CXK — Giao diện trình diễn ngoại tuyến nội bộ
Nền tảng Vue 3 chuẩn bị T09/T12. Chưa hoàn thành T12 hoặc được phép tư vấn sức khỏe.
Không nhập dữ liệu thật. Không có chức năng bật kết nối API.
Hiện có
- Ba tình huống tổng hợp: chưa sẵn sàng, từ chối yêu cầu mẫu, lỗi cấu trúc mẫu.
- Kết quả gắn nhãn mô phỏng; không phải phản hồi từ máy chủ.
- Chữ lớn, ba mức cỡ chữ, liên kết bỏ qua đầu trang và vùng thông báo.
- Bố cục thích ứng; màu sáng/tối theo hệ điều hành, không lưu lựa chọn.
- Không có ô nhập, camera, micro, mô hình, phân tích sử dụng hoặc lưu hội thoại.
- Không có nguồn y khoa hoặc kết quả phân loại mức độ.
Ứng dụng chỉ tải tệp giao diện từ máy phục vụ nội bộ. Mã ứng dụng không gọi mạng khi mở trang hoặc thao tác.
Chính sách nội dung chặn kết nối; chế độ phát triển tắt cập nhật nóng để tránh WebSocket.
Không có service worker; cần tải tệp giao diện trước khi sử dụng.
Môi trường và lệnh
Đã xác định Node 22.22.2, npm 10.9.7 trên Windows.
Yêu cầu Node ^22.12.0 || ^24.0.0 || >=26.0.0; chưa kiểm thử các phiên bản khác.
Chạy lệnh trong thư mục frontend/:
| Lệnh | Mục đích |
|---|---|
npm install |
Cài gói phát triển; cần mạng tới kho npm |
npm ci |
Cài đúng phiên bản khi có package-lock.json hợp lệ |
npm test |
Chạy Vitest một lần, không mở máy chủ |
npm run build |
Tạo dist/ cho kiểm tra nội bộ, không xuất bản |
npm run dev |
Chỉ tại 127.0.0.1:5173; tải lại trang sau khi sửa |
npm run preview |
Xem bản dựng tại 127.0.0.1:4173, sau khi build |
Không thêm --host 0.0.0.0, proxy API hoặc đưa dist/ lên Internet.
Không cần chạy backend. Không có khóa hoặc biến môi trường dịch vụ.
Kiểm tra trên ổ chia sẻ
Cài trực tiếp trên ổ T đã gặp TAR_ENTRY_ERROR và EBADF; không dùng thư viện cài dở làm bằng chứng.
Đã cài và dựng bản sao nguồn trên ổ cục bộ: 21 test đạt, build thành công; package-lock.json đã lưu.
tools/KIEM_TRA_FRONTEND.ps1 chạy từ gốc, chép nguồn sang thư mục TEMP riêng, dùng npm ci, test và build.
Lệnh không sửa nguồn; mặc định xóa thư mục tạm sau kiểm tra. -KeepBuild chỉ giữ bản dựng khi mọi bước đạt.
Không dùng thư mục tạm làm nơi lưu mã chuẩn. Kiểm lại hash khi nguồn thay đổi trong lúc sao chép.
Tệp chính và giới hạn
src/App.vue: bố cục và trạng thái tạm.src/demo.js: dữ liệu tổng hợp cố định, hàm thuần.src/styles.css: màu CXK, chữ, bàn phím và bố cục.index.html,src/main.js: điểm nạp giao diện.vite.config.js: Vue, Vitest và máy phục vụ loopback.tests/: kiểm thử mô phỏng và giao diện.- Đặc tả giao diện và trợ năng: hành vi và kiểm tra còn thiếu.
Không tuyên bố WCAG AA hoặc đã thử nghiệm với người cao tuổi.
T10/T11, phê duyệt y khoa, pháp lý và nghiên cứu người dùng vẫn còn phụ thuộc.
Hợp đồng API chỉ dùng đối chiếu mã trạng thái.
Không coi kiểm thử giao diện là kiểm thử tích hợp hoặc bộ lọc an toàn.