linus/OAMC-Auswertung
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Erstumsetzung: OAMC Turnierauswertung (AP 0–7, 9)

Browse Source 
* Datenmodell + Alembic-Initialmigration (Plan §4), Seed Saison 2026
* Wertungs-Engine (Plan §3.3), regelbasiert je Kategorie/Saison
  - Abnahmetest gegen die Ergebnisliste 2026-05-31
* Meisterschaftsberechnung mit Streichresultaten + Tie-Break
  (PLATZHALTER-Punktetabelle, O-1 offen)
* Ingest-API (idempotent, dry_run) inkl. Excel-Leser und Fahrer-Matching/Merge
* Zeitmessungs-Endpoint (Batch, idempotent, unzugeordnet/unplausibel) + SSE-Anzeige
  - Mess-Pi-Client bewusst NICHT enthalten (docs/zeitmessung-endpoint.md)
* Frontend: öffentliche Seiten + internes Backend (Jinja2/HTMX, kein Build)
* Auslieferung: Docker (multi-arch) + docker-compose sowie Debian-Paket/APT-Repo
* 57 Tests grün gegen echte PostgreSQL-Testdatenbank

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
linus
2026-09-05 18:49:00 +02:00
co-authored by Claude Sonnet 5
commit 03f6fdb0d9
115 changed files with 8041 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/settings.json
+7
View File
@@ -0,0 +1,7 @@
{
"permissions": {
"allow": [
"Bash(python3 pdftxt.py /home/linus/.claude/projects/-home-linus-OAMC/40bc91cb-023f-4cbe-8d30-ab5118a56de2/tool-results/webfetch-1788609089573-vokmc5.pdf)"
]
}
}
.claude/settings.local.json
+10
View File
@@ -0,0 +1,10 @@
{
"permissions": {
"allow": [
"WebFetch(domain:www.oamc.de)",
"WebFetch(domain:oamc.de)",
"Bash(python3 -c \"import pypdf; print\\('pypdf ok'\\)\")",
"Bash(python3 -c \"import fitz; print\\('pymupdf ok'\\)\")"
]
}
}
.dockerignore
+18
View File
@@ -0,0 +1,18 @@
.venv/
.git/
.gitignore
.pytest_cache/
.ruff_cache/
.mypy_cache/
**/__pycache__/
*.pyc
tests/
docs/
debian/
deploy/
packaging/
var/
*.sqlite
.env
.env.*
!.env.example
.env.example
+26
View File
@@ -0,0 +1,26 @@
# OAMC Turnierauswertung — Beispiel-Konfiguration
# Kopieren nach .env und anpassen. Alle Werte koennen auch als Umgebungsvariable
# mit Prefix OAMC_ gesetzt werden (z. B. OAMC_DATABASE_URL).
# --- Datenbank ---------------------------------------------------------------
OAMC_DATABASE_URL=postgresql+psycopg://linus:linus@localhost:5432/oamc_dev
# --- Sicherheit ------------------------------------------------------------
# Signierschluessel fuer Session-/JWT-Cookies. In Produktion zwingend setzen!
OAMC_SECRET_KEY=bitte-aendern-mindestens-32-zeichen-zufaellig
# Kommagetrennte API-Keys fuer den Ingest (Excel-Auswertung etc.)
OAMC_INGEST_API_KEYS=dev-ingest-key
# --- Betrieb ---------------------------------------------------------------
OAMC_ENV=dev
OAMC_LOG_LEVEL=info
# Basis-URL, unter der die Anwendung oeffentlich erreichbar ist (fuer iCal, Links)
OAMC_PUBLIC_BASE_URL=http://localhost:8000
# Verzeichnis fuer Uploads (PDFs, Bilder)
OAMC_UPLOAD_DIR=./var/uploads
# --- Zeitmessung / Geraete ----------------------------------------------
# Plausibilitaetsgrenzen fuer eine Einzelmessung in Sekunden (global; je Klasse
# spaeter aus der DB). Verstoesse werden markiert, nicht abgelehnt.
OAMC_MESS_MIN_SEKUNDEN=15
OAMC_MESS_MAX_SEKUNDEN=600
.gitignore
+41
View File
@@ -0,0 +1,41 @@
# Python
__pycache__/
*.py[cod]
*.egg-info/
.eggs/
build/
dist/
.venv/
venv/
.mypy_cache/
.ruff_cache/
.pytest_cache/
# Lokale Konfiguration & Secrets
.env
.env.*
!.env.example
*.local.toml
# Laufzeitdaten
/var/
uploads/
*.sqlite
*.sqlite3
*.db
# Debian-Build-Artefakte
debian/.debhelper/
debian/oamc-turnier/
debian/files
debian/*.substvars
debian/*.log
debian/debhelper-build-stamp
../*.deb
../*.buildinfo
../*.changes
# Editor
.idea/
.vscode/
*.swp
README.md
+138
View File
@@ -0,0 +1,138 @@
# OAMC Turnierauswertung
Webanwendung zur Auswertung von **ADAC Motorrad-Turnieren** des OAMC Reinheim e.V.:
Ergebnisse (Fehlerpunkte + Zeit → Platzierung), Fahrerdatenbank mit Historie,
Meisterschaftswertung und ein **Endpoint für die Lichtschranken-Zeitmessung**.
Fachliche Grundlagen, offene Fragen und Architekturbegründung: **[`plan.md`](plan.md)**.
> Der Mess-Pi-Client (GPIO/Lichtschranke) ist **nicht** Teil dieses Repos — die
> Anwendung stellt nur den Endpoint bereit. Contract:
> [`docs/zeitmessung-endpoint.md`](docs/zeitmessung-endpoint.md).
---
## Stack
| Schicht | Wahl |
|---|---|
| DB | PostgreSQL 17 (JSONB, ARRAY, `pg_trgm`) |
| Backend | Python 3.11+ · FastAPI · SQLAlchemy 2 · Alembic · Pydantic v2 |
| Frontend | serverseitig gerendertes Jinja2 + HTMX (kein Node, kein Build) |
| Live | Server-Sent Events (`sse-starlette`) |
| Auslieferung | **Docker-Image** *und* **Debian-Paket** (`.deb` / eigenes APT-Repo) |
## Projektstruktur
```
src/oamc/
models/ ORM (§4 im Plan)
wertung/ Wertungs-Engine — der Kern (§3.3). engine.py + service.py
meisterschaft/ Punkte, Streichresultate, Tie-Break, Endlaufquali (§3.4)
matching/ Fahrer-Dublettenerkennung + Merge (§6.4)
importer/ Bulk-Ingest + Excel-Leser
geraete/ Zeitmessungs-Endpoint-Logik (§3.6)
api/v1/ read.py · ingest.py · geraete.py · admin.py
frontend/ public.py · intern.py + templates/ static/
migrations/ Alembic
tests/ pytest gegen echte PostgreSQL-Testdatenbank
docker/ Dockerfile · nginx.conf · entrypoint.sh
debian/ .deb-Paketierung (venv unter /opt/oamc-turnier)
deploy/ systemd-Unit · nginx-vHost · Backup-Skript (bare metal)
packaging/apt-repo/ reprepro-Konfiguration + Build-Skript
```
## Entwicklung
```sh
python3 -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env # DATABASE_URL anpassen
createdb oamc_dev # PostgreSQL-Rolle mit CREATEDB nötig
alembic upgrade head
oamc-turnier seed # Stammdaten Saison 2026
oamc-turnier benutzer-anlegen admin --rolle admin
oamc-turnier serve --reload # http://127.0.0.1:8000 · /docs
```
### Tests
Brauchen eine erreichbare PostgreSQL-Testdatenbank (`OAMC_DATABASE_URL`, Default
`…/oamc_test`). Das Schema wird pro Lauf frisch migriert, jeder Test läuft in einer
zurückgerollten Transaktion.
```sh
createdb oamc_test
pytest
```
Der **Abnahmetest der Wertungs-Engine** (`tests/test_wertung_regression_2026_05_31.py`)
rechnet die im Plan §3.3 zitierten Zeilen der realen Ergebnisliste vom 31.05.2026 nach.
## Auslieferung 1 — Docker / „docker repo"
```sh
cp .env.example .env # OAMC_SECRET_KEY setzen!
docker compose up -d # db + app + nginx → http://localhost:8080
docker compose exec app oamc-turnier seed
# Image für eine Registry bauen/pushen:
docker build -t <registry>/oamc-turnier:0.1.0 -f docker/Dockerfile .
docker push <registry>/oamc-turnier:0.1.0
```
Multi-Arch für den Raspberry Pi 4:
```sh
docker buildx build --platform linux/arm64,linux/amd64 \
-t <registry>/oamc-turnier:0.1.0 -f docker/Dockerfile --push .
```
Migrationen laufen automatisch beim Containerstart (`docker/entrypoint.sh`).
## Auslieferung 2 — Debian-Paket / eigenes APT-Repo
```sh
sudo apt install build-essential debhelper devscripts python3-venv
./packaging/apt-repo/build-deb.sh # → ../oamc-turnier_0.1.0_*.deb
sudo apt install ../oamc-turnier_0.1.0_*.deb
```
Das Paket bringt ein eigenes virtualenv unter `/opt/oamc-turnier/venv`, eine
systemd-Unit und Beispielkonfiguration mit. Danach:
```sh
sudoedit /etc/oamc-turnier/oamc-turnier.env # DATABASE_URL, SECRET_KEY
sudo systemctl enable --now oamc-turnier
sudo -u oamc /opt/oamc-turnier/venv/bin/oamc-turnier seed
```
Eigenes signiertes APT-Repo aufsetzen: [`packaging/apt-repo/README.md`](packaging/apt-repo/README.md).
## API-Überblick (`/docs` für die vollständige OpenAPI-Doku)
| Bereich | Auth | Beispiele |
|---|---|---|
| **Read** | – | `GET /api/v1/turniere/{id}/ergebnisse`, `/api/v1/fahrer?q=`, `/api/v1/meisterschaften/{id}/stand` |
| **Ingest** | `X-API-Key` | `POST /api/v1/turniere/{id}/ergebnisse` (idempotent, `?dry_run=true`), `POST …/import/xlsx` |
| **Geräte** | `Authorization: Bearer <geräte-token>` | `POST /api/v1/zeitmessungen` (Batch, idempotent), SSE `GET /api/v1/turniere/aktiv/anzeige` |
| **Admin** | interne Session | `POST /api/v1/admin/geraete`, `…/zeitmessungen/{id}/zuordnen`, `…/meisterschaften/{id}/berechnen`, `…/fahrer/merge` |
## Bekannte offene Punkte (aus `plan.md` §10)
Diese sind **im Code klar markiert** und blockieren einen offiziellen Produktivgang:
* **O-1** — echte Meisterschafts-Punktetabelle fehlt. Es läuft eine
`PLATZHALTER_PUNKTETABELLE`; jeder berechnete Stand trägt einen Warnhinweis.
* **O-2** — Zuordnung `S 1`–`S 9` / `A 1`–`A 4` → Fahrzeugtyp: Klassen sind
angelegt, `fahrzeugtyp` bleibt `NULL`.
* **Wertungsregeln §3.3** sind aus PDFs *abgeleitet* — vor Produktivgang gegen die
ADAC-Turnierordnung 2026 zu verifizieren. Die Engine ist regelbasiert
konfigurierbar (`oamc.wertung.engine.REGELN`), nicht fest verdrahtet.
* **O-13/O-14/O-16** — Details der Zeitmessung (was wird gemessen, Zuordnung zum
Fahrer, Genauigkeit): siehe `docs/zeitmessung-endpoint.md`.
* **§11 Datenschutz** — Fahrerprofile sind `noindex` + `robots.txt`-gesperrt,
Geburts*jahr* statt -datum, Opt-out-Anonymisierung (`fahrer.anzeige_anonymisiert`)
ist umgesetzt; die Vorstandsentscheidung zur öffentlichen Darstellung von
Jugenddaten steht noch aus.
alembic.ini
+40
View File
@@ -0,0 +1,40 @@
# Alembic-Konfiguration. Die DB-URL kommt aus oamc.config (env.py), NICHT von hier.
[alembic]
script_location = migrations
prepend_sys_path = src
path_separator = os
timezone = Europe/Berlin
[loggers]
keys = root,sqlalchemy,alembic
[handlers]
keys = console
[formatters]
keys = generic
[logger_root]
level = WARNING
handlers = console
qualname =
[logger_sqlalchemy]
level = WARNING
handlers =
qualname = sqlalchemy.engine
[logger_alembic]
level = INFO
handlers =
qualname = alembic
[handler_console]
class = StreamHandler
args = (sys.stderr,)
level = NOTSET
formatter = generic
[formatter_generic]
format = %(levelname)-5.5s [%(name)s] %(message)s
datefmt = %H:%M:%S
debian/changelog
Vendored
+8
View File
@@ -0,0 +1,8 @@
oamc-turnier (0.1.0) unstable; urgency=medium
* Erste Paketierung: FastAPI-Anwendung, Datenmodell + Alembic-Migrationen,
Wertungs-Engine (Plan §3.3), Meisterschaftsberechnung (Platzhalter-Punkte,
O-1 offen), Ingest-API, Geraete-/Zeitmessungs-Endpoint, oeffentliches und
internes Frontend.
-- OAMC Reinheim e.V. im ADAC <webmaster@oamc.de> Fri, 05 Sep 2026 18:00:00 +0200
debian/control
Vendored
+29
View File
@@ -0,0 +1,29 @@
Source: oamc-turnier
Section: web
Priority: optional
Maintainer: OAMC Reinheim e.V. im ADAC <webmaster@oamc.de>
Build-Depends: debhelper-compat (= 13),
python3 (>= 3.11),
python3-venv,
python3-pip
Standards-Version: 4.6.2
Homepage: https://oamc.de
Rules-Requires-Root: no
Package: oamc-turnier
Architecture: any
Depends: ${misc:Depends},
python3 (>= 3.11),
adduser,
libpq5,
postgresql-client
Recommends: postgresql-17 | postgresql, nginx
Suggests: certbot
Description: Auswertung von ADAC Motorrad-Turnieren (OAMC Reinheim)
Webanwendung fuer Turnierergebnisse, Zeitmessungs-Ingest, Fahrerdatenbank und
Meisterschaftswertung. Enthaelt die FastAPI-Anwendung als eigenstaendiges
virtualenv unter /opt/oamc-turnier sowie eine systemd-Unit.
.
Nach der Installation ist /etc/oamc-turnier/oamc-turnier.env auszufuellen
(DATABASE_URL, SECRET_KEY) und der Dienst mit
"systemctl enable --now oamc-turnier" zu starten.
debian/copyright
Vendored
+8
View File
@@ -0,0 +1,8 @@
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: oamc-turnier
Files: *
Copyright: 2026 OAMC Reinheim e.V. im ADAC
License: proprietary
Interne Nutzung des OAMC Reinheim e.V. im ADAC. Weitergabe nur mit
ausdruecklicher Zustimmung des Vereinsvorstands.
debian/env/oamc-turnier.env
Vendored
+18
View File
@@ -0,0 +1,18 @@
# /etc/oamc-turnier/oamc-turnier.env — nach der Installation ausfuellen!
# Danach: systemctl enable --now oamc-turnier
# Pflicht:
OAMC_DATABASE_URL=postgresql+psycopg://oamc:CHANGE_ME@localhost:5432/oamc
OAMC_SECRET_KEY=CHANGE_ME_zufaellig_mind_32_zeichen
# Ingest-API-Keys (kommagetrennt), fuer die Excel-Auswertung:
OAMC_INGEST_API_KEYS=CHANGE_ME_ingest_key
# Betrieb:
OAMC_ENV=prod
OAMC_PUBLIC_BASE_URL=https://mt.oamc.de
OAMC_UPLOAD_DIR=/var/oamc/uploads
# Plausibilitaetsgrenzen Zeitmessung (Sekunden):
OAMC_MESS_MIN_SEKUNDEN=15
OAMC_MESS_MAX_SEKUNDEN=600
debian/oamc-turnier.dirs
Vendored
+2
View File
@@ -0,0 +1,2 @@
var/oamc/uploads
etc/oamc-turnier
debian/oamc-turnier.install
Vendored
+4
View File
@@ -0,0 +1,4 @@
debian/env/oamc-turnier.env etc/oamc-turnier
deploy/nginx/oamc-turnier.conf usr/share/doc/oamc-turnier/examples
deploy/backup/pg_dump.sh usr/share/doc/oamc-turnier/examples
docs/zeitmessung-endpoint.md usr/share/doc/oamc-turnier
debian/oamc-turnier.service
Vendored
+28
View File
@@ -0,0 +1,28 @@
[Unit]
Description=OAMC Turnierauswertung (FastAPI/uvicorn)
After=network-online.target postgresql.service
Wants=network-online.target
[Service]
Type=exec
User=oamc
Group=oamc
EnvironmentFile=/etc/oamc-turnier/oamc-turnier.env
WorkingDirectory=/opt/oamc-turnier
# Migrationen vor dem Start (idempotent)
ExecStartPre=/opt/oamc-turnier/venv/bin/alembic -c /opt/oamc-turnier/alembic.ini upgrade head
ExecStart=/opt/oamc-turnier/venv/bin/uvicorn oamc.main:app \
--host 127.0.0.1 --port 8000 --proxy-headers --forwarded-allow-ips '*'
Restart=on-failure
RestartSec=3
# Haertung
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/oamc
StateDirectory=oamc-turnier
RuntimeDirectory=oamc-turnier
[Install]
WantedBy=multi-user.target
debian/postinst
Vendored Executable
+33
View File
@@ -0,0 +1,33 @@
#!/bin/sh
set -e
case "$1" in
configure)
# Systembenutzer fuer den Dienst
if ! getent passwd oamc >/dev/null; then
adduser --system --group --home /var/oamc --no-create-home \
--gecos "OAMC Turnierauswertung" oamc
fi
mkdir -p /var/oamc/uploads
chown -R oamc:oamc /var/oamc
# Konfig-Datei nur beim ersten Mal, mit engen Rechten
if [ ! -e /etc/oamc-turnier/oamc-turnier.env ]; then
echo "Hinweis: /etc/oamc-turnier/oamc-turnier.env anlegen (siehe Beispiel)."
fi
chown root:oamc /etc/oamc-turnier/oamc-turnier.env 2>/dev/null || true
chmod 0640 /etc/oamc-turnier/oamc-turnier.env 2>/dev/null || true
echo "-----------------------------------------------------------------"
echo " oamc-turnier installiert. Naechste Schritte:"
echo " 1) PostgreSQL-DB + Rolle anlegen (siehe /usr/share/doc/oamc-turnier)"
echo " 2) /etc/oamc-turnier/oamc-turnier.env ausfuellen"
echo " 3) systemctl enable --now oamc-turnier"
echo " 4) /opt/oamc-turnier/venv/bin/oamc-turnier seed # Stammdaten 2026"
echo " 5) nginx: /usr/share/doc/oamc-turnier/examples/oamc-turnier.conf"
echo "-----------------------------------------------------------------"
;;
esac
#DEBHELPER#
exit 0
debian/postrm
Vendored Executable
+14
View File
@@ -0,0 +1,14 @@
#!/bin/sh
set -e
case "$1" in
purge)
rm -rf /opt/oamc-turnier/venv
rm -rf /var/oamc/uploads
# DB und /etc-Konfig bewusst NICHT loeschen (Datenverlust vermeiden)
echo "Hinweis: Datenbank und /etc/oamc-turnier bleiben erhalten."
;;
esac
#DEBHELPER#
exit 0
debian/rules
Vendored Executable
+38
View File
@@ -0,0 +1,38 @@
#!/usr/bin/make -f
# Baut ein in sich geschlossenes virtualenv unter /opt/oamc-turnier.
# Bewusst ohne dh-virtualenv (nicht in Debian 13 main) — venv + pip von Hand.
export DH_VERBOSE = 1
VENV = debian/oamc-turnier/opt/oamc-turnier/venv
APPDIR = debian/oamc-turnier/opt/oamc-turnier
%:
dh $@
override_dh_auto_build:
# nichts zu kompilieren
override_dh_auto_test:
# Tests laufen in CI gegen eine echte DB, nicht im Paketbau
override_dh_auto_install:
mkdir -p $(APPDIR)
python3 -m venv $(VENV)
$(VENV)/bin/pip install --no-cache-dir --upgrade pip
$(VENV)/bin/pip install --no-cache-dir .
# Migrationen + alembic.ini mitliefern (fuer "oamc-turnier migrate")
cp -r migrations $(APPDIR)/migrations
cp alembic.ini $(APPDIR)/alembic.ini
# venv relozierbar halten: absolute Shebangs auf den Zielpfad umschreiben
find $(VENV)/bin -type f -exec sed -i \
"1s|^#!.*python.*|#!/opt/oamc-turnier/venv/bin/python3|" {} + || true
# Wrapper in /usr/bin
mkdir -p debian/oamc-turnier/usr/bin
ln -sf /opt/oamc-turnier/venv/bin/oamc-turnier debian/oamc-turnier/usr/bin/oamc-turnier
override_dh_installsystemd:
dh_installsystemd --no-start --no-enable
override_dh_fixperms:
dh_fixperms
chmod 0640 debian/oamc-turnier/etc/oamc-turnier/oamc-turnier.env || true
debian/source/format
Vendored
+1
View File
@@ -0,0 +1 @@
3.0 (native)
deploy/backup/pg_dump.sh
Executable
+23
View File
@@ -0,0 +1,23 @@
#!/bin/sh
# Taeglicher pg_dump der OAMC-Turnierdatenbank (Plan §5.3).
# Als Cron/Timer fuer den Benutzer 'postgres' oder 'oamc' einrichten:
# 15 2 * * * /usr/share/doc/oamc-turnier/examples/pg_dump.sh
set -eu
DB="${OAMC_DB_NAME:-oamc}"
ZIEL="${OAMC_BACKUP_DIR:-/var/backups/oamc}"
BEHALTEN_TAGE="${OAMC_BACKUP_KEEP_DAYS:-30}"
STAMP="$(date +%Y-%m-%d_%H%M)"
mkdir -p "$ZIEL"
DATEI="$ZIEL/oamc_${STAMP}.sql.gz"
pg_dump --format=plain --no-owner --dbname="$DB" | gzip -9 > "$DATEI"
echo "Backup: $DATEI ($(du -h "$DATEI" | cut -f1))"
# Alte Backups aufraeumen
find "$ZIEL" -name 'oamc_*.sql.gz' -mtime "+${BEHALTEN_TAGE}" -delete
# WICHTIG (Plan §5.3): woechentlich eine Vollsicherung auf ein EXTERNES Medium
# ziehen und den Restore mindestens einmal testen:
# gunzip -c oamc_....sql.gz | psql -d oamc_restore_test
deploy/nginx/oamc-turnier.conf
+40
View File
@@ -0,0 +1,40 @@
# nginx vHost fuer die OAMC Turnierauswertung (bare-metal / Raspberry Pi).
# TLS via certbot: certbot --nginx -d mt.oamc.de
# Danach ergaenzt certbot die listen-443- und ssl_*-Zeilen automatisch.
server {
listen 80;
listen [::]:80;
server_name mt.oamc.de;
# certbot-Challenge
location /.well-known/acme-challenge/ { root /var/www/html; }
# Rest auf HTTPS umleiten (nach dem ersten certbot-Lauf aktivieren):
# return 301 https://$host$request_uri;
client_max_body_size 25m;
location = /favicon.ico { access_log off; log_not_found off; }
location /api/v1/turniere/aktiv/anzeige {
proxy_pass http://127.0.0.1:8000;
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 3600s;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 60s;
}
}
deploy/systemd/oamc-turnier.service
+28
View File
@@ -0,0 +1,28 @@
# Manuelle Installation ohne .deb (git-Checkout + venv unter /opt/oamc-turnier/app).
# sudo cp deploy/systemd/oamc-turnier.service /etc/systemd/system/
# sudo systemctl daemon-reload && sudo systemctl enable --now oamc-turnier
[Unit]
Description=OAMC Turnierauswertung (FastAPI/uvicorn)
After=network-online.target postgresql.service
Wants=network-online.target
[Service]
Type=exec
User=oamc
Group=oamc
EnvironmentFile=/etc/oamc-turnier/oamc-turnier.env
WorkingDirectory=/opt/oamc-turnier/app
ExecStartPre=/opt/oamc-turnier/app/.venv/bin/alembic upgrade head
ExecStart=/opt/oamc-turnier/app/.venv/bin/uvicorn oamc.main:app \
--host 127.0.0.1 --port 8000 --proxy-headers --forwarded-allow-ips '*'
Restart=on-failure
RestartSec=3
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/oamc
StateDirectory=oamc-turnier
[Install]
WantedBy=multi-user.target
docker-compose.yml
+55
View File
@@ -0,0 +1,55 @@
# OAMC Turnierauswertung — lokaler/kleiner Produktivbetrieb per Container.
# docker compose up -d (Build + Start)
# docker compose exec app oamc-turnier seed
#
# Fuer "docker repo": das app-Image separat bauen und pushen:
# docker build -t <registry>/oamc-turnier:0.1.0 -f docker/Dockerfile .
# docker push <registry>/oamc-turnier:0.1.0
services:
db:
image: postgres:17-alpine
environment:
POSTGRES_USER: oamc
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-oamc}
POSTGRES_DB: oamc
volumes:
- db_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U oamc"]
interval: 5s
timeout: 3s
retries: 20
restart: unless-stopped
app:
build:
context: .
dockerfile: docker/Dockerfile
image: oamc-turnier:${OAMC_VERSION:-0.1.0}
depends_on:
db:
condition: service_healthy
environment:
OAMC_DATABASE_URL: postgresql+psycopg://oamc:${POSTGRES_PASSWORD:-oamc}@db:5432/oamc
OAMC_SECRET_KEY: ${OAMC_SECRET_KEY:?bitte in .env setzen}
OAMC_INGEST_API_KEYS: ${OAMC_INGEST_API_KEYS:-dev-ingest-key}
OAMC_ENV: ${OAMC_ENV:-prod}
OAMC_PUBLIC_BASE_URL: ${OAMC_PUBLIC_BASE_URL:-http://localhost}
OAMC_SEED_ON_START: ${OAMC_SEED_ON_START:-0}
volumes:
- uploads:/var/oamc/uploads
restart: unless-stopped
nginx:
image: nginx:1.27-alpine
depends_on: [app]
ports:
- "${OAMC_HTTP_PORT:-8080}:80"
volumes:
- ./docker/nginx.conf:/etc/nginx/conf.d/default.conf:ro
restart: unless-stopped
volumes:
db_data:
uploads:
docker/Dockerfile
+45
View File
@@ -0,0 +1,45 @@
# OAMC Turnierauswertung — Anwendungs-Image
# Multi-Arch: baut fuer linux/arm64 (Raspberry Pi 4) und linux/amd64.
# docker buildx build --platform linux/arm64,linux/amd64 -f docker/Dockerfile .
FROM python:3.12-slim AS build
ENV PIP_DISABLE_PIP_VERSION_CHECK=1 PIP_NO_CACHE_DIR=1
WORKDIR /app
# WeasyPrint (PDF-Export) braucht native Bibliotheken; Build-Tools nur hier.
RUN apt-get update && apt-get install -y --no-install-recommends \
build-essential libpq-dev \
&& rm -rf /var/lib/apt/lists/*
COPY pyproject.toml README.md ./
COPY src ./src
RUN python -m venv /opt/venv \
&& /opt/venv/bin/pip install --upgrade pip \
&& /opt/venv/bin/pip install .
# ---------------------------------------------------------------------------
FROM python:3.12-slim AS runtime
ENV PYTHONUNBUFFERED=1 PATH="/opt/venv/bin:$PATH" \
OAMC_UPLOAD_DIR=/var/oamc/uploads
WORKDIR /app
RUN apt-get update && apt-get install -y --no-install-recommends \
libpq5 libpango-1.0-0 libpangoft2-1.0-0 libcairo2 \
&& rm -rf /var/lib/apt/lists/* \
&& useradd --system --create-home --uid 10001 oamc \
&& mkdir -p /var/oamc/uploads && chown -R oamc:oamc /var/oamc
COPY --from=build /opt/venv /opt/venv
COPY src ./src
COPY migrations ./migrations
COPY alembic.ini ./
COPY docker/entrypoint.sh /usr/local/bin/entrypoint.sh
RUN chmod +x /usr/local/bin/entrypoint.sh
USER oamc
EXPOSE 8000
HEALTHCHECK --interval=30s --timeout=5s --start-period=20s \
CMD python -c "import urllib.request,sys; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8000/healthz').status==200 else 1)"
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
CMD ["uvicorn", "oamc.main:app", "--host", "0.0.0.0", "--port", "8000", "--proxy-headers"]
docker/entrypoint.sh
+30
View File
@@ -0,0 +1,30 @@
#!/bin/sh
# Wartet auf die DB, spielt Migrationen ein, optional Seed, startet dann das CMD.
set -eu
echo "[entrypoint] warte auf Datenbank ..."
python - <<'PY'
import os, time, sys
import psycopg
url = os.environ.get("OAMC_DATABASE_URL", "")
dsn = url.replace("postgresql+psycopg://", "postgresql://", 1)
for i in range(60):
try:
psycopg.connect(dsn, connect_timeout=3).close()
print("[entrypoint] DB erreichbar")
sys.exit(0)
except Exception as e: # noqa
print(f"[entrypoint] ({i+1}/60) noch nicht bereit: {e}")
time.sleep(2)
sys.exit("[entrypoint] DB nicht erreichbar")
PY
echo "[entrypoint] alembic upgrade head"
alembic upgrade head
if [ "${OAMC_SEED_ON_START:-0}" = "1" ]; then
echo "[entrypoint] Seed Saison 2026 (idempotent)"
oamc-turnier seed || echo "[entrypoint] Seed uebersprungen/fehlgeschlagen"
fi
exec "$@"
docker/nginx.conf
+40
View File
@@ -0,0 +1,40 @@
# nginx vor uvicorn: TLS-Terminierung (im Compose ohne TLS), statische Dateien,
# SSE-taugliches Proxying (kein Buffering, lange Timeouts).
upstream oamc_app { server app:8000; }
server {
listen 80;
server_name _;
client_max_body_size 25m;
charset utf-8;
location /static/ {
proxy_pass http://oamc_app;
proxy_cache_valid 200 10m;
expires 1h;
}
# Server-Sent Events: Puffern aus, Verbindung offen halten
location /api/v1/turniere/aktiv/anzeige {
proxy_pass http://oamc_app;
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 3600s;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location / {
proxy_pass http://oamc_app;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 60s;
}
}
docs/zeitmessung-endpoint.md
+112
View File
@@ -0,0 +1,112 @@
# Endpoint für die Zeitmessung (Lichtschranke)
> Der **Mess-Pi-Client selbst ist nicht Teil dieses Projekts** — dieses Dokument
> beschreibt nur den **Endpoint**, den ein beliebiger Client (der zweite Raspberry
> Pi an der Lichtschranke) bespielt. Fachlicher Hintergrund: `plan.md` §3.6 / §6.2.
## Authentifizierung
Alle Geräte-Endpunkte erwarten einen **Geräte-Token** (nicht den Auswerter-Login):
```
Authorization: Bearer <geraete-token>
```
Token anlegen (interne Admin-Session):
```
POST /api/v1/admin/geraete
{ "bezeichnung": "lichtschranke-ziel-01", "typ": "lichtschranke" }
→ 201 { "id": 1, "bezeichnung": "...", "token": "oamc_dev_…" } # Token nur hier einmalig
```
Token neu ausgeben: `POST /api/v1/admin/geraete/{id}/token` ·
Gerät sperren: `POST /api/v1/admin/geraete/{id}/sperren`
## Ablauf auf dem Client (empfohlen)
1. `POST /api/v1/geraete/heartbeat` alle ~15 s → Statusanzeige + `aktives_turnier_id`
2. `GET /api/v1/geraete/konfiguration` → Entprellzeit, Messpunkte, Plausibilitätsgrenzen
3. `GET /api/v1/turniere/aktiv/startliste` (ETag-fähig) → Startreihenfolge für die Anzeige
4. Pro Durchfahrt eine Messung lokal puffern, dann als **Batch** senden:
`POST /api/v1/zeitmessungen`
5. `GET /api/v1/turniere/aktiv/anzeige` (SSE) → Live-Stream für die Anzeige am Parcours
## `POST /api/v1/zeitmessungen` — Batch, idempotent
```jsonc
{
"geraet": "lichtschranke-ziel-01", // informativ
"messungen": [
{
"id": "9f2c1e7a-4d38-4b6e-9a11-5c0b2d7e8f30", // UUID VOM GERÄT → Idempotenz
"turnier_id": 42,
"startnummer_gemeldet": 32, // Hinweis, kein Fremdschlüssel
"messpunkt": "durchgang-1",
"dauer_sekunden": 159.16, // vom Gerät berechnet (monotone Zeit)
"gemessen_am": "2026-05-31T10:14:02.482+02:00",
"monotonic_ns": 884213771004,
"roh": { "trigger_start_ns": 884054611004, "trigger_ziel_ns": 884213771004 }
}
]
}
```
### Antwort — jede Messung wird **einzeln** quittiert
```jsonc
{
"quittungen": [
{ "id": "9f2c1e7a-…", "status": "angenommen", "start_id": 512, "hinweis": null }
],
"angenommen": 1, "duplikate": 0, "unzugeordnet": 0, "unplausibel": 0
}
```
| `status` | Bedeutung | Client-Reaktion |
|----------------|-----------|-----------------|
| `angenommen` | gespeichert und einem Start zugeordnet | aus lokaler Queue löschen |
| `duplikat` | UUID war schon da (Nachlieferung nach Timeout) | aus lokaler Queue löschen |
| `unzugeordnet` | gespeichert, aber `startnummer_gemeldet` nicht auflösbar → manuelle Zuordnung im Frontend | aus lokaler Queue löschen |
| `unplausibel` | gespeichert, Dauer außerhalb der Grenzen → im Frontend markiert | aus lokaler Queue löschen |
| `fehler` | z. B. `turnier_id` unbekannt | **in der Queue behalten**, später erneut |
**Grundregeln** (Server-seitig umgesetzt):
* **Idempotent über `id`** — ein doppelt gesendeter Batch erzeugt keine Dubletten.
Ein abgebrochener Request darf gefahrlos wiederholt werden.
* Die **Dauer kommt fertig vom Gerät** — der Server rechnet **keine** Differenz aus
zwei Wanduhr-Zeitstempeln (NTP-Sprung auf einem Pi ohne RTC).
* Eine Messung **ohne** zuordenbare Startnummer wird **nie verworfen**, sondern als
`unzugeordnet` gespeichert und im internen Frontend zur Zuordnung angeboten.
* Plausibilitätsverstöße werden **markiert**, nicht abgelehnt. Grenzen:
`OAMC_MESS_MIN_SEKUNDEN` / `OAMC_MESS_MAX_SEKUNDEN` bzw. je Gerät in
`geraet.konfiguration`.
* `gemessen_am` weit in der Vergangenheit → die Messung wird als *nachgeliefert*
markiert und trotzdem angenommen.
## Fehlmessung nachträglich verwerfen
```
POST /api/v1/zeitmessungen/{id}/verwerfen
{ "grund": "Zuschauer hat die Schranke ausgelöst" }
```
Die Messung bleibt mit Grund gespeichert (Status `verworfen`), zählt aber nicht in
die `summe_zeit`.
## Was der Server aus den Messungen macht
`ergebnis.summe_zeit` wird bei der Auswertung als **Summe aller gültigen,
zugeordneten Einzelmessungen** eines Starts gebildet
(`oamc.wertung.service.summe_zeit_fuer_start`). Aus Einzelmessungen lässt sich die
Summe jederzeit bilden — der umgekehrte Weg existiert nicht, deshalb speichert der
Server jede Einzelmessung.
## Offene Punkte (aus `plan.md` §10), die den Endpoint noch betreffen
* **O-13** Was misst die Lichtschranke genau (eine Gesamtdurchfahrt, mehrere
Durchgänge, einzelne Abschnitte)? → bestimmt `messpunkt` und die Summenbildung.
* **O-14** Woher kennt der Client die Startnummer? → bis geklärt: `startnummer_gemeldet`
als Hinweis, Server löst gegen die Startliste auf.
* **O-16** Geforderte Messgenauigkeit / eine oder zwei Lichtschranken.
migrations/env.py
+66
View File
@@ -0,0 +1,66 @@
"""Alembic-Umgebung. DB-URL und Metadaten kommen aus der Anwendung."""
from __future__ import annotations
from logging.config import fileConfig
from alembic import context
from sqlalchemy import engine_from_config, pool
from oamc.config import get_settings
from oamc.models import Base
config = context.config
if config.config_file_name is not None:
fileConfig(config.config_file_name)
config.set_main_option("sqlalchemy.url", get_settings().database_url)
target_metadata = Base.metadata
# Von der Autogenerate-Vergleichung ausgenommen: der Trigramm-Index wird als
# Ausdrucksindex per Roh-SQL in der Initialmigration gepflegt.
_IGNORE_INDEXES = {"ix_fahrer_name_trgm"}
def include_object(obj, name, type_, reflected, compare_to): # noqa: ANN001
if type_ == "index" and name in _IGNORE_INDEXES:
return False
return True
def run_migrations_offline() -> None:
context.configure(
url=get_settings().database_url,
target_metadata=target_metadata,
literal_binds=True,
dialect_opts={"paramstyle": "named"},
compare_type=True,
compare_server_default=True,
include_object=include_object,
)
with context.begin_transaction():
context.run_migrations()
def run_migrations_online() -> None:
connectable = engine_from_config(
config.get_section(config.config_ini_section, {}),
prefix="sqlalchemy.",
poolclass=pool.NullPool,
)
with connectable.connect() as connection:
context.configure(
connection=connection,
target_metadata=target_metadata,
compare_type=True,
compare_server_default=True,
include_object=include_object,
)
with context.begin_transaction():
context.run_migrations()
if context.is_offline_mode():
run_migrations_offline()
else:
run_migrations_online()
migrations/script.py.mako
+26
View File
@@ -0,0 +1,26 @@
"""${message}
Revision ID: ${up_revision}
Revises: ${down_revision | comma,n}
Create Date: ${create_date}
"""
from __future__ import annotations
from collections.abc import Sequence
from alembic import op
import sqlalchemy as sa
${imports if imports else ""}
revision: str = ${repr(up_revision)}
down_revision: str | None = ${repr(down_revision)}
branch_labels: str | Sequence[str] | None = ${repr(branch_labels)}
depends_on: str | Sequence[str] | None = ${repr(depends_on)}
def upgrade() -> None:
${upgrades if upgrades else "pass"}
def downgrade() -> None:
${downgrades if downgrades else "pass"}
migrations/versions/df5e2dd5a864_initiales_schema.py
+300
View File
@@ -0,0 +1,300 @@
"""Initiales Schema
Revision ID: df5e2dd5a864
Revises:
Create Date: 2026-09-05 18:08:45.999851+02:00
"""
from __future__ import annotations
from collections.abc import Sequence
from alembic import op
import sqlalchemy as sa
from sqlalchemy.dialects import postgresql
revision: str = 'df5e2dd5a864'
down_revision: str | None = None
branch_labels: str | Sequence[str] | None = None
depends_on: str | Sequence[str] | None = None
def upgrade() -> None:
# pg_trgm fuer die unscharfe Fahrersuche beim Import (Plan §6.4)
op.execute("CREATE EXTENSION IF NOT EXISTS pg_trgm")
# ### commands auto generated by Alembic - please adjust! ###
op.create_table('benutzer',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('benutzername', sa.String(length=80), nullable=False),
sa.Column('anzeigename', sa.String(length=120), nullable=False),
sa.Column('passwort_hash', sa.String(length=255), nullable=False),
sa.Column('rolle', sa.Enum('admin', 'auswerter', 'lesend', name='benutzer_rolle'), nullable=False),
sa.Column('aktiv', sa.Boolean(), nullable=False),
sa.Column('letzter_login_am', sa.DateTime(timezone=True), nullable=True),
sa.Column('erstellt_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.Column('geaendert_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.PrimaryKeyConstraint('id', name=op.f('pk_benutzer')),
sa.UniqueConstraint('benutzername', name=op.f('uq_benutzer_benutzername'))
)
op.create_table('geraet',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('bezeichnung', sa.String(length=120), nullable=False),
sa.Column('typ', sa.Enum('lichtschranke', 'anzeige', name='geraet_typ'), nullable=False),
sa.Column('token_hash', sa.String(length=255), nullable=False),
sa.Column('aktiv', sa.Boolean(), nullable=False),
sa.Column('letzte_meldung_am', sa.DateTime(timezone=True), nullable=True),
sa.Column('firmware_version', sa.String(length=60), nullable=True),
sa.Column('queue_laenge_gemeldet', sa.Integer(), nullable=True),
sa.Column('notiz', sa.Text(), nullable=True),
sa.Column('konfiguration', postgresql.JSONB(astext_type=sa.Text()), nullable=False),
sa.Column('erstellt_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.Column('geaendert_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.PrimaryKeyConstraint('id', name=op.f('pk_geraet')),
sa.UniqueConstraint('bezeichnung', name=op.f('uq_geraet_bezeichnung'))
)
op.create_table('import_job',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('quelle', sa.String(length=120), nullable=False),
sa.Column('idempotenz_schluessel', sa.String(length=200), nullable=True),
sa.Column('dateiname', sa.String(length=300), nullable=True),
sa.Column('roh_payload', postgresql.JSONB(astext_type=sa.Text()), nullable=True),
sa.Column('ergebnis_bericht', postgresql.JSONB(astext_type=sa.Text()), nullable=True),
sa.Column('status', sa.Enum('angenommen', 'vorschau', 'fehler', 'teilweise', name='import_status'), nullable=False),
sa.Column('fehler', sa.Text(), nullable=True),
sa.Column('angelegt_von', sa.String(length=120), nullable=True),
sa.Column('angelegt_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.PrimaryKeyConstraint('id', name=op.f('pk_import_job'))
)
op.create_index(op.f('ix_import_job_idempotenz_schluessel'), 'import_job', ['idempotenz_schluessel'], unique=False)
op.create_table('saison',
sa.Column('jahr', sa.Integer(), autoincrement=False, nullable=False),
sa.Column('turnierordnung_version', sa.String(length=60), nullable=True),
sa.Column('streichresultate_tabelle', postgresql.JSONB(astext_type=sa.Text()), nullable=False),
sa.Column('nenngeld_cent', sa.Integer(), nullable=False),
sa.Column('aktiv', sa.Boolean(), nullable=False),
sa.PrimaryKeyConstraint('jahr', name=op.f('pk_saison'))
)
op.create_table('verein',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('name', sa.String(length=200), nullable=False),
sa.Column('kurzname', sa.String(length=60), nullable=True),
sa.Column('adac_gau', sa.String(length=120), nullable=True),
sa.Column('aktiv', sa.Boolean(), nullable=False),
sa.Column('notiz', sa.Text(), nullable=True),
sa.Column('erstellt_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.Column('geaendert_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.PrimaryKeyConstraint('id', name=op.f('pk_verein')),
sa.UniqueConstraint('name', name=op.f('uq_verein_name'))
)
op.create_table('fahrer',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('nachname', sa.String(length=120), nullable=False),
sa.Column('vorname', sa.String(length=120), nullable=False),
sa.Column('geburtsjahr', sa.Integer(), nullable=True),
sa.Column('geburtsdatum', sa.Date(), nullable=True),
sa.Column('geschlecht', sa.Enum('M', 'W', 'D', name='geschlecht'), nullable=True),
sa.Column('verein_id', sa.Integer(), nullable=True),
sa.Column('adac_mitgliedsnr', sa.String(length=40), nullable=True),
sa.Column('jugendausweis_gueltig_bis', sa.Date(), nullable=True),
sa.Column('anzeige_anonymisiert', sa.Boolean(), nullable=False),
sa.Column('aktiv', sa.Boolean(), nullable=False),
sa.Column('notiz', sa.Text(), nullable=True),
sa.Column('erstellt_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.Column('geaendert_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.ForeignKeyConstraint(['verein_id'], ['verein.id'], name=op.f('fk_fahrer_verein_id_verein')),
sa.PrimaryKeyConstraint('id', name=op.f('pk_fahrer'))
)
op.create_index(op.f('ix_fahrer_geburtsjahr'), 'fahrer', ['geburtsjahr'], unique=False)
op.execute(
"CREATE INDEX ix_fahrer_name_trgm ON fahrer USING gin "
"((lower(nachname || ' ' || vorname)) gin_trgm_ops)"
)
op.create_index(op.f('ix_fahrer_verein_id'), 'fahrer', ['verein_id'], unique=False)
op.create_table('klasse',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('saison_jahr', sa.Integer(), nullable=False),
sa.Column('code', sa.String(length=10), nullable=False),
sa.Column('kategorie', sa.Enum('J', 'S', 'A', name='kategorie'), nullable=False),
sa.Column('bezeichnung', sa.String(length=200), nullable=False),
sa.Column('jahrgaenge', postgresql.ARRAY(sa.Integer()), nullable=True),
sa.Column('ccm_max', sa.Integer(), nullable=True),
sa.Column('kw_max', sa.Numeric(precision=5, scale=2), nullable=True),
sa.Column('fahrzeugtyp', sa.String(length=200), nullable=True),
sa.Column('mindestalter_am_veranstaltungstag', sa.Integer(), nullable=True),
sa.Column('sortierung', sa.Integer(), nullable=False),
sa.Column('notiz', sa.Text(), nullable=True),
sa.ForeignKeyConstraint(['saison_jahr'], ['saison.jahr'], name=op.f('fk_klasse_saison_jahr_saison'), ondelete='CASCADE'),
sa.PrimaryKeyConstraint('id', name=op.f('pk_klasse')),
sa.UniqueConstraint('saison_jahr', 'code', name='klasse_saison_code')
)
op.create_index(op.f('ix_klasse_saison_jahr'), 'klasse', ['saison_jahr'], unique=False)
op.create_table('veranstaltung',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('datum', sa.Date(), nullable=False),
sa.Column('titel', sa.String(length=300), nullable=False),
sa.Column('ort', sa.String(length=200), nullable=True),
sa.Column('ausrichter_verein_id', sa.Integer(), nullable=True),
sa.Column('ist_doppelturnier', sa.Boolean(), nullable=False),
sa.Column('veranstaltungsleiter', sa.String(length=200), nullable=True),
sa.Column('turnierleiter', sa.String(length=200), nullable=True),
sa.Column('status', sa.Enum('geplant', 'laufend', 'vorlaeufig', 'final', name='veranstaltung_status'), nullable=False),
sa.Column('notiz', sa.Text(), nullable=True),
sa.Column('erstellt_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.Column('geaendert_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.ForeignKeyConstraint(['ausrichter_verein_id'], ['verein.id'], name=op.f('fk_veranstaltung_ausrichter_verein_id_verein')),
sa.PrimaryKeyConstraint('id', name=op.f('pk_veranstaltung'))
)
op.create_index(op.f('ix_veranstaltung_datum'), 'veranstaltung', ['datum'], unique=False)
op.create_table('meisterschaft',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('saison_jahr', sa.Integer(), nullable=False),
sa.Column('bezeichnung', sa.String(length=200), nullable=False),
sa.Column('kategorie', sa.Enum('J', 'S', 'A', name='meisterschaft_kategorie'), nullable=False),
sa.Column('klasse_id', sa.Integer(), nullable=True),
sa.Column('regelwerk', postgresql.JSONB(astext_type=sa.Text()), nullable=False),
sa.ForeignKeyConstraint(['klasse_id'], ['klasse.id'], name=op.f('fk_meisterschaft_klasse_id_klasse')),
sa.ForeignKeyConstraint(['saison_jahr'], ['saison.jahr'], name=op.f('fk_meisterschaft_saison_jahr_saison')),
sa.PrimaryKeyConstraint('id', name=op.f('pk_meisterschaft'))
)
op.create_index(op.f('ix_meisterschaft_saison_jahr'), 'meisterschaft', ['saison_jahr'], unique=False)
op.create_table('turnier',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('veranstaltung_id', sa.Integer(), nullable=False),
sa.Column('name', sa.String(length=120), nullable=False),
sa.Column('veranstalter_verein_id', sa.Integer(), nullable=True),
sa.Column('zaehlt_meisterschaft', sa.Boolean(), nullable=False),
sa.Column('ist_aktiv', sa.Boolean(), nullable=False),
sa.Column('status', sa.Enum('geplant', 'laufend', 'vorlaeufig', 'final', name='turnier_status'), nullable=False),
sa.Column('erstellt_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.Column('geaendert_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.ForeignKeyConstraint(['veranstalter_verein_id'], ['verein.id'], name=op.f('fk_turnier_veranstalter_verein_id_verein')),
sa.ForeignKeyConstraint(['veranstaltung_id'], ['veranstaltung.id'], name=op.f('fk_turnier_veranstaltung_id_veranstaltung'), ondelete='CASCADE'),
sa.PrimaryKeyConstraint('id', name=op.f('pk_turnier'))
)
op.create_index(op.f('ix_turnier_veranstaltung_id'), 'turnier', ['veranstaltung_id'], unique=False)
op.create_index(
'uq_turnier_ist_aktiv', 'turnier', ['ist_aktiv'], unique=True,
postgresql_where=sa.text('ist_aktiv'),
)
op.create_table('meisterschaft_stand',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('meisterschaft_id', sa.Integer(), nullable=False),
sa.Column('fahrer_id', sa.Integer(), nullable=False),
sa.Column('punkte_gesamt', sa.Numeric(precision=9, scale=2), nullable=False),
sa.Column('punkte_je_lauf', postgresql.JSONB(astext_type=sa.Text()), nullable=False),
sa.Column('gestrichene_laeufe', postgresql.JSONB(astext_type=sa.Text()), nullable=False),
sa.Column('anzahl_siege', sa.Integer(), nullable=False),
sa.Column('platz', sa.Integer(), nullable=True),
sa.Column('berechnet_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.ForeignKeyConstraint(['fahrer_id'], ['fahrer.id'], name=op.f('fk_meisterschaft_stand_fahrer_id_fahrer')),
sa.ForeignKeyConstraint(['meisterschaft_id'], ['meisterschaft.id'], name=op.f('fk_meisterschaft_stand_meisterschaft_id_meisterschaft'), ondelete='CASCADE'),
sa.PrimaryKeyConstraint('id', name=op.f('pk_meisterschaft_stand'))
)
op.create_index(op.f('ix_meisterschaft_stand_fahrer_id'), 'meisterschaft_stand', ['fahrer_id'], unique=False)
op.create_index(op.f('ix_meisterschaft_stand_meisterschaft_id'), 'meisterschaft_stand', ['meisterschaft_id'], unique=False)
op.create_table('wertungsklasse',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('turnier_id', sa.Integer(), nullable=False),
sa.Column('bezeichnung', sa.String(length=200), nullable=False),
sa.Column('klasse_ids', postgresql.ARRAY(sa.Integer()), nullable=False),
sa.Column('sortierung', sa.Integer(), nullable=False),
sa.ForeignKeyConstraint(['turnier_id'], ['turnier.id'], name=op.f('fk_wertungsklasse_turnier_id_turnier'), ondelete='CASCADE'),
sa.PrimaryKeyConstraint('id', name=op.f('pk_wertungsklasse'))
)
op.create_index(op.f('ix_wertungsklasse_turnier_id'), 'wertungsklasse', ['turnier_id'], unique=False)
op.create_table('start',
sa.Column('id', sa.Integer(), nullable=False),
sa.Column('turnier_id', sa.Integer(), nullable=False),
sa.Column('fahrer_id', sa.Integer(), nullable=False),
sa.Column('klasse_id', sa.Integer(), nullable=False),
sa.Column('wertungsklasse_id', sa.Integer(), nullable=True),
sa.Column('startnummer', sa.Integer(), nullable=False),
sa.Column('fahrzeug', sa.String(length=200), nullable=True),
sa.Column('nenngeld_bezahlt', sa.Boolean(), nullable=False),
sa.Column('status', sa.Enum('genannt', 'gestartet', 'DNF', 'DNS', 'DSQ', name='start_status'), nullable=False),
sa.Column('nennreihenfolge', sa.Integer(), nullable=True),
sa.ForeignKeyConstraint(['fahrer_id'], ['fahrer.id'], name=op.f('fk_start_fahrer_id_fahrer')),
sa.ForeignKeyConstraint(['klasse_id'], ['klasse.id'], name=op.f('fk_start_klasse_id_klasse')),
sa.ForeignKeyConstraint(['turnier_id'], ['turnier.id'], name=op.f('fk_start_turnier_id_turnier'), ondelete='CASCADE'),
sa.ForeignKeyConstraint(['wertungsklasse_id'], ['wertungsklasse.id'], name=op.f('fk_start_wertungsklasse_id_wertungsklasse'), ondelete='SET NULL'),
sa.PrimaryKeyConstraint('id', name=op.f('pk_start')),
sa.UniqueConstraint('turnier_id', 'startnummer', name='start_turnier_startnummer')
)
op.create_index(op.f('ix_start_fahrer_id'), 'start', ['fahrer_id'], unique=False)
op.create_index(op.f('ix_start_turnier_id'), 'start', ['turnier_id'], unique=False)
op.create_index(op.f('ix_start_wertungsklasse_id'), 'start', ['wertungsklasse_id'], unique=False)
op.create_table('ergebnis',
sa.Column('start_id', sa.Integer(), nullable=False),
sa.Column('summe_zeit', sa.Numeric(precision=7, scale=2), nullable=True),
sa.Column('summe_fehler', sa.Integer(), nullable=True),
sa.Column('gesamt', sa.Numeric(precision=9, scale=2), nullable=True),
sa.Column('platzierung', sa.Integer(), nullable=True),
sa.Column('zeit_vollstaendig', sa.Boolean(), nullable=False),
sa.Column('fehler_vollstaendig', sa.Boolean(), nullable=False),
sa.Column('erfasst_von', sa.String(length=120), nullable=True),
sa.Column('erfasst_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.Column('korrigiert_am', sa.DateTime(timezone=True), nullable=True),
sa.Column('korrektur_grund', sa.Text(), nullable=True),
sa.ForeignKeyConstraint(['start_id'], ['start.id'], name=op.f('fk_ergebnis_start_id_start'), ondelete='CASCADE'),
sa.PrimaryKeyConstraint('start_id', name=op.f('pk_ergebnis'))
)
op.create_table('zeitmessung',
sa.Column('id', sa.UUID(), nullable=False),
sa.Column('geraet_id', sa.Integer(), nullable=False),
sa.Column('turnier_id', sa.Integer(), nullable=False),
sa.Column('start_id', sa.Integer(), nullable=True),
sa.Column('startnummer_gemeldet', sa.Integer(), nullable=True),
sa.Column('messpunkt', sa.String(length=80), nullable=False),
sa.Column('dauer_sekunden', sa.Numeric(precision=7, scale=2), nullable=False),
sa.Column('gemessen_am', sa.DateTime(timezone=True), nullable=False),
sa.Column('monotonic_ns', sa.BigInteger(), nullable=True),
sa.Column('empfangen_am', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
sa.Column('nachgeliefert', sa.Boolean(), nullable=False),
sa.Column('status', sa.Enum('gueltig', 'verworfen', 'unzugeordnet', 'unplausibel', name='zeitmessung_status'), nullable=False),
sa.Column('verworfen_grund', sa.Text(), nullable=True),
sa.Column('roh', postgresql.JSONB(astext_type=sa.Text()), nullable=True),
sa.ForeignKeyConstraint(['geraet_id'], ['geraet.id'], name=op.f('fk_zeitmessung_geraet_id_geraet')),
sa.ForeignKeyConstraint(['start_id'], ['start.id'], name=op.f('fk_zeitmessung_start_id_start'), ondelete='SET NULL'),
sa.ForeignKeyConstraint(['turnier_id'], ['turnier.id'], name=op.f('fk_zeitmessung_turnier_id_turnier'), ondelete='CASCADE'),
sa.PrimaryKeyConstraint('id', name=op.f('pk_zeitmessung'))
)
op.create_index('ix_zeitmessung_start', 'zeitmessung', ['start_id'], unique=False)
op.create_index('ix_zeitmessung_turnier_status', 'zeitmessung', ['turnier_id', 'status'], unique=False)
# ### end Alembic commands ###
def downgrade() -> None:
# ### commands auto generated by Alembic - please adjust! ###
op.drop_index('ix_zeitmessung_turnier_status', table_name='zeitmessung')
op.drop_index('ix_zeitmessung_start', table_name='zeitmessung')
op.drop_table('zeitmessung')
op.drop_table('ergebnis')
op.drop_index(op.f('ix_start_wertungsklasse_id'), table_name='start')
op.drop_index(op.f('ix_start_turnier_id'), table_name='start')
op.drop_index(op.f('ix_start_fahrer_id'), table_name='start')
op.drop_table('start')
op.drop_index(op.f('ix_wertungsklasse_turnier_id'), table_name='wertungsklasse')
op.drop_table('wertungsklasse')
op.drop_index(op.f('ix_meisterschaft_stand_meisterschaft_id'), table_name='meisterschaft_stand')
op.drop_index(op.f('ix_meisterschaft_stand_fahrer_id'), table_name='meisterschaft_stand')
op.drop_table('meisterschaft_stand')
op.drop_index('uq_turnier_ist_aktiv', table_name='turnier')
op.drop_index(op.f('ix_turnier_veranstaltung_id'), table_name='turnier')
op.drop_table('turnier')
op.drop_index(op.f('ix_meisterschaft_saison_jahr'), table_name='meisterschaft')
op.drop_table('meisterschaft')
op.drop_index(op.f('ix_veranstaltung_datum'), table_name='veranstaltung')
op.drop_table('veranstaltung')
op.drop_index(op.f('ix_klasse_saison_jahr'), table_name='klasse')
op.drop_table('klasse')
op.drop_index(op.f('ix_fahrer_verein_id'), table_name='fahrer')
op.drop_index('ix_fahrer_name_trgm', table_name='fahrer', postgresql_using='gin')
op.drop_index(op.f('ix_fahrer_geburtsjahr'), table_name='fahrer')
op.drop_table('fahrer')
op.drop_table('verein')
op.drop_table('saison')
op.drop_index(op.f('ix_import_job_idempotenz_schluessel'), table_name='import_job')
op.drop_table('import_job')
op.drop_table('geraet')
op.drop_table('benutzer')
# ### end Alembic commands ###
packaging/apt-repo/README.md
+35
View File
@@ -0,0 +1,35 @@
# APT-Repository für `oamc-turnier`
Kleines, signiertes Ein-Paket-Repo (für den Vereins-Pi / eigenen Server). Nutzt
`reprepro`.
## Einmalig: Repo anlegen
```sh
sudo apt install reprepro devscripts build-essential debhelper
export GNUPGHOME=~/.gnupg
gpg --full-generate-key # Repo-Signierschlüssel, z. B. "OAMC APT <apt@oamc.de>"
gpg --armor --export apt@oamc.de > packaging/apt-repo/oamc-archive-keyring.asc
mkdir -p /srv/apt/oamc/conf
cp packaging/apt-repo/distributions /srv/apt/oamc/conf/distributions # SignWith anpassen
```
## Paket bauen und einspielen
```sh
./packaging/apt-repo/build-deb.sh # erzeugt ../oamc-turnier_*.deb
reprepro -b /srv/apt/oamc includedeb trixie ../oamc-turnier_*.deb
```
`/srv/apt/oamc` per nginx/Apache unter z. B. `https://apt.oamc.de` ausliefern.
## Auf dem Zielrechner
```sh
curl -fsSL https://apt.oamc.de/oamc-archive-keyring.asc \
| sudo tee /etc/apt/keyrings/oamc.asc >/dev/null
echo "deb [signed-by=/etc/apt/keyrings/oamc.asc] https://apt.oamc.de trixie main" \
| sudo tee /etc/apt/sources.list.d/oamc.list
sudo apt update && sudo apt install oamc-turnier
```
packaging/apt-repo/build-deb.sh
Executable
+19
View File
@@ -0,0 +1,19 @@
#!/bin/sh
# Baut das .deb aus dem Projektwurzelverzeichnis.
# Voraussetzungen: dpkg-dev, debhelper (>= 13), python3-venv, Internet (pip).
set -eu
WURZEL="$(cd "$(dirname "$0")/../.." && pwd)"
cd "$WURZEL"
command -v dpkg-buildpackage >/dev/null || {
echo "dpkg-dev / debhelper fehlen: sudo apt install build-essential debhelper devscripts"
exit 1
}
# -us -uc: unsigniert (Signatur macht reprepro beim includedeb)
dpkg-buildpackage -b -us -uc
echo
echo "Fertig. Artefakte:"
ls -1 ../oamc-turnier_*.deb 2>/dev/null || true
packaging/apt-repo/distributions
+8
View File
@@ -0,0 +1,8 @@
Origin: OAMC Reinheim
Label: OAMC Turnierauswertung
Suite: stable
Codename: trixie
Architectures: arm64 amd64 source
Components: main
Description: OAMC Turnierauswertung - internes APT-Repo
SignWith: apt@oamc.de
plan.md
+848
View File
@@ -0,0 +1,848 @@
# Plan: OAMC Turnierauswertung — Webanwendung
**Stand:** 2026-09-05 · **Status:** Entwurf, noch nicht freigegeben
**Änderung 05.09.:** Zeitmessung per Lichtschranke aufgenommen (§3.6, §5.4, §6.2, AP 5)
---
## 1. Ausgangslage
### 1.1 Der Verein und die Sportart
Der **OAMC Reinheim e.V. im ADAC** (Odenwälder Automobil- und Motorsportclub) richtet
**ADAC Motorrad-Turniere** aus. Diese laufen nach der **ADAC-Turnierordnung** im Bereich
des **ADAC Hessen-Thüringen (HTH)**.
Motorrad-Turniersport ist kein Rennsport, sondern ein Geschicklichkeitswettbewerb: Die
Fahrer durchfahren einen Parcours mit festen Aufgaben, dabei zählen **Fehlerpunkte** und
**Fahrzeit**.
Aufgaben im Parcours (laut Sportbeschreibung auf oamc.de):
Fahrzeugabnahme · Schätzen (im Stand und in Fahrt) · Slalom · Acht-Figur · Spurgasse ·
Kreisel · Tor · Schrägbrett · Wippe (mit und ohne Spurbrett) · Gummiringe ·
Dose umsetzen · Fahrgasse · Stop Haltelinie · Langsamfahrstrecke
### 1.2 Aktueller Ist-Zustand der Website
Die bestehende Seite **oamc.de** (Zweitdomain: oamc-reinheim.de) ist eine statische
**HTML-4.01-Frameset-Website**:
- Aufbau: `index` → `oben.htm` (Navigation) + `hauptfenster.htm`, jede Rubrik wieder
ein eigenes Frameset (`m/frame-m.htm` → `m1.htm` Menü + `m2.htm` Inhalt)
- Rubriken: Verein · VÜP ADAC-Platz · Kartgruppe · **Motorradgruppe** · Fahrrad JVS ·
Anfahrt · Download · Weblinks · Flohmarkt · BikerSafetyDay
- **Alle Ergebnisse liegen ausschließlich als PDF** unter `/datei/` und werden auf
`d/d-mot-turnier.htm` verlinkt — Tagesergebnisse, Meisterschaftsstände (HTH 2002–2026),
Bundesturnier-Ergebnisse, Protokolle
- Die Seite **`m/m-fahrer.htm` ist eine „BAUSTELLE"** — es gibt aktuell **keine
Fahrerdatenbank**. Genau das ist die Lücke, die dieses Projekt schließt.
- `m-ergebnisse.htm` und `m-ausschreibung.htm` verweisen nur auf die PDF-Downloadseite
### 1.3 Wie heute ausgewertet wird
Die Rahmenausschreibung 2026 nennt als Anforderung an den Veranstalter:
> „Auswertungscomputer mit MSOffice (**Excel**) und Drucker sollte zeitgemäß vorhanden sein."
Es existieren Vorlagen als `.xlsx` (z. B. `MT-NENNLISTE-5-2025.xlsx`). Die Auswertung
läuft also heute **in Excel**, das Ergebnis wird als PDF exportiert und manuell auf die
Website gelegt. Meisterschaftsstände werden separat fortgeschrieben.
**Schmerzpunkte:**
| Problem | Auswirkung |
|---|---|
| Ergebnisse nur als PDF | nicht durchsuchbar, nicht verlinkbar, nicht mobil lesbar |
| Meisterschaftsstand manuell | fehleranfällig, spät verfügbar |
| Keine Fahrerhistorie | „Wie oft war X schon dabei?" nicht beantwortbar |
| Fahrerstammdaten pro Turnier neu erfasst | Tippfehler, Dubletten, Namensvarianten |
| Frameset-Website | kein Deep-Link, schlechtes SEO, unbrauchbar auf dem Handy |
---
## 2. Ziel
Eine Webanwendung, die
1. **Turnierergebnisse auswertet** — Fehlerpunkte + Zeit → Platzierung je Wertungsklasse
2. **Alle Daten in einer Datenbank hält** statt in Excel und PDF
3. **Zeiten per API von der Lichtschranken-Zeitmessung entgegennimmt** (zweiter Raspberry
Pi am Parcours, siehe §3.6), in die Datenbank schreibt und **live anzeigt**
4. **Fahrer samt Stammdaten und Historie** bereitstellt (die heutige „Baustelle")
5. Die **Meisterschafts-/Pokalwertung** automatisch fortschreibt
### Nicht-Ziele (bewusst außerhalb dieses Projekts)
- Ablösung der kompletten oamc.de (Kart, Fahrrad, Flohmarkt, VÜP bleiben, wo sie sind)
- Online-Nennung/Anmeldung durch Teilnehmer → **Phase 2**, siehe §9
- Elektronische Erfassung der **Fehlerpunkte** — die bleiben beim Wertungspersonal im
Parcours und werden manuell eingegeben (siehe §3.6)
- Zahlungsabwicklung des Nenngelds (10 € je Start, wird vor Ort kassiert)
---
## 3. Fachliche Grundlagen
> ⚠️ Die folgenden Regeln wurden aus der Ergebnisliste
> `2026-05-31-MT-REIN-HAIN.PDF` und der `MT-Rahmenausschreibung-2026.pdf`
> **abgeleitet**. Sie sind **vor der Implementierung gegen die ADAC-Turnierordnung 2026
> (`MT-D2025.pdf`) und mit dem Bereichsleiter zu verifizieren** — siehe §10.
### 3.1 Veranstaltungsstruktur
- Ein Renntag kann ein **Doppelturnier** sein: zwei Turniere zweier Ortsclubs laufen
parallel auf einem Platz, z. B. „ADAC-Motorrad-Doppelturnier des MSC Hainstadt und
des OAMC Reinheim".
- **Jeder Fahrer wird in beiden Turnieren getrennt gewertet** — die Ergebnisliste vom
31.05.2026 enthält für dieselben Fahrer je einen Block „Reinheim" und einen Block
„Hainstadt" mit **eigenen Zeiten, Fehlern und Platzierungen**.
- ⇒ Datenmodell-Konsequenz: `veranstaltung` (Renntag) : `turnier` (Wertungslauf) = 1:n
### 3.2 Klassen
**Jugendklassen** (Einteilung strikt nach Jahrgang, Ausweispflicht bei der Nennung):
| Klasse | Jahrgang | ~Alter | Fahrzeug |
|---|---|---|---|
| J 1 | 2019 / 2018 / 2017 | 7–9 | Kindermotorrad max. 110 ccm / 5,5 kW |
| J 2 | 2016 / 2015 | 10–11 | Kindermotorrad max. 110 ccm / 5,5 kW |
| J 3 | 2014 / 2013 | 12–13 | Mofa, Motorrad + Roller max. 125 ccm / 11 kW |
| J 4 | 2012 / 2011 | 14–15 | Mofa, Motorrad + Roller max. 125 ccm / 11 kW |
| J 5 | 2010 / 2009 / 2008 (bis 18. Geburtstag) | 16–18 | Mofa, Motorrad + Roller max. 125 ccm / 11 kW |
Für Klasse 1 muss der Teilnehmer **am Veranstaltungstag** bereits 7 Jahre alt sein.
⇒ Die Jahrgangstabelle ist **jahresabhängig** und muss versioniert in der DB liegen,
nicht im Code (`klassen_jahrgang` mit `saison`).
**Erwachsenenklassen:** `S 1`–`S 9` (Stammfahrer) und `A 1`–`A 4` (Anfänger), unterteilt
nach Fahrzeugtyp/Hubraum. Aus der Sportbeschreibung: Mokicks und Roller bis 80 ccm ·
bis 250 ccm · bis 650 ccm · über 650 ccm · Enduro (mehrere Hubraumklassen) ·
Seitenwagen · **Pedelec / E-Bike** · **E-Scooter** (neu).
> ❗ Die genaue Zuordnung `S 1`…`S 9` / `A 1`…`A 4` → Fahrzeugtyp ist aus den
> öffentlichen Seiten **nicht** ersichtlich. Muss erfragt werden (§10).
**Wertungsklasse ≠ Klasse:** In der Ergebnisliste werden Klassen zu Wertungsklassen
zusammengefasst, wenn zu wenige Starter da sind — z. B. eine gemeinsame Wertung
„S 5, S 9, S 3, S 6, S 7" und „A 1, A 4". Das Zusammenlegen ist eine
**Entscheidung pro Turnier** und gehört als Datum in die DB, nicht als Regel in den Code.
### 3.3 Wertungslogik ← Kernstück der Anwendung
Spalten der Ergebnisliste:
`Start-Nr.` · `Voller Name` · `Regionalclub` · `Klasse` · `Geschlecht` · `Kategorie` ·
`Summe Zeit` · `Summe Fehler` · `Gesamt` · `Platzierung`
**Es gibt zwei verschiedene Berechnungen für `Gesamt`:**
**a) Erwachsene (Kategorie S, und A-Fahrer):**
```
Gesamt = Summe Zeit + Summe Fehler
Platzierung = aufsteigend nach Gesamt
```
Belege aus der Liste vom 31.05.2026, Wertungsklasse „S 5, S 9, S 3, S 6, S 7":
| Fahrer | Klasse | Zeit | Fehler | Gesamt | Platz |
|---|---|---|---|---|---|
| Bernius Meik | S 6 | 105,43 | 0 | **105,43** | 1 |
| Schmunk Christian | S 9 | 103,26 | 10 | **113,26** | 2 |
| Krack Robin | S 5 | 130,33 | 0 | **130,33** | 4 |
| Steinbrech Nicolai | S 5 | 65,71 | 1210 | **1275,71** | 11 |
**b) Jugend (Kategorie J):**
```
Gesamt = Summe Fehler ← die Zeit geht NICHT in die Wertung ein
Platzierung = aufsteigend nach Fehler, bei Gleichstand aufsteigend nach Zeit
```
Das deckt sich mit der Sportbeschreibung:
> „Bei den Turnieren kommt es in der Jugendklasse vorrangig auf die fehlerfreie
> Durchfahrt an, da die Zeit erst bei Punktgleichheit herangezogen wird."
Belege, Wertungsklasse J 3:
| Fahrer | Zeit | Fehler | Gesamt | Platz | Anmerkung |
|---|---|---|---|---|---|
| Freund Philipp | 136,88 | 0 | **0** | 1 | drei Fahrer mit 0 Fehlern … |
| D'Angelo Leandro | 140,40 | 0 | **0** | 2 | … Reihenfolge über die Zeit |
| Heil Luca | 144,46 | 0 | **0** | 3 | |
| Mattes Flynn | 160,05 | 10 | **10** | 4 | |
| Ratter Mitja | 148,42 | 60 | **60** | 7 | Gleichstand 60 Fehler … |
| Kemesies Finlay | 165,39 | 60 | **60** | 8 | … 148,42 < 165,39 |
⇒ Die Wertungsformel ist **pro Kategorie konfigurierbar** zu implementieren, nicht
hart zu verdrahten (`wertungsregel` als Strategie/Enum je Kategorie und Saison).
**Fehlerpunkte** treten in Vielfachen von 10 auf (10/20/30/…/1210). Die Zuordnung
„welcher Fehler an welcher Aufgabe kostet wie viele Punkte" steht in der
ADAC-Turnierordnung und ist zu beschaffen (§10).
**Mehrfachstarts:** Ein Fahrer kann am selben Tag **mehrfach starten** (anderes Fahrzeug,
andere Klasse). Beispiel 31.05.2026: *Schmunk Christian* startet in S 9 **und** S 3,
*Bernius Meik* in S 6 **und** S 7 — jeweils mit eigener Startnummer und eigenem Ergebnis.
⇒ Der Schlüssel eines Ergebnisses ist **nicht** (Turnier, Fahrer), sondern
(Turnier, Start), und Nenngeld fällt „für jeden Start" an.
### 3.4 Meisterschafts-/Pokalwertung (HTH)
- **Erwachsene:** ein Gesamtklassement der A- und S-Fahrer/innen (klassenübergreifend)
- **Jugend:** Pokalwertung **klassenweise** J 1 – J 5
**Streichresultate** — nicht alle Läufe zählen:
| Turniere in der Saison | 12 | 11 | 10 | 9 | 8 | 7 | 6 | 5 | 4 |
|---|---|---|---|---|---|---|---|---|---|
| **davon gewertet** | 8 | 8 | 8 | 7 | 6 | 5 | 4 | 3 | 2 |
Nicht jede Veranstaltung zählt zur Meisterschaft — der Terminkalender markiert Läufe
„mit Meisterschaftswertung" bzw. „o. M. = ohne Meisterschaft".
**Endlaufqualifikation:** die besten **10 Erwachsenen** und **10 Jugendlichen** der
HTH-Meisterschaft (Jugend ohne Trennung Damen/Herren, Verteilung prozentual nach
Teilnehmerzahl der 5 Jugendklassen). **Bei Punktgleichheit zählt die Majorität der
Siege.** Endgültige Festlegung durch den Bereichsleiter ⇒ die Anwendung *schlägt vor*,
sie *entscheidet nicht*.
> ❗ Die **Punktetabelle** (Platz → Meisterschaftspunkte) ist noch nicht bekannt (§10).
### 3.5 Weitere Regeln aus der Rahmenausschreibung 2026
- Nenngeld einheitlich **10 €** je Start (S, A, Jugend, Mofa/Moped, E-Bike, Pedelec, E-Scooter)
- **Nennschluss:** Klasse S + Jugendklassen 14:00 Uhr, A-Klasse + E-Bike/Pedelec/E-Scooter 15:00 Uhr
- Pokalläufe bei Doppelveranstaltungen beginnen generell 09:00 Uhr
- Gültiger Jugendausweis + unterschriebener Haftungsausschluss sind bei der Nennung vorzulegen
- Eine **nummerierte Nennungsliste** ist zu führen, die Reihenfolge nach Möglichkeit einzuhalten
- Für A-Klassen-Fahrer und Gelegenheitsfahrer wird z. B. jede 10. Startnummer freigehalten
- Schlussbericht + Ergebnisliste müssen nach FFM gemeldet werden — **der Veranstalter-Zuschuss
wird erst überwiesen, wenn beide Dokumente dort sind** ⇒ Export in genau diesen Formaten
ist kein „nice to have", sondern zahlungsrelevant
### 3.6 Zeitmessung per Lichtschranke *(Vorgabe des Auftraggebers)*
Die API wird von einem **zweiten Raspberry Pi am Parcours** bespielt. Dieser ist an eine
**Lichtschranke** angeschlossen, misst die Fahrzeiten, sendet sie an die Anwendung und
**zeigt die Daten des aktuellen Fahrzeugs/Starters an**.
Damit gibt es **zwei Datenquellen pro Ergebnis**:
| Wert | Quelle | Weg |
|---|---|---|
| `Summe Zeit` | **Lichtschranke** (Messgerät) | automatisch per API |
| `Summe Fehler` | **Wertungspersonal im Parcours** | manuell im internen Frontend |
Ein Ergebnis ist also erst vollständig, wenn **beide** Seiten geliefert haben. Das
Datenmodell muss einen Start mit Zeit, aber ohne Fehlerpunkte (und umgekehrt) sauber
abbilden können — ein „halbes" Ergebnis ist der Normalzustand während der Veranstaltung,
kein Fehler.
#### Konsequenzen für den Entwurf
**a) Rohmessungen statt Summen speichern.**
Die Spalte heißt in der Ergebnisliste `Summe Zeit` — die Zeit ist also vermutlich eine
**Summe mehrerer Messungen** (mehrere Durchgänge oder mehrere gemessene Abschnitte,
z. B. Langsamfahrstrecke und Gesamtdurchfahrt). Die Anwendung speichert deshalb **jede
Einzelmessung** (`zeitmessung`) und bildet die Summe selbst. Rückweg gibt es nicht:
aus einer gespeicherten Summe lassen sich Einzelmessungen nie wieder herstellen, aus
Einzelmessungen die Summe jederzeit. → offene Frage **O-13**
**b) Das Messgerät ist ein eigenständiger API-Client, kein Teil der Anwendung.**
Es bekommt einen **Geräte-Token** (nicht den Auswerter-Login), darf nur Messungen
schreiben und Starter-Daten lesen, und wird in der DB als `geraet` geführt. Ein Gerät
am offenen Platz muss man notfalls einzeln sperren können.
**c) Netzausfall ist der Normalfall, nicht die Ausnahme.**
Am ADAC-Platz kann das Netz wegbrechen. Der Mess-Pi **muss lokal puffern** (SQLite oder
Datei-Queue) und nach Wiederverbindung nachliefern. Deshalb gilt zwingend:
- jede Messung bekommt eine **UUID vom Messgerät** → Server ist idempotent, doppelt
gesendete Messungen erzeugen keine Dubletten
- die Messung trägt **zwei Zeitstempel**: Wanduhr (`gemessen_am`) und **monotone
Gerätezeit** (`monotonic_ns`). Die Wanduhr eines Pi ohne Netz und ohne RTC springt
beim NTP-Sync — die Dauer zwischen zwei Lichtschranken-Ereignissen darf davon nicht
abhängen. **Der Pi berechnet die Dauer selbst und sendet sie**, der Server rechnet
keine Differenz aus zwei Wanduhr-Zeitstempeln.
- der Server nimmt Messungen **rückwirkend** an (`gemessen_am` in der Vergangenheit)
und markiert sie als nachgeliefert
**d) Zuordnung Messung → Starter ist der kritische Punkt.**
Eine Lichtschranke misst eine Zeit, sie weiß nicht, **wer** durchgefahren ist. Die
Zuordnung muss irgendwo herkommen — Eingabe der Startnummer am Mess-Pi, eine
Warteschlange „nächster Starter" aus der Nennliste, oder ein Transponder/RFID.
→ offene Frage **O-14**. Bis zur Klärung wird konservativ geplant:
- der Mess-Pi holt sich per API die **Startreihenfolge** des laufenden Turniers
- er sendet die Messung **mit** der Startnummer, die er gerade anzeigt
- eine Messung **ohne** zuordenbare Startnummer wird nicht verworfen, sondern als
`zeitmessung` ohne `start_id` gespeichert und im Frontend zur manuellen Zuordnung
angeboten. Eine gemessene Zeit ist nicht reproduzierbar — sie darf nie verloren gehen,
nur weil die Zuordnung fehlte.
**e) Fehlmessungen sind Betriebsrealität.**
Zuschauer, Helfer oder ein zurücksetzendes Motorrad lösen die Lichtschranke aus.
Nötig sind: **Entprellung/Mindestabstand** zwischen zwei Triggern auf dem Pi, ein
**Verwerfen-Knopf** in der Erfassung, sowie Plausibilitätsprüfung serverseitig
(eine Fahrzeit von 3 s oder 900 s ist zu markieren, nicht stillschweigend zu übernehmen).
Jede verworfene Messung bleibt mit Grund gespeichert.
**f) Die Anzeige am Parcours ist ein eigener Anwendungsfall.**
Der Mess-Pi zeigt Starter- und Fahrzeugdaten an, zieht sie also **lesend** aus der API.
Das braucht einen schlanken, schnellen Endpunkt und eine Live-Aktualisierung (SSE),
und er muss **auch bei Netzausfall die zuletzt geladene Startliste weiter anzeigen**.
> ❗ Was genau angezeigt werden soll (Startnummer, Name, Klasse, Fahrzeug, laufende Zeit,
> letzte Zeit?) und auf welcher Hardware (HDMI-Monitor, kleines Display, LED-Tafel) ist
> noch offen → **O-15**.
---
## 4. Datenmodell
```
verein ──┐
├──< fahrer ──< start >── turnier >── veranstaltung
saison ──┤ │ │ │
├──< klasse ───┘ │ └──< wertungsklasse
│ ├──< ergebnis (Zeit + Fehler, berechnet)
│ └──< zeitmessung >── geraet (Lichtschranke)
└──< meisterschaft ──< meisterschaft_stand
```
### Tabellen
**`verein`** — Regionalclub / Ortsclub
`id` · `name` („OAMC Reinheim", „MSC Schotten", „PMS Kassel", „Hainstadt") ·
`kurzname` · `adac_gau` · `aktiv`
**`fahrer`** — Stammdaten, **einmalig**, nicht pro Turnier
`id` · `nachname` · `vorname` · `geburtsjahr` · `geburtsdatum` (nullable, für J1-Prüfung
„am Veranstaltungstag 7 Jahre") · `geschlecht` (M/W/D) · `verein_id` ·
`adac_mitgliedsnr` (nullable) · `jugendausweis_gueltig_bis` · `aktiv` · `notiz` ·
`erstellt_am` / `geaendert_am`
→ **Dublettenerkennung** beim Import nötig, siehe §6.3
**`saison`** — Jahr, macht Regeln versionierbar
`jahr` (PK) · `turnierordnung_version` · `streichresultate_tabelle` (JSONB) ·
`nenngeld_cent` · `aktiv`
**`klasse`** — Klassendefinition **pro Saison**
`id` · `saison_jahr` · `code` („J 1", „S 6", „A 4") · `kategorie` (J/S/A) ·
`bezeichnung` · `jahrgaenge` (int[], nur Jugend) · `ccm_max` · `kw_max` ·
`fahrzeugtyp` · `sortierung`
**`veranstaltung`** — der Renntag
`id` · `datum` · `titel` · `ort` · `ausrichter_verein_id` · `ist_doppelturnier` ·
`veranstaltungsleiter` · `turnierleiter` · `status` (geplant/laufend/vorlaeufig/final)
**`turnier`** — der einzelne Wertungslauf (bei Doppelturnier zwei pro Veranstaltung)
`id` · `veranstaltung_id` · `name` („Reinheim" / „Hainstadt") · `veranstalter_verein_id` ·
`zaehlt_meisterschaft` (bool) · `status`
**`wertungsklasse`** — pro Turnier zusammengefasste Klassen
`id` · `turnier_id` · `bezeichnung` („S 5, S 9, S 3, S 6, S 7") ·
`klasse_ids` (int[]) · `sortierung`
**`start`** — eine Teilnahme; ein Fahrer kann mehrere pro Turnier haben
`id` · `turnier_id` · `fahrer_id` · `klasse_id` · `wertungsklasse_id` · `startnummer` ·
`fahrzeug` (Text) · `nenngeld_bezahlt` · `status` (genannt/gestartet/DNF/DNS/DSQ)
→ UNIQUE (`turnier_id`, `startnummer`)
**`ergebnis`** — 1:1 zum Start, getrennt für saubere Nachträge/Korrekturen
`start_id` (PK) · `summe_zeit` (numeric(7,2), **aus `zeitmessung` summiert**) ·
`summe_fehler` (int, **manuell erfasst**) · `gesamt` (numeric(9,2), **berechnet**) ·
`platzierung` (int, **berechnet**) · `zeit_vollstaendig` (bool) ·
`fehler_vollstaendig` (bool) · `erfasst_von` · `erfasst_am` · `korrigiert_am` ·
`korrektur_grund`
→ Die beiden `*_vollstaendig`-Flags machen sichtbar, welche der zwei Quellen (§3.6)
noch fehlt. Gewertet wird erst, wenn beide gesetzt sind.
**`geraet`** — Messgerät / Anzeige am Parcours
`id` · `bezeichnung` („Lichtschranke Ziel", „Anzeige Start") · `typ`
(lichtschranke/anzeige) · `token_hash` · `aktiv` · `letzte_meldung_am` ·
`firmware_version` · `notiz`
→ `letzte_meldung_am` ist der Heartbeat: das Frontend zeigt, ob die Messung noch lebt
**`zeitmessung`** — Einzelmessung, **nicht** die Summe
`id` (UUID, **vom Gerät vergeben** → Idempotenz) · `geraet_id` · `turnier_id` ·
`start_id` (**nullable** — unzugeordnete Messungen gehen nicht verloren) ·
`startnummer_gemeldet` (int, was das Gerät angezeigt hat) · `messpunkt`
(z. B. „Durchgang 1", „Langsamfahrstrecke") · `dauer_sekunden` (numeric(7,2),
**vom Gerät berechnet**) · `gemessen_am` (timestamptz, Wanduhr) · `monotonic_ns` (bigint) ·
`empfangen_am` · `nachgeliefert` (bool) · `status` (gueltig/verworfen/unzugeordnet) ·
`verworfen_grund` · `roh` (JSONB, Rohereignisse der Lichtschranke)
→ UNIQUE (`id`); Index auf (`turnier_id`, `status`), (`start_id`)
**`aufgabe`** / **`ergebnis_aufgabe`** — *optional, Phase 2*: Einzelwertung je Parcours-Aufgabe
(Slalom, Wippe, Kreisel …). Die heutigen PDFs enthalten nur Summen; die Struktur
vorzusehen kostet jetzt nichts und erlaubt später Detailauswertungen. Sobald die
Lichtschranke mehrere Messpunkte bedient, wächst `zeitmessung.messpunkt` natürlich in
diese Struktur hinein.
**`meisterschaft`** — z. B. „HTH Erwachsene 2026", „HTH Jugend J 3 2026"
`id` · `saison_jahr` · `bezeichnung` · `kategorie` · `klasse_id` (nullable) · `regelwerk` (JSONB)
**`meisterschaft_stand`** — materialisiert, nach jedem Turnier neu berechnet
`meisterschaft_id` · `fahrer_id` · `punkte_gesamt` · `punkte_je_lauf` (JSONB) ·
`gestrichene_laeufe` (JSONB) · `anzahl_siege` (Tie-Break!) · `platz` · `berechnet_am`
**`import_job`** — Audit-Trail jedes API-/Datei-Imports
`id` · `quelle` · `dateiname` · `roh_payload` (JSONB) · `status` · `fehler` ·
`angelegt_von` · `angelegt_am`
**`benutzer`** / **`rolle`** — Admin, Auswerter, Lesend
### Kernprinzipien
- `gesamt` und `platzierung` werden **von der Anwendung berechnet**, nicht importiert —
importierte Werte werden gegen die Berechnung **geprüft** und Abweichungen gemeldet
(fängt Excel-Fehler in Altdaten und Regelmissverständnisse auf beiden Seiten)
- Alles **saisonversioniert**: Klassen, Jahrgänge, Streichresultate, Punktetabelle.
Ergebnisse aus 2019 müssen 2030 noch korrekt reproduzierbar sein.
- Ergebnisse sind **append-only mit Korrektur-Historie**, kein stilles UPDATE
---
## 5. Architektur & Technologie
### 5.1 Vorhandene Umgebung (geprüft auf diesem Gerät)
| | |
|---|---|
| Hardware | Raspberry Pi 4 Model B Rev 1.5, 8 GB RAM, 117 GB Speicher (94 GB frei) |
| OS | Debian 13 (trixie), Linux 6.18 aarch64 |
| **PostgreSQL 17.10** | installiert **und aktiv** ✅ |
| **nginx** | installiert **und aktiv** ✅ |
| **Python 3.13.5** + pip 25.1.1 | ✅ |
| Node.js / npm | ❌ nicht installiert |
| Docker | ❌ nicht installiert |
| git | ❌ **nicht installiert** — vor Projektstart nachinstallieren |
### 5.2 Empfohlener Stack
Der Stack folgt dem, was **schon läuft** — auf einem Pi 4 zählt jedes vermiedene
Laufzeit-Ökosystem.
| Schicht | Wahl | Begründung |
|---|---|---|
| Datenbank | **PostgreSQL 17** | läuft bereits; JSONB für Regelwerke, saubere Constraints, echte Transaktionen |
| Backend | **Python 3.13 + FastAPI** | Python ist da; FastAPI liefert die API-Doku (OpenAPI/Swagger) automatisch mit — wichtig, weil Dritte die API bespielen sollen |
| ORM / Migration | **SQLAlchemy 2 + Alembic** | Schemaänderungen über Jahre nachvollziehbar |
| Validierung | **Pydantic v2** | ein Schema für API-Validierung *und* Doku |
| Templates | **Jinja2**, serverseitig gerendert | Ergebnislisten sind Dokumente, keine App. Kein Build-Schritt, kein Node, sofort suchmaschinenlesbar |
| Interaktivität | **HTMX** (~14 kB, per CDN oder lokal) | Filter/Sortierung/Live-Nachladen ohne SPA-Apparat |
| Live-Updates | **SSE** (Server-Sent Events), von FastAPI direkt unterstützt | Anzeige am Parcours und Live-Ergebnisse; einseitiger Datenfluss, kein WebSocket-Zustand nötig, reconnectet von selbst |
| CSS | handgeschrieben oder **Pico.css** | keine Build-Pipeline |
| Excel/CSV-Import | **openpyxl** + `csv` | die Nennlisten sind `.xlsx` |
| PDF-Export | **WeasyPrint** | Schlussbericht + Ergebnisliste müssen nach FFM |
| Server | **uvicorn** hinter dem vorhandenen **nginx** | nginx macht TLS und liefert Statisches |
| Prozess | **systemd-Unit** | kein Docker nötig |
| TLS | **Let's Encrypt / certbot** | |
**Bewusst nicht gewählt:** React/Vue-SPA (Build-Kette auf dem Pi, kein SEO, viel Aufwand
für Tabellenanzeige) · Docker (Overhead ohne Nutzen bei einer App) · SQLite
(Mehrbenutzerbetrieb am Turniertag, Postgres ist schon da)
### 5.3 Betrieb
```
╔═══ Am Parcours ═══════════════╗
║ Pi #2 „Mess-Pi" ║
║ Lichtschranke → GPIO ║
║ lokale Queue (SQLite) ║──┐ POST Messungen (idempotent, gepuffert)
║ Anzeige Starter/Fahrzeug ║<─┼─ GET Startliste + SSE Live
╚═══════════════════════════════╝ │
│
Internet / LAN ──> nginx (TLS, statisch) ┘
└→ uvicorn/FastAPI (systemd) → PostgreSQL 17 (lokal)
→ /var/oamc/uploads (PDFs, Bilder)
```
- **Backup:** täglicher `pg_dump` + wöchentliche Vollsicherung auf externes Medium.
Auf einer SD-Karte/SSD im Pi ist das nicht optional.
- **Offline-Fähigkeit am Turniertag** ist durch die Zeitmessung **Pflicht geworden**, nicht
mehr optional (§3.6c). Zwei Ebenen:
1. der **Mess-Pi** puffert lokal und liefert nach — deckt kurze Aussetzer ab
2. bei Veranstaltungen **ohne Internet** muss der Anwendungs-Pi **mit vor Ort** und
beide Geräte hängen an einem lokalen Netz (Router/Hotspot ohne Uplink). Die
Synchronisation zum öffentlichen Server erfolgt danach.
⇒ Entscheidung dazu offen, siehe **O-7**.
- **Zeitserver:** ohne Internet gibt es kein NTP. Der Anwendungs-Pi sollte im lokalen
Netz selbst NTP anbieten, damit die Zeitstempel zusammenpassen. Für die *Messung*
ist das unkritisch (der Mess-Pi rechnet monoton, §3.6c), für die Protokollierung nicht.
### 5.4 Software auf dem Mess-Pi
Bewusst klein und eigenständig — das Gerät muss auch dann sinnvoll weiterlaufen, wenn
der Server nicht erreichbar ist.
| Teil | Wahl |
|---|---|
| GPIO / Lichtschranke | `gpiozero` mit `pigpio`- oder `lgpio`-Backend; Trigger als **Interrupt**, nicht Polling |
| Zeitmessung | `time.monotonic_ns()`, Entprellung/Mindestabstand konfigurierbar |
| Lokale Queue | SQLite, Einträge bleiben bis vom Server quittiert |
| Versand | HTTP + Geräte-Token, Retry mit Backoff, Batch-Nachlieferung |
| Anzeige | Browser im Kiosk-Modus auf die Anzeige-Seite der Anwendung (§7), Daten per SSE, letzte Startliste im `localStorage` als Offline-Rückfall |
| Betrieb | systemd-Unit, `WatchdogSec`, Autostart, read-only Root-FS erwägen (Stromausfall am Platz) |
> Für saubere Zeiten unter Last ist ein Interrupt-basierter Trigger Pflicht. Ob die
> Genauigkeit eines Linux-Userspace-Prozesses reicht, hängt von der geforderten
> Auflösung ab → **O-16**. Die Ergebnislisten führen **1/100 s** (z. B. `159,16`);
> das ist mit `pigpio` gut erreichbar, mit Polling in Python nicht zuverlässig.
---
## 6. API
Zwei Richtungen: **Ingest** (Daten kommen rein) und **Read** (Daten gehen raus).
### 6.1 Ingest — `POST /api/v1/…` (authentifiziert, API-Key)
| Endpunkt | Zweck |
|---|---|
| `POST /api/v1/veranstaltungen` | Renntag anlegen |
| `POST /api/v1/turniere` | Wertungslauf zum Renntag |
| `POST /api/v1/fahrer` · `PUT /api/v1/fahrer/{id}` | Stammdaten |
| `POST /api/v1/turniere/{id}/starts` | Nennliste (Bulk) |
| `POST /api/v1/turniere/{id}/ergebnisse` | **Ergebnis-Bulk-Upload** ← Kernfall |
| `POST /api/v1/import/xlsx` | Excel-Nennliste/Ergebnisliste als Datei |
| `POST /api/v1/turniere/{id}/finalisieren` | Wertung rechnen, Meisterschaft fortschreiben |
Beispiel-Payload Ergebnis-Upload:
```json
{
"quelle": "excel-auswertung-v3",
"idempotenz_schluessel": "2026-05-31-reinheim-final",
"ergebnisse": [
{ "startnummer": 32, "fahrer": { "nachname": "Gál-Szász", "vorname": "Péter",
"geburtsjahr": 2015, "geschlecht": "M", "verein": "OAMC Reinheim" },
"klasse": "J 2", "summe_zeit": 159.16, "summe_fehler": 10,
"gesamt_erwartet": 10, "platzierung_erwartet": 1 }
]
}
```
**Regeln für den Ingest:**
- **Idempotent** über `idempotenz_schluessel` — ein doppelt gesendeter Upload legt keine
Dubletten an. Am Turniertag mit wackligem Netz ist das Pflicht, nicht Komfort.
- **Zweistufig:** `?dry_run=true` liefert eine Validierungsvorschau (welche Fahrer sind
neu, welche werden gematcht, welche Werte weichen ab) — erst danach wird geschrieben.
- **`gesamt_erwartet` / `platzierung_erwartet`** sind optional; wenn geliefert, rechnet
der Server nach und meldet Abweichungen als Warnung, statt sie zu übernehmen.
- Jeder Aufruf landet in `import_job` mit Roh-Payload — bei Streit über eine Platzierung
ist rekonstruierbar, was wann ankam.
### 6.2 Geräte-API — Zeitmessung & Anzeige *(Mess-Pi, Token-Auth)*
Eigener Namensraum mit eigenem Rechteprofil: schreiben **nur** Messungen, lesen **nur**
das, was die Anzeige braucht. Kompromittierung des Geräts am offenen Platz darf keine
Ergebnisse manipulieren können.
| Endpunkt | Zweck |
|---|---|
| `POST /api/v1/geraete/heartbeat` | „ich lebe" + Firmware/Queue-Länge → Statusanzeige im Frontend |
| `GET /api/v1/geraete/konfiguration` | Entprellzeit, Messpunkte, aktives Turnier — zentral gepflegt statt auf dem Pi |
| `GET /api/v1/turniere/aktiv/startliste` | Startreihenfolge für die Anzeige, ETag-fähig, offlinefest zwischenspeicherbar |
| `GET /api/v1/turniere/aktiv/anzeige` (SSE) | Live-Stream: aktueller Starter, letzte Zeit |
| `POST /api/v1/zeitmessungen` | **Messungen (Batch, idempotent)** ← Kernfall |
| `POST /api/v1/zeitmessungen/{id}/verwerfen` | Fehlmessung markieren |
Beispiel-Payload der Zeitmessung — bewusst als **Batch**, weil der Pi nach einem
Netzausfall mehrere Messungen auf einmal nachliefert:
```json
{
"geraet": "lichtschranke-ziel-01",
"messungen": [
{
"id": "9f2c1e7a-4d38-4b6e-9a11-5c0b2d7e8f30",
"turnier_id": 42,
"startnummer_gemeldet": 32,
"messpunkt": "durchgang-1",
"dauer_sekunden": 159.16,
"gemessen_am": "2026-05-31T10:14:02.482+02:00",
"monotonic_ns": 884213771004,
"roh": { "trigger_start_ns": 884054611004, "trigger_ziel_ns": 884213771004 }
}
]
}
```
Antwort quittiert **jede Messung einzeln** (`angenommen` / `duplikat` / `unzugeordnet` /
`unplausibel`) — erst eine Quittung löscht den Eintrag aus der lokalen Queue des Pi.
**Festlegungen:**
- Die **`id` vergibt das Gerät** (UUIDv4/v7). Nur so ist Nachliefern nach Timeout ohne
Dubletten möglich — der Pi weiß nach einem abgebrochenen Request nicht, ob der Server
ihn verarbeitet hat, und darf ihn deshalb gefahrlos wiederholen.
- Die **Dauer kommt fertig vom Gerät**, der Server rechnet keine Differenz aus Wanduhr-
Zeitstempeln (Begründung §3.6c).
- `startnummer_gemeldet` ist ein **Hinweis, kein Fremdschlüssel**. Der Server löst sie
gegen die Startliste auf; scheitert das, wird die Messung als `unzugeordnet`
gespeichert und im Frontend zur Zuordnung angeboten — **nie verworfen**.
- Plausibilitätsgrenzen (min/max Fahrzeit je Klasse) sind konfigurierbar; Verstöße
werden **markiert**, nicht abgelehnt.
- Der Geräte-Token ist **nicht** der Auswerter-Login und einzeln sperrbar.
### 6.3 Read — `GET /api/v1/…` (öffentlich, ohne Key)
```
GET /api/v1/veranstaltungen?saison=2026
GET /api/v1/turniere/{id}/ergebnisse?wertungsklasse=J3
GET /api/v1/fahrer?q=bernius&verein=OAMC+Reinheim
GET /api/v1/fahrer/{id}/historie
GET /api/v1/meisterschaften/{id}/stand
GET /api/v1/meisterschaften/{id}/endlauf-qualifikation
```
Zusätzlich **iCal** (`/termine.ics`) für den Terminkalender und **CSV-Export** je Liste.
### 6.4 Fahrer-Matching beim Import
Der heikelste Teil des Imports. Aus den Altdaten sichtbar: Namen mit Sonderzeichen
(*Gál-Szász*), Vereinsangaben mal als „OAMC Reinheim", mal als „Hainstadt" (Ortsname
statt Clubname), Namensgleichheiten in Familien (*Gál-Szász Péter* / *Máté* / *János*;
*Bernius Meik* / *Jörg*; *Krack Robin* / *Luca*; *Tinz Xenia* / *Enrique*).
Vorgehen:
1. Exakter Match auf (Nachname, Vorname, Geburtsjahr) — normalisiert (Unicode NFKD,
Kleinschreibung, Bindestriche)
2. Unscharfer Match (Levenshtein / `pg_trgm`) → **Vorschlag**, nie automatisch
3. Kein Match → neuer Fahrer wird angelegt, aber im Import-Report als „NEU" markiert
4. **Merge-Funktion** im Admin, um nachträglich erkannte Dubletten zusammenzuführen
---
## 7. Seiten (Frontend)
**Öffentlich:**
| Seite | Inhalt |
|---|---|
| Startseite Motorrad-Turnier | nächster Termin, letzte Ergebnisse, aktueller Meisterschaftsstand |
| **Termine** | Saisonkalender, mit/ohne Meisterschaftswertung, Ausrichter, iCal-Abo |
| **Ergebnisse** | je Veranstaltung → Turnier → Wertungsklasse, sortierbar, mobil lesbar |
| **Live** (Turniertag) | vorläufiger Stand, sobald Zeiten eintreffen — deutlich als *vorläufig* gekennzeichnet, solange Fehlerpunkte fehlen (§3.6) |
| **Fahrer** | durchsuchbare Liste (löst die „BAUSTELLE" ab) |
| **Fahrerprofil** | Stammdaten, alle Starts, Platzierungen, Bestzeiten, Saisonverlauf |
| **Meisterschaft** | HTH-Stand Erwachsene + Jugend J 1–J 5, inkl. Streichresultat-Kennzeichnung |
| **Endlauf-Qualifikation** | aktueller Stand der Top-10-Plätze |
| Sportbeschreibung / Ausschreibung / Downloads | bestehende Inhalte, sauber übernommen |
**Intern (Login):**
| Seite | Inhalt |
|---|---|
| Nennungsannahme | Fahrer suchen/anlegen, Klasse automatisch aus Jahrgang vorschlagen, Startnummer vergeben, Nenngeld quittieren |
| Ergebniserfassung | schnelle Eingabe Zeit/Fehler je Startnummer, tastaturoptimiert |
| Auswertung | Wertungsklassen bilden, rechnen, vorläufig/final setzen |
| Korrekturen | mit Begründung, mit Historie |
| Exporte | Ergebnisliste (PDF, ADAC-Layout), Schlussbericht, Nennliste, CSV |
| **Messungen zuordnen** | unzugeordnete/unplausible Lichtschranken-Messungen einem Start zuweisen oder mit Grund verwerfen |
| **Geräte** | Mess-Pi-Status (Heartbeat, Queue-Länge), Token vergeben/sperren, Entprellzeit und Messpunkte konfigurieren |
| Import-Monitor | Import-Jobs, Warnungen, Fahrer-Dubletten mergen |
| Stammdaten | Saison, Klassen, Vereine, Punktetabelle, Benutzer |
**Anzeige am Parcours** (eigener, minimaler Modus für den Mess-Pi):
| Seite | Inhalt |
|---|---|
| `/anzeige` | aktueller Starter groß (Nr., Name, Klasse, Fahrzeug), laufende/letzte Zeit, nächste Starter; SSE-Update; Kiosk-tauglich; **behält bei Verbindungsverlust die letzte Startliste** und zeigt den Offline-Zustand deutlich an |
**Anforderungen quer:** responsiv (am Platz wird das Handy benutzt) · Deep-Links auf jede
Ergebnisliste · druckbare Ansichten · Aushang-/Beamer-Modus (große Schrift,
Autorefresh) · barrierearm (Kontrast, Tabellen-Semantik)
---
## 8. Arbeitspakete
### AP 0 — Klärung & Setup *(vor allem anderen)*
- Offene Fragen §10 mit dem Verein / Bereichsleiter klären
- **ADAC-Turnierordnung 2026 (`MT-D2025.pdf`) beschaffen und Wertungsregeln verifizieren**
- Punktetabelle Meisterschaft beschaffen
- `git` installieren, Repository anlegen, Python-venv, Projektgerüst
- Zugriff auf die Excel-Vorlagen und ein paar echte Nennlisten
### AP 1 — Datenmodell & Migrationen
- SQLAlchemy-Modelle + Alembic-Initialmigration
- Stammdaten-Seed: Saison 2026, Klassen J 1–J 5, S/A-Klassen, Vereine
- Unit-Tests auf Constraints (Mehrfachstart erlaubt, Startnummer eindeutig je Turnier)
### AP 2 — Wertungs-Engine *(der Kern — zuerst und mit Tests)*
- Regelstrategien je Kategorie (Jugend: Fehler → Zeit; Erwachsene: Zeit + Fehler)
- Platzierung inkl. Gleichstandsauflösung, DNF/DNS/DSQ-Behandlung
- **Regressionstest gegen die reale Ergebnisliste vom 31.05.2026** — alle 13 Wertungs-
blöcke müssen exakt die publizierten Platzierungen reproduzieren. Das ist der
Abnahmetest für die Engine.
### AP 3 — Meisterschaftsberechnung
- Punktevergabe, Streichresultate nach Tabelle §3.4
- Tie-Break „Majorität der Siege"
- Endlauf-Qualifikationsvorschlag Top 10 / Top 10 Jugend
- Nachrechnen gegen einen veröffentlichten HTH-Jahresstand als Test
### AP 4 — API
- Read-Endpunkte + OpenAPI-Doku
- Ingest-Endpunkte, Idempotenz, `dry_run`, API-Key-Auth, Rate-Limit
- Import-Job-Protokollierung
- Fahrer-Matching inkl. Merge
### AP 5 — Zeitmessung: Geräte-API & Mess-Pi
- Geräte-Registrierung, Token, Heartbeat, zentrale Konfiguration
- `POST /zeitmessungen` mit Batch, Idempotenz, Einzelquittung, Plausibilitätsprüfung
- Auflösung `startnummer_gemeldet` → Start; unzugeordnete Messungen im Frontend behandeln
- **Client auf dem Mess-Pi:** GPIO-Trigger, Entprellung, monotone Zeitmessung, lokale
SQLite-Queue, Retry mit Backoff, Kiosk-Anzeige mit Offline-Rückfall
- SSE-Endpunkt und `/anzeige`-Seite
- **Abnahmetest:** Netzstecker während der Messung ziehen — nach Wiederverbindung müssen
alle Messungen genau einmal in der DB stehen. Ebenso: Batch doppelt senden → keine Dubletten.
- **Kalibrierung:** gemessene Zeiten gegen eine Handstoppung/Referenz vergleichen, bevor
produktiv damit gewertet wird
### AP 6 — Öffentliches Frontend
- Layout, Navigation, responsive Tabellen
- Termine, Ergebnisse, Fahrerliste, Fahrerprofil, Meisterschaft
- iCal, CSV, Druckansichten
### AP 7 — Internes Frontend
- Login/Rollen, Nennungsannahme, Ergebniserfassung, Auswertung, Korrekturen
- Exporte (PDF-Ergebnisliste im ADAC-Layout, Schlussbericht)
### AP 8 — Datenübernahme Altbestand
- Import der PDF-Ergebnisse ab einem zu definierenden Jahr
(⚠️ die PDFs nutzen Subset-Fonts mit eigener Kodierung — reine Textextraktion schlägt
bei den Meisterschafts-PDFs fehl; realistisch ist ein **halbautomatischer** Import mit
manueller Nacharbeit, ggf. direkt aus den Excel-Originalen statt aus den PDFs)
- Vereinheitlichung Vereinsnamen, Dublettenbereinigung Fahrer
### AP 9 — Deployment & Betrieb
- systemd-Unit, nginx-vHost, TLS
- Backup-Automatik + **getesteter Restore**
- Monitoring, Logrotation
- Einweisung der Auswerter, Kurzanleitung
### AP 10 — Pilotbetrieb
- Eine Veranstaltung **parallel** zu Excel auswerten und Ergebnisse vergleichen
- **Zeitmessung zunächst nur mitlaufen lassen**, nicht werten: Lichtschranken-Zeit gegen
die manuell gestoppte Zeit stellen. Erst wenn beide über eine ganze Veranstaltung
übereinstimmen, wird die Messung wertungsrelevant.
- Erst nach fehlerfreiem Parallellauf umstellen
---
## 9. Ausbaustufen nach dem Kern
- **Online-Voranmeldung** — die Rahmenausschreibung wünscht ausdrücklich Voranmeldung
größerer Teilnehmergruppen und eine Anmeldeliste; das ist die naheliegendste Erweiterung
- **Aufgaben-Einzelwertung** (Tabellen aus §4 bereits vorgesehen) → „woran verliere ich Zeit?"
- Bildarchiv mit Verknüpfung Foto ↔ Fahrer ↔ Veranstaltung
- Automatische Meldung von Schlussbericht/Ergebnisliste an den ADAC
- Mehrmandantenfähigkeit für andere Ortsclubs (MSC Schotten, MSC Hainstadt, PMS Kassel …)
- Übernahme der übrigen oamc.de-Rubriken aus dem Frameset
---
## 10. Offene Fragen
| # | Frage | Warum blockierend |
|---|---|---|
| **O-1** | **Punktetabelle der Meisterschaft** (Platz → Punkte) | AP 3 nicht baubar |
| **O-2** | Zuordnung `S 1`–`S 9` und `A 1`–`A 4` → Fahrzeugtyp/Hubraum/kW | Stammdaten-Seed |
| **O-3** | Zählen **A-Fahrer** zur Meisterschaft? Die Rahmenausschreibung sagt „Gesamtklassement der A- und S-Fahrer/innen", die Spalte `Kategorie` ist bei A-Fahrern in der Ergebnisliste jedoch **leer** (bei S steht „S", bei Jugend „J") | AP 3 |
| **O-4** | Gilt die Jugend-Wertung (nur Fehler) auch beim Bundesendlauf, oder dort Zeit+Fehler? | AP 2 |
| **O-5** | Behandlung von DNF / DNS / Disqualifikation in Tages- und Jahreswertung | AP 2/3 |
| ~~O-6~~ | ~~Wer soll die API bespielen?~~ → **beantwortet:** ein zweiter Raspberry Pi an der Lichtschranke, der Zeiten sendet und Starter-/Fahrzeugdaten anzeigt (§3.6) | erledigt |
| **O-7** | **Ist am ADAC-Platz ein verlässliches Netz?** Wenn nein: muss der Anwendungs-Pi mit vor Ort? WLAN, LTE oder Kabel zwischen Mess-Pi und Server? | **hoch** — bestimmt die gesamte Betriebsarchitektur (§5.3) |
| **O-8** | Ab welchem Jahr sollen Altdaten übernommen werden (PDFs reichen bis 2002 zurück)? | Aufwand AP 8 |
| **O-9** | Wo wird gehostet — dieser Raspberry Pi, ein Server beim Verein, Webhosting? | AP 9, Erreichbarkeit |
| **O-10** | Verhältnis zur bestehenden oamc.de: Unterseite, Subdomain (z. B. `mt.oamc.de`) oder Ablösung? | Navigation, DNS |
| **O-11** | Wer bekommt Schreibrechte, wie viele Auswerter, gemeinsamer Account oder je Person? | AP 7 |
| **O-12** | Liegen die Excel-Originale der Altveranstaltungen noch vor? | macht AP 8 um ein Vielfaches einfacher |
### Neue Fragen zur Zeitmessung
| # | Frage | Warum blockierend |
|---|---|---|
| **O-13** | Was misst die Lichtschranke genau? **Eine** Gesamtdurchfahrt, **mehrere Durchgänge** oder einzelne Abschnitte (Langsamfahrstrecke …)? Woraus setzt sich `Summe Zeit` zusammen? | bestimmt `zeitmessung.messpunkt` und die Summenbildung; AP 5 |
| **O-14** | **Woher weiß der Mess-Pi, wer gerade fährt?** Startnummer manuell eintippen, Warteschlange „nächster Starter" aus der Nennliste, Transponder/RFID? | kritischster Punkt der Zuordnung; AP 5 |
| **O-15** | Was genau soll die **Anzeige** zeigen und auf welcher Hardware (HDMI-Monitor, kleines Display, LED-Tafel)? Für wen — Fahrer, Publikum, Wertungspersonal? | Gestaltung `/anzeige`; AP 5 |
| **O-16** | Geforderte **Messgenauigkeit**? Die Listen führen 1/100 s. Reicht Userspace-GPIO oder braucht es dedizierte Hardware? Ein oder zwei Lichtschranken (Start **und** Ziel)? | Hardware-Auswahl, AP 5 |
| **O-17** | **Wie kommen die Fehlerpunkte in die Anwendung** — Zettel vom Wertungspersonal und zentrale Eingabe, oder Tablets im Parcours? | AP 7; Phase 2 könnte hier ansetzen |
| **O-18** | Löst die Lichtschranke **automatisch** aus (Fahrzeug unterbricht Strahl) oder gibt es zusätzlich einen manuellen Start-/Stopp-Taster als Rückfall? | Ausfallkonzept, AP 5 |
| **O-19** | Wer baut/betreut die **Hardware** (Lichtschranke, Verkabelung, Stromversorgung am Platz)? Existiert sie schon oder wird sie beschafft? | Terminplanung |
---
## 11. Datenschutz
**Das ist hier kein Formalpunkt.** Es werden **Namen, Geburtsjahre, Geschlecht und
Vereinszugehörigkeit von Kindern ab 7 Jahren** verarbeitet und **öffentlich im Internet
angezeigt**. Die heutige Praxis (Namen in öffentlichen PDFs) wird durch eine
durchsuchbare Datenbank mit Personenprofilen **qualitativ verändert** — aus einer
schwer auffindbaren PDF-Liste wird ein über Jahre verknüpftes Profil eines Minderjährigen.
Das ist datenschutzrechtlich eine andere Kategorie und muss vor dem Livegang geklärt sein.
Zu klären und umzusetzen:
- **Rechtsgrundlage** je Verarbeitung; Einwilligung der Erziehungsberechtigten für die
Veröffentlichung von Jugenddaten (idealerweise in Nennformular/Haftungsausschluss
aufnehmen — die Formulare werden ohnehin unterschrieben)
- **Datenminimierung öffentlich:** Geburts*jahr* statt Geburtsdatum, kein Wohnort,
keine Kontaktdaten, keine ADAC-Mitgliedsnummer
- **`robots.txt` / `noindex`** für Fahrerprofile — Ergebnislisten dürfen auffindbar sein,
Personenprofile von Minderjährigen sollten es nicht sein
- **Opt-out**: Anzeige als „Teilnehmer 12" oder Namenskürzel auf Wunsch
- **Löschkonzept / Aufbewahrungsfristen**, Auskunfts- und Berichtigungsrecht
- **Verzeichnis von Verarbeitungstätigkeiten**, TOMs (Backup-Verschlüsselung, TLS,
Zugriffsrollen, Protokollierung)
- Ggf. **Auftragsverarbeitung** mit dem Hoster
> Empfehlung: Vor AP 6 (öffentliches Frontend) eine Entscheidung des Vorstands
> herbeiführen, wie Jugenddaten öffentlich dargestellt werden. Die technische Umsetzung
> ist einfach — die Entscheidung ist es nicht, und sie nachträglich zu ändern bedeutet,
> bereits indexierte Seiten wieder einzufangen.
---
## 12. Risiken
| Risiko | Auswirkung | Gegenmaßnahme |
|---|---|---|
| Wertungsregeln in §3.3 sind aus PDFs **abgeleitet**, nicht bestätigt | falsche Platzierungen, Vertrauensverlust | AP 0: Turnierordnung beschaffen; AP 2: Regressionstest gegen echte Listen; AP 10: Parallellauf |
| Ausfall am Turniertag (Pi, Netz, Strom) | Veranstaltung blockiert | Excel-Fallback bereithalten, bis der Parallellauf sauber ist; Export vor Ort möglich halten |
| **Lichtschranke fällt aus oder misst falsch** | Zeiten des laufenden Turniers fehlen — **nicht nachholbar**, die Fahrt ist vorbei | manuelle Zeitnahme als Rückfall **immer** parallel bereithalten; manuelle Nacherfassung im Frontend; Plausibilitätsprüfung serverseitig; AP 10 misst zunächst nur mit |
| **Fehlauslösung** durch Zuschauer/Helfer/rangierendes Motorrad | falsche Zeit im Ergebnis | Entprellung auf dem Pi, Verwerfen-Funktion mit Grund, Plausibilitätsgrenzen, Vier-Augen-Prinzip vor „final" |
| **Messung dem falschen Fahrer zugeordnet** | zwei Ergebnisse gleichzeitig falsch, schwer zu bemerken | Zuordnung (O-14) früh und sauber klären; Anzeige am Parcours macht die Zuordnung für alle sichtbar → Fehler fällt sofort auf |
| Netzausfall zwischen Mess-Pi und Server | Messungen gehen verloren | lokale Queue + Idempotenz (§3.6c); Abnahmetest in AP 5 zieht bewusst den Netzstecker |
| Altdaten-Import aus PDFs scheitert an Font-Kodierung | AP 8 wird teuer | Excel-Originale beschaffen (O-12); Import zeitlich begrenzen; notfalls Start ab 2026 |
| Fahrer-Dubletten durch Namensvarianten | falsche Meisterschaftsstände | Matching + Merge-Werkzeug in AP 4, Import-Report mit „NEU"-Markierung |
| Datenschutzthema Jugenddaten wird spät geklärt | Livegang verzögert oder Rückbau | §11 vor AP 6 entscheiden |
| Projekt hängt an einer Person | keine Wartung | Doku, sauberes Repo, zweite eingewiesene Person |
| Raspberry Pi: SD-Karte/Speicherausfall | Datenverlust | Backup extern + Restore testen, SSD statt SD-Karte erwägen; auf dem Mess-Pi read-only Root-FS erwägen |
| Scope-Ausweitung (Online-Nennung, Bildarchiv …) | Kern wird nie fertig | §9 ist bewusst *nach* dem Kern; AP 10 ist der Zielpunkt |
---
## 13. Nächster Schritt
1. Diesen Plan im Verein durchgehen, insbesondere **§10 (offene Fragen)** und
**§11 (Datenschutz)**
2. **ADAC-Turnierordnung 2026 und Punktetabelle beschaffen** — ohne die stehen AP 2 und AP 3
3. **Zeitmessung klären: O-13 (was wird gemessen), O-14 (Zuordnung zum Fahrer),
O-16 (Genauigkeit/Hardware), O-19 (wer baut sie)** — davon hängt AP 5 komplett ab
4. Entscheidung zu **O-7** (Netz am Platz) und **O-9/O-10** (Hosting, Domain)
5. Danach AP 0 → AP 1 → AP 2
> **Reihenfolge-Hinweis:** Die Zeitmessung ist das sichtbarste, aber nicht das erste
> Arbeitspaket. Sie liefert nur die Hälfte eines Ergebnisses (§3.6) und braucht Turnier,
> Startliste und Wertungslogik als Unterbau. AP 1–3 zuerst, dann AP 5 — sonst hat der
> Mess-Pi nichts, wogegen er Startnummern auflösen könnte.
---
### Quellen
- `www.oamc.de` — Startseite, Navigation, Rubrik Motorradgruppe (`m/m1.htm`, `m/m2.htm`,
`m/m-sportbeschreibung.htm`), Downloadseite `d/d-mot-turnier.htm`
- `www.oamc.de/datei/2026-05-31-MT-REIN-HAIN.PDF` — Tagesergebnis Doppelturnier
MSC Hainstadt / OAMC Reinheim, 13 Wertungsblöcke; Grundlage für §3.3
- `www.oamc.de/datei/MT-Rahmenausschreibung-2026.pdf` (Stand 1.2.2026) — Nenngeld,
Nennschluss, Streichresultate, Jugend-Klasseneinteilung, Endlaufqualifikation
- Systemprüfung auf dem Zielgerät (Raspberry Pi 4B) für §5.1
pyproject.toml
+72
View File
@@ -0,0 +1,72 @@
[project]
name = "oamc-turnier"
version = "0.1.0"
description = "OAMC Reinheim — Auswertung von ADAC Motorrad-Turnieren (Ergebnisse, Zeitmessung, Meisterschaft)"
readme = "README.md"
requires-python = ">=3.11"
license = { text = "Proprietär — OAMC Reinheim e.V. im ADAC" }
authors = [{ name = "OAMC Reinheim e.V." }]
dependencies = [
"fastapi>=0.115",
"uvicorn[standard]>=0.30",
"sqlalchemy>=2.0.30",
"alembic>=1.13",
"pydantic>=2.7",
"pydantic-settings>=2.2",
"psycopg[binary]>=3.2",
"jinja2>=3.1",
"python-multipart>=0.0.9",
"bcrypt>=4.1",
"pyjwt>=2.8",
"openpyxl>=3.1",
"python-dateutil>=2.9",
"sse-starlette>=2.1",
]
[project.optional-dependencies]
# WeasyPrint zieht native Abhängigkeiten (pango, cairo). Auf dem Pi separat via apt.
pdf = ["weasyprint>=62"]
dev = [
"pytest>=8.2",
"pytest-asyncio>=0.23",
"httpx>=0.27",
"ruff>=0.5",
"mypy>=1.10",
"types-python-dateutil",
]
[project.scripts]
oamc-turnier = "oamc.cli:main"
[build-system]
requires = ["setuptools>=68", "wheel"]
build-backend = "setuptools.build_meta"
[tool.setuptools.packages.find]
where = ["src"]
[tool.setuptools.package-data]
oamc = ["templates/**/*", "static/**/*", "seeds/data/*"]
[tool.pytest.ini_options]
testpaths = ["tests"]
asyncio_mode = "auto"
filterwarnings = [
"error::DeprecationWarning:oamc.*",
"ignore::DeprecationWarning:starlette.*",
"ignore::DeprecationWarning:httpx.*",
"ignore:Using `httpx`:UserWarning",
]
[tool.ruff]
line-length = 100
target-version = "py311"
[tool.ruff.lint]
select = ["E", "F", "I", "UP", "B", "SIM"]
[tool.mypy]
python_version = "3.11"
plugins = ["pydantic.mypy"]
warn_unused_ignores = true
src/oamc/__init__.py
+6
View File
@@ -0,0 +1,6 @@
"""OAMC Reinheim — Auswertung von ADAC Motorrad-Turnieren.
Fachliche Grundlagen und Architektur: siehe ``plan.md`` im Projektwurzelverzeichnis.
"""
__version__ = "0.1.0"
src/oamc/api/__init__.py
+1
View File
@@ -0,0 +1 @@
"""HTTP-API (FastAPI). Zwei Richtungen: Ingest (rein) und Read (raus). Plan §6."""
src/oamc/api/v1/__init__.py
+15
View File
@@ -0,0 +1,15 @@
"""Zusammenbau der API v1."""
from fastapi import APIRouter
from oamc.api.v1 import admin, geraete, ingest, read
api_v1 = APIRouter()
api_v1.include_router(read.router)
api_v1.include_router(ingest.router)
api_v1.include_router(geraete.router)
api_v1.include_router(geraete.turnier_router)
api_v1.include_router(geraete.messung_router)
api_v1.include_router(admin.router)
__all__ = ["api_v1"]
src/oamc/api/v1/admin.py
+210
View File
@@ -0,0 +1,210 @@
"""Interne Admin-/Auswerter-API (Session-Auth). AP 4/5/7.
Geraete-Verwaltung, Zuordnung unzugeordneter Messungen, Meisterschaftsberechnung
mit Persistierung, Fahrer-Merge, Import-Monitor.
"""
from __future__ import annotations
from datetime import UTC, datetime
from fastapi import APIRouter, HTTPException
from pydantic import BaseModel, Field
from sqlalchemy import select
from oamc.matching.fahrer import fahrer_zusammenfuehren
from oamc.meisterschaft.berechnung import berechne_stand
from oamc.models import (
Geraet,
ImportJob,
MeisterschaftStand,
Start,
Zeitmessung,
)
from oamc.models.enums import GeraetTyp, ZeitmessungStatus
from oamc.security.deps import Admin, Auswerter, DbDep
from oamc.security.tokens import erzeuge_geraete_token
from oamc.wertung.service import turnier_auswerten
router = APIRouter(prefix="/api/v1/admin", tags=["admin"])
class GeraetCreate(BaseModel):
bezeichnung: str
typ: GeraetTyp = GeraetTyp.LICHTSCHRANKE
konfiguration: dict = Field(default_factory=dict)
@router.post("/geraete", status_code=201)
def geraet_anlegen(db: DbDep, _admin: Admin, daten: GeraetCreate):
if db.scalars(select(Geraet).where(Geraet.bezeichnung == daten.bezeichnung)).first():
raise HTTPException(409, "Bezeichnung bereits vergeben")
roh, token_hash = erzeuge_geraete_token()
g = Geraet(
bezeichnung=daten.bezeichnung,
typ=daten.typ,
token_hash=token_hash,
konfiguration=daten.konfiguration,
)
db.add(g)
db.flush()
# Klartext-Token wird NUR hier ein einziges Mal ausgegeben.
return {"id": g.id, "bezeichnung": g.bezeichnung, "token": roh}
@router.post("/geraete/{geraet_id}/token")
def geraet_token_neu(db: DbDep, _admin: Admin, geraet_id: int):
g = db.get(Geraet, geraet_id)
if g is None:
raise HTTPException(404, "Geraet nicht gefunden")
roh, token_hash = erzeuge_geraete_token()
g.token_hash = token_hash
return {"id": g.id, "token": roh}
@router.post("/geraete/{geraet_id}/sperren")
def geraet_sperren(db: DbDep, _admin: Admin, geraet_id: int):
g = db.get(Geraet, geraet_id)
if g is None:
raise HTTPException(404, "Geraet nicht gefunden")
g.aktiv = False
return {"id": g.id, "aktiv": g.aktiv}
@router.get("/geraete")
def geraete_liste(db: DbDep, _auswerter: Auswerter):
jetzt = datetime.now(UTC)
out = []
for g in db.scalars(select(Geraet)):
alter_s = (jetzt - g.letzte_meldung_am).total_seconds() if g.letzte_meldung_am else None
out.append(
{
"id": g.id,
"bezeichnung": g.bezeichnung,
"typ": g.typ.value,
"aktiv": g.aktiv,
"letzte_meldung_am": g.letzte_meldung_am.isoformat() if g.letzte_meldung_am else None,
"sekunden_seit_meldung": round(alter_s) if alter_s is not None else None,
"lebt": alter_s is not None and alter_s < 60,
"queue_laenge_gemeldet": g.queue_laenge_gemeldet,
"firmware_version": g.firmware_version,
}
)
return out
@router.get("/zeitmessungen/offen")
def offene_messungen(db: DbDep, _auswerter: Auswerter, turnier_id: int | None = None):
stmt = select(Zeitmessung).where(
Zeitmessung.status.in_([ZeitmessungStatus.UNZUGEORDNET, ZeitmessungStatus.UNPLAUSIBEL])
)
if turnier_id:
stmt = stmt.where(Zeitmessung.turnier_id == turnier_id)
return [
{
"id": str(m.id),
"turnier_id": m.turnier_id,
"startnummer_gemeldet": m.startnummer_gemeldet,
"messpunkt": m.messpunkt,
"dauer_sekunden": float(m.dauer_sekunden),
"status": m.status.value,
"gemessen_am": m.gemessen_am.isoformat(),
}
for m in db.scalars(stmt.order_by(Zeitmessung.gemessen_am))
]
class ZuordnenEin(BaseModel):
startnummer: int
@router.post("/zeitmessungen/{messung_id}/zuordnen")
def messung_zuordnen(db: DbDep, _auswerter: Auswerter, messung_id: str, daten: ZuordnenEin):
m = db.get(Zeitmessung, messung_id)
if m is None:
raise HTTPException(404, "Messung nicht gefunden")
start = db.scalars(
select(Start).where(
Start.turnier_id == m.turnier_id, Start.startnummer == daten.startnummer
)
).first()
if start is None:
raise HTTPException(404, f"Kein Start mit Nr. {daten.startnummer} im Turnier {m.turnier_id}")
m.start_id = start.id
m.startnummer_gemeldet = daten.startnummer
if m.status == ZeitmessungStatus.UNZUGEORDNET:
m.status = ZeitmessungStatus.GUELTIG
return {"id": str(m.id), "start_id": start.id, "status": m.status.value}
class MergeEin(BaseModel):
ziel_fahrer_id: int
quelle_fahrer_id: int
@router.post("/fahrer/merge")
def fahrer_merge(db: DbDep, _admin: Admin, daten: MergeEin):
try:
anzahl = fahrer_zusammenfuehren(db, daten.ziel_fahrer_id, daten.quelle_fahrer_id)
except ValueError as exc:
raise HTTPException(400, str(exc)) from exc
return {"umgehaengte_starts": anzahl, "ziel_fahrer_id": daten.ziel_fahrer_id}
@router.get("/import-jobs")
def import_jobs(db: DbDep, _auswerter: Auswerter, limit: int = 50):
return [
{
"id": j.id,
"quelle": j.quelle,
"idempotenz_schluessel": j.idempotenz_schluessel,
"status": j.status.value,
"angelegt_am": j.angelegt_am.isoformat(),
"warnungen": (j.ergebnis_bericht or {}).get("warnungen", []),
}
for j in db.scalars(
select(ImportJob).order_by(ImportJob.angelegt_am.desc()).limit(limit)
)
]
@router.post("/meisterschaften/{meisterschaft_id}/berechnen")
def meisterschaft_berechnen(db: DbDep, _auswerter: Auswerter, meisterschaft_id: int):
"""Stand neu berechnen und materialisieren (``meisterschaft_stand``)."""
bericht = berechne_stand(db, meisterschaft_id)
db.query(MeisterschaftStand).filter(
MeisterschaftStand.meisterschaft_id == meisterschaft_id
).delete()
for z in bericht.zeilen:
db.add(
MeisterschaftStand(
meisterschaft_id=meisterschaft_id,
fahrer_id=z.fahrer_id,
punkte_gesamt=z.punkte_gesamt,
punkte_je_lauf={str(k): float(v) for k, v in z.punkte_je_lauf.items()},
gestrichene_laeufe=z.gestrichene_laeufe,
anzahl_siege=z.anzahl_siege,
platz=z.platz,
)
)
return {
"meisterschaft_id": meisterschaft_id,
"zeilen": len(bericht.zeilen),
"hinweise": bericht.hinweise,
}
@router.post("/turniere/{turnier_id}/neu-auswerten")
def turnier_neu_auswerten(db: DbDep, _auswerter: Auswerter, turnier_id: int):
try:
bericht = turnier_auswerten(db, turnier_id, zeit_aus_messungen=True, schreiben=True)
except ValueError as exc:
raise HTTPException(404, str(exc)) from exc
return {
"turnier_id": turnier_id,
"gewertete_starts": bericht.gewertete_starts,
"vorlaeufige_starts": bericht.vorlaeufige_starts,
"wertungsklassen": bericht.wertungsklassen,
"abweichungen": [a.__dict__ for a in bericht.abweichungen],
}
src/oamc/api/v1/geraete.py
+146
View File
@@ -0,0 +1,146 @@
"""Geraete-API — Zeitmessung & Anzeige (Mess-Pi, Bearer-Token). Plan §6.2.
Eigenes Rechteprofil: schreiben NUR Messungen, lesen NUR was die Anzeige braucht.
"""
from __future__ import annotations
import asyncio
import json
import uuid
from datetime import UTC, datetime
from fastapi import APIRouter, HTTPException, Request, Response
from sqlalchemy import select
from sqlalchemy.orm import Session
from sse_starlette.sse import EventSourceResponse
from oamc.db import SessionLocal
from oamc.geraete.service import (
aktives_turnier,
geraet_konfiguration,
messung_verwerfen,
startliste_fuer_anzeige,
verarbeite_batch,
)
from oamc.models import Zeitmessung
from oamc.schemas.geraete import (
BatchAntwort,
GeraeteKonfiguration,
Heartbeat,
HeartbeatAntwort,
MessungBatch,
VerwerfenEin,
)
from oamc.security.deps import DbDep, GeraetDep
router = APIRouter(prefix="/api/v1/geraete", tags=["geraete"])
turnier_router = APIRouter(prefix="/api/v1/turniere/aktiv", tags=["geraete"])
messung_router = APIRouter(prefix="/api/v1/zeitmessungen", tags=["geraete"])
@router.post("/heartbeat", response_model=HeartbeatAntwort)
def heartbeat(db: DbDep, geraet: GeraetDep, daten: Heartbeat):
geraet.letzte_meldung_am = datetime.now(UTC)
if daten.firmware_version:
geraet.firmware_version = daten.firmware_version
geraet.queue_laenge_gemeldet = daten.queue_laenge
aktiv = aktives_turnier(db)
return HeartbeatAntwort(
geraet_id=geraet.id,
bezeichnung=geraet.bezeichnung,
server_zeit=datetime.now(UTC),
aktives_turnier_id=aktiv.id if aktiv else None,
)
@router.get("/konfiguration", response_model=GeraeteKonfiguration)
def konfiguration(db: DbDep, geraet: GeraetDep):
return GeraeteKonfiguration(**geraet_konfiguration(db, geraet))
@turnier_router.get("/startliste")
def aktive_startliste(db: DbDep, geraet: GeraetDep, response: Response):
aktiv = aktives_turnier(db)
if aktiv is None:
raise HTTPException(409, "Kein aktives Turnier gesetzt")
daten = startliste_fuer_anzeige(db, aktiv.id)
# ETag-faehig, offlinefest zwischenspeicherbar (Plan §6.2)
roh = json.dumps(daten, sort_keys=True, ensure_ascii=False)
etag = f'W/"{aktiv.id}-{len(daten)}-{abs(hash(roh)) & 0xFFFFFFFF:x}"'
response.headers["ETag"] = etag
response.headers["Cache-Control"] = "no-cache"
return {"turnier_id": aktiv.id, "turnier": aktiv.name, "starts": daten}
@messung_router.post("", response_model=BatchAntwort)
def messungen_batch(db: DbDep, geraet: GeraetDep, batch: MessungBatch):
"""Messungen (Batch, idempotent) — der Kernfall. Antwort quittiert jede
Messung einzeln (angenommen/duplikat/unzugeordnet/unplausibel)."""
return verarbeite_batch(db, geraet, batch)
@messung_router.post("/{messung_id}/verwerfen")
def messung_verwerfen_endpoint(
db: DbDep, geraet: GeraetDep, messung_id: uuid.UUID, daten: VerwerfenEin
):
try:
m = messung_verwerfen(db, messung_id, daten.grund)
except ValueError as exc:
raise HTTPException(404, str(exc)) from exc
return {"id": str(m.id), "status": m.status.value, "grund": m.verworfen_grund}
# --- SSE: Live-Anzeige am Parcours -------------------------------------
async def _anzeige_stream(request):
"""Sendet alle ~2 s den aktuellen Stand. Einseitiger Datenfluss, reconnectet
von selbst (Plan §5.2). Der Client faellt bei Verbindungsverlust auf die
zuletzt geladene Startliste zurueck (Plan §7)."""
letzte_signatur = None
while True:
if await request.is_disconnected():
break
db: Session = SessionLocal()
try:
aktiv = aktives_turnier(db)
if aktiv is None:
payload = {"aktiv": False}
else:
letzte = db.scalars(
select(Zeitmessung)
.where(Zeitmessung.turnier_id == aktiv.id)
.order_by(Zeitmessung.empfangen_am.desc())
.limit(1)
).first()
naechste = startliste_fuer_anzeige(db, aktiv.id)[:5]
payload = {
"aktiv": True,
"turnier": aktiv.name,
"letzte_messung": (
{
"startnummer": letzte.startnummer_gemeldet,
"dauer_sekunden": float(letzte.dauer_sekunden),
"status": letzte.status.value,
"empfangen_am": letzte.empfangen_am.isoformat(),
}
if letzte
else None
),
"naechste_starter": naechste,
"server_zeit": datetime.now(UTC).isoformat(),
}
finally:
db.close()
signatur = json.dumps(payload, sort_keys=True)
if signatur != letzte_signatur:
letzte_signatur = signatur
yield {"event": "anzeige", "data": json.dumps(payload, ensure_ascii=False)}
await asyncio.sleep(2)
@turnier_router.get("/anzeige")
async def anzeige_sse(request: Request):
return EventSourceResponse(_anzeige_stream(request))
src/oamc/api/v1/ingest.py
+155
View File
@@ -0,0 +1,155 @@
"""Ingest-API — POST /api/v1/... (X-API-Key). Plan §6.1.
Idempotent, zweistufig (``?dry_run=true`` -> Validierungsvorschau).
"""
from __future__ import annotations
from fastapi import APIRouter, File, Form, HTTPException, Query, UploadFile
from oamc.importer.ingest import verarbeite_ergebnisse, verarbeite_starts
from oamc.importer.xlsx import lese_ergebnisliste, lese_nennliste
from oamc.models import Turnier, Veranstaltung
from oamc.models.enums import VeranstaltungStatus
from oamc.schemas.ingest import (
ErgebnisBulk,
ImportBericht,
StartBulk,
TurnierCreate,
VeranstaltungCreate,
)
from oamc.security.deps import DbDep, IngestKey
from oamc.wertung.service import turnier_auswerten
router = APIRouter(prefix="/api/v1", tags=["ingest"], dependencies=[])
@router.post("/veranstaltungen", status_code=201)
def veranstaltung_anlegen(db: DbDep, _key: IngestKey, daten: VeranstaltungCreate):
verein = None
if daten.ausrichter_verein:
from oamc.importer.ingest import finde_verein
verein = finde_verein(db, daten.ausrichter_verein)
v = Veranstaltung(
datum=daten.datum,
titel=daten.titel,
ort=daten.ort,
ausrichter_verein_id=verein.id if verein else None,
ist_doppelturnier=daten.ist_doppelturnier,
veranstaltungsleiter=daten.veranstaltungsleiter,
turnierleiter=daten.turnierleiter,
status=VeranstaltungStatus.GEPLANT,
)
db.add(v)
db.flush()
return {"id": v.id}
@router.post("/turniere", status_code=201)
def turnier_anlegen(db: DbDep, _key: IngestKey, daten: TurnierCreate):
if db.get(Veranstaltung, daten.veranstaltung_id) is None:
raise HTTPException(404, "Veranstaltung nicht gefunden")
verein = None
if daten.veranstalter_verein:
from oamc.importer.ingest import finde_verein
verein = finde_verein(db, daten.veranstalter_verein)
t = Turnier(
veranstaltung_id=daten.veranstaltung_id,
name=daten.name,
veranstalter_verein_id=verein.id if verein else None,
zaehlt_meisterschaft=daten.zaehlt_meisterschaft,
)
db.add(t)
db.flush()
return {"id": t.id}
@router.post("/turniere/{turnier_id}/starts", response_model=ImportBericht)
def starts_bulk(
db: DbDep,
_key: IngestKey,
turnier_id: int,
payload: StartBulk,
dry_run: bool = Query(default=False),
):
try:
return verarbeite_starts(db, turnier_id, payload, dry_run=dry_run, angelegt_von="api")
except ValueError as exc:
raise HTTPException(400, str(exc)) from exc
@router.post("/turniere/{turnier_id}/ergebnisse", response_model=ImportBericht)
def ergebnisse_bulk(
db: DbDep,
_key: IngestKey,
turnier_id: int,
payload: ErgebnisBulk,
dry_run: bool = Query(default=False),
):
"""Ergebnis-Bulk-Upload — der Kernfall (Plan §6.1)."""
try:
return verarbeite_ergebnisse(
db, turnier_id, payload, dry_run=dry_run, angelegt_von="api"
)
except ValueError as exc:
raise HTTPException(400, str(exc)) from exc
@router.post("/turniere/{turnier_id}/import/xlsx", response_model=ImportBericht)
async def import_xlsx(
db: DbDep,
_key: IngestKey,
turnier_id: int,
art: str = Form(description='"nennliste" oder "ergebnisliste"'),
idempotenz_schluessel: str = Form(...),
quelle: str = Form(default="xlsx-upload"),
blatt: str | None = Form(default=None),
dry_run: bool = Query(default=True),
datei: UploadFile = File(...),
):
"""Excel-Nennliste/Ergebnisliste als Datei (Plan §6.1).
Achtung: die Spaltenzuordnung (``SPALTEN_ALIAS`` in ``oamc.importer.xlsx``) ist
an die realen ADAC-Vorlagen anzupassen (Plan O-12). Default ``dry_run=true``.
"""
roh = await datei.read()
try:
if art == "nennliste":
payload = lese_nennliste(
roh, quelle=quelle, idempotenz_schluessel=idempotenz_schluessel, blatt=blatt
)
return verarbeite_starts(db, turnier_id, payload, dry_run=dry_run, angelegt_von="xlsx")
if art == "ergebnisliste":
payload = lese_ergebnisliste(
roh, quelle=quelle, idempotenz_schluessel=idempotenz_schluessel, blatt=blatt
)
return verarbeite_ergebnisse(
db, turnier_id, payload, dry_run=dry_run, angelegt_von="xlsx"
)
except ValueError as exc:
raise HTTPException(400, str(exc)) from exc
raise HTTPException(422, 'art muss "nennliste" oder "ergebnisliste" sein')
@router.post("/turniere/{turnier_id}/finalisieren")
def turnier_finalisieren(db: DbDep, _key: IngestKey, turnier_id: int):
"""Wertung rechnen und Turnier auf ``final`` setzen. Die Meisterschaft wird
ueber die Admin-API neu berechnet (siehe /api/v1/admin)."""
t = db.get(Turnier, turnier_id)
if t is None:
raise HTTPException(404, "Turnier nicht gefunden")
bericht = turnier_auswerten(db, turnier_id, zeit_aus_messungen=True, schreiben=True)
from oamc.models.enums import TurnierStatus
t.status = TurnierStatus.FINAL
return {
"turnier_id": turnier_id,
"gewertete_starts": bericht.gewertete_starts,
"vorlaeufige_starts": bericht.vorlaeufige_starts,
"abweichungen": [a.__dict__ for a in bericht.abweichungen],
}
src/oamc/api/v1/read.py
+218
View File
@@ -0,0 +1,218 @@
"""Read-API — oeffentlich, ohne Key (Plan §6.3).
Datenminimierung (Plan §11): keine Geburtsdaten, keine Kontaktdaten, keine
ADAC-Mitgliedsnummer. Nur Geburtsjahr, und das nur wo fachlich noetig.
"""
from __future__ import annotations
from fastapi import APIRouter, HTTPException, Query
from sqlalchemy import func, or_, select
from sqlalchemy.orm import selectinload
from oamc.api.v1.serialisierung import (
ergebnis_zeile,
fahrer_kurz,
turnier_kurz,
veranstaltung_kurz,
)
from oamc.meisterschaft.berechnung import berechne_stand, endlauf_qualifikation
from oamc.models import (
Fahrer,
Meisterschaft,
Start,
Turnier,
Veranstaltung,
Verein,
)
from oamc.security.deps import DbDep
router = APIRouter(prefix="/api/v1", tags=["read"])
@router.get("/veranstaltungen")
def liste_veranstaltungen(db: DbDep, saison: int | None = Query(default=None)):
stmt = select(Veranstaltung).order_by(Veranstaltung.datum.desc())
if saison:
stmt = stmt.where(func.extract("year", Veranstaltung.datum) == saison)
return [veranstaltung_kurz(v) for v in db.scalars(stmt)]
@router.get("/veranstaltungen/{veranstaltung_id}")
def eine_veranstaltung(db: DbDep, veranstaltung_id: int):
v = db.get(Veranstaltung, veranstaltung_id)
if v is None:
raise HTTPException(404, "Veranstaltung nicht gefunden")
return {**veranstaltung_kurz(v), "turniere": [turnier_kurz(t) for t in v.turniere]}
@router.get("/turniere/{turnier_id}/ergebnisse")
def turnier_ergebnisse(db: DbDep, turnier_id: int, wertungsklasse: str | None = None):
turnier = db.get(Turnier, turnier_id)
if turnier is None:
raise HTTPException(404, "Turnier nicht gefunden")
starts = db.scalars(
select(Start)
.where(Start.turnier_id == turnier_id)
.options(
selectinload(Start.fahrer).selectinload(Fahrer.verein),
selectinload(Start.ergebnis),
selectinload(Start.klasse),
selectinload(Start.wertungsklasse),
)
).all()
gruppen: dict[str, list] = {}
for s in starts:
wk = s.wertungsklasse.bezeichnung if s.wertungsklasse else (
s.klasse.code if s.klasse else "ohne Wertungsklasse"
)
gruppen.setdefault(wk, []).append(s)
if wertungsklasse:
gruppen = {k: v for k, v in gruppen.items() if k.lower() == wertungsklasse.lower()}
result = []
for name, gruppe in sorted(gruppen.items()):
gruppe.sort(key=lambda s: (s.ergebnis.platzierung if s.ergebnis and s.ergebnis.platzierung else 9999))
result.append(
{
"wertungsklasse": name,
"vorlaeufig": turnier.status.value not in ("final",),
"zeilen": [ergebnis_zeile(s) for s in gruppe],
}
)
return {"turnier": turnier_kurz(turnier), "wertungsklassen": result}
@router.get("/fahrer")
def suche_fahrer(
db: DbDep,
q: str | None = Query(default=None, min_length=2),
verein: str | None = None,
limit: int = Query(default=50, le=200),
):
stmt = select(Fahrer).where(Fahrer.aktiv.is_(True)).options(selectinload(Fahrer.verein))
if q:
muster = f"%{q.lower()}%"
stmt = stmt.where(
or_(
func.lower(Fahrer.nachname).like(muster),
func.lower(Fahrer.vorname).like(muster),
func.lower(func.concat(Fahrer.nachname, " ", Fahrer.vorname)).like(muster),
)
)
if verein:
stmt = stmt.join(Verein, Verein.id == Fahrer.verein_id).where(
func.lower(Verein.name).like(f"%{verein.lower()}%")
)
stmt = stmt.order_by(Fahrer.nachname, Fahrer.vorname).limit(limit)
return [fahrer_kurz(f) for f in db.scalars(stmt)]
@router.get("/fahrer/{fahrer_id}")
def ein_fahrer(db: DbDep, fahrer_id: int):
f = db.get(Fahrer, fahrer_id)
if f is None or not f.aktiv:
raise HTTPException(404, "Fahrer nicht gefunden")
return fahrer_kurz(f)
@router.get("/fahrer/{fahrer_id}/historie")
def fahrer_historie(db: DbDep, fahrer_id: int):
f = db.get(Fahrer, fahrer_id)
if f is None:
raise HTTPException(404, "Fahrer nicht gefunden")
starts = db.scalars(
select(Start)
.where(Start.fahrer_id == fahrer_id)
.options(
selectinload(Start.ergebnis),
selectinload(Start.klasse),
selectinload(Start.turnier).selectinload(Turnier.veranstaltung),
)
).all()
eintraege = []
for s in sorted(starts, key=lambda s: s.turnier.veranstaltung.datum, reverse=True):
e = s.ergebnis
eintraege.append(
{
"datum": s.turnier.veranstaltung.datum.isoformat(),
"veranstaltung": s.turnier.veranstaltung.titel,
"turnier": s.turnier.name,
"klasse": s.klasse.code if s.klasse else None,
"startnummer": s.startnummer,
"summe_zeit": float(e.summe_zeit) if e and e.summe_zeit is not None else None,
"summe_fehler": e.summe_fehler if e else None,
"gesamt": float(e.gesamt) if e and e.gesamt is not None else None,
"platzierung": e.platzierung if e else None,
"status": s.status.value,
}
)
zeiten = [x["summe_zeit"] for x in eintraege if x["summe_zeit"]]
return {
"fahrer": fahrer_kurz(f),
"anzahl_starts": len(eintraege),
"bestzeit": min(zeiten) if zeiten else None,
"starts": eintraege,
}
@router.get("/meisterschaften")
def liste_meisterschaften(db: DbDep, saison: int | None = None):
stmt = select(Meisterschaft)
if saison:
stmt = stmt.where(Meisterschaft.saison_jahr == saison)
return [
{
"id": m.id,
"bezeichnung": m.bezeichnung,
"saison": m.saison_jahr,
"kategorie": m.kategorie.value,
}
for m in db.scalars(stmt)
]
@router.get("/meisterschaften/{meisterschaft_id}/stand")
def meisterschaft_stand(db: DbDep, meisterschaft_id: int):
bericht = berechne_stand(db, meisterschaft_id)
return {
"meisterschaft_id": bericht.meisterschaft_id,
"saison": bericht.saison_jahr,
"kategorie": bericht.kategorie,
"laeufe_gesamt": bericht.laeufe_gesamt,
"laeufe_gewertet": bericht.laeufe_gewertet,
"hinweise": bericht.hinweise,
"zeilen": [
{
"platz": z.platz,
"fahrer": fahrer_kurz(db.get(Fahrer, z.fahrer_id)),
"punkte_gesamt": float(z.punkte_gesamt),
"anzahl_siege": z.anzahl_siege,
"gestrichene_laeufe": z.gestrichene_laeufe,
}
for z in bericht.zeilen
],
}
@router.get("/meisterschaften/{meisterschaft_id}/endlauf-qualifikation")
def meisterschaft_quali(db: DbDep, meisterschaft_id: int, plaetze: int = 10):
vorschlaege = endlauf_qualifikation(db, meisterschaft_id, plaetze)
return {
"meisterschaft_id": meisterschaft_id,
"hinweis": "Vorschlag — die endgueltige Festlegung trifft der Bereichsleiter (Plan §3.4).",
"plaetze": plaetze,
"vorschlaege": [
{
"platz": v.platz,
"fahrer": fahrer_kurz(db.get(Fahrer, v.fahrer_id)),
"punkte": float(v.punkte),
"anzahl_siege": v.anzahl_siege,
"tie_break_relevant": v.tie_break_relevant,
}
for v in vorschlaege
],
}
src/oamc/api/v1/serialisierung.py
+67
View File
@@ -0,0 +1,67 @@
"""Gemeinsame JSON-Serialisierung fuer die Read-API und das Frontend.
Datenschutz (Plan §11): ``fahrer_kurz`` gibt nie Geburtsdatum,
ADAC-Mitgliedsnummer oder Kontaktdaten aus. Anonymisierte Fahrer erscheinen als
"Teilnehmer/in #id".
"""
from __future__ import annotations
from oamc.models import Fahrer, Start, Turnier, Veranstaltung
def fahrer_kurz(f: Fahrer | None) -> dict | None:
if f is None:
return None
if f.anzeige_anonymisiert:
return {"id": f.id, "name": f.anzeigename, "anonymisiert": True}
return {
"id": f.id,
"name": f.voller_name,
"nachname": f.nachname,
"vorname": f.vorname,
"geburtsjahr": f.geburtsjahr,
"geschlecht": f.geschlecht.value if f.geschlecht else None,
"verein": f.verein.name if f.verein else None,
"anonymisiert": False,
}
def veranstaltung_kurz(v: Veranstaltung) -> dict:
return {
"id": v.id,
"datum": v.datum.isoformat(),
"titel": v.titel,
"ort": v.ort,
"ist_doppelturnier": v.ist_doppelturnier,
"status": v.status.value,
}
def turnier_kurz(t: Turnier) -> dict:
return {
"id": t.id,
"veranstaltung_id": t.veranstaltung_id,
"name": t.name,
"zaehlt_meisterschaft": t.zaehlt_meisterschaft,
"status": t.status.value,
"ist_aktiv": t.ist_aktiv,
}
def ergebnis_zeile(s: Start) -> dict:
e = s.ergebnis
return {
"startnummer": s.startnummer,
"fahrer": fahrer_kurz(s.fahrer),
"klasse": s.klasse.code if s.klasse else None,
"fahrzeug": s.fahrzeug,
"status": s.status.value,
"summe_zeit": float(e.summe_zeit) if e and e.summe_zeit is not None else None,
"summe_fehler": e.summe_fehler if e else None,
"gesamt": float(e.gesamt) if e and e.gesamt is not None else None,
"platzierung": e.platzierung if e else None,
"zeit_vollstaendig": bool(e and e.zeit_vollstaendig),
"fehler_vollstaendig": bool(e and e.fehler_vollstaendig),
"vorlaeufig": not (e and e.zeit_vollstaendig and e.fehler_vollstaendig),
}
src/oamc/cli.py
+97
View File
@@ -0,0 +1,97 @@
"""Kommandozeile: ``oamc-turnier <befehl>``.
Befehle:
migrate Alembic-Migrationen bis head
seed Stammdaten Saison 2026 (idempotent)
benutzer-anlegen internen Benutzer anlegen
serve uvicorn im Vordergrund (Entwicklung)
"""
from __future__ import annotations
import argparse
import getpass
import subprocess
import sys
from pathlib import Path
PROJEKT_WURZEL = Path(__file__).resolve().parent.parent.parent
def _migrate() -> int:
return subprocess.call(["alembic", "upgrade", "head"], cwd=str(PROJEKT_WURZEL))
def _seed() -> int:
from oamc.db import SessionLocal
from oamc.seeds import seed_saison_2026
with SessionLocal() as db:
zaehler = seed_saison_2026(db)
db.commit()
print("Seed Saison 2026:", zaehler)
return 0
def _benutzer_anlegen(args: argparse.Namespace) -> int:
from oamc.db import SessionLocal
from oamc.models import Benutzer
from oamc.models.enums import BenutzerRolle
from oamc.security.passwoerter import hash_passwort
passwort = args.passwort or getpass.getpass("Passwort: ")
with SessionLocal() as db:
b = Benutzer(
benutzername=args.benutzername,
anzeigename=args.anzeigename or args.benutzername,
passwort_hash=hash_passwort(passwort),
rolle=BenutzerRolle(args.rolle),
)
db.add(b)
db.commit()
print(f"Benutzer {b.benutzername!r} ({b.rolle.value}) angelegt.")
return 0
def _serve(args: argparse.Namespace) -> int:
import uvicorn
uvicorn.run(
"oamc.main:app", host=args.host, port=args.port, reload=args.reload, log_level="info"
)
return 0
def main(argv: list[str] | None = None) -> int:
parser = argparse.ArgumentParser(prog="oamc-turnier")
sub = parser.add_subparsers(dest="befehl", required=True)
sub.add_parser("migrate", help="Alembic-Migrationen ausfuehren")
sub.add_parser("seed", help="Stammdaten Saison 2026 einspielen")
p_b = sub.add_parser("benutzer-anlegen", help="internen Benutzer anlegen")
p_b.add_argument("benutzername")
p_b.add_argument("--anzeigename")
p_b.add_argument("--rolle", default="auswerter", choices=["admin", "auswerter", "lesend"])
p_b.add_argument("--passwort", help="sonst interaktive Abfrage")
p_s = sub.add_parser("serve", help="uvicorn im Vordergrund")
p_s.add_argument("--host", default="127.0.0.1")
p_s.add_argument("--port", type=int, default=8000)
p_s.add_argument("--reload", action="store_true")
args = parser.parse_args(argv)
if args.befehl == "migrate":
return _migrate()
if args.befehl == "seed":
return _seed()
if args.befehl == "benutzer-anlegen":
return _benutzer_anlegen(args)
if args.befehl == "serve":
return _serve(args)
parser.print_help()
return 1
if __name__ == "__main__":
sys.exit(main())
src/oamc/config.py
+67
View File
@@ -0,0 +1,67 @@
"""Zentrale Konfiguration, aus Umgebung / .env geladen (Pydantic Settings).
Alle Felder koennen ueber Umgebungsvariablen mit Prefix ``OAMC_`` gesetzt werden,
z. B. ``OAMC_DATABASE_URL``. Siehe ``.env.example``.
"""
from __future__ import annotations
from functools import lru_cache
from pathlib import Path
from pydantic import Field, field_validator
from pydantic_settings import BaseSettings, SettingsConfigDict
class Settings(BaseSettings):
model_config = SettingsConfigDict(
env_prefix="OAMC_",
env_file=".env",
env_file_encoding="utf-8",
extra="ignore",
)
# --- Datenbank ---------------------------------------------------------
database_url: str = Field(
default="postgresql+psycopg://linus:linus@localhost:5432/oamc_dev",
description="SQLAlchemy-URL. Muss psycopg (v3) verwenden.",
)
# --- Sicherheit ------------------------------------------------------
secret_key: str = Field(default="dev-only-insecure-key-change-me-please-32b")
ingest_api_keys: str = Field(
default="dev-ingest-key",
description="Kommagetrennte API-Keys fuer die Ingest-API (POST /api/v1/...).",
)
access_token_minutes: int = 60 * 12
# --- Betrieb --------------------------------------------------------
env: str = Field(default="dev", description="dev | prod")
log_level: str = "info"
public_base_url: str = "http://localhost:8000"
upload_dir: Path = Path("./var/uploads")
# --- Zeitmessung ---------------------------------------------------
mess_min_sekunden: float = 15.0
mess_max_sekunden: float = 600.0
@field_validator("database_url")
@classmethod
def _require_psycopg(cls, v: str) -> str:
if v.startswith("postgresql://"):
# bequemer Alias -> auf den psycopg-3-Treiber normalisieren
v = v.replace("postgresql://", "postgresql+psycopg://", 1)
return v
@property
def ingest_api_key_set(self) -> set[str]:
return {k.strip() for k in self.ingest_api_keys.split(",") if k.strip()}
@property
def is_prod(self) -> bool:
return self.env.lower() in {"prod", "production"}
@lru_cache
def get_settings() -> Settings:
return Settings()
src/oamc/db.py
+34
View File
@@ -0,0 +1,34 @@
"""Datenbank-Engine, Session-Factory und FastAPI-Dependency."""
from __future__ import annotations
from collections.abc import Iterator
from sqlalchemy import create_engine
from sqlalchemy.orm import Session, sessionmaker
from oamc.config import get_settings
_settings = get_settings()
engine = create_engine(
_settings.database_url,
pool_pre_ping=True,
future=True,
echo=False,
)
SessionLocal = sessionmaker(bind=engine, autoflush=False, expire_on_commit=False, future=True)
def get_db() -> Iterator[Session]:
"""FastAPI-Dependency: eine Session pro Request, sauberer Rollback bei Fehlern."""
db = SessionLocal()
try:
yield db
db.commit()
except Exception:
db.rollback()
raise
finally:
db.close()
src/oamc/frontend/__init__.py
+9
View File
@@ -0,0 +1,9 @@
"""Serverseitig gerendertes Frontend (Jinja2 + HTMX). Plan §5.2, §7.
Ergebnislisten sind Dokumente, keine App: kein Build-Schritt, kein Node,
suchmaschinenlesbar, Deep-Links auf jede Liste.
"""
from oamc.frontend.templating import templates
__all__ = ["templates"]
src/oamc/frontend/intern.py
+157
View File
@@ -0,0 +1,157 @@
"""Interne Seiten (Login-Pflicht). AP 7."""
from __future__ import annotations
from datetime import UTC, datetime
from fastapi import APIRouter, Form, HTTPException, Request, status
from fastapi.responses import RedirectResponse
from sqlalchemy import select
from sqlalchemy.orm import selectinload
from oamc.frontend.templating import templates
from oamc.models import Benutzer, Ergebnis, Geraet, Start, Turnier, Veranstaltung, Zeitmessung
from oamc.models.enums import ZeitmessungStatus
from oamc.security.deps import BenutzerOpt, DbDep, require_auswerter
from oamc.security.passwoerter import pruefe_passwort
from oamc.security.tokens import jwt_erzeugen
router = APIRouter(prefix="/intern", tags=["intern"])
@router.get("/login")
def login_form(request: Request):
return templates.TemplateResponse(request, "intern/login.html", {"fehler": None})
@router.post("/login")
def login(request: Request, db: DbDep, benutzername: str = Form(...), passwort: str = Form(...)):
b = db.scalars(
select(Benutzer).where(Benutzer.benutzername == benutzername, Benutzer.aktiv.is_(True))
).first()
if b is None or not pruefe_passwort(passwort, b.passwort_hash):
return templates.TemplateResponse(
request, "intern/login.html", {"fehler": "Anmeldung fehlgeschlagen"}, status_code=401
)
b.letzter_login_am = datetime.now(UTC)
token = jwt_erzeugen(b.benutzername, b.rolle.value)
resp = RedirectResponse("/intern", status_code=status.HTTP_303_SEE_OTHER)
resp.set_cookie(
"oamc_session", token, httponly=True, samesite="lax", max_age=60 * 60 * 12, path="/"
)
return resp
@router.get("/logout")
def logout():
resp = RedirectResponse("/", status_code=status.HTTP_303_SEE_OTHER)
resp.delete_cookie("oamc_session", path="/")
return resp
def _benutzer_oder_login(b: Benutzer | None):
if b is None:
raise HTTPException(
status.HTTP_307_TEMPORARY_REDIRECT, headers={"Location": "/intern/login"}
)
return b
@router.get("")
def dashboard(request: Request, db: DbDep, b: BenutzerOpt):
_benutzer_oder_login(b)
veranstaltungen = db.scalars(
select(Veranstaltung).order_by(Veranstaltung.datum.desc()).limit(10)
).all()
offene = db.scalar(
select(Zeitmessung)
.where(Zeitmessung.status.in_([ZeitmessungStatus.UNZUGEORDNET, ZeitmessungStatus.UNPLAUSIBEL]))
.limit(1)
)
return templates.TemplateResponse(
request,
"intern/dashboard.html",
{"benutzer": b, "veranstaltungen": veranstaltungen, "hat_offene_messungen": offene is not None},
)
@router.get("/erfassung/{turnier_id}")
def erfassung(request: Request, db: DbDep, b: BenutzerOpt, turnier_id: int):
_benutzer_oder_login(b)
turnier = db.get(Turnier, turnier_id)
if turnier is None:
raise HTTPException(404, "Turnier nicht gefunden")
starts = db.scalars(
select(Start)
.where(Start.turnier_id == turnier_id)
.options(selectinload(Start.fahrer), selectinload(Start.ergebnis), selectinload(Start.klasse))
.order_by(Start.startnummer)
).all()
return templates.TemplateResponse(
request, "intern/erfassung.html", {"benutzer": b, "turnier": turnier, "starts": starts}
)
@router.post("/erfassung/{turnier_id}/start/{start_id}")
def erfassung_speichern(
db: DbDep,
b: BenutzerOpt,
turnier_id: int,
start_id: int,
request: Request,
summe_zeit: str = Form(default=""),
summe_fehler: str = Form(default=""),
zeit_fertig: bool = Form(default=False),
fehler_fertig: bool = Form(default=False),
):
benutzer = _benutzer_oder_login(b)
require_auswerter(benutzer)
start = db.get(Start, start_id)
if start is None or start.turnier_id != turnier_id:
raise HTTPException(404, "Start nicht gefunden")
erg = start.ergebnis or Ergebnis(start_id=start.id)
if start.ergebnis is None:
start.ergebnis = erg
db.add(erg)
if summe_zeit.strip():
erg.summe_zeit = summe_zeit.replace(",", ".")
erg.zeit_vollstaendig = zeit_fertig
if summe_fehler.strip():
erg.summe_fehler = int(summe_fehler)
erg.fehler_vollstaendig = fehler_fertig
erg.erfasst_von = benutzer.benutzername
db.flush()
return templates.TemplateResponse(
request,
"partials/erfassung_zeile.html",
{"s": start, "turnier_id": turnier_id},
)
@router.get("/messungen")
def messungen(request: Request, db: DbDep, b: BenutzerOpt):
_benutzer_oder_login(b)
offen = db.scalars(
select(Zeitmessung)
.where(
Zeitmessung.status.in_(
[ZeitmessungStatus.UNZUGEORDNET, ZeitmessungStatus.UNPLAUSIBEL]
)
)
.order_by(Zeitmessung.gemessen_am)
).all()
return templates.TemplateResponse(
request, "intern/messungen.html", {"benutzer": b, "messungen": offen}
)
@router.get("/geraete")
def geraete(request: Request, db: DbDep, b: BenutzerOpt):
_benutzer_oder_login(b)
jetzt = datetime.now(UTC)
liste = []
for g in db.scalars(select(Geraet).order_by(Geraet.bezeichnung)):
alter = (jetzt - g.letzte_meldung_am).total_seconds() if g.letzte_meldung_am else None
liste.append({"g": g, "sekunden": round(alter) if alter is not None else None,
"lebt": alter is not None and alter < 60})
return templates.TemplateResponse(request, "intern/geraete.html", {"benutzer": b, "geraete": liste})
src/oamc/frontend/public.py
+245
View File
@@ -0,0 +1,245 @@
"""Oeffentliche Seiten (ohne Login) und Exporte."""
from __future__ import annotations
import csv
import io
from datetime import date
from fastapi import APIRouter, HTTPException, Request
from fastapi.responses import PlainTextResponse, StreamingResponse
from sqlalchemy import func, or_, select
from sqlalchemy.orm import selectinload
from oamc.api.v1.serialisierung import ergebnis_zeile
from oamc.config import get_settings
from oamc.frontend.templating import templates
from oamc.meisterschaft.berechnung import berechne_stand
from oamc.models import Fahrer, Meisterschaft, Start, Turnier, Veranstaltung
from oamc.security.deps import DbDep
router = APIRouter(tags=["frontend"])
@router.get("/", include_in_schema=False)
def startseite(request: Request, db: DbDep):
heute = date.today()
naechste = db.scalars(
select(Veranstaltung)
.where(Veranstaltung.datum >= heute)
.order_by(Veranstaltung.datum)
.limit(1)
).first()
letzte = db.scalars(
select(Veranstaltung)
.where(Veranstaltung.datum < heute)
.order_by(Veranstaltung.datum.desc())
.limit(5)
).all()
meisterschaften = db.scalars(select(Meisterschaft).order_by(Meisterschaft.id)).all()
return templates.TemplateResponse(
request,
"public/start.html",
{"naechste": naechste, "letzte": letzte, "meisterschaften": meisterschaften},
)
@router.get("/termine")
def termine(request: Request, db: DbDep, saison: int | None = None):
stmt = select(Veranstaltung).order_by(Veranstaltung.datum)
if saison:
stmt = stmt.where(func.extract("year", Veranstaltung.datum) == saison)
return templates.TemplateResponse(
request, "public/termine.html", {"veranstaltungen": db.scalars(stmt).all(), "saison": saison}
)
@router.get("/termine.ics", response_class=PlainTextResponse)
def termine_ics(db: DbDep):
s = get_settings()
zeilen = [
"BEGIN:VCALENDAR",
"VERSION:2.0",
"PRODID:-//OAMC Reinheim//Turnierauswertung//DE",
"CALSCALE:GREGORIAN",
"X-WR-CALNAME:OAMC Motorrad-Turniere",
]
for v in db.scalars(select(Veranstaltung).order_by(Veranstaltung.datum)):
d = v.datum.strftime("%Y%m%d")
zeilen += [
"BEGIN:VEVENT",
f"UID:veranstaltung-{v.id}@{s.public_base_url}",
f"DTSTART;VALUE=DATE:{d}",
f"SUMMARY:{v.titel}",
f"LOCATION:{v.ort or ''}",
f"DESCRIPTION:Status {v.status.value}"
+ ("" if not v.ist_doppelturnier else " — Doppelturnier"),
"END:VEVENT",
]
zeilen.append("END:VCALENDAR")
return PlainTextResponse("\r\n".join(zeilen), media_type="text/calendar")
@router.get("/ergebnisse")
def ergebnis_uebersicht(request: Request, db: DbDep):
v = db.scalars(select(Veranstaltung).order_by(Veranstaltung.datum.desc())).all()
return templates.TemplateResponse(request, "public/ergebnisse_liste.html", {"veranstaltungen": v})
@router.get("/ergebnisse/turnier/{turnier_id}.csv")
def ergebnis_turnier_csv(db: DbDep, turnier_id: int):
daten = _turnier_ergebnis_daten(db, turnier_id)
buf = io.StringIO()
w = csv.writer(buf, delimiter=";")
w.writerow(["Wertungsklasse", "Platz", "StartNr", "Name", "Verein", "Klasse", "Zeit", "Fehler", "Gesamt"])
for wk in daten["wertungsklassen"]:
for z in wk["zeilen"]:
f = z["fahrer"] or {}
w.writerow(
[
wk["wertungsklasse"],
z["platzierung"] or "",
z["startnummer"],
f.get("name", ""),
f.get("verein", ""),
z["klasse"] or "",
z["summe_zeit"] or "",
z["summe_fehler"] if z["summe_fehler"] is not None else "",
z["gesamt"] if z["gesamt"] is not None else "",
]
)
buf.seek(0)
name = f"ergebnis-turnier-{turnier_id}.csv"
return StreamingResponse(
iter([buf.getvalue()]),
media_type="text/csv",
headers={"Content-Disposition": f'attachment; filename="{name}"'},
)
@router.get("/ergebnisse/turnier/{turnier_id}")
def ergebnis_turnier(request: Request, db: DbDep, turnier_id: int):
daten = _turnier_ergebnis_daten(db, turnier_id)
return templates.TemplateResponse(request, "public/ergebnisse_turnier.html", daten)
def _turnier_ergebnis_daten(db: DbDep, turnier_id: int) -> dict:
turnier = db.get(Turnier, turnier_id)
if turnier is None:
raise HTTPException(404, "Turnier nicht gefunden")
starts = db.scalars(
select(Start)
.where(Start.turnier_id == turnier_id)
.options(
selectinload(Start.fahrer).selectinload(Fahrer.verein),
selectinload(Start.ergebnis),
selectinload(Start.klasse),
selectinload(Start.wertungsklasse),
)
).all()
gruppen: dict[str, list] = {}
for s in starts:
key = s.wertungsklasse.bezeichnung if s.wertungsklasse else (
s.klasse.code if s.klasse else "ohne Wertungsklasse"
)
gruppen.setdefault(key, []).append(s)
wk_liste = []
for name, gruppe in sorted(gruppen.items()):
gruppe.sort(key=lambda s: (s.ergebnis.platzierung if s.ergebnis and s.ergebnis.platzierung else 9999))
wk_liste.append({"wertungsklasse": name, "zeilen": [ergebnis_zeile(s) for s in gruppe]})
return {
"turnier": turnier,
"veranstaltung": turnier.veranstaltung,
"wertungsklassen": wk_liste,
"final": turnier.status.value == "final",
}
@router.get("/fahrer")
def fahrer_liste(request: Request, db: DbDep, q: str | None = None):
stmt = (
select(Fahrer)
.where(Fahrer.aktiv.is_(True))
.options(selectinload(Fahrer.verein))
.order_by(Fahrer.nachname, Fahrer.vorname)
)
if q and len(q) >= 2:
m = f"%{q.lower()}%"
stmt = stmt.where(
or_(
func.lower(Fahrer.nachname).like(m),
func.lower(Fahrer.vorname).like(m),
)
)
fahrer = db.scalars(stmt.limit(300)).all()
tmpl = "partials/fahrer_tabelle.html" if request.headers.get("HX-Request") else "public/fahrer_liste.html"
return templates.TemplateResponse(request, tmpl, {"fahrer": fahrer, "q": q or ""})
@router.get("/fahrer/{fahrer_id}")
def fahrer_profil(request: Request, db: DbDep, fahrer_id: int):
f = db.get(Fahrer, fahrer_id)
if f is None or not f.aktiv:
raise HTTPException(404, "Fahrer nicht gefunden")
starts = db.scalars(
select(Start)
.where(Start.fahrer_id == fahrer_id)
.options(
selectinload(Start.ergebnis),
selectinload(Start.klasse),
selectinload(Start.turnier).selectinload(Turnier.veranstaltung),
)
).all()
starts.sort(key=lambda s: s.turnier.veranstaltung.datum, reverse=True)
zeiten = [
float(s.ergebnis.summe_zeit)
for s in starts
if s.ergebnis and s.ergebnis.summe_zeit is not None
]
return templates.TemplateResponse(
request,
"public/fahrer_profil.html",
{
"fahrer": f,
"starts": starts,
"bestzeit": min(zeiten) if zeiten else None,
"anzahl": len(starts),
# noindex fuer Personenprofile (Plan §11)
"noindex": True,
},
)
@router.get("/meisterschaft")
def meisterschaft_uebersicht(request: Request, db: DbDep):
ms = db.scalars(select(Meisterschaft).order_by(Meisterschaft.id)).all()
return templates.TemplateResponse(request, "public/meisterschaft_liste.html", {"meisterschaften": ms})
@router.get("/meisterschaft/{meisterschaft_id}")
def meisterschaft_detail(request: Request, db: DbDep, meisterschaft_id: int):
if db.get(Meisterschaft, meisterschaft_id) is None:
raise HTTPException(404, "Meisterschaft nicht gefunden")
bericht = berechne_stand(db, meisterschaft_id)
fahrer_map = {
f.id: f for f in db.scalars(select(Fahrer).where(Fahrer.id.in_([z.fahrer_id for z in bericht.zeilen])))
}
return templates.TemplateResponse(
request,
"public/meisterschaft_detail.html",
{"bericht": bericht, "fahrer_map": fahrer_map},
)
@router.get("/anzeige")
def anzeige(request: Request):
"""Kiosk-Anzeige am Parcours. Holt Daten per SSE, faellt bei Verbindungsverlust
auf die zuletzt geladene Startliste zurueck (localStorage)."""
return templates.TemplateResponse(request, "anzeige/anzeige.html", {})
@router.get("/robots.txt", response_class=PlainTextResponse)
def robots():
# Ergebnislisten duerfen auffindbar sein, Personenprofile Minderjaehriger nicht.
return "User-agent: *\nDisallow: /fahrer/\nDisallow: /intern/\n"
src/oamc/frontend/templating.py
+26
View File
@@ -0,0 +1,26 @@
"""Jinja2-Umgebung und Filter."""
from __future__ import annotations
from pathlib import Path
from fastapi.templating import Jinja2Templates
TEMPLATE_DIR = Path(__file__).resolve().parent.parent / "templates"
templates = Jinja2Templates(directory=str(TEMPLATE_DIR))
def _zeit(wert) -> str:
if wert is None:
return "–"
return f"{float(wert):.2f}".replace(".", ",")
def _platz(wert) -> str:
return "–" if wert is None else str(wert)
templates.env.filters["zeit"] = _zeit
templates.env.filters["platz"] = _platz
templates.env.globals["projekt"] = "OAMC Turnierauswertung"
src/oamc/geraete/__init__.py
+17
View File
@@ -0,0 +1,17 @@
"""Geraete-/Zeitmessungs-Logik (AP 5, Plan §3.6, §6.2)."""
from oamc.geraete.service import (
aktives_turnier,
geraet_konfiguration,
messung_verwerfen,
startliste_fuer_anzeige,
verarbeite_batch,
)
__all__ = [
"aktives_turnier",
"geraet_konfiguration",
"messung_verwerfen",
"startliste_fuer_anzeige",
"verarbeite_batch",
]
src/oamc/geraete/service.py
+170
View File
@@ -0,0 +1,170 @@
"""Verarbeitung von Zeitmessungen und Daten fuer die Anzeige am Parcours.
Grundsaetze (Plan §3.6):
* Idempotent ueber die vom Geraet vergebene UUID — doppelt gesendete Messungen
erzeugen keine Dubletten.
* Die Dauer kommt fertig vom Geraet; der Server rechnet keine Differenz.
* Eine Messung ohne zuordenbare Startnummer wird NICHT verworfen, sondern als
``unzugeordnet`` gespeichert.
* Plausibilitaetsverstoesse werden MARKIERT (``unplausibel``), nicht abgelehnt.
"""
from __future__ import annotations
from datetime import UTC, datetime
from decimal import Decimal
from sqlalchemy import select
from sqlalchemy.orm import Session, selectinload
from oamc.config import Settings, get_settings
from oamc.models import Geraet, Start, Turnier, Zeitmessung
from oamc.models.enums import ZeitmessungStatus
from oamc.schemas.geraete import BatchAntwort, MessungBatch, MessungQuittung
def aktives_turnier(db: Session) -> Turnier | None:
return db.scalars(select(Turnier).where(Turnier.ist_aktiv.is_(True))).first()
def geraet_konfiguration(db: Session, geraet: Geraet) -> dict:
s = get_settings()
aktiv = aktives_turnier(db)
extra = geraet.konfiguration or {}
return {
"aktives_turnier_id": aktiv.id if aktiv else None,
"entprellung_ms": int(extra.get("entprellung_ms", 300)),
"messpunkte": list(extra.get("messpunkte", ["durchgang-1"])),
"plausibilitaet_min_s": float(extra.get("plausibilitaet_min_s", s.mess_min_sekunden)),
"plausibilitaet_max_s": float(extra.get("plausibilitaet_max_s", s.mess_max_sekunden)),
"extra": {k: v for k, v in extra.items() if k not in {
"entprellung_ms", "messpunkte", "plausibilitaet_min_s", "plausibilitaet_max_s"
}},
}
def _startnummer_aufloesen(db: Session, turnier_id: int, startnummer: int | None) -> int | None:
if startnummer is None:
return None
s = db.scalars(
select(Start).where(Start.turnier_id == turnier_id, Start.startnummer == startnummer)
).first()
return s.id if s else None
def verarbeite_batch(
db: Session, geraet: Geraet, batch: MessungBatch, settings: Settings | None = None
) -> BatchAntwort:
s = settings or get_settings()
quittungen: list[MessungQuittung] = []
zaehler = {"angenommen": 0, "duplikate": 0, "unzugeordnet": 0, "unplausibel": 0}
for m in batch.messungen:
# Idempotenz: existiert die UUID schon, wird sie nur quittiert.
bestehend = db.get(Zeitmessung, m.id)
if bestehend is not None:
zaehler["duplikate"] += 1
quittungen.append(
MessungQuittung(
id=m.id, status="duplikat", start_id=bestehend.start_id,
hinweis="bereits gespeichert",
)
)
continue
turnier = db.get(Turnier, m.turnier_id)
if turnier is None:
quittungen.append(
MessungQuittung(id=m.id, status="fehler", hinweis=f"Turnier {m.turnier_id} unbekannt")
)
continue
start_id = _startnummer_aufloesen(db, m.turnier_id, m.startnummer_gemeldet)
dauer = Decimal(m.dauer_sekunden)
unplausibel = not (Decimal(str(s.mess_min_sekunden)) <= dauer <= Decimal(str(s.mess_max_sekunden)))
if unplausibel:
status = ZeitmessungStatus.UNPLAUSIBEL
zaehler["unplausibel"] += 1
hinweis = f"Dauer {dauer}s ausserhalb {s.mess_min_sekunden}-{s.mess_max_sekunden}s"
elif start_id is None:
status = ZeitmessungStatus.UNZUGEORDNET
zaehler["unzugeordnet"] += 1
hinweis = "Startnummer nicht aufloesbar — zur manuellen Zuordnung"
else:
status = ZeitmessungStatus.GUELTIG
zaehler["angenommen"] += 1
hinweis = None
jetzt = datetime.now(UTC)
nachgeliefert = m.gemessen_am < jetzt.replace(microsecond=0) and (
(jetzt - m.gemessen_am).total_seconds() > 120
)
db.add(
Zeitmessung(
id=m.id,
geraet_id=geraet.id,
turnier_id=m.turnier_id,
start_id=start_id,
startnummer_gemeldet=m.startnummer_gemeldet,
messpunkt=m.messpunkt,
dauer_sekunden=dauer,
gemessen_am=m.gemessen_am,
monotonic_ns=m.monotonic_ns,
nachgeliefert=nachgeliefert,
status=status,
verworfen_grund=None,
roh=m.roh,
)
)
db.flush()
quittungen.append(
MessungQuittung(
id=m.id,
status={
ZeitmessungStatus.GUELTIG: "angenommen",
ZeitmessungStatus.UNZUGEORDNET: "unzugeordnet",
ZeitmessungStatus.UNPLAUSIBEL: "unplausibel",
}[status],
start_id=start_id,
hinweis=hinweis,
)
)
geraet.letzte_meldung_am = datetime.now(UTC)
return BatchAntwort(
quittungen=quittungen,
angenommen=zaehler["angenommen"],
duplikate=zaehler["duplikate"],
unzugeordnet=zaehler["unzugeordnet"],
unplausibel=zaehler["unplausibel"],
)
def messung_verwerfen(db: Session, messung_id, grund: str) -> Zeitmessung:
m = db.get(Zeitmessung, messung_id)
if m is None:
raise ValueError("Messung nicht gefunden")
m.status = ZeitmessungStatus.VERWORFEN
m.verworfen_grund = grund # bleibt mit Grund gespeichert (Plan §3.6e)
db.flush()
return m
def startliste_fuer_anzeige(db: Session, turnier_id: int) -> list[dict]:
starts = db.scalars(
select(Start)
.where(Start.turnier_id == turnier_id)
.options(selectinload(Start.fahrer), selectinload(Start.klasse))
.order_by(Start.nennreihenfolge.nulls_last(), Start.startnummer)
).all()
return [
{
"startnummer": s.startnummer,
"name": s.fahrer.anzeigename if s.fahrer else "?",
"klasse": s.klasse.code if s.klasse else None,
"fahrzeug": s.fahrzeug,
"status": s.status.value,
}
for s in starts
]
src/oamc/importer/__init__.py
+15
View File
@@ -0,0 +1,15 @@
"""Import: API-Bulk-Uploads und Excel-Dateien (AP 4, AP 8)."""
from oamc.importer.ingest import (
finde_klasse,
finde_verein,
verarbeite_ergebnisse,
verarbeite_starts,
)
__all__ = [
"finde_klasse",
"finde_verein",
"verarbeite_ergebnisse",
"verarbeite_starts",
]
src/oamc/importer/ingest.py
+319
View File
@@ -0,0 +1,319 @@
"""Bulk-Ingest: Nennliste (starts) und Ergebnisse.
Regeln (Plan §6.1):
* Idempotent ueber ``idempotenz_schluessel`` (import_job).
* Zweistufig: ``dry_run=True`` liefert eine Validierungsvorschau, erst danach
wird geschrieben.
* ``gesamt_erwartet``/``platzierung_erwartet`` werden nachgerechnet, Abweichungen
als Warnung gemeldet — nie uebernommen.
* Jeder Aufruf landet mit Roh-Payload in ``import_job``.
"""
from __future__ import annotations
from sqlalchemy import func, select
from sqlalchemy.orm import Session
from oamc.matching import MatchStatus, match_oder_neu, normalisiere
from oamc.models import (
Ergebnis,
ImportJob,
Klasse,
Start,
Turnier,
Verein,
Wertungsklasse,
)
from oamc.models.enums import ImportStatus, StartStatus
from oamc.schemas.ingest import (
AbweichungInfo,
ErgebnisBulk,
FahrerMatchInfo,
ImportBericht,
StartBulk,
)
from oamc.wertung.service import turnier_auswerten
def finde_verein(db: Session, name: str | None) -> Verein | None:
if not name:
return None
n = normalisiere(name)
for v in db.scalars(select(Verein)).all():
if normalisiere(v.name) == n or (v.kurzname and normalisiere(v.kurzname) == n):
return v
# enthaltend (z. B. "Reinheim" in "OAMC Reinheim e.V. im ADAC")
for v in db.scalars(select(Verein)).all():
if n and (n in normalisiere(v.name) or n in normalisiere(v.kurzname or "")):
return v
return None
def finde_klasse(db: Session, code: str, saison_jahr: int) -> Klasse | None:
if not code:
return None
ziel = code.strip().upper().replace(" ", " ")
for k in db.scalars(select(Klasse).where(Klasse.saison_jahr == saison_jahr)).all():
if k.code.upper() == ziel or k.code.upper().replace(" ", "") == ziel.replace(" ", ""):
return k
return None
def _saison_fuer_turnier(db: Session, turnier: Turnier) -> int:
return turnier.veranstaltung.datum.year
def _idempotenz_treffer(db: Session, schluessel: str | None) -> ImportJob | None:
if not schluessel:
return None
return db.scalars(
select(ImportJob).where(
ImportJob.idempotenz_schluessel == schluessel,
ImportJob.status.in_([ImportStatus.ANGENOMMEN, ImportStatus.TEILWEISE]),
)
).first()
def _wertungsklasse(db: Session, turnier_id: int, bezeichnung: str | None) -> Wertungsklasse | None:
if not bezeichnung:
return None
wk = db.scalars(
select(Wertungsklasse).where(
Wertungsklasse.turnier_id == turnier_id,
func.lower(Wertungsklasse.bezeichnung) == bezeichnung.strip().lower(),
)
).first()
if wk is None:
wk = Wertungsklasse(turnier_id=turnier_id, bezeichnung=bezeichnung.strip(), klasse_ids=[])
db.add(wk)
db.flush()
return wk
def verarbeite_starts(
db: Session, turnier_id: int, payload: StartBulk, *, dry_run: bool, angelegt_von: str | None
) -> ImportBericht:
turnier = db.get(Turnier, turnier_id)
if turnier is None:
raise ValueError(f"Turnier {turnier_id} nicht gefunden")
saison_jahr = _saison_fuer_turnier(db, turnier)
vorhandener = _idempotenz_treffer(db, payload.idempotenz_schluessel)
if vorhandener is not None:
return ImportBericht(
import_job_id=vorhandener.id, dry_run=dry_run, idempotent_uebersprungen=True
)
bericht = ImportBericht(dry_run=dry_run)
for eintrag in payload.starts:
verein = finde_verein(db, eintrag.fahrer.verein)
match = match_oder_neu(
db,
nachname=eintrag.fahrer.nachname,
vorname=eintrag.fahrer.vorname,
geburtsjahr=eintrag.fahrer.geburtsjahr,
geschlecht=eintrag.fahrer.geschlecht,
verein_id=verein.id if verein else None,
anlegen=not dry_run,
)
bericht.fahrer_matches.append(
FahrerMatchInfo(
startnummer=eintrag.startnummer,
eingabe=f"{eintrag.fahrer.nachname} {eintrag.fahrer.vorname}",
status=match.status.value,
fahrer_id=match.fahrer.id if match.fahrer else None,
vorschlaege=[v.__dict__ for v in match.vorschlaege],
)
)
if match.status == MatchStatus.NEU:
bericht.neue_fahrer += 1
klasse = finde_klasse(db, eintrag.klasse, saison_jahr)
if klasse is None:
bericht.warnungen.append(
f"Startnr. {eintrag.startnummer}: Klasse {eintrag.klasse!r} unbekannt"
)
continue
if dry_run:
bericht.angelegt += 1
continue
wk = _wertungsklasse(db, turnier_id, eintrag.wertungsklasse)
vorhanden = db.scalars(
select(Start).where(
Start.turnier_id == turnier_id, Start.startnummer == eintrag.startnummer
)
).first()
if vorhanden is None:
db.add(
Start(
turnier_id=turnier_id,
fahrer_id=match.fahrer.id,
klasse_id=klasse.id,
wertungsklasse_id=wk.id if wk else None,
startnummer=eintrag.startnummer,
fahrzeug=eintrag.fahrzeug,
nenngeld_bezahlt=eintrag.nenngeld_bezahlt,
nennreihenfolge=eintrag.nennreihenfolge,
status=eintrag.status,
)
)
bericht.angelegt += 1
else:
vorhanden.fahrer_id = match.fahrer.id
vorhanden.klasse_id = klasse.id
vorhanden.wertungsklasse_id = wk.id if wk else vorhanden.wertungsklasse_id
vorhanden.fahrzeug = eintrag.fahrzeug or vorhanden.fahrzeug
bericht.aktualisiert += 1
if not dry_run:
job = ImportJob(
quelle=payload.quelle,
idempotenz_schluessel=payload.idempotenz_schluessel,
roh_payload=payload.model_dump(mode="json"),
ergebnis_bericht=bericht.model_dump(mode="json"),
status=ImportStatus.ANGENOMMEN,
angelegt_von=angelegt_von,
)
db.add(job)
db.flush()
bericht.import_job_id = job.id
return bericht
def verarbeite_ergebnisse(
db: Session,
turnier_id: int,
payload: ErgebnisBulk,
*,
dry_run: bool,
angelegt_von: str | None,
) -> ImportBericht:
turnier = db.get(Turnier, turnier_id)
if turnier is None:
raise ValueError(f"Turnier {turnier_id} nicht gefunden")
saison_jahr = _saison_fuer_turnier(db, turnier)
vorhandener = _idempotenz_treffer(db, payload.idempotenz_schluessel)
if vorhandener is not None:
return ImportBericht(
import_job_id=vorhandener.id, dry_run=dry_run, idempotent_uebersprungen=True
)
bericht = ImportBericht(dry_run=dry_run)
for eintrag in payload.ergebnisse:
start = db.scalars(
select(Start).where(
Start.turnier_id == turnier_id, Start.startnummer == eintrag.startnummer
)
).first()
if start is None:
if eintrag.fahrer is None or eintrag.klasse is None:
bericht.warnungen.append(
f"Startnr. {eintrag.startnummer}: kein Start und keine Fahrer-/Klassenangabe "
"zum Anlegen"
)
continue
verein = finde_verein(db, eintrag.fahrer.verein)
match = match_oder_neu(
db,
nachname=eintrag.fahrer.nachname,
vorname=eintrag.fahrer.vorname,
geburtsjahr=eintrag.fahrer.geburtsjahr,
geschlecht=eintrag.fahrer.geschlecht,
verein_id=verein.id if verein else None,
anlegen=not dry_run,
)
bericht.fahrer_matches.append(
FahrerMatchInfo(
startnummer=eintrag.startnummer,
eingabe=f"{eintrag.fahrer.nachname} {eintrag.fahrer.vorname}",
status=match.status.value,
fahrer_id=match.fahrer.id if match.fahrer else None,
vorschlaege=[v.__dict__ for v in match.vorschlaege],
)
)
if match.status == MatchStatus.NEU:
bericht.neue_fahrer += 1
klasse = finde_klasse(db, eintrag.klasse, saison_jahr)
if klasse is None:
bericht.warnungen.append(
f"Startnr. {eintrag.startnummer}: Klasse {eintrag.klasse!r} unbekannt"
)
continue
if dry_run:
bericht.angelegt += 1
continue
wk = _wertungsklasse(db, turnier_id, eintrag.wertungsklasse)
start = Start(
turnier_id=turnier_id,
fahrer_id=match.fahrer.id,
klasse_id=klasse.id,
wertungsklasse_id=wk.id if wk else None,
startnummer=eintrag.startnummer,
status=StartStatus.GESTARTET,
)
db.add(start)
db.flush()
bericht.angelegt += 1
else:
bericht.aktualisiert += 1
if eintrag.wertungsklasse and not dry_run:
wk = _wertungsklasse(db, turnier_id, eintrag.wertungsklasse)
start.wertungsklasse_id = wk.id if wk else start.wertungsklasse_id
if start.status == StartStatus.GENANNT and not dry_run:
start.status = StartStatus.GESTARTET
if dry_run:
continue
erg = start.ergebnis or Ergebnis(start_id=start.id)
if start.ergebnis is None:
start.ergebnis = erg
db.add(erg)
if eintrag.summe_zeit is not None:
erg.summe_zeit = eintrag.summe_zeit
erg.zeit_vollstaendig = eintrag.zeit_vollstaendig
if eintrag.summe_fehler is not None:
erg.summe_fehler = eintrag.summe_fehler
erg.fehler_vollstaendig = eintrag.fehler_vollstaendig
erg.erfasst_von = angelegt_von
# Erwartungswerte fuer die Nachrechnung ablegen (werden von der Engine
# gegen die Berechnung gestellt, nicht als Wahrheit uebernommen).
if eintrag.gesamt_erwartet is not None:
erg.gesamt = eintrag.gesamt_erwartet
if eintrag.platzierung_erwartet is not None:
erg.platzierung = eintrag.platzierung_erwartet
if dry_run:
db.rollback()
return bericht
# Nachrechnen + Abweichungen melden
auswertung = turnier_auswerten(db, turnier_id, zeit_aus_messungen=False, schreiben=True)
for a in auswertung.abweichungen:
bericht.abweichungen.append(
AbweichungInfo(
startnummer=a.startnummer, feld=a.feld, erwartet=a.erwartet, berechnet=a.berechnet
)
)
if auswertung.abweichungen:
bericht.warnungen.append(
f"{len(auswertung.abweichungen)} Abweichung(en) zwischen Import und Neuberechnung"
)
job = ImportJob(
quelle=payload.quelle,
idempotenz_schluessel=payload.idempotenz_schluessel,
roh_payload=payload.model_dump(mode="json"),
ergebnis_bericht=bericht.model_dump(mode="json"),
status=ImportStatus.ANGENOMMEN if not bericht.warnungen else ImportStatus.TEILWEISE,
angelegt_von=angelegt_von,
)
db.add(job)
db.flush()
bericht.import_job_id = job.id
return bericht
src/oamc/importer/xlsx.py
+146
View File
@@ -0,0 +1,146 @@
"""Excel-Import fuer Nennlisten/Ergebnislisten (AP 4 / AP 8).
Die realen ``.xlsx``-Vorlagen liegen noch nicht vor (Plan O-12). Dieser Leser
arbeitet spaltenbasiert ueber eine **konfigurierbare Kopfzeilen-Zuordnung** und
kann sowohl als Nennliste (-> StartBulk) als auch als Ergebnisliste
(-> ErgebnisBulk) interpretiert werden. Sobald die echten Vorlagen da sind, ist
nur ``SPALTEN_ALIAS`` anzupassen.
"""
from __future__ import annotations
import io
from decimal import Decimal, InvalidOperation
from openpyxl import load_workbook
from oamc.schemas.ingest import (
ErgebnisBulk,
ErgebnisEintrag,
FahrerRef,
StartBulk,
StartCreate,
)
# moegliche Kopfzeilen-Bezeichnungen -> internes Feld
SPALTEN_ALIAS: dict[str, str] = {
"start-nr.": "startnummer",
"startnr": "startnummer",
"startnummer": "startnummer",
"voller name": "voller_name",
"name": "voller_name",
"nachname": "nachname",
"vorname": "vorname",
"regionalclub": "verein",
"verein": "verein",
"club": "verein",
"klasse": "klasse",
"wertungsklasse": "wertungsklasse",
"geschlecht": "geschlecht",
"geburtsjahr": "geburtsjahr",
"jahrgang": "geburtsjahr",
"fahrzeug": "fahrzeug",
"summe zeit": "summe_zeit",
"zeit": "summe_zeit",
"summe fehler": "summe_fehler",
"fehler": "summe_fehler",
"gesamt": "gesamt_erwartet",
"platzierung": "platzierung_erwartet",
"platz": "platzierung_erwartet",
}
def _num(wert) -> Decimal | None:
if wert in (None, ""):
return None
try:
return Decimal(str(wert).replace(",", "."))
except InvalidOperation:
return None
def _int(wert) -> int | None:
d = _num(wert)
return int(d) if d is not None else None
def _split_name(zeile: dict) -> tuple[str, str]:
if zeile.get("nachname") or zeile.get("vorname"):
return str(zeile.get("nachname", "")).strip(), str(zeile.get("vorname", "")).strip()
voll = str(zeile.get("voller_name", "")).strip()
# Ergebnisliste fuehrt "Nachname Vorname" (Plan §3.3)
teile = voll.split()
if len(teile) >= 2:
return teile[0], " ".join(teile[1:])
return voll, ""
def _zeilen(daten: bytes, blatt: str | None):
wb = load_workbook(io.BytesIO(daten), read_only=True, data_only=True)
ws = wb[blatt] if blatt else wb.active
rows = ws.iter_rows(values_only=True)
kopf_roh = next(rows)
kopf = [
SPALTEN_ALIAS.get(str(c).strip().lower()) if c is not None else None for c in kopf_roh
]
for row in rows:
if row is None or all(c in (None, "") for c in row):
continue
yield {feld: row[i] for i, feld in enumerate(kopf) if feld and i < len(row)}
def lese_nennliste(daten: bytes, *, quelle: str, idempotenz_schluessel: str | None,
blatt: str | None = None) -> StartBulk:
starts: list[StartCreate] = []
for z in _zeilen(daten, blatt):
nummer = _int(z.get("startnummer"))
if nummer is None:
continue
nach, vor = _split_name(z)
starts.append(
StartCreate(
startnummer=nummer,
fahrer=FahrerRef(
nachname=nach, vorname=vor,
geburtsjahr=_int(z.get("geburtsjahr")),
verein=(str(z["verein"]).strip() if z.get("verein") else None),
),
klasse=str(z.get("klasse", "")).strip(),
wertungsklasse=(str(z["wertungsklasse"]).strip() if z.get("wertungsklasse") else None),
fahrzeug=(str(z["fahrzeug"]).strip() if z.get("fahrzeug") else None),
)
)
return StartBulk(quelle=quelle, idempotenz_schluessel=idempotenz_schluessel, starts=starts)
def lese_ergebnisliste(daten: bytes, *, quelle: str, idempotenz_schluessel: str,
blatt: str | None = None) -> ErgebnisBulk:
eintraege: list[ErgebnisEintrag] = []
for z in _zeilen(daten, blatt):
nummer = _int(z.get("startnummer"))
if nummer is None:
continue
nach, vor = _split_name(z)
zeit = _num(z.get("summe_zeit"))
fehler = _int(z.get("summe_fehler"))
if zeit is None and fehler is None:
continue
eintraege.append(
ErgebnisEintrag(
startnummer=nummer,
fahrer=FahrerRef(
nachname=nach, vorname=vor,
geburtsjahr=_int(z.get("geburtsjahr")),
verein=(str(z["verein"]).strip() if z.get("verein") else None),
),
klasse=(str(z["klasse"]).strip() if z.get("klasse") else None),
wertungsklasse=(str(z["wertungsklasse"]).strip() if z.get("wertungsklasse") else None),
summe_zeit=zeit,
summe_fehler=fehler,
gesamt_erwartet=_num(z.get("gesamt_erwartet")),
platzierung_erwartet=_int(z.get("platzierung_erwartet")),
)
)
return ErgebnisBulk(
quelle=quelle, idempotenz_schluessel=idempotenz_schluessel, ergebnisse=eintraege
)
src/oamc/main.py
+55
View File
@@ -0,0 +1,55 @@
"""FastAPI-Anwendung. Wird von uvicorn hinter nginx betrieben (Plan §5.2/§5.3)."""
from __future__ import annotations
from pathlib import Path
from fastapi import FastAPI
from fastapi.responses import JSONResponse
from fastapi.staticfiles import StaticFiles
from oamc import __version__
from oamc.api.v1 import api_v1
from oamc.config import get_settings
from oamc.frontend import intern as frontend_intern
from oamc.frontend import public as frontend_public
STATIC_DIR = Path(__file__).resolve().parent / "static"
_BESCHREIBUNG = """
Auswertung von ADAC Motorrad-Turnieren des OAMC Reinheim.
* **Read** (`GET /api/v1/...`) — oeffentlich, ohne Key
* **Ingest** (`POST /api/v1/...`) — Header `X-API-Key`
* **Geraete** (`/api/v1/geraete/...`, `/api/v1/zeitmessungen`) — `Authorization: Bearer <geraete-token>`
* **Admin** (`/api/v1/admin/...`) — interne Session
Fachliche Grundlagen: `plan.md`. Wertungsregeln sind aus PDFs abgeleitet und vor
Produktivgang gegen die ADAC-Turnierordnung 2026 zu verifizieren (Plan §10).
"""
def create_app() -> FastAPI:
settings = get_settings()
app = FastAPI(
title="OAMC Turnierauswertung",
version=__version__,
description=_BESCHREIBUNG,
docs_url="/docs",
redoc_url=None,
)
app.mount("/static", StaticFiles(directory=str(STATIC_DIR)), name="static")
app.include_router(api_v1)
app.include_router(frontend_public.router)
app.include_router(frontend_intern.router)
@app.get("/healthz", include_in_schema=False)
def healthz() -> JSONResponse:
return JSONResponse({"status": "ok", "version": __version__, "env": settings.env})
return app
app = create_app()
src/oamc/matching/__init__.py
+27
View File
@@ -0,0 +1,27 @@
"""Fahrer-Matching beim Import (Plan §6.4) — der heikelste Teil.
1. Exakter Match auf (Nachname, Vorname, Geburtsjahr), normalisiert.
2. Unscharfer Match (pg_trgm) -> Vorschlag, nie automatisch.
3. Kein Match -> neuer Fahrer, im Report als "NEU" markiert.
4. Merge-Funktion fuer nachtraeglich erkannte Dubletten: ``fahrer_zusammenfuehren``.
"""
from oamc.matching.fahrer import (
MatchErgebnis,
MatchStatus,
fahrer_zusammenfuehren,
finde_aehnliche,
finde_exakt,
match_oder_neu,
normalisiere,
)
__all__ = [
"MatchErgebnis",
"MatchStatus",
"normalisiere",
"finde_exakt",
"finde_aehnliche",
"match_oder_neu",
"fahrer_zusammenfuehren",
]
src/oamc/matching/fahrer.py
+162
View File
@@ -0,0 +1,162 @@
"""Normalisierung, exakter/unscharfer Match, Merge."""
from __future__ import annotations
import enum
import unicodedata
from dataclasses import dataclass, field
from sqlalchemy import func, select, text, update
from sqlalchemy.orm import Session
from oamc.models import Fahrer, Start
def normalisiere(wert: str | None) -> str:
"""Unicode NFKD, Kleinschreibung, Bindestriche/Mehrfach-Whitespace weg.
"Gál-Szász" -> "gal szasz". So werden Namensvarianten beim Import
zusammengefuehrt, ohne Information im Datenbestand zu verlieren.
"""
if not wert:
return ""
zerlegt = unicodedata.normalize("NFKD", wert)
ohne_akzente = "".join(c for c in zerlegt if not unicodedata.combining(c))
ersetzt = ohne_akzente.replace("-", " ").replace(".", " ")
return " ".join(ersetzt.lower().split())
class MatchStatus(str, enum.Enum):
EXAKT = "exakt"
UNSCHARF = "unscharf" # Vorschlag — Bestaetigung noetig
NEU = "neu"
@dataclass
class KandidatVorschlag:
fahrer_id: int
voller_name: str
geburtsjahr: int | None
verein: str | None
aehnlichkeit: float
@dataclass
class MatchErgebnis:
status: MatchStatus
fahrer: Fahrer | None = None
vorschlaege: list[KandidatVorschlag] = field(default_factory=list)
neu_angelegt: bool = False
def finde_exakt(
db: Session, nachname: str, vorname: str, geburtsjahr: int | None
) -> Fahrer | None:
n, v = normalisiere(nachname), normalisiere(vorname)
# Vorfilter grob ueber die ersten Namensbuchstaben, exakter Vergleich dann in
# Python (Normalisierung deckt Akzente/Bindestriche ab; keine DB-Extension noetig).
praefix = normalisiere(nachname)[:3]
kandidaten = db.scalars(
select(Fahrer).where(func.lower(Fahrer.nachname).like(f"{praefix}%"))
).all()
if not kandidaten:
kandidaten = db.scalars(select(Fahrer)).all()
for f in kandidaten:
if (
normalisiere(f.nachname) == n
and normalisiere(f.vorname) == v
and (geburtsjahr is None or f.geburtsjahr is None or f.geburtsjahr == geburtsjahr)
):
return f
return None
def finde_aehnliche(
db: Session,
nachname: str,
vorname: str,
*,
limit: int = 5,
schwelle: float = 0.35,
) -> list[KandidatVorschlag]:
"""Trigramm-Aehnlichkeit auf ``lower(nachname || ' ' || vorname)`` (GIN-Index)."""
suchbegriff = f"{nachname} {vorname}".lower().strip()
voller_name = func.lower(func.concat(Fahrer.nachname, " ", Fahrer.vorname))
sim = func.similarity(voller_name, suchbegriff)
stmt = (
select(Fahrer, sim.label("sim"))
.where(sim >= schwelle)
.order_by(text("sim DESC"))
.limit(limit)
)
treffer = db.execute(stmt).all()
return [
KandidatVorschlag(
fahrer_id=f.id,
voller_name=f.voller_name,
geburtsjahr=f.geburtsjahr,
verein=f.verein.name if f.verein else None,
aehnlichkeit=round(float(sim), 3),
)
for f, sim in treffer
]
def match_oder_neu(
db: Session,
*,
nachname: str,
vorname: str,
geburtsjahr: int | None = None,
geschlecht=None,
verein_id: int | None = None,
anlegen: bool = True,
) -> MatchErgebnis:
exakt = finde_exakt(db, nachname, vorname, geburtsjahr)
if exakt is not None:
return MatchErgebnis(status=MatchStatus.EXAKT, fahrer=exakt)
vorschlaege = finde_aehnliche(db, nachname, vorname)
if vorschlaege and not anlegen:
return MatchErgebnis(status=MatchStatus.UNSCHARF, vorschlaege=vorschlaege)
if not anlegen:
return MatchErgebnis(status=MatchStatus.NEU)
neu = Fahrer(
nachname=nachname.strip(),
vorname=vorname.strip(),
geburtsjahr=geburtsjahr,
geschlecht=geschlecht,
verein_id=verein_id,
)
db.add(neu)
db.flush()
return MatchErgebnis(
status=MatchStatus.NEU, fahrer=neu, vorschlaege=vorschlaege, neu_angelegt=True
)
def fahrer_zusammenfuehren(db: Session, ziel_id: int, quelle_id: int) -> int:
"""Alle Starts von ``quelle_id`` auf ``ziel_id`` umhaengen, Quelle deaktivieren.
Rueckgabe: Anzahl umgehaengter Starts. Bewusst kein hartes DELETE — die Quelle
bleibt als inaktiver Datensatz mit Verweis erhalten (Nachvollziehbarkeit).
"""
if ziel_id == quelle_id:
raise ValueError("Ziel und Quelle sind identisch")
ziel = db.get(Fahrer, ziel_id)
quelle = db.get(Fahrer, quelle_id)
if ziel is None or quelle is None:
raise ValueError("Ziel- oder Quell-Fahrer nicht gefunden")
anzahl = db.execute(
update(Start).where(Start.fahrer_id == quelle_id).values(fahrer_id=ziel_id)
).rowcount
quelle.aktiv = False
quelle.notiz = ((quelle.notiz or "") + f"\n[merge] zusammengefuehrt nach Fahrer {ziel_id}").strip()
db.flush()
return anzahl or 0
src/oamc/meisterschaft/__init__.py
+23
View File
@@ -0,0 +1,23 @@
"""Meisterschafts-/Pokalwertung (HTH) — AP 3.
BLOCKIERT durch offene Frage O-1: die echte Punktetabelle (Platz -> Punkte) ist
noch nicht bekannt. Bis dahin arbeitet dieses Modul mit
``PLATZHALTER_PUNKTETABELLE`` (klar als solche markiert) bzw. mit der Tabelle aus
``meisterschaft.regelwerk['punkte']``.
"""
from oamc.meisterschaft.berechnung import (
PLATZHALTER_PUNKTETABELLE,
StandZeile,
berechne_stand,
endlauf_qualifikation,
punkte_fuer_platz,
)
__all__ = [
"PLATZHALTER_PUNKTETABELLE",
"StandZeile",
"berechne_stand",
"endlauf_qualifikation",
"punkte_fuer_platz",
]
src/oamc/meisterschaft/berechnung.py
+226
View File
@@ -0,0 +1,226 @@
"""Meisterschaftsstand, Streichresultate, Tie-Break, Endlaufqualifikation.
Regeln (Plan §3.4):
* Erwachsene: ein Gesamtklassement A + S (klassenuebergreifend).
* Jugend: Pokalwertung klassenweise J 1 - J 5.
* Streichresultate nach Tabelle in ``saison.streichresultate_tabelle``
("Turniere in der Saison" -> "davon gewertet").
* Nur Laeufe mit ``turnier.zaehlt_meisterschaft``.
* Tie-Break bei Punktgleichheit: Majoritaet der Siege.
* Endlauf: die besten 10 Erwachsenen bzw. 10 Jugendlichen — die Anwendung
*schlaegt vor*, entscheidet nicht (Bereichsleiter).
Die Punktetabelle ist offene Frage **O-1**. ``PLATZHALTER_PUNKTETABELLE`` ist
NICHT die echte Tabelle und erzeugt bei Verwendung einen Hinweis im Bericht.
"""
from __future__ import annotations
from dataclasses import dataclass, field
from decimal import Decimal
from sqlalchemy import select
from sqlalchemy.orm import Session
from oamc.models import (
Ergebnis,
Klasse,
Meisterschaft,
Saison,
Start,
Turnier,
Veranstaltung,
)
from oamc.models.enums import Kategorie, StartStatus
# ---------------------------------------------------------------------------
# PLATZHALTER — bis O-1 geklaert ist. Monoton fallend, Platz 1 = 25 Punkte,
# ab Platz 15 ein Punkt. Frei erfunden, nur damit AP 3 test- und lauffaehig ist.
# ---------------------------------------------------------------------------
PLATZHALTER_PUNKTETABELLE: dict[int, int] = {
1: 25, 2: 20, 3: 16, 4: 13, 5: 11, 6: 10, 7: 9, 8: 8,
9: 7, 10: 6, 11: 5, 12: 4, 13: 3, 14: 2,
}
PLATZHALTER_PUNKTE_AB_15 = 1
def punkte_fuer_platz(platz: int | None, tabelle: dict[int, int] | None = None) -> Decimal:
if platz is None or platz < 1:
return Decimal(0)
tab = tabelle or PLATZHALTER_PUNKTETABELLE
if platz in tab:
return Decimal(tab[platz])
# unterhalb der Tabelle: kleinster definierter Wert bzw. Platzhalter
if tabelle:
return Decimal(min(tabelle.values())) if tabelle else Decimal(0)
return Decimal(PLATZHALTER_PUNKTE_AB_15)
def gewertete_laeufe(anzahl_turniere: int, tabelle: dict[str, int] | None) -> int:
"""Wie viele der ``anzahl_turniere`` zaehlen (Rest = Streichresultate)."""
if not tabelle:
return anzahl_turniere
# exakter Eintrag?
key = str(anzahl_turniere)
if key in tabelle:
return int(tabelle[key])
# sonst: naechstkleinerer definierter Schluessel
kleinere = sorted((int(k) for k in tabelle), reverse=True)
for k in kleinere:
if k <= anzahl_turniere:
return int(tabelle[str(k)])
return anzahl_turniere
@dataclass
class StandZeile:
fahrer_id: int
punkte_gesamt: Decimal
punkte_je_lauf: dict[int, Decimal] # turnier_id -> Punkte (nach Streichung)
gestrichene_laeufe: list[int]
anzahl_siege: int
platz: int | None = None
@dataclass
class MeisterschaftsBericht:
meisterschaft_id: int
saison_jahr: int
kategorie: str
laeufe_gesamt: int
laeufe_gewertet: int
zeilen: list[StandZeile]
hinweise: list[str] = field(default_factory=list)
def _relevante_starts(db: Session, m: Meisterschaft, turnier_ids: list[int]) -> list[Start]:
stmt = (
select(Start)
.join(Ergebnis, Ergebnis.start_id == Start.id)
.join(Klasse, Klasse.id == Start.klasse_id)
.where(
Start.turnier_id.in_(turnier_ids),
Ergebnis.platzierung.is_not(None),
Start.status == StartStatus.GESTARTET,
)
)
if m.kategorie == Kategorie.JUGEND:
if m.klasse_id is not None:
stmt = stmt.where(Start.klasse_id == m.klasse_id)
else:
stmt = stmt.where(Klasse.kategorie == Kategorie.JUGEND)
else:
# Erwachsene: A + S zusammen (O-3: zaehlen A-Fahrer mit? -> annehmen: ja)
stmt = stmt.where(Klasse.kategorie.in_([Kategorie.STAMM, Kategorie.ANFAENGER]))
return list(db.scalars(stmt))
def berechne_stand(db: Session, meisterschaft_id: int) -> MeisterschaftsBericht:
m = db.get(Meisterschaft, meisterschaft_id)
if m is None:
raise ValueError(f"Meisterschaft {meisterschaft_id} nicht gefunden")
saison = db.get(Saison, m.saison_jahr)
regelwerk = m.regelwerk or {}
punkte_tab_raw = regelwerk.get("punkte")
punkte_tab = {int(k): int(v) for k, v in punkte_tab_raw.items()} if punkte_tab_raw else None
streich_tab = (saison.streichresultate_tabelle if saison else None) or regelwerk.get("streich")
hinweise: list[str] = []
if punkte_tab is None:
hinweise.append(
"O-1 offen: PLATZHALTER-Punktetabelle verwendet — nicht fuer offizielle Staende!"
)
if regelwerk.get("_hinweis"):
hinweise.append(str(regelwerk["_hinweis"]))
turniere = list(
db.scalars(
select(Turnier)
.join(Veranstaltung, Veranstaltung.id == Turnier.veranstaltung_id)
.where(
Veranstaltung.datum.is_not(None),
Turnier.zaehlt_meisterschaft.is_(True),
Veranstaltung.status.in_(["vorlaeufig", "final"]),
)
.order_by(Veranstaltung.datum, Turnier.id)
)
)
# nur Turniere der Saison der Meisterschaft
turniere = [t for t in turniere if t.veranstaltung.datum.year == m.saison_jahr]
turnier_ids = [t.id for t in turniere]
roh: dict[int, dict[int, Decimal]] = {} # fahrer_id -> {turnier_id: punkte}
siege: dict[int, int] = {}
if turnier_ids:
for s in _relevante_starts(db, m, turnier_ids):
p = punkte_fuer_platz(s.ergebnis.platzierung, punkte_tab)
bucket = roh.setdefault(s.fahrer_id, {})
# Mehrfachstart in derselben Kategorie am selben Tag: bestes Ergebnis zaehlt
bucket[s.turnier_id] = max(bucket.get(s.turnier_id, Decimal(0)), p)
if s.ergebnis.platzierung == 1:
siege[s.fahrer_id] = siege.get(s.fahrer_id, 0) + 1
n_gewertet = gewertete_laeufe(len(turnier_ids), streich_tab)
zeilen: list[StandZeile] = []
for fahrer_id, je_lauf in roh.items():
sortiert = sorted(je_lauf.items(), key=lambda kv: kv[1], reverse=True)
behalten = dict(sortiert[:n_gewertet])
gestrichen = [tid for tid, _ in sortiert[n_gewertet:]]
zeilen.append(
StandZeile(
fahrer_id=fahrer_id,
punkte_gesamt=sum(behalten.values(), Decimal(0)),
punkte_je_lauf=behalten,
gestrichene_laeufe=gestrichen,
anzahl_siege=siege.get(fahrer_id, 0),
)
)
zeilen.sort(key=lambda z: (-z.punkte_gesamt, -z.anzahl_siege, z.fahrer_id))
for i, z in enumerate(zeilen, start=1):
z.platz = i
return MeisterschaftsBericht(
meisterschaft_id=meisterschaft_id,
saison_jahr=m.saison_jahr,
kategorie=m.kategorie.value,
laeufe_gesamt=len(turnier_ids),
laeufe_gewertet=n_gewertet,
zeilen=zeilen,
hinweise=hinweise,
)
@dataclass
class QualiVorschlag:
fahrer_id: int
platz: int
punkte: Decimal
anzahl_siege: int
tie_break_relevant: bool
def endlauf_qualifikation(
db: Session, meisterschaft_id: int, plaetze: int = 10
) -> list[QualiVorschlag]:
"""Vorschlag Top-N fuer den Endlauf. Bei Punktgleichheit an der Grenze wird
``tie_break_relevant`` gesetzt — die endgueltige Festlegung trifft der
Bereichsleiter (Plan §3.4)."""
bericht = berechne_stand(db, meisterschaft_id)
zeilen = bericht.zeilen[: plaetze + 5] # etwas Puffer fuer die Grenzbetrachtung
vorschlaege: list[QualiVorschlag] = []
grenz_punkte = bericht.zeilen[plaetze - 1].punkte_gesamt if len(bericht.zeilen) >= plaetze else None
for z in zeilen:
vorschlaege.append(
QualiVorschlag(
fahrer_id=z.fahrer_id,
platz=z.platz or 0,
punkte=z.punkte_gesamt,
anzahl_siege=z.anzahl_siege,
tie_break_relevant=grenz_punkte is not None and z.punkte_gesamt == grenz_punkte,
)
)
return vorschlaege
src/oamc/models/__init__.py
+53
View File
@@ -0,0 +1,53 @@
"""Alle ORM-Modelle. Import hier zentral, damit Alembic-Autogenerate sie sieht."""
from __future__ import annotations
from oamc.models.audit import ImportJob
from oamc.models.base import Base
from oamc.models.benutzer import Benutzer
from oamc.models.enums import (
BenutzerRolle,
GeraetTyp,
Geschlecht,
ImportStatus,
Kategorie,
StartStatus,
TurnierStatus,
VeranstaltungStatus,
ZeitmessungStatus,
)
from oamc.models.fahrer import Fahrer
from oamc.models.klasse import Klasse
from oamc.models.meisterschaft import Meisterschaft, MeisterschaftStand
from oamc.models.organisation import Saison, Verein
from oamc.models.start import Ergebnis, Start
from oamc.models.veranstaltung import Turnier, Veranstaltung, Wertungsklasse
from oamc.models.zeitmessung import Geraet, Zeitmessung
__all__ = [
"Base",
"Verein",
"Saison",
"Klasse",
"Fahrer",
"Veranstaltung",
"Turnier",
"Wertungsklasse",
"Start",
"Ergebnis",
"Geraet",
"Zeitmessung",
"Meisterschaft",
"MeisterschaftStand",
"ImportJob",
"Benutzer",
"Kategorie",
"Geschlecht",
"VeranstaltungStatus",
"TurnierStatus",
"StartStatus",
"GeraetTyp",
"ZeitmessungStatus",
"ImportStatus",
"BenutzerRolle",
]
src/oamc/models/audit.py
+35
View File
@@ -0,0 +1,35 @@
"""Import-Audit-Trail (Plan §4, §6.1).
Jeder API-/Datei-Import landet hier mit Roh-Payload — bei Streit ueber eine
Platzierung ist rekonstruierbar, was wann ankam.
"""
from __future__ import annotations
from datetime import datetime
from sqlalchemy import DateTime, Integer, String, Text, func
from sqlalchemy.dialects.postgresql import JSONB
from sqlalchemy.orm import Mapped, mapped_column
from oamc.models.base import Base, sa_enum
from oamc.models.enums import ImportStatus
class ImportJob(Base):
__tablename__ = "import_job"
id: Mapped[int] = mapped_column(Integer, primary_key=True)
quelle: Mapped[str] = mapped_column(String(120), nullable=False) # "excel-auswertung-v3"
idempotenz_schluessel: Mapped[str | None] = mapped_column(String(200), index=True)
dateiname: Mapped[str | None] = mapped_column(String(300))
roh_payload: Mapped[dict | None] = mapped_column(JSONB)
ergebnis_bericht: Mapped[dict | None] = mapped_column(JSONB) # neue/gematchte Fahrer, Warnungen
status: Mapped[ImportStatus] = mapped_column(
sa_enum(ImportStatus, "import_status"), nullable=False
)
fehler: Mapped[str | None] = mapped_column(Text)
angelegt_von: Mapped[str | None] = mapped_column(String(120))
angelegt_am: Mapped[datetime] = mapped_column(
DateTime(timezone=True), server_default=func.now(), nullable=False
)
src/oamc/models/base.py
+43
View File
@@ -0,0 +1,43 @@
"""Deklarative Basis und gemeinsame Mixins."""
from __future__ import annotations
from datetime import datetime
from sqlalchemy import DateTime, MetaData, func
from sqlalchemy import Enum as SAEnum
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
def sa_enum(py_enum: type, name: str) -> SAEnum:
"""Postgres-Enum, das die ``value`` der Python-Enum-Member speichert (nicht den
Namen) — lesbare Dumps, stabile Migrationen."""
return SAEnum(py_enum, name=name, values_callable=lambda e: [m.value for m in e])
# Feste Namenskonvention -> stabile Constraint-Namen in Alembic-Migrationen.
NAMING_CONVENTION = {
"ix": "ix_%(column_0_label)s",
"uq": "uq_%(table_name)s_%(column_0_name)s",
"ck": "ck_%(table_name)s_%(constraint_name)s",
"fk": "fk_%(table_name)s_%(column_0_name)s_%(referred_table_name)s",
"pk": "pk_%(table_name)s",
}
class Base(DeclarativeBase):
metadata = MetaData(naming_convention=NAMING_CONVENTION)
class TimestampMixin:
"""``erstellt_am`` / ``geaendert_am`` — von der DB gepflegt."""
erstellt_am: Mapped[datetime] = mapped_column(
DateTime(timezone=True), server_default=func.now(), nullable=False
)
geaendert_am: Mapped[datetime] = mapped_column(
DateTime(timezone=True),
server_default=func.now(),
onupdate=func.now(),
nullable=False,
)
src/oamc/models/benutzer.py
+33
View File
@@ -0,0 +1,33 @@
"""Interne Benutzer (Login) — Admin / Auswerter / Lesend (Plan §4)."""
from __future__ import annotations
from datetime import datetime
from sqlalchemy import Boolean, DateTime, String
from sqlalchemy.orm import Mapped, mapped_column
from oamc.models.base import Base, TimestampMixin, sa_enum
from oamc.models.enums import BenutzerRolle
class Benutzer(Base, TimestampMixin):
__tablename__ = "benutzer"
id: Mapped[int] = mapped_column(primary_key=True)
benutzername: Mapped[str] = mapped_column(String(80), nullable=False, unique=True)
anzeigename: Mapped[str] = mapped_column(String(120), nullable=False)
passwort_hash: Mapped[str] = mapped_column(String(255), nullable=False)
rolle: Mapped[BenutzerRolle] = mapped_column(
sa_enum(BenutzerRolle, "benutzer_rolle"), nullable=False, default=BenutzerRolle.LESEND
)
aktiv: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)
letzter_login_am: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))
@property
def darf_schreiben(self) -> bool:
return self.rolle in (BenutzerRolle.ADMIN, BenutzerRolle.AUSWERTER)
@property
def ist_admin(self) -> bool:
return self.rolle == BenutzerRolle.ADMIN
src/oamc/models/enums.py
+71
View File
@@ -0,0 +1,71 @@
"""Fachliche Aufzaehlungstypen.
Bewusst als String-Enums in der DB (lesbare Dumps, einfache Migration). Die
*Wertungsformel* je Kategorie steht NICHT hier fest verdrahtet, sondern wird in
``oamc.wertung.engine`` pro Kategorie/Saison aufgeloest (Plan §3.3).
"""
from __future__ import annotations
import enum
class Kategorie(str, enum.Enum):
"""Grobklassierung eines Fahrers/Starts. Bestimmt die Default-Wertungsformel."""
JUGEND = "J"
STAMM = "S"
ANFAENGER = "A"
class Geschlecht(str, enum.Enum):
MAENNLICH = "M"
WEIBLICH = "W"
DIVERS = "D"
class VeranstaltungStatus(str, enum.Enum):
GEPLANT = "geplant"
LAUFEND = "laufend"
VORLAEUFIG = "vorlaeufig"
FINAL = "final"
class TurnierStatus(str, enum.Enum):
GEPLANT = "geplant"
LAUFEND = "laufend"
VORLAEUFIG = "vorlaeufig"
FINAL = "final"
class StartStatus(str, enum.Enum):
GENANNT = "genannt"
GESTARTET = "gestartet"
DNF = "DNF" # did not finish
DNS = "DNS" # did not start
DSQ = "DSQ" # disqualifiziert
class GeraetTyp(str, enum.Enum):
LICHTSCHRANKE = "lichtschranke"
ANZEIGE = "anzeige"
class ZeitmessungStatus(str, enum.Enum):
GUELTIG = "gueltig"
VERWORFEN = "verworfen"
UNZUGEORDNET = "unzugeordnet"
UNPLAUSIBEL = "unplausibel"
class ImportStatus(str, enum.Enum):
ANGENOMMEN = "angenommen"
VORSCHAU = "vorschau"
FEHLER = "fehler"
TEILWEISE = "teilweise"
class BenutzerRolle(str, enum.Enum):
ADMIN = "admin"
AUSWERTER = "auswerter"
LESEND = "lesend"
src/oamc/models/fahrer.py
+54
View File
@@ -0,0 +1,54 @@
"""Fahrer-Stammdaten — einmalig, nicht pro Turnier (Plan §4).
Loest die heutige \"BAUSTELLE\" ``m/m-fahrer.htm`` ab. Dublettenerkennung beim
Import: siehe ``oamc.matching.fahrer``.
"""
from __future__ import annotations
from datetime import date
from sqlalchemy import Boolean, Date, ForeignKey, Integer, String, Text
from sqlalchemy.orm import Mapped, mapped_column, relationship
from oamc.models.base import Base, TimestampMixin, sa_enum
from oamc.models.enums import Geschlecht
class Fahrer(Base, TimestampMixin):
__tablename__ = "fahrer"
# Hinweis: der GIN-Trigramm-Index ``ix_fahrer_name_trgm`` (unscharfe Suche beim
# Import, Plan §6.4) wird als Ausdrucksindex in der Migration angelegt und in
# ``migrations/env.py`` von der Autogenerate-Vergleichung ausgenommen.
id: Mapped[int] = mapped_column(Integer, primary_key=True)
nachname: Mapped[str] = mapped_column(String(120), nullable=False)
vorname: Mapped[str] = mapped_column(String(120), nullable=False)
geburtsjahr: Mapped[int | None] = mapped_column(Integer, index=True)
# nullable: nur fuer die J-1-Pruefung "am Veranstaltungstag 7 Jahre" noetig.
# Datenminimierung oeffentlich: nur das Jahr wird angezeigt (Plan §11).
geburtsdatum: Mapped[date | None] = mapped_column(Date)
geschlecht: Mapped[Geschlecht | None] = mapped_column(sa_enum(Geschlecht, "geschlecht"))
verein_id: Mapped[int | None] = mapped_column(ForeignKey("verein.id"), index=True)
adac_mitgliedsnr: Mapped[str | None] = mapped_column(String(40)) # nie oeffentlich
jugendausweis_gueltig_bis: Mapped[date | None] = mapped_column(Date)
# Datenschutz: Opt-out auf Anzeige als "Teilnehmer N" / Kuerzel (Plan §11)
anzeige_anonymisiert: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
aktiv: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)
notiz: Mapped[str | None] = mapped_column(Text)
verein: Mapped[Verein | None] = relationship(back_populates="fahrer") # noqa: F821
starts: Mapped[list[Start]] = relationship(back_populates="fahrer") # noqa: F821
@property
def voller_name(self) -> str:
return f"{self.nachname} {self.vorname}"
@property
def anzeigename(self) -> str:
if self.anzeige_anonymisiert:
return f"Teilnehmer/in #{self.id}"
return self.voller_name
src/oamc/models/klasse.py
+44
View File
@@ -0,0 +1,44 @@
"""Klassendefinition pro Saison (Plan §3.2).
Die Jahrgangstabelle ist jahresabhaengig und liegt deshalb in der DB, nicht im
Code. ``kategorie`` bestimmt die Default-Wertungsformel (J: nur Fehler; S/A:
Zeit + Fehler), ist aber pro Saison in ``wertungsregel`` ueberschreibbar.
"""
from __future__ import annotations
from sqlalchemy import ForeignKey, Integer, Numeric, String, Text, UniqueConstraint
from sqlalchemy.dialects.postgresql import ARRAY
from sqlalchemy.orm import Mapped, mapped_column, relationship
from oamc.models.base import Base, sa_enum
from oamc.models.enums import Kategorie
class Klasse(Base):
__tablename__ = "klasse"
__table_args__ = (
UniqueConstraint("saison_jahr", "code", name="klasse_saison_code"),
)
id: Mapped[int] = mapped_column(Integer, primary_key=True)
saison_jahr: Mapped[int] = mapped_column(
ForeignKey("saison.jahr", ondelete="CASCADE"), nullable=False, index=True
)
code: Mapped[str] = mapped_column(String(10), nullable=False) # "J 1", "S 6", "A 4"
kategorie: Mapped[Kategorie] = mapped_column(sa_enum(Kategorie, "kategorie"), nullable=False)
bezeichnung: Mapped[str] = mapped_column(String(200), nullable=False)
# Nur Jugend: erlaubte Geburtsjahrgaenge, z. B. [2019, 2018, 2017]
jahrgaenge: Mapped[list[int] | None] = mapped_column(ARRAY(Integer))
ccm_max: Mapped[int | None] = mapped_column(Integer)
kw_max: Mapped[float | None] = mapped_column(Numeric(5, 2))
fahrzeugtyp: Mapped[str | None] = mapped_column(String(200))
# Fuer Klasse J 1: Mindestalter am Veranstaltungstag (Plan §3.2: "bereits 7 Jahre")
mindestalter_am_veranstaltungstag: Mapped[int | None] = mapped_column(Integer)
sortierung: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
notiz: Mapped[str | None] = mapped_column(Text)
saison: Mapped[Saison] = relationship(back_populates="klassen") # noqa: F821
def __repr__(self) -> str: # pragma: no cover - Debug-Hilfe
return f"<Klasse {self.saison_jahr}/{self.code}>"
src/oamc/models/meisterschaft.py
+64
View File
@@ -0,0 +1,64 @@
"""Meisterschafts-/Pokalwertung (HTH) — Plan §3.4.
* Erwachsene: ein Gesamtklassement A + S (klassenuebergreifend)
* Jugend: Pokalwertung klassenweise J 1 - J 5
* Streichresultate nach Tabelle in ``saison.streichresultate_tabelle``
* Tie-Break: Majoritaet der Siege
* Die Anwendung *schlaegt* die Endlaufqualifikation *vor*, entscheidet nicht.
"""
from __future__ import annotations
from datetime import datetime
from sqlalchemy import DateTime, ForeignKey, Integer, Numeric, String, func
from sqlalchemy.dialects.postgresql import JSONB
from sqlalchemy.orm import Mapped, mapped_column, relationship
from oamc.models.base import Base, sa_enum
from oamc.models.enums import Kategorie
class Meisterschaft(Base):
__tablename__ = "meisterschaft"
id: Mapped[int] = mapped_column(Integer, primary_key=True)
saison_jahr: Mapped[int] = mapped_column(ForeignKey("saison.jahr"), nullable=False, index=True)
bezeichnung: Mapped[str] = mapped_column(String(200), nullable=False)
kategorie: Mapped[Kategorie] = mapped_column(
sa_enum(Kategorie, "meisterschaft_kategorie"), nullable=False
)
# nur bei Jugend gesetzt (klassenweise J1..J5); bei Erwachsenen NULL
klasse_id: Mapped[int | None] = mapped_column(ForeignKey("klasse.id"))
# Punktetabelle (Platz -> Punkte), Streichregel-Override, Endlauf-Parameter.
# Solange O-1 offen ist, steht hier die (klar markierte) Platzhalter-Tabelle.
regelwerk: Mapped[dict] = mapped_column(JSONB, nullable=False, default=dict)
staende: Mapped[list[MeisterschaftStand]] = relationship(
back_populates="meisterschaft", cascade="all, delete-orphan"
)
class MeisterschaftStand(Base):
"""Materialisiert — nach jedem Turnier neu berechnet."""
__tablename__ = "meisterschaft_stand"
id: Mapped[int] = mapped_column(Integer, primary_key=True)
meisterschaft_id: Mapped[int] = mapped_column(
ForeignKey("meisterschaft.id", ondelete="CASCADE"), nullable=False, index=True
)
fahrer_id: Mapped[int] = mapped_column(ForeignKey("fahrer.id"), nullable=False, index=True)
punkte_gesamt: Mapped[float] = mapped_column(Numeric(9, 2), nullable=False, default=0)
# {turnier_id: punkte}
punkte_je_lauf: Mapped[dict] = mapped_column(JSONB, nullable=False, default=dict)
# Liste der turnier_ids, die als Streichresultat NICHT zaehlen
gestrichene_laeufe: Mapped[list] = mapped_column(JSONB, nullable=False, default=list)
anzahl_siege: Mapped[int] = mapped_column(Integer, nullable=False, default=0) # Tie-Break
platz: Mapped[int | None] = mapped_column(Integer)
berechnet_am: Mapped[datetime] = mapped_column(
DateTime(timezone=True), server_default=func.now(), nullable=False
)
meisterschaft: Mapped[Meisterschaft] = relationship(back_populates="staende")
fahrer: Mapped[Fahrer] = relationship() # noqa: F821
src/oamc/models/organisation.py
+50
View File
@@ -0,0 +1,50 @@
"""Stammorganisation: Regionalclubs/Ortsclubs und Saison (Regelversionierung)."""
from __future__ import annotations
from decimal import Decimal
from sqlalchemy import Boolean, Integer, String, Text
from sqlalchemy.dialects.postgresql import JSONB
from sqlalchemy.orm import Mapped, mapped_column, relationship
from oamc.models.base import Base, TimestampMixin
class Verein(Base, TimestampMixin):
"""Regional-/Ortsclub. Namensvarianten (\"Hainstadt\" = Ort statt Club) werden
beim Import gegen ``kurzname``/``name`` gematcht (Plan §6.4)."""
__tablename__ = "verein"
id: Mapped[int] = mapped_column(Integer, primary_key=True)
name: Mapped[str] = mapped_column(String(200), nullable=False, unique=True)
kurzname: Mapped[str | None] = mapped_column(String(60))
adac_gau: Mapped[str | None] = mapped_column(String(120))
aktiv: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)
notiz: Mapped[str | None] = mapped_column(Text)
fahrer: Mapped[list[Fahrer]] = relationship(back_populates="verein") # noqa: F821
class Saison(Base):
"""Ein Wettkampfjahr. Macht Klassen, Jahrgaenge, Streichresultate und
Punktetabelle versionierbar (Plan §4 Kernprinzipien)."""
__tablename__ = "saison"
jahr: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=False)
turnierordnung_version: Mapped[str | None] = mapped_column(String(60))
# Tabelle "Turniere in der Saison" -> "davon gewertet" (Plan §3.4).
# z. B. {"12": 8, "11": 8, ... , "4": 2}
streichresultate_tabelle: Mapped[dict] = mapped_column(JSONB, nullable=False, default=dict)
nenngeld_cent: Mapped[int] = mapped_column(Integer, nullable=False, default=1000)
aktiv: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
klassen: Mapped[list[Klasse]] = relationship( # noqa: F821
back_populates="saison", cascade="all, delete-orphan"
)
@property
def nenngeld_euro(self) -> Decimal:
return (Decimal(self.nenngeld_cent) / 100).quantize(Decimal("0.01"))
src/oamc/models/start.py
+102
View File
@@ -0,0 +1,102 @@
"""Start (eine Teilnahme) und Ergebnis (1:1 zum Start).
Schluessel eines Ergebnisses ist (Turnier, Start), NICHT (Turnier, Fahrer) — ein
Fahrer kann am selben Tag mehrfach starten (Plan §3.3 Mehrfachstarts).
"""
from __future__ import annotations
from datetime import datetime
from decimal import Decimal
from sqlalchemy import (
Boolean,
DateTime,
ForeignKey,
Integer,
Numeric,
String,
Text,
UniqueConstraint,
func,
)
from sqlalchemy.orm import Mapped, mapped_column, relationship
from oamc.models.base import Base, sa_enum
from oamc.models.enums import StartStatus
class Start(Base):
__tablename__ = "start"
__table_args__ = (
UniqueConstraint("turnier_id", "startnummer", name="start_turnier_startnummer"),
)
id: Mapped[int] = mapped_column(Integer, primary_key=True)
turnier_id: Mapped[int] = mapped_column(
ForeignKey("turnier.id", ondelete="CASCADE"), nullable=False, index=True
)
fahrer_id: Mapped[int] = mapped_column(ForeignKey("fahrer.id"), nullable=False, index=True)
klasse_id: Mapped[int] = mapped_column(ForeignKey("klasse.id"), nullable=False)
wertungsklasse_id: Mapped[int | None] = mapped_column(
ForeignKey("wertungsklasse.id", ondelete="SET NULL"), index=True
)
startnummer: Mapped[int] = mapped_column(Integer, nullable=False)
fahrzeug: Mapped[str | None] = mapped_column(String(200))
nenngeld_bezahlt: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
status: Mapped[StartStatus] = mapped_column(
sa_enum(StartStatus, "start_status"), nullable=False, default=StartStatus.GENANNT
)
nennreihenfolge: Mapped[int | None] = mapped_column(Integer) # nummerierte Nennungsliste
turnier: Mapped[Turnier] = relationship(back_populates="starts") # noqa: F821
fahrer: Mapped[Fahrer] = relationship(back_populates="starts") # noqa: F821
klasse: Mapped[Klasse] = relationship() # noqa: F821
wertungsklasse: Mapped[Wertungsklasse | None] = relationship( # noqa: F821
back_populates="starts"
)
ergebnis: Mapped[Ergebnis | None] = relationship(
back_populates="start", cascade="all, delete-orphan", uselist=False
)
zeitmessungen: Mapped[list[Zeitmessung]] = relationship( # noqa: F821
back_populates="start"
)
@property
def gewertet(self) -> bool:
return self.status in (StartStatus.GESTARTET,)
class Ergebnis(Base):
"""1:1 zum Start — getrennte Tabelle fuer saubere Nachtraege/Korrekturen.
Zwei Quellen (Plan §3.6): ``summe_zeit`` aus ``zeitmessung`` summiert,
``summe_fehler`` manuell erfasst. Ein "halbes" Ergebnis ist der Normalzustand
waehrend der Veranstaltung. Gewertet wird erst, wenn beide ``*_vollstaendig``.
"""
__tablename__ = "ergebnis"
start_id: Mapped[int] = mapped_column(
ForeignKey("start.id", ondelete="CASCADE"), primary_key=True
)
summe_zeit: Mapped[Decimal | None] = mapped_column(Numeric(7, 2)) # aus zeitmessung summiert
summe_fehler: Mapped[int | None] = mapped_column(Integer) # manuell erfasst
gesamt: Mapped[Decimal | None] = mapped_column(Numeric(9, 2)) # berechnet
platzierung: Mapped[int | None] = mapped_column(Integer) # berechnet
zeit_vollstaendig: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
fehler_vollstaendig: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
erfasst_von: Mapped[str | None] = mapped_column(String(120))
erfasst_am: Mapped[datetime] = mapped_column(
DateTime(timezone=True), server_default=func.now(), nullable=False
)
korrigiert_am: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))
korrektur_grund: Mapped[str | None] = mapped_column(Text)
start: Mapped[Start] = relationship(back_populates="ergebnis")
@property
def wertbar(self) -> bool:
return bool(self.zeit_vollstaendig and self.fehler_vollstaendig)
src/oamc/models/veranstaltung.py
+95
View File
@@ -0,0 +1,95 @@
"""Renntag -> Wertungslauf -> zusammengefasste Wertungsklasse (Plan §3.1).
``veranstaltung`` (Renntag) : ``turnier`` (Wertungslauf) = 1:n. Ein Doppelturnier
hat zwei Turniere, jeder Fahrer wird in beiden getrennt gewertet.
"""
from __future__ import annotations
from datetime import date
from sqlalchemy import Boolean, Date, ForeignKey, Index, Integer, String, Text, text
from sqlalchemy.dialects.postgresql import ARRAY
from sqlalchemy.orm import Mapped, mapped_column, relationship
from oamc.models.base import Base, TimestampMixin, sa_enum
from oamc.models.enums import TurnierStatus, VeranstaltungStatus
class Veranstaltung(Base, TimestampMixin):
__tablename__ = "veranstaltung"
id: Mapped[int] = mapped_column(Integer, primary_key=True)
datum: Mapped[date] = mapped_column(Date, nullable=False, index=True)
titel: Mapped[str] = mapped_column(String(300), nullable=False)
ort: Mapped[str | None] = mapped_column(String(200))
ausrichter_verein_id: Mapped[int | None] = mapped_column(ForeignKey("verein.id"))
ist_doppelturnier: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
veranstaltungsleiter: Mapped[str | None] = mapped_column(String(200))
turnierleiter: Mapped[str | None] = mapped_column(String(200))
status: Mapped[VeranstaltungStatus] = mapped_column(
sa_enum(VeranstaltungStatus, "veranstaltung_status"),
nullable=False,
default=VeranstaltungStatus.GEPLANT,
)
notiz: Mapped[str | None] = mapped_column(Text)
turniere: Mapped[list[Turnier]] = relationship(
back_populates="veranstaltung", cascade="all, delete-orphan", order_by="Turnier.id"
)
class Turnier(Base, TimestampMixin):
__tablename__ = "turnier"
__table_args__ = (
# Hoechstens EIN Turnier darf "aktiv" sein -> Geraete-API /turniere/aktiv/*
Index(
"uq_turnier_ist_aktiv",
"ist_aktiv",
unique=True,
postgresql_where=text("ist_aktiv"),
),
)
id: Mapped[int] = mapped_column(Integer, primary_key=True)
veranstaltung_id: Mapped[int] = mapped_column(
ForeignKey("veranstaltung.id", ondelete="CASCADE"), nullable=False, index=True
)
name: Mapped[str] = mapped_column(String(120), nullable=False) # "Reinheim" / "Hainstadt"
veranstalter_verein_id: Mapped[int | None] = mapped_column(ForeignKey("verein.id"))
# Nicht jede Veranstaltung zaehlt zur Meisterschaft ("o. M.", Plan §3.4).
zaehlt_meisterschaft: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)
# Genau ein Turnier kann als "aktiv" markiert sein -> Geraete-API-Endpunkte
# /turniere/aktiv/*. Partieller Unique-Index in der Migration.
ist_aktiv: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
status: Mapped[TurnierStatus] = mapped_column(
sa_enum(TurnierStatus, "turnier_status"),
nullable=False,
default=TurnierStatus.GEPLANT,
)
veranstaltung: Mapped[Veranstaltung] = relationship(back_populates="turniere")
wertungsklassen: Mapped[list[Wertungsklasse]] = relationship(
back_populates="turnier", cascade="all, delete-orphan", order_by="Wertungsklasse.sortierung"
)
starts: Mapped[list[Start]] = relationship( # noqa: F821
back_populates="turnier", cascade="all, delete-orphan"
)
class Wertungsklasse(Base):
"""Pro Turnier zusammengefasste Klassen (Plan §3.2): z. B. "S 5, S 9, S 3, S 6, S 7".
Das Zusammenlegen ist eine Entscheidung pro Turnier, keine Regel im Code."""
__tablename__ = "wertungsklasse"
id: Mapped[int] = mapped_column(Integer, primary_key=True)
turnier_id: Mapped[int] = mapped_column(
ForeignKey("turnier.id", ondelete="CASCADE"), nullable=False, index=True
)
bezeichnung: Mapped[str] = mapped_column(String(200), nullable=False)
klasse_ids: Mapped[list[int]] = mapped_column(ARRAY(Integer), nullable=False, default=list)
sortierung: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
turnier: Mapped[Turnier] = relationship(back_populates="wertungsklassen")
starts: Mapped[list[Start]] = relationship(back_populates="wertungsklasse") # noqa: F821
src/oamc/models/zeitmessung.py
+97
View File
@@ -0,0 +1,97 @@
"""Messgeraet am Parcours und Einzelmessung (Plan §3.6, §4).
Grundsaetze:
* Rohmessungen statt Summen speichern — die Summe bildet die Anwendung.
* Die ``id`` vergibt das GERAET (UUID) -> Server ist idempotent.
* Die Dauer kommt fertig vom Geraet (monotone Zeit), der Server rechnet keine
Differenz aus Wanduhr-Zeitstempeln.
* Eine Messung ohne zuordenbaren Start geht NICHT verloren (``start_id`` nullable,
Status ``unzugeordnet``).
"""
from __future__ import annotations
import uuid
from datetime import datetime
from decimal import Decimal
from sqlalchemy import (
BigInteger,
Boolean,
DateTime,
ForeignKey,
Index,
Integer,
Numeric,
String,
Text,
func,
)
from sqlalchemy.dialects.postgresql import JSONB
from sqlalchemy.dialects.postgresql import UUID as PGUUID
from sqlalchemy.orm import Mapped, mapped_column, relationship
from oamc.models.base import Base, TimestampMixin, sa_enum
from oamc.models.enums import GeraetTyp, ZeitmessungStatus
class Geraet(Base, TimestampMixin):
"""Lichtschranke oder Anzeige. Eigener Geraete-Token (nicht der Auswerter-Login),
einzeln sperrbar (Plan §3.6b)."""
__tablename__ = "geraet"
id: Mapped[int] = mapped_column(Integer, primary_key=True)
bezeichnung: Mapped[str] = mapped_column(String(120), nullable=False, unique=True)
typ: Mapped[GeraetTyp] = mapped_column(sa_enum(GeraetTyp, "geraet_typ"), nullable=False)
token_hash: Mapped[str] = mapped_column(String(255), nullable=False)
aktiv: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)
letzte_meldung_am: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))
firmware_version: Mapped[str | None] = mapped_column(String(60))
queue_laenge_gemeldet: Mapped[int | None] = mapped_column(Integer)
notiz: Mapped[str | None] = mapped_column(Text)
# Zentral gepflegte Konfiguration, die der Mess-Pi per API abholt.
konfiguration: Mapped[dict] = mapped_column(JSONB, nullable=False, default=dict)
zeitmessungen: Mapped[list[Zeitmessung]] = relationship(back_populates="geraet")
class Zeitmessung(Base):
__tablename__ = "zeitmessung"
__table_args__ = (
Index("ix_zeitmessung_turnier_status", "turnier_id", "status"),
Index("ix_zeitmessung_start", "start_id"),
)
# vom Geraet vergeben (UUIDv4/v7) -> Idempotenz
id: Mapped[uuid.UUID] = mapped_column(PGUUID(as_uuid=True), primary_key=True)
geraet_id: Mapped[int] = mapped_column(ForeignKey("geraet.id"), nullable=False)
turnier_id: Mapped[int] = mapped_column(
ForeignKey("turnier.id", ondelete="CASCADE"), nullable=False
)
# nullable — unzugeordnete Messungen gehen nicht verloren
start_id: Mapped[int | None] = mapped_column(ForeignKey("start.id", ondelete="SET NULL"))
startnummer_gemeldet: Mapped[int | None] = mapped_column(Integer) # Hinweis, kein FK
messpunkt: Mapped[str] = mapped_column(String(80), nullable=False, default="durchgang-1")
dauer_sekunden: Mapped[Decimal] = mapped_column(Numeric(7, 2), nullable=False) # vom Geraet
gemessen_am: Mapped[datetime] = mapped_column(DateTime(timezone=True), nullable=False)
monotonic_ns: Mapped[int | None] = mapped_column(BigInteger)
empfangen_am: Mapped[datetime] = mapped_column(
DateTime(timezone=True), server_default=func.now(), nullable=False
)
nachgeliefert: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
status: Mapped[ZeitmessungStatus] = mapped_column(
sa_enum(ZeitmessungStatus, "zeitmessung_status"),
nullable=False,
default=ZeitmessungStatus.GUELTIG,
)
verworfen_grund: Mapped[str | None] = mapped_column(Text)
roh: Mapped[dict | None] = mapped_column(JSONB)
geraet: Mapped[Geraet] = relationship(back_populates="zeitmessungen")
start: Mapped[Start | None] = relationship(back_populates="zeitmessungen") # noqa: F821
@property
def zaehlt_in_summe(self) -> bool:
return self.status == ZeitmessungStatus.GUELTIG and self.start_id is not None
src/oamc/schemas/__init__.py
+1
View File
@@ -0,0 +1 @@
"""Pydantic-v2-Schemata: ein Schema fuer API-Validierung UND OpenAPI-Doku."""
src/oamc/schemas/geraete.py
+67
View File
@@ -0,0 +1,67 @@
"""Schemata der Geraete-API (Mess-Pi, Bearer-Token). Plan §6.2."""
from __future__ import annotations
import uuid
from datetime import datetime
from decimal import Decimal
from pydantic import BaseModel, Field
class Heartbeat(BaseModel):
firmware_version: str | None = None
queue_laenge: int = Field(default=0, ge=0)
freitext: str | None = None
class HeartbeatAntwort(BaseModel):
geraet_id: int
bezeichnung: str
server_zeit: datetime
aktives_turnier_id: int | None
class GeraeteKonfiguration(BaseModel):
aktives_turnier_id: int | None
entprellung_ms: int = 300
messpunkte: list[str] = ["durchgang-1"]
plausibilitaet_min_s: float
plausibilitaet_max_s: float
# frei konfigurierbare Zusatzwerte aus geraet.konfiguration
extra: dict = {}
class MessungEin(BaseModel):
id: uuid.UUID = Field(description="vom Geraet vergeben (UUIDv4/v7) -> Idempotenz")
turnier_id: int
startnummer_gemeldet: int | None = None
messpunkt: str = "durchgang-1"
dauer_sekunden: Decimal = Field(gt=0, decimal_places=2, description="vom Geraet berechnet")
gemessen_am: datetime
monotonic_ns: int | None = None
roh: dict | None = None
class MessungBatch(BaseModel):
geraet: str | None = Field(default=None, description="Kennung, informativ")
messungen: list[MessungEin] = Field(min_length=1)
class MessungQuittung(BaseModel):
id: uuid.UUID
status: str # angenommen | duplikat | unzugeordnet | unplausibel | fehler
start_id: int | None = None
hinweis: str | None = None
class BatchAntwort(BaseModel):
quittungen: list[MessungQuittung]
angenommen: int
duplikate: int
unzugeordnet: int
unplausibel: int
class VerwerfenEin(BaseModel):
grund: str = Field(min_length=1)
src/oamc/schemas/ingest.py
+112
View File
@@ -0,0 +1,112 @@
"""Schemata der Ingest-API (POST /api/v1/..., X-API-Key). Plan §6.1."""
from __future__ import annotations
from datetime import date
from decimal import Decimal
from pydantic import BaseModel, Field, model_validator
from oamc.models.enums import Geschlecht, StartStatus
class FahrerRef(BaseModel):
"""Fahrerangabe in einem Bulk-Upload — wird gegen die Stammdaten gematcht."""
nachname: str
vorname: str
geburtsjahr: int | None = Field(default=None, ge=1930, le=date.today().year)
geschlecht: Geschlecht | None = None
verein: str | None = None
fahrer_id: int | None = Field(default=None, description="wenn bekannt: direkter Treffer")
class VeranstaltungCreate(BaseModel):
datum: date
titel: str
ort: str | None = None
ausrichter_verein: str | None = None
ist_doppelturnier: bool = False
veranstaltungsleiter: str | None = None
turnierleiter: str | None = None
class TurnierCreate(BaseModel):
veranstaltung_id: int
name: str
veranstalter_verein: str | None = None
zaehlt_meisterschaft: bool = True
class StartCreate(BaseModel):
startnummer: int = Field(ge=1)
fahrer: FahrerRef
klasse: str = Field(description='Klassencode, z. B. "J 2", "S 6"')
wertungsklasse: str | None = None
fahrzeug: str | None = None
nenngeld_bezahlt: bool = False
nennreihenfolge: int | None = None
status: StartStatus = StartStatus.GENANNT
class StartBulk(BaseModel):
quelle: str = "manuell"
idempotenz_schluessel: str | None = None
starts: list[StartCreate]
class ErgebnisEintrag(BaseModel):
startnummer: int
fahrer: FahrerRef | None = None
klasse: str | None = None
wertungsklasse: str | None = None
summe_zeit: Decimal | None = Field(default=None, ge=0, decimal_places=2)
summe_fehler: int | None = Field(default=None, ge=0)
zeit_vollstaendig: bool = True
fehler_vollstaendig: bool = True
# optional: Server rechnet nach und meldet Abweichung als Warnung
gesamt_erwartet: Decimal | None = None
platzierung_erwartet: int | None = None
@model_validator(mode="after")
def _mindestens_ein_wert(self):
if self.summe_zeit is None and self.summe_fehler is None:
raise ValueError("Weder summe_zeit noch summe_fehler angegeben")
return self
class ErgebnisBulk(BaseModel):
quelle: str = Field(examples=["excel-auswertung-v3"])
idempotenz_schluessel: str = Field(
examples=["2026-05-31-reinheim-final"],
description="Ein doppelt gesendeter Upload legt keine Dubletten an.",
)
ergebnisse: list[ErgebnisEintrag]
# --- Vorschau-/Ergebnisberichte -----------------------------------------
class FahrerMatchInfo(BaseModel):
startnummer: int
eingabe: str
status: str # exakt | unscharf | neu
fahrer_id: int | None = None
vorschlaege: list[dict] = []
class AbweichungInfo(BaseModel):
startnummer: int | None
feld: str
erwartet: object
berechnet: object
class ImportBericht(BaseModel):
import_job_id: int | None = None
dry_run: bool
angelegt: int = 0
aktualisiert: int = 0
neue_fahrer: int = 0
fahrer_matches: list[FahrerMatchInfo] = []
abweichungen: list[AbweichungInfo] = []
warnungen: list[str] = []
idempotent_uebersprungen: bool = False
src/oamc/security/__init__.py
+22
View File
@@ -0,0 +1,22 @@
"""Authentifizierung: getrennte Profile fuer Ingest-API-Key, Geraete-Token und
interne Benutzer-Session (Plan §6.1, §6.2).
Der Geraete-Token ist NICHT der Auswerter-Login und einzeln sperrbar.
"""
from oamc.security.passwoerter import hash_passwort, pruefe_passwort
from oamc.security.tokens import (
erzeuge_geraete_token,
hash_token,
jwt_erzeugen,
jwt_lesen,
)
__all__ = [
"hash_passwort",
"pruefe_passwort",
"erzeuge_geraete_token",
"hash_token",
"jwt_erzeugen",
"jwt_lesen",
]
src/oamc/security/deps.py
+93
View File
@@ -0,0 +1,93 @@
"""FastAPI-Dependencies fuer die drei Auth-Profile."""
from __future__ import annotations
from datetime import UTC, datetime
from typing import Annotated
from fastapi import Depends, Header, HTTPException, Request, status
from sqlalchemy import select
from sqlalchemy.orm import Session
from oamc.config import get_settings
from oamc.db import get_db
from oamc.models import Benutzer, Geraet
from oamc.models.enums import BenutzerRolle
from oamc.security.tokens import jwt_lesen, token_stimmt
DbDep = Annotated[Session, Depends(get_db)]
# --- Ingest-API-Key (POST /api/v1/...) --------------------------------------
def require_ingest_key(
x_api_key: Annotated[str | None, Header(alias="X-API-Key")] = None,
) -> str:
keys = get_settings().ingest_api_key_set
if not x_api_key or x_api_key not in keys:
raise HTTPException(status.HTTP_401_UNAUTHORIZED, "Ungueltiger oder fehlender X-API-Key")
return x_api_key
IngestKey = Annotated[str, Depends(require_ingest_key)]
# --- Geraete-Token (Mess-Pi) ---------------------------------------------
def require_geraet(
db: DbDep,
authorization: Annotated[str | None, Header()] = None,
) -> Geraet:
if not authorization or not authorization.lower().startswith("bearer "):
raise HTTPException(status.HTTP_401_UNAUTHORIZED, "Bearer-Geraete-Token fehlt")
roh = authorization.split(" ", 1)[1].strip()
geraete = db.scalars(select(Geraet).where(Geraet.aktiv.is_(True))).all()
for g in geraete:
if token_stimmt(roh, g.token_hash):
g.letzte_meldung_am = datetime.now(UTC)
return g
raise HTTPException(status.HTTP_401_UNAUTHORIZED, "Geraete-Token ungueltig oder gesperrt")
GeraetDep = Annotated[Geraet, Depends(require_geraet)]
# --- Interne Benutzer-Session (Cookie-JWT) ------------------------------
def aktueller_benutzer(request: Request, db: DbDep) -> Benutzer | None:
token = request.cookies.get("oamc_session")
if not token:
auth = request.headers.get("authorization", "")
if auth.lower().startswith("bearer "):
token = auth.split(" ", 1)[1]
if not token:
return None
daten = jwt_lesen(token)
if not daten:
return None
b = db.scalars(
select(Benutzer).where(Benutzer.benutzername == daten.get("sub"), Benutzer.aktiv.is_(True))
).first()
return b
BenutzerOpt = Annotated["Benutzer | None", Depends(aktueller_benutzer)]
def require_benutzer(b: BenutzerOpt) -> Benutzer:
if b is None:
raise HTTPException(status.HTTP_401_UNAUTHORIZED, "Anmeldung erforderlich")
return b
def require_auswerter(b: Annotated[Benutzer, Depends(require_benutzer)]) -> Benutzer:
if not b.darf_schreiben:
raise HTTPException(status.HTTP_403_FORBIDDEN, "Auswerter- oder Admin-Rolle erforderlich")
return b
def require_admin(b: Annotated[Benutzer, Depends(require_benutzer)]) -> Benutzer:
if b.rolle != BenutzerRolle.ADMIN:
raise HTTPException(status.HTTP_403_FORBIDDEN, "Admin-Rolle erforderlich")
return b
Auswerter = Annotated[Benutzer, Depends(require_auswerter)]
Admin = Annotated[Benutzer, Depends(require_admin)]
src/oamc/security/passwoerter.py
+29
View File
@@ -0,0 +1,29 @@
"""Passwort-Hashing fuer interne Benutzer.
Direkt ``bcrypt`` (ohne passlib — dessen bcrypt-Backend ist mit bcrypt >= 4.1
inkompatibel). Lange Passwoerter werden vorher per SHA-256 auf 44 Base64-Zeichen
verdichtet, damit die 72-Byte-Grenze von bcrypt nie still abschneidet.
"""
from __future__ import annotations
import base64
import hashlib
import bcrypt
def _vorbereiten(klartext: str) -> bytes:
digest = hashlib.sha256(klartext.encode("utf-8")).digest()
return base64.b64encode(digest) # 44 Bytes, < 72
def hash_passwort(klartext: str) -> str:
return bcrypt.hashpw(_vorbereiten(klartext), bcrypt.gensalt()).decode("ascii")
def pruefe_passwort(klartext: str, hash_wert: str) -> bool:
try:
return bcrypt.checkpw(_vorbereiten(klartext), hash_wert.encode("ascii"))
except (ValueError, TypeError):
return False
src/oamc/security/tokens.py
+51
View File
@@ -0,0 +1,51 @@
"""Geraete-Token (undurchsichtig, gehasht gespeichert) und Benutzer-JWT."""
from __future__ import annotations
import hashlib
import hmac
import secrets
from datetime import UTC, datetime, timedelta
from typing import Any
import jwt
from oamc.config import get_settings
_TOKEN_PREFIX = "oamc_dev_" # nur ein Erkennungsmerkmal, kein Geheimnis
def erzeuge_geraete_token() -> tuple[str, str]:
"""Gibt ``(klartext_token, token_hash)`` zurueck. Der Klartext wird EINMALIG
dem Geraet mitgegeben und nie gespeichert."""
roh = _TOKEN_PREFIX + secrets.token_urlsafe(32)
return roh, hash_token(roh)
def hash_token(roh: str) -> str:
return hashlib.sha256(roh.encode("utf-8")).hexdigest()
def token_stimmt(roh: str, gespeicherter_hash: str) -> bool:
return hmac.compare_digest(hash_token(roh), gespeicherter_hash)
def jwt_erzeugen(subject: str, rolle: str, **extra: Any) -> str:
s = get_settings()
jetzt = datetime.now(UTC)
payload = {
"sub": subject,
"rolle": rolle,
"iat": jetzt,
"exp": jetzt + timedelta(minutes=s.access_token_minutes),
**extra,
}
return jwt.encode(payload, s.secret_key, algorithm="HS256")
def jwt_lesen(token: str) -> dict[str, Any] | None:
try:
return jwt.decode(token, get_settings().secret_key, algorithms=["HS256"])
except jwt.PyJWTError:
return None
src/oamc/seeds/__init__.py
+13
View File
@@ -0,0 +1,13 @@
"""Stammdaten-Seed (AP 1).
``seed_saison_2026`` legt Saison 2026, Klassen J 1-J 5 + S/A, Vereine und die
HTH-Meisterschaften an. Idempotent: mehrfaches Ausfuehren aendert nichts.
Offene Fragen, die den Seed betreffen:
* O-1 Punktetabelle Meisterschaft -> Platzhalter in ``meisterschaft.regelwerk``
* O-2 Zuordnung S 1-S 9 / A 1-A 4 -> Fahrzeugtyp -> ``fahrzeugtyp`` bleibt NULL
"""
from oamc.seeds.saison_2026 import seed_saison_2026
__all__ = ["seed_saison_2026"]
src/oamc/seeds/saison_2026.py
+146
View File
@@ -0,0 +1,146 @@
"""Seed fuer Saison 2026 — abgeleitet aus plan.md §3.2 und §3.4."""
from __future__ import annotations
from sqlalchemy import select
from sqlalchemy.orm import Session
from oamc.meisterschaft.berechnung import PLATZHALTER_PUNKTETABELLE
from oamc.models import Klasse, Meisterschaft, Saison, Verein
from oamc.models.enums import Kategorie
# "Turniere in der Saison" -> "davon gewertet" (Plan §3.4)
STREICHRESULTATE_2026 = {
"12": 8, "11": 8, "10": 8, "9": 7, "8": 6, "7": 5, "6": 4, "5": 3, "4": 2,
}
# Jugendklassen: Einteilung strikt nach Jahrgang (Plan §3.2)
JUGENDKLASSEN = [
("J 1", [2019, 2018, 2017], 110, 5.5, "Kindermotorrad", 7),
("J 2", [2016, 2015], 110, 5.5, "Kindermotorrad", None),
("J 3", [2014, 2013], 125, 11.0, "Mofa / Motorrad / Roller", None),
("J 4", [2012, 2011], 125, 11.0, "Mofa / Motorrad / Roller", None),
("J 5", [2010, 2009, 2008], 125, 11.0, "Mofa / Motorrad / Roller (bis 18. Geburtstag)", None),
]
# Erwachsenenklassen: konkrete Fahrzeugzuordnung ist offene Frage O-2.
STAMMKLASSEN = [f"S {i}" for i in range(1, 10)]
ANFAENGERKLASSEN = [f"A {i}" for i in range(1, 5)]
VEREINE = [
("OAMC Reinheim e.V. im ADAC", "OAMC Reinheim", "ADAC Hessen-Thueringen"),
("MSC Hainstadt", "Hainstadt", "ADAC Hessen-Thueringen"),
("MSC Schotten", "Schotten", "ADAC Hessen-Thueringen"),
("PMS Kassel", "Kassel", "ADAC Hessen-Thueringen"),
]
def _get_or_create(db: Session, model, defaults=None, **kwargs):
obj = db.scalars(select(model).filter_by(**kwargs)).first()
if obj is not None:
return obj, False
obj = model(**kwargs, **(defaults or {}))
db.add(obj)
db.flush()
return obj, True
def seed_saison_2026(db: Session) -> dict[str, int]:
"""Idempotenter Seed. Rueckgabe: Zaehler der neu angelegten Objekte."""
zaehler = {"saison": 0, "verein": 0, "klasse": 0, "meisterschaft": 0}
saison, neu = _get_or_create(
db,
Saison,
jahr=2026,
defaults={
"turnierordnung_version": "MT-D2025 (zu verifizieren, Plan §10)",
"streichresultate_tabelle": STREICHRESULTATE_2026,
"nenngeld_cent": 1000,
"aktiv": True,
},
)
zaehler["saison"] += int(neu)
for name, kurz, gau in VEREINE:
_, neu = _get_or_create(
db, Verein, name=name, defaults={"kurzname": kurz, "adac_gau": gau, "aktiv": True}
)
zaehler["verein"] += int(neu)
sortierung = 0
for code, jahrgaenge, ccm, kw, typ, mindestalter in JUGENDKLASSEN:
sortierung += 1
_, neu = _get_or_create(
db,
Klasse,
saison_jahr=2026,
code=code,
defaults={
"kategorie": Kategorie.JUGEND,
"bezeichnung": f"Jugend {code} (Jahrgang {'/'.join(map(str, jahrgaenge))})",
"jahrgaenge": jahrgaenge,
"ccm_max": ccm,
"kw_max": kw,
"fahrzeugtyp": typ,
"mindestalter_am_veranstaltungstag": mindestalter,
"sortierung": sortierung,
},
)
zaehler["klasse"] += int(neu)
for code in STAMMKLASSEN:
sortierung += 1
_, neu = _get_or_create(
db, Klasse, saison_jahr=2026, code=code,
defaults={
"kategorie": Kategorie.STAMM,
"bezeichnung": f"Stammfahrer {code}",
"fahrzeugtyp": None,
"sortierung": sortierung,
"notiz": "O-2 offen: Fahrzeugtyp/Hubraum/kW noch zuzuordnen",
},
)
zaehler["klasse"] += int(neu)
for code in ANFAENGERKLASSEN:
sortierung += 1
_, neu = _get_or_create(
db, Klasse, saison_jahr=2026, code=code,
defaults={
"kategorie": Kategorie.ANFAENGER,
"bezeichnung": f"Anfaenger {code}",
"fahrzeugtyp": None,
"sortierung": sortierung,
"notiz": "O-2 offen: Fahrzeugtyp/Hubraum/kW noch zuzuordnen",
},
)
zaehler["klasse"] += int(neu)
platzhalter_regelwerk = {
"punkte": {str(k): v for k, v in PLATZHALTER_PUNKTETABELLE.items()},
"_hinweis": "O-1 offen: PLATZHALTER-Punktetabelle, nicht offiziell!",
}
_, neu = _get_or_create(
db, Meisterschaft, saison_jahr=2026, bezeichnung="HTH Erwachsene 2026",
defaults={"kategorie": Kategorie.STAMM, "regelwerk": platzhalter_regelwerk},
)
zaehler["meisterschaft"] += int(neu)
jugendklassen = db.scalars(
select(Klasse).where(Klasse.saison_jahr == 2026, Klasse.kategorie == Kategorie.JUGEND)
).all()
for k in jugendklassen:
_, neu = _get_or_create(
db, Meisterschaft, saison_jahr=2026, bezeichnung=f"HTH Jugend {k.code} 2026",
defaults={
"kategorie": Kategorie.JUGEND,
"klasse_id": k.id,
"regelwerk": platzhalter_regelwerk,
},
)
zaehler["meisterschaft"] += int(neu)
return zaehler
src/oamc/static/css/app.css
+50
View File
@@ -0,0 +1,50 @@
/* OAMC Turnierauswertung — handgeschrieben, keine Build-Pipeline (Plan §5.2) */
:root {
--fg: #1a1a1a; --bg: #fbfbfa; --muted: #666; --line: #e2e2df;
--akzent: #0b5; --akzent-dark: #084; --warn: #b45309; --warn-bg: #fef3c7;
}
* { box-sizing: border-box; }
body { margin: 0; color: var(--fg); background: var(--bg);
font: 16px/1.55 system-ui, -apple-system, "Segoe UI", Roboto, sans-serif; }
a { color: var(--akzent-dark); }
.wrap { max-width: 60rem; margin: 0 auto; padding: 1.5rem 1rem 3rem; }
.topbar { display: flex; flex-wrap: wrap; gap: 1rem; align-items: baseline;
padding: .8rem 1rem; background: #fff; border-bottom: 1px solid var(--line); }
.topbar .brand { font-weight: 800; text-decoration: none; color: var(--fg); }
.topbar nav { display: flex; gap: 1rem; flex-wrap: wrap; }
.foot { border-top: 1px solid var(--line); padding: 1rem; text-align: center;
color: var(--muted); font-size: .85rem; }
h1 { font-size: 1.7rem; margin: .2em 0 .6em; }
h2 { font-size: 1.25rem; margin: 1.4em 0 .4em; }
table { width: 100%; border-collapse: collapse; margin: .5rem 0 1.5rem;
font-variant-numeric: tabular-nums; display: block; overflow-x: auto; }
th, td { text-align: left; padding: .4rem .6rem; border-bottom: 1px solid var(--line); }
th { font-size: .8rem; text-transform: uppercase; letter-spacing: .03em; color: var(--muted); }
td.num, th.num { text-align: right; }
tr.vorlaeufig td { color: var(--muted); font-style: italic; }
.badge { display: inline-block; font-size: .72rem; padding: .05em .5em; border-radius: 1em;
background: #eee; color: #444; vertical-align: middle; }
.hinweis { background: var(--warn-bg); color: var(--warn); padding: .6rem .9rem;
border-radius: .4rem; border: 1px solid #fcd34d; }
.cards { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr)); }
.card { background: #fff; border: 1px solid var(--line); border-radius: .5rem; padding: 1rem; }
.card h2 { margin-top: 0; }
ul.plain { list-style: none; padding: 0; } ul.plain li { margin: .3rem 0; }
.tiles { display: flex; gap: .8rem; flex-wrap: wrap; margin: 1rem 0; }
.tiles a { background: #fff; border: 1px solid var(--line); border-radius: .4rem;
padding: .6rem 1rem; text-decoration: none; }
form.schmal, form.inline { display: flex; gap: .5rem; flex-wrap: wrap; align-items: center; }
form.schmal { flex-direction: column; align-items: stretch; max-width: 22rem; }
label { display: block; }
input, button { font: inherit; padding: .4rem .5rem; border: 1px solid var(--line);
border-radius: .3rem; background: #fff; }
button { background: var(--akzent-dark); color: #fff; border-color: var(--akzent-dark);
cursor: pointer; }
.mini { font-size: .75rem; color: var(--muted); display: inline; }
.ok { color: var(--akzent-dark); } .warn { color: var(--warn); }
kbd { background: #eee; border: 1px solid #ccc; border-radius: .2rem; padding: 0 .3em; }
input[type=search] { width: 100%; max-width: 22rem; margin-bottom: .5rem; }
@media print {
.topbar, .foot, form { display: none; }
a { color: inherit; text-decoration: none; }
}
src/oamc/static/js/htmx.min.js
Vendored
+1
View File
File diff suppressed because one or more lines are too long
src/oamc/templates/anzeige/anzeige.html
+79
View File
@@ -0,0 +1,79 @@
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Anzeige – OAMC Turnier</title>
<style>
:root { color-scheme: dark; }
body { margin: 0; background: #0b0b0c; color: #f4f4f5;
font: 16px/1.4 system-ui, sans-serif; }
.kiosk { min-height: 100vh; display: flex; flex-direction: column; padding: 3vh 4vw; }
.status { font-size: 2vw; opacity: .7; display: flex; justify-content: space-between; }
.status .offline { color: #f87171; font-weight: 700; }
.aktuell { flex: 1; display: flex; flex-direction: column; justify-content: center; }
.nr { font-size: 12vw; font-weight: 800; line-height: 1; }
.name { font-size: 6vw; font-weight: 700; }
.meta { font-size: 3vw; opacity: .8; }
.zeit { font-size: 9vw; font-weight: 800; color: #4ade80; }
.naechste { font-size: 2.4vw; opacity: .85; }
.naechste li { margin: .2em 0; }
</style>
</head>
<body>
<div class="kiosk">
<div class="status">
<span id="turnier">–</span>
<span id="verbindung"></span>
</div>
<div class="aktuell">
<div class="nr" id="nr">–</div>
<div class="zeit" id="zeit"></div>
<div class="meta" id="meta"></div>
</div>
<div class="naechste">
<strong>Nächste Starter</strong>
<ol id="naechste"></ol>
</div>
</div>
<script>
const LS_KEY = "oamc_anzeige_letzte";
function render(d) {
document.getElementById("turnier").textContent = d.aktiv ? ("Turnier " + d.turnier) : "kein aktives Turnier";
if (d.letzte_messung) {
document.getElementById("nr").textContent = "Nr. " + (d.letzte_messung.startnummer ?? "?");
document.getElementById("zeit").textContent = d.letzte_messung.dauer_sekunden.toFixed(2).replace(".", ",") + " s";
document.getElementById("meta").textContent = d.letzte_messung.status;
}
const ol = document.getElementById("naechste");
ol.innerHTML = "";
(d.naechste_starter || []).forEach(s => {
const li = document.createElement("li");
li.textContent = `Nr. ${s.startnummer} – ${s.name} (${s.klasse ?? "?"})`;
ol.appendChild(li);
});
}
try {
const cached = localStorage.getItem(LS_KEY);
if (cached) render(JSON.parse(cached));
} catch (e) {}
let es;
function connect() {
es = new EventSource("/api/v1/turniere/aktiv/anzeige");
es.addEventListener("anzeige", ev => {
document.getElementById("verbindung").textContent = "";
const d = JSON.parse(ev.data);
render(d);
try { localStorage.setItem(LS_KEY, JSON.stringify(d)); } catch (e) {}
});
es.onerror = () => {
document.getElementById("verbindung").innerHTML = '<span class="offline">OFFLINE – letzter Stand</span>';
es.close();
setTimeout(connect, 3000);
};
}
connect();
</script>
</body>
</html>
src/oamc/templates/base.html
+29
View File
@@ -0,0 +1,29 @@
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
{% if noindex %}<meta name="robots" content="noindex">{% endif %}
<title>{% block title %}{{ projekt }}{% endblock %}</title>
<link rel="stylesheet" href="/static/css/app.css">
<script src="/static/js/htmx.min.js" defer></script>
</head>
<body>
<header class="topbar">
<a href="/" class="brand">OAMC&nbsp;Turnier</a>
<nav>
<a href="/termine">Termine</a>
<a href="/ergebnisse">Ergebnisse</a>
<a href="/fahrer">Fahrer</a>
<a href="/meisterschaft">Meisterschaft</a>
{% if request.cookies.get('oamc_session') %}<a href="/intern">Intern</a>{% endif %}
</nav>
</header>
<main class="wrap">
{% block content %}{% endblock %}
</main>
<footer class="foot">
<p>OAMC Reinheim e.V. im ADAC · Turnierauswertung · <a href="/docs">API</a> · <a href="/termine.ics">iCal</a></p>
</footer>
</body>
</html>
src/oamc/templates/intern/dashboard.html
+31
View File
@@ -0,0 +1,31 @@
{% extends "base.html" %}
{% block title %}Intern · {{ projekt }}{% endblock %}
{% block content %}
<h1>Intern</h1>
<p>Angemeldet als <strong>{{ benutzer.anzeigename }}</strong> ({{ benutzer.rolle.value }}) ·
<a href="/intern/logout">abmelden</a></p>
{% if hat_offene_messungen %}
<p class="hinweis"><a href="/intern/messungen">Es gibt unzugeordnete oder unplausible
Lichtschranken-Messungen →</a></p>
{% endif %}
<nav class="tiles">
<a href="/intern/messungen">Messungen zuordnen</a>
<a href="/intern/geraete">Geräte</a>
<a href="/docs">API-Doku</a>
</nav>
<h2>Veranstaltungen</h2>
<ul class="plain">
{% for v in veranstaltungen %}
<li>{{ v.datum.strftime('%d.%m.%Y') }} – {{ v.titel }}
{% for t in v.turniere %}
· <a href="/intern/erfassung/{{ t.id }}">Erfassung {{ t.name }}</a>
{% endfor %}
</li>
{% else %}
<li>Keine Veranstaltungen. Anlegen über die Ingest-API (<code>POST /api/v1/veranstaltungen</code>).</li>
{% endfor %}
</ul>
{% endblock %}
src/oamc/templates/intern/erfassung.html
+18
View File
@@ -0,0 +1,18 @@
{% extends "base.html" %}
{% block title %}Erfassung {{ turnier.name }} · {{ projekt }}{% endblock %}
{% block content %}
<h1>Ergebniserfassung – Turnier {{ turnier.name }}</h1>
<p>Zeit im Format <code>159,16</code> · Fehler als Vielfaches von 10 · Haken = Wert endgültig.
Speichern per <kbd>Enter</kbd> im jeweiligen Feld.</p>
<table>
<thead><tr><th>Nr.</th><th>Fahrer</th><th>Klasse</th><th>Zeit</th><th>Fehler</th>
<th>Gesamt</th><th>Platz</th></tr></thead>
<tbody>
{% set turnier_id = turnier.id %}
{% for s in starts %}
{% include "partials/erfassung_zeile.html" with context %}
{% endfor %}
</tbody>
</table>
{% endblock %}
src/oamc/templates/intern/geraete.html
+28
View File
@@ -0,0 +1,28 @@
{% extends "base.html" %}
{% block title %}Geräte · {{ projekt }}{% endblock %}
{% block content %}
<h1>Geräte am Parcours</h1>
<table>
<thead><tr><th>Bezeichnung</th><th>Typ</th><th>aktiv</th><th>Heartbeat</th>
<th class="num">Queue</th><th>Firmware</th></tr></thead>
<tbody>
{% for row in geraete %}
<tr>
<td>{{ row.g.bezeichnung }}</td>
<td>{{ row.g.typ.value }}</td>
<td>{{ 'ja' if row.g.aktiv else 'gesperrt' }}</td>
<td>
{% if row.sekunden is none %}nie
{% elif row.lebt %}<span class="ok">vor {{ row.sekunden }} s</span>
{% else %}<span class="warn">vor {{ row.sekunden }} s</span>{% endif %}
</td>
<td class="num">{{ row.g.queue_laenge_gemeldet if row.g.queue_laenge_gemeldet is not none else '–' }}</td>
<td>{{ row.g.firmware_version or '–' }}</td>
</tr>
{% else %}
<tr><td colspan="6">Keine Geräte registriert. Anlegen via
<code>POST /api/v1/admin/geraete</code>.</td></tr>
{% endfor %}
</tbody>
</table>
{% endblock %}
src/oamc/templates/intern/login.html
+11
View File
@@ -0,0 +1,11 @@
{% extends "base.html" %}
{% block title %}Anmeldung · {{ projekt }}{% endblock %}
{% block content %}
<h1>Interne Anmeldung</h1>
{% if fehler %}<p class="hinweis">{{ fehler }}</p>{% endif %}
<form method="post" action="/intern/login" class="schmal">
<label>Benutzername <input name="benutzername" required autofocus></label>
<label>Passwort <input name="passwort" type="password" required></label>
<button type="submit">Anmelden</button>
</form>
{% endblock %}
src/oamc/templates/intern/messungen.html
+33
View File
@@ -0,0 +1,33 @@
{% extends "base.html" %}
{% block title %}Messungen zuordnen · {{ projekt }}{% endblock %}
{% block content %}
<h1>Messungen zuordnen</h1>
<p>Unzugeordnete und unplausible Lichtschranken-Messungen. Eine gemessene Zeit ist nicht
reproduzierbar – sie wird nur mit Grund verworfen, nie stillschweigend.</p>
<table>
<thead><tr><th>Zeitpunkt</th><th>Turnier</th><th>gemeldete Nr.</th><th>Messpunkt</th>
<th class="num">Dauer</th><th>Status</th><th>Aktion</th></tr></thead>
<tbody>
{% for m in messungen %}
<tr>
<td>{{ m.gemessen_am.strftime('%H:%M:%S') }}</td>
<td>{{ m.turnier_id }}</td>
<td>{{ m.startnummer_gemeldet or '–' }}</td>
<td>{{ m.messpunkt }}</td>
<td class="num">{{ '%.2f' % m.dauer_sekunden }}</td>
<td><span class="badge">{{ m.status.value }}</span></td>
<td>
<form method="post" action="/api/v1/admin/zeitmessungen/{{ m.id }}/zuordnen" class="inline">
<input type="number" name="startnummer" placeholder="Nr." style="width:4rem" required>
<button type="submit">zuordnen</button>
</form>
</td>
</tr>
{% else %}
<tr><td colspan="7">Keine offenen Messungen. 👍</td></tr>
{% endfor %}
</tbody>
</table>
<p class="mini">Hinweis: Die Zuordnen-Aktion nutzt die Admin-API (JSON). Für die
produktive Bedienung wird hier ein HTMX-Formular mit JSON-Encoding ergänzt.</p>
{% endblock %}
src/oamc/templates/partials/erfassung_zeile.html
+23
View File
@@ -0,0 +1,23 @@
<tr id="start-{{ s.id }}">
<td>{{ s.startnummer }}</td>
<td>{{ s.fahrer.voller_name if s.fahrer else '?' }}</td>
<td>{{ s.klasse.code if s.klasse else '–' }}</td>
<td>
<form hx-post="/intern/erfassung/{{ turnier_id }}/start/{{ s.id }}"
hx-target="#start-{{ s.id }}" hx-swap="outerHTML">
<input type="text" name="summe_zeit" inputmode="decimal" style="width:6rem"
value="{{ ('%.2f' % s.ergebnis.summe_zeit)|replace('.', ',') if s.ergebnis and s.ergebnis.summe_zeit is not none else '' }}">
<label class="mini"><input type="checkbox" name="zeit_fertig" value="true"
{{ 'checked' if s.ergebnis and s.ergebnis.zeit_vollstaendig }}> fertig</label>
</td>
<td>
<input type="number" name="summe_fehler" step="10" min="0" style="width:5rem"
value="{{ s.ergebnis.summe_fehler if s.ergebnis and s.ergebnis.summe_fehler is not none else '' }}">
<label class="mini"><input type="checkbox" name="fehler_fertig" value="true"
{{ 'checked' if s.ergebnis and s.ergebnis.fehler_vollstaendig }}> fertig</label>
<button type="submit">OK</button>
</form>
</td>
<td>{{ ('%.2f' % s.ergebnis.gesamt)|replace('.', ',') if s.ergebnis and s.ergebnis.gesamt is not none else '–' }}</td>
<td>{{ s.ergebnis.platzierung if s.ergebnis and s.ergebnis.platzierung is not none else '–' }}</td>
</tr>
src/oamc/templates/partials/fahrer_tabelle.html
+14
View File
@@ -0,0 +1,14 @@
<table id="fahrer-tabelle">
<thead><tr><th>Name</th><th>Jg.</th><th>Verein</th></tr></thead>
<tbody>
{% for f in fahrer %}
<tr>
<td><a href="/fahrer/{{ f.id }}">{{ f.nachname }} {{ f.vorname }}</a></td>
<td>{{ f.geburtsjahr or '–' }}</td>
<td>{{ f.verein.name if f.verein else '–' }}</td>
</tr>
{% else %}
<tr><td colspan="3">Keine Treffer.</td></tr>
{% endfor %}
</tbody>
</table>
src/oamc/templates/public/ergebnisse_liste.html
+19
View File
@@ -0,0 +1,19 @@
{% extends "base.html" %}
{% block title %}Ergebnisse · {{ projekt }}{% endblock %}
{% block content %}
<h1>Ergebnisse</h1>
{% for v in veranstaltungen %}
<section class="card">
<h2>{{ v.datum.strftime('%d.%m.%Y') }} – {{ v.titel }}</h2>
<ul class="plain">
{% for t in v.turniere %}
<li><a href="/ergebnisse/turnier/{{ t.id }}">Turnier {{ t.name }}</a>
<span class="badge">{{ t.status.value }}</span>
· <a href="/ergebnisse/turnier/{{ t.id }}.csv">CSV</a></li>
{% endfor %}
</ul>
</section>
{% else %}
<p>Noch keine Ergebnisse.</p>
{% endfor %}
{% endblock %}
src/oamc/templates/public/ergebnisse_turnier.html
+40
View File
@@ -0,0 +1,40 @@
{% extends "base.html" %}
{% block title %}{{ veranstaltung.titel }} – {{ turnier.name }} · {{ projekt }}{% endblock %}
{% block content %}
<h1>{{ veranstaltung.titel }}</h1>
<p>{{ veranstaltung.datum.strftime('%d.%m.%Y') }} · Turnier <strong>{{ turnier.name }}</strong>
<span class="badge">{{ turnier.status.value }}</span>
· <a href="/ergebnisse/turnier/{{ turnier.id }}.csv">CSV-Export</a></p>
{% if not final %}
<p class="hinweis">Vorläufiger Stand – solange Zeit oder Fehlerpunkte fehlen, ist die
Platzierung nicht endgültig.</p>
{% endif %}
{% for wk in wertungsklassen %}
<h2>{{ wk.wertungsklasse }}</h2>
<table>
<thead><tr>
<th>Platz</th><th>Nr.</th><th>Name</th><th>Verein</th><th>Klasse</th>
<th class="num">Zeit</th><th class="num">Fehler</th><th class="num">Gesamt</th>
</tr></thead>
<tbody>
{% for z in wk.zeilen %}
<tr class="{{ 'vorlaeufig' if z.vorlaeufig else '' }}">
<td>{{ z.platzierung | platz }}</td>
<td>{{ z.startnummer }}</td>
<td>{% if z.fahrer %}<a href="/fahrer/{{ z.fahrer.id }}">{{ z.fahrer.name }}</a>{% endif %}
{% if z.status != 'gestartet' %}<span class="badge">{{ z.status }}</span>{% endif %}</td>
<td>{{ z.fahrer.verein if z.fahrer and z.fahrer.verein else '–' }}</td>
<td>{{ z.klasse or '–' }}</td>
<td class="num">{{ z.summe_zeit | zeit }}</td>
<td class="num">{{ z.summe_fehler if z.summe_fehler is not none else '–' }}</td>
<td class="num"><strong>{{ z.gesamt | zeit }}</strong></td>
</tr>
{% endfor %}
</tbody>
</table>
{% else %}
<p>Für dieses Turnier liegen keine Startdaten vor.</p>
{% endfor %}
{% endblock %}
src/oamc/templates/public/fahrer_liste.html
+9
View File
@@ -0,0 +1,9 @@
{% extends "base.html" %}
{% block title %}Fahrer · {{ projekt }}{% endblock %}
{% block content %}
<h1>Fahrer</h1>
<input type="search" name="q" placeholder="Name suchen…" value="{{ q }}"
hx-get="/fahrer" hx-trigger="keyup changed delay:300ms" hx-target="#fahrer-tabelle"
hx-select="#fahrer-tabelle" hx-swap="outerHTML" autocomplete="off">
{% include "partials/fahrer_tabelle.html" %}
{% endblock %}
src/oamc/templates/public/fahrer_profil.html
+34
View File
@@ -0,0 +1,34 @@
{% extends "base.html" %}
{% block title %}{{ fahrer.anzeigename }} · {{ projekt }}{% endblock %}
{% block content %}
<h1>{{ fahrer.anzeigename }}</h1>
{% if not fahrer.anzeige_anonymisiert %}
<p>{{ fahrer.geburtsjahr or '' }}{% if fahrer.verein %} · {{ fahrer.verein.name }}{% endif %}</p>
{% endif %}
<div class="cards">
<div class="card"><h2>{{ anzahl }}</h2><p>Starts</p></div>
<div class="card"><h2>{{ bestzeit | zeit }}</h2><p>Bestzeit (s)</p></div>
</div>
<h2>Starts</h2>
<table>
<thead><tr><th>Datum</th><th>Veranstaltung</th><th>Turnier</th><th>Klasse</th>
<th class="num">Zeit</th><th class="num">Fehler</th><th class="num">Platz</th></tr></thead>
<tbody>
{% for s in starts %}
<tr>
<td>{{ s.turnier.veranstaltung.datum.strftime('%d.%m.%Y') }}</td>
<td><a href="/ergebnisse/turnier/{{ s.turnier.id }}">{{ s.turnier.veranstaltung.titel }}</a></td>
<td>{{ s.turnier.name }}</td>
<td>{{ s.klasse.code if s.klasse else '–' }}</td>
<td class="num">{{ s.ergebnis.summe_zeit | zeit if s.ergebnis else '–' }}</td>
<td class="num">{{ s.ergebnis.summe_fehler if s.ergebnis and s.ergebnis.summe_fehler is not none else '–' }}</td>
<td class="num">{{ s.ergebnis.platzierung | platz if s.ergebnis else '–' }}</td>
</tr>
{% else %}
<tr><td colspan="7">Keine Starts.</td></tr>
{% endfor %}
</tbody>
</table>
{% endblock %}
src/oamc/templates/public/meisterschaft_detail.html
+31
View File
@@ -0,0 +1,31 @@
{% extends "base.html" %}
{% block title %}Meisterschaftsstand · {{ projekt }}{% endblock %}
{% block content %}
<h1>Meisterschaftsstand</h1>
<p>Saison {{ bericht.saison_jahr }} · Kategorie {{ bericht.kategorie }} ·
{{ bericht.laeufe_gewertet }} von {{ bericht.laeufe_gesamt }} Läufen gewertet
(Rest = Streichresultate)</p>
{% for h in bericht.hinweise %}
<p class="hinweis">{{ h }}</p>
{% endfor %}
<table>
<thead><tr><th>Platz</th><th>Fahrer</th><th class="num">Punkte</th><th class="num">Siege</th>
<th class="num">Streich­resultate</th></tr></thead>
<tbody>
{% for z in bericht.zeilen %}
{% set f = fahrer_map.get(z.fahrer_id) %}
<tr>
<td>{{ z.platz }}</td>
<td>{% if f %}<a href="/fahrer/{{ f.id }}">{{ f.anzeigename }}</a>{% else %}#{{ z.fahrer_id }}{% endif %}</td>
<td class="num">{{ '%.0f' % z.punkte_gesamt }}</td>
<td class="num">{{ z.anzahl_siege }}</td>
<td class="num">{{ z.gestrichene_laeufe | length }}</td>
</tr>
{% else %}
<tr><td colspan="5">Noch keine gewerteten Läufe.</td></tr>
{% endfor %}
</tbody>
</table>
{% endblock %}
src/oamc/templates/public/meisterschaft_liste.html
+13
View File
@@ -0,0 +1,13 @@
{% extends "base.html" %}
{% block title %}Meisterschaft · {{ projekt }}{% endblock %}
{% block content %}
<h1>Meisterschaften</h1>
<ul class="plain">
{% for m in meisterschaften %}
<li><a href="/meisterschaft/{{ m.id }}">{{ m.bezeichnung }}</a>
<span class="badge">{{ m.kategorie.value }}</span></li>
{% else %}
<li>Keine Meisterschaft angelegt.</li>
{% endfor %}
</ul>
{% endblock %}
src/oamc/templates/public/start.html
+40
View File
@@ -0,0 +1,40 @@
{% extends "base.html" %}
{% block content %}
<h1>ADAC Motorrad-Turniere</h1>
<div class="cards">
<section class="card">
<h2>Nächster Termin</h2>
{% if naechste %}
<p><strong>{{ naechste.datum.strftime('%d.%m.%Y') }}</strong><br>
{{ naechste.titel }}{% if naechste.ort %} · {{ naechste.ort }}{% endif %}</p>
{% else %}
<p>Kein Termin geplant.</p>
{% endif %}
<a href="/termine">Alle Termine →</a>
</section>
<section class="card">
<h2>Letzte Ergebnisse</h2>
<ul class="plain">
{% for v in letzte %}
<li><a href="/ergebnisse">{{ v.datum.strftime('%d.%m.%Y') }} – {{ v.titel }}</a>
<span class="badge">{{ v.status.value }}</span></li>
{% else %}
<li>Noch keine Ergebnisse erfasst.</li>
{% endfor %}
</ul>
</section>
<section class="card">
<h2>Meisterschaft</h2>
<ul class="plain">
{% for m in meisterschaften %}
<li><a href="/meisterschaft/{{ m.id }}">{{ m.bezeichnung }}</a></li>
{% else %}
<li>Keine Meisterschaft angelegt.</li>
{% endfor %}
</ul>
</section>
</div>
{% endblock %}
src/oamc/templates/public/termine.html
+22
View File
@@ -0,0 +1,22 @@
{% extends "base.html" %}
{% block title %}Termine · {{ projekt }}{% endblock %}
{% block content %}
<h1>Termine{% if saison %} {{ saison }}{% endif %}</h1>
<p><a href="/termine.ics">iCal-Abo</a></p>
<table>
<thead><tr><th>Datum</th><th>Titel</th><th>Ort</th><th>Meisterschaft</th><th>Status</th></tr></thead>
<tbody>
{% for v in veranstaltungen %}
<tr>
<td>{{ v.datum.strftime('%d.%m.%Y') }}</td>
<td>{{ v.titel }}{% if v.ist_doppelturnier %} <span class="badge">Doppelturnier</span>{% endif %}</td>
<td>{{ v.ort or '–' }}</td>
<td>{% if v.turniere and v.turniere[0].zaehlt_meisterschaft %}mit{% else %}o. M.{% endif %}</td>
<td><span class="badge">{{ v.status.value }}</span></td>
</tr>
{% else %}
<tr><td colspan="5">Keine Termine.</td></tr>
{% endfor %}
</tbody>
</table>
{% endblock %}
src/oamc/wertung/__init__.py
+24
View File
@@ -0,0 +1,24 @@
"""Wertungs-Engine — das Kernstueck (Plan §3.3, AP 2).
Die Wertungsformel ist pro Kategorie und Saison konfigurierbar, nicht fest
verdrahtet. Abnahmetest: die reale Ergebnisliste vom 31.05.2026 muss exakt
reproduziert werden (``tests/test_wertung_regression_2026_05_31.py``).
"""
from oamc.wertung.engine import (
DEFAULT_REGEL_JE_KATEGORIE,
REGELN,
WertungsEingabe,
WertungsErgebnis,
platziere,
regel_fuer,
)
__all__ = [
"WertungsEingabe",
"WertungsErgebnis",
"platziere",
"regel_fuer",
"REGELN",
"DEFAULT_REGEL_JE_KATEGORIE",
]

Some files were not shown because too many files have changed in this diff Show More