본문으로 건너뛰기

Identity

마운팅과 통합

Mounting and integration principles for apps, APIs, and GUI flows.

마운팅과 통합

  • 공개 import는 from codaro import createServerApp이다. createServerApp()은 독립 실행 가능하면서 동시에 다른 서버에 마운팅 가능하다.
  • FastAPI: app.mount("/codaro", createServerApp())
  • Django: ASGI 라우팅 분기
  • Flask: WSGIMiddleware 래핑
  • 프론트엔드는 <meta name="codaro-base"> 태그에서 root_path를 자동 감지한다.
  • GUI에서 되는 모든 것은 API로도 된다 (시스템적 수정 가능).
  • 제품 브라우저의 구체 계약은 window.codaroGui다. product command는 실제 React callback을 호출하고, controls()는 아직 개별 command가 없는 보이는 control을 반사한다. 의미와 검증 기준은 docs/skills/architecture/gui-control-contract.md가 소유한다.
  • host server 마운팅은 전체 Codaro 제품 API를 붙이는 경로다. 선택 기능만 넣는 부분 임베딩은 codaro.publication의 block embed owner를 사용하며 server mount와 혼합하지 않는다.
  • GUI, HTTP API와 Python API는 같은 compiler, builder, verifier와 publication workbench를 호출한다. 각 진입점이 target 판정이나 rollback 규칙을 복제하지 않는다.

관련

  • [[execution-engine]] - 엔진 추상화
  • [[architecture-overview]] - transport 레이어
  • [[python-product-journey]] - 공개 Python API와 publication 전체 여정
  • [[block-embedding]] - 선택 기능 블록의 부분 임베딩 계약