71 lines
1.6 KiB
Markdown
71 lines
1.6 KiB
Markdown
# 하나랑 대시보드
|
|
|
|
4자매 멀티에이전트 파이프라인 관제 대시보드.
|
|
자기야가 한눈에 전체 현황, 프로젝트 흐름, QA 상태, 배포 상태를 파악하고 관리하는 화면.
|
|
|
|
## 기술 스택
|
|
- Frontend: Next.js 16 + styled-components
|
|
- Backend: Nest.js + Prisma
|
|
- DB: MariaDB
|
|
- Realtime: Socket.IO
|
|
- FE: `https://hanarang.nabomhalang.co.kr`
|
|
- BE: `https://hanarang-api.nabomhalang.co.kr`
|
|
|
|
## 표준 저장소 구조
|
|
```text
|
|
hanarang-dashboard/
|
|
├── ARCHITECTURE.md
|
|
├── README.md
|
|
├── .plans/
|
|
│ ├── OVERVIEW.md
|
|
│ ├── design/
|
|
│ ├── sprints/
|
|
│ ├── hotfix/
|
|
│ ├── qa/
|
|
│ └── deploy/
|
|
├── docs/
|
|
│ ├── product-specs/
|
|
│ ├── references/
|
|
│ ├── tech-debt-tracker.md
|
|
│ └── QUALITY_SCORE.md
|
|
├── frontend/
|
|
└── backend/
|
|
```
|
|
|
|
## 작업 파이프라인
|
|
1. 하랑이 문서 작성 및 선 push
|
|
2. 나랑이 구현 branch 작업
|
|
3. 다랑이 QA + `.plans/qa/` 결과 문서 push
|
|
4. 하랑이 QA 확인 후 `main` merge
|
|
5. 이랑이 최신 `main` pull + 재배포
|
|
|
|
> `main`은 항상 배포 가능 상태를 유지해.
|
|
|
|
## 실행 방법
|
|
### 사전 준비
|
|
1. 루트 `.env.example` 참고
|
|
2. `backend/.env` 작성
|
|
3. `SSH_KEY_PATH` 설정
|
|
|
|
### Backend
|
|
```bash
|
|
cd backend
|
|
npm install
|
|
npx prisma migrate dev
|
|
npx prisma db seed
|
|
npm run dev
|
|
```
|
|
|
|
### Frontend
|
|
```bash
|
|
cd frontend
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
## 참고 문서
|
|
- 아키텍처: `ARCHITECTURE.md`
|
|
- 실행 문서: `.plans/OVERVIEW.md`
|
|
- 구조 기준: `docs/references/repo-structure.md`
|
|
- 프로젝트 IA: `docs/product-specs/project-information-architecture.md`
|