복지그루

멋쟁이사자처럼 Campus AX-Ton 강원대 · 팀 프로젝트 팀명: 멋쟁이 밤티들

기관 담당자가 학부모 문의를 받았을 때 아동 조건을 넣으면, 어디에 · 무엇을 들고 · 언제까지 가야 하는지를 한 장으로 정리해 학부모에게 그대로 건넬 수 있게 만드는 업무 도구.

학부모가 한 번에 갖춰 오게 만들어 담당자의 반송과 재문의를 줄입니다 · 과제 트랙: 업무 효율화

이름은 「복지」와 나무 한 그루의 「그루」를 붙인 것입니다. 부처마다 갈라져 있는 지원제도를 한 그루로 모아 담당자와 학부모가 같은 한 장을 본다는 뜻입니다.

---

무엇이 문제인가

아이에게 장애가 있다는 것을 막 알게 된 부모는 무엇부터 해야 하는지 모릅니다. 그래서 기관에 전화합니다. 그런데 전화를 받은 담당자도 전부를, 그리고 지금 기준으로는 알기 어렵습니다.

세 겹으로 갈라져 있기 때문입니다.

무엇이 갈라져 있나	근거
부처가 갈려 있다 — 교육·복지·의료·고용	소관 부처별 신청처 상이
같은 교육청 안에서도 담당자가 갈려 있다	강원도교육청 지침 원문
제도 이름이 지역마다 다르고, 시간이 지나면 또 바뀐다	6개 시도 카드 명칭 대조

확인한 사실 두 가지

① 같은 지원인데 시도마다 이름이 다릅니다

시도	서울	경기	인천	강원	충남	경남
카드명	굳센카드	꿈이든카드	참좋은카드	마음모아카드	디딤카드	특기적성비지원카드

② 폐지된 용어가 공식 지침에 남아 있습니다

2019년 7월 장애등급제가 폐지되어 「장애등급」이 「장애정도」로 바뀌었습니다. 그런데 2025년 지침에서 강원은 1회(전환 안내 목적), 경남은 14회(제출 서류로 반복 명시) 「장애등급」을 쓰고 있습니다.

경남 지침대로 안내하면 보호자에게 *"장애등급 결정서를 가져오세요"*라고 말하게 되는데, 2019년 7월 이후 등록한 보호자에게는 그런 서류가 없습니다.

---

사업 구조 — B2G2C

	누구	성격
구매자	시도교육청 / 교육지원청	B2G
사용자	기관 담당자	B2G
수혜자	학부모 (무료)	2C

교육청 조직은 위탁이 아니라 직할입니다. 특수교육지원센터는 법인격이 없고 교육지원청 안에 설치된 조직이라(특수교육법 제11조), 1개 시도교육청이 도입하면 산하 교육지원청 전부가 사용자가 됩니다. 강원은 17개입니다.

---

설계 원칙

1. 판정하지 않는다 — "확인하세요"까지만. 최종 판단은 담당자
2. 개인정보를 저장하지 않는다 — 이름·연락처를 받지 않고, 입력값을 기록하지 않음
3. 근거를 반드시 붙인다 — 모든 항목에 법령·지침 출처
4. 담당자 업무를 늘리지 않는다 — 상담 중 어차피 묻는 것만 입력, 결과는 즉시 출력
5. 옛 이름도 함께 보여준다 — 담당자가 지침과 대조할 수 있도록

---

문서

해커톤에 쓰는 문서 — docs/ 바로 아래

문서	내용
docs/해커톤-현황.md	지금 어디까지 왔나. 된 것 · 안 된 것 · 찾을 자료 · 10월 계획
docs/해커톤-발표-구성.md	해커톤 발표 파이프라인. 블록 12개 · 블록마다 목적·넘겨받는 것·나가는 한 문장·근거·주의 · 열린 결정
docs/해커톤-발표-근거.md	해커톤 근거. 정부기관 원문 수치만 · 쓰지 않는 수치와 이유 · 문서 끝에 목적별 출처 목록(링크 점검 2026-10-19)
docs/제도-출처-지도.md	출처 지도. 제도 4층 × 출처 · 서울 제외 16개 시도 카드·금액·서식 번호·문서 게시처·게시 시기 · 원문끼리 어긋나는 곳
docs/공식데이터-대조.md	공식 원문 대조. data.ts 제도 × 복지로·행안부 원문 · 경남 2026 지침 — 일치·고친 것·새로 넣은 것 · 다음 대조 후보
docs/데이터-갱신-파이프라인.md	갱신. 자동 감지 → 사람 확정 · 층별 갱신 방법 · 교육청 문서 확인 달력 · Vercel Cron · Supabase 테이블 설계안
docs/복지그루-구조.md	구조. 역할 분담(규칙/AI/담당자) · 데이터 흐름도 · 기술 구성 · 데이터 취급
docs/백엔드-API.md	라우트 명세 · 요청/응답 형식 · 층 구조

현장 기록 — docs/현장-기록/. 인터뷰 원본이라 고치지 않고 인용할 때만 연다

문서	내용
담당자-인터뷰.md	현장 근거 ①. 5문항 원본 기록 · 무엇이 반증됐는지
담당자-인터뷰-수원.md	현장 근거 ②. 수원교육지원청 지원센터 8문항 · ★ 주민센터 오안내 사례
기관-문의-기록.md	문의 20곳 전체 · 인용을 합치지 않는 규칙
원본/	인터뷰 ① 원본 hwpx

아이디어톤 보관 — docs/아이디어톤/. 2026.08 관점(「소관이 갈라져 있다」)이라 새 작업의 기준으로 쓰지 않는다. 예상 질문 답이나 문장을 살릴 때만 열어 해커톤 문서로 옮긴다

문서	내용
복지그루-기획서.md	기획 전문 — 문제 정의 · 신청 절차 구조도 · B2G 사업 모델 · 예상 질문 · 6장 지역 구현 순서
복지그루-기획서-요약.md	아이디어톤 발표용 발췌
발표-대본.md	아이디어톤 7분 대본 — 해커톤은 발표 구성으로
강원-경남-지침-분석.md	2025 지침 대조 작업 기록 — 경남 서식 번호는 옛 값, 지금 값은 대조 기록

---

데모

npm install

npm run dev

http://localhost:3000

데모의 두 장면

1. 조건을 입력하면 담당자용 확인 시트와 학부모용 안내문이 동시에 나온다
2. 지역만 바꾸면 카드 이름이 바뀌고, 경남을 고르면 ⚠ 「장애등급 결정서」 경고가 뜬다

데모 데이터 안내 — 절차·기한(30일/2주)·카드 명칭·장애영역별 검사도구는 강원·경남 교육청 지침 원문에서 확인한 내용입니다. 그 밖의 금액·세부 절차는 화면 구성을 보여주기 위한 예시이며, 화면에 예시 표시가 붙습니다. 입력하는 아동 정보는 전부 가상입니다.

기술 구성

Next.js 15 (App Router) · React 19 · TypeScript. 새 npm 의존성 없음 (SDK 대신 fetch, 검증도 손으로)

층	파일	하는 일
데이터	app/lib/data.ts	지역 · 장애영역 · 학교급 · 신청 상황 · 서식 · 제도
규칙	app/lib/build-sheet.ts	조건 → 제도·마감일·서류·경고·안내문. 순수 함수
검증	app/lib/validate.ts	요청 본문 검사. 모르는 id는 통과시키지 않는다
게시판	app/lib/board.ts	알림 마당 · 서식 자료실 · FAQ 데이터
화면	app/page.tsx · app/globals.css	규칙 모듈을 브라우저에서 직접 부른다

백엔드

라우트	하는 일	AI
POST /api/sheet	조건 → 확인 시트 한 벌. 교육청 시스템이 붙는 자리	❌
GET /api/options	넣을 수 있는 id 목록	❌
GET /api/reference	지역별 카드 명칭 · 서식 번호 대조표	❌
GET /api/notices	알림 마당 · 서식 자료실 · FAQ	❌
GET /api/health	배포 확인. 키 값은 응답에 넣지 않는다	❌
POST /api/letter	학부모용 안내문 문장화	⭕ 검색 끔
POST /api/lookup	우리 데이터에 없는 칸을 웹에서 찾기	⭕ Google Search

규칙이 고르고 AI가 쓴다. 제도를 고르는 것은 규칙이다. 같은 조건에 같은 결과가 나와야 담당자가 신뢰할 수 있기 때문이다. AI는 규칙이 못 하는 두 가지만 한다 — 우리 데이터에 없는 칸을 웹에서 찾는 것, 그리고 학부모가 읽을 문장으로 옮기는 것.

화면과 API가 같은 규칙 모듈을 쓴다. 그래서 화면에 뜬 시트와 /api/sheet 응답이 어긋날 수 없다. /api/letter는 조건만 받아 서버에서 규칙을 다시 돌리고 그 결과만 제미나이에 넘긴다 — 화면을 우회해 아무 내용이나 안내문에 밀어 넣을 수 없다. 생년월일과 담당자 연락처는 AI에 넘기지 않는다.

자세한 명세는 docs/백엔드-API.md.

환경변수

이름	용도
GEMINI_API_KEY	없으면 AI 버튼만 안내 메시지를 낸다
GEMINI_MODEL	선택. 기본값 gemini-3-flash-preview

.env.example을 .env.local로 복사해 채웁니다. 키가 없어도 화면과 규칙 계산은 그대로 동작합니다.

---

Vercel 배포

1. vercel.com/new → 이 저장소(yeonguk4100/Like-BamTi)를 가져온다
2. Framework Preset이 Next.js로 잡히는지 확인한다. 빌드 명령·출력 경로는 그대로 둔다
3. Environment Variables에 GEMINI_API_KEY를 넣는다 (GEMINI_MODEL은 생략 가능). Production · Preview · Development 세 곳에 모두 넣어야 미리보기 배포에서도 AI가 돈다
4. Deploy

설정 파일(vercel.json)은 두지 않습니다. Next.js 프로젝트는 Vercel이 그대로 알아봅니다.

배포된 뒤 /api/health를 열어 확인합니다.

{ "ok": true, "ai": { "configured": true } }

configured가 false면 환경변수가 안 들어간 것입니다. 넣은 뒤 다시 배포해야 반영됩니다.

올리기 전에 로컬에서 확인:

npm run typecheck

npm run build