2.0 KiB
Tài liệu chuẩn — VSF Dược thư
Bộ tài liệu chính thức đề xuất
Kiểm chứng lần cuối: 2026-08-14
Nguồn sự thật: code, cấu hình, migration, test và workflow trong repository
Tài liệu được giữ phẳng và gọn: mỗi file có một công việc đọc chính, nhưng không
tách một chủ đề thành quá nhiều trang ngắn. Các ghi chép cũ nằm trong
docs-legacy/ và chỉ dùng để tra lịch sử.
Đọc theo nhu cầu
| Bạn cần | Tài liệu |
|---|---|
| Hiểu thành phần và trạng thái dự án | Kiến trúc hệ thống |
| Hiểu hoặc xây lại PDF corpus | Pipeline PDF và ingestion |
| Hiểu query, retrieval và chat | Pipeline RAG và chat |
| Cài đặt, chạy local và test | Phát triển local |
| Deploy, rollback, trace hoặc xử lý lỗi | Vận hành |
| Tra endpoint, DTO và reason code | HTTP API |
| Tra env, chunk schema và datastore | Cấu hình và dữ liệu |
| Đánh giá guardrail và giới hạn | Đánh giá và an toàn |
| Cập nhật hoặc duyệt tài liệu | Chính sách tài liệu |
Đường đọc đề xuất
Người mới bắt đầu với Phát triển local, sau đó đọc Kiến trúc và RAG/chat. Người vận hành bắt đầu từ Vận hành, dùng API và Cấu hình làm tài liệu tra cứu.
Phạm vi
Bộ này mô tả implementation hiện có, không quảng bá roadmap thành tính năng.
Kubernetes/ArgoCD, service scaffold và kết quả benchmark đều được ghi đúng mức độ
kiểm chứng. Architecture Decision Records lịch sử vẫn nằm trong
docs-legacy/adr/ cho tới khi được rà soát và nhập lại có chọn lọc.