# devsambou/kultivia architecture

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

- Interactive diagram: https://gitdiagram.com/devsambou/kultivia
- Repository: https://github.com/devsambou/kultivia

## Overview

KultivIA is a multilingual agricultural crop-diagnosis app, with photo, text, and voice input. Its broader product also includes crop-health views, community reports, marketplace, weather alerts, and user setup/settings. The tree identifies the Flutter feature areas; excerpts confirm the server-side AI proxy and scheduled weather/report notification flows. Flutter-to-backend wiring and most screen-level calls were not shown, so those links are omitted or marked unverified rather than asserted.

Main entry points: [`functions/src/weatherAlerts.js`](https://github.com/devsambou/kultivia/blob/main/functions/src/weatherAlerts.js) (Scheduled weather alerts), [`functions/index.js`](https://github.com/devsambou/kultivia/blob/main/functions/index.js) (Function exports), [`functions/src/aiProxy.js`](https://github.com/devsambou/kultivia/blob/main/functions/src/aiProxy.js) (AI proxy), [`lib/repositories/firebase_diagnosis_repository.dart`](https://github.com/devsambou/kultivia/blob/main/lib/repositories/firebase_diagnosis_repository.dart) (Diagnosis repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Flutter app"]
  node_app["App entry<br/>[main.dart]"]
  node_gate["Welcome gate<br/>[gate_screen.dart]"]
end

subgraph group_crop["Crop assistance"]
  node_diagnosis["AI assistant"]
  node_ai_service["AI client"]
  node_health["Health dashboard"]
  node_result["Diagnosis result"]
  node_history["Diagnosis history"]
  node_diagnosis_repo["Diagnosis repository"]
  node_weather_screen["Weather alerts"]
end

subgraph group_community["Community and market"]
  node_community_screen["Community reports"]
  node_market["Marketplace"]
end

subgraph group_account["Accounts and preferences"]
  node_auth["Sign-in<br/>[auth_screen.dart]"]
  node_setup["Farm setup<br/>[setup_screen.dart]"]
  node_settings["Profile and settings"]
end

subgraph group_cloud["Cloud services"]
  node_weather_fn["Scheduled weather alerts<br/>[weatherAlerts.js]"]
  node_weather_rules["Risk assessment<br/>[weatherRules.js]"]
  node_report_fn["Report notification<br/>[notifyReport.js]"]
  node_proxy_fn["AI proxy<br/>[aiProxy.js]"]
  node_speech_fn["Speech synthesis<br/>[aiSpeech.js]"]
  node_transcribe_fn["Voice transcription<br/>[aiTranscribe.js]"]
  node_cloud_exports["Function exports<br/>[index.js]"]
end

node_farmer(("Farmer"))
node_firebase[("Firebase")]
node_rodium["RodiumAI"]
node_openmeteo["Open-Meteo"]
node_fcm["Firebase messaging"]

node_farmer -->|"uses"| node_app
node_app -.->|"opens"| node_gate
node_farmer -->|"requests diagnosis"| node_diagnosis
node_diagnosis -.->|"uses"| node_ai_service
node_ai_service -.->|"requests AI"| node_proxy_fn
node_proxy_fn -->|"forwards request"| node_rodium
node_cloud_exports -->|"exports"| node_proxy_fn
node_cloud_exports -->|"exports"| node_weather_fn
node_weather_fn -->|"assesses risk"| node_weather_rules
node_weather_fn -->|"reads users"| node_firebase
node_weather_fn -->|"fetches forecast"| node_openmeteo
node_weather_fn -->|"sends alerts"| node_fcm
node_cloud_exports -->|"exports"| node_report_fn
node_report_fn -->|"notifies topic"| node_fcm
node_speech_fn -->|"requests speech"| node_rodium
node_transcribe_fn -->|"requests transcription"| node_rodium
node_farmer -.->|"views alerts"| node_weather_screen
node_farmer -.->|"posts reports"| node_community_screen
node_farmer -.->|"browses vendors"| node_market
node_health -.->|"loads diagnoses"| node_diagnosis_repo
node_history -.->|"loads history"| node_diagnosis_repo
node_result -.->|"stores diagnosis"| node_diagnosis_repo
node_farmer -.->|"signs in"| node_auth
node_farmer -.->|"sets up farm"| node_setup
node_farmer -.->|"configures preferences"| node_settings

click node_app "https://github.com/devsambou/kultivia/blob/main/lib/main.dart"
click node_gate "https://github.com/devsambou/kultivia/blob/main/lib/screens/gate/gate_screen.dart"
click node_diagnosis "https://github.com/devsambou/kultivia/blob/main/lib/screens/home_ai/home_ai_screen.dart"
click node_ai_service "https://github.com/devsambou/kultivia/blob/main/lib/services/ai/rodium_ai_service.dart"
click node_health "https://github.com/devsambou/kultivia/blob/main/lib/screens/health/health_dashboard_screen.dart"
click node_result "https://github.com/devsambou/kultivia/blob/main/lib/screens/health/diagnosis_result_screen.dart"
click node_history "https://github.com/devsambou/kultivia/blob/main/lib/screens/history/history_screen.dart"
click node_diagnosis_repo "https://github.com/devsambou/kultivia/blob/main/lib/repositories/firebase_diagnosis_repository.dart"
click node_community_screen "https://github.com/devsambou/kultivia/blob/main/lib/screens/community/community_screen.dart"
click node_market "https://github.com/devsambou/kultivia/blob/main/lib/screens/market/marketplace_screen.dart"
click node_weather_screen "https://github.com/devsambou/kultivia/blob/main/lib/screens/weather/weather_alerts_screen.dart"
click node_weather_fn "https://github.com/devsambou/kultivia/blob/main/functions/src/weatherAlerts.js"
click node_weather_rules "https://github.com/devsambou/kultivia/blob/main/functions/src/weatherRules.js"
click node_report_fn "https://github.com/devsambou/kultivia/blob/main/functions/src/notifyReport.js"
click node_proxy_fn "https://github.com/devsambou/kultivia/blob/main/functions/src/aiProxy.js"
click node_speech_fn "https://github.com/devsambou/kultivia/blob/main/functions/src/aiSpeech.js"
click node_transcribe_fn "https://github.com/devsambou/kultivia/blob/main/functions/src/aiTranscribe.js"
click node_cloud_exports "https://github.com/devsambou/kultivia/blob/main/functions/index.js"
click node_auth "https://github.com/devsambou/kultivia/blob/main/lib/screens/auth/auth_screen.dart"
click node_setup "https://github.com/devsambou/kultivia/blob/main/lib/screens/setup/setup_screen.dart"
click node_settings "https://github.com/devsambou/kultivia/blob/main/lib/screens/settings/settings_screen.dart"

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_app,node_gate toneBlue
class node_diagnosis,node_ai_service,node_health,node_result,node_history,node_diagnosis_repo,node_weather_screen,node_firebase toneAmber
class node_community_screen,node_market toneMint
class node_auth,node_setup,node_settings toneRose
class node_weather_fn,node_weather_rules,node_report_fn,node_proxy_fn,node_speech_fn,node_transcribe_fn,node_cloud_exports,node_farmer,node_rodium,node_openmeteo,node_fcm toneIndigo
```

## Components

### Flutter app

- [App entry](https://github.com/devsambou/kultivia/blob/main/lib/main.dart): `lib/main.dart`
- [Welcome gate](https://github.com/devsambou/kultivia/blob/main/lib/screens/gate/gate_screen.dart): `lib/screens/gate/gate_screen.dart`

### Crop assistance

- [AI assistant](https://github.com/devsambou/kultivia/blob/main/lib/screens/home_ai/home_ai_screen.dart): `lib/screens/home_ai/home_ai_screen.dart`
- [AI client](https://github.com/devsambou/kultivia/blob/main/lib/services/ai/rodium_ai_service.dart): `lib/services/ai/rodium_ai_service.dart`
- [Health dashboard](https://github.com/devsambou/kultivia/blob/main/lib/screens/health/health_dashboard_screen.dart): `lib/screens/health/health_dashboard_screen.dart`
- [Diagnosis result](https://github.com/devsambou/kultivia/blob/main/lib/screens/health/diagnosis_result_screen.dart): `lib/screens/health/diagnosis_result_screen.dart`
- [Diagnosis history](https://github.com/devsambou/kultivia/blob/main/lib/screens/history/history_screen.dart): `lib/screens/history/history_screen.dart`
- [Diagnosis repository](https://github.com/devsambou/kultivia/blob/main/lib/repositories/firebase_diagnosis_repository.dart): `lib/repositories/firebase_diagnosis_repository.dart`
- [Weather alerts](https://github.com/devsambou/kultivia/blob/main/lib/screens/weather/weather_alerts_screen.dart): `lib/screens/weather/weather_alerts_screen.dart`

### Community and market

- [Community reports](https://github.com/devsambou/kultivia/blob/main/lib/screens/community/community_screen.dart): `lib/screens/community/community_screen.dart`
- [Marketplace](https://github.com/devsambou/kultivia/blob/main/lib/screens/market/marketplace_screen.dart): `lib/screens/market/marketplace_screen.dart`

### Accounts and preferences

- [Sign-in](https://github.com/devsambou/kultivia/blob/main/lib/screens/auth/auth_screen.dart): `lib/screens/auth/auth_screen.dart`
- [Farm setup](https://github.com/devsambou/kultivia/blob/main/lib/screens/setup/setup_screen.dart): `lib/screens/setup/setup_screen.dart`
- [Profile and settings](https://github.com/devsambou/kultivia/blob/main/lib/screens/settings/settings_screen.dart): `lib/screens/settings/settings_screen.dart`

### Cloud services

- [Scheduled weather alerts](https://github.com/devsambou/kultivia/blob/main/functions/src/weatherAlerts.js): `functions/src/weatherAlerts.js`
- [Risk assessment](https://github.com/devsambou/kultivia/blob/main/functions/src/weatherRules.js): `functions/src/weatherRules.js`
- [Report notification](https://github.com/devsambou/kultivia/blob/main/functions/src/notifyReport.js): `functions/src/notifyReport.js`
- [AI proxy](https://github.com/devsambou/kultivia/blob/main/functions/src/aiProxy.js): `functions/src/aiProxy.js`
- [Speech synthesis](https://github.com/devsambou/kultivia/blob/main/functions/src/aiSpeech.js): `functions/src/aiSpeech.js`
- [Voice transcription](https://github.com/devsambou/kultivia/blob/main/functions/src/aiTranscribe.js): `functions/src/aiTranscribe.js`
- [Function exports](https://github.com/devsambou/kultivia/blob/main/functions/index.js): `functions/index.js`

### Other components

- **Farmer**
- **Firebase**
- **RodiumAI**
- **Open-Meteo**
- **Firebase messaging**

## Connections

- Farmer → App entry: uses (evidence: `README.md`)
- App entry → Welcome gate: opens
- Farmer → AI assistant: requests diagnosis (evidence: `README.md`)
- AI assistant → AI client: uses
- AI client → AI proxy: requests AI
- AI proxy → RodiumAI: forwards request (evidence: `functions/src/aiProxy.js`)
- Function exports → AI proxy: exports (evidence: `functions/index.js`)
- Function exports → Scheduled weather alerts: exports (evidence: `functions/index.js`)
- Scheduled weather alerts → Risk assessment: assesses risk (evidence: `functions/src/weatherAlerts.js`)
- Scheduled weather alerts → Firebase: reads users (evidence: `functions/src/weatherAlerts.js`)
- Scheduled weather alerts → Open-Meteo: fetches forecast (evidence: `functions/src/weatherAlerts.js`)
- Scheduled weather alerts → Firebase messaging: sends alerts (evidence: `functions/src/weatherAlerts.js`)
- Function exports → Report notification: exports (evidence: `functions/index.js`)
- Report notification → Firebase messaging: notifies topic (evidence: `functions/src/notifyReport.js`)
- Speech synthesis → RodiumAI: requests speech (evidence: `functions/src/aiSpeech.js`)
- Voice transcription → RodiumAI: requests transcription (evidence: `functions/src/aiTranscribe.js`)
- Farmer → Weather alerts: views alerts
- Farmer → Community reports: posts reports
- Farmer → Marketplace: browses vendors
- Health dashboard → Diagnosis repository: loads diagnoses
- Diagnosis history → Diagnosis repository: loads history
- Diagnosis result → Diagnosis repository: stores diagnosis
- Farmer → Sign-in: signs in
- Farmer → Farm setup: sets up farm
- Farmer → Profile and settings: configures preferences
