Koder mosaic

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 crossplatform Flutter client for the Koder Kompass engine. It presents organization management as a terminologyaware, 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

*1.0.3 (20260426)*— active. Interactive org chart editor (renameaddmovearchive units, layout toggle), Roles admin screen (CRUD + assignrevoke), and Org Settings screen (general, branding, terminology, modules).

*1.0.2 (20260425)*— 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.

*1.0.1 (20260424)*— Koder ID bootstrap, org switching, terminologyaware core screens, shell telemetry, moduleaware Home navigation, and member directory lifecycle workflows.

Source: ../home/koder/dev/koder/meta/docs/stack/modules/koder-mosaic.md