- 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
155 lines
5.9 KiB
Python
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)
|
|
|