community feature

packages/db/README.md

@@ -0,0 +1,127 @@
+# @pascal-app/db
+
+Database package for Pascal Editor with Supabase.
+
+## Setup
+
+### 1. Install Dependencies
+
+From the monorepo root:
+
+```bash
+bun install
+```
+
+This installs Supabase CLI as a dev dependency.
+
+### 2. Start Supabase locally
+
+From the monorepo root:
+
+```bash
+bun db:start
+```
+
+This will start a local Supabase instance with PostgreSQL, PostgREST, and Studio.
+
+### 3. Check Supabase status
+
+```bash
+bun db:status
+```
+
+You'll see output like:
+
+```
+API URL: http://127.0.0.1:54321
+DB URL: postgresql://postgres:postgres@127.0.0.1:54322/postgres
+Studio URL: http://127.0.0.1:54323
+Anon key: eyJh...
+Service role key: eyJh...
+```
+
+### 4. Configure environment variables
+
+Add these to `apps/editor/.env.local`:
+
+```bash
+# Supabase
+NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321
+NEXT_PUBLIC_SUPABASE_ANON_KEY=<your_anon_key>
+SUPABASE_SERVICE_ROLE_KEY=<your_service_role_key>
+
+# Better Auth
+BETTER_AUTH_SECRET=<generate_with_openssl_rand_base64_32>
+BETTER_AUTH_URL=http://localhost:3000
+```
+
+Generate a secret for `BETTER_AUTH_SECRET`:
+
+```bash
+openssl rand -base64 32
+```
+
+## Migrations
+
+Migrations are located in `supabase/migrations/`.
+
+### Apply migrations
+
+```bash
+bun db:reset  # Resets and applies all migrations
+```
+
+### Create a new migration
+
+```bash
+cd packages/db
+bunx supabase migration new <migration_name>
+```
+
+## Database Schema
+
+### Auth Tables (Better Auth)
+
+- `users` - User accounts
+- `sessions` - Active sessions
+- `accounts` - OAuth provider accounts
+- `verification_tokens` - Magic link tokens
+
+### Application Tables
+
+- `properties` - User properties
+- `properties_addresses` - Property addresses with Google Maps data
+- `properties_models` - Scene graph models (versions)
+
+## Usage
+
+### Client-side (with RLS)
+
+```typescript
+import { supabase } from '@pascal-app/db/client'
+
+// RLS policies automatically filter by authenticated user
+const { data } = await supabase.from('properties').select('*')
+```
+
+### Server-side (service role)
+
+```typescript
+import { supabaseAdmin } from '@pascal-app/db/server'
+
+// Bypasses RLS - you must manually filter by user_id
+const { data } = await supabaseAdmin
+  .from('properties')
+  .select('*')
+  .eq('owner_id', userId)
+```
+
+## Supabase Studio
+
+Access the local Supabase Studio at: http://127.0.0.1:54323
+
+Use this to:
+- Browse tables and data
+- Run SQL queries
+- View logs
+- Manage RLS policies