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

우심 Updated by 우섭 심 11 days ago Actions #1

  • Status changed from New to In Progress

PR #24 리뷰 대기 (CI Smoke Test PASS). 리뷰 피드백 반영: TypeScript 7 상향, ESLint→oxlint 교체.
https://github.com/ai-career-platform/ai-career-platform/pull/24

우심 Updated by 우섭 심 11 days ago Actions #2

  • Precedes Feature #1541: [T20] Frontend 공통 레이아웃 및 UI 컴포넌트 구현 added

우심 Updated by 우섭 심 11 days ago Actions #3

  • Due date set to 11/09/2026
  • Start date changed from 11/06/2026 to 11/09/2026
  • Follows Feature #1570: [T03] Frontend 개발환경 세팅 가이드 added

우심 Updated by 우섭 심 11 days ago Actions #4

  • Follows deleted (Feature #1570: [T03] Frontend 개발환경 세팅 가이드)

우심 Updated by 우섭 심 11 days ago Actions #5

  • Related to Feature #1570: [T03] Frontend 개발환경 세팅 가이드 added

우심 Updated by 우섭 심 11 days ago Actions #6

  • Due date changed from 11/09/2026 to 11/06/2026
  • Status changed from In Progress to Resolved
  • Start date changed from 11/09/2026 to 11/06/2026
  • % Done changed from 90 to 100

PR #24 Crasnec 승인 후 main 병합 완료 (2026-11-06, 14b062f). 진척도 100%, 상태 Resolved — PM 확인 후 Closed 처리 부탁드립니다.
frontend/ React 기본 구조가 main에 반영되어 T20(#1541) 착수 가능합니다.
(T03 연결을 "우선 진행"→"관련"으로 변경: 우선 진행 관계가 시작일을 11/09로 자동 이동시켜 실제 작업일 11/06으로 복구)
https://github.com/ai-career-platform/ai-career-platform/pull/24

Also available in: PDF Atom