fix: 사례 URL을 camelCase(nttNo/nttId)로 교정 — 사례 카드 '원문 페이지 열기' 활성화

privacy.go.kr/front/case/view.do GET endpoint은 camelCase 파라미터(nttNo, nttId)만 인식. snake_case(ntt_id, nttno)는 default 사례로 폴백되어 모든 사례 링크가 동일한 잘못된 페이지로 이동하던 문제 수정.

- data/cases.sqlite: 1,745건 detail_url snake_case → camelCase
- src/kpaa/retrieval/retriever.py: case Excerpt metadata에 absolute_url() 채움 (이전엔 빈 문자열)
- src/kpaa/cases/scraper.py: API URL_ADDR 무시하고 camelCase로 직접 구성 (재스크래이프 시 회귀 방지)
- src/kpaa/cases/models.py: detail_url 필드 주석 업데이트

효과: 참고한 자료 패널에서 사례 카드 하단에 법조문과 동일한 '원문 페이지 열기 ↗' 링크 노출.

data/cases.sqlite

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:a84162716f015395c4aa07d962d4e5441095840e2a7c19e07eff77a2822123aa
-size 14213120
+oid sha256:63232b3922ec028677debdaf5588869ad077ed8560ad7af74d81294d3c4a59ee
+size 14217216

src/kpaa/cases/models.py

@@ -25,7 +25,7 @@ class Case(BaseModel):
     reg_dt: str          # YYYYMMDD
     case_year: str       # YYYY
     source_note: str     # ETC_CN
-    detail_url: str      # /front/case/view.do?ntt_id=...&nttno=...
+    detail_url: str      # /front/case/view.do?nttNo=...&nttId=... (camelCase 필수, snake_case는 default로 폴백)
     chunk_context: str = ""  # Anthropic Contextual Retrieval prefix — 인덱싱 시 body 앞에 prepend (답변 출력은 body만)
 
     def citation(self) -> str:

src/kpaa/cases/scraper.py

@@ -72,9 +72,17 @@ def _to_case(doc: dict[str, Any]) -> Case | None:
     body_raw = doc.get("NTT_CN_FULL") or doc.get("NTT_CN") or ""
     if not body_raw:
         return None
+    ntt_no = str(doc.get("NTT_NO") or "").strip()
+    ntt_id = str(doc.get("NTT_ID") or "").strip()
+    # API의 URL_ADDR 필드는 snake_case(ntt_id, nttno)를 주는데
+    # 서버 view.do는 camelCase(nttId, nttNo)만 인식한다 (snake_case는 default 페이지로 폴백).
+    # 직접 camelCase로 구성한다.
+    detail_url = (
+        f"/front/case/view.do?nttNo={ntt_no}&nttId={ntt_id}" if ntt_id and ntt_no else ""
+    )
     return Case(
-        ntt_no=str(doc.get("NTT_NO") or "").strip(),
-        ntt_id=str(doc.get("NTT_ID") or "").strip(),
+        ntt_no=ntt_no,
+        ntt_id=ntt_id,
         title=str(doc.get("NTT_SJ") or "").strip(),
         summary=_decode_body(str(doc.get("NTT_CN") or "")),
         body=_decode_body(str(body_raw)),
@@ -86,7 +94,7 @@ def _to_case(doc: dict[str, Any]) -> Case | None:
         reg_dt=str(doc.get("REG_DT") or "").strip(),
         case_year=str(doc.get("CASE_YEAR") or "").strip(),
         source_note=str(doc.get("ETC_CN") or "").strip(),
-        detail_url=str(doc.get("URL_ADDR") or "").strip(),
+        detail_url=detail_url,
     )
 
 

src/kpaa/retrieval/retriever.py

@@ -106,15 +106,11 @@ _PREC_BODY_LIMIT = 8000
 
 
 def _related_laws_excerpts() -> list[Excerpt]:
-    """data/related_laws.yaml 의 정적 리스트를 Excerpt로 변환.
+    """data/related_laws.jsonl 의 portal_corpus 라인을 Excerpt 로 변환.
 
     `관련_법령` intent 매칭 시 retriever가 라이브 검색 대신 이 리스트를 그대로
     컨텍스트에 박는다. 본 챗봇 scope는 개인정보보호법이지만, 사용자에게 *관련
     법령의 존재*를 안내해 적절한 곳에서 추가 확인하도록 돕는 용도.
-
-    yaml 두 형식 모두 지원:
-    - 레거시 list (수동 작성): name/short/description/url
-    - 신규 dict (자동 갱신, privacy.go.kr 스크래이프): items/[name/kind/kind_label/url/source]
     """
     from kpaa.related_laws import load_items
 
@@ -324,10 +320,10 @@ async def _fetch_cases(
                     "year": h.case_year,
                     "type": h.type_label,
                     "source_note": h.source_note,
-                    # privacy.go.kr의 view.do GET은 SPA 동작이라 ntt_id/nttno
-                    # deep-link를 무시하고 항상 동일 페이지를 반환(라이브 검증
-                    # 2026-04-29). 잘못된 사례로 이동하지 않게 url 제거.
-                    "url": "",
+                    # privacy.go.kr view.do GET은 camelCase 파라미터(nttNo, nttId)만
+                    # 인식 (snake_case는 default 사례로 폴백). detail_url이 camelCase
+                    # 포맷이면 absolute_url()이 정상 deep-link를 반환.
+                    "url": h.absolute_url() if h.detail_url else "",
                 },
                 sort_priority=0,
                 recency_score=_recency_score(_yyyy_mmdd_to_year(h.case_year or h.reg_dt)),
@@ -786,7 +782,7 @@ async def _fetch_admin_rules(
 def _seed_three_tier() -> tuple[str, str | None, str | None]:
     """본법 + 시행령 + 시행규칙 MST 묶음 lookup.
 
-    related_laws.yaml 에서 *개인정보 보호법* 패밀리만 골라낸다. KPAA 시점
+    related_laws.jsonl 에서 *개인정보 보호법* 패밀리만 골라낸다. KPAA 시점
     (2026-05) 개인정보보호법은 시행규칙이 없어 None 으로 떨어지는 게 정상.
 
     반환: (본법_mst, 시행령_mst | None, 시행규칙_mst | None)
@@ -799,7 +795,7 @@ def _seed_three_tier() -> tuple[str, str | None, str | None]:
 
         items = _rl.load_items()
     except Exception as e:
-        logger.warning("_seed_three_tier related_laws.yaml 로드 실패: %s", e)
+        logger.warning("_seed_three_tier related_laws.jsonl 로드 실패: %s", e)
         return primary_mst, None, None
     for it in items:
         name = str(it.get("name", ""))
@@ -932,7 +928,7 @@ def _primary_law_id_lock() -> asyncio.Lock:
 async def _resolve_primary_law_id(client: KoreanLawClient) -> str | None:
     """본법의 *법령ID* 를 lazy resolve. 실패 시 None.
 
-    KPAA 시점(2026-05) related_laws.yaml 에는 mst 만 저장되어 있어 lawId 는
+    KPAA 시점(2026-05) related_laws.jsonl 에는 mst 만 저장되어 있어 lawId 는
     별도 lookup 필요. get_text 응답의 LawText.law_id 에서 회수 후 캐시.
 
     Resolve 전략 (순서대로 시도):