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

- 重构了产品需求文档的章节组织和内容结构 - 改进了智能功能模块的文档格式和可读性 - 优化了一键邻回收和用户故事文档的排版 - 新增了完整的规格文档模板和内容框架 - 统一了文档风格和格式规范，提升文档质量
2025-09-15 14:07:29 +08:00
parent 8d228527d0
commit 450f08d05c
6 changed files with 743 additions and 280 deletions
--- a/01_设计/初步设计文档.md
+++ b/01_设计/初步设计文档.md
@@ -58,47 +58,69 @@
 ```mermaid
 graph TD
    subgraph 用户端 (User Layer)
-        C_MP[C端居民小程序<br>(uni-app / Vue.js)]
-        B_MP[B端小站小程序<br>(uni-app / Vue.js)]
+        C_MP[C端用户小程序<br>(uni-app / Vue.js)]
        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

    subgraph 网关层 (API Gateway)
-        Gateway[API Gateway<br>(Nginx)]
+        Gateway[API Gateway<br>(Nginx + Load Balancer)]
    end

    subgraph 后端服务 (Backend Service)
        Backend[后端应用服务器<br>(Node.js + NestJS)]
+        AIService[AI识别服务<br>(Python + TensorFlow)]
+        DeviceManager[设备管理服务<br>(MQTT Broker)]
    end

    subgraph 数据层 (Data Layer)
        DB[(PostgreSQL<br>核心业务数据)]
        Cache[(Redis<br>缓存/会话)]
+        TimeSeries[(InfluxDB<br>设备时序数据)]
    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` (维修记录)

 ---

--- a/01_设计/后台功能模块.md
+++ b/01_设计/后台功能模块.md
@@ -15,25 +15,29 @@

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


--- 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：数据报表与决策支持**
+- **作为** 数据中心主管赵主管，
+- **我想要** 系统能自动生成各类运营报表，包括设备利用率、用户活跃度、收益分析等，并支持自定义查询和数据导出，
+- **以便于** 我能为公司管理层提供准确的数据支持，协助制定运营策略和扩张计划。

 ---

--- a/01_设计/终端设备技术规格文档.md
+++ 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[待机界面<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信号测试
+- [ ] 设备组装和摆放
+- [ ] 平板应用安装和配置
+- [ ] 称重设备校准
+- [ ] 场地方培训和说明
+- [ ] 试运行和用户体验测试
+- [ ] 运营数据对接确认
+
+---
+
+**文档版权**: 绿邻回收项目组所有，未经授权不得转载或使用。