Koder Kompass — services/foundation/kompass/engine
Role in the stack
| Area |
Sector |
Consumers |
| Foundation |
Organization substrate |
Mosaic and every multi-tenant SaaS module |
Koder Kompass is the canonical multi-tenant organization model for the Koder Stack. It treats organizations, members, units, terminology, roles, permissions, and active modules as reusable platform primitives.
Primary couplings
| Module |
Nature |
services/foundation/kompass/app |
Flagship Flutter client and main consumer of org APIs |
services/foundation/id/platform |
Authenticates Koder users and provides OIDC claims |
data/kdb |
Persists org graph, members, permissions, and configuration |
| Google Workspace |
Imports Workspace org units and groups into Kompass units |
Interfaces
| Surface |
Contract |
GET /api/v1/me/bootstrap |
Authenticated startup payload: user, orgs, memberships, roles, permissions, modules, default org |
GET /api/v1/organizations/{id}/modules |
Active module list for an org |
GET /api/v1/organizations/{id}/module-contracts, POST /api/v1/organizations/{id}/modules |
Module activation contracts with org-type defaults, dependencies, permissions, and audit |
GET /api/v1/members, GET /api/v1/units, GET /api/v1/vacancies |
Operational counts and screens consumed by Mosaic |
POST /api/v1/units/{id}/move, POST /api/v1/units/{id}/manager, POST /api/v1/units/{id}/vacancies, POST /api/v1/units/mutations |
Org chart mutation API: reparent, manager, vacancies, and batched visual-editor changes |
POST /api/v1/members/invitations |
Creates member invitations with expiry and resend support |
POST /api/v1/members/import/preview, POST /api/v1/members/import/commit |
CSV import validation, deduplication, and commit flow |
POST /api/v1/members/bulk, GET /api/v1/members/export |
Bulk lifecycle actions and filtered CSV export |
GET/POST /api/v1/members/{id}/notes, GET/POST/DELETE /api/v1/members/{id}/tags |
Member profile notes and tagging |
GET /api/v1/terminology/{orgId} |
Resolved terminology for org-specific labels |
Status
*1.0.0 (20260519)*— in development.