Files
kalendar/README.md
2026-10-08 00:38:57 +02:00

25 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Kalender MVP
Ein kleines, eigenständiges Kalender-Modul für MPM. Es zeigt einen Monatskalender, erlaubt Termine anzulegen und speichert sie je MPM-Benutzer getrennt in SQLite.
## Containerbetrieb
MPM installiert das Repository als eigenen Compose-Stack. Der App-Container läuft mit Node.js 24, stellt Port `41002` nur intern bereit und lauscht auf `0.0.0.0`. Die SQLite-Datei liegt unter `MPM_MODULE_DATA_DIR` im persistenten MPM-Modulvolume und überlebt Container- sowie Modul-Neustarts.
## Konfiguration
Der Kalendertitel wird über `CALENDAR_TITLE` gesetzt. Für lokale Entwicklung `.env.example` nach `.env` kopieren. Bei einer Installation über MPM erscheint nach der Installation die Modul-Konfiguration; dort muss der Titel gesetzt werden. MPM übergibt den Wert an den App-Container, eine `.env`-Datei im Repository ist dafür nicht nötig.
## Installation über den MPM-Marketplace
Das öffentliche Repository kann mit der verbundenen Gitea-Instanz direkt aus dem Marketplace installiert werden. `module.json`, `compose.yml` und `Dockerfile` liegen im Repository-Stamm. MPM installiert den Standard-Branch; der Start erfolgt anschließend über die Modulverwaltung.
## Projektstruktur
- `module.json` – MPM-Modulmanifest einschließlich Container-Service
- `compose.yml` – interner App-Service für den Modul-Stack
- `Dockerfile` – Node.js-24-Laufzeit ohne externe npm-Abhängigkeiten
- `backend/server.js` – HTTP- und SQLite-Logik
- `backend/platform-module-sdk.js` – MPM-Gateway-Integration
- `frontend/index.html` – Kalenderoberfläche