Chế độ vận hành & Launch Pack

DentIQ hỗ trợ ba chế độ vận hành: Simple (phòng khám 1 ghế), Standard (đa phòng + kho/labo), Advanced (chuỗi đa chi nhánh + tài chính nâng cao). Chế độ được chọn khi cài đặt ban đầu qua Setup Wizard — và có thể thay đổi bất kỳ lúc nào tại Cài đặt › Vận hành › Tính năng.

Ba Launch Pack — ý nghĩa thực tế

Mỗi launch pack là bộ cài đặt mẫu áp lên chế độ vận hành và các cờ bật/tắt tính năng. Áp lại idempotent — không xóa dữ liệu, không ảnh hưởng lịch sử thanh toán hay patient. Sau khi áp, bạn vẫn có thể chỉnh tay từng tính năng độc lập.

Launch Pack	Tên gợi nhớ	Dành cho	Module bật mặc định
`SMALL_CLINIC`	1 ghế / phòng khám nhỏ	Phòng khám 1–2 bác sĩ, 1 chi nhánh, chưa cần kho/labo/tài chính nâng cao	Core workflows: Lịch hẹn, Lễ tân, Visit, Chẩn đoán, Treatment plan, Patient 360, Thu tiền, Đơn thuốc, In tài liệu
`STANDARD_CLINIC`	Đa phòng + Kho/Labo	Phòng khám 2–4 bác sĩ, cần quản lý kho vật tư, gửi labo răng, chăm sóc hậu điều trị	Tất cả của Simple + Kho hàng, Lab work orders, Sổ quỹ ca, Chăm sóc khách hàng, Báo cáo nâng cao, Bảo hành tài chính, Retention nâng cao
`ADVANCED_CLINIC`	Đa chi nhánh + Tài chính nâng cao	Chuỗi nhiều chi nhánh, cần tính thu nhập bác sĩ, hóa đơn điện tử, báo cáo chất lượng	Tất cả của Standard + Thu nhập bác sĩ, Điều chỉnh thù lao, Hóa đơn điện tử, Chất lượng điều trị

Launch Pack ≠ Chế độ vận hành

Launch pack (SMALL_CLINIC / STANDARD_CLINIC / ADVANCED_CLINIC) là bộ cài đặt mẫu áp một lần — idempotent, không xóa dữ liệu. Chế độ vận hành (SIMPLE_CLINIC / STANDARD_CLINIC / ADVANCED_CLINIC) là trạng thái runtime ảnh hưởng giao diện workspace bác sĩ. Sau khi áp pack, bạn vẫn tự chỉnh từng cờ độc lập — khi đó label hiển thị chuyển sang Tuỳ chỉnh.

Quy tắc 3 lớp: quyền — cờ clinic — chế độ

DentIQ kiểm soát những gì mỗi nhân viên thấy bằng 3 lớp độc lập. Hiểu đúng ba lớp này giúp tránh mọi nhầm lẫn khi cấu hình:

#	Lớp	Vai trò	Ai kiểm soát	Khi nào áp dụng
1	Quyền (permission)	Chủ quyền cho tất cả tính năng — kể cả core workflows. Thiếu quyền → ẩn hoặc chỉ đọc	Clinic Admin qua `Tổ chức › Roles & Permissions`	Luôn luôn — cả core lẫn module nâng cao
2	Cờ clinic (clinic flag)	Chủ quyền cho các module nâng cao (Kho, Labo, Thu nhập BS, E-Invoice…). Cờ tắt → module ẩn với mọi người, kể cả người đã có đủ quyền	Clinic Admin qua `Cài đặt › Vận hành › Tính năng`	Chỉ với module nâng cao (không ảnh hưởng core)
3	Chế độ (mode)	Chỉ set giá trị mặc định của các cờ khi áp launch pack. Không khóa cứng — sau đó bạn chỉnh tay tùy ý	Áp tự động khi chọn preset; có thể đổi bất kỳ lúc	Chỉ tại thời điểm áp preset

Thứ tự kiểm tra của hệ thống: cờ clinic → quyền → cài đặt nhân viên → cài đặt người dùng. Bất kỳ điều kiện nào không thoả → menu không hiện. Hệ thống không bao giờ hiển thị số "0 ₫" hay dữ liệu giả khi bị ẩn.

Tóm tắt nhanh

Core workflows (Lịch hẹn, Lễ tân, Visit, Patient 360, Thu tiền cơ bản, Đơn thuốc…) chỉ cần quyền là đủ — không bị ảnh hưởng bởi chế độ.
Module nâng cao (Kho, Labo, Sổ quỹ ca, CSKH, Thu nhập BS, E-Invoice…) cần cả hai: cờ clinic bật và quyền được cấp.

Bảng module — hiển thị theo chế độ

✓ = bật mặc định theo pack. ✗ = tắt mặc định (có thể bật thủ công sau). Quyền tương ứng vẫn phải được cấp cho nhân viên — xem 60 mã quyền.

Module	Simple	Standard	Advanced	Quyền tối thiểu
Core workflows — luôn theo quyền, không phụ thuộc chế độ
Lịch hẹn & Scheduler	✓	✓	✓	`appointment.read`
Lễ tân / Reception queue	✓	✓	✓	`reception.read`
Visit & Workspace bác sĩ	✓	✓	✓	`visit.read`
Chẩn đoán & Tooth chart	✓	✓	✓	`diagnosis.read`
Treatment plan	✓	✓	✓	`treatment_plan.read`
Patient 360 & Danh sách BN	✓	✓	✓	`patient.read`
Thu tiền (Payment cơ bản)	✓	✓	✓	`payment.read`
Đơn thuốc & Danh mục thuốc	✓	✓	✓	`prescription.read`
Danh mục dịch vụ	✓	✓	✓	`service.read`
In tài liệu (phiếu, biên lai…)	✓	✓	✓	`document.print`
Module nâng cao — cần cờ clinic bật và quyền
Kho hàng (Inventory)	✗	✓	✓	`inventory.read`
Lab work orders	✗	✓	✓	`lab_order.read`
Sổ quỹ ca (Cash management)	✗	✓	✓	`cash.read`
Chăm sóc khách hàng (CSKH)	✗	✓	✓	`customer_care.read`
Báo cáo nâng cao (Reports)	✗	✓	✓	`dashboard.read`
Bảo hành tài chính	✗	✓	✓	`payment.read`
Retention nâng cao	✗	✓	✓	`customer_care.read`
Thu nhập bác sĩ (Doctor Earnings)	✗	✗	✓	`earnings.read`
Điều chỉnh thù lao (Compensation)	✗	✗	✓	`earnings.manage`
Hóa đơn điện tử (E-Invoice)	✗	✗	✓	`einvoice.read`
Chất lượng điều trị (Quality)	✗	✗	✓	`dashboard.read`

Tôi đã cấp quyền nhưng menu vẫn không hiện?

Nguyên nhân phổ biến nhất: cờ clinic của module đó đang tắt. Quyền và cờ là hai lớp độc lập — cả hai phải bật thì menu mới xuất hiện.

Ví dụ: bạn cấp inventory.read cho nhân viên trong chế độ Simple → menu Kho hàng vẫn ẩn vì cờ inventoryEnabled của clinic đang tắt. Phải bật cờ tại Cài đặt › Vận hành › Tính năng → Kho hàng → Bật.

Cảnh báo inline tại trang Roles

Tại Tổ chức › Roles & Permissions, khi bạn gán quyền mà module tương ứng đang tắt ở cấp clinic, hệ thống hiển thị cảnh báo inline ngay bên cạnh quyền đó: "Quyền này hiện không có tác dụng vì module [Tên module] chưa được bật tại Cài đặt › Vận hành › Tính năng." Hãy chú ý cảnh báo này khi cấu hình role.

Thứ tự kiểm tra khi nhân viên báo "không thấy menu X":

Vào Cài đặt › Vận hành › Tính năng — kiểm tra cờ module đó có đang bật không.
Vào Tổ chức › Roles & Permissions — xác nhận quyền tương ứng đã được gán cho role của nhân viên.
Nếu cả hai đều ổn, kiểm tra cài đặt per-nhân viên tại tab Nhân sự trong Vận hành (áp dụng cho Thu nhập BS và Chất lượng).

Khởi đầu với phòng khám 1 ghế — hướng dẫn từng bước

Nếu phòng khám có 1–2 bác sĩ và chưa cần kho/labo/tài chính nâng cao, SMALL_CLINIC là lựa chọn tốt nhất. Menu gọn, nhân viên dễ học, và bạn có thể nâng cấp sau khi đã vận hành ổn định.

Bước 1 — Áp Small Clinic Launch Pack

Trong Setup Wizard, chọn preset SMALL_CLINIC. Nếu đã qua wizard, vào Cài đặt › Vận hành → tab Tổng quan → nhấn Áp Small Clinic Launch Pack → xác nhận. Idempotent — không mất dữ liệu.

Bước 2 — Những gì bạn có ngay lập tức

Có sẵn (core)	Chưa có — bật thủ công khi cần
Lịch hẹn + Scheduler Lễ tân / Reception queue Workspace bác sĩ Patient 360 đầy đủ Chẩn đoán + Tooth chart Treatment plan nhiều giai đoạn Đơn thuốc Thu tiền + in biên lai In phiếu tư vấn, đơn thuốc	Kho hàng (bật khi cần quản lý vật tư) Lab work orders (bật khi gửi labo) Sổ quỹ ca (bật khi đối soát tiền mặt theo ca) Chăm sóc KH / Recall tự động Báo cáo doanh thu nâng cao Thu nhập bác sĩ (cần nâng lên Advanced) Hóa đơn điện tử (cần nâng lên Advanced hoặc bật riêng cờ)

Bước 3 — Cấp quyền cho nhân viên

Dùng 7 role mặc định: Clinic Admin, Doctor, Receptionist, Customer Care, Accountant, Inventory Operator, Phụ tá. Gán mỗi nhân viên đúng role, set branch scope phù hợp. Không cần custom role khi mới bắt đầu. Xem 60 mã quyền khi cần custom.

Bước 4 — Chạy thử quy trình đầu-đến-cuối

Đặt 1 lịch hẹn test → check-in → visit → thu tiền → in biên lai. Xác nhận số tiền khớp trước khi onboard cả phòng khám. Xem checklist đầy đủ tại Ngày go-live.

Cần e-invoice ngay từ đầu?

E-Invoice mặc định tắt trong SMALL_CLINIC. Nếu phòng khám cần xuất hóa đơn điện tử từ ngày đầu, có hai cách: (1) chọn preset ADVANCED_CLINIC từ đầu, hoặc (2) giữ SMALL_CLINIC và bật riêng cờ einvoiceEnabled tại Cài đặt › Vận hành › Tính năng + cấp einvoice.manage cho kế toán. Xem E-Invoice setup.

Bảng tóm tắt theo vai trò & chế độ

Mô tả những menu điển hình mỗi role thấy theo chế độ mặc định, giả sử đã dùng role mặc định và cấp đủ quyền chuẩn. Điều chỉnh quyền hoặc cờ sẽ thay đổi kết quả.

Vai trò	Simple (1 ghế)	Standard (Đa phòng)	Advanced (Chuỗi + tài chính)
Clinic Admin Tất cả quyền	Lịch hẹn, Lễ tân, Workspace, Patient 360, Treatment plan, Thanh toán, Đơn thuốc, Cài đặt đầy đủ. Không có: Kho, Labo, Quỹ ca, CSKH, Báo cáo nâng cao, Thu nhập BS, E-Invoice	+ Kho hàng, Lab, Sổ quỹ ca, CSKH & Recall, Báo cáo doanh thu, Bảo hành tài chính	+ Thu nhập bác sĩ, Điều chỉnh thù lao, Hóa đơn điện tử, Chất lượng điều trị
Bác sĩ visit, diagnosis, treatment_plan, appointment, patient, prescription	Lịch hẹn của mình, Workspace, Chẩn đoán, Treatment plan, Patient 360, Đơn thuốc, In phiếu tư vấn. Không có: Lab, Thu nhập	+ Lab work orders (đặt, theo dõi tiến độ)	+ Thu nhập của chính mình (khi Clinic Admin bật cài đặt nhân viên Xem thu nhập cá nhân)
Lễ tân appointment, reception, patient, visit, payment.read	Lịch hẹn, Reception queue, Danh sách BN, Thu tiền cơ bản, In biên lai. Không có: Kho, CSKH, Báo cáo	Không đổi nhiều — CSKH là role riêng	Không đổi với lễ tân
Chăm sóc khách hàng customer_care, communication, patient.read	Rất hạn chế — module CSKH tắt → chỉ thấy Danh sách BN. Không có hàng đợi chăm sóc	Hàng đợi chăm sóc, Recall, Follow-up tự động, Automation triggers, xem BN chưa tái khám	+ Retention nâng cao, Bảo hành tài chính (nếu có `payment.read`)
Kế toán payment, cash, earnings.read, einvoice, dashboard.read	Thu tiền, xem công nợ, in biên lai. Không có: Sổ quỹ ca, Thu nhập BS, E-Invoice, Báo cáo nâng cao	+ Sổ quỹ ca, Báo cáo doanh thu	+ Thu nhập bác sĩ, Hóa đơn điện tử, Chất lượng
Thủ kho inventory, service.read	Rất hạn chế — module Kho tắt → chỉ thấy Danh mục dịch vụ	Module Kho đầy đủ: nhập/xuất kho, tồn kho, cảnh báo hạ tồn, xuất báo cáo kho	Kho đầy đủ + Chất lượng (nếu có `dashboard.read`)

Không hiển thị số "0 ₫" khi bị ẩn (CI-02)

Khi module bị tắt hoặc nhân viên thiếu quyền tài chính, hệ thống không hiển thị số "0 ₫" hay dữ liệu giả. Các trường tài chính bị ẩn hoàn toàn hoặc hiện thông báo "Dữ liệu bị ẩn do thiếu quyền" — không bao giờ hiển thị sai số tiền.

Nâng cấp chế độ vận hành về sau

Khi phòng khám phát triển, bạn có thể nâng cấp chế độ bất kỳ lúc nào — không mất dữ liệu, không ảnh hưởng lịch sử thanh toán, visit, hay patient.

Cách 1 — Áp lại launch pack mới

Vào Cài đặt › Vận hành → tab Tổng quan.
Nhấn Đổi pack → chọn STANDARD_CLINIC hoặc ADVANCED_CLINIC → xác nhận.
Hệ thống áp bộ mặc định của pack mới. Các cờ đã chỉnh tay trước đó sẽ được reset về mặc định pack mới — hãy kiểm tra lại tab Tính năng sau khi áp.
Cấp thêm quyền cho nhân viên tương ứng với các module mới bật (xem 60 mã quyền).

Cách 2 — Bật từng tính năng thủ công (khuyến nghị)

Vào Cài đặt › Vận hành → tab Tính năng.
Tìm module cần bật (ví dụ: Kho hàng) → gạt toggle Bật.
Cấp quyền tương ứng cho nhân viên cần dùng module đó.
Module xuất hiện trên menu ngay lập tức.

Sau khi bật module mới

Module xuất hiện trên menu ngay khi bật cờ. Nếu nhân viên vẫn chưa thấy, kiểm tra quyền role của họ (xem 60 mã quyền) và xem phần "Tôi đã cấp quyền nhưng menu vẫn không hiện?" bên trên.