a02b6c3ec8
- 批次 HK 生成；shipment_id 同业务强校验（统一失败面防探测） - 已核算回款禁改禁删（M3 防重锚点）；payment_days 派生（发货日首日=第 1 天） Co-Authored-By: Claude Code <noreply@anthropic.com>
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="回款已删除")
|