건설도면프로젝트
학습 지도
「P101이 표시된 최신 개정 도면과 원문 위치를 찾는다」 — 이 한 문장을 만족하는 시스템을, 검색·검증·관계·이벤트 4개 레이어로 실증한 프로젝트의 학습자료. 모든 수치·판정은 로컬 하이브리드 환경 실측(보고서 05·06·07)이다.
무엇을 푸는가, 전체는 어떻게 흐르는가
답은 반드시 원문 근거(문서·페이지·bbox)와 함께 제시한다. 모르면 「모름」으로 보고한다 — 추측을 만들지 않는 것이 첫 원칙이다.
단원 1 · 문제의 실체
설비 태그(P101·V201·PUMP-01)가 수백 장 도면에 흩어져 있고 개정(A→B→C)이 쌓인다. 「최신 개정이 무엇인가」가 사람 기억과 엑셀에 의존 → 질의 응답 시스템으로 바꾼다.
왜 어려운가 — 3가지 간극
① 검색 유사도는 사실 판단이 아니다 — 선이 실제로 연결됐는지는 점수가 증명하지 않는다.
② LLM 출력은 형식이 통과해도 환각일 수 있다 — 근거 대조가 필수다.
③ 도면은 이미지·PDF·CAD 형식이 뒤섞인다 — 경로마다 추출 품질이 다르다.
단원 2 · 종단 파이프라인 14단계 (위→아래로 데이터가 흐른다)
검색 — 키워드와 의미를 섞는다
「P101」처럼 정확한 태그는 BM25가, 「최신 개정」같은 표현 변화는 벡터가 잡는다. 둘을 한 질의에 넣고 점수를 정규화 파이프라인으로 결합한다.
BM25 (어휘)
토큰 일치 기반 랭킹. 태그 exact 질의에 최강. 한국어는 seunjeon 분석기.
에뮬 도메인에서도 동작 — 관리형 호환성 기준.
벡터 k-NN (의미)
bge-m3 1024차 임베딩 → lucene 엔진 근사 검색. ARM64에서 nmslib은 세그폴트(실측) → lucene 필수.
하이브리드 (결합)
두 점수를 normalization processor가 가중치 결합. 키 phase_results_processors(복수형!) — 단수형은 오류(실측).
실측 — 임베딩 모델 비교와 결합 손해 사례 (T12·T13)
읽을 거리 — 공식 학습자료
공식 문서OpenSearch 하이브리드 검색 개요docs.opensearch.org/latest/vector-search/ai-search/hybrid-search/index 공식 문서시맨틱·하이브리드 공식 튜토리얼(단계별)docs.opensearch.org/latest/tutorials/vector-search/neural-search-tutorial/ 공식 영상OpenSearch Project 공식 채널 — 벡터 DB·ML·AI 재생목록youtube.com/c/OpenSearchProject검증 — 형식 통과는 사실성이 아니다
LLM이 고른 답을 그대로 믿지 않는다. ①앱의 응답 검증 ②독립 검증기의 근거 대조 ③관계 제약 검사 — 3중 게이트를 통과한 것만 게시된다.
Gate 1 · LLM 선별 (17.5절)
응답 계약: candidate_id·decision·reason. 앱이 검사 — 입력 ID 집합=출력 ID 집합, 허용값(accept/reject/needs_review), 재시도 제한.
결함 4종(타임아웃·잘린 JSON·허용값 밖·ID 불일치) 전부 needs_review 보류 실증.
Gate 2 · kev-9b 근거검증
주장↔원문을 독립 모델이 3-way 판정:
supportedcontradictedinsufficient_evidence
게시 조건 = supported 그리고 confidence≥0.5. 저신뢰는 보류(0.416 사례 실측).
Gate 3 · T24 제약 검사
관계 후보의 형식·무결성 코드 검사. validation_status(기계)와 review_status(사람)는 분리 저장 — 통과해도 업무 승인 칸은 비워둔다(21.24.4).
T24 오류 코드 전체 (코드에서 직접 추출)
판정: E 있으면 fail · H201만 hold · 아니면 pass — v1 13/13 + v2 4/4 실증. 후보 수정은 candidate_hash 불일치로 감지→재검사(18.2절).
근거 검증의 원칙 — 편향 방지
관계·탐색·실적 질의
도면에서 읽은 관계(관측)만 게시하고, 유도한 관계(파생)는 규칙 버전과 함께 별도 표시한다. 다단계 질의는 그래프 제품 없이 앱 BFS로 — 요구 발생 시 재검토.
관계 4종
shown_insupersedespart_ofconnected_to
허용쌍 사전(allowed_pairs)·방향(대칭/순방향) 검사 후 게시.
도달 ≠ 영향
V201 차단 시 도달 {P101, P110, V202} vs 영향 {P110, V202} — 영향은 flow_direction이 정의된 관계만 순방향 전파(미정의=보류). 파생은 DERIV-*+규칙 버전, 전제 무효화 시 제거.
T26 실적 질의 — 3층 방어 (12/12 실증)
1층 · 템플릿 사전
승인된 SQL 틀만 실행 — 사전 밖 질의 거부, SELECT 검사. 변조 템플릿 차단 실증.
2층 · 값 검증
enum·regex 화이트리스트 + 이스케이프. 파라미터는 '$2' 위치 치환 — 주입 4종 차단.
3층 · 제한 역할
sd_query 계정: SELECT 전용·읽기전용 세션·statement_timeout 3s — 직접 INSERT·pg_sleep(6s) 전부 차단.
변경·이벤트·판 관리 (T27)
도면이 바뀌면 시스템은 어떻게 따라가는가 — 이벤트 계약 하나로: 멱등 원장, 시효 판정, 게이트 재적용, 새 판 원자 전환. 실패는 언제나 보류(reject 아님, 17.5.4).
소비자 6단계 처리 순서
실패 경로 9/9 — 시험이 잡은 결함까지 기록
· LLM 결함 4종 → needs_review 보류
· kev 정지 상태에서도 파이프라인 완주(생략 기록)
· BLOCKED 종단 — 원장 blocked+사유
· T24 통과 후 후보 수정 → candidate_hash 불일치 → 재검사 E109
· 시험이 소비자 네트워크-예외 크래시 발견→수정(보류 처리로 전환)
환경·운영 — 무엇이 진짜였고 무엇이 남았는가
AWS 에뮬레이터(진짜 동작하는 서비스) + 로컬 실엔진(불가 항목 대체)의 하이브리드로 전 과정을 실증했다. 색은 판정: 청록=가능·실증 파랑=강조/진행 주황=보류·불가.
에뮬에서 진짜 동작
S3(sha256·버전·SSE) · SQS·EventBridge · Lambda 실핸들러 · KMS·Secrets · IAM 정책 강제 · Athena·Glue·DMS.
부분 지원(제한)
OpenSearch Service — BM25·별칭·정책만(kNN DSL·fgac 미지원) · RDS — 기본 SQL만 · Textract — bbox만(텍스트 스텁).
에뮬 불가→로컬 대체 실증
Bedrock 스텁→Ollama·vLLM·kev · Neptune→앱 BFS · AOSS→로컬 OpenSearch 2.13. fgac는 실환경 과제(P-03).
운영 수치(실측)와 백업·롤백
남은 과제 — 전부 사람·자원 영역 (기술 과제 0)
실도면 샘플
요청서 A(7항목: PDF·스캔·CAD·개정세트·동명태그·기하 포함) 수령 → D-3 파서 설계 트리거.
실서비스 구성 응답
질의서 B 10문항(OS 버전·fgac·모델 경로·실적 DB·부하) → D-1 v0.2 확정.
합의 3종
C-1 업무 정의·수용 기준 / C-2 식별자 규칙 / C-3 검수 체계→G0 통과.
공인 학습자료 — 환경·운영 영역
공식 문서AWS Lambda 소개docs.aws.amazon.com/lambda/latest/dg/welcome.html 공식 문서Amazon EventBridge 소개docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html 공식 문서Tesseract OCR 공식 문서(tessdoc) — 흰목록·품질 한계github.com/tesseract-ocr/tessdoc공인 학습자료 총람과 역할별 경로
기준: 공식 문서·공인 기관·공식 채널 우선. 다운로드본은 학습자료/downloads/에 자료별 폴더로 격리 보관한다(신뢰 불가 데이터 취급). 전체 목록은 18번 문서.
주제별 핵심 링크
공인 PDF · 저장NIST AI 600-1 — 생성 AI 리스크(환각·그라운딩)nvlpubs.nist.gov/nistpubs/ai/NIST.AI.600-1.pdf 공인 PDF · 저장NIST AI 100-1 — AI 리스크 관리 프레임워크 1.0nvlpubs.nist.gov/nistpubs/ai/NIST.AI.100-1.pdf 공인 PDF · 저장PostgreSQL 18 전체 매뉴얼postgresql.org/files/documentation/pdf/18/postgresql-18-A4.pdf 공인(학회) · URL 열람AIChE "Art of the P&ID" 94쪽 — 다운로드는 접근 거부(브라우저 열람)aiche.org/…/artofthepid-aiche-rbt11-15-19.pdf 공식 문서OpenSearch 하이브리드 검색docs.opensearch.org/latest/vector-search/ai-search/hybrid-search/index 공식 문서+영상Amazon OpenSearch Service k-NN(문서 내 영상 포함)docs.aws.amazon.com/opensearch-service/latest/developerguide/knn.html 공식 영상OpenSearch Project 공식 채널youtube.com/c/OpenSearchProject 공식 영상AWS 공식 채널youtube.com/user/AmazonWebServices 공식 문서Tesseract OCR tessdocgithub.com/tesseract-ocr/tessdoc다운로드 보관 현황 (판정 기준: HTTP 200 + %PDF- + 100KB 초과)
| 폴더 | 파일 | 크기 | 판정 |
|---|---|---|---|
| 학습자료/downloads/01-nist-ai-600-1/ | NIST.AI.600-1.pdf | 1,174,643B | 성공 |
| 학습자료/downloads/02-nist-ai-100-1/ | NIST.AI.100-1.pdf | 1,946,127B | 성공 |
| 학습자료/downloads/04-postgresql-18-a4/ | postgresql-18-A4.pdf | 15,944,094B | 성공 |
| (시도) 03-aiche-art-of-pid/ | artofthepid-aiche.pdf | 17B | 실패 — Permission denied · URL 열람으로 대체 |
역할별 학습 경로 (18번 §4 요약)
| 역할 | 먼저 | 이어서 |
|---|---|---|
| 전체 이해(신규) | 본 지도 9페이지 → 18번 §1 | 15 용어집 → 07 충족도 |
| 검색 담당 | OpenSearch 하이브리드 튜토리얼 | 06 §1·§8(T13 가중치) |
| 검증·AI 담당 | NIST AI 600-1 환각·그라운딩 장 | 06 §3(kev)·§6(실패 경로) |
| 데이터·도메인 | AIChE P&ID 자료 | t24-baseline.json 기준판 구조 |
| 인프라·운영 | AWS·PG 공식 문서 | 12 D-1 전환 설계·OSB 수치 |
발행 목차 — 전체 문서·도식·자료 연계
모든 문서는 양식 템플릿(17번)을 준수하는 문서 뷰어 HTML(output/html/)로 변환되어 있다 — 표를 클릭하면 열린다.
원본 markdown·drawio는 output/ 폴더에 그대로 보존되며, 변환기(output/html/md2html.py)는 상호참조 링크를 자동으로 html 경로로 재작성한다.
전체 문서 목차 (클릭 = 문서 뷰어)
| 구분 | SEQ · 제목 | 보기 |
|---|---|---|
| 규칙 | 00 문서작성규칙 — SEQ 체계·판정 기준 | html/00_문서작성규칙.html |
| 설계 | 01 업무태스크 실행계획 (T01~T28·게이트) | 01_업무태스크_실행계획 |
| 02 업무적응 상세가이드 (12절 흐름·17~21절) | 02_업무적응_상세가이드 | |
| 03 OpenSearch 문제별 해결범위 분석 | 03_해결범위_분석 | |
| 04 보완기술 구현방안 (S01~S10) | 04_보완기술_구현방안 | |
| 실증 | 05 AWS 에뮬레이터 시나리오검증 (1차) | 05_에뮬레이터_시나리오검증 |
| 06 로컬보완환경 구성 및 검증 (2차·§1~9) | 06_로컬보완환경_구성및검증 | |
| 07 시나리오 충족도 종합판정 (3차) | 07_시나리오충족도_종합판정 | |
| 전환·요청 | 11 잔여 문제 설계 필요성 검토 (P-01~10·D-1~3) | 11_잔여문제_설계필요성검토 |
| 12 실환경 전환 아키텍처 설계 (D-1 v0.1) | 12_실환경전환_아키텍처설계 | |
| 13 외부 요청 패키지 (A·B·C 발송 초안) | 13_외부요청패키지 | |
| 23 유튜브 전사 파이프라인 체크리스트 (초기 실측 판정) | 23_파이프라인체크리스트 | |
| 24 MCP팀 요청서 (유튜브 전사 MCP·AI Ready 블로그 게시 MCP) | 24_MCP팀_요청서 | |
| 25 MCP팀 외부연동 가이드 (수신 원문 — stable-261117) | 25_외부연동_가이드 | |
| 26 가이드 수용·연동 준비 판정 (E2E 조건부 가능·파일럿 계획) | 26_수용및연동준비 | |
| 28 유튜브 전사 파일럿 3편 학습자료 (OpenSearchCon 발화·발췌 인용) | 28_전사_파일럿3편 | |
| 29 채널 전체 711편 링크페이지 (원문 영상 링크 보존·검색 필터·전사 상태) | 29_전체_링크페이지 | |
| 학습·참조 | 15 기술용어집 (MD 원본 판) | 15_기술용어집(문서 뷰어) · 16 인터랙티브 판(검색 필터) |
| 17 양식 템플릿 (본 지도의 규격서) | 17_양식템플릿 | |
| 18 학습자료 (7단원+공인 URL 목록) | 18_학습자료 | |
| 19 본 학습 지도 (A2 모션 9페이지) | 맨 위로 | |
| 21 하이브리드 검색 학습자료 (공식 문서 14편 분석·A2 모션 9시트) | 21_하이브리드검색_학습자료 | |
| 22 시맨틱·하이브리드 튜토리얼 학습자료 (공식 실습 전문·3방식 순위 대조) | 22_튜토리얼_학습자료 | |
| 환경·운영 | 08 에뮬레이터 환경 README | 08_README |
| 09 타 세션 연동 가이드 | 09_INTEGRATION | |
| 10 로컬 하이브리드 운영 README (스크립트 표·함정) | 10_README | |
| 20 AI 서포트 데이터엔지니어링 구성환경 (표준 골격←실물 사상·상태 3값) | 20_구성환경 |
아키텍처 도식 — drawio 인라인 뷰어 (클릭하면 브라우저에서 바로 렌더링)
drawio 뷰어 · 6시트14 전체 아키텍처 — 에뮬 가능/부분/불가 색 구분 (개요·적재·질의·T27·모델·매트릭스)html/viewer_14_전체아키텍처.html · 원본: output/14_KIKUM_건설도면_전체아키텍처_에뮬레이터구분_20261116.drawio (편집은 draw.io 앱) drawio 뷰어 · 5탭구버전 전체 시스템 아키텍처·데이터 흐름 (구성요소·데이터 준비·온라인 질의·변경 게시·태스크 맵)html/viewer_구_전체시스템.html · 원본: output/KIKUM_건설도면_전체시스템_아키텍처_데이터흐름_20261113.drawio구버전 도식은 PNG 미리보기도 준비되어 있다(브라우저 바로 열림): 01 구성요소 · 02 데이터 준비·승인 · 03 온라인 질의 · 04 변경·게시·복구 · 05 태스크 맵
다운로드 자료 바로가기
PDF · 1.2MBNIST AI 600-1 생성 AI 프로파일학습자료/downloads/01-nist-ai-600-1/NIST.AI.600-1.pdf PDF · 1.9MBNIST AI 100-1 AI 리스크 관리 프레임워크학습자료/downloads/02-nist-ai-100-1/NIST.AI.100-1.pdf PDF · 15.9MBPostgreSQL 18 전체 매뉴얼학습자료/downloads/04-postgresql-18-a4/postgresql-18-A4.pdfoutput/html/publish.sh 실행 한 번으로 전체(문서+뷰어) 갱신된다 ④ 게시용 복사본을 만들 때는 output/ 폴더 전체(링크 상대경로 유지)를 그대로 옮긴다.