# Lwendo Management App



## Key Features:

*   **User Roles and Authentication:**  Supports different user roles including Management, Manufacturing, and Logistics. Includes a basic login system to manage user sessions and role-based access. A default administrator account (`admin@test.com` / `admin123`) is pre-configured for initial setup.
*   **Admin Dashboard:**  Provides a central dashboard for administrators (Management role) to:
    *   View key statistics (total users, tasks, inventory items).
    *   Create and delete user accounts with assigned roles.
    *   Assign tasks to Logistics users, including descriptions and budgets.
    *   Manage inventory items (create, update, delete, and track stock levels).
    *   Monitor recent notifications (e.g., low stock alerts).
*   **Task Management:**
    *   Administrators can assign tasks to Logistics users.
    *   Logistics and Manufacturing users can view their assigned tasks.
    *   Users can update the progress of their tasks.
    *   Users can add receipts to tasks to track expenses, either manually entering details or by uploading receipt images.
*   **Intelligent Receipt Processing:**
    *   Leverages Google Gemini AI to analyze uploaded receipt images.
    *   Automatically extracts key information from receipts, including:
        *   Total amount
        *   List of items purchased
        *   Transaction date
        *   Receipt number
    *   This extracted data is linked to tasks for expense tracking.
*   **Inventory Management:**
    *   Administrators can manage a list of inventory items.
    *   Track stock levels and set minimum stock thresholds.
    *   The application includes basic low stock monitoring (notifications, though not fully implemented in this code snippet, are intended for this).
*   **Technology Stack:** Built using:
    *   Flask (Python web framework)
    *   Firebase Admin SDK (for backend data storage and authentication)
    *   Google Generative AI (Gemini API for receipt processing)
    *   PIL (Pillow for image processing)
    *   pandas (for data manipulation)

## Features to Add


### Task & Delivery Management Enhancements:

*   **Delivery Note Generation:** Implement the generation of digital delivery notes. This would likely involve creating a template for delivery notes and an endpoint to generate them based on task details.
*   **Real-time Delivery Status for Drivers:** Develop a mechanism for logistics drivers to update delivery statuses in real-time (beyond just general task progress). This might involve a separate driver-facing interface and more granular delivery statuses (e.g., "Out for Delivery," "Delivered," "Exception").
*   **Proof of Delivery Uploads:** Fully implement the file upload feature (signatures, images) to Firebase Storage for proof of delivery.  Currently, image uploads are used for receipts, but this needs to be extended for delivery confirmation.  Link these uploaded proofs to specific delivery tasks.
*   **Role-Specific Task Instructions:** Add dedicated fields in the task assignment process for role-specific instructions. This would allow for more tailored guidance for manufacturing teams and logistics drivers within the same task system.
*   **Task Deadlines and Priorities:** Include fields for setting deadlines and priority levels for tasks to improve task management and scheduling.

### Reporting and Dashboarding Expansion:

*   **Dynamic and Role-Specific Dashboards:** Enhance the admin dashboard and create dashboards for other roles (Manufacturing, Logistics). These dashboards should dynamically display real-time data such as:
    *   Inventory levels and low stock alerts
    *   Order status (from Sage integration)
    *   Task progress and delivery statuses
    *   Key performance indicators (KPIs) relevant to each role.
*   **Automated Report Generation:** Implement backend routines to automatically generate periodic reports (daily, weekly, monthly). These reports should be customizable and tailored for different stakeholders (e.g., management reports, inventory reports, logistics performance reports). Consider options for on-demand report generation as well.
*   **Dashboard Insights from AI:** Integrate the results of Gemini AI analysis (predictive analytics, forecasting - see AI Integration section below) into the dashboards. This includes visualizing forecasts, production schedules, and actionable insights derived from AI processing.

### Inventory Management Improvements:

*   **Real-time Low Stock Alerts:**  Develop a robust notification system to alert administrators and relevant personnel when inventory levels fall below the defined minimum stock thresholds. These alerts should be displayed on dashboards and potentially sent via email or other notification channels.
*   **Barcode/QR Scanning Integration:** Integrate a barcode or QR scanning API or library to streamline inventory updates. This would enable faster and more accurate stock adjustments during receiving, dispatching, and stocktaking processes.
*   **Inventory Management UI in Admin Dashboard:** Create a dedicated UI within the admin dashboard to manage inventory items directly (create, read, update, delete) instead of just having separate routes.

### Sage Accounting Integration:

*   **Sage API Integration:**  Implement API calls or data synchronization endpoints to connect with Sage Accounting.  Focus on transferring:
    *   Customer and Supplier Orders from Sage into the Flask application (for supply chain visibility).
    *   Invoice data from the Flask application (potentially generated from task expenses or order fulfillments) to Sage for accounting.
*   **Order Handling UI (Derived from Sage):** Design user interfaces (likely within the dashboards) to display and track orders pulled from Sage. While order *creation* may primarily happen in Sage, order *visibility and status tracking* within the Flask app are important.

### AI-Powered Predictive Analytics (Gemini):

*   **Production Scheduling with Gemini:** Implement the logic to send relevant data (e.g., order forecasts, inventory levels, manufacturing capacity) to the Gemini API to generate AI-driven production schedules.
*   **Inventory Forecasting with Gemini:** Utilize Gemini to analyze historical sales data, trends, and other relevant factors to generate inventory forecasts. This can help optimize stock levels and reduce waste.


### Authentication and User Management:

*   **Password Recovery:** Implement "forgot password" or password recovery functionality to enhance user account management.