zammad-form/README.md

# 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",
                    "FLASK_ENV": "development",
                    "ZAMMAD_URL": "https://tickets.XXXXX.net/api/v1/",
                    "ZAMMAD_TOKEN": "XXXXX"
                },
                "autoReload": {
                    "enable": true,
                    "pattern": [
                        "**/*.py"
                    ]
                },
                "args": [
                    "run",
                    "--no-debugger"
                ],
                "jinja": true,
                "autoStartBrowser": false
            }
        ]
    }

# Docker Compose

Container bauen:

    docker compose build


Container laufen lassen:

    docker compose run (-d)