Files

T

VuQuangBao 981a4968da Rewrite README for what this repo actually is

The old one was a verbatim copy of the real product's README: claimed
'live in production at realvuxbaro.me' (a different site), pointed at
docs-legacy/ (just removed), and said the team's Gitea 'has not
started' while sitting inside it. Replaced with an honest description
of this repo's actual purpose -- an isolated GitOps demo -- and its
real state.

2026-08-25 17:37:41 +07:00

3.0 KiB

Raw Blame History

Dược Thư RAG — Demo GitOps trên Gitea cá nhân

Chatbot y dược tra cứu Dược thư Quốc gia Việt Nam 2018, có căn cứ trích dẫn trang thật cho từng câu trả lời. Repo này là bản demo độc lập, dựng lại để chứng minh một điều cụ thể: toàn bộ hạ tầng có thể chạy qua GitOps đọc từ Gitea cá nhân (git.vinmec.tech/VuQuangBao), thay vì GitHub — cùng kiến trúc, khác nguồn Git, khác hạ tầng vật lý, không đụng gì tới sản phẩm chính hay hạ tầng của team.

Chạy thật tại: https://finalduocthu.realvuxbaro.me

Trạng thái

Phần	Thế nào
Corpus	15.100 chunk, embed và nạp vào Qdrant `duocthu_v1`
Chat	RAG có căn cứ — chỉ định, chống chỉ định, ADR theo tần suất, tương tác thuốc, thận trọng thai kỳ, giữ ngữ cảnh nhiều lượt
Eval toàn sách	673/684 (98,4%) trả lời được trong phạm vi có thể trả lời
ArgoCD	4 Application: `clickhouse-operator`, `langfuse`, `medical-chatbot-app`, `medical-chatbot-data` — tất cả đọc từ repo này
Quan sát	Grafana (độ trễ, phân bố quyết định, lỗi provider) + Langfuse tự host (trace từng bước xử lý, chi phí thật theo token)

Hai năng lực chưa có: tính liều theo cân nặng, so sánh nhiều thuốc. Đo trực tiếp và ghi lại trung thực tại apps/ai-service/evals/known_gaps.jsonl, không phải suy đoán. Xem thêm ở docs/rag-chat.md.

Đọc gì trước

Bắt đầu ở docs/README.md — bộ tài liệu chuẩn của dự án (kiến trúc, ingestion, RAG/chat, local dev, vận hành, API, cấu hình, eval). Bộ tài liệu này mô tả sản phẩm, không riêng cho bản demo — máy demo chỉ khác ở nguồn Git và hạ tầng chạy, hành vi chatbot thì y hệt.

Cấu trúc

apps/
  web/            Next.js — giao diện chat + BFF
  ai-service/     Python FastAPI — pipeline RAG, gọi AWS Bedrock
  api-gateway/    NestJS — cổng vào công khai
  auth-service/   NestJS — đăng ký/đăng nhập/JWT
packages/         DTO dùng chung, HTTP client, UI components
ingestion/        pipeline offline: PDF -> chuyên luận -> chunk -> embedding -> Qdrant
infra/helm/       Helm chart 4 Application đọc bởi ArgoCD (chart giống hệt production)
docs/             tài liệu chuẩn của dự án

Vì sao repo này tồn tại

Không phải để thay thế sản phẩm chính. Team dùng git.vinmec.tech/ai-team/* cho hạ tầng thật — repo này nằm trong namespace cá nhân (VuQuangBao/duocthu), tách biệt hoàn toàn: EC2 riêng, cluster k3s riêng, Postgres/Qdrant riêng, ArgoCD riêng, Langfuse riêng. Mục đích duy nhất: chứng minh khả năng migrate GitOps sang Gitea mà không đổi gì về kiến trúc hay hành vi hệ thống.