세팅할 때마다 "이 값이 어디 가는 거지" 를 코드에서 되짚고 있었다. AGENTS.md 에
설정 파일 지도를 넣고, 흩어져 있던 cp 명령을 거기 한 곳으로 모았다.
두는 곳 — 템플릿이 전부 짝을 갖는다(7개 확인).
루트 .env ← 백엔드가 읽는 유일한 .env
solution/backend/config/ config.local.toml DB·JWT·포트·CORS
solution/backend/config/ config.test.toml 없으면 pytest 가 import 단계에서 죽는다
solution/frontend/ .env VITE_* (API :9800)
admin/frontend/ .env VITE_* (API :9801)
nginx/ site.conf 없으면 Docker 가 디렉토리를 만든다
두지 않는 곳과 그 이유도 같이 적었다 — solution/backend(dotenv 가 루트를 본다),
admin/backend(PYTHONPATH 로 solution 것을 쓴다), solution/site, solution/shared.
solution/site/.env.example 을 지웠다.
"여기엔 아무것도 없다" 는 걸 알리려고 둔 파일인데, .env.example 은 이 레포에서
"복사해서 채워라" 라는 뜻이라 정반대 신호를 준다. 그 설명은 지도의 '두지 않는 곳' 으로 옮겼다.
그 밖에
- config.test.toml.example 의 server_name 이 O2oSiteServerTest 로 남아 있었다.
- config.local.toml.example 에 생략 가능한 [ExternalApiConfig] 필드 셋을 주석으로 적었다.
- .gitignore 의 *.toml 이 레포 전체를 덮는다는 것과, 그래서 pyproject.toml 같은 걸
추가하면 조용히 무시된다는 것을 규칙 옆에 적었다.
Mina Choi
fc47946d3f