NeighborShare

# 产品需求文档（PRD）：邻享家 - 社区能力共享平台 **文档版本：** V1.0 **创建日期：** 2026-07-18 **项目代号：** NeighborShare **目标用户：** 社区业主、租户、周边小微商家（维修点） **核心理念：** 让邻里间的技能与工具，像便利店一样触手可及。 --- ## 1. 产品背景与战略目标 ### 1.1 要解决的核心问题 - **需求侧痛点**：水管漏水、灯泡不亮、需要电钻，找不到靠谱的邻居或师傅；找人维修担心被“杀熟”。 - **供给侧痛点**：退休老师傅有手艺没客源；家里买了几百块的电钻，一年只用两次，闲置吃灰。 - **信息差痛点**：用户不知道“谁能修”，师傅不知道“谁要修”，附近三公里的需求无法精准匹配。 ### 1.2 战略目标（OKR） - **O1（业务目标）**：上线3个月内，实现1000单真实交易闭环；覆盖本地5个大型社区。 - **O2（体验目标）**：从“打开APP拍照”到“预约成功”的核心路径操作步骤不超过4步。 - **O3（数据目标）**：构建包含10万条设备维修数据的结构化知识图谱，支持AI自动问答。 --- ## 2. 核心功能架构总览 系统分为五个核心模块，由五个角色分别主导设计： | 模块名称 | 主导角色 | 核心职责 | | :--- | :--- | :--- | | **1. 智能服务匹配引擎** | **算法工程师** | LBS位置服务、AI图像识别（拍照识物）、维修意图识别与问答推荐。 | | **2. 交易与信用闭环** | **后端开发** | 订单状态机管理、微信/支付宝支付分账、积分计算、评价风控。 | | **3. 服务与知识库建设** | **技术负责人/架构师** | 分布式爬虫系统架构设计、知识库结构化存储、高并发搜索接口。 | | **4. 移动端交互体验** | **产品经理（PM）** | 用户界面设计、操作路径优化、前后端功能逻辑串联与交互稿输出。 | | **5. 全链路质量保障** | **测试/QA** | 接口自动化测试、全链路压测、AI识别准确率验证、异常场景模拟。 | --- ## 3. 详细功能需求（按角色划分） ### 3.1 产品经理（PM）职责：定义用户旅程与界面逻辑 #### 3.1.1 核心页面与操作路径 - **首页（LBS智能推荐）**： - 默认展示“步行10分钟”（约800米）圈内的热门服务与设备租赁列表。 - 顶部核心功能区：**“AI拍照识别”** 与 **“智能问答”** 搜索框。 - 底部常驻大按钮：**“发布服务/出租”**。 - **发布流程（供给侧）**： - 第一步：选择发布类型——【技能服务（上门）】或【工具设备（自取/借用）】。 - 第二步：填写核心字段——标题、详细描述、服务范围、自定义价格（元/小时或元/次）、可预约时间段。 - 第三步：上传资质/实拍图（设备需上传新旧程度照片）。 - **服务详情页（需求侧）- 核心亮点**： - **上半屏**：服务者信息、信用等级（LV1-LV5）、距离、价格。 - **下半屏（战略级功能）**：**“先看指南，再找师傅”**。 - 自动关联该服务品类下的Top3“维修指南”图文/视频。 - 用户点击可展开自助排查步骤。 - 页面底部固定按钮：**“看完指南，仍未解决？立即预约师傅”**。 - **订单状态机（交易闭环）**： - 待接单（发布后） -> 已接单/待服务 -> 服务中（开始计时） -> 待验收/待确认 -> 已完成（触发结算）。 #### 3.1.2 积分与评级体系（非货币） - **积分获取规则**：每完成一笔订单，交易双方各获得（订单金额 * 1）的积分。 - **评级门槛（等级特权）**： - LV1-LV2（新手）：普通展示。 - LV3-LV4（熟练）：获得“金牌师傅/诚信邻居”标识，搜索结果加权排名。 - LV5（社区专家）：平台首页专题推荐，免服务佣金。 - **积分消耗**：仅用于兑换“置顶卡”或“推广曝光流量”，不可提现，确保金融合规。 --- ### 3.2 算法工程师职责：AI与匹配逻辑 #### 3.2.1 拍照识别（Computer Vision） - **输入**：用户通过APP拍摄损坏的设备整机、机身铭牌或故障部位。 - **输出**：结构化数据 —— `{ "品牌": "海尔", "型号": "XQG100-B", "品类": "滚筒洗衣机" }`。 - **异常处理**：若置信度低于80%，触发“手动输入型号”引导页，并将模糊图片存入待标注库用于模型迭代。 #### 3.2.2 智能问答与意图识别（NLP + Knowledge Graph） - **交互方式**：用户在识别结果页输入文字（如“不脱水”、“漏水”）。 - **检索逻辑**：结合识别出的型号+故障描述，在知识库（Elasticsearch）中检索最匹配的Top3维修方法。 - **降级策略**：若无完全匹配型号，则上溯至“品类通用解决方案”推荐给用户。 #### 3.2.3 LBS动态推荐排序算法 - **基础分**：距离（近者优先，限制10分钟步行阈值）。 - **动态权重**：信用评分（0.4） + 响应速度（0.3） + 历史完单率（0.3）。 - **反作弊**：拒绝距离过远或信用分低于60分的服务者在首页展示。 --- ### 3.3 技术负责人/架构师职责：技术选型与基建 #### 3.3.1 整体技术架构（从0到1） - **移动端**：Flutter（跨平台方案，保证iOS/Android UI高度一致，降低开发成本）。 - **后端架构**：微服务架构（Spring Cloud Alibaba + Nacos）。 - *服务拆分清单*：用户中心、订单中心、支付中心、消息中心、AI推理中心、爬虫管理中心。 - **数据存储**： - **MySQL**：事务型数据（用户余额、订单主表）。 - **Elasticsearch**：服务列表搜索、附近的人/服务检索（Geo查询）、维修知识库全文检索。 - **Redis**：缓存热点数据（用户Session、热门服务列表）、分布式锁。 - **文件存储**：阿里云OSS或MinIO（用于存储设备照片、聊天图片、用户头像）。 #### 3.3.2 爬虫系统设计方案（知识库构建） - **目标数据源**：品牌官网售后文档、主流家电维修论坛（如家电维修联盟）、百科类网站。 - **合规策略（红线）**： - 严格遵守目标网站的 `robots.txt` 协议。 - 设置随机的请求间隔（3-5秒），限制并发请求数，防止误伤目标服务器。 - 伪装合理的User-Agent和Referer。 - **数据清洗与结构化**： - 爬取原始数据后，利用正则表达式或NLP分词抽取四个核心字段：**【故障现象】、【解决方法】、【所需工具】、【注意事项】**。 - 清洗后的数据存入Elasticsearch向量库，供AI检索调用。 --- ### 3.4 后端开发职责：核心业务逻辑实现 #### 3.4.1 支付与分账闭环 - **对接渠道**：微信支付V3接口 + 支付宝App支付接口。 - **资金流转（担保交易）**： 1. 用户下单，支付全额至**平台微信/支付宝商户账户（冻结状态）**。 2. 服务者上门完成服务，用户在APP点击“确认验收”。 3. 平台系统调用分账接口，将金额（扣除平台5%技术服务费后）打款至服务者的商户余额/银行卡。 - **异常处理**：若用户72小时未点击“确认验收”，系统自动推送提醒；若超过7天未确认，订单自动完成并触发打款（需在协议中注明）。 #### 3.4.2 设备租赁状态记录（风控关键点） - **借用前**：必须调用相机拍照上传设备当前状态，存入订单附件。 - **归还时**：再次拍照上传。 - **争议处理**：若双方就损坏产生纠纷，客服后台调取前后两张照片对比，作为定责核心依据。 --- ### 3.5 测试/QA职责：质量红线与测试策略 #### 3.5.1 核心测试场景 - **并发与性能测试**： - 使用JMeter模拟1000个用户同时在LBS 10公里范围内搜索服务，系统响应时间需 < 2秒。 - 模拟500人同时并发下单，测试库存锁（或服务者时间排期锁）的准确性，防止“超卖/超订”。 - **支付异常测试（重中之重）**： - 模拟支付过程中断网、杀死APP进程、微信回调延迟/重复回调。 - 确保订单状态最终一致性（使用本地消息表+定时任务补偿机制），严禁出现“扣款未下单”或“下单未扣款”的资损情况。 - **AI识别容错测试**： - 输入模糊、过曝、倾斜的照片，验证系统是否能优雅降级（给出手动输入入口），而非直接报错崩溃。 --- ## 4. UI/UX 设计指引（文字草图） - **品牌调性**：温暖、亲和的橙色（#FF7E36） + 干净可靠的白色，营造邻里互助的友好感。 - **底部导航栏（4个主Tab + 1个中央按钮）**： 1. **首页**（指南推荐 + 附近服务信息流）。 2. **消息**（IM聊天列表 + 系统通知）。 3. **发布**（中央显眼的“+”号凸起按钮，点击弹出发布类型选择）。 4. **订单**（我的服务订单 / 我的租赁订单，TAB切换）。 5. **我的**（个人资料、我的积分与等级、设置）。 --- ## 5. MVP版本开发排期与里程碑 | 阶段 | 周期 | 核心交付物 | 角色分工 | | :--- | :--- | :--- | :--- | | **需求评审与UI定稿** | 3天 | PRD确认、UI设计稿交付、接口文档定义 | PM主导，全员参与评审 | | **技术选型与架构搭建** | 5天 | 数据库ER图设计、项目脚手架搭建、中间件选型 | 架构师主导，后端/算法参与 | | **核心业务并行开发** | 20天 | 发布、LBS搜索、订单流程、IM即时通讯 | 后端（业务接口） + 前端（界面交互） | | **AI模型与爬虫建设** | 15天 | 图像识别接口部署、知识库爬取与清洗（首批1万条） | 算法主导，架构师提供服务器资源支持 | | **集成测试与灰度发布** | 10天 | 全链路压测报告、核心Bug清零、内部员工灰度测试 | QA主导，全员配合修复 | | **正式上线与运维监控** | 2天 | 部署生产环境、配置监控看板（Prometheus + Grafana） | 架构师主导，后端辅助 | --- ## 6. 后续迭代方向（V2.0规划） - **语音交互**：支持语音输入故障描述，自动转为文字检索。 - **社区动态**：增加邻里互助圈（类似朋友圈），增强用户粘性。 - **保险接入**：针对贵重设备租赁（如专业工具），引入按单购买的财产意外险，降低交易摩擦。 --- **文档结束**