Appearance
Nemo12 Documentation
Write once. Human-readable. Machine-readable. AI-readable.
Canonical documentation source duy nhất của Nemo12 — con người đọc qua VitePress/Git, AI đọc trực tiếp qua frontmatter, CI kiểm freshness/links/traceability (QG-001).
Bản đồ tài liệu
text
docs/
├── index.md ← bạn đang ở đây
├── conventions.md # quy ước, ID scheme, frontmatter, lifecycle, quy trình intake
├── intake.md # sổ tiếp nhận nguồn (SRC-001..015)
├── open-questions.md # câu hỏi + câu trả lời + quyết định AI tự quyết (✍️)
├── traceability.md # ma trận SRC → REQ → SDD → QG → US
│
├── product/
│ ├── prd-001-nemo12-platform.md # PRD: vision, personas, JTBD, use cases, user stories, ~100 REQ
│ └── legacy-feature-inventory.md # FEAT-001..055 từ 2 hệ legacy, đánh dấu GAP
│
├── architecture/
│ ├── sdd-001-platform.md # Cloudflare, monorepo, API, auth, data, events
│ ├── sdd-002-learner-intelligence.md# models, engines, thuật toán, depth & stopping
│ ├── sdd-003-knowledge-quality.md # knowledge registry, graph, quality/improvement loop
│ ├── sdd-004-curriculum-storage.md # hierarchy, D1/R2/KV, experience types, item bank
│ ├── sdd-005-interaction.md # comments, visibility, mentions, moderation, timeline
│ ├── sdd-006-reliability.md # NFR: isolation, degradation, tiers, security, DR
│ ├── sdd-007-learner-orchestration.md # global orchestrator, workload, context builder
│ ├── sdd-008-overview-views.md # multi-dimensional views, goal view, drill-down
│ ├── sdd-009-media.md # media/image system (R2 + Images + moderation)
│ ├── sdd-010-lab-platform.md # 288 labs → 6 archetypes, engines + content migration
│ └── legacy-migration.md # RISK-001..030 + carry-overs + chiến lược migration
│
├── design-system/index.md # DS-001: tokens, themes per school, components, a11y
├── quality/quality-gates.md # QG-001..010
└── engineering/skills.md # bộ skill tái sử dụng (.claude/skills/)Đọc theo vai trò
| Bạn là | Đọc theo thứ tự |
|---|---|
| Người rà soát yêu cầu | PRD-001 → feature inventory → traceability |
| Kiến trúc sư / engineer | SDD-001 → SDD-002..010 → legacy-migration |
| Người kiểm soát chất lượng | quality-gates → traceability |
| AI agent | conventions → skill /intake, /trace-check → theo frontmatter satisfies/verified_by |
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.md.