import ulid from sqlalchemy import Column, String, Numeric, Boolean, DateTime, ForeignKey, Index from sqlalchemy.sql import func from sqlalchemy.orm import relationship from app.core.database.db_session import Base class CustomerWallet(Base): __tablename__ = "customer_wallets" wallet_id = Column(String(26), primary_key=True, default=lambda: str(ulid.ULID())) customer_id = Column(String(26), ForeignKey("ecom_customers.customer_id", ondelete="CASCADE"), unique=True, nullable=False, index=True) active_balance = Column(Numeric(10, 2), nullable=False, default=0.00) pending_balance = Column(Numeric(10, 2), nullable=False, default=0.00) lifetime_earned = Column(Numeric(10, 2), nullable=False, default=0.00) lifetime_redeemed = Column(Numeric(10, 2), nullable=False, default=0.00) currency = Column(String(3), nullable=False, default="INR") is_locked = Column(Boolean, nullable=False, default=False) created_at = Column(DateTime, server_default=func.now()) updated_at = Column(DateTime, server_default=func.now(), onupdate=func.now()) # Relationships customer = relationship("EcomCustomer") transactions = relationship("WalletTransaction", back_populates="wallet", cascade="all, delete-orphan", order_by="desc(WalletTransaction.created_at)") class WalletTransaction(Base): __tablename__ = "wallet_transactions" transaction_id = Column(String(26), primary_key=True, default=lambda: str(ulid.ULID())) wallet_id = Column(String(26), ForeignKey("customer_wallets.wallet_id", ondelete="CASCADE"), nullable=False, index=True) customer_id = Column(String(26), ForeignKey("ecom_customers.customer_id", ondelete="CASCADE"), nullable=False, index=True) transaction_type = Column(String(32), nullable=False) # 'EARN', 'REDEEM', 'VOID_RETURN', 'ADJUSTMENT' reference_type = Column(String(32), nullable=False) # 'ORDER', 'SERVICE_JOB', 'MANUAL_ADMIN', 'PURCHASE_REDEMPTION' reference_id = Column(String(50), nullable=False, index=True) reference_no = Column(String(50), nullable=True) # e.g., 'ORD-1234' or 'JOB-5678' base_amount = Column(Numeric(10, 2), nullable=False, default=0.00) percentage_applied = Column(Numeric(5, 2), nullable=True) credit_amount = Column(Numeric(10, 2), nullable=False) status = Column(String(32), nullable=False, default="PENDING", index=True) # 'PENDING', 'MATURED', 'VOIDED', 'EXPIRED' matures_at = Column(DateTime, nullable=False, index=True) matured_at = Column(DateTime, nullable=True) voided_at = Column(DateTime, nullable=True) void_reason = Column(String(255), nullable=True) description = Column(String(255), nullable=True) created_at = Column(DateTime, server_default=func.now()) updated_at = Column(DateTime, server_default=func.now(), onupdate=func.now()) __table_args__ = ( Index('idx_wallet_tx_status_matures', 'status', 'matures_at'), Index('idx_wallet_tx_ref', 'reference_type', 'reference_id'), ) # Relationships wallet = relationship("CustomerWallet", back_populates="transactions")