feat: 방향전환 경로 검증 시스템 구현
- PathValidationResult 클래스를 Validation 폴더에 적절히 배치 - BacktrackingPattern 클래스로 A→B→A 패턴 상세 검출 - DirectionChangePlanner에서 되돌아가기 패턴 자동 검증 - CLAUDE.md에 AGVNavigationCore 프로젝트 구조 가이드 추가 - 빌드 시스템 오류 모두 해결 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -297,6 +297,50 @@ AGV가 후진 상태로 006 → 005 → 004 이동 중, 037(버퍼)에 도킹
|
||||
- **에러 처리**: 사용자 확인 다이얼로그와 상태바 메시지 활용
|
||||
- **코드 재사용**: UnifiedAGVCanvas를 맵에디터와 시뮬레이터에서 공통 사용
|
||||
|
||||
## AGVNavigationCore 프로젝트 구조 (함수 및 클래스 배치 가이드)
|
||||
|
||||
### 📁 AGVNavigationCore 폴더 구조
|
||||
```
|
||||
AGVNavigationCore/
|
||||
├── Controls/ # UI 컨트롤 및 캔버스
|
||||
├── Models/ # 데이터 모델 및 Enum 정의
|
||||
├── Utils/ # 유틸리티 클래스
|
||||
└── PathFinding/ # 경로 탐색 관련 모든 기능
|
||||
├── Analysis/ # 경로 분석 관련 클래스
|
||||
├── Core/ # 핵심 경로 탐색 알고리즘
|
||||
├── Planning/ # 경로 계획 및 방향 변경 로직
|
||||
└── Validation/ # 검증 관련 클래스 (DockingValidationResult, PathValidationResult 등)
|
||||
```
|
||||
|
||||
### 🎯 클래스 배치 원칙
|
||||
|
||||
#### PathFinding/Validation/
|
||||
- **검증 결과 클래스**: `*ValidationResult.cs` 패턴 사용
|
||||
- **검증 로직**: 결과를 반환하는 검증 메서드 포함
|
||||
- **네임스페이스**: `AGVNavigationCore.PathFinding.Validation`
|
||||
- **패턴**: 정적 팩토리 메서드 (CreateValid, CreateInvalid, CreateNotRequired)
|
||||
- **속성**: IsValid, ValidationError, 관련 상세 정보
|
||||
|
||||
#### PathFinding/Planning/
|
||||
- **경로 계획 클래스**: 실제 경로 탐색 및 계획 로직
|
||||
- **방향 변경 로직**: DirectionChangePlanner.cs 등
|
||||
- **경로 최적화**: 경로 생성과 관련된 전략 패턴
|
||||
|
||||
#### PathFinding/Core/
|
||||
- **핵심 알고리즘**: A* 알고리즘 등 기본 경로 탐색
|
||||
- **기본 경로 탐색**: 단순한 점-to-점 경로 계산
|
||||
|
||||
#### PathFinding/Analysis/
|
||||
- **경로 분석**: 생성된 경로의 품질 및 특성 분석
|
||||
- **성능 분석**: 경로 효율성 및 최적화 분석
|
||||
|
||||
### 📋 새 클래스 생성 시 체크리스트
|
||||
1. **기능별 분류**: 검증(Validation), 계획(Planning), 분석(Analysis), 핵심(Core)
|
||||
2. **네임스페이스 일치**: 폴더 구조와 네임스페이스 일치 확인
|
||||
3. **명명 규칙**: 기능을 명확히 나타내는 클래스명 사용
|
||||
4. **의존성**: 순환 참조 방지 및 계층적 의존성 유지
|
||||
5. **테스트 가능성**: 단위 테스트가 가능한 구조로 설계
|
||||
|
||||
### 🚨 알려진 이슈
|
||||
- **빌드 환경**: MSBuild 2022가 설치되지 않은 환경에서 빌드 불가
|
||||
- **좌표 시스템**: 줌/팬 상태에서 좌표 변환 정확성 지속 모니터링 필요
|
||||
Reference in New Issue
Block a user