Deploy guide and platform specs
Go-live steps, deployment tiers, API reference, and technical deliverables — in one place.
Four steps to production traffic
Same path for YCA Construction and ProcureIQ.
Terraform — skeleton in your cloud
customer-instance modules provision Artifact Registry, Cloud Run, GCS documents bucket, Secret Manager shells, and CI deploy IAM — typically under one hour.
GitHub Actions — same image as production
Push to main builds linux/amd64, publishes to Artifact Registry, and deploys Cloud Run with DOMAIN_CONFIG_PATH and INSTANCE_TIER — zero custom Dockerfile per vertical.
Ansible — secrets, schema, seed
Vault → Secret Manager → Cloud Run env; postgres_schema + seed_apply render domain_config and vertical SQL; smoke checks /health, /version, Postgres, Qdrant.
Production traffic — branded surface
Vercel Frontend (enterprise) or your UI/BFF (API tier) connects to QueryTextStream/v2. Admins manage prompts and intents — no redeploy for copy changes (roadmap).
Sandbox, Enterprise, or Dedicated Stack
Match packaging to who owns the cloud, UI, and keys.
Fastest path to a branded B2C/B2B product
Full YcaOS on Bold-managed infra: Vercel Frontend + Backend + Payment.API + yca-auth. Custom domain, Stripe optional, 99.5% SLA target. Live: YCA Construction Advisor (czatbudowlany.pl).
Keep your frontend; inherit the intelligence engine
Backend Cloud Run only — your UI/BFF owns UX. QueryTextStream/v2 + MCP Streamable HTTP for customer Neo4j, ERP, or supplier graphs. Live: ProcureIQ / Lindle.
Maximum control for enterprise procurement
Full stack in customer GCP: Cloud SQL, GCS, Firebase/OIDC, Qdrant, Vercel or self-hosted UI. BYOK, custom MCP tools, premium SLA (99.9% target), data residency for regulated buyers.
Integration endpoints
Streaming chat, health checks, and admin APIs on Cloud Run.
| Method | Path | Description |
|---|---|---|
GET | /health | Ansible smoke + Cloud Run liveness — proves instance is operable before handover |
GET | /version | api_version from domain_config + GIT_SHA — audit trail for enterprise buyers |
GET | /QueryTextStream/v2 | Primary revenue path: SSE chat, intent routing, tool orchestration, structured panels (ProcureIQ + YCA) |
GET | /api/documents/* | Document ingest & management — feeds the 7-step DocumentPipeline that powers RAG |
POST | /mcp/ | Customer-hosted MCP (tools/list, tools/call) — extend the agent with ERP, graph, or legacy APIs |
What's in the box
Core building blocks and what engineering receives on handoff.
Document Intelligence
Advanced OCR and semantic chunking for enterprise-scale unstructured data processing.
LLM Integration
Seamless Langfuse observability and trace logging for every prompt and model execution.
Cloud Whitelabeling
Rapid deployment of branded AI instances without modifying a single line of core logic.
Handoff deliverables
Pre-optimized database schemas for relational and vector workloads.
Kubernetes manifests and Terraform states for reproducible environment setup.
Baseline configurations and whitelabel assets for the branding engine.