# thimethz03/govi-sahaya architecture

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

- Interactive diagram: https://gitdiagram.com/thimethz03/govi-sahaya
- Repository: https://github.com/thimethz03/govi-sahaya

## Overview

Govi Sahaya is a Sri Lankan smart-agriculture and farmer-community platform, with a Flutter mobile client and an Express/MongoDB backend. Farmers use the API for authentication and services including AI crop diagnosis, weather, farm planning, safety help, learning, news, forums, notifications, and a marketplace. The backend routes requests to controllers, which use domain models and services; the sampled marketplace and farm-planning controllers show the persistence layer. Mobile application source and several feature implementations were not sampled, so those documented capabilities are represented at subsystem level, without inferred internal call chains.

Main entry points: [`govi_sahaya_backend/src/controllers/shopController.js`](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/shopController.js) (Marketplace), [`govi_sahaya_backend/src/app.js`](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/app.js) (Express API), [`govi_sahaya_backend/src/controllers/mlController.js`](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/mlController.js) (Crop diagnosis), [`govi_sahaya_backend/src/config/firebase.js`](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/config/firebase.js) (Firebase services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API runtime"]
  node_api["Express API<br/>[app.js]"]
  node_route_registry["API routes<br/>[index.js]"]
  node_server["Server startup<br/>[server.js]"]
  node_firebase["Firebase services<br/>[firebase.js]"]
end

subgraph group_identity["Identity and users"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_auth_service["Auth services<br/>[authService.js]"]
  node_user_model[("User records<br/>[User.js]")]
  node_auth_middleware["Request identity<br/>[authMiddleware.js]"]
end

subgraph group_farm["Farm advisory"]
  node_ml_routes["ML routes<br/>[mlRoutes.js]"]
  node_ml_controller["Crop diagnosis<br/>[mlController.js]"]
  node_ml_service["ML service<br/>[mlService.js]"]
  node_disease_records[("Disease records<br/>[Disease.js]")]
  node_weather["Weather forecasts"]
  node_profit["Profit planning"]
  node_fields[("Farm fields<br/>[Field.js]")]
  node_expenses[("Farm expenses<br/>[Expense.js]")]
  node_safety["Safety assistance"]
  node_hospital_search["Nearby hospitals"]
end

subgraph group_community["Community and content"]
  node_knowledge["Knowledge hub"]
  node_forum["Farmer forum<br/>[forumController.js]"]
  node_news["Agricultural news<br/>[newsController.js]"]
  node_notifications["Notifications"]
end

subgraph group_commerce["Marketplace"]
  node_shop_routes["Shop routes<br/>[shopRoutes.js]"]
  node_shop_controller["Marketplace<br/>[shopController.js]"]
  node_shop_items[("Shop inventory<br/>[ShopItem.js]")]
  node_cart[("Shopping carts<br/>[Cart.js]")]
  node_orders[("Orders<br/>[Order.js]")]
end

node_farmer(("Farmer"))
node_mongodb[("MongoDB")]
node_google_places["Google Places"]

node_farmer -.->|"requests services"| node_api
node_server -->|"starts"| node_api
node_server -->|"initializes"| node_firebase
node_api -->|"initializes"| node_firebase
node_api -->|"mounts routes"| node_route_registry
node_auth_routes -.->|"dispatches"| node_auth_controller
node_auth_controller -.->|"uses"| node_auth_service
node_auth_service -->|"queries"| node_user_model
node_auth_middleware -->|"loads user"| node_user_model
node_ml_routes -->|"protects requests"| node_auth_middleware
node_ml_routes -->|"dispatches"| node_ml_controller
node_ml_controller -->|"calls"| node_ml_service
node_ml_controller -->|"queries"| node_disease_records
node_profit -->|"reads and writes"| node_fields
node_profit -->|"reads and writes"| node_expenses
node_safety -->|"searches nearby"| node_hospital_search
node_shop_routes -->|"dispatches"| node_shop_controller
node_shop_controller -->|"reads and writes"| node_shop_items
node_shop_controller -->|"reads and writes"| node_cart
node_shop_controller -->|"reads and writes"| node_orders
node_shop_controller -->|"uploads images"| node_firebase

click node_api "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/app.js"
click node_route_registry "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/routes/index.js"
click node_server "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/server.js"
click node_auth_routes "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/routes/authRoutes.js"
click node_auth_controller "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/authController.js"
click node_auth_service "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/services/authService.js"
click node_user_model "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/User.js"
click node_auth_middleware "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/middleware/authMiddleware.js"
click node_ml_routes "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/routes/mlRoutes.js"
click node_ml_controller "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/mlController.js"
click node_ml_service "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/services/mlService.js"
click node_disease_records "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Disease.js"
click node_weather "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/weatherController.js"
click node_profit "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/profitPlannerController.js"
click node_fields "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Field.js"
click node_expenses "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Expense.js"
click node_safety "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/safetyAssistController.js"
click node_knowledge "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/knowledgeHubController.js"
click node_forum "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/forumController.js"
click node_news "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/newsController.js"
click node_notifications "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/services/notificationService.js"
click node_shop_routes "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/routes/shopRoutes.js"
click node_shop_controller "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/shopController.js"
click node_shop_items "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/ShopItem.js"
click node_cart "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Cart.js"
click node_orders "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Order.js"
click node_firebase "https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/config/firebase.js"

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_api,node_route_registry,node_server,node_firebase toneBlue
class node_auth_routes,node_auth_controller,node_auth_service,node_user_model,node_auth_middleware,node_mongodb toneAmber
class node_ml_routes,node_ml_controller,node_ml_service,node_disease_records,node_weather,node_profit,node_fields,node_expenses,node_safety,node_hospital_search toneMint
class node_knowledge,node_forum,node_news,node_notifications toneRose
class node_shop_routes,node_shop_controller,node_shop_items,node_cart,node_orders,node_farmer,node_google_places toneIndigo
```

## Components

### API runtime

- [Express API](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/app.js): `govi_sahaya_backend/src/app.js`
- [API routes](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/routes/index.js): `govi_sahaya_backend/src/routes/index.js`
- [Server startup](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/server.js): `govi_sahaya_backend/server.js`
- [Firebase services](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/config/firebase.js): `govi_sahaya_backend/src/config/firebase.js`

### Identity and users

- [Authentication routes](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/routes/authRoutes.js): `govi_sahaya_backend/src/routes/authRoutes.js`
- [Authentication](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/authController.js): `govi_sahaya_backend/src/controllers/authController.js`
- [Auth services](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/services/authService.js): `govi_sahaya_backend/src/services/authService.js`
- [User records](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/User.js): `govi_sahaya_backend/src/models/User.js`
- [Request identity](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/middleware/authMiddleware.js): `govi_sahaya_backend/src/middleware/authMiddleware.js`

### Farm advisory

- [ML routes](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/routes/mlRoutes.js): `govi_sahaya_backend/src/routes/mlRoutes.js`
- [Crop diagnosis](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/mlController.js): `govi_sahaya_backend/src/controllers/mlController.js`
- [ML service](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/services/mlService.js): `govi_sahaya_backend/src/services/mlService.js`
- [Disease records](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Disease.js): `govi_sahaya_backend/src/models/Disease.js`
- [Weather forecasts](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/weatherController.js): `govi_sahaya_backend/src/controllers/weatherController.js`
- [Profit planning](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/profitPlannerController.js): `govi_sahaya_backend/src/controllers/profitPlannerController.js`
- [Farm fields](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Field.js): `govi_sahaya_backend/src/models/Field.js`
- [Farm expenses](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Expense.js): `govi_sahaya_backend/src/models/Expense.js`
- [Safety assistance](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/safetyAssistController.js): `govi_sahaya_backend/src/controllers/safetyAssistController.js`
- **Nearby hospitals**

### Community and content

- [Knowledge hub](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/knowledgeHubController.js): `govi_sahaya_backend/src/controllers/knowledgeHubController.js`
- [Farmer forum](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/forumController.js): `govi_sahaya_backend/src/controllers/forumController.js`
- [Agricultural news](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/newsController.js): `govi_sahaya_backend/src/controllers/newsController.js`
- [Notifications](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/services/notificationService.js): `govi_sahaya_backend/src/services/notificationService.js`

### Marketplace

- [Shop routes](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/routes/shopRoutes.js): `govi_sahaya_backend/src/routes/shopRoutes.js`
- [Marketplace](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/controllers/shopController.js): `govi_sahaya_backend/src/controllers/shopController.js`
- [Shop inventory](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/ShopItem.js): `govi_sahaya_backend/src/models/ShopItem.js`
- [Shopping carts](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Cart.js): `govi_sahaya_backend/src/models/Cart.js`
- [Orders](https://github.com/thimethz03/govi-sahaya/blob/main/govi_sahaya_backend/src/models/Order.js): `govi_sahaya_backend/src/models/Order.js`

### Other components

- **Farmer**
- **MongoDB**
- **Google Places**

## Connections

- Farmer → Express API: requests services (evidence: `README.md`)
- Server startup → Express API: starts (evidence: `govi_sahaya_backend/server.js`)
- Server startup → Firebase services: initializes (evidence: `govi_sahaya_backend/server.js`)
- Express API → Firebase services: initializes (evidence: `govi_sahaya_backend/src/app.js`)
- Express API → API routes: mounts routes (evidence: `govi_sahaya_backend/src/app.js`)
- Authentication routes → Authentication: dispatches
- Authentication → Auth services: uses
- Auth services → User records: queries (evidence: `govi_sahaya_backend/src/services/authService.js`)
- Request identity → User records: loads user (evidence: `govi_sahaya_backend/src/middleware/authMiddleware.js`)
- ML routes → Request identity: protects requests (evidence: `govi_sahaya_backend/src/routes/mlRoutes.js`)
- ML routes → Crop diagnosis: dispatches (evidence: `govi_sahaya_backend/src/routes/mlRoutes.js`)
- Crop diagnosis → ML service: calls (evidence: `govi_sahaya_backend/src/controllers/mlController.js`)
- Crop diagnosis → Disease records: queries (evidence: `govi_sahaya_backend/src/controllers/mlController.js`)
- Profit planning → Farm fields: reads and writes (evidence: `govi_sahaya_backend/src/controllers/profitPlannerController.js`)
- Profit planning → Farm expenses: reads and writes (evidence: `govi_sahaya_backend/src/controllers/profitPlannerController.js`)
- Safety assistance → Nearby hospitals: searches nearby (evidence: `govi_sahaya_backend/src/controllers/safetyAssistController.js`)
- Shop routes → Marketplace: dispatches (evidence: `govi_sahaya_backend/src/routes/shopRoutes.js`)
- Marketplace → Shop inventory: reads and writes (evidence: `govi_sahaya_backend/src/controllers/shopController.js`)
- Marketplace → Shopping carts: reads and writes (evidence: `govi_sahaya_backend/src/controllers/shopController.js`)
- Marketplace → Orders: reads and writes (evidence: `govi_sahaya_backend/src/controllers/shopController.js`)
- Marketplace → Firebase services: uploads images (evidence: `govi_sahaya_backend/src/controllers/shopController.js`)
