feat(customers): add dashboard and customer management

2026-07-02 23:37:46 +02:00 · 2026-07-02 23:37:46 +02:00 · 92cb8d1286
commit 92cb8d1286
parent 694b7bd09a
28 changed files with 2521 additions and 13 deletions
--- a/backend/hermes/app/models/customer.py
+++ b/backend/hermes/app/models/customer.py
@ -0,0 +1,92 @@
+from datetime import datetime
+
+from sqlalchemy import Boolean, DateTime, ForeignKey, String, Text, func
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from app.db.database import Base
+
+
+class Customer(Base):
+    __tablename__ = "customers"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    customer_number: Mapped[str] = mapped_column(String(50), unique=True, index=True)
+    company_name: Mapped[str] = mapped_column(String(255), index=True)
+    legal_name: Mapped[str] = mapped_column(String(255), default="", server_default="")
+    customer_type: Mapped[str] = mapped_column(String(50), index=True)
+    status: Mapped[str] = mapped_column(String(50), index=True)
+    industry: Mapped[str] = mapped_column(String(120), default="", server_default="")
+    website: Mapped[str] = mapped_column(String(255), default="", server_default="")
+    email: Mapped[str] = mapped_column(String(255), default="", server_default="")
+    phone: Mapped[str] = mapped_column(String(80), default="", server_default="")
+    tax_number: Mapped[str] = mapped_column(String(120), default="", server_default="")
+    vat_id: Mapped[str] = mapped_column(String(120), default="", server_default="")
+    notes: Mapped[str] = mapped_column(Text, default="", server_default="")
+    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        server_default=func.now(),
+        onupdate=func.now(),
+    )
+
+    addresses: Mapped[list["CustomerAddress"]] = relationship(
+        back_populates="customer",
+        cascade="all, delete-orphan",
+        lazy="selectin",
+    )
+    contacts: Mapped[list["CustomerContact"]] = relationship(
+        back_populates="customer",
+        cascade="all, delete-orphan",
+        lazy="selectin",
+    )
+
+
+class CustomerAddress(Base):
+    __tablename__ = "customer_addresses"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    customer_id: Mapped[int] = mapped_column(
+        ForeignKey("customers.id", ondelete="CASCADE"),
+        index=True,
+    )
+    type: Mapped[str] = mapped_column(String(50), index=True)
+    street: Mapped[str] = mapped_column(String(255), default="", server_default="")
+    postal_code: Mapped[str] = mapped_column(String(30), default="", server_default="")
+    city: Mapped[str] = mapped_column(String(120), default="", server_default="")
+    state: Mapped[str] = mapped_column(String(120), default="", server_default="")
+    country: Mapped[str] = mapped_column(String(120), default="Deutschland", server_default="Deutschland")
+    is_primary: Mapped[bool] = mapped_column(Boolean, default=False, server_default="false")
+    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        server_default=func.now(),
+        onupdate=func.now(),
+    )
+
+    customer: Mapped[Customer] = relationship(back_populates="addresses")
+
+
+class CustomerContact(Base):
+    __tablename__ = "customer_contacts"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    customer_id: Mapped[int] = mapped_column(
+        ForeignKey("customers.id", ondelete="CASCADE"),
+        index=True,
+    )
+    first_name: Mapped[str] = mapped_column(String(100), default="", server_default="")
+    last_name: Mapped[str] = mapped_column(String(100), default="", server_default="")
+    position: Mapped[str] = mapped_column(String(120), default="", server_default="")
+    email: Mapped[str] = mapped_column(String(255), default="", server_default="")
+    phone: Mapped[str] = mapped_column(String(80), default="", server_default="")
+    mobile: Mapped[str] = mapped_column(String(80), default="", server_default="")
+    is_primary: Mapped[bool] = mapped_column(Boolean, default=False, server_default="false")
+    notes: Mapped[str] = mapped_column(Text, default="", server_default="")
+    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        server_default=func.now(),
+        onupdate=func.now(),
+    )
+
+    customer: Mapped[Customer] = relationship(back_populates="contacts")