How syedarsalana789/aqua_twin works
AquaTwin is a local PHP/MySQL flood-monitoring system for public users, administrators, and assigned area operators. The public workflow combines configured gauge observations, FFD river-discharge data, GloFAS history and outlook, and flood-map overlays; staff manage stations, thresholds, notices, and imported data, while operators submit readings and incident reports. The diagram includes documented capabilities whose implementation was not sampled; those relationships rely on README evidence rather than inspection of their source.
Main entry points: index.php Flood dashboard · twin_db.sql AquaTwin database · ffd_sync.php FFD fetch and parser · bootstrap.php Session and DB setup
Components 22
Public monitoring
- Flood dashboard
public/index.php - Map and dashboard client
public/assets/app.js - FFD portal embed
public/api/ffd_embed.php - GFM map overlay
public/api/gfm_capabilities.php
Flood data
- FFD data endpoint
public/api/ffd.php - FFD fetch and parser
app/ffd_sync.php - Official FFD portal
- Forecast and risk API
public/api/prediction.php - Discharge history API
public/api/flood.php - Open-Meteo GloFAS
- Scheduled sync
cron/sync_ffd.php
Staff operations
- Admin dashboard
public/admin.php - Admin data actions
public/admin_data.php - Operator dashboard
public/operator.php - Staff sign-in
public/login.php
Application core
- AquaTwin database
database/twin_db.sql - Session and DB setup
app/bootstrap.php - Auth and audit helpers
app/helpers.php - Database settings
config/database.php
Other components
- Public visitor
- Administrator
- Area operator
Connections 25
- Public visitor → Flood dashboard: opens
README.md - Flood dashboard → Map and dashboard client: renders
- Map and dashboard client → FFD data endpoint: requests data
- Flood dashboard → Forecast and risk API: requests outlook
- Flood dashboard → Discharge history API: requests history
- Flood dashboard → GFM map overlay: offers overlay
- Flood dashboard → FFD portal embed: embeds portal
- FFD data endpoint → FFD fetch and parser: calls when stale
public/api/ffd.php - FFD fetch and parser → Official FFD portal: fetches and parses
app/ffd_sync.php - FFD fetch and parser → AquaTwin database: stores readings
app/ffd_sync.php - Forecast and risk API → Open-Meteo GloFAS: fetches forecast
public/api/prediction.php - Forecast and risk API → AquaTwin database: stores outlook
public/api/prediction.php - Discharge history API → Open-Meteo GloFAS: fetches discharge
- Administrator → Admin dashboard: manages
README.md - Administrator → Admin data actions: imports and configures
README.md - Admin data actions → FFD fetch and parser: starts manual sync
public/admin_data.php - Admin data actions → AquaTwin database: updates monitoring data
- Area operator → Operator dashboard: submits readings
README.md - Operator dashboard → AquaTwin database: records readings and incidents
- Staff sign-in → AquaTwin database: checks account
public/login.php - Staff sign-in → Auth and audit helpers: audits sign-in
public/login.php - Scheduled sync → FFD fetch and parser: runs sync
cron/sync_ffd.php - Session and DB setup → Database settings: loads settings
app/bootstrap.php - Session and DB setup → Auth and audit helpers: loads helpers
app/bootstrap.php - Session and DB setup → AquaTwin database: opens connection
app/bootstrap.php