infra+docs: 로컬 env 확장 + seed.sql 샘플 + 문서 일괄 업데이트

[cocoyoon]

Part of #333.

Scope

로컬 개발자가 assets 프로젝트를 자연스럽게 쓸 수 있게 env/seed/문서를 정리.

Deliverables

• `scripts/local-env-sync.sh`
  • 기존 prod 역할 env 주입 유지
  • `ASSETS_DATABASE_URL`, `ASSETS_DATABASE_API_URL`, `ASSETS_DATABASE_ANON_KEY`, `ASSETS_DATABASE_SERVICE_ROLE_KEY` 블록 `.env.backend.dev.example` 에서 복사 (이미 존재하면 덮어쓰기 금지)
  • `APP_ENV=local` 기본값 주입
• `supabase/seed.sql`
  • `public.artists` / `public.groups` 최소 2-3행
  • `public.posts` 샘플 2-3행 (의존 FK 충족)
• 문서 업데이트
  • `packages/api-server/CLAUDE.md` §10 — "두 DB 풀: prod + assets" 문단
  • `docs/agent/environments.md` — assets 열 추가
  • `docs/DATABASE-MIGRATIONS.md` — Prod(Supabase CLI + SeaORM check) / Assets(Supabase CLI only) 분리 명시
  • `docs/agent/database-summary.md` — warehouse 제거, public 테이블 반영
• 신규 문서
  • `docs/architecture/assets-project.md` — 배경/스키마/상태머신/verify 시퀀스 다이어그램/실패 모드
  • `docs/agent/verify-flow-qa.md` — 수동 QA 체크리스트
• `README.md` 서비스 표에 assets 추가

Acceptance

• 신규 개발자가 README + environments.md 만 보고 로컬 기동 가능
• `just dev` 시 api-server / ai-server 모두 assets 연결 성공 로그 출력
• `just dev-reset` 후 seed된 posts가 web 에서 보임

Depends on

• ci: monorepo pre-push local CI orchestration #1-feat: v9.0 Type-Safe API Generation milestone #9 완료 후

[cocoyoon]

Closed by PR #344 (merged 2026-04-26). 본 PR 가 Epic #333 의 12 child 이슈 (#334–#347) 를 한 번에 다룸.