# ko7ila30/soil-platform architecture

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

- Interactive diagram: https://gitdiagram.com/ko7ila30/soil-platform
- Repository: https://github.com/ko7ila30/soil-platform

## Overview

This is a participatory soil-observation web platform: contributors explore mapped sites and soil zones, inspect site observations, and submit observations or new spatial features; stored records are served as GeoJSON and tabular/API results. The map also supports feature search/editing and localized UI, while account registration and login provide a separate access capability. The README documents the Flask–PostGIS runtime and principal site API; sampled code confirms validation and zone endpoints. Several UI and API details are only partially excerpted, so the graph omits uncertain links rather than inferring them.

Main entry points: [`app.py`](https://github.com/ko7ila30/soil-platform/blob/main/app.py) (Flask routes), [`static/js/carte.js`](https://github.com/ko7ila30/soil-platform/blob/main/static/js/carte.js) (Interactive map), [`zones_api.py`](https://github.com/ko7ila30/soil-platform/blob/main/zones_api.py) (Zone endpoints), [`db.py`](https://github.com/ko7ila30/soil-platform/blob/main/db.py) (DB connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Map experience"]
  node_map_ui["Interactive map<br/>[carte.js]"]
  node_form_ui["Observation forms<br/>[forms.js]"]
  node_translations["Translations<br/>[translations.js]"]
end

subgraph group_web["Web application"]
  node_app["Flask routes<br/>[app.py]"]
  node_validation["Input validation<br/>[validators.py]"]
  node_config["Domain configuration<br/>[config.py]"]
  node_db_helper["DB connection<br/>[db.py]"]
end

subgraph group_spatial["Spatial data"]
  node_zones_api["Zone endpoints<br/>[zones_api.py]"]
  node_postgis[("PostGIS records<br/>[schema.sql]")]
end

subgraph group_access["Accounts"]
  node_auth["Login and registration<br/>[auth.py]"]
end

node_contributor(("Contributor"))
node_map_tiles["Map tile service"]

node_contributor -->|"explores"| node_map_ui
node_map_ui -->|"fetches sites"| node_app
node_map_ui -->|"fetches zones"| node_zones_api
node_contributor -->|"submits records"| node_form_ui
node_app -->|"validates input"| node_validation
node_app -->|"opens connection"| node_db_helper
node_app -->|"uses settings"| node_config
node_app -->|"registers blueprint"| node_zones_api
node_zones_api -->|"queries data"| node_db_helper
node_zones_api -->|"reads map bounds"| node_config
node_db_helper -->|"connects to"| node_postgis
node_contributor -->|"registers or logs in"| node_auth
node_auth -->|"queries accounts"| node_db_helper
node_map_ui -->|"renders basemaps"| node_map_tiles

click node_map_ui "https://github.com/ko7ila30/soil-platform/blob/main/static/js/carte.js"
click node_form_ui "https://github.com/ko7ila30/soil-platform/blob/main/static/js/forms.js"
click node_translations "https://github.com/ko7ila30/soil-platform/blob/main/static/js/translations.js"
click node_app "https://github.com/ko7ila30/soil-platform/blob/main/app.py"
click node_validation "https://github.com/ko7ila30/soil-platform/blob/main/validators.py"
click node_config "https://github.com/ko7ila30/soil-platform/blob/main/config.py"
click node_db_helper "https://github.com/ko7ila30/soil-platform/blob/main/db.py"
click node_zones_api "https://github.com/ko7ila30/soil-platform/blob/main/zones_api.py"
click node_auth "https://github.com/ko7ila30/soil-platform/blob/main/auth.py"
click node_postgis "https://github.com/ko7ila30/soil-platform/blob/main/database/schema.sql"

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_map_ui,node_form_ui,node_translations toneBlue
class node_app,node_validation,node_config,node_db_helper toneAmber
class node_zones_api,node_postgis toneMint
class node_auth toneRose
class node_contributor,node_map_tiles toneIndigo
```

## Components

### Map experience

- [Interactive map](https://github.com/ko7ila30/soil-platform/blob/main/static/js/carte.js): `static/js/carte.js`
- [Observation forms](https://github.com/ko7ila30/soil-platform/blob/main/static/js/forms.js): `static/js/forms.js`
- [Translations](https://github.com/ko7ila30/soil-platform/blob/main/static/js/translations.js): `static/js/translations.js`

### Web application

- [Flask routes](https://github.com/ko7ila30/soil-platform/blob/main/app.py): `app.py`
- [Input validation](https://github.com/ko7ila30/soil-platform/blob/main/validators.py): `validators.py`
- [Domain configuration](https://github.com/ko7ila30/soil-platform/blob/main/config.py): `config.py`
- [DB connection](https://github.com/ko7ila30/soil-platform/blob/main/db.py): `db.py`

### Spatial data

- [Zone endpoints](https://github.com/ko7ila30/soil-platform/blob/main/zones_api.py): `zones_api.py`
- [PostGIS records](https://github.com/ko7ila30/soil-platform/blob/main/database/schema.sql): `database/schema.sql`

### Accounts

- [Login and registration](https://github.com/ko7ila30/soil-platform/blob/main/auth.py): `auth.py`

### Other components

- **Contributor**
- **Map tile service**

## Connections

- Contributor → Interactive map: explores (evidence: `README.md`)
- Interactive map → Flask routes: fetches sites (evidence: `static/js/carte.js`)
- Interactive map → Zone endpoints: fetches zones (evidence: `static/js/carte.js`)
- Contributor → Observation forms: submits records (evidence: `README.md`)
- Flask routes → Input validation: validates input (evidence: `app.py`)
- Flask routes → DB connection: opens connection (evidence: `app.py`)
- Flask routes → Domain configuration: uses settings (evidence: `app.py`)
- Flask routes → Zone endpoints: registers blueprint (evidence: `zones_api.py`)
- Zone endpoints → DB connection: queries data (evidence: `zones_api.py`)
- Zone endpoints → Domain configuration: reads map bounds (evidence: `zones_api.py`)
- DB connection → PostGIS records: connects to (evidence: `README.md`)
- Contributor → Login and registration: registers or logs in (evidence: `auth.py`)
- Login and registration → DB connection: queries accounts (evidence: `auth.py`)
- Interactive map → Map tile service: renders basemaps (evidence: `README.md`)
