Initial commit: Rentman Clone - Phase 0-6 (T001-T023)

Completed: - Phase 0: Project Setup (T001-T003) - Docker Compose, FastAPI skeleton, React SPA - Phase 1: Auth System (T004-T008) - DB models, JWT auth, RBAC middleware, user management - Phase 2: Contacts & Tags (T009-T011) - CRUD API + UI - Phase 3: Equipment Catalog (T012-T014) - Models, API, UI with barcode/QR - Phase 4: Crew Management (T015-T017) - Models, availability, UI - Phase 5: Vehicle Fleet (T018-T020) - Models, assignments, UI - Phase 6: Projects (T021-T023) - Project hierarchy models, CRUD API, list/detail UI
2026-05-31 20:36:42 +00:00
commit 7f7da15965
135 changed files with 18980 additions and 0 deletions
@@ -0,0 +1,85 @@
+"""Contact model for companies and persons."""
+
+import uuid
+from datetime import datetime
+
+from sqlalchemy import String, DateTime, ForeignKey, func, Table, Column
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from app.db.base import Base
+
+# Many-to-many association table: contacts ↔ tags
+contact_tags = Table(
+    "contact_tags",
+    Base.metadata,
+    Column(
+        "contact_id",
+        String(36),
+        ForeignKey("contacts.id", ondelete="CASCADE"),
+        primary_key=True,
+    ),
+    Column(
+        "tag_id",
+        String(36),
+        ForeignKey("tags.id", ondelete="CASCADE"),
+        primary_key=True,
+    ),
+)
+
+
+class Contact(Base):
+    """Represents a contact (company or person) within a tenant account."""
+
+    __tablename__ = "contacts"
+
+    id: Mapped[str] = mapped_column(
+        String(36), primary_key=True, default=lambda: str(uuid.uuid4())
+    )
+    account_id: Mapped[str] = mapped_column(
+        String(36), ForeignKey("accounts.id", ondelete="CASCADE"), nullable=False
+    )
+    type: Mapped[str] = mapped_column(
+        String(10), nullable=False
+    )  # 'company' or 'person'
+    company_name: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    first_name: Mapped[str | None] = mapped_column(String(100), nullable=True)
+    last_name: Mapped[str | None] = mapped_column(String(100), nullable=True)
+    email: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    phone: Mapped[str | None] = mapped_column(String(50), nullable=True)
+    mobile: Mapped[str | None] = mapped_column(String(50), nullable=True)
+    website: Mapped[str | None] = mapped_column(String(500), nullable=True)
+
+    # Billing address
+    billing_street: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    billing_number: Mapped[str | None] = mapped_column(String(20), nullable=True)
+    billing_postalcode: Mapped[str | None] = mapped_column(String(20), nullable=True)
+    billing_city: Mapped[str | None] = mapped_column(String(100), nullable=True)
+    billing_country: Mapped[str | None] = mapped_column(String(100), nullable=True)
+
+    # Shipping address
+    shipping_street: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    shipping_number: Mapped[str | None] = mapped_column(String(20), nullable=True)
+    shipping_postalcode: Mapped[str | None] = mapped_column(String(20), nullable=True)
+    shipping_city: Mapped[str | None] = mapped_column(String(100), nullable=True)
+    shipping_country: Mapped[str | None] = mapped_column(String(100), nullable=True)
+
+    # Additional fields from design.md
+    tax_number: Mapped[str | None] = mapped_column(String(50), nullable=True)
+    note: Mapped[str | None] = mapped_column(String, nullable=True)
+
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), nullable=False
+    )
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        server_default=func.now(),
+        onupdate=func.now(),
+        nullable=False,
+    )
+
+    # Relationships
+    account: Mapped["Account"] = relationship("Account", back_populates="contacts")
+    tags: Mapped[list["Tag"]] = relationship(
+        "Tag", secondary=contact_tags, back_populates="contacts"
+    )
+    # projects_as_customer relationship will be added in Phase 3 when Project model is created