Các repo GitHub
Tài khoản dac2205 có hơn 60 repo; phần lớn là dự án khác (Conan School, Conan1, các site riêng). Trang này nói về Nemo12: có những repo nào, code nằm ở đâu, và luật để quyết định một thứ mới vào repo nào.
Năm repo của Nemo12
| Repo | Chứa gì | Tên miền | Ghi chú |
|---|---|---|---|
| nemo12.com (monorepo chính) | API, D1, package dùng chung, mọi web app học tập và quản trị, docs, harness | xem bảng dưới | Repo làm việc hằng ngày |
| nemo12-www | Site công khai www, Pearl, CMS và docs của CMS | nemo12.com, pearl.nemo12.com | Tách 16.10.2026; đang chuyển hẳn (repo chính còn bản apps/web, apps/pearl tới khi chuyển xong) |
| nemo12-videos | Bộ công cụ video: Remotion (video giới thiệu) và nhà máy video explainer | ghi ra R2 và D1 | Tách 14.10.2026; skill video-create sống ở đây |
| nemo12-docs | Khung site cho tài liệu chất lượng (docs, qc) | qc.nemo12.com (dự định) | Mới tạo 18.10.2026; nội dung tài liệu vẫn nằm cạnh code ở repo chính |
| toan12.com | Nền tảng học Toán | toan12.com | Tách khỏi Nemo12 (môn Toán ra khỏi nemo12, trừ SAT Math và AP) |
Trong repo nemo12.com
| Nhóm | Thư mục | Tên miền |
|---|---|---|
| API và dữ liệu | workers/api, workers/foundry, workers/tool-plane, migrations/ (D1) | api.nemo12.com, mcp.nemo12.com |
| Package dùng chung | packages/ (design-system, learn-shell, books, walk, grammar-catalog, illustrations, sentry, rum, catalog, parent-courses) | không deploy riêng |
| Học sinh | apps/learn (shell, IELTS, SPEAK, WALK, ESSAY và các trang chung), apps/grammar, apps/sat | learn.nemo12.com, learn.nemo12.com/grammar, learn.nemo12.com/sat |
| Phụ huynh, mentor, gia sư | apps/marlins, apps/mentors, apps/tutors, apps/partners | marlins., dolphin., tutors., partners.nemo12.com |
| Nội dung và quản trị | apps/coral, apps/admin, apps/gull, apps/mm, apps/b21, apps/compass, apps/reef, apps/playbooks, apps/ui | các subdomain cùng tên |
| Tài liệu | docs/ (dùng chung), apps/<app>/docs/ (riêng từng app), apps/docs (site), apps/harness (site này) | docs.nemo12.com, harness.nemo12.com |
| Nội dung soạn tay | content/ (nguồn để nạp vào D1) | không deploy riêng |
Mỗi app một Worker trên Cloudflare; danh sách app, thư mục và thứ tự deploy nằm ở một chỗ: .github/app-paths.json.
Luật chọn repo
- Mặc định: vào nemo12.com. Thứ gì dùng chung đăng nhập, API, D1 hay package của Nemo12 thì ở đây, mỗi web app một thư mục
apps/<app>/(cùng docs, prototype, CLAUDE.md của nó). - Tách repo riêng chỉ khi không chung mã chạy, dữ liệu hay đăng nhập với phần còn lại: công cụ video (chỉ ghi ra R2, D1), site công khai có CMS riêng, một sản phẩm có người học riêng (toan12).
- Hai repo nói chuyện qua hợp đồng, không qua import. Hợp đồng là: API
/v1(api.nemo12.com), bảng D1, tiền tố R2, và vài file sinh có ghi rõ nguồn ở dòng đầu (ví dụapps/web/src/site/pageVideos.tsdo nemo12-videos ghi). - Tách program trong learn thì không tách repo: mỗi program một app và một Worker trong cùng repo, cùng tên miền (Tách app theo program).
Thư mục trên máy
text
~/ConanCode/
nemo12.com/ repo chính, làn platform
nemo12-grammar/ worktree của repo chính, làn grammar
nemo12-www/ repo nemo12-www
nemo12-videos/ repo nemo12-videos
nemo12-docs/ repo nemo12-docs
toan12.com/ repo toan12.com