1. Cài trên máy tính

Mở địa chỉ HospitalSign bằng Edge hoặc Chrome thông thường. Nhấn Cài ứng dụng nếu trình duyệt hỗ trợ, hoặc chọn chức năng cài trang này thành ứng dụng trong menu trình duyệt. Trình duyệt bên trong Codex có thể không hỗ trợ cài.

Bản local: mở start.cmd trước; ứng dụng đã cài vẫn cần máy chủ chạy. Cài PWA không đóng gói Python hoặc thay thế máy chủ.

2. Kích hoạt tài khoản và OTP một lần

Nhận tên đăng nhập và mã kích hoạt từ quản trị (hiệu lực 72 giờ, dùng một lần). Ở màn đăng nhập chọn Kích hoạt tài khoản mới, tự đặt mật khẩu đăng nhập và PIN ký riêng. Khóa thiết lập OTP chỉ hiện cho chính mình sau khi kích hoạt; trong ứng dụng xác thực TOTP, chọn thêm tài khoản bằng khóa thiết lập và nhập khóa đó. Cấu hình: TOTP, 6 số, chu kỳ 30 giây, SHA-1. Sau đó lấy mã trên điện thoại; không cần PowerShell.

Không chia sẻ mã thiết lập hoặc dùng chung tài khoản. Mã OTP chỉ xác nhận thao tác; chữ ký số do khóa và chứng thư cá nhân tạo ra.

3. Ký một hồ sơ

1. Mở app, đăng nhập bằng tài khoản và OTP.
2. Vào Hồ sơ trình ký, chọn hồ sơ đến lượt mình.
3. Tải và đọc đúng bản PDF hiện tại.
4. Nhấn Xác nhận & ký số, nhập PIN ký và OTP mới (mỗi mã OTP chỉ dùng một lần, kể cả mã vừa dùng để đăng nhập).
5. Kiểm tra trạng thái Hoàn tất hoặc chờ người ký tiếp; có thể kiểm tra chữ ký và tải PDF.

Yêu cầu ký hết hạn sau 120 giây. Nếu vừa ký hồ sơ khác, chờ mã OTP tiếp theo. Khi mất mạng, không ký và không tự động gửi lại yêu cầu.

Chứng thư có hạn 90 ngày. Khi còn 30 ngày, ứng dụng hiện nút Gia hạn chứng thư: nhập PIN và OTP, có thể đặt PIN mới. Chữ ký đã có vẫn hợp lệ sau khi gia hạn hoặc khi chứng thư cũ hết hạn, nhờ dấu thời gian của TSA nội bộ.

4. Điện thoại và nhiều nhân viên

Localhost trên điện thoại là chính điện thoại, không phải máy tính này. Để nhiều nhân viên dùng, cần máy chủ bệnh viện với tên miền HTTPS tin cậy. Android: mở bằng trình duyệt hỗ trợ và chọn cài ứng dụng. iPhone/iPad: Safari → Chia sẻ → Thêm vào Màn hình chính.

Cách triển khai nên chọn

Nhân viên dùng PWA; bệnh viện vận hành máy chủ tập trung, SSO/MFA và dịch vụ ký với HSM hoặc dịch vụ ký từ xa phù hợp. Nếu bắt buộc dùng USB token, cần đánh giá thêm ứng dụng cầu nối trên máy tính; PWA đơn thuần không tự đọc được mọi USB token.