← Danh mục tài liệu · raw markdown

Tài liệu kỹ thuật VIETAL — dành cho AI Agent và quản trị viên

Thư mục này là nguồn tài liệu duy nhất cho agent làm việc trên hệ thống quản trị dự án VIETAL.

Đọc công khai tại https://dv.badt.vn/project/docs hoặc tải raw markdown tại /project/docs/{slug}.md

(agent có token có thể đọc qua GET /api/v1/docs và GET /api/v1/docs/{slug}).

SlugTệpNội dungAi đọc
indexREADME.mdDanh mục nàytất cả
agent-workspaceAGENT_WORKSPACE.mdPhân vai, kiến trúc truy cập, 27 endpoint, lease, quy ước nộp bài, phối hợp nhiều agent, bảo mậtagent + quản trị
agent-claudeAGENT_CLAUDE.mdSổ tay kết nối Claude: chuẩn bị token, 3 cách kết nối (MCP/Desktop/Code), 28 công cụ, 5 quy trình mẫu, mã lỗi, bảo mậtngười vận hành + Claude
de-anTOM_TAT_DE_AN.mdToàn bộ đề án: 13 mốc, 20 đầu việc, 32 chỉ số, 29 dòng ngân sáchagent cần ngữ cảnh
thiet-keTHIET_KE_HE_THONG.mdThiết kế hệ thống: CSDL, xác thực, giao diện, API, i18n, vận hànhkỹ thuật
openapiopenapi.yamlĐặc tả OpenAPI 3.0 của Agent APIagent tự cấu hình
mcp-benh-nhanMCP_BENH_NHAN.mdMCP bệnh nhân ảo (vp_mcp.py): 19 công cụ cho kho ca JSON và bộ giả lập, cách lấy cookie, cách dùng dòng lệnhagent làm nội dung ca bệnh
trao-doiQUY_UOC_TRAO_DOI.mdQuy ước trao đổi Ban điều hành ⇄ trợ lý: kênh nào dùng cho việc gì, tiền tố, nhịp, mẫu câu, điều cấmcả hai phía

Trang cấp token cho Claude

Mở https://dv.badt.vn/project/claude (cần đăng nhập) để cấp token, xem cấu hình MCP sẵn để dán

(Claude Desktop / .mcp.json), danh sách 28 công cụ và câu lệnh giao việc mẫu.

Tải công cụ

Thứ tự đọc gợi ý cho agent mới

1. agent-workspace mục 1–4 (phân vai, truy cập, bắt đầu, vòng đời việc).

2. agent-claude (cách kết nối đúng với Claude + danh sách tool).

3. de-an khi cần hiểu nội dung/chỉ số/ngân sách của dự án.

4. openapi.yaml khi cần sinh client hoặc kiểm tra schema.

Quy tắc chung

đọc nội dung đã bóc bằng GET /api/v1/documents/{id}.