Oier Bravo Urtasun
e7a961a66d
Fase 2b closes the critical-path product differentiator. Two sessions on the
same list see each other's changes in real time, mutations survive network
drops and sync when reconnected, and a dedicated full-screen shopping view
optimises the in-store experience.
2b.1 Realtime
- `$lib/stores/realtimeSync.ts` wraps `postgres_changes` with an `applyItemEvent`
reducer (INSERT/UPDATE/DELETE → next items[]) and a `subscribeToList` helper
that awaits the SUBSCRIBED handshake before returning
- `/lists/[id]` subscribes in onMount, unsubscribes in onDestroy. Uses a
`pendingTempIds` set to deduplicate own-mutation echoes against optimistic
rows (matches by name+created_by+sort_order)
- Client-generated UUIDs for new inserts make the path idempotent: if the
server response is lost and we retry, the second POST hits PK-conflict
which the queue treats as success
- CHECKED section div now carries role="listitem" so Playwright locators
follow the item across sections
2b.2 Offline queue
- `$lib/sync/queue.ts` — SyncQueue class backed by IndexedDB (idb), FIFO flush,
MAX_ATTEMPTS=5 retry budget, PK-conflict-as-success short-circuit
- `$lib/sync/index.ts` — app-wide singleton, window.online listener flushes
automatically, hydrateSyncState() at page load restores pendingOpsCount
- `$lib/stores/syncStatus.ts` — derived store (offline | syncing | synced)
tracking navigator.onLine + queue depth
- SyncBanner component renders the offline/syncing indicator in the detail
and session views
- handleAdd enqueues on failure instead of reverting, so an offline mutation
keeps its optimistic row and syncs on reconnect
2b.3 Modo Compra
- `/lists/[id]/session/+page.svelte` — full-screen overlay (fixed inset-0
z-50) that covers the sidebar while keeping the normal auth routing.
56×56 toggles, flip animation shuffling items between TO BUY / CHECKED,
Finish Shopping confirmation modal → completeList → goto('/lists')
- Link from `/lists/[id]` header (data-testid=start-session) with the
new `list_start_session` message
Testing infra
- apps/web gets its own Vitest config (jsdom + fake-indexeddb/auto) and a
new `pnpm test:unit` script. `just test-all` now chains pgTAP → integration
→ unit → e2e so a single command is the gate.
- packages/test-utils/tests/sync-queue.test.ts (placeholder scaffold) removed —
replaced by `apps/web/src/lib/sync/queue.test.ts` co-located with the module
Totals: 103 tests green
16 pgTAP
59 Vitest integration (in packages/test-utils)
6 Vitest unit (in apps/web — the SyncQueue)
22 Playwright E2E (5 auth + 4 lists + 6 items + 2 realtime + 2 offline + 3 session)
2 skipped (realtime-presence — upstream bug, unchanged)
Documented in plan/fase-2b and CLAUDE.md.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
151 lines
5.3 KiB
Makefile
151 lines
5.3 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
|
|
db-types:
|
|
supabase gen types typescript --local > 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
|
|
|
|
# ── 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
|