一、项目概述
本项目是 铁路客运站设备运维管理系统 的后端服务开发，基于 Spring Boot 3.2.0 + MyBatis-Plus 3.5.5 技术栈，采用 Java 21 语言开发。本人在第一阶段主要负责 配置管理子系统 的19个模块的后端开发工作。
二、典型用户模板
用户1：系统管理员
属性 描述 姓名 张明 年龄 35岁 职业 铁路客运站运维系统管理员 角色 系统管理员 使用场景 日常系统配置维护、数据管理 需求 需要便捷地管理车站、设备分类、巡检线路等基础配置数据 痛点 原有系统操作繁琐，数据维护效率低
用户2：运维工程师
属性 描述 姓名 李华 年龄 28岁 职业 铁路客运站设备运维工程师 角色 运维人员 使用场景 日常巡检、保养、故障处理 需求 需要快速查询设备信息、巡检路线、故障解决方案 痛点 故障定位困难，历史数据查询不便
用户3：备件管理员
属性 描述 姓名 王芳 年龄 32岁 职业 铁路客运站备件仓库管理员 角色 备件管理人员 使用场景 备件入库、出库、库存管理 需求 需要准确管理备件库位、型号、库存数量 痛点 备件种类繁多，查找困难
三、用户场景/故事模板
场景1：车站信息管理
场景名称 ：新增车站信息
场景描述 ：系统管理员张明需要为新开通的高铁站录入基础信息。
用户目标 ：快速完成车站信息的新增，包括车站编码、名称、地址、联系人等信息。
前置条件 ：系统已登录，具备管理员权限。
事件流 ：
- 张明登录系统，进入配置管理子系统
- 选择「车站管理」模块
- 点击「新增」按钮
- 填写车站编码： GZ-SZ-001
- 填写车站名称：「广州南站」
- 选择省份：广东省，城市：广州市
- 填写详细地址和联系电话
- 点击「保存」按钮
- 系统提示「新增成功」
后置条件 ：车站信息成功录入系统，可在列表中查看。
场景2：巡检线路配置
场景名称 ：配置日常巡检线路
场景描述 ：运维工程师李华需要为广州南站配置日常巡检线路。
用户目标 ：创建一条覆盖全站设备的巡检路线，设置巡检频次为每日两次。
前置条件 ：已存在车站信息，具备运维权限。
事件流 ：
- 李华登录系统，进入「巡检线路」模块
- 选择所属车站：广州南站
- 点击「新增巡检线路」
- 填写线路编码： INSP-GZ-001
- 填写线路名称：「广州南站日常巡检路线」
- 设置巡检频次：2次/天
- 描述：覆盖候车厅、站台、设备间等区域
- 保存线路配置
后置条件 ：巡检线路配置成功，可分配给巡检人员执行任务。
场景3：故障字典查询
场景名称 ：快速定位故障解决方案
场景描述 ：运维工程师李华在巡检中发现某台自动售票机故障，需要快速查询解决方案。
用户目标 ：根据故障现象快速定位故障类型，获取标准解决方案。
前置条件 ：故障字典已维护完成。
事件流 ：
- 李华发现自动售票机无法打印票据
- 登录系统，进入「故障字典」模块
- 搜索关键词：「打印」
- 找到匹配的故障条目：「打印机卡纸」
- 查看故障级别：一般故障
- 获取解决方案：「打开打印机舱门，清理卡纸，重启设备」
- 按照方案处理故障
后置条件 ：故障处理完成，记录处理结果。
场景4：备件库存查询
场景名称 ：查询备件库存
场景描述 ：备件管理员王芳需要查询某种型号电源模块的库存情况。
用户目标 ：快速定位备件位置，确认库存数量是否满足维修需求。
前置条件 ：备件信息已录入系统。
事件流 ：
- 王芳收到维修工单，需要领取电源模块
- 登录系统，进入「备件型号」模块
- 搜索备件型号：「PS-220V-500W」
- 查看库存数量：15件
- 查看库位信息：A区-03货架-05层
- 确认库存充足，准备出库
后置条件 ：备件出库单已创建，库存数量更新。
四、个人任务分工
第一阶段任务清单
序号 任务名称 状态 完成时间 1 需求分析与技术方案设计 ✅ 2025-02-15 2 项目基础框架搭建 ✅ 2025-02-18 3 实体类设计与创建（19个模块） ✅ 2025-02-22 4 Mapper接口开发 ✅ 2025-02-25 5 Service层开发 ✅ 2025-02-28 6 Controller层开发 ✅ 2025-03-03 7 API接口测试 ✅ 2025-03-05 8 验收页面开发 ✅ 2025-03-08
核心模块开发
本人负责的配置管理子系统包含19个模块：
分类 模块名称 API路径 基础配置 车站管理 /api/stations 网格管理 /api/grids 位置管理 /api/l