Import dữ liệu cũ

Nếu bạn chuyển từ hệ thống cũ hoặc có danh sách bệnh nhân từ Excel, DentIQ cho phép import danh sách bệnh nhân vào hệ thống. Dữ liệu được xử lý an toàn: hệ thống đối soát trùng theo số điện thoại, cho phép merge hoặc tạo mới nếu cần.

Chuẩn bị dữ liệu

Trước khi import, bạn cần chuẩn bị file Excel với thông tin bệnh nhân. Vào Bệnh nhân → Import từ Excel → tải template để xem cấu trúc.

Các cột chấp nhận

Cột	Bắt buộc?	Ví dụ
`fullName`	Có	Nguyễn Văn A
`phone`	Có (để dedupe)	0912345678
`dateOfBirth`	Không (YYYY-MM-DD)	1990-05-15
`address`	Không	123 Nguyễn Huệ, Q.1, TP HCM
`gender`	Không	MALE / FEMALE
`treatmentHistoryNote`	Không (free text)	Đã cạo vôi 2020, trám răng 2021
`outstandingBalance`	Không (VND)	500000

Giao diện Import: tải file Excel, xem preview, xử lý trùng, hoàn tất

Import lịch sử điều trị cũ (TREATMENT_PLAN_SEED)

Ngoài import danh sách bệnh nhân cơ bản, DentIQ còn hỗ trợ import lịch sử điều trị cụ thể từ hồ sơ cũ — bao gồm ngày điều trị, tóm tắt, và số răng FDI. Dữ liệu này được ghi vào Patient 360 dưới dạng chẩn đoán lịch sử và ghi chú lâm sàng, hiển thị trong timeline với nhãn Imported.

Template TREATMENT_PLAN_SEED

Vào Bệnh nhân → Import từ Excel → chọn loại "Lịch sử điều trị" → tải template.

Cột dữ liệu

Cột	Bắt buộc?	Ví dụ
`phone`	Có (để tìm BN)	0912345678
`treatment_date`	Có (YYYY-MM-DD)	2023-06-15
`treatment_summary`	Có (tối đa 2000 ký tự)	Trám răng 36, sâu M/D
`teeth_fdi`	Không	36,46 (danh sách FDI cách nhau dấu phẩy)

Cột teeth_fdi — mã FDI hợp lệ

Mã FDI hợp lệ: răng vĩnh viễn 11–48 (góc 1–4, vị trí 1–8), răng sữa 51–85 (góc 5–8, vị trí 1–5). Ví dụ: 36,46 là hai răng hàm dưới. Mã không hợp lệ → hàng đó không được import (báo lỗi BLOCKER). Xem Tooth chart để biết thêm về FDI.

Kết quả sau import

Mỗi hàng hợp lệ tạo ra:

Chẩn đoán lịch sử — gắn vào BN (không gắn visit), nguồn = Imported.
Mục tooth chart — các răng trong teeth_fdi được ghi vào odontogram tổng hợp của BN.
Ghi chú lâm sàng — treatment_summary lưu thành clinical note nguồn Imported.
Timeline entry — "Đã nhập hồ sơ điều trị cũ (răng X, Y)" xuất hiện trong Patient 360.

Giới hạn quan trọng (GR-1)

TREATMENT_PLAN_SEED không tạo visit mới, charge, payment, hay doctor earning. Đây là dữ liệu lâm sàng lịch sử thuần tuý — không ảnh hưởng đến báo cáo doanh thu hay quỹ.

Luồng import bệnh nhân

Bước 1: Tải template

Vào Bệnh nhân → Import từ Excel → click Tải template. File Excel có sẵn các cột cần thiết. Bạn chỉ cần điền dữ liệu vào các hàng.

Bước 2: Điền dữ liệu

Mỗi hàng = 1 bệnh nhân.
Cột phone là chìa khóa để phát hiện trùng lập.
Cột treatmentHistoryNote là free text tóm tắt điều trị trước. Hệ thống không parse nó thành visit/charge — chỉ để lưu lịch sử.
Cột outstandingBalance nếu bệnh nhân còn nợ tại phòng khám cũ.

Bước 3: Upload file

Click Chọn file hoặc kéo thả file Excel vào. Hệ thống sẽ kiểm tra format và hiển thị preview.

Bước 4: Kiểm tra trùng và merge

Khi file được upload, hệ thống tự động so sánh số điện thoại (phone) với bệnh nhân hiện tại:

Trùng SĐT: Hệ thống hiển thị cảnh báo và hỏi: "Người này giống BN [tên cũ] không? Merge hay tạo mới?"
Không trùng: Bệnh nhân được tạo mới.
Merge: Nếu chọn merge, lịch sử điều trị mới được ghi vào BN cũ; không xoá dữ liệu gì.

Bước 5: Hoàn tất import

Sau khi xử lý hết, click Hoàn tất. Hệ thống sẽ import và hiển thị summary:

Tổng số BN import: X
Đã tạo mới: Y
Đã merge: Z
Lỗi (nếu có): cập nhật lại file và retry

Phạm vi import

DentIQ hỗ trợ import lịch sử điều trị kèm dữ liệu răng FDI qua TREATMENT_PLAN_SEED (xem phần trên). Tuy nhiên hệ thống không import chi tiết visit (dịch vụ, charge), ảnh X-quang, hay đơn thuốc. Nếu cần ghi lại chi tiết từng buổi khám trước đây, bạn phải nhập thủ công khi BN quay lại trong Patient 360 (gắn cờ Historical / Imported).

Giới hạn và lưu ý

Không hỗ trợ import

Chi tiết visit cũ đầy đủ (dịch vụ, charge, bác sĩ thực hiện) — dùng import danh sách BN cơ bản và ghi lại khi BN quay lại.
Tooth chart lịch sử đầy đủ với bề mặt chi tiết — TREATMENT_PLAN_SEED chỉ ghi FDI + tóm tắt, không ghi bề mặt (M/D/O/B/L/I) hay ảnh X-quang.
Ảnh X-quang hay hình lâm sàn cũ.
Đơn thuốc cũ chi tiết.
Lịch hẹn cũ.

Hỗ trợ import

Họ tên, SĐT, tuổi, địa chỉ, giới tính.
Ghi chú lịch sử điều trị (free text).
Công nợ còn lại tại thời điểm migrate.
Lịch sử điều trị có dữ liệu răng FDI (xem TREATMENT_PLAN_SEED ở trên).
Tag BN (VIP, marketing, v.v. — nếu có cột riêng).

Chiến lược với hồ sơ giấy cũ

Nếu bạn chỉ có hồ sơ giấy cứng (không Excel), bạn có thể:

Nhập danh sách BN cơ bản vào Excel (ít nhất: tên, SĐT, địa chỉ).
Import vào DentIQ.
Khi bác sĩ khám BN, bác sĩ xem hồ sơ giấy cũ → ghi chẩn đoán mới vào DentIQ.
Tối ưu: scan/chụp hồ sơ giấy → upload ở mục Files trong Patient 360.

Cập nhật dữ liệu sau import

Nếu phát hiện lỗi sau import (họ tên sai, SĐT sai), bạn có thể:

Vào Patient 360 của BN đó → chỉnh thông tin (yêu cầu quyền patient.manage).
Hoặc merge 2 BN: Patient 360 → Menu → Merge into…