---
url: https://docs.nemo12.com/index.md
description: >-
  Mục lục duy nhất của docs Nemo12 (SRC-1024), xếp theo mảng sản phẩm, đọc được
  bởi người, máy và AI.
---

# 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](product/value-stream-exam-learners.md) | IELTS: [learner model](product/ielts-learner-model.md), [SDD-035](architecture/sdd-035-ielts-onboarding.md), [SDD-038](architecture/sdd-038/index.md), Journey Engine [PRD-005](product/prd-005-journey-engine.md) + [SDD-045](architecture/sdd-045-journey-engine.md) · app di động [PRD-010 NEMO IELTS](product/prd-010-nemo-ielts-app.md) + [SDD-055](architecture/sdd-055-nemo-ielts-app.md) · Customer understanding: [PRD-007 Gull](product/prd-007-gull.md) + [SDD-047](architecture/sdd-047-gull.md) · SAT: [PRD-004](product/prd-004-sat.md), [SDD-044](architecture/sdd-044-sat-practice.md) · ngân hàng đề, dashboard chương trình |
| **Học sinh & trí tuệ học tập** | [PRD-002](product/prd-002-learner-ux.md) | Trải nghiệm học, [năm dạng câu hỏi](architecture/sdd-022-experience-formats.md), mô hình và engine ([SDD-002](architecture/sdd-002-learner-intelligence/index.md)), [luồng người dùng WF](workflows/index.md) |
| **Gia đình & mentor** | [Parent JTBD](product/parent-jtbd.md) | Marlins, Dolphins, [PRD-003 Dory & Anchor](product/prd-003-dory-anchor.md), lịch, slot, sự kiện |
| **Web công khai** | [Public Web IA](product/public-web-ia.md) | [SDD-029](architecture/sdd-029-public-site-ia/index.md), [DS-001 Design System](design-system/index.md) |
| **Nội dung & chương trình** | [SDD-004](architecture/sdd-004-curriculum-storage.md) | Coral, Foundry, lab, [sửa nội dung AI Teen trong Dolphin (SDD-056)](architecture/sdd-056-ai-teen-content-editor.md), [chương trình theo môn](curriculum/index.md), tri thức theo môn |
| **Nền tảng** | [PRD-001](product/prd-001/index.md) | Kiến trúc ([SDD-001](architecture/sdd-001-platform.md)), [tham chiếu hệ thống đang chạy](reference/index.md) |
| **Chất lượng** | [Hệ tiêu chuẩn](quality/index.md) | [Quality Gates](quality/quality-gates.md), audit, độ phủ, [rà soát yêu cầu](quality/request-audit.md) |
| **Kỹ thuật & vận hành** | [Coding conventions](engineering/coding-conventions.md) | [sổ sự cố](engineering/incident-log/index.md) · runbook: [rollback](ops/rollback.md), [migration-order](ops/migration-order.md), [dlq-replay](ops/dlq-replay.md), [automerge](ops/automerge.md) · [tốc độ tích hợp](ops/ci-speed.md) · [cloud-dev](ops/cloud-dev.md) · [chi phí hạ tầng](ops/cost-audit.md) · [mm](ops/mm.md) · [ui](ops/ui.md) · [danh mục skill của agent](skills/index.md) |
| **Sổ sách** | [intake](intake.md) | [traceability](traceability.md), [open-questions](open-questions/index.md), [backlog](backlog.md) |
| **Chiến lược** | [Capital Map](strategy/nemo12-capital-map.md) | [Strategic Focus](strategy/strategic-focus.md), [Media Capital](strategy/media-capital.md) |

## 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](product/prd-001-nemo12-platform.md)) |
| 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](product/prd-001-nemo12-platform.md) → PRD của mảng → [traceability](traceability.md) → [rà soát yêu cầu](quality/request-audit.md) |
| Kỹ sư | [SDD-001](architecture/sdd-001-platform.md) → SDD của mảng → [reference/](reference/index.md) |
| Kiểm soát chất lượng | [quality-gates](quality/quality-gates.md) → [traceability](traceability.md) |
| AI agent | [conventions](conventions.md) → [reference/](reference/index.md) → skill `/intake`, `/trace-check` → frontmatter `satisfies`/`verified_by` |

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

1. **Một hệ tài liệu duy nhất**: mọi nguồn qua [intake.md](intake.md); không hai phiên bản song song.
2. **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.
3. **One World, One Learner, One Platform**: school là domain context, không phải hệ thống riêng.
4. Quyết định chưa được chủ dự án duyệt mang ký hiệu ✍️ trong [open-questions/index.md](open-questions/index.md).

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

1. Đặt file vào thư mục theo loại (bảng trên), frontmatter theo [conventions §3](conventions.md).
2. 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ỗ.
3. Dời hay đổi tên file: thêm một dòng vào `docs/public/_redirects` để link cũ không gãy.
4. `npm run check:docs` (cổng `check-docs-structure`) đỏ nếu quên bước 2 hoặc 3.