ifixkart-admin/Backend/app/models/WalletModel.py
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- Backend: FastAPI app with all models, services, schemas, routes
- Admin Panel: Next.js dashboard with all modules
  (CRM, POS, repairs, warranties, billing, notifications, etc.)
- Ecommerce: storefront (submodule) + product catalog
- AI Agents: .agents/ skill library for Antigravity IDE
- Docs: architecture, billing, notification gateway markdown
- Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
2026-10-13 12:59:47 +05:30

60 lines
3 KiB
Python

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")