# kaleemarif/procuresmart architecture

> Architecture diagram of the GitHub repository kaleemarif/procuresmart, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kaleemarif/procuresmart
- Repository: https://github.com/kaleemarif/procuresmart

## Overview

ProcureSmart guides farmers toward a procurement centre and time using centre data, waiting-time estimates, and ranked recommendations; it also describes operator queue management and a Sahayak assistant. The visible backend implements prediction, recommendation, synthetic operator state, CEDA lookups, and tool-mediated chat. The README documents additional user-facing capabilities, but sampled frontend excerpts do not establish its API wiring. Prototype centre data and model metrics should not be treated as real-world operational data.

Main entry points: [`backend/main.py`](https://github.com/kaleemarif/procuresmart/blob/main/backend/main.py) (API and state), [`backend/ml/predict.py`](https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/predict.py) (Wait predictor), [`backend/chatbot/service.py`](https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/service.py) (Chat service), [`backend/chatbot/tools.py`](https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/tools.py) (Operational tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_farmer_ui["Farmer guidance<br/>[page.tsx]"]
  node_map["Centre map<br/>[ProcurementMap.tsx]"]
  node_operator_ui["Operator console"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_api["Backend API"]
  node_backend["API and state<br/>[main.py]"]
end

subgraph group_intelligence["Prediction and recommendation"]
  node_recommender["Centre ranking<br/>[recommendation.py]"]
  node_predictor["Wait predictor<br/>[predict.py]"]
  node_model["Trained model"]
  node_features["Feature config<br/>[config.py]"]
  node_preprocessor["Feature preprocessing<br/>[preprocess.py]"]
  node_trainer["Model training<br/>[train.py]"]
end

subgraph group_assistant["Sahayak assistant"]
  node_chat_route["Chat endpoint<br/>[router.py]"]
  node_chat_service["Chat service<br/>[service.py]"]
  node_chat_tools["Operational tools<br/>[tools.py]"]
  node_prompt["Assistant prompt<br/>[prompts.py]"]
  node_gemini_adapter["Gemini adapter<br/>[adapter.py]"]
end

node_farmer(("Farmer"))
node_operator(("Operator"))
node_ceda["CEDA service"]
node_gemini["Gemini API"]

node_farmer -->|"uses"| node_farmer_ui
node_farmer_ui -.->|"shows map"| node_map
node_operator -->|"uses"| node_operator_ui
node_farmer_ui -.->|"uses API"| node_api_client
node_api_client -.->|"requests"| node_backend
node_operator_ui -.->|"updates state"| node_backend
node_backend -->|"calls"| node_recommender
node_backend -->|"calls"| node_predictor
node_backend -->|"requests data"| node_ceda
node_recommender -->|"predicts waits"| node_predictor
node_predictor -->|"loads"| node_model
node_predictor -->|"uses features"| node_features
node_trainer -->|"builds pipeline"| node_preprocessor
node_preprocessor -->|"uses feature sets"| node_features
node_chat_route -->|"calls"| node_chat_service
node_chat_service -->|"delegates"| node_gemini_adapter
node_chat_service -->|"provides tools"| node_chat_tools
node_chat_service -->|"provides prompt"| node_prompt
node_gemini_adapter -->|"calls API"| node_gemini
node_chat_tools -->|"reads live state"| node_backend
node_chat_tools -->|"calls"| node_recommender
node_chat_tools -->|"calls"| node_predictor

click node_farmer_ui "https://github.com/kaleemarif/procuresmart/blob/main/frontend/app/farmer/page.tsx"
click node_map "https://github.com/kaleemarif/procuresmart/blob/main/frontend/components/farmer/ProcurementMap.tsx"
click node_operator_ui "https://github.com/kaleemarif/procuresmart/tree/main/frontend/app/operator"
click node_api_client "https://github.com/kaleemarif/procuresmart/blob/main/frontend/lib/api.ts"
click node_backend "https://github.com/kaleemarif/procuresmart/blob/main/backend/main.py"
click node_recommender "https://github.com/kaleemarif/procuresmart/blob/main/backend/recommendation.py"
click node_predictor "https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/predict.py"
click node_model "https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/artifacts/waiting_time_model.joblib"
click node_features "https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/config.py"
click node_preprocessor "https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/preprocess.py"
click node_trainer "https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/train.py"
click node_chat_route "https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/router.py"
click node_chat_service "https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/service.py"
click node_chat_tools "https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/tools.py"
click node_prompt "https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/prompts.py"
click node_gemini_adapter "https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/adapter.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_farmer_ui,node_map,node_operator_ui,node_api_client toneBlue
class node_backend toneAmber
class node_recommender,node_predictor,node_model,node_features,node_preprocessor,node_trainer,node_gemini toneMint
class node_chat_route,node_chat_service,node_chat_tools,node_prompt,node_gemini_adapter toneRose
class node_farmer,node_operator,node_ceda toneIndigo
```

## Components

### User experience

- [Farmer guidance](https://github.com/kaleemarif/procuresmart/blob/main/frontend/app/farmer/page.tsx): `frontend/app/farmer/page.tsx`
- [Centre map](https://github.com/kaleemarif/procuresmart/blob/main/frontend/components/farmer/ProcurementMap.tsx): `frontend/components/farmer/ProcurementMap.tsx`
- [Operator console](https://github.com/kaleemarif/procuresmart/tree/main/frontend/app/operator): `frontend/app/operator`
- [API client](https://github.com/kaleemarif/procuresmart/blob/main/frontend/lib/api.ts): `frontend/lib/api.ts`

### Backend API

- [API and state](https://github.com/kaleemarif/procuresmart/blob/main/backend/main.py): `backend/main.py`

### Prediction and recommendation

- [Centre ranking](https://github.com/kaleemarif/procuresmart/blob/main/backend/recommendation.py): `backend/recommendation.py`
- [Wait predictor](https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/predict.py): `backend/ml/predict.py`
- [Trained model](https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/artifacts/waiting_time_model.joblib): `backend/ml/artifacts/waiting_time_model.joblib`
- [Feature config](https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/config.py): `backend/ml/config.py`
- [Feature preprocessing](https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/preprocess.py): `backend/ml/preprocess.py`
- [Model training](https://github.com/kaleemarif/procuresmart/blob/main/backend/ml/train.py): `backend/ml/train.py`

### Sahayak assistant

- [Chat endpoint](https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/router.py): `backend/chatbot/router.py`
- [Chat service](https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/service.py): `backend/chatbot/service.py`
- [Operational tools](https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/tools.py): `backend/chatbot/tools.py`
- [Assistant prompt](https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/prompts.py): `backend/chatbot/prompts.py`
- [Gemini adapter](https://github.com/kaleemarif/procuresmart/blob/main/backend/chatbot/adapter.py): `backend/chatbot/adapter.py`

### Other components

- **Farmer**
- **Operator**
- **CEDA service**
- **Gemini API**

## Connections

- Farmer → Farmer guidance: uses (evidence: `README.md`)
- Farmer guidance → Centre map: shows map
- Operator → Operator console: uses (evidence: `README.md`)
- Farmer guidance → API client: uses API
- API client → API and state: requests
- Operator console → API and state: updates state
- API and state → Centre ranking: calls (evidence: `backend/main.py`)
- API and state → Wait predictor: calls (evidence: `backend/main.py`)
- API and state → CEDA service: requests data (evidence: `backend/main.py`)
- Centre ranking → Wait predictor: predicts waits (evidence: `backend/recommendation.py`)
- Wait predictor → Trained model: loads (evidence: `backend/ml/predict.py`)
- Wait predictor → Feature config: uses features (evidence: `backend/ml/predict.py`)
- Model training → Feature preprocessing: builds pipeline (evidence: `backend/ml/train.py`)
- Feature preprocessing → Feature config: uses feature sets (evidence: `backend/ml/preprocess.py`)
- Chat endpoint → Chat service: calls (evidence: `backend/chatbot/router.py`)
- Chat service → Gemini adapter: delegates (evidence: `backend/chatbot/service.py`)
- Chat service → Operational tools: provides tools (evidence: `backend/chatbot/service.py`)
- Chat service → Assistant prompt: provides prompt (evidence: `backend/chatbot/service.py`)
- Gemini adapter → Gemini API: calls API (evidence: `backend/chatbot/adapter.py`)
- Operational tools → API and state: reads live state (evidence: `backend/chatbot/tools.py`)
- Operational tools → Centre ranking: calls (evidence: `backend/chatbot/tools.py`)
- Operational tools → Wait predictor: calls (evidence: `backend/chatbot/tools.py`)
