增加了设计，后台功能模块设计

2025-08-12 14:02:16 +08:00
parent feba423b16
commit e3a645d519
12 changed files with 882 additions and 74 deletions
--- a/01_设计/初步设计文档.md
+++ b/01_设计/初步设计文档.md
@@ -10,6 +10,15 @@

 ---

+## 0. 文档追踪
+
+| **评审状态** | **评审人** | **评审日期** | **备注** |
+| :--- | :--- | :--- | :--- |
+| 初稿 | Sean | 2025-08-08 | - |
+| 技术评审 | (待定) | (待定) | - |
+
+---
+
 ## 1. 项目概述

 ### 1.1 项目背景与核心矛盾
@@ -87,6 +96,9 @@ graph TD
 - **团队风险**:
  - **风险点**: 团队成员对 `NestJS` 或 `uni-app` 的熟练度可能不一。
  - **应对策略**: 在项目启动前安排1-2天的技术预研（Spike），统一代码规范和最佳实践。
+- **需求风险**:
+  - **风险点**: MVP开发期间出现重大需求变更，影响核心交付范围。
+  - **应对策略**: 建立需求变更控制流程。所有需求变更需经由产品、项目、研发三方共同评估影响后，再决定是否纳入当前版本。

 ---

@@ -211,13 +223,13 @@ CREATE TABLE transaction_items (
  - **目标**: 完成后端核心API开发与前端基础架构。
  - **后端**: 完成所有后台、C端、B端的API开发与单元测试。
  - **前端**: 完成项目脚手架搭建，各端登录、核心页面UI布局。
-  - **产出**: 后端API可供调用，前端页面静态可见。
+  - **产出**: **所有后端API通过单元测试并提供Swagger文档**，前端完成核心页面UI框架搭建。

 - **Sprint 2 (第三、四周)**:
  - **目标**: 完成前后端对接、联调测试与上线准备。
  - **前端**: 完成所有业务逻辑开发，与后端API全面对接。
  - **测试**: 执行端到端的核心流程测试用例，进行多轮Bug修复。
-  - **产出**: 功能完备、通过测试的MVP版本，可随时部署。
+  - **产出**: 功能完备、**通过核心流程E2E测试**的MVP版本，可随时部署。

 ### 6.2 资源分配 (建议)
 - **后端开发**: 1-2人
@@ -225,9 +237,19 @@ CREATE TABLE transaction_items (
 - **测试(QA)**: 1人 (在Sprint 2后半段集中投入)
 - **产品/项目**: 1人 (负责需求澄清、进度跟踪)

-### 6.3 沟通与协作
+### 6.3 关键里程碑 (Milestones)
+
+| **里程碑** | **预计完成日期** | **负责人** | **交付物** |
+| :--- | :--- | :--- | :--- |
+| M1: 项目启动与技术预研 | W1周三 | Alex | 项目计划、技术选型确认 |
+| M2: 后端API开发完成 | W2周五 | 后端Leader | 可供调用的API文档 |
+| M3: 前后端联调完成 | W4周三 | 前/后端Leader | 完成核心功能对接 |
+| M4: MVP版本测试完成 | W4周五 | QA Leader | 测试报告 |
+| M5: MVP正式上线 | W5周一 | Alex | 上线公告 |
+
+### 6.4 沟通与协作
 - **每日站会**: 每天上午10点，15分钟，同步进度、风险和阻塞点。
- **每周复盘**: 每周五下午，复盘本周进展，规划下周计划。
+- **每周复盘与演示**: 每周五下午，复盘本周进展，并**进行功能演示**，规划下周计划。
 - **协作工具**:
  - **任务管理**: Jira (或类似工具)
  - **即时沟通**: Slack / 钉钉
--- a/01_设计/后台功能模块.md
+++ b/01_设计/后台功能模块.md
@@ -0,0 +1,39 @@
+# 后台管理系统功能模块设计 V1.0
+
+> **设计者**: dev-manager
+> **依据文档**: 
+> - 《废品回收小程序产品需求文档 (PRD) V2.0》
+> - 《废品回收小程序 - 初步设计文档 V1.0》
+> - 《用户故事 - 绿邻回收项目》
+
+## 概述
+本设计旨在为“绿邻回收”项目提供一个全面、可扩展的后台管理系统功能模块规划。后台的核心定位是**公司的“大脑”**，为运营、管理、财务和技术团队提供数据支持和业务管控工具。
+
+---
+
+## 功能模块详细规划
+
+| 一级菜单 | 二级菜单 (页面) | 功能模块 | 细节描述 | 对应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 |
--- a/01_设计/废品回收小程序产品需求文档.md
+++ b/01_设计/废品回收小程序产品需求文档.md
@@ -91,7 +91,7 @@ graph TD
 #### 3.1.2 首页 (核心页面)
 - **界面元素**:
  1.  **【我的卖品码】**: 页面最中心、最大的按钮，点击后全屏显示个人专属二维码，并调高屏幕亮度。
-  2.  **【附近小站】**: 列表或地图形式，展示附近合作小站的位置、营业时间、联系电话。
+  2.  **【附近小站】**: 列表或地图形式，展示附近合作小站的位置、**实时营业状态（营业中/休息中）、距离我有多远**、联系电话。
  3.  **【今日回收价】**: 醒目位置展示主要品类（纸壳、塑料瓶等）的单价（元/斤）。

 #### 3.1.3 “我的”页面
@@ -121,8 +121,8 @@ graph TD
 - **界面元素**:
  1.  **【开始回收】**: 核心操作按钮，点击进入扫码回收流程。
  2.  **【今日汇总】**: 数据卡片，展示当日回收总单数、总重量、总金额。
-  3.  **【库存盘点】**: 查看当前各类废品的库存重量。
-  4.  **【向上游交接】**: 生成出库单，打印或出示出库二维码，等待物流端揽收。
+  3.  **【库存盘点】**: 查看当前各类废品的库存重量。**当库存达到预警阈值时，系统应有明显提示。**
+  4.  **【向上游交接】**: 生成出库单，**一键通知物流团队上门揽收**，并出示出库二维码。

 #### 4.1.3 回收流程 (核心业务)
 1.  **扫码识客**: 点击“开始回收”，启动扫码器，扫描C端用户的“卖品码”。成功后显示用户昵称。
@@ -158,23 +158,43 @@ graph TD

 ---

-## 6. 统一管理后台 (Web端)
+## 6. 大仓管理端 (Web/PC)
+
+**核心定位：业务流转的仓储枢纽，数据准确性的最终保障。**
+
+### 6.1 功能模块详述
+
+#### 6.1.1 扫码确认入库
+- **需求**: 司机运抵大仓后，仓管员扫描司机任务单（或出库单）上的二维码。
+- **流程**: 系统自动带出司机、来源小站、货品品类及重量等信息。仓管员核对实物后确认，完成入库操作。库存数据自动更新。
+
+#### 6.1.2 实时库存监控
+- **需求**: 在PC端或数据大屏上，以可视化图表展示所有品类的实时库存量、库存周转天数、存放位置等。
+- **目标**: 为仓储规划和销售决策提供数据支持。
+
+#### 6.1.3 出库管理
+- **需求**: 当与下游回收商（如打包站）达成交易后，可在系统中选择品类和重量，一键生成标准化的出库单。
+- **凭证**: 出库单可打印，作为与下游结算和备货的依据。
+
+---
+
+## 7. 统一管理后台 (Web端)

 **核心定位：公司的“大脑”，驱动业务运转。**

 ### 6.1 功能模块详述

 #### 6.1.1 Dashboard 数据看板
- **需求**: 实时展示核心KPI，如：今日交易额、总用户数、活跃小站数、各品类回收量趋势图等。
+- **需求**: 实时展示核心KPI，如：今日交易额、活跃用户数、**各小站回收量排名**、各品类回收趋势图等，形成数据驾驶舱。

 #### 6.1.2 用户管理
 - **需求**: 查询C端用户信息、交易记录、账户状态。

 #### 6.1.3 小站管理
- **需求**: 小站的入驻审核、信息管理、地理位置分布图、服务状态（营业/休息）管理。
+- **需求**: 小站的入驻审核、信息管理（**名称、地址、地理位置、负责人、营业时间**）、地理位置分布图、服务状态（营业/休息）管理。

 #### 6.1.4 品类与价格管理
- **需求**: 动态添加/修改回收品类，实时调整各品类在不同区域的回收单价。
+- **需求**: 动态添加/修改/停用回收品类，实时调整各品类在不同区域或站点的回收单价。**支持设置不同品类的物流损耗参数。**

 #### 6.1.5 订单与库存管理
 - **需求**: 查询全平台所有交易流水。实时监控各小站、各打包站的库存情况。
@@ -186,28 +206,39 @@ graph TD
 - **需求**: 管理与小站、物流司机的结算周期和账单，支持账单导出。

 #### 6.1.8 系统管理
- **需求**: 后台操作员的角色与权限管理。
+- **需求**: 后台操作员的角色与权限管理。**对异常登录行为进行告警**。
+
+#### 6.1.9 报警中心
+- **需求**: 集中查看和处理系统产生的各类业务异常报警（如库存异常、交易异常、物流延误），记录处理过程与结果，并支持上报给相关负责人。

 ---

-## 7. 非功能性需求
- **性能**: 扫码响应时间 < 1秒。页面加载时间 < 2秒。
+## 8. 非功能性需求
+- **性能**: 扫码响应时间 < 1秒。页面加载时间 < 2秒。系统核心接口可用性 > 99.9%。
 - **易用性**: C端和B端界面必须严格遵循“适老化”设计，大字体、高对比度、操作简单。
- **安全性**: 交易、支付、个人信息等敏感数据必须加密传输和存储。
+- **安全性**: 交易、支付、个人信息等敏感数据必须加密传输和存储。需有完善的权限管理体系，防止未授权访问。
 - **可扩展性**: 架构设计应支持未来新品类、新城市、新业务模式（如积分商城、上门回收）的快速扩展。
+- **可观测性 (Observability)**:
+    - **监控与告警**: 对服务器、数据库、核心接口等进行实时监控，并在出现异常（如CPU过高、响应超时）时，通过短信/邮件/企业微信发出告警。
+    - **日志管理**: 建立集中化的日志平台，支持按关键字、时间、服务模块快速检索日志，以便于高效排查问题。
+- **可维护性**:
+    - **版本更新与回滚**: 发布流程应支持一键回滚到上一个稳定版本。
+    - **容量规划**: 定期输出系统资源使用趋势报告，为扩容提供决策依据。

 ---

-## 8. 版本迭代规划 (Roadmap)
+## 9. 版本迭代规划 (Roadmap)
 - **V1.0 (MVP)**:
  - 核心功能: C端 + B端核心回收流程、管理后台基础框架（品类价格、订单查看）。
-  - 目标: 跑通商业模式闭环。
+  - 目标: 跑通“居民->小站”核心商业模式闭环。
 - **V1.1**:
  - 新增功能: 物流端H5、后台物流管理、后台小站管理、C端提现功能。
-  - 目标: 引入物流角色，实现规范化清运。
+  - 目标: 引入物流角色，实现“小站->大仓”规范化清运。
 - **V1.2**:
-  - 新增功能: C端积分商城、后台财务结算模块、数据报表优化。
-  - 目标: 探索增值服务，提升运营效率。
+  - 新增功能: 大仓管理模块、后台财务结算模块、数据报表优化。
+  - 目标: 完善全链路管理，提升运营和财务效率。
+- **V1.3**:
+  - 新增功能: C端积分商城、精细化运营工具（如用户分层、活动配置）。
+  - 目标: 探索增值服务，提升用户粘性。
+

---
-**文档结束**