노션 협업 문서를 바탕으로 정리한 중급 프로젝트 README입니다.
- 프로젝트 기간: 2025-09-29 ~ 2025-10-22 (제출 마감 23:50)
- 목표
- 알바 공고와 가게/지원자를 잇는 서비스의 핵심 플로우(회원가입 → 프로필 → 공고 등록·조회 → 상세) 완성
- 공통 UI 컴포넌트(버튼/인풋/모달 등) 정리 및 Storybook 문서화
- **배포 파이프라인(Vercel)**과 팀 협업 파이프라인 정착
 |
 |
 |
 |
|---|---|---|---|
| 위소현(팀장) @sohyun0 |
박신천 @jeschun |
양재영 @BaeZzi813 |
유인화 @gummmmmy0v0 |
| 구성원 | 역할 | 공통 작업 | UI 컴포넌트 | 페이지 |
|---|---|---|---|---|
| 위소현 (팀장) | 프로젝트 관리/발표 | 초기 프로젝트 셋팅, 공용 문서 작성 및 관리(노션) | 헤더, 필터, 드롭다운, Post, 컨테이너, 스켈레톤 UI, 컬러, 폰트, 아이콘 | 공고 리스트, 공고 상세 |
| 박신천 | FE | 디자인 및 기능 QA, 본인 작업 관련 문서 | 인풋, 모달, 버튼 | 로그인, 회원가입, 내 프로필 등록, 프로필 상세 |
| 양재영 | FE | 시연 영상 준비, 디자인 및 기능 QA, 본인 작업 관련 문서 | 공통 프레임, 푸터, 토스트, 페이지네이션 | 가게 정보 등록, 가게 상세 |
| 유인화 | FE | 발표 자료 준비, 디자인 및 기능 QA, 본인 작업 관련 문서 | 테이블, 알림, 캘린더 | 가게 공고 등록, 공고 상세 |
- Next.js (React) + TypeScript
- Tailwind CSS (공통 컬러/폰트/유틸)
- Storybook (컬러/폰트/아이콘 가이드)
- ESLint · Prettier
- Vercel 배포
- GitHub Issues/Projects · 브랜치 전략 · 템플릿
- Discord/GitHub 웹훅
- 회원 인증: 회원가입, 로그인
- 마이페이지: 내 프로필 등록/수정, 상세 보기
- 가게: 가게 정보 등록, 상세
- 공고: 공고 리스트, 상세, 가게 공고 등록
- 공통 UI: 버튼, 인풋, 모달, 헤더, 필터, 드롭다운, 토스트, 페이지네이션, 스켈레톤, 테이블, 알림, 캘린더
- 상기 일정과 동일한 마일스톤 기준으로 각 작업을 세분화하여 진행 (퍼블리싱, API 연동, 리팩토링, 테스트/QA, 산출물 제작 등)
Next.js는 Pages Router 기준이며, API 디렉터리는 백엔드 통신 헬퍼 전용(프론트에서 사용)으로 취급합니다.
src
├── api
├── assets
│ ├── font
│ ├── icon
│ └── images
├── components
│ ├── features
│ ├── layout
│ └── ui
├── constants
├── context
├── hooks
├── lib
├── pages
│ ├── employer
│ ├── my-profile
│ ├── my-shop
│ ├── notices
│ ├── search.tsx
│ ├── login.tsx
│ ├── signup.tsx
│ ├── index.tsx
│ └── 404.tsx
├── stories
├── styles
└── types
구현 팁
components/features/는 도메인 단위 UI(예:PostForm,PostList) 중심.pages/에서는 라우팅과 데이터 주입만 담당하도록 분리.constants/에 라우트/키/에러 메시지 상수화 → 하드코딩 방지.
- 노션: 여기서 확인