Implant — 3 giai đoạn từ phẫu thuật đến mão cuối

Implant yêu cầu quy trình dài: Visit 1 phẫu thuật đặt trụ + lab order. Visit 2 (6 tháng sau) kiểm tra osseo-integration, tháo điểm chỉ. Visit 3 (sau 4 tuần) gắn mão sứ cuối. Hệ thống tự động tạo appointment recall, track lab order, ghi warranty 5 năm.

Giao diện implant 3-stage workflow — Luồng implant: Visit 1 (surgery + lab) → 6 tháng → Visit 2 (remove sutures, check) → 1 tháng → Visit 3 (place crown + warranty)

Bối cảnh

BN mất 2 cái răng số 36 (trái dưới) và 26 (phải dưới). Bác sĩ lập plan 2 implant + 2 mão sứ, tổng 30 triệu (cọc 15 triệu). Plan gồm 3 stage: Surgery (implant placement), Check-up (6 tháng sau), Crown placement (4 tuần sau check-up). BN approve. Lễ tân ghi cọc 15 triệu. Bác sĩ lập Visit 1: phẫu thuật đặt 2 trụ implant, tạo lab order (2x abutment + 2x crown). BN hẹn 6 tháng sau. Tháng 6, Visit 2: bác sĩ kiểm tra osseo-integration, tháo điểm chỉ, xác nhận lab. Tháng 7, Visit 3: gắn 2 mão sứ, bác sĩ mark stage "Crown placement" COMPLETED, warranty 5 năm được cấp. BN trả phần còn 15 triệu.

Diễn viên & quyền cần

Vai trò	Quyền	Hành động
Bác sĩ	`visit.manage`, `diagnosis.manage`, `treatment_plan.manage`, `lab_work_order.manage`	Lập plan, tạo visit, ghi diagnosis, tạo lab order, hoàn thành stage
Lễ tân	`reception.manage`, `appointment.manage`, `payment.manage`, `lab_work_order.read`	Tạo appointment recall, check-in, ghi thanh toán, theo dõi lab
Lab technician	`lab_work_order.manage`, `lab_work_order.read`	Nhận lab order, cập nhật tiến độ, ghi "Đã sẵn sàng" khi xong
Kế toán	`treatment_plan.read`, `payment.manage`, `lab_work_order.read`	Quản lý thanh toán 3 đợt, tracking revenue

Quy trình từng bước

Bác sĩ lập diagnosis + plan. Khám BN, phát hiện 2 răng mất → lập diagnosis (tooth 36, 26, condition: missing). Tạo plan 3 stage: (1) Implant Surgery (trụ + abutment temporary), (2) Check-up & Osseo-integration verify, (3) Crown placement (mão sứ cuối). Tổng giá 30 triệu, cọc 15 triệu. Lưu plan = DRAFT.
Lệ tân in phiếu tư vấn & BN approve. Lệ tân print "Phiếu tư vấn", BN xem, ký duyệt. Lệ tân hoặc bác sĩ click "Phê duyệt" (APPROVED). Charge 30 triệu tạo tự động. Outstanding = 30 triệu.
Ghi cọc 15 triệu. Lễ tân từ Patient 360 → "Ghi nhận thanh toán" → 15 triệu. Phiếu thu. Outstanding = 30 - 15 = 15 triệu.
Visit 1 — Phẫu thuật đặt trụ. Bác sĩ tạo appointment cho hôm nay (hoặc hôm mai). Lệ tân check-in → visit tạo auto, status ARRIVED. Bác sĩ start-consultation → visit IN_PROGRESS. Bác sĩ:
a. Ghi diagnosis visit-level (phẫu thuật 2 trụ implant, vị trí 36 & 26).
b. Mark stage "Implant Surgery" IN_PROGRESS → COMPLETED (ghi ngày, ghi ghi chú, chọn râng).
c. Tạo lab order: mục "Abutment + Crown" × 2 teeth. Lab order status DRAFT. Chi tiết: material (titanium abutment + cerec crown), shade, fit note.
d. Lưu & close visit. Visit status COMPLETED. Warranty snapshot tạo (5 năm từ ngày surgery complete).
Lệ tân ghi thanh toán visit 1 (tuỳ chọn). Nếu có charge riêng visit 1 (ví dụ: phí phẫu thuật 10 triệu), lệ tân ghi payment 10 triệu. Outstanding = 5 triệu (30 - 15 cọc - 10 visit1).
Lab order phát hành cho phòng lab. Bác sĩ hoặc lệ tân từ lab order detail → click "Gửi lab" (SENT_TO_LAB). Lab nhận notification. Status lab: SENT_TO_LAB.
6 tháng sau — Appointment recall Visit 2. Hệ thống (hoặc lệ tân) đặt appointment tái khám (recall) 6 tháng sau Visit 1. Ghi chú: "Kiểm tra osseo-integration, tháo điểm chỉ". Lệ tân gửi SMS/Zalo confirm cho BN. Lab có thể report "Sẵn sàng" trước appointment này.
Visit 2 — Check-up & Remove sutures. BN tới, lệ tân check-in → visit tạo. Bác sĩ start → IN_PROGRESS. Bác sĩ:
a. Khám, check osseo-integration (tapping test, X-ray), ghi observation, tháo điểm chỉ.
b. Ghi diagnosis visit-level (osseo-integration positive, sutures removed).
c. Stage "Check-up" mark COMPLETED.
d. Đặt lịch Visit 3 sau 4 tuần (từ visit detail hoặc workflow auto-suggest).
e. Close visit. Visit 2 status COMPLETED.
Lab hoàn thiện & gửi về. Lab finish crown, pack, gửi về phòng khám. Phòng khám (lệ tân hoặc bác sĩ) cập nhật lab order status: DELIVERED_TO_DOCTOR. Lab order detail show date received.
Appointment Visit 3 — Crown placement. 4 tuần sau Visit 2. Lệ tân confirm appointment với BN. Ghi chú: "Gắn mão sứ tooth 36 & 26".
Visit 3 — Gắn mão cuối. BN tới, lệ tân check-in → visit. Bác sĩ start → IN_PROGRESS. Bác sĩ:
a. Gắn mão sứ, adjust bite, check fit.
b. Ghi diagnosis visit-level (crown placed, no complications, occlusion good).
c. Stage "Crown placement" mark COMPLETED. Hệ thống lại tạo warranty snapshot: 5 năm từ ngày này (overwrite visit 1, hoặc add thêm warranty line).
d. Close visit. Visit 3 status COMPLETED.
Mark plan COMPLETED. Bác sĩ hoặc admin click plan detail → "Hoàn tất kế hoạch" → plan status COMPLETED.
Ghi thanh toán cuối (15 triệu). Lệ tân từ Patient 360 → "Ghi nhận thanh toán" → 15 triệu. Outstanding = 0. Phiếu thu = full amount (30 triệu).

Kết quả mong đợi

Plan status: DRAFT → APPROVED → IN_PROGRESS (khi bắt đầu stage đầu) → COMPLETED (khi stage cuối xong).
3 visits: Visit 1 (surgery), Visit 2 (check-up), Visit 3 (crown) — mỗi visit có stage link, diagnosis, close status COMPLETED.
Lab order: Status DRAFT → SENT_TO_LAB → IN_PROGRESS (lab làm) → READY → DELIVERED_TO_DOCTOR. Linked to stage "Crown placement".
Warranty: Cấp trên Visit 3 stage complete, valid 5 năm từ ngày gắn mão cuối. Xem trong Patient 360 tab "Bảo hành".
Payments: 3 lần: cọc 15M, visit 1 (tuỳ), final 15M. Outstanding = 0 khi done.
Patient 360 timeline: 3 visit events + 3 stage complete event + 2 lab order status + 2 payment + 1 warranty created → timeline rõ ràng "Lịch sử 7 tháng".

Khi nào hỏng & cách xử lý

Triệu chứng	Nguyên nhân	Khôi phục
Lab order không nhận được notification (không biết tạo được order)	Lab email/contact không cấu hình, hoặc hệ thống không gửi event	Bác sĩ hoặc lệ tân trực tiếp liên hệ lab: SMS / Zalo / phone. Ghi chú trên lab order "Contacted lab on [date]".
Visit 2 bị delay (BN không tới 6 tháng đúng lịch)	BN quên hẹn hoặc hoãn vì lý do cá nhân	Customer Care task "Follow-up missed recall" được tạo. Lệ tân liên hệ BN, đặt lại appointment, không phải delete recall appointment cũ — lưu lịch sử.
Lab order gửi sai material (color mismatch)	BN hoặc bác sĩ ghi sai shade trong lab order, hoặc lab hiểu nhầm	Bác sĩ + lab thống nhất. Tạo lab order mới (REWORK hoặc REVISION), ghi "Rework due to color issue". Lab order cũ lưu lịch sử (status = REWORK_REQUIRED).
Stage mark COMPLETED mà chưa hoàn thành (nhầm)	Bác sĩ click sai hoặc interface confusing	Bác sĩ hoặc admin "Uncomplete stage" (rollback). Stage status = PENDING. Warranty snapshot (nếu tạo) bị xóa. Ghi audit "Stage reverted due to [reason]".
Visit 3 (crown) gắn xong, plan vẫn IN_PROGRESS (chưa mark COMPLETED)	Bác sĩ quên mark stage hoặc plan, hoặc lỗi UI	Bác sĩ vào plan detail → mark stage "Crown placement" COMPLETED nếu chưa. Sau đó mark plan COMPLETED. Warranty tạo/update. Refresh Patient 360.
Warranty không hiển thị sau Visit 3 (missing)	Stage không bao giờ mark COMPLETED, hoặc warranty created nhưng cache stale	Kiểm tra plan stage status. Nếu "Crown placement" = COMPLETED, warranty phải tồn tại trong DB. Refresh Patient 360 tab "Bảo hành".

Dấu vết để lại (audit & branch ownership)

Audit log ghi: "Plan created (DRAFT)", "Plan approved", "Deposit 15M paid", "Visit 1 created/completed (surgery)", "Lab order created/sent", "Visit 2 created/completed (check-up)", "Visit 3 created/completed (crown)", "Final payment 15M", "Warranty created", "Plan completed". Toàn bộ timeline có timestamp, user, chi nhánh.

Lab order & stage interleave

Lab order không phải là stage, nhưng liên kết với stage "Crown placement". Hệ thống chặn stage complete nếu lab order chưa RECEIVED (tuỳ cấu hình clinic). Điều này đảm bảo bác sĩ không quên gắn mão trước khi lab deliver.

Multi-visit warranty (CI-04)

Implant có thể cấp warranty nhiều lần (visit 1 surgery + visit 3 crown), hoặc 1 warranty cover cả trụ + mão. DentIQ ghi rõ warranty scope per line item. Warranty snapshot tạo khi stage COMPLETED, nếu stage có `warrantyDuration` set. Khi visit 3 xong, warranty được cập nhật với expiry date = ngày gắn mão + 5 năm.