Platform Roadmap

How a sovereign platform got built.

The build story, told from the live git history — 3378 commits across 7 months, from the first Phoenix scaffold to a settling national network. Replay it, tour it, or ask the roadmap guide anything.

Replay the build
Narrated by the platform-aware AI agent — the same engine that ships inside Unityzm
git log --oneline · main Build ledger
3378commits
9 Feb 2026 → 16 Aug 2026 · ~219 feature branches · 12 chapters
merklelive·the build story
3378Commits since the first scaffold
Days from genesis to a settling network
~219Feature branches forked & merged
12Chapters in the build story
The story

12 chapters, in the order they shipped.

Curated from the commit history — each chapter is an epoch of the platform, with the milestones that defined it. The version rail tracks the story like a release ledger.

01
February 2026

GenesisAn umbrella, an identity, a front door.

121 commits

It starts the way every platform does — a single commit. In February the Phoenix umbrella is scaffolded, user profiles and authentication come online, and the public marketing site takes shape in the sovereign aesthetic. Quiet foundations for an ambitious idea.

9 Feb 2026 First commit — Phoenix umbrellaThe umbrella app is scaffolded; content views and layouts separated. Shipped
10 Feb 2026 User profiles, settings & authProfile dropdown, settings and sign-out wired over the default Phoenix auth. Shipped
Feb 2026 Sovereign landing siteThe public marketing chrome + landing copy in the uz- design system. Shipped
02
March 2026

The USN backboneEvery participant gets a network address.

174 commits

March introduces the idea that everything else hangs from: the Unityzm Sovereign Network. Participants are allocated a USN dial-up address, identity becomes a first-class registry, and the services layer begins — the addressing scheme that later lets money and logistics settle end-to-end.

Mar 2026 USN dial-up addressingEach participant is allocated a USN address — the routing key for the whole network. Shipped
Mar 2026 Identity & participant registryCore participants, reference types and the identity spine. Shipped
Mar 2026 USN services sprint 0The first network services built on the dial-up layer. Shipped
03
April – May 2026

A society comes onlineDirectory, feed, chat, KYC.

233 commits

With identity in place, people can find and talk to each other. A sovereign directory and search arrive, a social feed and chat with groups, and a guided six-step KYC/KYB flow that gates capabilities by verification tier. The platform stops being plumbing and starts being a place.

16 May 2026 Sovereign directory & searchPublicly mountable directory that widens with the viewer's scope. Shipped
16 May 2026 Feed, chat & groupsA live social feed, threaded chat and unified group threads. Shipped
15 May 2026 Tier-gated KYC/KYBSix-step verification; every chat/feed surface gated and auto-nudged by tier. Shipped
May 2026 Profile & brandingRich profiles and per-entity branding profiles. Shipped
04
May 2026

Money & complianceBankers-grade settlement, fiscalized.

370 commits

May is when value starts to move. A double-entry finance core with sub-second settlement, invoicing wired to ZRA fiscalization, an integration gateway for external providers, ward-level regional geography, and the first in-app AI assistant powered by Claude Code — the same engine that narrates this roadmap.

20 May 2026 Finance core & settlementsPooled virtual accounts, double-entry journals, sub-second finality. Shipped
22 May 2026 Invoicing + ZRA fiscalizationInvoice engine with tax-authority fiscalization. Shipped
22 May 2026 Integration gatewaySprint 0-1 of the external-provider gateway. Shipped
20 May 2026 In-app AI assistantClaude Code assistant + command palette across surfaces. Shipped
26 May 2026 RegionsWard-level geography powering routing and zones. Shipped
05
Early June 2026

Governance & portalsA kill-switch, a console, a citizen portal.

220 commits

June opens with control. A platform kill-switch and control center can pause finance or the whole network with a human in the loop; the commerce schemas are reconciled against the real database; and Citizen Portal v2 ships a navigable UserShell — home, wallet, discover — alongside a LiveKit + MinIO media engine.

3 Jun 2026 Kill-switch & control centerPause finance/global with a styled /down page and audit trail. Shipped
6 Jun 2026 Commerce reconciliationStore/catalogue/tax schemas aligned to the live DB (R-2c / r3). Shipped
8 Jun 2026 Citizen Portal v2UserShell: /home, /wallet, /discover and real money flows. Shipped
8 Jun 2026 Media engineLiveKit calls + MinIO object storage for media. Shipped
06
June 2026

The logistics engineQuote, dispatch, track, settle.

200 commits

The most ambitious epoch. A full logistics engine grows phase by phase: consignments and carriers, distance pricing and deterministic dispatch, live tracking, and a payout layer that locks real escrow and releases it on delivery with a 15% commission — proven to settle end-to-end over the USN. Then a deterministic agent layer — Convoy, Waypoint, Tally — automates it.

Jun 2026 Consignment & carrier (P2)The shipment primitive and carrier model. Shipped
Jun 2026 Pricing, dispatch & tracking (P3–P5)Distance fares, deterministic dispatch, live carrier tracking. Shipped
Jun 2026 Payout & real escrow (P6)Logistics-owned escrow lock → release → commission; real USN settlement. Shipped
10 Jun 2026 Agent layer L3–L6Deterministic Convoy / Waypoint / Tally agents automate dispatch. Shipped
07
June 2026

Merchant → StorefrontFrom warehouse to buyer, for real.

90 commits

The newest chapter turns a rich demo into a real, Postgres-backed economy. Merchants get a portal — warehouse, scan, processing, network, finance — built on a per-merchant asset engine. Admins get cross-merchant stock oversight. And the public buyer storefront reserves certified stock end-to-end: a real order, escrow, and a logistics consignment, tracked live.

Jun 2026 Merchant portal & asset scanWarehouse, scan/move, processing, network and finance over a real asset engine. Shipped
10 Jun 2026 Admin stock oversight/admin/stock — cross-merchant aggregates over the real stock domain. Shipped
10 Jun 2026 Public buyer storefront/store — reserve → order + escrow + consignment, tracked live. Shipped
08
June 2026

Solution editionsOne platform, many deployable products.

50 commits

The platform is packaged into deployable solution editions — declarative catalogues that boot only the apps an edition needs — alongside an IP-licensing model and a production deployment path. What was one monolith becomes a family of products.

10 Jun 2026 Solution editions catalogueSix editions as declarative data; selective node startup per edition. Shipped
Jun 2026 IP licensing & business modelOwner retains IP, licenses deployable editions as separate streams. Shipped
Jun 2026 Production deploymentCapRover model + installer + readiness hardening. Shipped
09
June 2026

Rails & the AI economyMoney in, intelligence metered, ads that pay.

60 commits

Platform payment rails — Wire/Showcase feeds, payment onboarding, TOTP and AI-wallets, temporal-participant registration — put real money in motion, while a Postgres AI usage ledger meters every model call, surfaced live in /focus and reconciled in an admin spend dashboard. A Showcase ads engine earns its keep through a billing spine, and a Zedi onboarding flow hands a new citizen a credit wallet from just a phone number and an authenticator.

Jun 2026 Platform payment railsWire/Showcase feeds, payment onboarding, TOTP + AI-wallet, temporal-participant registration. Shipped
13 Jun 2026 AI usage ledger & spend dashboardPostgres ledger of every model call; live /focus panel + /admin/finance/ai-ledger. Shipped
13 Jun 2026 Showcase ads engine + billingSpreads, templates, moderation and an Art Director, paid via the ads/campaign billing spine. Shipped
Jun 2026 Zedi onboarding + credit walletPhone + authenticator → reserved lifelong usn_id → claimable AI-credit wallet. Shipped
10
July 2026

The multi-tenant operations platformOne cockpit, many tenants, branded per client.

110 commits

The platform learns to carry many operators at once. A generic operations cockpit renders every tenant from a single descriptor — nav, screens and metrics gated by the tenant's operation type — so a new client is a config record and its ingested data, never a code change. Event-sourced traceability tracks lots through their lifecycle with printable QR/barcode labels and an append-only, hash-chained ledger; a /wall control-room pairs a live board with a map. Tenants get their own two-panel branded sign-in, self-registering sub-clients under maker-checker approval, scoped dashboards and their own developer portal — and every settlement now posts to a real double-entry ledger. Descriptor-driven provisioning, a DB descriptor catalogue, a tenant-setup audit trail and CSV operational ingest make onboarding reproducible.

5 Jul 2026 Operations cockpit v2Generic management renderer; nav, screens and seed metrics gated per tenant by operation type. Shipped
5 Jul 2026 Event-sourced traceabilityLot lifecycle with labelled tag-ranges, printable QR/barcode sheets and an append-only ledger. Shipped
6 Jul 2026 /wall control-room + analytics deckBoard + live map view with a data-layer seam; throughput, aging, conversion and cycle dashboards. Shipped
7 Jul 2026 Per-tenant branding & sign-inBrand-driven two-panel admin + partner login; the shell wears each tenant's name and palette. Shipped
7 Jul 2026 Sub-client platformSelf-registration, maker-checker approval, scoped dashboards, own users, reports/CSV and a dev portal. Shipped
7 Jul 2026 Double-entry settlement ledgerEvery settled settlement posts real double-entry GL postings, surfaced in an admin ledger view. Shipped
22 Jul 2026 Descriptor-driven provisioningDB descriptor catalogue + import task, tenant-setup audit events and generic CSV operational ingest. Shipped
11
July 2026

Governance, telemetry & the design programMaker-checker everywhere, and a fleet you can watch.

60 commits

The story's live edge. Sensitive operations move behind hold-then-execute maker-checker gating with an approvals queue, a per-user notifications centre and a separation-of-duties fix so approver and maker are never the same person under a shared token. An audit spine emits signed events for tenant provisioning, RBAC grants, ops-config and kill-switch changes. A 17-feature operations design program — financials, fleet & movement, operations, people and cross-cutting — is designed and approved, each feature feeding the tenant cockpit additively. And fleet telemetry lands: fuel and GPS pings with a simulated-provenance guard so real operator maps exclude simulation by default, a supervised per-trip journey simulator and a demo seed, all gated off production.

22 Jul 2026 Maker-checker approvals & notificationsHold-then-execute gating on certify/dispatch, KPIs, a per-user notifications centre and an SoD fix. Shipped
22 Jul 2026 Audit spineTenant provisioning, RBAC grants, ops-config and kill-switch changes emit signed audit events. Shipped
23 Jul 2026 17-feature ops design programFinancials, fleet & movement, operations, people and cross-cutting clusters — all designed & approved. Shipped
23 Jul 2026 Fleet telemetry foundationFuel + GPS pings with a simulated-provenance guard; real reads exclude simulation by default. Shipped
23 Jul 2026 Journey simulation runtimeSupervised per-trip simulator + demo seed for lifelike carrier movement, gated off production. Shipped
12
August 2026 · now

The front door, and the handsetOpened to the public, carried in a pocket, and shipped through a gate.

517 commits

The busiest month of the build, and the one where the platform stopped being something you were shown and became something you could walk into. The public site goes live and then earns its keep: fifty-nine badges that used to be decoration become answerable service pages, and time itself becomes bookable, with overlapping reservations refused by the database rather than by hopeful application code. A mobile runtime arrives — a brand kernel, a capability gate that refuses rather than degrades, a network link that treats being offline as the normal state, and a push service of our own with a third-party transport demoted to one option behind it. Access is put behind invitation: a wall, an acceptance journey, and a queue for people asking to be let in. The build story itself is published — twenty-seven essays, written as the work happened. And the engineering underneath gets its own discipline: the test gate goes from thirty-four apps to forty of forty-one behind a ratchet that cannot quietly rot, and production stops shipping by hand — every release now travels the pipeline, on a protected ref, attributable to the commit that was actually tested.

7 Aug 2026 The public front door goes liveThe marketing site ships to production as the platform's first public surface. Shipped
13 Aug 2026 Badges become servicesFifty-nine front-door badges become answerable service pages with an admin editor and a demand list. Shipped
14 Aug 2026 Bookings — reserving timeTime becomes bookable; overlapping reservations are refused by a Postgres EXCLUDE constraint, not by application checks. Shipped
14 Aug 2026 A mobile runtimeBrand kernel, a capability gate that refuses rather than degrades, and a network link that treats offline as normal. Shipped
14 Aug 2026 Our own push serviceNotifications the platform owns, with a third-party service demoted to one transport behind it, and sign-out that revokes. Shipped
15 Aug 2026 Invitation-only accessAn invite wall, an acceptance journey and a queue for people asking to be invited. Shipped
15 Aug 2026 The build story, in publicTwenty-seven essays on how the platform was built, written as it happened and published from the vault. Shipped
15 Aug 2026 The gate closesThe test gate goes from 34 apps to 40 of 41, the last held behind a known-open ratchet asserted as an equality so the list cannot rot. Shipped
15 Aug 2026 Production ships through the pipelineDeploys move off local scripts onto a manual job on a protected ref — attributable, gated, running the commit that was tested. Shipped
16 Aug 2026 Crawled on our termsThe AI training crawl is declined in robots.txt, and the sitemap starts advertising every live page instead of a fifth of them. Shipped
The branch graph

Branches forked. One spine.

Every epoch forked from main and merged back. When the roadmap is served from the source repository, this view renders the live commit DAG — lanes, merges, refs, stashes and unpushed work.

branch FebMarAprMayJunJulAug
● main
site · services · bookings · mobile
usn-dialup → services
directory · feed · chat · kyc
finance · settlements · invoice
integration-gateway
platform-kill-switch
user-portal-v2 · media
logistics p2 → p7
logistics L3 → L6 agents
merchant → portal-stock → store
solution-editions
operations-cockpit · sub-clients
approvals · audit · notifications
fleet-telemetry · simulator
main spine feature branch · fork → merge live DAG renders when served from the repo
What's next

Upcoming work, in flight and planned.

Curated from the active branches and the deferred follow-ups. Statuses move as branches merge.