Koder Mosaic — `services/foundation/kompass/app`
Role in the stack
| Area | Sector | Consumers |
|---|---|---|
| Foundation | Flagship product app | End users managing organizations through Kompass |
Koder Mosaic is the cross-platform Flutter client for the Koder Kompass engine. It presents organization management as a terminology-aware, module-filtered operational app for companies, schools, churches, nonprofits, clubs, condos, cooperatives, and other organization types.
Primary couplings
| Module | Nature |
|---|---|
services/foundation/kompass/engine |
Source of org data, modules, terminology, members, units, vacancies, and current-user bootstrap |
services/foundation/pass/app |
Companion identity app and sign-in surface |
sdk-koder-kit (engines/sdk/koder_kit) |
App wrapper, telemetry, errors, and platform conventions |
Interfaces
| Surface | Contract |
|---|---|
MosaicShell |
Restores the last destination per org and renders module-filtered navigation |
HomeScreen |
Shows active org summary: members, units, vacancies, alerts, and enabled modules |
MembersScreen |
Directory filters, invitations, CSV import/export, bulk lifecycle actions |
MemberDetailScreen |
Member profile edit, tags, and notes |
OrgChartScreen |
Interactive tree/list org chart: rename, add child, move, archive units via bottom-sheet actions |
RolesScreen |
Roles CRUD, permission viewer grouped by resource, assign/revoke role to members by email lookup |
OrgSettingsScreen |
General (identity, contact, regional), Branding (colors, logos), Terminology (per-locale overrides), and Modules (toggle activation) |
KompassClient.getCurrentUserBootstrap() |
Consumes GET /api/v1/me/bootstrap when available |
KompassClient.getOrgModules() |
Falls back to GET /api/v1/organizations/{id}/modules |
Status
v1.0.3 (2026-04-26) — active. Interactive org chart editor (renameaddmovearchive units, layout toggle), Roles admin screen (CRUD + assignrevoke), and Org Settings screen (general, branding, terminology, modules).
v1.0.2 (2026-04-25) — active. AndroidiOS OAuth sign-in fixed: replaced local TCP server (errno=1 on Android) with app_links URI stream via `dev.koder.mosaic:authcallback` custom scheme. All prior functionality intact.
v1.0.1 (2026-04-24) — Koder ID bootstrap, org switching, terminology-aware core screens, shell telemetry, module-aware Home navigation, and member directory lifecycle workflows.