Appearance
Single source of truth
Mỗi loại thông tin chỉ có một nơi chuẩn, để không phải hỏi "bản nào mới nhất".
| Loại thông tin | Nơi chuẩn | Ai sửa, sửa thế nào |
|---|---|---|
| Dữ liệu vận hành của từng brand: lịch, agenda, checklist, rủi ro, rubrics, reflection, action | Planner (D1) | Mentor sửa trực tiếp trên web |
| Template gốc cho brand mới | Planner (D1), menu Template | Mentor sửa trên web (xem) |
| Lý do & quy ước: JTBD, cách sắp xếp, playbook, design system, mô hình dữ liệu, deploy | Docs (VitePress) | Sửa file Markdown trong docs/guide/, commit |
| Tài liệu khoá học (vd AI Teen · Course Design) | Docs (VitePress) | Sửa Markdown, commit |
Còn seed/brands/*.json và trang docs/brands/*.md là gì?
Chúng là bản chụp lúc khởi tạo từ các Google Docs cũ, dùng đúng một lần để nạp D1. Sau khi D1 có dữ liệu, mentor chỉnh trên web nên bản chụp sẽ cũ dần. Mỗi trang brand trong docs đều có ghi chú "Snapshot lúc khởi tạo" để không bị hiểu nhầm.
Quy ước
- Không sửa dữ liệu brand trong
seed/haydocs/brands/*.mdđể thay đổi Planner. Chúng không đồng bộ ngược. - Không sửa tay
migrations/0002_seed.sqlvàdocs/brands/*.md, chúng được sinh bằngnpm run seed. npm run db:seed:remotetừ chối chạy khi D1 đã có brand, nên không thể vô tình xoá chỉnh sửa của mentor.