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