[DB-1012] feat: Production Supabase 구조 문서 자동화

[guesung]

설명

Production Supabase의 memo, feedback 스키마와 배포된 Edge Functions를 한 문서에서 확인할 수 있도록 결정론적인 Markdown 생성기를 추가합니다.

생성 문서는 Mermaid ERD와 테이블별 컬럼, PK/FK, nullable, 인덱스, RLS 정책, 트리거, Edge Function 이름·상태를 포함합니다. 관련 PR에서는 실제 Production 구조와 커밋된 문서를 byte 단위로 비교하여 드리프트를 차단합니다.

관련 이슈

• DB-1012

변경 유형

• 기능 추가
• CI/CD
• 문서
• 보안 강화

주요 변경

• 읽기 전용 Supabase Management API 기반 스키마·함수 조회
• 고정 정렬, LF, 마지막 개행을 적용한 결정론적 docs/supabase-schema.md 생성
• 생성 모드와 byte 단위 --check package script 추가
• 모든 PR의 관련 변경·외부 fork를 판정하는 pull_request_target 검사 추가
• 기본 브랜치의 신뢰된 생성기만 Production 토큰과 함께 실행하고 PR head는 문서 blob으로만 비교
• 트리거 인자 제외와 전체 동적 메타데이터 민감정보 탐지 게이트 추가
• SUPABASE_ACCESS_TOKEN 소비처와 환경 변수 문서 갱신

체크리스트

• Supabase 스키마 생성기 테스트 83개 통과
• 전체 Vitest 59개 파일, 668개 테스트 통과
• pnpm type-check:scripts
• pnpm check 통과(기존 경고 11건만 존재)
• 환경 변수 manifest 50개 정합성 확인
• 실제 Production pnpm check-supabase-schema 통과
• MJS·YAML 구문 검사와 git diff --check
• 독립 보안 리뷰 승인
• develop 머지 후 CI 통과
• develop E2E와 스테이징 배포 완료 확인
• 기본 브랜치 반영 후 Supabase Schema workflow_dispatch 실행 확인

QA

• 자동 QA: 28건 PASS, 0건 FAIL
• 수동 QA: 5건 대기
  • 실제 Production 문서 범위와 반복 생성 결정론 확인
  • 내부 관련 PR의 신뢰된 base 생성기 검사 확인
  • 외부 fork의 Production 조회 생략 확인
  • 범위 밖 항목 미포함 확인
  • 변경 파일 범위 최종 확인

이번 PR과 무관하게 발견한 것

• Production 트리거 인자에 기존 장기 인증 자격 증명이 리터럴로 저장되어 있습니다. 이 PR은 값이 문서에 노출되지 않도록 차단했지만, 운영 자격 증명 회전과 Vault 등 안전한 저장 방식으로의 이전은 별도 후속 작업이 필요합니다.
• 새 pull_request_target 워크플로는 기본 브랜치에 병합된 뒤 활성화됩니다. 현재 도입 PR은 로컬·Production·develop 검증으로 대체하고, 병합 후 수동 실행으로 확인해야 합니다.
• 보안을 위해 base 생성기로 PR 문서를 검증하므로 생성기의 출력 형식을 바꾸는 변경은 단계적으로 반영해야 합니다.
• 기존 코드에 Biome 경고 11건이 있으며 이번 변경 범위에는 포함하지 않았습니다.

[notion-workspace]

Supabse DB 테이블, 관계