Pollloop Frontend

설문 생성 및 관리 플랫폼

📚 목차

• 프로젝트 소개
• 주요 기능
• 기술 스택
• 팀 소개
• 프로젝트 산출물
• 실행 방법
• Git 규칙
• 체인지로그

📝 프로젝트 소개

Pollloop은 설문 생성 및 관리 플랫폼입니다. 사용자는 다양한 유형의 설문을 쉽게 생성하고 관리할 수 있으며, 미응답 참여자를 확인하고 참여 요청 이메일을 전송할 수 있습니다.

배포

• 배포 환경: Vercel
• 배포 방법: Vercel의 자체 CI/CD 파이프라인을 통한 자동 배포
  • main 브랜치 push 시 자동 배포
  • PR 생성 시 프리뷰 배포
• 배포 주소: https://pollloop.vercel.app/

개발 기간

• 2024.12.18 ~ 2024.01.16 (20일)

🎯 주요 기능

폼(Form)

• 다양한 유형의 질문 템플릿 제공
  • 단답형, 장문형, 체크박스, 라디오, 드롭다운
  • 범위 선택, 별점, 이미지 선택, 숫자, 날짜, 이메일
  • 파일 업로드 (이미지, PDF, 스프레드시트)
• 임시 저장 및 발행 기능
• 폼 결과 통계 및 시각화
• 참여자 관리 및 참여 요청 메일 발송

🛠 기술 스택

• Framework/Library: React + Vite
• Language: TypeScript
• State Management: Redux (Redux Toolkit)
• Styling: TailwindCSS
• Routing: React Router
• Form Management: React Hook Form + Zod
• HTTP Client: Axios
• Package Manager: pnpm

👥 팀 소개

Frontend (4명)

• 김소희(팀장) - 폼 만들기, 폼 참여, 폼 미리 보기
• 이햇님 - 회원가입, 로그인, 비밀번호 찾기/재설정/변경, 프로필
• 이혜민 - 홈, 폼 상세 조회_요약 및 통계
• 최푸른 - 나의 폼, 폼 상세 조회_참여자 목록 조회/관리

📋 프로젝트 산출물

프로젝트 미리 보기

회원가입, 로그인

로그인, 홈

프로필 - 프로필 이미지 변경, 비밀번호 변경

폼 만들기 - 기본 정보, 단답형, 장문형

폼 만들기 - 체크박스, 옵션 추가, 기타 옵션, 필수 여부 선택

폼 만들기 - 라디오, 드롭다운, 범위 선택

폼 만들기 - 이미지 선택

폼 만들기 - 숫자, 날짜, 이메일, 파일 업로드

폼 만들기 - 미리 보기

폼 만들기 - 임시 저장

폼 만들기 - 발행하기

참여 폼 - 폼 응답 및 제출하기

결과 보기 - 요약

결과 보기 - 참여자 목록

나의 폼 - 폼 목록

기획/설계

• 사용자 요구사항 정의서
• 와이어프레임
• 플로우차트
• 화면 정의서

API 연동

• API 명세서
• API 명세서(스웨거)

배포

• 배포 링크

💻 실행 방법

# 저장소 클론
git clone https://github.com/soheekimdev/Pollloop.git

# 패키지 설치
pnpm install

# 개발 서버 실행
pnpm dev

🔄 Git 규칙

브랜치 네이밍

• main: 배포용 브랜치
• develop: 개발용 브랜치
• feature/*: 기능 개발 브랜치

커밋 메시지

type: subject

body

• Type
  • feat: 새로운 기능 추가
  • fix: 버그 수정
  • docs: 문서 수정
  • style: 코드 포맷팅
  • refactor: 코드 리팩토링
  • design: CSS 등 사용자 UI 변경
  • rename: 파일/폴더명 수정 또는 위치 이동
  • test: 테스트 코드
  • chore: 빌드 업무 수정, 패키지 매니저 수정

예시:

feat: 로그인 기능 구현

- 이메일/비밀번호 유효성 검사 추가
- 로그인 API 연동
- 로그인 후 토큰 저장 구현