510 lines
20 KiB
Python
510 lines
20 KiB
Python
# services/suppliers/app/api/purchase_orders.py
|
|
"""
|
|
Purchase Order API endpoints
|
|
"""
|
|
|
|
from fastapi import APIRouter, Depends, HTTPException, Query, Path
|
|
from typing import List, Optional
|
|
from uuid import UUID
|
|
import structlog
|
|
|
|
from sqlalchemy.orm import Session
|
|
from app.core.database import get_db
|
|
from app.services.purchase_order_service import PurchaseOrderService
|
|
from app.schemas.suppliers import (
|
|
PurchaseOrderCreate, PurchaseOrderUpdate, PurchaseOrderResponse, PurchaseOrderSummary,
|
|
PurchaseOrderSearchParams, PurchaseOrderStatusUpdate, PurchaseOrderApproval,
|
|
PurchaseOrderStatistics
|
|
)
|
|
from app.models.suppliers import PurchaseOrderStatus
|
|
from shared.auth.dependencies import get_current_user, require_permissions
|
|
from shared.auth.models import UserInfo
|
|
|
|
router = APIRouter(prefix="/purchase-orders", tags=["purchase-orders"])
|
|
logger = structlog.get_logger()
|
|
|
|
|
|
@router.post("/", response_model=PurchaseOrderResponse)
|
|
async def create_purchase_order(
|
|
po_data: PurchaseOrderCreate,
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Create a new purchase order"""
|
|
require_permissions(current_user, ["purchase_orders:create"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
purchase_order = await service.create_purchase_order(
|
|
tenant_id=current_user.tenant_id,
|
|
po_data=po_data,
|
|
created_by=current_user.user_id
|
|
)
|
|
return PurchaseOrderResponse.from_orm(purchase_order)
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=400, detail=str(e))
|
|
except Exception as e:
|
|
logger.error("Error creating purchase order", error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to create purchase order")
|
|
|
|
|
|
@router.get("/", response_model=List[PurchaseOrderSummary])
|
|
async def list_purchase_orders(
|
|
supplier_id: Optional[UUID] = Query(None, description="Filter by supplier ID"),
|
|
status: Optional[str] = Query(None, description="Filter by status"),
|
|
priority: Optional[str] = Query(None, description="Filter by priority"),
|
|
date_from: Optional[str] = Query(None, description="Filter from date (YYYY-MM-DD)"),
|
|
date_to: Optional[str] = Query(None, description="Filter to date (YYYY-MM-DD)"),
|
|
search_term: Optional[str] = Query(None, description="Search term"),
|
|
limit: int = Query(50, ge=1, le=1000, description="Number of results to return"),
|
|
offset: int = Query(0, ge=0, description="Number of results to skip"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""List purchase orders with optional filters"""
|
|
require_permissions(current_user, ["purchase_orders:read"])
|
|
|
|
try:
|
|
from datetime import datetime
|
|
|
|
# Parse date filters
|
|
date_from_parsed = None
|
|
date_to_parsed = None
|
|
if date_from:
|
|
try:
|
|
date_from_parsed = datetime.fromisoformat(date_from)
|
|
except ValueError:
|
|
raise HTTPException(status_code=400, detail="Invalid date_from format")
|
|
|
|
if date_to:
|
|
try:
|
|
date_to_parsed = datetime.fromisoformat(date_to)
|
|
except ValueError:
|
|
raise HTTPException(status_code=400, detail="Invalid date_to format")
|
|
|
|
# Validate status
|
|
status_enum = None
|
|
if status:
|
|
try:
|
|
status_enum = PurchaseOrderStatus(status.upper())
|
|
except ValueError:
|
|
raise HTTPException(status_code=400, detail="Invalid status")
|
|
|
|
service = PurchaseOrderService(db)
|
|
search_params = PurchaseOrderSearchParams(
|
|
supplier_id=supplier_id,
|
|
status=status_enum,
|
|
priority=priority,
|
|
date_from=date_from_parsed,
|
|
date_to=date_to_parsed,
|
|
search_term=search_term,
|
|
limit=limit,
|
|
offset=offset
|
|
)
|
|
|
|
orders = await service.search_purchase_orders(
|
|
tenant_id=current_user.tenant_id,
|
|
search_params=search_params
|
|
)
|
|
|
|
return [PurchaseOrderSummary.from_orm(order) for order in orders]
|
|
except HTTPException:
|
|
raise
|
|
except Exception as e:
|
|
logger.error("Error listing purchase orders", error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to retrieve purchase orders")
|
|
|
|
|
|
@router.get("/statistics", response_model=PurchaseOrderStatistics)
|
|
async def get_purchase_order_statistics(
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Get purchase order statistics for dashboard"""
|
|
require_permissions(current_user, ["purchase_orders:read"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
stats = await service.get_purchase_order_statistics(current_user.tenant_id)
|
|
return PurchaseOrderStatistics(**stats)
|
|
except Exception as e:
|
|
logger.error("Error getting purchase order statistics", error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to retrieve statistics")
|
|
|
|
|
|
@router.get("/pending-approval", response_model=List[PurchaseOrderSummary])
|
|
async def get_orders_requiring_approval(
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Get purchase orders requiring approval"""
|
|
require_permissions(current_user, ["purchase_orders:approve"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
orders = await service.get_orders_requiring_approval(current_user.tenant_id)
|
|
return [PurchaseOrderSummary.from_orm(order) for order in orders]
|
|
except Exception as e:
|
|
logger.error("Error getting orders requiring approval", error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to retrieve orders requiring approval")
|
|
|
|
|
|
@router.get("/overdue", response_model=List[PurchaseOrderSummary])
|
|
async def get_overdue_orders(
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Get overdue purchase orders"""
|
|
require_permissions(current_user, ["purchase_orders:read"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
orders = await service.get_overdue_orders(current_user.tenant_id)
|
|
return [PurchaseOrderSummary.from_orm(order) for order in orders]
|
|
except Exception as e:
|
|
logger.error("Error getting overdue orders", error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to retrieve overdue orders")
|
|
|
|
|
|
@router.get("/{po_id}", response_model=PurchaseOrderResponse)
|
|
async def get_purchase_order(
|
|
po_id: UUID = Path(..., description="Purchase order ID"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Get purchase order by ID with items"""
|
|
require_permissions(current_user, ["purchase_orders:read"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
purchase_order = await service.get_purchase_order(po_id)
|
|
|
|
if not purchase_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
|
|
# Check tenant access
|
|
if purchase_order.tenant_id != current_user.tenant_id:
|
|
raise HTTPException(status_code=403, detail="Access denied")
|
|
|
|
return PurchaseOrderResponse.from_orm(purchase_order)
|
|
except HTTPException:
|
|
raise
|
|
except Exception as e:
|
|
logger.error("Error getting purchase order", po_id=str(po_id), error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to retrieve purchase order")
|
|
|
|
|
|
@router.put("/{po_id}", response_model=PurchaseOrderResponse)
|
|
async def update_purchase_order(
|
|
po_data: PurchaseOrderUpdate,
|
|
po_id: UUID = Path(..., description="Purchase order ID"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Update purchase order information"""
|
|
require_permissions(current_user, ["purchase_orders:update"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
|
|
# Check order exists and belongs to tenant
|
|
existing_order = await service.get_purchase_order(po_id)
|
|
if not existing_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
if existing_order.tenant_id != current_user.tenant_id:
|
|
raise HTTPException(status_code=403, detail="Access denied")
|
|
|
|
purchase_order = await service.update_purchase_order(
|
|
po_id=po_id,
|
|
po_data=po_data,
|
|
updated_by=current_user.user_id
|
|
)
|
|
|
|
if not purchase_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
|
|
return PurchaseOrderResponse.from_orm(purchase_order)
|
|
except HTTPException:
|
|
raise
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=400, detail=str(e))
|
|
except Exception as e:
|
|
logger.error("Error updating purchase order", po_id=str(po_id), error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to update purchase order")
|
|
|
|
|
|
@router.patch("/{po_id}/status", response_model=PurchaseOrderResponse)
|
|
async def update_purchase_order_status(
|
|
status_data: PurchaseOrderStatusUpdate,
|
|
po_id: UUID = Path(..., description="Purchase order ID"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Update purchase order status"""
|
|
require_permissions(current_user, ["purchase_orders:update"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
|
|
# Check order exists and belongs to tenant
|
|
existing_order = await service.get_purchase_order(po_id)
|
|
if not existing_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
if existing_order.tenant_id != current_user.tenant_id:
|
|
raise HTTPException(status_code=403, detail="Access denied")
|
|
|
|
purchase_order = await service.update_order_status(
|
|
po_id=po_id,
|
|
status=status_data.status,
|
|
updated_by=current_user.user_id,
|
|
notes=status_data.notes
|
|
)
|
|
|
|
if not purchase_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
|
|
return PurchaseOrderResponse.from_orm(purchase_order)
|
|
except HTTPException:
|
|
raise
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=400, detail=str(e))
|
|
except Exception as e:
|
|
logger.error("Error updating purchase order status", po_id=str(po_id), error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to update purchase order status")
|
|
|
|
|
|
@router.post("/{po_id}/approve", response_model=PurchaseOrderResponse)
|
|
async def approve_purchase_order(
|
|
approval_data: PurchaseOrderApproval,
|
|
po_id: UUID = Path(..., description="Purchase order ID"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Approve or reject a purchase order"""
|
|
require_permissions(current_user, ["purchase_orders:approve"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
|
|
# Check order exists and belongs to tenant
|
|
existing_order = await service.get_purchase_order(po_id)
|
|
if not existing_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
if existing_order.tenant_id != current_user.tenant_id:
|
|
raise HTTPException(status_code=403, detail="Access denied")
|
|
|
|
if approval_data.action == "approve":
|
|
purchase_order = await service.approve_purchase_order(
|
|
po_id=po_id,
|
|
approved_by=current_user.user_id,
|
|
approval_notes=approval_data.notes
|
|
)
|
|
elif approval_data.action == "reject":
|
|
if not approval_data.notes:
|
|
raise HTTPException(status_code=400, detail="Rejection reason is required")
|
|
purchase_order = await service.reject_purchase_order(
|
|
po_id=po_id,
|
|
rejection_reason=approval_data.notes,
|
|
rejected_by=current_user.user_id
|
|
)
|
|
else:
|
|
raise HTTPException(status_code=400, detail="Invalid action")
|
|
|
|
if not purchase_order:
|
|
raise HTTPException(
|
|
status_code=400,
|
|
detail="Purchase order is not in pending approval status"
|
|
)
|
|
|
|
return PurchaseOrderResponse.from_orm(purchase_order)
|
|
except HTTPException:
|
|
raise
|
|
except Exception as e:
|
|
logger.error("Error processing purchase order approval", po_id=str(po_id), error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to process purchase order approval")
|
|
|
|
|
|
@router.post("/{po_id}/send-to-supplier", response_model=PurchaseOrderResponse)
|
|
async def send_to_supplier(
|
|
po_id: UUID = Path(..., description="Purchase order ID"),
|
|
send_email: bool = Query(True, description="Send email notification to supplier"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Send purchase order to supplier"""
|
|
require_permissions(current_user, ["purchase_orders:send"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
|
|
# Check order exists and belongs to tenant
|
|
existing_order = await service.get_purchase_order(po_id)
|
|
if not existing_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
if existing_order.tenant_id != current_user.tenant_id:
|
|
raise HTTPException(status_code=403, detail="Access denied")
|
|
|
|
purchase_order = await service.send_to_supplier(
|
|
po_id=po_id,
|
|
sent_by=current_user.user_id,
|
|
send_email=send_email
|
|
)
|
|
|
|
if not purchase_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
|
|
return PurchaseOrderResponse.from_orm(purchase_order)
|
|
except HTTPException:
|
|
raise
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=400, detail=str(e))
|
|
except Exception as e:
|
|
logger.error("Error sending purchase order to supplier", po_id=str(po_id), error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to send purchase order to supplier")
|
|
|
|
|
|
@router.post("/{po_id}/confirm-supplier-receipt", response_model=PurchaseOrderResponse)
|
|
async def confirm_supplier_receipt(
|
|
po_id: UUID = Path(..., description="Purchase order ID"),
|
|
supplier_reference: Optional[str] = Query(None, description="Supplier's order reference"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Confirm supplier has received and accepted the order"""
|
|
require_permissions(current_user, ["purchase_orders:update"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
|
|
# Check order exists and belongs to tenant
|
|
existing_order = await service.get_purchase_order(po_id)
|
|
if not existing_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
if existing_order.tenant_id != current_user.tenant_id:
|
|
raise HTTPException(status_code=403, detail="Access denied")
|
|
|
|
purchase_order = await service.confirm_supplier_receipt(
|
|
po_id=po_id,
|
|
supplier_reference=supplier_reference,
|
|
confirmed_by=current_user.user_id
|
|
)
|
|
|
|
if not purchase_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
|
|
return PurchaseOrderResponse.from_orm(purchase_order)
|
|
except HTTPException:
|
|
raise
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=400, detail=str(e))
|
|
except Exception as e:
|
|
logger.error("Error confirming supplier receipt", po_id=str(po_id), error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to confirm supplier receipt")
|
|
|
|
|
|
@router.post("/{po_id}/cancel", response_model=PurchaseOrderResponse)
|
|
async def cancel_purchase_order(
|
|
po_id: UUID = Path(..., description="Purchase order ID"),
|
|
cancellation_reason: str = Query(..., description="Reason for cancellation"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Cancel a purchase order"""
|
|
require_permissions(current_user, ["purchase_orders:cancel"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
|
|
# Check order exists and belongs to tenant
|
|
existing_order = await service.get_purchase_order(po_id)
|
|
if not existing_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
if existing_order.tenant_id != current_user.tenant_id:
|
|
raise HTTPException(status_code=403, detail="Access denied")
|
|
|
|
purchase_order = await service.cancel_purchase_order(
|
|
po_id=po_id,
|
|
cancellation_reason=cancellation_reason,
|
|
cancelled_by=current_user.user_id
|
|
)
|
|
|
|
if not purchase_order:
|
|
raise HTTPException(status_code=404, detail="Purchase order not found")
|
|
|
|
return PurchaseOrderResponse.from_orm(purchase_order)
|
|
except HTTPException:
|
|
raise
|
|
except ValueError as e:
|
|
raise HTTPException(status_code=400, detail=str(e))
|
|
except Exception as e:
|
|
logger.error("Error cancelling purchase order", po_id=str(po_id), error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to cancel purchase order")
|
|
|
|
|
|
@router.get("/supplier/{supplier_id}", response_model=List[PurchaseOrderSummary])
|
|
async def get_orders_by_supplier(
|
|
supplier_id: UUID = Path(..., description="Supplier ID"),
|
|
limit: int = Query(20, ge=1, le=100, description="Number of orders to return"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Get recent purchase orders for a specific supplier"""
|
|
require_permissions(current_user, ["purchase_orders:read"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
orders = await service.get_orders_by_supplier(
|
|
tenant_id=current_user.tenant_id,
|
|
supplier_id=supplier_id,
|
|
limit=limit
|
|
)
|
|
return [PurchaseOrderSummary.from_orm(order) for order in orders]
|
|
except Exception as e:
|
|
logger.error("Error getting orders by supplier", supplier_id=str(supplier_id), error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to retrieve orders by supplier")
|
|
|
|
|
|
@router.get("/ingredients/{ingredient_id}/history")
|
|
async def get_ingredient_purchase_history(
|
|
ingredient_id: UUID = Path(..., description="Ingredient ID"),
|
|
days_back: int = Query(90, ge=1, le=365, description="Number of days to look back"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Get purchase history for a specific ingredient"""
|
|
require_permissions(current_user, ["purchase_orders:read"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
history = await service.get_ingredient_purchase_history(
|
|
tenant_id=current_user.tenant_id,
|
|
ingredient_id=ingredient_id,
|
|
days_back=days_back
|
|
)
|
|
return history
|
|
except Exception as e:
|
|
logger.error("Error getting ingredient purchase history", ingredient_id=str(ingredient_id), error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to retrieve ingredient purchase history")
|
|
|
|
|
|
@router.get("/ingredients/top-purchased")
|
|
async def get_top_purchased_ingredients(
|
|
days_back: int = Query(30, ge=1, le=365, description="Number of days to look back"),
|
|
limit: int = Query(10, ge=1, le=50, description="Number of top ingredients to return"),
|
|
current_user: UserInfo = Depends(get_current_user),
|
|
db: Session = Depends(get_db)
|
|
):
|
|
"""Get most purchased ingredients by value"""
|
|
require_permissions(current_user, ["purchase_orders:read"])
|
|
|
|
try:
|
|
service = PurchaseOrderService(db)
|
|
ingredients = await service.get_top_purchased_ingredients(
|
|
tenant_id=current_user.tenant_id,
|
|
days_back=days_back,
|
|
limit=limit
|
|
)
|
|
return ingredients
|
|
except Exception as e:
|
|
logger.error("Error getting top purchased ingredients", error=str(e))
|
|
raise HTTPException(status_code=500, detail="Failed to retrieve top purchased ingredients") |