Skip to content

prgrms-aibe-devcourse/AIBE1_FinalProject_LastDance_FE

Repository files navigation

우리.zip - 생활 관리 플랫폼 (Frontend)

팀 소개

조다미 반준영 한정호 진소희 조준호
@dochmai382 @aibeban @hanjungho @soheeGit @lSNOTNULL

프로젝트 개요

우리.zip은 하우스메이트와 함께하는 스마트한 공동생활 관리 플랫폼입니다.
일상 관리, 소비 분석, 집안일 분담 등을 하나의 서비스로 통합하여 쾌적하고 공정한 공동 생활 환경을 조성하는 웹 기반 서비스입니다.

주요 기능

  • 스마트 대시보드 개인과 그룹의 모든 활동을 한눈에 시각화하여 보여줍니다. 할일 완료율, 지출 패턴, 일정 현황 등을 종합적으로 분석하여 맞춤형 인사이트를 제공합니다.
    Image

  • 통합 캘린더
    개인 일정과 그룹 일정을 하나의 캘린더에서 관리할 수 있습니다. 월간, 주간, 일간 보기 모드를 지원하며, 일정 충돌을 방지하고 알림 기능을 제공합니다.
    Image

  • 할일 관리
    집안일, 업무 등 다양한 할 일을 그룹 구성원에게 공평하게 분배하고, 실시간 진행 상황을 추적합니다. 우선순위 설정 및 마감일 관리 기능을 지원합니다.
    Image

  • 스마트 가계부 공동 지출 내역을 기록하고 자동 분할 계산 기능을 제공합니다. 카테고리별 지출 분석 및 월별 예산 관리 기능을 통해 효율적인 소비를 돕습니다.
    Image

  • AI 생활 도우미 사용자의 생활 패턴을 분석하여 맞춤형 조언을 제공합니다. 효율적인 일정 관리 및 스마트한 절약 팁 등을 제안합니다. Image

  • 커뮤니티 생활 팁, 레시피, 청소 방법 등 다양한 정보를 공유하고, 사용자 간의 경험을 나눌 수 있는 커뮤니티 기능을 제공합니다. Image

  • 청년정책 정보 주거, 취업, 창업, 교육 등 청년들을 위한 다양한 정책 정보를 제공합니다. 최신 혜택 정보를 큐레이션하고 신청 방법 및 기간 등을 안내합니다. Image

기술 스택

구분 기술
Core React TypeScript Vite
State & Data Zustand Axios
UI & Routing Tailwind CSS Framer Motion React Router
배포 Vercel

시스템 아키텍쳐

Image

시작하기

1. 필수 요구사항

  • Node.js 18.0.0 이상
  • npm 또는 yarn

2. 설치 및 실행

# 1. 저장소 클론
git clone [repository-url]
cd woori-zip

# 2. 의존성 설치
npm install

# 3. 환경 변수 설정
cp .env.example .env
# .env 파일을 열어 필요한 값을 설정하세요

# 4. 개발 서버 실행
npm run dev

상세 정보

프로젝트 구조

src/
├── components/           # 재사용 가능한 컴포넌트
│   ├── auth/            # 인증 관련 컴포넌트
│   ├── calendar/        # 캘린더 기능
│   ├── community/       # 커뮤니티 기능
│   ├── dashboard/       # 대시보드
│   ├── expenses/        # 가계부 관리
│   ├── games/           # 미니게임
│   ├── layout/          # 레이아웃 컴포넌트
│   └── tasks/           # 할일 관리
├── api/                 # API 호출 함수들
├── store/               # Zustand 스토어
├── types/               # TypeScript 타입 정의
├── hooks/               # 커스텀 훅
└── utils/               # 유틸리티 함수

개발 스크립트

# 개발 서버 실행
npm run dev

# 타입 체크
npm run type-check

# 린팅
npm run lint

# 프로덕션 빌드
npm run build:prod

# 미리보기 서버
npm run preview

기여하기

  1. 이슈를 먼저 등록해주세요.
  2. Feature 브랜치를 생성하세요 (git checkout -b feature/AmazingFeature).
  3. 변경사항을 커밋하세요 (git commit -m 'Add some AmazingFeature').
  4. Pull Request를 생성하세요.

라이선스

이 프로젝트는 MIT 라이선스를 따릅니다.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5

Languages