🏠 UNI Dorm (유니돔)

인천대학교 기숙사 생활을 더욱 편리하고 즐겁게!
UNIDorm은 기숙사 사생들을 위한 룸메이트 매칭, 공동구매, 민원 접수 및 커뮤니티 기능을 제공하는 통합 플랫폼입니다.

---

✨ Key Features (주요 기능)

👥 룸메이트 매칭 (Roommate Matching)

• 생활 패턴 기반 필터링: 수면 시간, 흡연 여부, 청소 주기 등 본인과 맞는 룸메이트를 쉽게 찾을 수 있습니다.
• 체크리스트: 룸메이트와 함께 확인해야 할 항목들을 관리합니다.

📦 공동구매 (Group Purchase)

• 배달비/배송비 절약: 기숙사 근처에서 함께 물건이나 음식을 주문할 파티원을 모집합니다.
• 키워드 알림: 관심 있는 공동구매 품목이 올라오면 즉시 알림을 받습니다.

💬 실시간 채팅 (Real-time Chat)

• 룸메이트 & 공동구매: 매칭된 상대나 공동구매 참여자들과 실시간으로 소통할 수 있습니다.

📋 기숙사 행정 & 커뮤니티

• 민원 접수: 시설 보수 등 기숙사 관련 민원을 관리자에게 직접 전달하고 답변을 확인합니다.
• 공지사항 & 꿀팁: 기숙사 공지사항과 사생들만의 생활 꿀팁을 공유합니다.
• 학사 일정: 기숙사 및 학교의 주요 일정을 캘린더로 한눈에 확인합니다.

🛠 관리자 페이지 (Admin Panel)

• 통계 대시보드: 사용자 및 서비스 이용 현황을 파악합니다.
• 콘텐츠 관리: 공지사항 작성, 민원 답변, 팝업 알림 설정 등을 통합 관리합니다.

---

🛠 Tech Stack (기술 스택)

Frontend

• v19
• 
• 

State Management & Data Fetching

• 
• 

Styling & Animation

• 
• 

Communication & Real-time

• 
• (STOMP)
• (FCM & Push)

---

📁 Project Structure (프로젝트 구조)

src/
├── apis/          # Axios 인스턴스 및 API 정의
├── assets/        # 이미지, 아이콘 등 정적 자원
├── components/    # 재사용 가능한 UI 컴포넌트
├── constants/     # 고정 값, 경로 설정
├── hooks/         # 커스텀 훅
├── pages/         # 주요 화면 페이지
├── routes/        # 라우팅 설정
├── stores/        # Zustand 상태 관리
├── styles/        # 전역 및 공통 스타일 (Styled-components)
├── types/         # TypeScript 타입 정의
└── utils/         # 공통 유틸리티 함수

---

🚀 Getting Started (시작하기)

1. Repository Clone

git clone https://github.com/inu-appcenter/UNIDorm-web.git
cd unidorm-web

2. Dependencies Install

npm install

3. Environment Variables (.env)

루트 디렉토리에 .env 파일을 생성하고 필요한 API Key 및 설정을 입력하세요.

VITE_API_SUBDOMAIN=your_api_url
...

4. Run Development Server

npm run dev

---

© 2026 INU Appcenter. All rights reserved.