feat(tools): 新增台账管理功能模块

- 添加 addLedger API 接口定义和实现
- 创建工程配置表单组件 (EngineeringForm)
- 创建设备配置表单组件 (EquipmentForm)
- 创建项目和测点表单组件 (ProjectForm, LineForm)
- 实现台账树形结构面板 (LedgerTreePanel)
- 添加台账数据验证契约检查脚本
- 集成字典选项和动态表单验证功能
- 实现台账节点增删改查完整流程
- 优化 Echarts 图表组件分组渲染性能

frontend/src/api/tools/addLedger/check-api-debug-contract.mjs

@@ -0,0 +1,39 @@
+/* eslint-env node */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const currentDir = path.dirname(fileURLToPath(import.meta.url))
+const apiFile = path.join(currentDir, 'index.ts')
+const interfaceFile = path.join(currentDir, 'interface', 'index.ts')
+
+const apiSource = fs.readFileSync(apiFile, 'utf8')
+const interfaceSource = fs.readFileSync(interfaceFile, 'utf8')
+
+const expectations = [
+    ['equipment payload maps devType', /devType:\s*params\.dev_type/],
+    ['equipment payload maps devModel', /devModel:\s*params\.dev_model/],
+    ['equipment payload maps devAccessMethod', /devAccessMethod:\s*params\.dev_access_method/],
+    ['equipment payload maps nodeId', /nodeId:\s*params\.node_id/],
+    ['equipment payload maps nodeProcess', /nodeProcess:\s*resolveOptionalNumber\(params\.node_process\)/],
+    ['line payload maps lineId', /lineId:\s*resolveOptionalText\(params\.line_id\s*\|\|\s*params\.id\)/],
+    ['line payload maps lineNo', /lineNo:\s*params\.line_no/],
+    ['line payload maps volGrade', /volGrade:\s*params\.vol_grade/],
+    ['line payload maps ctRatio', /ctRatio:\s*params\.ct_ratio/],
+    ['line payload maps isGovern', /isGovern:\s*params\.is_govern/],
+    ['tree node supports parentId', /parentId\?:\s*string/],
+    ['tree node supports parentIds', /parentIds\?:\s*string/],
+    ['delete response type is boolean', /requestAddLedger<boolean>\('delete',\s*'\/node'/]
+]
+
+const failures = expectations.filter(([, pattern]) => !pattern.test(`${apiSource}\n${interfaceSource}`))
+
+if (failures.length) {
+    console.error('addLedger API_DEBUG contract check failed:')
+    for (const [name] of failures) {
+        console.error(`- ${name}`)
+    }
+    process.exit(1)
+}
+
+console.log('addLedger API_DEBUG contract check passed')