# a-igumenov/environment-parameter-monitoring-map architecture

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

- Interactive diagram: https://gitdiagram.com/a-igumenov/environment-parameter-monitoring-map
- Repository: https://github.com/a-igumenov/environment-parameter-monitoring-map

## Overview

Tai PHP/MySQL aplinkos stebėsenos platforma: IoT jutikliai siunčia matavimus per REST API, o viešas žemėlapis pateikia jų vietą ir naujausius rodmenis; naudotojai taip pat gali peržiūrėti istoriją. Administratorius konfigūruoja sistemą, tvarko jutiklius ir stebi veikimą. Pateiktos ištraukos patvirtina pagrindinius API, žemėlapio, autentifikavimo ir administravimo ryšius; dalis kitų funkcijų žinoma iš README, todėl jų ryšiai pažymėti kaip dokumentuoti.

Main entry points: [`api/sensors.php`](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/sensors.php) (Jutiklių REST API), [`includes/config.php`](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/config.php) (Konfigūracija ir DB ryšys), [`index.php`](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/index.php) (Žemėlapis ir filtrai), [`schema.sql`](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/schema.sql) (MySQL duomenų bazė)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Jutiklių duomenys"]
  node_api["Jutiklių REST API<br/>[sensors.php]"]
  node_v1["API v1 maršrutas<br/>[sensors.php]"]
  node_city["Miesto priskyrimas<br/>[cities.php]"]
end

subgraph group_public["Vieša stebėsena"]
  node_map["Žemėlapis ir filtrai<br/>[index.php]"]
  node_history["Rodmenų istorija<br/>[sensors.php]"]
  node_privacy["Privatumo puslapis<br/>[privacy.php]"]
  node_cookies["Slapukų sutikimas<br/>[cookies.php]"]
end

subgraph group_admin["Administravimas"]
  node_admin_panel["Sąranka ir skydas<br/>[admin.php]"]
  node_sensor_manage["Jutiklių valdymas<br/>[manage.php]"]
  node_auth["Administratoriaus autentifikacija<br/>[auth.php]"]
  node_health_cleanup["Sveikata ir valymas<br/>[cleanup.php]"]
  node_backup["Duomenų atsarginės kopijos<br/>[backup.php]"]
end

subgraph group_platform["Platformos paslaugos"]
  node_config["Konfigūracija ir DB ryšys<br/>[config.php]"]
  node_security["Saugumo antraštės<br/>[security.php]"]
  node_database[("MySQL duomenų bazė<br/>[schema.sql]")]
  node_map_tiles["Žemėlapių tiekėjai"]
  node_chartjs["Chart.js CDN"]
end

node_devices(("IoT jutikliai"))
node_visitors(("Žemėlapio lankytojai"))
node_admin_user(("Administratorius"))

node_devices -->|"siunčia matavimus"| node_api
node_v1 -->|"persiunčia užklausas"| node_api
node_api -->|"priskiria miestą"| node_city
node_api -->|"skaito ir įrašo"| node_database
node_visitors -->|"žiūri žemėlapį"| node_map
node_map -->|"pateikia žemėlapio duomenis"| node_api
node_visitors -->|"peržiūri istoriją"| node_history
node_history -->|"skaito rodmenis"| node_database
node_map -->|"rodo žemėlapį"| node_map_tiles
node_map -->|"naudoja grafikuose"| node_chartjs
node_admin_user -->|"konfigūruoja sistemą"| node_admin_panel
node_admin_user -->|"tvarko jutiklius"| node_sensor_manage
node_admin_panel -->|"tikrina prieigą"| node_auth
node_sensor_manage -->|"tikrina prieigą"| node_auth
node_admin_panel -->|"atnaujina nustatymus"| node_config
node_sensor_manage -.->|"atlieka valdymo veiksmus"| node_api
node_health_cleanup -->|"naudoja DB ryšį"| node_config
node_health_cleanup -.->|"tikrina ir valo"| node_database
node_backup -->|"skaito DB nustatymus"| node_config
node_backup -->|"kuria kopijas"| node_database
node_config -->|"įkelia saugumo funkcijas"| node_security
node_privacy -->|"skaito nustatymus"| node_config
node_cookies -->|"skaito žemėlapio tiekėją"| node_config
node_cookies -->|"naudoja sesiją"| node_auth

click node_api "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/sensors.php"
click node_v1 "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/v1/sensors.php"
click node_city "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/cities.php"
click node_map "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/index.php"
click node_history "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/sensors.php"
click node_privacy "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/privacy.php"
click node_cookies "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/cookies.php"
click node_admin_panel "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/admin.php"
click node_sensor_manage "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/manage.php"
click node_auth "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/auth.php"
click node_health_cleanup "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/cleanup.php"
click node_backup "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/backup.php"
click node_config "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/config.php"
click node_security "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/security.php"
click node_database "https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/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_api,node_v1,node_city toneBlue
class node_map,node_history,node_privacy,node_cookies toneAmber
class node_admin_panel,node_sensor_manage,node_auth,node_health_cleanup,node_backup,node_visitors toneMint
class node_config,node_security,node_database,node_map_tiles,node_chartjs toneRose
class node_devices,node_admin_user toneIndigo
```

## Components

### Jutiklių duomenys

- [Jutiklių REST API](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/sensors.php): `api/sensors.php`
- [API v1 maršrutas](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/v1/sensors.php): `api/v1/sensors.php`
- [Miesto priskyrimas](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/cities.php): `includes/cities.php`

### Vieša stebėsena

- [Žemėlapis ir filtrai](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/index.php): `index.php`
- [Rodmenų istorija](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/sensors.php): `api/sensors.php`
- [Privatumo puslapis](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/privacy.php): `privacy.php`
- [Slapukų sutikimas](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/cookies.php): `cookies.php`

### Administravimas

- [Sąranka ir skydas](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/admin.php): `includes/admin.php`
- [Jutiklių valdymas](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/manage.php): `manage.php`
- [Administratoriaus autentifikacija](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/auth.php): `includes/auth.php`
- [Sveikata ir valymas](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/cleanup.php): `api/cleanup.php`
- [Duomenų atsarginės kopijos](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/api/backup.php): `api/backup.php`

### Platformos paslaugos

- [Konfigūracija ir DB ryšys](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/config.php): `includes/config.php`
- [Saugumo antraštės](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/includes/security.php): `includes/security.php`
- [MySQL duomenų bazė](https://github.com/a-igumenov/environment-parameter-monitoring-map/blob/main/schema.sql): `schema.sql`
- **Žemėlapių tiekėjai**
- **Chart.js CDN**

### Other components

- **IoT jutikliai**
- **Žemėlapio lankytojai**
- **Administratorius**

## Connections

- IoT jutikliai → Jutiklių REST API: siunčia matavimus (evidence: `README.md`)
- API v1 maršrutas → Jutiklių REST API: persiunčia užklausas (evidence: `api/v1/sensors.php`)
- Jutiklių REST API → Miesto priskyrimas: priskiria miestą (evidence: `api/sensors.php`)
- Jutiklių REST API → MySQL duomenų bazė: skaito ir įrašo (evidence: `api/sensors.php`)
- Žemėlapio lankytojai → Žemėlapis ir filtrai: žiūri žemėlapį (evidence: `README.md`)
- Žemėlapis ir filtrai → Jutiklių REST API: pateikia žemėlapio duomenis (evidence: `README.md`)
- Žemėlapio lankytojai → Rodmenų istorija: peržiūri istoriją (evidence: `README.md`)
- Rodmenų istorija → MySQL duomenų bazė: skaito rodmenis (evidence: `api/sensors.php`)
- Žemėlapis ir filtrai → Žemėlapių tiekėjai: rodo žemėlapį (evidence: `README.md`)
- Žemėlapis ir filtrai → Chart.js CDN: naudoja grafikuose (evidence: `index.php`)
- Administratorius → Sąranka ir skydas: konfigūruoja sistemą (evidence: `README.md`)
- Administratorius → Jutiklių valdymas: tvarko jutiklius (evidence: `README.md`)
- Sąranka ir skydas → Administratoriaus autentifikacija: tikrina prieigą (evidence: `includes/admin.php`)
- Jutiklių valdymas → Administratoriaus autentifikacija: tikrina prieigą (evidence: `manage.php`)
- Sąranka ir skydas → Konfigūracija ir DB ryšys: atnaujina nustatymus (evidence: `includes/admin.php`)
- Jutiklių valdymas → Jutiklių REST API: atlieka valdymo veiksmus
- Sveikata ir valymas → Konfigūracija ir DB ryšys: naudoja DB ryšį (evidence: `api/cleanup.php`)
- Sveikata ir valymas → MySQL duomenų bazė: tikrina ir valo
- Duomenų atsarginės kopijos → Konfigūracija ir DB ryšys: skaito DB nustatymus (evidence: `api/backup.php`)
- Duomenų atsarginės kopijos → MySQL duomenų bazė: kuria kopijas (evidence: `api/backup.php`)
- Konfigūracija ir DB ryšys → Saugumo antraštės: įkelia saugumo funkcijas (evidence: `includes/config.php`)
- Privatumo puslapis → Konfigūracija ir DB ryšys: skaito nustatymus (evidence: `privacy.php`)
- Slapukų sutikimas → Konfigūracija ir DB ryšys: skaito žemėlapio tiekėją (evidence: `cookies.php`)
- Slapukų sutikimas → Administratoriaus autentifikacija: naudoja sesiją (evidence: `cookies.php`)
