-
Notifications
You must be signed in to change notification settings - Fork 0
18 v1 page and prototype spec
本文档是 Figma 原型和前端需求的页面级输入。它描述页面结构、字段、操作、状态、校验和关键流程，不包含实现代码。
- 让平台、商户、用户、客服和现场人员能完整走通 P0 流程。
- 在技术设计前暴露状态缺口、金额歧义和异常死路。
- 给后续 API、数据库字段、权限码、错误码和测试用例提供页面依据。
- 确保 CRMEB 原有普通商城体验不被智慧农业流程破坏。
| 使用端 | 主视口 | 补充视口 |
|---|---|---|
| 平台管理端 | Desktop 1440 × 900 | Desktop 1280 × 800 |
| 商户中心 | Desktop 1440 × 900 | Desktop 1280 × 800 |
| 用户 H5/小程序 | Mobile 390 × 844 | Mobile 375 × 812 |
| 服务端客服 | Desktop 1440 × 900 | Desktop 1280 × 800 |
| 现场作业 | Mobile 390 × 844 | Mobile 375 × 812 |
设计基线：
- CRMEB 当前实际页面风格是最高优先级，不以重新设计品牌、后台框架或商城视觉体系为目标。
- 平台和商户端沿用现有 Element UI 密度、表单和表格习惯。
- 用户端沿用 uni-app 当前导航、商品、订单和支付风格。
- 新页面应让使用者感觉是 CRMEB 原系统自然增加的业务模块，不得大幅改变侧栏、顶栏、面包屑、列表、表单、弹窗、分页、按钮和状态反馈习惯。
- 只有现有组件无法表达批次进度、库存池、账本公式、农业时间线、地图或溯源时，才新增领域组件。
- 平台和商户后台卡片圆角不超过
8px，默认优先使用现有4px；用户端沿用现有16rpx至24rpx移动卡片圆角。不使用卡片嵌套卡片。 - 页面分区使用标题、分隔线、标签页和全宽区域，不用大量浮动卡片。
- 图标按钮优先使用项目现有图标库或 Lucide 对应图标，并提供 Tooltip。
- 金额不使用渐变和夸张大字；关键金额使用清晰层级和正负方向。
- 状态颜色不能成为唯一信息载体，必须同时显示文字。
- 所有长编号、商品名、地块名和异常原因都要验证换行、截断与展开。
开始 Figma 页面设计前必须先完成只读审计，并把截图、尺寸和组件结论放到 Figma 的参考页和 02 Components & Tokens 页面。未完成审计，不进入高保真设计。
当前进度：
- 四端源码、运行态 DOM、数据库菜单、主题、站点和 DIY 装修已完成只读核验。
- 详细事实见 23-crmeb-visual-baseline-audit.md。
- Figma 已建立正式文件、参考页、3 个变量集合、61 个变量和 10 个文本样式。
- 基础令牌页已完成截图校验。
- 用户端 uni-app 组件级复用审计已完成，详见 25-user-uniapp-reuse-audit.md。
- 四端
108个低保真、108个高保真、15条跨端 Flow 和60个流程副本已落图并通过编号、尺寸、重叠、占位文案、缺失字体和真实跳转自动审计；登录态原始截图可在开发阶段选补，不替代当前结构化参考证据。
| 范围 | 必查内容 | 主要来源 |
|---|---|---|
| 平台管理端 | 布局、侧栏、顶栏、面包屑、标签页、列表密度、筛选栏、表单、抽屉/弹窗、详情页、状态标签、分页、空状态 |
smartfarm_admin/src/layout、src/styles、src/components、src/router/modules、主题相关 store/settings |
| 商户端 | 与平台端的共同模式及商户端特有商品、营销、财务页面 |
smartfarm_mer/src/layout、src/styles、src/components、src/views、src/router/modules
|
| 用户端 | 首页装修、底部导航、商品列表/详情、普通秒杀、购物车、订单确认、支付、订单详情、用户中心 |
smartfarm_user/pages.json、App.vue、uni.scss、pages、components、主题和装修相关工具 |
| 服务端 | 客服工作台布局、表格、会话、订单上下文和固定路由 |
smartfarm_service/src/views、src/layout、src/router、src/styles
|
| 后端菜单 | 当前真实菜单层级、页面路径、按钮权限和图标 |
eb_system_menu 与对应路由文件 |
| 主题与站点配置 | 主色、Logo、站点名、上传资源、布局/主题开关 |
eb_system_config、eb_system_config_value 及前端运行配置 |
| 用户端装修 | 实际首页组件、底部导航、分类和主题配置 |
eb_diy、eb_system_group、eb_system_group_data 及装修 API |
审计产出至少包含：
- 四端关键页面截图和页面地址。
- 字体、字号、行高、主色、功能色、边框、圆角、阴影和间距样本。
- 按钮、输入框、选择器、表格、分页、弹窗、抽屉、标签页和状态标签样本。
- 列表页、编辑页、详情页和异常页的现有版式。
- 可直接复用、需要轻度扩展、必须新增三类组件清单。
- 数据库配置与前端默认值不一致时，以当前运行态页面为准并记录来源。
禁止事项：
- 不为了“更现代”整体更换后台布局、主色、字体、图标体系或组件密度。
- 不把智慧农业页面做成独立的另一套品牌后台。
- 不用大面积营销型 Hero、装饰渐变、超大圆角卡片或与现有 CRMEB 不一致的仪表盘风格。
- 不在未核对运行态装修数据前，仅凭源码静态默认值重画用户首页。
- 不把 Figma 社区模板直接套入项目后再要求现有页面适配模板。
下表中的名称首先表示“页面需要具备的领域表达能力”，不是要求前端重新开发一套基础组件。落地顺序必须是：
- 查找 CRMEB/Element UI/uni-app 已有同类页面和组件。
- 已有组件可满足时直接复用。
- 只缺少字段或状态时扩展复用。
- 只有批次、持仓、账本公式、农业时间线等现有组件无法表达的内容才新增领域组件。
用户端页面必须按 25 的审计结论复用现有能力；低保真评审前不根据本表提前创建新的公共组件。
| 组件 | 使用场景 | 必须支持 |
|---|---|---|
StatusTag |
订单、批次、账本、审核、履约状态 | 统一文案、颜色、Tooltip |
BusinessNoLink |
订单号、批次号、账本号 | 点击进入详情、复制图标 |
FilterBar |
桌面列表 | 常用筛选、更多筛选、重置、保存视图 |
DataTable |
桌面列表 | 固定操作列、排序、分页、空状态 |
SummaryStrip |
详情页顶部 | 状态、关键数量、金额、时间和主操作 |
Timeline |
生产、履约、状态历史 | 类型、时间、人员、图片和公开状态 |
BatchProgress |
云仓批次/持仓 | 当前百分比、已售/总量、节点和更新时间 |
InventoryPools |
云仓批次 | 各库存池数量和恒等式校验 |
MoneyBreakdown |
账本与结算 | 本金、收益、回购、扣减、合计和公式 |
RuleSnapshot |
云仓/套餐历史订单 | 历史规则只读展示 |
AuditHistory |
审核和异常 | 操作人、前后状态、原因和时间 |
EvidenceViewer |
农业异常、验收、售后 | 图片、视频、报告和下载 |
TraceLink |
商品、订单、产出 | 查看稳定溯源档案 |
EmptyState |
无数据 | 明确原因与可执行下一步 |
PermissionState |
无权限 | 不暴露数据，给出返回入口 |
每个 Figma 页面和后续 PRD 页面条目必须包含：
页面编号
使用角色
页面目标
入口与返回路径
前置业务状态
页面字段
主要操作
次要操作
校验与错误提示
加载/空/错误/无权限状态
成功后的状态迁移
审计与埋点要求
关联决策编号
页面目标
让运营快速判断活动当前阶段、库存、待选择、代销和结算是否正常。
筛选
- 活动编号/名称。
- 未开始、进行中、选择期、代销中、已结束、已关闭。
- 活动开始/结束时间。
- 商品来源。
- 是否存在库存、结算或异常。
表格字段
| 字段 | 说明 |
|---|---|
| 活动编号/名称 | 可复制编号，点击详情 |
| 活动时间 | 预热、开始、结束 |
| 活动商品数 | SPU 和 SKU 批次数 |
| 活动库存/已付款 | 汇总数量 |
| 待选择 | 已付款待选择明细数 |
| 代销持仓 | 已冻结代销数量 |
| 有效销售进度 | 批次加权汇总，只用于概览 |
| 待结算/待回购 | 金额或数量 |
| 异常 | 质量、库存、售后或账务异常数 |
| 状态 | 活动状态 |
操作
- 新建活动。
- 编辑草稿。
- 复制活动，复制后必须重新选择库存和发布时间。
- 预览用户端。
- 关闭未开始活动。
- 查看数据详情。
进行中活动不允许直接修改已付款用户的价格、结算模式、分成和回购规则。
页面使用步骤导航：
基础信息 → 活动商品 → 发布预检
基础信息
- 活动名称。
- 预热、开始、结束时间。
- 支付超时。
- 默认去向选择期限。
- 活动封面和分享信息。
- 用户端规则摘要。
交互
- 保存草稿不要求所有字段完整。
- 下一步前校验当前步骤。
- 修改结束时间时同步提示选择截止和批次开始时间变化。
- 已有付款后只允许修改展示材料和不影响历史规则的内容。
发布预检
按错误、警告、通过分组：
- 错误必须修复：无活动商品、库存未验收、分成不等于 100%、回购比例非法、时间冲突、缺少代销。
- 警告可确认：库存较少、周期较长、未配置邮寄/自提。
- 通过项：用户端预览、供货审核、规则快照、消息模板。
顶部对象
- 来源类型。
- 商户/平台。
- 商品、SKU。
- 入库/验收可用数量。
- 关联溯源。
配置区
| 分区 | 字段 |
|---|---|
| 抢购 | 抢购价、活动库存、每人限购 |
| 去向 | 代销固定开启；邮寄、自提开关 |
| 邮寄 | 运费模板、包邮、可配送范围 |
| 自提 | 网点、可提货时间、自提期限 |
| 代销 | 预计销售周期、用户/平台分成率 |
| 结算 | 三种模式单选、固定节点只读展示 |
| 回购 | 100%、90%、80%、自定义比例 |
| 售后 | 首次和二次观察期固定选项 |
| 商户货款 | 供货价、验收信息、结算方式只读/确认 |
右侧规则预览
实时展示用户将看到的：
- 支付后再选去向。
- 最晚选择时间和超时自动代销。
- 周期、分成、结算模式和节点。
- 回购计算示例。
- 平台券和运营成本承担。
校验
- 活动库存不得超过验收可用数量。
- 抢购价、供货价和二次最低销售边界显示对比。
- 用户分成率 + 平台分成率必须为 100%。
- 自定义回购比例必须大于 0 且不超过 100%。
- 开启邮寄必须选运费模板或包邮。
- 开启自提必须配置至少一个网点和期限。
顶部指标：
- 活动预占、已付款、首次退款、未抢完退回。
- 邮寄、自提、代销数量。
- 待选择明细和最晚处理时间。
- 二次有效销售、回购和待结算。
标签页：
活动商品 / 首次订单 / 待选择 / 批次 / 商户货款 / 用户账本 / 操作日志
指标点击后跳到已带筛选的对应列表，不在详情中重复塞入完整业务表格。
列表
- 申请编号、商户、商品/SKU。
- 供货价、申请数量、验收数量。
- 计划交付时间。
- 商品/材料审核状态。
- 入库/验收状态。
- 关联活动数。
审核详情
- 商品基础资料和现有商城状态。
- 产地、生产/供应批次、报告和证书。
- 供货价、数量、售后和履约说明。
- 拟供、审批、来源预留、送达、待检、验收、拒收、短缺、活动占用、云仓可用、退回和平台承接数量链。
- 运费、质量和售后三类责任方建议及平台确认快照。
- 历史供货表现。
- 审核通过、驳回、要求补充材料。
一张申请只允许一个来源 SKU。提交申请不改来源库存；审核通过建立预留，完成实际入库/验收后才形成活动可用数量。详情操作由 allowed_actions 控制，拒收、短缺、释放预留和实物退回均须有数量、原因、证据和流水。
筛选
- 活动、商品/SKU、用户、订单号。
- 首次付款、确认中、待选择、邮寄、自提、代销、退款、关闭和异常。
- 距选择截止/自提截止时间。
- 临时邮寄待补运费、运费退款、自提待核销/逾期。
- 是否已提醒。
字段
- 用户、订单、商品、数量和支付时间。
- 当前状态。
- 选择截止倒计时。
- 临时补运费单状态。
- 最终去向、履约/持仓、自提点和首次退款状态。
- 最近提醒时间。
操作
- 重新发送提醒。
- 查看订单规则快照。
- 查看补运费单。
- 查看/核销自提凭证。
- 按授权处理自提逾期协商结果。
- 发起异常处理。
运营不能代用户随意选择去向。系统自动代销由截止任务执行，人工补偿执行必须有审批和操作原因。
按活动、商品/SKU、来源商户、状态、预计到期、进度区间和异常筛选。表格展示批次号、总量、有效售出、锁定、售后冻结、未售、进度、结算模式、下一节点、到期日和冻结原因；行操作仅进入详情、暂停申请或异常处理，不能直接改数量。
顶部摘要
- 批次编号、活动、商品/SKU、来源商户。
- 状态、开始时间、到期时间。
- 冻结代销数量、有效售出、剩余、锁定、售后冻结、回购。
- 当前进度、已达节点、结算模式。
- 累计确认收入、已售本金、可分配利润。
标签页
- 库存池：数量恒等式、库存流水。
- 二次零售：订单明细、分配数量、有效时间、退款。
- 用户持仓：持仓数量、占比、已返本金、收益、回购。
- 进度快照：每次触发、累计数据和节点。
- 账本：本金、收益、回购、冻结和冲正。
- 异常与操作日志。
操作
- 暂停二次分配。
- 恢复。
- 查看差异。
- 到期核算。
- 进入回购。
不能提供“手工修改已售数量”输入框。纠错只能从二次订单、退款、库存流水或受控异常调整产生。
列表按普通商城订单明细展示销售 SKU、支付/完成/退款状态、分配批次、分配数量、锁定时间、有效销售时间和释放/冲正结果。详情展示“普通可售库存与 cloud_only 库存桥接 → 下单锁定 → 支付 → 完成观察期 → 批次有效销售”的证据链；人工只可处理异常映射和差异预览，不可指定某个用户持仓被卖出。
列表字段
- 回购单号、批次、用户/持仓。
- 未售数量、单位本金、回购比例。
- 回购金额、库存转入状态、账本状态。
- 异常/冻结。
详情
- 批次到期依据。
- 最终有效售出与未售数量。
- 用户持仓分配过程。
- 回购计算公式。
- 平台库存接收记录。
- 用户回购账本和资金入账。
操作顺序
核对数量 → 审核回购金额 → 转平台库存 → 生成/确认账本 → 完成
任何一步失败都显示当前成功步骤和可重试动作，禁止用户账本成功但库存转入无记录。
按严重级别、对象类型、活动/批次、异常类型、SLA、负责人和状态筛选。详情展示触发事实、受影响订单/库存/持仓/账本、系统已执行动作、证据、建议、审批和审计。恢复销售、库存修复、回购或资金冲正分别要求独立权限；关闭异常前必须验证受影响对象已回到可解释状态。
筛选
- 用户、活动、批次、持仓和首次订单。
- 本金、收益、回购、冻结、冲正。
- 节点、状态、结算时间。
表格
- 账本编号。
- 用户。
- 类型。
- 活动/批次。
- 节点。
- 本金、收益、回购、调整和合计。
- 业务状态、正式入账状态和 CRMEB 余额流水。
详情
- 输入数据快照。
- 公式和累计差额。
- 历史已结算/正在结算。
- 来源二次订单或回购单。
- 冻结/冲正链。
- 入账前后余额、
posting_key、处理次数和失败原因。
操作
- 规则内记录自动入账，页面只显示处理进度。
- 超阈值或异常记录显示“复核并入账”，弹窗只提交账本版本和审核意见，不提供金额输入框。
- 可恢复失败显示“按原幂等键重试”；成功记录不再显示执行按钮。
- 借方冲正必须从调整申请进入，不能在详情直接扣余额。
账本列表
- 商户、供货申请、活动、商品/SKU、首次订单明细。
- 有效数量、供货价、毛额、退款/履约扣减和应结金额。
- 验收时间、首次完成时间、资格时间、入单状态和冻结原因。
列表与详情必须继续关联供货数量生命周期、首次有效购买、首次售后观察期和 farm_supply_settlement 正式入账记录；平台不能把“满足资格”或“进入结单”展示为已经到账。
结单列表与详情
- 结单号、商户、自然日区间、明细数、毛额、扣减、结算额。
- 自动审核结果、正式入账状态、CRMEB 商户财务流水和入账时间。
- 详情逐笔展示来源账本，生成后不允许增删明细。
操作
- “预览结单”只计算候选，不占用账本。
- “生成结单”由后端重新选择符合条件记录并加锁。
- 超阈值结单可“复核并入账”；失败可按原键重试。
- 已入账差异只能发起调整，不允许重开或编辑原结单。
以抽屉或独立详情页展示来源对象、目标账户、方向、金额、入账前后余额、CRMEB 流水、处理租约、重试记录、Outbox 和审计日志。失败页显示错误码和建议动作，不显示堆栈或敏感数据库信息。
页面按批次或日期查看五组数：
首次订单
活动/云仓库存
二次零售
业务账本
资金入账
差异类型：
- 数量不闭合。
- 金额不闭合。
- 状态延迟。
- 重复账本。
- 缺少资金流水。
- 退款未冲正。
提供“查看差异来源”，不提供直接改余额或改汇总数量的快捷按钮。
列表字段：
- 农场编号、名称、公开地址、负责人、状态。
- 区域数、地块数、栏舍数、当前生产批次数。
- 点位状态：已定位、仅地址、地图配置异常。
- 最近修改时间和修改人。
筛选项为名称/编号、行政区域、状态和点位状态。列表操作使用详情、编辑、启停和查看位置；没有有效点位时“启用”按钮不可用，并展示阻断原因。
农场详情按下列标签组织：
基本资料 / 区域地块 / 栏舍资产 / 仓库库位 / 生产批次 / 公开预览 / 变更记录
基本资料编辑字段：
- 农场编号、名称、公开地址、详细地址、介绍、封面和真实场景图。
- 行政区域、负责人和联系方式。
- 地址关键词检索、地图点选、经度、纬度和固定坐标系
GCJ02。 - 用户端是否公开、公开地址和公开内容预览。
地图点选与地址搜索都只填充候选值，保存时后端再次校验。经纬度必须成对存在，不允许将 0,0 或地图默认中心点当作真实位置。
“仓库库位”标签页维护仓库编号、名称、类型、负责人、内部地址、状态，以及库位编号、货架/层位、允许品类和容量说明。它是 ADM-AG-003 的标签页和抽屉，不新增独立 P0 页面编号；启用中的库存、产出或履约任务引用时只能停用，不能删除。仓库精确位置和库位只对有范围的运营/现场人员展示。
- 区域编辑：农场、区域编号、名称、用途、面积、位置描述、示意图、可选内部中心点和状态。
- 地块编辑：农场、区域、地块编号、总面积、可租面积、土壤/用途、位置描述、示意图、可选内部中心点和状态。
- 区域和地块默认继承农场公开点位；中心点仅用于内部快速定位，不参与面积、容量或冲突计算。
- 用户公开预览显示农场点位、区域/地块名称和示意图，不默认显示地块、栏舍或仓库精确坐标。
全状态：
| 状态 | 页面表现 | 可操作 |
|---|---|---|
| 地图正常 | 地址搜索、点选标记和坐标同步 | 保存草稿、启用 |
| 客户端地图加载失败 | 保留地址、坐标输入和重试 | 保存草稿，不丢表单 |
| 服务端地理编码失败 | 显示稳定错误和手工点位入口 | 保存草稿；无有效点位不可启用 |
| Key 未配置/配额不足 | 显示配置状态和错误码，不显示空白假地图 | 保存草稿、联系配置人员 |
| 坐标非法/缺一项 | 字段内错误，地图不自动跳到默认位置 | 修正后保存 |
| 已启用且被引用 | 关键公开字段显示影响提示和版本 | 可修改非破坏字段；停用需检查关联 |
平台管理端复用现有 src/components/map/Map.vue 的腾讯 GL JS 加载、点选和标记能力，并通过 FarmMapPicker 组合地址检索、服务端地理编码、坐标校验和失败状态；不复制第二套基础地图组件。
列表字段：
- 自提点编号、名称、支持业务、公开地址、营业时间、状态。
- 点位状态、待核销数、关联活动/履约数和最近修改时间。
编辑字段：
- 名称、支持业务固定为
cloud、公开地址和内部补充地址。 - 结构化营业时段、联系人、联系电话。
- 地址搜索、地图点选、
longitude/latitude/GCJ02。 - 用户端说明、到店提示和状态。
启用前校验：
- 名称、公开地址、营业时段和联系方式完整。
- 经纬度成对有效且坐标系为
GCJ02。 - 业务类型固定为云仓自提，不能配置租地/认养产出自提。
- 用户端预览可以显示地址、导航和营业时间。
已生成自提凭证后，网点修改只影响新凭证；历史凭证继续展示确认时的名称、地址、营业时间、联系方式和坐标快照。
字段分区
- 基础：名称、农场、区域、图片、介绍。
- 分配：整块/面积份额、面积、可选作物。
- 周期：预计开始、周期、预计采收次数。
- 交付：固定数量/最低数量、单位、分批规则。
- 服务：包含服务、可选服务和费用。
- 邮寄：运费、配送范围、包装。
- 异常：减产、绝收、延期和退款处理。
- 展示：用户端说明和规则预览。
发布前必须验证真实地块容量和预计可售套餐数量，页面显示“可发布容量”，但不能以估算代替下单时事务校验。
左侧订单队列：
- 已付款待分配。
- 套餐、作物、面积、计划周期。
- 最晚分配时间。
右侧可用资产：
- 农场/区域/地块。
- 可用面积。
- 同期占用。
- 土壤/用途和作物适配。
- 冲突原因。
确认区：
- 分配地块、占用面积、起止时间。
- 分配后剩余容量。
- 自动生成生产批次开关。
确认前再次校验容量。冲突时不清空用户已选条件，刷新可用资产后继续处理。
先选择分配模式：
- 单体：关联可用个体资产和排他规则。
- 批次份额：关联品种、栏舍和份额容量。
其余字段：
- 品种、周期、交付品类。
- 固定/最低交付数量和次数。
- 服务、邮寄和异常规则。
- 个体死亡/疾病替换规则。
- 用户端展示预览。
套餐发布后存在订单时，不允许切换单体/批次份额模式。
顶部：
- 批次、类型、农场、地块/栏舍、作物/品种、负责人、状态。
- 计划与实际周期。
- 预计/实际产出。
标签页：
时间线 / 关联租地认养订单 / 采收产出 / 异常 / 溯源
平台运营可审核记录，现场人员只能编辑未提交或被驳回的本人草稿。
列表优先展示：
- 严重程度。
- 异常类型。
- 影响资产、批次、订单和数量。
- 已通知用户数。
- 处理方案和状态。
详情处理步骤：
确认事实 → 确认影响范围 → 选择补足/替换/延期/补发/退款 → 审批 → 通知 → 执行 → 关闭
关闭前必须填写实际结果。替换资产时同时展示原资产和新资产，不覆盖原记录。
编辑区：
- 来源生产批次和产出批次。
- 已发布过程记录。
- 报告、证书、产地和负责人。
- 关联商品/SKU、云仓批次、订单和履约。
预览区：
- 按用户端真实顺序展示。
- 标识草稿/当前版本。
- 生成稳定二维码预览。
已发布版本编辑时必须填写修改原因，并创建新版本。
商户首页沿用现有工作台，只增加按当前员工权限可见的供货待审核/待交付、履约售后、货款待入单和异议待处理计数及跳转，不新做营销型仪表盘。商品列表增加农产品来源、溯源材料完整度和云仓供货资格；商品编辑在现有表单分区增加稳定产地/资质/报告/证书资料。供应批次、送达和验收证据属于每张供货申请快照，不覆盖商品主数据。
筛选草稿、待审核、退回补充、已通过、已关闭及商品/SKU。每条显示申请号、单一来源 SKU、拟供量、供货价、交付时间、材料完整度、审核状态和下一动作；支持从商品/SKU 选择器批量选择后分别创建草稿，不允许一张申请承载多个 SKU。
流程
选择商品/SKU → 填写供货 → 上传材料 → 预览 → 提交审核
字段
- 商品和单一 SKU，只允许选择本商户。
- 拟供数量、供货价和最晚交付时间。
- 产地、供应批次、报告和证书。
- 入库方式和联系人。
- 运费、质量和售后责任方建议及说明。
校验
- 商品必须已通过平台商品审核。
- SKU 必须有效且未删除。
- 数量和供货价大于 0。
- 必需材料完整。
- 提交后锁定关键字段；驳回后复制为新版本修改。
提交申请不扣减商品当前库存；平台审核通过后才建立来源预留。页面必须明确这一点，避免商户误认为提交即已入云仓。
状态分组：
待审核 / 待送达 / 验收中 / 已验收 / 部分验收 / 已驳回 / 已关闭
列表显示拟供、审批、来源预留、送达、待检、验收、拒收/短缺、活动占用、云仓可用、退回/平台承接、有效首次购买和待结算货款。点击数量进入对应流水，不把所有数据堆在一张表中。
顶部展示状态、单一来源 SKU、供货价、审核意见和 allowed_actions。详情用数量时间线和守恒校验解释每一次预留、送达、验收、占用、释放、退回；同时显示三类责任快照、材料版本、关联活动、首次销售/退款摘要和操作审计。历史快照只读，商品资料变化只产生来源告警。
只展示责任快照确认由当前商户处理的任务。列表按待发货、已发货、退回待验、售后处理中、异常和完成筛选；详情支持提交运单、物流更正、打包/质量证据、退回验收和异常上报。用户地址按权限脱敏，所有动作依赖 allowed_actions 和版本；结算、回购、用户收益或最终异常决定不在商户端执行。
商户可见：
- 来源供货申请、活动和商品/SKU。
- 有效首次购买数量。
- 供货价、首次退款扣减和约定履约扣减。
- 入库/验收时间、首次完成时间和可结算时间。
- 待条件、可入单、已入单、已结算、冻结、冲正。
- 所属日结单、正式入账时间和 CRMEB 财务流水。
商户不可见：
- 具体用户持仓占比。
- 用户本金和收益。
- 平台二次零售利润。
列表
- 结单号、结算自然日、账本笔数、毛额、扣减、结算额和入账状态。
- 支持按日期、状态和结单号筛选；只返回当前登录商户数据。
详情
- 顶部显示结算额、入账时间和对应商户余额流水。
- 明细表展示供货申请、活动商品、有效数量、供货价、扣减和应结金额。
- 提供导出和提交对账异议，展示后续调整/冲正；正式入账后可跳原有转账/提现能力。不提供提前结算、拆单、合单或改金额。
首屏
- 当前场次和开始/结束倒计时。
- 活动商品列表。
- 抢购价、剩余库存、限购。
- 邮寄/自提/代销能力标签。
- 预计周期、结算模式短标签。
交互
- 未开始：按钮显示开抢时间。
- 进行中：按钮稳定尺寸，不因“抢购中/已抢完”变化导致布局跳动。
- 已售罄：保留商品，显示售罄。
- 已结束：可查看规则和历史，不可下单。
- 从支付成功页继续抢购时恢复原场次和滚动位置。
信息顺序：
- 商品、图片、抢购价、库存、限购和倒计时。
- 支持的邮寄、自提、代销方式。
- “先付款，后选择去向”流程。
- 预计销售周期、分成率、结算模式和固定节点。
- 到期回购比例与示例。
- 商品产地和溯源。
- 首次退款、售后和自提逾期规则。
主要操作是“立即抢购”。页面不得将预计收益显示为大于商品本身的主标题，也不得用确定口吻替代实际销售结果。
只确认
- 商品/SKU。
- 数量和限购。
- 商品价款。
- 活动规则摘要。
- 用户已阅读规则确认。
不出现
- 收货地址。
- 运费。
- 本次去向选择。
支付前再次校验活动、库存、限购和规则版本。规则版本变化时阻止支付并要求重新确认。
活动仍在进行时：
- 主按钮：
继续抢购。 - 次按钮：
立即选择去向。 - 显示最晚选择时间和“也可稍后到订单中心处理”。
活动已经结束时：
- 主按钮：
选择去向。 - 次按钮：
查看云仓订单。
支付成功页不使用强制弹窗阻塞返回活动。
支付结果必须覆盖：本地确认中、成功、失败可重试、用户取消、订单已关闭和渠道回调延迟。页面始终轮询/查询后端本地订单状态，不以 H5/小程序支付组件返回值直接认定成功；确认中保持稳定结果区并允许稍后从订单中心继续。
顶部状态标签页：
全部 / 待付款 / 待选择 / 邮寄 / 自提 / 代销 / 已完成 / 售后退款 / 已关闭 / 异常
待选择明细展示：
- 商品、数量、支付时间。
- 截止倒计时。
- 超时自动代销。
- “选择去向”按钮。
一个明细只显示一个数量，不提供数量拆分器。
列表必须区分首次订单状态和去向/履约状态：未付款、支付确认中、首次退款、补运费退款、自提逾期、持仓冻结和普通完成不能被压成同一个“售后”标签。每条只显示后端允许的下一动作，重复支付、订单关闭或去向已冻结时不再显示旧按钮。
使用三段式模式选择：
邮寄到家 | 线下自提 | 平台代销
只显示活动商品已开放的方式，代销始终存在。
- 地址。
- 运费模板计算结果。
- 包邮或待补运费金额。
- 预计发货和售后说明。
需要补运费时，点击“确认邮寄并支付运费”创建补运费单；支付成功后邮寄才最终生效。
- 网点、地址、营业时间。
- 可提货时间、自提截止时间。
- 逾期处理。
- 初始代销数量和本金。
- 批次开始和预计到期时间。
- 结算模式与节点。
- 分成率和回购比例。
- 实际有效销售认定。
确认弹层必须再次显示“整个订单明细将全部采用此方式”。确认后不可由用户自行修改。
固定信息
- 商品缩略图、规格、整条明细数量和原商品订单号。
- 醒目标注“商品价款已支付，本次只支付运费”，运费不重复计入本金。
- 收件地址、命中运费模板、计费摘要、应付运费和支付倒计时。
- 支付方式只展示当前终端与 CRMEB 配置实际可用的微信、支付宝或余额。
操作
- 更换地址后必须重新试算，旧
quote_hash失效。 - 点击支付只提交支付方式和幂等请求号，金额、用户和订单号由后端读取。
- 在线支付返回后进入本页“结果确认中”，轮询本地
pay_result；不根据 SDK 成功提示直接跳转履约。 - 未支付时可取消临时邮寄或切换支付方式；切换渠道由后端生成新运费单号。
全状态
| 状态 | 页面表现 | 可操作 |
|---|---|---|
| 待支付 | 地址、报价、方式和倒计时 | 支付、更换地址、取消 |
| 支付中/结果确认中 | 固定高度加载区，不重复拉起支付 | 返回订单中心 |
| 邮寄已确认 | 成功结果和履约摘要 | 查看履约 |
| 超时且仍在选择期 | 旧单失效说明 | 重新选择去向 |
| 超时且已自动代销 | 代销结果和持仓入口 | 查看我的云仓 |
| 迟到支付/退款处理中 | 已收款但去向不变、原路全额退款说明 | 查看退款进度、联系客服 |
| 已退款 | 退款方式、金额和完成时间 | 返回订单中心 |
| 支付冲突/退款失败 | 异常编号与客服入口 | 联系客服，不允许重复支付 |
复用 AddressSelector、addressWindow、现有支付方式弹层、金额格式化、骨架屏、空态和支付结果视觉；只新增运费单状态摘要，不复制第二套地址或支付组件。
- 商品、数量、网点、公开地址和导航。
- 可提货/截止时间。
- 核销码和刷新时间。
- 已核销状态。
- 逾期状态和联系客服。
使用凭证中的自提点 GCJ02 快照调用 uni.openLocation，不要求先获取用户当前位置。地图或导航不可用时保留地址复制和联系客服。核销码区域尺寸固定，加载失败不挤压其他内容。
顶部只显示用户能理解的汇总：
- 代销中本金。
- 已返本金。
- 待结算收益。
- 已结算收益。
- 待回购金额。
列表筛选：
待入批次 / 代销中 / 结算中 / 已完成 / 冻结
每条持仓显示商品、批次、数量、进度、模式、预计到期和下一节点。
信息顺序：
- 商品、活动、首次订单和规则快照。
- 批次有效销售进度。
- 本人持仓数量、分摊已售和剩余。
- 本金、收益、回购金额分解。
- 25/50/75/100% 节点时间线。
- 二次有效销售说明。
- 账本明细和异常状态。
批次到期不足 100% 时，进度停留在真实百分比，并单独展示剩余回购，不能把回购画成销售完成。
筛选：
全部 / 本金返还 / 代销收益 / 回购款 / 冻结与冲正
每条显示：
- 类型、金额、状态和时间。
- 活动、批次和节点。
- 可点击查看公式。
正向入账与冲正使用明确符号和文字，不能只靠红绿颜色。
依次展示账本类型与状态、正负金额、来源首次订单/持仓/批次、结算节点、规则和公式快照、计算数量、本金/收益/回购拆分、入账目标、CRMEB 余额流水状态、冻结/失败/冲正原因和操作时间线。页面只读；失败状态提供“刷新结果/联系客服”，不提供用户自行重算或重复入账按钮。
首屏展示真实农场和当前可参与套餐，不制作营销落地页式的大面积空白 Hero。
分区：
- 可租土地。
- 可认养。
- 农场与生产动态。
- 最近发布的溯源内容。
每个农场条目显示真实场景图、名称、公开区域、可参与项目和位置入口；不根据用户当前位置自动请求定位权限。
信息顺序：
- 农场名称、真实场景图、公开地址和状态。
- 农场介绍、生产方式、报告/证书和公开溯源。
- 区域与地块示意，不展示敏感内部精确点位。
- 当前可租套餐、可认养套餐和生产动态。
- 位置卡片、复制地址和导航。
复用轮播、富文本、图片加载、状态标签和商品/套餐列表基础样式；位置卡片只承担地址摘要和进入 USR-AG-003，不在详情页长期挂载大地图。
- 顶部使用现有自定义导航栏。
- 地图显示服务端保存的农场
GCJ02标记和名称。 - 下方显示公开地址、位置说明、示意图、复制地址和“开始导航”。
- “开始导航”调用
uni.openLocation，无需获取用户当前位置。 - 地图脚本失败、当前端不支持或 Key 未配置时，显示地址、示意图、复制和重试，不出现空白整页。
- 只有未来增加“距我多远/附近农场”时才在用户主动点击后调用
uni.getLocation；拒绝权限不影响其他内容。
顺序：
- 套餐、农场、区域和真实场景图片。
- 整块/面积份额、可选作物和周期。
- 固定/最低交付数量、预计采收次数。
- 包含服务和可选服务。
- 邮寄和异常处理。
- 支付后分配真实地块的说明。
不让用户在 V1 操作复杂地图选坐标。可展示区域示意和历史真实地块案例。
- 筛选农场、周期、面积/份额、作物可选性和可售状态，排序支持推荐、价格和周期。
- 条目显示真实农场图、套餐名、面积/份额、周期、最低交付承诺、价格和剩余容量。
- 复用现有商品双列/单列模板、图片懒加载、价格和骨架屏；不伪造成普通实物商品库存。
- 售罄、未开始、已结束、容量校验失败和网络错误均有独立状态。
- 选择作物。
- 选择可选服务。
- 商品/套餐价款和运费规则。
- 交付数量和周期快照。
- 确认后支付。
支付成功状态为“待分配地块”，不能立即伪造一个地块编号。
按“待付款/待分配/进行中/待收成/履约中/已完成/异常”分段筛选。每条显示农场、套餐、真实地块或待分配说明、当前阶段、预计节点、产出/履约摘要和异常标记；取消、退款、关闭和分配失败不能被归入普通空状态。
- 真实农场、区域、地块编号和面积/份额。
- 种植状态和预计采收。
- 农事时间线。
- 已采收、已履约和剩余数量。
- 分批物流。
- 农业异常和处理结果。
- 溯源入口。
明确展示分配模式：
- 单体认养：会分配唯一资产编号。
- 批次份额：会分配真实养殖批次中的份额。
同时展示周期、交付品类、数量、次数、服务、邮寄、死亡/疾病/延期处理。
筛选农场、品种、单体/批次份额、周期和可售状态。条目显示真实场景、品种、分配模式、周期、交付承诺、价格和剩余容量；复用租地列表结构但必须用模式标签区分唯一个体与批次份额。
展示套餐与分配模式、数量/份额、合同联系人、周期和交付快照、异常替换规则、费用明细和协议版本。支付前不承诺具体个体；支付成功进入待分配。容量、价格或协议版本变化时返回详情重新确认，不能静默替换。
按“待付款/待分配/养殖中/待产出/履约中/已完成/异常”筛选。单体条目显示资产编号或待分配，份额条目显示批次和份额；共同展示下一节点、产出摘要、异常和溯源入口。
单体模式显示个体编号、照片、栏舍、健康和替换历史；批次模式显示批次、份额、栏舍和群体记录。
共同展示：
- 养殖时间线。
- 产出与履约。
- 异常和通知。
- 溯源。
替换后同时保留原资产和新资产，不让历史“消失”。
- 展示本次产出来源、可履约/已分配数量、包裹拆分、地址状态、运费、物流、收货和售后。
- 长周期下单地址仅作默认联系人；发货前必须重新确认或更换地址并形成履约快照。
- 多包裹按包裹展示承运商、运单、状态和售后范围，不能只显示一个总物流号。
- 用户只可选择邮寄到家，不出现云仓代销或店铺上架。
- 覆盖待确认地址、待补运费、处理中、待发货、部分发货、运输中、已完成、退款/售后和异常冻结。
信息顺序：
- 商品/产出和溯源编号。
- 农场、区域、地块/栏舍。
- 生产批次与个体编号（如有）。
- 已审核发布的过程时间线。
- 采收/产出批次。
- 检测报告和证书。
- 关联订单或履约信息。
公开档案不展示内部成本、商户供货价、用户收益和未发布记录。
普通商品详情只增加产地、供应商公开摘要、报告/证书状态和稳定溯源入口；普通订单详情只增加业务来源、关联产出/供应批次和溯源入口。购物车、优惠、下单、支付、物流和售后仍走 CRMEB 原链路，不把云仓去向、持仓、批次收益或回购状态混入普通商品和普通订单。
| 布局 | 目标视口 | 结构 | 复用与新增 |
|---|---|---|---|
| 原客服工作台 | Desktop 1280x800 以上 |
保留现有三栏聊天 | 直接复用 kefu/pc，只增加农业桌面入口 |
| 农业桌面工作区 | Desktop 1280x800、1440x900
|
左侧窄导航、顶部人员/范围、主列表与右侧抽屉详情 | 复用 Element UI、请求、上传、SVG、格式化；新增农业字段组件 |
| 移动作业工作区 | Mobile 360x800、390x844、430x932
|
顶部任务上下文、单列内容、固定底部主导航/提交区 | 复用 Token、请求、上传、SVG；新增移动任务、扫码、证据和草稿组件 |
移动端每个主要操作区最小触控高度 44px，底部固定操作区预留安全区；表格必须转换为摘要列表，不允许横向缩放桌面表格。服务/现场端沿用当前项目蓝色 #1890ff、白底和灰色分隔，不借用用户商城红/橙主题，也不改成整套农业绿色主题。
SVC-AU-001 复用现有账号、密码、验证码和 service Token。桌面保持原登录构图，移动视口将固定宽度改为单列自适应；登录失败、验证码失效、账号关闭和网络错误均保留输入内容并给出稳定反馈。
SVC-AU-002 仅在账号同时拥有多个工作区时显示。工作区条目展示名称、职责摘要、可见对象数量、最近入口和能力状态；选择只决定前端入口，不扩大后端权限。上下文加载失败可重试或退出，不允许带着旧上下文进入业务页。
SVC-AU-003 展示账号、所属商户/平台、职责、范围摘要、scope_version、摄像头/图片扫码/本机草稿/地图能力、工作区切换和退出。它不展示完整范围对象清单，不提供自行修改权限或职责。
桌面客服页包含：
- 搜索：手机号后四位/完整手机号权限、用户 ID、租地/认养业务号、CRMEB 订单号、履约号。
- 筛选：业务类型、状态、农场、异常状态和时间。
- 列表：用户脱敏信息、业务类型、套餐/资产摘要、当前阶段、下一节点、异常标记。
- 详情抽屉：交易、分配对象、生产时间线、产出、地址/物流、异常与可执行建议。
默认只返回授权商户或平台范围。查看完整手机号需要 farm.user.pii.read 并写审计日志；客服不能改生产事实或财务结果。
客服搜索入口：
- 手机号/用户 ID。
- 首次订单号。
- 补运费单号。
- 持仓/批次/账本编号。
结果按关系图展示：
首次订单 → 去向 → 邮寄/自提/持仓 → 批次 → 账本
客服只能执行已授权异常动作，普通查询不显示其他用户持仓。
- 筛选：待处理、自提逾期、运费退款、持仓冻结、批次滞销、通知失败。
- 列表：异常编号、用户/订单脱敏摘要、当前状态、SLA、负责人和最后动作。
- 详情：事实快照、关联订单/持仓/批次、系统已执行动作、通知记录和审计时间线。
- 操作：补充备注、联系记录、提交处理建议、在具备独立权限时核销自提。
“建议改寄/继续自提/回购”等只形成建议单；最终涉及回购、金额、账本或规则的决定回到平台管理端。
移动首屏：
- 今日待办。
- 即将逾期。
- 待补充材料。
- 已上报异常。
任务类型使用图标和文字：农事、养殖、采收、验收、打包、出库、异常。
每条任务固定显示对象编号、地点、计划时间、剩余时间、任务类型和状态。支持“今天/逾期/待补充/已完成”分段筛选；无权限或已被重新分配时整条任务只读并提示刷新。
- 默认打开后置摄像头，识别地块、栏舍、资产、生产批次、产出批次、仓库位和履约单二维码。
- 扫码结果先调用解析接口，显示对象名称、编号、状态、地点和当前可执行动作，用户确认后再进入录入页。
- 摄像头拒绝、非 HTTPS、设备不支持或识别失败时，始终提供“上传二维码图片”和“手工输入编号”。
- 不允许二维码内容直接作为前端路由或 SQL ID；只提交完整原始码给后端解析、验签和范围校验。
- 重复识别同一码时保持结果区域尺寸稳定，避免连续跳转。
- 扫码或从任务进入，自动带出批次。
- 事件类型。
- 发生时间。
- 物料/用量。
- 内容。
- 图片/视频。
- 是否建议对用户公开。
支持保存草稿和提交审核；网络失败时必须保留未提交内容。
V1 冻结为“本机离线草稿，不离线提交”：字段和待上传媒体元数据保存到本机；网络恢复后重新上传媒体并以同一 request_id 提交。草稿显示保存时间、所属账号和对象版本，退出账号时不向其他账号展示。
- 来源生产批次。
- 品类、规格。
- 总数量、合格数量、损耗数量。
- 单位、生产/采收日期和保质期。
- 检测状态和入库位置。
- 现场证据。
页面实时校验：
总数量 = 合格数量 + 损耗数量 + 待检数量
按任务进入，不提供全仓库任意搜索：
- 入库验收：来源批次、应收、实收、合格、拒收、差异原因和证据。
- 分配/拣货：履约单、库位、批次、数量和先到期先出提示。
- 打包/出库：包裹数、重量、物流公司、运单号、现场照片。
- 云仓自提核销：用户脱敏信息、核销码、可提数量、截止时间和异常原因；租地/认养产出不进入此子流程。
每个动作显示提交前摘要；数量、批次或状态已变化时拒绝旧版本提交并刷新，不允许客户端覆盖库存结论。
- 类型和严重程度。
- 资产、生产批次、订单/履约影响。
- 影响数量。
- 原因、证据和建议方案。
- 是否需要立即暂停履约/销售。
严重异常提交后显示平台接收状态和事件编号，禁止重复点击生成多条事件。
- 桌面队列按“待审核/已通过/已驳回”、记录类型、农场、提交人和时间筛选。
- 详情展示原始录入、数量方程、附件、关联任务/对象、历史版本和范围提示。
- 通过前执行版本和对象状态预检；驳回必须填写结构化原因和补充要求。
- 审核人不能直接改提交内容，不能审核已被撤回、超出范围或版本落后的记录。
- 列表与详情均使用后端
allowed_actions，提交成功后刷新队列计数和历史。
- 按当前账号列出类型、对象、最后保存时间、字段完整度、媒体状态和 schema 版本。
- 支持恢复、删除、批量清理失效草稿；不支持跨设备同步或离线提交。
- 使用 IndexedDB 保存 JSON 与可持久化 Blob；浏览器无法保留媒体时标为“需重新选择”，不得伪装已上传。
- 恢复前重新查询对象范围、状态和版本；范围撤销、任务完成或 schema 不兼容时只允许导出可读摘要或删除。
- 登出后其他账号不可见；存储不足、隐私模式和数据库升级失败均提供不丢字段的明确降级提示。
| 能力 | 直接复用 | 扩展/新增 |
|---|---|---|
| 登录与 Token |
utils/auth.js、现有登录页和 request.js
|
farm/context 加载与权限失效刷新 |
| PC 表单/表格/抽屉 | Element UI | 农业对象摘要、关系时间线、范围提示 |
| 图片/文件 | 现有上传接口与鉴权头 |
FarmEvidenceUploader，压缩、重试和待上传状态 |
| 图标 |
SvgIcon、现有 Iconfont |
只补不存在的任务/扫码领域图标 |
| 移动导航 | 无可直接复用成品 |
FarmMobileHeader、FarmMobileTabbar、FarmStickyActions
|
| 扫码 | 无 |
FarmQrScanner，@zxing/browser + 图片/手工输入降级 |
| 草稿 | 无 |
FarmDraftStore，IndexedDB 按账号、对象和 schema 版本隔离 JSON/Blob |
| 状态反馈 | Element Message/Loading 的 PC 模式 | 移动 Toast、稳定加载区、离线横幅和提交结果页 |
每个 P0 页面至少设计：
| 状态 | 页面要求 |
|---|---|
| 初始加载 | 骨架或稳定加载区域，不引起布局跳动 |
| 空数据 | 说明为什么为空及下一步 |
| 筛选无结果 | 保留筛选，提供重置 |
| 网络错误 | 重试，不丢失已填写表单 |
| 权限不足 | 不显示敏感数据，提供返回 |
| 业务状态变化 | 提示数据已变化并刷新 |
| 重复提交 | 按幂等结果显示已成功，不重复创建 |
| 售后/冻结 | 禁用非法操作并说明原因 |
| 数据差异 | 展示差异来源和处理入口 |
| 场景 | 必须表达 |
|---|---|
| 云仓支付前 | 付款后再选择去向 |
| 选择代销 | 整个订单明细全部进入代销 |
| 邮寄补运费 | 商品价款已支付，本次只支付运费 |
| 超时自动代销 | 最晚选择时间和默认结果 |
| 分期结算 | 当前模式结算本金、收益的具体时间点 |
| 到期回购 | 回购基数、比例和未售数量 |
| 租地下单 | 支付后分配真实地块，不是支付前任意选坐标 |
| 批次认养 | 获得真实批次份额，不承诺虚构个体 |
| 农业异常 | 原因、影响、处理方案和预计完成时间 |
| 溯源版本 | 展示当前已审核发布版本 |
文案语气保持事实性，不使用“稳赚”“固定回报”“一定售完”等表达。
本节与 30-v1-p0-page-matrix.md 共用唯一 Flow 编号，不再维护另一套简写编号。Figma 中对应画板位于 07 Prototype Flows，名称固定为 FLOW-{Flow 编号}。
| Flow | 主路径 | 成功终点 | 必须可见的异常/返回 |
|---|---|---|---|
PF-CW-01 云仓活动供货 |
商户单 SKU 供货申请 → 平台审核预留 → 到货验收 → 活动配置/发布 | 已验收数量进入活动库存 | 库存不足、拒收、短缺、材料过期；返回供货详情补充或关闭 |
PF-CW-02 用户抢购与支付 |
集市云仓 → 商品详情 → 抢购确认 → 支付 → 支付结果 | 继续抢购或进入待选择订单 | 库存竞争、确认中、失败、取消、关闭；返回详情或订单中心 |
PF-CW-03 三种去向 |
待选择订单 → 邮寄/自提/代销 | 一个订单明细冻结一种去向 | 版本冲突、退款中、截止自动代销；返回当前真实订单状态 |
PF-CW-04 补运费 |
邮寄选择 → 地址/运费报价 → 独立运费支付 → 支付查询 | 邮寄去向生效并生成履约 | 报价变化、取消、超时、迟到成功退款；返回待选择或自动代销 |
PF-CW-05 自提 |
选择网点 → 凭证 → 服务/平台核销 | 首次订单完成 | 码失效、逾期、地图失败；进入协同后继续、改寄或回购建议 |
PF-CW-06 代销与三结算模式 |
持仓入批次 → 真实二次销售 → 进度节点 → 用户账本 | 按活动 SKU 固定模式结清 | 批次暂停、二次退款、节点入账失败；返回持仓/账本真实状态 |
PF-CW-07 到期滞销回购 |
未售数量预览 → 审核执行 → 库存转入 → 回购入账 | 用户取得回购本金/收益，批次关闭 | 库存或资金部分失败；停在可重试步骤，不伪造售完 |
PF-CW-08 商户货款 |
首次购买完成并过售后期 → 资格链 → 日结 → 商户账单 | 货款进入 CRMEB 商户余额 | 首次退款、异议、结单失败/调整；返回账本或结单详情 |
PF-LA-01 租地 |
套餐详情 → 下单支付 → 平台分配真实地块 → 生产时间线 | 采收并进入产出履约 | 容量变化、支付确认中、并发占用、无候选；返回详情/订单/异常 |
PF-AD-01 认养 |
套餐详情 → 下单支付 → 分配唯一个体或真实批次份额 | 进入养殖和产出时间线 | 容量变化、无健康资产、份额并发、替换；返回订单/异常 |
PF-PD-01 生产记录 |
现场任务/扫码 → 录入证据 → 提交审核 | 审核通过后进入公开候选时间线 | 离线草稿、上传失败、版本/范围变化、驳回；返回草稿或任务 |
PF-PD-02 产出与履约 |
采收入库 → 数量审核 → 用户确认地址 → 分包发货 | 产出分批履约完成 | 数量方程失败、部分验收、地址/运费/物流/售后异常 |
PF-EX-01 异常闭环 |
现场上报 → SLA 列表 → 方案审批 → 分步执行 | 事实、审批、执行、通知和审计闭合 | 方案失效、部分执行、权限变化；返回详情重新预检 |
PF-TR-01 溯源发布 |
生产/产出/材料 → 编辑预览 → 审核 → 发布 | 稳定二维码访问审核版本 | 材料过期、敏感信息、撤回；返回编辑/材料/关联页 |
PF-AU-01 服务身份与范围 |
登录 → 选择工作区 → 权限范围读取 → 作业入口 | 进入有权限页面 | 上下文失败、职责/范围撤销、Token 失效；返回入口刷新或登录 |
落图结果：108 个低保真、108 个高保真和上述 15 个 Flow 均已完成；15 个 Flow 使用 60 个同页高保真副本承载真实前进、返回和起点。重名、错尺寸、画板重叠、占位文案、缺失字体和流程跳转问题均为 0。该结果属于 Codex 自主预审，不替代项目方研发启动会的人工签字。
- Figma 账号和团队项目由项目方持有。
- AI 工具通过 Figma 官方授权连接，不在项目文档、源码、Skill、环境变量或任务描述中保存账号密码。
- 当前正式文件：SmartFarm V1 - CRMEB Baseline & Product Design。
- 已建立
01 Current CRMEB References、02 Components & Tokens和08 Handoff & Assets；参考页明确标记为结构化运行态/源码/数据库事实，不冒充浏览器原始截图。 - 产品负责人拥有编辑和版本冻结权限。
- 研发、测试、运营使用查看/评论权限。
- 每次评审创建命名版本，不覆盖已冻结基线。
- 页面使用本文件编号命名。
- 组件、变量、图标和图片集中管理。
- 原型连线只表达真实可执行动作，不做无法实现的演示跳转。
- 每个关键流程单独建立 Prototype Flow 起点。
- 评审意见在 Figma 评论中记录，最终决策写回
12，不能只留在评论。
以下勾选项表示文档、低保真、高保真和 Prototype 自主预审通过；人工业务签字统一留到研发启动会。
- 每个 P0 页面有正常状态，并通过页面状态矩阵和共享状态组件覆盖空、加载、错误和无权限语义。
- 每个按钮都能说明前置状态和操作结果。
- 云仓付款不要求先选去向。
- 云仓订单明细没有数量拆分。
- 补运费超时、自提逾期和首次退款有页面结果。
- 批次进度只显示真实有效销售。
- 三种结算模式都能通过页面解释。
- 到期不足 100% 时显示回购而非伪造售完。
- 商户页面没有用户收益隐私数据。
- 租地/认养显示真实资产分配模式。
- 农业异常保留原资产和原记录。
- 溯源只展示审核发布内容并保留版本。
- 从详情返回列表时按页面契约保留筛选和滚动位置。
- 移动端最长文案、编号和金额的低保真直接文本检查不溢出。
- 每个用户端页面已经标记复用的现有页面、组件、API 和平台条件。
- 低保真没有重复设计商品、秒杀、订单、支付、地址、物流和售后基础组件；开发任务仍须保留源码复用证据。
- 代表页面已与 CRMEB 结构化视觉基线比较，布局、密度、组件和交互没有明显割裂。
- Figma 文件、状态账本和评审记录不包含任何登录密码、邮箱验证码或访问令牌。
- 首页
- 项目总览
- 项目立项
- 端与角色
- 供应链经营闭环
- 模块地图
- V1 范围 PRD
- 任务拆解
- 结算与账本
- V1 结算口径
- 云仓秒杀
- CRMEB 底座能力映射
- 当前菜单页面审计
- V1 决策与术语
- 云仓流程与状态机
- 租地认养与溯源 PRD
- V1 数据模型草案
- 开发前设计计划
- V1 信息架构
- 页面与原型规格
- V1 API 契约草案
- 事件任务权限通知
- 五项目代码改造蓝图
- 测试验收发布与手册计划
- CRMEB 视觉基线审计
- G3/G4 决策登记表
- 用户端 uni-app 复用审计
- 开发前主清单
- 自主设计工作指引
- V1 需求追踪矩阵
- G3 技术专项验证报告
- V1 P0 页面矩阵
- 写操作契约注册表
- 事件任务操作注册表
- 状态异常事务矩阵
- 数据库字段字典
- 页面 API 文件追踪
- V1 ER 图
- API 字段契约注册表
- 平台管理员手册
- 商户手册
- 用户帮助
- 服务与现场手册
- 开发任务包
- 测试目录与 Fixtures
- 发布与运维手册
- 设计交付与研发交接