- 프로젝트: CodeInsight (코드 실행 시각화 학습 플랫폼)
- 구조: monorepo (
packages/frontend,packages/backend,packages/shared) - 백엔드: Fastify + Prisma + PostgreSQL
- 프론트: React + Vite + TypeScript
- Python lesson JSON 설명문 개선/정리 작업이 계속 진행 중.
.claude운영 문서 일부가 현재 코드 상태보다 뒤쳐져 있어 주기적 갱신 필요.
- 작업 전에 현재 코드/문서 실측 후 판단하기.
- 계획 문서보다 실제 코드 상태(
app.ts, 서비스 엔트리, git status)를 우선 신뢰하기.
- 사용자 이슈: "중국어가 안 보이고, Playground 버튼/JS 뷰어 탭이 안 보임".
- 원인:
- 현재 작업 브랜치에
zh로케일 파일/리소스 연결이 누락됨. PlaygroundPage가 JS를 시각화 렌더 조건에서 제외하고 있어 JS 관련 탭이 표시되지 않음.
- 현재 작업 브랜치에
- 수정:
packages/frontend/src/i18n.ts에zh리소스 복구.packages/frontend/src/locales/zh/translation.json복구.packages/frontend/src/components/LanguageSelector.tsx를 3개 언어(en/ko/zh) 선택 구조로 복구.packages/frontend/src/features/playground/PlaygroundPage.tsx를 JS 탭 로직 포함 버전으로 복구 (showJsMemoryTab,canRenderVisualizer에 JS 포함).
- 검증:
pnpm --filter @codeinsight/frontend build성공.- 실행 중 dev 서버(
127.0.0.1:5174)에서 소스 응답 확인:i18n.ts에zhTranslation로딩 확인.LanguageSelector.tsx에中文/grid-cols-3확인.PlaygroundPage.tsx에jsMemory/showJsMemoryTab확인.StepControls.tsx에playground-run-button존재 확인.
- 사용자 명시 선호: 프론트 UI/스타일 작업은 핫리로드로 확인.
- 기본 원칙: 사용자가 요청하지 않으면
pnpm build자동 실행하지 않음.