feat(knowledge): 공식 데이터와 신고 워크플로 반영

fowoco-knowledge/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.2.0 - 2026-07-16
+
+- 필요서류 187건과 EPS 세부업종 847건의 원본 해시·버전을 고정
+- 제조업 필요서류 122건과 제조업 세부업종 569건 정규화
+- 데이터 적재·검증·조회 CLI 추가
+- 고용변동 신고와 계약·고용허가·체류 연장 절차 분리
+- 고용변동 신고의 HR 사실확인·기한 후보 계산·증빙 완료 기준 추가
+- 다국어 사업내용의 표본 불일치로 번역 사용을 보류하고 품질 제한 문서화
+
 ## 0.1.0 - 2026-07-16
 
 - FOWOCO 6개 Intent와 9개 Domain 정의

fowoco-knowledge/README.md

@@ -55,6 +55,14 @@ python3.11 -m venv .venv
 # 분류·Slot Filling 결과가 Workflow를 실행할 수 있는지 확인
 .venv/bin/python -m fowoco_knowledge check-request \
   fowoco-knowledge/examples/ambiguous_document_request.json
+
+# 공식 원본 검증 후 제조업 Knowledge 스냅샷 재생성
+.venv/bin/python -m fowoco_knowledge sync-official-data
+
+# 신청서별 필요서류와 제조업 세부업종 조회
+.venv/bin/python -m fowoco_knowledge \
+  list-required-documents "외국인 고용변동 등 신고"
+.venv/bin/python -m fowoco_knowledge search-industries "금속가공제품"
 ```
 
 `check-request`는 자연어 모델을 대신하지 않습니다. 모델이 출력한 Workflow와 Slot이
@@ -80,3 +88,7 @@ python3.11 -m venv .venv
 - 실제 운영 로그: 개인정보를 제거하고 별도 승인된 경우에만 Active Learning 후보로 사용
 
 세부 기준은 [`docs/DATA_GUIDE.md`](docs/DATA_GUIDE.md)를 확인합니다.
+
+공식 데이터 변환은 [`docs/OFFICIAL_DATA_PIPELINE.md`](docs/OFFICIAL_DATA_PIPELINE.md),
+신고·연장 기능의 범위는 [`docs/E9_REPORTING_WORKFLOWS.md`](docs/E9_REPORTING_WORKFLOWS.md)를
+확인합니다.

fowoco-knowledge/data/external/README.md

@@ -1,11 +1,13 @@
 # External data
 
-공식 원본 데이터는 이 디렉토리에 커밋하지 않습니다.
+공식 원본 데이터는 이 디렉토리에 커밋하지 않습니다. 출처·버전·원본 해시는
+`source_manifest.yaml`, 제조업 정규화 결과는 `data/processed/`에서 관리합니다.
 
 1. `knowledge/official_links.yaml`의 출처에서 원본 다운로드
 2. 라이선스·게시일·행 수 확인
-3. `local-data/`에서 비식별·정규화 작업
-4. 필요한 코드·용어·출처 ID만 Context Pack에 반영
+3. `local-data/official/`에서 SHA·행 수·컬럼 검증
+4. `sync-official-data`로 제조업 정규화 스냅샷 생성
 5. Knowledge 변경 Issue와 Pull Request에 확인일·변환 규칙 기록
 
-이 방식은 원본 데이터 재배포와 오래된 스냅샷의 무분별한 사용을 방지합니다.
+이 방식은 원본 데이터 재배포와 오래된 스냅샷의 무분별한 사용을 방지합니다. 세부 기준은
+`docs/OFFICIAL_DATA_PIPELINE.md`를 확인합니다.

fowoco-knowledge/data/external/source_manifest.yaml

@@ -0,0 +1,57 @@
+version: 0.1.0
+verified_at: 2026-07-16
+policy:
+  raw_files_committed: false
+  normalized_snapshots_committed: true
+  checksum_mismatch_action: stop_and_review
+sources:
+  - id: SRC-KEIS-REQUIRED-DOCS
+    title: 한국고용정보원_고용허가제 민원서식별 업종별 필요 서류_20250826
+    landing_url: https://www.data.go.kr/data/15153513/fileData.do
+    download_url: https://www.data.go.kr/cmm/cmm/fileDownload.do?atchFileId=FILE_000000003536044&fileDetailSn=1&insertDataPrcus=N
+    source_version: "20250826"
+    filename: required_documents.csv
+    encoding: utf-8-sig
+    sha256: 3816528c5f41285c9d9b87582a5c650a52f7d48868fee46dcc2bd7dc1073ec00
+    expected_rows: 187
+    expected_columns: [신청서명, 필요서류명, 해당업종, 샘플서식제공여부]
+    transform: required_documents_manufacturing
+    output: required_documents_manufacturing.csv
+    license: 이용허락범위 제한 없음
+
+  - id: SRC-KEIS-ALLOWED-INDUSTRIES
+    title: 한국고용정보원_업종별 EPS 허용 세부업종 및 사업내용_20251121
+    landing_url: https://www.data.go.kr/data/15153406/fileData.do
+    download_url: https://www.data.go.kr/cmm/cmm/fileDownload.do?atchFileId=FILE_000000003535225&fileDetailSn=1&insertDataPrcus=N
+    source_version: "20251121"
+    filename: allowed_industries.csv
+    encoding: utf-8-sig
+    sha256: 274c2d0084878a8f5122a00f92086983391fd9176ab5821a06cccf0e2e1a2eeb
+    expected_rows: 847
+    expected_columns:
+      - 대분류 업종명
+      - 중분류 업종명
+      - 사업내용
+      - 사업내용 영어
+      - 사업내용 방글라데시
+      - 사업내용 카자흐스탄
+      - 사업내용 베트남
+      - 사업내용 네팔
+      - 사업내용 필리핀
+      - 사업내용 스리랑카
+      - 사업내용 태국
+      - 사업내용 파키스탄
+      - 사업내용 미얀마
+      - 사업내용 캄보디아
+      - 사업내용 라오스
+      - 사업내용 중국
+      - 사업내용 우즈베키스탄
+      - 사업내용 몽골
+      - 사업내용 인도네시아
+      - 사업내용 동티모르
+    transform: manufacturing_industries
+    output: manufacturing_industries.csv
+    license: 이용허락범위 제한 없음
+    quality_note: >-
+      다국어 열은 한국어 사업내용과 의미가 일치하지 않는 표본이 확인되어 사용을 보류한다.
+      MVP에서는 한국어 업종 분류와 영어 참고명만 정규화한다.

fowoco-knowledge/data/processed/manifest.yaml

@@ -0,0 +1,11 @@
+version: 0.1.0
+source_verified_at: 2026-07-16
+datasets:
+- source_id: SRC-KEIS-REQUIRED-DOCS
+  path: required_documents_manufacturing.csv
+  row_count: 122
+  sha256: 96a712f01cbcd13e43c53501f386803be973a79da4c379f143c53ddfb288a053
+- source_id: SRC-KEIS-ALLOWED-INDUSTRIES
+  path: manufacturing_industries.csv
+  row_count: 569
+  sha256: 4cfc3a1ce928f3f04011b166533e871b1a47b58da70d8650d7fbd7248fdee04e