# pgcshanne/agrilink architecture

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

- Interactive diagram: https://gitdiagram.com/pgcshanne/agrilink
- Repository: https://github.com/pgcshanne/agrilink

## Overview

AgriLink is a Flutter application for smallholder farmers. Its principal workflow is farmer access to agricultural guidance and monitoring, including disease and soil analysis, planting advice, weather, market prices, and crop tracking; authentication, feedback, and administrator capabilities are also represented. The README documents these capabilities, but the supplied source excerpts do not show Dart implementation or call paths, so feature wiring and backend integration are left unverified rather than inferred.

Main entry points: [`lib/main.dart`](https://github.com/pgcshanne/agrilink/blob/main/lib/main.dart) (App Entry), [`lib/services/free_ai_service.dart`](https://github.com/pgcshanne/agrilink/blob/main/lib/services/free_ai_service.dart) (AI Services), [`lib/disease_detection_page.dart`](https://github.com/pgcshanne/agrilink/blob/main/lib/disease_detection_page.dart) (Disease Detection), [`lib/soil_analysis_page.dart`](https://github.com/pgcshanne/agrilink/blob/main/lib/soil_analysis_page.dart) (Soil Analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app_entry["App Entry<br/>[main.dart]"]
end

subgraph group_farm["Farm Guidance"]
  node_disease["Disease Detection"]
  node_soil["Soil Analysis"]
  node_planting["Planting Advisory"]
  node_seeds["Seed Exchange"]
  node_tasks["Growth Tasks<br/>[tasks_page.dart]"]
end

subgraph group_insights["Monitoring &amp; Insights"]
  node_weather["Weather<br/>[weather_page.dart]"]
  node_market["Market Prices"]
  node_analytics["Analytics"]
end

subgraph group_services["Services &amp; Access"]
  node_login["Login<br/>[login_page.dart]"]
  node_register["Registration<br/>[register_page.dart]"]
  node_profile["Farmer Profile<br/>[profile_page.dart]"]
  node_translations["Translations"]
  node_chat["AI Chat"]
  node_api["API Service<br/>[api_service.dart]"]
  node_firebase["Firebase Service"]
  node_ai_services["AI Services"]
  node_user_session["User Session<br/>[user_session.dart]"]
end

node_farmer(("Farmer"))
node_administrator(("Administrator"))

node_farmer -.->|"uses"| node_app_entry
node_app_entry -.->|"offers"| node_disease
node_app_entry -.->|"offers"| node_soil
node_app_entry -.->|"offers"| node_planting
node_app_entry -.->|"offers"| node_seeds
node_app_entry -.->|"offers"| node_tasks
node_app_entry -.->|"offers"| node_weather
node_app_entry -.->|"offers"| node_market
node_app_entry -.->|"offers"| node_analytics
node_app_entry -.->|"offers"| node_login
node_app_entry -.->|"offers"| node_register
node_app_entry -.->|"offers"| node_profile
node_app_entry -.->|"offers"| node_chat
node_app_entry -.->|"uses"| node_translations
node_app_entry -.->|"uses"| node_user_session
node_administrator -.->|"uses"| node_analytics
node_api -.-> node_firebase
node_ai_services -.->|"may support"| node_disease
node_ai_services -.->|"may support"| node_soil
node_ai_services -.->|"may support"| node_planting

click node_app_entry "https://github.com/pgcshanne/agrilink/blob/main/lib/main.dart"
click node_disease "https://github.com/pgcshanne/agrilink/blob/main/lib/disease_detection_page.dart"
click node_soil "https://github.com/pgcshanne/agrilink/blob/main/lib/soil_analysis_page.dart"
click node_planting "https://github.com/pgcshanne/agrilink/blob/main/lib/planting_advisory_page.dart"
click node_seeds "https://github.com/pgcshanne/agrilink/blob/main/lib/seed_exchange_page.dart"
click node_tasks "https://github.com/pgcshanne/agrilink/blob/main/lib/tasks_page.dart"
click node_weather "https://github.com/pgcshanne/agrilink/blob/main/lib/weather_page.dart"
click node_market "https://github.com/pgcshanne/agrilink/blob/main/lib/market_price_page.dart"
click node_analytics "https://github.com/pgcshanne/agrilink/blob/main/lib/analytics_page.dart"
click node_login "https://github.com/pgcshanne/agrilink/blob/main/lib/login_page.dart"
click node_register "https://github.com/pgcshanne/agrilink/blob/main/lib/register_page.dart"
click node_profile "https://github.com/pgcshanne/agrilink/blob/main/lib/profile_page.dart"
click node_translations "https://github.com/pgcshanne/agrilink/blob/main/lib/services/app_translations.dart"
click node_chat "https://github.com/pgcshanne/agrilink/blob/main/lib/widgets/ai_chat_overlay.dart"
click node_api "https://github.com/pgcshanne/agrilink/blob/main/lib/services/api_service.dart"
click node_firebase "https://github.com/pgcshanne/agrilink/blob/main/lib/services/firebase_service.dart"
click node_ai_services "https://github.com/pgcshanne/agrilink/blob/main/lib/services/free_ai_service.dart"
click node_user_session "https://github.com/pgcshanne/agrilink/blob/main/lib/services/user_session.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_entry toneBlue
class node_disease,node_soil,node_planting,node_seeds,node_tasks toneAmber
class node_weather,node_market,node_analytics toneMint
class node_login,node_register,node_profile,node_translations,node_chat,node_api,node_firebase,node_ai_services,node_user_session toneRose
class node_farmer,node_administrator toneIndigo
```

## Components

### Application

- [App Entry](https://github.com/pgcshanne/agrilink/blob/main/lib/main.dart): `lib/main.dart`

### Farm Guidance

- [Disease Detection](https://github.com/pgcshanne/agrilink/blob/main/lib/disease_detection_page.dart): `lib/disease_detection_page.dart`
- [Soil Analysis](https://github.com/pgcshanne/agrilink/blob/main/lib/soil_analysis_page.dart): `lib/soil_analysis_page.dart`
- [Planting Advisory](https://github.com/pgcshanne/agrilink/blob/main/lib/planting_advisory_page.dart): `lib/planting_advisory_page.dart`
- [Seed Exchange](https://github.com/pgcshanne/agrilink/blob/main/lib/seed_exchange_page.dart): `lib/seed_exchange_page.dart`
- [Growth Tasks](https://github.com/pgcshanne/agrilink/blob/main/lib/tasks_page.dart): `lib/tasks_page.dart`

### Monitoring & Insights

- [Weather](https://github.com/pgcshanne/agrilink/blob/main/lib/weather_page.dart): `lib/weather_page.dart`
- [Market Prices](https://github.com/pgcshanne/agrilink/blob/main/lib/market_price_page.dart): `lib/market_price_page.dart`
- [Analytics](https://github.com/pgcshanne/agrilink/blob/main/lib/analytics_page.dart): `lib/analytics_page.dart`

### Services & Access

- [Login](https://github.com/pgcshanne/agrilink/blob/main/lib/login_page.dart): `lib/login_page.dart`
- [Registration](https://github.com/pgcshanne/agrilink/blob/main/lib/register_page.dart): `lib/register_page.dart`
- [Farmer Profile](https://github.com/pgcshanne/agrilink/blob/main/lib/profile_page.dart): `lib/profile_page.dart`
- [Translations](https://github.com/pgcshanne/agrilink/blob/main/lib/services/app_translations.dart): `lib/services/app_translations.dart`
- [AI Chat](https://github.com/pgcshanne/agrilink/blob/main/lib/widgets/ai_chat_overlay.dart): `lib/widgets/ai_chat_overlay.dart`
- [API Service](https://github.com/pgcshanne/agrilink/blob/main/lib/services/api_service.dart): `lib/services/api_service.dart`
- [Firebase Service](https://github.com/pgcshanne/agrilink/blob/main/lib/services/firebase_service.dart): `lib/services/firebase_service.dart`
- [AI Services](https://github.com/pgcshanne/agrilink/blob/main/lib/services/free_ai_service.dart): `lib/services/free_ai_service.dart`
- [User Session](https://github.com/pgcshanne/agrilink/blob/main/lib/services/user_session.dart): `lib/services/user_session.dart`

### Other components

- **Farmer**
- **Administrator**

## Connections

- Farmer → App Entry: uses
- App Entry → Disease Detection: offers
- App Entry → Soil Analysis: offers
- App Entry → Planting Advisory: offers
- App Entry → Seed Exchange: offers
- App Entry → Growth Tasks: offers
- App Entry → Weather: offers
- App Entry → Market Prices: offers
- App Entry → Analytics: offers
- App Entry → Login: offers
- App Entry → Registration: offers
- App Entry → Farmer Profile: offers
- App Entry → AI Chat: offers
- App Entry → Translations: uses
- App Entry → User Session: uses
- Administrator → Analytics: uses
- API Service → Firebase Service
- AI Services → Disease Detection: may support
- AI Services → Soil Analysis: may support
- AI Services → Planting Advisory: may support
