40 v1 user help

SmartFarm V1 用户帮助中心

状态：设计态帮助文档，功能尚未开发和发布

本文依据 SmartFarm V1 已确认规则编写。页面开发、测试和发布后，才可作为正式用户帮助。正式版本应替换为真实页面截图，并隐藏本文末尾的维护者追踪信息。

一、三类使用场景

租地

用户购买租地套餐后，平台分配真实地块并提供种植、管护、采收和产出邮寄服务。用户可以查看地块、生产过程、产出、物流和溯源。

认养

用户购买认养套餐后，平台分配真实个体资产或养殖批次份额。用户可以查看养殖过程、健康记录、产出、物流和溯源。

集市云仓

用户在专属云仓活动中抢购商品。付款后可在规定时间内选择整条订单明细邮寄、自提或代销；选择代销后，可以查看真实销售进度、本金、收益和到期回购。

重要区别：

• 租地和认养产生的农产品只支持邮寄到家。
• 邮寄、自提和代销三种去向只属于集市云仓。
• 一条云仓订单明细的全部数量只能选择一种去向。需要不同去向时，应分别下单。

二、农场专区

页面：USR-AG-001~003。

用户可查看：

• 农场公开介绍、图片和服务能力。
• 可售租地和认养套餐。
• 公开地址、GCJ02 地图点位和导航。
• 公开溯源材料。

地图无法加载时仍应显示地址、示意图、复制地址和重试。查看农场不要求用户先授权当前位置；只有使用距离类增强功能时才可能申请定位。

三、如何租地

页面：USR-LA-001~003。

1. 购买前确认

• 农场和套餐名称。
• 地块面积或权益方式。
• 可选作物和代种植服务。
• 服务周期。
• 承诺产出数量和单位。
• 价格、邮寄规则和可能的运费。
• 延期容忍说明。
• 销售时间、库存和限购。
• 退款和异常说明。

2. 下单

1. 选择套餐、数量和允许的作物/服务选项。
2. 确认联系人和订单信息。
3. 提交订单并支付。
4. 支付成功后等待平台分配真实地块。

页面展示的候选信息不代表已经占用具体地块。平台确认分配后，“我的土地”才显示正式地块和占用周期。

3. 容量不足

若支付后暂时无法分配，订单进入待处理状态。平台会重新分配或按异常流程提供方案，不会用不存在的默认地块完成订单。

四、我的土地与收成

页面：USR-LA-004/005、USR-PD-001。

土地详情应显示：

• 真实农场、区域、地块和占用周期。
• 套餐和订单快照。
• 生产批次和农事时间线。
• 已审核的图片、记录和材料。
• 承诺产出、已分配产出和剩余未履约数量。
• 邮寄履约、包裹、物流和售后。
• 溯源入口。

租地产出不能选择自提、云仓代销或上架店铺。

五、如何认养

页面：USR-AD-001~003。

购买前确认：

• 认养类别、品种和农场。
• 单体认养或批次份额。
• 服务周期和承诺产出。
• 价格、邮寄、异常替换和延期说明。
• 可售数量和限购。

支付后平台分配真实个体或份额。单体分配成功后会显示稳定资产编号；批次份额会显示所属批次和份额。

六、我的认养与产出

页面：USR-AD-004/005、USR-PD-001。

用户可查看：

• 个体/批次份额。
• 养殖和健康时间线。
• 生产与产出批次。
• 异常、替换和确认记录。
• 邮寄包裹、物流和售后。
• 溯源材料。

认养产出同样只支持邮寄到家。

七、农业产出如何邮寄

页面：USR-PD-001。

每次产出发货前：

1. 查看本次可履约数量。
2. 确认当前收货地址。
3. 查看是否包邮或需补运费。
4. 确认后等待打包和发货。
5. 在详情查看分包、运单和物流。
6. 收到后确认收货，或在售后期内申请处理。

购买套餐时选择的地址主要用于联系和预留信息；每次实际发货前应重新确认，避免长期周期内地址变化。

运费规则：

• 平台按生产节奏主动分批，额外运费由平台承担。
• 包邮套餐正常分批不重复收费。
• 用户主动要求额外拆包或升级配送时，确认报价后才支付补运费。

八、农业延期、减产或资产异常

平台发现异常后会展示事实、影响和方案。

可能的方案

• 完全等价替换。
• 延期交付。
• 分批补发。
• 减量或降级。
• 未履约部分退款。

需要用户确认时，用户有 3 个自然日处理：

• 完全等价且没有超过套餐延期容忍期，超时可按原快照接受。
• 减量、降级、超容忍期或需要补款，超时默认拒绝，并转未履约退款。

生产已经开始后，退款按尚未履约的交付价值和数量计算，不把已经完成的生产服务全部退回。详情应显示承诺、已履约、历史已退、处理中和本次退款金额。

九、如何参加集市云仓

页面：USR-CW-001~003。

1. 活动商品页应显示

• 抢购价、活动库存和限购。
• 活动开始/结束时间。
• 预计代销周期。
• 支持的邮寄、自提和代销去向。
• 结算模式和用户收益分成率。
• 到期回购比例。
• 首次和二次售后说明。
• 规则版本和关键风险提示。

2. 抢购

1. 选择 SKU 和数量。
2. 确认抢购规则。
3. 创建订单并付款。
4. 付款成功后可立即选择去向，也可以继续抢购。

云仓首次抢购 V1 不使用优惠券、积分抵扣、会员价或分销佣金，以保持本金和收益规则明确。

十、付款后可以稍后选择

页面：USR-CW-004~006。

付款后页面提供：

• 立即选择去向。
• 继续抢购，返回原活动和位置。
• 进入云仓订单中心稍后选择。

订单中心显示选择截止时间。截止前可选择整条明细：

1. 邮寄。
2. 自提。
3. 代销。

提交最终选择后不能改成另一种方式。需要两种方式时，购买时就应分开下单。

超过截止时间仍未选择，系统按活动规则自动转为代销。

十一、云仓邮寄

页面：USR-CW-006/007。

操作：

1. 选择邮寄。
2. 选择地址。
3. 查看运费报价和支付截止时间。
4. 需要补运费时完成支付。
5. 查看后端最终结果。

注意：

• 运费支付截止不会晚于去向选择截止。
• 运费单超时后，订单会回到可选择状态或按规则自动代销。
• 超时后支付渠道才返回成功时，不会重新改成邮寄；系统会生成全额运费退款。
• 支付中请查看结果，不要重复创建多张运费单。

十二、云仓自提

页面：USR-CW-008。

凭证显示：

• 自提点名称、地址、地图和营业时间。
• 核销码/二维码。
• 可提数量、已提数量和剩余数量。
• 核销截止时间。
• 联系客服入口。

可按实际业务分次核销。每次核销后数量会更新并保留记录。

逾期或部分提货后的剩余数量可能进入：

• 延长保留。
• 改为邮寄并按规则处理运费。
• 退款。
• 异常回购。

最终以订单中心展示的方案为准。租地和认养产出没有自提凭证。

十三、云仓代销

页面：USR-CW-009/010。

选择代销后，商品进入对应活动 SKU 的云仓批次。页面显示：

• 初始持仓和当前有效持仓。
• 预计销售周期和到期时间。
• 真实有效销售进度。
• 结算模式。
• 预计/已确认本金、收益和回购。
• 已售/未售经济等价数量。
• 账本状态和异常说明。

“平台实际代销售出”是什么意思

云仓商品会映射为普通商城可售商品。普通用户真实下单、付款、完成订单并经过二次售后观察期后，才计入有效代销销售。

以下情况不计入最终有效销售：

• 只浏览或加购物车。
• 创建订单但未付款。
• 已付款但订单尚未完成。
• 完成后仍在售后观察期。
• 已发生有效退款。

进度不是平台手工填写，也不是活动抢购数量本身。

十四、三种结算模式

每个活动商品只能选择一种模式，并在购买前展示。

模式 A：到期统一结算

25/50/75% 只更新进度。全部有效售完或到期回购完成后，一次结算允许返还的本金、收益和回购款。

模式 B：分期结算收益，到期结算本金

跨过 25/50/75/100% 节点时结算新增收益；本金在全部售完或到期时结算。

模式 C：分期结算本金和收益

跨过节点时，按真实累计销售结果结算新增本金和收益；到期处理最后差额和回购。

一次从 20% 跳到 80% 时，只触发最高的新节点 75%，但金额按真实 80% 累计销售计算，不重复生成 25/50% 账本。

十五、到期回购

批次到期时：

1. 系统停止新的二次销售分配。
2. 等待活动配置的在途处理宽限。
3. 宽限结束后确定最终未售数量。
4. 平台计算并审核回购预案。
5. 审核通过后生成回购账本。

回购金额：

最终未售等价数量 × 云仓抢购本金单价 × 回购比例快照

“到期”不代表当秒到账。页面应分别显示宽限处理中、待审核、执行中、已完成或异常。

十六、云仓账本与余额

页面：USR-CW-011/012。

账本分为：

• 本金返还。
• 经营收益。
• 到期回购款。

状态解释：

状态	含义
预计	按当前进度展示，不是应付承诺
待结算	已形成业务金额，仍待条件
待审核/冻结	有阈值、退款、争议或差异
入账中	正在写入余额
已入账	已进入可用余额并有正式流水
调整/冲正	历史错误通过新记录修正

普通二次退款不会直接把用户余额扣成负数。系统先处理未入账或同一持仓未来应付，不足部分按平台经营风险记录；只有确认属于错误入账或外部支付最终撤销时，才可能进入受审核冲正。

十七、退款

云仓首次购买退款

正式代销批次启动前，可按规则申请整条首次明细退款。退款处理中不能同时改变去向。

邮寄补运费退款

运费迟到支付、邮寄未生效或符合取消条件时，独立退运费，不修改原商品本金订单。

二次销售退款

由普通商城买家的售后触发，影响批次有效销售、进度和后续结算。用户可在持仓和账本看到结果，不需要手工操作。

十八、溯源

页面：USR-TR-001、USR-CM-001/002。

可从商品、普通订单、土地/认养详情和产出物流进入。公开档案显示当前发布版本、过程时间线、报告证书和撤回说明。

二维码使用稳定公开入口。若档案撤回，应显示撤回状态，不展示未审核草稿或内部备注。

十九、常见不可操作原因

页面提示	可能原因	建议
活动未开始/已结束	不在活动时间	查看活动时间
库存不足/超过限购	可售量或个人额度不足	减少数量或选择其他商品
规则已变化	页面停留期间规则版本更新	刷新并重新确认
订单尚未付款	支付未确认	查看支付结果
已过选择期限	系统已自动代销或处理中	查看订单最终状态
不支持邮寄/自提	当前 SKU 未配置该方式	选择允许的去向
补运费处理中	支付结果尚未闭合	等待结果，不重复支付
批次冻结	存在库存、退款或账本异常	查看说明或联系客服
套餐容量不足	暂无地块/资产/份额	等待分配或异常方案
资源正在分配	平台正在锁定真实资产	稍后刷新
异常方案已过期	已按超时规则处理	查看新状态和退款

二十、联系客服前准备

• 订单号或云仓持仓号。
• 商品、套餐或农场名称。
• 当前页面和状态。
• 发生时间。
• 支付/退款结果摘要。
• 物流单号或自提点。
• 异常方案编号。
• 脱敏截图。

不要向客服发送密码、验证码、完整银行卡信息或支付密钥。

二十一、维护者追踪

用户流程	页面	API	重点测试
农场	USR-AG-001~003	agriculture home/farm/map	MAP-*、PAGE-MAP-001
租地	USR-LA-001~005	用户 land API	LAND-*、LAND-ALLOC-*、LAND-EX-*
认养	USR-AD-001~005	用户 adoption API	ADOPT-*、ADOPT-ALLOC-*、ADOPT-EX-*
农业邮寄	USR-PD-001	fulfillment/freight/refund	FUL-*
云仓抢购/去向	USR-CW-001~008	cloud order/disposition/freight/pickup	CW-ORDER/DISP/FREIGHT/PICKUP/REFUND-*
云仓持仓/账本	USR-CW-009~012	holding/progress/ledger	CW-SET/BUY/POST/EQTY-*
溯源	USR-TR-001	trace public API	TRACE-*

面向用户的正式版本不展示 API 和测试编号；这些信息仅用于产品、开发和验收维护。