ifixkart-admin/Backend/app/api/v1/routers/RepairErpRouter.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

123 lines
4.8 KiB
Python

from fastapi import APIRouter, Depends, HTTPException, Query, status, Request
from sqlalchemy.orm import Session
from typing import List, Optional, Any
from app.core.database.db_session import get_db
from app.core.permissions.RoleChecker import get_current_user
from app.models.UserModel import User
from app.services.RepairErpService import RepairErpService
from app.schemas.RepairErp import (
CrmCustomerDeviceCreate, CrmCustomerDeviceResponse,
CrmRepairTicketCreate, CrmRepairTicketUpdateStage, CrmRepairTicketUpdateChecklist,
CrmRepairTicketAssignTechnician, CrmRepairTicketResponse
)
router = APIRouter(prefix="/api/v1/repair", tags=["Repair ERP & IMEI Management"])
def get_repair_service(request: Request, db: Session = Depends(get_db)) -> RepairErpService:
tenant_id = getattr(request.state, "tenant_id", "tenant_default")
return RepairErpService(db=db, tenant_id=tenant_id)
# --- DEVICE & IMEI ENDPOINTS ---
@router.post("/devices", response_model=CrmCustomerDeviceResponse, status_code=status.HTTP_201_CREATED)
def register_device(
payload: CrmCustomerDeviceCreate,
svc: RepairErpService = Depends(get_repair_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Registers a new device under a customer with IMEI / Serial number."""
return svc.register_device(payload)
@router.get("/devices/lookup", response_model=CrmCustomerDeviceResponse)
def lookup_device_by_imei(
imei_serial: str = Query(..., description="IMEI or Serial Number"),
svc: RepairErpService = Depends(get_repair_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Searches and retrieves a device record by IMEI / Serial number."""
device = svc.lookup_by_imei(imei_serial)
if not device:
raise HTTPException(status_code=404, detail="Device not found for provided IMEI / Serial")
return device
# --- REPAIR TICKET LIFECYCLE ENDPOINTS ---
@router.post("/tickets", response_model=CrmRepairTicketResponse, status_code=status.HTTP_201_CREATED)
def create_repair_ticket(
payload: CrmRepairTicketCreate,
svc: RepairErpService = Depends(get_repair_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Creates a new mobile repair service ticket."""
return svc.create_ticket(payload)
@router.get("/tickets", response_model=List[CrmRepairTicketResponse])
def list_repair_tickets(
skip: int = Query(0, ge=0),
limit: int = Query(50, ge=1, le=200),
stage: Optional[str] = None,
technician_id: Optional[str] = None,
svc: RepairErpService = Depends(get_repair_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Lists repair tickets filtered by stage or assigned technician."""
return svc.list_tickets(skip=skip, limit=limit, stage=stage, technician_id=technician_id)
@router.get("/tickets/{ticket_id}", response_model=CrmRepairTicketResponse)
def get_repair_ticket_by_id(
ticket_id: str,
svc: RepairErpService = Depends(get_repair_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Retrieves single repair ticket details."""
ticket = svc.get_ticket(ticket_id)
if not ticket:
raise HTTPException(status_code=404, detail="Repair ticket not found")
return ticket
@router.patch("/tickets/{ticket_id}/stage", response_model=CrmRepairTicketResponse)
def update_repair_ticket_stage(
ticket_id: str,
payload: CrmRepairTicketUpdateStage,
svc: RepairErpService = Depends(get_repair_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Updates the stage lifecycle of a repair ticket."""
ticket = svc.update_stage(ticket_id, payload)
if not ticket:
raise HTTPException(status_code=404, detail="Repair ticket not found")
return ticket
@router.patch("/tickets/{ticket_id}/checklists", response_model=CrmRepairTicketResponse)
def update_repair_ticket_checklists(
ticket_id: str,
payload: CrmRepairTicketUpdateChecklist,
svc: RepairErpService = Depends(get_repair_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Updates diagnostic or QC checklists for a repair ticket."""
ticket = svc.update_checklists(ticket_id, payload)
if not ticket:
raise HTTPException(status_code=404, detail="Repair ticket not found")
return ticket
@router.post("/tickets/{ticket_id}/assign", response_model=CrmRepairTicketResponse)
def assign_technician_to_ticket(
ticket_id: str,
payload: CrmRepairTicketAssignTechnician,
svc: RepairErpService = Depends(get_repair_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Assigns a technician to a repair ticket."""
ticket = svc.assign_technician(ticket_id, payload)
if not ticket:
raise HTTPException(status_code=404, detail="Repair ticket not found")
return ticket