Skip to main content
Partnered•Live in Production (247 Tests Passing)•2026 – Present

Tuko Pamoja — Multi-Tenant Double-Entry Fund Accounting & Membership Platform

Audit-grade multi-tenant community finance platform with ring-fenced funds, maker-checker workflows, and 247 automated tests.

Tuko Pamoja — Multi-Tenant Double-Entry Fund Accounting & Membership Platform
Tuko Pamoja — Multi-Tenant Double-Entry Fund Accounting & Membership Platform Cover Banner
0 Passed
Automated Tests
0%
Test Pass Rate
0-Entry Ledger
Financial Integrity
0-Person Rule
Control Standard
The Challenge

Problem & Context

Savings groups and welfare associations often commingle funds in informal spreadsheets with zero separation of duties, lost audit trails, and insecure handling of sensitive member claim records.

An enterprise-grade, multi-tenant community financial management and double-entry fund accounting Progressive Web App (PWA) engineered for chamas, welfare associations, and cooperative groups.

Architecture & Delivery

Key Architectural Highlights

Built an audit-compliant double-entry ledger ring-fencing designated funds (Welfare, Emergency, Sinking) with automatic member obligation allocation and available credit tracking.
Enforced Maker-Checker separation of duties at the API layer so officers recording receipts or drafting expense payouts cannot independently verify or finalize their own entries.
Engineered a two-phase bulk CSV roster importer executing complete relational validation and duplicate checks with zero database writes on preview, followed by an atomic commit.
Created a high-precision ReportLab PDF engine (two-pass NumberedCanvas 'Page X of Y', repeated headers) and OpenPyXL Excel exporter with spreadsheet formula injection defense.
Maintained a 100% pass rate across 247 automated tests (178 Django backend tests + 69 Vitest frontend tests) with immutable audit logging and memory-stored JWT + HttpOnly cookie auth.
Deep Dive

Engineering Challenges & Solutions

THE HARD PROBLEM

In small savings groups, allowing one treasurer to both record cash/M-Pesa receipts and mark them as verified creates a major fraud and audit vulnerability.

THE ARCHITECTURAL SOLUTION

Implemented API-enforced Maker-Checker state machines requiring a second independent officer to verify inflows against bank/M-Pesa statements and confirm expense disbursements before ledger posting.

Technology Stack

Tools & Technologies Used

Backend & Ledger
Django 5DRF 3.15Python 3.13PostgreSQLDjango-Q2
Frontend PWA
React 18/19TypeScriptVite 5Workbox PWAVitest
Reporting & Security
ReportLab 5.1OpenPyXLHttpOnly Refresh JWTImmutable Audit Log
Deployment
Oracle Cloud ARM64NginxGunicornPM2Brevo SMTP
Interface Gallery

Visual Walkthrough & Captures

Pamoja QA Welfare Admin Workspace & Contribution Plans
Pamoja QA Welfare Admin Workspace & Contribution Plans
Pamoja QA Welfare Admin Workspace & Contribution Plans
Maker-Checker Expenses & Disbursements Workflow
Maker-Checker Expenses & Disbursements Workflow
Maker-Checker Expenses & Disbursements Workflow
Community Financial Reports & Excel Export Engine
Community Financial Reports & Excel Export Engine
Community Financial Reports & Excel Export Engine