nkwabyte/cqaag_app

The Field application for the Ghana Cashew Quality Analysts' Association # CQAAG Mobile Application The official field inspection and portal mobile application for the **Ghana Cashew Quality Analysts' Association (CQAAG)**. Built with Flutter, Riverpod, and Firebase to empower quality analysts, farmers, inspectors, and administrators across Ghana with real-time cashew nut quality assessment, GPS farm location tagging, PDF certificate generation, QR traceability, and membership management. --- ## Table of Contents - Overview - Key Features - Technology Stack - Project Architecture & Organization - Quality Calculation Engine - Setup & Installation - Environment Configuration - Code Generation & Build Commands - License & Support --- ## Overview The CQAAG mobile application serves as a comprehensive digital field assistant for cashew quality inspection and member governance in Ghana. Analysts can perform standardized quality evaluations directly in cashew farms and warehouses—even in remote areas with offline data caching—to determine Kernel Output Ratio (KOR), Nut Count, Defect Rate, and Moisture Content. The app also provides a full portal for association members to manage their profiles, track membership applications, access association documents (Constitution, Code of Ethics, Quality Standards), view regional chapters, and participate in events. --- ## Key Features ### 🔍 Field Quality Inspection Wizard - **5-Step Inspection Workflow**: 1. **Basic Details**: Record farmer/supplier details, lot size, bag count, and origin location (Region, District, Town). 2. **Farm Location**: Capture precise GPS coordinates using device location services. 3. **Quality Measurement**: Input sample weight, defect weight, sound kernel weight, nut count, and moisture percentage to calculate **Kernel Output Ratio (KOR)** automatically. 4. **Photo Documentation**: Upload high-resolution evidence photos directly to Cloudinary. 5. **Result & Traceability**: Generate digital inspection certificates, export PDF reports, and generate unique QR codes …