이랑 — 귀농 정보 큐레이션 포탈

"어디서, 무엇을, 어떻게" — 귀농에 필요한 정보를 한곳에서.

흩어진 지원사업, 지역 환경, 작물 데이터를 조건 기반으로 큐레이션하여, 귀농 예정자가 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 ⏳

---

라이선스

이 프로젝트는 개인 사이드 프로젝트입니다. 라이선스는 추후 결정 예정입니다.

---