# ki-repos/geopotent architecture

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

- Interactive diagram: https://gitdiagram.com/ki-repos/geopotent
- Repository: https://github.com/ki-repos/geopotent

## Overview

GeoPotent is a Django application for assessing land’s solar, wind, and agricultural potential, with a landowner–builder marketplace. Landowners submit location, area, dates, and system settings; the analysis workflow obtains soil and weather data, calculates crop and energy/revenue potential, persists results, and presents reports. Separate account and marketplace workflows support builder profiles, land listings, proposals, and investment decisions. The sampled code supports the analysis and marketplace structure; unsampled implementation details are represented only where the URL configuration or source index provides evidence.

Main entry points: [`potential_app/urls.py`](https://github.com/ki-repos/geopotent/blob/main/potential_app/urls.py) (Application Routes), [`potential_app/views.py`](https://github.com/ki-repos/geopotent/blob/main/potential_app/views.py) (Analysis Processing), [`potential_app/models.py`](https://github.com/ki-repos/geopotent/blob/main/potential_app/models.py) (Land and Analysis Records), [`potential_app/views_business.py`](https://github.com/ki-repos/geopotent/blob/main/potential_app/views_business.py) (Proposal Workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Land Analysis"]
  node_analysis_input["Analysis Input<br/>[views.py]"]
  node_analysis_forms["Analysis Forms<br/>[forms.py]"]
  node_analysis_process["Analysis Processing<br/>[views.py]"]
  node_soil_analysis["Soil Analysis<br/>[soil_analysis.py]"]
  node_energy_estimation["Energy Estimation"]
  node_results_reports["Results and Reports<br/>[views.py]"]
end

subgraph group_domain["Domain Data"]
  node_domain_records[("Land and Analysis Records<br/>[models.py]")]
  node_accounts_records[("User and Builder Profiles<br/>[models.py]")]
  node_market_records[("Proposals and Bonds<br/>[models.py]")]
end

subgraph group_marketplace["Marketplace"]
  node_land_listing["Land Listings<br/>[views_business.py]"]
  node_builder_directory["Builder Directory<br/>[views_business.py]"]
  node_proposal_workflow["Proposal Workflow<br/>[views_business.py]"]
  node_dashboard["Role Dashboard<br/>[views_business.py]"]
end

subgraph group_accounts["Accounts"]
  node_signup_login["Signup and Login<br/>[views_auth.py]"]
  node_account_forms["Account Forms<br/>[forms.py]"]
end

node_landowner(("Landowner"))
node_builder(("Builder"))
node_routes["Application Routes<br/>[urls.py]"]
node_soilgrids["SoilGrids API"]
node_openmeteo["Open-Meteo API"]

node_landowner -->|"uses"| node_routes
node_builder -->|"uses"| node_routes
node_routes -->|"routes to"| node_analysis_input
node_routes -->|"routes to"| node_analysis_process
node_routes -->|"routes to"| node_results_reports
node_routes -->|"routes to"| node_signup_login
node_routes -->|"routes to"| node_land_listing
node_routes -->|"routes to"| node_builder_directory
node_routes -->|"routes to"| node_proposal_workflow
node_routes -->|"routes to"| node_dashboard
node_analysis_input -->|"renders"| node_analysis_forms
node_analysis_forms -->|"models"| node_domain_records
node_analysis_process -->|"requests soil data"| node_soil_analysis
node_analysis_process -->|"estimates energy"| node_energy_estimation
node_soil_analysis -->|"fetches soil data"| node_soilgrids
node_energy_estimation -->|"fetches weather"| node_openmeteo
node_analysis_process -->|"loads and saves"| node_domain_records
node_analysis_process -->|"redirects to results"| node_results_reports
node_results_reports -->|"reads analysis"| node_domain_records
node_signup_login -->|"uses signup form"| node_account_forms
node_account_forms -->|"models"| node_accounts_records
node_signup_login -->|"creates profiles"| node_accounts_records
node_land_listing -->|"creates land"| node_domain_records
node_builder_directory -->|"lists builders"| node_accounts_records
node_proposal_workflow -->|"creates and updates"| node_market_records
node_proposal_workflow -->|"links land analysis"| node_domain_records
node_dashboard -->|"reads proposals"| node_market_records

click node_routes "https://github.com/ki-repos/geopotent/blob/main/potential_app/urls.py"
click node_analysis_input "https://github.com/ki-repos/geopotent/blob/main/potential_app/views.py"
click node_analysis_forms "https://github.com/ki-repos/geopotent/blob/main/potential_app/forms.py"
click node_analysis_process "https://github.com/ki-repos/geopotent/blob/main/potential_app/views.py"
click node_soil_analysis "https://github.com/ki-repos/geopotent/blob/main/utils/soil_analysis.py"
click node_energy_estimation "https://github.com/ki-repos/geopotent/blob/main/utils/energy_estimation.py"
click node_results_reports "https://github.com/ki-repos/geopotent/blob/main/potential_app/views.py"
click node_domain_records "https://github.com/ki-repos/geopotent/blob/main/potential_app/models.py"
click node_accounts_records "https://github.com/ki-repos/geopotent/blob/main/potential_app/models.py"
click node_market_records "https://github.com/ki-repos/geopotent/blob/main/potential_app/models.py"
click node_signup_login "https://github.com/ki-repos/geopotent/blob/main/potential_app/views_auth.py"
click node_account_forms "https://github.com/ki-repos/geopotent/blob/main/potential_app/forms.py"
click node_land_listing "https://github.com/ki-repos/geopotent/blob/main/potential_app/views_business.py"
click node_builder_directory "https://github.com/ki-repos/geopotent/blob/main/potential_app/views_business.py"
click node_proposal_workflow "https://github.com/ki-repos/geopotent/blob/main/potential_app/views_business.py"
click node_dashboard "https://github.com/ki-repos/geopotent/blob/main/potential_app/views_business.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_analysis_input,node_analysis_forms,node_analysis_process,node_soil_analysis,node_energy_estimation,node_results_reports toneBlue
class node_domain_records,node_accounts_records,node_market_records toneAmber
class node_land_listing,node_builder_directory,node_proposal_workflow,node_dashboard,node_routes,node_soilgrids,node_openmeteo toneMint
class node_signup_login,node_account_forms toneRose
class node_landowner,node_builder toneIndigo
```

## Components

### Land Analysis

- [Analysis Input](https://github.com/ki-repos/geopotent/blob/main/potential_app/views.py): `potential_app/views.py`
- [Analysis Forms](https://github.com/ki-repos/geopotent/blob/main/potential_app/forms.py): `potential_app/forms.py`
- [Analysis Processing](https://github.com/ki-repos/geopotent/blob/main/potential_app/views.py): `potential_app/views.py`
- [Soil Analysis](https://github.com/ki-repos/geopotent/blob/main/utils/soil_analysis.py): `utils/soil_analysis.py`
- [Energy Estimation](https://github.com/ki-repos/geopotent/blob/main/utils/energy_estimation.py): `utils/energy_estimation.py`
- [Results and Reports](https://github.com/ki-repos/geopotent/blob/main/potential_app/views.py): `potential_app/views.py`

### Domain Data

- [Land and Analysis Records](https://github.com/ki-repos/geopotent/blob/main/potential_app/models.py): `potential_app/models.py`
- [User and Builder Profiles](https://github.com/ki-repos/geopotent/blob/main/potential_app/models.py): `potential_app/models.py`
- [Proposals and Bonds](https://github.com/ki-repos/geopotent/blob/main/potential_app/models.py): `potential_app/models.py`

### Marketplace

- [Land Listings](https://github.com/ki-repos/geopotent/blob/main/potential_app/views_business.py): `potential_app/views_business.py`
- [Builder Directory](https://github.com/ki-repos/geopotent/blob/main/potential_app/views_business.py): `potential_app/views_business.py`
- [Proposal Workflow](https://github.com/ki-repos/geopotent/blob/main/potential_app/views_business.py): `potential_app/views_business.py`
- [Role Dashboard](https://github.com/ki-repos/geopotent/blob/main/potential_app/views_business.py): `potential_app/views_business.py`

### Accounts

- [Signup and Login](https://github.com/ki-repos/geopotent/blob/main/potential_app/views_auth.py): `potential_app/views_auth.py`
- [Account Forms](https://github.com/ki-repos/geopotent/blob/main/potential_app/forms.py): `potential_app/forms.py`

### Other components

- **Landowner**
- **Builder**
- [Application Routes](https://github.com/ki-repos/geopotent/blob/main/potential_app/urls.py): `potential_app/urls.py`
- **SoilGrids API**
- **Open-Meteo API**

## Connections

- Landowner → Application Routes: uses (evidence: `potential_app/urls.py`)
- Builder → Application Routes: uses (evidence: `potential_app/urls.py`)
- Application Routes → Analysis Input: routes to (evidence: `potential_app/urls.py`)
- Application Routes → Analysis Processing: routes to (evidence: `potential_app/urls.py`)
- Application Routes → Results and Reports: routes to (evidence: `potential_app/urls.py`)
- Application Routes → Signup and Login: routes to (evidence: `potential_app/urls.py`)
- Application Routes → Land Listings: routes to (evidence: `potential_app/urls.py`)
- Application Routes → Builder Directory: routes to (evidence: `potential_app/urls.py`)
- Application Routes → Proposal Workflow: routes to (evidence: `potential_app/urls.py`)
- Application Routes → Role Dashboard: routes to (evidence: `potential_app/urls.py`)
- Analysis Input → Analysis Forms: renders (evidence: `potential_app/views.py`)
- Analysis Forms → Land and Analysis Records: models (evidence: `potential_app/forms.py`)
- Analysis Processing → Soil Analysis: requests soil data (evidence: `potential_app/views.py`)
- Analysis Processing → Energy Estimation: estimates energy (evidence: `potential_app/views.py`)
- Soil Analysis → SoilGrids API: fetches soil data (evidence: `utils/soil_analysis.py`)
- Energy Estimation → Open-Meteo API: fetches weather (evidence: `utils/energy_estimation.py`)
- Analysis Processing → Land and Analysis Records: loads and saves (evidence: `potential_app/views.py`)
- Analysis Processing → Results and Reports: redirects to results (evidence: `potential_app/urls.py`)
- Results and Reports → Land and Analysis Records: reads analysis (evidence: `potential_app/views.py`)
- Signup and Login → Account Forms: uses signup form (evidence: `potential_app/views_auth.py`)
- Account Forms → User and Builder Profiles: models (evidence: `potential_app/forms.py`)
- Signup and Login → User and Builder Profiles: creates profiles (evidence: `potential_app/views_auth.py`)
- Land Listings → Land and Analysis Records: creates land (evidence: `potential_app/views_business.py`)
- Builder Directory → User and Builder Profiles: lists builders (evidence: `potential_app/views_business.py`)
- Proposal Workflow → Proposals and Bonds: creates and updates (evidence: `potential_app/views_business.py`)
- Proposal Workflow → Land and Analysis Records: links land analysis (evidence: `potential_app/views_business.py`)
- Role Dashboard → Proposals and Bonds: reads proposals (evidence: `potential_app/views_business.py`)
