99 lines
4.4 KiB
Markdown
99 lines
4.4 KiB
Markdown
# CLAUDE.md
|
|
|
|
이 파일은 Claude Code (claude.ai/code)가 이 저장소에서 코드 작업을 할 때 지침을 제공합니다.
|
|
|
|
## 프로젝트 개요
|
|
|
|
이것은 ATV (Automatic Test Vehicle) 릴 라벨 부착, 수정 및 전송 작업을 위한 산업 자동화 시스템입니다. 시스템은 Windows Forms를 사용하여 C# (.NET Framework 4.8)로 구축되었으며, 모션 컨트롤러, 바코드 리더, 프린터 및 PLC를 포함한 다양한 하드웨어 구성 요소와 통합됩니다.
|
|
|
|
## 빌드 명령어
|
|
|
|
- **윈도우 환경 cmd 로 실행필요
|
|
"C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Current\Bin\msbuild.exe" "C:\Data\Source\(5815) ATV Reel Label Attach Modify & Transfer (WMS)\Source\Handler\Project\STDLabelAttach(ATV).csproj" /v:quiet
|
|
|
|
|
|
## 아키텍처 개요
|
|
|
|
### 핵심 구성 요소
|
|
|
|
- **Project/**: UI 및 비즈니스 로직이 포함된 메인 애플리케이션
|
|
- 기본 Windows Forms 애플리케이션 포함 (`fMain.cs`)
|
|
- `RunCode/StateMachine/` 및 `RunCode/Step/`에서 상태 머신 로직 구현
|
|
- `Device/` 폴더의 디바이스 인터페이스 (KeyenceBarcode, SATOPrinter, TowerLamp 등)
|
|
- 사용자 상호작용을 위한 다이얼로그 폼
|
|
|
|
- **Project_form2/**: 데이터 처리를 위한 보조 수신기 애플리케이션
|
|
- SID (Serial ID) 변환 및 처리 담당
|
|
- 고객 정보 관리
|
|
- 가져오기/내보내기 기능
|
|
|
|
- **Sub/**: 공유 라이브러리 및 유틸리티
|
|
- `arCtl/`: 사용자 정의 UI 컨트롤 및 구성 요소
|
|
- `arAzinAxt/`: 모션 컨트롤러 인터페이스 (AzinAxt 하드웨어)
|
|
- `arRS232/`: 시리얼 통신 라이브러리
|
|
- `AmkorRestfulService/`: 외부 통합을 위한 RESTful API 서비스
|
|
- `CommSM/`: 상태 머신 통신 라이브러리
|
|
- `CommUtil/`: 공통 유틸리티 및 다이얼로그
|
|
|
|
### 주요 기술
|
|
|
|
- **하드웨어 통합**: 모션 컨트롤러 (AzinAxt), 바코드 리더 (Keyence), SATO 프린터
|
|
- **데이터베이스**: SQL Server를 사용한 Entity Framework 6.2.0
|
|
- **통신**: 시리얼 (RS232), RESTful API, WebSocket
|
|
- **비전**: 이미지 처리를 위한 EmguCV
|
|
- **프로토콜**: 장비 제어를 위한 사용자 정의 상태 머신 구현
|
|
|
|
### 상태 머신 아키텍처
|
|
|
|
애플리케이션은 포괄적인 상태 머신 패턴을 사용합니다:
|
|
- `RunCode/Step/`: 주요 작업 단계 (INIT, IDLE, RUN, HOME, FINISH)
|
|
- `RunCode/StateMachine/`: 핵심 상태 머신 로직 및 이벤트 처리
|
|
- `RunCode/RunSequence/`: 특정 작업 시퀀스 (바코드 읽기, 인쇄, 피킹)
|
|
|
|
### 디바이스 관리
|
|
|
|
- 위치 검증이 포함된 `arAzinAxt` 라이브러리를 통한 모션 제어
|
|
- Keyence 스캐너 통합을 통한 바코드 읽기
|
|
- SATO 프린터 API를 통한 라벨 인쇄
|
|
- 안전 및 I/O 제어를 위한 PLC 통신
|
|
|
|
## 개발 패턴
|
|
|
|
### 구성 관리
|
|
- 수정을 위한 UI 폼이 포함된 `Setting/` 클래스에 설정 저장
|
|
- `System_Setting.cs` 및 `System_MotParameter.cs`의 시스템 매개변수
|
|
- `UserSetting.cs`의 사용자별 설정
|
|
|
|
### 데이터 관리
|
|
- `Model1.edmx`의 Entity Framework 모델
|
|
- 다양한 데이터 유형을 위한 `Manager/` 폴더의 데이터베이스 관리자
|
|
- 릴 정보, 결과 및 SID 변환을 위한 구성 요소 클래스
|
|
|
|
### UI 패턴
|
|
- `UIControl/` 폴더의 사용자 정의 컨트롤
|
|
- `Dialog/` 폴더의 일관된 다이얼로그 패턴
|
|
- 포함된 이미지 및 아이콘을 사용한 리소스 관리
|
|
|
|
## 중요 사항
|
|
|
|
- 시스템에는 특정 하드웨어 드라이버가 필요합니다 (AzinAxt 모션 컨트롤러, Keyence SDK, SATO 프린터 드라이버)
|
|
- 데이터베이스 연결 문자열은 `app.config`에서 구성됩니다
|
|
- 모션 매개변수는 `MotParam/`의 `.swpp` 및 `.usrs` 파일에 저장됩니다
|
|
- 애플리케이션은 서로 다른 출력 경로를 가진 Debug 및 Release 구성을 모두 지원합니다
|
|
- 플랫폼 대상은 일반적으로 하드웨어 호환성을 위해 x64입니다
|
|
|
|
## 테스트
|
|
|
|
공식적인 단위 테스트 프로젝트는 없습니다. 테스트는 일반적으로 다음을 통해 수행됩니다:
|
|
- 메인 애플리케이션을 사용한 수동 작업
|
|
- 실제 장비를 사용한 하드웨어 인 더 루프 테스트
|
|
- 애플리케이션의 디버그 다이얼로그 및 모니터링 폼
|
|
|
|
## 종속성
|
|
|
|
주요 외부 종속성은 다음과 같습니다:
|
|
- Entity Framework 6.2.0
|
|
- Newtonsoft.Json 13.0.3
|
|
- EmguCV 4.5.1
|
|
- 웹 서비스를 위한 Microsoft OWIN 스택
|
|
- 다양한 하드웨어별 SDK 및 드라이버 |