neta/supabase/README.md

Supabase Directory

This directory stores SQL files for the project's Supabase/PostgreSQL database.

Current Baseline

• schema.sql is the first registered database SQL file.
• Its documentation is in docs/database/0001-initial-schema.md.
• Its order is tracked in docs/database/query-order.md.
• Execution history is tracked in docs/database/query-log.md.

Future Changes

Future schema changes should be added under:

supabase/migrations/

Optional local/demo data should be added under:

supabase/seeds/

Do not overwrite already executed SQL without also creating a new ordered migration and documenting why.

Current Ordered SQL

1. schema.sql
2. migrations/0002_add_freelancer_os_core_tables.sql
3. migrations/0003_add_project_planning_assets.sql
4. migrations/0004_add_business_os_tables.sql
5. migrations/0005_add_advanced_crm_tables.sql
6. migrations/0006_add_pgvector_and_embeddings.sql
7. migrations/0007_add_client_portal_tables.sql
8. migrations/0008_add_project_progress_and_quota.sql
9. migrations/0009_lock_registration_after_first_admin.sql
10. Optional local/demo data: seeds/0001_demo_freelancer_os_data.sql

Apply Migrations

From the repository root:

DATABASE_URL='postgresql://postgres:password@host:5432/postgres' bash ./scripts/apply-migrations.sh

The script applies all required schema files in canonical order. It requires either local psql or Docker. If psql is not installed, it runs psql through the postgres:16-alpine Docker image.