팀 소개

팀 프로젝트 소개

역할 분담 (팀원별 역할)

이름 역할 담당 task 주요 산출물
지나 회원·인증·마이페이지·배송지 회원가입·아이디/이메일 로그인·Google 계정 연결, JWT 발급·검증, 비밀번호 해싱·로그아웃 토큰 차단, 내 정보·기본 배송지 조회·수정, 관리자 계정 접근 제어 인증·회원 API, 공통 사용자 UUID·프로필·배송지, 고객/관리자 로그인·마이페이지 화면, Google OAuth 보완·최종 README·ERD(PR #40·#42 main 반영)
서현 상품 탐색·찜·상품 운영 상품 목록·상세·검색·필터·페이지네이션, 찜·리뷰, 관리자 상품 가격·판매 상태·재고·이미지 관리 상품·찜·리뷰 API, 상품 등록·수정·재고·이미지 운영 화면, API 문서
영우 장바구니·주문·모의 결제 비회원/회원 장바구니·합치기, 서버 금액·배송지 검증, 모의 주문 생성·조회·재고 차감, 환불 신청 접수, 주문 트랜잭션 장바구니·주문·환불 접수 API, 상품·가격·배송지 주문 시점 스냅샷, 결제·주문 화면
형준 체험 예약·취소·운영 및 PM 체험·회차 조회, 예약 생성·조회·취소, 정원·기간·중복 검증, 관리자 접수 마감 체험·예약 API, 예약 화면, 개발용 시드, PR 검토·통합

팀 규칙 & 프로젝트 목표

1. 담당 기능과 진행 상황·막힌 점을 팀에 투명하게 공유하기
2. 다른 담당자의 파일 수정이 필요하면 먼저 요청하고 합의하기
3. main·develop 직접 푸시 금지, 개인 브랜치에서 PR 생성 후 팀원 1명 승인받기
4. 프로젝트 목표: 기존 화면에 안정적인 FastAPI 백엔드를 연결하고 필수 시나리오를 통합 검증하기

Code Convention

Python 3.13+ · Node.js 24 · Next.js 16 · FastAPI · 비동기 SQLAlchemy / 기능별 계층 분리 / pytest·프런트 테스트·TypeScript·ESLint·프로덕션 빌드 검증 / .env 등 비밀값 커밋 금지 / 개인 브랜치 → develop PR·승인 → main 통합

🧾 기록

<aside>

회의록

팀 공유 자료 정리

개인 작업 일지(필수!)

Github

Github Rules

➡️ 팀 Github 링크 :

https://github.com/KANT-2/group_4_vegetable_project

⭐⭐⭐ 개인 일지 (필수!) ⭐⭐⭐

<aside> ⭐

개인 일지를 작성하는 이유

개인 일지는 단순히 “오늘 무엇을 했다”를 기록하는 용도보다는,

내가 어떤 역할을 맡았는지 → 어떤 문제를 해결해야 했는지 → 어떻게 접근하고 수행했는지 → 그 결과 무엇을 만들어냈는지

가 드러나도록 작성하는 것이 중요합니다.

이를 통해 여러분은 추후 본인의 프로젝트 경험을 포트폴리오나 면접에서 실제 역량을 증명할 수 있는 근거로 활용하게 됩니다.

제목 없음

</aside>

[2026.10.23] 협업 기준
- 기능별 파일 소유권을 분리하고 개인 브랜치 → develop PR → 통합 검증 → main 순서로 작업합니다.
- 인증·상품·주문·예약 API 간 사용자 식별자와 데이터 규격을 먼저 합의합니다.

[2026.10.26 중간 발표 튜터 피드백]
1. 긍정적 피드백
- 발표자료 14페이지의 실제 PostgreSQL DB 검증, 자동 테스트, 19단계 통합 시나리오, 시험 데이터 정리 및 0건 확인을 구체적으로 제시한 점이 좋았습니다.

2. 통과 기준 명확화
- 단순히 ‘테스트 N건 통과’가 아니라 입력·예상 결과·실패 조건을 함께 기록합니다.
- 정상: HTTP 2xx와 DB 최종 상태가 기대값과 일치.
- 입력 오류: 422이며 DB 변경 없음.
- 인증·권한: 토큰 없음/로그아웃 토큰은 401, 일반 사용자의 관리자 API는 403, 타인 데이터 접근은 403 또는 404.
- 트랜잭션·동시성: 중복 주문은 1건만 생성, 예약 정원 초과 없음, 중간 실패 시 전체 롤백.
- 정리: 테스트 계정·주문·예약·상품 데이터를 삭제하고 잔여 0건 확인.

3. 사용한 테스트 틀
- Backend: pytest, pytest-asyncio, FastAPI/httpx 기반 API 테스트, SQLAlchemy·asyncpg 기반 실제 PostgreSQL 통합 테스트.
- Frontend: Node.js test runner(node --test), TypeScript(tsc --noEmit), ESLint.
- Build: next build.
- 발표 당시 결과는 Backend 385건, Frontend 145건 통과였으며 최신 상품 통합 문서에는 Frontend 153건과 Backend 선택 회귀·상품 검증 388건이 기록되어 있습니다. 아래 최종 제출 기준의 PR #40 브랜치 검증 수치는 발표 당시 수치와 구분합니다.

4. 수동 테스트와 사용자 모드 검증
- 비회원: 상품 조회·검색·필터, 비회원 장바구니.
- 일반 회원: 회원가입/로그인, 프로필·배송지, 찜·장바구니·주문·예약, 로그아웃 후 401.
- 관리자: 관리자 전용 로그인, 상품 운영·예약 접수 마감, 일반 회원 접근 403.
- PC·모바일 화면, 로딩·오류·빈 상태, 새로고침 후 상태 유지까지 브라우저에서 확인하고 캡처와 결과를 남깁니다. 로컬 브라우저 검증과 배포 환경 검증은 구분합니다.

5. API 추가 후 바로 배포 가능한가?
- API 구현만으로 즉시 배포 가능한 것은 아닙니다. Next.js와 FastAPI 배포 환경, DATABASE_URL·JWT_SECRET_KEY·CORS 허용 출처·NEXT_PUBLIC_API_BASE_URL, DB 마이그레이션/시드, 빌드·시작 명령과 헬스 체크를 준비해야 합니다. 이후 실제 배포 주소에서 회원/관리자 사용자 모드의 종단 간 수동 검증을 통과해야 배포 완료로 판단합니다.

6. 2026.10.28 최종 제출 기준
- PR #5로 회원·인증·마이페이지, 상품·찜·리뷰·재고, 장바구니·모의 주문·환불 신청, 체험 예약·취소를 main에 통합했습니다.
- PR #40의 Google 계정 연결 보완과 최종 README·ERD는 develop에 병합됐고 PR #42로 main에 반영됐습니다.
- PR #40 브랜치 로컬 검사: 백엔드 552건 통과·3건 건너뜀, 프런트 180건 통과, 타입 검사·린트·프로덕션 빌드 134페이지 성공.
- 고객 화면은 3000, 같은 Next.js 앱의 관리자 확인 포트는 3001, FastAPI는 8000입니다. 주요 로컬 경로에서 HTTP 200을 확인했습니다.
- ERD: docs/ERD-current.md. auth.users.id = app_users.id = profiles.id이고 JWT sub도 같은 UUID입니다.

7. 튜터 피드백 반영 개선 방향
- 통과 기준: 기능별 정상·오류·권한·중복 요청의 입력값, 예상 HTTP 응답, DB 저장 결과를 표로 정하고 자동·수동 테스트 결과를 함께 기록합니다.
- 사용자 관점 검증: 비회원·일반 회원·관리자 흐름을 PC와 모바일에서 직접 수행하고, 실패 안내·재시도·새로고침 후 상태까지 확인합니다.
- 배포 준비: 환경변수·OAuth 리디렉션·DB 마이그레이션·헬스 체크를 점검하고 실제 배포 주소에서 로그인부터 주문·예약까지 재검증합니다.
- 데이터 다이어그램: ERD의 PK·FK·관계선 표기를 통일하고 발표 화면에서도 글자와 연결 관계가 한눈에 보이도록 이미지를 다시 정리합니다.

팀 단위 튜터님 피드백 정리

[2026.10.28 최종 발표 튜터 피드백]
PPT 6페이지 「05 데이터 다이어그램」
- 표기 규칙을 찾아 적용하면 좋겠다는 의견을 받았습니다.
- 테이블과 관계가 한눈에 들어오도록 이미지를 더 직관적으로 구성하면 좋겠다는 의견을 받았습니다.
- 개선 방향: ERD의 PK·FK·관계 표기를 통일하고 글자 크기·배치·색을 정리합니다.

프로젝트 로직 플로우차트

graph LR
A[Frontend] --> B[Restore DB]
B --> C[FastAPI Base]
C --> D[Auth]
C --> E[Products]
C --> F[Orders]
C --> G[Reservations]
D --> H[Integration Test]
E --> H
F --> H
G --> H
H --> I[Deploy]

구현 흐름: 기존 화면 분석 → DB·Storage 복구 → FastAPI 공통 환경 → 인증·상품·주문·체험 개발 → develop 통합·자동/수동 검증 → PR #5 main 병합 → 인증 보완·최종 ERD/README PR #40 병합 → develop→main PR #42 병합.

2026.10.28 기준 최종 main에는 회원·인증·마이페이지, 상품·찜·리뷰·재고 운영, 비회원/회원 장바구니·모의 주문·환불 신청, 체험 예약·취소가 통합됐습니다. Google 계정 연결 보완과 최종 README·ERD도 PR #40·#42로 반영됐습니다. PR #40의 로컬 검증 결과는 백엔드 552건 통과·3건 건너뜀, 프런트 180건 통과, 타입 검사·린트 통과, 빌드 134페이지 생성입니다

API 명세서

Spring 1기 P1 API 명세서 (2)

Spring 1기 P1 WBS (2)