Hasaki ClinicOS — Tài liệu hệ thống¶
Hệ điều hành vận hành cho chuỗi phòng khám thẩm mỹ/y khoa Hasaki Clinic. Tài liệu này là single source of truth cho kiến trúc, nghiệp vụ và vận hành.
ClinicOS là gì¶
ClinicOS là giao diện admin (web) quản lý toàn bộ vận hành một chuỗi clinic thẩm mỹ: từ đặt lịch, tiếp nhận, tư vấn, khám/kê toa, làm dịch vụ, thu ngân, đến điều phối nhân sự và kho dược. Điểm khác biệt cốt lõi không nằm ở "quản lý" mà ở bộ máy điều phối tự động chống gian lận và luồng vận hành xuyên suốt theo mã phiếu.
- Công nghệ: HTML/CSS/JS tĩnh thuần, không framework, không build step. Mỗi trang một file
.htmlđộc lập, dùng chungtheme.css+app.js+data.js. - Ngôn ngữ: toàn bộ tiếng Việt.
- Thẩm mỹ: "clinic light 2026" — nền trắng ngà ấm, teal y khoa + blush hồng, font Fraunces × Outfit.
- Triển khai: GitHub + Cloudflare Pages (output
admin, không build command).
Đọc theo vai trò¶
| Vai trò | Bắt đầu từ |
|---|---|
| Mọi người | 00 · Tổng quan hệ thống |
| Developer | 00 → 05 Glossary → 01 Kiến trúc → 02 Dữ liệu → 03 Frontend |
| BA / PM | 00 → 05 Glossary → 09 User stories → 15 Business rules |
| QA | 00 → 09 User stories → 15 Business rules → 10 Test plan |
| DevOps | 00 → 01 Kiến trúc → 07 Deploy |
| Vận hành / Quản lý CN | 00 → 20 Điều phối tua → 08 Chống ghim khách |
| Tài chính | 00 → 16 Luồng thu tiền & công |
Bản đồ tài liệu¶
| # | Tài liệu | Đối tượng | Nội dung |
|---|---|---|---|
| 00 | Tổng quan hệ thống | Tất cả | Executive summary, 6 nhóm chức năng, luồng tổng |
| 01 | Kiến trúc & triển khai | Eng, DevOps | Static multi-page, shared assets, render pattern |
| 02 | Mô hình dữ liệu & mã phiếu | Eng, BA | Store khách, hệ thống mã phiếu BK→TV→KH→RC→DV |
| 03 | Design system & trang | Frontend | Clinic light 2026, component, 40 trang |
| 05 | Glossary | Tất cả | Thuật ngữ VN domain (TVV, KTV, tua, SKU, major/skill) |
| 09 | User stories | BA, Dev, QA | Theo vai trò, acceptance criteria |
| 15 | Business rules | Tất cả | Rule chống ghim, single-active, SLA, thu tiền |
| 10 | Test plan & cases | QA | Chiến lược test các luồng cashier/dispatch |
| 07 | Deploy & môi trường | DevOps | GitHub + Cloudflare Pages |
| 08 | Chống ghim khách | Ops, Security | Cơ chế chống cấu kết TVV–KTV, ẩn danh, audit |
| 16 | Luồng thu tiền & công | Finance, Dev | Multi-payment, công thức tính công |
| 20 | Điều phối tua | Ops | Auto-dispatch, công thức score, van xả |
Trạng thái tài liệu
Tài liệu nội bộ. Mọi quyết định kỹ thuật/nghiệp vụ chốt ở đây được coi là chuẩn. Khi hệ thống thay đổi, cập nhật tài liệu tương ứng trước khi merge.