Feature #863
open[PM] 공통 환경 구성과 새 Supabase 준비
100%
Description
담당: 형준 / 기간: 2026-10-23 (1일차) / PR: #2 (https://github.com/KANT-2/group_4_vegetable_project/pull/2)
[한 일]
- FastAPI 공통 기반: 설정 로딩, 비동기 SQLAlchemy 엔진·세션, lifespan, CORS, 처리 시간 로깅(경로·상태·시간만 기록)
- 4계층 기능 폴더 구성(accounts·catalog·purchases·experiences)과 기능별 소유권 정리
- 새 Supabase에 마이그레이션 13개와 시드(채소 21·상품 71·레시피 23) 적용 스크립트(apply_sql.py: 테이블·데이터가 있으면 중단, 삭제·초기화 없음), Storage 이미지 92개 업로드와 공개 URL 확인
- 환경변수 예시·설정 문서·API 약속 초안 작성, 헤더 로고를 두 마스코트 구성으로 교체
[막힌 점 → 해결]
- 새 DB 연결 시 password authentication failed → 비밀번호를 출력하지 않고 문자 종류·길이만 점검해 공백이 섞인 것을 찾아 해결
- profiles·cart_items·orders 등이 모두 Supabase auth.users를 외래키로 참조 → app_users 신설과 외래키 교체안을 API 약속 문서로 제안(팀 합의 필요)
- PM 필수 승인 규칙 때문에 PM 본인 PR 머지 불가 → Ruleset Bypass list에 admin 역할을 PR 한정으로 추가(직접 푸시는 계속 차단)
[검증]
- pytest 5건 통과, 새 DB 연결과 홈·상품 목록 화면 렌더링 확인
[미완료]
- 사용자 식별(app_users) 합의, 팀원 환경 실행 확인
형안 Updated by 형준 안 22 days ago
[2026-10-27 PM 통합 점검 / c2a03e5]
사용자 식별은 auth.users.id = app_users.id = profiles.id, JWT sub도 같은 UUID를 사용하는 A’ 방향으로 팀 계약에 반영됐습니다. 체험 FK는 app_users 참조이며 다른 담당 테이블의 FK를 일괄 변경하지 않습니다. 공통 오류 처리 보강(PR #20), PR #29 통합 코드와 담당 경계를 검토했습니다.
팀 공지의 기존 실행 기록: 백엔드 474건 통과·3건 스킵, 프론트 156건·타입·린트 통과, 빌드 131페이지 성공. 이번 기록 갱신에서 재실행한 수치는 아닙니다. 실행 안내: 최신 develop 병합 → backend에서 uv sync → 백엔드 → 프론트 실행. 현재 빌드도 백엔드가 필요합니다.
남은 통합 작업: 관리자 전체 상품 저장의 오래된 재고 덮어쓰기 수정·회귀 확인, product_images 마이그레이션 007 현재 적용 여부와 등록/사진 변경 검증, 영우 담당 구매/재고 변경 확인, 고객·관리자·모바일 브라우저 전체 검증, 테스트 데이터 생성자 확인 후 정확한 ID 정리, README·API 계약·통합 체크리스트·PR #5 갱신. 전체 통합·배포는 진행 중이며 본 일감의 기존 공통 환경 완료 상태와 구분합니다. 제출 10/28 14:00 KST.
근거: https://github.com/KANT-2/group_4_vegetable_project/pull/29
https://github.com/KANT-2/group_4_vegetable_project/pull/20