106 lines
3.4 KiB
Python
106 lines
3.4 KiB
Python
|
"""缺料审批 CRUD 路由"""
|
|||
|
|
from fastapi import APIRouter, Depends, HTTPException, Query
|
|||
|
|
from sqlalchemy.orm import Session
|
|||
|
|
|
|||
|
|
from app.database import get_db_pms
|
|||
|
|
from app.models import PmsWorkOrder, PmsMaterialApproval, MaterialBase, ApprovalStatus
|
|||
|
|
from app.schemas.approval import (
|
|||
|
|
ApprovalCreate,
|
|||
|
|
ApprovalStatusUpdate,
|
|||
|
|
ApprovalResponse,
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
router = APIRouter(prefix="/api/pms/approval", tags=["缺料审批"])
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.post("", response_model=ApprovalResponse, status_code=201)
|
|||
|
|
async def create_approval(data: ApprovalCreate, db: Session = Depends(get_db_pms)):
|
|||
|
|
"""
|
|||
|
|
提交缺料审批申请
|
|||
|
|
|
|||
|
|
- 员工提交缺料审批，系统自动设置状态为 PENDING
|
|||
|
|
"""
|
|||
|
|
work_order = db.query(PmsWorkOrder).filter(
|
|||
|
|
PmsWorkOrder.id == data.work_order_id
|
|||
|
|
).first()
|
|||
|
|
if not work_order:
|
|||
|
|
raise HTTPException(status_code=400, detail=f"工单 ID={data.work_order_id} 不存在")
|
|||
|
|
|
|||
|
|
material = db.query(MaterialBase).filter(
|
|||
|
|
MaterialBase.id == data.missing_material_id
|
|||
|
|
).first()
|
|||
|
|
if not material:
|
|||
|
|
raise HTTPException(status_code=400, detail=f"物料 ID={data.missing_material_id} 不存在")
|
|||
|
|
|
|||
|
|
approval = PmsMaterialApproval(
|
|||
|
|
work_order_id=data.work_order_id,
|
|||
|
|
missing_material_id=data.missing_material_id,
|
|||
|
|
required_qty=data.required_qty,
|
|||
|
|
reason=data.reason,
|
|||
|
|
status=ApprovalStatus.PENDING,
|
|||
|
|
)
|
|||
|
|
db.add(approval)
|
|||
|
|
db.commit()
|
|||
|
|
db.refresh(approval)
|
|||
|
|
return approval
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.get("", response_model=list[ApprovalResponse])
|
|||
|
|
async def list_pending_approvals(
|
|||
|
|
skip: int = Query(0, ge=0),
|
|||
|
|
limit: int = Query(20, gt=0, le=100),
|
|||
|
|
db: Session = Depends(get_db_pms)
|
|||
|
|
):
|
|||
|
|
"""
|
|||
|
|
分页查询所有待审批（状态为 PENDING）的审批流
|
|||
|
|
|
|||
|
|
供主管查看待处理的缺料审批申请
|
|||
|
|
"""
|
|||
|
|
return db.query(PmsMaterialApproval).filter(
|
|||
|
|
PmsMaterialApproval.status == ApprovalStatus.PENDING
|
|||
|
|
).order_by(PmsMaterialApproval.created_at.desc()).offset(skip).limit(limit).all()
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.put("/{approval_id}/status", response_model=ApprovalResponse)
|
|||
|
|
async def update_approval_status(
|
|||
|
|
approval_id: int,
|
|||
|
|
data: ApprovalStatusUpdate,
|
|||
|
|
db: Session = Depends(get_db_pms)
|
|||
|
|
):
|
|||
|
|
"""
|
|||
|
|
更新审批状态
|
|||
|
|
|
|||
|
|
- 仅允许状态从 PENDING 流转到 APPROVED 或 REJECTED
|
|||
|
|
- 终态不可再次修改
|
|||
|
|
"""
|
|||
|
|
approval = db.query(PmsMaterialApproval).filter(
|
|||
|
|
PmsMaterialApproval.id == approval_id
|
|||
|
|
).first()
|
|||
|
|
if not approval:
|
|||
|
|
raise HTTPException(status_code=404, detail=f"审批记录 ID={approval_id} 不存在")
|
|||
|
|
|
|||
|
|
if approval.status != ApprovalStatus.PENDING:
|
|||
|
|
raise HTTPException(
|
|||
|
|
status_code=400,
|
|||
|
|
detail=f"当前状态为 {approval.status.value}，不可修改（终态不可变更）"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
if data.status == ApprovalStatus.PENDING:
|
|||
|
|
raise HTTPException(status_code=400, detail="不允许将状态改回 PENDING")
|
|||
|
|
|
|||
|
|
approval.status = data.status
|
|||
|
|
db.commit()
|
|||
|
|
db.refresh(approval)
|
|||
|
|
return approval
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.get("/{approval_id}", response_model=ApprovalResponse)
|
|||
|
|
async def get_approval(approval_id: int, db: Session = Depends(get_db_pms)):
|
|||
|
|
"""获取单个审批详情"""
|
|||
|
|
approval = db.query(PmsMaterialApproval).filter(
|
|||
|
|
PmsMaterialApproval.id == approval_id
|
|||
|
|
).first()
|
|||
|
|
if not approval:
|
|||
|
|
raise HTTPException(status_code=404, detail=f"审批记录 ID={approval_id} 不存在")
|
|||
|
|
return approval
|