가이드 source_url 추가 + 헌재·PIPC 원문 deep-link 수정

코드:
- GuideChunk에 source_url 필드 추가
- guides.sqlite 스키마/INSERT/SELECT에 source_url 반영
- retriever: 가이드 카드 metadata.url에 source_url 주입
- retriever 헌재 deep-link: /LSW/detcInfoP.do?detcSeq={ID}&mode=0
(기존: SDK detail_url이 OPEN API endpoint라 localhost 상대경로로 깨짐)
- retriever PIPC deep-link: /LSW/ppcInfoP.do?ppcSeq={ID}&mode=8
(기존: 봇 차단 우려로 url 빈 값 — 실제 ID로 200 응답 검증 완료)

데이터:
- guides.sqlite: source_url 컬럼 추가, 4개 가이드 PIPC 게시판 직링크 부여 (457건)
- cases.sqlite: detail_url 현행 camelCase 포맷(?nttId=…&nttNo=…)으로 일관화
- guide/chunks/*.jsonl: source_url 필드 4개 jsonl 모두 추가

data/guides.sqlite

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6ef7969e411190926e1b9069aa9208abc01d993be83b2657da37def0382f23da
-size 4505600
+oid sha256:28eb30381d62f57a2fef36c91ad24ced518bae84da78e0689158da2d32892157
+size 4562944

data/guides_meta.json

@@ -23,6 +23,6 @@
     "source_pdf": "소상공인을 위한 개인정보 보호 핸드북(2024.12).pdf",
     "chunks_count": 41
   },
-  "_built_at": "2026-05-06 01:09:21",
+  "_built_at": "2026-05-06 15:24:29",
   "_total_chunks": 457
 }

src/kpaa/guides/index.py

@@ -26,7 +26,8 @@ CREATE TABLE IF NOT EXISTS guides (
     body           TEXT,
     pages          TEXT,
     source_pdf     TEXT,
-    chunk_context  TEXT
+    chunk_context  TEXT,
+    source_url     TEXT DEFAULT ''
 );
 
 CREATE VIRTUAL TABLE IF NOT EXISTS guides_fts USING fts5(
@@ -99,12 +100,13 @@ def build_index(chunks: Iterable[GuideChunk], *, db_path: Path) -> None:
                 conn.execute(
                     """INSERT INTO guides
                        (chunk_id, doc_id, doc_title, doc_date,
-                        section, chunk_no, body, pages, source_pdf, chunk_context)
-                       VALUES (?,?,?,?,?,?,?,?,?,?)""",
+                        section, chunk_no, body, pages, source_pdf, chunk_context,
+                        source_url)
+                       VALUES (?,?,?,?,?,?,?,?,?,?,?)""",
                     (
                         c.chunk_id, c.doc_id, c.doc_title, c.doc_date,
                         c.section, c.chunk_no, c.body, c.pages, c.source_pdf,
-                        c.chunk_context,
+                        c.chunk_context, c.source_url,
                     ),
                 )
                 conn.execute(
@@ -154,6 +156,7 @@ def search(
             body=r["body"], pages=r["pages"] or "",
             source_pdf=r["source_pdf"],
             chunk_context=(r["chunk_context"] if "chunk_context" in r.keys() else "") or "",
+            source_url=(r["source_url"] if "source_url" in r.keys() else "") or "",
         )
         for r in rows
     ]
@@ -188,6 +191,7 @@ def get_chunks(
             body=r["body"], pages=r["pages"] or "",
             source_pdf=r["source_pdf"],
             chunk_context=(r["chunk_context"] if "chunk_context" in r.keys() else "") or "",
+            source_url=(r["source_url"] if "source_url" in r.keys() else "") or "",
         )
         for r in rows
     }
@@ -223,6 +227,7 @@ def list_all_chunks(*, db_path: Path | None = None) -> list[GuideChunk]:
             body=r["body"], pages=r["pages"] or "",
             source_pdf=r["source_pdf"],
             chunk_context=(r["chunk_context"] if "chunk_context" in r.keys() else "") or "",
+            source_url=(r["source_url"] if "source_url" in r.keys() else "") or "",
         )
         for r in rows
     ]

src/kpaa/guides/models.py

@@ -22,6 +22,7 @@ class GuideChunk(BaseModel):
     pages: str = ""      # 원본 PDF 페이지 범위 (예: "p.8" 또는 "p.8-9")
     source_pdf: str      # 원본 PDF 파일명
     chunk_context: str = ""  # Anthropic Contextual Retrieval prefix — 인덱싱 시 body 앞에 prepend (답변 출력은 body만)
+    source_url: str = ""  # 원본 가이드 게시물 URL (PIPC 자료실 bbsView.do 직링크) — UI "원문 가이드 열기" 버튼용
 
     def citation(self) -> str:
         """답변에 박을 인용 태그.

src/kpaa/retrieval/retriever.py

@@ -412,7 +412,7 @@ async def _fetch_guides(
                     "doc_title": h.doc_title,
                     "pages": h.pages,
                     "source_pdf": h.source_pdf,
-                    "url": "",
+                    "url": h.source_url or "",
                 },
                 sort_priority=1,  # case(0) < guide(1) < law(1) < pipc(2)...
                 recency_score=_recency_score(year),
@@ -565,10 +565,13 @@ async def _fetch_pipc(
                         "decision_no": body.decision_no,
                         "decision_date": body.decision_date,
                         "agency": body.agency,
-                        # 법제처 사람용 페이지(`/LSW/ppcInfoP.do?ppcSeq=...&mode=8`)
-                        # 가 *간헐적 봇 차단* 페이지를 반환하는 사례가 있어 url 부착
-                        # 보류. 안정 URL 확인 후 채울 예정.
-                        "url": "",
+                        # 법제처 사람용 결정문 페이지 deep-link.
+                        # 패턴: /LSW/ppcInfoP.do?ppcSeq={ID}&mode=8
+                        "url": (
+                            f"https://www.law.go.kr/LSW/ppcInfoP.do?ppcSeq={body.decision_id}&mode=8"
+                            if body.decision_id
+                            else ""
+                        ),
                         **_fallback_meta(used_kw, queue),
                     },
                     sort_priority=2,
@@ -1140,8 +1143,14 @@ async def _fetch_constitutional(
                         "decision_date": body.decision_date,
                         "petitioner": body.petitioner,
                         "respondent": body.respondent,
-                        "url": hit.detail_url
-                        or f"https://www.law.go.kr/detcInfoP.do?detcSeq={body.decision_id}",
+                        # SDK의 hit.detail_url은 OPEN API endpoint(/DRF/lawService.do?...)
+                        # 라 브라우저용이 아니므로 사용 X. 공개 deep-link 사용.
+                        # 패턴: /LSW/detcInfoP.do?detcSeq={ID}&mode=0
+                        "url": (
+                            f"https://www.law.go.kr/LSW/detcInfoP.do?detcSeq={body.decision_id}&mode=0"
+                            if body.decision_id
+                            else ""
+                        ),
                         **_fallback_meta(used_kw, queue),
                     },
                     sort_priority=3,   # 판례·해석례 사이 (4=판례, 3=해석례)