king-Mudho/fishlink-zimbabwe

# FishLink Zimbabwe FishLink Zimbabwe is a production-ready fish supply chain and postharvest loss reduction platform built for producers, transporters, processors, retailers, and administrators. It brings together marketplace trading, cold-chain monitoring, hygiene compliance, QR traceability, and supplier feedback in one connected workflow. --- ## What's Included - JWT-based authentication with a custom Django user model and role-aware routing - Role-specific dashboards for producers, transporters, processors, retailers, and administrators - Live fish marketplace with messaging, orders, district price boards, and demand alerts - Cold-chain monitoring with warning and critical temperature thresholds and emergency reports - Hygiene auditing with scored checklists, photo evidence, and supervisor escalation - QR traceability, recall management, supplier ratings, and formal complaints - Platform analytics, activity audit logging, pagination, and security hardening - Responsive public landing page with dark and light mode --- ## Technology Stack ### Frontend | Library | Purpose | |---|---| | React 18 + TypeScript | UI framework with strict typing | | Vite | Build tool and dev server | | Tailwind CSS | Utility-first styling with custom design tokens | | Framer Motion | Page and component animations | | React Router v6 | Client-side routing with protected routes | | Axios | HTTP client with JWT interceptors and token refresh | | React Context API | Global state (auth, market, cold chain, hygiene, traceability) | | Recharts | Area, bar, and mini line charts | | react-hot-toast | Theme-aware toast notifications | | Lucide React | Icon library | ### Backend | Library | Purpose | |---|---| | Django 4.x | Web framework | | Django REST Framework | API layer | | djangorestframework-simplejwt | JWT access + refresh token authentication | | drf-spectacular | OpenAPI 3 schema generation | | django-environ | Environment variable management | | SQLite | Development database …