Feature #1571
open
우심
우심
[T19] Frontend 프로젝트 기본 구조·실행 (frontend/)
Feature #1571:
[T19] Frontend 프로젝트 기본 구조·실행 (frontend/)
Start date:
11/06/2026
Due date:
11/06/2026 (11 days late)
% Done:
100%
Estimated time:
Description
목표 및 사용자 시나리오:
Frontend 개발자(T20~T24)가 공통 구조 위에서 화면을 병렬 개발할 수 있도록 React 기반 frontend/ 앱 골격을 구축한다.
범위:
- React 19 + TypeScript 7 + Vite 8 + React Router 8
- Lint: oxlint (typescript-eslint가 TS 7 미지원(<6.1) → 리뷰 피드백으로 TS 7 상향 및 oxlint 교체)
- API client(src/api): 같은 Origin /api 호출, ApiError(HTTP status / 네트워크 0)
- Mock 모드(npm run dev:mock): Backend 미구현 API 대응
- 라우터, 최소 레이아웃, 홈(헬스 상태)·404 화면
- Vitest + Testing Library 테스트, frontend/README.md(스택 근거·실행·구조·규칙)
- T20 작업 위치 확보: src/components, src/layouts, src/styles(디자인 토큰 초안)
비범위:
- 공통 레이아웃·UI 컴포넌트 디자인: T20 (#1541)
- 기능 화면: T21~T24
- CI Frontend job: T28 / Staging 배포(Dockerfile·Nginx): T30
- 기존 poc/staging/frontend 변경
선행조건:
- T03 (#1570) 완료 — PR #19 병합
- T06 API 계약 미확정 → 기능 API는 Mock으로 대응
관련 화면/API/DB:
- /api/health, /api/version, /api/health/db (실제 구현 API)
- /api/v1/* 미구현 → 404 정상
완료조건(테스트·증빙 포함):
- Windows 로컬 실행·라우터 접근·build·lint/test PASS
- 실제 API / Mock 모드 / 404 화면 확인
- PR 리뷰 승인 및 병합
현재 결과 / 검증 근거:
- npm ci → lint(oxlint, --deny-warnings) PASS, typecheck(TypeScript 7.0.2) PASS, test 7개 PASS, build PASS
- Hooks 규칙 위반 샘플을 oxlint가 오류로 검출함을 확인
- npm run dev + 로컬 PoC: API 3종 200, Connected / 0.1.0 / Operational, Console 오류 0
- npm run dev:mock: 네트워크 요청 없이 Mock 데이터 표시 / 미존재 경로 → 404 화면
- 의존성 모두 registry.npmjs.org, 비밀정보 커밋 없음
- CI Smoke Test PASS (현재 CI는 Frontend lint/test/build 미실행 → 로컬 증빙)
브랜치 / PR / Merge SHA:
- 브랜치: task/t19-frontend-skeleton
- PR: https://github.com/ai-career-platform/ai-career-platform/pull/24
- Merge SHA: 없음 (리뷰 대기)
Staging 검증 결과: 미수행 (Staging 변경 NO)
다음 행동: 리뷰 반영 → 병합 → T20 담당자 공유 → T28과 CI Frontend job 협의
Subtasks