农业超市小程序 · 产品方案

项目背景与目标Background & Goals

项目方在黑龙江地区经营农资线下门店，主营农药、种子、叶面肥，客户以周边乡镇农户为主。现状痛点：

获客半径受限：只覆盖门店周边，旺季（春耕 / 秋管）人手不足、闲季客流断崖；
缺少锁客手段：农户比价流动性强，没有预存 / 会员机制把年度采购留在自己店里；
农技服务无法变现：店主日常免费解答病虫害问题，专业能力没有转化为线上流量与订单；
限制类农药合规压力：《农药管理条例》要求限制使用农药实名购买、记录可追溯，手工台账费时且有漏记风险。

产品目标（按优先级）

G1 锁客会员充值折扣体系

充值送余额 + 等级折扣（95 / 9 / 85 折）+ 每月代金券，将散客转化为预存会员，做高复购与年度客单。本项目核心卖点。

G2 转化农技流量 → 购药订单

AI 拍照识病、专家问答、病虫图鉴作为免费工具引流，识别结果直接联动「对症的药」，形成工具 → 商品闭环。

G3 裂变一级分销拉新

发展村级「团长」，专属推广码 + 分享海报，一级分佣（比例后台可配），用熟人网络低成本扩大覆盖半径。

G4 合规实名购药电子台账

限制类农药下单前强制实名核验，购买记录加密留存备查，替代手工台账。

范围说明：直播带货模块经与项目方确认不在本期范围，后续如需可作为二期独立启动，本文档不再描述。

用户与角色Users & Roles

角色	端	画像 / 职责	核心诉求
普通农户	小程序	45–65 岁为主，种植玉米 / 水稻 / 大豆，智能机操作能力弱，常在田间户外使用	买到对症的药、价格实惠、字大看得清、送货到村
种植大户 / 合作社	小程序	耕种数百至数千亩，批量采购，价格敏感 + 专业敏感	批量价（会员折扣）、三证真伪、开票、货站发大件
团长（分销员）	小程序	村内活跃农户 / 小卖部店主，经后台审核开通	推广码好分享、佣金看得懂、提现顺畅
农技专家	后台（受限角色）	店主本人 / 合作农艺师	集中回复提问、答案可关联商品
运营 / 客服	后台	商品上架、订单发货、活动配置、客服答疑	批量操作高效、订单信息完整、佣金对账清楚
超级管理员	后台	项目方负责人	经营数据一屏总览、权限可控、资金操作留痕

设计约束（源自用户画像，约束全部 C 端页面）：正文 ≥14px、标题 17px、按钮触区 ≥44pt（遵循微信小程序设计指南）；高对比配色抗田间强光；图标线性具象「望而知意」；文案口语化（「怎么送货 / 钱怎么算 / 货在路上」）；弱网下所有加载给进度反馈。详见风格甄选页调研摘要。

业务总览与范围Scope

核心业务闭环

引流AI 识病 / 问答 / 分销码

→

选购分类 / 搜索 / 推荐

→

合规校验限制药需实名

→

支付微信 + 余额

→

履约快递 / 货站 / 自提

→

沉淀充值入会 / 当团长

模块清单（本期范围）

端	模块	优先级	原型	验收要点
C 端小程序	工程基建	P0 必须	—	微信授权 + 手机号绑定可用；uni-app 工程可编译多端
	实名认证 · 合规	P0 必须	S13	未实名拦截限制药下单；信息加密存储
	首页	P0 必须	S1	Banner / 金刚区 / 秒杀位 / 推荐 / 资讯 / 搜索全部后台可配
	商品商城	P0 必须	S2 S3	三证信息完整展示；SKU 切换正确
	购物车 · 结算 · 支付	P0 必须	S4 S5	优惠计算顺序正确（§7.2）；微信 / 余额混合支付
	订单管理	P0 必须	S6	状态机完整（§7.1）；物流单号展示
	个人中心	P0 必须	S12	订单角标准确；实名 / 会员状态正确
	AI 病虫害识别	P0 必须	S7	识别 → 建议 → 推荐商品闭环；失败兜底转专家
	会员中心 / 农技服务	P1 建议	S8 S9 S10	充值到账 + 赠送准确；问答审核后可见
	秒杀促销专区	P2 增强	S11	倒计时准确；库存防超卖（§7.4）
B 端后台	后台基建（RBAC / 日志）	P0 必须	W1	角色权限隔离；资金操作 100% 留痕
	商品 / 订单管理	P0 必须		SKU 库存准确；发货 / 退款流程可走通
	分销体系（一级）	P0 必须		归属识别准确；佣金冻结 / 解冻 / 提现全链路
	用户 / 会员 / 内容 / 设置	P1 建议		等级折扣可配；代金券每月定发
	数据统计	P2 增强		看板数据与订单表可对账

信息架构IA · 5 Tab

C 端五 Tab：首页 / 分类 / 农技 / 购物车 / 我的。二级页隐藏底栏（遵循微信小程序导航规范，二级页左上角返回）；AI 识病在首页金刚区与农技 Tab 双入口露出。

Tab	一级页面	二级页面
首页	首页 S1	搜索结果页 · 秒杀专区 S11 · 资讯详情 · 效果展示列表
分类	分类列表 S2	商品详情 S3 · 评价列表 · 分享海报生成
农技	农技服务三 Tab S8	AI 识别 S7 · 识别历史 · 提问发布 · 问答详情 · 视频播放 · 图鉴详情 S9
购物车	购物车 S4	订单结算 S5 · 地址选择 / 编辑 · 代金券选择
我的	个人中心 S12	订单列表 / 详情 S6 · 物流详情 · 实名认证 S13 · 会员中心 S10 · 充值 · 余额明细 · 团长中心 S14 · 提现 · 收藏 / 足迹 · 地址管理 · 消息中心 · 客服 / 设置 / 协议

页面总数：一级 5 + 二级约 24，共约 29 个页面。原型覆盖 14 个关键屏，其余为同构板式（列表 / 表单 / 详情），开发按既有组件延展。

C 端功能明细Feature Spec · 小程序

5.1登录与实名合规 P0 必须原型 S13

微信授权登录

首次进入静默 wx.login 换取 openid 创建影子账户；浏览无需登录，下单 / 收藏 / 提问前触发授权弹层；
手机号绑定：使用微信「手机号快速验证组件」，拒绝授权时降级为短信验证码；
同一手机号多微信登录合并规则：以手机号为主键，后绑定的 openid 追加到账户。

实名认证（三步流程）

步骤 1 上传证件：身份证人像面 + 国徽面拍照上传，OCR 自动填充姓名 / 身份证号，允许手工修正；
步骤 2 确认信息：提交第三方核验接口（姓名 + 身份证号二要素）；核验失败给出具体原因（姓名不符 / 号码错误）并允许重试，连续 5 次失败锁定 24h；
步骤 3 完成：核验通过打实名标识，回跳来源页（通常是被拦截的下单页）。

合规硬规则（开发必读）：① 商品打 is_restricted 标记（限制使用农药名录内），该类商品「提交订单」时校验实名状态，未实名弹出引导弹窗跳转 S13，拦截发生在结算而非浏览；② 实名信息（姓名 / 身份证号 / 证件照）落库前 AES-256 加密，密钥独立管理；后台仅超管角色可见脱敏后信息（王** / 2301**…6614）；③ 限制类农药每笔订单生成不可篡改的购买记录（购买人实名 + 商品 + 数量 + 时间），保留期 ≥2 年，后台可按人 / 按品导出，供监管备查（依据《农药管理条例》第二十七条经营台账要求）。

5.2首页 P0 必须原型 S1

区块	规则	后台可配
轮播 Banner	3–5 帧自动轮播 4s；跳转支持：商品 / 分类 / 资讯 / 秒杀专区 / 外链（小程序内 webview）	图片、跳转、排序、起止时间
金刚区（8 宫格）	买农药 / 买种子 / 叶面肥 / 拍照识病 / 效果展示 / 会员中心 / 线下门店 / 问专家；线性具象图标	图标、名称、跳转、排序、显隐
秒杀位	展示进行中场次前 3 商品 + 倒计时；无进行中场次时整块隐藏	随秒杀活动配置联动
爆款推荐	双列卡片；排序 = 近 30 天销量，可后台手工置顶；卡片含实拍图 / 功效标签 / 价格 / 会员价	置顶商品、显示数量
农技资讯位	2 条：预警类（红标）优先，其余按发布时间；点击进资讯详情	文章管理 + 预警标记
全局搜索	联合检索商品名 / 病虫害名 / 作物名；病虫害命中时结果页顶部插入图鉴卡（导流农技）；保留搜索历史 10 条	热门搜索词

5.3商品与商城 P0 必须原型 S2 S3

分类与列表

两级分类：一级（农药 / 种子 / 叶面肥 / 植调剂 / 其他）左侧导航，二级胶囊横排（如农药 → 除草剂 / 杀虫剂 / 杀菌剂 / 拌种剂）；
排序：综合（默认，权重 = 销量×0.5 + 好评×0.3 + 新品×0.2）/ 销量 / 价格升降 / 好评；
筛选：适用作物、价格区间、是否会员专属、是否限制类；
列表卡片必含：实拍图、品名 + 规格、适用作物 + 防治对象（农户决策关键）、价格 / 会员价、销量。

商品详情（信息优先级从上到下）

轮播图（5 张内：产品图 + 适用作物实拍 + 效果对比）；
价格区：现价 / 划线价 / 当前用户会员价（按用户等级实时计算显示）；
标题 + 一句话功效；销量 / 好评率 / 收藏；
三证信息卡：农药登记证号 / 生产许可证号 / 产品标准号 + 「平台已核验」标识（种子类展示品种审定编号）；
「怎么用 · 用多少」：有效成分 / 适用作物 / 防治对象 / 每亩用量兑水量 / 注意事项（警示条）；
用户评价（支持晒图，默认展示 1 条 + 查看全部）；相关推荐 6 个。

多规格 SKU：规格弹层选择（如 200ml / 500ml / 1L×20 整件），价格库存随 SKU 切换；
收藏：登录后可收藏 / 取消，个人中心列表管理；
分享：微信好友卡片分享 + Canvas 生成分享海报（商品图 + 价格 + 小程序码；若用户为团长则嵌入其推广参数）。

5.4购物车 · 结算 · 支付 P0 必须原型 S4 S5

购物车

按一级分类分组展示；单选 / 组选 / 全选；数量步进（上限 = 可用库存）；左滑删除 / 移入收藏；
实时合计：含会员折扣后的应付金额 + 「已优惠 X 元」；凑单提示条：距最近一档代金券门槛差额提示；
失效商品（下架 / 无库存）沉底灰置，可一键清空；购物车数据服务端存储，跨设备同步。

订单结算

收货地址：省市区三级联动（本期仅开放黑龙江省，其他省份选择时提示「暂未开通」）；
配送方式三选一：快递配送（按运费模板计费）/ 货站配送（大件整件，免运费，后台可配开关）/ 门店自提（展示门店地址营业时间）；
代金券：自动匹配可用最优券，可手动换选或不用；
余额抵扣：开关式，开启后余额优先抵扣，不足部分微信支付（混合支付）；
订单备注（选填）；金额明细逐行展示：商品金额 / 运费 / 代金券 / 会员折扣 / 实付。

支付

微信支付（JSAPI）；支付超时 15 分钟自动关单释放库存；
余额支付需设置 6 位支付密码（首次使用引导设置），单笔纯余额支付 ≥¥500 时需短信验证；
支付回调幂等处理；掉单补偿：轮询 + 微信支付通知双保险。

5.5订单与售后 P0 必须原型 S6

订单列表五 Tab：全部 / 待付款 / 待发货 / 待收货 / 已完成；状态文案口语化（等发货 / 货在路上）；
订单详情：状态条 + 地址 + 商品清单 + 金额明细 + 物流信息（快递公司 + 运单号，或货站发货票照片）+ 订单号 / 时间（可复制）；
物流仅展示单号与发货凭证，不含实时物流轨迹追踪；
用户操作：待付款可取消 / 继续支付；待发货可申请退款（原路退回）；待收货可确认收货（发货后 10 天自动确认）；已完成可评价（文字 + 晒图 1–6 张）/ 再买一单；
售后规则：发货后不支持退换货（农资特殊品类，详情页与结算页均有告知）；仅未发货可退，退款原路退回（微信原路 / 余额回充），代金券退回可用，佣金联动回滚（§7.3）。

5.6会员体系 P1 · 核心卖点原型 S10

等级	获得条件	折扣	其他权益
银卡	注册即得	95 折	每月代金券
金卡	累计消费 ≥¥10,000（后台可配）	9 折	+ 专属客服、生日礼包（纪念品）
钻石	累计消费 ≥¥30,000（后台可配）	85 折	+ 田间寻诊优先、旅游名额（仅宣传位展示）

折扣范围：默认全场生效，后台可按分类 / 单品排除（如秒杀商品不再叠加）；
充值：预设档位（¥1,000 送 ¥50 / ¥5,000 送 ¥500，后台可配）+ 自定义金额（≥¥100）；微信支付；赠送金额与本金同池使用、退款时赠送部分不可提取；
余额明细：充值 / 赠送 / 消费 / 退款回充 / 后台调整五种流水类型，每笔关联订单号或操作人；
代金券：满 ¥1,000 减 ¥100，每月 1 日 0 点定时任务批量发放给全部会员，当月末 23:59:59 过期；下单自动匹配；单笔订单限用 1 张，可与会员折扣叠加（顺序见 §7.2）；
会员专属商品：专区展示原价 / 会员价对比，非会员可浏览不可购买（引导入会）。

升降级规则

升级：支付成功后实时重算累计消费（退款订单金额剔除），达标即升，立刻生效并推送订阅消息；
不降级：等级只升不降（简化认知，符合「充值锁客」目标）；后台可手动调整等级（须填原因、留痕）。

5.7农技服务 P1 建议原型 S8 S9

问专家（农技问答）

提问：文字（≤500 字）+ 图片（≤6 张）+ 作物标签；提交后进入后台审核队列（防广告），审核通过公开可见；
回复：专家角色在后台回复，回复可关联商品（在答案下方渲染商品卡）；用户收到订阅消息通知；
列表：按作物筛选；「我的提问」查看自己的记录与回复状态；有用数（点赞）排序加权。

看视频（视频教程）

分类：按作物 / 按农事环节（整地 / 播种 / 除草 / 病虫防治 / 收储）；
播放：全屏、倍速（1 / 1.25 / 1.5 / 2）、记忆播放进度；视频下方关联商品卡跳转购买；
视频文件走 OSS + CDN，上传时转码 720p。

病虫图鉴

按作物一级筛选；每条目结构固定：病害实拍图 + 类型标签 + 「长啥样 / 啥时候来 / 咋防治」三段 + 推荐用药标签（直达商品）；
「当前高发」标记后台可配，高发条目置顶并同步到首页预警位；条目底部导流 AI 拍照识别。

5.8AI 病虫害识别 P0 必须原型 S7

拍照 / 相册压缩至 ≤1MB

→

上传 OSS进度条反馈

→

服务端调用通义千问 Qwen-VL

→

结构化结果病名 / 置信度 / 建议

→

商品映射病害 → 对症商品

→

结果页可转专家提问

调用链路：小程序不直连大模型；服务端封装 prompt（要求返回 JSON：病虫害名称 / 类型 / 置信度 / 症状描述 / 分步防治建议），做格式校验与重试（1 次）；
商品联动：后台维护「病虫害 → 推荐商品」映射表（图鉴条目关联商品），识别结果按病名匹配展示 2–4 个在售商品；无映射时展示同作物杀菌 / 杀虫热销兜底；
置信度策略：≥80% 正常展示；60–80% 展示但提示「建议再拍一张或问专家」；<60% 不给病名结论，直接引导转专家提问（自动携带该图片）；
兜底：接口超时（>15s）/ 失败给重试与转专家双出口，绝不白屏；
成本控制：单用户每日免费识别次数后台可配（默认 10 次）；识别历史保留可回看；
免责：结果页底部固定文案「AI 建议仅供参考，用药请遵说明书或咨询专家」。

5.9分销（团长） P0 必须原型 S14

开通：个人中心申请（需已实名），填写所在村屯；后台审核通过后生成专属推广码（如 NZ-8842）与带参小程序码；
绑定关系：新用户通过团长码 / 海报 / 分享卡片首次进入即绑定（首绑优先，永久有效，后台可解绑）；自购不计佣；
佣金计算：仅一级关系；佣金 = 订单实付商品金额（剔除运费）× 佣金比例；比例后台全局配置 + 可按分类覆盖；
团长中心：资金三态口语化展示（一共赚到 / 能取出 / 在路上）；今日订单、本月业绩、带来的人数；赚钱明细每笔关联买家与订单号；
推广工具：推广码展示、Canvas 生成推广海报（含团长昵称 + 小程序码）、分享给微信好友；
提现：余额 ≥¥50 可申请，后台审核后通过微信商家转账到零钱打款；记录打款流水；单日限额后台可配。

5.10营销与个人中心 P0 必须 / P2 增强原型 S11 S12

秒杀促销专区（P2）

按日三场次（10:00 / 14:00 / 20:00，后台可配）；场次内商品秒杀价 + 限量库存 + 已抢进度条；
倒计时以服务器时间为准；抢购下单走独立校验（§7.4 防超卖）；秒杀商品不叠加会员折扣（价格互斥取低）；
满减营销位：展示当前满减活动（与代金券机制复用）。

个人中心（P0）

头部：头像 / 昵称 / 手机号 + 实名标识 + 会员等级徽章；
订单四宫格（待付款 / 待发货 / 待收货 / 待评价）带数量角标；
会员卡横条（等级 + 余额 + 去充值）、团长入口横条（累计佣金 + 进入）；
列表项：收藏 / 足迹 / 地址管理 / 消息中心（订单 · 活动 · 系统三类）/ 客服（微信客服会话）/ 意见反馈 / 协议与关于 / 清缓存。

B 端管理后台功能明细Web · 运营侧

Web 端（PC），左侧八模块导航，框架见原型 W1。所有资金相关操作（改价 / 退款 / 调余额 / 佣金 / 提现）强制二次确认 + 操作日志。

P0 必须后台基建

管理员登录：账号密码 + 图形验证码；失败 5 次锁定 15 分钟

角色权限（RBAC）：预置超管 / 运营 / 客服 / 专家，可自定义角色勾选菜单与操作权限

操作日志：记录操作人 / IP / 时间 / 前后值，保留 ≥1 年

支付配置：微信支付参数配置

P0 必须商品管理

分类管理：多级分类增删改、排序、图标、启停；删除需先迁移商品

商品管理：CRUD、上下架、批量操作、搜索筛选

多规格 SKU：规格名 / 价格 / 会员价基准 / 库存 / 库存预警值

专业参数：三证 / 成分 / 作物 / 防治对象 / 用量 / 注意事项；is_restricted 限制类标记（限制类必填三证）

评价管理：查看 / 回复 / 置顶 / 删除；库存低于预警值进待办

P0 必须订单管理

列表 / 详情：多条件筛选（状态 / 时间 / 配送方式 / 用户 / 商品），含支付 / 优惠 / 物流 / 操作日志

订单操作：改价（仅待付款）、发货（快递单号或货站发货票）、取消 / 关闭、备注、退款原路退回

数据导出：按条件导出 Excel，上限 1 万行 / 次

联动：发货触发订阅消息；退款自动回滚代金券与佣金

P0 必须分销管理

团长审核：申请审核、专属推广码与带参小程序码生成

佣金配置：比例全局配置 + 分类覆盖；修改仅对新订单生效

佣金明细：冻结 / 可用 / 已提现三态；订单归属查询、手动解绑

提现管理：审核 + 微信商家转账打款 + 打款记录；驳回需填原因并通知

分销看板：推广业绩、拉新、佣金 Top

P1 建议用户管理

列表 / 详情：基本信息 / 账户 / 订单 / 地址 / 实名状态（脱敏展示）

用户操作：调整等级 / 余额（必填原因、生成流水并短信通知）、禁用（不可下单可查旧订单）、站内消息

用户标签：自定义标签（种植大户 / 高价值等），按标签筛选精准营销

P1 建议会员体系管理

等级配置：名称 / 图标 / 升级门槛 / 折扣比例 / 折扣范围；修改次日 0 点生效

充值档位：金额 / 赠送 / 启停排序

代金券管理：面额 / 门槛 / 有效期、每月定时批量发放（失败自动重试 + 告警）、核销统计

资金记录：充值记录全量查询导出；余额明细五类流水查询

P1 建议内容管理

Banner 管理：增删改、跳转、排序、时段

农技问答：审核（默认审核后公开）、回复、分类

视频教程：上传转码、上下架、关联商品

病虫图鉴：条目维护，含「病害 → 推荐商品」映射（AI 推荐数据源）与高发标记

资讯文章：富文本发布、上下架 / 置顶

田间问诊：问诊次数配置及管理

P1 建议系统设置

配送设置：开放区域 / 运费模板 / 快递公司 / 货站开关

支付设置：余额支付开关、退款规则

消息通知：订阅消息模板配置

基础设置：名称 / Logo / 客服 / 协议 / 关于

P2 增强数据统计

经营概览：今日订单 / 销售额 / 新增用户 / 充值 + 7 日趋势 + 待办事项

商品统计：销量排行、分类占比

订单统计：量额趋势、支付方式占比

用户会员统计：增长、会员转化、复购率、余额使用率；口径以支付成功为准、退款剔除，T+0 小时级更新

关键业务规则Business Rules · 验收必测

7.1订单状态机

待付款 → 待发货 → 待收货 → 已完成
├ 待付款 —（用户取消 / 15 分钟超时）→ 已取消（库存回滚、券回退）
├ 待发货 —（用户申请退款 / 后台退款）→ 已退款（原路退回、券回退、佣金回滚）
├ 待收货 —（用户确认 / 发货后 10 天自动）→ 已完成；发货后不可退换
└ 已完成 —（评价）→ 终态；评价窗口 30 天

7.2优惠计算顺序（结算金额公式）

固定顺序，前后端与后台报表必须一致：
① 商品小计 = Σ(SKU 现价 × 数量)（秒杀商品用秒杀价，且该商品跳过步骤②）
② 会员折扣 = 商品小计 × (1 − 等级折扣率)，仅作用于参与折扣范围的商品
③ 代金券：满足门槛（按②折后金额判断）后整单减免，单笔限 1 张
④ 运费：按配送方式与运费模板计算，加在③之后
⑤ 余额抵扣：优先扣余额，不足部分微信支付
实付 = 商品小计 − 会员折扣 − 代金券 + 运费 − 余额抵扣；分摊：券与折扣按商品金额比例分摊到行，用于部分退款与佣金基数计算。

7.3佣金结算规则

触发：归属订单支付成功时计算佣金，状态冻结中（C 端显示「在路上 / 确认收货后到账」）；
解冻：订单已完成 + 7 天（无退款争议期）后自动转可提现；
回滚：解冻前订单退款 → 佣金取消；解冻后发生后台特殊退款 → 从团长可提现余额扣减（可为负，下笔佣金抵扣）；
基数：订单实付商品金额（分摊后，剔除运费与代金券平台承担部分）；
提现：≥¥50 申请 → 后台审核 → 微信商家转账到零钱 → 打款记录；个税合规提示：年累计提现较大的团长建议走灵活用工平台代发（实施期与项目方确认）。

7.4库存与防超卖

普通商品：下单锁库存（Redis 预扣 + DB 事务），支付超时 / 取消回滚；
秒杀商品：独立秒杀库存，Redis 原子扣减 + 消息队列异步落单；抢完即示「已抢光」，不出现负库存；
库存预警：低于预警值进入后台待办 + 每日汇总通知。

数据模型概要Core Entities

建库以此为骨架，字段级设计开发期补充 ER 图评审。

实体	关键字段	关系 / 说明
`user`	id, openid[], phone, nickname, avatar, level, balance, total_spent, is_verified, referrer_id, status, tags[]	referrer_id → 分销绑定；实名信息独立表加密存储
`user_identity`	user_id, real_name(enc), id_no(enc), id_card_imgs(enc), verified_at, provider_txn	与 user 1:1；AES-256；仅超管脱敏可见
`product / sku`	product：分类, 标题, 图集, 三证四字段, 成分, 作物[], 防治对象[], 用量说明, is_restricted, is_member_only, status；sku：规格, 价格, 划线价, 库存, 预警值	product 1:N sku；三证在限制类必填
`order / order_item`	order：单号, user_id, 状态, 配送方式, 地址快照, 金额五件套（小计/折扣/券/运费/实付）, 支付方式, referrer_id 快照, 物流字段；item：sku 快照, 数量, 行分摊金额	金额与归属均落快照，规则变更不影响历史单
`balance_log`	user_id, 类型（充值/赠送/消费/退款/调整）, 金额, 关联单号/操作人, 余额快照	只增不改；对账依据
`coupon / user_coupon`	模板（面额/门槛/有效期规则）；用户券（状态：未用/已用/过期, 使用订单）	每月定时任务批量写 user_coupon
`commission`	order_id, promoter_id, 基数, 比例快照, 金额, 状态（冻结/可用/已提现/已回滚）, 解冻时间	状态流转见 §7.3
`withdrawal`	promoter_id, 金额, 状态（待审/打款中/成功/驳回）, 微信转账单号, 审核人	—
`disease`	作物, 名称, 类型, 图集, 三段文案, 推荐商品[], is_epidemic	AI 识别结果按名称匹配此表出商品
`ai_recognition`	user_id, 图片, 模型返回 JSON, 置信度, 匹配病害 id, 耗时	识别历史 + 成本统计
`qa / video / article / banner`	内容类实体，均含状态（草稿/审核/发布）与排序	—
`admin / role / op_log`	RBAC 三件套 + 操作日志（操作人/动作/前后值/IP）	资金操作强制写 op_log

技术方案与第三方集成Tech Stack

C 端uni-app（Vue3）

一码多端，首发微信小程序；状态管理 Pinia；请求层统一封装（鉴权 / 重试 / 弱网提示）。分包：主包（购物主链路）+ 农技分包 + 会员分销分包，控制首屏包体。

B 端Vue3 + Element Plus

管理台模板 + ECharts 报表；富文本用 wangEditor。

服务端单体优先

Node.js NestJS 或 Java Spring Boot（以团队栈定）；MySQL 8 + Redis；定时任务（关单 / 发券 / 解冻 / 自动收货）用分布式调度防重复执行。

基础设施阿里云

ECS（按 10 人并发起步，可弹性扩容）+ OSS（图片视频）+ CDN；HTTPS 全站；ICP 备案前置办理。

第三方	用途	集成要点
微信开放能力	登录 / 手机号 / 支付 / 订阅消息 / 客服 / 小程序码	需企业主体小程序 + 微信支付商户号；农药类目资质审核提前办；订阅消息模板：发货 / 回复 / 佣金到账 / 券到账
实名核验接口	身份证二要素核验 + OCR	阿里云 / 腾讯云市场按次计费；服务端调用，重试与失败原因透传
通义千问 Qwen-VL	病虫害图像识别	DashScope API；服务端封装 prompt 输出 JSON；限流与每日次数控制；调用日志留存做成本核算
微信商家转账	团长佣金提现打款	需商户号开通「商家转账到零钱」权限，注意开通门槛与额度

非功能性要求NFR

类别	要求
性能	并发按约 10 人同时在线设计（接口分页、Redis 缓存、静态资源 CDN）；首页首屏 ≤2s（4G）；接口 P95 ≤800ms；图片一律压缩 + 懒加载
弱网	所有提交操作有 loading 与防重复点击；上传显示进度；失败给「手把手」重试提示；关键静态内容（图鉴）本地缓存
安全	实名信息 AES-256 加密、传输 HTTPS；支付回调验签 + 幂等；余额 / 佣金变动全部走流水表可对账；后台资金操作二次确认 + 留痕；接口鉴权 token + 关键接口风控限流
合规	限制类农药实名拦截与台账（§5.1）；用户协议 / 隐私政策首启弹窗确认；AI 结果免责声明；ICP 备案
可用性	遵循微信小程序设计指南：导航明确、触区 ≥44pt、正文 ≥14px、WCAG AA 对比度；文案口语化规范表随 UI 交付；错误提示含解决动作
可运维	服务端日志集中收集；支付 / AI / 核验第三方调用失败告警（钉钉或短信）；数据库每日备份，保留 30 天

里程碑与交付物Milestones

阶段	周期	内容	交付物 / 验收
M0 设计定稿	第 1 周	风格方向确认（5 选 1）→ 全 14 屏高保真 UI + 设计规范（色板 / 字阶 / 组件）	Figma 设计稿 + 标注切图
M1 商城主链路	第 2–4 周	基建 + 登录实名 + 首页 + 商城 + 购物车结算支付 + 订单 + 后台商品 / 订单	可下单可发货的最小闭环，联调环境演示
M2 会员与农技	第 5–6 周	会员充值折扣 + 代金券 + AI 识别 + 农技三件套 + 后台会员 / 内容	充值 → 折扣下单全流程；AI 识别 → 购药闭环
M3 分销与营销	第 7 周	团长开通 / 绑定 / 佣金 / 提现 + 秒杀专区 + 数据统计	推广码下单佣金正确入账并可提现
M4 验收上线	第 8 周	全量回归（含 §7 规则用例）、性能与安全检查、资质配合、提审发布	上线 + 后台操作手册 + 源码交付

验收口径：以本文档 §5–§7 为功能验收清单，§7 业务规则须提供测试用例执行记录（优惠计算、状态机、佣金回滚、防超卖为必测项）。上线后免费质保 3 个月（Bug 修复，不含新需求）。

风险与前置事项Risks

⚠ 需项目方立即并行启动（不阻塞开发，但阻塞上线）

企业主体 + 微信支付商户号：小程序农药类目有资质审核（营业执照经营范围含农药经营 + 农药经营许可证），审核周期不可控，立即去办。
ICP 备案：免费但需 7–20 天，服务器购买后第一时间提交。
商家转账到零钱权限：佣金打款依赖，商户号满足条件后尽早申请。

风险	影响	对策
农药类目审核不通过 / 周期长	无法上架农药类商品	先以种子 / 叶面肥类目上线跑通流程；农药类目通过后开放
AI 识别准确率不达预期	农户信任受损	置信度分层策略（§5.8）+ 转专家兜底 + 免责声明；上线前用真实病叶样本集抽测
分销涉传销合规边界	监管风险	严格一级分佣、不收取入门费、不按发展人头计酬，仅按真实销售计佣
余额资金池合规	预付资金监管	余额仅限本平台消费不可提现（团长佣金除外）；充值协议明示；留存完整流水
需求变更频繁	周期漂移	以本文档为基线，变更走书面确认，评估工期影响后排期