Vertragsverwaltung

Node.js-Webanwendung zur Verwaltung von Mobilfunk- und Festnetzvertraegen.

Betrieb mit Docker

Die Anwendung wird als Container betrieben und speichert persistente Daten in /app/data.

Initialen Admin setzen

Beim ersten Start wird genau dann ein Admin angelegt, wenn noch keine Benutzer vorhanden sind und diese Umgebungsvariablen gesetzt sind:

• INITIAL_ADMIN_USERNAME
• INITIAL_ADMIN_PASSWORD
• INITIAL_ADMIN_DISPLAY_NAME optional

Beispiel:

INITIAL_ADMIN_USERNAME=admin
INITIAL_ADMIN_PASSWORD=bitte-aendern
INITIAL_ADMIN_DISPLAY_NAME=Administrator

Sobald ein Benutzerbestand vorhanden ist, wird kein weiterer Initial-Admin automatisch erzeugt.

Docker Compose / Dockge

Die mitgelieferte docker-compose.yml ist auf die Gitea-Registry ausgelegt:

services:
  vertragsverwaltung:
    image: git.wilkensxl.de/mrsphay/vertragsverwaltung:latest
    ports:
      - "3000:3000"
    environment:
      HOST: 0.0.0.0
      PORT: 3000
      NODE_ENV: production
      INITIAL_ADMIN_USERNAME: ${INITIAL_ADMIN_USERNAME:-}
      INITIAL_ADMIN_PASSWORD: ${INITIAL_ADMIN_PASSWORD:-}
      INITIAL_ADMIN_DISPLAY_NAME: ${INITIAL_ADMIN_DISPLAY_NAME:-Administrator}
    volumes:
      - vertragsverwaltung-data:/app/data

Fuer Dockge kann statt des benannten Volumes auch ein Host-Pfad verwendet werden:

volumes:
  - /opt/vertragsverwaltung/data:/app/data

Unter Windows entsprechend zum Host passend, zum Beispiel:

volumes:
  - C:\docker\vertragsverwaltung\data:/app/data

Gitea Actions

Der Workflow liegt in docker.yml.

Erwartete Secrets in Gitea:

• REGISTRY_USER
• REGISTRY_PASSWORD

Bei jedem Push auf main wird:

1. das Repository ausgecheckt
2. ein Image git.wilkensxl.de/mrsphay/vertragsverwaltung:latest gebaut
3. das Image in die Gitea-Registry gepusht

Lokaler Start ohne Docker

npm install
npm start

Die Anwendung laeuft dann standardmaessig auf Port 3000.