문서 배포 검증¶

공개 문서의 빌드, 배포, 복구 시 사용하는 운영 가이드입니다.

Vercel 자동 배포¶

truthound-docs 프로젝트는 Hobby 플랜과 GitHub의 seadonggyun4/Truthound 저장소를 사용합니다. main push는 운영 문서를, 다른 브랜치와 pull request는 인증이 필요한 Preview를 배포합니다. vercel.json에서 설치·빌드 명령, 출력 디렉터리 site, /ko/ 호환 영구 리디렉션을 관리합니다. 설치 도구는 임시 가상환경에 격리합니다. Vercel이 제공하는 Python에서 uv sync --frozen --extra docs로 의존성을 설치하며, Docs CI는 같은 lockfile을 Python 3.11에서 검증합니다. sh docs/scripts/build_site.sh로 공개 문서를 검증하고 빌드합니다. 오케스트레이션 문서는 커밋된 스냅샷을 사용하며 빌드 도중 외부 main을 가져오지 않습니다. API나 서버리스 실행 환경은 배포하지 않습니다.

대표 주소는 https://truthound-docs.vercel.app/입니다. 한국어는 /, 영어는 /en/ 경로를 사용합니다. 운영 문서는 검색 엔진 수집을 허용합니다. Preview에는 Vercel 인증과 Preview 검색 제외 정책이 적용되며 소스맵 보호도 유지합니다. 기존 호스팅 설정은 제거합니다. 이미 게시된 패키지 메타데이터는 수정할 수 없으므로 다음 패키지·플러그인 배포부터 새 주소가 제공됩니다.

저장소 설정 확인¶

mkdocs.yml과 mkdocs.public.yml의 대표 주소가 Vercel인지 확인합니다.
full/public 문서 준비 후 각 빌드와 한국어 검증을 수행합니다.
docs/public_docs.yml의 공개 범위를 유지합니다. dashboard와 Workflow는 공개하지 않습니다.
docs/orchestration/은 저장소 스냅샷, docs/ai/는 Core AI 기술 문서입니다.
스냅샷을 갱신할 때만 scripts/fetch-external-docs.sh orchestration을 실행합니다.
배너·아이콘·테마 설정은 유지합니다.

Generated Site Checklist¶

실무 운영 가이드에서 site/, Vercel을(를) 다루는 항목입니다:

실무 운영 가이드에서 site/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/tutorials/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/cli/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/python-api/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/reference/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/ai/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/ai/system-boundary/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/orchestration/index.html, Orchestration을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/orchestration/airflow/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/orchestration/airflow/observability-alerting/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/orchestration/common/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/orchestration/common/engine-resolution-selection/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/orchestration/engines/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/orchestration/engines/capability-matrix/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/orchestration/enterprise/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/orchestration/enterprise/rollout-topologies/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/releases/latest-benchmark-summary/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/releases/truthound-3.1/index.html을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/sitemap.xml을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 site/search/search_index.json을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 assets/truthound_banner.png을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 Truthound, assets/Truthound_icon_banner.png, Truthound_icon_banner.png을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 docs/public_docs.yml을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 관련 설정과 실행 흐름을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.

Search and Sitemap Checklist¶

실무 운영 가이드에서 sitemap.xml, expected_page_count, docs/public_docs.yml을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 sitemap.xml을(를) 다루는 항목입니다:
실무 운영 가이드에서 관련 설정과 실행 흐름을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 관련 설정과 실행 흐름을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 CLI을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 관련 설정과 실행 흐름을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 관련 설정과 실행 흐름을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 API, Python을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
[ ] 성능
[ ] 벤치마크 methodology
실무 운영 가이드에서 Great Expectations, Great, Expectations을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
[ ] latest verified 벤치마크 summary
[ ] 오케스트레이션 overview
[ ] 오케스트레이션 airflow
[ ] 오케스트레이션 shared 런타임
[ ] 오케스트레이션 shared 런타임 deep dive
[ ] 오케스트레이션 engines
[ ] 오케스트레이션 engines capability matrix
[ ] 오케스트레이션 enterprise
[ ] 오케스트레이션 enterprise rollout topologies
실무 운영 가이드에서 search_index.json, expected_page_count, docs/public_docs.yml을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 search_index.json을(를) 다루는 항목입니다:
실무 운영 가이드에서 TruthoundContext, Truthound을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 ValidationRunResult을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 truthound.ai을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 Great Expectations, Great, Expectations을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 benchmark을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 release-grade을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 Truthound, Truthound Orchestration, Orchestration을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 search_index.json을(를) 다루는 항목입니다:
실무 운영 가이드에서 shared runtime을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 engine을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 enterprise을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 airflow을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 prefect을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 dbt을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 sitemap.xml, search_index.json을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.

Content Verification Checklist¶

실무 운영 가이드에서 관련 설정과 실행 흐름을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 RC1, RC1을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 release-grade, fixed-runner benchmark verification, verified benchmark summary, GA을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 Great Expectations, README, Great, Expectations을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 Home, Core, Orchestration, Release, Notes, ADRs, Legacy, Archive을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 Core, Getting, Started, Tutorials, Guides, Reference, Concepts, Architecture을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 Workflow, MkDocs을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 truthound.ai을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 truthound-orchestration을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
실무 운영 가이드에서 https://github.com/seadonggyun4/truthound-orchestration/edit/main/docs/...을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.

Local Verification Commands¶

full 참조 문서는 선택형 Core UI 문서를 유지합니다. 한국어 검사에 --surface full을 사용하면 알려진 Core UI 세 경로의 링크만 허용합니다. 한국어 분량 기준이나 외부 UI 링크 차단은 완화하지 않습니다. public 빌드는 기본 경로 정책과 공개 manifest의 제외 규칙을 유지합니다. 다음 빌드가 site/를 덮어쓰기 전에 각 빌드의 검사를 실행하세요.

sh scripts/fetch-external-docs.sh orchestration
python docs/scripts/prepare_public_docs.py --mode full
python docs/scripts/prepare_public_docs.py --mode public
python docs/scripts/check_links.py --mkdocs mkdocs.yml README.md CLAUDE.md build/full-docs
python docs/scripts/check_links.py --mkdocs mkdocs.public.yml build/public-docs
python -m mkdocs build --strict
python docs/scripts/verify_korean_docs.py --site-dir site --surface full
python -m mkdocs build --strict -f mkdocs.public.yml
python docs/scripts/verify_public_surface.py --manifest docs/public_docs.yml --site-dir site

성능 and 벤치마크
벤치마크 Methodology
실무 운영 가이드에서 Latest, Verified, Benchmark, Summary을(를) 기준으로 데이터 품질 검증, 워크플로우 자동화, 결과 해석 방법을 설명합니다.
Truthound AI 개요
Truthound 오케스트레이션 개요

공개 배포 식별 정보¶

공개·한국어 빌드 gate 이후 deployment-manifest.json에 소스 Git 커밋, 패키지 버전과 명시적으로 허용한 공개 검증 문서의 SHA-256 해시만 기록합니다. 허용 목록에는 MCP 참조·작업 안내·재현 예제, 기존 파일·CLI 진입 문서, CI 검사와 배포 검증 문서가 두 언어로 포함됩니다. 환경 변수, 비공개 기록, 임의 파일을 수집하지 않습니다. 이 기록은 Release CI 성공이나 PyPI 게시 증거를 대신하지 않습니다.

https://truthound-docs.vercel.app/deployment-manifest.json의 source_commit이 최종 목표 커밋과 같은지 확인하고 고정된 공개 페이지 각각의 실제 응답 바이트를 page_sha256과 대조합니다. 이전 커밋, 누락 페이지, 해시 불일치는 배포 검증 실패입니다. 기본 한국어 페이지는 /guides/.../, 영어는 /en/guides/.../를 사용합니다. HTTP 200과 문구 일치만으로 배포 커밋을 증명하지 않습니다.

방문 및 성능 통계¶

운영 문서는 Hobby의 Vercel Web Analytics와 무료 Speed Insights를 사용합니다. Preview와 로컬 빌드는 이벤트를 전송하지 않습니다. 페이지 URL의 쿼리 문자열과 fragment를 제거하며 사용자 정의 이벤트는 설정하지 않습니다. 문서 방문 통계이며 PyPI 다운로드 수와는 별개입니다. Speed Insights Plus는 활성화하지 않습니다.