[Meeting] 기능정의서 검토 및 역할 분배

[haewonwon]

참석자
@haewonwon @seohyeon0219 @junnyya @sopramdong @kimjihu24

서론

• 저번 주 회의에서 프로토타입 기능을 정리함
• 이를 바탕으로 LLM을 활용해 기능 정의서 초안 작성함
  • https://www.notion.so/v0-2b27cb311a978097bc82f2a642faa948?source=copy_link

본론

• 오늘 할 일
  • 기능 정의서 초안을 검토하여 v1로 승격
  • 기능 정의서(v1)을 바탕으로 역할 분배

결론

• 기능 정의서를 완벽하게 작성할 필요는 없음
• 다만, 예외처리는 확실하게 정의하는 게 좋을 듯

[haewonwon]

src/
├── app/                      # 애플리케이션의 진입점 및 전역 설정
│   ├── providers/            # React Query, Router, Global Context 등
│   ├── styles/               # 전역 스타일 (reset.css 등)
│   └── index.js              # Entry Point
│
├── pages/                    # 라우팅 단위의 페이지 조합 (Widgets 조합)
│   ├── home/                 # 메인 페이지 (룰렛, 카테고리 탭)
│   ├── shop-list/            # 가게 목록 페이지
│   └── shop-detail/          # 가게 상세 페이지 (정보 + 리뷰)
│
├── widgets/                  # 페이지를 구성하는 독립적인 UI 블록 (Entities + Features)
│   ├── header/               # 닉네임 표시가 포함된 헤더
│   ├── roulette-section/     # 룰렛 기능과 UI가 결합된 섹션
│   ├── shop-list-view/       # 카테고리별 가게 목록 뷰
│   ├── review-board/         # 리뷰 목록 + 작성 폼이 결합된 섹션
│   └── shop-info-card/       # 가게 상세 정보 카드
│
├── features/                 # 사용자의 행동(비즈니스 로직) 처리
│   ├── auth/                 # 인증/유저 관련 기능
│   │   └── generate-nickname/# (기능) 랜덤 닉네임 생성 및 로컬스토리지 저장 로직
│   ├── roulette/             # 룰렛 게임 관련 기능
│   │   └── play/             # (기능) 랜덤 추천 알고리즘, 애니메이션 상태 관리
│   ├── review/               # 리뷰 관련 기능
│   │   └── write/            # (기능) 작성 폼, 유효성 검사(300자, 이미지 5MB), 등록
│   └── shop/                 # 가게 관련 기능
│       └── filter-category/  # (기능) 카테고리 선택 및 필터링 로직
│
├── entities/                 # 비즈니스 데이터 모델 및 데이터를 보여주는 순수 UI
│   ├── user/                 # 유저 모델
│   │   ├── model/            # 닉네임 state 관리
│   │   └── ui/               # UserBadge (헤더용 닉네임 표시 칩)
│   ├── shop/                 # 가게 모델
│   │   ├── api/              # 가게 데이터 fetch
│   │   └── ui/               # ShopCard (리스트 아이템), ShopDetailInfo (상세 정보)
│   ├── review/               # 리뷰 모델
│   │   ├── model/            # 리뷰 데이터 타입 정의 (JS 객체 구조)
│   │   └── ui/               # ReviewItem (개별 리뷰 표시)
│   └── category/             # 카테고리 모델
│       └── ui/               # CategoryTab (단일 탭 UI)
│
└── shared/                   # 재사용 가능한 공통 로직 및 UI (비즈니스 로직 없음)
    ├── api/                  # Axios 인스턴스, 공통 에러 처리
    ├── lib/                  # 유틸리티 함수
    │   ├── local-storage.js  # Storage 접근/예외 처리 래퍼
    │   ├── random.js         # 랜덤 숫자/추첨 유틸
    │   └── date.js           # 날짜 포맷팅
    └── ui/                   # 공통 컴포넌트 (Design System)
        ├── Button/
        ├── Modal/
        ├── Input/
        ├── StarRating/       # (UI) 별점 표시/선택 컴포넌트
        └── ImageUploader/    # (UI) 이미지 미리보기 및 파일 선택

[haewonwon]

기능정의서 초안을 바탕으로 생성된 FSD 폴더 구조입니다!