docs(scanstation(: Full Docs

.gitignore

@@ -1,142 +1,2 @@
-# ---> VisualStudioCode
+.hugo_build.lock
-.vscode/*
+public
-!.vscode/settings.json
-!.vscode/tasks.json
-!.vscode/launch.json
-!.vscode/extensions.json
-!.vscode/i18n-ally-custom-framework.yml
-*.code-workspace
-
-# Local History for Visual Studio Code
-.history/
-
-# ---> Node
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-
-# Diagnostic reports (https://nodejs.org/api/report.html)
-report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-*.lcov
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-web_modules/
-
-# TypeScript cache
-*.tsbuildinfo
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variables file
-.env
-.env.test
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-.parcel-cache
-
-# Next.js build output
-.next
-out
-
-# Nuxt.js build / generate output
-.nuxt
-dist
-
-# Gatsby files
-.cache/
-# Comment in the public line in if your project uses Gatsby and not Next.js
-# https://nextjs.org/blog/next-9-1#public-directory-support
-# public
-
-# vuepress build output
-.vuepress/dist
-
-# Serverless directories
-.serverless/
-
-# FuseBox cache
-.fusebox/
-
-# DynamoDB Local files
-.dynamodb/
-
-# TernJS port file
-.tern-port
-
-# Stores VSCode versions used for testing VSCode extensions
-.vscode-test
-
-# yarn v2
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-.pnp.*
-
-yarn.lock
-package-lock.json
-build
-
-*.sqlite
-*.sqlite-jurnal
-/docs
-lib
-/oss-attribution
-*.tmp
-pnpm-lock.yaml
-.argo/secret.yaml

config.yaml

@@ -0,0 +1,122 @@
+# Configuration
+baseURL: "https://docs.lauf-fuer-kaya.de"
+title: "LfK! Dokumentation"
+
+module:
+  imports:
+    - path: github.com/imfing/hextra
+
+enableRobotsTXT: true
+enableGitInfo: true
+hasCJKLanguage: true
+
+outputs:
+  home: [HTML]
+  page: [HTML]
+  section: [HTML, RSS]
+
+markup:
+  highlight:
+    noClasses: false
+  goldmark:
+    renderer:
+      unsafe: true
+    extensions:
+      passthrough:
+        delimiters:
+          block: [['\[', '\]'], ['$$', '$$']]
+          inline: [['\(', '\)']]
+        enable: true
+
+enableInlineShortcodes: true
+
+defaultContentLanguage: de
+languages:
+  de:
+    languageName: Deutsch
+    languageCode: de
+    title: LfK! Dokumentation
+    weight: 1
+  en:
+    languageName: English
+    languageCode: en
+    title: LfK! Documentation
+    weight: 2
+
+menu:
+  main:
+    - identifier: user
+      name: Anwender
+      pageRef: /user
+      weight: 1
+    - identifier: admin
+      name: Administratoren
+      pageRef: /admin
+      weight: 2
+    - identifier: selfservice
+      name: Selfservice
+      pageRef: /selfservice
+      weight: 3
+    - identifier: scanstation
+      name: Scanerstationen
+      pageRef: /scanstation
+      weight: 4
+    - identifier: beamershow
+      name: Beamershow
+      pageRef: /beamershow
+      weight: 5
+    - name: Suche
+      identifier: search
+      weight: 6
+      params:
+        type: search
+
+  # sidebar:
+  #   - identifier: more
+  #     name: Mehr
+  #     params:
+  #       type: separator
+  #     weight: 2
+  #   - identifier: source
+  #     name: "Source Code"
+  #     url: "https://git.odit.services/lfk"
+
+params:
+  description: Dokumentation für das Lauf für Kaya! Läufersystem.
+
+  navbar:
+    displayTitle: true
+    displayLogo: true
+    logo:
+      path: logo.png
+      dark: logo.png
+      # width: 40
+      # height: 20
+      # link: /
+    width: wide
+  page:
+    width: normal
+  theme:
+    default: system
+    displayToggle: true
+  footer:
+    enable: true
+    displayCopyright: false
+    displayPoweredBy: false
+    width: normal
+  search:
+    enable: true
+    type: flexsearch
+
+    flexsearch:
+      # index page by: content | summary | heading | title
+      index: content
+      # full | forward | reverse | strict
+      # https://github.com/nextapps-de/flexsearch/#tokenizer-prefix-search
+      tokenize: forward
+  highlight:
+    copy:
+      enable: true
+      display: hover
+  comments:
+    enable: false

content/_index.de.md

@@ -0,0 +1,25 @@
+---
+title: Die Dokumentation für das LfK! Läufersystem
+layout: hextra-home
+---
+{{< hextra/hero-badge >}}
+  <div class="hx-w-2 hx-h-2 hx-rounded-full hx-bg-primary-400"></div>
+  <span>Kostenlos, open source</span>
+  {{< icon name="arrow-circle-right" attributes="height=14" >}}
+{{< /hextra/hero-badge >}}
+
+<div class="hx-mt-6 hx-mb-6">
+{{< hextra/hero-headline >}}
+  Dokumentation des LfK! Läufersystems.
+{{< /hextra/hero-headline >}}
+</div>
+
+<div class="hx-mb-12">
+{{< hextra/hero-subtitle >}}
+  Hier findest du alle Informationen, die du benötigst, um das LfK! Läufersystem zu installieren, zu konfigurieren und zu nutzen.
+{{< /hextra/hero-subtitle >}}
+</div>
+
+<div class="hx-mb-6">
+{{< hextra/hero-button text="Schnellstart für Nutzer 👉" link="user" >}}
+</div>

content/_index.en.md

@@ -0,0 +1,25 @@
+---
+title: The Documentation for the LfK! Runner System
+layout: hextra-home
+---
+{{< hextra/hero-badge >}}
+  <div class="hx-w-2 hx-h-2 hx-rounded-full hx-bg-primary-400"></div>
+  <span>Free, open source</span>
+  {{< icon name="arrow-circle-right" attributes="height=14" >}}
+{{< /hextra/hero-badge >}}
+
+<div class="hx-mt-6 hx-mb-6">
+{{< hextra/hero-headline >}}
+  Documentation of the LfK! Runner System.
+{{< /hextra/hero-headline >}}
+</div>
+
+<div class="hx-mb-12">
+{{< hextra/hero-subtitle >}}
+  Here you will find all the information you need to install, configure, and use the LfK! Runner System.
+{{< /hextra/hero-subtitle >}}
+</div>
+
+<div class="hx-mb-6">
+{{< hextra/hero-button text="Quickstart for Users 👉" link="user" >}}
+</div>

content/beamershow/_index.de.md

@@ -0,0 +1,27 @@
+---
+linkTitle: "Beamershow"
+title: Beamershow
+weight: 1
+prev: /
+next: /beamershow/config
+cascade:
+  type: docs
+---
+
+Die Beamershow zeigt live Statistiken zum aktuellen Event an.
+Wie der Name schon andeutet ist sie dafür gedacht mit einem Beamer vor Ort auf eine (Lein)Wand projeziert zu werden.
+
+Sie sollte im Normalfall immer unter `<läufersystem>/beamershow` erreichbar sein, mehr dazu unter [Konfiguration](./config)
+
+## Seiten/Informationen
+
+> Die Beamershow umfasst folgende Seiten/Abschnitte
+
+* Allgemeines
+  * Anzahl an Läufer:innen
+  * Bisher insgesamt erlaufene Kilometer
+  * Aktuelle Spendengesamtsumme
+* Top 10 Läufer nach Distanz
+* Top 10 Läufer nach schnellster Rundenzeit
+* Top 10 Organisationen nach Distanz
+* Top 10 Teams nach Distanz

content/beamershow/_index.en.md

@@ -0,0 +1,27 @@
+---
+linkTitle: "Beamershow"
+title: Beamershow
+weight: 1
+prev: /
+next: /beamershow/config
+cascade:
+  type: docs
+---
+
+The beamer show displays live statistics for the current event.
+As the name suggests, it is intended to be projected on a (screen) wall on-site using a beamer.
+
+It should normally always be accessible under `<läufersystem>/beamershow`, more details can be found under [Configuration](./config).
+
+## Pages/Information
+
+> The beamer show includes the following pages/sections
+
+* General
+  * Number of runners
+  * Total kilometers ran so far
+  * Current total donation amount
+* Top 10 runners by distance
+* Top 10 runners by fastest lap time
+* Top 10 organizations by distance
+* Top 10 teams by distance

content/beamershow/config.de.md

@@ -0,0 +1,18 @@
+---
+title: Beamershow Konfig
+weight: 1
+prev: /beamershow
+---
+
+## Start
+
+Wenn du die Beamershow öffnest wirst du als erstes nach dem API Endpunkt gefragt - diese entspricht der URL des Läufersystems (z.B.: `https://lauf-fuer-kaya.de`).
+Als nächstes musst du noch einen Client Token gefragt, den du von deinem Admin bekommst.
+
+Sobald du den Token eingegeben hast kannst du auf den Button "Konfigurieren" klicken und die Beamershow wird gestartet.
+
+## Konfiguration ändern
+
+Tippe `cnf` auf einer beliebigen Seite der Beamershow.
+
+Du wirst sofort von der Beamershow abbemeldet und kannst so einen neuen API Endpunkt und Client Token angeben.

content/beamershow/config.en.md

@@ -0,0 +1,18 @@
+---
+title: Beamershow Config
+weight: 1
+prev: /beamershow
+---
+
+## Start
+
+When you open the Beamershow, you will first be asked for the API endpoint - this corresponds to the URL of the runner system (e.g., `https://lauf-fuer-kaya.de`).
+Next, you will be asked for a client token, which you will receive from your admin.
+
+Once you have entered the token, you can click the "Configure" button and the Beamershow will start.
+
+## Change Configuration
+
+Type `cnf` on any page of the Beamershow.
+
+You will be immediately logged out of the Beamershow and can then enter a new API endpoint and client token.

content/scanstation/_index.de.md

@@ -0,0 +1,37 @@
+---
+linkTitle: "Scannerstationen"
+title: Über die Scannerstationen
+weight: 1
+prev: /
+next: /scanstation/install
+cascade:
+  type: docs
+---
+
+Die Scannerstation ist die Kombination aus Hardware und Software, die dazu genutzt wird Läuferkarten zu scannen und damit gelaufene Distanzen im System zu erfassen.
+Wir schreiben grundsätzlich keine Hardware oder Software vor - stellen aber selbst eine Software bereit und empfehlen Hardware.
+
+Die API für Scannerstationen im Läufersystem ist grundsätzlich so gestaltet, dass Scans live erfasst und validiert (Läufer, Track, Rundenzeit) werden.
+
+## Bedienung
+
+{{< callout type="info" >}}
+  Die Bedienung kann erst nach der [Konfiguration](./config) erfolgen.
+{{< /callout >}}
+
+
+Die Bedienung der Software als Helfer an der Scannerstation ist relativ einfach.
+
+
+{{% steps %}}
+
+### Scannen
+
+Den Handscanner auf den Barcode der Läuferkarte halten und auf den Bestätigungs-Ton warten.
+
+### Validierung
+
+Schau auf den Bildschirm deiner Scannerstation, ob der Scan valide war.
+Hier wird auch die aktuelle Kilometerzahl und die Rundenzeit angezeigt.
+
+{{% /steps %}}

content/scanstation/_index.en.md

@@ -0,0 +1,35 @@
+---
+linkTitle: "Scannerstationen"
+title: "About the Scanner Stations"
+weight: 1
+prev: /
+next: /scanstation/install
+cascade:
+  type: docs
+---
+
+The scanner station is the combination of hardware and software used to scan runner cards and record the distances run in the system.
+We do not prescribe any specific hardware or software - but we do provide our own software and recommend hardware.
+
+The API for scanner stations in the runner system is designed to capture and validate scans live (runner, track, lap time).
+
+## Operation
+
+{{< callout type="info" >}}
+  Operation can only be performed after [configuration](./config).
+{{< /callout >}}
+
+Operating the software as a helper at the scanner station is relatively simple.
+
+{{% steps %}}
+
+### Scanning
+
+Hold the handheld scanner over the barcode of the runner card and wait for the confirmation tone.
+
+### Validation
+
+Look at the screen of your scanner station to see if the scan was valid.
+The current kilometer count and lap time are also displayed here.
+
+{{% /steps %}}

content/scanstation/config.de.md

@@ -0,0 +1,48 @@
+---
+title: Scannerstation Konfig
+weight: 3
+prev: /scanstation/install
+---
+
+## Start
+
+{{% steps %}}
+
+### API Endpunkt
+
+Wenn du die Scanclient Software öffnest wirst du als erstes nach einem API Endpunkt gefragt.
+Hier musst du die URL deines LfK-Backends eintragen (z.B.: `https://lauf-fuer-kaya.de`).
+
+### Client-Token
+
+Als nächstes musst du noch einen Client Token gefragt.
+Die Anlage ist unter [Token anlegen](/user/scanstation) beschrieben.
+
+### Bestätigen
+
+Solltest du dich beim API-Endpunkt vertippt haben kannst du anstatt eines Client Token auch `rst` eingeben, um diesen nochmal zu setzen.
+Sobald du den Token eingegeben hast kannst du auf den Button "Konfigurieren" klicken und der Scanclient wird gestartet.
+
+{{% /steps %}}
+
+## Konfiguration ändern
+
+{{% steps %}}
+
+### Config-Modus starten
+
+Tippe `cnf` in das Läuferkarten-Feld und bestätige mit Enter.
+
+### Config-Modus
+
+Jetzt öffnet sich die Konfigurationsübersicht, in der alle Details zur Konfigurierten Scannerstation aufgelistet sind.
+
+### Einstellungen speichern
+
+Wenn du fertig bist kannst du über den Button "Back to Scanner" wieder in den Scan-Modus wechseln.
+
+### Abmelden
+
+Wenn du die Software vom Läufersystem abmelden oder den Token ändern willst klicke auf "Log out from this Client".
+
+{{% /steps %}}

content/scanstation/config.en.md

@@ -0,0 +1,48 @@
+---
+title: Scanner Station Configuration
+weight: 3
+prev: /scanstation/install
+---
+
+## Start
+
+{{% steps %}}
+
+### API Endpoint
+
+When you open the Scanclient software, you will first be asked for an API endpoint.
+Here you need to enter the URL of your LfK backend (e.g., `https://lauf-fuer-kaya.de`).
+
+### Client Token
+
+Next, you will be asked for a Client Token.
+The setup is described under [Create Token](/user/scanstation).
+
+### Confirm
+
+If you made a typo in the API endpoint, you can enter `rst` instead of a Client Token to set it again.
+Once you have entered the token, you can click the "Configure" button and the Scanclient will start.
+
+{{% /steps %}}
+
+## Change Configuration
+
+{{% steps %}}
+
+### Start Config Mode
+
+Type `cnf` in the runner card field and press Enter.
+
+### Config Mode
+
+Now the configuration overview opens, listing all the details of the configured scanner station.
+
+### Save Settings
+
+When you are done, you can switch back to scan mode by clicking the "Back to Scanner" button.
+
+### Log Out
+
+If you want to log out the software from the runner system or change the token, click on "Log out from this Client".
+
+{{% /steps %}}

content/scanstation/hardware.de.md

@@ -0,0 +1,19 @@
+---
+title: Hardwareempfehlungen
+weight: 4
+prev: /scanstation/config
+---
+
+Known-good Hardware, die wir für die Scannerstationen empfehlen können.
+
+## Computer
+
+* Raspberry Pi 3 oder neuer
+* Prozessor: Minimum: Intel Core 2 Duo
+* Arbeitsspeicher: Minimum 4GB
+
+## Barcodescanner
+
+* Datalogic Gryphon GD4130-BK/WH USB Scanner (1D)
+* Datalogic Gryphon GD4200 USB Scanner (1D)
+* Datalogic Gryphon GD4400 USB Scanner (2D)

content/scanstation/hardware.en.md

@@ -0,0 +1,19 @@
+---
+title: Hardware Recommendations
+weight: 4
+prev: /scanstation/config
+---
+
+Known-good hardware that we can recommend for the scanning stations.
+
+## Computer
+
+* Raspberry Pi 3 or newer
+* Processor: Minimum: Intel Core 2 Duo
+* Memory: Minimum 4GB
+
+## Barcode Scanner
+
+* Datalogic Gryphon GD4130-BK/WH USB Scanner (1D)
+* Datalogic Gryphon GD4200 USB Scanner (1D)
+* Datalogic Gryphon GD4400 USB Scanner (2D)

content/scanstation/install.de.md

@@ -0,0 +1,71 @@
+---
+title: Scannerstation Installation
+weight: 2
+prev: /scanstation
+next: /scanstation/config
+---
+
+Es gibt aktuell zwei Varianten, um die Scanclient Software zu installieren/nutzen.
+
+1. Als Livesystem starten (empfohlen)
+2. Für Windows oder Linux herunterladen
+
+## Livesystem
+
+{{< callout type="info" >}}
+  Wir empfehlen die Nutzung des Livesystems, da es keine Installation erfordert und immer die aktuellste Version verwendet.
+{{< /callout >}}
+
+{{% steps %}}
+
+### Download
+
+Lade dir die aktuellste Version des Betriebssystems herunter: [Versionsübersicht](https://git.odit.services/lfk/scanclient-live/releases)
+
+* Den neusten (obersten) Release auswählen.
+* Unter "Downloads" die Datei lfk-scanclient-live_X.Y.Z_x64.zip anklicken
+
+### Stick Formatieren
+
+Einen USB-Stick einstecken und als FAT32 formatieren (Achtung: Hierbei gehen alle Daten verloren, die auf dem Stick sind).
+
+### Kopieren und Entpacken
+
+Die ZIP-Datei auf den Stick kopieren und entpacken.
+Du solltest einen neuen Order `slax` erhalten
+
+### Den Stick bootfähig machen
+
+* Windows: Die Datei `USBSTICK\slax\boot\bootinst.bat` als Administrator ausführen
+* Linux/Mac: Die Datei `USBSTICK/slax/boot/bootinst.sh` mit Root-Rechten (sudo) ausführen
+
+### Booten
+
+Den Stick in den Rechner deiner Wahl einstecken und von ihm Starten.
+Bei den meisten Rechner geht das, indem du beim Hochfahren F12 und/oder Entf drückst und dann den USB-Stick auswählst.
+
+{{% /steps %}}
+
+## Windows/Linux
+
+{{% steps %}}
+
+### Herunterladen
+
+Programm aus dem Git Repo herunterladen: [Versionsübersicht](https://git.odit.services/lfk/scanclient-electron/releases)
+
+* Den neusten (obersten) Release auswählen.
+* Unter "Downloads" die Datei für dein Betriebssystem anklicken
+  * Windows: `@lfk-scanclient-electron-win32-x64.zip`
+  * Linux: `@lfk-scanclient-electron-linux-x64.zip`
+
+### Entpacken
+
+Die ZIP-Datei entpacken und den Ordner `lfk-scanclient-electron-win32-x64` öffnen.
+
+### Starten
+
+* Windows: Die Datei `@lfk-scanclient-electron.exe` öffnen.
+* Linux: Die Datei `@lfk-scanclient-electron` öffnen.
+
+{{% /steps %}}

content/scanstation/install.en.md

@@ -0,0 +1,71 @@
+---
+title: Scannerstation Installation
+weight: 2
+prev: /scanstation
+next: /scanstation/config
+---
+
+There are currently two ways to install/use the Scanclient software.
+
+1. Start as a live system (recommended)
+2. Download for Windows or Linux
+
+## Live System
+
+{{< callout type="info" >}}
+  We recommend using the live system as it requires no installation and always uses the latest version.
+{{< /callout >}}
+
+{{% steps %}}
+
+### Download
+
+Download the latest version of the operating system: [Version Overview](https://git.odit.services/lfk/scanclient-live/releases)
+
+* Select the latest (top) release.
+* Under "Downloads" click on the file lfk-scanclient-live_X.Y.Z_x64.zip
+
+### Format Stick
+
+Insert a USB stick and format it as FAT32 (Warning: This will erase all data on the stick).
+
+### Copy and Unzip
+
+Copy the ZIP file to the stick and unzip it.
+You should get a new folder `slax`
+
+### Make the Stick Bootable
+
+* Windows: Run the file `USBSTICK\slax\boot\bootinst.bat` as Administrator
+* Linux/Mac: Run the file `USBSTICK/slax/boot/bootinst.sh` with root privileges (sudo)
+
+### Boot
+
+Insert the stick into the computer of your choice and boot from it.
+On most computers, you can do this by pressing F12 and/or Delete during startup and then selecting the USB stick.
+
+{{% /steps %}}
+
+## Windows/Linux
+
+{{% steps %}}
+
+### Download
+
+Download the program from the Git repo: [Version Overview](https://git.odit.services/lfk/scanclient-electron/releases)
+
+* Select the latest (top) release.
+* Under "Downloads" click on the file for your operating system
+  * Windows: `@lfk-scanclient-electron-win32-x64.zip`
+  * Linux: `@lfk-scanclient-electron-linux-x64.zip`
+
+### Unzip
+
+Unzip the ZIP file and open the folder `lfk-scanclient-electron-win32-x64`.
+
+### Start
+
+* Windows: Open the file `@lfk-scanclient-electron.exe`.
+* Linux: Open the file `@lfk-scanclient-electron`.
+
+{{% /steps %}}

content/selfservice/_index.de.md

@@ -0,0 +1,23 @@
+---
+linkTitle: "Selfservice"
+title: Einleitung
+weight: 1
+prev: /
+next: /selfservice/orgs
+cascade:
+  type: docs
+---
+
+Der Selfservice bietet Läufer:innen sich selbst für den Lauf zu registrieren und ihre eigenen Daten einzusehen.
+
+Genauer gibt es folgende Funktionen:
+
+* Registrierung für Bürgerläufer
+* Registrierung für Firmenläufer
+* Einsehen der eigenen Daten
+  * Stammdaten: Vorname, Mittelname, Nachname, E-Mail Adresse, Telefonnummer
+  * Rundenzeiten
+* Herunterladen der eigenen Läuferurkunde
+* Restloses löschen der eigenen Daten aus dem System
+
+Achtung: Damit der Selfservice für Bürgerläufer funktioniert, muss die automatisch generierte Bürgerlauf-Organisation existieren!

content/selfservice/_index.en.md

@@ -0,0 +1,23 @@
+---
+linkTitle: "Selfservice"
+title: Introduction
+weight: 1
+prev: /
+next: /selfservice/orgs
+cascade:
+  type: docs
+---
+
+The self-service allows runners to register themselves for the run and view their own data.
+
+It includes (but is not limited to) the following functions:
+
+* Registration for citizen runners
+* Registration for corporate runners
+* Viewing a runner's own data
+  * General data: First name, middle name, last name, email address, phone number
+  * Lap times
+* Download a runner certificate
+* Completely delete a runner's data from the system (GDPR compliant)
+
+Note: For the self-service to work for citizen runners, the automatically generated citizen run organization must exist!

content/selfservice/orgs.de.md

@@ -0,0 +1,35 @@
+---
+title: Selfservice für Organisationen
+weight: 1
+prev: /selfservice
+---
+
+Läufer:innen von Firmen und andere Institutionen können sich über den Selfservice für den Lauf registrieren.
+So werden sie automatisch im System angelegt und bekommen per Mail einen Link zugesendet, mit dem sie ihre persönlichen Daten und Rundenzeiten ansehen können.
+
+## Selfservice für eine Organisations freischalten
+
+{{< callout type="warning" >}}
+  Nur Teammitglider können Organisationen für die Registrierung über den Selfservice freischalten.
+  Solltest du zu einer Organisation gehören, die sich freischalten lassen will wende dich bitte an das Laufteam.
+{{< /callout >}}
+
+{{% steps %}}
+
+### Org-Übersicht
+
+Rufe im Läufersystem die Seite `Organisationen auf`
+
+### Org-Details
+
+Klicke für die gewünschte Organisation auf den Button `Details`
+
+### Selfservice aktivieren
+
+Setze einen Haken bei `Selfservice Registrierung`, falls dieser noch nicht gesetzt ist und klicke auf `Änderungen speichern`
+
+### Link Teilen
+
+Kopiere den Registrierungslink für die Organisation
+
+{{% /steps %}}

content/selfservice/orgs.en.md

@@ -0,0 +1,34 @@
+---
+title: Selfservice for organizations
+weight: 1
+prev: /selfservice
+---
+
+Runners from companies and other institutions can register for the run through the self-service. They will be automatically added to the system and receive a link via email to view their personal data and lap times.
+
+## Enable Self-service for an Organization
+
+{{< callout type="warning" >}}
+  Only team members can enable organizations for registration through the self-service.
+  If you belong to an organization that wants to use the selfservice, please contact the team.
+{{< /callout >}}
+
+{{% steps %}}
+
+### Org Overview
+
+Open the `Organizations` page in the runner system
+
+### Org Details
+
+Click the `Details` button for the desired organization
+
+### Enable Self-service
+
+Check the `Self-service Registration` box if it is not already checked and click `Save changes`
+
+### Share Link
+
+Copy the registration link for the organization
+
+{{% /steps %}}

content/user/_index.de.md

@@ -0,0 +1,17 @@
+---
+linkTitle: "Nutzerdokumentation"
+title: Einleitung
+cascade:
+  type: docs
+---
+Dieser Teil der Dokumentation befasst sich mit der Bedienung des Läufersystems für normale Nutzer:innen.
+Solltest du an der Installation oder Konfiguration interessiert sein schau doch mal in den [Admin](/admins) Bereich.
+
+## FAQ
+
+> Ein paar der meist gestellten Fragen vorab
+
+### Warum sehe ich eine Seite nicht?
+
+Nutzer sehen nur die Seiten im System, für die sie Berechtigungen haben.
+Solltest du eine Seite nicht sehen, die du brauchst melde dich bitte bei deinem Admin.

go.mod

@@ -0,0 +1,5 @@
+module git.odit.services/lfk/docs
+
+go 1.23.4
+
+require github.com/imfing/hextra v0.9.3 // indirect

go.sum

@@ -0,0 +1,2 @@
+github.com/imfing/hextra v0.9.3 h1:p4vDm2TSgt3RpJdJm2mqkpoJCH2S08wzySyyYodtgCc=
+github.com/imfing/hextra v0.9.3/go.mod h1:cEfel3lU/bSx7lTE/+uuR4GJaphyOyiwNR3PTqFTXpI=

i18n/en.yaml

@@ -0,0 +1,6 @@
+user: User
+admin: Administrators
+selfservice: Selfservice
+scanstation: Scaning Stations
+beamershow: Beamer Show
+search: Search

layouts/partials/custom/footer.html

@@ -0,0 +1,4 @@
+<div style="text-align: center; width: 100%;"></div>
+    Made by <a href="https://odit.services/?ref=lfk-docs" target="_blank" rel="noreferrer">ODIT.Services</a> with ❤️ <br>
+    Developed for <a href="https://lauf-fuer-kaya.de" target="_blank" rel="noreferrer">Lauf für Kaya</a> | <a href="https://lauf-fuer-kaya.de/impressum" target="_blank" rel="noreferrer">Imprint</a> | <a href="https://lauf-fuer-kaya.de/datenschutz" target="_blank" rel="noreferrer">Privacy</a>
+</div>

legacy/.gitignore

@@ -0,0 +1,142 @@
+# ---> VisualStudioCode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/i18n-ally-custom-framework.yml
+*.code-workspace
+
+# Local History for Visual Studio Code
+.history/
+
+# ---> Node
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+yarn.lock
+package-lock.json
+build
+
+*.sqlite
+*.sqlite-jurnal
+/docs
+lib
+/oss-attribution
+*.tmp
+pnpm-lock.yaml
+.argo/secret.yaml

static/files/class_with_middlename.csv

@@ -0,0 +1,11 @@
+Vorname;Mittelname;Nachname;Klasse
+Lorem ;Impum;dolor;1A
+sit;;amet;1A
+consetetur;sadipscing;elitr;1A
+Max;;Mustermann;1A
+Maxime;;Mustermann;2A
+Peter;Emanuel ;Lustig;2A
+Robert;;Schmidtt;2A
+Guten;;Morgen;2A
+Wunderschönen;Guten;Morgen;3A
+Tolle;;Ümläütä;3A