90 lines
3.3 KiB
Python
90 lines
3.3 KiB
Python
|
"""回款管理接口（需求 2.2.3）。
|
|||
|
|
|
|||
|
|
回款按业务登记到账款项，批次号自动生成（HK 前缀）。校验规则（发货
|
|||
|
|
批次同业务强校验、已核算禁改禁删、汇总重算）见 `receipt_service` 模块
|
|||
|
|
docstring；基础数据属业务操作，登录即可访问。
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
from typing import Annotated
|
|||
|
|
|
|||
|
|
from fastapi import APIRouter, Depends, Path, Query
|
|||
|
|
|
|||
|
|
from app.api.deps import DbSession, RequestMetaDep, get_current_user
|
|||
|
|
from app.core.response import ApiResponse, PageResult, ok
|
|||
|
|
from app.models import User
|
|||
|
|
from app.schemas.receipt import (
|
|||
|
|
ReceiptCreateIn,
|
|||
|
|
ReceiptOut,
|
|||
|
|
ReceiptQuery,
|
|||
|
|
ReceiptUpdateIn,
|
|||
|
|
)
|
|||
|
|
from app.services import receipt_service
|
|||
|
|
|
|||
|
|
# 基础数据是业务操作：登录即可，不要求管理员（区别于系统管理的 AdminUser）
|
|||
|
|
CurrentUser = Annotated[User, Depends(get_current_user)]
|
|||
|
|
|
|||
|
|
router = APIRouter(prefix="/receipts", tags=["回款管理"])
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.get("", response_model=ApiResponse[PageResult[ReceiptOut]], summary="回款列表")
|
|||
|
|
def list_receipts(
|
|||
|
|
session: DbSession,
|
|||
|
|
_: CurrentUser,
|
|||
|
|
query: Annotated[ReceiptQuery, Query()],
|
|||
|
|
) -> ApiResponse[PageResult[ReceiptOut]]:
|
|||
|
|
"""分页查询回款。附业务号/发货单号与回款天数派生值，可按业务/日期/抵顶/核算状态筛选。"""
|
|||
|
|
return ok(receipt_service.list_receipts(session, query))
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.post("", response_model=ApiResponse[ReceiptOut], summary="新增回款")
|
|||
|
|
def create_receipt(
|
|||
|
|
session: DbSession,
|
|||
|
|
current_user: CurrentUser,
|
|||
|
|
payload: ReceiptCreateIn,
|
|||
|
|
meta: RequestMetaDep,
|
|||
|
|
) -> ApiResponse[ReceiptOut]:
|
|||
|
|
"""新增回款。批次号自动生成；发货批次须与本回款同属一个业务；业务须执行中。"""
|
|||
|
|
return ok(
|
|||
|
|
receipt_service.create_receipt(session, payload, operator=current_user, meta=meta),
|
|||
|
|
message="回款已登记",
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.get("/{receipt_id}", response_model=ApiResponse[ReceiptOut], summary="回款详情")
|
|||
|
|
def get_receipt(
|
|||
|
|
session: DbSession,
|
|||
|
|
_: CurrentUser,
|
|||
|
|
receipt_id: Annotated[int, Path(ge=1)],
|
|||
|
|
) -> ApiResponse[ReceiptOut]:
|
|||
|
|
"""回款详情（含回款天数派生值，未指定发货批次时为空）。"""
|
|||
|
|
return ok(receipt_service.get_detail(session, receipt_id))
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.put("/{receipt_id}", response_model=ApiResponse[ReceiptOut], summary="编辑回款")
|
|||
|
|
def update_receipt(
|
|||
|
|
session: DbSession,
|
|||
|
|
current_user: CurrentUser,
|
|||
|
|
receipt_id: Annotated[int, Path(ge=1)],
|
|||
|
|
payload: ReceiptUpdateIn,
|
|||
|
|
meta: RequestMetaDep,
|
|||
|
|
) -> ApiResponse[ReceiptOut]:
|
|||
|
|
"""编辑回款（全量替换并重算合计）。已核算回款禁止修改；发货批次重新校验同业务。"""
|
|||
|
|
return ok(
|
|||
|
|
receipt_service.update_receipt(
|
|||
|
|
session, receipt_id, payload, operator=current_user, meta=meta
|
|||
|
|
),
|
|||
|
|
message="已保存",
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.delete("/{receipt_id}", response_model=ApiResponse[None], summary="删除回款")
|
|||
|
|
def delete_receipt(
|
|||
|
|
session: DbSession,
|
|||
|
|
current_user: CurrentUser,
|
|||
|
|
receipt_id: Annotated[int, Path(ge=1)],
|
|||
|
|
meta: RequestMetaDep,
|
|||
|
|
) -> ApiResponse[None]:
|
|||
|
|
"""删除回款。已核算回款禁止删除；业务已完成或已终止时禁删。"""
|
|||
|
|
receipt_service.delete_receipt(session, receipt_id, operator=current_user, meta=meta)
|
|||
|
|
return ok(message="回款已删除")
|