ProjectPermit / BuildRequirements — Phase 0

ProjectPermit은 건축 및 리노베이션 프로젝트를 위한 증거 연계형 지자체 허가 사전 검토 엔진입니다. BuildRequirements는 그 내부에 있는 결정적 규칙 엔진입니다.

Phase 0은 다음을 지원합니다:

• gatineau_qc

• ottawa_on

• 8개 프로젝트 패밀리

• 지자체 GIS/지오코더를 사용한 주소 해석

• 규칙 버전 및 오버레이를 고려한 결과

• 모든 규칙 결과에 대한 공식 출처 증거

• FastAPI 엔드포인트 및 표준 MCP 도구

• 유료 전송 계층과 규칙 엔진 간의 x402 대비 분리

엔진은 의도적으로 LLM을 호출하지 않습니다. 호출 에이전트는 자연어 범위를 구조화된 사실로 정규화하며, BuildRequirements는 결정적 지자체 규칙을 적용합니다.

빠른 시작

python -m venv .venv
source .venv/bin/activate
pip install -e .
uvicorn projectpermit.api:app --host 127.0.0.1 --port 8000

MCP 지원을 위해:

pip install -e '.[mcp]'
projectpermit-mcp

projectpermit-mcp는 MCP Python SDK v2 Streamable HTTP, JSON 응답, 그리고 무상태 HTTP를 사용합니다. 기본적으로 127.0.0.1:8001에서 수신 대기합니다. PROJECTPERMIT_MCP_HOST와 PROJECTPERMIT_MCP_PORT로 재정의할 수 있습니다.

테스트 실행:

PYTHONPATH=src python -m unittest discover -s tests -v

Related MCP server: Canadian Building Code MCP Server

API

POST /v1/check-project-requirements

예시:

{
  "jurisdiction": "ottawa_on",
  "address": "110 Laurier Ave W, Ottawa, ON",
  "resolve_address": false,
  "project": {
    "family": "window_door",
    "action": "enlarge_existing_window",
    "structural_change": true
  }
}

결과는 사전 검토 정보 패키지이며, 지자체 허가, 법률 자문, 엔지니어링 인증, 또는 건축 코드 설계 승인이 아닙니다.

저장소 구성

• src/projectpermit/engine.py — 결정적 규칙 엔진

• src/projectpermit/address.py — 지자체 주소/GIS 어댑터

• src/projectpermit/api.py — HTTP API

• src/projectpermit/mcp_server.py — 표준 MCP 서버

• data/golden_cases.json — 결정적 회귀 테스트 코퍼스

• data/source_manifest.json — 공식 출처 레지스트리/신선도 메타데이터

• schemas/ — 공개 요청/응답 스키마

• docs/PHASE0_SPEC.md — 제품 및 엔지니어링 범위

• docs/X402_ARCHITECTURE.md — 결제/발견 설계

Base Sepolia x402 스모크 프로필

공개 값 전용 테스트넷 프로필이 config/x402.base-sepolia.env.example에 제공됩니다. 이는 Base Sepolia(eip155:84532)와 x402.org 테스트넷 퍼실리테이터를 대상으로 합니다. 수신 주소는 공개입니다. 이 저장소에 개인 키나 시드 문구를 절대 넣지 마십시오.

set -a
source config/x402.base-sepolia.env.example
set +a
pip install -e '.[x402]'
uvicorn projectpermit.api:app --host 0.0.0.0 --port 8000

보호 대상 리소스는 POST /v1/check-project-requirements입니다. /health는 배포 모니터링을 위해 무료로 유지됩니다.

실제 유료 스모크 테스트

이 테스트는 자신의 머신에서만 실행하십시오. 지불자 개인 키를 로컬에 보관하고, 절대 붙여넣거나 커밋하지 마십시오.

python -m venv .venv-buyer
source .venv-buyer/bin/activate
pip install -e '.[buyer]'
export EVM_PRIVATE_KEY='0x...'
python scripts/x402_paid_smoke.py

지불자 지갑에는 $0.01 테스트 결제를 위한 충분한 Base Sepolia USDC가 있어야 합니다. 성공적인 실행은 HTTP 200과 디코딩된 정산 응답을 반환해야 합니다. 서버 자체는 지불자 개인 키를 절대 필요로 하지 않습니다.

Phase 0 안전 경계

불확실성이 존재하는 경우, 판정은 의도적으로 LIKELY_REQUIRED, LIKELY_NOT_REQUIRED, ADDITIONAL_REVIEW_REQUIRED, MUNICIPAL_CONFIRMATION_REQUIRED와 같은 사전 검토 표현을 사용합니다. 엔진은 지자체, 허가 발급 기관, 변호사, 건축가, 또는 엔지니어로 제시되어서는 안 됩니다.