Project Status

진행 상황 스냅샷

이 페이지는 특정 시점 기준 스냅샷입니다. 최신 상태는 Project 보드와 Issue 목록, Milestone을 직접 확인하는 것이 정확합니다.

요약

• 전체 14개 화면(Figma 11 + 자체 설계 3) + 모바일 3 + 회원가입 — 전부 구현 완료 (Screen-Catalog)
• 공통 컴포넌트 라이브러리, 디자인 토큰, 반응형 대응, 404/에러 처리, 접근성 1차 점검 완료 (Component-Library, Accessibility-Audit)
• 데모 로그인(mini@naver.com / 1234) 연동 완료, 백엔드 연동 지점은 전부 TODO(backend) 주석으로 표시됨 (Auth-and-Demo-Account)
• 병합된 PR 44개, 종료된 Issue 49개 (현재 시점 기준)

Milestone 진행률

Milestone	진행률	주제
M0 · 기반 구축	10/10 ✅	저장소 세팅, 스택 결정, 디자인 토큰, 라우팅 골격
M1 · HR 핵심 화면	12/12 ✅	AUTH-001, HOME-001, PEOPLE-001, SET-001 등 PWF 데스크톱 화면
M2 · 문서·업무·Agent	16/16 ✅	WORK-001, CREATE-001, REVIEW-001, CASE-001
M3 · 근로자 모바일	3/3 ✅	LINK-001/002/003
M4 · UX 고도화	13/15 (2개 open)	로딩/빈/에러 상태, 레이아웃 고정, 모션 토큰, 도움말·토스트, 페이지네이션, 디바운스, 접근성
M5 · 미설계 화면 보완	4/4 ✅	서류관리·Agent 패널·티켓·근로자 상세 딥링크 (Figma에 없어 자체 설계)
M6 · 탭·필터 기능 완성	6/6 ✅	탭/드롭다운이 실제로 목록을 필터링하도록 연결, 상세 탭 콘텐츠 채우기

M4에 남은 2개 (둘 다 디자인 쪽 확인 대기, blocked 아님/blocked):

• #97 StatusLabel·기한 색상 토큰이 WCAG AA 대비 기준(4.5:1) 미달 — amber 2.62:1, red 4.20:1, green 4.29:1로 측정됨. 브랜드 전역 색상이라 디자이너 확인 필요
• #47 승인 CTA·승인 대기 강조 인터랙션 명세 — 사용자 본인의 Figma 작업 대기 중 (status:blocked)

주요 결정·작업 이력 (시간순)

1. 스택 결정 (Frontend-Stack-Decision) — React + Vite + TypeScript
2. 디자인 기준 전환 — MFW(러프) → PWF(정식 프로토타입) → PWF 2nd dev로 두 차례 전환. Figma 페이지명이 바뀔 때마다 Screen-Catalog의 링크를 갱신했음
3. 브랜치 정책 예외 — fowoco/knowledge 공통 컨벤션과 달리, 이 저장소는 병합 후에도 브랜치를 삭제하지 않음
4. 인증 방식 — 백엔드 이전이므로 Zustand 기반 데모 인증으로 로그인 흐름 우선 완성 (Auth-and-Demo-Account)
5. M5 — Figma에 없는 화면 자체 설계 — 서류관리/Agent 패널/티켓 관리는 Figma PWF에 대응 화면이 없어, 기존 화면 톤(헤드라인+설명, 탭/검색, 비동기 상태 패턴)을 따라 새로 설계
6. M6 — "보이는데 안 되는" 버그 일괄 정리 — 탭·드롭다운 필터가 화면엔 있지만 실제로 목록에 적용되지 않던 문제, 네이티브 <select>의 스타일링 한계(→ 공통 Dropdown 컴포넌트 도입), 업무/근로자 상세 탭에 콘텐츠가 없던 문제를 한 번에 정리
7. UX 마무리 라운드 — 기한 3단계 색상 구분, 도움말 패널, 전역 토스트, 목록 "전체 보기" 데모 페이지네이션, 검색 디바운스, 1차 접근성 점검을 순차로 진행
8. DB ERD 검토 — 원본 22개 테이블·3개 물리 DB 설계안을 프론트 실사용 기준으로 7개 테이블·단일 스키마로 단순화 제안 (별도 문서, 이 저장소 밖에서 관리 — 백엔드팀과 조율 필요)

알려진 갭 (다음 단계 후보)

• Figma에 설계돼 있지만 미구현: 승인 요청/결정 오버레이, 업무 Context 드로어, 완료 처리 오버레이(내부/외부기관 증빙), 보안 링크 재발급, 파일 일괄 가져오기(INTAKE-001), 온보딩 투어 — 자세한 목록은 Screen-Catalog 참고. 아직 이슈로 쪼개지지 않음
• Spring 백엔드 연동 — API 계약 확정 후 TODO(backend) 주석 위치부터 순서대로
• 로그인 상태 영속화(새로고침 유지) — 백엔드 세션/토큰 방식 확정 후 진행
• 색상 대비 개선 — #97