signal-batch/.claude/commands/clarify.md
htlee 2e9361ee58 refactor: SNP API 전환 및 레거시 코드 전면 정리
- CollectDB 다중 신호 수집 → S&P Global AIS API 단일 수집으로 전환
- sig_src_cd + target_id 이중 식별자 → mmsi(VARCHAR) 단일 식별자
- t_vessel_latest_position → t_ais_position 테이블 전환
- 레거시 배치/유틸 ~30개 클래스 삭제 (VesselAggregationJobConfig, ShipKindCodeConverter 등)
- AisTargetCacheManager 기반 캐시 이중 구조 (최신위치 + 트랙 버퍼)
- CacheBasedVesselTrackDataReader + CacheBasedTrackJobListener 신규 추가
- VesselStaticStepConfig: 정적정보 CDC 변경 검출 + hourly job 편승
- SignalKindCode enum: vesselType/extraInfo 기반 선종 자동 분류
- WebSocket/STOMP 전체 mmsi 전환 (StompTrackStreamingService ~40곳)
- 모니터링/성능 최적화 코드 mmsi 기반 전환
- DataSource 설정 통합 (snpdb 단일 DB)
- AreaBoundaryCache Polygon→Geometry 캐스트 수정 (MULTIPOLYGON 지원)
- ConcurrentHashMap 적용 (VesselTrackStepConfig 동시성 버그 수정)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 09:59:49 +09:00

1.6 KiB

/clarify - 요구사항 명확화

새로운 기능이나 버그 수정 요청 시 요구사항을 명확히 하기 위한 질문을 생성합니다.

사용 시점

  • 사용자 요청이 모호할 때
  • 여러 구현 방법이 가능할 때
  • 비즈니스 요구사항 확인이 필요할 때

질문 카테고리

1. 기능 범위

  • 이 기능의 정확한 범위는 무엇인가요?
  • 어떤 서비스/컴포넌트가 이 기능을 사용하나요?
  • 기존 기능과의 관계는 어떻게 되나요?

2. API 설계

  • REST API 엔드포인트 설계가 필요한가요?
  • 요청/응답 형식은 어떻게 되나요?
  • 기존 API 패턴을 따르나요?

3. 데이터

  • 어떤 데이터가 필요한가요?
  • 데이터 소스는 무엇인가요? (DB, 외부 API, 파일)
  • 데이터 영속성이 필요한가요?

4. 에러 처리

  • 예상되는 에러 케이스는 무엇인가요?
  • 에러 시 어떻게 처리해야 하나요? (재시도, 로깅, 알림)

5. 성능

  • 예상 데이터 양은 얼마나 되나요?
  • 배치 처리가 필요한가요?
  • 성능 요구사항이 있나요?

6. 배포/환경

  • 특정 환경(dev/qa/prod)에서만 동작해야 하나요?
  • 프로파일별 설정이 필요한가요?

출력 형식

## 요구사항 명확화 질문

### 기능 범위
1. [질문1]
2. [질문2]

### API 설계
1. [질문1]

### 데이터
1. [질문1]

...

---
답변을 바탕으로 구현 계획을 수립하겠습니다.

인자

$ARGUMENTS: 사용자의 요청 내용을 요약해서 입력

예: /clarify 선박 위치 배치 저장 기능