[FEAT] 상호작용 경고에 병용금기 사유(PROHBT_CONTENT) 노출

[heejeongJ]

작업 개요

기존 상호작용 응답은 병용금기 상대 성분만 노출해 "왜 위험한지"를 알 수 없었습니다. DUR 응답의 PROHBT_CONTENT(횡문근융해증·혈액학적 독성 등)를 함께 매핑·노출해 사용자 이해도를 높였습니다.

주요 변경 사항

1. InteractionRulePort 시그니처 변경

• lookupContraindicatedIngredients(name) 반환을 Set<String> → Map<String, String> (성분 → 사유)으로 변경
• lookupByMedicineName 시그니처는 유지

2. DurInteractionRuleAdapter 확장

• 응답에서 MIXTURE_INGR_KOR_NAME 와 PROHBT_CONTENT 를 페어로 추출 (LinkedHashMap 으로 입력 순서 보존)
• 같은 성분이 여러 사유로 등재된 경우 첫 사유 채택 (putIfAbsent)
• /info 의 interactionWarnings 포맷을 "성분(사유), ..." 로 강화하고, 사유가 비면 성분만 노출

3. InteractionEngine 경고 문구 강화

• 충돌 시 사유를 괄호로 부착: "메토잘정과(와) 이부프로펜는 병용금기입니다(혈액학적 독성). 함께 복용 전 의사·약사와 상담하세요."
• 사유가 비어 있으면 괄호 없이 기존 문구 유지
• 정규화·양방향 contains 매칭 로직은 그대로

4. 테스트 갱신

• DurInteractionRuleAdapterTest: /info 사유 포맷, 사유 없는 경우, 같은 성분 첫 사유 채택, 매핑 반환·예외 폴백
• InteractionEngineTest: 사유 부착·사유 비어 있을 때·정규화·component 폴백 케이스
• :api:test · :app:compileJava 통과

라이브 검증

실제 DUR 키로 end-to-end 확인.

• 조회: 이부프로펜 → 매핑 메토트렉세이트 → 혈액학적 독성
• 엔진: 기존약 메토잘정(component=메토트렉세이트) + 새 약 이부프로펜 → "메토잘정과(와) 이부프로펜는 병용금기입니다(혈액학적 독성). 함께 복용 전 의사·약사와 상담하세요."

고민사항

1. 포트 시그니처 교체 vs 새 메서드 추가

기존 Set<String> 을 유지하고 사유 조회용 메서드를 별도로 두는 안도 가능했지만, 단일 구현(DurInteractionRuleAdapter)·단일 호출자(InteractionEngine)라 호환성 위험이 작고 시그니처를 한 번에 교체하는 편이 인터페이스를 깔끔히 유지한다고 판단했습니다.

2. 같은 성분에 여러 사유가 있을 때

DUR 응답에는 같은 상대 성분이 다른 사유로 여러 번 등재되는 경우가 있습니다. 결정적 동작을 위해 첫 사유를 채택(putIfAbsent)했습니다. 만약 사유 누락이 문제가 되면 "사유1 / 사유2" 로 결합하는 방식으로 바꿀 여지가 있습니다.

3. 사유가 비어 있을 때의 출력

PROHBT_CONTENT 가 비어 있는 행도 일부 존재합니다. 이 경우 괄호 없이 성분명만 노출해 가독성을 유지했습니다.

4. /info 응답 포맷 — DTO 구조 vs 문자열 enrich

구조화된 응답으로 바꾸려면 DTO 변경과 클라이언트 영향이 발생합니다. 현재 클라이언트가 interactionWarnings 문자열을 그대로 렌더링하는 점을 고려해, DTO 는 그대로 두고 문자열에 사유를 함께 담는 방식을 택했습니다.

5. 사유 텍스트 가공 여부

PROHBT_CONTENT 는 짧은 의학 용어 한두 단어(횡문근융해증·혈액학적 독성 등)로 들어와 그대로 노출해도 자연스럽습니다. 별도 가공·축약 없이 원문 사유를 그대로 사용했습니다.

호환성 / 영향 범위

• /v2/check 경고 문구가 사유 포함 형태로 길어집니다. 요청·응답 스키마는 동일합니다.
• /v2/info 의 interactionWarnings 문자열 포맷이 "성분(사유), ..." 로 바뀝니다. 사유 없을 때는 기존과 동일하게 성분명만 노출됩니다.
• 포트 메서드 반환 타입이 변경됐지만 구현체·호출자가 모두 코드베이스 내라 외부 영향은 없습니다.

연관 이슈

Closes #76