搵技能.../

Supabase Db Model | Skills Pool

技能檔案

Supabase Db Model

Chuẩn hoá cách đọc/viết DB model Supabase (migrations + TS types + services) trong repo này.

HuynhSang20050 星標2026年1月8日

職業: 資料庫架構師
分類: 數據庫工具

技能內容

Mục tiêu

Giữ source of truth ở Supabase (DB-first) và truy cập dữ liệu qua apps/web/src/services/*-service.ts.
Dùng type-safe schema từ apps/web/src/types/database.ts khi thao tác với Row/Insert/Update.

Nguồn sự thật trong repo

Schema/migrations: apps/web/supabase/migrations/*.sql
Types (generated/committed): apps/web/src/types/database.ts
Query patterns:
- Blog: apps/web/src/services/blog-service.ts
- Docs: apps/web/src/services/docs-service.ts

Type pattern (khuyến nghị)

Row type:
- Database['public']['Tables']['blog_posts']['Row']
Insert type:
- Database['public']['Tables']['blog_posts']['Insert']
Update type:

相關技能

快速安裝

Supabase Db Model

npx skills add HuynhSang2005/blog-deleted

下載 Skill 打開源碼倉庫

作者: HuynhSang2005
星標: 0
更新時間: 2026年1月8日
職業

本頁內容

Database['public']['Tables']['blog_posts']['Update']

Ví dụ đang dùng trong repo:

Blog joins: blog_posts + profiles (author) + media (cover/og) + tags (qua blog_post_tags).

Query patterns quan trọng

1) Joins + flatten junction table

Repo dùng join kiểu:
- tags:blog_post_tags(tag:tags(*))
Sau đó flatten bằng helper (xem flattenTags trong apps/web/src/services/blog-service.ts).

2) Full-text search (FTS)

Blog list dùng textSearch('search_vector', term, { type: 'websearch', config: 'simple' }).
Khi thêm field mới vào tìm kiếm, cần cập nhật:
- Migration tạo/đổi search_vector (index GIN nếu có)
- Service query (tên column phải khớp)

3) Date range filter cho admin

Pattern trong repo: dùng .or(...) để match cả created_at và published_at/updated_at.
Xem applyOrDateFilter trong blog-service.ts và docs-service.ts.

4) Docs slug normalization

Public docs dùng slugParts.join('/') và map '' -> 'index' (xem getPublicDocBySlug trong docs-service.ts).
Khi thiết kế URL docs, ưu tiên giữ quy ước index này để tránh 2 nguồn truth.

Workflow khi đổi DB

Tạo migration mới dưới apps/web/supabase/migrations/ (DDL/RLS/indexes).
Apply migration bằng Supabase MCP:
- DDL: dùng apply_migration
- Debug dữ liệu: dùng execute_sql
Regenerate TypeScript types:
- Ưu tiên dùng Supabase tooling (CLI hoặc MCP generate_typescript_types) để cập nhật apps/web/src/types/database.ts.
Cập nhật services (apps/web/src/services/*-service.ts) và types helper nếu cần.

Lưu ý

Không hardcode secrets/keys.
RLS: thay đổi policy phải có migration rõ ràng.
App Router Next.js 16: pages phải await params/searchParams (liên quan khi query theo locale/slug).

02

Nguồn sự thật trong repo

03Type pattern (khuyến nghị)

04Query patterns quan trọng

051) Joins + flatten junction table

062) Full-text search (FTS)

073) Date range filter cho admin

084) Docs slug normalization

09Workflow khi đổi DB

數據庫工具

Database Migrations

数据库迁移最佳实践，涵盖模式变更、数据迁移、回滚以及零停机部署，适用于PostgreSQL、MySQL及常用ORM（Prisma、Drizzle、Django、TypeORM、golang-migrate）。

數據庫工具

Database Migrations

Şema değişiklikleri, veri migration'ları, rollback'ler ve PostgreSQL, MySQL ve yaygın ORM'ler (Prisma, Drizzle, Django, TypeORM, golang-migrate) arasında sıfır kesinti deployment'ları için veritabanı migration en iyi uygulamaları.

Postgres Patterns

PostgreSQL database patterns for query optimization, schema design, indexing, and security. Based on Supabase best practices.

數據庫工具

Frontend Query & Mutation

Guide for implementing Dify frontend query and mutation patterns with TanStack Query and oRPC. Trigger when creating or updating contracts in web/contract, wiring router composition, consuming consoleQuery or marketplaceQuery in components or services, deciding whether to call queryOptions() directly or extract a helper or use-* hook, handling conditional queries, cache invalidation, mutation error handling, or migrating legacy service calls to contract-first query and mutation helpers.

langgenius138.3k

數據庫工具

Db Migrations

Use when generating or regenerating Drizzle migration files, changing database schema tables or columns, resolving migration sequence conflicts after rebase, reviewing migration SQL for idempotent patterns, or renaming migration files.

Drizzle

Drizzle ORM schema and database guide. Use when working with database schemas (src/database/schemas/*), defining tables, creating migrations, or database model code. Triggers on Drizzle schema definition, database migrations, or ORM usage questions.

資料庫架構師