docs: 优化产品需求文档和功能模块文档结构

- 重构了产品需求文档的章节组织和内容结构
- 改进了智能功能模块的文档格式和可读性
- 优化了一键邻回收和用户故事文档的排版
- 新增了完整的规格文档模板和内容框架
- 统一了文档风格和格式规范,提升文档质量
This commit is contained in:
史悦
2025-09-15 14:07:29 +08:00
parent 8d228527d0
commit 450f08d05c
6 changed files with 743 additions and 280 deletions

View File

@@ -58,47 +58,69 @@
```mermaid ```mermaid
graph TD graph TD
subgraph 用户端 (User Layer) subgraph 用户端 (User Layer)
C_MP[C端居民小程序<br>(uni-app / Vue.js)] C_MP[C端用户小程序<br>(uni-app / Vue.js)]
B_MP[B端小站小程序<br>(uni-app / Vue.js)]
Admin[管理后台Web<br>(Vue 3 + Element Plus)] Admin[管理后台Web<br>(Vue 3 + Element Plus)]
Maintenance[运维端APP<br>(Flutter / React Native)]
end
subgraph 智能终端层 (Terminal Layer)
Terminal1[智能终端设备#1<br>(嵌入式Linux + Qt)]
Terminal2[智能终端设备#2<br>(嵌入式Linux + Qt)]
TerminalN[智能终端设备#N<br>(嵌入式Linux + Qt)]
end end
subgraph 网关层 (API Gateway) subgraph 网关层 (API Gateway)
Gateway[API Gateway<br>(Nginx)] Gateway[API Gateway<br>(Nginx + Load Balancer)]
end end
subgraph 后端服务 (Backend Service) subgraph 后端服务 (Backend Service)
Backend[后端应用服务器<br>(Node.js + NestJS)] Backend[后端应用服务器<br>(Node.js + NestJS)]
AIService[AI识别服务<br>(Python + TensorFlow)]
DeviceManager[设备管理服务<br>(MQTT Broker)]
end end
subgraph 数据层 (Data Layer) subgraph 数据层 (Data Layer)
DB[(PostgreSQL<br>核心业务数据)] DB[(PostgreSQL<br>核心业务数据)]
Cache[(Redis<br>缓存/会话)] Cache[(Redis<br>缓存/会话)]
TimeSeries[(InfluxDB<br>设备时序数据)]
end end
C_MP --> Gateway C_MP --> Gateway
B_MP --> Gateway
Admin --> Gateway Admin --> Gateway
Maintenance --> Gateway
Terminal1 --> DeviceManager
Terminal2 --> DeviceManager
TerminalN --> DeviceManager
Gateway --> Backend Gateway --> Backend
Backend --> AIService
Backend --> DeviceManager
Backend --> DB Backend --> DB
Backend --> Cache Backend --> Cache
DeviceManager --> TimeSeries
AIService --> Cache
``` ```
### 3.2 技术选型理由 ### 3.2 技术选型理由
- **前端 (uni-app + Vue)**: 一次开发多端发布极大提升MVP开发效率统一技术栈。 - **前端 (uni-app + Vue)**: 一次开发多端发布极大提升MVP开发效率C端小程序和运维端APP统一技术栈。
- **后端 (Node.js + NestJS)**: 全栈语言统一TypeScript架构清晰适合企业级应用保证代码质量和可维护性 - **智能终端 (嵌入式Linux + Qt)**: 稳定可靠的嵌入式系统Qt提供良好的触屏界面开发体验支持多媒体和网络通信
- **数据库 (PostgreSQL + Redis)**: PostgreSQL功能强大满足地理位置查询等复杂需求Redis作为缓存保证系统响应速度 - **后端 (Node.js + NestJS)**: 全栈语言统一TypeScript微服务架构清晰适合处理高并发的设备连接
- **AI服务 (Python + TensorFlow)**: 成熟的机器学习框架,支持物品识别模型的训练和推理。
- **设备通信 (MQTT)**: 轻量级物联网协议,适合终端设备与云端的实时通信。
- **数据库 (PostgreSQL + Redis + InfluxDB)**: PostgreSQL处理业务数据Redis提供缓存和会话InfluxDB专门存储设备时序数据。
### 3.3 风险评估与应对策略 ### 3.3 风险评估与应对策略
- **技术风险**: - **硬件风险**:
- **风险点**: `uni-app` 在部分低端安卓机型上可能存在性能瓶颈 - **风险点**: 智能终端设备的硬件稳定性和恶劣环境适应性
- **应对策略**: 在开发中期,选取核心页面(如扫码、列表)进行专项性能测试,预留优化时间 - **应对策略**: 选择工业级硬件组件,进行充分的环境测试(高温、低温、湿度、振动)
- **团队风险**: - **AI识别风险**:
- **风险点**: 团队成员对 `NestJS``uni-app` 的熟练度可能不一 - **风险点**: 物品识别准确率可能达不到预期,影响用户体验
- **应对策略**: 在项目启动前安排1-2天的技术预研Spike统一代码规范和最佳实践 - **应对策略**: 建立持续学习机制,收集错误样本不断优化模型;设置人工审核机制作为兜底
- **需求风险**: - **网络风险**:
- **风险点**: MVP开发期间出现重大需求变更影响核心交付范围 - **风险点**: 终端设备网络不稳定导致数据传输中断
- **应对策略**: 建立需求变更控制流程。所有需求变更需经由产品、项目、研发三方共同评估影响后,再决定是否纳入当前版本 - **应对策略**: 实现本地数据缓存机制,支持断网重连和数据补传
- **成本风险**:
- **风险点**: 单台设备成本超出3000元预算影响盈利模式。
- **应对策略**: 严格控制硬件BOM成本探索批量采购降本优化设计减少不必要功能。
--- ---
@@ -111,6 +133,7 @@ graph TD
CREATE TABLE users ( CREATE TABLE users (
id SERIAL PRIMARY KEY, id SERIAL PRIMARY KEY,
wx_openid VARCHAR(255) UNIQUE NOT NULL, wx_openid VARCHAR(255) UNIQUE NOT NULL,
phone_number VARCHAR(20) UNIQUE,
nickname VARCHAR(255), nickname VARCHAR(255),
avatar_url TEXT, avatar_url TEXT,
balance DECIMAL(10, 2) NOT NULL DEFAULT 0.00, balance DECIMAL(10, 2) NOT NULL DEFAULT 0.00,
@@ -118,26 +141,33 @@ CREATE TABLE users (
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW() updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
); );
-- 2. B端回收小站 -- 2. 智能终端设备
CREATE TABLE stations ( CREATE TABLE terminals (
id SERIAL PRIMARY KEY, id SERIAL PRIMARY KEY,
device_code VARCHAR(100) UNIQUE NOT NULL,
name VARCHAR(255) NOT NULL, name VARCHAR(255) NOT NULL,
address TEXT NOT NULL, address TEXT NOT NULL,
location GEOGRAPHY(POINT, 4326), location GEOGRAPHY(POINT, 4326),
manager_name VARCHAR(100), venue_type VARCHAR(50) NOT NULL, -- supermarket, express_station, etc.
phone_number VARCHAR(20), venue_contact_name VARCHAR(100),
status VARCHAR(20) NOT NULL DEFAULT 'active', 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(), created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW() updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
); );
-- 3. 小站员工 -- 3. 终端配置
CREATE TABLE staff ( CREATE TABLE terminal_configs (
id SERIAL PRIMARY KEY, id SERIAL PRIMARY KEY,
station_id INT NOT NULL REFERENCES stations(id), terminal_id INT NOT NULL REFERENCES terminals(id),
phone_number VARCHAR(20) UNIQUE NOT NULL, bag_count INT NOT NULL DEFAULT 3,
password_hash VARCHAR(255) NOT NULL, max_weight_per_bag DECIMAL(10, 2) DEFAULT 50.00,
role VARCHAR(50) NOT NULL DEFAULT 'staff', ai_confidence_threshold DECIMAL(3, 2) DEFAULT 0.85,
network_config JSONB,
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW() updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
); );
@@ -146,7 +176,9 @@ CREATE TABLE staff (
CREATE TABLE categories ( CREATE TABLE categories (
id SERIAL PRIMARY KEY, id SERIAL PRIMARY KEY,
name VARCHAR(100) UNIQUE NOT NULL, name VARCHAR(100) UNIQUE NOT NULL,
code VARCHAR(20) UNIQUE NOT NULL, -- bottle, paper, textile
unit VARCHAR(20) NOT NULL DEFAULT 'kg', unit VARCHAR(20) NOT NULL DEFAULT 'kg',
ai_model_labels TEXT[], -- AI识别标签数组
is_active BOOLEAN NOT NULL DEFAULT TRUE, is_active BOOLEAN NOT NULL DEFAULT TRUE,
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
); );
@@ -155,20 +187,22 @@ CREATE TABLE categories (
CREATE TABLE prices ( CREATE TABLE prices (
id SERIAL PRIMARY KEY, id SERIAL PRIMARY KEY,
category_id INT NOT NULL REFERENCES categories(id), 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, price DECIMAL(10, 2) NOT NULL,
effective_date TIMESTAMPTZ NOT NULL DEFAULT NOW(), effective_date TIMESTAMPTZ NOT NULL DEFAULT NOW(),
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
UNIQUE(category_id, station_id) UNIQUE(category_id, terminal_id)
); );
-- 6. 交易记录总表 -- 6. 交易记录总表
CREATE TABLE transactions ( CREATE TABLE transactions (
id SERIAL PRIMARY KEY, id SERIAL PRIMARY KEY,
user_id INT NOT NULL REFERENCES users(id), user_id INT NOT NULL REFERENCES users(id),
station_id INT NOT NULL REFERENCES stations(id), terminal_id INT NOT NULL REFERENCES terminals(id),
staff_id INT NOT NULL REFERENCES staff(id),
total_amount DECIMAL(10, 2) NOT NULL, 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() created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
); );
@@ -177,9 +211,44 @@ CREATE TABLE transaction_items (
id SERIAL PRIMARY KEY, id SERIAL PRIMARY KEY,
transaction_id INT NOT NULL REFERENCES transactions(id) ON DELETE CASCADE, transaction_id INT NOT NULL REFERENCES transactions(id) ON DELETE CASCADE,
category_id INT NOT NULL REFERENCES categories(id), category_id INT NOT NULL REFERENCES categories(id),
bag_number INT NOT NULL, -- 投入的袋子编号
weight DECIMAL(10, 2) NOT NULL, weight DECIMAL(10, 2) NOT NULL,
price_per_unit DECIMAL(10, 2) NOT NULL, price_per_unit DECIMAL(10, 2) NOT NULL,
amount 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() created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
); );
``` ```
@@ -189,28 +258,43 @@ CREATE TABLE transaction_items (
## 5. 核心API接口设计 ## 5. 核心API接口设计
### 5.1 管理后台API (`/api/admin`) ### 5.1 管理后台API (`/api/admin`)
- **终端管理**: `GET, POST, PUT /terminals/:id`
- **品类管理**: `GET, POST, PUT /categories/:id` - **品类管理**: `GET, POST, PUT /categories/:id`
- **小站管理**: `GET, POST, PUT /stations/:id`
- **价格管理**: `GET, POST /prices` - **价格管理**: `GET, POST /prices`
- **员工管理**: `GET, POST /staff` - **维护管理**: `GET, POST /maintenance`
- **数据监控**: `GET /monitoring/dashboard`
### 5.2 C端小程序API (`/api/c`) ### 5.2 C端小程序API (`/api/c`)
- **认证**: `POST /auth/login` (微信Code换JWT) - **认证**: `POST /auth/login` (微信Code换JWT)
- **用户信息**: `GET /profile` - **用户信息**: `GET /profile`
- **核心功能**: - **核心功能**:
- `GET /features/prices` (今日回收价) - `GET /features/prices` (今日回收价)
- `GET /features/nearby-stations` (附近小站) - `GET /features/nearby-terminals` (附近终端)
- `GET /features/transactions` (交易记录) - `GET /features/transactions` (交易记录)
- `GET /features/qrcode` (生成登录二维码)
### 5.3 B端小程序API (`/api/b`) ### 5.3 智能终端设备API (`/api/terminal`)
- **认证**: `POST /auth/login` (手机号密码登录) - **设备认证**: `POST /auth/device` (设备注册登录)
- **回收流程**: - **用户识别**: `POST /user/identify` (二维码/手机号识别)
- `GET /recycle/user-info` (扫码识客) - **交易流程**:
- `POST /recycle/transactions` (创建交易) - `POST /transaction/start` (开始交易)
- **数据查询**: - `POST /transaction/weigh` (称重数据上传)
- `GET /data/summary` (今日汇总) - `POST /transaction/ai-verify` (AI识别验证)
- `GET /data/inventory` (库存盘点) - `POST /transaction/complete` (完成交易)
- `GET /data/categories` (可用回收品类) - **设备状态**:
- `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` (维修记录)
--- ---

View File

@@ -15,25 +15,29 @@
| 一级菜单 | 二级菜单 (页面) | 功能模块 | 细节描述 | 对应PRD/用户故事 | | 一级菜单 | 二级菜单 (页面) | 功能模块 | 细节描述 | 对应PRD/用户故事 |
| :--- | :--- | :--- | :--- | :--- | | :--- | :--- | :--- | :--- | :--- |
| **数据中心** | **运营驾驶舱** | 核心KPI展示 | - 今日交易总额、总单数、总重量<br>- 活跃用户数 (DAU/MAU)<br>- 新增用户数 | PRD 6.1.1 | | **数据中心** | **运营驾驶舱** | 核心KPI展示 | - 今日交易总额、总单数、总重量<br>- 活跃用户数 (DAU/MAU)<br>- 在线设备数/故障设备数<br>- 设备利用率和平均交易频次 | PRD 7.1.1 |
| | | 业务数据图表 | - 各品类回收趋势图 (近7/30天)<br>- 各小站回收量动态排名<br>- 用户活跃时段分布图 | PRD 6.1.1 | | | | 实时监控大屏 | - 地图展示所有终端位置和状态<br>- 各终端实时交易数据<br>- 设备健康状态色彩编码<br>- 异常设备实时告警 | PRD 7.1.1, 用户故事 4.2.1 |
| **运营管理** | **小站管理** | 小站列表 | - 显示小站ID、名称、地址、负责人、联系电话、状态(营业/休息中/已关闭)<br>- 支持按名称、地址、负责人搜索<br>- 支持按状态筛选 | PRD 6.1.3 | | **设备管理** | **终端设备列表** | 设备信息管理 | - 显示设备编号、名称、地址、场地方信息、运行状态<br>- 支持按设备编号、地址、状态搜索<br>- 设备部署成本和投资回收期显示 | PRD 7.1.2 |
| | | 小站详情/编辑 | - **基本信息**查看和修改名称、地址、地理位置(地图选点)、负责人、营业时间<br>- **员工管理**:关联/解绑小站员工账号<br>- **服务状态**手动切换小站营业/休息状态<br>- **交易数据**查看该小站的历史交易流水 | PRD 6.1.3, 用户故事 5.2.3 | | | | 设备详情/编辑 | - **基本信息**设备编号、位置、场地方联系方式<br>- **硬件配置**袋子数量、最大承重、AI识别阈值<br>- **运行状态**在线/离线/故障/维护中<br>- **交易数据**该设备的历史交易流水和收益分析 | PRD 7.1.2 |
| | | 入驻审核 | - 查看待审核的小站申请列表<br>- 点击审核,可查看提交资料,并执行“通过”或“驳回”操作 | PRD 6.1.3 | | | | 设备部署管理 | - 新设备入网配置和参数设置<br>- 设备软件版本管理和远程更新<br>- 设备网络配置和连接状态监控 | PRD 7.1.2 |
| | **品类价格管理** | 回收品类列表 | - 显示品类ID、名称、单位如kg、状态启用/停用)<br>- 支持新增、编辑、停用品类 | PRD 6.1.4, 用户故事 6.3.2 | | | **设备监控** | 实时状态监控 | - 各设备CPU、内存、存储使用率<br>- 网络连接状态和数据传输质量<br>- 各袋子实时重量和容量预警<br>- 设备温度和环境监控 | PRD 7.1.2, 用户故事 4.2.1 |
| | | 价格策略配置 | - 选择一个或多个小站,为指定品类设置回收单价<br>- 支持批量调价和设置价格生效时间<br>- 可查看历史价格调整记录 | PRD 6.1.4, 用户故事 5.2.2 | | | | 故障预警系统 | - AI预测设备故障风险<br>- 自动生成维护提醒<br>- 故障类型统计和趋势分析 | PRD 7.1.9, 用户故事 4.2.2 |
| | | 物流损耗配置 | - 为不同品类设置全局或区域性的运输损耗比例纸壳损耗2% | PRD 6.1.4, 用户故事 6.3.3 | | **运营管理** | **品类价格管理** | 回收品类列表 | - 显示品类ID、名称、代码、单位、AI识别标签<br>- 支持新增、编辑、停用品类<br>- AI识别模型标签配置 | PRD 7.1.4 |
| **交易管理** | **订单流水** | 交易列表 | - 列表展示所有交易记录交易ID、用户昵称、回收小站、总金额、创建时间<br>- 支持按交易ID、用户、小站、时间范围进行复合查询 | PRD 6.1.5, 初步设计 2. MVP | | | | 价格策略配置 | - 选择一个或多个终端,为指定品类设置回收单价<br>- 支持批量调价和设置价格生效时间<br>- 可查看历史价格调整记录和市场价格对比 | PRD 7.1.4 |
| | | 订单详情 | - 查看单笔交易的详细信息,包括所有回收物品的品类、重量、单价、金额 | PRD 6.1.5 | | | | AI识别配置 | - 设置不同品类的AI识别置信度阈值<br>- 上传训练样本和错误样本管理<br>- 模型识别准确率统计和优化建议 | PRD 7.1.4 |
| **用户管理** | **C端用户列表** | 用户信息查询 | - 列表展示所有C端用户信息用户ID、微信昵称、头像、账户余额、注册时间<br>- 支持按用户ID、昵称查询 | PRD 6.1.2 | | **交易管理** | **订单流水** | 交易列表 | - 列表展示所有交易记录:交易ID、用户昵称、终端设备、总金额、AI置信度、创建时间<br>- 支持按交易ID、用户、设备、时间范围进行复合查询 | PRD 7.1.5 |
| | | 用户详情 | - 查看用户的基本信息、账户余额、完整的交易记录列表 | PRD 6.1.2 | | | | 订单详情 | - 查看单笔交易的详细信息,包括所有回收物品的品类、重量、单价、金额<br>- 显示AI识别结果和置信度<br>- 交易过程图片查看 | PRD 7.1.5 |
| **物流管理** | **揽收任务** | 任务列表 | - 查看所有物流任务任务ID、状态待揽收/运输中/已入库)、司机、关联小站、创建时间<br>- 支持按状态、司机、小站筛选 | PRD 6.1.6, V1.1规划 | | | | 异常交易处理 | - 低置信度交易人工审核<br>- 用户投诉处理和退款管理<br>- 异常交易模式分析 | PRD 7.1.5 |
| | | 任务详情 | - 查看任务包含的所有待交接的品类和重量信息,以及实际交接的记录 | PRD 6.1.6, V1.1规划 | | **用户管理** | **C端用户列表** | 用户信息查询 | - 列表展示所有C端用户信息用户ID、微信昵称、手机号、账户余额、注册时间<br>- 用户行为分析:常用设备、交易频次、偏好品类 | PRD 7.1.3 |
| | | 司机管理 | - 管理物流司机信息(姓名、联系方式、关联车辆) | PRD 6.1.6, V1.1规划 | | | | 用户详情 | - 查看用户的基本信息、账户余额、完整的交易记录列表<br>- 用户设备使用热力图和行为轨迹 | PRD 7.1.3 |
| **财务管理** | **结算管理** | 对账单 | - 生成与小站、物流司机的周期性结算账单<br>- 账单需清晰列出所有明细,并扣除平台服务费/损耗 | PRD 6.1.7, V1.2规划 | | **运维管理** | **维护任务** | 任务列表 | - 查看所有运维任务任务ID、类型巡检/维修/清运)、设备、运维人员、状态<br>- 支持按任务类型、状态、设备筛选 | PRD 7.1.6 |
| | | 提现审批 | - (若C端提现需人工审核)处理C端用户的提现申请 | PRD 3.1.3 (V1.1) | | | | 任务详情 | - 查看任务的详细信息、维修记录、更换备件<br>- 维修前后照片对比<br>- 维修成本和时长统计 | PRD 7.1.6 |
| | | 账单导出 | - 支持将结算账单导出为Excel格式 | PRD 6.1.7 | | | | 运维人员管理 | - 管理运维工程师信息(姓名、联系方式、技能等级、负责区域) | PRD 7.1.6 |
| **系统管理** | **角色与权限** | 角色管理 | - 创建、编辑后台角色(如:运营、财务、客服)<br>- 为角色分配不同的菜单和操作权限(增删改查) | PRD 6.1.8 | | | **库存清运** | 清运计划 | - 基于设备容量自动生成清运计划<br>- 最优路线规划和运输成本计算<br>- 清运记录和重量核对 | PRD 7.1.5 |
| | | 账号管理 | - 创建后台操作员账号,并为其分配角色 | PRD 6.1.8 | | **财务管理** | **结算管理** | 对账单 | - 生成与场地方、运维团队的周期性结算账单<br>- 设备投资成本分摊和回收期计算<br>- 账单需清晰列出所有明细和分润比例 | PRD 7.1.7 |
| | **系统监控** | 登录日志 | - 查看所有后台账号的登录历史记录包括登录IP、时间、设备信息 | PRD 6.1.8 | | | | 成本分析 | - 单台设备成本构成分析<br>- 运营成本趋势和优化建议<br>- ROI计算和盈利预测 | PRD 7.1.7 |
| | | 报警中心 | - 集中展示系统产生的各类业务异常报警库存预警、交易异常、API错误<br>- 支持查看报警详情、标记处理状态、记录处理过程 | PRD 6.1.9, 用户故事 6.3.4 | | | | 提现审批 | - (若C端提现需人工审核)处理C端用户的提现申请 | PRD 4.1.4 |
| **系统管理** | **角色与权限** | 角色管理 | - 创建、编辑后台角色(如:运营、技术、财务、客服)<br>- 为角色分配不同的菜单和操作权限(增删改查) | PRD 7.1.8 |
| | | 账号管理 | - 创建后台操作员账号,并为其分配角色<br>- 设备访问权限管理 | PRD 7.1.8 |
| | **智能监控** | 系统日志 | - 查看所有后台账号的登录历史记录、设备操作日志<br>- 异常操作行为分析和告警 | PRD 7.1.8 |
| | | 智能报警中心 | - 集中展示设备故障、容量预警、交易异常、网络中断等告警<br>- AI辅助故障诊断和处理建议<br>- 告警处理流程跟踪和效果评估 | PRD 7.1.9 |

View File

@@ -5,9 +5,9 @@
## 1. 执行摘要 (Executive Summary) ## 1. 执行摘要 (Executive Summary)
**绿邻回收**是一个旨在革新城市社区废品回收模式的环保科技项目。我们通过构建一个以微信小程序为载体,连接居民、社区小站和回收产业链的超便捷回收网络,解决当前城市废品回收中存在的最后一公里难题。 **绿邻回收**是一个旨在革新城市社区废品回收模式的环保科技项目。我们通过在各大超市、快递门口部署智能回收终端,结合微信小程序后台管理系统,打造一个全自动化、高效透明的废品回收网络,解决当前城市废品回收中存在的"最后一公里"难题。
我们的核心业务是,用户(特别是中老年人)可以方便地将家中的可回收废品(初期聚焦于塑料瓶、纸壳、旧衣物)送到楼下的合作小站(如超市、快递驿站),通过一个极其简单的“适老化”小程序进行称重、计价,并立即获得现金或兑换商品。小站的废品将由我们的物流体系每日归集到城市中心仓,再统一销售给大型打包站,从而形成一个高效、透明、共赢的商业闭环 我们的核心产品是智能回收终端设备配备1-3个回收袋用于分类收集饮料瓶、废纸、织物等可回收物品通过AI摄像头自动识别监控回收物品平板电脑显示重量和操作界面整个系统由坚固的铝合金骨架组合而成。用户只需将废品投入对应的回收袋系统自动称重计价通过简单的身份识别即可完成交易实现真正的无人值守智能回收
本项目致力于通过技术手段和创新的运营模式,提升回收效率,改善用户体验,为环保事业贡献力量,并创造可观的经济价值。 本项目致力于通过技术手段和创新的运营模式,提升回收效率,改善用户体验,为环保事业贡献力量,并创造可观的经济价值。
@@ -55,57 +55,59 @@
## 4. 产品与服务 (Product and Service) ## 4. 产品与服务 (Product and Service)
### 4.1 核心载体:微信小程序 ### 4.1 核心产品:智能回收终端
分为两个端:用户端和小站端 我们的核心产品是部署在各大超市、快递门口的智能回收终端设备
- **用户端**: - **硬件组成**:
- **核心功能**: 查看附近小站、回收价格公示、个人账户(交易记录、余额)。 - **分类回收袋**: 1-3个可配置回收袋用于分类收集饮料瓶、废纸、织物等不同品类
- **“适老化”设计**: 超大字体、语音播报、极简流程、无需复杂注册。 - **AI视觉监控**: 高清摄像头实时监控回收物品,确保分类正确性和防止异物投入
- **智能称重**: 精准称重传感器,实时显示重量和计算价格
- **交互平板**: 用户友好的触摸屏界面,支持身份识别、重量显示、交易确认
- **结构骨架**: 坚固的铝合金框架,确保设备稳定性和防护性能
- **小站端**: - **软件系统**:
- **核心功能**: 扫码识别用户、称重品类录入、自动计价、结算(现金/兑换)、当日汇总。 - **用户端微信小程序**: 查看附近终端、回收价格公示、个人账户管理
- **设计理念**: 操作直观,功能聚焦,稳定可靠。 - **终端操作系统**: 支持多种身份识别方式,自动称重计价,实时数据上传
- **后台管理系统**: 远程监控终端状态、数据统计分析、故障预警
### 4.2 业务流程 ### 4.2 业务流程
这是一个完整闭环系统,从居民到最终的打包站。 这是一个基于智能终端的完整闭环系统,从居民到最终的打包站。
``` mermaid ``` mermaid
graph TD graph TD
subgraph 用户端 subgraph 用户端
A[居民在家整理废品] --> B{下楼前往小站}; A[居民在家整理废品] --> B[前往超市/快递门口终端];
end end
subgraph 小站 subgraph 智能终端
B --> C[站长使用小程序称重]; B --> C[用户身份识别登录];
C --> D[系统自动计算价格]; C --> D[选择回收品类投入对应袋子];
D --> E{选择结算方式}; D --> E[AI摄像头监控验证物品];
E --> F[获得现金/兑换商品]; E --> F[系统自动称重计价];
E --> G[积分存入账户]; F --> G[用户确认交易];
F --> H[完成回收]; G --> H[积分/现金到账];
G --> H; H --> I[废品自动存储在终端];
C --> I[废品暂存小站];
end end
subgraph 物流与仓储 subgraph 物流与仓储
I --> J(每日由专人从小站收集); I --> J[终端满载自动预警];
J --> K[转运至邻近小仓]; J --> K[物流团队定期清运];
K --> L(专车每日从小仓归集); K --> L[运输至城市大仓];
L --> M[送达城市大仓]; L --> M[分类、压缩、存储];
M --> N[分类、压缩、存储];
end end
subgraph 供应链末端 subgraph 供应链末端
N --> O(定期从大仓转运); M --> N[定期从大仓转运];
O --> P[销售给大型打包站]; N --> O[销售给大型打包站];
end end
P --> |资金回流| Q((分润体系)); O --> |资金回流| P((分润体系));
subgraph 收益分配 subgraph 收益分配
Q --> |利润| CEO/公司; P --> |利润| 公司运营;
Q --> |服务费| B端小站; P --> |场地费| 超市/快递站;
Q --> |回收金| A; P --> |回收金| A;
Q --> |工资/运费| 物流与仓储; P --> |运维成本| 设备维护;
end end
``` ```
@@ -143,11 +145,12 @@ graph TD
## 7. 财务规划 (Financial Plan) ## 7. 财务规划 (Financial Plan)
### 7.1 成本结构 (Cost Structure) ### 7.1 成本结构 (Cost Structure)
- **技术开发成本**: 小程序开发、服务器、数据库等。 - **设备成本**: 每个终端设备约2500元包含摄像头、平板、称重传感器、铝合金骨架、组装调试
- **人力成本**: 核心团队、线下运营及物流人员的工资。 - **部署成本**: 每个站点部署费用约300元包含运输、安装、调试、培训
- **营销成本**: 地推活动、物料制作费用。 - **运维成本**: 每个站点月运维成本约200元包含设备维护、软件更新、故障处理
- **运营成本**: 仓储租金、运输车辆油耗及维护 - **技术开发成本**: 软件系统开发、云服务器、数据库等
- **给用户的回收金**: 支付给用户的废品费用。 - **给用户的回收金**: 支付给用户的废品费用。
- **总投入**: 每个站点总投入成本约3000元实现一期自循环目标。
### 7.2 收入来源 (Revenue Streams) ### 7.2 收入来源 (Revenue Streams)
- **核心收入**: 将从大仓集中处理后的可回收物,以更高的价格批量出售给大型打包站或处理厂,赚取其中的差价。 - **核心收入**: 将从大仓集中处理后的可回收物,以更高的价格批量出售给大型打包站或处理厂,赚取其中的差价。
@@ -165,21 +168,25 @@ graph TD
```mermaid ```mermaid
sequenceDiagram sequenceDiagram
participant User as 用户 participant User as 用户
participant Station as 小站端小程序 participant Terminal as 智能终端
participant Camera as AI摄像头
participant Server as 后端服务器 participant Server as 后端服务器
User->>User: 在家整理好废品 User->>User: 在家整理好废品
User->>Station: 带着废品到楼下小站 User->>Terminal: 前往超市/快递门口的智能终端
Station->>User: 站长:欢迎,请出示您的手机号/会员码 Terminal->>User: 显示欢迎界面,请选择登录方式
User->>Station: (提供手机号后4位) User->>Terminal: 手机号/扫码/刷卡登录
Station->>Server: 查询用户信息 (手机号:xxxx) Terminal->>Server: 验证用户身份
Server-->>Station: 返回用户信息 Server-->>Terminal: 返回用户信息
Station->>Station: 站长选择品类(纸壳),放置上称 Terminal->>User: 显示用户昵称,请选择回收品类
Station->>Server: 上传数据(用户ID, 品类:纸壳, 重量:2.5kg) User->>Terminal: 选择"废纸"并投入对应袋子
Server-->>Station: 返回计算价格(3.75元) Camera->>Terminal: AI识别确认是废纸类物品
Station->>User: 站长一共3块7毛5您要现金还是换东西 Terminal->>Terminal: 自动称重 (2.5kg)
User->>Station: 就要现金吧 Terminal->>Server: 上传数据(用户ID, 品类:废纸, 重量:2.5kg)
Station->>Server: 确认交易(用户ID, 金额:3.75, 方式:现金) Server-->>Terminal: 返回计算价格(3.75元)
Server-->>Station: 交易成功 Terminal->>User: 显示"废纸2.5kg价值3.75元,确认交易吗?"
Station->>User: (支付现金)好了,欢迎下次再来! User->>Terminal: 点击确认
Terminal->>Server: 确认交易(用户ID, 金额:3.75)
Server-->>Terminal: 交易成功
Terminal->>User: 语音播报"交易成功获得3.75元"并显示交易完成界面
``` ```

View File

@@ -30,19 +30,20 @@
### 1.3 项目目标 ### 1.3 项目目标
- **V1.0 (MVP) 目标**: - **V1.0 (MVP) 目标**:
- 验证核心商业模式:居民到小站的回收流程 - 验证智能终端的核心商业模式:无人值守自动回收
- 在1-2个试点社区,实现每周100+笔交易。 - 部署10-15台终端设备,实现每周200+笔交易。
- C端用户次月留存率达到30%B端小站无主动流失 - 单台设备日均交易量达到15笔用户重复使用率达到40%。
- 实现每台设备3000元投入成本的自循环盈利模式。
### 1.4 核心用户画像 ### 1.4 核心用户画像
- **C端 - 居民**: - **C端 - 居民用户**:
- **王大妈**: 65岁退休在家对价格敏感会用微信但对复杂操作有困难。希望卖废品能像去超市买菜一样简单。 - **王大妈**: 65岁退休在家对价格敏感希望24小时随时能卖废品操作要像ATM一样简单直观
- **B端 - 小站站长**: - **小张**: 30岁上班族希望下班路过超市时能快速处理家里的快递纸箱不用排队等人工服务。
- **李老板**: 45岁社区超市店主。希望回收操作不影响主业记账清晰能快速和上游完成交接结算。 - **B端 - 场地方**:
- **物流端 - 司机**: - **超市老板**: 希望终端设备不占用过多空间,不影响正常营业,还能获得稳定的场地租金收入。
- **张师傅**: 35岁回收车队司机。希望能有清晰的揽收路线交接时不用手写单据扫个码就能搞定 - **快递站点**: 希望设备能吸引更多客流,带动快递业务,增加额外收入来源
- **后台 - 运营经理**: - **运营端 - 设备管理员**:
- **小陈**: 28岁公司运营。希望实时看到各小站的回收数据,能灵活调整回收品类和价格 - **小陈**: 28岁负责终端设备的远程监控、故障处理、定期清运等运维工作
--- ---
@@ -50,166 +51,202 @@
```mermaid ```mermaid
graph TD graph TD
subgraph C端用户 subgraph 用户
A[1.居民携带废品到小站] --> B{2.出示个人收款码}; A[1.居民携带废品到终端] --> B[2.终端屏幕身份识别];
end end
subgraph B端用户 subgraph 智能终端
B --> C[3.站长扫码识别用户]; B --> C[3.选择回收品类];
C --> D[4.选择品类, 输入重量]; C --> D[4.投入对应回收袋];
D --> E[5.确认金额, 完成交易]; D --> E[5.AI摄像头识别验证];
E --> F((资金计入用户余额)); E --> F[6.自动称重计价];
E --> G[6.定期向上游发起交接]; F --> G[7.用户确认交易];
G --> H((资金计入用户余额));
G --> I[8.废品存储在终端];
end end
subgraph 物流端 subgraph 后台监控
G --> H[7.司机接单, 前往小站]; I --> J[9.终端容量监控];
H --> I[8.扫小站出库码, 核对品类重量]; J --> K{是否达到清运阈值?};
I --> J[9.确认揽收, 运输至打包站]; K -->|是| L[10.自动派发清运任务];
K -->|否| M[继续接收废品];
end
subgraph 物流清运
L --> N[11.物流团队接收任务];
N --> O[12.前往终端清运];
O --> P[13.运输至处理中心];
end end
subgraph 管理后台 subgraph 管理后台
K[品类/价格管理] --> D; Q[终端设备管理] --> C;
F --> L[订单流水监控]; R[品类/价格管理] --> F;
G --> M[库存数据监控]; H --> S[交易流水监控];
I --> N[物流状态跟踪]; I --> T[库存状态监控];
J --> O[财务结算管理]; L --> U[物流任务管理];
P --> V[财务结算管理];
end end
``` ```
--- ---
## 3. C端居民端小程序 ## 3. 智能终端系统
**核心定位:让卖废品像收钱一样简单。** **核心定位:24小时无人值守的智能回收站。**
### 3.1 功能模块详述 ### 3.1 硬件组成详述
#### 3.1.1 登录/注册 #### 3.1.1 回收袋模块
- **需求**: 微信一键授权登录,自动创建账户,无需额外注册步骤。 - **配置**: 1-3个可配置回收袋根据场地大小和回收品类需求调整
- **分类**: 饮料瓶袋、废纸袋、织物袋,每个袋子有独立的称重传感器
- **容量**: 每个袋子设计容量约50-80升支持自动容量检测
#### 3.1.2 首页 (核心页面) #### 3.1.2 AI视觉监控
- **界面元素**: - **摄像头**: 高清摄像头,支持物品识别和分类验证
1. **【我的卖品码】**: 页面最中心、最大的按钮,点击后全屏显示个人专属二维码,并调高屏幕亮度。 - **功能**: 实时监控投入物品,防止异物污染,记录投入过程
2. **【附近小站】**: 列表或地图形式,展示附近合作小站的位置、**实时营业状态(营业中/休息中)、距离我有多远**、联系电话。 - **AI算法**: 基于深度学习的物品分类识别,准确率>95%
3. **【今日回收价】**: 醒目位置展示主要品类(纸壳、塑料瓶等)的单价(元/斤)。
#### 3.1.3 “我的”页面 #### 3.1.3 交互平板系统
- **界面元素**: - **规格**: 10-12寸触摸屏支持多点触控
1. **【我的余额】**: 突出显示当前账户余额。 - **功能**: 用户身份识别、操作引导、重量显示、交易确认
2. **【提现】(V1.1)**: 将余额提现至微信零钱。需进行实名认证。 - **登录方式**: 支持手机号、二维码扫描、NFC卡片等多种方式
3. **【交易记录】**: 列表形式,展示每一笔交易的时间、地点、品类、重量、金额。
4. **【联系客服】**: 提供客服电话或在线咨询入口。
#### 3.1.4 消息通知 #### 3.1.4 结构骨架
- **需求**: - **材料**: 铝合金框架,具备防水、防盗、耐候性能
- 交易成功后,收到模板消息推送,告知本次收入金额。 - **设计**: 模块化设计,便于运输安装和维护
- 提现成功后,收到模板消息推送。 - **安全**: 配备防撬锁、振动报警等安全措施
### 3.2 软件系统详述
#### 3.2.1 终端操作系统
- **界面**: 适老化设计,大字体、高对比度、语音引导
- **流程**: 登录→选择品类→投入物品→AI验证→称重计价→确认交易
- **离线**: 支持网络断开时的离线操作和数据缓存
#### 3.2.2 数据采集与上传
- **实时数据**: 称重数据、交易记录、设备状态、故障信息
- **定时上传**: 每10分钟向后台上传一次数据
- **异常报警**: 设备故障、满载、异常操作自动报警
--- ---
## 4. B端(小站端)小程序 ## 4. C端(用户端)小程序
**核心定位:高效的移动回收工作站。** **核心定位:便捷的个人回收助手。**
### 4.1 功能模块详述 ### 4.1 功能模块详述
#### 4.1.1 登录 #### 4.1.1 登录/注册
- **需求**: 由管理员在后台创建账号,站长通过“手机号+验证码”登录 - **需求**: 微信一键授权登录,自动创建账户,无需额外注册步骤
- **支持**: 同时支持手机号快速注册,便于在终端设备上使用。
#### 4.1.2 工作台 (首页) #### 4.1.2 首页 (核心页面)
- **界面元素**: - **界面元素**:
1. **开始回收】**: 核心操作按钮,点击进入扫码回收流程 1. **附近终端】**: 地图或列表形式,展示附近智能终端的位置、设备状态(正常/故障/满载)、距离
2. **【今日汇总】**: 数据卡片,展示当日回收总单数、总重量、总金额 2. **【今日回收价】**: 醒目位置展示主要品类(饮料瓶、废纸、织物)的实时单价
3. **库存盘点】**: 查看当前各类废品的库存重量。**当库存达到预警阈值时,系统应有明显提示。** 3. **快速回收】**: 一键跳转到最近的可用终端,并生成二维码用于终端登录。
4. **向上游交接】**: 生成出库单,**一键通知物流团队上门揽收**,并出示出库二维码 4. **我的余额】**: 显示当前账户余额和今日收入
#### 4.1.3 回收流程 (核心业务) #### 4.1.3 终端交互功能
1. **扫码识客**: 点击“开始回收”启动扫码器扫描C端用户的“卖品码”。成功后显示用户昵称 - **二维码登录**: 生成个人专属二维码,用于在终端设备上快速登录
2. **录入信息**: - **交易确认**: 接收终端发送的交易确认通知,可在手机上再次确认。
- **品类选择**: 大按钮形式选择“纸壳”、“塑料瓶”等 - **实时反馈**: 显示正在进行的交易状态,包括称重、计价过程
- **重量输入**: 手动输入称重后的重量。
- 系统自动计算金额并显示。
3. **确认交易**: 与用户核对无误后,点击“确认”。系统二次弹窗确认。
4. **语音播报**: 交易成功后,必须有清晰的语音播报,如“**收款成功5.8元**”,方便老年用户确认。
#### 4.1.4 账单与库存 #### 4.1.4 "我的"页面
- **账单**: 查看每日、每周的交易流水和收入汇总。 - **界面元素**:
- **库存**: 实时查看各品类库存,达到阈值时有提醒 1. **【我的余额】**: 突出显示当前账户余额和累计收入
2. **【提现】**: 将余额提现至微信零钱,支持实名认证。
3. **【交易记录】**: 列表形式,展示每一笔交易的时间、终端位置、品类、重量、金额。
4. **【设备反馈】**: 用户可对使用过的终端设备进行评价和故障反馈。
#### 4.1.5 消息通知
- **需求**:
- 交易成功后,收到模板消息推送,告知本次收入金额。
- 提现成功后,收到模板消息推送。
- 设备故障或维护通知推送。
--- ---
## 5. 物流端 (打包站/司机端) ## 5. 运维端 (设备维护)
**核心定位:精准、高效的废品“快递员”。** (初期可为H5页面或集成在B端小程序中) **核心定位:智能终端的"医生",确保设备正常运行。**
### 5.1 功能模块详述 ### 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 功能模块详述
#### 6.1.1 扫码确认入库 #### 6.1.1 实时监控大屏
- **需求**: 司机运抵大仓后,仓管员扫描司机任务单(或出库单)上的二维码 - **需求**: 在PC端或数据大屏上实时显示所有终端的运行状态、交易数据、库存情况
- **流程**: 系统自动带出司机、来源小站、货品品类及重量等信息。仓管员核对实物后确认,完成入库操作。库存数据自动更新 - **可视化**: 地图展示终端分布,状态色彩编码(绿色正常/黄色预警/红色故障)
- **告警**: 设备故障、满载、异常操作实时告警。
#### 6.1.2 实时库存监控 #### 6.1.2 数据分析中心
- **需求**: 在PC端或数据大屏上以可视化图表展示所有品类的实时库存量、库存周转天数、存放位置等。 - **需求**: 提供深度数据分析,包括用户行为分析、设备效率分析、收益分析等。
- **目标**: 为仓储规划和销售决策提供数据支持 - **报表**: 自动生成日报、周报、月报,支持数据导出
- **预测**: 基于历史数据预测设备维护需求、清运时间等。
#### 6.1.3 库管理 #### 6.1.3 库存汇总管理
- **需求**: 当与下游回收商(如打包站)达成交易后,可在系统中选择品类和重量,一键生成标准化的出库单 - **需求**: 汇总所有终端的库存数据,为集中清运和销售提供决策支持
- **凭证**: 出库单可打印,作为与下游结算和备货的依据 - **功能**: 库存预警、最优清运路线规划、销售时机建议
--- ---
## 7. 统一管理后台 (Web端) ## 7. 统一管理后台 (Web端)
**核心定位:公司的“大脑”,驱动业务运转。** **核心定位:智能终端网络的"指挥中心",驱动业务运转。**
### 6.1 功能模块详述 ### 7.1 功能模块详述
#### 6.1.1 Dashboard 数据看板 #### 7.1.1 Dashboard 数据看板
- **需求**: 实时展示核心KPI今日交易额、活跃用户数、**各小站回收量排名**、各品类回收趋势图等,形成数据驾驶舱 - **需求**: 实时展示核心KPI今日交易额、活跃用户数、**各终端设备回收量排名**、各品类回收趋势图、设备在线率等
#### 6.1.2 用户管理 #### 7.1.2 终端设备管理
- **需求**: 查询C端用户信息、交易记录、账户状态 - **需求**: 设备的入网配置、信息管理(**设备编号、地理位置、场地方信息、运行状态**)、地理位置分布图、设备状态监控
- **功能**: 远程设备重启、参数配置、软件更新推送。
#### 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) ## 9. 版本迭代规划 (Roadmap)
- **V1.0 (MVP)**: - **V1.0 (MVP)**:
- 核心功能: C端 + B端核心回收流程、管理后台基础框架品类价格、订单查看)。 - 核心功能: 智能终端硬件系统、C端小程序、基础管理后台设备监控、品类价格、订单查看)。
- 目标: 跑通“居民->小站”核心商业模式闭环 - 目标: 跑通"用户->智能终端"无人值守回收模式验证3000元/台设备的自循环盈利
- **V1.1**: - **V1.1**:
- 新增功能: 物流端H5、后台物流管理、后台小站管理、C端提现功能。 - 新增功能: 运维端APP、设备远程诊断、AI识别算法优化、C端提现功能。
- 目标: 引入物流角色,实现“小站->大仓”规范化清运 - 目标: 完善设备运维体系,提升设备稳定性和识别准确率
- **V1.2**: - **V1.2**:
- 新增功能: 大仓管理模块、后台财务结算模块、数据报表优化 - 新增功能: 数据分析中心、智能清运调度、财务自动结算、设备健康管理
- 目标: 完善全链路管理,提升运营和财务效率。 - 目标: 实现数据驱动运营,提升运营效率和设备利用率。
- **V1.3**: - **V1.3**:
- 新增功能: C端积分商城、精细化运营工具(如用户分层、活动配置)。 - 新增功能: 积分商城、社区互动、碳积分系统、多品类扩展(电子垃圾等)。
- 目标: 探索增值服务,提升用户粘性 - 目标: 构建环保生态圈,探索更多盈利模式

View File

@@ -15,25 +15,25 @@
### 1.2. 用户故事 ### 1.2. 用户故事
#### **故事1查看回收价格** #### **故事1查看回收价格和终端位置**
- **作为** 王大妈, - **作为** 王大妈,
- **我想要** 在出门前就能通过小程序看到今天纸壳子、塑料瓶卖多少钱一斤 - **我想要** 在出门前就能通过小程序看到今天各种废品的回收价格,以及最近的智能终端在哪里、是否正常运行
- **以便于** 我决定今天是否值得跑一趟,并且心里有底,不怕被坑 - **以便于** 我决定今天是否值得跑一趟,并且选择最方便的终端设备
#### **故事2找到最近的回收** #### **故事224小时随时回收**
- **作为** 刚搬来小区的年轻人小张, - **作为** 上班族小张,
- **我想要** 在小程序上用地图直接看到最近的回收站在哪,离我有多远,现在是否在营业 - **我想要** 下班后或周末任何时间都能使用智能终端处理家里的快递纸箱,不受营业时间限制
- **以便于** 我能快速方便地处理掉家里堆积的快递纸箱 - **以便于** 我能根据自己的时间安排处理废品,不用专门请假或赶时间
#### **故事3极速卖品** #### **故事3全自动回收体验**
- **作为** 王大妈, - **作为** 王大妈,
- **我想要** 到小站后让站长扫一下我的手机二维码他称重、确认后钱就能马上到我的小程序账户里并且能听到“收款成功5块8”这样的语音提醒 - **我想要** 在智能终端上用手机号登录后,按照屏幕提示选择废纸类型,把纸箱投入对应袋子,系统自动称重计价并语音播报"收款成功5块8毛"
- **以便于** 整个过程像在超市用付款码一样简单,不用我输密码、点确认,甚至不用掏手机看,听声音就知道交易成功了,非常安心 - **以便于** 整个过程像使用ATM一样简单不需要等人服务也不用担心被骗秤或算错账
#### **故事4查看我的收入** #### **故事4实时了解收益**
- **作为** 王大妈, - **作为** 王大妈,
- **我想要** 在“我的”页面清楚地看到我的账户里还有多少钱,并且能翻看每一笔卖废品的记录, - **我想要** 在手机小程序里实时看到交易完成的通知,查看我的账户余额变化和每笔交易的详细记录,
- **以便于** 我知道这个月靠卖废品攒了多少零花钱,感觉很有成就感 - **以便于** 我知道这个月通过智能终端攒了多少零花钱,对这种新方式更有信心
--- ---
@@ -71,59 +71,64 @@
--- ---
## 角色三:下站运输员 (物流司机) ## 角色三:设备运维人员
### 3.1. 核心诉求:路线清晰,任务明确,交接高效,权责分明 ### 3.1. 核心诉求:设备状态清晰,故障快速定位,维护高效便捷
#### **用户画像:张师傅** #### **用户画像:张师傅**
- **身份**: 35岁回收车队司机 - **身份**: 35岁智能终端设备运维工程师
- **习惯**: 每天需要跑多个点,时间观念强,不希望在交接流程上浪费时间 - **习惯**: 熟悉各种电子设备,有一定的技术基础,注重工作效率
- **痛点**: 路线规划不合理导致绕路,手写单据字迹潦草易出错,跟小站站长核对重量时偶尔会发生争执 - **痛点**: 设备分布较广需要跑多个点,故障诊断耗时,备件管理混乱,用户投诉处理压力大
### 3.2. 用户故事 ### 3.2. 用户故事
#### **故事1查看揽收任务** #### **故事1智能巡检任务**
- **作为** 运输员张师傅, - **作为** 运维工程师张师傅,
- **我想要** 在我的手机端H5或小程序看到今天所有需要去揽收的任务列表,并能一键开启导航, - **我想要** 在运维APP上看到系统根据设备状态自动生成的巡检任务包括设备位置、故障类型、优先级,并能一键导航,
- **以便于** 我可以合理规划路线,节省运输时间 - **以便于** 我可以高效规划巡检路线,优先处理紧急故障,提升设备可用率
#### **故事2无纸化扫码交接** #### **故事2远程诊断与现场维修**
- **作为** 运输员张师傅, - **作为** 运维工程师张师傅,
- **我想要** 到达小站后,直接扫描站长出示的出库二维码,手机上就能显示出待交接的品类和重量 - **我想要** 通过手机APP连接到智能终端远程查看设备各模块状态并获得故障诊断建议和维修指导
- **以便于** 我可以快速核对,确认无误后双方点击确认即可完成交接,无需手写单据,高效且有据可查 - **以便于** 我能快速定位问题,携带正确的备件前往现场,提高一次修复成功率
#### **故事3更新任务状态** #### **故事3设备清运与库存管理**
- **作为** 运输员张师傅, - **作为** 运维工程师张师傅,
- **我想要** 在完成揽收、运输、入库等关键节点时,能在手机上方便地更新任务状态 - **我想要** 当终端设备发出满载预警时能在APP上查看各袋子的准确重量并记录清运数据
- **以便于** 公司后台能实时了解我的工作进展,也方便了后续的流程协同 - **以便于** 我能合理安排清运车辆,确保数据准确性,避免与后台系统数据不一致
#### **故事4维修记录与绩效跟踪**
- **作为** 运维工程师张师傅,
- **我想要** 每次维修后能在APP上记录维修过程、更换的备件、维修时间并拍照存档
- **以便于** 建立完整的设备维护档案,也让我的工作成果得到准确记录和考核。
--- ---
## 角色四:大仓库管理员 ## 角色四:数据中心管理员
### 4.1. 核心诉求:入库清晰,库存准确,出库便捷 ### 4.1. 核心诉求:数据准确,监控全面,决策支持
#### **用户画像:赵主管** #### **用户画像:赵主管**
- **身份**: 50岁城市大仓的仓库主管。 - **身份**: 50岁智能终端网络数据中心主管。
- **习惯**: 工作严谨,对数据准确性要求高 - **习惯**: 工作严谨,善于数据分析,关注系统整体运行状况
- **痛点**: 司机运回来的货物品类和重量与预期不符,库存盘点耗时耗力,与下游打包站的销售记录对账困难 - **痛点**: 设备数量多分布广难以全面监控,数据异常发现不及时,缺乏有效的预测分析工具
### 4.2. 用户故事 ### 4.2. 用户故事
#### **故事1扫码确认入库** #### **故事1实时监控大屏**
- **作为** 仓库主管赵主管, - **作为** 数据中心主管赵主管,
- **我想要** 在司机把废品运到大仓时,我能扫描他任务单上的二维码,系统就自动记录某某司机在什么时间、从哪些小站运来了多少斤什么废品 - **我想要** 在数据中心的大屏上实时看到所有智能终端的运行状态、交易数据、库存情况,并用不同颜色标识设备健康状态
- **以便于** 我可以快速完成入库登记,保证数据的准确性,并自动更新仓库库存 - **以便于** 我能一目了然地掌握整个终端网络的运行情况,及时发现异常设备
#### **故事2实时库存监控** #### **故事2智能预警与分析**
- **作为** 仓库主管赵主管, - **作为** 数据中心主管赵主管,
- **我想要** 在后台系统的大屏或电脑上,实时看到仓库里所有品类的库存量、存放位置和存放天数 - **我想要** 系统能基于历史数据自动预测设备维护需求、最佳清运时间,并在设备即将出现故障前提前预警
- **以便于** 我可以合理规划仓储空间,并在某种废品库存达到一定数量时,及时安排出库销售 - **以便于** 我能提前安排运维资源,实现预防性维护,降低设备故障率
#### **故事3生成出库单** #### **故事3数据报表与决策支持**
- **作为** 仓库主管赵主管, - **作为** 数据中心主管赵主管,
- **我想要** 当联系好下游的打包站后,能在系统里选择品类和重量,一键生成标准化的出库单 - **我想要** 系统能自动生成各类运营报表,包括设备利用率、用户活跃度、收益分析等,并支持自定义查询和数据导出
- **以便于** 我可以指导工人备货,并作为与打包站结算的凭证,让整个出库流程规范化 - **以便于** 我能为公司管理层提供准确的数据支持,协助制定运营策略和扩张计划
--- ---

View File

@@ -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[待机界面<br>显示回收价格] --> B[用户登录<br>手机号/扫码]
B --> C[选择品类<br>塑料瓶/废纸/织物]
C --> D[投入物品<br>AI识别验证]
D --> E[自动称重<br>计算价格]
E --> F[确认交易<br>语音播报]
F --> G[交易完成<br>返回待机]
D --> H{识别失败}
H --> I[重新投入<br>或人工客服]
```
### 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信号测试
- [ ] 设备组装和摆放
- [ ] 平板应用安装和配置
- [ ] 称重设备校准
- [ ] 场地方培训和说明
- [ ] 试运行和用户体验测试
- [ ] 运营数据对接确认
---
**文档版权**: 绿邻回收项目组所有,未经授权不得转载或使用。