보조금 파인더 (bojo24)

행정안전부 보조금24 정보를 AI로 요약하고 쉽게 찾을 수 있는 플랫폼

🌐 Live: bojo24.vercel.app

✨ 주요 기능

• 🔍 스마트 검색: 카테고리별 보조금 검색 및 필터링
• 🤖 AI 요약: Google Gemini로 복잡한 내용을 3줄 요약
• ❓ FAQ 자동 생성: 자주 묻는 질문 5개 자동 생성
• 📱 반응형 디자인: 모바일/데스크톱 최적화
• 🚀 빠른 로딩: Next.js 14 App Router 기반 최적화

🛠 기술 스택

• Framework: Next.js 14.2.3 (App Router)
• Language: TypeScript 5.5.3
• Styling: Tailwind CSS 3.4.1
• Database: Supabase
• AI: Google Gemini API
• Deployment: Vercel
• CI/CD: GitHub Actions

🚀 빠른 시작

로컬 개발

1. 저장소 클론

   git clone https://github.com/lsk7209/bojo24.git
   cd bojo24
   

2. 의존성 설치

   npm install
   

3. 환경 변수 설정

   cp ENV_SAMPLE.txt .env
   # .env 파일을 열어 실제 값으로 수정
   

   필수 환경 변수:

   • SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, SUPABASE_ANON_KEY
   • GEMINI_API_KEY
   • PUBLICDATA_SERVICE_KEY_ENC

4. 개발 서버 실행

   npm run dev
   

   브라우저에서 http://localhost:3000 열기

데이터 수집

# 보조금 데이터 수집
npm run fetch:benefits

# AI 요약 생성
npm run gen:gemini

📦 스크립트

명령어	설명
npm run dev	개발 서버 실행
npm run build	프로덕션 빌드
npm run start	프로덕션 서버 실행
npm run lint	ESLint 실행
npm run fetch:benefits	보조금 데이터 수집
npm run gen:gemini	AI 요약 생성

🗄 데이터베이스 구조

benefits 테이블

CREATE TABLE benefits (
  id TEXT PRIMARY KEY,
  name TEXT NOT NULL,
  category TEXT,
  governing_org TEXT,
  detail_json JSONB,
  last_updated_at TIMESTAMPTZ,
  gemini_summary TEXT,
  gemini_faq_json JSONB
);

🚢 배포

Vercel 배포 (권장)

1. Vercel에 GitHub 저장소 연결
2. 환경 변수 설정 (Vercel 대시보드)
3. 자동 배포 완료!

자세한 배포 가이드는 DEPLOYMENT.md 참고

GitHub Actions

프로젝트에는 다음 자동화 워크플로우가 포함되어 있습니다:

• CI/CD: 코드 푸시 시 자동 빌드 검증
• Data Sync: 매일 자동 데이터 수집 및 AI 요약 생성

📁 프로젝트 구조

bojo24/
├── src/
│   ├── app/              # Next.js App Router 페이지
│   │   ├── benefit/     # 보조금 목록/상세
│   │   ├── admin/       # 관리자 페이지
│   │   └── blog/        # 블로그
│   ├── components/      # 재사용 컴포넌트
│   ├── lib/             # 유틸리티 함수
│   │   ├── env.ts       # 환경 변수 검증
│   │   └── supabaseClient.ts
│   ├── scripts/         # 데이터 수집/AI 생성
│   └── types/           # TypeScript 타입
├── .github/workflows/   # GitHub Actions
├── public/              # 정적 파일
└── vercel.json          # Vercel 설정

🔧 환경 변수

자세한 환경 변수 설정은 ENV_SETUP.md 참고

필수

• SUPABASE_URL
• SUPABASE_SERVICE_ROLE_KEY
• SUPABASE_ANON_KEY
• GEMINI_API_KEY
• PUBLICDATA_SERVICE_KEY_ENC

선택

• PUBLICDATA_BASE_URL (기본값 사용 가능)
• PUBLICDATA_DELAY_MS (기본값: 600)
• PUBLICDATA_PAGE_SIZE (기본값: 100)
• NEXT_PUBLIC_SITE_URL (SEO용)

🧪 품질 체크

# Lint 검사
npm run lint

# 타입 체크
npx tsc --noEmit

# 빌드 테스트
npm run build

📚 문서

• 환경 변수 설정
• 배포 가이드
• Supabase 설정

🤝 기여

이슈 및 Pull Request 환영합니다!

📄 라이선스

MIT License

---

bojo24 - 보조금 정보를 쉽고 빠르게