Skip to content

Project Status

Jump to bottom
mini edited this page Aug 10, 2026 · 5 revisions

진행 상황 스냅샷

이 페이지는 특정 시점 기준 스냅샷입니다 (최근 갱신: v3.0.0 / PR #296 기준, 2026-08-10). 최신 상태는 Project 보드와 Issue 목록, Milestone을 직접 확인하는 것이 정확합니다.

요약

  • v3.0.0 릴리스됨 (main, PR #296 병합 커밋 c54bab5) — develop 통합 브랜치가 그동안 쌓인 대규모 기능을 한 번에 main에 반영
  • 전체 화면(인증 5 + 데스크톱 핵심 10 + 근로자 모바일 3 + 자체 설계 2) 구현 완료 — 상세는 Screen-Catalog
  • 주요 API 도메인이 전부 실제 서버(fowoco-server)에 연동됨: Auth(로그인/회원가입/비밀번호 재설정)·Worker(조회+등록/수정)·Task·Case·Audit·Document(요청 초안/다운로드/HWP 업로드/OCR 검토)·Worker Import(명단 가져오기)·Worker Link(전달/응답)·Company Settings·Notification·AI Run(자연어 요청→질문→후보→Case/Task 생성, SSE 진행상태)
  • 로그인은 실제 JWT + refresh 쿠키 기반이며 새로고침해도 세션이 유지됨 (Auth-and-Demo-Account) — 단, LoginPage의 "데모로 시작" 버튼은 여전히 잘못된 이메일(mini@naver.com)을 하드코딩하고 있어 실패함. 실제 시드 계정으로 직접 로그인해야 함 (아래 데모 계정 참고)
  • 라우트 코드 스플리팅 적용 — 프로덕션 빌드 500KB 경고 해소
  • 별도의 전체 UI 디자인 리뉴얼 시도(다크→화이트/블루 톤, 사이드바→상단 pill 네비게이션)가 PR #276로 진행됐으나 의도적으로 미병합 상태(리뷰용 draft). develop이 흡수한 실제 병합 디자인과는 다른 별개 트랙이었음 — 최신 화면 디자인은 PWF v3 + develop 자체 개선(사이드바 유지, 블루 accent)을 따름

최근 주요 변경 (시간순, 최근 것부터)

  1. 개발 도구 정비 (이슈 #297 / PR #299) — 패키지 매니저를 npm → bun으로 전환(bun.lock), husky+lint-staged로 커밋 전 자동 lint/format 도입, CI·Dockerfile을 bun 기준으로 갱신, .nvmrc+engines로 Node 20 고정, Dependabot 추가
  2. PR #296 — develop → main 대규모 통합 (v3.0.0) — 149개 파일, +12199/-1778, 61개 커밋. Today 대시보드 실 API, AI Run 전체 흐름, 문서 요청·다운로드·OCR·HWP 업로드, 근로자 import, worker-link 전달/응답, 회사 설정, 알림, 라우트 코드 스플리팅을 한 번에 반영
  3. AI Run 자연어 요청 연동 완료 (이슈 #229, 관련 PR #230/#286/#287 등은 develop 통합 후 정리) — POST /ai-runs → NEEDS_INFO 질문 응답 → REVIEW_REQUIRED 후보 검토 → Case/Task 확정까지 전체 흐름, 진행 상태 SSE 구독, 브라우저 탭 단위 요청 초안 보존
  4. 근로자 등록/수정 연동 (이슈 #270 / PR #271) — 서버 POST/PATCH /workers에 연결. WorkerListPage에 등록 버튼, WorkerDetailPage에 수정 버튼 추가
  5. 업무함을 Case API로 전환 (이슈 #268 / PR #269) — /workers+/tasks+/workflow-catalogs 클라이언트 조합 방식에서 서버의 GET /cases, /cases/{id}/projection으로 교체
  6. 비밀번호 재설정 연동 (이슈 #277 / PR #278) — ForgotPasswordPage/ResetPasswordPage를 POST /auth/password-reset-requests, /auth/password-resets에 연결. 작업 중 apiFetch가 202-무본문 응답을 잘못 처리하던 버그도 같이 수정
  7. SignupPage 활성 버그 수정 (이슈 #279 / PR #280) — 서버가 agreements 필드를 필수로 요구하도록 바뀌었는데 client가 안 보내서 회원가입이 전부 400으로 실패하던 것을 발견·수정
  8. 전체 UI 디자인 리뉴얼 시도 (이슈 #272~#275 / PR #276, 미병합) — 다크 그라파이트 → 화이트+블루 액센트로 전환, 사이드바 제거하고 상단 pill 네비게이션 구조로 재작성. 리뷰용으로 열어둔 상태이며 develop 통합과는 별개 트랙

Milestone 진행률

Milestone 상태 주제
M0 · 기반 구축 ✅ 저장소 세팅, 스택 결정, 디자인 토큰, 라우팅 골격
M1 · HR 핵심 화면 ✅ AUTH-001, HOME-001, PEOPLE-001 등 PWF 데스크톱 화면
M2 · 문서·업무·Agent ✅ WORK-001, CREATE-001, REVIEW-001, CASE-001
M3 · 근로자 모바일 ✅ LINK-001/002/003
M4 · UX 고도화 ✅ 로딩/빈/에러 상태, 레이아웃 고정, 모션 토큰, 반응형 전체 점검
M5 · 미설계 화면 보완 ✅ 서류관리·근로자 상세 딥링크
M6 · 탭·필터 기능 완성 ✅ 탭/드롭다운 실제 필터링 연결
(비공식) M7 · 실 백엔드 API 전면 연동 ✅ Worker CRUD, Case API, Auth 전체(로그인/가입/재설정), Document, Worker Import, Worker Link, Company Settings, Notification, AI Run — PR #296으로 대부분 완료

열린 이슈 (우선순위 높은 것)

  • #154 / #155 (P0) — 승인·완료처리 API 연동. 주의: POST /tasks/{id}/approval-requests·/approve·/reject·/evidence·/complete는 이미 approvals.ts→CaseDetailPage로 연결되어 있는 것이 확인됨(2026-08-10 감사). 기본 흐름은 된 것으로 보이나, #154가 원래 지적한 multi-approver·재승인 diff 같은 서버에 없는 개념이 남아있는지 재확인 후 이슈 상태 갱신 필요
  • #206 (P2) — Agent·티켓 사이드바 노출 여부 결정 대기
  • #97 — StatusLabel·기한 색상 토큰 WCAG AA 대비 미달 (디자이너 확인 대기)
  • #47 — 승인 CTA·승인 대기 강조 인터랙션 명세 (blocked, Figma 작업 대기)
  • #272~#275 — 전체 UI 디자인 리뉴얼, PR #276 리뷰 대기(의도적 미병합)

릴리스 이력

버전 대상 비고
v1.0.0 main 최초 정식 릴리스
v2.0.0 design/full-ui-renewal 브랜치 (prerelease) 디자인 리뉴얼 프리뷰, main 미반영
v3.0.0 main develop 통합(PR #296) — 대시보드·AI Run·문서·근로자import·회사설정·알림 전면 연동

주요 결정 이력

  1. 스택 결정 (Frontend-Stack-Decision) — React + Vite + TypeScript
  2. 디자인 기준 — PWF v3(Prototype-WireFrame-3rd)를 기준으로 유지. 별도 시도된 전면 리뉴얼(PR #276)은 미병합
  3. 인증 방식 — 실제 JWT + refresh 쿠키 기반 서버 인증
  4. 업무함(WORK-001) 재설계 — Task 평면 목록 → 근로자 중심 마스터-디테일 → Case API 기반(PR #269)으로 재차 전환
  5. develop 브랜치 통합 전략 — 여러 기능 PR을 integration/0808-* 브랜치들로 단계적으로 묶은 뒤 develop에 합치고, 검증 후 develop→main 한 번에 병합(#296)하는 방식을 채택

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

  • LoginPage "데모로 시작" 버튼의 하드코딩된 이메일(mini@naver.com)이 실제 시드 계정과 불일치 — 클릭하면 로그인 실패. demo.admin@example.com으로 수정 필요
  • #154/#155 승인·완료처리 이슈 상태 재확인 (기본 연동은 된 것으로 보임)
  • 색상 대비 개선 (#97)
  • Agent·티켓 사이드바 노출 여부 결정 (#206)

Clone this wiki locally