Phase 1 MVP Backend & API Documentation Live

Milk Collection Platform for Rural Dairy Collectors

Digitizing the daily milk recording workflow, offline-first mobile sync, dual-ledger farmer accounting, and real-time subscription management.

Seeded Test Accounts & Credentials

Ready to test immediately in Swagger / Scalar or the Admin Console

AdminADMIN

Platform management & subscriptions

Phone: 0770000001
Password: adminpassword
Active CollectorMC0001

Saman Kumara (Active Sub)

Phone: 0771111111
Password: collector123
Inactive CollectorMC0002

Nimal Silva (Subscription Gated)

Phone: 0772222222
Password: collector123
FarmerF0001

Kamal Gunawardena

Phone: 0774444441
Password: farmer123

Core Phase 1 MVP Capabilities Implemented

Dual-Ledger Accounting

Maintains strict financial integrity. Collections and advances are immutable ledger records. Net Payable is dynamically computed as:Net Payable = Gross - Advances

Offline Sync Engine (/api/sync)

Designed for rural areas without internet. Collectors record entries with client-side UUIDs. When internet reconnects, the batch upserts idempotently to prevent duplicate entries.

Subscription Gating

Admins toggle collectors Active or Inactive with one switch. When inactive, any collection or sales attempt receives 403 Forbidden: "Subscription expired – contact support".