财务中心 Runbook(全球化)
SQL 顺序 · 演示路径 · 审计核验 · CI gate
文档来源:
docs/RUNBOOK_FINANCE_CENTER_GLOBAL_V1.md# 财务中心运行手册(全球化) > 财务中心(全球化)上线与验收 运行手册(facts-only) 目标:让“收款/付款更简单”,并保持总部/城市分权、合同/收费标准统一口径、记录清晰可查可核验。 --- ## 0) 原则 - facts-only:记录事实与证据链,不做收益承诺。 - 统一口径:pricing_ref / contract_ref / rule_ref 只引用不写死。 - 权限:按 city_center_id 隔离;总部可跨城审计/放行。 --- ## 1) SQL 执行顺序(上线必做) > 若已有库,请按顺序执行;全新库可直接执行对应建表 SQL。 ### 1.1 必须执行(缺失会导致页面/API 501) 1) 付款申请 主表:`docs/SQL_FIN_PAYREQS_V1.sql` 2) Pricing SSOT:`docs/SQL_FIN_PRICING_RULES_V1.sql` 3) Contract SSOT:`docs/SQL_FIN_CONTRACT_TEMPLATES_V1.sql` ### 1.2 已有库增量(按需) 4) 付款申请 增 client_type/country_code:`docs/SQL_UPGRADE_FIN_PAYREQS_ADD_CLIENT_COUNTRY_V1.sql` 5) 付款申请 增 legal_required/legal_status:`docs/SQL_UPGRADE_FIN_PAYREQS_ADD_LEGAL_STATUS_V1.sql` --- ## 2) 入口与自检 - 财务中心:`/admin/finance_center` - 付款申请:`/admin/finance_pay_requests` - 收费标准:`/admin/finance_pricing_rules` - 合同模板:`/admin/finance_contract_templates` CI gate(防回潮): ```bash bash bin/ci_check_finance_payreq_loop_v1.sh ``` 输出应为 `OK` --- ## 3) 最小演示路径(推荐给团队培训) ### Step A:从场结算一键生成 付款申请 1) 打开:`/admin/space_settlements` 2) 找到一条 settlement,点击“发起付款申请” 3) 预期:弹窗提示已创建 payreq_id ### Step B:付款申请 自动带出 pricing_ref / contract_ref 1) 打开:`/admin/finance_pay_requests` 2) 找到刚创建的记录 3) 预期字段: - client_type / country_code(默认 enterprise/CN,或创建时传入) - pricing_ref:按 SSOT 自动匹配(CN 优先,否则 ALL;priority 最小优先) - contract_ref:按 SSOT 自动匹配(CN 优先,否则 ALL;priority 最小优先) ### Step C:法务放行(按事件/金额阈值) 1) 在 付款申请 页面下方“法务放行/驳回” 2) 填 payreq id,选择 legal_status=approved,提交 3) 预期: - legal_required=1 - legal_status=approved - 审计写入 `finance_legal_status_changed` ### Step D:归档 ZIP + 核验 1) 在 付款申请 列表行点击“下载ZIP” 2) 解压检查: - payreq.json - audit_events.csv - VERIFY_INDEX.md(含创建事件核验链接) - PACK_MANIFEST.json 3) 打开 VERIFY_INDEX 的核验链接,确认能定位审计记录 --- ## 4) 审计检索(核验入口) - 付款申请:`/admin/share_cards_audit?q=finance_payreq_` - Pricing upsert:`/admin/share_cards_audit?q=finance_pricing_rule_upsert` - Contract upsert:`/admin/share_cards_audit?q=finance_contract_template_upsert` - Legal status:`/admin/share_cards_audit?q=finance_legal_status_changed` - 付款申请 pack:`/admin/share_cards_audit?q=finance_payreq_pack_downloaded` --- ## 5) 常见问题(P0 口径) - proof_url:当前为“粘贴链接记录凭证”(P0),后续可接统一上传存储。 - legal_required 规则:当前为金额阈值 P0(>= 50,000.00),后续可接“项目事件策略”。