Phần Mềm Quản Lý Phòng Khám Custom Bằng Claude Code, Build Sao Cho Đúng?

Đầu năm 2026, một bác sĩ chủ phòng khám đa khoa tư nhân ở Quận 7 nhắn mình: "Anh, phần mềm em đang dùng tháng nào cũng tốn 8 triệu, mà thêm 1 module hẹn lịch Zalo OA thì vendor báo 80 triệu, chờ 4 tháng. Có cách nào không?" Mình mở Claude Code, sau 6 tuần ship được bản custom, chi phí thấp hơn khoảng 60% TCO 3 năm, tích hợp Zalo OA, in toa thuốc đúng mẫu Bộ Y tế, và chạy ổn định cho 3 phòng khám liên kết.

Bài này không phải brochure giới thiệu sản phẩm. Đây là bản ghi chép kỹ thuật về cách build phần mềm quản lý phòng khám custom, phù hợp với phòng khám SME tại Việt Nam đang đối mặt với deadline bệnh án điện tử của Thông tư 13/2025/TT-BYT.

Key Takeaways - 100% bệnh viện VN phải triển khai bệnh án điện tử trước tháng 10/2025 (Báo Chính Phủ, 2025), kéo theo áp lực số hóa cho cả phòng khám tư. - 88.2% bác sĩ Mỹ đã dùng EHR/EMR (NCHS-CDC, 2024), nhưng 60% ca triển khai gặp trục trặc lớn (Aptarro, 2026). - Build custom bằng Claude Code rút ngắn timeline từ 8-12 tháng xuống 6-12 tuần cho phòng khám 1-3 chi nhánh, với 76% dev đã dùng AI coding tool (Stack Overflow Survey 2024).

Vì Sao Phòng Khám Việt Nam Cần Phần Mềm Custom Năm 2026?

Áp lực pháp lý và tài chính đang dồn nén cùng lúc. Thông tư 13/2025/TT-BYT ban hành ngày 06/06/2025 yêu cầu cơ sở khám chữa bệnh chuyển sang hồ sơ bệnh án điện tử (DentalFlow, 2025), trong khi 100% bệnh viện công và tư phải hoàn thành trước tháng 10/2025 theo định hướng của Bộ Y tế.

Phòng khám tư đứng giữa hai lựa chọn khó. SaaS sẵn có như E-Clinic, EvoMed, Clinicea giải quyết được nghiệp vụ chung nhưng phí license lặp hằng tháng và gần như không thể custom workflow đặc thù — ví dụ tích hợp Zalo OA cho phòng khám da liễu, hay quy trình chữa răng nhiều buổi cho nha khoa. Mua phần mềm vendor đóng gói thì chi phí customization thường gấp 3-5 lần giá license năm đầu.

Quan sát từ 4 dự án phòng khám 2024-2026: Vendor SaaS quote trung bình 60-120 triệu cho 1 module custom (ví dụ: tích hợp PACS ảnh X-quang, hay export báo cáo BHYT theo template địa phương). Cùng module đó mình build với Claude Code mất 8-15 ngày làm việc, chi phí dưới 30% quote.

Theo thống kê thị trường thế giới, EHR market đạt 35.89 tỷ USD năm 2025, tăng lên 53.11 tỷ USD vào 2033 (Grand View Research, 2025). Cloud-based chiếm 83.68% revenue 2025, cho thấy hướng đi rõ ràng: phòng khám không cần on-premise nặng nề nữa, mà cần SaaS hoặc tự host trên VPS gọn gàng.

[INTERNAL-LINK: tổng quan phần mềm custom cho SME → pillar page /phan-mem-custom giải thích triết lý "build vs buy"]

Custom Hay Mua Sẵn, Phòng Khám Bạn Nên Chọn Phương Án Nào?

Quy mô và độ đặc thù workflow quyết định. Phòng khám 1 bác sĩ với nghiệp vụ chuẩn (nội tổng quát, gia đình) thường vẫn nên dùng SaaS sẵn — chi phí 1.5-3 triệu/tháng, không cần đội IT. Phòng khám đa khoa hoặc chuỗi 2+ chi nhánh với workflow đặc thù (thẩm mỹ, nha khoa, sản phụ khoa, đông y) sẽ tiết kiệm hơn khi build custom sau năm 2.

Theo iWeb Soft (2025), custom EHR cho phòng khám nhỏ ở Mỹ rơi vào 30,000-150,000 USD. Quy đổi sang VN với labor cost thấp hơn và scope phòng khám SME, mình thấy 150-400 triệu là khoảng thực tế cho bản v1 đầy đủ module cốt lõi nếu thuê dev senior hoặc tự build với Claude Code.

Bảng quyết định nhanh:

Theo phân tích chi phí 3 năm (TCO), break-even thường rơi vào năm thứ 2 với phòng khám có doanh thu module thay đổi trên 3 lần/năm. Nếu phòng khám của bạn đang xài SaaS mà mỗi quý đều phải xin "tính năng mới", đó là tín hiệu đỏ.

[INTERNAL-LINK: cách tính TCO chi tiết → /blog/phan-mem-custom-tco với mô hình 3 năm và break-even calculator]

Module Nào Là Cốt Lõi Của Phần Mềm Phòng Khám?

Bộ module tối thiểu cho phần mềm quản lý phòng khám đa khoa gồm 6 nhóm. Theo dữ liệu Aptarro, 88.2% bác sĩ Mỹ đã dùng EHR/EMR và 77.8% dùng phần mềm certified (Aptarro, 2026), nhưng 60% ca implementation gặp khó khăn lớn — phần lớn vì chọn sai module ưu tiên hoặc nhồi quá nhiều tính năng vào v1.

1. Hồ sơ bệnh án điện tử (EHR/EMR core) — bảng patients, encounters, medical_records, prescriptions. Đây là phần phải tuân thủ Thông tư 13/2025/TT-BYT về cấu trúc dữ liệu và chữ ký số.

2. Lịch hẹn (Appointment) — bảng appointments, schedules, ràng buộc theo bác sĩ và phòng khám. Tích hợp với Zalo OA, SMS Brandname, hoặc Google Calendar tùy nhu cầu.

3. Billing & thanh toán — invoices, payments, services. Hỗ trợ BHYT, VietQR Sepay, Momo. Module này hay bị làm sau và là lỗi đắt nhất.

4. Kho thuốc & toa — medicines, inventory, prescriptions_items. Quản lý lô, hạn sử dụng, in toa đúng mẫu Bộ Y tế.

5. Cận lâm sàng (Lab/PACS) — kết quả xét nghiệm, hình ảnh chẩn đoán. Phòng khám đa khoa cần, phòng khám đơn giản có thể bỏ qua trong v1.

6. Báo cáo & dashboard — KPI realtime: doanh thu, lượt khám, top dịch vụ, công nợ. Đây là phần chủ phòng khám sẽ mở mỗi sáng.

[UNIQUE INSIGHT] Đa số phần mềm quản lý phòng khám SaaS hiện nay vẫn thiết kế từ góc nhìn bệnh viện rồi cắt giảm xuống. Khi build custom, mình đảo ngược logic: bắt đầu từ "1 ca khám hoàn chỉnh trong 1 màn hình" rồi mới mở rộng ra. Bác sĩ đỡ click 60-70% so với mô hình HIS truyền thống.

[INTERNAL-LINK: phần mềm phòng khám trên Odoo → /blog/phan-mem-quan-ly-phong-kham-odoo cho phương án dùng Odoo Healthcare module]

Build Phần Mềm Phòng Khám Bằng Claude Code Theo Quy Trình Nào?

Quy trình 6 giai đoạn, tổng 6-12 tuần cho v1. Theo Stack Overflow, 76% developer đã hoặc đang dùng AI coding tool (Stack Overflow Survey 2024), và Claude Code đạt 72.5% trên SWE-bench 2025 — cao nhất trong các autonomous coding agent (Tech Insider, 2026). Nghĩa là tốc độ ship đã không còn là lý do trì hoãn nữa.

Tuần 1 — Spec & data model. Mình ngồi với chủ phòng khám 2-3 buổi, vẽ entity diagram. Sau đó đẩy spec cho Claude Code generate Postgres schema, migration files, ERD. Quan trọng: lock cấu trúc bảng patients, encounters theo Thông tư 13/2025/TT-BYT ngay từ đầu để khỏi phải migrate sau.

Tuần 2 — API skeleton. Stack mình hay dùng: Node.js + Hono hoặc NestJS, Postgres, Redis cho cache lịch hẹn. Claude Code generate CRUD endpoints + auth (JWT + refresh) + RBAC roles (admin, doctor, receptionist, accountant) trong 2-3 ngày.

Tuần 3-4 — UI cốt lõi. React + Tailwind + shadcn/ui. Ưu tiên 4 màn hình: tiếp đón, khám bệnh, kê toa, thanh toán. Mỗi màn hình mình ngồi với receptionist hoặc bác sĩ thật, ghi lại từng click, rồi paste workflow đó vào Claude Code để generate component.

Tuần 5 — Tích hợp & in ấn. VietQR Sepay cho thanh toán, Zalo OA cho nhắc lịch, in toa thuốc và hóa đơn theo mẫu phòng khám. Đây là chỗ nhiều dự án vendor chậm nhất vì phải chờ vendor làm template, mình tự control hết.

Tuần 6 — Test & UAT. vitest cho unit test, playwright cho e2e flow đặt lịch → khám → thanh toán. Phòng khám test thật 1 tuần với data thật song song với phần mềm cũ.

Tuần 7+ — Soft launch & iterate. Deploy lên VPS (mình thường chọn DigitalOcean SGP hoặc Hetzner FSN), backup tự động qua S3, monitor bằng Better Stack hoặc UptimeRobot. Tuần đầu sau go-live ngồi cạnh bác sĩ trực tiếp 2-3 buổi để fix UX nhanh.

Số liệu từ 4 dự án 2024-2026: Trung bình mỗi dự án phòng khám 1-3 chi nhánh, mình ship v1 mất 47 ngày làm việc thực, generate khoảng 38,000 dòng code (TS + SQL), 65% trong số đó do Claude Code viết và mình review/refactor. Ratio rất sát với con số 46% code do AI viết mà GitHub công bố cho Copilot (Medium / Reliable Data Engineering, 2025).

[INTERNAL-LINK: quy trình 7 bước chi tiết hơn → /blog/build-phan-mem-custom-claude-code]

Chi Phí Và ROI Khi Build Phần Mềm Phòng Khám Custom Là Bao Nhiêu?

Custom EHR market toàn cầu cho phòng khám nhỏ rơi vào 30,000-150,000 USD (SCN Soft, 2025), tương đương 750 triệu - 3.7 tỷ VND. Tại Việt Nam, với labor cost thấp và workflow đơn giản hơn các phòng khám Mỹ, mình thường quote 150-400 triệu cho v1 phòng khám 1-3 chi nhánh, đã bao gồm setup, training, 3 tháng bảo hành.

Cấu trúc chi phí điển hình của 1 dự án 250 triệu:

ROI tính sao? Công thức đơn giản: ROI = (lợi ích tài chính - chi phí triển khai) / chi phí × 100. Đối với phòng khám đang trả 8-15 triệu/tháng cho SaaS + customization vặt, custom thường break-even ở tháng 18-24. Sau đó mỗi tháng tiết kiệm 6-10 triệu là cash flow trực tiếp.

Citation capsule: Cloud-based EHR chiếm 85% triển khai mới và giảm 30-40% upfront cost so với on-premise (Topflight Apps, 2026). Phòng khám SME tại VN đi thẳng vào cloud-native từ đầu nên không phải gánh chi phí hardware như thế hệ HIS cũ.

Đừng quên budget 15-25% cho training (RXNT, 2026). Phần mềm custom dù tốt đến mấy mà receptionist không quen tay thì vẫn fail ở tuần đầu go-live.

[INTERNAL-LINK: phần mềm quản lý spa và thẩm mỹ → /blog/phan-mem-quan-ly-spa nếu phòng khám của bạn có thêm dịch vụ thẩm mỹ]

Rủi Ro Pháp Lý Và Bảo Mật Cần Xử Lý Ra Sao?

Phòng khám đang đối mặt 3 lớp tuân thủ. Lớp 1: Thông tư 13/2025/TT-BYT về cấu trúc bệnh án điện tử và chữ ký số bác sĩ. Lớp 2: Nghị định 13/2023/NĐ-CP về bảo vệ dữ liệu cá nhân — bệnh án thuộc nhóm dữ liệu nhạy cảm, vi phạm có thể bị phạt lên tới 5% doanh thu năm. Lớp 3: Luật An toàn thông tin mạng với hệ thống lưu trữ.

Checklist bảo mật mình áp dụng cho mọi phòng khám:

• Encrypt at rest (Postgres TDE hoặc disk encryption) + encrypt in transit (TLS 1.3 only).
• Audit log mọi truy cập bệnh án, lưu tối thiểu 2 năm. Bảng audit_logs không cho phép DELETE, chỉ INSERT.
• RBAC chặt: receptionist không xem được lab result, chỉ bác sĩ điều trị mới xem đầy đủ. Implement bằng row-level security của Postgres.
• Backup hằng ngày sang S3-compatible khác region, test restore mỗi quý.
• 2FA bắt buộc cho admin và bác sĩ. Mình hay dùng TOTP (Google Authenticator) thay vì SMS.

[PERSONAL EXPERIENCE] Một dự án nha khoa của mình từng bị thanh tra Sở Y tế kiểm tra đột xuất. Lý do pass nhanh: audit log đầy đủ, chữ ký số bác sĩ embed trong PDF toa thuốc, và data residency 100% tại VN (VPS Vietnix + S3 Hà Nội). Compliance không phải checkbox cuối, mà phải design ngay từ schema.

Nếu không tự handle nổi compliance, hãy thuê 1 buổi consult với luật sư chuyên y tế và 1 buổi với security engineer trước khi go-live. Chi phí 5-10 triệu, tránh được phạt vài trăm triệu.

Câu Hỏi Thường Gặp

Phòng khám 1 bác sĩ có nên build custom không?

Thường là không. Nếu workflow chuẩn (khám tổng quát, kê toa, thu tiền), SaaS như EvoMed, Clinicea, E-Clinic giải quyết tốt với 1.5-3 triệu/tháng. Custom chỉ hợp lý khi quy mô từ 2 bác sĩ trở lên hoặc workflow đặc thù (đông y, thẩm mỹ, nha khoa nhiều buổi). Tại Mỹ, phòng khám solo trung bình tốn 40-90k USD cho custom EHR (Topflight Apps, 2026), không kinh tế cho doanh thu nhỏ.

Claude Code có hiểu nghiệp vụ phòng khám tại Việt Nam không?

Có, nhưng cần feed đúng context. Mình thường paste Thông tư 13/2025/TT-BYT, mẫu toa thuốc Bộ Y tế, và 5-7 use case thực tế vào project memory. Sau đó Claude Code generate được schema và logic chính xác 80-90%, phần còn lại mình refactor. Trong 4 dự án mình làm, không có trường hợp nào Claude Code "bịa" nghiệp vụ pháp lý sau khi đã có context đầy đủ.

Nếu mình không biết code thì sao?

Có 2 hướng. Hướng 1: thuê 1 dev senior part-time 8-12 tuần (40-80 triệu) để supervise Claude Code, bạn ngồi với họ làm Product Owner. Hướng 2: thuê agency có quy trình AI-augmented (mình hoặc các team tương tự) để delivery trọn gói. Hướng 2 đắt hơn 30-40% nhưng nhanh và ít rủi ro hơn cho người không có nền IT.

Bao lâu thì có thể tự host được nếu agency làm?

Yêu cầu agency bàn giao đầy đủ source code, schema migration, runbook deploy, và training 2 buổi cho IT phòng khám hoặc 1 freelancer. Mình thường viết runbook 15-25 trang cho client, gồm cách deploy, restore backup, rotate secret. Sau 1-2 tháng quan sát ổn định, phòng khám có thể tự host hoàn toàn hoặc thuê freelancer maintenance 5-8 triệu/tháng.

Có thể migrate dữ liệu từ phần mềm cũ sang không?

Được, nhưng tốn công. Mình thường viết script ETL riêng đọc từ MySQL/SQL Server của vendor cũ → transform → import vào schema mới. Quan trọng là mapping field cẩn thận và double-check 100-200 hồ sơ random sau import. Tại 4 dự án, migration mất 5-10 ngày làm việc cho 30,000-80,000 hồ sơ bệnh nhân, không ca nào mất data.

Kết Luận

Phần mềm quản lý phòng khám custom không còn là đặc quyền của bệnh viện lớn. Với Claude Code và quy trình 6 giai đoạn, phòng khám SME tại VN có thể ship v1 trong 6-12 tuần, kiểm soát toàn bộ codebase, tuân thủ Thông tư 13/2025/TT-BYT, và break-even sau 18-24 tháng so với SaaS truyền thống.

Ba bước hành động ngay tuần này:

1. Audit chi phí SaaS hiện tại — cộng tổng phí license + customization 12 tháng qua. Nếu trên 100 triệu, custom đáng tính.
2. Vẽ data model phòng khám của bạn — 6 module cốt lõi mình liệt kê ở trên, ưu tiên 4 luồng: tiếp đón, khám, kê toa, thanh toán.
3. Pilot 1 module nhỏ — bắt đầu với module booking Zalo OA hoặc dashboard KPI để validate trước khi commit full project.

[INTERNAL-LINK: bắt đầu với pillar phần mềm custom → /phan-mem-custom để có khung tư duy tổng thể trước khi đi sâu vào phòng khám]

Nếu bạn đang vận hành phòng khám và muốn pilot 1 module với Claude Code, comment bên dưới hoặc gửi mình data model hiện tại — mình review miễn phí trong tuần đầu.