`优鲜`系统项目需求文档

1. 项目概述

1.1 项目名称

项目名称: 优鲜系统

1.2 项目背景

背景描述

随着生活节奏加快，消费者对便捷、新鲜、安全的生鲜食材需求日益增长。为满足消费者对高品质生鲜食材的需求，打造一套集线下门店与线上销售于一体的优鲜生鲜配送系统。系统以"15分钟送达，每天都是新鲜的蔬菜"为核心理念，通过采购视频透明化、农户直采标识等特色功能，建立消费者信任，提升购物体验。系统采用每个门店服务一个或多个小区模式，实现精准覆盖和高效配送。

项目目标:
构建高效、透明、可信的生鲜电商平台，实现线上线下一体化运营，支持快速配送、商品溯源、农户直采标识等核心功能，打造差异化竞争优势。
核心特色:
- 15分钟极速送达: 基于线下门店网络，实现15分钟内将新鲜蔬菜送达客户
- 每日新鲜保证: 所有蔬菜每日新鲜上架，确保食材新鲜度
- 采购视频透明化: 每样蔬菜上架前必须上传采购视频，让消费者了解食材来源
- 农户直采标识: 从农村农户家采购的菜品有特殊标识，区别于批发菜品，突出品质优势

1.3 项目范围

1.3.1 客户端功能范围:

商品浏览:
- 商品列表浏览（按分类、搜索、排序）
- 商品详情查看（商品信息、价格、库存、图片）
- 采购视频观看（查看商品采购视频，了解食材来源）
- 农户直采标识识别（查看是否为农户直采商品）
- 商品评价查看（查看其他用户对商品的评价）
购物车管理:
- 添加商品到购物车
- 修改购物车商品数量
- 删除购物车商品
- 购物车商品结算
订单管理:
- 订单创建（选择商品、配送地址、配送时间）
- 订单支付（微信支付、支付宝、余额支付）
- 订单查询（我的订单列表、订单详情）
- 订单跟踪（实时查看订单状态、配送进度）
- 订单取消（取消未支付或待配送订单）
- 订单评价（对商品和配送服务进行评价）
用户管理:
- 用户注册登录（手机号注册、微信登录、密码登录）
- 个人信息维护（昵称、头像、性别、实名认证）
- 收货地址管理（添加、修改、删除、设置默认地址）
- 会员管理（查看会员等级、积分、权益）
- 小区关联（自动识别所在小区，切换服务小区）
支付管理:
- 订单支付（多种支付方式选择）
- 账户余额查询
- 账户充值
- 资金流水查询
评价管理:
- 商品评价（订单完成后对商品进行评价，上传评价图片）
- 配送评价（对配送服务和配送员进行评价）
- 评价查看（查看自己的评价记录）
营销功能:
- 优惠券查看（查看可用优惠券）
- 优惠券使用（下单时使用优惠券）
- 促销活动查看（查看限时折扣、满减活动）
- 会员权益查看（查看会员专享价格、积分奖励）

1.3.2 门店端功能范围:

门店信息管理:
- 门店信息查看（门店名称、地址、联系方式、营业时间）
- 门店信息修改（修改联系方式、营业时间等）
- 门店位置管理（查看门店经纬度）
门店库存管理:
- 商品库存查询（查看门店商品库存情况）
- 库存预警查看（查看库存不足提醒）
- 库存盘点（对门店商品进行库存盘点）
- 库存调整（调整商品库存数量）
- 库存统计报表（查看库存统计报表）
门店订单管理:
- 订单查看（查看分配给门店的订单列表）
- 订单详情查看（查看订单详细信息）
- 订单处理（接单、拒单）
- 订单状态更新（更新订单配送状态）
- 订单统计（按小区统计订单数量、金额）
配送管理:
- 配送订单查看（查看待配送订单）
- 配送订单分配（手动分配配送员或自动分配）
- 配送路线规划（查看配送路线，规划最优路线）
- 配送进度跟踪（跟踪配送员配送进度）
- 配送完成确认（确认订单配送完成）
- 配送时效监控（监控15分钟配送时效）
配送员管理:
- 配送员信息查看（查看配送员基本信息）
- 配送员状态管理（查看配送员工作状态：空闲、配送中、休息）
- 配送员位置跟踪（实时查看配送员位置）
- 配送员评价统计（查看配送员评价数据）
门店数据统计:
- 门店订单统计（按日、周、月统计订单量、销售额）
- 门店库存统计（库存总量、库存周转率、库存预警统计）
- 门店配送统计（配送订单数、配送时效、15分钟送达率）
- 门店小区统计（服务小区订单统计、用户统计）

1.3.3 全局管理端功能范围:

商品管理:
- 商品分类管理（添加、修改、删除商品分类，分类层级管理）
- 商品信息管理（添加、修改、删除商品，商品上架/下架）
- 商品价格管理（设置商品价格、促销价、会员价）
- 农户直采标识管理（标记商品为农户直采，关联农户信息）
- 采购视频管理（上传、审核、删除采购视频，视频存储管理）
- 商品查询统计（商品搜索、筛选、排序，商品销量统计）
门店管理:
- 门店信息管理（添加、修改、删除门店，门店列表查询）
- 门店小区关联（门店关联服务小区，小区门店分配）
- 门店配送范围管理（设置门店配送范围，配送范围统计）
- 门店数据统计（门店销售统计、库存统计、配送统计）
小区管理:
- 小区信息管理（添加、修改、删除小区，小区列表查询、搜索）
- 小区门店关联（小区关联服务门店，门店服务小区分配）
- 小区配送范围管理（设置小区配送范围，配送范围验证）
- 小区用户统计（小区注册用户数、订单量、活跃度统计）
- 小区扩展管理（新小区入驻申请、新小区门店分配）
采购管理:
- 采购计划管理（制定、审批、执行采购计划）
- 采购视频管理（上传采购视频，视频关联商品，视频审核）
- 农户信息管理（添加、修改、查询农户信息，农户合作商品管理）
- 供应商管理（添加、修改供应商信息，供应商商品管理）
订单管理:
- 订单查询（全局订单查询，按小区、门店、状态筛选）
- 订单处理（订单取消、退款处理、订单导出）
- 订单统计（按小区、门店、时间范围统计订单）
用户管理:
- 客户信息管理（客户信息查询、分页查询）
- 会员管理（会员等级设置、会员权益管理、会员积分管理）
- 用户统计（用户注册统计、活跃用户统计、会员统计、用户复购率统计）
支付管理:
- 支付处理（支付请求生成、支付回调处理、支付状态更新）
- 退款管理（退款申请、退款审核、退款处理、退款记录查询）
- 资金管理（账户余额查询、充值、提现、资金流水查询）
评价管理:
- 评价审核（审核商品评价、配送评价）
- 评价删除（删除不当评价）
- 评价筛选（按条件筛选评价）
- 评价统计（好评率、平均分统计）
营销管理:
- 优惠券管理（创建、发放、使用、查询、统计优惠券）
- 促销活动管理（创建促销活动、设置活动商品和时间、活动效果统计）
- 会员权益管理（会员专享价格、会员积分奖励、会员生日礼包、会员升级奖励）
数据统计:
- 销售统计（销售额、商品销量、分类销售、农户直采商品销售、销售趋势分析）
- 库存统计（库存总量、库存周转率、库存预警、库存成本统计）
- 配送统计（配送订单统计、配送时效统计、配送员工作量统计、配送范围覆盖统计）
- 用户统计（用户注册、活跃用户、会员、用户复购率、按小区统计用户数）
系统管理:
- 管理员管理（添加、修改、删除管理员，管理员分页查询）
- 角色权限管理（角色管理、权限分配、菜单权限配置、数据权限配置）
- 系统配置（系统参数配置、消息通知配置、支付配置、第三方服务配置）
- 操作日志（操作日志记录、操作日志查询、异常日志记录）
非功能范围: 性能、安全性、兼容性、可扩展性等

2. 用户需求

2.1 用户角色

角色	描述
客户	购买生鲜商品的终端用户
门店管理员	管理门店库存、订单、配送等日常运营
采购人员	负责商品采购、上传采购视频、农户对接
配送员	负责订单配送，确保15分钟内送达
系统管理员	系统配置、权限分配、全局管理
运营人员	商品上架、营销活动、数据分析
财务人员	资金结算、财务报表管理

2.2 用户场景

场景 1: 客户打开APP，系统自动识别客户所在小区，展示对应门店的商品，客户浏览新鲜蔬菜，查看采购视频了解食材来源，选择农户直采标识的商品，下单后15分钟内收到新鲜蔬菜。
场景 2: 采购人员前往农户家采购蔬菜，拍摄采购视频，上传到系统，标记为农户直采，商品上架销售。
场景 3: 门店管理员查看库存情况，根据销售数据制定采购计划，管理门店配送范围。
场景 4: 配送员接收配送订单，查看配送地址，规划最优路线，确保15分钟内送达客户。
场景 5: 客户查看商品详情，观看采购视频，了解是否为农户直采，查看其他用户评价后下单。
场景 6: 运营人员发布促销活动，设置优惠券，分析销售数据，优化商品结构。
场景 7: 系统管理员配置系统参数，分配角色权限，管理门店信息，查看系统运行状态。

功能描述: 客户端浏览和查看商品信息，包括商品列表、详情、采购视频、农户直采标识等。
功能需求:
- 商品列表浏览:
  - 商品分页展示（支持分页加载）
  - 按分类筛选商品（叶菜类、根茎类、瓜果类、菌菇类等）
  - 商品搜索（按商品名称、关键词搜索）
  - 商品排序（按价格、销量、上架时间排序）
  - 按农户直采标识筛选商品
- 商品详情查看:
  - 商品基本信息展示（名称、描述、价格、单位、库存）
  - 商品图片展示（多图轮播）
  - 商品库存实时显示
  - 商品价格展示（原价、促销价、会员价）
- 采购视频观看:
  - 采购视频在线播放
  - 视频播放进度控制
  - 视频全屏播放
  - 视频加载优化（支持CDN加速）
- 农户直采标识识别:
  - 农户直采商品特殊标识显示
  - 农户直采商品标签展示
  - 农户信息展示（农户名称、合作商品）
- 商品评价查看:
  - 商品评价列表展示
  - 评价详情查看（评价内容、图片、评分）
  - 评价筛选（按评分、时间筛选）
  - 评价统计展示（好评率、平均分）

3.1.2 购物车管理

功能描述: 管理客户购物车，支持商品添加、修改、删除和结算。
功能需求:
- 购物车操作:
  - 添加商品到购物车
  - 修改购物车商品数量（增加、减少）
  - 删除购物车商品
  - 清空购物车
  - 购物车商品选择（全选、单选）
- 购物车结算:
  - 购物车商品结算
  - 结算金额计算（商品总价、配送费、优惠券抵扣）
  - 结算前库存校验
  - 结算前价格校验（防止价格变动）

3.1.3 订单管理

功能描述: 客户端订单全流程管理，包括订单创建、支付、查询、跟踪、取消和评价。
功能需求:
- 订单创建:
  - 从购物车选择商品创建订单
  - 选择配送地址（自动识别所属小区）
  - 选择配送时间
  - 选择优惠券（可用优惠券列表）
  - 订单金额计算（商品价格、配送费、优惠券抵扣）
  - 订单确认提交
  - 订单门店自动分配（根据配送地址所在小区）
- 订单支付:
  - 选择支付方式（微信支付、支付宝、余额支付）
  - 发起支付请求
  - 支付状态查询
  - 支付成功确认
  - 支付失败处理
- 订单查询:
  - 我的订单列表（全部、待支付、待配送、配送中、已完成、已取消）
  - 订单详情查看（商品信息、配送信息、支付信息）
  - 订单状态实时更新
  - 订单搜索（按订单号搜索）
- 订单跟踪:
  - 订单状态实时跟踪
  - 配送进度查看（配送员位置、预计送达时间）
  - 订单状态通知（APP推送、短信通知）
- 订单取消:
  - 取消未支付订单
  - 取消待配送订单（需审核）
  - 取消原因填写
  - 取消后退款处理
- 订单评价:
  - 订单完成后评价入口
  - 商品评价（商品质量、新鲜度、价格评分，评价内容、图片上传）
  - 配送评价（配送速度、服务态度评分）
  - 配送员评价
  - 评价提交

3.1.4 用户管理

功能描述: 客户端用户信息管理，包括注册登录、个人信息、收货地址、会员管理等。
功能需求:
- 用户注册登录:
  - 手机号注册（短信验证码验证）
  - 微信登录（微信授权登录）
  - 密码登录（手机号+密码）
  - 忘记密码（手机号验证重置密码）
  - 登录状态保持
- 个人信息维护:
  - 个人信息查看（昵称、头像、性别、手机号）
  - 修改昵称
  - 上传头像
  - 修改性别
  - 实名认证（姓名、身份证号）
- 收货地址管理:
  - 添加收货地址（地址、联系人、电话）
  - 地址自动识别所属小区
  - 修改收货地址
  - 删除收货地址
  - 设置默认地址
  - 地址验证（验证地址是否在配送范围内）
  - 地址小区关联（自动关联或手动选择小区）
- 会员管理:
  - 会员信息查看（会员等级、积分、成长值）
  - 会员权益查看（会员专享价格、积分奖励、优惠券）
  - 会员积分查询（积分明细、积分获取记录）
  - 会员成长值查看
- 小区关联:
  - 自动识别所在小区（基于常用地址）
  - 用户默认小区设置
  - 用户小区切换
  - 小区服务门店查看

3.1.5 支付管理

功能描述: 客户端支付相关功能，包括订单支付、账户余额、充值等。
功能需求:
- 订单支付:
  - 支付方式选择（微信支付、支付宝、余额支付）
  - 支付请求发起
  - 支付状态查询
  - 支付成功确认
- 账户余额:
  - 账户余额查询
  - 账户充值（充值金额选择、支付方式选择）
  - 资金流水查询（收入、支出明细）
  - 余额使用记录

3.1.6 评价管理

功能描述: 客户端评价功能，包括商品评价、配送评价等。
功能需求:
- 商品评价:
  - 订单完成后评价入口
  - 商品评分（商品质量、新鲜度、价格）
  - 评价内容填写
  - 评价图片上传（多图）
  - 评价提交
- 配送评价:
  - 配送服务评分（配送速度、服务态度）
  - 配送员评分
  - 配送评价内容填写
  - 评价提交
- 评价查看:
  - 我的评价列表
  - 评价详情查看
  - 评价修改（未提交前可修改）

3.1.7 营销功能

功能描述: 客户端营销相关功能，包括优惠券、促销活动、会员权益等。
功能需求:
- 优惠券:
  - 优惠券列表查看（可用、已用、已过期）
  - 优惠券详情查看（使用条件、有效期）
  - 优惠券领取（领取活动优惠券）
  - 优惠券使用（下单时选择使用）
- 促销活动:
  - 促销活动列表查看
  - 促销活动详情查看（活动商品、活动规则）
  - 限时折扣商品查看
  - 满减活动查看
- 会员权益:
  - 会员专享价格查看
  - 会员积分奖励查看
  - 会员生日礼包查看
  - 会员升级奖励查看

3.2 门店端功能需求

3.2.1 门店信息管理

功能描述: 门店端门店信息管理，包括门店信息查看和修改。
功能需求:
- 门店信息查看:
  - 门店基本信息查看（门店名称、地址、联系方式、营业时间）
  - 门店位置查看（经纬度、地图展示）
  - 门店状态查看（营业中、休息中）
- 门店信息修改:
  - 修改联系方式（电话、联系人）
  - 修改营业时间
  - 修改门店状态（营业、休息）

3.2.2 门店库存管理

功能描述: 门店端库存管理，包括库存查询、预警、盘点、调整等。
功能需求:
- 商品库存查询:
  - 门店商品库存列表（商品名称、库存数量、单位）
  - 库存详情查看
  - 库存搜索（按商品名称搜索）
  - 库存筛选（按分类筛选）
- 库存预警:
  - 库存不足提醒（低于安全库存的商品）
  - 库存预警列表
  - 库存预警统计
- 库存盘点:
  - 库存盘点功能（录入实际库存）
  - 盘点记录保存
  - 盘点差异分析
- 库存调整:
  - 库存数量调整（增加、减少）
  - 调整原因填写
  - 调整记录保存
- 库存统计报表:
  - 库存总量统计
  - 库存分类统计
  - 库存周转率统计
  - 库存预警统计

3.2.3 门店订单管理

功能描述: 门店端订单管理，包括订单查看、处理、统计等。
功能需求:
- 订单查看:
  - 门店订单列表（待处理、配送中、已完成、已取消）
  - 订单详情查看（商品信息、客户信息、配送信息、支付信息）
  - 订单搜索（按订单号、客户姓名搜索）
  - 订单筛选（按状态、时间范围、小区筛选）
- 订单处理:
  - 订单接单（确认接单）
  - 订单拒单（拒单原因填写）
  - 订单状态更新（更新配送状态）
  - 订单备注添加
- 订单统计:
  - 按小区统计订单（订单数量、订单金额）
  - 按时间统计订单（日、周、月统计）
  - 订单状态统计
  - 订单趋势分析

3.2.4 配送管理

功能描述: 门店端配送管理，包括配送订单分配、路线规划、进度跟踪等。
功能需求:
- 配送订单查看:
  - 待配送订单列表
  - 配送中订单列表
  - 配送订单详情
- 配送订单分配:
  - 自动分配配送员（基于距离、配送员状态）
  - 手动分配配送员（选择配送员）
  - 配送订单推送（通知配送员）
  - 配送员分配记录
- 配送路线规划:
  - 配送路线查看（地图展示）
  - 配送路线规划（多订单最优路线）
  - 配送时间预估
  - 配送路线优化建议
- 配送进度跟踪:
  - 配送员位置实时跟踪
  - 配送进度查看
  - 预计送达时间显示
  - 配送异常处理
- 配送完成确认:
  - 配送完成确认
  - 配送完成时间记录
  - 配送完成通知客户
- 配送时效监控:
  - 15分钟送达计时
  - 超时预警（接近15分钟提醒）
  - 超时订单统计
  - 配送时效统计

3.2.5 配送员管理

功能描述: 门店端配送员管理，包括配送员信息、状态、位置跟踪等。
功能需求:
- 配送员信息查看:
  - 配送员列表（姓名、电话、配送区域）
  - 配送员详情查看
  - 配送员搜索
- 配送员状态管理:
  - 配送员状态查看（空闲、配送中、休息）
  - 配送员状态更新
  - 配送员工作量统计
- 配送员位置跟踪:
  - 配送员实时位置查看（地图展示）
  - 配送员位置历史记录
  - 配送员配送路线查看
- 配送员评价统计:
  - 配送员评价查看（客户评价）
  - 配送员评分统计（平均分、好评率）
  - 配送员工作量统计（配送订单数、配送时效）

3.2.6 门店数据统计

功能描述: 门店端数据统计，包括订单、库存、配送等统计。
功能需求:
- 门店订单统计:
  - 订单量统计（日、周、月）
  - 销售额统计（日、周、月）
  - 订单趋势分析
  - 订单状态分布统计
- 门店库存统计:
  - 库存总量统计
  - 库存周转率统计
  - 库存预警统计
  - 库存分类统计
- 门店配送统计:
  - 配送订单数统计
  - 配送时效统计（平均配送时间）
  - 15分钟送达率统计
  - 配送异常统计
- 门店小区统计:
  - 服务小区订单统计
  - 服务小区用户统计
  - 小区订单分布统计

3.3 全局管理端功能需求

3.3.1 商品管理

功能描述: 全局管理端商品管理，包括商品分类、商品信息、农户直采标识、采购视频等。
功能需求:
- 商品分类管理:
  - 添加商品分类（分类名称、分类图标、排序）
  - 修改商品分类
  - 删除商品分类
  - 分类层级管理（一级分类、二级分类）
  - 分类排序管理
- 商品信息管理:
  - 添加商品（名称、描述、价格、单位、图片、分类）
  - 修改商品信息
  - 删除商品
  - 商品上架/下架
  - 商品批量操作（批量上架、批量下架、批量删除）
  - 商品导入/导出
- 商品价格管理:
  - 设置商品价格（原价、促销价、会员价）
  - 价格批量调整
  - 价格历史记录
  - 价格变动通知
- 农户直采标识管理:
  - 标记商品为农户直采
  - 关联农户信息
  - 农户直采商品筛选
  - 农户直采商品特殊展示配置（标识样式、标签样式）
- 采购视频管理:
  - 上传采购视频（视频文件上传，支持多种格式）
  - 视频关联商品
  - 视频审核（审核通过后才能上架）
  - 视频删除/替换
  - 视频存储管理（视频存储位置、存储空间管理）
  - 视频播放管理（视频播放配置、CDN配置）
- 商品查询统计:
  - 商品搜索（按名称、关键词搜索）
  - 商品筛选（按分类、农户直采标识、上架状态筛选）
  - 商品排序（按价格、销量、上架时间排序）
  - 商品销量统计
  - 商品销售趋势分析

3.3.2 门店管理

功能描述: 全局管理端门店管理，包括门店信息、门店小区关联、配送范围等。
功能需求:
- 门店信息管理:
  - 添加门店（名称、地址、联系方式、营业时间、经纬度）
  - 修改门店信息
  - 删除门店
  - 门店列表查询（分页查询）
  - 门店搜索（按名称、地址搜索）
  - 门店状态管理（营业、休息、关闭）
- 门店小区关联:
  - 门店关联服务小区（一个门店可服务多个小区）
  - 小区与门店绑定关系管理
  - 门店服务小区列表查询
  - 小区门店分配（新小区分配门店）
  - 门店小区关系调整
- 门店配送范围管理:
  - 设置门店配送范围（基于关联的小区）
  - 配送范围修改（增加/移除服务小区）
  - 配送范围查询
  - 配送范围可视化（地图展示，标注服务小区）
  - 配送范围统计（服务小区数量、覆盖用户数）
- 门店数据统计:
  - 门店销售统计（销售额、订单量）
  - 门店库存统计（库存总量、库存周转率）
  - 门店配送统计（配送订单数、配送时效）
  - 门店对比分析（多门店数据对比）

3.3.3 小区管理

功能描述: 全局管理端小区管理，包括小区信息、小区门店关联、配送范围等。
功能需求:
- 小区信息管理:
  - 添加小区（小区名称、地址、经纬度、楼栋信息）
  - 修改小区信息
  - 删除小区
  - 小区列表查询（分页查询）
  - 小区搜索（按名称、地址搜索）
  - 小区状态管理（启用、停用）
- 小区门店关联:
  - 小区关联服务门店（一个小区对应一个门店）
  - 门店服务小区分配
  - 小区门店关系查询
  - 小区门店关系调整
- 小区配送范围管理:
  - 设置小区配送范围（小区内所有地址）
  - 配送范围验证（地址是否属于该小区）
  - 小区配送范围查询
  - 配送范围可视化（地图展示）
- 小区用户统计:
  - 小区注册用户数统计
  - 小区订单量统计
  - 小区活跃度统计
  - 小区用户分布分析
- 小区扩展管理:
  - 新小区入驻申请（申请信息查看、审核）
  - 新小区门店分配
  - 小区扩展计划管理
  - 小区扩展进度跟踪

3.3.4 采购管理

功能描述: 全局管理端采购管理，包括采购计划、采购视频、农户信息、供应商管理等。
功能需求:
- 采购计划管理:
  - 制定采购计划（商品、数量、供应商、预计采购时间）
  - 采购计划审批（审批流程、审批意见）
  - 采购计划执行（执行状态跟踪）
  - 采购计划查询（按时间、状态查询）
  - 采购计划统计
- 采购视频管理:
  - 上传采购视频（采购现场拍摄，支持多种格式）
  - 视频关联商品（关联到具体商品）
  - 视频审核流程（审核通过后才能关联商品上架）
  - 视频存储与播放（视频存储管理、播放配置）
  - 视频批量管理
- 农户信息管理:
  - 添加农户信息（姓名、联系方式、地址、合作商品）
  - 修改农户信息
  - 农户信息查询（按姓名、地址查询）
  - 农户合作商品管理（关联商品列表）
  - 农户评价统计（客户评价、合作商品评价）
- 供应商管理:
  - 添加供应商（批发商信息：名称、联系方式、地址）
  - 供应商信息管理（修改、删除）
  - 供应商商品管理（供应商提供的商品列表）
  - 供应商评价（供应商服务质量评价）
  - 供应商统计（合作商品数、采购金额统计）

3.3.5 订单管理

功能描述: 全局管理端订单管理，包括订单查询、处理、统计等。
功能需求:
- 订单查询:
  - 全局订单查询（所有门店订单）
  - 订单详情查看
  - 订单搜索（按订单号、客户姓名、商品名称搜索）
  - 订单筛选（按状态、时间范围、小区、门店筛选）
  - 订单导出（Excel导出）
- 订单处理:
  - 订单取消（系统取消，取消原因）
  - 订单退款处理（退款申请审核、退款处理）
  - 订单备注添加
  - 订单异常处理
- 订单统计:
  - 按小区统计订单（订单数量、订单金额）
  - 按门店统计订单（订单数量、订单金额）
  - 按时间范围统计订单（日、周、月统计）
  - 订单状态分布统计
  - 订单趋势分析
  - 订单商品统计（热销商品、滞销商品）

3.3.6 用户管理

功能描述: 全局管理端用户管理，包括客户信息、会员管理等。
功能需求:
- 客户信息管理:
  - 客户信息查询（按手机号、昵称、小区查询）
  - 客户分页查询
  - 客户详情查看（个人信息、订单记录、评价记录）
  - 客户状态管理（启用、禁用）
- 会员管理:
  - 会员等级设置（等级名称、等级条件、等级权益）
  - 会员权益管理（折扣、积分、优惠券配置）
  - 会员积分管理（积分获取规则、积分消费规则、积分调整）
  - 会员成长值管理（成长值获取规则、成长值计算）
  - 会员统计（会员数量、会员分布、会员活跃度）
- 用户统计:
  - 用户注册统计（日、周、月注册量）
  - 活跃用户统计（日活、周活、月活）
  - 会员统计（会员数量、会员占比）
  - 用户复购率统计
  - 按小区统计用户数
  - 小区用户活跃度统计
  - 用户行为分析

3.3.7 支付管理

功能描述: 全局管理端支付管理，包括支付处理、退款管理、资金管理等。
功能需求:
- 支付处理:
  - 支付请求生成（订单支付请求）
  - 支付回调处理（第三方支付回调）
  - 支付状态更新（支付成功、支付失败）
  - 支付失败处理（失败原因分析、重试机制）
  - 支付统计（支付方式分布、支付成功率）
- 退款管理:
  - 退款申请查看（退款原因、退款金额）
  - 退款审核（审核通过、审核拒绝）
  - 退款处理（原路退回、退款状态跟踪）
  - 退款记录查询（按时间、状态查询）
  - 退款统计（退款金额、退款率）
- 资金管理:
  - 账户余额查询（用户账户余额）
  - 充值功能（手动充值、充值记录）
  - 提现功能（提现申请审核、提现处理）
  - 资金流水查询（收入、支出明细）
  - 资金统计（账户总余额、充值总额、提现总额）

3.3.8 评价管理

功能描述: 全局管理端评价管理，包括评价审核、删除、统计等。
功能需求:
- 评价审核:
  - 商品评价审核（审核通过、审核拒绝）
  - 配送评价审核
  - 评价内容审核（敏感词过滤）
  - 评价图片审核
- 评价删除:
  - 删除不当评价（违规评价删除）
  - 批量删除评价
  - 删除原因记录
- 评价筛选:
  - 按商品筛选评价
  - 按评分筛选评价
  - 按时间筛选评价
  - 按状态筛选评价（已审核、待审核）
- 评价统计:
  - 好评率统计（商品好评率、配送好评率）
  - 平均分统计（商品平均分、配送平均分）
  - 评价数量统计
  - 评价趋势分析

3.3.9 营销管理

功能描述: 全局管理端营销管理，包括优惠券、促销活动、会员权益等。
功能需求:
- 优惠券管理:
  - 创建优惠券（满减券、折扣券，设置使用条件、有效期）
  - 优惠券发放（手动发放给指定用户、自动发放规则配置）
  - 优惠券使用（使用记录查询）
  - 优惠券查询（按状态、时间查询）
  - 优惠券统计（发放数量、使用数量、使用率）
- 促销活动管理:
  - 创建促销活动（限时折扣、满减活动）
  - 活动商品设置（选择参与活动的商品）
  - 活动时间设置（开始时间、结束时间）
  - 活动规则配置（折扣力度、满减金额）
  - 活动效果统计（参与商品销量、销售额、活动ROI）
- 会员权益管理:
  - 会员专享价格设置（商品会员价配置）
  - 会员积分奖励设置（积分获取规则、积分奖励配置）
  - 会员生日礼包设置（生日礼包内容、发放规则）
  - 会员升级奖励设置（升级奖励配置）

3.3.10 数据统计

功能描述: 全局管理端数据统计，包括销售、库存、配送、用户等统计。
功能需求:
- 销售统计:
  - 销售额统计（日、周、月销售额）
  - 商品销量统计（商品销量排行）
  - 分类销售统计（各分类销售额、销量）
  - 农户直采商品销售统计（农户直采商品销售额、销量）
  - 销售趋势分析（销售额趋势、销量趋势）
  - 按小区统计销售额
  - 按门店统计销售额
  - 销售对比分析（同比、环比）
- 库存统计:
  - 库存总量统计（总库存量、总库存金额）
  - 库存周转率（各商品库存周转率）
  - 库存预警统计（库存不足商品统计）
  - 库存成本统计（库存成本分析）
  - 库存分布统计（各门店库存分布）
- 配送统计:
  - 配送订单统计（配送订单数量）
  - 配送时效统计（平均配送时间、15分钟送达率）
  - 配送员工作量统计（配送员配送订单数、配送时效）
  - 配送范围覆盖统计（覆盖小区数、覆盖用户数）
  - 配送异常统计（超时订单、异常订单）
- 用户统计:
  - 用户注册统计（日、周、月注册量）
  - 活跃用户统计（日活、周活、月活）
  - 会员统计（会员数量、会员占比）
  - 用户复购率统计
  - 按小区统计用户数
  - 小区用户活跃度统计
  - 用户留存分析（新用户留存率、老用户留存率）

3.3.11 系统管理

功能描述: 全局管理端系统管理，包括管理员、角色权限、系统配置等。
功能需求:
- 管理员管理:
  - 添加管理员（用户名、密码、角色、权限）
  - 修改管理员信息
  - 删除管理员
  - 管理员分页查询
  - 管理员登录（登录验证、登录日志）
  - 修改密码（密码修改、密码重置）
  - 管理员状态管理（启用、禁用）
- 角色权限管理:
  - 角色管理（添加、修改、删除角色）
  - 权限分配（功能权限分配）
  - 菜单权限配置（菜单访问权限配置）
  - 数据权限配置（数据访问权限配置，如门店数据权限）
  - 角色权限查询
- 系统配置:
  - 系统参数配置（配送时间、配送费、会员折扣等）
  - 消息通知配置（短信通知、APP推送配置）
  - 支付配置（支付方式配置、支付参数配置）
  - 第三方服务配置（地图服务、短信服务、文件存储服务配置）
  - 系统参数查询
- 操作日志:
  - 操作日志记录（管理员操作记录）
  - 操作日志查询（按时间、管理员、操作类型查询）
  - 异常日志记录（系统异常记录）
  - 日志导出

4. 非功能需求

4.1 性能需求

响应时间:
- 页面响应时间 ≤2 秒
- API接口响应时间 ≤1 秒
- 视频加载时间 ≤5 秒
并发用户数: 支持不少于 1000 人同时在线
数据处理能力:
- 支持大量订单和商品数据的快速查询
- 支持视频文件的快速上传和播放
配送时效: 确保15分钟内送达率 ≥95%

4.2 安全需求

数据加密:
- 重要数据传输与存储加密（HTTPS、数据库加密）
- 支付数据加密
- 用户隐私数据加密
用户认证:
- 支持多种登录方式（手机号、微信）
- 支持短信验证码验证
- 支持二次验证
权限控制:
- 基于角色的访问控制（RBAC）
- 数据权限控制
操作审计:
- 完整的操作日志记录
- 敏感操作二次确认
视频安全:
- 视频文件防篡改
- 视频访问权限控制

4.3 兼容性需求

浏览器兼容性: 支持主流浏览器（Chrome、Edge、Firefox、Safari等）
设备兼容性:
- 支持PC端及移动端自适应
- 支持iOS和Android原生APP
- 支持微信小程序
系统兼容性: 支持Windows、Linux、macOS等操作系统
视频格式兼容: 支持主流视频格式（MP4、AVI、MOV等）

4.4 可用性需求

系统稳定性: 系统可用性 ≥99.5%
高可用: 支持负载均衡、故障自动切换
数据备份: 定期数据备份，支持数据恢复
容灾能力: 支持异地容灾

4.5 其他需求

良好的用户体验（UI/UX设计）: 界面简洁美观，操作便捷
日志与异常监控: 实时监控系统运行状态，及时发现和处理异常
系统扩展性: 支持功能模块扩展，支持多门店扩展
API接口标准化: RESTful API设计，支持第三方系统对接
视频存储: 支持大容量视频存储，支持CDN加速

5. 约束条件

5.1 技术约束

技术栈:
- 前端：Vue.js/React.js + 微信小程序
- 后端：Spring Boot/Node.js
- 数据库：MySQL/PostgreSQL
- 缓存：Redis
- 消息队列：RabbitMQ/Kafka
- 文件存储：OSS/对象存储
- 视频处理：FFmpeg
- 地图服务：高德地图/百度地图API
开发工具:
- IDE：IntelliJ IDEA/VS Code
- 版本控制：Git
- 项目管理：Maven/npm
- 接口文档：Swagger

5.2 时间约束

项目开始时间: 待定
项目结束时间: 待定
开发周期: 预计 8-10 个月

5.3 资源约束

人力资源: 开发团队 8-12 人（前端、后端、测试、产品、设计）
硬件资源:
- 服务器（应用服务器、数据库服务器、文件服务器）
- 视频存储空间（大容量存储）
- CDN服务
第三方服务:
- 支付接口（微信支付、支付宝）
- 短信服务
- 地图服务API
- 视频处理服务
- 文件存储服务

5.4 业务约束

配送范围: 基于门店关联的小区，每个门店服务一个或多个小区，确保15分钟配送时效
配送时间: 营业时间内，15分钟送达
商品上架: 必须上传采购视频后才能上架
农户直采: 需要建立农户信息档案，确保可追溯

6. 附录

6.1 术语表

术语	定义
优鲜	线上买菜系统名称，提供15分钟极速配送的生鲜电商平台
农户直采	直接从农村农户家采购的蔬菜，区别于批发市场采购，具有特殊标识
采购视频	商品采购过程中拍摄的视频，用于展示食材来源，建立消费者信任
15分钟送达	系统核心服务承诺，从下单到配送完成在15分钟内完成
门店	线下实体门店，作为商品存储和配送起点
小区	系统服务的基本单位，每个小区关联一个门店，门店以小区为单位进行扩展
门店小区关联	门店与服务小区的绑定关系，一个门店可服务多个小区，一个小区对应一个门店
配送范围	门店能够提供配送服务的区域范围，基于关联的小区进行配送
配送员	负责订单配送的工作人员，需要确保15分钟内送达
农户	与平台合作的农村农户，提供直采蔬菜
批发商	提供批量采购商品的供应商
农户直采标识	在商品上显示的特殊标识，用于区分农户直采商品和批发商品
购物车	用户选择的商品临时存储区域
订单	客户提交的购买申请，包含商品信息、配送地址、支付信息等
订单状态	订单在业务流程中的当前状态，如待支付、已支付、配送中、已完成等
配送路线优化	根据多个订单地址，规划最优配送路线，提高配送效率
库存管理	管理门店商品库存，包括库存查询、预警、盘点等
会员	注册用户，享受会员权益（折扣、积分等）
优惠券	平台发放的优惠凭证，可用于订单抵扣
促销活动	平台组织的营销活动，如限时折扣、满减活动等
视频审核	对上传的采购视频进行审核，确保内容合规后才能关联商品上架
实时定位	通过GPS等技术实时获取配送员位置信息
配送时效统计	统计配送订单的时效数据，包括平均配送时间、15分钟送达率等
用户复购率	用户重复购买的比例，反映用户粘性和平台服务质量
小区扩展	系统以小区为单位进行门店扩展，新小区入驻时分配对应门店
地址小区识别	系统自动识别收货地址所属的小区，用于匹配服务门店
库存周转率	商品库存的周转速度，反映库存管理效率
CDN	Content Delivery Network，内容分发网络，用于加速视频和图片的访问速度
OSS	Object Storage Service，对象存储服务，用于存储视频、图片等文件
RBAC	Role-Based Access Control，基于角色的访问控制
API接口	Application Programming Interface，应用程序编程接口，用于系统间数据交互
高可用	High Availability，系统的高可用性，确保服务持续稳定运行
负载均衡	将请求分发到多个服务器，提高系统处理能力和可用性
容灾	在系统故障时，能够快速切换到备用系统，保证业务连续性

6.2 参考文献

[参考文献 1]
[参考文献 2]

备注: 以上为优鲜系统的需求文档，基于"15分钟送达，每天都是新鲜的蔬菜"的核心理念，通过采购视频透明化和农户直采标识等特色功能，打造差异化竞争优势。后续可根据实际业务需求进一步细化和调整。