ifixkart-backend/app/schemas/Crm.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

220 lines
6.3 KiB
Python

from pydantic import BaseModel, EmailStr, Field
from typing import List, Optional
from datetime import datetime
from decimal import Decimal
# --- CUSTOMER SCHEMAS ---
class CrmCustomerBase(BaseModel):
name: str
phone: str
email: Optional[str] = None
notes: Optional[str] = None
class CrmCustomerCreate(CrmCustomerBase):
sales_tier: Optional[str] = "BRONZE"
service_tier: Optional[str] = "STANDARD"
class CrmCustomerUpdate(BaseModel):
name: Optional[str] = None
email: Optional[str] = None
phone: Optional[str] = None
sales_tier: Optional[str] = None
service_tier: Optional[str] = None
notes: Optional[str] = None
class CrmCustomerResponse(CrmCustomerBase):
customer_id: str
tenant_id: str
sales_tier: str
service_tier: str
total_orders_count: int
total_repairs_count: int
total_lifetime_value_inr: float
is_dual_customer: bool
created_at: Optional[datetime] = None
class Config:
from_attributes = True
# --- CONTACT SCHEMAS ---
class CrmContactCreate(BaseModel):
customer_id: str
address: Optional[str] = None
city: Optional[str] = None
state: Optional[str] = None
pincode: Optional[str] = None
alternate_phone: Optional[str] = None
class CrmContactResponse(CrmContactCreate):
contact_id: str
tenant_id: str
class Config:
from_attributes = True
# --- LEAD SCHEMAS ---
class CrmLeadCreate(BaseModel):
title: str
phone: Optional[str] = None
email: Optional[str] = None
first_name: Optional[str] = None
last_name: Optional[str] = None
customer_id: Optional[str] = None
source: Optional[str] = "STOREFRONT"
status: Optional[str] = "NEW"
score: Optional[int] = 10
assigned_user_id: Optional[str] = None
notes: Optional[str] = None
class CrmLeadUpdate(BaseModel):
title: Optional[str] = None
phone: Optional[str] = None
email: Optional[str] = None
first_name: Optional[str] = None
last_name: Optional[str] = None
status: Optional[str] = None
score: Optional[int] = None
assigned_user_id: Optional[str] = None
notes: Optional[str] = None
quote_amount: Optional[Decimal] = None
quote_title: Optional[str] = None
quote_terms: Optional[str] = None
quote_sent_at: Optional[datetime] = None
quote_sent_by: Optional[str] = None
class CrmLeadConvert(BaseModel):
category: str = "ECOMMERCE" # ECOMMERCE, SERVICE, BOTH
deal_title: Optional[str] = None
estimated_value: Optional[float] = 0.0
customer_name: Optional[str] = None
customer_email: Optional[str] = None
customer_phone: Optional[str] = None
notes: Optional[str] = None
class CrmLeadResponse(CrmLeadCreate):
lead_id: str
tenant_id: str
quote_amount: Optional[Decimal] = None
quote_title: Optional[str] = None
quote_terms: Optional[str] = None
quote_sent_at: Optional[datetime] = None
quote_sent_by: Optional[str] = None
created_at: Optional[datetime] = None
updated_at: Optional[datetime] = None
class Config:
from_attributes = True
# --- DEAL SCHEMAS ---
class CrmDealCreate(BaseModel):
title: str
customer_id: Optional[str] = None
lead_id: Optional[str] = None
stage: Optional[str] = "NEW"
estimated_value: Optional[float] = 0.0
value: Optional[float] = None
probability_percent: Optional[int] = 50
assigned_user_id: Optional[str] = None
notes: Optional[str] = None
class CrmDealUpdate(BaseModel):
title: Optional[str] = None
stage: Optional[str] = None
estimated_value: Optional[float] = None
value: Optional[float] = None
probability_percent: Optional[int] = None
assigned_user_id: Optional[str] = None
notes: Optional[str] = None
class CrmDealResponse(CrmDealCreate):
deal_id: str
tenant_id: str
created_at: Optional[datetime] = None
class Config:
from_attributes = True
# --- CUSTOMER 360 DEGREE PROFILE SCHEMA ---
class Customer360Response(BaseModel):
customer: CrmCustomerResponse
contacts: List[CrmContactResponse] = []
leads: List[CrmLeadResponse] = []
deals: List[CrmDealResponse] = []
orders_summary: dict = Field(default_factory=dict)
repairs_summary: dict = Field(default_factory=dict)
# --- TASK SCHEMAS ---
class CrmTaskCreate(BaseModel):
title: str
description: Optional[str] = None
location_id: Optional[str] = None
assignee_id: Optional[str] = None
entity_type: Optional[str] = None
entity_id: Optional[str] = None
priority: Optional[str] = "MEDIUM"
status: Optional[str] = "PENDING"
due_at: Optional[datetime] = None
class CrmTaskUpdate(BaseModel):
title: Optional[str] = None
description: Optional[str] = None
location_id: Optional[str] = None
assignee_id: Optional[str] = None
priority: Optional[str] = None
status: Optional[str] = None
due_at: Optional[datetime] = None
completed_at: Optional[datetime] = None
class CrmTaskResponse(CrmTaskCreate):
task_id: str
tenant_id: str
completed_at: Optional[datetime] = None
created_at: Optional[datetime] = None
updated_at: Optional[datetime] = None
class Config:
from_attributes = True
# --- CALENDAR EVENT SCHEMAS ---
class CrmCalendarEventCreate(BaseModel):
title: str
description: Optional[str] = None
location_id: Optional[str] = None
task_id: Optional[str] = None
source_type: Optional[str] = "MANUAL"
source_id: Optional[str] = None
start_time: datetime
end_time: datetime
is_all_day: Optional[bool] = False
status: Optional[str] = "SCHEDULED"
class CrmCalendarEventUpdate(BaseModel):
title: Optional[str] = None
description: Optional[str] = None
location_id: Optional[str] = None
task_id: Optional[str] = None
start_time: Optional[datetime] = None
end_time: Optional[datetime] = None
is_all_day: Optional[bool] = None
status: Optional[str] = None
class CrmCalendarEventResponse(CrmCalendarEventCreate):
event_id: str
tenant_id: str
created_at: Optional[datetime] = None
updated_at: Optional[datetime] = None
class Config:
from_attributes = True
class CrmLeadConvertResponse(BaseModel):
lead: CrmLeadResponse
customer: CrmCustomerResponse
deal: CrmDealResponse
is_dual_customer: bool
class Config:
from_attributes = True