> ## Documentation Index
> Fetch the complete documentation index at: https://docs.escrivalimited.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to Sasini App

> The digital heartbeat of Kenya's agricultural future. Unifying 30,000+ farmers, supply chains, and automated backend APIs into a single, seamless ecosystem.

<Note>
  **Current Scope:** While the app's architecture dynamically supports multiple commodities (Coffee, Macadamia, Avocado), this documentation currently focuses on our live, active deployment for **Tea Farmers**.
</Note>

<div style={{ height: '20px' }} />

To make this platform truly world-class, we built it on a strict, role-based architecture. Every user—from the farmer in the field to the administrator at HQ—gets a tailored, high-performance experience.

***

## 👨‍🌾 The Farmer Application

**The Pocket Command Center.** A robust, fully localized mobile interface (Swahili, French, German, English) designed to work seamlessly even in remote highland regions and manage their entire business from their pocket.

<AccordionGroup>
  <Accordion icon="sack-dollar" title="Produce & Financials">
    * **Delivery Tracking:** Real-time visibility into weighbridge deliveries with advanced date filtering and live total-yield statistics.

    * **Payment Overview:** Instant access to payment histories, breakdowns, and downloadable digital receipts, filterable by any date.
  </Accordion>

  <Accordion icon="tractor" title="Farm Management & Logistics">
    * **Farm Input Ordering:** Browse, order, and track the status of genuine seeds, fertilizers, and farming tools.

    * **Pickup Requests:** Request Sasini logistics to collect produce from the farm, or suggest new collection routes.

    * **Pest Reports:** Instantly report localized outbreaks (with images) to alert Sasini agronomists.
  </Accordion>

  <Accordion icon="microchip" title="AI, Insights & Weather">
    * **Sasini AI Assistant:** A powerful, highly-tuned agricultural chatbot powered by the latest **Google Gemini** technology to answer complex farming queries.

    * **Live Weather:** App-native basic forecasts powered by external weather APIs, with deep-dive location details via external links.

    * **News & Markets:** Live updates on global commodity prices, market trends, and Sasini announcements.
  </Accordion>

  <Accordion icon="user-gear" title="Account, Support & Externals">
    * **Personalization:** Change profile pictures, update passwords, or request account deactivation.

    * **Help & Feedback:** Submit direct feedback, access comprehensive FAQs, and contact support.

    * **Instant Notifications:** Receive highly personalized push notifications directly from Sasini management.

    * **External Hubs:** Quick links to the Sasini Retail Store, the Farmer Training Center, and Financial Archives.
  </Accordion>
</AccordionGroup>

***

## 🏢 The Admin Web Console

**The Factory Nerve Center.** Administrators and extension officers utilize a high-security web dashboard to govern the ecosystem from top to bottom.

<Steps>
  <Step title="Logistics & Fleet Command" icon="truck-fast">
    Monitor incoming pickup requests, approve farm input orders, and triage active pest reports with live geolocation mapping.
  </Step>

  <Step title="Broadcast Communications" icon="tower-broadcast">
    Publish breaking news, update live market prices, and push out critical weather or drought alerts instantly to thousands of devices.
  </Step>

  <Step title="User Governance" icon="users-gear">
    Verify KYC parameters for new farmer registrations, process account lifecycle requests, and resolve submitted support tickets.
  </Step>
</Steps>

<div style={{ height: '20px' }} />

***

## 💻 Developer Architecture

**The Technical Backbone.**

The application relies on a scalable, zero-trust microservice architecture connecting internal factory ERPs with global tech providers.

* **Google Cloud Integration:** Direct, low-latency server-to-server connections.
* **LLM Pipelines:** Utilizing **Google Gemini** models for the core AI Assistant.
* **Dynamic Data:** Integrating Google Search algorithms and MSN Weather APIs for real-time localization.
* **Data Security:** End-to-end payload encryption, JWT session management, rigorous password hashing, and immutable Digital IDs.

***

## Explore the Documentation

Ready to dive deeper? Use these quick links to jump directly into the technical and operational workflows of the Sasini App.

<CardGroup cols={2}>
  <Card color="#76BD22" icon="id-card" href="/getting-started/profile" title="Registration & MFA">
    Review the localized onboarding pipeline, MFA protocols, and Digital ID generation.
  </Card>

  <Card color="#76BD22" icon="scale-unbalanced" href="/produce/deliveries" title="Deliveries & Payments">
    Explore the weighbridge integration and financial ledger calculations.
  </Card>

  <Card color="#76BD22" icon="box-open" href="/farm/inputs" title="Farm Inputs & Logistics">
    Discover the e-commerce flow for fertilizers and physical produce pickups.
  </Card>

  <Card color="#76BD22" icon="robot" href="/info/sasini-ai" title="Sasini AI & Insights">
    Deep-dive into the Google Gemini integration and pest reporting architecture.
  </Card>
</CardGroup>