01 / 09 · 표지
CONSTRUCTION DRAWING INTELLIGENCE · LEARNING MAP

건설도면프로젝트
학습 지도

「P101이 표시된 최신 개정 도면과 원문 위치를 찾는다」 — 이 한 문장을 만족하는 시스템을, 검색·검증·관계·이벤트 4개 레이어로 실증한 프로젝트의 학습자료. 모든 수치·판정은 로컬 하이브리드 환경 실측(보고서 05·06·07)이다.

1문제 정의 2전체 흐름 3검색 BM25·벡터 4검증 선별·근거 5관계·탐색·실적 6이벤트·판 관리 7환경·운영·전환 읽는 방법페이지 순서 = 학습 순서 · 파랑=진행 강조 · 청록=실증 성공 · 주황=보류/주의
18/18
T27 이벤트 소비자 시험(멱등·시효·판 전환)
12/12
T26 실적 질의 3층 방어(주입·권한·타임아웃)
0.5
kev 근거검증 신뢰도 하한(미만=보류)
임베딩 bge-m3 1024차한국어 질의 5/5 kNN p50 3.7ms · 195ops@10k실패는 reject 아닌 보류 기계 판정과 사람 검수 분리
건설도면프로젝트 · 학습자료 SEQ 19 (양식: kikum.xyz/physical-ai-motion 준수 — 템플릿 17번)근거: output/05·06·07 실측 보고서 · 용어: 15번 · URL 목록: 18번
02 / 09 · 단원 1-2
UNIT 01-02 · PROBLEM & PIPELINE

무엇을 푸는가, 전체는 어떻게 흐르는가

답은 반드시 원문 근거(문서·페이지·bbox)와 함께 제시한다. 모르면 「모름」으로 보고한다 — 추측을 만들지 않는 것이 첫 원칙이다.

단원 1 · 문제의 실체

설비 태그(P101·V201·PUMP-01)가 수백 장 도면에 흩어져 있고 개정(A→B→C)이 쌓인다. 「최신 개정이 무엇인가」가 사람 기억과 엑셀에 의존 → 질의 응답 시스템으로 바꾼다.

업무 질의 1개기준판 baseline개정 order·status·valid_until동일 태그 타 프로젝트 구분

왜 어려운가 — 3가지 간극

① 검색 유사도는 사실 판단이 아니다 — 선이 실제로 연결됐는지는 점수가 증명하지 않는다.
② LLM 출력은 형식이 통과해도 환각일 수 있다 — 근거 대조가 필수다.
③ 도면은 이미지·PDF·CAD 형식이 뒤섞인다 — 경로마다 추출 품질이 다르다.

단원 2 · 종단 파이프라인 14단계 (위→아래로 데이터가 흐른다)

① S3 원본 업로드 — sha256 체크섬 · 버전관리 · SSE ② 형식 분기 — PDF 텍스트 · 스캔 · DXF · DWG변환 · IFC ③ 추출 파서 — Docling · Tesseract · ezdxf · IfcOpenShell ④ 추출 레코드 — 태그 · bbox · 페이지 · 개정 · 품질상태 ⑤ 임베딩 — bge-m3 1024차 (Ollama @11435) ⑥ 색인 v{N} — NDJSON bulk · kNN lucene ⑦ 하이브리드 검색 — BM25 + 벡터 · 정규화 가중치 결합 ⑧ LLM 선별 — JSON 계약 · ID 대사 · 재시도 제한(17.5절) ⑨ kev 근거검증 — 3-way 판정 · conf≥0.5만 통과 ⑩ T24 제약 검사 — E101~E111 · H201 · 기준판 대사 ⑪ 판 게시 — relations_pub · 별칭 원자 전환 ⑫ SQS 이벤트 — event_id · source_version 계약 ⑬ T27 소비자 — 멱등 원장 · 시효 판정 · 게이트 재적용 ⑭ 하류 — 재조회·T25·T26 실패→보류결함 4종→needs_review저신뢰→보류E코드→fail 미게시
단원 1-2 · 근거 01 실행계획 §9절 업무질문 · 06 §1 종단 실증상세 도식: 14 drawio 시트 02 · 용어: 15 용어집 §2
03 / 09 · 단원 3
UNIT 03 · HYBRID SEARCH

검색 — 키워드와 의미를 섞는다

「P101」처럼 정확한 태그는 BM25가, 「최신 개정」같은 표현 변화는 벡터가 잡는다. 둘을 한 질의에 넣고 점수를 정규화 파이프라인으로 결합한다.

BM25 (어휘)

토큰 일치 기반 랭킹. 태그 exact 질의에 최강. 한국어는 seunjeon 분석기.
에뮬 도메인에서도 동작 — 관리형 호환성 기준.

벡터 k-NN (의미)

bge-m3 1024차 임베딩 → lucene 엔진 근사 검색. ARM64에서 nmslib은 세그폴트(실측) → lucene 필수.

하이브리드 (결합)

두 점수를 normalization processor가 가중치 결합. 키 phase_results_processors(복수형!) — 단수형은 오류(실측).

실측 — 임베딩 모델 비교와 결합 손해 사례 (T12·T13)

한국어 질의 5문항 정답 수 bge-m3 (1024차)nomic-embed (768차)하이브리드(bge)kNN 단독(bge) 5 / 5 3 / 5 4 / 5 5 / 5 · 결합이 항상 이득은 아니다 — PUMP 질의 1위→2위 역전 사례(가중치 무관) · 채택: 가중치 스윕 + 역전 질의 기록 프로토콜(T13) · 임베딩 지연 212ms
PUT _search/pipeline/hybrid-pipeline { "phase_results_processors": [ ... { "normalization-processor": { "combination": { "technique": "arithmetic_mean", "weights": [0.3, 0.7] } } } ] } GET idx/_search?search_pipeline=hybrid-pipeline { "query": { "hybrid": { "queries": [ BM25…, knn… ] } } }
로컬 OpenSearch 2.13 실증 구성 그대로. 관리형 버전 이동 시 파이프라인 키 호환 우선 확인(D-1 M2).
bge-m3 채택768→1024 매핑 전환 실증교차≠연결 · 도트 폭 임계 10px

읽을 거리 — 공식 학습자료

공식 문서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
단원 3 · 근거 06 §1·§5-임베딩비교·§8 T13전체 URL 목록은 18번 문서 §2-B
04 / 09 · 단원 4
UNIT 04 · SELECTION · GROUNDING · CONSTRAINTS

검증 — 형식 통과는 사실성이 아니다

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 오류 코드 전체 (코드에서 직접 추출)

E101필수 ID·필드 누락 E102관계 유형 허용값 밖 E103참조 개체·문서 부재 E104출발·도착 유형쌍 불일치 E105방향 위반(역순쌍 존재) E106문서에 없는 개정 참조 E107근거 필수필드 누락 E108근거 source_ref 미등재 E109무효 개정 끝점 E110supersedes 순서 위반 E111위치 계약 위반 H201식별 신뢰 낮음→hold

판정: E 있으면 fail · H201만 hold · 아니면 pass — v1 13/13 + v2 4/4 실증. 후보 수정은 candidate_hash 불일치로 감지→재검사(18.2절).

근거 검증의 원칙 — 편향 방지

검증기 입력은 질문·주장·근거만. "T24를 통과했다"는 이력을 언급하는 순간 supported 판정으로 치우친다(실측). NIST AI 600-1도 생성 AI의 환각(confabulation)을 고유 리스크로 분류하고 근거 확보·평가·사람 검토를 통제 수단으로 제시한다 — 본 프로젝트 게이트 구조와 같은 방향.
공인 PDF · 다운로드 완료NIST AI 600-1 생성 AI 프로파일(환각·그라운딩 리스크)nvlpubs.nist.gov/nistpubs/ai/NIST.AI.600-1.pdf → 학습자료/downloads/01-nist-ai-600-1/ 공인 PDF · 다운로드 완료NIST AI 100-1 AI 리스크 관리 프레임워크 1.0nvlpubs.nist.gov/nistpubs/ai/NIST.AI.100-1.pdf → 학습자료/downloads/02-nist-ai-100-1/
단원 4 · 근거 06 §3 kev·§5 kev관계검수·§6 실패경로 9/9전체 URL 목록은 18번 문서 §2-F
05 / 09 · 단원 5
UNIT 05 · RELATIONS · TRAVERSAL · SQL DEFENSE

관계·탐색·실적 질의

도면에서 읽은 관계(관측)만 게시하고, 유도한 관계(파생)는 규칙 버전과 함께 별도 표시한다. 다단계 질의는 그래프 제품 없이 앱 BFS로 — 요구 발생 시 재검토.

P101펌프 V201밸브 P110펌프 V202 TK-01ALPHA 프로젝트권한 경계 밖 connected_to (flow: P101→V201) connected_to (flow→) connected_to — 순환 경로 허용, 경로 내 중복 노드 금지 REL-07 — 양끝 프로젝트 불일치→미표출

관계 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) 전부 차단.

공식 문서PostgreSQL 행 보안 정책(RLS) — 필요 시 재사용 패턴postgresql.org/docs/current/ddl-rowsecurity.html 공인 PDF · 다운로드 완료PostgreSQL 18 전체 매뉴얼(15.9MB)postgresql.org/files/documentation/pdf/18/postgresql-18-A4.pdf → 학습자료/downloads/04-postgresql-18-a4/
단원 5 · 근거 06 §7 T25 18/18 · §8 T26 12/12그래프 제품 미채택 사유: 03 §5·11 P-09
06 / 09 · 단원 6
UNIT 06 · EVENTS · LEDGER · VERSIONED BOARDS

변경·이벤트·판 관리 (T27)

도면이 바뀌면 시스템은 어떻게 따라가는가 — 이벤트 계약 하나로: 멱등 원장, 시효 판정, 게이트 재적용, 새 판 원자 전환. 실패는 언제나 보류(reject 아님, 17.5.4).

소비자 6단계 처리 순서

① 멱등event_id 원장 조회duplicate 스킵 ② 시효source_version≤최신stale 스킵 ③ 게이트선별+kev+T24재적용 ④ reindexv{N+1} 새 판 구성 ⑤ 별칭 전환한 요청 원자 교체 ⑥ 하류 발행재조회·T25 · 원장 상태 5종 — applied(적용) · duplicate(멱등 스킵) · stale(오래된 이벤트) · blocked(게이트 보류+사유) · failed(오류) · entity_state — active/deleted, 읽기는 GET _doc 실시간(refresh 지연 회피 — 실측 교훈) · manifest 배치 — 부분 실패 지속(applied=1/blocked=1/failed=1) + 재실행 멱등(duplicate=2) · 요약 complete/partial · 7/7 · 판 고정 — 실행 시작 시점 인덱스명으로 조회→전환 중에도 같은 판 응답(일관성 실증) 판 전환 롤백 — 이전 판 보존이 전제 seachdog_units_v2 → (전환) → v3 · 별칭 _current 한 요청 교체 · 이상 시 별칭 되돌림=판 단위 롤백

실패 경로 9/9 — 시험이 잡은 결함까지 기록

· LLM 결함 4종 → needs_review 보류
· kev 정지 상태에서도 파이프라인 완주(생략 기록)
· BLOCKED 종단 — 원장 blocked+사유

· T24 통과 후 후보 수정 → candidate_hash 불일치 → 재검사 E109
· 시험이 소비자 네트워크-예외 크래시 발견→수정(보류 처리로 전환)

공식 문서SQS·SNS·EventBridge 공식 선택 가이드(이벤트 계약 설계 근거)docs.aws.amazon.com/decision-guides/latest/decision-guides/sns-or-sqs-or-eventbridge.html 공식 영상Amazon Web Services 공식 채널 — 서비스 개요·이벤트 드리븐 아키텍처youtube.com/user/AmazonWebServices
단원 6 · 근거 06 §6 T27 18/18·실패경로 9/9·배치 7/7전체 URL 목록은 18번 문서 §2-C
07 / 09 · 단원 7
UNIT 07 · HYBRID ENVIRONMENT & OPERATIONS

환경·운영 — 무엇이 진짜였고 무엇이 남았는가

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).

운영 수치(실측)와 백업·롤백

3.7ms
kNN-768 p50 @10k 문서
195 ops
초당 처리(단일 클라이언트)
0%
부하 시험 오류율(OSB)
0건
설계상 막힌 시나리오(07 판정)
백업 — S3 버전관리(원본) · OS 스냅샷(일일+판 전환 전 수동) · RDS 자동 백업 · 원장 스냅샷. 복구 — 이전 판 별칭 되돌림·원장 재생. 회귀 — 전 로컬 시험 스크립트를 실환경 엔드포인트로 재실행(D-1 M3 완료 기준).

남은 과제 — 전부 사람·자원 영역 (기술 과제 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
단원 7 · 근거 05 전편 · 06 §9 · 07 §6 · 11 P-01~10 · 12 D-1아키텍처 도식: 14 drawio 6시트(색 규약 동일)
08 / 09 · 자료 총람
RESOURCES · OFFICIAL LEARNING MATERIALS

공인 학습자료 총람과 역할별 경로

기준: 공식 문서·공인 기관·공식 채널 우선. 다운로드본은 학습자료/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.pdf1,174,643B성공
학습자료/downloads/02-nist-ai-100-1/NIST.AI.100-1.pdf1,946,127B성공
학습자료/downloads/04-postgresql-18-a4/postgresql-18-A4.pdf15,944,094B성공
(시도) 03-aiche-art-of-pid/artofthepid-aiche.pdf17B실패 — Permission denied · URL 열람으로 대체

역할별 학습 경로 (18번 §4 요약)

역할먼저이어서
전체 이해(신규)본 지도 9페이지 → 18번 §115 용어집 → 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 수치
판정 원칙(규칙 R3 준수) — 본 지도의 모든 수치는 실측이며, 예측·해석은 근거와 구분해 표기했다. 실패 사례(AIChE 다운로드 거부·OCR 오인식·결함 발견)도 삭제하지 않고 기록한다.
건설도면프로젝트 학습자료 · SEQ 19 · 2026-11-17양식 템플릿 17 · URL 목록 18 · 용어집 15/16 · 아키텍처 14
09 / 09 · 발행 목차
PUBLISHING INDEX · ALL DOCUMENTS & DIAGRAMS

발행 목차 — 전체 문서·도식·자료 연계

모든 문서는 양식 템플릿(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 에뮬레이터 환경 README08_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.pdf
발행 규칙 — ① 변환본은 전부 오프라인 동작(외부 리소스 0) ② drawio 링크는 인라인 뷰어 페이지로 열린다(로컬 내장 공식 뷰어 assets/viewer-static.min.js · 원본 편집만 draw.io 앱) ③ markdown 원본이 항상 원천이며, 재변환은 output/html/publish.sh 실행 한 번으로 전체(문서+뷰어) 갱신된다 ④ 게시용 복사본을 만들 때는 output/ 폴더 전체(링크 상대경로 유지)를 그대로 옮긴다.