123 lines
4.8 KiB
Python
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
|