zammad-form/README.md
2025-01-21 13:00:10 +01:00

1.6 KiB

Zammad Form

Dieses VUE 3 und Python Flask Projekt stellt ein kleines Formular zur Verfügung. Mit diesem Formular können Menschen ohne einen Zugang zu Zammad Tickets erstellen.

Das Projekt enthält ein Dockerfile und eine docker-compose config mit der man den Container erstellen kann.

Entwicklungsumgebung

Zum entwickeln benötigt man Python (>3.8) und nodejs auf dem System. Den Vue Js Dev Server startet man wie folgt:

cd frontend
npm install (das nur einmalig nötig)
npm run dev

Um den Backend Server zu starten, braucht es die beiden Environment Vars ZAMMAD_URL und ZAMMAD_TOKEN. Diese konfiguriert man entweder im System oder per VS Code launch.json Datei

Manuell starten mit auto reload:

cd backend
python app.py

oder mit VS code launch.json:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python Debugger: Flask",
            "type": "debugpy",
            "request": "launch",
            "module": "flask",
            "env": {
                "FLASK_APP": "backend\\app.py",
                "FLASK_DEBUG": "1",
                "FLASK_RUN_PORT": "8080",
                "ZAMMAD_URL": "https://tickets.XXXXX.net/api/v1/",
                "ZAMMAD_TOKEN": "XXXXX"
            },
            "args": [
                "run",
                "--no-debugger",
                "--no-reload"
            ],
            "jinja": true,
            "autoStartBrowser": false
        }
    ]
}

Docker Compose

Container bauen:

docker compose build

Container laufen lassen:

docker compose run (-d)