# lansanacoly7/naatal_agro architecture

> Architecture diagram of the GitHub repository lansanacoly7/naatal_agro, 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/lansanacoly7/naatal_agro
- Repository: https://github.com/lansanacoly7/naatal_agro

## Overview

Nataal Agro is a proposed agricultural decision platform for Senegalese farmers. The documented user workflow is to use the mobile or web client to access the Django API, then consult farming, crop-health, weather, and market guidance. The README documents these capabilities and the intended PostgreSQL and AI stack, but the sampled runtime files are empty; domain links and service integrations are therefore shown as unverified. The tree contains no implementation modules for most documented features.

Main entry points: [`backend`](https://github.com/lansanacoly7/naatal_agro/tree/main/backend) (Django API), [`mobile/lib/main.dart`](https://github.com/lansanacoly7/naatal_agro/blob/main/mobile/lib/main.dart) (Mobile app), [`web/src/App.tsx`](https://github.com/lansanacoly7/naatal_agro/blob/main/web/src/App.tsx) (Web dashboard), [`ai/prompts`](https://github.com/lansanacoly7/naatal_agro/tree/main/ai/prompts) (AI assistant)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_mobile["Mobile app<br/>[main.dart]"]
  node_web["Web dashboard<br/>[App.tsx]"]
end

subgraph group_platform["Platform services"]
  node_api["Django API"]
  node_postgres[("PostgreSQL")]
  node_auth["Authentication"]
  node_profile["User profiles"]
end

subgraph group_agriculture["Agricultural features"]
  node_crops["Crop management"]
  node_markets["Market insights"]
  node_weather["Weather insights"]
  node_notifications["Notifications"]
end

subgraph group_intelligence["AI guidance"]
  node_ai["AI assistant"]
  node_ai_services["AI services"]
end

node_farmer(("Farmer"))

node_farmer -->|"uses"| node_mobile
node_farmer -->|"uses"| node_web
node_mobile -->|"accesses API"| node_api
node_web -->|"accesses API"| node_api
node_api -->|"uses database"| node_postgres
node_api -.->|"provides"| node_auth
node_api -.->|"provides"| node_profile
node_api -.->|"provides"| node_crops
node_api -.->|"provides"| node_markets
node_api -.->|"provides"| node_weather
node_api -.->|"provides"| node_notifications
node_api -.->|"provides"| node_ai
node_ai -.->|"uses"| node_ai_services

click node_mobile "https://github.com/lansanacoly7/naatal_agro/blob/main/mobile/lib/main.dart"
click node_web "https://github.com/lansanacoly7/naatal_agro/blob/main/web/src/App.tsx"
click node_api "https://github.com/lansanacoly7/naatal_agro/tree/main/backend"
click node_postgres "https://github.com/lansanacoly7/naatal_agro/tree/main/database"
click node_auth "https://github.com/lansanacoly7/naatal_agro/tree/main/backend"
click node_profile "https://github.com/lansanacoly7/naatal_agro/tree/main/backend"
click node_crops "https://github.com/lansanacoly7/naatal_agro/tree/main/backend"
click node_markets "https://github.com/lansanacoly7/naatal_agro/tree/main/backend"
click node_weather "https://github.com/lansanacoly7/naatal_agro/tree/main/backend"
click node_notifications "https://github.com/lansanacoly7/naatal_agro/tree/main/backend"
click node_ai "https://github.com/lansanacoly7/naatal_agro/tree/main/ai/prompts"

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_mobile,node_web toneBlue
class node_api,node_postgres,node_auth,node_profile toneAmber
class node_crops,node_markets,node_weather,node_notifications toneMint
class node_ai,node_ai_services toneRose
class node_farmer toneIndigo
```

## Components

### User clients

- [Mobile app](https://github.com/lansanacoly7/naatal_agro/blob/main/mobile/lib/main.dart): `mobile/lib/main.dart`
- [Web dashboard](https://github.com/lansanacoly7/naatal_agro/blob/main/web/src/App.tsx): `web/src/App.tsx`

### Platform services

- [Django API](https://github.com/lansanacoly7/naatal_agro/tree/main/backend): `backend`
- [PostgreSQL](https://github.com/lansanacoly7/naatal_agro/tree/main/database): `database`
- [Authentication](https://github.com/lansanacoly7/naatal_agro/tree/main/backend): `backend`
- [User profiles](https://github.com/lansanacoly7/naatal_agro/tree/main/backend): `backend`

### Agricultural features

- [Crop management](https://github.com/lansanacoly7/naatal_agro/tree/main/backend): `backend`
- [Market insights](https://github.com/lansanacoly7/naatal_agro/tree/main/backend): `backend`
- [Weather insights](https://github.com/lansanacoly7/naatal_agro/tree/main/backend): `backend`
- [Notifications](https://github.com/lansanacoly7/naatal_agro/tree/main/backend): `backend`

### AI guidance

- [AI assistant](https://github.com/lansanacoly7/naatal_agro/tree/main/ai/prompts): `ai/prompts`
- **AI services**

### Other components

- **Farmer**

## Connections

- Farmer → Mobile app: uses (evidence: `README.md`)
- Farmer → Web dashboard: uses (evidence: `README.md`)
- Mobile app → Django API: accesses API (evidence: `README.md`)
- Web dashboard → Django API: accesses API (evidence: `README.md`)
- Django API → PostgreSQL: uses database (evidence: `README.md`)
- Django API → Authentication: provides
- Django API → User profiles: provides
- Django API → Crop management: provides
- Django API → Market insights: provides
- Django API → Weather insights: provides
- Django API → Notifications: provides
- Django API → AI assistant: provides
- AI assistant → AI services: uses
