# 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.