ICPI Live Cutover Window
Window Goal
Execute the first real env-only ICPI gateway cutover in the current runnable environment by switching only the API gateway target from old colocated ICPI hosting to the extracted runtime.
Resolving locale, route permissions, and workspace projection.
Current scope: Guest
Category: 10_normative | Version: v1.0.0
Owner: DOCUMENT_CUSTODIAN | Review cycle: 90 days
Approval authority: GOVERNANCE_ADMIN
Documentation portal is read-only. Editing and mutation endpoints are disabled.
Kvary platform is originally created in Georgian. Where a Georgian version exists, Georgian is authoritative for platform UI, documentation, and legal interpretation.
Translations into other languages are provided for convenience. Some records may originate in other languages and carry their own source or legal locale for a specific flow, but where a Georgian version is available, the Georgian version prevails for platform-level wording and interpretation.
Metadata incomplete: Document ID, Version, Status, Owner Role, Last Review Date, Next Review Date, Change Log
Execute the first real env-only ICPI gateway cutover in the current runnable environment by switching only the API gateway target from old colocated ICPI hosting to the extracted runtime.
svc-icpiConstraints held during the window:
ICPI_SERVICE_URL=http://127.0.0.1:4020TENDERS_SERVICE_URL=http://127.0.0.1:4020ICPI_SERVICE_URL=http://127.0.0.1:4021TENDERS_SERVICE_URL=http://127.0.0.1:4020Only the ICPI upstream target changed.
No gateway route definitions changed. No gateway auth middleware changed.
svc-auth on :4100svc-tenders on :4020svc-icpi on :4021:40014001, 4020, 4021, 4100svc-authsvc-tenderssvc-icpi:4020GET /icpi/prices?page=1&pageSize=1 returned 200GET /icpi/prices?page=1&pageSize=1 returned 200GET /api/v1/icpi/prices?page=1&pageSize=1 returned 200POST /api/v1/icpi/upsert succeededGET /api/v1/icpi/latest/:itemCode read-back succeeded401 missing_bearer_tokenVerification item used:
itemCode: ICPI_S52_MMUXY4ERICPI_SERVICE_URL=http://127.0.0.1:4021TENDERS_SERVICE_URL=http://127.0.0.1:4020GET /api/v1/icpi/prices?page=1&pageSize=1GET /api/v1/icpi/suggest?query=cutover®ion=GE&limit=5POST /api/v1/icpi/upsert with authenticated happy-path payloadGET /api/v1/icpi/latest/:itemCode?region=GEGET /api/v1/icpi/estimate?itemCode=:itemCode&quantity=2®ion=GEPOST /api/v1/icpi/upsert without bearer tokenComparison target after cutover:
:4021200svc-icpi401 missing_bearer_tokenTo make the cutover real in the current monorepo workflow, the default local gateway seam was updated:
devdev:coredev:apiThese now point ICPI to http://localhost:4021.
Rollback remains explicit via:
dev:api:icpi-fallbackPort cleanup/bootstrap support was also updated in:
Yes, at the seam/config level.
The gateway default in the current local workflow now points at extracted svc-icpi, and no rollback was needed during the cutover window.
Old colocated ICPI hosting remains available for fallback.
After the observation window and documentation capture:
svc-icpi