Cách cập nhật trang tài liệu¶

Trang này là site tĩnh (MkDocs Material) đưa lên Cloudflare Pages, project one-anna-docs. Không liên quan tới Worker one-anna-api — deploy trang tài liệu không đụng portal.

Thư mục trên Mac¶

~/one-anna-docs-site/ (nằm ngoài repo ANNA 2):

Đường dẫn	Nội dung
`docs/`	Nguồn Markdown: `00-tong-quan.md`, `NN-<module>/{tinh-nang,base-du-lieu,erd}.md`, `danh-sach-anh-can-chup.md`
`docs/NN-<module>/images/`	Ảnh của module (đang là ảnh giữ chỗ)
`site/`	Bản đã build, dùng để deploy
`mkdocs.yml`	Cấu hình site (menu bên trái)
`deploy.sh`	Thêm ảnh + build (nếu có MkDocs) + deploy
`ONE-ANNA-tai-lieu.docx`	Bản Word gộp

Thêm ảnh rồi deploy lại¶

Chụp theo Danh sách ảnh cần chụp; lưu PNG đúng tên file vào docs/NN-<module>/images/ (ghi đè ảnh giữ chỗ).
Chạy:
```
cd ~/one-anna-docs-site && ./deploy.sh
```
Script: nếu máy có mkdocs thì build lại toàn bộ; nếu không, chép ảnh từ docs/*/images/ sang site/*/images/ (đường dẫn ảnh trong site giống hệt). Sau đó chạy npx wrangler pages deploy site --project-name one-anna-docs --branch main.
Mở lại trang (Ctrl/Cmd + Shift + R để bỏ cache).

Sửa nội dung chữ¶

Sửa file .md trong docs/, rồi build lại bằng MkDocs:

python3 -m venv ~/.venv-mkdocs && ~/.venv-mkdocs/bin/pip install mkdocs-material
cd ~/one-anna-docs-site && PATH=~/.venv-mkdocs/bin:$PATH ./deploy.sh

Sơ đồ (mermaid) viết trong khối ```mermaid; site tự vẽ.

Phần sinh tự động¶

Các bảng cột trong Base dữ liệu và sơ đồ ERD được sinh tự động từ cấu trúc Lark Base (đọc qua API ngày 22/10/2026). Khi Base đổi cột nhiều, nên sinh lại thay vì sửa tay.