백엔드 미구현을 나눴습니다

부록 D 의 여섯 도메인 중 넷은 돌아가고 둘이 비어 있습니다. 그 둘을 통째로 넘깁니다.

정본은 미결 항목입니다. 이 글은 알림이고, 담당·기한·확인 명령은 항목에 붙어 있습니다.

• 백엔드 미구현 분담 — 과금 도메인 (담당: 백성검)
• 백엔드 미구현 분담 — 평가·신뢰 도메인 (담당: 박민호)

무엇을 누가

패킷	도메인	테이블	담당
A	과금	analysis_credit coach coach_referral (3)	백성검
B	평가·신뢰	review review_option review_selection report no_show (5)	박민호
—	카드·호칭 남은 셋 · 매칭 남은 둘 · player_vector (6)		정어진

백성검 님께 작은 쪽을 드린 이유는 이미 드린 항목이 넷(429·카드 생성·mock 고정·업로드) 있어서입니다. 그리고 과금은 방금 만드신 market/coaches 화면에 그대로 붙습니다.

박민호 님께 평가·신뢰를 드린 이유는 정할 것이 많아서입니다 — 평가 선택지 목록, 평가 가능 기간, 신고 사유의 형태, 불참을 누가 기록하는가. 화면이 아직 없어서 백엔드가 먼저 나가도 됩니다.

왜 테이블 개수가 아니라 도메인으로 잘랐나

app/<컨텍스트>/ 구조를 tests/test_architecture.py 가 실제로 검사합니다. 도메인 경계가 곧 폴더 경계라, 도메인으로 자르면 두 분의 파일이 안 겹칩니다.

테이블 개수로 균등하게 자르면 한 도메인이 둘로 쪼개져 같은 폴더를 둘이 만지게 됩니다. 그게 충돌의 원인이 됩니다.

🔴 그래도 겹치는 자리가 정확히 다섯 곳 있습니다

새 컨텍스트를 하나 만들 때마다 반드시 손대야 하는 파일입니다. 제가 09-03 에 클립 업로드를 넣으면서 다섯 곳 모두 건드렸습니다.

app/main.py · alembic/env.py · tests/conftest.py · tests/user/adapter/test_auth_router.py · alembic/versions/ 의 down_revision.

앞의 넷은 충돌해도 손으로 풀면 됩니다. 마지막 하나가 문제입니다 — 두 분이 각자 마이그레이션을 만들면 down_revision 이 같은 값을 가리켜 head 가 둘이 되고 alembic upgrade head 가 죽습니다. 자동 병합이 안 되는 자리입니다.

그래서 이 다섯 곳은 제가 배선합니다. 두 분은 자기 컨텍스트 폴더 안에서만 작업하시고, 다 되면 브랜치에 푸시하고 알려 주십시오. 배선은 5분이고 충돌 해결은 30분입니다.

시작하실 때

Claude 에게 이렇게 주시면 됩니다.

fastapi/docs/backend-work-split.md 를 읽고 나에게 배정된 패킷을 찾아줘.
「먼저 확인」을 실제로 돌려보고, 이미 되어 있으면 손대지 마.
「하지 말 것」과 「공유 파일 5곳」은 반드시 지켜줘.

fastapi/CLAUDE.md 맨 앞에도 같은 안내를 달아 두었습니다 — 그 폴더에서 작업을 시작하면 Claude 가 자동으로 읽는 자리입니다.

제 쪽 진행

클립 업로드(SFR-001)를 열었습니다. 버킷은 supersub-ai 의 videos/ 접두사로 정했고, 서버 .env 설정과 IAM 권한만 남았습니다. 상세는 클립 업로드를 열었습니다에 있습니다.