LinHelp/docs/superpowers/specs/2026-07-07-linxiaobang-prd-design.md

邻小帮一期 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. 技术选型

一期技术选型确认如下：

• 后端：Java 8、Spring Boot 2.7.x、MyBatis Plus、Sa-Token、MySQL、Redis、Flyway、Knife4j、MinIO。
• 小程序端：微信原生小程序，使用 WXML、WXSS、JavaScript 和 wx.request 封装请求。
• 后台管理端：Vue 3、TypeScript、Vite、Element Plus。
• 配送员端 H5：Vue 3、TypeScript、Vite。

因后端指定 Java 8，一期不采用 Spring Boot 3；Spring Boot 3 要求 Java 17 及以上。

6. 小程序端 PRD

6.1 首页

首页目标是让居民快速进入高频服务，并看到当前社区的运营内容。

页面元素：

• 当前社区名称。
• 搜索框。
• 今日活动 Banner。
• 功能入口：商品预定、代取快递、今日团购、二手闲置、社区公告、我的订单。
• 热门商品。
• 今日团购。
• 最新闲置。
• 最新公告。

交互规则：

• 点击商品预定进入商品分类页。
• 点击代取快递进入代取表单。
• 点击今日团购进入团购列表。
• 点击二手闲置进入闲置列表。
• 点击社区公告进入公告列表。
• 点击我的订单进入订单中心。

异常状态：

• 无 Banner 时隐藏 Banner 区域。
• 无热门商品时显示简短空状态。
• 无公告时显示“暂无公告”。

6.2 商品预定

商品预定是一期核心交易模块，服务社区便利店、水果店、生鲜店等本地商户。

功能包括：

• 商品分类。
• 商品列表。
• 商品搜索。
• 商品详情。
• SKU 或规格选择。
• 数量选择。
• 库存展示。
• 配送方式选择。
• 备注填写。
• 订单提交。

默认分类：

• 水果。
• 零食。
• 饮料。
• 早餐。
• 蔬菜。
• 日用品。

配送方式：

• 立即配送。
• 预约配送。
• 自提。

订单状态：

• 待确认：用户已提交订单，后台尚未确认。
• 待备货：后台已确认，商家准备商品。
• 待配送：商品已备好，等待派单或配送。
• 待自提：商品已备好，等待用户到店自提。
• 配送中：配送员已开始配送。
• 已完成：用户确认或后台确认完成。
• 已取消：用户或后台取消订单。

业务规则：

• 线下支付订单提交后直接进入待确认。
• 商品库存不足时不可下单。
• 预约配送必须选择预约时间。
• 自提订单不进入配送员派单流程。
• 后台可取消异常订单，并记录取消原因。

6.3 快递代取

快递代取是高频服务模块，目标是降低居民取件成本，并为平台带来稳定服务费。

用户填写信息：

• 快递公司。
• 取件码。
• 取件地址。
• 收货地址。
• 手机号。
• 件数。
• 备注。
• 可选图片，如取件截图。

计费规则：

• 首件 3 元。
• 第二件起每件加 1 元。
• 后台可手动调整异常订单价格。

订单状态：

• 待确认：用户已提交，后台待确认。
• 待取件：后台已确认并准备派单。
• 取件中：配送员正在前往取件。
• 配送中：配送员已取到快递并配送。
• 已送达：配送员已送达并上传照片。
• 已完成：用户确认或后台确认完成。
• 已取消：订单取消。

业务规则：

• 用户提交后，系统根据件数自动计算预估费用。
• 后台确认后才能派单。
• 配送员送达时可上传照片。
• 若取件码错误或快递不存在，配送员可标记异常。

6.4 今日团购

团购用于社区集中采购和统一配送，一期做轻量预定，不做复杂成团机制。

页面内容：

• 团购商品图片。
• 团购标题。
• 团购价。
• 原价。
• 剩余库存。
• 截单时间。
• 预计送达或自提时间。
• 商品详情。

用户操作：

• 选择数量。
• 选择收货地址。
• 填写备注。
• 提交团购订单。

订单状态：

• 待确认。
• 已确认。
• 待配送或待自提。
• 配送中。
• 已完成。
• 已取消。

业务规则：

• 截单后用户不可继续下单。
• 库存售罄后不可下单。
• 后台可按团购活动汇总订单。
• 团购订单可选择配送或自提。

6.5 二手闲置

二手闲置用于提升社区活跃度，一期只做信息发布和联系，不做在线交易。

用户发布信息：

• 标题。
• 图片。
• 价格。
• 描述。
• 分类。
• 联系方式。
• 交易方式：面交或可配送。

浏览能力：

• 闲置列表。
• 闲置详情。
• 搜索。
• 分类筛选。
• 收藏。
• 联系卖家。

审核规则：

• 用户发布后进入待审核。
• 社区管理员审核通过后展示。
• 审核拒绝需填写原因。
• 用户可下架自己的闲置。

内容状态：

• 待审核。
• 已发布。
• 已拒绝。
• 已下架。
• 已成交。

6.6 社区公告

社区公告用于物业通知、停水停电、活动和运营通知。

功能包括：

• 公告列表。
• 公告详情。
• 置顶公告。
• 发布时间。
• 公告分类。

公告分类：

• 物业通知。
• 停水停电。
• 社区活动。
• 服务说明。
• 其他。

6.7 我的

我的页面用于承载个人信息和用户资产。

功能包括：

• 用户头像和昵称。
• 地址管理。
• 商品订单。
• 快递代取订单。
• 团购订单。
• 我的闲置。
• 我的收藏。
• 联系客服。
• 服务协议和隐私政策入口。

7. 后台管理 PRD

7.1 登录与权限

后台支持账号密码登录。一期角色包括：

• 平台管理员。
• 社区管理员。
• 商家。
• 配送员。

权限规则：

• 平台管理员可查看所有预留社区数据。
• 社区管理员只管理当前社区。
• 商家只管理自己店铺的商品和订单。
• 配送员只查看分配给自己的配送任务。

7.2 社区管理

社区管理用于 SaaS 预留，一期只维护当前小区。

字段包括：

• 社区名称。
• 社区地址。
• 负责人。
• 联系电话。
• 服务状态。
• 服务模块开关。

模块开关包括：

• 商品预定。
• 快递代取。
• 团购。
• 二手闲置。
• 社区公告。

7.3 商家管理

字段包括：

• 商家名称。
• 商家类型。
• 联系人。
• 联系电话。
• 营业状态。
• 所属社区。

商家类型：

• 便利店。
• 水果店。
• 生鲜店。
• 药店。
• 其他。

7.4 商品管理

功能包括：

• 商品分类管理。
• 商品新增、编辑、上下架。
• 商品图片管理。
• SKU 或规格管理。
• 库存管理。
• 库存变更记录。

商品字段：

• 商品名称。
• 商品分类。
• 所属商家。
• 商品图片。
• 商品描述。
• 售价。
• 原价。
• 库存。
• 单位。
• 状态。

7.5 订单管理

订单管理包含商品订单、快递代取订单和团购订单。

通用能力：

• 订单列表。
• 订单详情。
• 状态筛选。
• 用户筛选。
• 时间筛选。
• 修改状态。
• 取消订单。
• 指派配送员。
• 查看操作日志。
• 记录收款状态。

线下收款状态：

• 未收款。
• 已收款。
• 已免单。
• 异常。

取消规则：

• 待确认订单可直接取消。
• 配送中订单取消需填写原因。
• 已完成订单不可取消，只能做售后备注。

7.6 配送管理

功能包括：

• 配送员列表。
• 配送员启用和停用。
• 待派单订单。
• 配送中订单。
• 已完成订单。
• 送达照片查看。
• 配送异常处理。

派单规则：

• 管理员选择待配送订单。
• 管理员选择配送员。
• 系统生成配送任务。
• 配送员 H5 展示任务。

7.7 团购管理

功能包括：

• 发布团购。
• 设置团购商品。
• 设置价格、库存、截单时间。
• 设置预计送达或自提时间。
• 查看团购订单汇总。
• 修改团购状态。

团购状态：

• 未开始。
• 进行中。
• 已截单。
• 已完成。
• 已取消。

7.8 二手审核

功能包括：

• 待审核列表。
• 审核通过。
• 审核拒绝。
• 下架违规内容。
• 查看用户发布记录。

审核重点：

• 图片是否违规。
• 描述是否违规。
• 联系方式是否异常。
• 是否包含违法或高风险商品。

7.9 公告管理

功能包括：

• 新增公告。
• 编辑公告。
• 删除公告。
• 设置置顶。
• 设置分类。
• 设置发布状态。

公告状态：

• 草稿。
• 已发布。
• 已下线。

7.10 数据概览

首页看板展示：

• 今日订单数。
• 今日应收金额。
• 待确认订单数。
• 待配送订单数。
• 快递代取订单数。
• 今日团购订单数。
• 热门商品。
• 配送员完成量。

一期数据看板只做基础运营统计，不做复杂 BI 分析。

8. 配送员 H5 PRD

配送员 H5 面向手机浏览器使用，重点是简单、稳定、少操作。

页面包括：

• 登录页。
• 今日任务。
• 配送中。
• 已完成。
• 订单详情。
• 收入统计。

订单详情展示：

• 订单类型。
• 用户姓名。
• 用户电话。
• 收货地址。
• 商品或快递信息。
• 配送备注。
• 应收金额。
• 当前状态。

操作包括：

• 开始配送。
• 标记已送达。
• 上传送达照片。
• 标记异常。
• 一键拨号。

异常类型：

• 联系不上用户。
• 地址错误。
• 商品缺货。
• 快递取件失败。
• 用户拒收。
• 其他。

9. 核心业务流程

9.1 商品订单流程

1. 用户浏览商品。
2. 用户选择规格、数量和配送方式。
3. 用户提交订单。
4. 订单进入待确认。
5. 后台确认订单。
6. 商家备货。
7. 后台将订单指派给配送员。
8. 配送员开始配送。
9. 配送员送达并上传照片。
10. 用户确认完成或后台确认完成。

9.2 快递代取流程

1. 用户填写快递代取信息。
2. 系统根据件数计算预估费用。
3. 用户提交订单。
4. 后台确认订单和价格。
5. 后台指派配送员。
6. 配送员前往取件。
7. 配送员取件后开始配送。
8. 配送员送达并上传照片。
9. 用户确认完成或后台确认完成。

9.3 团购流程

1. 后台发布团购活动。
2. 用户浏览团购商品。
3. 用户提交团购订单。
4. 截单前后台可查看订单明细。
5. 截单后后台汇总订单。
6. 商家备货。
7. 后台安排配送或自提。
8. 用户收货后完成订单。

9.4 二手闲置流程

1. 用户发布闲置信息。
2. 内容进入待审核。
3. 后台审核。
4. 审核通过后前台展示。
5. 买家联系卖家。
6. 双方线下完成交易。
7. 发布者可标记已成交或下架。

10. 数据设计概要

一期数据结构需要支持单小区上线，并预留 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：退款记录。

11. 状态机设计

11.1 商品订单状态

• 待确认。
• 待备货。
• 待配送。
• 待自提。
• 配送中。
• 已完成。
• 已取消。

11.2 快递代取状态

• 待确认。
• 待取件。
• 取件中。
• 配送中。
• 已送达。
• 已完成。
• 已取消。

11.3 团购订单状态

• 待确认。
• 已确认。
• 待配送。
• 待自提。
• 配送中。
• 已完成。
• 已取消。

11.4 闲置状态

• 待审核。
• 已发布。
• 已拒绝。
• 已下架。
• 已成交。

12. 异常与风控

订单异常：

• 用户取消。
• 商家缺货。
• 地址错误。
• 联系不上用户。
• 配送失败。
• 用户拒收。
• 后台操作错误。

处理规则：

• 所有后台状态变更记录操作日志。
• 取消订单必须记录取消原因。
• 配送异常必须选择异常类型并填写说明。
• 送达照片作为履约证据。

二手风控：

• 发布内容必须审核后展示。
• 后台可下架违规内容。
• 用户联系方式只在详情页展示。

13. 验收标准

一期上线需满足：

• 居民可以完成商品下单、快递代取、团购预定。
• 居民可以发布闲置，后台审核后展示。
• 居民可以查看社区公告。
• 后台可以管理商品、库存、订单、团购、公告和闲置审核。
• 管理员可以为订单指派配送员。
• 配送员可以查看任务、更新状态并上传送达照片。
• 订单状态流转清晰，关键操作有日志。
• 后台可以记录线下收款状态。
• 系统可支持一个小区真实试运营。
• 数据模型预留 tenant_id、community_id、merchant_id 等 SaaS 扩展字段。

14. 后续扩展方向

二期可考虑：

• 微信支付。
• 优惠券。
• 会员积分。
• 配送员抢单。
• 多社区管理后台。
• 商户结算。
• 家政服务。
• 上门维修。
• 跑腿服务。
• 社区论坛。
• 物业缴费。
• 数据分析看板。

15. 待用户确认

本 PRD 已确定以下方向：

• 产品形态：单小区先上线，底层预留 SaaS。
• 支付方式：线下支付或货到付款。
• 配送方式：后台派单。
• 一期范围：标准 MVP。

用户确认本文档后，可继续进入实施计划阶段，拆分项目结构、接口、数据库表、开发里程碑和任务清单。