Files
AgentLab/backend/tests/fakes/fake_erp.py
T
ThearchyHelios 941723b17c 端到端验收修复与指标出具:
- 身份与工具:登录页建第一个管理员(认人接口的 401 说明能不能建);搭建者有只读的人和组名录,选人给候选并核对名字;授权三行带标题;端点请求头名校验(空名、非法名存不进、发不出时说清原因);写入能力在工具页试运行一律演练、不发送,HTTP 状态照实说成败;写记忆不算只读、查询能力只能选同一端点上的只读能力;审批与遮罩的说法和实际规则一致;开登录时不要署名、导入和发布记登录的人;使用者不显示推演等只给搭建者的操作,403 按是否开登录说话;登录页只认一次人
- 流程与实例:图里用到的岗位(派给谁、超时升级给谁、发送确认派给谁)全部派生、没绑人的发布时报错;写外部系统的参数按能力声明的类型收拢后再算哈希和发送,收不成就不发;发起人的实例页只看这一步的状态,处理人才给待办卡;会签进度带登录核实和时间,升级后照实写规则;实例状态写流程的结论(已退回、未确认、等待核实写入结果),核实生效后不再挂失败原因;流程应用首页不派生最近封存运行的结果块,看板没数据时是安静的空态;样例⑩的金额带类型和下限、待办标题带金额,表单上下限前后端一起生效
- 看板与证据:定时任务模板加 ISO 周、上一 ISO 周、本月、上月;出处链穿过原样解析查询结果的整形节点,追不到原始数据的照实说停在哪里,样例⑨改用 cell();应用首页和版本历史都能做成应用;指标块单位不重复;版本列表带退役说明;定时任务页头跟着刷新;删视图要确认、新视图能起名;编辑器属性用中文名、术语带解释
- 指标出具(用户 2026-10-15 拍板):契约只写「指标来自」、上游没有报告撰写节点、成果里没有模型写的话时按指标出具——必需指标齐、指标输入追到原始数据、成果字段里的数回指得上才完整出具;受管级要求每个指标静态地追到原始数据(governed.metric_untraced);出具横幅和应用印章写明按指标
- 受管工作流降为已发布只给管理员(Q8 顺延,服务端同样拦);工作流接口带当前发布版的级别,画布上改过之后也认得出受管工作流
2026-10-15 07:15:37 +08:00

182 lines
8.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""假的外部系统(付款),供动作的测试(设计文档 §7.2)和浏览器验收用。名字、单号都是虚构的。
- 认 Idempotency-Key:同一个键只记一笔,再来同一个键交回那一笔(200),新键记一笔(201);
- 有查询接口:按幂等键查付款,查到 200,查不到 404;
- 能注入四种情况(mode):ok 正常;timeout_after_write 写成功之后不回话(客户端超时,结果未知);error_500 不记账、
回 500;error_4xx 不记账、回 422(参数不对)。
- requests 记下收到的每一次写请求(幂等键、环境、请求体),测试据此数「外部系统收到了几次」。
两种用法:
- 测试里不起服务:endpoint_request_for(erp) 给出一个和 capabilities.registry.endpoint_request 同签名的替身,
monkeypatch 上去即可;
- 浏览器验收:scripts/fake-erp.py 起 app(erp)(Starlette),在「工具 → 端点」登记成一个端点(开内网访问,配 test 和
prod 两个环境,路径 /test 和 /prod 前缀分别记账),付款能力 POST {环境}/payments,查询能力 GET {环境}/payments/lookup。
"""
from __future__ import annotations
import asyncio
import itertools
from dataclasses import dataclass, field
from typing import Any
MODES = ("ok", "timeout_after_write", "error_500", "error_4xx")
@dataclass
class FakeErp:
mode: str = "ok"
#: (环境, 幂等键) → 付款记录
payments: dict[tuple[str, str], dict[str, Any]] = field(default_factory=dict)
#: 收到的每一次写请求
requests: list[dict[str, Any]] = field(default_factory=list)
#: 收到的每一次查询
lookups: list[dict[str, Any]] = field(default_factory=list)
#: timeout_after_write 时服务端挂多久(秒)。比客户端的超时长就行
hang_s: float = 30.0
_ids: Any = field(default_factory=lambda: itertools.count(1001))
def reset(self, mode: str = "ok") -> None:
self.mode = mode
self.payments.clear()
self.requests.clear()
self.lookups.clear()
def writes(self, environment: str | None = None) -> list[dict[str, Any]]:
return [r for r in self.requests if environment is None or r["environment"] == environment]
def write(self, environment: str, idem_key: str | None, body: Any) -> tuple[int, dict[str, Any], bool]:
"""处理一次写请求:(状态码, 响应体, 是不是写成功之后不回话)。"""
self.requests.append({"environment": environment, "idem_key": idem_key, "body": body, "mode": self.mode})
if not idem_key:
return 400, {"error": "missing Idempotency-Key"}, False
if self.mode == "error_500":
return 500, {"error": "internal error"}, False
if self.mode == "error_4xx":
return 422, {"error": "invalid amount"}, False
key = (environment, idem_key)
if key in self.payments:
return 200, self.payments[key], False
payment = {"id": f"PAY-{next(self._ids)}", "status": "paid", "idempotency_key": idem_key,
"amount": (body or {}).get("amount") if isinstance(body, dict) else None}
self.payments[key] = payment
return 201, payment, self.mode == "timeout_after_write"
def lookup(self, environment: str, idem_key: str) -> tuple[int, dict[str, Any]]:
self.lookups.append({"environment": environment, "idem_key": idem_key})
found = self.payments.get((environment, idem_key))
return (200, found) if found else (404, {"error": "not found"})
def endpoint_request_for(erp: FakeErp, *, lookup_capability: str = "erp_lookup") -> Any:
"""capabilities.registry.endpoint_request 的替身:名字是 lookup_capability 的当查询,其余当写入。语义同真的执行器:
写成功之后不回话的交 unknown=True;演练(端点没有测试环境时传进来的是 simulated)不碰假系统。"""
from app.capabilities.registry import EndpointResult
async def fake(session: Any, capability: Any, args: dict[str, Any], *, environment: str,
idem_key: str | None = None, on_behalf: str | None = None, run_id: str | None = None,
node_id: str | None = None, tool: Any = None) -> EndpointResult:
if environment == "simulated":
return EndpointResult(status=None, body={"simulated": True}, environment="simulated")
if capability.name == lookup_capability:
status, body = erp.lookup(environment, str(args.get("idempotency_key") or ""))
return EndpointResult(status=status, body=body, environment=environment)
status, body, hung = erp.write(environment, idem_key, args)
if hung:
return EndpointResult(status=None, body=None, unknown=True, environment=environment,
error="端点没有返回确定的结果:ReadTimeout")
return EndpointResult(status=status, body=body, environment=environment)
return fake
def app(erp: FakeErp | None = None) -> Any:
"""ASGI 应用(scripts/fake-erp.py 用)。路径以环境开头:/test/… 和 /prod/… 各记各的账。"""
from starlette.applications import Starlette
from starlette.requests import Request
from starlette.responses import JSONResponse
from starlette.routing import Route
erp = erp or FakeErp()
async def pay(request: Request) -> JSONResponse:
env = request.path_params["env"]
try:
body = await request.json()
except ValueError:
body = None
status, payload, hung = erp.write(env, request.headers.get("Idempotency-Key"), body)
if hung:
await asyncio.sleep(erp.hang_s)
return JSONResponse(payload, status_code=status)
async def lookup(request: Request) -> JSONResponse:
status, payload = erp.lookup(request.path_params["env"], request.query_params.get("idempotency_key", ""))
return JSONResponse(payload, status_code=status)
async def mode(request: Request) -> JSONResponse:
wanted = (await request.json()).get("mode")
if wanted not in MODES:
return JSONResponse({"error": f"mode must be one of {MODES}"}, status_code=400)
erp.mode = wanted
return JSONResponse({"mode": erp.mode})
async def state(_: Request) -> JSONResponse:
return JSONResponse({"mode": erp.mode, "requests": erp.requests, "lookups": erp.lookups,
"payments": [{"environment": e, **p} for (e, _), p in erp.payments.items()]})
async def reset(_: Request) -> JSONResponse:
erp.reset()
return JSONResponse({"mode": erp.mode})
return Starlette(routes=[
Route("/{env:str}/payments", pay, methods=["POST"]),
Route("/{env:str}/payments/lookup", lookup, methods=["GET"]),
Route("/_fake/mode", mode, methods=["POST"]),
Route("/_fake/state", state, methods=["GET"]),
Route("/_fake/reset", reset, methods=["POST"]),
])
#: 测试里登记的两个能力:付款(写入,卡号遮罩)、按幂等键查付款(读)
PAY, LOOKUP = "erp_pay", "erp_lookup"
def install(monkeypatch: Any, erp: FakeErp, endpoint_id: str, *, lookup: bool) -> dict[str, Any]:
"""把能力登记和平台执行器换成替身(治理底座包的接口,测试里不依赖它的实现)。返回登记的能力,测试可以再改。"""
from types import SimpleNamespace
from app.capabilities import registry
caps = {
PAY: SimpleNamespace(name=PAY, title="付款", effect="write", effect_system="write", approval="inherit",
unattended_write=False, masked=["/card"], endpoint_id=endpoint_id,
lookup=LOOKUP if lookup else None, version=3, credential_mode="service"),
LOOKUP: SimpleNamespace(name=LOOKUP, title="查付款", effect="read", effect_system="read", approval="none",
unattended_write=False, masked=[], endpoint_id=endpoint_id, lookup=None, version=1,
credential_mode="service"),
}
async def get_capability(session: Any, name: str) -> Any:
return caps.get(name)
monkeypatch.setattr(registry, "get_capability", get_capability)
monkeypatch.setattr(registry, "endpoint_request", endpoint_request_for(erp, lookup_capability=LOOKUP))
return caps
async def endpoint_row(*, test: bool) -> str:
"""建一个登记的端点(prod 必有,test 看参数),返回 id。"""
import uuid
from app.db.base import SessionLocal
from app.db.models import Endpoint
envs: dict[str, Any] = {"prod": {"base_url": "http://erp.example/prod", "headers": {}}}
if test:
envs["test"] = {"base_url": "http://erp.example/test", "headers": {}}
async with SessionLocal() as session:
row = Endpoint(name=f"erp-{uuid.uuid4().hex[:8]}", environments=envs)
session.add(row)
await session.commit()
return row.id