Skip to content

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 tinNơi chuẩnAi 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, actionPlanner (D1)Mentor sửa trực tiếp trên web
Template gốc cho brand mớiPlanner (D1), menu TemplateMentor 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, deployDocs (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/ hay docs/brands/*.md để thay đổi Planner. Chúng không đồng bộ ngược.
  • Không sửa tay migrations/0002_seed.sql và docs/brands/*.md, chúng được sinh bằng npm run seed.
  • npm run db:seed:remote từ chối chạy khi D1 đã có brand, nên không thể vô tình xoá chỉnh sửa của mentor.

Tài liệu nội bộ dành cho mentor Nemo12.