이랑 — 귀농 정보 큐레이션 포탈
"어디서, 무엇을, 어떻게" — 귀농에 필요한 정보를 한곳에서.
흩어진 지원사업, 지역 환경, 작물 데이터를 조건 기반으로 큐레이션하여,
귀농 예정자가 5분 만에 자신에게 맞는 로드맵을 확인할 수 있는 웹서비스입니다.
왜 이랑인가요?
귀농을 고려하는 도시 직장인에게 가장 큰 허들은 정보의 파편화입니다.
| 현재 문제 | 이랑의 해결 |
|---|
| 지원사업 정보가 농사로, 지자체, 귀농귀촌종합센터 등에 흩어져 있음 | 조건(나이 x 지역 x 작물) 기반 지원사업 검색 |
| 지역 선택에 필요한 기후/인프라/인구 데이터를 직접 비교하기 어려움 | 시군구별 거주환경/재배환경 비교 대시보드 |
| 기존 서비스(팜모닝, 그린랩스)는 현직 농민 대상 | 귀농 "예정자"에게 맞춘 정보 설계 |
"이랑"은 밭을 갈 때 생기는 고랑 사이의 두둑을 뜻합니다.
농업의 본질을 담으면서, "함께 이랑(나란히)"이라는 중의적 의미를 가집니다.
핵심 기능
Phase 1 — 정보 큐레이션 MVP ✅ (2026-04)
- 지역 탐색
/regions — 시·도 → 시·군·구 → 읍·면 드릴다운, 비교·랭킹(/regions/ranking)
- 지원사업 검색
/programs — 나이/지역/희망 작물 조건 필터 + 로드맵
- 작물 정보
/crops — 재배 환경, 수익성, 난이도, 비교
Phase 2 — 진단 v2.0 + SEO 발견성 ✅ (2026-04 ~ 2026-08)
- 귀농 진단
/assess — 유형 분류·공유 링크(/assess/r/[data])·결과 저장
- SEO — JSON-LD 구조화 데이터, sitemap, 소프트 404 정리, OG 이미지
- 신뢰 — 면책 고지(
/about/disclaimer), 정정 이력(/about/corrections), 업데이트 소식(/about/updates)
- 콘텐츠 — 인터뷰(
/interviews), 가이드 5종(/guides), 용어집, 비용 계산(/costs)
Phase 3 — 커뮤니티 & 콘텐츠 🔄 (2026-09 ~)
- ✅ 1단계 '한 줄 의견' — 사전 승인제 + 룰 기반 스팸 필터 + admin 승인 큐 (2026-09-02)
- ⏳ 2단계 Q&A / 후기 — 1단계 참여 지표 확인 후 판단
Phase 4 — 스마트팜 연계 (미정)
- 스마트팜 장비/솔루션 연계, 재배 관리 대시보드
기술 스택
| 영역 | 기술 |
|---|
| Frontend | Next.js 16 (App Router) / TypeScript / CSS Modules / lucide-react |
| Backend | Next.js API Routes (Serverless) |
| Database | Supabase (PostgreSQL + Edge Functions) |
| Hosting | Vercel |
| Data Pipeline | GitHub Actions / TypeScript (공공데이터 API + Supabase Edge Functions) |
| CI/CD | GitHub Actions (Lint · Type-check · Build) + Vercel 자동 배포 |
| Analytics | Google Analytics 4 + Vercel Analytics |
데이터 소스
공공데이터 API와 공식 통계를 활용하여 신뢰도 높은 정보를 제공합니다.
| 데이터 | 출처 |
|---|
| 기상 (기온/강수/일조) | 기상청 ASOS API |
| 의료기관 | 건강보험심평원 API |
| 학교 위치 | 교육부 표준데이터 |
| 인구/고령화율 | 통계청 SGIS API |
| 작물 재배면적/생산량 | 통계청 KOSIS API |
| 귀농 지원사업 | 농림축산식품부 / AgriX |
시작하기
사전 준비
- Node.js 20+
- Supabase 프로젝트 (PostgreSQL)
- 공공데이터 API Key (data.go.kr)
설치 및 실행
# 1. 저장소 클론
git clone https://github.com/KangseonLEE/irang.git
cd irang
# 2. 의존성 설치
npm install
# 3. 환경변수 설정
cp .env.local.example .env.local
# .env.local 파일을 열어 실제 키 입력
# 4. 개발 서버 실행
npm run dev
http://localhost:3000 에서 확인할 수 있습니다.
환경변수
| 변수명 | 설명 |
|---|
DATA_GO_KR_API_KEY | 공공데이터포털 인증키 |
SGIS_CONSUMER_KEY | 통계청 SGIS 서비스ID |
SGIS_CONSUMER_SECRET | 통계청 SGIS 보안KEY |
KOSIS_API_KEY | KOSIS Open API 인증키 |
NEXT_PUBLIC_SUPABASE_URL | Supabase 프로젝트 URL |
NEXT_PUBLIC_SUPABASE_ANON_KEY | Supabase Anonymous Key |
프로젝트 구조
src/
├── app/ # Next.js App Router 페이지
│ ├── page.tsx # 랜딩 페이지
│ ├── regions/ # 지역 비교 (시도 → 시군구)
│ ├── crops/ # 작물 정보
│ ├── programs/ # 지원사업 검색
│ ├── education/ # 귀농 교육
│ ├── events/ # 체험 행사
│ ├── interviews/ # 귀농인 인터뷰
│ ├── stats/ # 통계 (인구·청년·만족도)
│ ├── match/ # 맞춤 지역·작물 추천
│ ├── assess/ # 귀농 적합성 진단
│ ├── search/ # 통합 검색
│ └── api/ # Route Handlers (프록시)
├── components/
│ ├── ui/ # 공통 UI 컴포넌트
│ ├── filter/ # FilterBar 계열
│ ├── landing/ # 랜딩 전용 섹션
│ ├── charts/ # Recharts 래퍼
│ ├── map/ # SVG 지도
│ └── layout/ # Header, Footer, Nav
├── lib/
│ ├── api/ # 외부 API 연동 (8개)
│ ├── data/ # 정적 데이터 (폴백 포함)
│ └── hooks/ # 커스텀 훅
└── types/ # 공유 타입 정의
supabase/ # Supabase 스키마·마이그레이션·Edge Functions
scripts/ # 유틸리티 스크립트
CI/CD & 자동화
| 워크플로우 | 트리거 | 설명 |
|---|
CI (ci.yml) | PR / main push | ESLint 린트 → TypeScript 타입 체크 → Next.js 빌드 |
외부 링크 헬스체크 (check-links.yml) | 매일 09:00 KST | sourceUrl 유효성 검증, 깨진 링크 발견 시 Issue 자동 생성 |
정책 데이터 검증 (check-policy.yml) | 매주 월 09:00 KST | 정부 지원사업 출처 URL 스냅샷 비교 |
데이터 동기화 (sync-data.yml) | 매일 06:00 KST | Supabase Edge Function 호출 (RDA API + 웹 크롤링) |
배포는 git push origin main 시 Vercel이 자동으로 트리거합니다.
로드맵
| 마일스톤 | 내용 | 목표 시점 |
|---|
| M0 | 시장조사 + PRD 확정 | 2026-04 ✅ |
| M1 | 데이터 소스 확보 + 스키마 설계 | 2026-04 ✅ |
| M2 | MVP 개발 + 배포 (irangfarm.com) | 2026-04 ✅ |
| M3 | 진단 v2.0 + SEO + 신뢰 장치 | 2026-08 ✅ |
| M4 | 커뮤니티 1단계 출시 | 2026-09-02 ✅ |
| M5 | 유입·참여 지표 기반 Go/No-Go (커뮤니티 2단계) | 2026-10 ⏳ |
라이선스
이 프로젝트는 개인 사이드 프로젝트입니다. 라이선스는 추후 결정 예정입니다.
