跳到主要内容

ZhenRobot 部署运行手册

Status: minimal deployment runbook baseline.

本文件定义 www.zhenrobot.com 当前 repo-local 的最小部署与回写边界。

1. 目的​

避免后续对静态站、Webhook 路由、环境变量和运行方式的修改只停留在命令或聊天记录中。

2. 当前最小运行对象​

  • 公开站点页面
  • 静态资源
  • repo-local 运行脚本
  • 当前仓内的 Webhook 路由壳
  • 公开订单状态与签收证明展示页
  • 文档 / 白皮书 / 下载中心入口页

3. 变更时必须回写的事项​

  • 站点部署方式变化
  • 域名、回源、入口页变化
  • Webhook 路由或转发方式变化
  • 影响订单状态、签收证明或异常处理展示的运行方式变化
  • 文档站入口、白皮书入口或下载中心入口变化
  • 与 zhen-platform-console、zhen-platform-core、zhen-brain-core 的路由或回调关系变化

4. 关键运行边界​

  • 本仓可持有站点部署细节、静态资源与必要转发壳
  • 本仓不是统一身份、统一账单、统一 entitlement、统一 Key 的真相源
  • 若回调、支付、订单主事实、Key 生命周期或工作区边界由共享层解释，本仓只保留必要的接入、展示与转发规则
  • 浏览器前台不应在正式生产路径中直连 zhen-brain-core

5. 订单状态、证明与异常链要求​

  • 与订单状态、签收证明、异常处理相关的部署或路由调整，必须同步回写本文件
  • manual_takeover、exception、签收证明、回执样例与状态展示规则必须保持一致，不允许页面和回调语义分叉
  • 若机器人主链触发人工接管，应明确记为异常升级链，不得在展示层伪装成纯机器人自动完成

6. Webhook 与共享层对接要求​

  • repo-local 可以保留 Webhook 入口壳、转发壳或前台展示相关的适配层
  • Webhook 的签名验证、账单解释、订单主事实、entitlement 真相与跨租户隔离，不应在本仓重新定义
  • 若接入开发者回调，必须与 Scoped Key、工作区隔离和订单 / 证明访问权限保持一致

7. 环境变量与敏感配置治理​

  • 共享层环境变量和正式 contract 不应在本仓被重新解释
  • 任何新增域名、Webhook、回调密钥、对象存储、证明文件地址或转发路由，都必须回写本文件
  • 凡是影响前台订单状态、签收证明、异常处理或下载能力的配置，不允许只存在于部署命令或聊天记录

8. 最低巡检与回滚要求​

  • 首页、报价页、订单状态页、签收证明页、文档入口页必须纳入最小巡检
  • 若部署影响订单状态查询、证明查看或异常说明，必须具备可回滚路径
  • 回滚不应破坏订单状态展示、证明可读性与文档入口

8.1 首个最小真实链路巡检冻结版​

在首份非示例真实 manifest 出现前，最小巡检不得再发散，先冻结为：

  1. landing / scenario 可访问且 CTA 不死链
  2. quote submit 可提交并返回可追踪标识
  3. track 可用同一标识读取状态
  4. proof 或 exception 至少一个终态页可读
  5. 桌面端与移动端各完成一次同链路访问留痕

固定要求：

  • 若第 2 步仍是 mailto:，本轮巡检应直接判定为“最小真实链路未成立”
  • 若 track、proof、exception 页面只是静态样例，没有真实标识驱动，也不得记为通过
  • 首份真实 manifest 必须至少索引这五步对应的页面访问与结果证据

9. 当前最低要求​

  • 任何部署相关变更都必须同步更新本文件
  • 若后续引入更细的部署、回滚、巡检步骤，可在 ops/ 下继续细分，但本文件仍为入口
  • 任何影响现实履约可信度的运行变化，都必须和 architecture/、commercial/、测试证据一起联动回写