# danghong.me Docs

> Nguồn sự thật của hệ sinh thái danghong.me: brief từng site (danghong.me, ai, ielts, nextstep, media, docs) và phần dùng chung. Single source of truth for the danghong.me ecosystem: per-site briefs and the shared layer.

Tài liệu viết bằng tiếng Việt; định danh, route và tên file bằng tiếng Anh. Mỗi trang có frontmatter `description` (VI) và `description_en` (EN). Mỗi trang có bản Markdown ở cùng đường dẫn cộng đuôi `.md`. Luật đọc và viết: https://docs.danghong.me/conventions.md

## Table of Contents

### Bắt đầu

- [Documentation Conventions](https://docs.danghong.me/conventions.md): Luật viết docs.danghong.me: tổ chức theo site, phần dùng chung, frontmatter, song ngữ, vòng đời trang và cổng kiểm.

### Hệ sinh thái (dùng chung)

- [Identity — Hồng là ai](https://docs.danghong.me/ecosystem/identity.md): Bản chuẩn về Hồng Đặng: định vị Learning Architect, tuyên ngôn, hành trình, 5 niềm tin, vai trò trong từng brand và kênh liên hệ.
- [Brand Architecture](https://docs.danghong.me/ecosystem/brand-architecture.md): Quan hệ giữa brand mẹ danghong.me và Sư Tử Con, Nemo12, Next Step: site nào thuộc brand nào, nguồn sự thật của brand nằm ở đâu.
- [Audiences](https://docs.danghong.me/ecosystem/audiences.md): Bản đồ người đọc của từng site trong hệ danghong.me: ai, cần gì, theme và giọng văn nào, CTA chính. Chi tiết nằm trong brief từng site.
- [Content Standards](https://docs.danghong.me/ecosystem/content-standards.md): Nguyên tắc viết nội dung chung cho mọi site danghong.me: viết để làm được việc, 3S, bình dân học vụ, cấu trúc Tôi muốn. Giọng riêng theo brief từng site.
- [Quality — Non-Functional Requirements](https://docs.danghong.me/ecosystem/quality.md): Yêu cầu phi chức năng cho mọi site danghong.me: hiệu năng, độ tin cậy, bảo mật, truy cập, SEO và cổng kiểm docs, kèm hiện trạng từng mục.
- [Design System](https://docs.danghong.me/ecosystem/design-system.md): Design system ba tầng của hệ danghong.me: lõi dùng chung, theme theo brand (danghong, Sư Tử Con, Nemo12, Next Step), ngoại lệ theo site.
- [Infrastructure — Domains, DNS, Cloudflare](https://docs.danghong.me/ecosystem/infrastructure.md): Hạ tầng hệ danghong.me: mỗi subdomain chạy ở đâu, build từ thư mục nào, DNS trỏ về đâu, hai account Cloudflare, và subdomain đang lên kế hoạch.
- [Data — D1, R2 and JSON API](https://docs.danghong.me/ecosystem/data.md): Dữ liệu dùng chung của hệ danghong.me: D1 và R2 danghong-media, các bảng và collection, cách danghong.me đọc lúc build, JSON API công khai.
- [Deployment — CI and Cloudflare Pages](https://docs.danghong.me/ecosystem/deployment.md): Cách build và deploy từng site danghong.me lên Cloudflare Pages: CI, GitHub Actions, wrangler, token, Access cho admin media, kiểm tra sau deploy.
- [Engineering Standards](https://docs.danghong.me/ecosystem/engineering.md): Quy chuẩn code chung cho repo danghong.me: TypeScript, đặt tên, Git, CI, chạy local, docs đi cùng code, làm việc với AI agent.

#### Design system

- [Design System Core](https://docs.danghong.me/ecosystem/design-system/core.md): Lõi design system dùng chung cho mọi site danghong.me: lưới, breakpoint, độ dài dòng, chữ co giãn, truy cập, tên token, footer hệ sinh thái.
- [Theme danghong — Warm Apple x YC](https://docs.danghong.me/ecosystem/design-system/themes/danghong.md): Theme của brand mẹ danghong (danghong.me, media, docs): triết lý 30% Apple x 70% YC, bảng màu Warm Beige và Luxury Crimson, font Inter.
- [Theme Sư Tử Con](https://docs.danghong.me/ecosystem/design-system/themes/sutucon.md): Theme Sư Tử Con cho ai.danghong.me: lấy nguyên từ brand gốc sutucon.com, docs chỉ link tới nguồn, không chép giá trị token.
- [Theme Nemo12](https://docs.danghong.me/ecosystem/design-system/themes/nemo12.md): Theme Nemo12 cho ielts.danghong.me: lấy nguyên từ design system của Nemo12 (DS-001 trên docs.nemo12.com), docs chỉ link tới nguồn.
- [Theme Next Step](https://docs.danghong.me/ecosystem/design-system/themes/nextstep.md): Theme Next Step cho nextstep.danghong.me: lấy nguyên từ brand gốc nextstep27.com, docs chỉ link tới nguồn, không chép giá trị token.

### danghong.me

- [danghong.me Brief](https://docs.danghong.me/sites/www/brief.md): Brief của danghong.me (brand mẹ): vị thế Learning Architect, bài toán, mục tiêu, người đọc Outcome-Driven Architect, user story, chỉ số North Star.
- [danghong.me Sitemap](https://docs.danghong.me/sites/www/sitemap.md): Sitemap của danghong.me: 5 mục Mega Menu, route chi tiết, trang ẩn, quy tắc điều hướng, Page Navigation, Hồng's List 4D và các tab About.
- [danghong.me Content — Products Catalog](https://docs.danghong.me/sites/www/content.md): Danh mục nội dung danghong.me: 14 sản phẩm (hệ thống, trải nghiệm, Gemini Gems, công cụ), sách Learning Design, newsletter, cách thêm vào D1.
- [danghong.me Design](https://docs.danghong.me/sites/www/design.md): Thiết kế riêng của danghong.me trên nền theme danghong: Navbar Glassmorphism, Outcome Card, Hero song ngữ, Community Gallery, Footer, Page Navigation.
- [danghong.me Ops](https://docs.danghong.me/sites/www/ops.md): Vận hành danghong.me: build và deploy qua Cloudflare Pages Git, xuất bản nội dung từ media admin, biến môi trường, kiểm tra sau deploy, việc còn mở.
- [danghong.me Web Architecture](https://docs.danghong.me/sites/www/architecture.md): Kiến trúc kỹ thuật danghong.me: Next.js 16 static export, cấu trúc thư mục, rendering, localStorage, hiệu năng, thuật ngữ và câu hỏi kiểm tra.
- [Quiz Standards — 3-Layer Verification](https://docs.danghong.me/sites/www/quiz-standards.md): Chuẩn quiz 3 lớp (trắc nghiệm, giải thích, đào sâu) cho bộ sách Learning Design trên danghong.me, kèm trạng thái triển khai hiện tại.

### ai.danghong.me · Sư Tử Con

- [ai.danghong.me Brief](https://docs.danghong.me/sites/ai/brief.md): Brief của ai.danghong.me: Hồng trong Sư Tử Con, người đọc, mục tiêu, giọng văn, CTA và phạm vi. Bản nháp, site chưa chạy.
- [ai.danghong.me Sitemap](https://docs.danghong.me/sites/ai/sitemap.md): Sitemap dự kiến của ai.danghong.me: các trang chính và CTA dẫn về Sư Tử Con. Bản nháp, chưa có route thật.
- [ai.danghong.me Content](https://docs.danghong.me/sites/ai/content.md): Nội dung dự kiến của ai.danghong.me: loại nội dung, nguồn dữ liệu, phần nào link sang Sư Tử Con. Bản nháp.
- [ai.danghong.me Design](https://docs.danghong.me/sites/ai/design.md): Thiết kế của ai.danghong.me: dùng nguyên theme Sư Tử Con từ brand gốc, lõi design system chung, footer hệ sinh thái.
- [ai.danghong.me Ops](https://docs.danghong.me/sites/ai/ops.md): Vận hành dự kiến của ai.danghong.me: chưa có mã nguồn, Pages project hay DNS; các bước để dựng site.

### ielts.danghong.me · Nemo12

- [ielts.danghong.me Brief](https://docs.danghong.me/sites/ielts/brief.md): Brief của ielts.danghong.me: Hồng trong Nemo12, người đọc, mục tiêu, giọng văn, CTA và phạm vi. Bản nháp, site chưa chạy.
- [ielts.danghong.me Sitemap](https://docs.danghong.me/sites/ielts/sitemap.md): Sitemap dự kiến của ielts.danghong.me: các trang chính và CTA dẫn về Nemo12. Bản nháp, chưa có route thật.
- [ielts.danghong.me Content](https://docs.danghong.me/sites/ielts/content.md): Nội dung dự kiến của ielts.danghong.me: loại nội dung, nguồn dữ liệu, phần nào link sang Nemo12. Bản nháp.
- [ielts.danghong.me Design](https://docs.danghong.me/sites/ielts/design.md): Thiết kế của ielts.danghong.me: dùng nguyên theme Nemo12 từ brand gốc, lõi design system chung, footer hệ sinh thái.
- [ielts.danghong.me Ops](https://docs.danghong.me/sites/ielts/ops.md): Vận hành dự kiến của ielts.danghong.me: chưa có mã nguồn, Pages project hay DNS; các bước để dựng site.

### nextstep.danghong.me · Next Step

- [nextstep.danghong.me Brief](https://docs.danghong.me/sites/nextstep/brief.md): Brief của nextstep.danghong.me: Hồng trong Next Step, người đọc, mục tiêu, giọng văn, CTA và phạm vi. Bản nháp, site chưa chạy.
- [nextstep.danghong.me Sitemap](https://docs.danghong.me/sites/nextstep/sitemap.md): Sitemap dự kiến của nextstep.danghong.me: các trang chính và CTA dẫn về Next Step. Bản nháp, chưa có route thật.
- [nextstep.danghong.me Content](https://docs.danghong.me/sites/nextstep/content.md): Nội dung dự kiến của nextstep.danghong.me: loại nội dung, nguồn dữ liệu, phần nào link sang Next Step. Bản nháp.
- [nextstep.danghong.me Design](https://docs.danghong.me/sites/nextstep/design.md): Thiết kế của nextstep.danghong.me: dùng nguyên theme Next Step từ brand gốc, lõi design system chung, footer hệ sinh thái.
- [nextstep.danghong.me Ops](https://docs.danghong.me/sites/nextstep/ops.md): Vận hành dự kiến của nextstep.danghong.me: chưa có mã nguồn, Pages project hay DNS; các bước để dựng site.

### media.danghong.me

- [media.danghong.me Brief](https://docs.danghong.me/sites/media/brief.md): Brief của media.danghong.me: kho tư liệu chính thức về Hồng cho báo chí và đối tác, đồng thời là kho dữ liệu D1/R2 và trang admin cho cả hệ.
- [media.danghong.me Sitemap](https://docs.danghong.me/sites/media/sitemap.md): Sitemap của media.danghong.me: các trang công khai (giới thiệu, câu chuyện, con người, album, links, video, tài liệu), trang admin và JSON API.
- [media.danghong.me Content](https://docs.danghong.me/sites/media/content.md): Nội dung của media.danghong.me: loại tư liệu đang có và cần có, dữ liệu trong D1/R2, JSON API công khai để các site khác dùng lại.
- [media.danghong.me Design](https://docs.danghong.me/sites/media/design.md): Thiết kế của media.danghong.me: dùng theme danghong, có dark mode theo hệ điều hành, lưới ảnh và lightbox; ngoại lệ so với lõi design system.
- [media.danghong.me Ops](https://docs.danghong.me/sites/media/ops.md): Vận hành media.danghong.me: cấu trúc code, xử lý request, phân quyền admin bằng Cloudflare Access, cách thêm/bớt nội dung, giới hạn, chạy local, sao lưu.

### docs.danghong.me

- [docs.danghong.me Brief](https://docs.danghong.me/sites/docs/brief.md): Brief của docs.danghong.me: nguồn sự thật duy nhất cho hệ danghong.me, phục vụ Hồng và AI agent, tổ chức theo site cộng lớp dùng chung.
- [docs.danghong.me Sitemap](https://docs.danghong.me/sites/docs/sitemap.md): Sitemap của docs.danghong.me: trang chủ, lớp dùng chung, thư mục từng site, quyết định, nhật ký, audit, cùng llms.txt và bản .md.
- [docs.danghong.me Content](https://docs.danghong.me/sites/docs/content.md): Nội dung của docs.danghong.me: loại trang (brief, sitemap, content, design, ops, theme, ADR), trang bắt buộc và tuỳ chọn cho mỗi site.
- [docs.danghong.me Design](https://docs.danghong.me/sites/docs/design.md): Thiết kế của docs.danghong.me: VitePress default theme với màu theme danghong, dark mode của VitePress, trang chủ dạng bảng thay cho hero.
- [docs.danghong.me Ops](https://docs.danghong.me/sites/docs/ops.md): Vận hành docs.danghong.me: chạy local, cổng kiểm npm run check, build, deploy bằng wrangler, chuyển hướng URL cũ, việc còn mở.

### Quyết định & lịch sử

- [Decisions](https://docs.danghong.me/decisions.md): Danh sách quyết định kiến trúc (ADR) ảnh hưởng nhiều site trong hệ danghong.me, kèm ngày và trạng thái.
- [ADR-001 — Site-based docs](https://docs.danghong.me/decisions/adr-001-site-based-docs.md): ADR-001: tổ chức docs.danghong.me theo site (www, ai, ielts, nextstep, media, docs) cộng lớp ecosystem dùng chung, bỏ cấu trúc A/B/C.
- [ADR-002 — Brand themes from source](https://docs.danghong.me/decisions/adr-002-brand-themes-from-source.md): ADR-002: theme Sư Tử Con, Nemo12, Next Step lấy nguyên từ brand gốc; docs chỉ link tới nguồn token, không chép giá trị màu.
- [ADR-003 — Content in D1 and R2](https://docs.danghong.me/decisions/adr-003-content-in-d1-r2.md): ADR-003: GitHub chỉ giữ code; ảnh, link, PDF và nội dung site nằm trong Cloudflare D1/R2, sửa qua media admin chỉ cho một email.
- [Log — Requests and Changes](https://docs.danghong.me/log.md): Nhật ký docs.danghong.me: yêu cầu đầu vào từ Hồng và các thay đổi lớn của tài liệu, theo ngày, mới nhất ở trên.