forked from Ruderverein-Donau-Linz/rowt
60 lines
2.3 KiB
Markdown
60 lines
2.3 KiB
Markdown
# Database
|
|
|
|
Since the database stabilized quite well over the last months/years, hopefully it will not change that much in the future.
|
|
Thus, here is the current (October '24) model and the reasoning behind it:
|
|
|
|
## User
|
|
|
|
|
|
- All user-relevant fields are stored in `User`.
|
|
- `Role` (and its associative table `UserRole`) map current roles the user has. This is used for e.g. permissions (`Vorstand`, `Admin`, `cox`, ... roles) and fee calculation (`Donau Linz`, `scheckbuch`, `Rennjugend`).
|
|
- `Family` specifies, well, a family. Currently only used for fee calculation.
|
|
- `cluster` in `Role` groups roles together. There is a db check to only allow for at most 1 role of the same cluster (e.g. either `cox` or `bootsfuehrer`, but not both).
|
|
|
|
## Planned rowing adventures :-)
|
|
|
|
|
|
There are 2 main types:
|
|
|
|
1. **Trips:** Trips can be created by every cox. They are "simple", every-day trips.
|
|
2. **Events:** Events can be created by everyone who has the `manage_events` role. They are used if multiple coxes are needed, e.g. for "Fetzenfahrt", "Anrudern", .... Additionally, events are shown in public calendar (e.g. on the website).
|
|
|
|
`TripDetails` extracts the common data for both Trips and Events.
|
|
Rower can register using the `UserTrip` table.
|
|
This table expects either...
|
|
|
|
- a `user_id`, if a person who has an account registers to the trip/event
|
|
- a `user_note`, if the cox of a trip, or a `manage_events` user of an event wants to add a guest which has no account
|
|
|
|
## Logbook
|
|
|
|
|
|
If `arrival` is NULL, the boat is assumed to still be on the water.
|
|
There are a few `LogbookType`s:
|
|
|
|
- `Wanderfahrt`: Used to check if a user has accomplished their `Fahrtenabzeichen` in the current year.
|
|
- `Regatta`
|
|
|
|
If the number of users entered is less than the boat's maximum capacity, the remaining spaces will be automatically assigned to guests.
|
|
|
|
## Boat
|
|
|
|
|
|
## Trailer
|
|
|
|
|
|
## Fetching
|
|
|
|
|
|
This tables are used to automatically fetch data (every hour). Currently we have:
|
|
|
|
- `Waterlevel` which fetches the current waterlevel in Linz from hydro (with their explicit permission :-))
|
|
- `Weather` weather data from *Open Weather*
|
|
|
|
## Misc
|
|
|
|
|
|
- **Log:** Logs "interesting" activities, to be viewed in the web ui
|
|
- **Notification**
|
|
- **Distance:** Default distances of certain common targets
|