Feature #1570
open
우심
우심
[T03] Frontend 개발환경 세팅 가이드
Feature #1570:
[T03] Frontend 개발환경 세팅 가이드
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:
- 브랜치: task/t03-frontend-setup
- PR: https://github.com/ai-career-platform/ai-career-platform/pull/19
- Merge: 2026-11-06 (Crasnec 승인·병합), SHA e71ce002bc6209f66121c2d335123cc8e09e0419
Staging 검증 결과: 해당 없음 (문서 변경, Staging 변경 NO)
다음 행동: 완료. 후속 T19(React 기본 구조) 진행 중
Subtasks
우심 Updated by 우섭 심 11 days ago
- Status changed from New to Resolved
PR #19 Crasnec 승인 후 main 병합 완료 (2026-11-06, e71ce00). 진척도 100%, 상태 Resolved — PM 확인 후 Closed 처리 부탁드립니다.
https://github.com/ai-career-platform/ai-career-platform/pull/19
우심 Updated by 우섭 심 11 days ago
- Precedes Feature #1571: [T19] Frontend 프로젝트 기본 구조·실행 (frontend/) added
우심 Updated by 우섭 심 11 days ago
- Precedes deleted (Feature #1571: [T19] Frontend 프로젝트 기본 구조·실행 (frontend/))
우심 Updated by 우섭 심 11 days ago
- Related to Feature #1571: [T19] Frontend 프로젝트 기본 구조·실행 (frontend/) added