NCWS-DMS is a brand-new, standalone digital system. It does not replace an existing software product it replaces manual paper-based processes currently used at most of Rwanda's 300+ coffee washing stations.
# NCWS-DMS: National Coffee Washing Station Digital Management System
A comprehensive government-scale digital platform for managing Rwanda's coffee washing station operations. Digitize coffee production from farm delivery through export with real-time traceability, transparent farmer payments, and government monitoring capabilities.
---
## Quick Start
### 3-Minute Setup
```bash
# 1. Install dependencies
pnpm install
# 2. Start the app
pnpm dev
# 3. Open your browser
#
localhost
```
**Demo Login:**
```
Username: admin | Password: password
```
See QUICKSTART.md for more options.
---
## System Overview
### What NCWS-DMS Does
**For Farmers:**
- Simple delivery recording with SMS receipts
- Transparent payment tracking
- Access to delivery history
**For Washing Stations:**
- Digital farmer registration
- Cherry delivery management
- Fermentation batch tracking
- Drying bed monitoring with moisture levels
- Production & export reporting
**For Government (NAEB/MINAGRI):**
- Real-time national production monitoring
- District-level analytics
- Production forecasting
- Export tracking
- Data-driven policy making
### Key Features
✅ **Farmer Registration** - Unique ID generation, duplicate prevention, profile management
✅ **Cherry Delivery Tracking** - Weight recording, automatic payment calculation, receipt generation
✅ **Fermentation Batch Management** - Batch lifecycle tracking, tank management, time scheduling
✅ **Drying Bed Monitoring** - Moisture level tracking, temperature/humidity monitoring, completion status
✅ **Production & Export Reporting** - Station-level reports, aggregated data, export-ready formats
✅ **Government Dashboard** - National overview, district filtering, analytics, real-time metrics
✅ **Role-Based Access Control** - 6 user roles with dedicated dashboards and permissions
✅ **Secure Authentication** - JWT tokens, password hashing, audit logging
---
## Documentation
| Document | Purpose | Audience |
|--------- …