project-context-huynhsang-blog
Tóm tắt 上下文存储库 Huỳnh Sang Blog(monorepo Next.js 16、Supabase DB-first、Cloudinary media、next-intl i18n、Bun/Biome)。 Dùng khi cần hiểu kiến trúc repo,tìm đúng chỗ để sửa,hoặc 入门贡献者。
📖 中文导读:Tóm tắt 上下文存储库 Huỳnh Sang Blog(monorepo Next.js 16、Supabase DB-first、Cloudinary media、next-intl i18n、Bun/Biome)。 Dùng khi cần hiểu kiến trúc repo,tìm đúng chỗ để sửa,hoặc 入门贡献者。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: project-context-huynhsang-blog description: Tóm tắt context repo Huỳnh Sang Blog (monorepo Next.js 16, Supabase DB-first, Cloudinary media, next-intl i18n, Bun/Biome). Dùng khi cần hiểu kiến trúc repo, tìm đúng chỗ để sửa, hoặc onboarding contributor.
Context dự án: Huỳnh Sang Blog
Khi nào dùng skill này
- Khi bạn nói: “giải thích kiến trúc repo”, “nên sửa ở đâu”, “luồng blog/docs/admin hoạt động thế nào”.
- Khi cần mapping nhanh: route → service → DB → UI component.
Bản đồ nhanh (repo-specific)
- App Router:
apps/web/src/app/[locale]/...- Site routes:
apps/web/src/app/[locale]/(site)/* - Admin routes:
apps/web/src/app/[locale]/admin/*
- Site routes:
- Services (DB-first):
apps/web/src/services/*-service.ts- Blog:
apps/web/src/services/blog-service.ts - Docs:
apps/web/src/services/docs-service.ts
- Blog:
- UI components:
- Shared:
apps/web/src/components/* - Shadcn UI (KHÔNG SỬA):
apps/web/src/components/ui/*
- Shared:
- i18n messages:
apps/web/src/i18n/locales/vi.json - Supabase migrations:
apps/web/supabase/migrations/* - E2E tests:
apps/web/tests/*.spec.ts
Quy tắc “không được phá”
- UI text luôn là Tiếng Việt qua
next-intl(thuật ngữ kỹ thuật giữ English). - Next.js 16: luôn
await paramsvàawait searchParamstrong page. - Source of truth: Supabase cho blog/docs/projects (không Contentlayer).
- Media file ở Cloudinary, DB chỉ lưu metadata/reference.
- Không sửa:
apps/web/src/lib/core/**vàapps/web/src/components/ui/**.
Workflow tool (khi cần verify)
- Repo ops: Serena (tìm file/symbol trước khi đọc cả file).
- Library docs: Context7.
- Web research: Perplexity.
- Database: Supabase MCP (DDL → migration; query/debug → SQL).
Gợi ý cách làm việc hiệu quả
- Xác định nơi sửa: route (app) → component → service → DB.
- Dùng search (workspace) để tìm usage trước khi sửa API.
- Sau khi đổi API/signature: cập nhật mọi references.