Przewodnik wdrożenia i specyfikacja platformy
Kroki go-live, tiery, API i deliverables techniczne — w jednym miejscu.
Cztery kroki do ruchu produkcyjnego
Ta sama ścieżka co YCA Construction i ProcureIQ.
Terraform — szkielet w Twojej chmurze
Moduły customer-instance provisionują Artifact Registry, Cloud Run, bucket GCS, Secret Manager i IAM dla CI — zwykle w ok. godzinę.
GitHub Actions — ten sam obraz co produkcja
Push na main buduje linux/amd64, publikuje do Artifact Registry i wdraża Cloud Run z DOMAIN_CONFIG_PATH i INSTANCE_TIER.
Ansible — sekrety, schemat, seed
Vault → Secret Manager → env Cloud Run; postgres_schema + seed_apply; smoke /health, /version, Postgres, Qdrant.
Ruch produkcyjny — Twoja marka
Vercel Frontend (enterprise) lub UI/BFF klienta (tier API) łączy się z QueryTextStream/v2. Zarządzanie promptami bez redeploy (roadmap).
Sandbox, Enterprise lub Dedicated Stack
Dopasuj pakiet do tego, kto trzyma chmurę, UI i klucze.
Najszybsza ścieżka do brandowanego produktu B2C/B2B
Pełny YcaOS na infra Bold: Vercel Frontend + Backend + Payment.API + yca-auth. Własna domena, opcjonalny Stripe, SLA ~99,5%. Na produkcji: YCA Construction Advisor (czatbudowlany.pl).
Zachowaj frontend — odziedzicz silnik inteligencji
Tylko Backend Cloud Run — UI/BFF klienta. QueryTextStream/v2 + MCP Streamable HTTP dla Neo4j, ERP lub grafów dostawców. Na produkcji: ProcureIQ / Lindle.
Maksymalna kontrola dla enterprise procurement
Pełny stos w GCP klienta: Cloud SQL, GCS, Firebase/OIDC, Qdrant. BYOK, narzędzia MCP, SLA premium (99,9%), residency dla branż regulowanych.
Endpointy integracyjne
Streaming chat, health checki i API admina na Cloud Run.
| Metoda | Ścieżka | Opis |
|---|---|---|
GET | /health | Smoke Ansible + liveness Cloud Run — dowód operacyjności przed przekazaniem |
GET | /version | api_version z domain_config + GIT_SHA — audyt dla kupujących enterprise |
GET | /QueryTextStream/v2 | Główna ścieżka produktu: SSE czat, routing intencji, orkiestracja narzędzi, panele |
GET | /api/documents/* | Ingestia i zarządzanie dokumentami — DocumentPipeline 7 kroków napędza RAG |
POST | /mcp/ | MCP u klienta (tools/list, tools/call) — rozszerz agenta o ERP, graf, legacy API |
Co jest w pudełku
Rdzeniowe elementy i co inżynieria dostaje przy przekazaniu.
Inteligencja dokumentów
Zaawansowany OCR i semantyczne chunkowanie dla przetwarzania danych nestrukturalnych w skali enterprise.
Integracja LLM
Płynna obserwowalność Langfuse i logowanie trace dla każdego promptu i wykonania modelu.
Whitelabel chmurowy
Szybkie wdrożenie brandowanych instancji AI bez modyfikacji core logic.
Deliverables
Wstępnie zoptymalizowane schematy DB dla obciążeń relacyjnych i wektorowych.
Manifesty Kubernetes i stany Terraform dla powtarzalnej konfiguracji środowiska.
Konfiguracje bazowe i assety whitelabel dla silnika brandingu.