docs: plan sprint-015 dashboard v3 redesign
This commit is contained in:
@@ -16,14 +16,14 @@
|
||||
- 장기 문서: `docs/`
|
||||
|
||||
## 활성 작업
|
||||
- **SPRINT-014**: Hermes 전환 + 프로젝트 IA/파일 구조 리뉴얼
|
||||
- **SPRINT-015**: Master Dashboard v3 정보 구조 리디자인
|
||||
|
||||
## 이번 Sprint 핵심 요구사항
|
||||
1. OpenClaw → Hermes 전환 후 자매 상태가 전부 offline으로 보이는 문제 해결
|
||||
2. 자매 프로필 사진 탐색 경로/fallback 재정비
|
||||
3. 변경된 파일 구조에 맞춘 프로젝트 진행률 / Sprint / Hotfix UI 개편
|
||||
4. 프로젝트를 네비게이션 두 번째 페이지로 고정
|
||||
5. 다랑 QA 완료 후 `main`이 배포 상태가 되고, 이랑은 최신 `main`을 pull해서 재배포만 수행하도록 흐름 고정
|
||||
1. 메인 대시보드를 4자매 운영 관제의 대표 화면으로 재정의
|
||||
2. 현행 미니멀 터미널 UI를 유지한 채 레퍼런스의 강한 정보 구조를 흡수
|
||||
3. 상단 global status bar / 4자매 상태 카드 / `ACTIVE PIPELINE` 중심 구조 도입
|
||||
4. `ACTIVITY FEED`, `SPRINT METRICS`, `INFRASTRUCTURE OVERVIEW`, `MISTAKE LOG & HARNESS`를 운영 문맥으로 재배치
|
||||
5. 데스크톱 우선 설계 후 모바일 세로 흐름까지 함께 정리
|
||||
|
||||
## 이행 전략
|
||||
- 코드에서는 구 구조와 신 구조를 일정 기간 동시 지원
|
||||
@@ -34,5 +34,6 @@
|
||||
## 문서 맵
|
||||
- 구조 기준: `../ARCHITECTURE.md`
|
||||
- 디자인 인덱스: `./design/index.md`
|
||||
- Sprint 계획: `./sprints/SPRINT-014.md`
|
||||
- Sprint 계획: `./sprints/SPRINT-015.md`
|
||||
- 나랑 handoff: `./sprints/SPRINT-015-NARANG-HANDOFF.md`
|
||||
- 배포 플로우: `./deploy/main-release-flow.md`
|
||||
|
||||
@@ -16,8 +16,11 @@
|
||||
- `ui/settings-design.md`
|
||||
- `ui/admin-design.md`
|
||||
|
||||
## Sprint 014에서 반드시 반영할 화면
|
||||
- 대시보드 메인: Hermes 상태/프로젝트 요약/두 번째 네비 반영
|
||||
- 프로젝트 목록: 프로젝트를 두 번째 페이지로 이동한 기준 재배치
|
||||
- 프로젝트 상세: Sprint / Hotfix / QA / Deploy 분리 구조 반영
|
||||
- 자매 페이지: Hermes 상태 판정과 아바타 fallback 반영
|
||||
## 레퍼런스
|
||||
- `references/07-master-dashboard-v3-reference.md`
|
||||
|
||||
## Sprint 015에서 반드시 반영할 화면
|
||||
- 대시보드 메인: Master Dashboard v3 구조 반영
|
||||
- 핵심 섹션: Global Status Bar / 4자매 상태 카드 / `ACTIVE PIPELINE`
|
||||
- 운영 패널: `ACTIVITY FEED`, `SPRINT METRICS`, `INFRASTRUCTURE OVERVIEW`, `MISTAKE LOG & HARNESS`
|
||||
- 모바일: 데스크톱 구조를 억지로 축소하지 말고 세로 읽기 흐름으로 재배열
|
||||
|
||||
33
.plans/design/references/07-master-dashboard-v3-reference.md
Normal file
33
.plans/design/references/07-master-dashboard-v3-reference.md
Normal file
@@ -0,0 +1,33 @@
|
||||
# Master Dashboard v3 Reference Notes
|
||||
|
||||
## 출처
|
||||
자기야가 2026-04-06에 공유한 레퍼런스 시안.
|
||||
|
||||
## 핵심 인상
|
||||
- 짙은 다크 배경 위에 운영 패널을 촘촘하게 배치
|
||||
- 상단 global status bar + 중앙 sprint progress + 우측 runtime connection 구조
|
||||
- 4자매 상태 카드를 1행에서 동시에 노출
|
||||
- `ACTIVE PIPELINE`을 중심으로 4자매 협업 흐름을 시각화
|
||||
- `ACTIVITY FEED` / `SPRINT METRICS` / `INFRASTRUCTURE OVERVIEW` / `MISTAKE LOG & HARNESS`를 한 화면에서 모두 판단 가능
|
||||
|
||||
## 채택 결정
|
||||
- **채택:** 정보 구조, 섹션 구성, 운영 화면다운 밀도, Active Pipeline 개념
|
||||
- **부분 채택:** 색 강조, pulse/flow 애니메이션, 상단 진행률 표현
|
||||
- **비채택:** 과한 glow, glassmorphism 회귀, 장식 위주의 다이어그램화
|
||||
|
||||
## 제품 적용 원칙
|
||||
- 하나랑 대시보드는 현행 미니멀 터미널 UI 톤을 유지
|
||||
- 레퍼런스는 `레이아웃/정보 위계/흐름 표현` 위주로 번역 적용
|
||||
- 비주얼 차용 비율은 대략 70% 이내로 제한
|
||||
- 실데이터 기반 운영 화면으로 느껴져야 하며 mock showcase처럼 보이면 안 됨
|
||||
|
||||
## 특히 강한 섹션
|
||||
1. Sister Status Cards
|
||||
2. Active Pipeline
|
||||
3. Activity Feed + Metrics 병렬 비교
|
||||
4. Infra + Mistake Log 하단 운영 패널
|
||||
|
||||
## 구현 시 주의
|
||||
- 실제 데이터 밀도에 비해 컴포넌트가 과장되면 안 됨
|
||||
- 첫 스크롤 안에 가장 중요한 판단 정보가 모여야 함
|
||||
- 모바일에서는 같은 구조를 억지로 축소하지 말고 세로 흐름으로 재배열
|
||||
@@ -1,31 +1,225 @@
|
||||
# 대시보드 메인 (`/`) — Sprint 014 리뉴얼 포인트
|
||||
# 대시보드 메인 (`/`) — Sprint 015 Master Dashboard v3
|
||||
|
||||
## 유지 요소
|
||||
- 미니멀 터미널 UI
|
||||
- 4자매 상태 카드
|
||||
- 프로젝트 요약 + 활동 피드
|
||||
- 모바일 하단 탭바
|
||||
## 목적
|
||||
대시보드 메인은 단순 요약 화면이 아니라, 자기야가 들어오자마자 `지금 4자매 파이프라인이 어디까지 와 있는지` 즉시 판단할 수 있는 대표 운영 화면이어야 해.
|
||||
|
||||
## 수정 포인트
|
||||
### 1. 자매 상태 판정
|
||||
- Hermes 런타임 기준 상태를 읽어야 함
|
||||
- OpenClaw만 보는 하드코딩 제거
|
||||
- 상태 카드가 전원 `OFFLINE`으로 고정되지 않게 실제 상태/uptime/cpu를 노출
|
||||
이번 v3의 핵심은 **현행 미니멀 터미널 UI를 유지하면서, 더 강한 정보 구조와 흐름 시각화로 메인 화면을 재구성하는 것**이야.
|
||||
|
||||
### 2. 자매 아바타
|
||||
- 실사/프로필 이미지가 있으면 사용
|
||||
- 없으면 fallback SVG
|
||||
- broken image 상태 금지
|
||||
## 유지할 것
|
||||
- 현재 제품의 미니멀 터미널 톤
|
||||
- 짙은 배경 + 얇은 border + mono 보조 텍스트
|
||||
- 4자매 중심 세계관/역할 구분
|
||||
- 모바일 하단 탭바와 기존 페이지 동선
|
||||
|
||||
### 3. 프로젝트 요약 영역
|
||||
- 프로젝트는 네비게이션 두 번째 페이지와 동일한 정보 구조를 축약해서 보여줌
|
||||
- 단순 퍼센트만이 아니라 현재 phase가 드러나야 함
|
||||
## 강하게 가져올 것
|
||||
- 상단 global status bar 구조
|
||||
- 4자매 카드 1행 배치
|
||||
- `ACTIVE PIPELINE` 중심 운영 다이어그램
|
||||
- `ACTIVITY FEED` + `SPRINT METRICS` 병렬 구조
|
||||
- `INFRASTRUCTURE OVERVIEW` + `MISTAKE LOG & HARNESS` 하단 운영 패널 구조
|
||||
|
||||
### 4. 네비게이션 순서
|
||||
- `대시 → 프로 → 활동 → 자매 → 조직 → 설정 → 관리`
|
||||
- 모바일 하단 탭바도 같은 순서 유지
|
||||
## 줄일 것
|
||||
- 과한 glow
|
||||
- 장식성 애니메이션 남발
|
||||
- 의미 없이 많은 뱃지/배경 장식
|
||||
- mock 대시보드처럼 보이는 가짜 숫자 강조
|
||||
|
||||
## 모바일 기준
|
||||
- 2열 상태 카드 유지
|
||||
- 프로젝트 요약은 phase 우선, 활동 피드는 그 아래
|
||||
- 하단 탭에서 프로젝트가 두 번째 탭으로 보여야 함
|
||||
---
|
||||
|
||||
## 전체 레이아웃
|
||||
### 1. Top Global Status Bar
|
||||
한 줄 또는 반응형 2단 구조.
|
||||
|
||||
#### 좌측
|
||||
- 브랜드/제품명
|
||||
- 현재 페이지 정체성 (`Master Dashboard`)
|
||||
|
||||
#### 중앙
|
||||
- 현재 Sprint / Day / focus summary
|
||||
- 진행률 bar 또는 current cycle 요약
|
||||
|
||||
#### 우측
|
||||
- Discord/Runtime 연결 상태
|
||||
- 알림 진입점
|
||||
- operator/avatar 요약
|
||||
|
||||
#### UX 기준
|
||||
- 상단에서 현재 운영 국면을 짧게 읽을 수 있어야 함
|
||||
- 모바일에서는 좌/중/우를 무리하게 한 줄에 우겨넣지 말고 2단으로 자연스럽게 접기
|
||||
|
||||
---
|
||||
|
||||
### 2. Sister Status Cards Row
|
||||
4자매 카드는 1행 핵심 상태 영역.
|
||||
|
||||
#### 공통 정보
|
||||
- 이름
|
||||
- 역할
|
||||
- 상태 (`IDLE`, `WORKING`, `REVIEWING`, `OFFLINE`, `DEPLOYING` 등)
|
||||
- CPU / RAM 또는 대응 리소스 지표
|
||||
- 현재 작업 한 줄 요약
|
||||
|
||||
#### 역할별 색 기준
|
||||
- Harang: amber
|
||||
- Narang: sky
|
||||
- Darang: pink
|
||||
- Irang: violet
|
||||
|
||||
#### 상태 표현 규칙
|
||||
- 색은 역할 + 현재 상태를 같이 전달해야 함
|
||||
- working/reviewing처럼 active 상태일 때만 강한 강조
|
||||
- idle은 조용하게
|
||||
- offline은 회색/경고 계열로 분명히 구분
|
||||
|
||||
#### 카드 UX 기준
|
||||
- 네 카드의 높이/구조는 최대한 동일
|
||||
- 긴 텍스트는 1줄 또는 2줄 clamp
|
||||
- CPU/RAM은 숫자와 bar를 함께 보여줘도 되지만 과장하지 말 것
|
||||
- 아바타/아이콘은 보조 요소고, 상태 텍스트가 주인공이어야 함
|
||||
|
||||
---
|
||||
|
||||
### 3. `ACTIVE PIPELINE`
|
||||
이번 v3의 대표 섹션.
|
||||
|
||||
#### 목적
|
||||
User → Harang → Narang → Darang → Irang 흐름과, maker-checker loop, escalation 조건을 한눈에 보여준다.
|
||||
|
||||
#### 기본 노드
|
||||
- User
|
||||
- Harang (`Plan & Assign`)
|
||||
- Narang (`Implement` or active task id)
|
||||
- Darang (`Review / QA`)
|
||||
- Irang (`Deploy / Idle`)
|
||||
|
||||
#### 보여줄 정보
|
||||
- 현재 active task 또는 ticket id
|
||||
- Narang ↔ Darang review loop
|
||||
- escalation 조건 또는 누적 실패 횟수
|
||||
- Irang이 아직 idle인지, redeploy 대기인지
|
||||
|
||||
#### 구현 기준
|
||||
- SVG 기반 라인/화살표 허용
|
||||
- active state가 있을 때만 제한적 pulse/flow
|
||||
- 정적인 설명보다 실제 운영 상태가 우선
|
||||
- loop / escalation은 읽히되 과하게 복잡하면 안 됨
|
||||
|
||||
#### 금지
|
||||
- 예쁘기만 한 다이어그램
|
||||
- 현재 상태를 읽을 수 없는 장식형 선/화살표
|
||||
|
||||
---
|
||||
|
||||
### 4. Middle Row — `ACTIVITY FEED` + `SPRINT METRICS`
|
||||
운영 근거와 정량 판단을 나란히 배치한다.
|
||||
|
||||
#### A. Activity Feed
|
||||
운영 이벤트 타임라인.
|
||||
|
||||
##### 우선 정보
|
||||
- 시각
|
||||
- 주체/대상 (예: Narang → Darang)
|
||||
- 이벤트 타입 (`handoff`, `review_request`, `review_fail`, `deploy`, `hotfix` 등)
|
||||
- 관련 task/sprint/hotfix id
|
||||
- 실패/경고 시 짧은 원인
|
||||
|
||||
##### UX 기준
|
||||
- 텍스트 로그가 아니라 읽히는 이벤트 카드여야 함
|
||||
- event type 색은 통일감 있게 관리
|
||||
- 필요하면 details/JSON 결과는 접어서 보여줌
|
||||
|
||||
#### B. Sprint Metrics
|
||||
한 Sprint의 진행 체감치를 운영 지표로 압축.
|
||||
|
||||
##### 포함 후보
|
||||
- total tasks
|
||||
- done / in progress / review / planning 비중
|
||||
- sister별 completed count
|
||||
- avg iterations
|
||||
- first-pass rate
|
||||
- escalation count
|
||||
|
||||
##### UX 기준
|
||||
- 차트는 보조, 숫자 읽기가 우선
|
||||
- donut + mini bar + stat box 조합 허용
|
||||
- `활동 피드와 같은 행에서 비교`했을 때 자연스러워야 함
|
||||
|
||||
---
|
||||
|
||||
### 5. Bottom Row — `INFRASTRUCTURE OVERVIEW` + `MISTAKE LOG & HARNESS`
|
||||
운영 기반과 학습 자산을 하단에 둔다.
|
||||
|
||||
#### A. Infrastructure Overview
|
||||
##### 목적
|
||||
현재 시스템이 어디서 어떻게 돌아가는지 빠르게 파악.
|
||||
|
||||
##### 포함 요소
|
||||
- gateway
|
||||
- sisters runtime host/lxc/vm
|
||||
- deploy access path
|
||||
- health / load / uptime 요약
|
||||
|
||||
##### 표현 방식
|
||||
- 단순 카드 나열보다 연결 관계가 보이는 가벼운 맵 구조 선호
|
||||
- 다만 실제 데이터가 빈약하면 과장된 네트워크 다이어그램으로 만들지 말 것
|
||||
|
||||
#### B. Mistake Log & Harness
|
||||
##### 목적
|
||||
운영 중 쌓인 실수/규칙/학습 자산을 한 눈에 보여줌.
|
||||
|
||||
##### 포함 요소
|
||||
- 최신 mistake/harness rule 몇 개
|
||||
- 작성 시점
|
||||
- 누가 추가했는지
|
||||
- category (`DB Schema`, `Frontend`, `Deployment` 등)
|
||||
- 필요하면 작은 trend visualization
|
||||
|
||||
##### UX 기준
|
||||
- 단순 문서 링크가 아니라 운영 학습 보드처럼 보여야 함
|
||||
- `View Full` 또는 상세 문서 링크는 보조로 유지
|
||||
|
||||
---
|
||||
|
||||
## 데스크톱 정보 순서
|
||||
1. Top Global Status Bar
|
||||
2. Sister Status Cards
|
||||
3. Active Pipeline
|
||||
4. Activity Feed / Sprint Metrics
|
||||
5. Infrastructure Overview / Mistake Log & Harness
|
||||
|
||||
## 모바일 정보 순서
|
||||
1. Top Status Summary
|
||||
2. Sister Status Cards (2열 또는 1열)
|
||||
3. Active Pipeline
|
||||
4. Activity Feed
|
||||
5. Sprint Metrics
|
||||
6. Infrastructure Overview
|
||||
7. Mistake Log & Harness
|
||||
|
||||
모바일에서는 복잡한 수평 관계보다 세로 읽기 흐름이 우선이야.
|
||||
|
||||
---
|
||||
|
||||
## 데이터 연결 원칙
|
||||
- mock 텍스트/숫자로 고정하지 말고 실제 데이터가 들어올 자리를 먼저 설계할 것
|
||||
- 값이 없을 때는 `No recent activity`, `No active deployment`, `No harness rules yet`처럼 조용한 empty state 제공
|
||||
- offline / missing / unavailable 상태는 숨기지 말고 명확히 드러낼 것
|
||||
|
||||
## 인터랙션 원칙
|
||||
- hover 없어도 핵심 정보가 읽혀야 함
|
||||
- 클릭 가능한 영역은 페이지 이동 또는 상세 패널 열기처럼 의미가 분명해야 함
|
||||
- notification / details / expand는 보조 수단
|
||||
|
||||
## 스타일 원칙
|
||||
- background는 현행 다크 톤 유지
|
||||
- border 1px 중심
|
||||
- 그림자/glow는 active state 강조용 최소치만 사용
|
||||
- 하드한 터미널 감성과 현대적 운영 패널 느낌 사이 균형 유지
|
||||
|
||||
## 연결 페이지
|
||||
- 프로젝트 페이지는 phase/QA/deploy 세부 판단용
|
||||
- 활동 페이지는 장기 로그 열람용
|
||||
- 자매 상세는 개별 runtime/세션 분석용
|
||||
- 관리 페이지는 조작/재시작/관리용
|
||||
|
||||
즉, 홈은 모든 걸 다 보여주는 곳이 아니라 **지금 어디를 눌러야 하는지 판단시키는 운영 출발점**이어야 해.
|
||||
|
||||
49
.plans/sprints/SPRINT-015-NARANG-HANDOFF.md
Normal file
49
.plans/sprints/SPRINT-015-NARANG-HANDOFF.md
Normal file
@@ -0,0 +1,49 @@
|
||||
# SPRINT-015 Narang Handoff
|
||||
|
||||
## repo / branch
|
||||
- repo: `https://git.nabomhalang.co.kr/hanarang/hanarang-dashboard`
|
||||
- branch: `feature/sprint-015-v3-redesign-plan`
|
||||
|
||||
## 읽을 문서
|
||||
1. `.plans/sprints/SPRINT-015.md`
|
||||
2. `.plans/design/ui/dashboard-design.md`
|
||||
3. `.plans/design/index.md`
|
||||
4. 기존 구현 참조가 필요하면 `.plans/sprints/SPRINT-014.md`
|
||||
|
||||
## 이번에 해야 하는 일
|
||||
대시보드 메인(`/`)을 v3 정보 구조로 재설계해.
|
||||
|
||||
핵심은 이거야.
|
||||
- 현행 미니멀 터미널 톤 유지
|
||||
- 레퍼런스의 정보 구조 적극 채택
|
||||
- `ACTIVE PIPELINE`을 대표 섹션으로 도입
|
||||
- 4자매 상태 카드 / Activity Feed / Sprint Metrics / Infra / Mistake Log를 운영 화면답게 재배치
|
||||
- 장식은 줄이고 실데이터 연결 가능한 구조로 구현
|
||||
|
||||
## 절대 기준
|
||||
- glassmorphism으로 회귀하지 마
|
||||
- styled-components 체계 유지
|
||||
- fake mock 느낌 강한 장식 UI로 끝내지 마
|
||||
- hover 없이도 핵심 정보 읽혀야 해
|
||||
- 데스크톱 먼저 맞추고 모바일 세로 흐름까지 꼭 정리해
|
||||
- 기존 페이지 동선 숨기지 마
|
||||
|
||||
## 구현 우선순위
|
||||
1. 상단 Global Status Bar / Hero Summary
|
||||
2. 4자매 상태 카드 v3
|
||||
3. `ACTIVE PIPELINE`
|
||||
4. `ACTIVITY FEED` / `SPRINT METRICS`
|
||||
5. `INFRASTRUCTURE OVERVIEW` / `MISTAKE LOG & HARNESS`
|
||||
6. 반응형/빈 상태/오프라인 상태 정리
|
||||
|
||||
## 확인 포인트
|
||||
- 첫 화면 첫 스크롤 안에서 자매 상태 + 현재 파이프라인이 읽혀야 함
|
||||
- 색은 상태 의미가 있을 때만 강하게 사용
|
||||
- Activity / Metrics / Infra / Mistake가 각각 따로 노는 패널이 아니라 운영 맥락으로 이어져야 함
|
||||
- `ACTIVE PIPELINE`은 예쁘기만 한 다이어그램이 아니라 현재 handoff / review loop / escalation을 보여줘야 함
|
||||
|
||||
## QA 전 필수
|
||||
- `npm run build` 통과
|
||||
- 반응형 확인
|
||||
- 데이터 없을 때/길 때/오프라인일 때 레이아웃 확인
|
||||
- 외부 URL 기준으로 실제 읽기 흐름 확인
|
||||
180
.plans/sprints/SPRINT-015.md
Normal file
180
.plans/sprints/SPRINT-015.md
Normal file
@@ -0,0 +1,180 @@
|
||||
# SPRINT-015: Master Dashboard v3 정보 구조 리디자인
|
||||
|
||||
## 목표
|
||||
기존 미니멀 터미널 UI를 유지하면서, 자기야가 제안한 레퍼런스의 강한 정보 구조를 흡수해 메인 대시보드를 `4자매 운영 관제의 대표 화면`으로 재정의한다.
|
||||
|
||||
## 핵심 방향
|
||||
- glassmorphism으로 회귀하지 않음
|
||||
- 현재 프로덕션의 미니멀 터미널 톤 유지
|
||||
- 대신 레이아웃/정보 위계/운영 흐름 표현은 새 레퍼런스를 적극 반영
|
||||
- 장식보다 운영 가독성을 우선
|
||||
- 데스크톱 우선 설계 후 모바일 세로 흐름까지 함께 정리
|
||||
|
||||
## 디자인 원칙
|
||||
1. **정보 구조 우선**
|
||||
- 예쁜 카드보다 `지금 무엇이 진행 중인지`가 먼저 읽혀야 함
|
||||
2. **운영 화면다운 밀도**
|
||||
- 한 화면에서 자매 상태 / 현재 파이프라인 / 활동 / 지표 / 인프라를 함께 판단 가능해야 함
|
||||
3. **현행 톤 유지**
|
||||
- 배경, border, mono 보조 텍스트, 브라켓/터미널 감성은 유지
|
||||
4. **애니메이션 절제**
|
||||
- 상태 강조용 pulse/flow만 제한적으로 사용
|
||||
- 불필요한 glow, 과한 색 번짐, 반복 뱃지는 줄임
|
||||
5. **실데이터 우선**
|
||||
- 예시 숫자가 아니라 실제 runtime/task/project/deploy 데이터를 붙일 수 있는 구조로 설계
|
||||
|
||||
## 범위
|
||||
- 메인 대시보드(`/`) 레이아웃 v3 개편
|
||||
- 상단 global status bar 재설계
|
||||
- 4자매 상태 카드 재배치/요약 정보 재정의
|
||||
- `ACTIVE PIPELINE` 섹션 신설
|
||||
- `ACTIVITY FEED` / `SPRINT METRICS` 병렬 구조 재정렬
|
||||
- `INFRASTRUCTURE OVERVIEW` / `MISTAKE LOG & HARNESS` 하단 운영 영역 재구성
|
||||
- 기존 프로젝트/활동/자매/관리 페이지와 연결되는 진입 동선 재정리
|
||||
|
||||
## 제외 범위
|
||||
- 이번 Sprint에서 새 도메인 기능 추가는 하지 않음
|
||||
- 백엔드 데이터 모델을 대규모로 갈아엎지 않음
|
||||
- 기존 페이지 전체를 동시 리디자인하지 않음
|
||||
- chart 라이브러리 교체는 필요할 때만 제한적으로 수행
|
||||
|
||||
## 태스크
|
||||
|
||||
### TASK-070: 대시보드 v3 IA 확정 및 섹션 맵 정리
|
||||
- **담당:** 하랑이 → 나랑이
|
||||
- **상태:** pending
|
||||
- **설명:** 레퍼런스를 현행 제품에 맞게 번역한 섹션 구조/우선순위를 확정한다.
|
||||
- **산출물:**
|
||||
- `.plans/design/ui/dashboard-design.md` 갱신
|
||||
- 섹션별 데이터 소스 매핑 표
|
||||
- **완료 기준:**
|
||||
- 상단바 / 자매 카드 / Active Pipeline / Activity Feed / Metrics / Infra / Mistake Log의 역할이 문서로 명확함
|
||||
|
||||
### TASK-071: 상단 Global Status Bar + Hero Summary 개편
|
||||
- **담당:** 나랑이
|
||||
- **상태:** pending
|
||||
- **주요 파일:**
|
||||
- `frontend/app/page.tsx`
|
||||
- `frontend/components/**` 내 dashboard 공통 헤더/요약 관련 컴포넌트
|
||||
- **설명:**
|
||||
- 좌측 브랜드/페이지 아이덴티티
|
||||
- 중앙 sprint/day 또는 현재 운영 focus
|
||||
- 우측 연결 상태/알림/관리자 프로필 요약
|
||||
구조를 재정의한다.
|
||||
- **완료 기준:**
|
||||
- 첫 화면 상단에서 현재 스프린트/연결 상태를 즉시 읽을 수 있음
|
||||
- 모바일에서 세로 스택 또는 2단 구조로 무너지지 않음
|
||||
|
||||
### TASK-072: 4자매 상태 카드 v3 재설계
|
||||
- **담당:** 나랑이
|
||||
- **상태:** pending
|
||||
- **주요 파일:**
|
||||
- `frontend/app/page.tsx`
|
||||
- `frontend/components/sisters/**` 또는 대시보드 상태 카드 컴포넌트
|
||||
- **설명:** 각 자매 카드에 아래 정보를 안정적으로 담는다.
|
||||
- 이름 / 역할
|
||||
- 현재 상태 (`IDLE`, `WORKING`, `REVIEWING`, `OFFLINE` 등)
|
||||
- CPU / RAM 또는 대응 운영 지표
|
||||
- 현재 작업 한 줄 요약
|
||||
- **완료 기준:**
|
||||
- 카드 4개가 한 세트로 읽힘
|
||||
- 색상/강조는 자매별 역할과 상태를 동시에 표현함
|
||||
- 아바타/아이콘/텍스트 길이 차이로 카드 높이가 깨지지 않음
|
||||
|
||||
### TASK-073: `ACTIVE PIPELINE` 시각화 도입
|
||||
- **담당:** 나랑이
|
||||
- **상태:** pending
|
||||
- **의존성:** TASK-070
|
||||
- **주요 파일:**
|
||||
- `frontend/app/page.tsx`
|
||||
- 새 공통 컴포넌트 생성 가능 (`frontend/components/dashboard/ActivePipeline.tsx` 등)
|
||||
- **설명:**
|
||||
- User → Harang → Narang → Darang → Irang 흐름을 운영 그래프로 표현
|
||||
- maker-checker loop, escalation 조건, 현재 active task를 읽을 수 있게 구성
|
||||
- **구현 메모:**
|
||||
- SVG/HTML 혼합 구현 허용
|
||||
- 애니메이션은 실제 active state가 있을 때만 제한적으로 사용
|
||||
- 정적인 장식보다 상태 전달이 우선
|
||||
- **완료 기준:**
|
||||
- 현재 누가 받고/처리하고/검토 중인지 한눈에 보임
|
||||
- 3회 실패 escalation 같은 운영 규칙이 과하지 않게 드러남
|
||||
|
||||
### TASK-074: `ACTIVITY FEED` / `SPRINT METRICS` 병렬 재배치
|
||||
- **담당:** 나랑이
|
||||
- **상태:** pending
|
||||
- **주요 파일:**
|
||||
- `frontend/app/page.tsx`
|
||||
- 기존 activity/task/metrics 컴포넌트
|
||||
- **설명:** 활동 피드와 지표를 같은 행에서 비교하는 운영 레이아웃으로 정렬한다.
|
||||
- **완료 기준:**
|
||||
- 활동 피드는 이벤트 타입/주체/대상 task를 읽기 쉬움
|
||||
- metrics는 total tasks, 완료율, 반복 횟수, first-pass rate, escalation 수를 빠르게 읽을 수 있음
|
||||
- mock처럼 보이지 않도록 실제 데이터 연결 포인트가 드러남
|
||||
|
||||
### TASK-075: `INFRASTRUCTURE OVERVIEW` / `MISTAKE LOG & HARNESS` 하단 운영 영역 구성
|
||||
- **담당:** 나랑이
|
||||
- **상태:** pending
|
||||
- **설명:** 인프라 상태 맵과 mistake/harness 규칙 영역을 하단 2열 운영 패널로 정리한다.
|
||||
- **주요 파일:**
|
||||
- `frontend/app/page.tsx`
|
||||
- 관련 API 데이터를 읽는 서비스/타입
|
||||
- **완료 기준:**
|
||||
- Gateway / sisters infra / deploy access 흐름이 읽힘
|
||||
- MISTAKE.md/하네스 규칙 로그는 운영 학습 자산처럼 보여야 함
|
||||
- 모바일에서는 Infra → Mistake Log 순 세로 배치
|
||||
|
||||
### TASK-076: 현행 디자인 시스템과 v3 레이아웃 정합화
|
||||
- **담당:** 나랑이
|
||||
- **상태:** pending
|
||||
- **의존성:** TASK-071 ~ TASK-075
|
||||
- **설명:** 새 레이아웃이 기존 미니멀 터미널 UI와 충돌하지 않게 색/간격/타이포/테두리 규칙을 정리한다.
|
||||
- **완료 기준:**
|
||||
- 기존 프로젝트/활동/설정 페이지와 같은 제품군처럼 보임
|
||||
- Tailwind 레퍼런스의 분위기를 가져오되 styled-components 기반 현행 톤과 충돌하지 않음
|
||||
|
||||
### TASK-077: 반응형/실데이터 QA 준비
|
||||
- **담당:** 나랑이 → 다랑이
|
||||
- **상태:** pending
|
||||
- **의존성:** TASK-071 ~ TASK-076
|
||||
- **설명:** 데스크톱/태블릿/모바일 반응형과 실데이터 연결 상태를 확인하고 QA 요청 준비를 마친다.
|
||||
- **완료 기준:**
|
||||
- Desktop / Tablet / Mobile 주요 breakpoints 확인
|
||||
- 빈 상태 / 긴 텍스트 / offline 상태 / 데이터 없음 상태가 깨지지 않음
|
||||
- QA 전달 시 스크린샷 또는 확인 포인트 포함
|
||||
|
||||
## 데이터 매핑 기준
|
||||
| 섹션 | 우선 데이터 |
|
||||
|---|---|
|
||||
| Global Status Bar | current sprint, connection status, notifications, current operator |
|
||||
| Sister Cards | runtime status, role, usage metrics, current work summary |
|
||||
| Active Pipeline | latest handoff, active implementation, active review, escalation count |
|
||||
| Activity Feed | latest activities/log events/task transitions |
|
||||
| Sprint Metrics | total tasks, completion, review loops, first-pass rate, escalations |
|
||||
| Infrastructure Overview | gateway/node/server/process summary |
|
||||
| Mistake Log & Harness | latest MISTAKE/Harness rules or derived operational lessons |
|
||||
|
||||
## UX 규칙
|
||||
- 정보 순서는 `지금 상태 → 흐름 → 근거 이벤트 → 정량 지표 → 인프라/학습 자산`
|
||||
- 카드 하나하나보다 섹션 간 관계가 더 중요함
|
||||
- hover가 없어도 중요한 정보는 보여야 함
|
||||
- 색은 상태 의미가 있을 때만 강하게 쓴다
|
||||
- `Working`, `Reviewing`, `Ready for Deploy` 같은 운영 단어는 전체 제품에서 같은 표현을 유지한다
|
||||
|
||||
## 구현 제약
|
||||
- styled-components 구조 유지
|
||||
- 기존 공통 토큰/색 변수 최대한 재사용
|
||||
- 새 레이아웃 때문에 기존 페이지 진입 동선이 숨지면 안 됨
|
||||
- 과한 애니메이션/지속적인 repaint 유발 구현 지양
|
||||
- fake 숫자 하드코딩으로 끝내지 말고 실데이터 연결 지점을 남길 것
|
||||
|
||||
## 검증 기준
|
||||
- 홈 화면 진입 시 `하나랑 대시보드가 무엇을 운영하는지` 즉시 이해됨
|
||||
- 4자매 상태와 현재 파이프라인이 첫 스크롤 안에서 읽힘
|
||||
- 활동/지표/인프라/학습 로그가 운영자 관점에서 자연스럽게 이어짐
|
||||
- 데스크톱/모바일 모두 정보 손실 없이 읽힘
|
||||
- 현행 미니멀 터미널 UI와 충돌하지 않음
|
||||
|
||||
## 참고
|
||||
- 레퍼런스는 `정보 구조`를 강하게 채택
|
||||
- 비주얼은 현재 제품 톤을 유지한 상태로 70%만 차용
|
||||
- `ACTIVE PIPELINE`은 이번 v3 리디자인의 대표 섹션으로 취급
|
||||
Reference in New Issue
Block a user