RUIL
ll1 + ll2 · Trade Rail
Trade Infrastructure
Mutual-credit ledger + Ubuntu obligation graph + Chain Builder + RUIL Days. Not a vertical — the protocol everything else sits on.
Pietarien Ecosystem · One System, Many Doors
One spine.
Ten doors.
One build.
Thirteen documents describe the same system from ten different angles. This page assembles the parts inventory, maps existing code to the architecture, and lays out what gets built first.
10Branded Doors
2Rail Layers (Trade + Intelligence)
6Build Phases
6Existing Code Projects
4Docs-only Verticals
"The parts are 90% sound but were designed as ten companies. The one-system build isn't about merging the plans — it's about building the spine they all implicitly assume: one identity, one ledger, one wallet, one compliance engine, one AI, one hub network, one data trust — and plugging into the capital that is already allocated to your users."
— Synthesis brief (first read.docx)
— Synthesis brief (first read.docx)
System Architecture
Four layers, two rails. Every vertical is a door into the same spine. RUIL is not a vertical — it's trade infrastructure.
Intelligence Rail — always on, zero marginal cost
Pieta
IP generation · 791 EPO patents · 29,175 atoms · $176 all-time cost
Nexus
Execution layer · 31 docs/idea · Factory, Doctorate, Book, Patent pipelines
Shared Core OS — build once, expose to all doors
Identity & Trust
FICA-once · OIDC · Ubuntu Ledger (4-dim reputation) · Category badges · Fraud graph
Money & Trade
Dual-ledger wallet (Rand + RUIL Credits + Points) · Escrow API · PayFast/Gumroad · VAT 404 notional ZAR
Logistics & Hubs
Multi-carrier (Pargo / Pudo / Courier Guy) · Hub network · Taxi-parcel grid · Donation routing
Compliance Engine
COA/R638 · SANS 2088 · CPA condition grading · PPRA/FICA · NLTAA · POPIA · OIP Guidance Note
Trade Rail — the protocol, everything else is an application
RUIL Credits
Mutual credit (Sardex/WIR model) · 10% cap / 3× debt cap · Never converts to Rand
Ubuntu Ledger
Ubuntu Bonds + Ubuntu Debt · Obligation graph, not a score · Graeber / Ostrom foundations
Chain Builder
Multi-step value chains · Mielies → Chips = 4× value · 5% Chain Bond per step
RUIL Days
Fortnightly physical markets · Market Day Elders · Stokvel Escrow on-site · 134RUIL# USSD
Ten Branded Doors — one identity, one wallet, one concierge across all
Lekker Local
Home cooks, crafts, after-hours services · Ouma model 80/20 · COA wizard
Beat Best Before
Food surplus · SANS 2088 · AI forecast · FoodForward SA donation
WINSKOPIES
Surplus / second-hand / discounted · Condition grading · Escrow
Surplus Solver
B2B overstock · R5bn distressed stock · ERP API · TCB donation
SaamStig
Branded products · Consignment resellers · R190bn informal retail
WERKNET
Jobs, gigs, micro-credentials · YES / SETA funding · SA Youth.mobi
Opstal
Property sales, rentals, holiday stays · PPRA/FICA · e-DRS · Fractional
AANWIEL
Vehicles, spares, rentals, mobile repair · R230bn used market
RONDRITS
Community transport · Minibus taxi grid · Holiday shuttles · NLTAA
WhatsApp Concierge
Single entry point · One USSD code · Routes any user to any door
Funding & Partnership Rails
Capital Rails
B-BBEE SED/ED obligations · PBO/18A status · Spaza Shop Support Fund (R500m) · NYDA R1k–R250k · SEFA/SEDFA · YES tax incentive · SETA grants
Government & Donation Partners
SA Youth.mobi · EPWP · e-DRS · Taking Care of Business (TCB) · FoodForward SA · SA Harvest · George Co-Existence model
Parts Inventory
13 source documents across 11 components. Status = current state of development materials.
Docs Only
Lekker Local
ll3 · Community Door
Community Door · Phase B Wedge
Micro-entrepreneurship entry point. Home cooks, crafts, after-hours. The Ouma model: platform handles tax, supplier keeps 80%.
WINSKOPIES
ll4 · Commerce Door
Commerce Door
Multi-category marketplace for surplus, second-hand, and discounted goods. Condition grading, escrow >R500, multi-carrier, 5% capped commission.
Beat Best Before
ll5 · Food Surplus Door
Food Door · Phase B Wedge
Edible surplus redistribution before waste. SANS 2088, PWA + WhatsApp, AI surplus forecast, FoodForward SA donation pathway.
Surplus Solver
ll6 · B2B Supply Door
B2B Supply Pipeline
Non-food overstock: hardware, clothing, electronics, industrial. Supply pipeline feeding WINSKOPIES + SaamStig. R5bn distressed stock opportunity.
SaamStig
ll7 · Branded Commerce
Branded Commerce Door
Community reseller network + affordable branded products. Consignment model (not credit — NCA safe). Tiered commissions 15→22%. R190bn informal retail.
WERKNET
ll8 · Human Capital Door
Human Capital Door
Jobs, skills, gig marketplace — the ecosystem's internal labour market. Zero-rated via SA Youth.mobi. YES/SETA funding. 33.6% unemployment context.
Opstal
ll9 · Asset Door
Property Door · Phase E
Sales, rentals, holiday stays, farms, plots. PPRA/FICA integration, e-DRS, fractional township ownership. R3tn township equity opportunity.
AANWIEL
ll10 · Mobility Door
Vehicle Door · Phase E
Vehicles, spares, rentals, leasing, repairs + mobile mechanics. R230bn used market. Mobile repair growing to R108bn by 2030.
RONDRITS
ll11 · Movement Door
Transport Door · Phase E
Community rides, holiday shuttles, minibus taxi digitisation, parcel grid on existing taxi routes. R60-100bn taxi market. NLTAA compliance.
Pieta + Nexus
ll12 · Intelligence Rail
Intelligence Layer · Production
Already production-grade. Nexus generates 31 docs per idea at zero marginal cost. Pieta: 697 patent packages, $176 all-time cost. Plug every door in.
The five personas insight: The same five fictional people recur across all eleven briefs — proof that ten doors are really one product for five personas.
Ouma
Home Producer
Lekker Local → Beat Best Before → SaamStig
Sipho
Reseller / Small Retailer
WINSKOPIES → Surplus Solver → SaamStig
Thandi
Aspiring Entrepreneur
WERKNET → Lekker Local → SaamStig → Nexus AI
Thabo
Farmer / Driver
RUIL → Lekker Local → RONDRITS → AANWIEL
Pieter
Asset Owner
Opstal → AANWIEL → RUIL → WINSKOPIES
Existing Code Assets
Six separate projects already exist. All use React + Tailwind. Four use Next.js. Two use Vite/React. The unified build picks one framework and one Supabase instance.
Door
Location & Stack
Key Features Built
Reuse Value
Lekker Local
Most CompleteVite · React · TypeScript · Supabase
LekkeLocal/lekkerlocal-creations-hub-main
Auth, orders, admin dashboard, seller dashboard, subscription, reviews, notifications, geo, cart
High — migrate auth + seller patterns
Beat Best Before
Vite · React · TypeScript · Supabase
BEAT BEST BEFORE/project
Auth, product cards, cart, order history, tracking, notifications
High — food listing + cart patterns
WINSKOPIES
Next.js · JavaScript · Tailwind
WinsKopies/createxyz-project
Listings, marketplace, categories, ratings, messages, watchlist, seller verify
High — listings + ratings patterns
Surplus Solver
Next.js · TypeScript · Tailwind
Surplus Solver/surplus solver
Listings, categories, dashboard, cart, auth guard, sell flow
Medium — B2B listing patterns
Opstal
Next.js · JavaScript · Tailwind
OPSTAL/createxyz-project
Property listings, booking, role selection, agent profiles, Pexels image search
Medium — property/booking patterns
AANWIEL
Next.js · JavaScript · Tailwind
AANWIEL NEW/createxyz-project
Vehicle listings, inquiries, search, user profiles
Medium — vehicle listing patterns
Unification Strategy
Framework choice: Next.js App Router — already used by 4 of 6 code projects. The two Vite projects (Lekker Local, Beat Best Before) are more feature-complete; their component and service patterns get migrated in, not their bundler.
Single Supabase instance — one auth, one schema, shared across all doors. The shared core OS (identity, wallet, compliance) lives here. Each door gets its own schema prefix but the same auth user.
Monorepo or single app? Single Next.js app with App Router route groups: /(lekker-local), /(winskopies), etc. Shared layout provides the nav, identity, and wallet. One deploy, one domain.
Build Phases
Sequencing by dependency first, then frequency. Identity and compliance before any door. Food corridor first — daily, universal, clearest trust story. Regulated verticals last.
A
0–3 months
Foundations & Capital · "The Spine"
Legal shell (Holding Pty + RUIL Cooperative + PBO/18A)
NCA-consignment restructure for SaamStig
Tax counsel — RUIL credits + VAT 404 notional ZAR
FICA-once identity MVP
Ubuntu Ledger v1
Dual-ledger wallet (Rand + Credits + Points)
Escrow API
WhatsApp Business concierge
134RUIL# USSD
B-BBEE SED capital proposals
Spaza Fund application
NYDA + SEFA registration
Pilot cell selection (1 town, 70+ traders)
Go/No-Go: 100 registered users with FICA-once · 500 multi-party transactions · 1 RUIL Day run · First R100k committed capital
B
3–9 months
Food Corridor · "The Wedge"
Lekker Local (COA wizard, verified badge, WhatsApp onboarding, Hub #1)
Beat Best Before (SANS 2088, PWA, POS auto-listing, FoodForward donation)
RUIL credits live on both
Curated Bundles v1 (weekly Ouma Box)
Group umbrella insurance live
Go/No-Go: 50 verified suppliers · 1,000 orders · 30% saving vs. supermarket basket · 100% COA compliance · Food kg recovered/month
C
9–15 months
Commerce Corridor · "The Engine"
WINSKOPIES (condition grading, WhatsApp listing, escrow >R500, Pargo/Pudo)
Surplus Solver (ERP API, multi-format, TCB donation)
SaamStig (consignment resellers, tier system, dropship, training)
Shared inventory lifecycle state machine
Loyalty points live
Hub #2
Go/No-Go: GMV per capita · Repeat-purchase rate · Inventory turn days · 50 resellers earning
D
12–18 months
Human Capital · "The People"
WERKNET (zero-rated via SA Youth.mobi, gig marketplace, micro-credentials)
Mentorship in RUIL Hours
YES / SETA funding pipeline
Nexus AI via WhatsApp (pricing calc, one-page plans, marketing kits)
Go/No-Go: 200 ecosystem gig placements · 100 micro-credentials · Employer satisfaction score
E
18–30 months
Asset & Mobility · "The Big Tickets"
Opstal (PPRA/FICA engine, e-DRS, booking engine, fractional township focus)
AANWIEL (vehicle-history API, mobile-mechanic marketplace, subscription)
RONDRITS (NLTAA compliance, WhatsApp booking, Opstal holiday transport)
Taxi-parcel grid pilot
Go/No-Go: Per-vertical transactions, trust incidents, dispute resolution time
F
24–36 months
Intelligence & Data Revenue · "The Flywheel"
Data trust + impact ledger products
IP services via Pieta (patent search for ecosystem inventors)
Ecosystem subscription "Pietarien One"
Cross-door loyalty burn
Second pilot cell + Hawala-style inter-cell netting
B-BBEE impact reporting as a service
Meta-metric: % of household spend circulating inside the ecosystem — money retained in community
Technical Requirements
Build the spine once. Partner for commodities. Never build twice across doors.
| Service | What it does | Build / Partner |
|---|---|---|
| Identity & Trust | FICA-once KYC · OIDC auth (Supabase) · Ubuntu Ledger obligation graph · 4-dim reputation · Category certification badges (COA, SANS 2088, PDP, roadworthy, FFC) · Fraud graph (cross-door visibility) | Build Core moat |
| Money Kernel | Dual-ledger wallet (Rand + RUIL Credits + Points) · Mixed-till checkout · Escrow API · Notional ZAR valuation feed (VAT 404 compliance) · Stokvel group escrow | Partner + Build PayFast/Gumroad payments; build credit ledger |
| Compliance Engine | Rule packs per vertical: COA/R638, SANS 2088, CPA 55(2) condition grading, Second-Hand Goods Act, PPRA/FICA, NLTAA, POPIA · Document generation templates · Regulator reporting APIs | Build + Counsel |
| Commerce Core | Listings · Condition grading · Inventory lifecycle state machine (listed → bundled → reserved → sold → donated) · Multi-format sales · Orders · Bundles engine · 5 personas' journeys as shared flows | Build |
| Logistics | Multi-carrier API (Pargo / Pudo / Courier Guy / PAXI) · Hub registry · Taxi-parcel route integration · Donation routing (FoodForward SA, TCB) · Delivery tracking | Partner Pargo, Pudo, Loop/AftaRobot |
| AI (Nexus) | WhatsApp concierge · Demand forecasting · Photo condition assessment · Skills matching · Sentiment analysis · Document factory (31 docs/idea) · Business plan + pricing calculator on demand | Partner-internal Already exists at :8090 |
| Channels | WhatsApp Business API (primary) · USSD gateway (134RUIL#) · Next.js PWA (offline-first) · Agent app for non-smartphone communities | Build + Partner USSD provider |
| Data & Impact | Shared warehouse across all doors · Township demand curves (what sells, at what price, which kasi) · Impact ledger: jobs created, meals saved, kg diverted, Rand retained · B-BBEE/SDG reporting for corporate SED clients | Build Revenue line + capital rail proof |
| Physical Ops | Hub network operations · RUIL Days protocol · Ecosystem agent programme · Stokvel liaison · Market Day Elders coordination | Ops, not tech |
Where We Start
Phase A: the unified Next.js project. One repo, one schema, the shared core. Lekker Local as the first door from Phase B.
01
Create the unified project
New Next.js App Router project at
pietarien-one/. App route groups for each door. Tailwind + shadcn/ui (already used across projects). Single Supabase project.02
Shared Core: Auth + Identity
FICA-once onboarding flow. Single Supabase Auth user covers all doors. Ubuntu Ledger schema. User reputation + certification badges tables.
03
Shared Core: Wallet + Ledger
Dual-ledger: Rand balance + RUIL Credit balance + loyalty points. Escrow for transactions >R500. Notional ZAR valuation log for tax compliance.
04
Migrate Lekker Local
Port the most-complete existing project (Vite → Next.js App Router). Seller dashboard, order flow, admin, reviews, subscription — all adapted to use the shared core auth + wallet.
05
WhatsApp Concierge
Single WhatsApp Business number that routes any user (new or returning) to any door. Nexus (:8090) answers natural language questions. USSD fallback for non-smartphone users.
06
Beat Best Before Door
Port second existing project. Connect BBB surplus listings to LL's shared auth + cart. Donation pathway to FoodForward SA live. SANS 2088 badge on supplier profiles.
Target Location for the Unified Project
D:\Nexus-Pietarien\1 LekkeLocal\pietarien-one\
New Next.js 14+ project. Pulls patterns from the six existing code projects but starts clean — no legacy bundler conflicts, one shared Supabase config, one Tailwind setup. The existing projects stay as reference/migration sources.
Say "start building" and the project gets scaffolded — shared core schema first, then Lekker Local door, then Beat Best Before. Or say which part you want to tackle first and we go there directly.