增加项目介绍文档和设备管理文档

Author: 600888

docs/.vitepress/config.ts

@@ -28,6 +28,13 @@ export default defineConfig({
         // 侧边栏
         sidebar: {
             '/guide/': [
+                {
+                    text: '关于项目',
+                    collapsed: false,
+                    items: [
+                        { text: '项目介绍', link: '/guide/about/project-introduction' }
+                    ]
+                },
                 {
                     text: '安装部署',
                     collapsed: false,
@@ -42,7 +49,8 @@ export default defineConfig({
                     text: '设备模块',
                     collapsed: false,
                     items: [
-                        { text: '协议支持', link: '/guide/device/protocols' }
+                        { text: '协议支持', link: '/guide/device/protocols' },
+                        { text: '设备管理', link: '/guide/device/device-management' }
                     ]
                 },
                 {
@@ -56,14 +64,14 @@ export default defineConfig({
                         { text: '公式使用', link: '/guide/point/formula' },
                         { text: '寄存器解析', link: '/guide/point/register-parsing' }
                     ]
-                },
-                {
-                    text: '操作手册',
-                    collapsed: false,
-                    items: [
-                        { text: '用户使用手册', link: '/guide/manual/user-manual' }
-                    ]
                 }
+                // {
+                //     text: '操作手册',
+                //     collapsed: false,
+                //     items: [
+                //         { text: '用户使用手册', link: '/guide/manual/user-manual' }
+                //     ]
+                // }
             ],
             '/api/': [
                 {

docs/.vitepress/theme/custom.css

@@ -170,4 +170,29 @@ section.VPSidebarItem.level-0,
 .VPSidebarGroup {
     padding-top: 12px !important;
     padding-bottom: 0 !important;
+}
+
+/* =========================================
+   自定义滚动条样式 (类似 Element UI)
+   ========================================= */
+*::-webkit-scrollbar {
+    width: 6px;
+    height: 6px;
+}
+
+*::-webkit-scrollbar-track {
+    background: transparent;
+}
+
+*::-webkit-scrollbar-thumb {
+    background: transparent;
+    border-radius: 3px;
+}
+
+*:hover::-webkit-scrollbar-thumb {
+    background: rgba(144, 147, 153, 0.3);
+}
+
+*::-webkit-scrollbar-thumb:hover {
+    background: rgba(144, 147, 153, 0.5) !important;
 }

docs/guide/about/project-introduction.md

@@ -0,0 +1,61 @@
+# 项目介绍
+
+## 个人介绍
+
+本人2023年毕业后，一直在杭州某新能源企业从事储能EMS能源管理系统开发工作。
+
+工作语言：C++、Python。
+
+主要工作内容：
+
+- Linux C++开发，Web后端
+- 电力通讯协议（Modbus、DL/T645-2007、IEC104、IEC61850）
+- 策略算法
+- 实时数据采集
+- 历史时序数据存储
+- 第三方平台对接（调度、云平台）
+
+## 项目背景
+- **开发初衷**：为什么要做这个 EMS Simulate 模拟器？
+
+  1. 公司没有测试环境，也很难搭建测试环境，真实环境搭建流程非常繁琐，而且成本很高。
+
+  2. 公司主要负责做集成，大项目EMS都是外采，只有部分小项目会分给内部EMS部门做，也就意味着部门其实拿不到什么资源，所以很多时候软件开发出来只能到项目现场调试，那么问题就会非常多，有些时候影响交付进度，容易吃到客户的投诉和内部交付部门的投诉。
+
+  3. 2023年开始我刚进到公司的时候，主要还是接的一些小型站控级的储能集装箱项目，一般在5-10MW左右，每个现场都是不同厂家的PCS、BMS、电表、保护设备等等，也就意味着每个现场都需要重新配置点表。同时不同现场还有各种定制化的需求，比如说：
+
+     - 有些项目要接虚拟电厂、客户云平台、地方调度等（对于EMS来说就是数据转发，通过IEC104协议或者Modbus协议）。
+     - 有些项目1个PCS拖2个BMS的，需要调整功率下发策略和保护策略。
+     - 设备有些时候是走串口服务器，有些时候是走交换机，有些时候是直连。接的设备有多有少，小项目可能就几个通道，大项目可能就是10几个通道甚至更多，EMS软件底层的通讯在面对如此复杂的场景，存在些许兼容性的问题，导致数据采集异常。
+
+     上面这些问题平时开发很难进行测试，传统的调试工具只能简单地测试通讯和验证协议，不能对实质业务进行测试。
+
+  4. EMS软件一直都在迭代升级，平时新版本更新到现场时经常出现问题，容易吃到客户投诉，双休日也经常会接到客户电话。
+
+  5. 这两年主要是做储能一体柜的EMS，但是和站控级EMS存在同样的问题，设备厂家经常更换，而且点位相比之前更加复杂，比如说下面一个点位包含了运行信息、并离网状态和故障错误。
+
+     ![](/doc-img/introduction/1.png)
+
+- **要解决的问题**：在实际开发或测试中遇到了哪些痛点？
+
+  1. 解决测试环境搭建困难，难以对EMS进行系统测试的问题。
+
+  2. 加快现场调试进度，能够更快更精准地定位问题。
+
+  3. 解决传统调试工具只能模拟单个设备、单种协议、无法跨设备进行数据同步的问题。
+
+  4. 解决传统调试工具无法进行场景模拟的问题。
+
+     例子1：给PCS下发开关机指令，会引发PCS运行状态测点变化。
+
+     例子2：国外的某个项目需要用到黑启动功能，也就是电网失电，EMS需要自动将PCS从并网模式切换到离网模式。电网失电这个场景的模拟可以是电网频率和电流变为0，然后引发一系列测点联动的变化，普通的调试工具很难做到。
+
+- **项目目标**：这个项目希望达到什么样的效果？
+
+  1. 可以帮助EMS开发者更方便地进行系统测试。
+  2. 现在工商储一体柜EMS大多数都是发到现场插4g卡到工控机上，连上网后远程进行调试。考虑到这个场景，项目开发采用WEB版本，可以在网页上使用该模拟工具，加快现场远程调试进度，方便定位问题。
+
+### 联系方式
+
+- QQ：1755696012
+- 微信：axaxax13579

docs/guide/device/device-management.md

@@ -0,0 +1,100 @@
+# 设备管理
+
+设备模块提供了对模拟器中设备和设备组的全面管理功能。本指南将介绍如何进行设备组管理、设备管理以及测点的导入操作。
+
+## 设备组管理
+
+设备组用于对相同类型或相同业务场景的设备进行逻辑分组，方便统一管理。
+
+### 添加设备组
+
+1. 在侧边栏，点击设备组区域的“添加”按钮。
+2. 填写设备组名称等基本信息。
+3. 点击“确定”保存。
+
+> ![](/doc-img/device/device-management/1.png)
+
+### 编辑设备组
+
+1. 选择需要编辑的设备组。
+2. 修改设备组的名称和信息。
+3. 点击“确定”保存修改。
+
+> ![](/doc-img/device/device-management/2.png)
+
+### 删除设备组
+
+1. 选择需要删除的设备组。
+2. 点击下拉列表，点击“删除”按钮，在弹出的确认框中确认删除操作。
+3. **注意**：删除设备组会包含它里面的设备以及测点。
+
+> ![](/doc-img/device/device-management/3.png)
+
+## 设备管理
+
+设备是模拟器中进行数据采集和控制的基本单元。
+
+### 添加设备
+
+1. 选中要添加设备的设备组。
+2. 点击“新增主站”或者“新增从站”按钮。
+3. 填写基本参数、连接参数等配置信息。
+4. 点击“确定”完成添加。
+
+> ![](/doc-img/device/device-management/4.png)
+
+### 编辑设备
+
+1. 在设备列表中点击选中需要编辑的设备。
+2. 在右侧修改设备的连接参数或基本信息。
+3. 点击上方“保存配置”按钮。
+
+> ![](/doc-img/device/device-management/5.png)
+
+### 删除设备
+
+1. 在设备列表中选择需要删除的设备，点击右键。
+2. 点击弹出的“删除”按钮。
+3. 确认后即从系统中移除该设备。
+
+> ![](/doc-img/device/device-management/6.png)
+
+## 导入测点
+
+为了方便快速配置设备的数据点，系统支持通过模板或文件批量导入测点信息。
+
+1. 在设备列表中，选择需要导入测点的目标设备。
+
+2. 点击“导入测点”按钮。
+
+3. 选择准备好的测点配置文件（通常为 Excel 文件）。
+
+   >![](/doc-img/device/device-management/7.png)
+
+4. 上传文件并确认导入。系统将自动解析并在该设备下生成对应的测点。
+
+   >![](/doc-img/device/device-management/8.png)
+
+## 设备控制
+
+### 启动设备
+
+1. 在左侧设备树中点击选中需要启动的设备。
+
+2. 在右侧的设备详情展示区，点击上方的主操作按钮“开启设备”。
+
+3. 设备状态将变更为“运行中”，开始与外部系统进行通讯和数据交互。
+
+   >![](/doc-img/device/device-management/9.png)
+
+### 关闭设备
+
+1. 在左侧设备树中点击选中正在运行的设备。
+
+2. 在右侧的设备详情展示区，点击上方的主操作按钮“停止设备”。
+
+3. 设备状态将变更为“停止”，设备连接断开，停止数据交互。
+
+   >![](/doc-img/device/device-management/10.png)
+
+