MH-DashBoard-organization/docs/INFRA_VALIDATION_CHECKLIST.md

인프라 검증 체크리스트

현재 확인 상태

• 2026-03-27 기준 docker compose ps 에서 proxy, frontend, backend, db 모두 healthy
• 2026-03-27 기준 curl http://localhost:8080/api/health 정상
• 2026-03-27 기준 curl http://localhost:8080/api/members 에서 items 비어 있지 않음
• 다른 PC 접속도 현재 확인됨
• 개발/운영 DB 분리 운영 원칙은 DEV_PROD_DB_PROTOCOL.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

3. 초기 데이터 업로드

• 조직도 화면에서 .xlsx 또는 .csv 업로드
• curl http://localhost:8080/api/members
• 확인 기준:
  • items 배열이 비어 있지 않음
  • 화면 렌더링이 정상 동작함

4. 영속성 확인

• docker compose restart backend proxy
• 다시 curl http://localhost:8080/api/members
• 확인 기준:
  • 업로드했던 데이터가 그대로 유지됨

5. 종료 후 재기동 확인

• docker compose down
• docker compose up -d
• 확인 기준:
  • DB 데이터 유지
  • 업로드 파일 유지

6. 제외 또는 후속 검증 항목

• 월간 스냅샷 파일 유지 검증은 현재 코드 기준 미구현 항목
• 스냅샷 기능을 다시 범위에 넣을 경우 별도 API/파일 경로/다운로드 검증 절차를 추가해야 함
• 8081에서 조직도, 멤버, 자리배치도 검증 전에는 8080 정본 DB 기준 동기화가 필요함