Project

General

Profile

Feature #1571

open
우심 우심

[T19] Frontend 프로젝트 기본 구조·실행 (frontend/)

Feature #1571: [T19] Frontend 프로젝트 기본 구조·실행 (frontend/)

Added by 우섭 심 11 days ago. Updated 11 days ago.

Status:
Resolved
Priority:
High
Assignee:
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:

Staging 검증 결과: 미수행 (Staging 변경 NO)

다음 행동: 리뷰 반영 → 병합 → T20 담당자 공유 → T28과 CI Frontend job 협의


Add

Subtasks


Add

Related issues 2 (2 open — 0 closed)

Related to Feature #1570: [T03] Frontend 개발환경 세팅 가이드Resolved우섭 심11/06/202611/06/2026

Remove relationActions
Precedes Feature #1541: [T20] Frontend 공통 레이아웃 및 UI 컴포넌트 구현New11/09/202611/13/2026

Remove relationActions

Also available in: PDF Atom