Skip to content

18 v1 page and prototype spec

技术老胡 edited this page Jul 29, 2026 · 2 revisions

V1 页面与低保真原型规格

本文档是 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,不使用卡片嵌套卡片。
  • 页面分区使用标题、分隔线、标签页和全宽区域,不用大量浮动卡片。
  • 图标按钮优先使用项目现有图标库或 Lucide 对应图标,并提供 Tooltip。
  • 金额不使用渐变和夸张大字;关键金额使用清晰层级和正负方向。
  • 状态颜色不能成为唯一信息载体,必须同时显示文字。
  • 所有长编号、商品名、地块名和异常原因都要验证换行、截断与展开。

CRMEB 视觉基线审计

开始 Figma 页面设计前必须先完成只读审计,并把截图、尺寸和组件结论放到 Figma 的 02 Components & Tokens 页面。未完成审计,不进入高保真设计。

范围 必查内容 主要来源
平台管理端 布局、侧栏、顶栏、面包屑、标签页、列表密度、筛选栏、表单、抽屉/弹窗、详情页、状态标签、分页、空状态 smartfarm_admin/src/layoutsrc/stylessrc/componentssrc/router/modules、主题相关 store/settings
商户端 与平台端的共同模式及商户端特有商品、营销、财务页面 smartfarm_mer/src/layoutsrc/stylessrc/componentssrc/viewssrc/router/modules
用户端 首页装修、底部导航、商品列表/详情、普通秒杀、购物车、订单确认、支付、订单详情、用户中心 smartfarm_user/pages.jsonApp.vueuni.scsspagescomponents、主题和装修相关工具
服务端 客服工作台布局、表格、会话、订单上下文和固定路由 smartfarm_service/src/viewssrc/layoutsrc/routersrc/styles
后端菜单 当前真实菜单层级、页面路径、按钮权限和图标 eb_system_menu 与对应路由文件
主题与站点配置 主色、Logo、站点名、上传资源、布局/主题开关 eb_system_configeb_system_config_value 及前端运行配置
用户端装修 实际首页组件、底部导航、分类和主题配置 eb_diyeb_system_groupeb_system_group_data 及装修 API

审计产出至少包含:

  1. 四端关键页面截图和页面地址。
  2. 字体、字号、行高、主色、功能色、边框、圆角、阴影和间距样本。
  3. 按钮、输入框、选择器、表格、分页、弹窗、抽屉、标签页和状态标签样本。
  4. 列表页、编辑页、详情页和异常页的现有版式。
  5. 可直接复用、需要轻度扩展、必须新增三类组件清单。
  6. 数据库配置与前端默认值不一致时,以当前运行态页面为准并记录来源。

禁止事项:

  • 不为了“更现代”整体更换后台布局、主色、字体、图标体系或组件密度。
  • 不把智慧农业页面做成独立的另一套品牌后台。
  • 不用大面积营销型 Hero、装饰渐变、超大圆角卡片或与现有 CRMEB 不一致的仪表盘风格。
  • 不在未核对运行态装修数据前,仅凭源码静态默认值重画用户首页。
  • 不把 Figma 社区模板直接套入项目后再要求现有页面适配模板。

三、通用页面组件

组件 使用场景 必须支持
StatusTag 订单、批次、账本、审核、履约状态 统一文案、颜色、Tooltip
BusinessNoLink 订单号、批次号、账本号 点击进入详情、复制图标
FilterBar 桌面列表 常用筛选、更多筛选、重置、保存视图
DataTable 桌面列表 固定操作列、排序、分页、空状态
SummaryStrip 详情页顶部 状态、关键数量、金额、时间和主操作
Timeline 生产、履约、状态历史 类型、时间、人员、图片和公开状态
BatchProgress 云仓批次/持仓 当前百分比、已售/总量、节点和更新时间
InventoryPools 云仓批次 各库存池数量和恒等式校验
MoneyBreakdown 账本与结算 本金、收益、回购、扣减、合计和公式
RuleSnapshot 云仓/套餐历史订单 历史规则只读展示
AuditHistory 审核和异常 操作人、前后状态、原因和时间
EvidenceViewer 农业异常、验收、售后 图片、视频、报告和下载
TraceLink 商品、订单、产出 查看稳定溯源档案
EmptyState 无数据 明确原因与可执行下一步
PermissionState 无权限 不暴露数据,给出返回入口

四、页面规格模板

每个 Figma 页面和后续 PRD 页面条目必须包含:

页面编号
使用角色
页面目标
入口与返回路径
前置业务状态
页面字段
主要操作
次要操作
校验与错误提示
加载/空/错误/无权限状态
成功后的状态迁移
审计与埋点要求
关联决策编号

五、平台端关键页面

ADM-CW-001 云仓活动列表

页面目标

让运营快速判断活动当前阶段、库存、待选择、代销和结算是否正常。

筛选

  • 活动编号/名称。
  • 未开始、进行中、选择期、代销中、已结束、已关闭。
  • 活动开始/结束时间。
  • 商品来源。
  • 是否存在库存、结算或异常。

表格字段

字段 说明
活动编号/名称 可复制编号,点击详情
活动时间 预热、开始、结束
活动商品数 SPU 和 SKU 批次数
活动库存/已付款 汇总数量
待选择 已付款待选择明细数
代销持仓 已冻结代销数量
有效销售进度 批次加权汇总,只用于概览
待结算/待回购 金额或数量
异常 质量、库存、售后或账务异常数
状态 活动状态

操作

  • 新建活动。
  • 编辑草稿。
  • 复制活动,复制后必须重新选择库存和发布时间。
  • 预览用户端。
  • 关闭未开始活动。
  • 查看数据详情。

进行中活动不允许直接修改已付款用户的价格、结算模式、分成和回购规则。

ADM-CW-002 云仓活动编辑

页面使用步骤导航:

基础信息 → 活动商品 → 发布预检

基础信息

  • 活动名称。
  • 预热、开始、结束时间。
  • 支付超时。
  • 默认去向选择期限。
  • 活动封面和分享信息。
  • 用户端规则摘要。

交互

  • 保存草稿不要求所有字段完整。
  • 下一步前校验当前步骤。
  • 修改结束时间时同步提示选择截止和批次开始时间变化。
  • 已有付款后只允许修改展示材料和不影响历史规则的内容。

发布预检

按错误、警告、通过分组:

  • 错误必须修复:无活动商品、库存未验收、分成不等于 100%、回购比例非法、时间冲突、缺少代销。
  • 警告可确认:库存较少、周期较长、未配置邮寄/自提。
  • 通过项:用户端预览、供货审核、规则快照、消息模板。

ADM-CW-003 云仓活动商品编辑

顶部对象

  • 来源类型。
  • 商户/平台。
  • 商品、SKU。
  • 入库/验收可用数量。
  • 关联溯源。

配置区

分区 字段
抢购 抢购价、活动库存、每人限购
去向 代销固定开启;邮寄、自提开关
邮寄 运费模板、包邮、可配送范围
自提 网点、可提货时间、自提期限
代销 预计销售周期、用户/平台分成率
结算 三种模式单选、固定节点只读展示
回购 100%、90%、80%、自定义比例
售后 首次和二次观察期固定选项
商户货款 供货价、验收信息、结算方式只读/确认

右侧规则预览

实时展示用户将看到的:

  • 支付后再选去向。
  • 最晚选择时间和超时自动代销。
  • 周期、分成、结算模式和节点。
  • 回购计算示例。
  • 平台券和运营成本承担。

校验

  • 活动库存不得超过验收可用数量。
  • 抢购价、供货价和二次最低销售边界显示对比。
  • 用户分成率 + 平台分成率必须为 100%。
  • 自定义回购比例必须大于 0 且不超过 100%。
  • 开启邮寄必须选运费模板或包邮。
  • 开启自提必须配置至少一个网点和期限。

ADM-CW-004 云仓活动数据详情

顶部指标:

  • 活动预占、已付款、首次退款、未抢完退回。
  • 邮寄、自提、代销数量。
  • 待选择明细和最晚处理时间。
  • 二次有效销售、回购和待结算。

标签页:

活动商品 / 首次订单 / 待选择 / 批次 / 商户货款 / 用户账本 / 操作日志

指标点击后跳到已带筛选的对应列表,不在详情中重复塞入完整业务表格。

ADM-CW-005 商户供货审核

列表

  • 申请编号、商户、商品/SKU。
  • 供货价、申请数量、验收数量。
  • 计划交付时间。
  • 商品/材料审核状态。
  • 入库/验收状态。
  • 关联活动数。

审核详情

  • 商品基础资料和现有商城状态。
  • 产地、生产/供应批次、报告和证书。
  • 供货价、数量、售后和履约说明。
  • 历史供货表现。
  • 审核通过、驳回、要求补充材料。

审核通过不等于可发布活动;完成实际入库/验收后才形成活动可用数量。

ADM-CW-007 待选择订单

筛选

  • 活动、商品/SKU、用户、订单号。
  • 距截止时间。
  • 待选择、临时邮寄待补运费。
  • 是否已提醒。

字段

  • 用户、订单、商品、数量和支付时间。
  • 当前状态。
  • 选择截止倒计时。
  • 临时补运费单状态。
  • 最近提醒时间。

操作

  • 重新发送提醒。
  • 查看订单规则快照。
  • 查看补运费单。
  • 发起异常处理。

运营不能代用户随意选择去向。系统自动代销由截止任务执行,人工补偿执行必须有审批和操作原因。

ADM-CW-009 云仓批次详情

顶部摘要

  • 批次编号、活动、商品/SKU、来源商户。
  • 状态、开始时间、到期时间。
  • 冻结代销数量、有效售出、剩余、锁定、售后冻结、回购。
  • 当前进度、已达节点、结算模式。
  • 累计确认收入、已售本金、可分配利润。

标签页

  1. 库存池:数量恒等式、库存流水。
  2. 二次零售:订单明细、分配数量、有效时间、退款。
  3. 用户持仓:持仓数量、占比、已返本金、收益、回购。
  4. 进度快照:每次触发、累计数据和节点。
  5. 账本:本金、收益、回购、冻结和冲正。
  6. 异常与操作日志。

操作

  • 暂停二次分配。
  • 恢复。
  • 查看差异。
  • 到期核算。
  • 进入回购。

不能提供“手工修改已售数量”输入框。纠错只能从二次订单、退款、库存流水或受控异常调整产生。

ADM-CW-011 到期回购

列表字段

  • 回购单号、批次、用户/持仓。
  • 未售数量、单位本金、回购比例。
  • 回购金额、库存转入状态、账本状态。
  • 异常/冻结。

详情

  • 批次到期依据。
  • 最终有效售出与未售数量。
  • 用户持仓分配过程。
  • 回购计算公式。
  • 平台库存接收记录。
  • 用户回购账本和资金入账。

操作顺序

核对数量 → 审核回购金额 → 转平台库存 → 生成/确认账本 → 完成

任何一步失败都显示当前成功步骤和可重试动作,禁止用户账本成功但库存转入无记录。

ADM-FN-002 用户云仓账本

筛选

  • 用户、活动、批次、持仓和首次订单。
  • 本金、收益、回购、冻结、冲正。
  • 节点、状态、结算时间。

表格

  • 账本编号。
  • 用户。
  • 类型。
  • 活动/批次。
  • 节点。
  • 本金、收益、回购、调整和合计。
  • 状态、结算单和资金流水。

详情

  • 输入数据快照。
  • 公式和累计差额。
  • 历史已结算/正在结算。
  • 来源二次订单或回购单。
  • 冻结/冲正链。

ADM-FN-004 云仓对账

页面按批次或日期查看五组数:

首次订单
活动/云仓库存
二次零售
业务账本
资金入账

差异类型:

  • 数量不闭合。
  • 金额不闭合。
  • 状态延迟。
  • 重复账本。
  • 缺少资金流水。
  • 退款未冲正。

提供“查看差异来源”,不提供直接改余额或改汇总数量的快捷按钮。

ADM-LA-003 租地套餐编辑

字段分区

  • 基础:名称、农场、区域、图片、介绍。
  • 分配:整块/面积份额、面积、可选作物。
  • 周期:预计开始、周期、预计采收次数。
  • 交付:固定数量/最低数量、单位、分批规则。
  • 服务:包含服务、可选服务和费用。
  • 邮寄:运费、配送范围、包装。
  • 异常:减产、绝收、延期和退款处理。
  • 展示:用户端说明和规则预览。

发布前必须验证真实地块容量和预计可售套餐数量,页面显示“可发布容量”,但不能以估算代替下单时事务校验。

ADM-LA-006 地块分配工作台

左侧订单队列:

  • 已付款待分配。
  • 套餐、作物、面积、计划周期。
  • 最晚分配时间。

右侧可用资产:

  • 农场/区域/地块。
  • 可用面积。
  • 同期占用。
  • 土壤/用途和作物适配。
  • 冲突原因。

确认区:

  • 分配地块、占用面积、起止时间。
  • 分配后剩余容量。
  • 自动生成生产批次开关。

确认前再次校验容量。冲突时不清空用户已选条件,刷新可用资产后继续处理。

ADM-AD-003 认养套餐编辑

先选择分配模式:

  • 单体:关联可用个体资产和排他规则。
  • 批次份额:关联品种、栏舍和份额容量。

其余字段:

  • 品种、周期、交付品类。
  • 固定/最低交付数量和次数。
  • 服务、邮寄和异常规则。
  • 个体死亡/疾病替换规则。
  • 用户端展示预览。

套餐发布后存在订单时,不允许切换单体/批次份额模式。

ADM-PD-002 生产批次详情

顶部:

  • 批次、类型、农场、地块/栏舍、作物/品种、负责人、状态。
  • 计划与实际周期。
  • 预计/实际产出。

标签页:

时间线 / 关联租地认养订单 / 采收产出 / 异常 / 溯源

平台运营可审核记录,现场人员只能编辑未提交或被驳回的本人草稿。

ADM-PD-007 农业异常列表与详情

列表优先展示:

  • 严重程度。
  • 异常类型。
  • 影响资产、批次、订单和数量。
  • 已通知用户数。
  • 处理方案和状态。

详情处理步骤:

确认事实 → 确认影响范围 → 选择补足/替换/延期/补发/退款 → 审批 → 通知 → 执行 → 关闭

关闭前必须填写实际结果。替换资产时同时展示原资产和新资产,不覆盖原记录。

ADM-TR-002 溯源档案编辑/预览

编辑区:

  • 来源生产批次和产出批次。
  • 已发布过程记录。
  • 报告、证书、产地和负责人。
  • 关联商品/SKU、云仓批次、订单和履约。

预览区:

  • 按用户端真实顺序展示。
  • 标识草稿/当前版本。
  • 生成稳定二维码预览。

已发布版本编辑时必须填写修改原因,并创建新版本。

六、商户端关键页面

MER-CW-002 云仓供货申请编辑

流程

选择商品/SKU → 填写供货 → 上传材料 → 预览 → 提交审核

字段

  • 商品和 SKU,只允许选择本商户。
  • 可供货数量、供货价和最晚交付时间。
  • 产地、供应批次、报告和证书。
  • 入库方式和联系人。
  • 邮寄/自提/质量售后责任说明。

校验

  • 商品必须已通过平台商品审核。
  • SKU 必须有效且未删除。
  • 数量和供货价大于 0。
  • 必需材料完整。
  • 提交后锁定关键字段;驳回后复制为新版本修改。

MER-CW-003 云仓供货记录

状态分组:

待审核 / 待送达 / 验收中 / 已验收 / 部分验收 / 已驳回 / 已关闭

列表显示申请量、验收量、活动预占量、有效首次购买量和待结算货款。点击数量进入对应流水,不把所有数据堆在一张表中。

MER-FN-001 云仓供货货款

商户可见:

  • 来源供货申请、活动和商品/SKU。
  • 有效首次购买数量。
  • 供货价、首次退款扣减和约定履约扣减。
  • 入库/验收时间、首次完成时间和可结算时间。
  • 待结算、结算中、已结算、冻结、冲正。

商户不可见:

  • 具体用户持仓占比。
  • 用户本金和收益。
  • 平台二次零售利润。

七、用户端云仓页面

USR-CW-001 集市云仓

首屏

  • 当前场次和开始/结束倒计时。
  • 活动商品列表。
  • 抢购价、剩余库存、限购。
  • 邮寄/自提/代销能力标签。
  • 预计周期、结算模式短标签。

交互

  • 未开始:按钮显示开抢时间。
  • 进行中:按钮稳定尺寸,不因“抢购中/已抢完”变化导致布局跳动。
  • 已售罄:保留商品,显示售罄。
  • 已结束:可查看规则和历史,不可下单。
  • 从支付成功页继续抢购时恢复原场次和滚动位置。

USR-CW-002 云仓商品详情

信息顺序:

  1. 商品、图片、抢购价、库存、限购和倒计时。
  2. 支持的邮寄、自提、代销方式。
  3. “先付款,后选择去向”流程。
  4. 预计销售周期、分成率、结算模式和固定节点。
  5. 到期回购比例与示例。
  6. 商品产地和溯源。
  7. 首次退款、售后和自提逾期规则。

主要操作是“立即抢购”。页面不得将预计收益显示为大于商品本身的主标题,也不得用确定口吻替代实际销售结果。

USR-CW-003 云仓抢购确认

只确认

  • 商品/SKU。
  • 数量和限购。
  • 商品价款。
  • 活动规则摘要。
  • 用户已阅读规则确认。

不出现

  • 收货地址。
  • 运费。
  • 本次去向选择。

支付前再次校验活动、库存、限购和规则版本。规则版本变化时阻止支付并要求重新确认。

USR-CW-004 云仓支付成功

活动仍在进行时:

  • 主按钮:继续抢购
  • 次按钮:立即选择去向
  • 显示最晚选择时间和“也可稍后到订单中心处理”。

活动已经结束时:

  • 主按钮:选择去向
  • 次按钮:查看云仓订单

支付成功页不使用强制弹窗阻塞返回活动。

USR-CW-005 云仓订单中心

顶部状态标签页:

待选择 / 邮寄 / 自提 / 代销 / 已完成 / 售后

待选择明细展示:

  • 商品、数量、支付时间。
  • 截止倒计时。
  • 超时自动代销。
  • “选择去向”按钮。

一个明细只显示一个数量,不提供数量拆分器。

USR-CW-006 云仓去向选择

使用三段式模式选择:

邮寄到家 | 线下自提 | 平台代销

只显示活动商品已开放的方式,代销始终存在。

邮寄

  • 地址。
  • 运费模板计算结果。
  • 包邮或待补运费金额。
  • 预计发货和售后说明。

需要补运费时,点击“确认邮寄并支付运费”创建补运费单;支付成功后邮寄才最终生效。

自提

  • 网点、地址、营业时间。
  • 可提货时间、自提截止时间。
  • 逾期处理。

平台代销

  • 初始代销数量和本金。
  • 批次开始和预计到期时间。
  • 结算模式与节点。
  • 分成率和回购比例。
  • 实际有效销售认定。

确认弹层必须再次显示“整个订单明细将全部采用此方式”。确认后不可由用户自行修改。

USR-CW-007 邮寄补运费

  • 展示商品价款已支付,不重复计入。
  • 展示运费计算明细、地址和支付倒计时。
  • 支付成功进入邮寄待履约。
  • 支付超时仍在选择期,返回待选择。
  • 支付超时且已过选择期,展示已自动转代销,不允许继续支付过期单。

USR-CW-008 自提凭证

  • 商品、数量、网点、导航。
  • 可提货/截止时间。
  • 核销码和刷新时间。
  • 已核销状态。
  • 逾期状态和联系客服。

核销码区域尺寸固定,加载失败不挤压其他内容。

USR-CW-009 我的云仓

顶部只显示用户能理解的汇总:

  • 代销中本金。
  • 已返本金。
  • 待结算收益。
  • 已结算收益。
  • 待回购金额。

列表筛选:

待入批次 / 代销中 / 结算中 / 已完成 / 冻结

每条持仓显示商品、批次、数量、进度、模式、预计到期和下一节点。

USR-CW-010 云仓持仓详情

信息顺序:

  1. 商品、活动、首次订单和规则快照。
  2. 批次有效销售进度。
  3. 本人持仓数量、分摊已售和剩余。
  4. 本金、收益、回购金额分解。
  5. 25/50/75/100% 节点时间线。
  6. 二次有效销售说明。
  7. 账本明细和异常状态。

批次到期不足 100% 时,进度停留在真实百分比,并单独展示剩余回购,不能把回购画成销售完成。

USR-CW-011 云仓账本

筛选:

全部 / 本金返还 / 代销收益 / 回购款 / 冻结与冲正

每条显示:

  • 类型、金额、状态和时间。
  • 活动、批次和节点。
  • 可点击查看公式。

正向入账与冲正使用明确符号和文字,不能只靠红绿颜色。

八、用户端租地、认养与溯源页面

USR-AG-001 农场专区

首屏展示真实农场和当前可参与套餐,不制作营销落地页式的大面积空白 Hero。

分区:

  • 可租土地。
  • 可认养。
  • 农场与生产动态。
  • 最近发布的溯源内容。

USR-LA-002 租地详情

顺序:

  1. 套餐、农场、区域和真实场景图片。
  2. 整块/面积份额、可选作物和周期。
  3. 固定/最低交付数量、预计采收次数。
  4. 包含服务和可选服务。
  5. 邮寄和异常处理。
  6. 支付后分配真实地块的说明。

不让用户在 V1 操作复杂地图选坐标。可展示区域示意和历史真实地块案例。

USR-LA-003 租地下单确认

  • 选择作物。
  • 选择可选服务。
  • 商品/套餐价款和运费规则。
  • 交付数量和周期快照。
  • 确认后支付。

支付成功状态为“待分配地块”,不能立即伪造一个地块编号。

USR-LA-005 我的土地详情

  • 真实农场、区域、地块编号和面积/份额。
  • 种植状态和预计采收。
  • 农事时间线。
  • 已采收、已履约和剩余数量。
  • 分批物流。
  • 农业异常和处理结果。
  • 溯源入口。

USR-AD-002 认养详情

明确展示分配模式:

  • 单体认养:会分配唯一资产编号。
  • 批次份额:会分配真实养殖批次中的份额。

同时展示周期、交付品类、数量、次数、服务、邮寄、死亡/疾病/延期处理。

USR-AD-005 我的认养详情

单体模式显示个体编号、照片、栏舍、健康和替换历史;批次模式显示批次、份额、栏舍和群体记录。

共同展示:

  • 养殖时间线。
  • 产出与履约。
  • 异常和通知。
  • 溯源。

替换后同时保留原资产和新资产,不让历史“消失”。

USR-TR-001 溯源档案

信息顺序:

  1. 商品/产出和溯源编号。
  2. 农场、区域、地块/栏舍。
  3. 生产批次与个体编号(如有)。
  4. 已审核发布的过程时间线。
  5. 采收/产出批次。
  6. 检测报告和证书。
  7. 关联订单或履约信息。

公开档案不展示内部成本、商户供货价、用户收益和未发布记录。

九、服务/现场端页面

SVC-CW-001 云仓订单查询

客服搜索入口:

  • 手机号/用户 ID。
  • 首次订单号。
  • 补运费单号。
  • 持仓/批次/账本编号。

结果按关系图展示:

首次订单 → 去向 → 邮寄/自提/持仓 → 批次 → 账本

客服只能执行已授权异常动作,普通查询不显示其他用户持仓。

SVC-PD-001 我的农业任务

移动首屏:

  • 今日待办。
  • 即将逾期。
  • 待补充材料。
  • 已上报异常。

任务类型使用图标和文字:农事、养殖、采收、验收、打包、出库、异常。

SVC-PD-003 新增过程记录

  • 扫码或从任务进入,自动带出批次。
  • 事件类型。
  • 发生时间。
  • 物料/用量。
  • 内容。
  • 图片/视频。
  • 是否建议对用户公开。

支持保存草稿和提交审核。离线能力是否实现放到技术评审,原型先定义网络失败后保留未提交内容。

SVC-PD-004 采收/产出录入

  • 来源生产批次。
  • 品类、规格。
  • 总数量、合格数量、损耗数量。
  • 单位、生产/采收日期和保质期。
  • 检测状态和入库位置。
  • 现场证据。

页面实时校验:

总数量 = 合格数量 + 损耗数量 + 待检数量

SVC-PD-006 异常上报

  • 类型和严重程度。
  • 资产、生产批次、订单/履约影响。
  • 影响数量。
  • 原因、证据和建议方案。
  • 是否需要立即暂停履约/销售。

严重异常提交后显示平台接收状态和事件编号,禁止重复点击生成多条事件。

十、全局状态要求

每个 P0 页面至少设计:

状态 页面要求
初始加载 骨架或稳定加载区域,不引起布局跳动
空数据 说明为什么为空及下一步
筛选无结果 保留筛选,提供重置
网络错误 重试,不丢失已填写表单
权限不足 不显示敏感数据,提供返回
业务状态变化 提示数据已变化并刷新
重复提交 按幂等结果显示已成功,不重复创建
售后/冻结 禁用非法操作并说明原因
数据差异 展示差异来源和处理入口

十一、关键确认文案

场景 必须表达
云仓支付前 付款后再选择去向
选择代销 整个订单明细全部进入代销
邮寄补运费 商品价款已支付,本次只支付运费
超时自动代销 最晚选择时间和默认结果
分期结算 当前模式结算本金、收益的具体时间点
到期回购 回购基数、比例和未售数量
租地下单 支付后分配真实地块,不是支付前任意选坐标
批次认养 获得真实批次份额,不承诺虚构个体
农业异常 原因、影响、处理方案和预计完成时间
溯源版本 展示当前已审核发布版本

文案语气保持事实性,不使用“稳赚”“固定回报”“一定售完”等表达。

十二、低保真原型流程

PF-CW-01 用户云仓抢购

集市云仓
→ 商品详情
→ 抢购确认
→ 支付
→ 支付成功
→ 继续抢购
→ 云仓订单中心待选择

验收:付款过程不要求地址和去向,继续抢购返回原场次。

PF-CW-02 三种去向

待选择
├─ 邮寄 → 地址/运费 → 补运费 → 待履约
├─ 自提 → 网点/期限 → 核销凭证
└─ 代销 → 规则确认 → 待入批次 → 我的云仓

验收:一个明细没有数量拆分,所有分支均能返回订单中心。

PF-CW-03 云仓经营与结算

平台活动配置
→ 发布预检
→ 活动结束/选择窗口
→ 批次启动
→ 二次零售有效
→ 达到节点
→ 用户账本
→ 到期回购/批次关闭

验收:进度、节点、回购和账本能逐步解释。

PF-MER-01 商户供货

商品/SKU
→ 供货申请
→ 平台审核
→ 送达/入库验收
→ 关联活动
→ 有效首次购买
→ 商户货款

验收:商户不需要等待二次零售售完。

PF-LA-01 用户租地

农场专区
→ 租地详情
→ 选择作物/服务
→ 支付
→ 待分配
→ 真实地块
→ 农事时间线
→ 采收
→ 分批邮寄

PF-AD-01 用户认养

认养详情
→ 确认单体/批次份额模式
→ 支付
→ 资产/份额分配
→ 养殖时间线
→ 产出
→ 分批邮寄

PF-AG-01 农业异常

现场上报
→ 平台确认影响
→ 方案审批
→ 用户通知
→ 补足/替换/延期/补发/退款
→ 结果关闭

PF-TR-01 溯源发布

生产/产出记录
→ 溯源草稿
→ 审核
→ 发布版本
→ 商品/订单/履约访问
→ 修改生成新版本

十三、Figma 交付规范

  • Figma 账号和团队项目由项目方持有。
  • AI 工具通过 Figma 官方授权连接,不在项目文档、源码、Skill、环境变量或任务描述中保存账号密码。
  • 新建正式设计文件前先完成 CRMEB 视觉基线审计,并建立 Current CRMEB References 页面保存只读参考截图。
  • 产品负责人拥有编辑和版本冻结权限。
  • 研发、测试、运营使用查看/评论权限。
  • 每次评审创建命名版本,不覆盖已冻结基线。
  • 页面使用本文件编号命名。
  • 组件、变量、图标和图片集中管理。
  • 原型连线只表达真实可执行动作,不做无法实现的演示跳转。
  • 每个关键流程单独建立 Prototype Flow 起点。
  • 评审意见在 Figma 评论中记录,最终决策写回 12,不能只留在评论。

十四、原型评审检查表

  • 每个 P0 页面有正常、空、加载、错误和无权限状态。
  • 每个按钮都能说明前置状态和操作结果。
  • 云仓付款不要求先选去向。
  • 云仓订单明细没有数量拆分。
  • 补运费超时、自提逾期和首次退款有页面结果。
  • 批次进度只显示真实有效销售。
  • 三种结算模式都能通过页面解释。
  • 到期不足 100% 时显示回购而非伪造售完。
  • 商户页面没有用户收益隐私数据。
  • 租地/认养显示真实资产分配模式。
  • 农业异常保留原资产和原记录。
  • 溯源只展示审核发布内容并保留版本。
  • 从详情返回列表时保留筛选和滚动位置。
  • 移动端最长文案、编号和金额不溢出。
  • 新页面与 CRMEB 当前同类页面并排比较后,布局、密度、组件和交互没有明显割裂。
  • Figma 文件和评审记录不包含任何登录密码、邮箱验证码或访问令牌。

十五、关联文档

Clone this wiki locally