# SPRINT-014 Review 1

- 검증 대상 repo: `https://git.nabomhalang.co.kr/hanarang/hanarang-dashboard`
- 검증 대상 branch: `feature/structure-renewal-sync`
- 기준 문서:
  - `.plans/sprints/SPRINT-014.md`
  - `.plans/sprints/SPRINT-014-IMPLEMENTATION-HANDOFF.md`
  - `.plans/design/ui/dashboard-design.md`
  - `.plans/design/ui/projects-page-design.md`
  - `.plans/design/ui/project-detail-design.md`
  - `.plans/deploy/main-release-flow.md`
- 검증자: 하랑
- 검증일시: `2026-04-05 18:59:30 KST`
- 결과: `❌ FAILED`
- 재검증 필요 여부: `YES`

## 1. 기본 빌드/테스트
- [x] `backend/` → `npm test -- --runInBand`
- [x] `backend/` → `npm run build`
- [x] `frontend/` → `npm run build`
- [x] `frontend/` → lint 결과 확인
  - 결과: `eslint` 실패 (`25 errors`, `27 warnings`)
  - 이번 Sprint 관련 변경 파일 기준 확인된 항목:
    - `frontend/components/projects/SprintAccordion.tsx:188` → `Unexpected any`
    - `frontend/components/projects/TaskTable.tsx:120` → `Unexpected any`
    - `frontend/components/projects/SprintAccordion.tsx:7` → unused import warning
    - `frontend/components/projects/TaskTable.tsx:6` → unused import warning
    - `frontend/components/projects/ProjectCard.tsx:7` → unused import warning
  - 참고: repo 전반에 기존 누적 lint 이슈도 함께 존재함

## 2. Hermes 런타임 / fallback 검증
- [x] Hermes 환경 경로가 코드상 `~/.hermes/*` 우선으로 정리됨
- [x] `.openclaw/*` fallback 경로가 코드상 유지됨
- [x] `hermes-agent` / `hermes-gateway` 기준 상태 판정 코드 반영 확인
- [ ] Hermes 실운영 환경에서 4자매가 전부 `OFFLINE`으로 고정되지 않음
- [ ] admin/costs 관련 로그/세션/재시작 기능이 Hermes 기준으로 실제 동작함
- 메모:
  - 소스 확인 결과 대상 파일 전반에서 Hermes-first + OpenClaw fallback 패턴이 일관되게 반영됨
  - 실노드 연결 기반 런타임 확인은 이번 로컬 QA 범위에서 아직 미실시

## 3. Avatar fallback 검증
- [x] `~/.hermes/avatar.*` 우선 탐색 코드 확인
- [x] `~/.openclaw/avatar.*` fallback 코드 확인
- [x] 이미지 실패 시 frontend `SisterAvatar`에서 fallback SVG/initial 처리 확인
- [ ] 대시보드 / 자매 목록 / 자매 상세에서 실제 렌더링 일관성 확인
- 메모:
  - backend `avatar.service.ts`와 frontend `SisterAvatar.tsx` 기준 broken image 방지 구조는 반영됨
  - 실제 브라우저 렌더링 재확인은 필요함

## 4. 대시보드 / 네비게이션 검증
- [x] 네비게이션 순서가 `대시 → 프로 → 활동 → 자매 → 조직 → 설정 → 관리`로 정렬됨
- [x] 모바일 하단 탭 순서도 동일한 배열 기반으로 구성됨
- [x] 프로젝트가 네비게이션 두 번째 위치에 보임
- [x] 대시보드 프로젝트 요약에서 phase/deploy 정보 구조 반영 확인

## 5. 프로젝트 목록 검증 (`/projects`)
- [x] 프로젝트 리스트에서 현재 단계가 우선 표시되도록 구현됨
- [x] 단계 문구가 아래 기준과 맞음
  - `PLANNING`
  - `IMPLEMENT`
  - `QA`
  - `READY FOR DEPLOY`
  - `DEPLOYED`
- [x] `QA PASSED / QA FAILED / READY FOR DEPLOY / DEPLOYED ON MAIN / REDEPLOY REQUIRED` 문구 구조 반영 확인
- [x] `READY FOR DEPLOY`와 `DEPLOYED ON MAIN` 구분 메타 반영 확인
- [x] latest QA / deploy status / updatedAt 메타 확인
- 메모:
  - backend `projects.service.ts`와 frontend `app/projects/page.tsx` 기준 정적 검토 완료
  - 실데이터 렌더링 검증은 재확인 필요

## 6. 프로젝트 상세 검증 (`/projects/[id]`)
- [x] 헤더에서 project status / current sprint / deploy state 구조 확인
- [x] 본문에서 아래 블록이 분리되어 보이도록 구현 확인
  - `DELIVERY FLOW`
  - `QA STATUS`
  - `DEPLOY STATUS`
  - `SPRINT LEDGER`
  - `HOTFIX HISTORY`
  - `ASSIGNED NODES`
- [x] hotfix 요약이 실제 summary/description 우선으로 노출되도록 반영 확인
- [x] 모바일 순서가 `DELIVERY FLOW → QA STATUS → DEPLOY STATUS → SPRINT/HOTFIX`로 설계 반영 확인
- [x] 신규 `.plans/hotfix/`, `.plans/qa/` 구조 우선 읽기 확인
- [x] 구 구조 `.qa/` fallback 처리 확인
- 메모:
  - source-level 검토 기준 acceptance 충족
  - 실브라우저/실데이터 동선 검증은 남아 있음

## 7. 배포 플로우 문구 검증
- [x] `main = deployable` 원칙이 코드/문구에 반영됨
- [x] 다랑 QA 통과 전 `main` merge 금지 문서 유지 확인
- [x] 이랑은 최신 `main`만 재배포하는 흐름 메타/문구 반영 확인
- [x] feature branch 직접 배포로 오해할 문구 제거 확인

## 8. blocker / error 목록
- `frontend lint 실패가 남아 있음` — Sprint scope 변경 파일 기준 주요 항목:
  - `frontend/components/projects/SprintAccordion.tsx:188` → `Unexpected any`
  - `frontend/components/projects/TaskTable.tsx:120` → `Unexpected any`
- `Hermes 실운영 런타임 검증 미완료`
  - 4자매 online/offline 상태
  - admin/costs 실동작
- `실브라우저 기반 모바일/렌더링 QA 미완료`
  - avatar fallback 실제 노출
  - `/projects`, `/projects/[id]` 실데이터 표시

## 9. 총평
- 문서 기준 Sprint 014 구현 범위는 전반적으로 반영된 것으로 보임.
- 로컬 기준 `backend test`, `backend build`, `frontend build`는 모두 통과했어.
- 다만 QA 완료로 닫기엔 아직 이르다.
  - Sprint 관련 lint 이슈가 남아 있고,
  - Hermes 실운영 런타임 확인과 브라우저/모바일 재검증이 비어 있어.
- 따라서 현재 판정은 `FAILED`로 두고, lint 정리 + 실환경 검증 후 재검증이 맞아.

## 10. 최종 보고 포맷
```json
{
  "repo": "https://git.nabomhalang.co.kr/hanarang/hanarang-dashboard",
  "branch": "feature/structure-renewal-sync",
  "passed": false,
  "errors": [
    "frontend/components/projects/SprintAccordion.tsx:188 Unexpected any",
    "frontend/components/projects/TaskTable.tsx:120 Unexpected any",
    "Hermes 실운영 런타임 검증 미완료",
    "실브라우저 기반 모바일/렌더링 QA 미완료"
  ]
}
```