TorbatYar/backend/services/hospitality/app/models/kitchen.py
Mortezakoohjani 5c6a2e78cf feat(platform): seed service registry, deploy all modules, and fix homepage catalog.
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>
2026-07-27 12:39:51 +03:30

121 lines
4.0 KiB
Python

"""Kitchen aggregates — Phase 12.6.
Kitchen display / ticket routing shell consuming POS tickets and QR
ordering sessions by reference only (source_type + source_id UUID).
"""
from __future__ import annotations
import uuid
from sqlalchemy import Index, Integer, String, Text, UniqueConstraint
from sqlalchemy.orm import Mapped, mapped_column
from app.core.database import Base
from app.models.base import (
ActorAuditMixin,
SoftDeleteMixin,
TenantMixin,
TimestampMixin,
UUIDPrimaryKeyMixin,
)
from app.models.types import (
GUID,
KitchenItemStatus,
KitchenTicketSource,
KitchenTicketStatus,
LifecycleStatus,
)
class KitchenStation(
Base,
UUIDPrimaryKeyMixin,
TenantMixin,
TimestampMixin,
SoftDeleteMixin,
ActorAuditMixin,
):
"""A kitchen preparation station within a venue."""
__tablename__ = "kitchen_stations"
venue_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
code: Mapped[str] = mapped_column(String(50), nullable=False)
name: Mapped[str] = mapped_column(String(255), nullable=False)
status: Mapped[LifecycleStatus] = mapped_column(
default=LifecycleStatus.ACTIVE, nullable=False
)
__table_args__ = (
UniqueConstraint(
"tenant_id", "venue_id", "code", name="uq_kitchen_stations_tenant_venue_code"
),
Index("ix_kitchen_stations_venue", "tenant_id", "venue_id"),
Index("ix_kitchen_stations_tenant_deleted", "tenant_id", "is_deleted"),
)
class KitchenTicket(
Base,
UUIDPrimaryKeyMixin,
TenantMixin,
TimestampMixin,
SoftDeleteMixin,
ActorAuditMixin,
):
"""A kitchen ticket routed from a POS ticket or QR ordering session (by reference only)."""
__tablename__ = "kitchen_tickets"
venue_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
station_id: Mapped[uuid.UUID | None] = mapped_column(GUID(), nullable=True)
source_type: Mapped[KitchenTicketSource] = mapped_column(
default=KitchenTicketSource.POS_TICKET, nullable=False
)
source_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
code: Mapped[str] = mapped_column(String(50), nullable=False)
status: Mapped[KitchenTicketStatus] = mapped_column(
default=KitchenTicketStatus.QUEUED, nullable=False
)
notes: Mapped[str | None] = mapped_column(Text, nullable=True)
__table_args__ = (
UniqueConstraint(
"tenant_id", "venue_id", "code", name="uq_kitchen_tickets_tenant_venue_code"
),
Index("ix_kitchen_tickets_venue", "tenant_id", "venue_id"),
Index("ix_kitchen_tickets_station", "tenant_id", "station_id"),
Index("ix_kitchen_tickets_source", "tenant_id", "source_type", "source_id"),
Index("ix_kitchen_tickets_status", "tenant_id", "status"),
Index("ix_kitchen_tickets_tenant_deleted", "tenant_id", "is_deleted"),
)
class KitchenTicketItem(
Base,
UUIDPrimaryKeyMixin,
TenantMixin,
TimestampMixin,
SoftDeleteMixin,
ActorAuditMixin,
):
"""A single menu-item line on a kitchen ticket."""
__tablename__ = "kitchen_ticket_items"
venue_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
kitchen_ticket_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
menu_item_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
quantity: Mapped[int] = mapped_column(Integer, default=1, nullable=False)
status: Mapped[KitchenItemStatus] = mapped_column(
default=KitchenItemStatus.QUEUED, nullable=False
)
sort_order: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
__table_args__ = (
Index("ix_kitchen_ticket_items_venue", "tenant_id", "venue_id"),
Index("ix_kitchen_ticket_items_ticket", "tenant_id", "kitchen_ticket_id"),
Index("ix_kitchen_ticket_items_status", "tenant_id", "status"),
Index("ix_kitchen_ticket_items_tenant_deleted", "tenant_id", "is_deleted"),
)