From fb0707420229bbd6a9866ff59ed8e16d2f7fc1cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E9=B9=8F?= <wangpengv@yonyou.com>
Date: Tue, 7 Jul 2026 14:32:18 +0800
Subject: [PATCH] docs: add linxiaobang phase one PRD

---
 .../2026-07-07-linxiaobang-prd-design.md      | 783 ++++++++++++++++++
 1 file changed, 783 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-07-07-linxiaobang-prd-design.md

diff --git a/docs/superpowers/specs/2026-07-07-linxiaobang-prd-design.md b/docs/superpowers/specs/2026-07-07-linxiaobang-prd-design.md
new file mode 100644
index 0000000..1eeedfe
--- /dev/null
+++ 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。
+
+用户确认本文档后，可继续进入实施计划阶段，拆分项目结构、接口、数据库表、开发里程碑和任务清单。