MH-DashBoard-organization/README.md

MH Dashboard Organization

조직현황, 자리배치도, 프로젝트별 분석, 팀/개인별 분석을 하나의 대시보드로 제공하는 사내 웹 애플리케이션입니다.

구성

• frontend/
  • 허브 화면과 공통 스타일
• frontend/apps/
  • 화면별 source-of-truth 앱 소스
• legacy/static/
  • 조직현황 레거시 런타임 자산
• incoming-files/served/
  • integration 화면의 실제 런타임 서빙 자산
• incoming-files/reference/
  • 원본 참고 자산
• backend/app/
  • FastAPI 백엔드
• scripts/
  • 실행, publish, 검증, 동기화 스크립트

핵심 원칙

• frontend/apps/*가 탭별 수정 원본입니다.
• incoming-files/served/*와 legacy/static/*는 런타임 자산입니다.
• 조직현황/멤버/자리배치 관련 검증은 8081 개발 환경에서 먼저 수행합니다.
• 8080은 기준 데이터와 공개 환경, 8081은 검증 환경으로 다룹니다.
• main, dev는 Git 브랜치이고 8080, 8081은 실행 환경입니다.
• 권장 운영은 main -> 8080, dev 또는 작업 브랜치 -> 8081입니다.

시작 문서

• 첫 문서: docs/TEAM_GUIDE.md
• 협업 규칙: CONTRIBUTING.md
• 개발/운영 DB 원칙: docs/DEV_PROD_DB_PROTOCOL.md
• 실제 서빙 책임 맵: docs/architecture/8081_SERVING_MAP.md
• 디자인 기준: docs/architecture/DESIGN_SSOT.md

빠른 실행

기본 공개 환경:

cp .env.example .env
docker compose up -d --build

격리된 8081 개발 환경:

cp .env.example .env
./scripts/prepare_dev_worktree.sh
cd .dev-worktree-8081
docker compose -p mh-dashboard-organization-dev --env-file .env -f docker-compose.8081.yml up -d --build

publish 스크립트

• 조직현황: ./scripts/publish_organization_app.sh
• 프로젝트별 분석: ./scripts/publish_payment_app.sh
• 팀/개인별 분석: ./scripts/publish_team_app.sh
• 사업관리대장: ./scripts/publish_ledger_app.sh
• DB 상태: ./scripts/publish_db_status_app.sh