Nemo12 Documentation

Write once. Human-readable. Machine-readable. AI-readable.

Đây là mục lục DUY NHẤT của docs (SRC-1024, 24.09.2026). Thanh bên bên trái tự sinh từ cùng một nguồn (apps/docs/.vitepress/structure.mjs), xếp theo mảng sản phẩm; trang "Bản đồ tài liệu" cũ đã gộp vào đây.

Tìm theo mảng

Mảng	Bắt đầu từ	Gồm
Luyện thi	Value Stream IELTS · SAT · AP	IELTS: learner model, SDD-035, SDD-038, Journey Engine PRD-005 + SDD-045 · app di động PRD-010 NEMO IELTS + SDD-055 · Customer understanding: PRD-007 Gull + SDD-047 · SAT: PRD-004, SDD-044 · ngân hàng đề, dashboard chương trình
Học sinh & trí tuệ học tập	PRD-002	Trải nghiệm học, năm dạng câu hỏi, mô hình và engine (SDD-002), luồng người dùng WF
Gia đình & mentor	Parent JTBD	Marlins, Dolphins, PRD-003 Dory & Anchor, lịch, slot, sự kiện
Web công khai	Public Web IA	SDD-029, DS-001 Design System
Nội dung & chương trình	SDD-004	Coral, Foundry, lab, sửa nội dung AI Teen trong Dolphin (SDD-056), chương trình theo môn, tri thức theo môn
Nền tảng	PRD-001	Kiến trúc (SDD-001), tham chiếu hệ thống đang chạy
Chất lượng	Hệ tiêu chuẩn	Quality Gates, audit, độ phủ, rà soát yêu cầu
Kỹ thuật & vận hành	Coding conventions	sổ sự cố · runbook: rollback, migration-order, dlq-replay, automerge · tốc độ tích hợp · cloud-dev · chi phí hạ tầng · mm · ui · danh mục skill của agent
Sổ sách	intake	traceability, open-questions, backlog
Chiến lược	Capital Map	Strategic Focus, Media Capital

Tìm theo loại

Mỗi loại tài liệu vẫn nằm ở thư mục riêng, vì các cổng kiểm và nhiều phiên đang chạy dùng đường dẫn ấy. Mảng là lớp XẾP để đọc, không phải một lần dời file.

Loại	Thư mục	Mã
Yêu cầu sản phẩm	`product/`	PRD-xxx, REQ-<nhóm>-nn (bảng REQ chuẩn nằm ở PRD-001 §5)
Thiết kế hệ thống	`architecture/`	SDD-xxx
Luồng người dùng	`workflows/`	WF-xx
Tham chiếu hệ thống đang chạy	`reference/`	(một phần sinh tự động từ mã)
Chất lượng	`quality/`	QG-xxx, AS, CS
Kỹ thuật, vận hành	`engineering/`, `ops/`
Nội dung	`curriculum/`, `knowledge/`
Di sản chuyenchon	`legacy/`	RISK, FEAT, CC

Đọc theo vai trò

Bạn là	Đọc theo thứ tự
Người rà soát yêu cầu	PRD-001 → PRD của mảng → traceability → rà soát yêu cầu
Kỹ sư	SDD-001 → SDD của mảng → reference/
Kiểm soát chất lượng	quality-gates → traceability
AI agent	conventions → reference/ → skill `/intake`, `/trace-check` → frontmatter `satisfies`/`verified_by`

Bốn nguyên tắc lõi

Một hệ tài liệu duy nhất: mọi nguồn qua intake.md; không hai phiên bản song song.
Traceability 2 chiều bắt buộc (REQ-DOC-02): không REQ nào thiếu SDD/QG, không ý SDD nào thiếu REQ/US.
One World, One Learner, One Platform: school là domain context, không phải hệ thống riêng.
Quyết định chưa được chủ dự án duyệt mang ký hiệu ✍️ trong open-questions/index.md.

Thêm một tài liệu mới

Đặt file vào thư mục theo loại (bảng trên), frontmatter theo conventions §3.
Nếu là PRD, SDD hoặc file trong product/, thêm một dòng vào FILE_AREA trong apps/docs/.vitepress/structure.mjs. Thư mục khác tự có chỗ.
Dời hay đổi tên file: thêm một dòng vào docs/public/_redirects để link cũ không gãy.
npm run check:docs (cổng check-docs-structure) đỏ nếu quên bước 2 hoặc 3.

Nemo12 Documentation ​

Tìm theo mảng ​

Tìm theo loại ​

Đọc theo vai trò ​

Bốn nguyên tắc lõi ​