Hướng dẫn bản mô phỏng CXK — chuẩn bị T16

Ngày 26/09/2026 · DRAFT · Chỉ dùng nội bộ với các nút và dữ liệu tổng hợp cố định.
Đây không phải hướng dẫn chăm sóc người bệnh, hoạt động tuyển người hoặc xác nhận hoàn thành T16.

1. Trước khi mở

Bản này giúp kiểm cách giao diện hiển thị trạng thái kỹ thuật. Nó không trả lời câu hỏi sức khỏe.
Không nhập, dán, tải lên hoặc cung cấp thông tin cá nhân và dữ liệu bệnh nhân.
Không dùng kết quả mô phỏng để quyết định chăm sóc hoặc đánh giá tình trạng sức khỏe.
Chưa có hoạt động với người tham gia hoặc môi trường triển khai được xác nhận trong tài liệu này.

Mã hiện có nằm ở 📄 App.vue và 📄 demo.js.
Thao tác dưới đây là hướng dẫn cần kiểm chứng, không phải biên bản thử người dùng đã thực hiện.

2. Mở đúng bản nội bộ

1. Người phụ trách kỹ thuật chuẩn bị gói theo README frontend.
2. Không tự cài phần mềm, nhập khóa hoặc thay cấu hình mạng để mở bản mô phỏng.
3. Chỉ mở địa chỉ loopback do người chuẩn bị xác nhận trên chính máy đang sử dụng.
4. Cấu hình hiện tại dùng http://127.0.0.1:5173 khi phát triển, hoặc http://127.0.0.1:4173 khi xem bản dựng.
5. Nếu cổng đang bận, dừng để kiểm tra; không tự chuyển sang địa chỉ mạng LAN hoặc Internet.
6. Kiểm tra nhãn “Nội bộ · OFFLINE DEMO” và tiêu đề “Thử giao diện. Không tư vấn sức khỏe.”
7. Ban đầu phải có “Chưa chọn tình huống” và mức chữ 1/3.

Không cần chạy backend, MSSQL hoặc IIS. Không mở thẳng tệp index.html để thay máy phục vụ mô-đun.
Trình duyệt vẫn tải HTML, JavaScript và CSS từ máy phục vụ cục bộ.
Việc tải tệp này khác với gọi API của ứng dụng hoặc gửi nội dung tới mô hình.
Mã ứng dụng không gọi API khi mở trang hoặc bấm nút. Không có chế độ bật API thật.
Không có service worker để bảo đảm mở lại khi máy phục vụ đã dừng.
Cài gói npm có thể dùng mạng, nhưng không phải hành vi của bản mô phỏng đã tải.

3. Thao tác từng bước

Chỉnh cỡ chữ

• Chọn “Tăng chữ” để chuyển từ mức 1 lên 2, rồi 3.
• Chọn “Giảm chữ” để trở lại mức nhỏ hơn.
• Nút tương ứng bị vô hiệu hóa ở mức nhỏ nhất hoặc lớn nhất.
• Lựa chọn chỉ tồn tại ở trang đang mở, không được ứng dụng lưu lại.
• Có thể dùng chức năng phóng to của trình duyệt; ba mức chữ không thay chức năng này.

Chọn tình huống

Chọn nút khác sẽ thay kết quả hiện tại. Không có lịch sử hội thoại.
Các dòng GET /api/readiness hoặc POST /api/chat chỉ là chữ tham chiếu, không gửi yêu cầu.
Giao diện không có mẫu health 200 hoặc mẫu thân yêu cầu quá lớn 413.
Các trường hợp đó thuộc kiểm API riêng, không kiểm bằng nút giao diện.

Dùng bàn phím

1. Dùng Tab để chuyển tới phần tử tương tác tiếp theo; dùng Shift+Tab để quay lại.
2. Ở đầu trang, chọn liên kết “Bỏ qua đầu trang, đến nội dung chính” bằng Enter.
3. Khi nút có tiêu điểm, dùng Enter hoặc Space để kích hoạt.
4. Quan sát viền tiêu điểm và kết quả sau khi chọn. Không chỉ dựa vào màu để nhận biết lựa chọn.
5. Nút bị vô hiệu hóa có thể bị bỏ qua khi dùng Tab; đây là hành vi mong đợi tại giới hạn chữ.

Vùng kết quả có thông báo cho công cụ đọc màn hình. Chưa xác nhận chất lượng đọc trên mọi trình duyệt.
Giao diện không tự chuyển tiêu điểm tới kết quả; tiếp tục đọc bằng cách thông thường của công cụ đang dùng.
Kiểm bàn phím và công cụ đọc màn hình thực vẫn phải ghi bằng chứng riêng.

Đặt lại và kết thúc

• “Đặt lại bản trình diễn” xóa tình huống đang chọn, nhưng giữ nguyên mức chữ.
• Tải lại trang trả tình huống về rỗng và mức chữ về 1/3.
• Đóng trang để kết thúc xem. Việc này không tự dừng máy phục vụ cục bộ.
• Người đã mở máy phục vụ có thể dừng bằng Ctrl+C trong đúng terminal của tiến trình đó.
• Không tắt hàng loạt tiến trình khác hoặc xóa tệp để đặt lại bản mô phỏng.

4. Giới hạn phải giữ rõ

• Không có ô nhập, tải tệp, camera, micro hoặc ghi âm.
• Không có mô hình, tri thức y khoa, phân loại mức độ hoặc trích dẫn.
• Không dùng localStorage, sessionStorage, IndexedDB hoặc cookie để lưu lựa chọn của ứng dụng.
• Trạng thái mẫu và chữ chỉ nằm trong bộ nhớ thành phần Vue.
• Điều này không khẳng định trình duyệt, tiện ích mở rộng hoặc máy phục vụ không giữ bộ nhớ đệm và log.
• Chính sách nội dung có connect-src 'none'; đây không phải bảo đảm cách ly toàn bộ thiết bị.
• Cấu hình phát triển tắt cập nhật nóng qua WebSocket; sửa tệp cần tải lại trang.
• Không tuyên bố đạt WCAG AA, đã thử với người cao tuổi hoặc đã kiểm mọi kích thước màn hình.

Xem đặc tả giao diện và trợ năng để biết các kiểm tra còn chờ.
Kết quả kiểm mã hoặc bấm nút không chứng minh hiệu quả nghiên cứu và an toàn y khoa.

5. Khi gặp lỗi hoặc nội dung ngoài dự kiến

1. Dừng thao tác nếu trang yêu cầu dữ liệu thật, quyền camera/micro, đăng nhập hoặc kết nối dịch vụ.
2. Không cấp quyền, không gửi dữ liệu và không thử lại bằng câu hỏi sức khỏe.
3. Ghi tên nút, bước thao tác, trình duyệt và thông báo kỹ thuật; không đưa dữ liệu nhận diện vào ghi chú.
4. Chỉ chụp ảnh nếu chắc chắn màn hình không có dữ liệu riêng tư.
5. Báo vai trò phụ trách kỹ thuật hoặc GVHD qua kênh đã được xác nhận cho phiên kiểm tra.
6. Nếu chưa có đầu mối nhận việc, giữ dừng. Không giả định luôn có người trực hỗ trợ.

Tên người nhận sự cố, kênh liên hệ và thời gian phản hồi còn chờ xác nhận.
Không có bảo đảm phản hồi hoặc hỗ trợ chăm sóc sức khỏe từ bản này.
Xem hướng dẫn vận hành khi cần giữ bằng chứng và dừng tiến trình.

6. Phiếu kiểm nội bộ để trống cho lần thực hiện

Không điền “đạt” trước khi quan sát. Không dùng phiếu này để tuyển hoặc thu dữ liệu người tham gia.
Tài liệu chỉ chuẩn bị một phần T13/T16; T12 và các phê duyệt liên quan vẫn phải được xét riêng.