# Lộ trình tích hợp ký số vào hệ thống nghiệp vụ

Từ phạm vi nghiệp vụ đến quản lý trạng thái, nhận kết quả và chuyển giao vận hành.

Hướng dẫn khái niệm và chuẩn bị triển khai

## 1. Chốt đầu vào trước khi viết mã

Chuẩn bị một luồng hồ sơ mẫu, xác định ứng dụng nguồn, người tham gia và nơi nhận kết quả. Làm rõ tài liệu được tạo từ mẫu hay tải lên, ai duyệt trước khi ký và khi nào được phép sửa nội dung.

Yêu cầu đặc tả đúng dịch vụ và phiên bản, môi trường thử nghiệm, phương thức xác thực được cấp và đầu mối hỗ trợ. Không suy ra endpoint từ tên sản phẩm hoặc dùng một tài liệu RSS cho mọi module.



## 2. Lập hợp đồng tích hợp

Thống nhất định danh hồ sơ, yêu cầu và lần thử; cách nhận trạng thái; giới hạn đầu vào; và cách trả tài liệu. Nếu có callback hoặc truy vấn trạng thái, xác nhận cơ chế được hỗ trợ trong đặc tả thay vì tự giả định.

Lập bảng ánh xạ dữ liệu giữa hai hệ thống, gồm trường bắt buộc, cách kiểm tra và bên chịu trách nhiệm. Ví dụ: ứng dụng nghiệp vụ quản lý mã hồ sơ, trong khi dịch vụ có thể trả định danh giao dịch riêng. Phải có cách liên kết để tra cứu.



## 3. Nối hành trình người ký

Hiển thị đúng người tham gia, tài liệu hoặc phiên bản và thao tác cần thực hiện. Nếu chuyển sang điện thoại hoặc ứng dụng khác, mô tả bước quay lại và cách kiểm tra kết quả.

Thông báo phải phân biệt đang chờ, người dùng hủy, yêu cầu không còn hiệu lực và hoàn tất. Đây là nhóm ý nghĩa nghiệp vụ để khảo sát; tên trạng thái chính xác phải theo API của dịch vụ.



## 4. Kiểm thử toàn trình và ngoại lệ

Chạy từ lúc tạo hồ sơ đến khi nhận kết quả trong hệ thống nguồn. Kiểm tra quyền xem và tải, phiên bản tài liệu, kết quả chữ ký theo công cụ được chọn và khả năng truy nguyên yêu cầu.

Kiểm thử hủy, hết hạn, mất kết nối, gửi lại và nhận thông báo trùng. Với mỗi tình huống, ghi kết quả mong đợi, dữ liệu giữ lại và hành động phục hồi. Chỉ tự động thử lại khi hiểu tác động của thao tác.



## 5. Nghiệm thu và chuyển giao

Bộ nghiệm thu cần có kịch bản, kết quả, phiên bản phần mềm và đặc tả áp dụng. Vận hành cần đầu mối hỗ trợ, cách tra cứu bằng mã hồ sơ/giao dịch và quy trình xử lý sự cố.

Không đưa thông tin bí mật vào log, ảnh chụp hoặc ví dụ chia sẻ. Thống nhất phạm vi lưu giữ và quyền xem log theo chính sách dự án. Sau mỗi nâng cấp, đánh giá lại các luồng bị ảnh hưởng.



Tài liệu nguồn:
- Tổng quan quy trình tài liệu GoPaperless: https://docs.mobile-id.vn/GoPaperless/Brochure_Datasheet/Brochure_GoPaperless_20250819.pdf

https://knowledge.mobile-id.vn/vi/kien-thuc/lo-trinh-tich-hop-ky-so/