64 lines
2.1 KiB
Markdown
64 lines
2.1 KiB
Markdown
# 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](docs/TEAM_GUIDE.md)
|
|
- 협업 규칙: [CONTRIBUTING.md](CONTRIBUTING.md)
|
|
- 개발/운영 DB 원칙: [docs/DEV_PROD_DB_PROTOCOL.md](docs/DEV_PROD_DB_PROTOCOL.md)
|
|
- 실제 서빙 책임 맵: [docs/architecture/8081_SERVING_MAP.md](docs/architecture/8081_SERVING_MAP.md)
|
|
- 디자인 기준: [docs/architecture/DESIGN_SSOT.md](docs/architecture/DESIGN_SSOT.md)
|
|
|
|
## 빠른 실행
|
|
|
|
기본 공개 환경:
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
docker compose up -d --build
|
|
```
|
|
|
|
격리된 `8081` 개발 환경:
|
|
|
|
```bash
|
|
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`
|