ifixkart-backend/app/models/RefundModel.py
adithiyan 10bfba7d58 feat: add warranties, refunds, notifications, CRM calendar, system config & delivery modules
- New models: WarrantyModel, WalletModel, SystemConfigModel
- New schemas: WarrantySchema, RefundSchema, SystemConfig, CrmTaskCalendar, NotificationTemplate, NotificationGateway, RepairErp, ReviewModeration, InventoryPos, MultiDashboard, BillingFinance
- New services: WarrantyService, RefundService, CrmService, CrmTaskCalendarService, DeliveryService, EmailTemplateService, InventoryPosService, MultiDashboardService, NotificationGatewayService, RepairErpService, ReviewModerationService, SystemConfigService, TemplateService, CreditService
- Updated routers: AdminOrder, BillingFinance, Cart, Catalog, Checkout, Crm, InventoryPos, NotificationGateway, RolePermission, ServiceJob, Settings, Storefront, UserCreation
- Updated models: Inventory, Notification, Order, Product, Service, Setting, SystemConfig, User
- Updated core: database init, invoice generator, main app
- Added WarrantyRouter with full CRUD and claim flow
2026-10-13 22:05:16 +05:30

75 lines
2.9 KiB
Python

from datetime import datetime, timezone
import ulid
from sqlalchemy import Column, String, Float, DateTime, Text, ForeignKey, Enum
from sqlalchemy.orm import relationship
import enum
from app.core.database.db_session import Base
from app.models.audit_base import AuditMixin
class RefundEntityType(str, enum.Enum):
SALES = "SALES"
SERVICE = "SERVICE"
class RefundPaymentMethod(str, enum.Enum):
CASH = "CASH"
ONLINE = "ONLINE"
class RefundStatus(str, enum.Enum):
PENDING = "PENDING"
APPROVED = "APPROVED"
REJECTED = "REJECTED"
PROCESSING = "PROCESSING"
REFUNDED = "REFUNDED"
FAILED = "FAILED"
class RefundRequest(Base, AuditMixin):
__tablename__ = "refund_requests"
refund_id = Column(String(36), primary_key=True, default=lambda: str(ulid.ULID()))
tenant_id = Column(String(36), nullable=False, default="tenant_default", index=True)
location_id = Column(String(36), ForeignKey("crm_locations.location_id", ondelete="RESTRICT"), nullable=False, index=True)
entity_type = Column(String(20), nullable=False) # SALES or SERVICE
entity_id = Column(String(36), nullable=False, index=True) # Order ID or ServiceJob ID
amount = Column(Float, nullable=False)
payment_method = Column(String(20), nullable=False)
status = Column(String(20), nullable=False, default="PENDING")
reason = Column(Text, nullable=True)
part_number_verification = Column(String(255), nullable=True) # For SERVICE
razorpay_refund_id = Column(String(255), nullable=True)
razorpay_refund_status = Column(String(50), nullable=True)
requested_by = Column(String(36), nullable=False)
approved_by = Column(String(36), nullable=True)
rejected_by = Column(String(36), nullable=True)
requested_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
approved_at = Column(DateTime, nullable=True)
rejected_at = Column(DateTime, nullable=True)
refunded_at = Column(DateTime, nullable=True)
rejection_reason = Column(Text, nullable=True)
admin_notes = Column(Text, nullable=True)
media = relationship("RefundMedia", back_populates="refund_request", cascade="all, delete-orphan")
class RefundMedia(Base, AuditMixin):
__tablename__ = "refund_media"
id = Column(String(36), primary_key=True, default=lambda: str(ulid.ULID()))
refund_id = Column(String(36), ForeignKey("refund_requests.refund_id", ondelete="CASCADE"), nullable=False, index=True)
file_url = Column(String(1000), nullable=False)
file_type = Column(String(50), nullable=False) # e.g. "image/jpeg", "video/mp4"
media_filename = Column(String(255), nullable=True)
uploaded_by = Column(String(36), nullable=False)
uploaded_at = Column(DateTime, nullable=False, default=lambda: datetime.now(timezone.utc))
refund_request = relationship("RefundRequest", back_populates="media")