feat(calc): 单笔回款核算引擎与绩效台账
- calc_service.calc_receipt：锁回款行→settlement_status=0 校验→发货批次/ 归属前置→resolve_snapshot(回款日)→按 calc_template 分派（与 _preview_rate 同构，‰÷1000 防线）→items 行级折算（行类别阈值，混合按行汇总）→ barter/起付/R→台账 v1→CAS 置已核算，单 audit 事务 - 策略点集中：_personal_rate（#12 经理个人户单笔落 0 待答复）、_row_profit （#20 不含税原样）；核算粒度 #25 一期口径=业务级一次性计提（重复回款 repeated=True 仅登记进度） - 台账仓储：生效行查询/业务级判定/版本号；schemas LedgerOut/Query - api /api/v1/calc/*：台账分页/详情/核算触发（写限 admin+marketing_ops） - 测试 8 例：金标准双类别复算到分（DB 锚定 4000.00/39.11/39.11）、 一次性计提、已核算 400、未指定批次、成本缺失行保守 -3000、负绩效照算、 准入、列表筛选；行级明细折算两位固化 - conftest 清理顺序修正：V7 台账/月结清理移到回款/人员删除之前 （RESTRICT 外键不挡序） Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
liuwenxinandClaude Code committed
1 parent
a5c86640e2
commit
df1a3839a1
7 files changed
+1006
-6
No files matched your search
@@ -101,6 +101,14 @@ def _purge_test_data() -> None:
|
||||
session.execute(delete(UserRole).where(UserRole.role_id.in_(role_ids)))
|
||||
session.execute(delete(Role).where(Role.id.in_(role_ids)))
|
||||
|
||||
# ---- M3-core：核算台账 / 月结 / 调整单（必须先于回款/业务/人员删除——
|
||||
# ledger.receipt_id/personnel_id/settlement_id 外键 RESTRICT 会挡住后面
|
||||
# 的单据与人员清理；仅测试写入，全量清）----
|
||||
session.execute(delete(PerformanceLedger))
|
||||
session.execute(delete(SettlementItem))
|
||||
session.execute(delete(MonthlySettlement))
|
||||
session.execute(delete(AdjustmentOrder).where(AdjustmentOrder.order_no.like("TZ%")))
|
||||
|
||||
# ---- M2 业务数据（T11）：业务/发货/回款三类单据 ----
|
||||
# 编号系统生成、无 t_ 前缀可用，按业务编号前缀全量清（三类单据表目前
|
||||
# 只有测试会写）。外键均为 RESTRICT，删除顺序不能倒：回款 → 发货
|
||||
@@ -182,12 +190,6 @@ def _purge_test_data() -> None:
|
||||
# 审批单无 t_ 前缀可用，按 AP 编号前缀全量清（steps 外键 CASCADE 随删；
|
||||
# ref_id 固化无外键，业务已在上一步删除，无悬挂影响）
|
||||
session.execute(delete(ApprovalOrder).where(ApprovalOrder.order_no.like("AP%")))
|
||||
# ---- M3-core：核算台账 / 月结 / 调整单（仅测试写入，全量清；
|
||||
# 删除顺序：台账→明细→月结头→调整单，TZ 前缀全量清）----
|
||||
session.execute(delete(PerformanceLedger))
|
||||
session.execute(delete(SettlementItem))
|
||||
session.execute(delete(MonthlySettlement))
|
||||
session.execute(delete(AdjustmentOrder).where(AdjustmentOrder.order_no.like("TZ%")))
|
||||
# 开关参数恢复种子基线：测试提交的变更批次条目 id 均大于种子终值 22
|
||||
# （V3 十九条 + V6 两条 + V7 调整单开关一条），删新条目与新批次后解析
|
||||
# 回退到种子值（开关=0）
|
||||
|
||||
@@ -0,0 +1,370 @@
|
||||
"""单笔回款核算集成测试（M3 ④：金标准复算到分）。
|
||||
|
||||
金标准场景（双类别混合业务，覆盖行级折算与汇总）：
|
||||
- 行1 市政水利：100×100.00 = 销售 10000，成本 3000 → 毛利率 0.7，阈值 30%
|
||||
→ 折算 10000×(0.7−0.3) = 4000
|
||||
- 行2 轨道交通：50×200.00 = 销售 10000，成本 8000 → 毛利率 0.2，阈值 20%
|
||||
→ 折算 10000×(0.2−0.2) = 0
|
||||
- 折算合计 4000；发货 10-01 → 回款 10-20，days=20
|
||||
- 率 = (10 − 20×4/360)‰ = 88/9000；绩效 = 4000×88/9000 ≈ 39.11
|
||||
- 回款 20000（=销售额 100%）→ R=100、权重 1 → 应付 = 39.11
|
||||
|
||||
守的还有：核算粒度 #25（业务级一次性计提——第二笔回款仅登记进度）、
|
||||
已核算再核算 400、未指定批次 400、成本缺失行毛利按 0 计、负绩效照算、
|
||||
准入（normal 403 / marketing_ops 可用）。
|
||||
"""
|
||||
|
||||
import uuid
|
||||
from decimal import Decimal
|
||||
|
||||
import pytest
|
||||
from fastapi.testclient import TestClient
|
||||
from sqlalchemy import select
|
||||
|
||||
from app.core.db import get_session_factory
|
||||
from app.models import PerformanceLedger, Receipt
|
||||
from app.models.receipt import SETTLEMENT_DONE
|
||||
from tests.integration.factories import business_payload, customer
|
||||
|
||||
pytestmark = pytest.mark.integration
|
||||
|
||||
_CALC = "/api/v1/calc"
|
||||
_BUSINESSES = "/api/v1/business/businesses"
|
||||
_SHIPMENTS = "/api/v1/business/shipments"
|
||||
_RECEIPTS = "/api/v1/business/receipts"
|
||||
_PERSONNEL = "/api/v1/base/personnel"
|
||||
|
||||
|
||||
def _person(client: TestClient, headers: dict) -> dict:
|
||||
resp = client.post(
|
||||
_PERSONNEL,
|
||||
json={
|
||||
"personnel_name": f"t_核算_{uuid.uuid4().hex[:8]}",
|
||||
"business_role_id": _role_id("salesperson"),
|
||||
"salary_standard": "3000.00",
|
||||
},
|
||||
headers=headers,
|
||||
)
|
||||
assert resp.status_code == 200, resp.text
|
||||
return resp.json()["data"]
|
||||
|
||||
|
||||
def _role_id(code: str) -> int:
|
||||
from sqlalchemy import select
|
||||
|
||||
from app.core.constants import BUSINESS_ROLE_SALESPERSON
|
||||
from app.core.db import get_session_factory
|
||||
from app.models import BusinessRole
|
||||
|
||||
factory = get_session_factory()
|
||||
with factory() as session:
|
||||
role_code = BUSINESS_ROLE_SALESPERSON if code == "salesperson" else code
|
||||
return int(
|
||||
session.execute(
|
||||
select(BusinessRole.id).where(
|
||||
BusinessRole.role_code == role_code, BusinessRole.status == 1
|
||||
)
|
||||
).scalar_one()
|
||||
)
|
||||
|
||||
|
||||
def _create_full_chain(
|
||||
client: TestClient,
|
||||
headers: dict,
|
||||
*,
|
||||
items: list[dict],
|
||||
ship_date: str,
|
||||
receipt_date: str,
|
||||
amount: str,
|
||||
) -> tuple[dict, dict]:
|
||||
"""客户 → 人员 → 业务（双行明细+归属）→ 发货 → 回款（指定批次）。"""
|
||||
cust = customer(client, headers)
|
||||
person = _person(client, headers)
|
||||
resp = client.post(
|
||||
_BUSINESSES,
|
||||
json=business_payload(cust["id"], owner_personnel_id=person["id"], items=items),
|
||||
headers=headers,
|
||||
)
|
||||
assert resp.status_code == 200, resp.text
|
||||
biz = resp.json()["data"]
|
||||
|
||||
resp = client.post(
|
||||
_SHIPMENTS,
|
||||
json={
|
||||
"business_id": biz["id"],
|
||||
"ship_date": ship_date,
|
||||
"items": [{"product_name": "t_发货物", "quantity": "1", "sale_price": "1.00"}],
|
||||
},
|
||||
headers=headers,
|
||||
)
|
||||
assert resp.status_code == 200, resp.text
|
||||
shipment = resp.json()["data"]
|
||||
|
||||
resp = client.post(
|
||||
_RECEIPTS,
|
||||
json={
|
||||
"business_id": biz["id"],
|
||||
"receipt_date": receipt_date,
|
||||
"amount": amount,
|
||||
"shipment_id": shipment["id"],
|
||||
},
|
||||
headers=headers,
|
||||
)
|
||||
assert resp.status_code == 200, resp.text
|
||||
receipt = resp.json()["data"]
|
||||
return biz, receipt
|
||||
|
||||
|
||||
def _calc(client: TestClient, headers: dict, receipt_id: int):
|
||||
return client.post(f"{_CALC}/receipts/{receipt_id}/calc", headers=headers)
|
||||
|
||||
|
||||
_GOLD_ITEMS = [
|
||||
{
|
||||
"product_name": "t_市政_金标",
|
||||
"product_category": "municipal_water",
|
||||
"quantity": "100",
|
||||
"sale_price": "100.00",
|
||||
"cost_amount": "3000.00",
|
||||
},
|
||||
{
|
||||
"product_name": "t_轨交_金标",
|
||||
"product_category": "rail_transit",
|
||||
"quantity": "50",
|
||||
"sale_price": "200.00",
|
||||
"cost_amount": "8000.00",
|
||||
},
|
||||
]
|
||||
|
||||
|
||||
class TestGoldenStandard:
|
||||
"""金标准：双类别混合业务复算到分（Decimal 精确断言）。"""
|
||||
|
||||
def test_复算到分_全字段固化(self, client: TestClient, admin: dict) -> None:
|
||||
biz, receipt = _create_full_chain(
|
||||
client,
|
||||
admin["headers"],
|
||||
items=_GOLD_ITEMS,
|
||||
ship_date="2026-10-01",
|
||||
receipt_date="2026-10-20",
|
||||
amount="20000.00",
|
||||
)
|
||||
|
||||
resp = _calc(client, admin["headers"], receipt["id"])
|
||||
assert resp.status_code == 200, resp.text
|
||||
out = resp.json()["data"]
|
||||
assert out["repeated"] is False
|
||||
|
||||
ledger = out["ledger"]
|
||||
assert ledger["payment_days"] == 20
|
||||
assert ledger["settlement_month"] == "2026-10"
|
||||
# 率 = (10 − 20×4/360)‰ = 88/9000，Fraction 约分原文 11/1125
|
||||
assert ledger["rate_text"] == "11/1125"
|
||||
assert ledger["weight_r"] == 100
|
||||
assert ledger["missing_cost"] == 0
|
||||
assert ledger["snapshot_json"]["line_details"][0]["converted"] == "4000.00"
|
||||
|
||||
# 金额锚定 DB 事实源（NUMERIC(14,2) 读回恒两位；响应 JSON 的 Decimal
|
||||
# 序列化 scale 不作断言——归前端展示问题）
|
||||
factory = get_session_factory()
|
||||
with factory() as session:
|
||||
row = session.execute(
|
||||
select(PerformanceLedger).where(
|
||||
PerformanceLedger.receipt_id == receipt["id"],
|
||||
PerformanceLedger.is_active == 1,
|
||||
)
|
||||
).scalar_one()
|
||||
assert row.converted_profit == Decimal("4000.00")
|
||||
# 绩效 = 4000 × 88/9000 = 39.111… → 落库两位 39.11
|
||||
assert row.performance_amount == Decimal("39.11")
|
||||
# 应付 = 绩效 × 权重 1 = 39.11
|
||||
assert row.payable_amount == Decimal("39.11")
|
||||
|
||||
# 回款状态被 CAS 置已核算
|
||||
detail = client.get(f"{_RECEIPTS}/{receipt['id']}", headers=admin["headers"]).json()["data"]
|
||||
assert detail["settlement_status"] == 1
|
||||
|
||||
def test_已核算回款再核算400(self, client: TestClient, admin: dict) -> None:
|
||||
biz, receipt = _create_full_chain(
|
||||
client,
|
||||
admin["headers"],
|
||||
items=_GOLD_ITEMS,
|
||||
ship_date="2026-10-01",
|
||||
receipt_date="2026-10-20",
|
||||
amount="100.00",
|
||||
)
|
||||
assert _calc(client, admin["headers"], receipt["id"]).status_code == 200
|
||||
resp = _calc(client, admin["headers"], receipt["id"])
|
||||
assert resp.status_code == 400
|
||||
assert "已核算" in resp.json()["message"]
|
||||
|
||||
def test_业务级一次性计提_第二笔仅登记进度(self, client: TestClient, admin: dict) -> None:
|
||||
"""核算粒度 #25 一期口径：同业务第二笔回款不重复计提。"""
|
||||
biz, first = _create_full_chain(
|
||||
client,
|
||||
admin["headers"],
|
||||
items=_GOLD_ITEMS,
|
||||
ship_date="2026-10-01",
|
||||
receipt_date="2026-10-20",
|
||||
amount="10000.00",
|
||||
)
|
||||
assert _calc(client, admin["headers"], first["id"]).status_code == 200
|
||||
|
||||
resp = client.post(
|
||||
_RECEIPTS,
|
||||
json={
|
||||
"business_id": biz["id"],
|
||||
"receipt_date": "2026-10-25",
|
||||
"amount": "5000.00",
|
||||
"shipment_id": None,
|
||||
},
|
||||
headers=admin["headers"],
|
||||
)
|
||||
assert resp.status_code == 200, resp.text
|
||||
second = resp.json()["data"]
|
||||
|
||||
resp = _calc(client, admin["headers"], second["id"])
|
||||
assert resp.status_code == 200, resp.text
|
||||
out = resp.json()["data"]
|
||||
assert out["repeated"] is True
|
||||
|
||||
factory = get_session_factory()
|
||||
with factory() as session:
|
||||
rows = (
|
||||
session.execute(
|
||||
select(PerformanceLedger).where(
|
||||
PerformanceLedger.business_id == biz["id"],
|
||||
PerformanceLedger.is_active == 1,
|
||||
)
|
||||
)
|
||||
.scalars()
|
||||
.all()
|
||||
)
|
||||
assert len(rows) == 1, "第二笔回款不得新增台账行（一次性计提）"
|
||||
receipts = (
|
||||
session.execute(select(Receipt).where(Receipt.business_id == biz["id"]))
|
||||
.scalars()
|
||||
.all()
|
||||
)
|
||||
assert all(r.settlement_status == SETTLEMENT_DONE for r in receipts)
|
||||
|
||||
|
||||
class TestGuards:
|
||||
"""校验链与策略点。"""
|
||||
|
||||
def test_未指定批次400(self, client: TestClient, admin: dict) -> None:
|
||||
cust = customer(client, admin["headers"])
|
||||
person = _person(client, admin["headers"])
|
||||
resp = client.post(
|
||||
_BUSINESSES,
|
||||
json=business_payload(cust["id"], owner_personnel_id=person["id"]),
|
||||
headers=admin["headers"],
|
||||
)
|
||||
assert resp.status_code == 200
|
||||
biz = resp.json()["data"]
|
||||
resp = client.post(
|
||||
_RECEIPTS,
|
||||
json={
|
||||
"business_id": biz["id"],
|
||||
"receipt_date": "2026-10-20",
|
||||
"amount": "100.00",
|
||||
},
|
||||
headers=admin["headers"],
|
||||
)
|
||||
assert resp.status_code == 200
|
||||
receipt = resp.json()["data"]
|
||||
|
||||
resp = _calc(client, admin["headers"], receipt["id"])
|
||||
assert resp.status_code == 400
|
||||
assert "发货批次" in resp.json()["message"]
|
||||
|
||||
def test_成本缺失行_毛利按0计并标记(self, client: TestClient, admin: dict) -> None:
|
||||
items = [
|
||||
{
|
||||
"product_name": "t_无成本_市政",
|
||||
"product_category": "municipal_water",
|
||||
"quantity": "100",
|
||||
"sale_price": "100.00",
|
||||
"cost_amount": None,
|
||||
}
|
||||
]
|
||||
biz, receipt = _create_full_chain(
|
||||
client,
|
||||
admin["headers"],
|
||||
items=items,
|
||||
ship_date="2026-10-01",
|
||||
receipt_date="2026-10-20",
|
||||
amount="10000.00",
|
||||
)
|
||||
resp = _calc(client, admin["headers"], receipt["id"])
|
||||
assert resp.status_code == 200, resp.text
|
||||
ledger = resp.json()["data"]["ledger"]
|
||||
# 成本缺失 → 毛利按 0 → 折算 = 销售额×(0−30%) = **−3000**（保守少算
|
||||
# 方向：缺成本的行宁少算不多发），missing_cost=1
|
||||
assert ledger["missing_cost"] == 1
|
||||
assert float(ledger["converted_profit"]) == -3000.0
|
||||
assert float(ledger["performance_amount"]) == pytest.approx(-29.33, abs=0.01)
|
||||
|
||||
def test_负绩效照算不归零(self, client: TestClient, admin: dict) -> None:
|
||||
items = [
|
||||
{
|
||||
"product_name": "t_亏损_市政",
|
||||
"product_category": "municipal_water",
|
||||
"quantity": "100",
|
||||
"sale_price": "100.00",
|
||||
"cost_amount": "9000.00",
|
||||
}
|
||||
]
|
||||
biz, receipt = _create_full_chain(
|
||||
client,
|
||||
admin["headers"],
|
||||
items=items,
|
||||
ship_date="2026-10-01",
|
||||
receipt_date="2026-10-20",
|
||||
amount="10000.00",
|
||||
)
|
||||
resp = _calc(client, admin["headers"], receipt["id"])
|
||||
assert resp.status_code == 200, resp.text
|
||||
ledger = resp.json()["data"]["ledger"]
|
||||
# 毛利 1000、率 0.1 < 阈值 30% → 折算 10000×(0.1−0.3) = −2000 → 负绩效
|
||||
assert float(ledger["converted_profit"]) == -2000.0
|
||||
assert float(ledger["performance_amount"]) < 0
|
||||
|
||||
def test_准入_normal403_marketing_ops可用(
|
||||
self, client: TestClient, admin: dict, normal: dict, make_user, auth_headers
|
||||
) -> None:
|
||||
biz, receipt = _create_full_chain(
|
||||
client,
|
||||
admin["headers"],
|
||||
items=_GOLD_ITEMS,
|
||||
ship_date="2026-10-01",
|
||||
receipt_date="2026-10-20",
|
||||
amount="100.00",
|
||||
)
|
||||
resp = _calc(client, normal["headers"], receipt["id"])
|
||||
assert resp.status_code == 403
|
||||
|
||||
ops = make_user(["marketing_ops"])
|
||||
ops["headers"] = auth_headers(ops)
|
||||
resp = _calc(client, ops["headers"], receipt["id"])
|
||||
assert resp.status_code == 200, resp.text
|
||||
|
||||
def test_台账列表与筛选(self, client: TestClient, admin: dict) -> None:
|
||||
biz, receipt = _create_full_chain(
|
||||
client,
|
||||
admin["headers"],
|
||||
items=_GOLD_ITEMS,
|
||||
ship_date="2026-10-01",
|
||||
receipt_date="2026-10-20",
|
||||
amount="100.00",
|
||||
)
|
||||
_calc(client, admin["headers"], receipt["id"])
|
||||
|
||||
resp = client.get(
|
||||
f"{_CALC}/ledger",
|
||||
params={"settlement_month": "2026-10", "is_active": 1},
|
||||
headers=admin["headers"],
|
||||
)
|
||||
assert resp.status_code == 200
|
||||
rows = resp.json()["data"]["list"]
|
||||
assert rows and rows[0]["business_no"] == biz["business_no"]
|
||||
Reference in new issue
Block a user