Project

General

Profile

Feature #1570

open
우심 우심

[T03] Frontend 개발환경 세팅 가이드

Feature #1570: [T03] 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 개발자가 Windows 11 PC에서 설치부터 로컬 실행·API 연결·검증까지 직접 진행할 수 있도록 개발환경 가이드를 검증·보완한다.

범위:

  • docs/development/FRONTEND_DEVELOPMENT_SETUP.md 실행 검증 및 보완
  • Node.js LTS 설치 절차(winget/MSI, 설치 확인, PATH·실행 정책·registry 오류 대응) 추가 (리뷰 반영)
  • Frontend 표준 스택 React 명시
  • 예외 케이스(404 / DB 중지 503·Degraded) 재현·복구 명령, 로컬 PoC 안전한 중지 방법 추가
  • 검증 증빙: docs/development/evidence/T03_FRONTEND_SETUP_VERIFICATION.md

비범위:

  • React 프로젝트 구조 생성: T19
  • Staging 서비스·DB 변경

선행조건: 없음

완료조건(테스트·증빙 포함):

  • 로컬 PoC 기동, UI 로드, API 3종 200 확인
  • 예외 케이스 증빙, PR 리뷰 승인 및 CI 통과

현재 결과 / 검증 근거:

  • Windows 11 Pro, Docker 29.7.2, Node v24.19.0 / npm 11.17.0
  • /api/health, /api/version, /api/health/db 200, 화면 Connected / Operational, Console 오류 0
  • /api/v1/jobs 404, 로컬 DB 중지 시 /api/health/db 503 → Degraded, 재시작 후 복구
  • CI Smoke Test PASS
  • 1차 리뷰(Crasnec) 변경 요청 → Node 설치 절차·React 명시 반영 → 승인

브랜치 / PR / Merge SHA:

Staging 검증 결과: 해당 없음 (문서 변경, Staging 변경 NO)

다음 행동: 완료. 후속 T19(React 기본 구조) 진행 중


Add

Subtasks


Add

Related issues 1 (1 open — 0 closed)

Related to Feature #1571: [T19] Frontend 프로젝트 기본 구조·실행 (frontend/)Resolved우섭 심11/06/202611/06/2026

Remove relationActions

Also available in: PDF Atom