from sqlalchemy import Column, Integer, String, Boolean, Float, DateTime, ForeignKey, Text from sqlalchemy.orm import relationship from datetime import datetime, timezone from database import Base def _utcnow(): return datetime.now(timezone.utc) class Order(Base): __tablename__ = "orders" id = Column(Integer, primary_key=True, index=True) table_id = Column(Integer, ForeignKey("tables.id"), nullable=True) # nullable for online orders opened_by = Column(Integer, ForeignKey("users.id"), nullable=False) opened_at = Column(DateTime(timezone=True), default=_utcnow) status = Column(String, default="open", nullable=False) # open|partially_paid|paid|closed|cancelled closed_at = Column(DateTime, nullable=True) closed_by = Column(Integer, ForeignKey("users.id"), nullable=True) notes = Column(Text, nullable=True) business_day_id = Column(Integer, ForeignKey("business_days.id"), nullable=True) # KDS kds_status = Column(String, default="pending", nullable=False) # pending|preparing|done kds_status_changed_at = Column(DateTime(timezone=True), nullable=True) order_type = Column(String, default="here", nullable=False) # here|takeaway|delivery # Xenia Connect — online order fields source = Column(String, default="pos", nullable=False) # "pos" | "online" online_order_ref = Column(String, nullable=True) # e.g. "ORD-0042" online_order_cloud_id = Column(Integer, nullable=True) # cloud DB pk for status mirroring online_status = Column(String, nullable=True) # mirrors cloud status online_customer_name = Column(String, nullable=True) online_customer_phone = Column(String, nullable=True) online_customer_address = Column(Text, nullable=True) online_customer_notes = Column(Text, nullable=True) online_order_type = Column(String, nullable=True) # "delivery" | "dine_in" # Phase 2F — customer CRM customer_id = Column(Integer, ForeignKey("customers.id"), nullable=True) # Number of customers at the table for this order customer_count = Column(Integer, nullable=True) # Fiscal printer status: NULL = fiscal was off, "pending" | "success" | "failed" fiscal_status = Column(String, nullable=True) table = relationship("Table", back_populates="orders") opener = relationship("User", foreign_keys=[opened_by], back_populates="orders_opened") closer = relationship("User", foreign_keys=[closed_by], back_populates="orders_closed") customer = relationship("Customer", back_populates="orders", foreign_keys=[customer_id]) items = relationship("OrderItem", back_populates="order", cascade="all, delete-orphan") waiters = relationship("OrderWaiter", back_populates="order", cascade="all, delete-orphan") print_logs = relationship("PrintLog", back_populates="order", cascade="all, delete-orphan") print_jobs = relationship("PrintJob", back_populates="order", cascade="all, delete-orphan") audit_logs = relationship("OrderAuditLog", back_populates="order", cascade="all, delete-orphan") discounts = relationship("OrderDiscount", back_populates="order", cascade="all, delete-orphan") class OrderWaiter(Base): __tablename__ = "order_waiters" id = Column(Integer, primary_key=True, index=True) order_id = Column(Integer, ForeignKey("orders.id"), nullable=False) waiter_id = Column(Integer, ForeignKey("users.id"), nullable=False) assigned_at = Column(DateTime(timezone=True), default=_utcnow) order = relationship("Order", back_populates="waiters") waiter = relationship("User", back_populates="order_assignments") class OrderItem(Base): __tablename__ = "order_items" id = Column(Integer, primary_key=True, index=True) order_id = Column(Integer, ForeignKey("orders.id"), nullable=False) product_id = Column(Integer, ForeignKey("products.id"), nullable=False) added_by = Column(Integer, ForeignKey("users.id"), nullable=False) quantity = Column(Float, nullable=False) unit_price = Column(Float, nullable=False) # price snapshot at time of order selected_options = Column(Text, nullable=True) # JSON array of option ids removed_ingredients = Column(Text, nullable=True) # JSON array of ingredient ids notes = Column(Text, nullable=True) status = Column(String, default="active", nullable=False) # active|paid|cancelled kds_status = Column(String, default="pending", nullable=False) # pending|preparing|done|served|declined added_at = Column(DateTime(timezone=True), default=_utcnow) printed = Column(Boolean, default=False, nullable=False) # Payment tracking paid_by = Column(Integer, ForeignKey("users.id"), nullable=True) paid_at = Column(DateTime, nullable=True) payment_method = Column(String, nullable=True) # 'cash'|'card'|'other' — future use paid_in_shift_id = Column(Integer, ForeignKey("waiter_shifts.id"), nullable=True) # Phase 2A — cost snapshot (copied from product at time of order, never updated) unit_cost = Column(Float, nullable=True) # On-the-fly price adjustment (positive = surcharge, negative = discount) price_adjustment = Column(Float, nullable=False, default=0.0) # Phase 2B — cancellation tracking cancelled_by = Column(Integer, ForeignKey("users.id"), nullable=True) cancelled_at = Column(DateTime(timezone=True), nullable=True) cancel_reason = Column(Text, nullable=True) # KDS decline tracking decline_note = Column(Text, nullable=True) # reason set by kitchen when declining # Courses — optional course assignment for sequenced firing course_id = Column(Integer, nullable=True) # Deal binding — which deal created this item, and which original item it's linked to deal_id = Column(Integer, ForeignKey("deals.id"), nullable=True) linked_item_id = Column(Integer, ForeignKey("order_items.id"), nullable=True) order = relationship("Order", back_populates="items") product = relationship("Product", back_populates="order_items") added_by_user = relationship("User", foreign_keys=[added_by], back_populates="order_items") paid_by_user = relationship("User", foreign_keys=[paid_by], back_populates="items_paid") @property def unit_type(self) -> str: return self.product.unit_type if self.product and self.product.unit_type else "piece" class PrintLog(Base): __tablename__ = "print_log" id = Column(Integer, primary_key=True, index=True) order_id = Column(Integer, ForeignKey("orders.id"), nullable=False) printer_id = Column(Integer, ForeignKey("printers.id"), nullable=False) printed_at = Column(DateTime(timezone=True), default=_utcnow) item_ids = Column(Text, nullable=False) # JSON array of order_item ids success = Column(Boolean, nullable=False) error_message = Column(Text, nullable=True) order = relationship("Order", back_populates="print_logs") printer = relationship("Printer", back_populates="print_logs") class PrintJob(Base): """ One row per (order, printer, zone) print job. Tracks the full lifecycle: pending → success or cancelled. PrintLog rows record each individual attempt. """ __tablename__ = "print_jobs" id = Column(Integer, primary_key=True, index=True) order_id = Column(Integer, ForeignKey("orders.id"), nullable=False) printer_id = Column(Integer, ForeignKey("printers.id"), nullable=False) zone_id = Column(Integer, nullable=True) # prep zone id, NULL for legacy item_ids = Column(Text, nullable=False) # JSON array of order_item ids copies = Column(Integer, nullable=False, default=1) status = Column(String, nullable=False, default="pending") # pending|success|cancelled retry_count = Column(Integer, nullable=False, default=0) first_attempted_at = Column(DateTime(timezone=True), default=_utcnow) last_attempted_at = Column(DateTime(timezone=True), nullable=True) succeeded_at = Column(DateTime(timezone=True), nullable=True) cancelled_at = Column(DateTime(timezone=True), nullable=True) cancel_reason = Column(String, nullable=True) # "staff_cancelled" | "order_closed" order = relationship("Order", back_populates="print_jobs") printer = relationship("Printer", back_populates="print_jobs") class OrderAuditLog(Base): """Immutable append-only audit trail for every action on an order.""" __tablename__ = "order_audit_log" id = Column(Integer, primary_key=True, index=True) order_id = Column(Integer, ForeignKey("orders.id"), nullable=False) event_type = Column(String, nullable=False) # ORDER_OPENED | ITEMS_ADDED | PAYMENT | PAYMENT_OFFLINE | ORDER_CLOSED | ORDER_CANCELLED | ITEM_CANCELLED waiter_id = Column(Integer, ForeignKey("users.id"), nullable=True) item_ids = Column(Text, nullable=True) # JSON list of OrderItem ids amount = Column(Float, nullable=True) # total value for PAYMENT events payment_method = Column(String, nullable=True) note = Column(Text, nullable=True) created_at = Column(DateTime(timezone=True), default=_utcnow) # Emergency offline payment fields offline_uuid = Column(String, nullable=True) # client-generated UUID for dedup offline_at = Column(String, nullable=True) # ISO timestamp from client is_duplicate = Column(Integer, nullable=False, default=0) # 1 = duplicate payment flagged order = relationship("Order", back_populates="audit_logs") waiter = relationship("User") @property def waiter_name(self): return self.waiter.username if self.waiter else None class OrderDiscount(Base): """Records a discount applied to an order or a specific item.""" __tablename__ = "order_discounts" id = Column(Integer, primary_key=True, index=True) order_id = Column(Integer, ForeignKey("orders.id"), nullable=False) item_id = Column(Integer, ForeignKey("order_items.id"), nullable=True) # NULL = whole-order discount discount_type = Column(String, nullable=False) # 'percent' | 'fixed' discount_value = Column(Float, nullable=False) # e.g. 10.0 = 10% or €10.00 applied_by = Column(Integer, ForeignKey("users.id"), nullable=False) applied_at = Column(DateTime(timezone=True), default=_utcnow) reason = Column(Text, nullable=True) order = relationship("Order", back_populates="discounts") item = relationship("OrderItem") applied_by_user = relationship("User")