비전

충청권 1876~1945 — 친일·매국과 항일·애국이 같은 거리, 같은 해에 어떻게 공존했는가.
1차 사료에 근거한 지역사 오픈 위키.

대통령 소속 친일반민족행위진상규명위원회의 1차 사료 + 향토사학자(김남균 선생 외)의 단행본·답사 자료 + 신문 1차 사료(네이버 뉴스라이브러리 자동 수집)를 통합한 충청권 지역사 위키. Andrej Karpathy의 LLM Wiki 패턴을 따라 벡터 DB·청킹 없이 LLM이 직접 위키 링크([[..]])를 따라가며 답합니다.

Phase 1~5 로드맵의 상세는 로드맵 섹션을, vault 내부 가이드는 _가이드/비전.md·AGENTS.md·CLAUDE.md를 참조하십시오.

우리가 만드는 / 만들지 않는 것

4축 — 시간·공간·인물·사료

시기 5단계 (+ 전사기)

주요 페이지

페르소나

같은 질문에 답이 갈리는 세 대화 상대 — 답변 방식과 데이터 소스가 다릅니다.

박순길 (가상 인물)

• 한자명: 朴順吉 (가상 인물 — 청주공립농업학교 학생들의 경험을 바탕으로 합성)
• 출생: 1912년경 충청북도 청주군 내수면 세교리 (가상)
• 활동기: 1928~1932 청주공립농업학교 재학
• 시대 경계: 1932 이후 사건 → "직접 겪지 못했습니다"
• 지역 경계: 충북 외 → "신문에서 읽었습니다"
• 면식고지: 첫 답변 끝에 가상 인물임을 한 줄로 명시
• 학교 표기 규약: 1930년 시점 정식명칭 "청주공립농업학교"로 통일. "청주농고"는 광복 후 약칭이라 페르소나가 직접 칭하는 건 비역사적이지만, 독자 단서를 위해 "청주농고 전신인 청주공립농업학교" 형식 허용

예정된 추가 페르소나 (Phase 4)

• 어윤희 (실존, 충북 충주 출생 1880~1961) — 동학으로 남편 잃음 → 개성 3·1 → 서대문 → 보육사업. 충청권 항일 여성 페르소나 후보 1순위
• 청주공립고등여학교 학생 (가상) — 박순길의 동시대 여성 페어
• 박인덕 (실존, 평양·서울 / 친일) — 친일 여성 페르소나. 윤리 가드 강화 필수
• 시기별 큐레이터 (1894 동학 / 1907 의병 / 1919 3·1 / 1937 황국신민화)

자료 제출·검토·승인 워크플로

공개 사용자 → submit.html → GitHub Issue (라벨: 자료제출)
              ↓
검토자 → review.html → 4종 플래그
   · 검토완료    : 그대로 등재
   · 수정필요    : 본문 수정 요청 코멘트
   · 분류재검토  : AI 재분류 요청 (관리자 권한)
   · 반려추천    : 등재 부적합
              ↓
운영자 → admin.html → 승인 시 GitHub Contents API로 .md 커밋 → GitHub Pages 배포
              ↓
LLM 컨텍스트(graph_data.json) 자동 갱신 (워커 5분 캐시 TTL)

역할 매트릭스

컴포넌트 아키텍처

┌─────────────────────────────────────────────────────────────┐
│  GitHub Pages (정적 호스팅)                                  │
│  index / chat / graph / submit / review / admin / docs.html │
└──────────────┬──────────────────────────────────────────────┘
               │ HTTPS
┌──────────────▼──────────────────────────────────────────────┐
│  Cloudflare Worker (815-chat)                               │
│   · 페르소나 챗봇 (Workers AI Llama 3.3 70B)                │
│   · GitHub API 프록시 (Issues / Contents / Comments)        │
│   · 인증 (X-Admin-Secret 헤더 검증)                         │
└──────────────┬──────────────────────────────────────────────┘
       │       │       │
       ▼       ▼       ▼
   ┌──────┐ ┌──────┐ ┌──────────┐
   │  KV  │ │  R2  │ │ GitHub   │
   │ AUTH │ │ATTCH │ │ (vault)  │
   │STATE │ │      │ │          │
   └──────┘ └──────┘ └──────────┘

주요 바인딩

frontmatter 스키마

공통 필드

---
type: 인물 | 사건 | 단체 | 학교 | 지역 | 문헌 | 가이드
side: 친일 | 항일 | 중립        # 인물 노트
source_verified: ●●● | ●●○ | ●○○
sources:                         # 권장 (Phase 1.5에서 도입)
  - title: ...
    type: 판결문 | 정부공식보고서 | 신문 | 학술논문 | 권위백과
    grade: ●●●
관련인물: [...]
관련사건: [...]
관련지역: [...]
관련학교: [...]
tags: [...]
생성일: YYYY-MM-DD
submitter: ...                   # 제출자 (실명·필명)
submitter_contact: ...           # 선택
delegated_by: ...                # 대리등록자
list_source: ...                 # 자료 출처 목록 (예: 카카오톡 2026-04-29 김남균 제출)
license: CC-BY-4.0               # 향후 도입
---

인물 노트 추가 필드

이름: 홍길동
한자: 洪吉同
생년월일: 1900.01.01
사망년월일: 1980.12.31
출신지: 충청북도 청주
학력:
  - 청주공립농업학교 (1925~1928) [●●●]
출처_볼륨: vol7
시작페이지: 5352
끝페이지: 5398
관련기관: [...]
언급횟수: 6

문헌 노트 추가 필드 (예: 단행본·신문)

책: 불망 - 충북 지역 친일 잔재 답사기
저자: 김남균
출판: 2019
출처_책: bulmang | pamyo | chungbuk_survey | chungbuk_hangil | ...
부: 제1부
지역: 충청북도

출처 등급제 정비 진행 중

현재 vault 등급 분포(2026-05-02 측정):

등급 부여 규칙 (Phase 1.5에서 자동화)

현재 데이터 통계 (2026-05-02)

1차 자료 묶음별 분포

자주 쓰는 명령어

# 위키 점검 (frontmatter 누락·링크 깨짐)
python _가이드/scripts/lint_vault.py

# 그래프 재빌드 (노드 + 엣지 + summary)
python scripts/build_graph.py

# 충청권 4단위 통계 재생성
python scripts/build_regional_stats.py

# 친일잔재 source 필드 분리 (Phase 1 정비 완료)
python scripts/separate_source_field.py

# 워커 비밀 관리
cd worker && npx wrangler secret put REVIEWER_SECRET
cd worker && npx wrangler secret put ADMIN_SECRET
cd worker && npx wrangler kv key list --binding REVIEW_STATE --remote

# 워커 배포
cd worker && npx wrangler deploy

# 신문 기사 자동 수집 (1건)
python news-archive/collect.py "https://newslibrary.naver.com/..."

# 신문 기사 자동 수집 (배치 TSV)
python news-archive/collect.py --batch news-archive/data/seeds_xxx.tsv

배포 방법

① wiki (정적 페이지)

git add -p
git commit -m "feat: ..."
git push origin main

→ GitHub Pages 자동 빌드 (1~2분 후 반영)

② Cloudflare Worker

cd worker
npx wrangler deploy

→ https://815-chat.sungandpartners.workers.dev 즉시 반영. graph_data.json 변경은 워커 5분 캐시 TTL 후 자동 페치, 워커 코드 변경은 deploy 즉시 반영.

절대 금지 (CLAUDE.md 발췌)

로드맵 Phase 1~5

Phase 1 (완료) — 비전 + 데이터 골격

• ✅ _가이드/비전.md 작성
• ✅ CLAUDE.md에 비전 박음
• ✅ 친일잔재 source 필드 분리 (불망/파묘/충북_조사_2020)
• ✅ graph_data.json 노드에 path+summary 보강 → 챗봇 "자료 없음" 사고 해결
• ✅ docs.html 운영 DOCS (관리자 비밀번호 보호)
• ✅ person.html + data/person_poc.json — 사료 attribution + 토글 UI PoC 2026-05-05 승인

Phase 1.5 (완료, 2026-05-05) — 출처 등급 정비 + frontmatter v2

• ✅ scripts/regrade_sources.py — 신문기사 ○○○→●●○ / 보고서 ●●○→●●● / "레거시"→●●○ (1,168건 변경, ●●● 비율 0.6%→56%)
• ✅ scripts/migrate_frontmatter_v2.py — sources[] 배열 + added_at/added_by/needs_review 도입 (1,922 노트 마이그레이션)
• ✅ scripts/build_person_data.py → data/persons.json (1,524명) + data/persons_index.json
• ✅ person.html이 PoC JSON 대신 v2 frontmatter 기반 data/persons.json 직접 읽기 (1,524명 검색)

Phase 1.6 (PoC 완료, 2026-05-05) — 1차 사료 자동 발굴 (●●● 승급)

• ✅ scripts/enrich_sources.py — i815·보훈처 자동 조회 PoC (--limit/--side/--region/--dry-run)
• ✅ 결과는 data/enrich_proposals.json에 pending_review 적재 — vault 직접 변경 없음, 검토자 승인 필요 (트래픽 책임 분산)
• 🔲 검토자 큐(review.html) UI 연동 — 사용자 트리거로 일괄 진행 예정
• 🔲 ●●● 노트 비율 56% → 70%+ 목표 (Phase 1.5에서 ●●● 56% 선달성, 잔여만 자동 발굴)

Phase 1.7 (룰 기반 완료, 2026-05-05) — 의미 관계 추출 (relations.json 부활)

• ✅ scripts/extract_relations.py — frontmatter + 본문 [[..]] 룰 기반 (LLM 미사용, 비용 0)
• ✅ graph_relations.json 자동 생성 — 36,672 관계 (인물-인물 9,477 / 인물-단체 6,149 / 인물-학교 524 / 인물-출신지 382 / 인물-사건 106 / 본문언급 20,034)
• ✅ 워커 buildContext가 RELATIONS_URL로 fetch (5분 캐시 TTL, 이미 구현됨)
• 🔲 LLM fact-triple 추출은 다음 Phase (룰 기반으로 우선 충분히 가동)
• 🔲 scripts/find_bridges.py — 같은 시기·지역 친일↔항일 매칭 52개 → 1,000개+ 목표

Phase 2 (1개월 후) — 서사 시각화 (MVP)

• 🔲 narrative.html — 시간 슬라이더 + 충청권 지도 + 사건 카드 + 친일/항일 인물 칩
• 🔲 data/narrative.json 빌드 스크립트
• 🔲 첫 PoC 사건 (사용자 결정): 1919 3·1 / 1929~30 광주학생운동·맹휴 / 1876~1910 동학·의병
• 🔲 충청권 항일 여성 노트 작성: 어윤희(충북 충주) + 유관순(충남 천안) + 옥중 동지 cross-link

Phase 2 (1개월) — 서사 시각화 (MVP)

• 🔲 narrative.html — 시간 슬라이더 + 충청권 지도 + 사건 카드 + 친일/항일 인물 칩
• 🔲 data/narrative.json 빌드 스크립트
• 🔲 첫 PoC 사건 (사용자 결정): 1919 3·1 / 1929~30 광주학생운동·맹휴 / 1876~1910 동학·의병

Phase 3 (2~3개월) — 연구자 도구

• 🔲 search.html — 다중 필터 (연도·지역·시기·사건유형·신뢰도·인물 분류)
• 🔲 자료별 "인용하기" 버튼 → BibTeX/RIS 클립보드
• 🔲 영구 URL (/v/2026.05/...) — 월별 git tag
• 🔲 /api/v1/... REST API

Phase 4 (4~5개월) — 서사 깊이 + 학술 인증

• 🔲 DOI 발급 (Zenodo 연계)
• 🔲 ORCID 로그인
• 🔲 시기별 큐레이터 페르소나 (1894 동학 / 1907 의병 / 1919 3·1 / 1937 황국신민화)
• 🔲 어윤희·박인덕·청주공립고등여학교 학생 페르소나 추가
• 🔲 챗봇 vault 직독 (Karpathy LLM Wiki 정신 회귀)

Phase 5 (5~6개월) — 전국 확장

• 🔲 충청권 → 전국 8개 권역
• 🔲 영어/일어 인터페이스
• 🔲 일제 관헌문서 OCR 강화

변경 이력 (주요)

이 문서는 운영 중에 계속 갱신됩니다. 가장 최신 정보는 vault의 _가이드/비전.md + CLAUDE.md + AGENTS.md를 함께 참조하십시오.