DMF_Crawler/state/README.md
Yun Chan 56a6e2da93 chore: 저장소 구조 정리 및 문서화, 첫 커밋
- src/dist 산출물 분리 원칙 정리(.gitignore, .gitattributes)
- 루트 및 주요 폴더(config/scripts/prompts/tests/src, 런타임 폴더 5종)에
  안내용 README.md 추가
- CHANGELOG.md, LICENSE, docs/ops/05-release-and-versioning.md 추가
- docs/README.md 문서 지도 갱신
2026-09-04 09:25:44 +09:00

923 B

state/ — 상태 파일 (런타임 생성, git 미추적)

DB 락 없이 가볍게 읽어야 하는 상태만 여기 둔다. 이 파일만 저장소에 남고 나머지는 .gitignore로 제외된다.

경로 내용
heartbeat.json 마지막 성공 실행 시각·run_id·리포트 경로. 워치독(watchdog.py)이 이걸로 "배치가 안 돌았다"를 판정한다
alerts.json 미해소 알림 미러. 알림 에이전트(notify/pump.py)가 SQLite 잠금 없이 여기만 읽는다
run.lock 배타 실행 락 파일(runlock.py). 중복 실행 방지
proposals/ AI가 제안한 내용의 보관소. 자동 적용 금지 — 사람 승인 대기 상태로만 쌓인다
tmp/ 임시 작업 디렉터리(수동 검증·릴리스 산출물 임시 보관 등)

알림 등급·에스컬레이션 규칙은 docs/ops/02-failure-alerting.md가 정본이다.