ERP 板块能力、接口与边界

ERP 是「集群 + 供给包」的组合式交付：一个行业无关的复式事件账内核，加行业模板资产（连接器 pack、舰队蓝图、科目映射、报表 preset），经同源入口对外提供 REST 面与 MCP 工具面。它不是单体 ERP 应用，也不提供表单式 UI。

本页所有数字均由 claims.json / gaps.json / tool-surface.json / coverage/ / 模板 manifest 在构建时派生，与 claim_gate 同源；不写价格、客户数、用量或上线日期。

本页口径
项目	数量	出处
MCP 工具	21¹	tool-surface.json
业务路由	63²	coverage/ （另有 2 条健康探针；其中 20 条未实施）
行业模板	3³	templates/*/manifest.json
可宣称能力	12⁴	claims.json
明确不宣称	7⁵	claims.json

形态：四层，各自独立升级

客户端壹座 miniapp 四端UE / SE / SP / CP 四端页面集/erp/supply-chain/v1/*　同源入口，剥掉客户端自带的 X-ERP-*
平台网关platform gateway按会话 + 绑定记录重注入身份；无会话 401，未绑角色不注入
纵向 REST 服务面vertical api63 路由；单副本；闸序租户 → 页面集 → grant → 身份域全程走内核工具面，不直连库表
行业模板层vertical templates跨境 / 餐饮 / 仓配；四件套 + 定价 + 页面集；边界由 AST 审计仅 proposal，不直写
账本内核fact ledger kernel复式事件账；确认门是唯一落账路径；借贷必平由 DB 约束强制

仓构成
角色	仓	面	源码行	测试行
账本内核（行业无关）	`fd-erp-ledger-mcp`	MCP 工具面	4456	2895
行业模板工厂（差异全部上移至此）	`fd-erp-vertical-templates`	模板资产 + 连接器绑定 + 能力矩阵	10715	8536
纵向 REST 服务面	`fd-erp-vertical-api`	REST 65 路由（含 20 placeholder）	3174	1797

能力面（可宣称，逐条带证据）

能力	标识	证据
复式事件账（写路径只出 proposal，确认门唯一落账；借贷必平由数据库约束强制；分录 append-only；余额确定性重算）	`ledger.double-entry`	codemcp_tool×4
stable_id 幂等去重（同源重推只落一次）	`ledger.idempotent`	code×1
多币种：原币 + 本位币折算，汇率带 as_of 与出处，无出处拒绝	`ledger.fx-provenance`	code×2
对账只读滩头：四类差异含双侧原始引用，对外部系统零写入	`recon.readonly-four-diffs`	mcp_tooltest×3
三个行业模板以四件套交付（连接器 pack / 舰队蓝图 / 科目映射 / 报表 preset），各件独立版本	`templates.four-piece`	asset×3
扩展件：取价规则 pack（规则带出处）+ 四端页面集 pack（壹座底座契约）	`templates.extension-packs`	asset×2
出网单口：商家数据只经连接器运行时读取，模板层不持端点、不发 HTTP、不读凭证	`connector.single-egress`	codetest×2
连接器三态证据链（目录 provider / 执行器测试 / live 验收），缺一态即未接通	`connector.three-state`	assettest×2
分成只产出双方可核对的分成对账单与核对指令，零资金执行面（二清红线）	`shares.no-fund-execution`	codetest×2
事件计费与计费规则审批（bill_event / approve_billing_rule）	`billing.event`	mcp_tool×2
双客群租户隔离：经营数据按租户（cell）隔离，查询闸强制租户列	`tenant.isolation`	code×1
三个行业连接器包已在市场（supply-chain v3 / restaurant-chain v2 / crossborder v2）	`market.connector-packs`	release×3

明确不宣称（对外如实守界）

以下条目以否定口径出现在本页与官网；任何肯定句式都会被 claim_gate.py 判红。

能力	口径
不宣称：开票自研 / 支持开票	开票自研当前不提供（挂账）：票据本体由客户既有合规渠道处理，平台不伪造不代开
不宣称：税务申报	税务申报当前不提供（挂账）
不宣称：资金执行（资金池 / 代收代付 / 分账执行 / 资金归集）	二清红线：平台只产出对账结果与核对指令，资金归集与分账走客户自选的持牌通道
不宣称：单体 ERP 应用 / 表单式 UI	ERP 以「集群 + 供给包」组合交付，不是单体 ERP 应用或表单式 UI
不宣称：官网已 deploy	官网 ERP 落地页为可发布工件 + 本地校验证据；site deploy 需真实凭据，属独立发布步骤
不宣称：网关已上线	gateway rollout 需真实凭据与集群变更，属独立发布步骤
不宣称：registry 快照已写入	registry 写入属独立发布步骤，需真实凭据

MCP 工具面（21 个）

proposal

工具	读 / 写	行为
`submit_proposal`	写	write · 只创建 proposals 行、绝不直接落账；同 stable_id 重复提交返回首次结果（唯一索引去重）
`list_proposals`	读	read · 分页查询本租户 proposal 列表及状态（待确认/已确认/已拒绝）
`confirm_proposal`	写	write · 确认门；确认后按复式分录落账，借贷必平由 DB 约束强制、不平整笔拒绝；同 stable_id 幂等
`reject_proposal`	写	write · 拒绝 proposal，留审计痕迹且不落账；同 stable_id 幂等

ledger

工具	读 / 写	行为
`query_balance`	读	read · 按科目/币种查询余额；余额由 journal_entries 确定性重算，无直写余额字段
`query_entries`	读	read · 分页查询已落账分录（原币/折算、出处、来源引用、时间戳、冲正关联）

recon

工具	读 / 写	行为
`run_reconciliation`	写	long-running · 运行两源流水对账（只读滩头，对外部系统零写入），立即返回 task_id；幂等不产生破坏性副作用，但会创建/推进对账任务与报告状态故非 read-only
`get_recon_report`	读	read · 按 task_id 查询对账任务状态/进度/结果 + 四类差异清单（缺失/多余/金额不符/状态不符，双侧原始引用）

billing

工具	读 / 写	行为
`submit_billing_rule`	写	write · 登记计费规则新版本（draft→pending_approval）；同 rule_key 版本递增、重复提交产生新版本故非幂等；无出处费率拒绝（RATE_UNSOURCED）
`approve_billing_rule`	写	write · 规则确认门（pending_approval→active，人工确认、不接受程序自审自批）；同维度冲突未处置拒绝上线；同 rule_key 旧 active 版本随新版本退役
`list_billing_rules`	读	read · 分页查询计费规则（含版本、状态机、config、rate_source）
`bill_event`	写	write · 按 active 规则对事件计费，写 fee_details（append-only，快照锁定规则版本）+ 组 billing-engine 机器车道分录 proposal（不直接落账）；同 stable_id 重推返回首次结果
`list_fees`	读	read · 分页查询费用明细（含红冲反向行 status='reversed' + reversal_of 关联）
`get_fee_detail`	读	read · 费用详情 + 四层溯源链（费用项→业务单据→作业事件→计费规则版本）+ 快照确定性重算
`reverse_fee`	写	write · 红冲费用：新增反向明细行（reversal_of 关联，原行原样保留，append-only 无改/删路径）；原分录已落账时组冲正 proposal；同 fee 幂等
`simulate_billing`	读	read · 按历史事件集试算新旧规则费用差异（零写入；费率出处纪律同正式规则）
`bill_period_snapshot`	写	write · 按期间触发日终快照计费（存储费 = 日终库存快照 × 费率）：批量快照 → fee_details（快照锁定规则版本+汇率四要素）+ 一条 billing-engine 机器车道分录 proposal（不直接落账）；幂等键 = (租户, 期间, stable_id)，同期间重跑返回首次结果

credit

工具	读 / 写	行为
`reserve_credit`	写	write · 占用客户信用额度（备忘性质，不写复式分录）；额度不足拒绝（CREDIT_EXCEEDED 含额度明细）；同 stable_id 幂等返回首次结果
`release_credit`	写	write · 释放信用占用（reserved→released，幂等；备忘表状态推进，非账本事实）
`query_credit`	读	read · 查询额度位：limit / ar_balance（1300 分录确定性重算）/ reserved / available
`list_credit_reservations`	读	read · 列出信用占用明细（含派生状态 reserved/expired/released 与 expires_at）；不释放、不修改任何占用

REST 接口面（63 条业务路由，20 条未实施）

面	路由数	实施状态
`cp`	12	4 未实施
`pagesets`	1	已实施
`se`	15	5 未实施
`sp`	13	6 未实施
`ue`	22	5 未实施

未实施端点按契约返回 501 NOT_IMPLEMENTED 并附计划车道，承载层不改写、不吞掉、不伪装成占位表单。

行业模板（差异全部上移至此）

行业	模板资产	上架状态
跨境电商对账模板 v1.4.4	connector_packfleet_blueprintaccount_mapping_packreport_presetcapability_matrix	已上架：市场 v2
餐饮连锁对账模板 v1.0.0	connector_packfleet_blueprintaccount_mapping_packreport_preset	已上架：市场 v2
仓配分销模板 v1.0.0	connector_packfleet_blueprintaccount_mapping_packreport_presetpricing_rules_packpagesets_pack	已上架：市场 v3

功能覆盖矩阵（supply-chain，35 个功能点）

直接命中 23
模式复用 12
新建 0
不做 0

矩阵由客户功能清单导入后重算生成（幂等），每个功能点带至少一条实现证据；清单本体不进规格与模板资产，只以脱敏编号引用。

连接器缺口（4 条，每项带机器判据）

缺口	能力	责任仓	状态
`unionpay-no-provider`	银联收款渠道（结算流水只读）	`open-connector-mt`	open
`wms-no-provider`	客户 WMS（库存快照只读，角色绑定 wms）	`open-connector-mt`	open
`payments-not-wired`	支付渠道结算读取（微信支付/支付宝，经连接器运行时）	`fd-erp-vertical-templates`	resolved
`kingdee-no-executor-test`	金蝶云星空（凭证/单据同步）	`open-connector-mt`	open

边界

资金（二清红线）: 只产出对账结果与核对指令。不提供资金池、代收代付、分账执行；资金归集与分账走客户自选的持牌通道。
开票 / 税务: 不自研、当前不提供（挂账）。账内可记录发票类事件并参与对账；票据本体走客户既有合规渠道，不伪造、不代开。
执行面: 发货、支付、补货、开票等经营动作仅经采纳的外部 MCP server 完成；凭证由租户自带（BYOK）、经环境变量注入，零落库零日志。
租户隔离: 同时服务寻数自用与外部商家/泛企业客户；经营数据按租户隔离，任一客户租户不能读取其他租户的账、单据或报表。