팀 프로젝트를 원활히 시작하고 협업 효율을 높이기 위해, 아래 항목들을 팀원들과 함께 논의한 후 구체적으로 작성해 주세요.

💡 프로젝트 주제

welive_5팀_고급프로젝트 (2026.02. 13 ~ 2026. 04. 01)

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

팀원	주요 담당
박건순	Auth, User, Apartment API 개발 / AWS 설계
김선영	Residents, Complaints, Comments API 개발 / Github CICD , Sentry
유인학	Polls, Notice, Notifications, Events등 나머지 API 개발 / 프론트엔드 연동

🗓️ 프로젝트 일정 요약

항목	기간	내용
기획 및 요구사항 정리	02.19 ~ 02.23	프로젝트 방향성 논의, 협업 문서 정리, 기초 설계(스키마 등)
1차 개발 스프린트	02.24 ~ 03.05	본인이 맡은 업무 API 개발
중간 발표	03.06	발표
2차 개발 스프린트	03.07 ~ 03.18	본인이 맡은 업무 API 개발
	03.19 ~ 03.20	1차 API 개발 마무리
	03.23 ~ 03.29	2차 개발 시작 (프론트엔드 & CICD & AWS)
	03.30	개발 작업 모두 완료 / 최종 테스트
자료 및 영상 녹화	03.31	발표자료 준비 및 시연 영상 녹화
최종 발표	04.01	발표

⚙️ 기술 스택 및 협업 도구

분류	사용 예정 도구
Language(언어)	TypeScript, JavaScript
Runtime/Framework(런타임/프레임워크)	Node.js, Express
Database(DB)	PostgreSQL
ORM/DB Tool(ORM)	Prisma
Validation(검증)	superstruct
API 문서화	Swagger (OpenAPI)
협업 도구	Discord, GitHub, Notion
CI/CD (배포)	GitHub Actions
인프라 (AWS)	EC2(서버), RDS(DB), S3(파일 저장) 등

🧩 규칙 수립

항목	내용
네이밍 컨벤션	camelCase (변수, 함수), kebab-case (파일), SCREAMING_SNAKE_CASE (열거형)

ex) auth-task.controller.ts (Layer 앞에 .) | | 커밋 컨벤션 | # ✨ feat : 새로운 기능 추가

🐛 fix : 버그 수정

📝 docs : 문서 수정

🛠️ refactor : 리팩토링 (코드)

✅ test : 테스트 추가/수정

🔥 remove : 코드/파일 삭제

♻️ chore(update) : 유지보수 작업(빌드/설정/패키지 등) |

| 브랜치 전략 | main, dev, feat/기능명, chore/기능명 | | PR 규칙 | 1명 이상 Approve 시 Merge |

👍 잘한 점

매주 멘토님의 코드 리뷰를 통해 피드백을 받았으며, 해당 내용을 리스트로 정리한 후 이를 기반으로 코드를 리팩토링했습니다.
매일 13시에 스크럼 회의를 진행하며 각자의 작업 진행 상황을 공유하고, 작업 속도나 도움이 필요한 부분을 빠르게 파악하여 적극적으로 소통하며 협업을 이어갔습니다. 이를 통해 모두가 유사한 수준의 이해도를 유지할 수 있도록 노력했습니다.
기존에는 아파트 정보를 한 번만 입력받다 보니 모든 동의 층수와 호수가 똑같아야만 하는 현실과 동떨어진 문제가 있었습니다. 이를 해결하기 위해 동별로 시작 층, 끝 층, 호수를 각각 다르게 설정할 수 있도록 구조를 유연하게 바꿨고, 동시에 시스템 부하를 막기 위해 최대 데이터 생성량을 제한하여 예상치 못한 대량 요청 공격에도 견딜 수 있는 안전한 설계로 개선했습니다.(struct.ts에서 max값 설정)