Home

FOWOCO Client (프론트엔드) 개요

fowoco-client는 HR 담당자용 관리 웹과 근로자용 모바일 안내 웹을 담당하는 프론트엔드 패키지입니다. 백엔드는 Spring(Java) 기반 fowoco-server와 REST/JSON API로 통신합니다. v3.0.0(PR #296) 기준으로 Auth·Worker·Task· Case·Audit·Document·Worker Import·Worker Link·Company Settings·Notification·AI Run까지 주요 도메인이 실제 서버에 연동되어 있습니다 — 정확한 현황은 Project-Status, Screen-Catalog 참고.

페이지 목록

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

빠른 시작

패키지 매니저는 bun입니다 (PR #299에서 npm → bun 전환, Node 버전은 .nvmrc 참고).

bun install
bun run dev

bun install 시 .husky/pre-commit 훅이 자동 등록되어, 커밋할 때 staged 파일에 ESLint/Prettier가 자동 실행됩니다.

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

# server 레포
DEMO_SEED_ENABLED=true DEMO_SEED_ADMIN_PASSWORD='fowoco-demo-1234' ./gradlew bootRun

데모 계정: demo.admin@example.com / fowoco-demo-1234 (LoginPage의 "데모로 시작" 버튼은 다른 이메일이 하드코딩되어 있어 현재 실패합니다 — 로그인 폼에 직접 입력하세요. 자세한 내용은 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 참고). (실제로는 병합 시 브랜치를 삭제하고 있음 — 컨벤션 재확인 필요하면 팀에 문의)