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

14
config/README.md Normal file
View file

@ -0,0 +1,14 @@
# `config/` — 설정
| 파일 | git 추적 | 역할 |
|---|---|---|
| `config.toml` | 추적함 | 모든 PC 공통 기본값. **비밀 값을 절대 넣지 않는다** |
| `config.local.toml.example` | 추적함 | PC별 오버라이드 예시. 복사해서 실제 파일을 만든다 |
| `config.local.toml` | **추적 안 함**(`.gitignore`) | 이 PC만의 실제 값(백업 드라이브, 리포트 폴더, 실행 시각 등). `config.toml`의 같은 키를 덮어쓴다 |
인증키·웹훅 주소·비밀번호는 이 폴더의 어떤 파일에도 넣지 않는다. 온보딩 설정 창에서
입력하면 Windows DPAPI로 암호화되어 `%LOCALAPPDATA%\DMF_Crawler\service_key.bin`
저장된다(이유는 `docs/design/01-architecture.md` §3.2 `secrets_dpapi.py`).
전체 키 스펙과 각 키의 의미는 `docs/design/01-architecture.md` §6, 값을 바꾼 뒤 확인하는
법은 루트 `README.md` §6을 참고한다.