d579d0b142
Add frontend/modules/loyalty with types, API client, design system, feature pages and thin App Router routes under app/loyalty/. BFF proxy at app/api/loyalty/. Include loyalty frontend docs. Co-authored-by: Cursor <cursoragent@cursor.com>
112 lines
3.6 KiB
Python
112 lines
3.6 KiB
Python
"""Customer management aggregates — Phase 14.4."""
|
|
from __future__ import annotations
|
|
|
|
import uuid
|
|
from datetime import datetime
|
|
|
|
from sqlalchemy import DateTime, Index, String, Text, UniqueConstraint
|
|
from sqlalchemy.orm import Mapped, mapped_column
|
|
from sqlalchemy.types import JSON
|
|
|
|
from app.core.database import Base
|
|
from app.models.base import (
|
|
ActorAuditMixin,
|
|
SoftDeleteMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
UUIDPrimaryKeyMixin,
|
|
)
|
|
from app.models.types import GUID, LifecycleStatus
|
|
|
|
|
|
class CustomerProfile(
|
|
Base,
|
|
UUIDPrimaryKeyMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
SoftDeleteMixin,
|
|
ActorAuditMixin,
|
|
):
|
|
__tablename__ = "customer_profiles"
|
|
|
|
organization_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
|
|
code: Mapped[str] = mapped_column(String(50), nullable=False)
|
|
display_name: Mapped[str] = mapped_column(String(255), nullable=False)
|
|
external_crm_contact_ref: Mapped[str | None] = mapped_column(String(100), nullable=True)
|
|
external_user_ref: Mapped[str | None] = mapped_column(String(100), nullable=True)
|
|
mobile: Mapped[str | None] = mapped_column(String(32), nullable=True)
|
|
email: Mapped[str | None] = mapped_column(String(255), nullable=True)
|
|
status: Mapped[LifecycleStatus] = mapped_column(
|
|
default=LifecycleStatus.ACTIVE, nullable=False
|
|
)
|
|
metadata_json: Mapped[dict | None] = mapped_column(JSON, nullable=True)
|
|
|
|
__table_args__ = (
|
|
UniqueConstraint("tenant_id", "code", name="uq_customer_profiles_tenant_code"),
|
|
Index("ix_customer_profiles_org", "tenant_id", "organization_id"),
|
|
)
|
|
|
|
|
|
class CustomerPreference(
|
|
Base,
|
|
UUIDPrimaryKeyMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
SoftDeleteMixin,
|
|
ActorAuditMixin,
|
|
):
|
|
__tablename__ = "customer_preferences"
|
|
|
|
customer_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
|
|
key: Mapped[str] = mapped_column(String(100), nullable=False)
|
|
value: Mapped[dict | None] = mapped_column(JSON, nullable=True)
|
|
|
|
__table_args__ = (
|
|
UniqueConstraint(
|
|
"tenant_id", "customer_id", "key", name="uq_customer_preferences_key"
|
|
),
|
|
Index("ix_customer_preferences_customer", "tenant_id", "customer_id"),
|
|
)
|
|
|
|
|
|
class VisitHistoryEntry(
|
|
Base,
|
|
UUIDPrimaryKeyMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
SoftDeleteMixin,
|
|
ActorAuditMixin,
|
|
):
|
|
__tablename__ = "visit_history_entries"
|
|
|
|
customer_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
|
|
appointment_id: Mapped[uuid.UUID | None] = mapped_column(GUID(), nullable=True)
|
|
service_ref: Mapped[uuid.UUID | None] = mapped_column(GUID(), nullable=True)
|
|
staff_ref: Mapped[str | None] = mapped_column(String(100), nullable=True)
|
|
visited_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), nullable=False)
|
|
notes: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
|
|
__table_args__ = (
|
|
Index("ix_visit_history_entries_customer", "tenant_id", "customer_id"),
|
|
)
|
|
|
|
|
|
class CustomerDocumentRef(
|
|
Base,
|
|
UUIDPrimaryKeyMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
SoftDeleteMixin,
|
|
ActorAuditMixin,
|
|
):
|
|
__tablename__ = "customer_document_refs"
|
|
|
|
customer_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
|
|
title: Mapped[str] = mapped_column(String(255), nullable=False)
|
|
storage_file_ref: Mapped[str] = mapped_column(String(255), nullable=False)
|
|
notes: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
|
|
__table_args__ = (
|
|
Index("ix_customer_document_refs_customer", "tenant_id", "customer_id"),
|
|
)
|