Tủ tài liệu

Ngoài các trang trên site này, kho mã nguồn còn 219 tệp tài liệu viết rải rác qua nhiều đợt. Trang này là bản đồ của toàn bộ số đó: tài liệu nào còn hiệu lực, tài liệu nào đã bị thay thế, và tài liệu nào thuộc sản phẩm khác.

Thứ tự ưu tiên khi có mâu thuẫn

1. Các trang trên docs.conan.school, được kiểm chứng lại với cơ sở dữ liệu production, có hiệu lực cao nhất
2. Tài liệu trong kho mã nguồn, bối cảnh và chi tiết thiết kế
3. Bình luận trong code, chi tiết triển khai

Nếu một tài liệu trong kho mâu thuẫn với trang trên site này, trang trên site đúng.

Đã được thay thế bởi site này

Những tài liệu sau vẫn nằm trong kho nhưng nội dung đã được kiểm chứng lại và viết mới ở đây:

Tài liệu trong kho	Trang thay thế
api.conan.school/docs/SYSTEM_DESIGN.md	Bản đồ nền tảng
api.conan.school/docs/08-database-schema.md	Mô hình dữ liệu
docs/architecture/CLOUDFLARE_ONLY_INVARIANT.md	Quy tắc triển khai
docs/product/COURSE_INFORMATION_SYSTEM.md	Mô hình chương trình học
docs/member-intelligence/SYSTEM_DESIGN.md	Learner Model & Recommendation
com.conan.school/docs/WEBSITE_AUDIT_2026-07-19.md	Rà soát tính năng

Còn hiệu lực: nên đọc khi cần

Nền tảng và API

Tệp	Nội dung
api.conan.school/docs/ENDPOINTS_REFERENCE.md	Danh mục endpoint đầy đủ
api.conan.school/docs/API_STANDARDS.md	Chuẩn đặt tên, mã lỗi, phân trang
api.conan.school/docs/ENV_SETUP.md	Biến môi trường và secret
docs/architecture/SPA_POLICY.md	Quy tắc SPA và định tuyến
docs/architecture/FRAMEWORK_MIGRATION.md	Lịch sử chuyển đổi framework

Sản phẩm Tokyo

Tệp	Nội dung
com.conan.school/docs/PRD.md	Yêu cầu sản phẩm cổng thành viên
com.conan.school/docs/ui-style-guide.md	Hướng dẫn giao diện
com.conan.school/docs/WEBSITE_QUALITY_STANDARDS.md	Chuẩn chất lượng
docs/product/TOKYO_COMMUNITY.md	Định vị Tokyo Community
docs/product/CONAN_SCHOOL_POSITIONING.md	Định vị thương hiệu
docs/product/CONAN_SCHOOL_CONTENT_STANDARD.md	Chuẩn nội dung

Hệ thống con

Nhóm tệp	Nội dung
docs/announcements_system_{design,requirements}.md	Hệ thống thông báo
docs/presence_system_{design,requirements}.md	Hệ thống hiện diện
docs/referral_system_{design,requirements}.md	Hệ thống giới thiệu
docs/membership-trial-policy.md	Chính sách dùng thử và thành viên
docs/rafiki-*.md (5 tệp)	Trí tuệ khái niệm, quiz review, giao diện tiết lộ dần

Chuẩn website

website-standards/ (5 tệp) · www.conan.school/docs/website-quality-standards.md · www.conan.school/docs/website-operations-runbook.md

Hệ thống AI-native

docs/ai-native-feature-system/ (8 tệp), mô hình miền, chuẩn artifact, lộ trình triển khai docs/ai-native-books/ (9 tệp) · docs/ai-native-content/ (7 tệp)

Quản trị

docs/admin-architecture/ (9 tệp, gồm 2 quyết định kiến trúc) · mentors.conan.school/docs/ (PRD, SDD)

Thuộc sản phẩm khác

Đừng nhầm những tài liệu này với nền tảng Conan School:

Thư mục	Sản phẩm
docs/capos.conan1.com/ (33 tệp)	CAPOS, sản phẩm riêng, có PRD/SDD/hạ tầng riêng
docs/compass27/ (10 tệp)	Compass27, sản phẩm riêng

Rà soát lịch sử

api.conan.school/docs/audits/ chứa 18 bản rà soát theo từng khoá học (ai-master.md, close-sales.md, customer-decode.md…) cùng global_scorecard.md. Đây là ảnh chụp tại thời điểm rà soát, hữu ích để đối chiếu, nhưng không phản ánh trạng thái hiện tại. Trạng thái hiện tại xem Rà soát tính năng.

Các bản rà soát một lần khác: docs/affiliate_audit_report.md, docs/www-conan-school-audit-2026-07-19.md, com.conan.school/docs/FEATURE_AUDIT_BOOKS_CHATBOT_2026-07-20.md, com.conan.school/docs/UI_SHELL_AUDIT_2026-07-23.md.

Quy trình làm việc

docs/CODEX_WORKING_AGREEMENT.md và docs/working-with-codex-common-failures.md ghi lại thoả thuận làm việc với trợ lý AI và các lỗi thường gặp. Phần quan trọng nhất, không deploy từ máy local, ba cạm bẫy dữ liệu, đã được đưa lên Quy tắc triển khai và Mô hình dữ liệu.

Khi viết tài liệu mới

Viết thẳng vào docs.conan.school/ chứ đừng thêm tệp rời rạc vào kho. Nếu nội dung thuộc một trang đã có, hãy sửa trang đó, mục tiêu là giữ một nguồn sự thật duy nhất, không phải thêm một tệp nữa vào 219 tệp trên.