건설도면프로젝트 — 프로젝트 이해 학습자료 + 공인 학습자료 목록
| 항목 | 내용 |
|---|---|
| 작성일 | 2026년 11월 17일 |
| 프로젝트명 | 건설도면프로젝트 (내부 문서명 건설도면) |
| 목적 | 전체 문서(00~16)를 처음 접하는 사람용 학습자료로 재구성 — 시각화 판은 19 HTML 19_KIKUM_건설도면프로젝트_시각화학습자료_20261117.html(A2 모션, 17 양식 템플릿 준수) |
| 학습자료 기준 | 공인(공식) 자료 우선: 공식 문서·공식 기관·공식 채널. 벤더 블로그·개인 자료는 "보조"로 분리 표기. 다운로드본은 학습자료/downloads/(자료별 별도 폴더) |
1 프로젝트 이해 — 7단원 요약
단원 1. 무엇을 푸는가 (문제 정의)
- 첫 업무 질문: "P101이 표시된 최신 개정 도면과 원문 위치를 찾는다" — 펌프·밸브·배관 태그가 수백 장 도면에 흩어져 있고, 개정(A→B→C)이 쌓이며 "어느 게 최신인지"가 사람 기억에 의존하는 상황이 출발점이다.
- 원칙: 답은 반드시 원문 근거(문서·페이지·위치)와 함께 제시한다. 모르면 「모름」으로 보고한다(추측 금지).
- 핵심 산출물: 개체·문서·개정의 기준판(baseline), 검색 가능한 색인, 승인된 관계 판.
단원 2. 전체 흐름 (아키텍처 한 줄)
원본(S3) → 형식별 추출(PDF·OCR·CAD) → 임베딩(bge-m3) → 색인(v{N}) → 하이브리드 검색 → LLM 선별 → kev 근거검증 → T24 관계 검사 → 판 게시(별칭 원자 전환) → SQS 이벤트 → 소비자(멱등·시효) → 하류(탐색·실적 질의). 각 단계는 실패해도 reject가 아니라 보류(needs_review)로 흐른다.
단원 3. 검색 — BM25·벡터·하이브리드
- BM25(키워드)는 태그 exact 질의에 강하고, 벡터(의미)는 "최신 개정" 같은 표현 변화에 강하다. 두 방식을 한 질의에 섞고 점수를 정규화 파이프라인(
phase_results_processors)으로 결합한다. - 실측 교훈: 한국어 임베딩은 bge-m3(1024차) 5/5 vs nomic 3/5 — 모델 선택도 실험 대상. 결합이 항상 이득은 아니다(kNN 단독 5/5 > 하이브리드 4/5 사례) → 가중치 스윕 프로토콜.
- k-NN 엔진은 ARM64에서 lucene 필수(nmslib 세그폴트 실측).
단원 4. 검증 — LLM 선별·근거 검증·제약 검사
- LLM 선별: 응답을 JSON 계약(candidate_id·decision·reason)으로 받고 앱이 ID 대사·허용값·재시도 제한 검사(17.5절). 결함 4종 전부 needs_review 행 실증.
- kev-9b grounding: 주장↔원문을 3-way(supported/contradicted/insufficient_evidence) 판정, confidence<0.5는 보류. 검증기 입력에는 게이트 이력을 언급하지 않는다(편향 실측).
- T24: 관계 후보의 형식·참조·개정·근거·위치를 코드 검사(E101~E111, H201). 형식 통과와 사실성 승인(사람 review_status)은 분리.
단원 5. 관계·탐색·실적 질의
- 관계 4종(shown_in·supersedes·part_of·connected_to) + 방향·허용쌍 사전. 관측 관계만 게시(relations_pub), 파생은 DERIV-*+규칙 버전.
- T25 탐색: 앱 BFS — 종류·방향·깊이·권한(양끝 프로젝트)·순환 제한. 도달≠영향(flow_direction 규칙 별도).
- T26 실적 질의: 템플릿 사전+값 검증+제한 역할(sd_query, SELECT 전용·timeout 3s)의 3층 방어 12/12.
단원 6. 변경·이벤트·판 관리 (T27)
- 이벤트 계약:
{event_id, entity_id, source_version, operation, run_id, payload}. - 소비자 순서: ①멱등(원장) ②시효(stale 스킵) ③게이트 재적용 ④새 판 reindex ⑤별칭 원자 전환 ⑥하류 발행. 원장 상태 5종(applied/duplicate/stale/blocked/failed).
- 판 고정: 실행 시작 시점 인덱스로 조회 → 전환 중에도 일관된 응답. manifest 배치는 부분 실패 지속+재실행 스킵(7/7).
단원 7. 환경·운영 — 하이브리드 실증과 실환경 전환
- 로컬 하이브리드: AWS 에뮬레이터(S3/SQS 등 진짜 동작) + 로컬 엔진(OpenSearch 2.13·Ollama·vLLM·kev·PG18·Tesseract)으로 불가 항목을 대체 실증 — 14 drawio 색 구분 참조.
- 운영 수치: kNN p50 3.7ms·195ops@10k 문서·오류 0%. 백업=스냅샷+이전 판, 롤백=별칭 되돌림.
- 남은 과제는 자원·사람 영역(실도면 샘플·구성 응답·합의) — 11·13 문서 참조.
2 공인 학습자료 URL 목록
링크 점검 기록(2026-11-17): 전 URL 실접속 검증 완료. 조치 2건 — ① ISA-5.1 구매 페이지(404)를 공식 위원회 페이지로 교체 ② OpenSearch 튜토리얼·개요·k-NN 링크를 끝 슬래시(canonical)로 정규화 — 슬래시 없는 경로·.html 결합은 접속 시점에 따라 404 소프트 페이지(내용은 404, 상태는 200)를 돌려줄 수 있다. AIChE PDF는 링크 유효(200) — 다운로드만 봇 차단.
A. 도메인 — P&ID·건설도면 읽기
| 구분 | 자료 | URL |
|---|---|---|
| 공인(학회) | AIChE "Art of the P&ID" 94쪽 강의자료(PDF, 다운로드 실패 — 접근 거부, 브라우저 열람 필요) | https://www.aiche.org/sites/default/files/community/262801/aiche-community-site-event/514546/artofthepid-aiche-rbt11-15-19.pdf |
| 공인(표준) | ISA-5.1 계장 기호 표준 공식 위원회 페이지(표준 본문은 유료) | https://www.isa.org/standards-and-publications/isa-standards/isa-standards-committees/isa5-1 |
| 보조(비공인) | HardHat Engineer P&ID 기호집 PDF | https://hardhatengineer.com/wp-content/uploads/2017/09/PID-Symbols.pdf |
| 보조(비공인) | EdrawSoft P&ID 범례 PDF | https://www.edrawsoft.com/pid/images/pid-legend.pdf |
B. 검색·벡터 — OpenSearch/AWS 공식
| 구분 | 자료 | URL |
|---|---|---|
| 공식 문서 | 하이브리드 검색 개요 | https://docs.opensearch.org/latest/vector-search/ai-search/hybrid-search/index/ |
| 공식 문서 | 시맨틱·하이브리드 공식 튜토리얼 | https://docs.opensearch.org/latest/tutorials/vector-search/neural-search-tutorial/ |
| 공식 문서 | k-NN 근사 검색(인덱스·엔진) | https://docs.opensearch.org/latest/vector-search/vector-search-techniques/approximate-knn/ |
| 공식 문서+영상 | Amazon OpenSearch Service k-NN(문서 내 소개 영상 포함) | https://docs.aws.amazon.com/opensearch-service/latest/developerguide/knn.html |
| 공식 블로그 | 효과적인 하이브리드 검색 기법(2025-04) | https://opensearch.org/blog/building-effective-hybrid-search-in-opensearch-techniques-and-best-practices |
| 공식 채널(영상) | OpenSearch Project 공식 유튜브(벡터 DB·ML·AI 재생목록) | https://www.youtube.com/c/OpenSearchProject |
| 공식 채널(영상) | Amazon OpenSearch Service 공식 채널 | https://www.youtube.com/channel/UCjMd5zMUoMqaqBVBNzb9v8A |
| 공식 블로그 | AWS 빅데이터 블로그 — 하이브리드 검색 | https://aws.amazon.com/blogs/big-data/hybrid-search-with-amazon-opensearch-service/ |
C. AWS 서비스 — 공식 문서·채널
| 구분 | 자료 | URL |
|---|---|---|
| 공식 문서 | AWS Lambda 소개 | https://docs.aws.amazon.com/lambda/latest/dg/welcome.html |
| 공식 문서 | Amazon EventBridge 소개 | https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html |
| 공식 문서 | SQS·SNS·EventBridge 선택 가이드 | https://docs.aws.amazon.com/decision-guides/latest/decision-guides/sns-or-sqs-or-eventbridge.html |
| 공식 문서 | Lambda×SQS 통합 | https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html |
| 공식 문서 | S3 이벤트→EventBridge | https://docs.aws.amazon.com/AmazonS3/latest/userguide/EventBridge.html |
| 공식 채널(영상) | Amazon Web Services 공식 유튜브 | https://www.youtube.com/user/AmazonWebServices |
D. PostgreSQL — 공식
| 구분 | 자료 | URL |
|---|---|---|
| 공식 문서 | 행 보안 정책(RLS) | https://www.postgresql.org/docs/current/ddl-rowsecurity.html |
| 공식 문서 | CREATE POLICY 레퍼런스 | https://www.postgresql.org/docs/current/sql-createpolicy.html |
| 공식 PDF | PostgreSQL 18 전체 매뉴얼(A4) — 다운로드 완료 | https://www.postgresql.org/files/documentation/pdf/18/postgresql-18-A4.pdf |
E. OCR — Tesseract 공식
| 구분 | 자료 | URL |
|---|---|---|
| 공식 문서 | tessdoc(공식 문서 저장소) | https://github.com/tesseract-ocr/tessdoc |
| 공식 문서 | 명령줄 사용법 | https://github.com/tesseract-ocr/tessdoc/blob/main/Command-Line-Usage.md |
| 공식 문서 | 기술 문서(엔진 개요 논문 포함) | https://github.com/tesseract-ocr/tessdoc/blob/main/tess3/Technical-Documentation.md |
F. AI 리스크·환각 — NIST 공인
| 구분 | 자료 | URL |
|---|---|---|
| 공인(기관) | NIST AI 600-1 생성 AI 프로파일(환각·그라운딩 리스크 정의) — 다운로드 완료 | https://nvlpubs.nist.gov/nistpubs/ai/NIST.AI.600-1.pdf |
| 공인(기관) | NIST AI 100-1 AI 리스크 관리 프레임워크 1.0 — 다운로드 완료 | https://nvlpubs.nist.gov/nistpubs/ai/NIST.AI.100-1.pdf |
| 공인(기관) | NIST AI RMF 프로그램 페이지 | https://www.nist.gov/itl/ai-risk-management-framework |
3 다운로드 자료 — 폴더 구조와 판정 기록
판정 기준(규칙 R3): 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 | ✅ 성공 |
(시도) 학습자료/downloads/03-aiche-art-of-pid/ | artofthepid-aiche.pdf | 17B("Permission denied") | ❌ 실패 — 접근 통제. URL 열람으로 대체, 폴더 삭제 |
보안 주기: 다운로드 파일은 신뢰 불가 데이터 — 각자 별도 폴더에 격리 보관(프로젝트 실행 코드와 분리), 열람 시 뷰어 사용.
4 학습 경로 권고 (역할별)
| 역할 | 먼저 볼 것 | 이어서 |
|---|---|---|
| 전체 이해(신규 투입자) | 19 HTML 9페이지(시트9 발행 목차) → 본 문서 §1 | 15 용어집 → 07 충족도 |
| 검색 담당 | §2-B OpenSearch 하이브리드 튜토리얼 | 06 §1·06 §8(T13 가중치) |
| 검증·AI 담당 | §2-F NIST AI 600-1 환각·그라운딩 장 | 06 §3(kev)·§6(실패 경로) |
| 데이터·도메인 담당 | §2-A P&ID 자료(AIChE) | 기준판 구조(t24-baseline.json) |
| 인프라·운영 담당 | §2-C·D AWS/PG 공식 문서 | 12 D-1 전환 설계·OSB 수치 |