# Changelog

이 프로젝트의 사용자 대상 변경 사항을 버전별로 기록한다.
형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를,
버전 번호는 [Semantic Versioning](https://semver.org/lang/ko/)을 따른다.

버전 번호와 태그 규칙, 릴리스 절차는 `docs/ops/05-release-and-versioning.md`가 정본이다.
개발 과정의 상세한 시행착오·실측 기록은 `docs/HANDOFF.md`에 있다. 이 문서는 그중
**사용자가 실제로 체감하는 변화만** 요약한다.

## [Unreleased]

### 추가
- 저장소 최상위와 주요 폴더(`src/`, `config/`, `scripts/`, `prompts/`, `tests/`,
  `data/`, `state/`, `logs/`, `reports/`, `backup/`)마다 안내용 `README.md`를 추가했다.
- `docs/ops/05-release-and-versioning.md` — 버전·태그·릴리스 절차 정본.
- `LICENSE` — 저장소 최상위에 라이선스 고지 파일을 추가했다.
- Git 저장소를 초기화하고 `git.chanpaca.net`(공개)에 배포했다.

## [0.1.0] - 2026-09-03

첫 배포 가능 버전. 무인 파이프라인(수집→비교→저장→리포트)이 실제 데이터로 end-to-end 동작을 확인했다.

### 추가
- 공식 공공데이터포털 Open API 수집(`source_mfds.py`), 인증키는 선택 사항으로 동작.
- 인증키가 없거나 `source.mode=browser`일 때 AGY headful Chrome으로 의약품안전나라
  CCBAC03 xlsx를 내려받는 대체 수집 경로.
- SQLite 이벤트 소싱 저장소(append-only 스냅샷 + 이벤트), 신규/변경/취하 diff 판정.
- 안전장치 5종(`integrity.py`): 급격한 건수 감소·결측·중복·churn·취하 비율 이상 시
  비교 결과를 폐기하고 리포트를 막는다.
- XlsxWriter 기반 8시트 엑셀 리포트(`report/`): 대시보드·오늘변경분·전체현황·성분별·
  업체별·워치리스트·추이·메타. 시트 간 상호 링크, 조건부서식, 틀고정, 자동필터 포함.
- tkinter 기반 온보딩=복구 통합 GUI(`gui/`)와 진단 엔진(`checks.py`), CLI `doctor` 서브커맨드.
- Windows 작업 스케줄러 자동 등록/해제, 로그온 시 알림, 놓친 작업 따라잡기 트리거 3종.
- 화면 토스트 + 웹훅(디스코드 등) 알림, 등급별 쿨다운·에스컬레이션.
- 선택 기능으로 켤 수 있는 AGY 기반 AI 한 줄 요약(diff 코멘트).
- 기존 프로토타입 xlsx(9,084건) 임포터(`importers/prototype_xlsx.py`) — 최초 기준선 수립용.
- `bootstrap.cmd` 원클릭 설치(venv 생성 → 의존성 설치 → 바탕화면 바로가기 → 온보딩 실행).

### 검증
- 실제 CCBAC03 headful 수집으로 9,816건 수집·정규화·저장·리포트 생성 성공.
- `pytest tests -q` 79 passed.

[Unreleased]: https://git.chanpaca.net/yunchan/DMF_Crawler/compare/v0.1.0...HEAD
[0.1.0]: https://git.chanpaca.net/yunchan/DMF_Crawler/releases/tag/v0.1.0