first commit

2026-07-22 13:48:46 +08:00
commit c87751c3dc
2820 changed files with 726976 additions and 0 deletions
@@ -0,0 +1,78 @@
+---
+description: 
+globs: *.sql,supabase.ts,supabase/*
+alwaysApply: false
+---
+# Database Workflow Rules
+version: 1.0.0
+
+## Database Schema Changes
+
+### NEVER Create Manual Migrations
+- Do NOT manually create migration files in `supabase/migrations/`
+- Always use the declarative schema approach
+- Update schema files in `supabase/schemas/` folder instead
+- Only modify generated migrations files if absolutely necessary
+
+### Schema File Management
+- Modify existing table schemas in `supabase/schemas/` files
+- Add new tables by creating new schema files
+- Follow the existing schema file patterns and naming conventions
+
+## Migration Generation Process
+
+### Step 1: Stop Supabase
+```bash
+supabase stop
+```
+
+### Step 2: Generate Migration
+```bash
+supabase db diff -f <migration_name>
+```
+- Replace `<migration_name>` with descriptive name (e.g., `add_user_preferences`, `create_new_table`)
+- Migration will be generated in `supabase/migrations/` with timestamp
+
+### Step 3: Apply Migration
+```bash
+supabase start && supabase migration up
+```
+
+## Local Development Only
+
+### CRITICAL: Never Push to Remote
+- NEVER use `supabase db push`
+- NEVER use `supabase db pull`
+- ALL migrations should be tested locally only
+- Remote database changes are forbidden
+
+## Type Generation
+
+### Auto-Generate Types
+- NEVER manually edit `shared/database.ts`
+- Always regenerate after schema changes:
+```bash
+supabase gen types typescript --local > shared/database.ts
+```
+
+## Workflow Summary
+
+1. **Edit Schema**: Modify `supabase/schemas/` files
+2. **Stop Database**: `supabase stop`
+3. **Generate Migration**: `supabase db diff -f <name>`
+4. **Apply Migration**: `supabase start && supabase migration up`
+5. **Update Types**: `supabase gen types typescript --local > shared/database.ts`
+
+## Common Commands Reference
+
+```bash
+# Development workflow
+supabase stop
+supabase db diff -f <migration_name>
+supabase start && supabase migration up
+supabase gen types typescript --local > shared/database.ts
+
+# NEVER use these commands
+# supabase db push  ❌
+# supabase db pull  ❌
+```