JosephNderitu/shamba-records-task

# 🌱 SmartSeason Field Monitoring System > A full-stack web application that helps coordinators and field agents track crop progress across multiple fields during a growing season. --- ## 🔗 Live Demo **shamba-records-task.onrende… --- ## 🔐 Demo Credentials | Role | Username | Email | Password | |------|----------|-------|----------| | Admin (Coordinator) | `Admin` | `test.admin@gmail.com` | `Admin@2026` | | Field Agent | `agent01` | `agent@gmail.com` | `agent@2026` | --- ## ✅ Features - **Role-based access control** — Admin and Field Agent roles with separate views - **Field management** — Create, edit, delete and assign fields (Admin only) - **Field updates** — Agents post stage updates with notes and observations - **Field lifecycle** — Planted → Growing → Ready → Harvested - **Computed status** — Active, At Risk, Completed (auto-calculated) - **Dashboards** — Separate views for Admin and Agent with Chart.js insights - **Activity timeline** — Full audit trail of every field update - **Search & filters** — Filter fields by stage, status, or keyword - **Jazzmin admin panel** — Enhanced Django admin interface --- ## 🛠️ Tech Stack | Layer | Technology | |-------|------------| | Backend | Django 5.2 (Python 3.11) | | Database | PostgreSQL 15 | | Frontend | HTML5, Bootstrap 5, Chart.js, FontAwesome | | Web Server | Nginx + Gunicorn | | Containerization | Docker + Docker Compose | | Deployment | Render | | CI/CD | GitHub Actions | --- ## 🚀 Local Setup ### Prerequisites - Docker Desktop - Git ### Steps ```bash # 1. Clone the repository git clone github.com cd shamba-records-task # 2. Create environment file copy .env.example .env # Edit .env with your values # 3. Build and start docker compose up --build # 4. Visit the app # localhost ``` ### Environment Variables Create a `.env` file in the root directory: ```env SECRET_KEY=your-secret-key-here DEBUG=1 ALLOWED_HOSTS=localhost, …