프로젝트 계획서 TEAM4

💡 프로젝트 주제

위리브
관련 문서 [https://codeit.notion.site/1f46fd228e8d80cdbc7af27b082d118d?pvs=143]
API SWAGGER [https://nb-project-welive-be.vercel.app/api]

👥 프로젝트 구성원과 R&R

팀원	주요 담당
박태원	팀장, 민원 관리, 공지사항 관리, 댓글관리, 이벤트관리
서석규	아파트 관리, 투표관리, 투표 스케쥴, 발표영상 촬영
이경민	서기, 인증 및 사용자 관리, 입주민관리
이창호	알림관리, 배포

🗓️ 프로젝트 일정 요약

항목	기간	내용
기획 및 요구사항 정리	3월26일 ~ 3월 27일	프로젝트 방향성 논의, 기능 리스트 작성
1차 개발 스프린트	3월 28일~4월 15일	주요 기능 구현 시작 (메인화면,로그인, 각 API 등)
중간 발표 & 회고	4월16일 13시	기능 시연 + 피드백 수렴
2차 개발 스프린트	4월17일~5월08일	나머지 기능 개발, 테스트, 버그 수정
최종 발표 & 회고	5월09일~5월11일 10시	발표 자료 정리 및 시연

✅ Git 협업 규칙

Git 협업 규칙 v1

📁폴더 구조

nb07-welive-team4/
├── .github/workflows/      # CI/CD (PR 체크, 배포, Claude 리뷰)
├── prisma/                 # DB 스키마 및 마이그레이션
├── src/
│   ├── controllers/        # 요청/응답 처리
│   ├── services/           # 비즈니스 로직
│   ├── repositories/       # DB 쿼리
│   ├── routes/             # API 엔드포인트 등록
│   ├── middlewares/        # 인증, 에러 처리 등 공통 로직
│   ├── structs/            # 입력값 유효성 검사
│   ├── types/              # TypeScript 타입 정의
│   ├── lib/                # 외부 서비스 연결 (DB, Redis, S3)
│   ├── queue/              # 알림 큐
│   ├── workers/            # 백그라운드 작업
│   └── utils/              # 유틸리티 함수
├── tests/                  # 통합 테스트
└── Dockerfile, compose.yaml, tsconfig 등 설정 파일

⚙️ 기술 스택 및 협업 도구

분류	사용 예정 도구
Backend	Node.js (Express)
Database	postgresql
API 문서화	Swagger
협업 도구	Discord, GitHub, Notion
일정 관리	GitHub Issues + Notion 타임라인