mirror of
https://github.com/xbgmsharp/postgsail.git
synced 2025-09-17 11:17:46 +00:00
75 lines
2.1 KiB
Markdown
75 lines
2.1 KiB
Markdown
# PostgSail ERD
|
|
The Entity-Relationship Diagram (ERD) provides a graphical representation of database tables, columns, and inter-relationships. ERD can give sufficient information for the database administrator to follow when developing and maintaining the database.
|
|
|
|
## A global overview
|
|
Auto generated Mermaid diagram using [mermerd](https://github.com/KarnerTh/mermerd) and [MermaidJs](https://github.com/mermaid-js/mermaid).
|
|
|
|
|
|
|
|
## Further
|
|
There is 3 main schemas:
|
|
- API Schema:
|
|
- tables
|
|
- metrics
|
|
- logbook
|
|
- ...
|
|
- functions
|
|
- ...
|
|
|
|
- Auth Schema:
|
|
- tables
|
|
- accounts
|
|
- vessels
|
|
- ...
|
|
- functions
|
|
- ...
|
|
|
|
- Public Schema:
|
|
- tables
|
|
- app_settings
|
|
- tpl_messages
|
|
- ...
|
|
- functions
|
|
- ...
|
|
|
|
## Overview
|
|
- Insert data into table metadata from API using PostgREST
|
|
- Insert data into table metrics from API using PostgREST
|
|
- TimescaleDB Hypertable to store signalk metrics
|
|
- pgsql functions to generate logbook, stays, moorages
|
|
- CRON functions to process logbook, stays, moorages
|
|
- python functions for geo reverse and send notification via email and/or pushover
|
|
- Views statistics, timelapse, monitoring, logs
|
|
- Always store time in UTC
|
|
|
|
## Ingest flowchart
|
|
```mermaid
|
|
graph LR
|
|
A[SignalK] -- HTTP POST --> B{PostGREST}
|
|
B -- SQL --> C{PostgreSQL}
|
|
C --> D((metadata trigger))
|
|
C --> E((metrics trigger))
|
|
D --> F{tbl.metadata}
|
|
E --> G{tbl.metrics}
|
|
E --> H{tbl.logs}
|
|
E --> I{tbl.stays}
|
|
```
|
|
|
|
## pg_cron flowchart
|
|
```mermaid
|
|
graph LR
|
|
A[pg_cron] --> B((cron_new_notification))
|
|
A --> C((cron_pre_logbook))
|
|
A --> D((cron_new_logbook))
|
|
A --> E((cron_new_stay))
|
|
A --> F((cron_monitor_offline))
|
|
A --> G((cron_monitor_online))
|
|
C --> K{Validate logbook details}
|
|
D --> L{Update logbook details}
|
|
E --> M{Update stay details}
|
|
L --> N{Update Moorages details}
|
|
M --> N{Update Moorages details}
|
|
B --> O{Update account,vessel,otp}
|
|
F --> P{Update metadata}
|
|
G --> P
|
|
``` |