docs: add linxiaobang phase one PRD

2026-07-07 14:32:18 +08:00
commit fb07074202
1 changed files with 783 additions and 0 deletions
--- a/docs/superpowers/specs/2026-07-07-linxiaobang-prd-design.md
+++ b/docs/superpowers/specs/2026-07-07-linxiaobang-prd-design.md
@@ -0,0 +1,783 @@
 # 邻小帮一期 PRD 设计
 版本：v0.1  
 日期：2026-07-07  
 范围：单小区 MVP，底层预留多社区 SaaS 能力  
 状态：待评审
 ## 1. 产品概述
 「邻小帮」是面向社区居民的生活服务小程序。一期围绕一个小区上线，优先跑通商品预定、配送上门、快递代取、社区团购、二手闲置和社区公告等高频场景。
 一期不追求成为万能社区平台，而是验证一个完整履约闭环：
 居民下单或提交服务需求 -> 后台确认 -> 商家备货或配送员取件 -> 管理员派单 -> 配送员送达 -> 用户确认完成 -> 后台沉淀运营数据。
 ## 2. 产品目标
 ### 2.1 一期目标
 - 支持一个小区真实试运营。
 - 支持居民完成商品预定、快递代取、团购预定、闲置发布和公告查看。
 - 支持后台完成商品、订单、配送、团购、公告、闲置审核等日常管理。
 - 支持配送员通过 H5 接收任务、更新状态、上传送达照片。
 - 数据结构和权限模型预留多小区、多商户、多角色扩展能力。
 ### 2.2 非目标
 一期不做以下能力：
 - 微信支付和在线退款。
 - 配送员自动抢单。
 - 实时配送轨迹。
 - 复杂优惠券、会员积分和营销插件。
 - 商家自动结算。
 - 多小区前台切换。
 - 家政、维修、论坛、拼车等二期服务。
 - 二手闲置在线担保交易。
 ## 3. 用户角色
 ### 3.1 居民用户
 居民用户通过微信小程序使用服务，主要操作包括：
 - 浏览首页内容。
 - 浏览商品并提交订单。
 - 提交快递代取需求。
 - 参与社区团购。
 - 发布和浏览二手闲置。
 - 查看社区公告。
 - 管理收货地址。
 - 查看订单状态。
 - 联系商家、配送员或客服。
 ### 3.2 社区管理员
 社区管理员负责小区日常运营，主要操作包括：
 - 管理订单。
 - 确认订单。
 - 指派配送员。
 - 发布公告。
 - 发布团购。
 - 审核二手闲置。
 - 处理投诉和异常订单。
 - 查看基础运营数据。
 ### 3.3 商家
 商家负责商品和备货，主要操作包括：
 - 管理商品分类。
 - 管理商品、规格和库存。
 - 查看相关商品订单。
 - 更新备货状态。
 - 配合管理员处理订单异常。
 ### 3.4 配送员
 配送员通过 H5 完成履约，主要操作包括：
 - 查看被分配的配送任务。
 - 查看用户地址和联系方式。
 - 更新配送状态。
 - 上传送达照片。
 - 标记配送异常。
 - 查看当日完成量和粗略收入统计。
 ### 3.5 平台管理员
 平台管理员是 SaaS 扩展预留角色。一期可隐藏复杂入口，只保留底层数据模型和权限设计，后续用于管理多个小区、租户、商户和服务模块。
 ## 4. 产品范围
 一期采用标准 MVP 范围，包含：
 - 微信小程序居民端。
 - Vue 管理后台。
 - 配送员 H5。
 - 后端 API。
 - MySQL 数据库。
 - 文件存储，用于商品图片、闲置图片、快递图片、送达照片等。
 一期支付方式采用线下支付或货到付款。后台保留收款状态字段，后续再接入微信支付。
 一期配送方式采用后台派单。管理员将商品订单、快递代取订单或团购配送任务分配给配送员。
 ## 5. 小程序端 PRD
 ### 5.1 首页
 首页目标是让居民快速进入高频服务，并看到当前社区的运营内容。
 页面元素：
 - 当前社区名称。
 - 搜索框。
 - 今日活动 Banner。
 - 功能入口：商品预定、代取快递、今日团购、二手闲置、社区公告、我的订单。
 - 热门商品。
 - 今日团购。
 - 最新闲置。
 - 最新公告。
 交互规则：
 - 点击商品预定进入商品分类页。
 - 点击代取快递进入代取表单。
 - 点击今日团购进入团购列表。
 - 点击二手闲置进入闲置列表。
 - 点击社区公告进入公告列表。
 - 点击我的订单进入订单中心。
 异常状态：
 - 无 Banner 时隐藏 Banner 区域。
 - 无热门商品时显示简短空状态。
 - 无公告时显示“暂无公告”。
 ### 5.2 商品预定
 商品预定是一期核心交易模块，服务社区便利店、水果店、生鲜店等本地商户。
 功能包括：
 - 商品分类。
 - 商品列表。
 - 商品搜索。
 - 商品详情。
 - SKU 或规格选择。
 - 数量选择。
 - 库存展示。
 - 配送方式选择。
 - 备注填写。
 - 订单提交。
 默认分类：
 - 水果。
 - 零食。
 - 饮料。
 - 早餐。
 - 蔬菜。
 - 日用品。
 配送方式：
 - 立即配送。
 - 预约配送。
 - 自提。
 订单状态：
 - 待确认：用户已提交订单，后台尚未确认。
 - 待备货：后台已确认，商家准备商品。
 - 待配送：商品已备好，等待派单或配送。
 - 待自提：商品已备好，等待用户到店自提。
 - 配送中：配送员已开始配送。
 - 已完成：用户确认或后台确认完成。
 - 已取消：用户或后台取消订单。
 业务规则：
 - 线下支付订单提交后直接进入待确认。
 - 商品库存不足时不可下单。
 - 预约配送必须选择预约时间。
 - 自提订单不进入配送员派单流程。
 - 后台可取消异常订单，并记录取消原因。
 ### 5.3 快递代取
 快递代取是高频服务模块，目标是降低居民取件成本，并为平台带来稳定服务费。
 用户填写信息：
 - 快递公司。
 - 取件码。
 - 取件地址。
 - 收货地址。
 - 手机号。
 - 件数。
 - 备注。
 - 可选图片，如取件截图。
 计费规则：
 - 首件 3 元。
 - 第二件起每件加 1 元。
 - 后台可手动调整异常订单价格。
 订单状态：
 - 待确认：用户已提交，后台待确认。
 - 待取件：后台已确认并准备派单。
 - 取件中：配送员正在前往取件。
 - 配送中：配送员已取到快递并配送。
 - 已送达：配送员已送达并上传照片。
 - 已完成：用户确认或后台确认完成。
 - 已取消：订单取消。
 业务规则：
 - 用户提交后，系统根据件数自动计算预估费用。
 - 后台确认后才能派单。
 - 配送员送达时可上传照片。
 - 若取件码错误或快递不存在，配送员可标记异常。
 ### 5.4 今日团购
 团购用于社区集中采购和统一配送，一期做轻量预定，不做复杂成团机制。
 页面内容：
 - 团购商品图片。
 - 团购标题。
 - 团购价。
 - 原价。
 - 剩余库存。
 - 截单时间。
 - 预计送达或自提时间。
 - 商品详情。
 用户操作：
 - 选择数量。
 - 选择收货地址。
 - 填写备注。
 - 提交团购订单。
 订单状态：
 - 待确认。
 - 已确认。
 - 待配送或待自提。
 - 配送中。
 - 已完成。
 - 已取消。
 业务规则：
 - 截单后用户不可继续下单。
 - 库存售罄后不可下单。
 - 后台可按团购活动汇总订单。
 - 团购订单可选择配送或自提。
 ### 5.5 二手闲置
 二手闲置用于提升社区活跃度，一期只做信息发布和联系，不做在线交易。
 用户发布信息：
 - 标题。
 - 图片。
 - 价格。
 - 描述。
 - 分类。
 - 联系方式。
 - 交易方式：面交或可配送。
 浏览能力：
 - 闲置列表。
 - 闲置详情。
 - 搜索。
 - 分类筛选。
 - 收藏。
 - 联系卖家。
 审核规则：
 - 用户发布后进入待审核。
 - 社区管理员审核通过后展示。
 - 审核拒绝需填写原因。
 - 用户可下架自己的闲置。
 内容状态：
 - 待审核。
 - 已发布。
 - 已拒绝。
 - 已下架。
 - 已成交。
 ### 5.6 社区公告
 社区公告用于物业通知、停水停电、活动和运营通知。
 功能包括：
 - 公告列表。
 - 公告详情。
 - 置顶公告。
 - 发布时间。
 - 公告分类。
 公告分类：
 - 物业通知。
 - 停水停电。
 - 社区活动。
 - 服务说明。
 - 其他。
 ### 5.7 我的
 我的页面用于承载个人信息和用户资产。
 功能包括：
 - 用户头像和昵称。
 - 地址管理。
 - 商品订单。
 - 快递代取订单。
 - 团购订单。
 - 我的闲置。
 - 我的收藏。
 - 联系客服。
 - 服务协议和隐私政策入口。
 ## 6. 后台管理 PRD
 ### 6.1 登录与权限
 后台支持账号密码登录。一期角色包括：
 - 平台管理员。
 - 社区管理员。
 - 商家。
 - 配送员。
 权限规则：
 - 平台管理员可查看所有预留社区数据。
 - 社区管理员只管理当前社区。
 - 商家只管理自己店铺的商品和订单。
 - 配送员只查看分配给自己的配送任务。
 ### 6.2 社区管理
 社区管理用于 SaaS 预留，一期只维护当前小区。
 字段包括：
 - 社区名称。
 - 社区地址。
 - 负责人。
 - 联系电话。
 - 服务状态。
 - 服务模块开关。
 模块开关包括：
 - 商品预定。
 - 快递代取。
 - 团购。
 - 二手闲置。
 - 社区公告。
 ### 6.3 商家管理
 字段包括：
 - 商家名称。
 - 商家类型。
 - 联系人。
 - 联系电话。
 - 营业状态。
 - 所属社区。
 商家类型：
 - 便利店。
 - 水果店。
 - 生鲜店。
 - 药店。
 - 其他。
 ### 6.4 商品管理
 功能包括：
 - 商品分类管理。
 - 商品新增、编辑、上下架。
 - 商品图片管理。
 - SKU 或规格管理。
 - 库存管理。
 - 库存变更记录。
 商品字段：
 - 商品名称。
 - 商品分类。
 - 所属商家。
 - 商品图片。
 - 商品描述。
 - 售价。
 - 原价。
 - 库存。
 - 单位。
 - 状态。
 ### 6.5 订单管理
 订单管理包含商品订单、快递代取订单和团购订单。
 通用能力：
 - 订单列表。
 - 订单详情。
 - 状态筛选。
 - 用户筛选。
 - 时间筛选。
 - 修改状态。
 - 取消订单。
 - 指派配送员。
 - 查看操作日志。
 - 记录收款状态。
 线下收款状态：
 - 未收款。
 - 已收款。
 - 已免单。
 - 异常。
 取消规则：
 - 待确认订单可直接取消。
 - 配送中订单取消需填写原因。
 - 已完成订单不可取消，只能做售后备注。
 ### 6.6 配送管理
 功能包括：
 - 配送员列表。
 - 配送员启用和停用。
 - 待派单订单。
 - 配送中订单。
 - 已完成订单。
 - 送达照片查看。
 - 配送异常处理。
 派单规则：
 - 管理员选择待配送订单。
 - 管理员选择配送员。
 - 系统生成配送任务。
 - 配送员 H5 展示任务。
 ### 6.7 团购管理
 功能包括：
 - 发布团购。
 - 设置团购商品。
 - 设置价格、库存、截单时间。
 - 设置预计送达或自提时间。
 - 查看团购订单汇总。
 - 修改团购状态。
 团购状态：
 - 未开始。
 - 进行中。
 - 已截单。
 - 已完成。
 - 已取消。
 ### 6.8 二手审核
 功能包括：
 - 待审核列表。
 - 审核通过。
 - 审核拒绝。
 - 下架违规内容。
 - 查看用户发布记录。
 审核重点：
 - 图片是否违规。
 - 描述是否违规。
 - 联系方式是否异常。
 - 是否包含违法或高风险商品。
 ### 6.9 公告管理
 功能包括：
 - 新增公告。
 - 编辑公告。
 - 删除公告。
 - 设置置顶。
 - 设置分类。
 - 设置发布状态。
 公告状态：
 - 草稿。
 - 已发布。
 - 已下线。
 ### 6.10 数据概览
 首页看板展示：
 - 今日订单数。
 - 今日应收金额。
 - 待确认订单数。
 - 待配送订单数。
 - 快递代取订单数。
 - 今日团购订单数。
 - 热门商品。
 - 配送员完成量。
 一期数据看板只做基础运营统计，不做复杂 BI 分析。
 ## 7. 配送员 H5 PRD
 配送员 H5 面向手机浏览器使用，重点是简单、稳定、少操作。
 页面包括：
 - 登录页。
 - 今日任务。
 - 配送中。
 - 已完成。
 - 订单详情。
 - 收入统计。
 订单详情展示：
 - 订单类型。
 - 用户姓名。
 - 用户电话。
 - 收货地址。
 - 商品或快递信息。
 - 配送备注。
 - 应收金额。
 - 当前状态。
 操作包括：
 - 开始配送。
 - 标记已送达。
 - 上传送达照片。
 - 标记异常。
 - 一键拨号。
 异常类型：
 - 联系不上用户。
 - 地址错误。
 - 商品缺货。
 - 快递取件失败。
 - 用户拒收。
 - 其他。
 ## 8. 核心业务流程
 ### 8.1 商品订单流程
 1. 用户浏览商品。
 2. 用户选择规格、数量和配送方式。
 3. 用户提交订单。
 4. 订单进入待确认。
 5. 后台确认订单。
 6. 商家备货。
 7. 后台将订单指派给配送员。
 8. 配送员开始配送。
 9. 配送员送达并上传照片。
 10. 用户确认完成或后台确认完成。
 ### 8.2 快递代取流程
 1. 用户填写快递代取信息。
 2. 系统根据件数计算预估费用。
 3. 用户提交订单。
 4. 后台确认订单和价格。
 5. 后台指派配送员。
 6. 配送员前往取件。
 7. 配送员取件后开始配送。
 8. 配送员送达并上传照片。
 9. 用户确认完成或后台确认完成。
 ### 8.3 团购流程
 1. 后台发布团购活动。
 2. 用户浏览团购商品。
 3. 用户提交团购订单。
 4. 截单前后台可查看订单明细。
 5. 截单后后台汇总订单。
 6. 商家备货。
 7. 后台安排配送或自提。
 8. 用户收货后完成订单。
 ### 8.4 二手闲置流程
 1. 用户发布闲置信息。
 2. 内容进入待审核。
 3. 后台审核。
 4. 审核通过后前台展示。
 5. 买家联系卖家。
 6. 双方线下完成交易。
 7. 发布者可标记已成交或下架。
 ## 9. 数据设计概要
 一期数据结构需要支持单小区上线，并预留 SaaS 扩展字段。
 核心公共字段：
 - tenant_id：租户 ID。
 - community_id：社区 ID。
 - merchant_id：商家 ID。
 - created_at：创建时间。
 - updated_at：更新时间。
 - deleted：逻辑删除标记。
 建议表：
 - app_user：用户。
 - user_address：用户地址。
 - sys_role：角色。
 - user_role：用户角色。
 - tenant：租户。
 - community：社区。
 - community_module_config：社区模块配置。
 - merchant：商家。
 - product_category：商品分类。
 - product：商品。
 - product_sku：商品规格。
 - stock_log：库存日志。
 - goods_order：商品订单。
 - goods_order_item：商品订单明细。
 - order_log：订单日志。
 - express_order：快递代取订单。
 - express_log：快递代取日志。
 - group_buy：团购活动。
 - group_buy_order：团购订单。
 - delivery_user：配送员。
 - delivery_order：配送任务。
 - delivery_log：配送日志。
 - second_goods：二手闲置。
 - second_goods_img：二手图片。
 - second_goods_comment：二手留言。
 - notice：公告。
 - banner：Banner。
 - feedback：投诉与反馈。
 支付和退款表一期可预留，但不进入核心流程：
 - payment_record：收款记录。
 - refund_record：退款记录。
 ## 10. 状态机设计
 ### 10.1 商品订单状态
 - 待确认。
 - 待备货。
 - 待配送。
 - 待自提。
 - 配送中。
 - 已完成。
 - 已取消。
 ### 10.2 快递代取状态
 - 待确认。
 - 待取件。
 - 取件中。
 - 配送中。
 - 已送达。
 - 已完成。
 - 已取消。
 ### 10.3 团购订单状态
 - 待确认。
 - 已确认。
 - 待配送。
 - 待自提。
 - 配送中。
 - 已完成。
 - 已取消。
 ### 10.4 闲置状态
 - 待审核。
 - 已发布。
 - 已拒绝。
 - 已下架。
 - 已成交。
 ## 11. 异常与风控
 订单异常：
 - 用户取消。
 - 商家缺货。
 - 地址错误。
 - 联系不上用户。
 - 配送失败。
 - 用户拒收。
 - 后台操作错误。
 处理规则：
 - 所有后台状态变更记录操作日志。
 - 取消订单必须记录取消原因。
 - 配送异常必须选择异常类型并填写说明。
 - 送达照片作为履约证据。
 二手风控：
 - 发布内容必须审核后展示。
 - 后台可下架违规内容。
 - 用户联系方式只在详情页展示。
 ## 12. 验收标准
 一期上线需满足：
 - 居民可以完成商品下单、快递代取、团购预定。
 - 居民可以发布闲置，后台审核后展示。
 - 居民可以查看社区公告。
 - 后台可以管理商品、库存、订单、团购、公告和闲置审核。
 - 管理员可以为订单指派配送员。
 - 配送员可以查看任务、更新状态并上传送达照片。
 - 订单状态流转清晰，关键操作有日志。
 - 后台可以记录线下收款状态。
 - 系统可支持一个小区真实试运营。
 - 数据模型预留 tenant_id、community_id、merchant_id 等 SaaS 扩展字段。
 ## 13. 后续扩展方向
 二期可考虑：
 - 微信支付。
 - 优惠券。
 - 会员积分。
 - 配送员抢单。
 - 多社区管理后台。
 - 商户结算。
 - 家政服务。
 - 上门维修。
 - 跑腿服务。
 - 社区论坛。
 - 物业缴费。
 - 数据分析看板。
 ## 14. 待用户确认
 本 PRD 已确定以下方向：
 - 产品形态：单小区先上线，底层预留 SaaS。
 - 支付方式：线下支付或货到付款。
 - 配送方式：后台派单。
 - 一期范围：标准 MVP。
 用户确认本文档后，可继续进入实施计划阶段，拆分项目结构、接口、数据库表、开发里程碑和任务清单。