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 문서 지도 갱신
This commit is contained in:
Yun Chan 2026-09-04 09:25:44 +09:00
commit 56a6e2da93
159 changed files with 145825 additions and 0 deletions

13
data/README.md Normal file
View file

@ -0,0 +1,13 @@
# `data/` — 자료 보관소 (런타임 생성, git 미추적)
이 폴더의 내용물은 **전부 실행하면 다시 만들어진다.** 이 파일(`README.md`)만 저장소에
남고, 나머지는 `.gitignore`로 제외된다.
| 경로 | 내용 |
|---|---|
| `dmf.sqlite3` (+ `-wal` / `-shm`) | 정본 데이터베이스. 이벤트 소싱 스토리지(append-only) |
| `raw/YYYY-MM-DD/` | 그날 공식 API가 준 원문 응답을 페이지별로 그대로 보존. 나중에 다시 해석할 수 있도록 가공하지 않는다 |
| `headful_downloads/run_*/` | AGY headful Chrome 수집 경로로 받은 원본 xlsx 다운로드 보관 |
스키마와 이벤트 소싱 모델은 `docs/design/02-data-model.md`가 정본이다.
DB가 손상됐을 때 복구하는 법은 루트 `README.md` §5 장애 대응표를 참고한다.