39 lines
2.0 KiB
Markdown
39 lines
2.0 KiB
Markdown
# 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](architecture.md) |
|
|
| Hiểu hoặc xây lại PDF corpus | [Pipeline PDF và ingestion](pdf-ingestion.md) |
|
|
| Hiểu query, retrieval và chat | [Pipeline RAG và chat](rag-chat.md) |
|
|
| Cài đặt, chạy local và test | [Phát triển local](local-development.md) |
|
|
| Deploy, rollback, trace hoặc xử lý lỗi | [Vận hành](operations.md) |
|
|
| Tra endpoint, DTO và reason code | [HTTP API](api-reference.md) |
|
|
| Tra env, chunk schema và datastore | [Cấu hình và dữ liệu](configuration.md) |
|
|
| Đánh giá guardrail và giới hạn | [Đánh giá và an toàn](evaluation-safety.md) |
|
|
| Cập nhật hoặc duyệt tài liệu | [Chính sách tài liệu](documentation-policy.md) |
|
|
|
|
## Đường đọc đề xuất
|
|
|
|
Người mới bắt đầu với [Phát triển local](local-development.md), sau đó đọc
|
|
[Kiến trúc](architecture.md) và [RAG/chat](rag-chat.md). Người vận hành bắt đầu từ
|
|
[Vận hành](operations.md), dùng [API](api-reference.md) và
|
|
[Cấu hình](configuration.md) 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.
|
|
|