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/*
  • 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
  • UI components:
    • Shared: apps/web/src/components/*
    • Shadcn UI (KHÔNG SỬA): apps/web/src/components/ui/*
  • 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 params và await searchParams trong 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ả

  1. Xác định nơi sửa: route (app) → component → service → DB.
  2. Dùng search (workspace) để tìm usage trước khi sửa API.
  3. Sau khi đổi API/signature: cập nhật mọi references.