하나랑 대시보드

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

표준 저장소 구조

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

cd backend
npm install
npx prisma migrate dev
npx prisma db seed
npm run dev

Frontend

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