ifixkart-backend/app/api/v1/routers/InventoryPosRouter.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

155 lines
5.9 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.InventoryPosService import InventoryPosService
from app.schemas.InventoryPos import (
CrmWarehouseCreate, CrmWarehouseResponse,
CrmSupplierCreate, CrmSupplierResponse,
CrmInventoryStockAdjust, CrmInventoryStockResponse,
PosTerminalCreate, PosTerminalResponse,
CrmPosSessionOpen, CrmPosSessionClose, CrmPosSessionResponse, PosSessionExtend
)
router = APIRouter(prefix="/api/v1/inventory-pos", tags=["Inventory & POS Management"])
def get_inventory_service(request: Request, db: Session = Depends(get_db)) -> InventoryPosService:
tenant_id = getattr(request.state, "tenant_id", "tenant_default")
return InventoryPosService(db=db, tenant_id=tenant_id)
# --- WAREHOUSE ENDPOINTS ---
@router.post("/warehouses", response_model=CrmWarehouseResponse, status_code=status.HTTP_201_CREATED)
def create_warehouse(
payload: CrmWarehouseCreate,
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Creates a new warehouse storage hub."""
return svc.create_warehouse(payload)
@router.get("/warehouses", response_model=List[CrmWarehouseResponse])
def list_warehouses(
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Lists all warehouses for the active tenant."""
return svc.list_warehouses()
# --- SUPPLIER ENDPOINTS ---
@router.post("/suppliers", response_model=CrmSupplierResponse, status_code=status.HTTP_201_CREATED)
def create_supplier(
payload: CrmSupplierCreate,
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Registers a new spare parts or device supplier."""
return svc.create_supplier(payload)
@router.get("/suppliers", response_model=List[CrmSupplierResponse])
def list_suppliers(
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Lists all registered suppliers."""
return svc.list_suppliers()
# --- STOCK LEVEL ENDPOINTS ---
@router.post("/stock/adjust", response_model=CrmInventoryStockResponse)
def adjust_stock_quantity(
payload: CrmInventoryStockAdjust,
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Adjusts stock levels (restock or deduction) for a SKU in a warehouse."""
return svc.adjust_stock(payload)
@router.get("/stock", response_model=List[CrmInventoryStockResponse])
def list_inventory_stock(
warehouse_id: Optional[str] = None,
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Lists stock levels across warehouses."""
return svc.list_stock(warehouse_id=warehouse_id)
# --- POS TERMINAL & SESSION ENDPOINTS ---
@router.get("/terminals", response_model=List[PosTerminalResponse])
def list_pos_terminals(
location_id: Optional[str] = Query(None),
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Lists POS terminals for a location or across all locations."""
return svc.list_terminals(location_id=location_id)
@router.post("/terminals", response_model=PosTerminalResponse, status_code=status.HTTP_201_CREATED)
def create_pos_terminal(
payload: PosTerminalCreate,
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Registers a new POS terminal device."""
return svc.create_terminal(location_id=payload.location_id, code=payload.code, name=payload.name)
@router.post("/pos-sessions/open", response_model=CrmPosSessionResponse, status_code=status.HTTP_201_CREATED)
def open_pos_session(
payload: CrmPosSessionOpen,
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Opens a POS terminal session for a user."""
return svc.open_pos_session(user_id=current_user.user_id, data=payload)
@router.post("/pos-sessions/{session_id}/close", response_model=CrmPosSessionResponse)
def close_pos_session(
session_id: str,
payload: CrmPosSessionClose,
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Closes an active POS terminal session."""
session = svc.close_pos_session(pos_session_id=session_id, data=payload)
if not session:
raise HTTPException(status_code=404, detail="POS terminal session not found")
return session
@router.post("/pos-sessions/{session_id}/extend", response_model=CrmPosSessionResponse)
def extend_pos_session(
session_id: str,
payload: PosSessionExtend,
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Extends an active POS terminal session."""
session = svc.extend_pos_session(pos_session_id=session_id, user_id=current_user.user_id, data=payload)
if not session:
raise HTTPException(status_code=404, detail="POS terminal session not found or cannot be extended")
return session
@router.get("/pos-sessions")
def list_pos_sessions(
status: Optional[str] = Query(None),
location_id: Optional[str] = Query(None),
user_id: Optional[str] = Query(None),
svc: InventoryPosService = Depends(get_inventory_service),
current_user: User = Depends(get_current_user)
) -> Any:
"""Lists all POS terminal sessions."""
return svc.list_pos_sessions(status=status, location_id=location_id, user_id=user_id)