项目范围（Project Scope）

Status: formal project scope baseline.

Canonical current-entry docs:

/www/wwwroot/default/swam_architecture_zhenrobot.md

/www/wwwroot/default/swam_zhen_business_matrix.md

/www/wwwroot/www.zhenrobot.com/README.md

/www/wwwroot/www.zhenrobot.com/docs/README.md

本文件定义 www.zhenrobot.com 当前项目范围与边界，不重新定义生态总纲；若与上游冲突，以上游为准。

提示这页适合谁阅读

如果你需要判断某项能力应放在前台、文档站还是平台控制台，这页提供范围地图；如果你要直接接入 C2AI2X，请从选择接入路径开始。

项目范围的四个观察面

用户入口

让客户理解服务区域、报价与履约方式。

订单链路

从报价、追踪到证明与异常处理。

集成入口

提供文档、白皮书与企业接入说明。

平台边界

明确哪些长期动作应交给统一平台。

固定说明：

本文档定义项目正式范围与必须补齐的前台能力，不等于宣称这些能力截至今日都已真实存在
截至 2026-04-16 的 reality check，公开前台核心采购 / 订阅 / 演示 CTA 仍主要为 mailto:，因此 报价 / 订单状态 / 签收证明 / 异常处理 仍应被理解为本仓当前优先补齐项
截至 2026-04-17 主链联调 Round 1，当前 public live 边界先冻结为 线索 / 报价 / 方案咨询 / 后续承接，不得把未证实的采购、履约、签收或异常结果写成 live

1. 项目正式定义

ZhenRobot 是 Zhen 生态中的 Robot 物理世界履约网络，不是集团门户，不是第二控制台，也不是单纯的机器人品牌展示站。

本仓库当前承担的是：

现实履约产品前台
服务区域、场景、报价、下单引导
订单状态、签收证明、异常处理与 SLA 信任表达
文档中心、白皮书与企业接入前台入口
当前阶段必要的本站路由、静态页与运行材料

2. 当前主使命

把“门到门机器人配送、线下履约交付与物理结果证明”讲清楚。
让用户能从公开页面进入报价、订单状态、签收证明与异常处理链路。
把正式身份、账单、entitlement、API Key、工作区与控制面逐步收敛到 zhen-platform-console / zhen-platform-core。

一句话概括：

本仓库负责把现实履约前台做锋利，而不是在单站里重复实现平台层能力。

3. Phase 1 必须覆盖

首页
服务区域 / 报价页
订单状态 / 签收证明页
异常处理与 SLA 说明页
文档中心 / 白皮书入口
移动端主链可读、可点、可理解

3.1 首个最小真实链路冻结版

Phase 1 不得再发散，先冻结为一条最小真实链路：

首页或场景页 -> quote -> track -> proof / exception -> evidence bundle

其中：

quote
- 不是 mailto:，而是可回写 request_id / quote_id / order_id 的受控提交入口
track
- 至少能展示 created / scheduled / delivering / delivered / exception / manual_takeover 中的最小必要状态
proof / exception
- 至少要能落到一个终态结果页，而不是只停在“已提交咨询”
evidence bundle
- 必须能把桌面端、移动端、订单标识、状态页、终态页与回写证据收进同一批执行包

4. 核心角色

企业客户 / 商家 / 园区 / 物业
- 了解能力边界、服务区域、报价与履约方式
已下单用户
- 查看订单状态、签收证明、异常处理入口
集成方 / 合作方
- 查看文档、API、白皮书与企业接入说明
运营与控制面用户
- 最终应进入 zhen-platform-console，不应继续由本站承担长期平台动作

5. 应做与不应做

本仓库应做

公开获客与信任表达
报价 / 下单入口说明
订单状态、签收证明、异常可见性
文档、白皮书、协议和接入说明

本仓库不应做

统一身份中心
统一账单中心
统一 entitlement 解释层
统一 API Key 生命周期
独立平台控制台
正式生产路径中的前台直连 zhen-brain-core

6. 关键边界

正式生产主链遵守：business frontend -> zhen-platform-core -> zhen-brain-core
登录后订单、账单、Key、组织与运营动作应收敛到 zhen-platform-console
前台可展示订单、证明与异常，但不承担账单/租户/配额/entitlement 的最终解释
若任务从数字执行升级到现实履约，ZhenRobot 负责物理交付结果，不负责重建经营底座

7. 成功判断

当前阶段优先看以下结果：

用户能理解 ZhenRobot 是现实履约网络，而不是品牌门户
用户能找到服务区域、报价、订单状态、签收证明与异常入口
文档、白皮书、企业接入说明有清晰入口
平台 handoff 清晰，不会把站点继续做成第二控制台

截至 2026-04-16 的现实判断：

前两项当前仍属于目标态要求，不应误读成已经被真实前台与证据包证明的已完成事实
本仓下一步最关键的不是继续扩写品牌信息，而是把 quote / order / track / proof / exception 的最小真实链路补出来
在首个最小真实链路落地前，不得把 ZhenRobot 记为“现实履约前台已跑实”

1. 项目正式定义​

2. 当前主使命​

3. Phase 1 必须覆盖​

3.1 首个最小真实链路冻结版​

4. 核心角色​

5. 应做与不应做​

本仓库应做​

本仓库不应做​

6. 关键边界​

7. 成功判断​