Backend:
- New models: Tab, TabEntry, TabPayment (3 new tables)
- Tab: open|closed|forgiven, one open tab per customer enforced
- TabEntry: what went ON the tab (per-item snapshot with description)
- TabPayment: what came OFF the tab; balance = sum(entries) - sum(payments), never stored
- New router /api/tabs/:
- GET / — list open tabs (sorted by balance desc); ?tab_status= override
- GET /{id} — full tab detail with entries + payments
- POST / — open new tab for a customer (400 if one already exists)
- POST /{id}/entries — add entry directly (amount + description)
- POST /{id}/pay — record payment; validates amount <= balance
- POST /{id}/close — close tab (requires balance = 0)
- POST /{id}/forgive — write off remaining balance
- GET /customer/{customer_id} — all tabs for a customer (open first)
- POST /api/orders/{id}/items/{item_id}/tab:
- Requires order has a customer assigned
- Finds or auto-creates open tab for that customer
- Sets order_item.status = "tabbed" (new valid status value)
- Creates TabEntry with auto-generated description
- Broadcasts order_updated SSE event
- Migrations: CREATE TABLE IF NOT EXISTS for tabs, tab_entries, tab_payments
Frontend:
- TabsPage (/tabs): open tabs list sorted by balance; each card shows charges/payments
history, live balance, Πληρωμή modal (defaults to full balance), Κλείσιμο button
(only shown when balance=0), Χάρισμα Υπολοίπου with confirm modal + reason
- CustomersPage CustomerDetail: open tab banner showing balance + entry count
(appears between stats and contact info when customer has an open tab)
- OrderDetailPage: 📋 Καρτέλα button appears on active items when order has a customer;
tabbed items show a 📋 Καρτέλα badge; tabItem mutation calls /items/{id}/tab
- Sidebar: CreditCard icon for Καρτέλες (after Πελάτες)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
59 lines
2.5 KiB
Python
59 lines
2.5 KiB
Python
from sqlalchemy import Column, Integer, String, Boolean, DateTime, Float, ForeignKey, Text
|
|
from sqlalchemy.orm import relationship
|
|
from datetime import datetime, timezone
|
|
from database import Base
|
|
|
|
|
|
def _utcnow():
|
|
return datetime.now(timezone.utc)
|
|
|
|
|
|
class Tab(Base):
|
|
__tablename__ = "tabs"
|
|
|
|
id = Column(Integer, primary_key=True, index=True)
|
|
customer_id = Column(Integer, ForeignKey("customers.id"), nullable=False)
|
|
status = Column(String, default="open", nullable=False) # open | closed | forgiven
|
|
opened_at = Column(DateTime(timezone=True), default=_utcnow)
|
|
closed_at = Column(DateTime(timezone=True), nullable=True)
|
|
closed_by_id = Column(Integer, ForeignKey("users.id"), nullable=True)
|
|
notes = Column(Text, nullable=True)
|
|
|
|
customer = relationship("Customer", foreign_keys=[customer_id])
|
|
closed_by = relationship("User", foreign_keys=[closed_by_id])
|
|
entries = relationship("TabEntry", back_populates="tab", cascade="all, delete-orphan")
|
|
payments = relationship("TabPayment", back_populates="tab", cascade="all, delete-orphan")
|
|
|
|
|
|
class TabEntry(Base):
|
|
"""What went ON the tab — a deferred charge."""
|
|
__tablename__ = "tab_entries"
|
|
|
|
id = Column(Integer, primary_key=True, index=True)
|
|
tab_id = Column(Integer, ForeignKey("tabs.id"), nullable=False)
|
|
order_id = Column(Integer, ForeignKey("orders.id"), nullable=True)
|
|
order_item_id = Column(Integer, ForeignKey("order_items.id"), nullable=True)
|
|
amount = Column(Float, nullable=False) # snapshot at time of tab entry
|
|
description = Column(Text, nullable=True) # auto-generated summary
|
|
created_by_id = Column(Integer, ForeignKey("users.id"), nullable=False)
|
|
created_at = Column(DateTime(timezone=True), default=_utcnow)
|
|
|
|
tab = relationship("Tab", back_populates="entries")
|
|
created_by = relationship("User", foreign_keys=[created_by_id])
|
|
|
|
|
|
class TabPayment(Base):
|
|
"""What came OFF the tab — a payment reducing the balance."""
|
|
__tablename__ = "tab_payments"
|
|
|
|
id = Column(Integer, primary_key=True, index=True)
|
|
tab_id = Column(Integer, ForeignKey("tabs.id"), nullable=False)
|
|
amount = Column(Float, nullable=False)
|
|
payment_method = Column(String, nullable=True) # cash | card | other
|
|
received_by_id = Column(Integer, ForeignKey("users.id"), nullable=False)
|
|
notes = Column(Text, nullable=True)
|
|
created_at = Column(DateTime(timezone=True), default=_utcnow)
|
|
|
|
tab = relationship("Tab", back_populates="payments")
|
|
received_by = relationship("User", foreign_keys=[received_by_id])
|