Benning E-CAD ist eine Flask-Webanwendung mit einer Canvas-basierten Zeichenflaeche im Browser. Der Stack:

Request-Flow

Browser
  └─ GET /ecad/editor/42        → Flask renders editor.html
  └─ POST /api/auth/login       → Flask API Blueprint → SQLAlchemy → SQLite
  └─ PUT /api/pages/1           → Flask → JSON in canvas_data Column
  └─ WS  /socket.io             → SocketIO → In-Memory presence dict
  └─ POST /api/ki/generate      → Flask → DeepSeek API → JSON response

Blueprint-Struktur (routes.py)

Alle API-Endpoints sind in einem einzigen Blueprint api_bp mit Prefix /api registriert. Logische Gruppierung durch Kommentar-Header:

# Sektionen in routes.py:
# AUTH           → /api/auth/*
# PROJECTS       → /api/projects/*
# PAGES          → /api/pages/*
# SYMBOLS        → /api/symbols/*
# TEMPLATES      → /api/templates/*
# EXPORT         → /api/projects/:id/export/*
# BMK            → /api/projects/:id/bmk/*
# KI             → /api/ki/*
# BOM            → /api/projects/:id/bom*
# KLEMMPLAN      → /api/projects/:id/klemmplan*
# QUERVERWEISE   → /api/projects/:id/querverweise
# KABELPLAN      → /api/projects/:id/kabelplan
# KONTAKTSPIEGEL → /api/projects/:id/kontaktspiegel*
# MAKROS         → /api/macros*
# PROJECT-TPL    → /api/project-templates, /api/projects/from-template
# COMPLETE-EXPORT → /api/projects/:id/export/complete

Der gesamte Editor lebt in editor.html und laedt die JS-Module als <script type="module">. Kein Bundler, kein Build-Step.

Option A: SVG-Datei + symbol_index.json (empfohlen fuer globale Symbole)

/opt/vbwork-ecad/app/static/symbols/
└── meine-kategorie/
    └── mein-symbol.svg

ssh root@87.106.42.193
nano /opt/vbwork-ecad/app/static/symbols/symbol_index.json

{
  "categories": [
    {
      "name": "Meine Kategorie",
      "symbols": [
        {
          "name": "Mein Symbol",
          "file": "meine-kategorie/mein-symbol.svg",
          "description": "Beschreibung",
          "iec_number": "IEC 60617-XX",
          "tags": ["tag1", "tag2"]
        }
      ]
    }
  ]
}

cd /opt/vbwork-ecad && docker compose restart

Option B: API (fuer benutzerspezifische Symbole)

POST /api/symbols
Content-Type: application/json

{
  "name": "Mein Symbol",
  "category": "Meine Kategorie",
  "svg_data": "<svg viewBox='0 0 60 60'>...</svg>",
  "description": "Beschreibung",
  "iec_number": "IEC 60617-XX",
  "tags": ["tag1"]
}

Das Symbol wird in der DB gespeichert und ist nur fuer den erstellenden Benutzer sichtbar.

Aktuell sind alle Endpoints in routes.py. Fuer neue Funktionen kann ein separater Blueprint erstellt werden:

# /opt/vbwork-ecad/app/api/mein_api.py

from flask import Blueprint, request, jsonify
from flask_login import login_required, current_user
from .. import db

mein_bp = Blueprint('mein', __name__)

def ok(data=None, status=200):
    return jsonify({'ok': True, 'data': data}), status

def err(msg, status=400):
    return jsonify({'ok': False, 'error': msg}), status

@mein_bp.route('/mein-endpoint', methods=['GET'])
@login_required
def mein_endpoint():
    return ok({'message': 'Hallo'})

# /opt/vbwork-ecad/app/api/__init__.py
from .mein_api import mein_bp

# Entweder eigener Prefix:
app.register_blueprint(mein_bp, url_prefix='/api/mein')

# Oder gleicher api_bp Prefix (dann in mein_api.py api_bp statt mein_bp nutzen):
from .api import api_bp  # importieren und Route dazufuegen

cd /opt/vbwork-ecad && docker compose restart
curl https://vbwork.benning.one/api/mein/mein-endpoint

Test-Setup

# /opt/vbwork-ecad/tests/conftest.py (muss erstellt werden)
import pytest
from app import create_app, db
from app.models import User

@pytest.fixture
def app():
    app = create_app()
    app.config['TESTING'] = True
    app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///:memory:'
    app.config['WTF_CSRF_ENABLED'] = False
    with app.app_context():
        db.create_all()
        yield app
        db.drop_all()

@pytest.fixture
def client(app):
    return app.test_client()

@pytest.fixture
def auth_client(client):
    # Erstelle Testuser und logge ein
    with client.application.app_context():
        u = User(username='test', email='test@test.com')
        u.set_password('test123')
        db.session.add(u)
        db.session.commit()
    client.post('/api/auth/login', json={'username': 'test', 'password': 'test123'})
    return client

Beispiel-Test

# /opt/vbwork-ecad/tests/test_projects.py
def test_create_project(auth_client):
    r = auth_client.post('/api/projects', json={'name': 'Test Projekt'})
    assert r.status_code == 201
    data = r.get_json()
    assert data['ok'] is True
    assert data['data']['name'] == 'Test Projekt'
    assert data['data']['page_count'] == 1  # Erste Seite wird auto-erstellt

def test_project_not_found(auth_client):
    r = auth_client.get('/api/projects/99999')
    assert r.status_code == 404

def test_health(client):
    r = client.get('/api/health')
    assert r.status_code == 200
    assert r.get_json()['data']['status'] == 'ok'

Tests ausfuehren

ssh root@87.106.42.193
cd /opt/vbwork-ecad
docker exec -it vbwork-ecad-app-1 python -m pytest tests/ -v

Produktiv (auf dem VPS)

cd /opt/vbwork-ecad

# Container-Status
docker compose ps

# Logs verfolgen
docker compose logs -f

# Container neu starten (nach Code-Aenderungen)
docker compose restart

# Kompletter Rebuild (nach requirements.txt Aenderungen)
docker compose down
docker compose build --no-cache
docker compose up -d

Lokal (Entwicklung)

# Voraussetzungen: Docker Desktop, git

git clone git@github.com:... /local/vbwork-ecad
cd /local/vbwork-ecad
cp .env.example .env  # DEEPSEEK_API_KEY setzen

docker compose up -d
# App laeuft auf http://localhost:5000

Dockerfile

FROM python:3.12-slim
WORKDIR /app

RUN apt-get update && apt-get install -y --no-install-recommends gcc

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .
RUN chmod +x /app/entrypoint.sh
RUN mkdir -p /app/data /app/app/static/symbols

EXPOSE 5000
CMD ["/app/entrypoint.sh"]

# entrypoint.sh:
# gunicorn -k eventlet -w 1 --bind 0.0.0.0:5000 "app:create_app()"

Volumes

# docker-compose.yml (relevant):
volumes:
  - /opt/vbwork-ecad/data:/app/data        # SQLite-Datenbankdatei
  - /opt/vbwork-ecad/app:/app/app          # Live-Reload fuer Entwicklung