1e53792ad6
打通 T+ 快照、业务、发货、回款和核算准备链路，保留来源差异并提供待补状态。 新增业务自动接入任务、跨平台读取服务托管、权限复核、来源关联和前端核对页面。 补充迁移、隔离集成测试、浏览器模拟验收及角色授权边界修复。
106 lines
4.0 KiB
Python
106 lines
4.0 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, PayrollWriter, RequestMetaDep, get_current_user
|
||
from app.core.response import ApiResponse, PageResult, ok
|
||
from app.models import User
|
||
from app.schemas.receipt import (
|
||
ReceiptConfirmIn,
|
||
ReceiptCreateIn,
|
||
ReceiptOut,
|
||
ReceiptQuery,
|
||
ReceiptUpdateIn,
|
||
)
|
||
from app.services import receipt_confirmation, receipt_service
|
||
|
||
# 基础数据是业务操作：登录即可，不要求管理员（区别于系统管理的 AdminUser）
|
||
CurrentUser = Annotated[User, Depends(get_current_user)]
|
||
|
||
router = APIRouter(prefix="/receipts", tags=["回款管理"])
|
||
|
||
|
||
@router.get("/confirmation-policy", summary="回款人工确认开关状态")
|
||
def confirmation_policy(session: DbSession, _: CurrentUser):
|
||
return ok({"enabled": receipt_confirmation.enabled(session)})
|
||
|
||
|
||
@router.post("/{receipt_id}/confirm", response_model=ApiResponse[ReceiptOut], summary="独立人工确认回款")
|
||
def confirm_receipt(
|
||
receipt_id: Annotated[int, Path(ge=1)], payload: ReceiptConfirmIn,
|
||
session: DbSession, current_user: CurrentUser, meta: RequestMetaDep,
|
||
):
|
||
return ok(receipt_service.confirm_receipt(
|
||
session, receipt_id, payload, operator=current_user, meta=meta,
|
||
), message="回款已人工确认")
|
||
|
||
|
||
@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: PayrollWriter,
|
||
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: PayrollWriter,
|
||
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: PayrollWriter,
|
||
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="回款已删除")
|