Files
collective-lists/Justfile
Oier Bravo Urtasun 3efe0b9be0 feat(fase-9): migration 015 — users.theme column for dark mode
Adds `theme text not null default 'system' check (theme in
('light','dark','system'))` to public.users. New users get 'system' so
the UI follows the OS preference until they opt in; existing rows
backfill via the default.

Includes pgTAP test 009 (8 assertions covering column existence/type,
default value, valid transitions, and the check constraint rejecting
unknown values). Wires the theme field into the hand-curated
database.ts type so PostgREST queries stay typed.

Also hardens `just db-types` to bail out (instead of truncating
database.ts) when the supabase CLI is missing — the recipe was silently
wiping the file on this dev machine.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-18 01:06:18 +02:00

199 lines
7.2 KiB
Makefile

# Colectivo — task runner
# Requires: just, docker, pnpm
set dotenv-load := true
# Alias: docker compose with correct project root so .env is always found
dc_dev := "docker compose --env-file .env -f infra/docker-compose.dev.yml"
dc_prod := "docker compose --env-file .env -f infra/docker-compose.prod.yml"
# ── Setup ─────────────────────────────────────────────────────────────────────
# First-time (and idempotent) local environment setup
setup:
bash setup.sh
# ── Dev ───────────────────────────────────────────────────────────────────────
# Start full local stack (Docker services + SvelteKit dev server)
dev:
{{dc_dev}} up -d
pnpm --filter @colectivo/web dev
# Stop all services (Docker stack + SvelteKit dev server)
stop:
{{dc_dev}} down
-pkill -f "vite" 2>/dev/null || true
# Stop local Docker stack
dev-stop:
{{dc_dev}} down
# Stop and remove all volumes (full reset)
dev-clean:
{{dc_dev}} down -v
# ── Database ──────────────────────────────────────────────────────────────────
# Drop, migrate, and seed the dev database
db-reset:
supabase db reset
# Apply pending migrations
db-migrate:
supabase db push
# Apply dev seed data
db-seed:
docker exec -i colectivo-dev-db-1 psql -U postgres < supabase/seed.sql
# Regenerate TypeScript types from Supabase schema.
# Writes to a tempfile first so a missing/failing `supabase` CLI does not
# truncate the existing hand-curated database.ts (which would silently
# break every TS consumer in the monorepo).
db-types:
#!/usr/bin/env bash
set -euo pipefail
if ! command -v supabase >/dev/null 2>&1; then
echo "supabase CLI not installed — database.ts is hand-curated, edit it manually" >&2
exit 1
fi
tmp=$(mktemp)
supabase gen types typescript --local > "$tmp"
mv "$tmp" packages/types/src/database.ts
echo "Types written to packages/types/src/database.ts"
# Open Supabase Studio
db-open:
open http://localhost:54323
# ── Keycloak ──────────────────────────────────────────────────────────────────
# Export Keycloak realm to keycloak/realm-export.json
kc-export:
{{dc_dev}} exec keycloak \
/opt/keycloak/bin/kc.sh export \
--realm colectivo \
--users realm_file \
--file /tmp/realm-export.json
{{dc_dev}} cp keycloak:/tmp/realm-export.json keycloak/realm-export.json
echo "Exported to keycloak/realm-export.json"
# Open Keycloak Admin Console
kc-open:
open http://localhost:8080/admin
# ── Build ─────────────────────────────────────────────────────────────────────
# Build all packages
build:
pnpm turbo run build
# Run the production build locally against the dev Docker stack (port 3000)
serve: build
{{dc_dev}} up -d
PORT=3000 node apps/web/build/index.js
# Type-check all packages
check:
pnpm turbo run check
# Lint all packages
lint:
pnpm turbo run lint
# Run tests
test:
pnpm turbo run test
# ── Testing ───────────────────────────────────────────────────────────────────
# Run every test suite (pgTAP + Vitest integration + apps/web unit + Playwright E2E).
# Requires `just dev` to already be running — the stack must be healthy.
test-all: test-db test-integration test-unit test-e2e
# Run apps/web Vitest unit tests (browser-env + jsdom + fake-indexeddb).
# Currently covers the offline sync queue (Fase 2b.2).
test-unit:
pnpm --filter @colectivo/web test:unit
# Run pgTAP SQL tests directly against the dev database
# `set dotenv-load` at the top of this file sources .env so POSTGRES_PASSWORD
# is available — we forward it to psql via PGPASSWORD.
test-db:
#!/usr/bin/env bash
set -euo pipefail
for f in supabase/tests/*.sql; do
PGPASSWORD="$POSTGRES_PASSWORD" psql -U postgres -h localhost -d postgres \
-v ON_ERROR_STOP=1 -f "$f"
done
# Run Vitest integration tests (RLS + trigger assertions via supabase-js)
test-integration:
pnpm --filter @colectivo/test-utils test
# Run Playwright E2E tests (headless)
test-e2e:
pnpm --filter @colectivo/web exec playwright test
# Run Playwright E2E tests in headed mode (for debugging)
test-e2e-headed:
pnpm --filter @colectivo/web exec playwright test --headed
# Run Kong rate-limit verification tests. Restarts Kong first to ensure a
# clean counter state (tests burn through the minute + hour quotas). Not
# part of test-all because the tests share the rate-limit counter with the
# rest of the integration suite.
test-rate-limit:
#!/usr/bin/env bash
set -euo pipefail
{{dc_dev}} up -d --force-recreate kong
sleep 3
export RUN_RATE_LIMIT_TESTS=1
pnpm --filter @colectivo/test-utils test -- rate-limit
# Build a prod bundle, serve it on :3000, run Lighthouse against PWA /
# Accessibility / Best-Practices. Fails if any score drops below 90.
# Must run while `just dev` (docker stack) is up — Lighthouse loads the
# real app which hits Supabase via Kong.
lighthouse:
#!/usr/bin/env bash
set -euo pipefail
pnpm --filter @colectivo/web build
PORT=3000 node apps/web/build/index.js &
SERVER_PID=$!
trap "kill $SERVER_PID 2>/dev/null || true" EXIT
for i in 1 2 3 4 5 6 7 8 9 10; do
if curl -sf http://localhost:3000/ -o /dev/null; then break; fi
sleep 1
done
pnpm --filter @colectivo/web exec lighthouse http://localhost:3000 \
--only-categories=pwa,accessibility,best-practices \
--output=html --output-path=./lighthouse-report.html \
--chrome-flags='--headless --no-sandbox' \
--quiet
# Run the RLS isolation curl audit — complements rls-audit.test.ts.
rls-audit:
infra/scripts/rls-audit.sh
# ── Backup & Restore ──────────────────────────────────────────────────────────
# Take a manual backup of a service (e.g. just backup supabase)
backup service:
infra/scripts/backup.sh {{service}}
# Restore a backup file (e.g. just restore supabase backups/2024-01-01.dump)
restore service file:
infra/scripts/restore.sh {{service}} {{file}}
# ── Production ────────────────────────────────────────────────────────────────
# Deploy to production via SSH
deploy:
infra/scripts/deploy.sh
# Stream production Docker logs
logs:
{{dc_prod}} logs -f