# DatumGuard

[![CI](https://github.com/tjwnsdhfz/datumguard/actions/workflows/ci.yml/badge.svg)](https://github.com/tjwnsdhfz/datumguard/actions/workflows/ci.yml)
[![Deployment Smoke](https://github.com/tjwnsdhfz/datumguard/actions/workflows/deployment-smoke.yml/badge.svg)](https://github.com/tjwnsdhfz/datumguard/actions/workflows/deployment-smoke.yml)
[![Live Demo](https://img.shields.io/badge/Live_Demo-Vercel-000000?logo=vercel)](https://datumguard-tjwnsdhfz.vercel.app)
[![API Endpoint](https://img.shields.io/badge/API_Endpoint-Render-46e3b7?logo=render&logoColor=000000)](https://datumguard-api.onrender.com/api/v1/health)

## CAD가 생성됐다는 사실은, 치수가 맞다는 증거가 아닙니다.

**CAD command success is not accuracy evidence.**

DatumGuard는 요구사항을 versioned contract로 잠그고 저장된 DXF·STEP을 다시 열어 재측정한 뒤,
검증된 파일만 내보내는 오픈소스 Engineering Design Assurance 도구입니다.
**Fail-closed verification for AI-assisted CAD workflows.**

**[검증된 Frame 실행 →](https://datumguard-tjwnsdhfz.vercel.app/frame)** · **[60초 Case Study →](https://datumguard-tjwnsdhfz.vercel.app/case-study)** · [v0.4.0 release evidence →](https://github.com/tjwnsdhfz/datumguard/releases/tag/v0.4.0) · [Benchmark 재현 →](docs/frameguard-gnn.md#8-재현-명령)

> **Safety boundary:** FrameGuard는 제한된 2D 선형 탄성 frame의 초기 screening이며 구조 안전 인증이나 전문 구조 검토를 대체하지 않습니다. `/openbim`은 `research_validation_only=true`, `approval_eligible=false`인 합성 연구 preview입니다.

## 60초 요약

| | 핵심 |
|---|---|
| **문제** | 자연어·폼에서 CAD가 생성되어도 저장 파일의 실제 치수, datum, 공차가 요구조건과 같다는 보장은 없습니다. |
| **방법** | 요구를 versioned contract로 고정하고, writer와 분리된 reader가 serialized DXF 또는 STEP을 다시 열어 측정합니다. 모든 필수 검사가 통과할 때만 bundle을 활성화합니다. |
| **증거** | [v0.4.0 release](https://github.com/tjwnsdhfz/datumguard/releases/tag/v0.4.0)는 413 pytest, 41 Playwright, 15-page build, container/SBOM와 security gate를 통과합니다. 실제 Rhino 8·Grasshopper source에서 6개 GUID의 provenance를 DXF XDATA까지 보존했고, DXF completeness gate는 지원하지 않는 내용을 동일 형상으로 주장하지 않습니다. 정확한 run·deployment ID는 release notes에 고정합니다. |
| **한계** | 구조·안전·법규·산업표준 적합성이나 범용 3D를 인증하지 않습니다. FrameGuard는 제한된 2D 선형 탄성 frame의 초기 screening이며 전문 구조 검토를 대체하지 않습니다. 3D는 세 가지 제한형 solid family의 STEP 기하 검증만 local/CI에서 지원하며, 공개 Render Free API에서는 비활성입니다. OpenBIM 결과도 합성 연구 evidence일 뿐 제작·시공 승인이 아닙니다. 100개 golden contract + 자연어 50개 benchmark는 계획 단계입니다. |

| 결과 | 재현 fixture | 승인 게이트 |
|---|---|---|
| **PASS** | [4-room Architecture](fixtures/examples/architecture_four_room.json), [CDA piping](fixtures/examples/piping_utility.json), [verified pipe rack](fixtures/examples/frame_pipe_rack.json) | CAD 경로는 독립 재측정 후 bundle 승인, FrameGuard는 screening PASS evidence 생성 |
| **FAIL** | [300mm open loop](fixtures/examples/architecture_open_300mm.json), [clearance violation](fixtures/examples/piping_clearance_failure.json), [missing-brace rack](fixtures/examples/frame_pipe_rack_failure.json) | violation을 반환하고 CAD bundle 또는 frame screening PASS 차단 |

> **중요:** PDF 미리보기는 `DO NOT SCALE`입니다. 2D 설계의 검증된 bundle에 포함된 DXF만 제작 기준 파일이며, `/intake`의 외부 파일 감사 결과는 informational evidence로서 제작 승인이 아닙니다.

[![DatumGuard의 architecture contract, CAD canvas, 독립 DXF verifier와 approval gate](docs/assets/demo/architecture-verified.png)](https://datumguard-tjwnsdhfz.vercel.app)

[공개 Architecture 데모 열기 →](https://datumguard-tjwnsdhfz.vercel.app) · [실행·재현 가이드 보기 →](docs/demo.md)

이미지의 재현 절차와 화면 계약은 [Architecture Demo Guide](docs/demo.md)에 고정되어 있습니다. Architecture, Piping, Plate는 저장된 DXF evidence가 통과해야만 bundle을 활성화합니다. 제한형 Solid은 같은 원칙을 STEP에 적용하지만 local/CI 전용이고, `/intake`는 외부 CAD 산출물을 변경하지 않고 감사합니다.

## Engineering domains

| 분야 | Route | 검증 예시 |
|---|---|---|
| Architecture | `/` | wall 폐합·연결, opening, grid/column, room area |
| Plant / Semiconductor Piping | `/piping` | route 연결·직교성, valve/support 위치, equipment clearance |
| Structural Frame Screening — v0.4.0 production | `/frame` | Rhino/GH source GUID→2D exact solver→DXF semantic 재개봉 gate→surrogate triage |
| Mechanical / Ship Plate | `/plate` | hole/slot/cutout, edge distance, ligament, overlap |
| 3D Solid Part — local/CI, hosted run disabled | `/solid` | 세 family의 OpenCascade B-rep, bbox, topology, hole/bore diameter와 axis |
| Existing CAD Artifact | `/intake` | DXF support matrix·completeness gate, STEP·IFC 구조 감사와 revision compare |
| OpenBIM Evidence — public research UI, hosted run disabled | `/openbim` | IFC4+IDS 정보요구조건, IFC integrity, project AABB clearance, protected revision |

세부 범위와 분야별 비목표는 [Engineering Domains](docs/engineering-domains.md)에 정리되어 있습니다.

### FrameGuard structural screening

[![FrameGuard Rhino/GH exchange, DXF re-open, OpenSees parity와 uncertainty gate](docs/assets/demo/frame-assurance-pipeline.png)](https://datumguard-tjwnsdhfz.vercel.app/frame)

FrameGuard는 Rhino 8/Grasshopper가 추출한 centerline·support·load·section metadata를 명시적
unit/datum과 함께 mm contract로 정규화합니다. `datumguard_numpy_2d_frame_v1`이 변위·반력·member
end force·combined stress를 계산하고, 별도 reader가 serialized R2013 DXF를 다시 열어 좌표·단위·datum을
`0.001 mm` gate로 검증합니다. 둘 중 하나라도 실패하면 공식 screening PASS와 DXF download를
차단합니다. 상세 교환 계약은 [Rhino/GH + DXF Guide](docs/frameguard-rhino.md)에 있습니다.

[![실제 Rhino 8 portal frame source와 GUID/DXF reopen gate](docs/evidence/frameguard-rhino-roundtrip-rhino.png)](docs/frameguard-rhino.md#2026-07-13-실제-cordyceps-round-trip-evidence)

실제 Rhino 8 + Grasshopper + Cordyceps 실행에서 **6개 Rhino GUID → contract entity → DXF
XDATA** provenance를 보존하고, DXF 내부의 전체 semantic contract를 독립 재개봉해
`0.0 mm` endpoint 편차로 통과시켰습니다. 원본
[Grasshopper document](docs/evidence/frameguard-rhino-roundtrip.gh),
[exchange JSON](docs/evidence/frameguard-rhino-exchange.json),
[verification result](docs/evidence/frameguard-rhino-roundtrip-result.json),
[evidence ZIP](docs/evidence/frameguard-rhino-roundtrip.zip)을 그대로 재현할 수 있습니다.
이 bundle의 역할은 `geometry_evidence`이며 안전 인증이나 시공 승인이 아닙니다.

독립 검증 evidence로 genuine `openseespy==3.8.0.0` 해석과 6개 사례를 비교해 **6/6 parity
PASSED**를 기록했습니다. solver-labeled 90-case topology holdout에서는 3-seed PyG ensemble의
GraphSAGE가 displacement MAE `0.6274 mm`/R² `0.8049`, utilization MAE `0.03718`/R² `0.7327`,
GAT가 각각 `0.6512 mm`/`0.7924`, `0.02944`/`0.8065`를 기록했습니다. 이 수치는 합성
pipe-rack family의 연구 결과이며 안전 인증이 아닙니다. surrogate는 `PREDICTED` 또는
`REVIEW_REQUIRED`만 반환하고, 공식 PASS는 계속 exact solver와 DXF gate가 결정합니다.
[OpenSees parity](docs/frameguard-opensees.md), [PyG benchmark와 uncertainty gate](docs/frameguard-gnn.md),
[ridge historical baseline](docs/frameguard-surrogate.md)에 원본 수치와 한계를 공개합니다.

> `/frame`과 FrameGuard assurance API/MCP는 v0.4.0 production 범위입니다. v0.4.0은 실제
> Rhino/Grasshopper round-trip evidence와 one-step `frame_rhino_roundtrip` API/MCP를 더했으며,
> 결과는 여전히 구조 안전 인증이 아닌 초기 screening입니다. 정확한 CI·배포·strict smoke ID는
> [release evidence](https://github.com/tjwnsdhfz/datumguard/releases/tag/v0.4.0)에 고정합니다.

### OpenBIM Evidence Guard research preview

`protocol-v1`에서 동결한 합성 Virtual FAB evaluation 30 case를 실행했다. 120 candidate record와
1,200 measured engine run에서 engine error 0, canonical payload 10/10 일치를 기록했다. 수정 후 Full
pipeline은 TP/FP/FN `330/0/0`, clean·authorized false positive 0, engine p95 1,876.222ms였다.

최초 집계에서 발견한 evaluator 구현 오류 2건은 detector를 재실행하지 않고 보존 raw
`sha256:58dcf7dc...`에서 `analysis-v1.0.2`로 재분석했다. 사전등록하지 않은 zero-support 처리의
supported-rule macro-F1은 별도 post-freeze sensitivity로만 남겨 두 가설을 `NOT_CONCLUSIVE`로
표시했다. 전체 provenance, 수정 전후 수치와 한계는
[BIM Awards 2026 연구 evidence](docs/awards-2026/README.md)에 공개한다. BCF 독립 viewer,
배포 license와 production smoke는 아직 gate가 열려 있으므로 BCF 또는 실사업장 성능을 핵심 성과로
주장하지 않는다.

### Plant / Semiconductor Piping demo

![DatumGuard의 CDA utility piping route, support와 clearance 독립 DXF 검증 결과](docs/assets/demo/piping-verified.png)

재현 절차와 브라우저 계약은 [Piping Demo Guide](docs/piping-demo.md)에 고정되어 있습니다.

### 3D STEP solid demo

[![OpenCascade STEP 생성, 격리 재입력, 실제 mesh와 치수 검증](docs/assets/demo/solid-step-verified.png)](https://datumguard-tjwnsdhfz.vercel.app/solid)

Mounting plate, angle bracket, flange만 생성합니다. STEP writer와 격리된 OpenCascade process의 재입력·측정은 local/CI에서 통과하지만 공개 Render Free API의 실행 endpoint는 메모리 안전을 위해 `503 DG_CAPABILITY_DISABLED`로 닫혀 있습니다. 상세 contract·측정·Rhino 8 왕복 검증은 [3D Solid STEP Assurance](docs/solid-step.md)에 기록되어 있습니다. 외부 CAD 파일은 [Artifact Lab Guide](docs/artifact-lab.md)의 `/intake`에서 검사합니다.

## Assurance pipeline

```mermaid
flowchart LR
    UI["DesignContract<br/>form + confirmed intent"] --> CORE["Canonical geometry<br/>DXF writer"]
    CORE --> DXF["Serialized R2013 DXF<br/>layers + XDATA"]
    DXF --> VERIFY["Independent reader<br/>remeasure + constraints"]
    VERIFY -->|passed| GATE["Approval gate"]
    VERIFY -->|repairable| REPAIR["Bounded repair<br/>free parameters only, max 3"]
    REPAIR --> CORE
    GATE --> BUNDLE["DXF · SVG · DO NOT SCALE PDF<br/>verification JSON"]
```

Writer의 메모리 형상은 verifier로 전달되지 않습니다. Verifier는 직렬화된 DXF를 별도로 다시 읽고, 실제 측정값이 계약의 target·tolerance·constraint를 통과했을 때만 공식 bundle을 승인합니다.

제한형 3D 경로도 `SolidPartContract → OpenCascade STEP writer subprocess → 별도 OpenCascade re-import process → approval gate`로 writer와 verifier의 데이터 경로를 분리합니다. 이는 mounting plate, angle bracket, flange의 저장 STEP 기하 일치만 검증하며 범용 3D, assembly, 구조·압력·피로·재료·가공성 해석은 범위 밖입니다.

## 핵심 원칙

- 폼 입력을 `DesignContract`의 source of truth로 사용합니다.
- DXF writer와 verifier는 분리되어 있으며 verifier는 직렬화된 DXF를 재측정합니다.
- `locked` 치수와 datum은 자동수정하지 않습니다.
- 공차·필수 제약을 모두 통과한 경우에만 공식 ZIP bundle을 만듭니다.
- Rhino 결과는 선택적 secondary evidence일 뿐 공식 판정을 대체하지 않습니다.

## 빠른 시작

요구 사항은 Python 3.12+와 Node.js 20+입니다.

```bash
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
pip install -e ".[dev]"
datumguard-api
```

다른 터미널에서 웹을 실행합니다.

```bash
cd web
npm ci
npm run dev
```

브라우저에서 다음 경로를 엽니다.

- `http://localhost:3000/case-study`: 60초 product case study
- `http://localhost:3000/`: Interactive Architecture demo
- `http://localhost:3000/piping`: Plant/Semiconductor Utility Piping demo
- `http://localhost:3000/frame`: Structural Frame Screening demo
- `http://localhost:3000/plate`: 샘플 플레이트 설계·검증
- `http://localhost:3000/solid`: 3D solid STEP 생성·독립 재입력
- `http://localhost:3000/intake`: 외부 DXF·STEP·IFC 감사·revision 비교
- `http://localhost:3000/openbim`: IFC4·IDS 연구 검증과 JSON/HTML, 선택적 BCF evidence export
- `http://localhost:8000/docs`: FastAPI 문서

## Docker 실행

```bash
docker compose up --build
```

- Web: `http://localhost:3000`
- API: `http://localhost:8000`
- Health: `http://localhost:8000/api/v1/health`
- Readiness: `http://localhost:8000/api/v1/ready`

## 공개 배포

현재 공개 배포는 아래 주소에서 바로 사용할 수 있습니다.

- Web: [datumguard-tjwnsdhfz.vercel.app](https://datumguard-tjwnsdhfz.vercel.app)
- Product Case Study: [/case-study](https://datumguard-tjwnsdhfz.vercel.app/case-study)
- Architecture: [web root](https://datumguard-tjwnsdhfz.vercel.app)
- Plant / Semiconductor Piping: [/piping](https://datumguard-tjwnsdhfz.vercel.app/piping)
- Structural Frame Screening: [/frame](https://datumguard-tjwnsdhfz.vercel.app/frame)
- Mechanical / Ship Plate: [/plate](https://datumguard-tjwnsdhfz.vercel.app/plate)
- 3D Solid STEP UI: [/solid](https://datumguard-tjwnsdhfz.vercel.app/solid) — UI·schema는 공개되지만 실행은 local/CI 기능이며 현재 Render Free API에서는 메모리 안전을 위해 비활성
- CAD Artifact Lab: [/intake](https://datumguard-tjwnsdhfz.vercel.app/intake)
- OpenBIM Research Preview: [/openbim](https://datumguard-tjwnsdhfz.vercel.app/openbim) — UI와 동결 evidence는 공개되지만 Render 실행 capability는 비활성
- API: [health](https://datumguard-api.onrender.com/api/v1/health) · [domains](https://datumguard-api.onrender.com/api/v1/domains) · [OpenAPI](https://datumguard-api.onrender.com/docs)

`/openbim`은 production URL에서 조회할 수 있지만 hosted API 실행은 비활성이고,
`research_validation_only=true`인 합성 연구 evidence만 공개한다. `/frame` 역시 제한된 2D 선형 탄성
screening이며 두 경로 모두 제작·시공·구조 안전 승인을 발행하지 않는다.

현재 공개 기준은 [v0.4.0 release](https://github.com/tjwnsdhfz/datumguard/releases/tag/v0.4.0)입니다. Vercel 선행 smoke는 새 web과 기존 API의 하위 호환성을 확인하고, Render 완료 이벤트가 실행하는 최종 smoke는 API `version`, `release_sha`, capability, Architecture·FrameGuard canary, Artifact Lab audit, Solid `503` fail-closed와 CORS를 같은 배포 revision에서 검사합니다. 도메인 evidence에서 Architecture는 96m²와 4개 room seed, Piping은 12.0m route와 1,975mm minimum clearance, Plate는 전체 치수 편차 0.000000mm를 보고합니다. 이전 `v0.3.0`은 직전 evidence snapshot, `v0.2.1`은 [rollback baseline](docs/operations/rollback-baseline.md)으로 유지합니다.

직접 복제해 배포하려면 공개 저장소 [tjwnsdhfz/datumguard](https://github.com/tjwnsdhfz/datumguard)를 사용합니다. 먼저 Render 버튼으로 backend를 만들고 발급된 API origin을 Vercel 배포 화면의 `NEXT_PUBLIC_DATUMGUARD_API_URL`에 입력합니다.

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https%3A%2F%2Fgithub.com%2Ftjwnsdhfz%2Fdatumguard)
[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Ftjwnsdhfz%2Fdatumguard&root-directory=web&env=NEXT_PUBLIC_DATUMGUARD_API_URL,NEXT_PUBLIC_GITHUB_URL)

- Backend는 루트 `Dockerfile`을 Render, Fly.io, Railway 같은 컨테이너 서비스에 배포합니다.
- Frontend는 Vercel 프로젝트의 Root Directory를 `web/`으로 지정하고, build 전에 `NEXT_PUBLIC_DATUMGUARD_API_URL`을 backend URL로 설정합니다.
- Backend의 `DATUMGUARD_CORS_ORIGINS`에는 frontend origin을 쉼표로 구분해 설정합니다.

`render.yaml`은 보호된 `main` commit을 backend에 자동 배포합니다. Vercel for GitHub는 Root Directory `web/`에서 PR Preview와 `main` Production을 만들며, v0.4.0 strict smoke는 `/frame` DOM, `structural_frame` domain, deterministic FrameGuard canary와 exact `release_sha`까지 요구합니다. 최종 원격 run과 deployment ID는 v0.4.0 release notes에 고정합니다. 정확한 연결 계약은 [GitHub Deployment Guide](docs/github-deployment.md), 환경변수·cold start 순서는 [Deployment Guide](docs/deployment.md)를 따릅니다.

배포 후에는 `$WEB_ORIGIN/case-study`, `/`, `/piping`, `/frame`, `/plate`, `/solid`, `/intake`,
`/openbim`을 함께 확인합니다. Frontend를 build한 뒤
`NEXT_PUBLIC_DATUMGUARD_API_URL`을 바꾸었다면 반드시 rebuild해야 합니다.

공개 데모는 stateless입니다. 계정·DB·서버 프로젝트 저장을 사용하지 않으며, 요청 파일과 자연어 원문을 영구 저장하지 않습니다. Hosted demo에는 Rhino 연결을 요구하지 않으며, Rhino evidence는 로컬 adapter가 있을 때만 secondary cross-check로 사용합니다.

운영 경계도 코드로 고정했습니다. 실제 수신 byte 제한, 파일별·합계 upload 제한, optional API key, anonymous/authenticated quota, heavy CAD queue, parser subprocess, request ID·redacted JSON log, `/live`·`/ready`·bounded `/metrics`, Solid/Artifact Lab kill switch를 제공합니다. 브라우저 draft는 30일 TTL의 IndexedDB에만 저장되며 [/privacy](https://datumguard-tjwnsdhfz.vercel.app/privacy)에서 전체 삭제할 수 있습니다. 10k DAU는 현재 Free 배포의 용량 주장이 아니며, 출시 체크리스트·장애/rollback·SLO·비용 후보는 [Operations Guide](docs/operations/README.md)와 [Cost Guard](docs/operations/cost-guard.md)에 분리했습니다.

OpenCascade Solid은 코드·Linux CI·Docker image에서 실제 STEP 생성과 재입력을 통과하지만, Render Free 512MB Production canary에서 HTTP 502가 발생해 `DATUMGUARD_ENABLE_SOLID=false`로 fail-closed했습니다. OOM 또는 worker restart는 의심되지만 직접 확인되지 않았습니다. 유료 변경 없이 기능을 과장하지 않기 위한 운영 결정이며, [Cost Guard](docs/operations/cost-guard.md)의 Render Standard 이상 staging에서 canary와 부하 검증을 통과한 뒤에만 다시 활성화합니다.

## API와 MCP

- 한 번에 생성·검증: `POST /api/v1/designs/run`
- 계약 검증: `POST /api/v1/contracts/validate`
- 건축 평면 생성·검증: `POST /api/v1/architecture/designs/run`
- 건축 계약 검증: `POST /api/v1/architecture/contracts/validate`
- 배관 route 생성·검증: `POST /api/v1/piping/designs/run`
- 배관 계약 검증: `POST /api/v1/piping/contracts/validate`
- frame 선형 구조 screening: `POST /api/v1/frame/designs/run`
- frame 계약 검증: `POST /api/v1/frame/contracts/validate`
- frame/Rhino schema: `GET /api/v1/schema/frame-contract`, `GET /api/v1/schema/rhino-frame-exchange`
- Rhino/GH exchange adapter: `POST /api/v1/frame/rhino/adapt`
- frame DXF 생성·독립 재개봉 gate: `POST /api/v1/frame/cad/run`
- 비공식 surrogate triage: `POST /api/v1/frame/surrogate/predict`
- 정적 연구 evidence: `GET /api/v1/frame/benchmarks/opensees`, `GET /api/v1/frame/benchmarks/gnn`
- 3D solid 생성·STEP 독립 검증: `POST /api/v1/solid/designs/run`
- CAD 파일 감사: `POST /api/v1/artifacts/audit`
- CAD revision 비교: `POST /api/v1/artifacts/compare`
- OpenBIM IFC·IDS evidence: `POST /api/v1/openbim/evidence/run` — research validation only, MCP 도구 없음
- Liveness/readiness/metrics: `GET /api/v1/live`, `GET /api/v1/ready`, `GET /api/v1/metrics`
- 단계별 endpoint는 [TRD](docs/TRD.md)에 정리되어 있습니다.
- 로컬 MCP: `datumguard-mcp`

MCP는 기존 9개 설계 도구에 `artifact_audit`, `artifact_compare`, `solid_generate_verify`,
`frame_analyze`, `frame_repair_propose`, `frame_rhino_adapt`, `frame_rhino_roundtrip`,
`frame_dxf_generate_verify`, `frame_surrogate_predict`, `frame_opensees_parity_evidence`를 더한
**19개 도구**를 제공합니다.

MCP contract 분기는 입력의 `design_kind`로 결정합니다.

| `design_kind` | MCP application service | Web route |
|---|---|---|
| `architectural_plan` | Architecture | `/` |
| `piping_plan` | Piping | `/piping` |
| `structural_frame` | Deterministic 2D frame screening | `/frame` |
| `solid_part` | OpenCascade STEP | `/solid` |
| 필드 없음 | Plate/panel 호환 경로 | `/plate` |

기존 9개 도구 이름은 plate·architecture·piping에서 하위 호환됩니다. `artifact_audit`과 `artifact_compare`는 contract 없는 실제 파일에 informational evidence만 만들고, `solid_generate_verify`는 `solid_part` contract를 실제 STEP으로 직렬화한 뒤 별도 OpenCascade worker에서 재측정합니다. `rhino_preview`는 secondary evidence이며 공식 판정을 변경하지 않습니다.

## 검증

```powershell
$env:UV_LINK_MODE = "copy" # Windows OneDrive only
uv sync --frozen --extra dev
uv run --frozen ruff check src tests tools
uv run --frozen mypy src/datumguard
uv run --frozen pytest
Set-Location web
npm run typecheck
npm run lint
npm run build
```

Case Study, Architecture, Piping, FrameGuard, Plate, Solid, Artifact Lab, OpenBIM route의 브라우저 계약은 실제
FastAPI를 함께 시작하는 Playwright E2E로 검사합니다.

```powershell
Set-Location web
npm run test:e2e
```

[v0.4.0 release evidence](https://github.com/tjwnsdhfz/datumguard/releases/tag/v0.4.0)는 backend
**413 passed / 6 optional-runtime skipped**, Chromium Playwright **41 passed**, typecheck·lint·15-page
build, 두 container build, CycloneDX SBOM, fixed-critical scan, dependency review, pip audit와 두 CodeQL
language 결과를 실제 run에 연결합니다. 선택형 research workflow도 genuine OpenSeesPy와 PyG smoke를
[run 29194964854](https://github.com/tjwnsdhfz/datumguard/actions/runs/29194964854)에서 재실행했습니다.
Render 배포 완료 뒤의 Production smoke는 health `release_sha`까지 대조합니다.

합성 예제 계약은 Architecture의 [통과 4-room studio](fixtures/examples/architecture_four_room.json)·[300mm open-loop 실패](fixtures/examples/architecture_open_300mm.json), Piping의 [통과 CDA route](fixtures/examples/piping_utility.json)·[clearance 실패](fixtures/examples/piping_clearance_failure.json), FrameGuard의 [통과 pipe rack](fixtures/examples/frame_pipe_rack.json)·[missing-brace 실패](fixtures/examples/frame_pipe_rack_failure.json)로 제공합니다. 기존 Architecture fixture도 하위 호환 회귀용으로 유지합니다. 모든 예제는 실사업장 도면이 아닌 공개 합성 데이터입니다.

## 문서

- [Roadmap](ROADMAP.md)
- [Contributing Guide](CONTRIBUTING.md)
- [Citation](CITATION.cff)
- [PRD](docs/PRD.md)
- [TRD](docs/TRD.md)
- [Prompt Design](docs/prompt-design.md)
- [Architecture Demo Guide](docs/demo.md)
- [Piping Demo Guide](docs/piping-demo.md)
- [FrameGuard Structural Screening](docs/frameguard.md)
- [FrameGuard Surrogate Research Baseline](docs/frameguard-surrogate.md)
- [FrameGuard Rhino/Grasshopper Exchange and DXF Gate](docs/frameguard-rhino.md)
- [FrameGuard OpenSeesPy Parity](docs/frameguard-opensees.md)
- [FrameGuard PyG Benchmark and Uncertainty Gate](docs/frameguard-gnn.md)
- [3D Solid STEP Assurance](docs/solid-step.md)
- [Artifact Lab Guide](docs/artifact-lab.md)
- [BIM Awards 2026 · OpenBIM Evidence Guard](docs/awards-2026/README.md)
- [Engineering Domains](docs/engineering-domains.md)
- [Mission Control Design System](docs/design-system.md)
- [Deployment Guide](docs/deployment.md)
- [GitHub Deployment Guide](docs/github-deployment.md)
- [현재 구현·배포 Handoff](docs/HANDOFF.md)
- [개발 프롬프트 실행 순서](prompts/INDEX.md)

## License

MIT