MH-DashBoard-organization/docs/INFRA_VALIDATION_CHECKLIST.md

인프라 검증 체크리스트

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 데이터 유지
  • 업로드 파일 유지
  • 스냅샷 파일 유지