5c6a2e78cf
Register all active platform services and base features in core DB so admin can manage them, add delivery/hospitality/sports-center backend phases, update apps catalog and production deploy tooling. Co-authored-by: Cursor <cursoragent@cursor.com>
91 lines
2.8 KiB
Python
91 lines
2.8 KiB
Python
"""Analytics aggregates — Phase 12.8.
|
|
|
|
Report definitions describe which local metric keys to compute; snapshots
|
|
store a point-in-time metrics payload produced by simple local SQL counts
|
|
(no external analytics engine, no cross-service imports).
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import uuid
|
|
|
|
from sqlalchemy import Index, String
|
|
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 AnalyticsReportDefinition(
|
|
Base,
|
|
UUIDPrimaryKeyMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
SoftDeleteMixin,
|
|
ActorAuditMixin,
|
|
):
|
|
"""A tenant-scoped definition of which local metrics a report tracks."""
|
|
|
|
__tablename__ = "analytics_report_definitions"
|
|
|
|
venue_id: Mapped[uuid.UUID | None] = mapped_column(GUID(), nullable=True)
|
|
code: Mapped[str] = mapped_column(String(50), nullable=False)
|
|
name: Mapped[str] = mapped_column(String(255), nullable=False)
|
|
metric_keys: Mapped[list] = mapped_column(JSON, nullable=False)
|
|
filters: Mapped[dict | None] = mapped_column(JSON, nullable=True)
|
|
status: Mapped[LifecycleStatus] = mapped_column(
|
|
default=LifecycleStatus.ACTIVE, nullable=False
|
|
)
|
|
|
|
__table_args__ = (
|
|
Index(
|
|
"ix_analytics_report_definitions_tenant_code",
|
|
"tenant_id",
|
|
"code",
|
|
unique=True,
|
|
),
|
|
Index("ix_analytics_report_definitions_venue", "tenant_id", "venue_id"),
|
|
Index(
|
|
"ix_analytics_report_definitions_tenant_deleted",
|
|
"tenant_id",
|
|
"is_deleted",
|
|
),
|
|
)
|
|
|
|
|
|
class AnalyticsSnapshot(
|
|
Base,
|
|
UUIDPrimaryKeyMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
SoftDeleteMixin,
|
|
ActorAuditMixin,
|
|
):
|
|
"""A point-in-time computed metrics payload for a report definition."""
|
|
|
|
__tablename__ = "analytics_snapshots"
|
|
|
|
venue_id: Mapped[uuid.UUID | None] = mapped_column(GUID(), nullable=True)
|
|
report_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
|
|
period_start: Mapped[str] = mapped_column(String(32), nullable=False)
|
|
period_end: Mapped[str] = mapped_column(String(32), nullable=False)
|
|
metrics: Mapped[dict] = mapped_column(JSON, nullable=False)
|
|
status: Mapped[LifecycleStatus] = mapped_column(
|
|
default=LifecycleStatus.ACTIVE, nullable=False
|
|
)
|
|
|
|
__table_args__ = (
|
|
Index("ix_analytics_snapshots_venue", "tenant_id", "venue_id"),
|
|
Index("ix_analytics_snapshots_report", "tenant_id", "report_id"),
|
|
Index(
|
|
"ix_analytics_snapshots_tenant_deleted", "tenant_id", "is_deleted"
|
|
),
|
|
)
|