Home

FOWOCO Client (프론트엔드) 개요

fowoco-client는 HR 담당자용 관리 웹과 근로자용 모바일 안내 웹을 담당하는 프론트엔드 패키지입니다. 백엔드는 Spring(Java) 기반 fowoco-server와 REST/JSON API로 통신합니다. Worker·Task·Audit·Document·Auth API는 실제 서버에 연동되어 있고, 아직 서버 계약이 없는 일부 화면(예: 승인·완료 처리 일부, 보안 링크 재발급)만 데모 상태로 남아 있습니다 — 정확한 현황은 Screen-Catalog 참고.

페이지 목록

• Frontend-Stack-Decision — 프레임워크·언어·상태관리 결정과 근거
• Screen-Catalog — 전체 화면 목록·구현 상태·Figma 대응 관계·알려진 갭
• Component-Library — 공통 컴포넌트·훅·유틸 전체 목록과 사용법
• Auth-and-Demo-Account — 로그인/회원가입 흐름과 데모 계정 정보
• Accessibility-Audit — 접근성(a11y) 점검 결과와 남은 항목
• Project-Status — 진행 상황 스냅샷 (Milestone·Issue·PR)

빠른 시작

npm install
npm run dev

로컬 서버(fowoco-server)를 함께 띄우려면 server 레포에서 데모 시드를 켜고 실행합니다.

# server 레포
DEMO_SEED_ENABLED=true DEMO_SEED_ADMIN_EMAIL='mini@naver.com' DEMO_SEED_ADMIN_PASSWORD='fowoco-demo-1234' ./gradlew bootRun

데모 계정: mini@naver.com / fowoco-demo-1234 (자세한 내용은 Auth-and-Demo-Account 참고)

관련 링크

• 저장소: https://github.com/fowoco/client
• Project 보드: https://github.com/orgs/fowoco/projects/2
• Figma: FOWOCO 디자인 파일 — 현재 기준은 [PWF] Prototype-WireFrame-3rd(PWF v3, node-id=1246-751) 페이지. 섹션 00~11로 구성되며 05번 Desktop Core Product가 데스크톱 화면 스펙, 06번이 근로자 모바일, 09번이 Developer Handoff 문서다. 자세한 대응 관계는 Screen-Catalog 참고
• 개발 컨벤션(모노레포 공통): fowoco/knowledge — CONTRIBUTING.md, DEVELOPMENT_STRATEGY.md
• 이 저장소는 공통 컨벤션 중 "병합 후 브랜치 자동 삭제"를 따르지 않습니다 (CONTRIBUTING.md 참고). (실제로는 병합 시 브랜치를 삭제하고 있음 — 컨벤션 재확인 필요하면 팀에 문의)