ICPI Cutover Parity Checklist
Purpose
This checklist is the low-risk parity gate before pointing live or shared dev traffic at svc-icpi.
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
This checklist is the low-risk parity gate before pointing live or shared dev traffic at svc-icpi.
GET /api/v1/icpi/prices returns the same JSON shape and pagination fieldsGET /api/v1/icpi/suggest returns the same suggestion shape and region fallback behaviorGET /api/v1/icpi/latest/:itemCode returns the same 404 icpi_not_found behaviorGET /api/v1/icpi/estimate returns the same estimate shape and 400 invalid_estimate_query behaviorPOST /api/v1/icpi/upsert still requires gateway authsvc-icpi service still requires service-side bearer auth on /icpi/upsert401 reason familyprincipal_resolution_failedsourceKey normalization still defaults to SRFcurrency normalization still defaults to GELsourceKey, year, quarter, regionCode, itemCode, unit, currencyreceivedacceptedduplicatesDroppedsourceKeysourceVersionICPI_SERVICE_URL can point to http://localhost:4021TENDERS_SERVICE_URL remains unchanged for all non-ICPI trafficAUTH_SERVICE_URL is set for the new svc-icpi runtimeDATABASE_URL is set for the new svc-icpi runtimeJWT_SECRET is set for the new svc-icpi runtimenpm --prefix services/svc-icpi run buildnpm --prefix services/svc-icpi run start with required envnpm --prefix services/svc-tenders run build still passes while old host remainsGET /api/v1/icpi/* without route changesPOST /api/v1/icpi/upsert without route changesICPI_SERVICE_URL=http://localhost:4021 is enough to redirect ICPI traffic without changing gateway codesvc-tendersICPI_SERVICE_URL back to the old host or unsetting it502 icpi_service_unavailable504 icpi_service_timeout401 spikes on ICPI upsert