Harden infra validation flow

docs/INFRA_VALIDATION_CHECKLIST.md

@@ -0,0 +1,50 @@
+# 인프라 검증 체크리스트
+
+## 1. 컨테이너 기동
+- `docker compose build`
+- `docker compose up -d`
+- `docker compose ps`
+- 확인 기준: `proxy`, `frontend`, `backend`, `db` 모두 `healthy`
+
+## 2. API 상태 확인
+- `curl http://localhost:8080/api/health`
+- 확인 기준:
+  - `status` 가 `ok`
+  - `checks.database` 가 `true`
+  - `checks.upload_dir` 가 `true`
+  - `checks.snapshot_dir` 가 `true`
+
+## 3. 초기 데이터 업로드
+- 조직도 화면에서 `.xlsx` 또는 `.csv` 업로드
+- `curl http://localhost:8080/api/members`
+- 확인 기준:
+  - `items` 배열이 비어 있지 않음
+  - 화면 렌더링이 정상 동작함
+
+## 4. 영속성 확인
+- `docker compose restart backend proxy`
+- 다시 `curl http://localhost:8080/api/members`
+- 확인 기준:
+  - 업로드했던 데이터가 그대로 유지됨
+
+## 5. 스냅샷 검증
+- `curl -X POST -F snapshot_month=2026-03 http://localhost:8080/api/snapshots/monthly`
+- 확인 기준:
+  - CSV 파일 경로가 반환됨
+  - `/snapshots/...` 다운로드 가능
+
+## 6. 중복/형식 오류 검증
+- 같은 월로 다시 스냅샷 생성
+- 확인 기준:
+  - 409 에러 반환
+- 잘못된 형식으로 스냅샷 생성 예: `202603`
+- 확인 기준:
+  - 400 에러 반환
+
+## 7. 종료 후 재기동 확인
+- `docker compose down`
+- `docker compose up -d`
+- 확인 기준:
+  - DB 데이터 유지
+  - 업로드 파일 유지
+  - 스냅샷 파일 유지