---
name: code-fix
description: 리포트 코드 문제 수정 워크플로우. 리포트 관련 버그, 에러를 진단하고 수정. 에러 수정 요청 시 적용.
disable-model-invocation: true
---

# 리포트 코드 문제 수정 워크플로우

## 수정 범위 제약

리포트 관련 파일만 수정. 원인이 리포트 밖에 있으면 보고만.

## 진단 절차

1. 에러 메시지 분석
2. 에러 파일이 리포트 범위 내인지 확인
3. 근본 원인 파악
4. 리포트 범위 내에서 최소한의 수정
5. 린트/타입 검사로 검증

## 리포트 특화 에러 패턴

| 에러 | 원인 | 해결 |
|------|------|------|
| 디자이너 렌더링 실패 | Context 상태 불일치 | ReportDesignerContext 확인 |
| 프리뷰 빈 화면 | 데이터 직렬화 오류 | report.ts 타입 확인 |
| API 404 | 라우트 미등록 | reportRoutes.ts 확인 |
| company_code 누락 | 서비스 필터링 빠짐 | reportService.ts 확인 |

## 수정 후 검증

```bash
cd frontend && npx tsc --noEmit
```
