d3ro-voice/docs/map/09-supabase-backend.md
Yun Chan 876e72ea2f
Some checks failed
ci / 정본·보안·린트·타입·테스트 (push) Failing after 18s
ci / 워크스페이스 빌드 검증 (push) Has been skipped
ci / 모바일 린트·타입·Jest (push) Successful in 45s
ci / Supabase Edge Functions + Cloudflare Worker (push) Successful in 22s
ci / .NET API 서버 테스트 (push) Successful in 11s
deploy-site / deploy (push) Successful in 44s
docs(wave7): record peer-swarm bug fixes, metrics, and map sync
2026-11-14 15:41:48 +09:00

12 KiB

09 — Backend: Supabase + Cloudflare Map

Surfaces: server/supabase (Postgres + Deno Edge Functions), server/cloudflare-worker (edge gateway) Role: canonical product data, auth, RLS, storage, AI proxies, billing, notifications


1. Supabase project (server/supabase/)

  • config.toml — project_id d3ro-voice; local ports API 55321 / DB 55322 / Studio 55323 / local SMTP UI 55324; DB major v17; storage 50 MiB; auth site_url localhost:5173, redirects include https://d3ro.chanpaca.net and d3ro-voice://auth-callback; external providers Google/GitHub/Apple; per-function verify_jwt settings; analytics off. The mail section uses the Supabase CLI 3.x [local_smtp] name rather than the removed [inbucket] alias.
  • seed.sql, migrations/ (74 source files; pushed and confirmed synced with production llnocwyqvhgwpdjcqqyw on 2026-11-14 via supabase db push --remote and migration list --remote), functions/ (all 24 source functions redeployed on 2026-11-14 via --use-api --import-map server/supabase/functions/deno.json), functions/_shared/, tests/, deno.json.

Note: root supabase/ contains only empty scaffolding (.branches/, snippets/). The real project lives under server/supabase/.

1.1 Migrations (74) — thematic groups

Theme Examples
Core schema + RLS + auth triggers initial tables, profiles, triggers
Storage buckets audio, meeting documents, exports
Teams team invites, membership, roles, team_activities feed (20260913000033)
Cross-device sync 20261113000001: immutable meeting_memos.revision integer column + BEFORE UPDATE trigger (bump_meeting_memo_revision) so A→B→A edits always advance revision for CAS conflict detection (GAP-SYNC-08). 20260927000036: preset prompt RPCs sync_set_builtin_instruction_prompt_v1 / sync_list_builtin_instructions_v1 + default SSOT builtin_instruction_default_prompt_v1. 20260927000035: knowledge_documents tombstones/cursor/realtime + pg_cron job prune-sync-tombstones (daily 03:17 UTC). 20260927000034: sync_tombstones (AFTER DELETE triggers on 8 synced tables, owner-read RLS, realtime, prune_sync_tombstones_v1), history.revision bump on content change, meeting_memos.updated_at, (user_id, updated_at, id) cursor indexes, client-keyed sync_upsert/delete_user_template_v1, realtime for devices/memo_tags/custom_instructions/user_templates, and export_account_portability projected back onto v1 archive keys
Knowledge / RAG knowledge_documents, knowledge_chunks, pgvector
Notifications / push push tokens, durable outbox
Billing Payple, subscriptions, payment provider events/operations ('stripe' provider values kept only for historical rows)
Admin admin roles, audit log, atomic admin RPCs
Mobile platform mobile platform/monetization/runtime integrity
Commands atomic command reorder
Devices device registration + revocation
Content reporting report reasons, generation receipts
Meetings meeting documents
STT quota atomic quota reservations (00026)
Ads ad reward receipt replay protection (00028)

Forgejo CI runs check:migrations:test and check:migrations. These gates validate filename format, unique and monotonically increasing timestamps, and non-empty files; they do not apply SQL to a local/shadow database or compare remote migration state. Separately on 2026-11-04, an isolated d3ro-voice-wave4-runtime stack applied all 73 migrations from empty and after db reset; db diff --use-pg-delta --strict-coverage replayed the same history into a shadow DB and returned no schema changes. This local proof does not establish linked/production drift.

1.2 Edge Functions (24)

Function Purpose
stt-proxy User STT gateway: auth, atomic quota reservation/refund, provider fallback, fail-closed
llm-proxy LLM gateway (Claude/OpenAI)
realtime-token OpenAI Realtime ephemeral token (tier-gated, session quota)
generate-meeting-document AI document generation (minutes/report/idea-note/mindmap)
embed-chunks / search-knowledge RAG embeddings + semantic search. knowledge_embedding budgets are read from generated PLAN_QUOTA, whose source is packages/core/src/plan-catalog.ts
audio-purge Service-only audio object purge worker invoked by pg_cron. config.toml sets verify_jwt = false so modern service keys reach the handler; the handler then authorizes the exact service credential before queue/storage work. Isolated local runtime proof on 2026-11-04 covered missing/non-service key 401, service-key 200, direct drain, and pg_cron → Vault → pg_net → Edge → Storage deletion
content-report AI content reporting
team-invite / team-accept Team invitations
send-push Push delivery
account-delete Account deletion cascade + provider unlink
admin-users / admin-subscriptions / admin-payments / admin-audit-log Admin operations
billing-catalog Server pricing catalog. Prices/quotas read PLAN_PRICE_KRW/PLAN_QUOTA from functions/_shared/core-contract.generated.ts, generated from packages/core/src/plan-catalog.ts by scripts/ci/sync-core-contract.mjs (npm run contract:check fails on drift; added 2026-09-26, Wave 3, 88f24d8)
payple-checkout / payple-manage / payple-renew / payple-webhook Payple billing (Korea)
iap-verify Google Play / App Store purchase verification
admob-ssv AdMob server-side verification + reward ledger
google-play-rtdn Play Real-time Developer Notifications

Shared contracts in functions/_shared/: admin, auth, audit, cors, quota, embedding-quota, payple, push, llm, stt, team, generation-receipt, google-play, pubsub, generative-ai-safety (+ *.test.ts).

1.3 Tests (server/supabase/tests/)

Integration/E2E: content-report red e2e, content-reporting (ps1/sql), mobile platform/recording/reward-race, payment provider, mobile release preflight, public mobile runtime, push claim/outbox, team push security, STT quota.


2. Cloudflare worker (server/cloudflare-worker/)

  • wrangler.toml — worker d3ro-voice-api, compat 2024-04-01, BACKEND_ORIGIN="https://d3ro.chanpaca.net" in source (Wave 7 c68e81e; note live Worker fe6d9532-0052-48f5-b62c-45c86f6aaaa5 still retains pre-Wave-7 dashboard var http://192.168.0.39:5050 from --keep-vars), optional custom domain route (commented).
  • src/index.ts, src/origin-policy.ts, src/push-drain.ts — CORS preflight, /worker-health, origin policy + loop guard (508/503), null-body status handling (204/205/304), forwards to backend origin with X-Forwarded-* / X-D3RO-Edge-Proxy headers.
  • server/cloudflare-site-bridge/ — Pages/Worker bridge hardened in Wave 7 with 508 loop guard, path smuggling 400, and deno.json (src/index.test.ts 5/5 PASS).

Cloudflare Tunnel kd-nas maps public hostnames to NAS services.


3. Data model (product tables, high level)

Canonical product data lives in Supabase Postgres with RLS:

  • Identity: auth.users + profiles, roles/claims, identity links.
  • Content: history, meetings, meeting_memos, meeting_documents, memos, dictionary, commands/instructions, templates.
  • Knowledge: knowledge_documents, knowledge_chunks (pgvector).
  • Teams: teams, members, invites, activity feed (team_activities, RPC-only writes, realtime-enabled).
  • Delivery: devices (mobile + desktop windows/macos), push_tokens, push outbox.
  • Sync: sync_tombstones — deletion log the desktop mirror (and any offline client) reads by cursor.
  • Monetization: subscriptions, payment_provider_events/operations, ad_reward_claims, IAP receipts, generation receipts.
  • Ops: audit_log + admin operation records.
  • Portability: portable_exports (+ storage).

Shared TS types for these live in packages/api-client (SSOT).


4. Backend status summary

  • Auth (email + Google/GitHub/Apple), RLS, storage, realtime: implemented; production Auth + Google provider entry verified GREEN; GitHub/Apple provider secrets and mobile consent callback pending (external).
  • STT/LLM proxies: implemented and fail-closed (no synthetic transcripts); atomic quota reservations verified with 20-way concurrency.
  • Billing (Payple + IAP verify + webhooks/RTDN; Stripe removed 2026-09-26): implemented; live provider end-to-end and Payple webhook signature verification pending.
  • Ads (AdMob SSV, rewarded ledger, replay protection): implemented (Edge v13 ACTIVE); production AdMob serving blocked externally (review/serving limits/store link/payment profile).
  • Push: Supabase owns tokens/devices/outbox/retries. Transports implemented for FCM, Web Push (VAPID + RFC 8291), and APNs (.p8 token); the Cloudflare Worker cron drains the outbox every minute. Android still requires FCM at the device. Details: docs/deployment/push-transport-without-firebase.md.
  • Content safety: generation receipts + content-report implemented.
  • Data portability (account-delete, export/restore): implemented.
  • Audio purge source wiring, unit tests, and an isolated local pg_cron/Vault invocation are verified: the fixture queue, audio_files row, and Storage object each changed from one to zero and net._http_response recorded HTTP 200. Deployment and the production schedule/Vault/object path remain unverified.

External gates are enumerated in docs/v3/MOBILE_APP_COMPLETION_SSOT.md §0/§6 and mirrored in 11-gap-backlog.md (EXT-*, BE-*).


Wave 6 hardening (2026-11-14)

  • Supabase Edge Functions (server/supabase/functions, Deno 270 passed | 0 failed): consolidated jsonResponse/json and streaming byte-bounded readJsonBody into _shared/json-response.ts across 20 Edge handlers (preserving CORS/Cache-Control/header contracts and failing closed with 400/413 on invalid/oversized JSON); hardened account-delete (SAFE_INTERNAL_CODES), llm-proxy (502 + quota refund on invalid provider JSON), _shared/payple.ts (postPaypleJson with AbortSignal.timeout), and realtime-token/openai-provider.ts (AbortSignal.timeout), backed by _shared/json-response.test.ts and tests in payple, realtime-token, llm-proxy, and stt-proxy.
  • Cloudflare Worker (server/cloudflare-worker, Deno 9 passed | 0 failed): added resolveBackendTargetUrl blocking //host/\host SSRF, omitted backendOrigin from /worker-health, stripped Host/hop-by-hop headers, set redirect: 'manual', added AbortSignal.timeout(30_000), sanitized 502/504 JSON responses, removed console.log, canceled unread !response.ok response bodies in push-drain.ts, and added 4 regression tests in src/index.test.ts.

Wave 7 hardening (2026-11-14, c68e81e, post-v1.17.1)

  • Supabase Edge Functions (server/supabase/functions, Deno 273 passed | 0 failed): stt-proxy/handler.ts rejects requests whose Content-Length exceeds the cap with 413 before buffering; embed-chunks/handler.ts refunds quota only on upstream provider failures; _shared/quota.ts fails closed by rethrowing DB errors other than PGRST116 (stt-proxy/handler.test.ts, embed-chunks/handler.test.ts, _shared/quota.test.ts).
  • Cloudflare Worker & Site Bridge (server/cloudflare-worker, Deno 15 passed | 0 failed; server/cloudflare-site-bridge, Deno 5 passed | 0 failed): updated wrangler.toml default BACKEND_ORIGIN to https://d3ro.chanpaca.net (fixing the HTTP 403 error 1003 root cause in source; live Worker fe6d9532-... still holds the pre-Wave-7 dashboard var until redeployed without --keep-vars or updated), added origin-policy.ts rejecting non-HTTPS/private-IP/internal origins and proxy loops (508/503), handled null-body statuses (204/205/304), and applied origin validation to push-drain.ts; hardened cloudflare-site-bridge with 508 loop guard and path-smuggling 400 (deno.json, src/index.test.ts).