ax_hub_mcp_tool/.agents/AGENTS.md

AX HUB 프로젝트 개발 규칙 (AGENTS.md)

이 파일은 AI Agent(Antigravity)가 이 프로젝트에서 작업할 때 항상 명심하고 지켜야 할 규칙을 정의하는 파일입니다. 작업 시 유의해야 할 사항이 생기면 언제든지 이 아래에 자유롭게 내용을 추가해 주세요!

개발 가이드라인

• 패키지명은 controller 대신 presentation을 사용합니다.
• MapStruct 사용 시, 테스트 환경 에러를 방지하기 위해 생성자(new ...Impl()) 대신 Mappers.getMapper(인터페이스명.class) 방식으로 인스턴스를 가져옵니다.

명심해야 할 규칙 추가란

• 이모지는 무조건 넣지 않는다

• import 할것 무조건 한다

• Git commit과 push는 사용자의 명시적인 허락(지시) 없이는 절대 수행하지 않는다.

• 자바 만들때는 무조건 아래 내용을 넣는다 /**

• @package io.shinhanlife.axhub.biz.mcp.tool.sms

• @className AxHubToolSmsApplication

• @description AX HUB 시스템 처리 클래스

• @author 김형식

• @create 2026.09.01

• ---------- 개정이력 ----------

• 수정일 수정자 수정내용

• ---

• 2026.09.01 김형식 최초생성

• */

• 신한라이프 인터페이스 통신 프로토콜 및 메시지 포맷 가이드 (준버티컬 Tool 대상):

  • 현재 개발 대상은 대내MCI / EAI (JSON) 연동으로 한정한다. (대외MCI FixedLength 연동은 범위에서 제외)
  • 통신 노선, 데이터 변환 규격, 시스템별 연계 방식 등은 MCI/EIMS 상에서 관리되므로 코드 레벨에서 식별하거나 분기 처리하지 않는다. (단순 통합 JSON 요청만 수행)
  • 처리계 UI ↔ 처리계 AP 구간: HTTPS / SSV를 사용하며, FW에서 x-api를 통해 SSV↔DTO 변환을 수행한다.

• 신한라이프 표준 로그 기준 (Logback 설정):

  • 로그 생성 경로: /swlog/어플리케이션명(모듈명)/코드명/ (예: /swlog/dap-gateway/A01/)
  • 로그 네이밍 규칙: ${HOSTNAME}_코드명_yyyyMMdd.log (예: ${HOSTNAME}_A01_20260722.log)
  • 기본 로그 구분 코드: 시스템 운영기록 가동기록의 경우 A01을 기본으로 사용한다.
  • 호스트명 동적 할당: Logback 설정 시 <property name="HOSTNAME" value="${HOSTNAME}" /> 를 선언하여 사용한다.