feat #565: add vector knowledge ingestion demo

docs/design/558-vector-tag-vpd-search/README.md

@@ -1,6 +1,6 @@
 # 설계서: 기술 태그 기반 벡터 지식자료 검색과 VPD 연결
 
-> **상태**: 구현 초안
+> **상태**: 데모 흐름 구현
 > **추적성**: Redmine #565 · 기준 구현: `28_agent_ords_vector_tag_vpd_setup.sql`, `29_agent_ords_vector_search_ords.sql`
 
 ## 1. 한 문장으로 이해하기
@@ -147,6 +147,17 @@ backoffice의 `/objects` 화면은 이 객체에 일반 Handler를 생성하지
                                   → CB_VECTOR_DOCUMENT_TAG에 태그 저장
 ```
 
+백오피스의 `/vector-knowledge` 화면에서 이 흐름을 데모로 실행할 수 있다.
+
+- 문서 ID·제목·본문·기술 태그를 입력하면 문단/길이 기준으로 청크를 만든다.
+- `DEMO-4D`는 외부 API 없이 샘플 데이터와 같은 4차원 벡터를 만드는 재현 모드다.
+- `AI`를 선택하면 `BACKOFFICE_AI_BASE_URL/v1/embeddings`와
+  `BACKOFFICE_AI_EMBEDDING_MODEL`을 사용해 청크마다 실제 임베딩을 생성한다.
+- 같은 방식으로 검색어를 임베딩하고, 임시 토큰으로 전용 ORDS Handler를 호출한다.
+- VPD가 `TECH_TAG`를 먼저 필터링한 뒤 남은 청크만 벡터 거리순으로 반환한다.
+
+`DEMO-4D`는 의미 기반 품질을 보장하는 모델이 아니라 권한 흐름을 재현하기 위한 고정 차원 예제다. 운영 검색은 ingestion과 검색에 같은 임베딩 모델·차원을 사용해야 한다.
+
 ## 7. 운영 가이드라인
 
 - 태그는 자유 문장보다 대문자·언더스코어 형태의 안정적인 ID로 관리한다. 예: `SPRING_BOOT`, `ORACLE_VPD`, `INTERNAL_ONLY`.
@@ -166,7 +177,8 @@ backoffice의 `/objects` 화면은 이 객체에 일반 Handler를 생성하지
 - 검색 결과에 임베딩 원문이 포함되지 않는다.
 - `/permissions` 화면에서 `TAG` 규칙이 기본 `TECH_TAG`와 OR 의미를 일반 문장으로 설명한다.
 
-## 9. 범위 밖
+## 9. 아직 별도 운영 설계가 필요한 부분
 
-- 임베딩 모델 호출·문서 업로드 UI·태그 사전 승인 워크플로는 이번 시나리오에서 구현하지 않는다.
+- 대용량 파일 업로드, 비동기 작업 큐, 재시도·실패 격리, 임베딩 모델 버전별 재색인은 운영 파이프라인에서 별도로 설계한다.
+- 태그 사전 승인 워크플로와 문서별 소유자/보존기간 정책은 현재 데모 화면의 범위를 넘어선다.
 - 운영 DB에 대한 DDL, 기존 정책 교체, 방화벽/NSG 변경은 별도 승인을 받아 실행한다.