Server+Client: REST-API für Entität Projekt, Kontakt auf REST umgestellt, ID-basiertes Laden, CLI-Musterprojekte, VS-Code Task

- Server: ORM-Modell Projekt (Tabelle projekte) mit FK kunden_id, Relationship zu Kunde - Server: Geschäftslogik projekt.py (get/create/update/delete) - Server: DB-Migration V01_02 (projekte-Tabelle) - Server: REST-Endpunkte /xhr/projekt/* mit Autorisierung - Server: CLI init-db legt Muster-Projekte je Kunde an (1-3) - Client: kontakt.ts auf REST umgestellt, In-Memory entfernt, snake_case - Client: projekt.ts auf REST umgestellt, In-Memory behalten für call_log/kontaktadresse - Client: ID-basiertes Laden (nur ID in Route-Params, fetchById im oninit) - Client: Kundenname in Überschrift von Kontaktliste/View und Projektliste/View - Client: Select-Widget entfernt (Kunde voreingestellt), Hidden-Input für kunden_id - Client: kunde.ts showProjekte/showKontakte auf kunden_id geändert - Client: call_log.ts/kontaktadresse.ts Feldzugriffe auf iProjekt snake_case angepasst - AGENTS.md: Vorgehensweise ID-basiertes Laden hinterlegt, Branch-Regel formuliert - VS-Code Task "Flask: init-db" mit venv-Pfaden Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-04 12:03:52 +02:00
1 parent 4b172081b9
commit e04a52857a
@@ -12,7 +12,8 @@ erfolgt ausschließlich über __bind_key__.
 import datetime
 import decimal

-from sqlalchemy import Column, DateTime, Integer, String
+from sqlalchemy import Column, DateTime, ForeignKey, Integer, String
+from sqlalchemy.orm import relationship

 from db import dbapp

@@ -93,4 +94,64 @@ class Kunde(dbapp.Model):
        return columns2dict(self)


+class Kontakt(dbapp.Model):
+    """
+    Ansprechpartner bei einem Kunden. Jeder Kontakt ist genau einem Kunden
+    zugeordnet (kunden_id). Der Kundenname (kunden_name) ist keine eigene
+    Spalte, sondern wird über die Relationship zu Kunde abgeleitet und nur
+    in to_dict() für die JSON-Serialisierung ergänzt.
+    """
+    __tablename__ = 'kontakte'
+    __bind_key__ = BINDKEY
+    id = Column(Integer, primary_key=True)
+    kunden_id = Column(Integer, ForeignKey('kunden.id'), nullable=False)
+    anrede = Column(String(30), nullable=True)
+    name = Column(String(200), nullable=False)
+    position = Column(String(200), nullable=True)
+    telefon = Column(String(100), nullable=True)
+    email = Column(String(200), nullable=True)
+    notiz = Column(String(2000), nullable=True)
+
+    kunde = relationship('Kunde')
+
+    def to_dict(self):
+        """
+        Liefert die Kontaktdaten als Dictionary. Die Tabellenspalten werden
+        über columns2dict serialisiert; kunden_name wird zusätzlich aus der
+        Kunde-Relationship eingefügt.
+        """
+        result = columns2dict(self)
+        result['kunden_name'] = self.kunde.name if self.kunde else None
+        return result
+
+
+class Projekt(dbapp.Model):
+    """
+    Projekt eines Kunden. Jedes Projekt ist genau einem Kunden zugeordnet
+    (kunden_id). Der Kundenname (kunden_name) ist keine eigene Spalte,
+    sondern wird über die Relationship zu Kunde abgeleitet und nur in
+    to_dict() für die JSON-Serialisierung ergänzt.
+    """
+    __tablename__ = 'projekte'
+    __bind_key__ = BINDKEY
+    id = Column(Integer, primary_key=True)
+    kunden_id = Column(Integer, ForeignKey('kunden.id'), nullable=False)
+    projektname = Column(String(200), nullable=False)
+    zweck = Column(String(2000), nullable=True)
+    verantwortlicher = Column(String(200), nullable=True)
+    startdatum = Column(String(20), nullable=True)
+
+    kunde = relationship('Kunde')
+
+    def to_dict(self):
+        """
+        Liefert die Projektdaten als Dictionary. Die Tabellenspalten werden
+        über columns2dict serialisiert; kunden_name wird zusätzlich aus der
+        Kunde-Relationship eingefügt.
+        """
+        result = columns2dict(self)
+        result['kunden_name'] = self.kunde.name if self.kunde else None
+        return result
+
+
 print("########## crm/model importiert")
@@ -43,6 +43,30 @@ def _db_V01_00():
    session.commit()


+def _db_V01_01():
+    """
+    Legt die Tabelle 'kontakte' an. Bei bestehenden Datenbanken, die mit
+    Version 01.00 initialisiert wurden, fehlt diese Tabelle, da das
+    Kontakt-Modell erst nachträglich ergänzt wurde. create_all erzeugt
+    nur fehlende Tabellen, bestehende bleiben unangetastet.
+    """
+    dbapp.create_all(bind_key=BINDKEY)
+    _updatesysteminfo('01.01')
+    session.commit()
+
+
+def _db_V01_02():
+    """
+    Legt die Tabelle 'projekte' an. Bei bestehenden Datenbanken, die mit
+    Version 01.01 initialisiert wurden, fehlt diese Tabelle, da das
+    Projekt-Modell erst nachträglich ergänzt wurde. create_all erzeugt
+    nur fehlende Tabellen, bestehende bleiben unangetastet.
+    """
+    dbapp.create_all(bind_key=BINDKEY)
+    _updatesysteminfo('01.02')
+    session.commit()
+
+
 def checkupdates():
    """
    Ermittelt die aktuelle DB-Version aus der Systeminfo-Tabelle und führt alle
@@ -0,0 +1,120 @@
+"""
+Geschäftslogik für die Entität Kontakt.
+
+Diese Funktionen kapseln den DB-Zugriff und die fachlichen Validierungen.
+Aufgerufen werden sie aus crm/routes.py; die Autorisierungsprüfung erfolgt
+dort über den Decorator authorisation_required.
+
+:author:  Mistral Vibe <vibe@mistral.ai>
+:date:    2026-09-03
+:version: 1.0
+"""
+from db import dbapp
+from crm.model import Kontakt, Kunde
+
+from auth.model.errors import ApplicationError, HtmlStatusCode
+
+session = dbapp.session
+
+
+def get_kontakte():
+    """
+    Liefert alle Kontakte, sortiert nach Name.
+    """
+    return Kontakt.query.order_by(Kontakt.name).all()
+
+
+def get_kontakt(kontakt_id: int) -> Kontakt:
+    """
+    Liefert einen einzelnen Kontakt anhand seiner ID.
+    Wirft ApplicationError (404), falls der Kontakt nicht existiert.
+    """
+    kontakt = Kontakt.query.get(kontakt_id)
+    if kontakt is None:
+        raise ApplicationError(
+            "Kontakt mit der ID {} wurde nicht gefunden.".format(kontakt_id),
+            htmlstatus=HtmlStatusCode.Not_Found,
+        )
+    return kontakt
+
+
+def create_kontakt(data: dict) -> Kontakt:
+    """
+    Legt einen neuen Kontakt an. Die vom Client übergebene ID wird ignoriert;
+    die ID wird serverseitig per Auto-Increment vergeben.
+
+    - data: dict mit den Feldern kunden_id, anrede, name, position, telefon,
+            email, notiz
+    """
+    kunden_id = data.get("kunden_id")
+    if kunden_id is None:
+        raise ApplicationError(
+            "Es muss ein Kunde ausgewählt werden.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kunde = Kunde.query.get(int(kunden_id))
+    if kunde is None:
+        raise ApplicationError(
+            "Der ausgewählte Kunde existiert nicht.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    if not data.get("name") or not str(data["name"]).strip():
+        raise ApplicationError(
+            "Der Kontaktname darf nicht leer sein.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kontakt = Kontakt()
+    kontakt.kunden_id = int(kunden_id)
+    kontakt.anrede = (data.get("anrede") or "").strip() or None
+    kontakt.name = data["name"].strip()
+    kontakt.position = (data.get("position") or "").strip() or None
+    kontakt.telefon = (data.get("telefon") or "").strip() or None
+    kontakt.email = (data.get("email") or "").strip() or None
+    kontakt.notiz = (data.get("notiz") or "").strip() or None
+    session.add(kontakt)
+    session.commit()
+    return kontakt
+
+
+def update_kontakt(data: dict) -> Kontakt:
+    """
+    Aktualisiert einen bestehenden Kontakt. Die ID im data-Dict bestimmt den
+    zu ändernden Datensatz.
+    """
+    kontakt = get_kontakt(data["id"])
+    kunden_id = data.get("kunden_id")
+    if kunden_id is None:
+        raise ApplicationError(
+            "Es muss ein Kunde ausgewählt werden.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kunde = Kunde.query.get(int(kunden_id))
+    if kunde is None:
+        raise ApplicationError(
+            "Der ausgewählte Kunde existiert nicht.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    if not data.get("name") or not str(data["name"]).strip():
+        raise ApplicationError(
+            "Der Kontaktname darf nicht leer sein.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kontakt.kunden_id = int(kunden_id)
+    kontakt.anrede = (data.get("anrede") or "").strip() or None
+    kontakt.name = data["name"].strip()
+    kontakt.position = (data.get("position") or "").strip() or None
+    kontakt.telefon = (data.get("telefon") or "").strip() or None
+    kontakt.email = (data.get("email") or "").strip() or None
+    kontakt.notiz = (data.get("notiz") or "").strip() or None
+    session.commit()
+    return kontakt
+
+
+def delete_kontakt(kontakt_id: int):
+    """
+    Löscht einen Kontakt anhand seiner ID.
+    Wirft ApplicationError (404), falls der Kontakt nicht existiert.
+    """
+    kontakt = get_kontakt(kontakt_id)
+    session.delete(kontakt)
+    session.commit()
@@ -0,0 +1,116 @@
+"""
+Geschäftslogik für die Entität Projekt.
+
+Diese Funktionen kapseln den DB-Zugriff und die fachlichen Validierungen.
+Aufgerufen werden sie aus crm/routes.py; die Autorisierungsprüfung erfolgt
+dort über den Decorator authorisation_required.
+
+:author:  Mistral Vibe <vibe@mistral.ai>
+:date:    2026-09-04
+:version: 1.0
+"""
+from db import dbapp
+from crm.model import Projekt, Kunde
+
+from auth.model.errors import ApplicationError, HtmlStatusCode
+
+session = dbapp.session
+
+
+def get_projekte():
+    """
+    Liefert alle Projekte, sortiert nach projektname.
+    """
+    return Projekt.query.order_by(Projekt.projektname).all()
+
+
+def get_projekt(projekt_id: int) -> Projekt:
+    """
+    Liefert ein einzelnes Projekt anhand seiner ID.
+    Wirft ApplicationError (404), falls das Projekt nicht existiert.
+    """
+    projekt = Projekt.query.get(projekt_id)
+    if projekt is None:
+        raise ApplicationError(
+            "Projekt mit der ID {} wurde nicht gefunden.".format(projekt_id),
+            htmlstatus=HtmlStatusCode.Not_Found,
+        )
+    return projekt
+
+
+def create_projekt(data: dict) -> Projekt:
+    """
+    Legt ein neues Projekt an. Die vom Client übergebene ID wird ignoriert;
+    die ID wird serverseitig per Auto-Increment vergeben.
+
+    - data: dict mit den Feldern kunden_id, projektname, zweck,
+            verantwortlicher, startdatum
+    """
+    kunden_id = data.get("kunden_id")
+    if kunden_id is None:
+        raise ApplicationError(
+            "Es muss ein Kunde ausgewählt werden.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kunde = Kunde.query.get(int(kunden_id))
+    if kunde is None:
+        raise ApplicationError(
+            "Der ausgewählte Kunde existiert nicht.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    if not data.get("projektname") or not str(data["projektname"]).strip():
+        raise ApplicationError(
+            "Der Projektname darf nicht leer sein.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    projekt = Projekt()
+    projekt.kunden_id = int(kunden_id)
+    projekt.projektname = data["projektname"].strip()
+    projekt.zweck = (data.get("zweck") or "").strip() or None
+    projekt.verantwortlicher = (data.get("verantwortlicher") or "").strip() or None
+    projekt.startdatum = (data.get("startdatum") or "").strip() or None
+    session.add(projekt)
+    session.commit()
+    return projekt
+
+
+def update_projekt(data: dict) -> Projekt:
+    """
+    Aktualisiert ein bestehendes Projekt. Die ID im data-Dict bestimmt den
+    zu ändernden Datensatz.
+    """
+    projekt = get_projekt(data["id"])
+    kunden_id = data.get("kunden_id")
+    if kunden_id is None:
+        raise ApplicationError(
+            "Es muss ein Kunde ausgewählt werden.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    kunde = Kunde.query.get(int(kunden_id))
+    if kunde is None:
+        raise ApplicationError(
+            "Der ausgewählte Kunde existiert nicht.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    if not data.get("projektname") or not str(data["projektname"]).strip():
+        raise ApplicationError(
+            "Der Projektname darf nicht leer sein.",
+            htmlstatus=HtmlStatusCode.Bad_Request,
+        )
+    projekt.kunden_id = int(kunden_id)
+    projekt.projektname = data["projektname"].strip()
+    projekt.zweck = (data.get("zweck") or "").strip() or None
+    projekt.verantwortlicher = (data.get("verantwortlicher") or "").strip() or None
+    projekt.startdatum = (data.get("startdatum") or "").strip() or None
+    session.commit()
+    return projekt
+
+
+def delete_projekt(projekt_id: int):
+    """
+    Löscht ein Projekt anhand seiner ID.
+    Wirft ApplicationError (404), falls das Projekt nicht existiert.
+    """
+    projekt = get_projekt(projekt_id)
+    session.delete(projekt)
+    session.commit()
@@ -19,6 +19,8 @@ from flask import jsonify, request
 from auth.decorators import authorisation_required
 from crm.model import KUNDEN_MANAGER, MITARBEITER
 from crm.model import kunde as kunden
+from crm.model import kontakt as kontakte
+from crm.model import projekt as projekte

 print("crm-routes")

@@ -68,4 +70,94 @@ def kunde_delete():
    return jsonify({}), 200


+# --------------------------------------------------------------------------- #
+# Kontakt                                                                      #
+# --------------------------------------------------------------------------- #
+
+
+@app.get("/xhr/kontakt/list")
+@authorisation_required([MITARBEITER, KUNDEN_MANAGER])
+def kontakt_list():
+    """Liefert alle Kontakte als Liste."""
+    result = [k.to_dict() for k in kontakte.get_kontakte()]
+    return jsonify(result), 200
+
+
+@app.get("/xhr/kontakt/get")
+@authorisation_required([MITARBEITER, KUNDEN_MANAGER])
+def kontakt_get():
+    """Liefert einen einzelnen Kontakt anhand seiner ID (Query-Param id)."""
+    kontakt = kontakte.get_kontakt(int(request.args.get("id")))
+    return jsonify(kontakt.to_dict()), 200
+
+
+@app.post("/xhr/kontakt/create")
+@authorisation_required([KUNDEN_MANAGER])
+def kontakt_create():
+    """Legt einen neuen Kontakt an. ID wird serverseitig vergeben."""
+    kontakt = kontakte.create_kontakt(request.json)
+    return jsonify(kontakt.to_dict()), 200
+
+
+@app.put("/xhr/kontakt/update")
+@authorisation_required([KUNDEN_MANAGER])
+def kontakt_update():
+    """Aktualisiert einen bestehenden Kontakt."""
+    kontakt = kontakte.update_kontakt(request.json)
+    return jsonify(kontakt.to_dict()), 200
+
+
+@app.delete("/xhr/kontakt/delete")
+@authorisation_required([KUNDEN_MANAGER])
+def kontakt_delete():
+    """Löscht einen Kontakt anhand seiner ID (Query-Param id)."""
+    kontakte.delete_kontakt(int(request.args.get("id")))
+    return jsonify({}), 200
+
+
+# --------------------------------------------------------------------------- #
+# Projekt                                                                      #
+# --------------------------------------------------------------------------- #
+
+
+@app.get("/xhr/projekt/list")
+@authorisation_required([MITARBEITER, KUNDEN_MANAGER])
+def projekt_list():
+    """Liefert alle Projekte als Liste."""
+    result = [p.to_dict() for p in projekte.get_projekte()]
+    return jsonify(result), 200
+
+
+@app.get("/xhr/projekt/get")
+@authorisation_required([MITARBEITER, KUNDEN_MANAGER])
+def projekt_get():
+    """Liefert ein einzelnes Projekt anhand seiner ID (Query-Param id)."""
+    projekt = projekte.get_projekt(int(request.args.get("id")))
+    return jsonify(projekt.to_dict()), 200
+
+
+@app.post("/xhr/projekt/create")
+@authorisation_required([KUNDEN_MANAGER])
+def projekt_create():
+    """Legt ein neues Projekt an. ID wird serverseitig vergeben."""
+    projekt = projekte.create_projekt(request.json)
+    return jsonify(projekt.to_dict()), 200
+
+
+@app.put("/xhr/projekt/update")
+@authorisation_required([KUNDEN_MANAGER])
+def projekt_update():
+    """Aktualisiert ein bestehendes Projekt."""
+    projekt = projekte.update_projekt(request.json)
+    return jsonify(projekt.to_dict()), 200
+
+
+@app.delete("/xhr/projekt/delete")
+@authorisation_required([KUNDEN_MANAGER])
+def projekt_delete():
+    """Löscht ein Projekt anhand seiner ID (Query-Param id)."""
+    projekte.delete_projekt(int(request.args.get("id")))
+    return jsonify({}), 200
+
+
 print("########## crm.routes importiert")