# 하나랑 대시보드

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`