From 450f08d05cc0bf69e398f0568413ed559f644392 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=8F=B2=E6=82=A6?= Date: Mon, 15 Sep 2025 14:07:29 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BC=98=E5=8C=96=E4=BA=A7=E5=93=81?= =?UTF-8?q?=E9=9C=80=E6=B1=82=E6=96=87=E6=A1=A3=E5=92=8C=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E6=A8=A1=E5=9D=97=E6=96=87=E6=A1=A3=E7=BB=93=E6=9E=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 重构了产品需求文档的章节组织和内容结构 - 改进了智能功能模块的文档格式和可读性 - 优化了一键邻回收和用户故事文档的排版 - 新增了完整的规格文档模板和内容框架 - 统一了文档风格和格式规范,提升文档质量 --- 01_设计/初步设计文档.md | 170 ++++++++++---- 01_设计/后台功能模块.md | 48 ++-- 01_设计/商业计划书-绿邻回收.md | 109 +++++---- 01_设计/废品回收小程序产品需求文档.md | 271 ++++++++++++--------- 01_设计/用户故事.md | 99 ++++---- 01_设计/终端设备技术规格文档.md | 326 ++++++++++++++++++++++++++ 6 files changed, 743 insertions(+), 280 deletions(-) create mode 100644 01_设计/终端设备技术规格文档.md diff --git a/01_设计/初步设计文档.md b/01_设计/初步设计文档.md index 9c59622..2d445a8 100644 --- a/01_设计/初步设计文档.md +++ b/01_设计/初步设计文档.md @@ -58,47 +58,69 @@ ```mermaid graph TD subgraph 用户端 (User Layer) - C_MP[C端居民小程序
(uni-app / Vue.js)] - B_MP[B端小站小程序
(uni-app / Vue.js)] + C_MP[C端用户小程序
(uni-app / Vue.js)] Admin[管理后台Web
(Vue 3 + Element Plus)] + Maintenance[运维端APP
(Flutter / React Native)] + end + + subgraph 智能终端层 (Terminal Layer) + Terminal1[智能终端设备#1
(嵌入式Linux + Qt)] + Terminal2[智能终端设备#2
(嵌入式Linux + Qt)] + TerminalN[智能终端设备#N
(嵌入式Linux + Qt)] end subgraph 网关层 (API Gateway) - Gateway[API Gateway
(Nginx)] + Gateway[API Gateway
(Nginx + Load Balancer)] end subgraph 后端服务 (Backend Service) Backend[后端应用服务器
(Node.js + NestJS)] + AIService[AI识别服务
(Python + TensorFlow)] + DeviceManager[设备管理服务
(MQTT Broker)] end subgraph 数据层 (Data Layer) DB[(PostgreSQL
核心业务数据)] Cache[(Redis
缓存/会话)] + TimeSeries[(InfluxDB
设备时序数据)] end C_MP --> Gateway - B_MP --> Gateway Admin --> Gateway + Maintenance --> Gateway + Terminal1 --> DeviceManager + Terminal2 --> DeviceManager + TerminalN --> DeviceManager Gateway --> Backend + Backend --> AIService + Backend --> DeviceManager Backend --> DB Backend --> Cache + DeviceManager --> TimeSeries + AIService --> Cache ``` ### 3.2 技术选型理由 -- **前端 (uni-app + Vue)**: 一次开发,多端发布,极大提升MVP开发效率,统一技术栈。 -- **后端 (Node.js + NestJS)**: 全栈语言统一(TypeScript),架构清晰,适合企业级应用,保证代码质量和可维护性。 -- **数据库 (PostgreSQL + Redis)**: PostgreSQL功能强大,满足地理位置查询等复杂需求;Redis作为缓存,保证系统响应速度。 +- **前端 (uni-app + Vue)**: 一次开发,多端发布,极大提升MVP开发效率,C端小程序和运维端APP统一技术栈。 +- **智能终端 (嵌入式Linux + Qt)**: 稳定可靠的嵌入式系统,Qt提供良好的触屏界面开发体验,支持多媒体和网络通信。 +- **后端 (Node.js + NestJS)**: 全栈语言统一(TypeScript),微服务架构清晰,适合处理高并发的设备连接。 +- **AI服务 (Python + TensorFlow)**: 成熟的机器学习框架,支持物品识别模型的训练和推理。 +- **设备通信 (MQTT)**: 轻量级物联网协议,适合终端设备与云端的实时通信。 +- **数据库 (PostgreSQL + Redis + InfluxDB)**: PostgreSQL处理业务数据,Redis提供缓存和会话,InfluxDB专门存储设备时序数据。 ### 3.3 风险评估与应对策略 -- **技术风险**: - - **风险点**: `uni-app` 在部分低端安卓机型上可能存在性能瓶颈。 - - **应对策略**: 在开发中期,选取核心页面(如扫码、列表)进行专项性能测试,预留优化时间。 -- **团队风险**: - - **风险点**: 团队成员对 `NestJS` 或 `uni-app` 的熟练度可能不一。 - - **应对策略**: 在项目启动前安排1-2天的技术预研(Spike),统一代码规范和最佳实践。 -- **需求风险**: - - **风险点**: MVP开发期间出现重大需求变更,影响核心交付范围。 - - **应对策略**: 建立需求变更控制流程。所有需求变更需经由产品、项目、研发三方共同评估影响后,再决定是否纳入当前版本。 +- **硬件风险**: + - **风险点**: 智能终端设备的硬件稳定性和恶劣环境适应性。 + - **应对策略**: 选择工业级硬件组件,进行充分的环境测试(高温、低温、湿度、振动)。 +- **AI识别风险**: + - **风险点**: 物品识别准确率可能达不到预期,影响用户体验。 + - **应对策略**: 建立持续学习机制,收集错误样本不断优化模型;设置人工审核机制作为兜底。 +- **网络风险**: + - **风险点**: 终端设备网络不稳定导致数据传输中断。 + - **应对策略**: 实现本地数据缓存机制,支持断网重连和数据补传。 +- **成本风险**: + - **风险点**: 单台设备成本超出3000元预算,影响盈利模式。 + - **应对策略**: 严格控制硬件BOM成本,探索批量采购降本,优化设计减少不必要功能。 --- @@ -111,6 +133,7 @@ graph TD CREATE TABLE users ( id SERIAL PRIMARY KEY, wx_openid VARCHAR(255) UNIQUE NOT NULL, + phone_number VARCHAR(20) UNIQUE, nickname VARCHAR(255), avatar_url TEXT, balance DECIMAL(10, 2) NOT NULL DEFAULT 0.00, @@ -118,26 +141,33 @@ CREATE TABLE users ( updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW() ); --- 2. B端回收小站表 -CREATE TABLE stations ( +-- 2. 智能终端设备表 +CREATE TABLE terminals ( id SERIAL PRIMARY KEY, + device_code VARCHAR(100) UNIQUE NOT NULL, name VARCHAR(255) NOT NULL, address TEXT NOT NULL, location GEOGRAPHY(POINT, 4326), - manager_name VARCHAR(100), - phone_number VARCHAR(20), - status VARCHAR(20) NOT NULL DEFAULT 'active', + venue_type VARCHAR(50) NOT NULL, -- supermarket, express_station, etc. + venue_contact_name VARCHAR(100), + venue_contact_phone VARCHAR(20), + status VARCHAR(20) NOT NULL DEFAULT 'online', -- online, offline, maintenance, error + hardware_version VARCHAR(50), + software_version VARCHAR(50), + deployment_cost DECIMAL(10, 2) DEFAULT 3000.00, + deployment_date DATE, created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW() ); --- 3. 小站员工表 -CREATE TABLE staff ( +-- 3. 终端配置表 +CREATE TABLE terminal_configs ( id SERIAL PRIMARY KEY, - station_id INT NOT NULL REFERENCES stations(id), - phone_number VARCHAR(20) UNIQUE NOT NULL, - password_hash VARCHAR(255) NOT NULL, - role VARCHAR(50) NOT NULL DEFAULT 'staff', + terminal_id INT NOT NULL REFERENCES terminals(id), + bag_count INT NOT NULL DEFAULT 3, + max_weight_per_bag DECIMAL(10, 2) DEFAULT 50.00, + ai_confidence_threshold DECIMAL(3, 2) DEFAULT 0.85, + network_config JSONB, created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW() ); @@ -146,7 +176,9 @@ CREATE TABLE staff ( CREATE TABLE categories ( id SERIAL PRIMARY KEY, name VARCHAR(100) UNIQUE NOT NULL, + code VARCHAR(20) UNIQUE NOT NULL, -- bottle, paper, textile unit VARCHAR(20) NOT NULL DEFAULT 'kg', + ai_model_labels TEXT[], -- AI识别标签数组 is_active BOOLEAN NOT NULL DEFAULT TRUE, created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() ); @@ -155,20 +187,22 @@ CREATE TABLE categories ( CREATE TABLE prices ( id SERIAL PRIMARY KEY, category_id INT NOT NULL REFERENCES categories(id), - station_id INT NOT NULL REFERENCES stations(id), + terminal_id INT NOT NULL REFERENCES terminals(id), price DECIMAL(10, 2) NOT NULL, effective_date TIMESTAMPTZ NOT NULL DEFAULT NOW(), created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), - UNIQUE(category_id, station_id) + UNIQUE(category_id, terminal_id) ); -- 6. 交易记录总表 CREATE TABLE transactions ( id SERIAL PRIMARY KEY, user_id INT NOT NULL REFERENCES users(id), - station_id INT NOT NULL REFERENCES stations(id), - staff_id INT NOT NULL REFERENCES staff(id), + terminal_id INT NOT NULL REFERENCES terminals(id), total_amount DECIMAL(10, 2) NOT NULL, + payment_method VARCHAR(20) DEFAULT 'balance', -- balance, wechat_pay + ai_confidence_score DECIMAL(3, 2), + transaction_images TEXT[], -- 交易过程图片 created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() ); @@ -177,9 +211,44 @@ CREATE TABLE transaction_items ( id SERIAL PRIMARY KEY, transaction_id INT NOT NULL REFERENCES transactions(id) ON DELETE CASCADE, category_id INT NOT NULL REFERENCES categories(id), + bag_number INT NOT NULL, -- 投入的袋子编号 weight DECIMAL(10, 2) NOT NULL, price_per_unit DECIMAL(10, 2) NOT NULL, amount DECIMAL(10, 2) NOT NULL, + ai_identified_category VARCHAR(100), -- AI识别的品类 + ai_confidence DECIMAL(3, 2), -- AI置信度 + created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() +); + +-- 8. 终端状态监控表 +CREATE TABLE terminal_status ( + id SERIAL PRIMARY KEY, + terminal_id INT NOT NULL REFERENCES terminals(id), + cpu_usage DECIMAL(5, 2), + memory_usage DECIMAL(5, 2), + disk_usage DECIMAL(5, 2), + network_status VARCHAR(20), + temperature DECIMAL(5, 2), + bag_weights JSONB, -- 各袋子当前重量 {"bag1": 25.5, "bag2": 30.2} + error_codes VARCHAR(255)[], + last_heartbeat TIMESTAMPTZ, + created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() +); + +-- 9. 设备维护记录表 +CREATE TABLE maintenance_records ( + id SERIAL PRIMARY KEY, + terminal_id INT NOT NULL REFERENCES terminals(id), + maintenance_type VARCHAR(50) NOT NULL, -- routine, repair, emergency + operator_name VARCHAR(100), + operator_phone VARCHAR(20), + description TEXT, + before_images TEXT[], + after_images TEXT[], + cost DECIMAL(10, 2), + status VARCHAR(20) DEFAULT 'completed', -- pending, in_progress, completed + scheduled_at TIMESTAMPTZ, + completed_at TIMESTAMPTZ, created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() ); ``` @@ -189,28 +258,43 @@ CREATE TABLE transaction_items ( ## 5. 核心API接口设计 ### 5.1 管理后台API (`/api/admin`) +- **终端管理**: `GET, POST, PUT /terminals/:id` - **品类管理**: `GET, POST, PUT /categories/:id` -- **小站管理**: `GET, POST, PUT /stations/:id` - **价格管理**: `GET, POST /prices` -- **员工管理**: `GET, POST /staff` +- **维护管理**: `GET, POST /maintenance` +- **数据监控**: `GET /monitoring/dashboard` ### 5.2 C端小程序API (`/api/c`) - **认证**: `POST /auth/login` (微信Code换JWT) - **用户信息**: `GET /profile` - **核心功能**: - `GET /features/prices` (今日回收价) - - `GET /features/nearby-stations` (附近小站) + - `GET /features/nearby-terminals` (附近终端) - `GET /features/transactions` (交易记录) + - `GET /features/qrcode` (生成登录二维码) -### 5.3 B端小程序API (`/api/b`) -- **认证**: `POST /auth/login` (手机号密码登录) -- **回收流程**: - - `GET /recycle/user-info` (扫码识客) - - `POST /recycle/transactions` (创建交易) -- **数据查询**: - - `GET /data/summary` (今日汇总) - - `GET /data/inventory` (库存盘点) - - `GET /data/categories` (可用回收品类) +### 5.3 智能终端设备API (`/api/terminal`) +- **设备认证**: `POST /auth/device` (设备注册登录) +- **用户识别**: `POST /user/identify` (二维码/手机号识别) +- **交易流程**: + - `POST /transaction/start` (开始交易) + - `POST /transaction/weigh` (称重数据上传) + - `POST /transaction/ai-verify` (AI识别验证) + - `POST /transaction/complete` (完成交易) +- **设备状态**: + - `POST /status/heartbeat` (设备心跳) + - `POST /status/error` (错误报告) + - `GET /config` (获取设备配置) + +### 5.4 运维端API (`/api/maintenance`) +- **认证**: `POST /auth/login` (运维人员登录) +- **任务管理**: + - `GET /tasks` (获取维护任务) + - `POST /tasks/:id/start` (开始任务) + - `POST /tasks/:id/complete` (完成任务) +- **设备检测**: + - `POST /device/:id/diagnose` (设备诊断) + - `POST /device/:id/repair` (维修记录) --- diff --git a/01_设计/后台功能模块.md b/01_设计/后台功能模块.md index 34d8b6b..59522a3 100644 --- a/01_设计/后台功能模块.md +++ b/01_设计/后台功能模块.md @@ -15,25 +15,29 @@ | 一级菜单 | 二级菜单 (页面) | 功能模块 | 细节描述 | 对应PRD/用户故事 | | :--- | :--- | :--- | :--- | :--- | -| **数据中心** | **运营驾驶舱** | 核心KPI展示 | - 今日交易总额、总单数、总重量
- 活跃用户数 (DAU/MAU)
- 新增用户数 | PRD 6.1.1 | -| | | 业务数据图表 | - 各品类回收趋势图 (近7/30天)
- 各小站回收量动态排名
- 用户活跃时段分布图 | PRD 6.1.1 | -| **运营管理** | **小站管理** | 小站列表 | - 显示小站ID、名称、地址、负责人、联系电话、状态(营业/休息中/已关闭)
- 支持按名称、地址、负责人搜索
- 支持按状态筛选 | PRD 6.1.3 | -| | | 小站详情/编辑 | - **基本信息**:查看和修改名称、地址、地理位置(地图选点)、负责人、营业时间
- **员工管理**:关联/解绑小站员工账号
- **服务状态**:手动切换小站营业/休息状态
- **交易数据**:查看该小站的历史交易流水 | PRD 6.1.3, 用户故事 5.2.3 | -| | | 入驻审核 | - 查看待审核的小站申请列表
- 点击审核,可查看提交资料,并执行“通过”或“驳回”操作 | PRD 6.1.3 | -| | **品类价格管理** | 回收品类列表 | - 显示品类ID、名称、单位(如kg)、状态(启用/停用)
- 支持新增、编辑、停用品类 | PRD 6.1.4, 用户故事 6.3.2 | -| | | 价格策略配置 | - 选择一个或多个小站,为指定品类设置回收单价
- 支持批量调价和设置价格生效时间
- 可查看历史价格调整记录 | PRD 6.1.4, 用户故事 5.2.2 | -| | | 物流损耗配置 | - 为不同品类设置全局或区域性的运输损耗比例(如:纸壳损耗2%) | PRD 6.1.4, 用户故事 6.3.3 | -| **交易管理** | **订单流水** | 交易列表 | - 列表展示所有交易记录:交易ID、用户昵称、回收小站、总金额、创建时间
- 支持按交易ID、用户、小站、时间范围进行复合查询 | PRD 6.1.5, 初步设计 2. MVP | -| | | 订单详情 | - 查看单笔交易的详细信息,包括所有回收物品的品类、重量、单价、金额 | PRD 6.1.5 | -| **用户管理** | **C端用户列表** | 用户信息查询 | - 列表展示所有C端用户信息:用户ID、微信昵称、头像、账户余额、注册时间
- 支持按用户ID、昵称查询 | PRD 6.1.2 | -| | | 用户详情 | - 查看用户的基本信息、账户余额、完整的交易记录列表 | PRD 6.1.2 | -| **物流管理** | **揽收任务** | 任务列表 | - 查看所有物流任务:任务ID、状态(待揽收/运输中/已入库)、司机、关联小站、创建时间
- 支持按状态、司机、小站筛选 | PRD 6.1.6, V1.1规划 | -| | | 任务详情 | - 查看任务包含的所有待交接的品类和重量信息,以及实际交接的记录 | PRD 6.1.6, V1.1规划 | -| | | 司机管理 | - 管理物流司机信息(姓名、联系方式、关联车辆) | PRD 6.1.6, V1.1规划 | -| **财务管理** | **结算管理** | 对账单 | - 生成与小站、物流司机的周期性结算账单
- 账单需清晰列出所有明细,并扣除平台服务费/损耗 | PRD 6.1.7, V1.2规划 | -| | | 提现审批 | - (若C端提现需人工审核)处理C端用户的提现申请 | PRD 3.1.3 (V1.1) | -| | | 账单导出 | - 支持将结算账单导出为Excel格式 | PRD 6.1.7 | -| **系统管理** | **角色与权限** | 角色管理 | - 创建、编辑后台角色(如:运营、财务、客服)
- 为角色分配不同的菜单和操作权限(增删改查) | PRD 6.1.8 | -| | | 账号管理 | - 创建后台操作员账号,并为其分配角色 | PRD 6.1.8 | -| | **系统监控** | 登录日志 | - 查看所有后台账号的登录历史记录,包括登录IP、时间、设备信息 | PRD 6.1.8 | -| | | 报警中心 | - 集中展示系统产生的各类业务异常报警(库存预警、交易异常、API错误)
- 支持查看报警详情、标记处理状态、记录处理过程 | PRD 6.1.9, 用户故事 6.3.4 | +| **数据中心** | **运营驾驶舱** | 核心KPI展示 | - 今日交易总额、总单数、总重量
- 活跃用户数 (DAU/MAU)
- 在线设备数/故障设备数
- 设备利用率和平均交易频次 | PRD 7.1.1 | +| | | 实时监控大屏 | - 地图展示所有终端位置和状态
- 各终端实时交易数据
- 设备健康状态色彩编码
- 异常设备实时告警 | PRD 7.1.1, 用户故事 4.2.1 | +| **设备管理** | **终端设备列表** | 设备信息管理 | - 显示设备编号、名称、地址、场地方信息、运行状态
- 支持按设备编号、地址、状态搜索
- 设备部署成本和投资回收期显示 | PRD 7.1.2 | +| | | 设备详情/编辑 | - **基本信息**:设备编号、位置、场地方联系方式
- **硬件配置**:袋子数量、最大承重、AI识别阈值
- **运行状态**:在线/离线/故障/维护中
- **交易数据**:该设备的历史交易流水和收益分析 | PRD 7.1.2 | +| | | 设备部署管理 | - 新设备入网配置和参数设置
- 设备软件版本管理和远程更新
- 设备网络配置和连接状态监控 | PRD 7.1.2 | +| | **设备监控** | 实时状态监控 | - 各设备CPU、内存、存储使用率
- 网络连接状态和数据传输质量
- 各袋子实时重量和容量预警
- 设备温度和环境监控 | PRD 7.1.2, 用户故事 4.2.1 | +| | | 故障预警系统 | - AI预测设备故障风险
- 自动生成维护提醒
- 故障类型统计和趋势分析 | PRD 7.1.9, 用户故事 4.2.2 | +| **运营管理** | **品类价格管理** | 回收品类列表 | - 显示品类ID、名称、代码、单位、AI识别标签
- 支持新增、编辑、停用品类
- AI识别模型标签配置 | PRD 7.1.4 | +| | | 价格策略配置 | - 选择一个或多个终端,为指定品类设置回收单价
- 支持批量调价和设置价格生效时间
- 可查看历史价格调整记录和市场价格对比 | PRD 7.1.4 | +| | | AI识别配置 | - 设置不同品类的AI识别置信度阈值
- 上传训练样本和错误样本管理
- 模型识别准确率统计和优化建议 | PRD 7.1.4 | +| **交易管理** | **订单流水** | 交易列表 | - 列表展示所有交易记录:交易ID、用户昵称、终端设备、总金额、AI置信度、创建时间
- 支持按交易ID、用户、设备、时间范围进行复合查询 | PRD 7.1.5 | +| | | 订单详情 | - 查看单笔交易的详细信息,包括所有回收物品的品类、重量、单价、金额
- 显示AI识别结果和置信度
- 交易过程图片查看 | PRD 7.1.5 | +| | | 异常交易处理 | - 低置信度交易人工审核
- 用户投诉处理和退款管理
- 异常交易模式分析 | PRD 7.1.5 | +| **用户管理** | **C端用户列表** | 用户信息查询 | - 列表展示所有C端用户信息:用户ID、微信昵称、手机号、账户余额、注册时间
- 用户行为分析:常用设备、交易频次、偏好品类 | PRD 7.1.3 | +| | | 用户详情 | - 查看用户的基本信息、账户余额、完整的交易记录列表
- 用户设备使用热力图和行为轨迹 | PRD 7.1.3 | +| **运维管理** | **维护任务** | 任务列表 | - 查看所有运维任务:任务ID、类型(巡检/维修/清运)、设备、运维人员、状态
- 支持按任务类型、状态、设备筛选 | PRD 7.1.6 | +| | | 任务详情 | - 查看任务的详细信息、维修记录、更换备件
- 维修前后照片对比
- 维修成本和时长统计 | PRD 7.1.6 | +| | | 运维人员管理 | - 管理运维工程师信息(姓名、联系方式、技能等级、负责区域) | PRD 7.1.6 | +| | **库存清运** | 清运计划 | - 基于设备容量自动生成清运计划
- 最优路线规划和运输成本计算
- 清运记录和重量核对 | PRD 7.1.5 | +| **财务管理** | **结算管理** | 对账单 | - 生成与场地方、运维团队的周期性结算账单
- 设备投资成本分摊和回收期计算
- 账单需清晰列出所有明细和分润比例 | PRD 7.1.7 | +| | | 成本分析 | - 单台设备成本构成分析
- 运营成本趋势和优化建议
- ROI计算和盈利预测 | PRD 7.1.7 | +| | | 提现审批 | - (若C端提现需人工审核)处理C端用户的提现申请 | PRD 4.1.4 | +| **系统管理** | **角色与权限** | 角色管理 | - 创建、编辑后台角色(如:运营、技术、财务、客服)
- 为角色分配不同的菜单和操作权限(增删改查) | PRD 7.1.8 | +| | | 账号管理 | - 创建后台操作员账号,并为其分配角色
- 设备访问权限管理 | PRD 7.1.8 | +| | **智能监控** | 系统日志 | - 查看所有后台账号的登录历史记录、设备操作日志
- 异常操作行为分析和告警 | PRD 7.1.8 | +| | | 智能报警中心 | - 集中展示设备故障、容量预警、交易异常、网络中断等告警
- AI辅助故障诊断和处理建议
- 告警处理流程跟踪和效果评估 | PRD 7.1.9 | diff --git a/01_设计/商业计划书-绿邻回收.md b/01_设计/商业计划书-绿邻回收.md index a7010fe..7194abc 100644 --- a/01_设计/商业计划书-绿邻回收.md +++ b/01_设计/商业计划书-绿邻回收.md @@ -5,9 +5,9 @@ ## 1. 执行摘要 (Executive Summary) -**绿邻回收**是一个旨在革新城市社区废品回收模式的环保科技项目。我们通过构建一个以微信小程序为载体,连接居民、社区小站和回收产业链的超便捷回收网络,解决当前城市废品回收中存在的“最后一公里”难题。 +**绿邻回收**是一个旨在革新城市社区废品回收模式的环保科技项目。我们通过在各大超市、快递门口部署智能回收终端,结合微信小程序后台管理系统,打造一个全自动化、高效透明的废品回收网络,解决当前城市废品回收中存在的"最后一公里"难题。 -我们的核心业务是,用户(特别是中老年人)可以方便地将家中的可回收废品(初期聚焦于塑料瓶、纸壳、旧衣物)送到楼下的合作小站(如超市、快递驿站),通过一个极其简单的“适老化”小程序进行称重、计价,并立即获得现金或兑换商品。小站的废品将由我们的物流体系每日归集到城市中心仓,再统一销售给大型打包站,从而形成一个高效、透明、共赢的商业闭环。 +我们的核心产品是智能回收终端设备,配备1-3个回收袋用于分类收集饮料瓶、废纸、织物等可回收物品,通过AI摄像头自动识别监控回收物品,平板电脑显示重量和操作界面,整个系统由坚固的铝合金骨架组合而成。用户只需将废品投入对应的回收袋,系统自动称重计价,通过简单的身份识别即可完成交易,实现真正的无人值守智能回收。 本项目致力于通过技术手段和创新的运营模式,提升回收效率,改善用户体验,为环保事业贡献力量,并创造可观的经济价值。 @@ -55,57 +55,59 @@ ## 4. 产品与服务 (Product and Service) -### 4.1 核心载体:微信小程序 -分为两个端:用户端和小站端。 +### 4.1 核心产品:智能回收终端 +我们的核心产品是部署在各大超市、快递门口的智能回收终端设备。 -- **用户端**: - - **核心功能**: 查看附近小站、回收价格公示、个人账户(交易记录、余额)。 - - **“适老化”设计**: 超大字体、语音播报、极简流程、无需复杂注册。 +- **硬件组成**: + - **分类回收袋**: 1-3个可配置回收袋,用于分类收集饮料瓶、废纸、织物等不同品类 + - **AI视觉监控**: 高清摄像头实时监控回收物品,确保分类正确性和防止异物投入 + - **智能称重**: 精准称重传感器,实时显示重量和计算价格 + - **交互平板**: 用户友好的触摸屏界面,支持身份识别、重量显示、交易确认 + - **结构骨架**: 坚固的铝合金框架,确保设备稳定性和防护性能 -- **小站端**: - - **核心功能**: 扫码识别用户、称重品类录入、自动计价、结算(现金/兑换)、当日汇总。 - - **设计理念**: 操作直观,功能聚焦,稳定可靠。 +- **软件系统**: + - **用户端微信小程序**: 查看附近终端、回收价格公示、个人账户管理 + - **终端操作系统**: 支持多种身份识别方式,自动称重计价,实时数据上传 + - **后台管理系统**: 远程监控终端状态、数据统计分析、故障预警 ### 4.2 业务流程 -这是一个完整的闭环系统,从居民到最终的打包站。 +这是一个基于智能终端的完整闭环系统,从居民到最终的打包站。 ``` mermaid graph TD subgraph 用户端 - A[居民在家整理废品] --> B{下楼前往小站}; + A[居民在家整理废品] --> B[前往超市/快递门口终端]; end - subgraph 小站 - B --> C[站长使用小程序称重]; - C --> D[系统自动计算价格]; - D --> E{选择结算方式}; - E --> F[获得现金/兑换商品]; - E --> G[积分存入账户]; - F --> H[完成回收]; - G --> H; - C --> I[废品暂存小站]; + subgraph 智能终端 + B --> C[用户身份识别登录]; + C --> D[选择回收品类投入对应袋子]; + D --> E[AI摄像头监控验证物品]; + E --> F[系统自动称重计价]; + F --> G[用户确认交易]; + G --> H[积分/现金到账]; + H --> I[废品自动存储在终端]; end subgraph 物流与仓储 - I --> J(每日由专人从小站收集); - J --> K[转运至邻近小仓]; - K --> L(专车每日从小仓归集); - L --> M[送达城市大仓]; - M --> N[分类、压缩、存储]; + I --> J[终端满载自动预警]; + J --> K[物流团队定期清运]; + K --> L[运输至城市大仓]; + L --> M[分类、压缩、存储]; end subgraph 供应链末端 - N --> O(定期从大仓转运); - O --> P[销售给大型打包站]; + M --> N[定期从大仓转运]; + N --> O[销售给大型打包站]; end - P --> |资金回流| Q((分润体系)); + O --> |资金回流| P((分润体系)); subgraph 收益分配 - Q --> |利润| CEO/公司; - Q --> |服务费| B端小站; - Q --> |回收金| A; - Q --> |工资/运费| 物流与仓储; + P --> |利润| 公司运营; + P --> |场地费| 超市/快递站; + P --> |回收金| A; + P --> |运维成本| 设备维护; end ``` @@ -143,11 +145,12 @@ graph TD ## 7. 财务规划 (Financial Plan) ### 7.1 成本结构 (Cost Structure) -- **技术开发成本**: 小程序开发、服务器、数据库等。 -- **人力成本**: 核心团队、线下运营及物流人员的工资。 -- **营销成本**: 地推活动、物料制作费用。 -- **运营成本**: 仓储租金、运输车辆油耗及维护。 +- **设备成本**: 每个终端设备约2500元(包含摄像头、平板、称重传感器、铝合金骨架、组装调试) +- **部署成本**: 每个站点部署费用约300元(包含运输、安装、调试、培训) +- **运维成本**: 每个站点月运维成本约200元(包含设备维护、软件更新、故障处理) +- **技术开发成本**: 软件系统开发、云服务器、数据库等。 - **给用户的回收金**: 支付给用户的废品费用。 +- **总投入**: 每个站点总投入成本约3000元,实现一期自循环目标。 ### 7.2 收入来源 (Revenue Streams) - **核心收入**: 将从大仓集中处理后的可回收物,以更高的价格批量出售给大型打包站或处理厂,赚取其中的差价。 @@ -165,21 +168,25 @@ graph TD ```mermaid sequenceDiagram participant User as 用户 - participant Station as 小站端小程序 + participant Terminal as 智能终端 + participant Camera as AI摄像头 participant Server as 后端服务器 User->>User: 在家整理好废品 - User->>Station: 带着废品到楼下小站 - Station->>User: 站长:欢迎,请出示您的手机号/会员码 - User->>Station: (提供手机号后4位) - Station->>Server: 查询用户信息 (手机号:xxxx) - Server-->>Station: 返回用户信息 - Station->>Station: 站长选择品类(纸壳),放置上称 - Station->>Server: 上传数据(用户ID, 品类:纸壳, 重量:2.5kg) - Server-->>Station: 返回计算价格(3.75元) - Station->>User: 站长:一共3块7毛5,您要现金还是换东西? - User->>Station: 就要现金吧 - Station->>Server: 确认交易(用户ID, 金额:3.75, 方式:现金) - Server-->>Station: 交易成功 - Station->>User: (支付现金)好了,欢迎下次再来! + User->>Terminal: 前往超市/快递门口的智能终端 + Terminal->>User: 显示欢迎界面,请选择登录方式 + User->>Terminal: 手机号/扫码/刷卡登录 + Terminal->>Server: 验证用户身份 + Server-->>Terminal: 返回用户信息 + Terminal->>User: 显示用户昵称,请选择回收品类 + User->>Terminal: 选择"废纸"并投入对应袋子 + Camera->>Terminal: AI识别确认是废纸类物品 + Terminal->>Terminal: 自动称重 (2.5kg) + Terminal->>Server: 上传数据(用户ID, 品类:废纸, 重量:2.5kg) + Server-->>Terminal: 返回计算价格(3.75元) + Terminal->>User: 显示"废纸2.5kg,价值3.75元,确认交易吗?" + User->>Terminal: 点击确认 + Terminal->>Server: 确认交易(用户ID, 金额:3.75) + Server-->>Terminal: 交易成功 + Terminal->>User: 语音播报"交易成功,获得3.75元"并显示交易完成界面 ``` diff --git a/01_设计/废品回收小程序产品需求文档.md b/01_设计/废品回收小程序产品需求文档.md index c86022c..e4ae3ea 100644 --- a/01_设计/废品回收小程序产品需求文档.md +++ b/01_设计/废品回收小程序产品需求文档.md @@ -30,19 +30,20 @@ ### 1.3 项目目标 - **V1.0 (MVP) 目标**: - - 验证核心商业模式:居民到小站的回收流程。 - - 在1-2个试点社区,实现每周100+笔交易。 - - C端用户次月留存率达到30%,B端小站无主动流失。 + - 验证智能终端的核心商业模式:无人值守自动回收。 + - 部署10-15台终端设备,实现每周200+笔交易。 + - 单台设备日均交易量达到15笔,用户重复使用率达到40%。 + - 实现每台设备3000元投入成本的自循环盈利模式。 ### 1.4 核心用户画像 -- **C端 - 居民**: - - **王大妈**: 65岁,退休在家,对价格敏感,会用微信但对复杂操作有困难。希望卖废品能像去超市买菜一样简单。 -- **B端 - 小站站长**: - - **李老板**: 45岁,社区超市店主。希望回收操作不影响主业,记账清晰,能快速和上游完成交接结算。 -- **物流端 - 司机**: - - **张师傅**: 35岁,回收车队司机。希望能有清晰的揽收路线,交接时不用手写单据,扫个码就能搞定。 -- **后台 - 运营经理**: - - **小陈**: 28岁,公司运营。希望实时看到各小站的回收数据,能灵活调整回收品类和价格。 +- **C端 - 居民用户**: + - **王大妈**: 65岁,退休在家,对价格敏感,希望24小时随时能卖废品,操作要像ATM一样简单直观。 + - **小张**: 30岁,上班族,希望下班路过超市时能快速处理家里的快递纸箱,不用排队等人工服务。 +- **B端 - 场地方**: + - **超市老板**: 希望终端设备不占用过多空间,不影响正常营业,还能获得稳定的场地租金收入。 + - **快递站点**: 希望设备能吸引更多客流,带动快递业务,增加额外收入来源。 +- **运营端 - 设备管理员**: + - **小陈**: 28岁,负责终端设备的远程监控、故障处理、定期清运等运维工作。 --- @@ -50,166 +51,202 @@ ```mermaid graph TD - subgraph C端用户 - A[1.居民携带废品到小站] --> B{2.出示个人收款码}; + subgraph 用户端 + A[1.居民携带废品到终端] --> B[2.终端屏幕身份识别]; end - subgraph B端用户 - B --> C[3.站长扫码识别用户]; - C --> D[4.选择品类, 输入重量]; - D --> E[5.确认金额, 完成交易]; - E --> F((资金计入用户余额)); - E --> G[6.定期向上游发起交接]; + subgraph 智能终端 + B --> C[3.选择回收品类]; + C --> D[4.投入对应回收袋]; + D --> E[5.AI摄像头识别验证]; + E --> F[6.自动称重计价]; + F --> G[7.用户确认交易]; + G --> H((资金计入用户余额)); + G --> I[8.废品存储在终端]; end - subgraph 物流端 - G --> H[7.司机接单, 前往小站]; - H --> I[8.扫小站出库码, 核对品类重量]; - I --> J[9.确认揽收, 运输至打包站]; + subgraph 后台监控 + I --> J[9.终端容量监控]; + J --> K{是否达到清运阈值?}; + K -->|是| L[10.自动派发清运任务]; + K -->|否| M[继续接收废品]; + end + + subgraph 物流清运 + L --> N[11.物流团队接收任务]; + N --> O[12.前往终端清运]; + O --> P[13.运输至处理中心]; end subgraph 管理后台 - K[品类/价格管理] --> D; - F --> L[订单流水监控]; - G --> M[库存数据监控]; - I --> N[物流状态跟踪]; - J --> O[财务结算管理]; + Q[终端设备管理] --> C; + R[品类/价格管理] --> F; + H --> S[交易流水监控]; + I --> T[库存状态监控]; + L --> U[物流任务管理]; + P --> V[财务结算管理]; end ``` --- -## 3. C端(居民端)小程序 +## 3. 智能终端系统 -**核心定位:让卖废品像收钱一样简单。** +**核心定位:24小时无人值守的智能回收站。** -### 3.1 功能模块详述 +### 3.1 硬件组成详述 -#### 3.1.1 登录/注册 -- **需求**: 微信一键授权登录,自动创建账户,无需额外注册步骤。 +#### 3.1.1 回收袋模块 +- **配置**: 1-3个可配置回收袋,根据场地大小和回收品类需求调整 +- **分类**: 饮料瓶袋、废纸袋、织物袋,每个袋子有独立的称重传感器 +- **容量**: 每个袋子设计容量约50-80升,支持自动容量检测 -#### 3.1.2 首页 (核心页面) -- **界面元素**: - 1. **【我的卖品码】**: 页面最中心、最大的按钮,点击后全屏显示个人专属二维码,并调高屏幕亮度。 - 2. **【附近小站】**: 列表或地图形式,展示附近合作小站的位置、**实时营业状态(营业中/休息中)、距离我有多远**、联系电话。 - 3. **【今日回收价】**: 醒目位置展示主要品类(纸壳、塑料瓶等)的单价(元/斤)。 +#### 3.1.2 AI视觉监控 +- **摄像头**: 高清摄像头,支持物品识别和分类验证 +- **功能**: 实时监控投入物品,防止异物污染,记录投入过程 +- **AI算法**: 基于深度学习的物品分类识别,准确率>95% -#### 3.1.3 “我的”页面 -- **界面元素**: - 1. **【我的余额】**: 突出显示当前账户余额。 - 2. **【提现】(V1.1)**: 将余额提现至微信零钱。需进行实名认证。 - 3. **【交易记录】**: 列表形式,展示每一笔交易的时间、地点、品类、重量、金额。 - 4. **【联系客服】**: 提供客服电话或在线咨询入口。 +#### 3.1.3 交互平板系统 +- **规格**: 10-12寸触摸屏,支持多点触控 +- **功能**: 用户身份识别、操作引导、重量显示、交易确认 +- **登录方式**: 支持手机号、二维码扫描、NFC卡片等多种方式 -#### 3.1.4 消息通知 -- **需求**: - - 交易成功后,收到模板消息推送,告知本次收入金额。 - - 提现成功后,收到模板消息推送。 +#### 3.1.4 结构骨架 +- **材料**: 铝合金框架,具备防水、防盗、耐候性能 +- **设计**: 模块化设计,便于运输安装和维护 +- **安全**: 配备防撬锁、振动报警等安全措施 + +### 3.2 软件系统详述 + +#### 3.2.1 终端操作系统 +- **界面**: 适老化设计,大字体、高对比度、语音引导 +- **流程**: 登录→选择品类→投入物品→AI验证→称重计价→确认交易 +- **离线**: 支持网络断开时的离线操作和数据缓存 + +#### 3.2.2 数据采集与上传 +- **实时数据**: 称重数据、交易记录、设备状态、故障信息 +- **定时上传**: 每10分钟向后台上传一次数据 +- **异常报警**: 设备故障、满载、异常操作自动报警 --- -## 4. B端(小站端)小程序 +## 4. C端(用户端)小程序 -**核心定位:高效的移动回收工作站。** +**核心定位:便捷的个人回收助手。** ### 4.1 功能模块详述 -#### 4.1.1 登录 -- **需求**: 由管理员在后台创建账号,站长通过“手机号+验证码”登录。 +#### 4.1.1 登录/注册 +- **需求**: 微信一键授权登录,自动创建账户,无需额外注册步骤。 +- **支持**: 同时支持手机号快速注册,便于在终端设备上使用。 -#### 4.1.2 工作台 (首页) +#### 4.1.2 首页 (核心页面) - **界面元素**: - 1. **【开始回收】**: 核心操作按钮,点击进入扫码回收流程。 - 2. **【今日汇总】**: 数据卡片,展示当日回收总单数、总重量、总金额。 - 3. **【库存盘点】**: 查看当前各类废品的库存重量。**当库存达到预警阈值时,系统应有明显提示。** - 4. **【向上游交接】**: 生成出库单,**一键通知物流团队上门揽收**,并出示出库二维码。 + 1. **【附近终端】**: 地图或列表形式,展示附近智能终端的位置、设备状态(正常/故障/满载)、距离。 + 2. **【今日回收价】**: 醒目位置展示主要品类(饮料瓶、废纸、织物)的实时单价。 + 3. **【快速回收】**: 一键跳转到最近的可用终端,并生成二维码用于终端登录。 + 4. **【我的余额】**: 显示当前账户余额和今日收入。 -#### 4.1.3 回收流程 (核心业务) -1. **扫码识客**: 点击“开始回收”,启动扫码器,扫描C端用户的“卖品码”。成功后显示用户昵称。 -2. **录入信息**: - - **品类选择**: 大按钮形式选择“纸壳”、“塑料瓶”等。 - - **重量输入**: 手动输入称重后的重量。 - - 系统自动计算金额并显示。 -3. **确认交易**: 与用户核对无误后,点击“确认”。系统二次弹窗确认。 -4. **语音播报**: 交易成功后,必须有清晰的语音播报,如“**收款成功,5.8元**”,方便老年用户确认。 +#### 4.1.3 终端交互功能 +- **二维码登录**: 生成个人专属二维码,用于在终端设备上快速登录。 +- **交易确认**: 接收终端发送的交易确认通知,可在手机上再次确认。 +- **实时反馈**: 显示正在进行的交易状态,包括称重、计价过程。 -#### 4.1.4 账单与库存 -- **账单**: 查看每日、每周的交易流水和收入汇总。 -- **库存**: 实时查看各品类库存,达到阈值时有提醒。 +#### 4.1.4 "我的"页面 +- **界面元素**: + 1. **【我的余额】**: 突出显示当前账户余额和累计收入。 + 2. **【提现】**: 将余额提现至微信零钱,支持实名认证。 + 3. **【交易记录】**: 列表形式,展示每一笔交易的时间、终端位置、品类、重量、金额。 + 4. **【设备反馈】**: 用户可对使用过的终端设备进行评价和故障反馈。 + +#### 4.1.5 消息通知 +- **需求**: + - 交易成功后,收到模板消息推送,告知本次收入金额。 + - 提现成功后,收到模板消息推送。 + - 设备故障或维护通知推送。 --- -## 5. 物流端 (打包站/司机端) +## 5. 运维端 (设备维护) -**核心定位:精准、高效的废品“快递员”。** (初期可为H5页面,或集成在B端小程序中) +**核心定位:智能终端的"医生",确保设备正常运行。** ### 5.1 功能模块详述 -#### 5.1.1 揽收任务 -- **需求**: 查看由系统(或后台运营)派发的揽收任务列表,包含小站地址、预计揽收重量、联系方式。 -- **功能**: 支持路线规划。 +#### 5.1.1 设备巡检任务 +- **需求**: 查看系统自动生成的巡检任务列表,包含终端位置、巡检类型(定期保养/故障维修/清运)、预计时间。 +- **功能**: 支持路线规划,优化巡检效率。 -#### 5.1.2 扫码交接 -- **需求**: 到达小站后,扫描小站端生成的“出库码”。 -- **流程**: 扫码后,页面显示待交接的品类和重量。司机确认实际收到的重量,可进行修改。双方确认后,完成交接。 +#### 5.1.2 设备状态检测 +- **需求**: 到达终端后,通过手机APP连接设备进行状态检测。 +- **流程**: 检测各硬件模块(摄像头、称重、屏幕、网络)状态,记录检测结果。 +- **报告**: 自动生成巡检报告,上传设备照片和维修记录。 -#### 5.1.3 状态更新 -- **需求**: 可手动更新任务状态,如“运输中”、“已入库”。 +#### 5.1.3 清运管理 +- **需求**: 根据终端容量预警,及时清运回收物品。 +- **流程**: 扫描终端二维码,查看各品类存储量,记录清运重量,更新库存状态。 + +#### 5.1.4 故障处理 +- **需求**: 接收设备故障报警,快速响应维修。 +- **功能**: 常见故障诊断指导,备件管理,维修记录。 --- -## 6. 大仓管理端 (Web/PC) +## 6. 数据中心 (Web/PC) -**核心定位:业务流转的仓储枢纽,数据准确性的最终保障。** +**核心定位:智能终端网络的"大脑",提供数据驱动的决策支持。** ### 6.1 功能模块详述 -#### 6.1.1 扫码确认入库 -- **需求**: 司机运抵大仓后,仓管员扫描司机任务单(或出库单)上的二维码。 -- **流程**: 系统自动带出司机、来源小站、货品品类及重量等信息。仓管员核对实物后确认,完成入库操作。库存数据自动更新。 +#### 6.1.1 实时监控大屏 +- **需求**: 在PC端或数据大屏上,实时显示所有终端的运行状态、交易数据、库存情况。 +- **可视化**: 地图展示终端分布,状态色彩编码(绿色正常/黄色预警/红色故障)。 +- **告警**: 设备故障、满载、异常操作实时告警。 -#### 6.1.2 实时库存监控 -- **需求**: 在PC端或数据大屏上,以可视化图表展示所有品类的实时库存量、库存周转天数、存放位置等。 -- **目标**: 为仓储规划和销售决策提供数据支持。 +#### 6.1.2 数据分析中心 +- **需求**: 提供深度数据分析,包括用户行为分析、设备效率分析、收益分析等。 +- **报表**: 自动生成日报、周报、月报,支持数据导出。 +- **预测**: 基于历史数据预测设备维护需求、清运时间等。 -#### 6.1.3 出库管理 -- **需求**: 当与下游回收商(如打包站)达成交易后,可在系统中选择品类和重量,一键生成标准化的出库单。 -- **凭证**: 出库单可打印,作为与下游结算和备货的依据。 +#### 6.1.3 库存汇总管理 +- **需求**: 汇总所有终端的库存数据,为集中清运和销售提供决策支持。 +- **功能**: 库存预警、最优清运路线规划、销售时机建议。 --- ## 7. 统一管理后台 (Web端) -**核心定位:公司的“大脑”,驱动业务运转。** +**核心定位:智能终端网络的"指挥中心",驱动业务运转。** -### 6.1 功能模块详述 +### 7.1 功能模块详述 -#### 6.1.1 Dashboard 数据看板 -- **需求**: 实时展示核心KPI,如:今日交易额、活跃用户数、**各小站回收量排名**、各品类回收趋势图等,形成数据驾驶舱。 +#### 7.1.1 Dashboard 数据看板 +- **需求**: 实时展示核心KPI,如:今日交易额、活跃用户数、**各终端设备回收量排名**、各品类回收趋势图、设备在线率等。 -#### 6.1.2 用户管理 -- **需求**: 查询C端用户信息、交易记录、账户状态。 +#### 7.1.2 终端设备管理 +- **需求**: 设备的入网配置、信息管理(**设备编号、地理位置、场地方信息、运行状态**)、地理位置分布图、设备状态监控。 +- **功能**: 远程设备重启、参数配置、软件更新推送。 -#### 6.1.3 小站管理 -- **需求**: 小站的入驻审核、信息管理(**名称、地址、地理位置、负责人、营业时间**)、地理位置分布图、服务状态(营业/休息)管理。 +#### 7.1.3 用户管理 +- **需求**: 查询C端用户信息、交易记录、账户状态、使用习惯分析。 -#### 6.1.4 品类与价格管理 -- **需求**: 动态添加/修改/停用回收品类,实时调整各品类在不同区域或站点的回收单价。**支持设置不同品类的物流损耗参数。** +#### 7.1.4 品类与价格管理 +- **需求**: 动态添加/修改/停用回收品类,实时调整各品类在不同区域或终端的回收单价。**支持设置不同品类的AI识别阈值参数。** -#### 6.1.5 订单与库存管理 -- **需求**: 查询全平台所有交易流水。实时监控各小站、各打包站的库存情况。 +#### 7.1.5 交易与库存管理 +- **需求**: 查询全平台所有交易流水。实时监控各终端设备的库存情况,自动生成清运计划。 -#### 6.1.6 物流管理 -- **需求**: 查看物流司机信息,手动派发或调整揽收任务,跟踪任务状态。 +#### 7.1.6 运维管理 +- **需求**: 查看运维人员信息,手动派发或调整巡检任务,跟踪设备维护状态。 -#### 6.1.7 财务管理 -- **需求**: 管理与小站、物流司机的结算周期和账单,支持账单导出。 +#### 7.1.7 财务管理 +- **需求**: 管理与场地方、运维团队的结算周期和账单,支持成本分析和收益计算。 -#### 6.1.8 系统管理 -- **需求**: 后台操作员的角色与权限管理。**对异常登录行为进行告警**。 +#### 7.1.8 系统管理 +- **需求**: 后台操作员的角色与权限管理。**对异常登录行为和设备异常操作进行告警**。 -#### 6.1.9 报警中心 -- **需求**: 集中查看和处理系统产生的各类业务异常报警(如库存异常、交易异常、物流延误),记录处理过程与结果,并支持上报给相关负责人。 +#### 7.1.9 智能报警中心 +- **需求**: 集中查看和处理系统产生的各类异常报警(设备故障、容量预警、交易异常、网络中断),AI辅助诊断问题原因。 --- @@ -229,16 +266,16 @@ graph TD ## 9. 版本迭代规划 (Roadmap) - **V1.0 (MVP)**: - - 核心功能: C端 + B端核心回收流程、管理后台基础框架(品类价格、订单查看)。 - - 目标: 跑通“居民->小站”核心商业模式闭环。 + - 核心功能: 智能终端硬件系统、C端小程序、基础管理后台(设备监控、品类价格、订单查看)。 + - 目标: 跑通"用户->智能终端"无人值守回收模式,验证3000元/台设备的自循环盈利。 - **V1.1**: - - 新增功能: 物流端H5、后台物流管理、后台小站管理、C端提现功能。 - - 目标: 引入物流角色,实现“小站->大仓”规范化清运。 + - 新增功能: 运维端APP、设备远程诊断、AI识别算法优化、C端提现功能。 + - 目标: 完善设备运维体系,提升设备稳定性和识别准确率。 - **V1.2**: - - 新增功能: 大仓管理模块、后台财务结算模块、数据报表优化。 - - 目标: 完善全链路管理,提升运营和财务效率。 + - 新增功能: 数据分析中心、智能清运调度、财务自动结算、设备健康管理。 + - 目标: 实现数据驱动运营,提升运营效率和设备利用率。 - **V1.3**: - - 新增功能: C端积分商城、精细化运营工具(如用户分层、活动配置)。 - - 目标: 探索增值服务,提升用户粘性。 + - 新增功能: 积分商城、社区互动、碳积分系统、多品类扩展(电子垃圾等)。 + - 目标: 构建环保生态圈,探索更多盈利模式。 diff --git a/01_设计/用户故事.md b/01_设计/用户故事.md index e6fd27d..fd41704 100644 --- a/01_设计/用户故事.md +++ b/01_设计/用户故事.md @@ -15,25 +15,25 @@ ### 1.2. 用户故事 -#### **故事1:查看回收价格** +#### **故事1:查看回收价格和终端位置** - **作为** 王大妈, -- **我想要** 在出门前就能通过小程序看到今天纸壳子、塑料瓶卖多少钱一斤, -- **以便于** 我决定今天是否值得跑一趟,并且心里有底,不怕被坑。 +- **我想要** 在出门前就能通过小程序看到今天各种废品的回收价格,以及最近的智能终端在哪里、是否正常运行, +- **以便于** 我决定今天是否值得跑一趟,并且选择最方便的终端设备。 -#### **故事2:找到最近的回收站** -- **作为** 刚搬来小区的年轻人小张, -- **我想要** 在小程序上用地图直接看到最近的回收站在哪,离我有多远,现在是否在营业, -- **以便于** 我能快速方便地处理掉家里堆积的快递纸箱。 +#### **故事2:24小时随时回收** +- **作为** 上班族小张, +- **我想要** 下班后或周末任何时间都能使用智能终端处理家里的快递纸箱,不受营业时间限制, +- **以便于** 我能根据自己的时间安排处理废品,不用专门请假或赶时间。 -#### **故事3:极速卖品** +#### **故事3:全自动回收体验** - **作为** 王大妈, -- **我想要** 到小站后,让站长扫一下我的手机二维码,他称重、确认后,钱就能马上到我的小程序账户里,并且能听到“收款成功,5块8”这样的语音提醒, -- **以便于** 整个过程像在超市用付款码一样简单,不用我输密码、点确认,甚至不用掏手机看,听声音就知道交易成功了,非常安心。 +- **我想要** 在智能终端上用手机号登录后,按照屏幕提示选择废纸类型,把纸箱投入对应袋子,系统自动称重计价并语音播报"收款成功,5块8毛", +- **以便于** 整个过程像使用ATM一样简单,不需要等人服务,也不用担心被骗秤或算错账。 -#### **故事4:查看我的收入** +#### **故事4:实时了解收益** - **作为** 王大妈, -- **我想要** 在“我的”页面清楚地看到我的账户里还有多少钱,并且能翻看每一笔卖废品的记录, -- **以便于** 我知道这个月靠卖废品攒了多少零花钱,感觉很有成就感。 +- **我想要** 在手机小程序里实时看到交易完成的通知,查看我的账户余额变化和每笔交易的详细记录, +- **以便于** 我知道这个月通过智能终端攒了多少零花钱,对这种新方式更有信心。 --- @@ -71,59 +71,64 @@ --- -## 角色三:下站运输员 (物流司机) +## 角色三:设备运维人员 -### 3.1. 核心诉求:路线清晰,任务明确,交接高效,权责分明 +### 3.1. 核心诉求:设备状态清晰,故障快速定位,维护高效便捷 #### **用户画像:张师傅** -- **身份**: 35岁,回收车队司机。 -- **习惯**: 每天需要跑多个点,时间观念强,不希望在交接流程上浪费时间。 -- **痛点**: 路线规划不合理导致绕路,手写单据字迹潦草易出错,跟小站站长核对重量时偶尔会发生争执。 +- **身份**: 35岁,智能终端设备运维工程师。 +- **习惯**: 熟悉各种电子设备,有一定的技术基础,注重工作效率。 +- **痛点**: 设备分布较广需要跑多个点,故障诊断耗时,备件管理混乱,用户投诉处理压力大。 ### 3.2. 用户故事 -#### **故事1:查看揽收任务** -- **作为** 运输员张师傅, -- **我想要** 在我的手机端(H5或小程序)看到今天所有需要去揽收的任务列表,并能一键开启导航, -- **以便于** 我可以合理规划路线,节省运输时间。 +#### **故事1:智能巡检任务** +- **作为** 运维工程师张师傅, +- **我想要** 在运维APP上看到系统根据设备状态自动生成的巡检任务,包括设备位置、故障类型、优先级,并能一键导航, +- **以便于** 我可以高效规划巡检路线,优先处理紧急故障,提升设备可用率。 -#### **故事2:无纸化扫码交接** -- **作为** 运输员张师傅, -- **我想要** 到达小站后,直接扫描站长出示的出库二维码,手机上就能显示出待交接的品类和重量, -- **以便于** 我可以快速核对,确认无误后双方点击确认即可完成交接,无需手写单据,高效且有据可查。 +#### **故事2:远程诊断与现场维修** +- **作为** 运维工程师张师傅, +- **我想要** 通过手机APP连接到智能终端,远程查看设备各模块状态,并获得故障诊断建议和维修指导, +- **以便于** 我能快速定位问题,携带正确的备件前往现场,提高一次修复成功率。 -#### **故事3:更新任务状态** -- **作为** 运输员张师傅, -- **我想要** 在完成揽收、运输、入库等关键节点时,能在手机上方便地更新任务状态, -- **以便于** 公司后台能实时了解我的工作进展,也方便了后续的流程协同。 +#### **故事3:设备清运与库存管理** +- **作为** 运维工程师张师傅, +- **我想要** 当终端设备发出满载预警时,能在APP上查看各袋子的准确重量,并记录清运数据, +- **以便于** 我能合理安排清运车辆,确保数据准确性,避免与后台系统数据不一致。 + +#### **故事4:维修记录与绩效跟踪** +- **作为** 运维工程师张师傅, +- **我想要** 每次维修后能在APP上记录维修过程、更换的备件、维修时间,并拍照存档, +- **以便于** 建立完整的设备维护档案,也让我的工作成果得到准确记录和考核。 --- -## 角色四:大仓库管理员 +## 角色四:数据中心管理员 -### 4.1. 核心诉求:入库清晰,库存准确,出库便捷 +### 4.1. 核心诉求:数据准确,监控全面,决策支持 #### **用户画像:赵主管** -- **身份**: 50岁,城市大仓的仓库主管。 -- **习惯**: 工作严谨,对数据准确性要求高。 -- **痛点**: 司机运回来的货物品类和重量与预期不符,库存盘点耗时耗力,与下游打包站的销售记录对账困难。 +- **身份**: 50岁,智能终端网络数据中心主管。 +- **习惯**: 工作严谨,善于数据分析,关注系统整体运行状况。 +- **痛点**: 设备数量多分布广难以全面监控,数据异常发现不及时,缺乏有效的预测分析工具。 ### 4.2. 用户故事 -#### **故事1:扫码确认入库** -- **作为** 仓库主管赵主管, -- **我想要** 在司机把废品运到大仓时,我能扫描他任务单上的二维码,系统就自动记录某某司机在什么时间、从哪些小站运来了多少斤什么废品, -- **以便于** 我可以快速完成入库登记,保证数据的准确性,并自动更新仓库库存。 +#### **故事1:实时监控大屏** +- **作为** 数据中心主管赵主管, +- **我想要** 在数据中心的大屏上实时看到所有智能终端的运行状态、交易数据、库存情况,并用不同颜色标识设备健康状态, +- **以便于** 我能一目了然地掌握整个终端网络的运行情况,及时发现异常设备。 -#### **故事2:实时库存监控** -- **作为** 仓库主管赵主管, -- **我想要** 在后台系统的大屏或电脑上,实时看到仓库里所有品类的库存量、存放位置和存放天数, -- **以便于** 我可以合理规划仓储空间,并在某种废品库存达到一定数量时,及时安排出库销售。 +#### **故事2:智能预警与分析** +- **作为** 数据中心主管赵主管, +- **我想要** 系统能基于历史数据自动预测设备维护需求、最佳清运时间,并在设备即将出现故障前提前预警, +- **以便于** 我能提前安排运维资源,实现预防性维护,降低设备故障率。 -#### **故事3:生成出库单** -- **作为** 仓库主管赵主管, -- **我想要** 当联系好下游的打包站后,能在系统里选择品类和重量,一键生成标准化的出库单, -- **以便于** 我可以指导工人备货,并作为与打包站结算的凭证,让整个出库流程规范化。 +#### **故事3:数据报表与决策支持** +- **作为** 数据中心主管赵主管, +- **我想要** 系统能自动生成各类运营报表,包括设备利用率、用户活跃度、收益分析等,并支持自定义查询和数据导出, +- **以便于** 我能为公司管理层提供准确的数据支持,协助制定运营策略和扩张计划。 --- diff --git a/01_设计/终端设备技术规格文档.md b/01_设计/终端设备技术规格文档.md new file mode 100644 index 0000000..b3f2fc0 --- /dev/null +++ b/01_设计/终端设备技术规格文档.md @@ -0,0 +1,326 @@ +# 智能回收终端设备技术规格文档 V1.0 + +> **文档状态**: 初稿 +> **版本**: 1.0 +> **修订日期**: 2024-09-15 +> **作者**: 产品技术团队 + +--- + +## 1. 产品概述 + +### 1.1 产品定位 +智能回收终端是一款部署在超市、快递门口的便携式废品回收设备,通过AI视觉识别、自动称重、智能分类等技术,在营业时间内提供智能化回收服务。设备可根据营业时间灵活收纳。 + +### 1.2 设计原则 +- **成本控制**: 设备硬件成本控制在1000元以内 +- **便携设计**: 支持营业时间外的收纳存放 +- **用户友好**: 操作简单直观,适合中老年用户使用 +- **简化部署**: 利用现有电源,无需复杂安装 + +--- + +## 2. 硬件规格 + +### 2.1 主要组成部件 + +#### 2.1.1 交互平板 +- **平板电脑**: 10.1英寸Android/Windows平板,2GB RAM + 32GB存储 +- **触控**: 电容触摸屏,支持多点触控 +- **连接**: WiFi + 4G LTE网络 +- **可收纳**: 支持营业结束后收进室内保管 +- **成本预算**: ≤350元 + +#### 2.1.2 AI摄像头 +- **摄像头**: USB接口200万像素摄像头 +- **视野**: 覆盖回收袋投入口区域 +- **连接**: USB连接至平板,即插即用 +- **防护**: 基础防尘设计 +- **成本预算**: ≤150元 + +#### 2.1.3 称重系统 +- **称重模块**: 便携式电子秤模块×3 +- **量程**: 单袋最大承重50kg,精度±50g +- **连接**: 蓝牙/USB连接至平板 +- **便携**: 支持快速拆装和收纳 +- **成本预算**: ≤300元 + +#### 2.1.4 分类回收袋 +- **回收袋**: 3个标准回收袋,容积40L/袋 +- **材料**: 牛津布或帆布材质,可清洗 +- **标识**: 丝印分类标识,无需LED灯 +- **便携**: 可折叠收纳 +- **成本预算**: ≤100元 + +#### 2.1.5 支撑骨架 +- **材料**: 铝合金便携式支架 +- **设计**: 可折叠设计,便于收纳运输 +- **稳定**: 确保使用时的结构稳定性 +- **重量**: 整套骨架≤15kg +- **成本预算**: ≤100元 + +### 2.2 整机规格 + +| 项目 | 规格参数 | +|------|----------| +| 展开尺寸 | 1000mm(H) × 600mm(W) × 400mm(D) | +| 收纳尺寸 | 200mm(H) × 600mm(W) × 400mm(D) | +| 整机重量 | ≤20kg | +| 工作温度 | 0°C ~ +40°C (室内使用) | +| 存储温度 | -10°C ~ +50°C | +| 工作湿度 | 20%~80% RH (无凝露) | +| 防护等级 | IP20 (基础防尘) | +| 供电要求 | 使用现有220V市电 | +| 功耗 | 工作≤30W | +| 通信方式 | Wi-Fi + 4G LTE + 蓝牙 | +| 认证标准 | 3C认证 | + +--- + +## 3. 软件架构 + +### 3.1 平板应用软件 +- **平台**: Android 8.0+ 或 Windows 10 +- **开发**: 原生应用或H5网页应用 +- **界面**: 简洁易用的触控界面 +- **更新**: 应用商店更新或远程更新 + +### 3.2 外设连接 +- **摄像头**: USB即插即用,标准UVC驱动 +- **称重模块**: 蓝牙或USB连接,标准HID协议 +- **网络**: Wi-Fi优先,4G备用 +- **数据同步**: 实时上传至云端服务器 + +### 3.3 AI识别引擎 +- **框架**: 云端AI识别 + 本地缓存 +- **识别方式**: 拍照上传至云端识别 +- **识别品类**: 塑料瓶、废纸、织物等 +- **准确率**: ≥90% (依赖云端算法) +- **响应时间**: ≤5秒 (含网络传输) + +### 3.4 应用功能 +- **用户登录**: 手机号验证码登录,小程序扫码登录 +- **品类选择**: 大按钮选择回收品类 +- **称重计价**: 自动读取称重数据并计价 +- **交易确认**: 语音播报和屏幕确认 + +### 3.5 云端对接 +- **协议**: HTTPS + MQTT over SSL +- **数据同步**: 实时上传交易数据 +- **远程控制**: 支持远程参数配置 +- **监控**: 实时状态监控和告警 + +--- + +## 4. 用户界面设计 + +### 4.1 界面设计原则 +- **适老化设计**: 大字体、高对比度、简化操作 +- **多语言支持**: 中文、英文界面切换 +- **语音提示**: 全程语音引导和反馈 +- **视觉反馈**: 丰富的动画和状态提示 + +### 4.2 主要界面流程 + +```mermaid +graph TD + A[待机界面
显示回收价格] --> B[用户登录
手机号/扫码] + B --> C[选择品类
塑料瓶/废纸/织物] + C --> D[投入物品
AI识别验证] + D --> E[自动称重
计算价格] + E --> F[确认交易
语音播报] + F --> G[交易完成
返回待机] + D --> H{识别失败} + H --> I[重新投入
或人工客服] +``` + +### 4.3 界面元素规范 +- **主要文字**: 36px 思源黑体 +- **按钮**: 最小80×60px,圆角8px +- **颜色**: 主色调绿色#2E8B57,警告色红色#DC143C +- **图标**: 简洁线条风格,支持夜间模式 + +--- + +## 5. 网络与通信 + +### 5.1 通信架构 +- **主通道**: 4G LTE网络连接云端服务器 +- **备份通道**: Wi-Fi网络作为备用连接 +- **本地通信**: 蓝牙5.0支持维护人员本地连接 + +### 5.2 数据传输 +- **实时数据**: 交易数据实时上传 +- **状态监控**: 每分钟上报设备状态 +- **大文件**: 图片和日志文件压缩后传输 +- **离线缓存**: 支持7天离线数据缓存 + +### 5.3 网络安全 +- **加密**: TLS 1.3端到端加密 +- **认证**: 设备证书双向认证 +- **防护**: DDoS攻击防护 +- **审计**: 完整的通信日志记录 + +--- + +## 6. 运行环境要求 + +### 6.1 部署环境 +- **场地**: 超市内部或有顶棚的门口区域 +- **电源**: 就近使用超市现有220V电源插座 +- **网络**: Wi-Fi环境(优先)+ 4G信号覆盖 +- **地面**: 平整地面即可,无需特殊承重要求 + +### 6.2 使用空间 +- **展开时**: 营业时间内在指定区域展开使用 +- **收纳时**: 营业结束后可收纳至室内存放 +- **操作空间**: 前方预留1m用户操作区域 +- **存放空间**: 室内预留0.5m²存放空间 + +### 6.3 部署要求 +- **安装**: 无需复杂安装,即插即用 +- **固定**: 临时固定方式,防止意外移动 +- **收纳**: 支持快速拆装和室内存放 +- **安全**: 平板等贵重设备可收进室内 + +--- + +## 7. 性能指标 + +### 7.1 关键性能指标 + +| 指标类别 | 具体指标 | 目标值 | 备注 | +|----------|----------|--------|------| +| **可用性** | 设备在线率 | ≥99% | 月度统计 | +| **可靠性** | 故障率(MTBF) | ≥2000小时 | 平均故障间隔 | +| **准确性** | 称重精度 | ±10g | 单次称重 | +| **识别率** | AI识别准确率 | ≥95% | 标准光线条件 | +| **响应性** | 交易完成时间 | ≤60秒 | 从投入到完成 | +| **容量** | 日处理能力 | 50-100笔 | 根据使用频率 | +| **效率** | 单笔交易时间 | ≤60秒 | 平均处理时间 | + +### 7.2 用户体验指标 +- **操作简易度**: 3步完成交易 +- **等待时间**: AI识别≤3秒,称重≤2秒 +- **语音反馈**: 清晰度≥85分贝 +- **界面响应**: 触控响应≤200ms + +--- + +## 8. 成本分析 + +### 8.1 硬件成本构成 + +| 组件 | 成本(元) | 占比 | +|------|----------|------| +| 交互平板 | 350 | 35.0% | +| 称重系统 | 300 | 30.0% | +| AI摄像头 | 150 | 15.0% | +| 分类回收袋 | 100 | 10.0% | +| 支撑骨架 | 100 | 10.0% | +| **硬件总计** | **1000** | **100%** | + +### 8.2 总投资成本构成 +- **硬件设备**: 1000元/台 +- **部署安装**: 300元/台 (运输、安装、调试) +- **培训推广**: 200元/台 (场地方培训、用户推广) +- **运营启动**: 500元/台 (前3个月运营成本) +- **备品备件**: 1000元/台 (维修备件、损耗补充) +- **总投资**: 3000元/台 + +### 8.3 运营成本预估 +- **网络费用**: 30元/月 (4G套餐) +- **设备维护**: 80元/月 (人工+备件) +- **电费**: 实际很少 (使用超市电源) +- **场地费**: 50元/月 (给超市的场地费) +- **月运营成本**: 160元/台 +- **年运营成本**: 1920元/台 + +### 8.4 投资回收分析 +- **总投入**: 3000元/台 +- **预期日收入**: 15-30元/台 (基于交易分成) +- **月收入**: 450-900元/台 +- **扣除运营成本**: 290-740元/台 (净收入) +- **投资回收期**: 4-10个月 + +--- + +## 9. 质量保证 + +### 9.1 测试标准 +- **功能测试**: 100%功能覆盖测试 +- **性能测试**: 7×24小时连续运行测试 +- **环境测试**: 高低温、湿度、震动测试 +- **EMC测试**: 电磁兼容性测试 +- **安全测试**: 电气安全和机械安全测试 + +### 9.2 质量认证 +- **国标认证**: GB 4943.1-2011信息技术设备安全 +- **环保认证**: RoHS 2.0有害物质限制指令 +- **通信认证**: 工信部无线电发射设备型号核准 +- **安全认证**: CCC强制性产品认证 + +### 9.3 售后服务 +- **质保期**: 整机保修24个月 +- **维修响应**: 市区4小时,郊区24小时 +- **备件保证**: 常用备件5年供应保证 +- **技术支持**: 7×24小时远程技术支持 + +--- + +## 10. 技术发展路线 + +### 10.1 V1.0版本 (MVP) +- 基础功能实现: 识别、称重、交易 +- 支持3大类物品回收 +- 基本的远程监控能力 + +### 10.2 V1.1版本 (优化版) +- AI识别算法优化,准确率提升至98% +- 增加更多回收品类支持 +- 优化用户界面和交互流程 +- 增强故障自诊断能力 + +### 10.3 V1.2版本 (智能版) +- 集成更强大的边缘计算能力 +- 支持用户行为分析和个性化服务 +- 增加积分兑换和游戏化元素 +- 实现预测性维护 + +### 10.4 未来发展 +- 支持更多品类(电子垃圾、有害垃圾) +- 集成区块链技术实现碳积分 +- AI算法持续优化和自学习 +- 与智慧城市系统深度集成 + +--- + +## 11. 附录 + +### 11.1 相关标准 +- GB/T 191-2008《包装储运图示标志》 +- GB 4943.1-2011《信息技术设备 安全 第1部分》 +- GB/T 2423《电工电子产品环境试验》 +- YD/T 1538-2014《移动通信手持机充电器及接口技术要求》 + +### 11.2 供应商推荐 +- **主控芯片**: 瑞芯微RK3399、全志H6 +- **触控屏**: 京东方、天马微电子 +- **称重传感器**: 梅特勒-托利多、赛多利斯 +- **摄像头**: 海康威视、大华股份 +- **结构件**: 富士康、比亚迪精密制造 + +### 11.3 部署检查清单 +- [ ] 现场勘查和空间规划 +- [ ] 确认电源插座位置 +- [ ] WiFi网络配置和4G信号测试 +- [ ] 设备组装和摆放 +- [ ] 平板应用安装和配置 +- [ ] 称重设备校准 +- [ ] 场地方培训和说明 +- [ ] 试运行和用户体验测试 +- [ ] 运营数据对接确认 + +--- + +**文档版权**: 绿邻回收项目组所有,未经授权不得转载或使用。 \ No newline at end of file