florianfederspiel
8c458f4953
All checks were successful
Build and Push Docker Images / verify-docs-sync (push) Successful in 9s
Build and Push Docker Images / build-backend (push) Successful in 14s
Build and Push Docker Images / build-frontend (push) Successful in 13s
Build and Push Docker Images / build-docs (push) Successful in 1m47s
47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
# FEDEO Funktionsdokumentation
|
|
|
|
Diese Dokumentation bildet alle Funktionen der Software zentral ab und ist für die Nutzung in der Nuxt-Content-Docs-Homepage vorbereitet.
|
|
|
|
## Ziel
|
|
|
|
- Vollständige Übersicht über Funktionen in Backend, Web-Frontend und Mobile-App
|
|
- Nachvollziehbare Versionierung der Doku
|
|
- Einfache Aktualisierung bei Funktionsänderungen
|
|
|
|
## Struktur
|
|
|
|
- `docs/funktionen/uebersicht.md`: Fachliche Gesamtübersicht der Bereiche
|
|
- `docs/funktionen/backend-api.md`: Automatisch erzeugte API-Funktionsliste
|
|
- `docs/funktionen/frontend-web.md`: Automatisch erzeugte Seiten-/Funktionsliste des Web-Frontends
|
|
- `docs/funktionen/mobile-app.md`: Automatisch erzeugte Screens-/Funktionsliste der Mobile-App
|
|
- `docs/versionen/docs-versionen.md`: Versionierung der Dokumentation
|
|
- `docs/wartung/dokumentationsprozess.md`: Prozess, damit die Doku dauerhaft aktuell bleibt
|
|
- `docs/scripts/sync-funktionsdoku.mjs`: Skript zur automatischen Aktualisierung
|
|
|
|
## Aktualisierung bei Funktionsänderungen
|
|
|
|
Bei jeder Funktionsänderung bitte ausführen:
|
|
|
|
```bash
|
|
node docs/scripts/sync-funktionsdoku.mjs
|
|
```
|
|
|
|
Danach:
|
|
|
|
1. Änderungen in `docs/funktionen/*.md` prüfen
|
|
2. Falls nötig fachliche Texte in `docs/funktionen/uebersicht.md` ergänzen
|
|
3. Eintrag in `docs/versionen/docs-versionen.md` ergänzen
|
|
4. Alles gemeinsam committen
|
|
|
|
## Verwendung mit Nuxt Content
|
|
|
|
Empfohlene Vorgehensweise:
|
|
|
|
1. `docs/` in das Content-Verzeichnis übernehmen (oder per Sync einbinden)
|
|
2. Navigation anhand der Ordner `funktionen`, `wartung`, `versionen` aufbauen
|
|
3. `backend-api.md`, `frontend-web.md`, `mobile-app.md` als referenzierende Funktionskataloge einbinden
|
|
|
|
## Hinweis
|
|
|
|
Die Dateien `backend-api.md`, `frontend-web.md` und `mobile-app.md` werden automatisch generiert. Manuelle Änderungen in diesen Dateien werden bei der nächsten Synchronisation überschrieben.
|