Skip to main content
Solo•Live in Production•Sept 2025 – Present

Tea Farm Management System (TFMS) — Enterprise Agricultural ERP

Commercial tea estate operations, agronomic intelligence, 7-logic payroll engine, and Safaricom Daraja M-Pesa B2C wage disbursements across 59 Next.js routes.

Tea Farm Management System (TFMS) — Enterprise Agricultural ERP
Tea Farm Management System (TFMS) — Enterprise Agricultural ERP Cover Banner
<0 min
Payroll Turnaround
0 Routes
App Router Pages
0 Logics
Payroll Models
0-Tier RBAC
Role Portals
The Challenge

Problem & Context

Commercial tea estates historically relied on paper tally books, physical weighbridge chits, and risky cash-in-transit wage payouts—causing leaf weight disputes, payroll errors, and 2–3 day disbursement delays.

An enterprise agricultural operations and financial management platform rebuilt on Next.js 16 (React 19, Turbopack), Django 5.1 REST Framework, and PostgreSQL 16—automating estate agronomy, weighbridge integrity, 7-model payroll, and direct M-Pesa B2C worker payouts.

Architecture & Delivery

Key Architectural Highlights

Re-architected into a decoupled Next.js 16 (59 App Router routes, glassmorphic UI) + Django 5.1 DRF Service-Selector backend secured by HttpOnly SameSite JWT cookies.
Built an agronomic sectioning engine categorizing estate blocks by tea clone (TRFK 306, Clone 31/8), slope, bush density, and digital weighbridge receipt slips with moisture/tare deductions.
Engineered a dynamic 7-logic payroll engine (fixed, per-kg, threshold commissions, task bonuses, and blended models) with immutable historical rate snapshots and OpenPyXL styled Excel reports.
Integrated Safaricom Daraja M-Pesa B2C SalaryPayment disbursements with idempotent asynchronous webhook handlers, cutting estate payroll turnaround to under 5 minutes.
Created a Virtual Time Manipulation Engine for testing 14-day plucking intervals and payroll cycle closures, alongside an ENABLE_DEMO_MODE 1-click switcher for Owner, Manager, and Worker portals.
Deep Dive

Engineering Challenges & Solutions

THE HARD PROBLEM

Adjusting per-kg plucking rates or daily threshold quotas mid-season can retroactively corrupt historical worker earnings in active pay cycles.

THE ARCHITECTURAL SOLUTION

Built DecimalField payroll calculation services in apps.finance that freeze point-in-time rate snapshots onto each WorkerPaymentPeriod before M-Pesa B2C dispatch.

Technology Stack

Tools & Technologies Used

Frontend Web
Next.js 16.4 (Turbopack)React 19TypeScript 5Tailwind CSSLucide
Backend API
Python 3.13Django 5.1.7DRF 3.15SimpleJWT (HttpOnly)OpenPyXL
Payments & Comms
Safaricom Daraja M-Pesa B2CBrevo Email APIVirtual Time Engine
Database & Cloud
PostgreSQL 16Nginx SNI + CertbotGunicornPM2Oracle Cloud ARM64
Interface Gallery

Visual Walkthrough & Captures

Estate Intelligence, Recharts Yield Trend & OpenPyXL Exports
Estate Intelligence, Recharts Yield Trend & OpenPyXL Exports
Estate Intelligence, Recharts Yield Trend & OpenPyXL Exports
Agronomic Sectioning & Clone/Block Profiles (TRFK 306)
Agronomic Sectioning & Clone/Block Profiles (TRFK 306)
Agronomic Sectioning & Clone/Block Profiles (TRFK 306)
Estate Finance Engine & Safaricom Daraja M-Pesa B2C Integration
Estate Finance Engine & Safaricom Daraja M-Pesa B2C Integration
Estate Finance Engine & Safaricom Daraja M-Pesa B2C Integration