承诺与协议卡片
/operations/commitments 和 /operations/agreements 表示不同层级。承诺是只读的派生交付护照；协议管理条件、参与方、日期和生命周期转换。
协议注册表
在 /operations/agreements 中，有权访问该区域的员工可以查看共享协议注册表；客户只是附加筛选条件，不是唯一的列表边界。状态栏筛选 draft、review、awaiting_signature、active、suspended、expiring、expired、terminated 和 superseded。计数覆盖所选筛选器可用的全部结果，而不只是已加载的行。表格/卡片只切换同一结果集的视图，点击行会打开协议护照。
每行标题旁显示方向（客户、供应商或内部）。期限由开始和结束日期组成；没有结束日期时显示无结束日期。请继续浏览列表直到找到所需结果；部分页面不等于完整注册表。
承诺护照
护照还显示创建时间和更新时间作为审计元数据；派生承诺仍为只读。
可在 /operations/commitments 中打开承诺卡片，也可通过 /operations/commitments/:commitmentId 直接打开具体护照，查看类型、承诺数量/单位、提供时的生效日期、履行状态、工作阶段、条件依据和源订单。护照中可能没有当前交付期限：不要根据缺失字段或“开放”分组推断逾期，请以源订单和合同中的交付日期或期限为准。
承诺来自订单，不能在此卡片编辑。请在检查权限和历史后回到源订单修改数量、到期日或条件。加载错误、空结果和源订单补充信息缺失是不同状态。
协议护照
/operations/agreements 中的协议卡片显示方向、状态、生效日期、法律主体、当前条件版本、行数及签署文档要求。名称必须来自关联上下文，不能直接显示技术标识符。
协议护照中的预付款区块显示绑定到该协议、指定条款版本和结算币种的账户；不是客户钱包。不能输入金额：请选择一笔已确认、尚未分配且币种相同的客户付款。开户和入账需要相应权限，并可能受职责分离约束：登记付款的人不能再次确认。加载中、空列表、读取失败、版本冲突和待处理操作是不同状态；空或暂不可用不等于余额为零。本区块不支出资金、不创建或释放发票行预留、不办理退款；这里只打开账户、选择付款并查看状态。如果付款已绑定但尚未入账，卡片会保留同一笔付款并提示再次点击 入账；不要选择其他付款。pending_funding 或待处理的写入表示应等待并重新读取卡片，不代表余额为零。
卡片的主数值是“可用”：可用 = 已入账 − 已占用 − 已使用；非零“已退款”单独显示。卡片还显示当前条款版本和结算币种；新的条款版本会开启独立的预留区；被替代版本的余额不会转移。“已使用”表示与已开具发票行的关联，不表示此区块可执行支出；这里没有支出、创建/释放预留或退款操作。
处于 awaiting_signature 状态时，协议等待门户外确认签署；门户只记录这个决定，不会自行作出决定。因此这里没有单独的激活按钮，请检查外部签署流程和关联的文档副本。实际下一步是取得已签署文本，然后在下方文档区域选择添加；它不会自动出现。
条件下方有单独的关联文档区域，提供添加和查看全部操作。签署副本尚未生成时列表可能为空，这不表示访问失败；创建时间和更新时间提供额外的审计上下文。
查看全部会在当前协议的上下文中打开文档注册表：/documents?sourceType=agreement&sourceId=<agreementId>。结果只能包含此协议的文档，并显示清晰的本地化标题、上下文标签和空状态；技术 ID 或其他协议的文件都不能算作正确的筛选结果。
转换需要匹配状态和卡片的当前版本，以免覆盖他人的修改。每次转换都要填写原因；原因会保存到协议历史中。
如果用户有写入权限，可以在 /operations/agreements/new 创建协议。表单会创建草稿；协议处于 draft 或 review 时，可在 /operations/agreements/:agreementId/terms 编辑条件，这会替换当前条件。若卡片已变化或出现冲突，请重新阅读卡片后再试。界面没有单独回到旧版本的操作；从 review 回到 draft 是编辑条件的一部分。
选择客户和第一项报价/价格后，门户会建议“报价 — 客户”这样的名称。在你手动修改之前，更换选择会更新建议；手动修改后，门户会保留你输入的文字。协议名称是必填项，请使用清晰信息而不要编造数据；编辑已有协议不会覆盖原有名称。
当前预付款选择器中的付款日期可能显示为原始 ISO 值 YYYY-MM-DD，而不是当前语言环境的格式。这是源代码阻塞：不要把它当作本地化日期证据；含金额画面在记录 currency.expected/currency.observed 并完成匹配构建日期复核前不得发布。
允许的转换
draft→review：提交审核；review→awaiting_signature：提交签署；active或expiring→suspended：暂停；suspended→active：恢复；- 任意可变状态 →
terminated：终止，不可逆。
激活不是此卡片上的按钮：active 来自法律签署后或外部文档系统。到期和替换转换由系统处理。
如果卡片版本已变化或转换未被接受，请重新加载并根据最新信息决定；不要盲目重试旧操作。
安全
转换前检查条件版本、签署文档、法律主体、客户、日期和访问权。示例请使用虚构的合同、金额和参与方；不要暴露银行数据、客户数据或技术标识符。
相关页面