# P&ID 재설계 - 코딩 계획

> 작성일: 2026-05-04
> 상태: 진행 중
> 목표: `No-10_Plant_PID.dxf`(28,819 엔티티) 처리 시 30분 타임아웃 해결

---

## 현황 요약

| 단계 | 내용 | 상태 |
|------|------|------|
| Step 1 | 현황 분석 (DXF 구조 파악) | ✅ 완료 |
| Step 2 | 성공 테스트 분석 (분할+병렬 성공 요인) | ✅ 완료 |
| Step 3 | 레전드 페이지 분석 (legend_parser.py 생성) | ✅ 완료 |
| Step 4 | 해결 방향 정의 | ✅ 완료 |
| Step 5~10 | 구현 (아래 상세 계획) | 🔲 미시작 |

---

## 핵심 전략

1. **도면 분할** — 한 DXF 파일 내 여러 도면을 좌표 기반으로 분리 (9개 도면 → 각각 독립 처리)
2. **계측기 유형별 병렬 LLM 호출** — Sensor/Valve/System/Gauge/Pump 동시 처리
3. **위치 정보 저장** — 태그의 DXF 상 좌표 + 근처 텍스트
4. **AREA 그룹핑** — 태그명에서 플랜트 번호 유추

---

## 변경 대상 파일

| 파일 | 변경 내용 |
|------|-----------|
| `mcp-server/pipeline/extractor.py` | 도면 분할 로직 추가 |
| `mcp-server/worker/pid_worker.py` | 도면 분할 + 병렬 LLM 호출 |
| `mcp-server/pipeline/mapper.py` | 기존 유지 (이미 배치 처리 구현됨) |
| `mcp-server/pipeline/topology.py` | 기존 유지 (이미 SpatialGrid 구현됨) |
| `mcp-server/pipeline/legend_parser.py` | 기존 유지 (이미 계측기 그룹 정의됨) |

---

## 상세 코딩 계획

### Phase 1: 도면 분할 로직 (extractor.py)

#### 1-1. 도면 분할 테스트 스크립트 작성
- **파일**: `test_drawing_split.py` (신규)
- **목표**: `No-10_Plant_PID.dxf`를 TITLE 레이어 LINE으로 분할하는 로직 프로토타입
- **작업 내용**:
  - ezdxf로 DXF 로드
  - TITLE 레이어의 LINE 엔티티 탐색
  - 수직 LINE(X 좌표가 일정)을 도면 경계로 감지
  - 각 도면별 X/Y 범위 출력
- **검증**: 9개 도면 영역이 올바르게 분리되는지 확인
- **완료 기준**: 콘솔에 9개 도면의 X/Y 범위가 출력됨

#### 1-2. PidGeometricExtractor에 도면 분할 메서드 추가
- **파일**: `mcp-server/pipeline/extractor.py`
- **목표**: `split_drawings()` 메서드 추가
- **작업 내용**:
  - `split_drawings() -> List[DrawingRegion]` 메서드 추가
  - DrawingRegion 데이터클래스 정의 (drawing_no, x_min, x_max, y_min, y_max)
  - TITLE 레이어 LINE 기반 경계 감지
  - 레전드 페이지(X < 2000) 제외
  - FFD 페이지도 제외 (최상단 텍스트 기반)
- **완료 기준**: `split_drawings()` 호출 시 9개 DrawingRegion 반환

#### 1-3. 영역별 추출 메서드 추가
- **파일**: `mcp-server/pipeline/extractor.py`
- **목표**: `extract_region()` 메서드 추가
- **작업 내용**:
  - `extract_region(region: DrawingRegion) -> List[GeometricEntity]` 메서드 추가
  - bbox가 region 범위 내에 있는 엔티티만 필터링
  - 기존 `extract_and_save()` 로직 재사용
- **완료 기준**: 각 도면별 엔티티 수 합계가 전체 엔티티 수와 일치

#### 1-4. 도면 분할 통합 테스트
- **파일**: `test_drawing_split.py`
- **목표**: 전체 파이프라인 테스트
- **작업 내용**:
  - DXF 로드 → 분할 → 영역별 추출 → 결과 검증
  - 각 도면별 엔티티 수, 태그 수 확인
  - 처리 시간 측정
- **완료 기준**: 9개 도면 모두 정상 추출, 총 처리 시간 < 30초

---

### Phase 2: 계측기 유형별 병렬 LLM 호출 (pid_worker.py)

#### 2-1. 계측기 유형별 프롬프트 정의
- **파일**: `mcp-server/worker/pid_worker.py`
- **목표**: 각 유형별 전용 프롬프트 상수 정의
- **작업 내용**:
  - `_SENSOR_EXTRACT_SYSTEM` — FT, FIT, LT, PT, TE, PG, LG, TG 추출
  - `_VALVE_EXTRACT_SYSTEM` — FCV, TCV, LCV, PCV, XV, FV, LV, PV, TV 추출
  - `_SYSTEM_EXTRACT_SYSTEM` — LI, PI, TI, FIQ, FICQ, TICA, PICA, LICA 추출
  - `_GAUGE_EXTRACT_SYSTEM` — PG, TG, LG 추출
  - `_PUMP_EXTRACT_SYSTEM` — P-10101, VP-10117, DP-10101 등 펌프 추출
  - 각 프롬프트는 `max_tokens=65536` 적용
- **완료 기준**: 5개 프롬프트 상수 정의 완료

#### 2-2. 유형별 추출 함수 작성
- **파일**: `mcp-server/worker/pid_worker.py`
- **목표**: `_extract_tags_by_type()` 함수 추가
- **작업 내용**:
  - `_extract_tags_by_type(text: str, type_name: str, system_prompt: str) -> List[dict]` 함수
  - LLM 호출 → JSON 파싱 → 태그 목록 반환
  - `max_tokens=65536` 적용
  - finish_reason=length 복구 로직 포함
- **완료 기준**: 단일 유형 추출 테스트 통과

#### 2-3. 병렬 호출 로직 구현
- **파일**: `mcp-server/worker/pid_worker.py`
- **목표**: `_extract_all_types_parallel()` async 함수 추가
- **작업 내용**:
  - `asyncio.gather()`로 5개 유형 동시 호출
  - 각 유형별 결과 통합
  - 중복 태그 제거 (tagNo 기준)
- **완료 기준**: 5개 유형 병렬 호출 테스트, 총 처리 시간 < 120초

#### 2-4. `_build_pid_graph_parallel()` 리팩토링
- **파일**: `mcp-server/worker/pid_worker.py`
- **목표**: 기존 함수를 도면 분할 + 병렬 LLM 호출로 변경
- **작업 내용**:
  - Phase 1: 도면 분할 (extractor.split_drawings())
  - Phase 2: 각 도면별 기하 추출 (extractor.extract_region())
  - Phase 3: 각 도면별 유형별 병렬 LLM 호출
  - Phase 4: 결과 통합 + 그래프 빌드
  - Phase 5: 저장
- **완료 기준**: 기존 API 호환 유지, 처리 시간 30분 → 5분 이내

#### 2-5. 병렬 처리 통합 테스트
- **파일**: `test_parallel_extraction.py` (신규)
- **목표**: 전체 병렬 처리 파이프라인 테스트
- **작업 내용**:
  - `No-10_Plant_PID.dxf` 전체 처리
  - 각 단계별 시간 측정
  - 추출된 태그 수, 매핑 수 확인
- **완료 기준**: 전체 처리 < 5분, 태그 추출 수 > 기존

---

### Phase 3: 위치 정보 저장

#### 3-1. 위치 정보 스키마 정의
- **파일**: `mcp-server/worker/pid_worker.py`
- **목표**: 태그 추출 결과에 위치 정보 포함
- **작업 내용**:
  - 각 태그에 `bbox` (min_x, min_y, max_x, max_y) 필드 추가
  - `drawing_no` (도면 번호) 필드 추가
  - `nearby_text` (근처 텍스트) 필드 추가
- **완료 기준**: 추출 결과 JSON에 위치 정보 포함

#### 3-2. 근처 텍스트 추출 로직
- **파일**: `mcp-server/pipeline/extractor.py`
- **목표**: `get_nearby_text()` 메서드 추가
- **작업 내용**:
  - 특정 좌표 주변 threshold 이내 TEXT 엔티티 검색
  - SpatialGrid 활용 (O(1) 조회)
  - 상하좌우 위치 파악 (direction 필드)
- **완료 기준**: 태그 주변 텍스트 정상 추출

#### 3-3. 위치 정보 통합 테스트
- **파일**: `test_location_info.py` (신규)
- **목표**: 위치 정보 정확도 검증
- **작업 내용**:
  - 알려진 태그 위치와 추출된 위치 비교
  - 근처 텍스트 정확도 확인
- **완료 기준**: 위치 정보 정확도 > 90%

---

### Phase 4: AREA 그룹핑

#### 4-1. AREA 추출 로직 개선
- **파일**: `mcp-server/pipeline/legend_parser.py`
- **목표**: `extract_area_from_tag()` 정확도 향상
- **작업 내용**:
  - FICQ-6113 → "6" (6호 플랜트)
  - FICQ-10113 → "10" (10호 플랜트)
  - 패턴 매칭 개선 (정규식 튜닝)
- **완료 기준**: 테스트 케이스 10개 모두 정확

#### 4-2. AREA별 그룹핑 함수
- **파일**: `mcp-server/worker/pid_worker.py`
- **목표**: `_group_by_area()` 함수 추가
- **작업 내용**:
  - 추출된 태그 목록을 AREA별로 그룹핑
  - AREA 번호가 없는 태그는 "unknown" 그룹
  - 그룹별 통계 출력
- **완료 기준**: AREA별 그룹핑 결과 정상 출력

---

### Phase 5: Experion 태그 매핑

#### 5-1. 기존 매핑 로직 확인
- **파일**: `mcp-server/pipeline/mapper.py`
- **목표**: 기존 IntelligentMapper 동작 확인
- **작업 내용**:
  - `_batch_gather()` 배치 처리 확인 (이미 구현됨)
  - RapidFuzz 기반 후보 추출 확인
  - LLM 기반 최종 매핑 확인
- **완료 기준**: 기존 매핑 정확도 확인

#### 5-2. 매핑 결과 통합
- **파일**: `mcp-server/worker/pid_worker.py`
- **목표**: `_build_pid_graph_parallel()`에 매핑 결과 통합
- **작업 내용**:
  - Phase 3 결과 (추출된 태그)를 IntelligentMapper에 전달
  - 매핑 결과를 그래프에 추가
  - 매핑 통계 출력
- **완료 기준**: 매핑 결과 그래프에 정상 반영

---

### Phase 6: UI 연동

#### 6-1. API 엔드포인트 확인
- **파일**: `src/Web/Controllers/PidController.cs`
- **목표**: 기존 API 엔드포인트 확인
- **작업 내용**:
  - 태그 검색 API 확인
  - 위치 정보 반환 여부 확인
- **완료 기준**: API 스펙 파악

#### 6-2. 위치 정보 API 추가
- **파일**: `src/Web/Controllers/PidController.cs`
- **목표**: 태그 위치 조회 API 추가
- **작업 내용**:
  - `GET /api/pid/tags/{tagName}/location` 엔드포인트 추가
  - DXF 좌표, 도면 번호, 근처 텍스트 반환
  - 현재 실시간 값 연동
- **완료 기준**: API 테스트 통과

#### 6-3. 프론트엔드 UI 수정
- **파일**: `src/Web/wwwroot/js/app.js`
- **목표**: 태그 검색 시 위치 표시
- **작업 내용**:
  - 태그 검색 결과에 위치 정보 표시
  - "6호 정제탑, 밑에서 3번째 온도 센서입니다. 현재 온도 105도" 형식
  - DXF 도면 상 위치 시각화 (선택사항)
- **완료 기준**: UI에서 위치 정보 확인 가능

---

## 실행 순서 및 의존성

```
Phase 1 (도면 분할)
  ├── 1-1 → 1-2 → 1-3 → 1-4  (순차)
  │
Phase 2 (병렬 LLM)
  ├── 2-1 → 2-2 → 2-3 → 2-4 → 2-5  (순차, Phase 1 완료 후)
  │
Phase 3 (위치 정보)
  ├── 3-1 → 3-2 → 3-3  (순차, Phase 2 완료 후)
  │
Phase 4 (AREA 그룹핑)
  ├── 4-1 → 4-2  (순차, 독립 실행 가능)
  │
Phase 5 (매핑 통합)
  ├── 5-1 → 5-2  (순차, Phase 2+3 완료 후)
  │
Phase 6 (UI 연동)
  ├── 6-1 → 6-2 → 6-3  (순차, Phase 5 완료 후)
```

---

## 각 단계 완료 기준

| 단계 | 완료 기준 | 예상 시간 |
|------|-----------|-----------|
| 1-1 | 9개 도면 영역 콘솔 출력 | 30분 |
| 1-2 | `split_drawings()` 9개 Region 반환 | 1시간 |
| 1-3 | `extract_region()` 정상 동작 | 30분 |
| 1-4 | 전체 분할 테스트 통과 | 30분 |
| 2-1 | 5개 프롬프트 상수 정의 | 30분 |
| 2-2 | 단일 유형 추출 테스트 통과 | 1시간 |
| 2-3 | 5개 유형 병렬 호출 테스트 | 1시간 |
| 2-4 | `_build_pid_graph_parallel()` 리팩토링 완료 | 2시간 |
| 2-5 | 전체 병렬 처리 테스트 통과 | 1시간 |
| 3-1 | 위치 정보 JSON 필드 추가 | 30분 |
| 3-2 | `get_nearby_text()` 구현 | 1시간 |
| 3-3 | 위치 정보 정확도 검증 | 30분 |
| 4-1 | AREA 추출 테스트 10개 통과 | 30분 |
| 4-2 | AREA별 그룹핑 결과 출력 | 30분 |
| 5-1 | 기존 매핑 정확도 확인 | 30분 |
| 5-2 | 매핑 결과 그래프 반영 | 1시간 |
| 6-1 | API 스펙 파악 | 30분 |
| 6-2 | 위치 조회 API 추가 | 1시간 |
| 6-3 | UI 수정 완료 | 1시간 |

**총 예상 시간: 약 18시간**

---

## 체크리스트

### Phase 1: 도면 분할
- [ ] 1-1. 도면 분할 테스트 스크립트 작성
- [ ] 1-2. PidGeometricExtractor에 도면 분할 메서드 추가
- [ ] 1-3. 영역별 추출 메서드 추가
- [ ] 1-4. 도면 분할 통합 테스트

### Phase 2: 계측기 유형별 병렬 LLM 호출
- [ ] 2-1. 계측기 유형별 프롬프트 정의
- [ ] 2-2. 유형별 추출 함수 작성
- [ ] 2-3. 병렬 호출 로직 구현
- [ ] 2-4. `_build_pid_graph_parallel()` 리팩토링
- [ ] 2-5. 병렬 처리 통합 테스트

### Phase 3: 위치 정보 저장
- [ ] 3-1. 위치 정보 스키마 정의
- [ ] 3-2. 근처 텍스트 추출 로직
- [ ] 3-3. 위치 정보 통합 테스트

### Phase 4: AREA 그룹핑
- [ ] 4-1. AREA 추출 로직 개선
- [ ] 4-2. AREA별 그룹핑 함수

### Phase 5: Experion 태그 매핑
- [ ] 5-1. 기존 매핑 로직 확인
- [ ] 5-2. 매핑 결과 통합

### Phase 6: UI 연동
- [ ] 6-1. API 엔드포인트 확인
- [ ] 6-2. 위치 정보 API 추가
- [ ] 6-3. 프론트엔드 UI 수정

---

## 주의 사항

1. **백업 필수**: 각 파일 수정 전 `.rooBackup/`에 백업
2. **diff 제시**: 변경 내용 diff 형식으로 제시 후 확인
3. **작은 단계**: 각 단계를 독립적으로 완료하고 검증
4. **테스트 우선**: 테스트 스크립트 먼저 작성 후 구현
5. **기존 코드 유지**: topology.py, mapper.py는 기존 유지 (이미 잘 구현됨)

---

## 다음 시작 시

1. 이 파일의 체크리스트에서 첫 번째 미완료 항목부터 시작
2. 각 단계 완료 시 체크리스트 업데이트
3. 문제가 발생하면 해당 단계에서 중단하고 원인 분석
4. 완료 기준을 충족해야 다음 단계로 진행