Home

go-platform wiki

go-platform is the Go layer of Apostol CRM: a library and a set of platform packages that put a Go process behind Gateway API and over the api.* functions of db-platform. The repository's README says what the code is. This wiki says how applications are built on it and how existing ones move to it.

The pages are written for AI agents first: each states the rule, the reason, and the check, in that order. A human reads them the same way.

Page	What it decides
Development-Strategy	how an application on Apostol CRM is built now that business logic can live in Go: the three layers, what stays in PostgreSQL, what goes to Go, what C++ keeps; the layout of a project; the stages of the platform; the rules for agents
API-v1-to-v2-Migration	the procedure for moving an existing application from /api/v1 (routes dispatched in PostgreSQL) to /api/v2 (routes served by Go): inventory, shape translation, packages, parity tests, switching consumers, retiring rest.*, traps

Conventions of /api/v2, the request path, the control plane and the configuration of a process are in the README; the control-plane protocol is in the Gateway API README. This wiki does not repeat them.