[제안] 실행환경 in-app Boot 스타터 도입 방향 (관측/AI 횡단관심사·RTE 코어 자동구성)

[dasomel]

제안 배경

표준프레임워크 5.0이 Spring Boot 3.5 기반으로 전환되면서 org.egovframe.boot:egovframe-boot-starter-parent가 BOM/parent 역할을 하고, egovframe-boot-starter-crypto / egovframe-boot-starter-security(및 -access) 같은 자동구성 스타터도 배포되고 있습니다. 다만 두 가지 공백이 있습니다.

1. RTE 실행환경 모듈을 앱에서 수동 배선해야 함 — 단일 Boot 템플릿(예: egovframe-boot-sample-java-config)을 보면 DataSource·MyBatis·IdGnr·Transaction·AOP/Trace 등을 @Configuration Java Config로 일일이 배선합니다. crypto/security 외에는 자동구성 스타터가 없어 보일러플레이트가 큽니다.
2. 횡단관심사(관측·AI 등) 표준 스타터 부재 — 로그-트레이스 상관관계, AI 연동 시의 공통 처리(예외/폴백, 프롬프트 외부화, 개인정보 마스킹 등)가 사업마다 제각각 구현됩니다.

제안

실행환경 차원에서 얇은 in-app Boot 스타터를 점진적으로 제공하는 방향을 제안하고, 우선순위가 높은 첫 후보를 구체화합니다.

• (1순위) egovframe-boot-starter-observability(가칭) — 로그-트레이스 상관관계(traceId/spanId) 표시, service.name 리소스 속성, 기본 샘플링 등 sane default를 micrometer-tracing-bridge-otel 기반으로 자동구성. 앱은 의존성만 추가하면 표준 로깅을 얻습니다.
  • 패턴 시연: egovframe-template-simple-backend에 무침투 상관관계 표시를 먼저 적용했습니다 — [feat] 로그에 트레이스 상관관계(traceId/spanId) 표시 egovframe-template-simple-backend#140
  • 배포단 관측 표준 논의: [제안] 애플리케이션 로그-트레이스 상관관계(traceId/spanId) 표준화 및 단일 앱 레퍼런스 egovframe-operating-environment-msa#7
• (후속) AI 횡단관심사 스타터 — Spring AI 위에 추적로깅·예외/폴백·개인정보 마스킹 등 공통 처리. 관련 RFC는 [제안] 공급사 비종속 LLM 연동 표준 추상화 계층 도입 논의 egovframe-ai-rag#21 에서 별도로 논의 중입니다.
• (후속) RTE 코어 자동구성 — 수동 @Configuration 배선을 줄이는 코어 모듈 스타터.

먼저 확인하고 싶은 점 (게이팅)

1. 스타터 소스 기여 경로 — 현재 org.egovframe.boot:egovframe-boot-starter-*는 아티팩트(JAR)로는 배포되나, 빌드 소스가 공개 조직 리포에 보이지 않습니다. 외부 기여가 가능하도록 스타터 빌드 소스의 공개 리포/기여 경로가 있는지, 신규 스타터 모듈을 어디에 두는 것이 적합한지 안내를 구합니다.
2. 모듈 위치/구조 — 멀티 모듈 구조 개선 논의([발전 방안 제안(Improvement Plan)]: 멀티 모듈 구조의 장점 극대화 하기 #244)와도 맞물립니다. 신규 스타터를 egovframe-runtime 내 모듈로 둘지, 별도 스타터 리포로 둘지 방향을 구합니다.
3. 범위/중복 — 위 스타터 후보가 현재 진행 중인 다른 작업과 겹치는지 먼저 확인하고 싶습니다.

방향이 정해지기 전에는 스타터 코드 PR을 올리지 않고, 본 이슈에서 위치·범위를 먼저 합의한 뒤 진행하겠습니다. 우선은 위 #140처럼 템플릿/앱 수준의 작은 무침투 변경으로 패턴을 보여 드리는 데까지만 진행한 상태입니다.