SYNAPS for JBNU 🏫

전북대학교 상권 활성화를 위한 AI 기반 통합 플랫폼

📋 프로젝트 개요

SYNAPS for JBNU는 전북대학교 주변 상권의 활성화를 목표로 하는 AI 기반 통합 플랫폼입니다. 사업자와 투자자를 연결하고, AI를 활용한 매출 분석, 정부 지원금 정보 제공, 크라우드 펀딩 등의 서비스를 제공합니다.

🎯 주요 기능

🏪 사장님 비서 (Business Dashboard)

• AI 매출 분석: Google Gemini AI를 활용한 매출 데이터 분석 및 인사이트 제공
• 정부 지원금 정보: 맞춤형 정부/지자체 지원금 추천 및 신청 시스템
• 크라우드 펀딩: 사업 확장을 위한 펀딩 생성 및 관리
• 채권 발행: 사업자 채권 발행 및 투자자 매칭

💰 내 지갑 비서 (User Dashboard)

• 자산 관리: 개인 투자 포트폴리오 관리
• 펀딩 투자: 관심 있는 사업에 투자 참여
• 맞춤 추천: AI 기반 투자 기회 추천

🌐 Synaps 커뮤니티

• 펀딩 지도: 전북대 주변 펀딩 프로젝트 지도 시각화
• 성공 사례: 펀딩 성공 사례 및 스토리 공유
• 투자자 리뷰: 투자 경험 및 리뷰 공유

🛠 기술 스택

Frontend

• Next.js 15.5.3 - React 기반 풀스택 프레임워크
• React 19.1.0 - 사용자 인터페이스 라이브러리
• TypeScript - 타입 안전성을 위한 정적 타입 언어
• Tailwind CSS 4 - 유틸리티 우선 CSS 프레임워크

AI & API

• Google Gemini AI - 매출 분석 및 콘텐츠 생성
• Next.js API Routes - 서버리스 API 엔드포인트

Development Tools

• Turbopack - 빠른 번들링을 위한 웹팩 대안
• ESLint - 코드 품질 관리
• PostCSS - CSS 후처리

📁 프로젝트 구조

synaps-jbnu/
├── src/
│   ├── app/
│   │   ├── api/                    # API 라우트
│   │   │   ├── analyze-sales/      # AI 매출 분석 API
│   │   │   ├── bonds/              # 채권 관련 API
│   │   │   ├── business-bonds/     # 사업자 채권 API
│   │   │   └── generate-content/   # AI 콘텐츠 생성 API
│   │   ├── business/               # 사장님 비서 페이지
│   │   │   ├── dashboard/          # 사업자 대시보드
│   │   │   ├── bonds/              # 채권 발행
│   │   │   ├── funding/            # 펀딩 생성
│   │   │   └── support-funds/      # 정부 지원금
│   │   ├── user/                   # 내 지갑 비서 페이지
│   │   │   ├── dashboard/          # 사용자 대시보드
│   │   │   └── funding/            # 펀딩 투자
│   │   ├── community/              # 커뮤니티 페이지
│   │   │   ├── funding-map/        # 펀딩 지도
│   │   │   ├── success-stories/    # 성공 사례
│   │   │   └── investor-reviews/   # 투자자 리뷰
│   │   └── page.tsx                # 메인 온보딩 페이지
│   └── components/                 # 재사용 가능한 컴포넌트
├── public/                         # 정적 파일
└── package.json                    # 프로젝트 의존성

🚀 시작하기

필수 요구사항

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

설치 및 실행

1. 저장소 클론

git clone https://github.com/your-username/synaps-jbnu.git
cd synaps-jbnu

2. 의존성 설치

npm install

3. 환경 변수 설정

cp .env.example .env.local

.env.local 파일에 필요한 환경 변수를 설정하세요:

GOOGLE_AI_API_KEY=your_gemini_api_key_here

4. 개발 서버 실행

npm run dev

5. 브라우저에서 확인 http://localhost:3000에서 애플리케이션을 확인할 수 있습니다.

📱 주요 페이지

메인 페이지 (/)

• 사용자 역할 선택 (사장님 비서 / 내 지갑 비서)
• 커뮤니티 접근

사장님 비서 (/business/dashboard)

• 매출 현황 및 AI 분석
• 맞춤 지원금 추천
• 펀딩 및 채권 현황

정부 지원금 (/business/support-funds)

• 지원금 목록 및 검색/필터링
• 상세 정보 및 신청 프로세스

커뮤니티 (/community)

• 펀딩 지도 시각화
• 성공 사례 및 투자자 리뷰

🔧 개발 스크립트

# 개발 서버 실행 (Turbopack 사용)
npm run dev

# 프로덕션 빌드
npm run build

# 프로덕션 서버 실행
npm start

# 코드 린팅
npm run lint

🌟 주요 특징

AI 기반 분석

• Google Gemini AI를 활용한 매출 데이터 분석
• 개인화된 비즈니스 인사이트 제공
• 자동화된 콘텐츠 생성

맞춤형 지원금 시스템

• 사업자 정보 기반 지원금 추천
• 실시간 신청 가능 여부 확인
• 단계별 신청 프로세스

직관적인 UI/UX

• 반응형 디자인
• 모던한 인터페이스
• 사용자 친화적인 네비게이션

🤝 기여하기

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

📞 문의

프로젝트에 대한 문의사항이 있으시면 이슈를 생성해 주세요.

---

SYNAPS for JBNU - 전북대학교 상권 활성화를 위한 혁신적인 플랫폼 🚀