外观
17. 系统管理
17.0 快速上手：5 分钟创建新用户并分配角色权限
作为租户管理员，你需要为新入职的运维技术员创建一个系统账号并分配「技术员」角色。
前置条件：登录用户拥有 user:create 和 user:assign_role 权限。
Step 1：进入权限管理
点击左侧菜单「⚙️ 系统管理 → 🔐 权限管理」。→ 详见 §17.3.1
Step 2：打开用户标签页
确认当前在「用户管理」标签页下。→ 详见 §17.3.1.1
Step 3：新建用户
点击「新增用户」按钮 → 弹出新增用户表单 → 填写用户名、密码、姓名等信息 → 点击确定。→ 详见 §17.3.1.1
Step 4：为用户分配角色
在用户列表中找到刚创建的用户 → 点击「分配角色」按钮 → 弹出角色选择弹窗 → 勾选「技术员」角色 → 点击保存。→ 详见 §17.3.1.1
Step 5：验证权限
切换到「我的权限」标签页，可查看当前登录用户拥有的全部权限。新用户需要重新登录后生效。→ 详见 §17.3.1.4
💡 完成以上步骤后，你已掌握「新建用户 → 分配角色 → 验证权限」的核心链路。
17.1 功能概述
本章介绍「系统管理」菜单组下的十四个管理模块：
| 模块 | 定位 | 核心功能 |
|---|---|---|
| 权限管理 | 租户级用户与权限管控 | 用户管理（CRUD+分配角色+重置密码）、角色管理（CRUD+权限树配置）、数据权限规则分组、我的权限查看 |
| 审批流程管理 | 审批流定义与启停 | 创建/编辑/启停审批工作流，支持多步骤审批链，7 种业务类型（work_order_group 组合工单审批仅前端支持，后端枚举待同步） |
| 单据编号规则 | 统一编号规则配置 | 定义各类单据的编号规则（含重置策略/优先级）、序号管理、变更历史、生成日志 |
| 租户管理 | 跨租户管理（全局） | 创建/编辑/删除租户账套、配置租户数据库 → 跳转系统管理中心 |
| 运维监控 | 系统运维指标大屏 | 系统级运行指标实时监控面板 |
| 条码规则 | 条码格式匹配规则 | 条码规则 CRUD、条码解析测试、条码生成器（含条码图形渲染+PNG 下载） |
| 配置向导 | 引导式系统初始化 | 31 步向导式配置流程（8 个分组），逐步完成 CSV 导入与导航配置 |
| 数据导入 | 批量数据导入 | 21 种业务数据类型的 CSV 批量导入，含导入历史 |
| 定时任务管理 | 调度任务监控 | 查看/展开/触发/暂停/恢复系统定时任务，11 种内置任务类型 |
| 系统参数设定中心 | 白名单系统参数可视化维护 | 分类表单编辑（5 种控件）、连接测试（SMTP/企业微信/AI/OCR/地图）、变更审计、从 .env 导入、刷新运行配置 |
| 自定义字段管理 | 元数据驱动扩展字段 | 按作用域（设备/客户/工单/点检单）管理自定义字段定义，字段值保存在主表 extra_attributes JSON 列，不修改表结构 |
| 翻译管理 | 平台级 i18n 在线编辑 | 三语（中/英/日）并排在线校对，按 namespace/关键字/状态筛选，保存时自动校验占位符并热刷新生效 |
| 许可管理 | 租户自助许可视图（只读） | 许可信息与状态、安装池用户/设备用量、本租户配额确认、本租户实时在线用户 |
| 属性 Schema 设计器 | 设备类型属性模板设计 | 为设备类型可视化设计属性字段（类型/单位/必填/枚举项），LD 模板一键导入，JSON 实时预览 |
17.2 页面入口
- PC端：左侧菜单「⚙️ 系统管理」→ 展开子菜单选择对应模块
- 移动端：系统管理功能仅限 PC 端操作，移动端无直接入口
- 系统管理中心（超级管理员专属）：直接访问
/static/admin/index.html，提供租户管理、租户仪表盘、全局权限等跨租户管理功能
注意：系统管理菜单的可见性由权限控制。
system:config权限持有者可见全部子模块；部分模块（如审批流程管理、单据编号规则）由独立权限控制入口。
17.3 PC端操作
17.3.1 权限管理
「权限管理」是系统管理中功能最丰富的模块，包含四个标签页：用户管理、角色管理、数据权限、我的权限。
页面顶部展示 4 张统计卡片：
| 卡片 | 说明 |
|---|---|
| 角色数量 | 当前租户下的角色总数 |
| 权限数量 | 系统中全部可分配的权限点数 |
| 用户数量 | 当前租户下的用户总数 |
| 部门数量 | 当前租户下的部门总数 |
17.3.1.1 用户管理
用户管理标签页展示当前租户下的所有用户列表，支持搜索、新增、编辑、分配角色、重置密码和删除操作。
用户列表
| 列名 | 说明 |
|---|---|
| 用户名 | 登录账号 |
| 姓名 | 用户真实姓名 |
| 部门 | 所属部门名称（未分配时显示"未分配"提示文字） |
| 邮箱 | 用户邮箱地址（空时显示"-"） |
| 电话 | 联系电话 |
| 企业微信ID | 企业微信关联账号 |
| 操作 | 编辑、分配角色、重置密码、删除（按权限显示） |
搜索
用户列表上方提供搜索框，输入用户名关键字后回车搜索，按用户名模糊匹配筛选。
新增用户
点击「新增用户」按钮，弹出新增用户弹窗，包含以下表单字段：
| 字段 | 必填 | 说明 |
|---|---|---|
| 用户名 | ✅ | 登录账号，不可重复 |
| 密码 | ✅ | 用户登录密码 |
| 姓名 | 否 | 用户真实姓名 |
| 部门 | 否 | 从部门树选择所属部门 |
| 电话 | 否 | 联系电话 |
| 邮箱 | 否 | 电子邮箱 |
| 企业微信ID | 否 | 企业微信关联标识 |
| 职位 | 否 | 岗位名称 |
| 工号 | 否 | 员工编号 |
| 个人手机 | 否 | 个人手机号码 |
| 个人邮箱 | 否 | 个人邮箱 |
| 通讯地址 | 否 | 邮寄地址 |
| 紧急联系人 | 否 | 紧急情况联系人姓名 |
| 紧急联系电话 | 否 | 紧急情况联系电话 |
| 入职日期 | 否 | 入职时间 |
| 头像 | 否 | 用户头像上传（支持点击上传图片） |
编辑用户
在操作列点击「编辑」按钮，弹出编辑弹窗。表单字段与新增用户一致，可修改除用户名外的所有字段。
分配角色
点击「分配角色」按钮，弹出角色选择弹窗。展示系统中所有可用角色（含全局角色和租户角色），勾选后保存即可将角色赋予该用户。
重置密码
点击「重置密码」按钮，弹出密码输入弹窗，输入新密码后确认即可。
删除用户
点击「删除」按钮，弹出二次确认提示，确认后删除用户及关联数据。
17.3.1.2 角色管理
角色管理标签页采用左右分栏布局：左侧为角色卡片列表，右侧为选中角色的权限配置面板。
角色卡片列表（左侧）
每张角色卡片展示：
| 信息 | 说明 |
|---|---|
| 角色名称 | 角色显示名称（如"超级管理员""技术员"） |
| 角色编码 | 系统内部唯一编码（如 super_admin） |
| 角色标签 | 「系统」标签（蓝色，不可编辑/删除）、「🌐 全局」标签（跨租户）、「🏢 租户」标签（当前租户专属） |
| 用户数 | 已分配该角色的用户数量 |
| 权限数 | 该角色拥有的权限数量 |
点击角色卡片，右侧面板切换到该角色的权限配置视图。
权限配置面板（右侧）
选中角色后，右侧显示该角色的权限配置界面：
标题栏：显示角色名称 + "权限配置" + 已选权限数量
操作按钮：
- 「编辑」按钮（修改角色名称、描述、启用状态；系统角色按钮禁用）
- 「删除」按钮（系统角色按钮禁用）
- 「全选」按钮（一键勾选所有模块所有权限）
- 「清空」按钮（一键取消所有权限勾选）
- 「保存权限」按钮（提交权限变更，loading 状态）
权限树：按模块分组展示所有权限点，每个模块为独立卡片：
| 模块 | 权限示例 |
|---|---|
| 租户管理 | 创建租户、编辑租户、删除租户、禁用/启用租户、切换租户、管理租户用户 |
| 用户管理 | 创建用户、更新用户、删除用户、分配角色、重置密码、查看用户 |
| 角色管理 | 创建角色、更新角色、删除角色、分配权限、查看角色 |
| 部门管理 | 创建部门、更新部门、删除部门、查看部门、管理部门成员 |
| 设备管理 | 创建设备、更新设备、删除设备、查看设备、导入/导出设备、设备结构编辑、设备标签管理、设备历史 |
| 位置管理 | 创建位置、更新位置、删除位置、查看位置、管理地理信息 |
| 工单管理 | 创建工单、编辑工单、删除工单、查看工单、查看所有工单、分配工单、执行工单、完成工单、取消工单、审批工单、导出工单、评价工单 |
| 跨租户派单 | 跨租户派单、接受/拒绝派单、查看派单、管理租户关系 |
| 点检管理 | 查看/创建/更新/删除点检分类、点检项、模板分类、模板、计划；发布模板；执行点检；管理绑定；数据导入 |
| 维护管理 | 查看/创建/更新/删除/启停维护计划、更新计数器 |
| 库存管理 | 查看/管理库存、入库/出库操作、库存调整、成本调整；查看/创建/更新/删除备件 |
| 仓库/库位 | 查看/创建/编辑/删除仓库和库位 |
| 备件借用 | 查看备件借用、创建借用申请、审批备件借用 |
| BIM模型 | 查看BIM、上传BIM、删除BIM、管理设备映射 |
| 传感器/IoT | 查看/创建/更新/删除传感器、查看传感器数据、管理告警规则 |
| 报表分析 | 查看报表、导出报表、查看仪表盘、自定义仪表盘、仪表盘钻取；查看/创建/更新/删除/设计报表模板 |
| 成本管理 | 查看成本、管理费率与快照、导出成本、编辑费用明细 |
| 据点对比看板 | 查看据点对比看板、查看设备保全费排名 |
| 智能功能 | OCR识别、语音识别、RAG智能问答、预测性维护 |
| 知识库 | 查看知识库、管理知识库 |
| 客户档案 | 查看/创建/更新/删除客户分类、客户档案 |
| 供应商档案 | 查看/创建/更新/删除供应商分类、供应商档案 |
| 单据编号规则 | 查看/创建/修改/删除/启用禁用编号规则、查看序号/重置序号、查看生成日志、手动输入编号 |
| 条码规则 | 查看/创建/编辑/删除条码规则 |
| 审批管理 | 查看待审批、执行审批、查看/管理审批流程 |
| 定时任务管理 | 查看定时任务、手动触发、暂停/恢复/租户配置、修改全局配置 |
| 设备盘点 | 查看设备盘点、管理设备盘点 |
| 标签管理 | 查看标签模板、管理标签模板和打印 |
| 交接班管理 | 查看交接班、查看所有交接班、管理交接班 |
| 资质证书 | 查看资质证书、管理资质证书 |
| 排班管理 | 查看排班、管理排班、查看本人排班、撤回发布、查看统计、换班/请假/审批、自助调整班次时间 |
| 班次模板 | 查看班次模板、管理班次模板 |
| 工具资产 | 查看/创建/更新/删除工具 |
| 采购申请 | 查看/创建/编辑/审批采购申请、到货登记与入库 |
| 培训管理 | 查看/管理培训分类、课程、记录、计划、地图、统计；课时/题库/考试管理；AI出题、参加考试 |
| SOP关联 | 查看/管理SOP关联 |
| 个人工作台 | 查看个人工作台、管理收藏夹 |
| 系统管理 | 系统配置、查看系统/审计日志、导出审计日志、系统备份/恢复、数据导入、配置向导 |
| 移动端 | 移动端访问、查看/执行工单、执行点检、扫码、报修、GPS签到、拍照上传、电子签名、离线模式 |
每个权限点为复选框，勾选即赋予权限。模块标题行左侧有全选复选框，点击可一键选中/取消该模块下所有权限。右侧显示已选数量/总数（如 "2/5"）。
新建角色
点击「创建角色」按钮，弹出新增角色弹窗，填写角色名称、编码、描述后创建。支持从角色模板创建。
编辑角色
选中角色后点击「编辑」按钮，可修改角色名称、描述和启用状态。系统角色（is_system=true）的编辑按钮为禁用状态。
删除角色
系统角色不可删除。非系统角色点击「删除」按钮后弹出二次确认，确认后删除。
17.3.1.3 数据权限
数据权限标签页用于配置用户或角色对数据的访问范围控制。
页面布局：
- 信息提示栏：蓝色提示条，说明数据权限的作用
- 筛选表单：关键词输入框 + 目标类型下拉（全部/角色/用户）+ 资源类型下拉 + 范围类型下拉 + 搜索/重置按钮
- 数据规则分组卡片：按规则组展示
数据规则分组展示
每条数据规则以卡片形式分组展示：
| 展示信息 | 说明 |
|---|---|
| 分组名称 | 规则组名称 |
| 目标类型标签 | 蓝色="角色" / 绿色="用户" |
| 目标对象 | 具体的角色名称或用户名 |
| 范围标签 | 按部门 / 按位置 / 按设备类型 / 按客户分类 / 按客户 / 按仓库 |
| 条件提示 | 已配置的部门数、位置数、设备类型数、客户分类数、客户数、仓库数 |
| 资源类型标签组 | 该规则影响的业务资源（紫色标签，可逐个移除，带 + 添加按钮） |
每组卡片支持以下操作：
- 「✏️ 编辑」按钮：修改数据规则的条件配置
- 「🗑️ 删除」按钮：删除整组数据规则（二次确认，显示受影响的规则数）
- 「+」标签：为规则组添加新的资源类型
新建/编辑数据规则
点击「创建数据规则」按钮，弹出配置弹窗，包含以下字段：
- 规则名称
- 目标类型（角色 / 用户）
- 目标对象选择
- 范围类型选择
- 范围值选择（部门树/位置树/设备类型树/客户分类树等，支持 TreeSelect 选择器）
- 资源类型（多选）
- 规则类型（grant 授权并集 / restrict 限制交集）
- 描述
17.3.1.4 我的权限
「我的权限」标签页展示当前登录用户自身的权限概况，方便核查权限范围。
页面分为左右两栏：
左栏 — 基本信息卡片
| 信息 | 说明 |
|---|---|
| 用户ID | 当前登录用户的唯一标识 |
| 所属租户 | 当前操作的租户ID |
| 权限数量 | 绿色数字徽章显示当前拥有的权限总数 |
左栏 — 角色信息卡片
展示当前用户被分配的角色标签列表（蓝色标签）。无角色时显示空状态提示。
右栏 — 权限明细
按模块分组展示当前用户拥有的所有权限点：
- 每个模块显示模块名称 + 权限数量 + 绿色权限标签列表
- 权限点为已选（蓝色底色+边框）样式展示
17.3.2 审批流程管理
审批流程管理用于定义系统中的审批工作流，以卡片网格形式展示，支持创建、编辑、启停和删除。
页面布局
- 标题区：模块名称 + 描述文字
- 操作栏：「创建审批流程」按钮（需
approval:workflow:manage权限）+ 「刷新」按钮 - 空状态：当无工作流时展示空状态提示 + "立即创建"快捷按钮
- 流程卡片列表：3 列卡片网格（响应式 xs:24/sm:12/lg:8）
流程卡片内容
| 信息 | 说明 |
|---|---|
| 流程名称 | 工作流名称（16px 加粗） |
| 业务类型 | 关联的业务类型（12px 灰色文字） |
| 启用状态 | 绿色（success）"启用" 或 灰色（default）"禁用" 标签 |
| 步骤预览 | 审批步骤链预览文本 |
| 流程描述 | 工作流说明文字 |
操作按钮
| 按钮 | 说明 |
|---|---|
| 编辑 | 修改工作流（名称、类型、描述、审批步骤） |
| 启用/禁用开关 | 切换工作流的启用状态，调用 toggle API |
| 删除 | 删除工作流（二次确认弹窗） |
业务类型（7 种）
注意：其中
work_order_group（组合工单审批）当前仅前端支持选择，后端ApprovalBusinessType枚举尚未同步，提交该类型的审批工作流可能失败。
| 类型值 | 说明 |
|---|---|
work_order_create | 工单创建审批 |
work_order_group | 组合工单审批（⚠️ 后端枚举待同步） |
work_order_complete | 工单完成审批 |
equipment_scrap | 设备报废审批 |
spare_part_out | 备件出库审批 |
maintenance_plan | 维护计划审批 |
purchase_request | 采购申请审批 |
创建/编辑审批流程
弹出配置弹窗，包含以下字段：
- 流程名称：输入框
- 业务类型：下拉选择（7 种类型）
- 审批步骤：动态步骤列表，每步包含：
- 步骤名称
- 审批人类型：指定用户 / 指定角色 / 部门主管
- 审批人选择（根据类型联动）
- 审批模式：
any（或签，任一人审批即通过）/all（会签，所有人都需通过） - 添加步骤 / 删除步骤按钮
- 描述：文本输入
17.3.3 单据编号规则管理
单据编号规则管理用于定义系统中各类业务单据的自动编号规则，确保编号规范唯一。页面包含三个子面板：规则列表、生成日志、序号管理。
统计卡片
页面顶部 4 张统计卡片展示：
| 卡片 | 图标 | 说明 |
|---|---|---|
| 规则总数 | 📋 | 当前租户下编号规则总数 |
| 已启用 | ✅ | 状态为"启用"的规则数 |
| 已禁用 | ⏸️ | 状态为"禁用"的规则数 |
| 今日生成 | 🔢 | 当天生成的编号数量 |
规则列表标签页
表格列：
| 列名 | 说明 |
|---|---|
| 规则名称 | 两行显示：规则名称（加粗）+ 规则编码（灰色等宽字体） |
| 目标对象 | 蓝色标签显示目标类型名称 |
| 规则表达式 | 两行显示：模式表达式（蓝色等宽字体）+ 预览示例（绿色小字） |
| 重置策略 | 标签显示策略：不重置 / 按天重置 / 按月重置 / 按年重置 |
| 优先级 | 数字，居中显示 |
| 状态 | 开关组件，直接切换启用/禁用 |
| 操作 | 编辑 ✏️、序号状态 📊、变更历史 📜、删除 🗑️（按权限显示） |
筛选
- 按目标类型筛选（下拉框）
- 按启用状态筛选（下拉框：全部/启用/禁用）
生成日志标签页
需 doc:number:log:view 权限才可见。日志表格列：
| 列名 | 说明 |
|---|---|
| 生成时间 | 编号生成的时间戳 |
| 目标对象 | 目标类型名称 |
| 对象ID | 关联的业务对象ID |
| 生成编号 | 实际生成的编号值 |
| 规则编码 | 使用的规则编码 |
| 序号值 | 生成时的序号值（居中显示） |
| 类型 | 自动 / 手动 |
| 操作人 | 生成操作的用户名 |
支持按目标类型和日期范围筛选。
序号管理
操作列中点击「📊 序号状态」按钮，弹出序号状态弹窗，展示该规则的序号使用情况：
| 列名 | 说明 |
|---|---|
| 作用域 | 序号的作用范围标识 |
| 当前值 | 当前序号值 |
| 最大值 | 序号上限值 |
| 使用率 | 进度条 + 百分比（>90% 红色 / >70% 橙色 / 正常绿色） |
| 更新时间 | 序号最后更新时间 |
| 操作 | 重置按钮（需 doc:number:sequence:reset 权限，高危操作有二次确认） |
变更历史
操作列中点击「📜 变更历史」按钮，弹窗展示规则的变更记录列表。
17.3.4 租户管理
点击「租户管理」菜单项后，系统在 新窗口 中打开系统管理中心（/static/admin/index.html）。
系统管理中心需超级管理员登录验证：
登录后进入管理中心首页，展示：
统计概览（4 张卡片）
| 卡片 | 说明 |
|---|---|
| 租户总数 | 系统中所有租户数量 |
| 活跃租户 | 状态为活跃的租户数 |
| 用户总数 | 跨租户的用户总数 |
| 设备总数 | 跨租户的设备总数 |
功能模块入口（5 张卡片）
| 模块 | 说明 | 状态 |
|---|---|---|
| 🏢 租户管理 | 创建、编辑、管理租户账套，配置基本信息和状态 | 可用 |
| 📊 租户仪表盘 | 查看各租户使用统计（用户数、设备数、工单数等） | 可用 |
| 🔐 全局权限 | 管理跨租户的全局用户和权限配置 | 可用 |
| ⚙️ 系统配置 | 系统级全局配置（邮件、存储、安全等） | 即将推出 |
| 📋 操作日志 | 系统操作日志，追踪管理员操作记录 | 即将推出 |
快捷操作栏
| 操作 | 说明 |
|---|---|
| ➕ 创建新租户 | 跳转租户管理页 |
| 📊 查看统计 | 跳转租户仪表盘 |
| 🔄 刷新数据 | 重新加载统计概览 |
| 🏠 返回主系统 | 返回主系统页面 |
租户管理页面
点击「租户管理」卡片进入（tenant-management.html），支持：
- 创建新租户（配置租户名称、编码、数据库连接信息）
- 编辑租户基本信息
- 启用/禁用租户
- 删除租户
📌 复制模板数据的范围说明（2026-09 起）：创建租户选择「复制模板数据」时， 知识库 PDF 文档与知识条目会复制（自动换发新文档/条目标识，状态为「待处理」）， AI 问答对话历史不复制。复制后需在新租户「知识库与AI → PDF文档管理」点击 「批量重建 RAG 数据」，重建完成后文档与知识条目才能被 AI 问答检索到； 重建依赖 PDF 文件本体，创建租户时请勾选「复制文件」。 同理，删除租户时会自动清理该租户在向量检索索引中的全部数据。
租户仪表盘
点击「租户仪表盘」卡片进入（tenant-dashboard.html），查看各租户的使用情况统计对比。
全局权限
点击「全局权限」卡片进入（global-permission.html），管理跨租户的全局用户和权限配置。
17.3.5 运维监控
运维监控（菜单 key=metrics）展示系统级运维指标监控面板，为内嵌组件。
该模块提供系统运行状态、资源使用、服务健康等指标的实时监控视图。需 system:config 权限。
17.3.6 条码规则
条码规则管理用于维护条码格式匹配规则，支持扫码时自动识别备件和批次号，并提供条码生成功能。
页面布局（4 个区域）
| 区域 | 说明 |
|---|---|
| 顶部操作栏 | 标题 + 分类筛选下拉 + 刷新 + 新增规则 + 生成条码按钮 |
| 条码解析测试面板 | 输入条码内容进行解析测试，实时显示匹配结果 |
| 条码生成器面板 | 选择规则 → 填写参数 → 生成条码（可折叠面板，左侧蓝色边框） |
| 规则列表表格 | 条码规则的完整列表 |
规则列表列
| 列名 | 说明 |
|---|---|
| 规则名称 | 规则显示名称 |
| 分类 | 库存物料 / 设备资产 / 工单 / 备件 / 位置 / 自定义 |
| 条码类型 | Code128 等条码编码类型 |
| 正则表达式 | 匹配规则的正则表达式（可省略） |
| 示例值 | 规则匹配的条码示例（可省略） |
| 优先级 | 数字排序（支持列排序） |
| 启用 | 布尔值 |
| 操作 | 编辑 / 删除 |
条码解析测试
在输入框中输入条码内容（或粘贴扫码结果），回车或点击「测试解析」按钮：
- 匹配成功：绿色显示 ✅ 匹配成功 — 规则名称 + JSON 格式的解析字段详情
- 未匹配：红色显示 ❌ 未匹配到任何规则
条码生成器
展开生成面板后：
- 步骤 1：选择规则：下拉选择带生成模板的规则（可搜索，显示规则名+分类标签），无可用规则时黄色提示
- 步骤 2：填写字段值：按模板要求的占位符字段填写值（内置变量
{date}{datetime}{year}{month}{day}自动填充） - 步骤 3：生成：点击「🏷️ 生成」按钮
- 成功时显示：条码内容（大号蓝色等宽字体）+ 📋 复制按钮 + ⬇️ 下载PNG 按钮 + 条码图形渲染 + 正则验证警告（如有）
- 失败时显示：红色错误信息
规则管理
每条规则包含字段：规则名称、分类、条码类型、正则表达式、解析模板、分隔符、字段映射（JSON）、生成模板、示例值、描述、优先级、启用状态。支持新增、编辑、删除操作。
17.3.7 配置向导
配置向导是一个引导式系统初始化工具，帮助新租户按阶段逐步完成基础数据的导入和配置。
配置完成度仪表盘
页面顶部展示：
- 圆形进度环：必填项完成度百分比
- 智能推荐：蓝色提示条，建议下一步操作
- 分组状态列表：按 8 个分组展示各配置项的完成状态：
- ✓ 绿色 = 已完成
- ○ 灰色 = 可选项（非必填）
- ! 黄色 = 未完成（必填项）
- 每项显示名称 + 记录数 + 状态消息 + 「去配置」快捷按钮
32 步向导步骤
点击「开始配置向导」后进入步骤导航：
| 分组 | 步骤 | 内容 | 必填 |
|---|---|---|---|
| 组织架构与客户 | 1 | 导入部门 | 否 |
| 2 | 导入用户 | 否 | |
| 3 | 导入客户分类 | 否 | |
| 4 | 导入客户 | 否 | |
| 位置与设备 | 5 | 导入位置 | ✅ |
| 6 | 导入设备类型 | ✅ | |
| 7 | 导入设备型号 | 否 | |
| 8 | 导入设备 | ✅ | |
| 仓库与供应链 | 9 | 导入仓库/库位 | 否 |
| 10 | 导入供应商分类 | 否 | |
| 11 | 导入供应商 | 否 | |
| 12 | 导入制造商字典 | 否 | |
| 13 | 导入备件档案 | 否 | |
| 点检配置 | 14 | 导入点检分类 | 否 |
| 15 | 导入点检项目 | ✅ | |
| 16 | 导入模板分类 | 否 | |
| 17 | 导入点检模板 | ✅ | |
| 18 | 模板设备绑定 | 否 | |
| 19 | 导入绑定设定 | 否 | |
| 计划启用 | 20 | 导入点检计划 | 否 |
| 21 | 导入维护计划 | 否 | |
| 22 | 配置点检计划 | ✅ | |
| 23 | 分配执行人 | ✅ | |
| 设备结构与标签 | 24 | 导入设备标签 | 否 |
| 25 | 导入设备结构 | 否 | |
| 26 | 导入结构版本 | 否 | |
| 27 | 导入结构节点 | 否 | |
| 传感器与3D | 28 | 导入传感器定义 | 否 |
| 29 | 导入告警规则 | 否 | |
| 30 | 导入3D占位符 | 否 | |
| 系统配置 | 31 | 导入条码规则 | 否 |
| 32 | 导入编号规则 | 否 |
💡 完整向导第 6 步「导入设备类型」页面顶部有「可选：先导入行业模板包（推荐）」卡片，可直接导入行业模板包（含模板、点检项、设备类型与绑定），导入成功后显示按设备类型绑定/兜底模板统计，并自动标记设备类型/型号/点检模板步骤完成；后续 CSV 导入步骤可按需跳过。该入口为内嵌卡片，不新增向导步骤、不改变步骤编号与断点续配。
步骤操作
| 操作 | 说明 |
|---|---|
| 下载空白模板 | 下载当前步骤对应的空 CSV 模板；步骤 6/8 设备相关步骤可下载带类型/型号下拉的 Excel 模板 |
| 导出现有数据 | 导出已有数据为 CSV（可用于修改后重新导入或跨租户迁移） |
| 上传 CSV / Excel | 系统导入中心步骤（第 1~13、24~31 步）支持 .csv/.xlsx/.xls；点检配置步骤（第 14~19 步）支持 CSV |
| 预览确认 | 表格预览上传数据，显示已解析记录数和缺失必填字段提醒 |
| 执行导入 | 勾选「更新已存在的记录」后执行，显示新增/更新/跳过/失败数量 |
| 上一步/下一步 | 在步骤间切换 |
| 跳过此步 | 跳过非必填步骤 |
| 标记为已完成 | 手动标记导航型步骤（如步骤 21、22）为完成 |
导航型步骤（22—配置点检计划、23—分配执行人）展示蓝色提示结果页（info 风格），包含说明文字 + "前往配置"按钮（两者均跳转到「点检计划」页面）+ "标记为已完成"按钮。
精简向导（Lite 模式）
除 32 步完整向导外，系统还提供 4 步精简向导，面向快速开业场景：
| 步骤 | 内容 | 包含导入项 |
|---|---|---|
| 1 | 建组织 | 导入部门、导入位置 |
| 2 | 导设备 | 可选：先导入行业模板包（推荐）；导入设备类型/型号（模板包导入后自动完成）与设备档案（设备 Excel 模板类型/型号列带下拉；页面含机构维度提示：parent_code/is_component 两列填法，可链接查看字段说明） |
| 3 | 套模板 | 保留 CSV 点检模板导入：第 2 步已导模板包时可导出模板 CSV 修改后重新导入或直接下一步；第 2 步未导时可下载空白 CSV 模板填写后导入。导入后显示绑定/兜底统计 |
| 4 | 发账号 | 导入用户 |
- 许可限定模块的安装默认进入精简向导，否则默认完整向导；两种模式可在页面内手动切换，选择会被记住
- 精简向导中未覆盖的配置项，点击时会提示并自动切换到完整向导的对应步骤
- 跳过引导后可随时从「系统管理 → 配置向导」继续，向导支持断点续配
- 精简向导「导设备」步提示：
parent_code（父设备编码）与is_component（机构标记）两列，is_component=1表示机构/组件，填写parent_code自动挂接父装备结构树，留空为独立机构；机构设备走免签字链路 - 第 2 步先导入行业模板包后，行业设备类型/型号自动落入本步档案，设备 Excel 模板的类型/型号下拉会自动带出；第 3 步离开时若点检模板仍未完成会轻提示（不阻断）
17.3.8 数据导入
数据导入模块提供统一的 CSV 批量导入入口，按分组标签页展示 21 种业务数据类型的导入功能。
导入说明
页面顶部提供可折叠的导入说明面板：
- 表头红色加粗带 * 的为必填字段
- id 列及 _id 后缀列为可选，新建时留空自动生成
- 支持跨租户迁移（导出 → 导入）
- 推荐导入顺序：部门 → 用户 → 客户分类 → 客户 → 位置 → 设备类型 → 设备 → ...
- 若 CSV 中同时提供
_id和对应_code，系统优先使用_id
导入类型标签页（21 种，6 个分组）
| 分组 | 数据类型 | 说明 |
|---|---|---|
| 组织架构与客户 | 部门 | 部门名称、编码、上级部门、主管 |
| 用户 | 用户名、姓名、部门、角色 | |
| 客户分类 | 分类名称、编码 | |
| 客户档案 | 客户名称、分类、联系方式 | |
| 位置与设备 | 位置档案 | 位置名称、编码、上级位置 |
| 设备类型 | 类型名称、编码、上级类型 | |
| 设备档案 | 设备编号、名称、类型、位置、部门 | |
| 仓库与供应链 | 仓库/库位 | 库位名称、编码、上级库位 |
| 供应商分类 | 供应商分类名称、编码 | |
| 供应商档案 | 供应商名称、分类、联系方式 | |
| 制造商字典 | 制造商名称、编码 | |
| 备件档案 | 备件编码、名称、规格、单位 | |
| 设备结构与标签 | 设备标签 | 标签名称、颜色、描述 |
| 设备结构 | 结构名称、编码、设备关联 | |
| 结构版本 | 版本名称、结构关联 | |
| 结构节点 | 节点名称、排序号、父节点 | |
| 传感器与3D | 传感器定义 | 传感器名称、类型、设备 |
| 传感器告警规则 | 规则名称、条件、级别 | |
| 3D占位符 | 占位符名称、位置、尺寸 | |
| 系统配置 | 条码规则 | 规则名称、正则、分类 |
| 编号规则 | 规则名称、模式、目标类型 |
每个标签页提供：
- 下载/导出按钮（下拉）：下载空白 CSV 模板 / 导出现有数据为 CSV
- 文件拖拽上传区：支持 UTF-8 或 GB2312 编码的 CSV 文件
- 数据预览：上传后表格预览 + 蓝色提示（已解析 N 条记录 + 缺少必填字段警告）
- 执行导入：勾选「更新已存在的记录」后点击执行，显示导入结果
导入结果
执行完成后展示结果卡片：
- 成功（绿色）：显示新增/更新/跳过/失败行数
- 警告（黄色）：当有失败行时，可展开查看错误详情（前 10 条行级错误）
导入历史
页面底部展示最近导入记录表格：
| 列名 | 说明 |
|---|---|
| 类型 | 导入的数据类型 |
| 文件名 | 上传的 CSV 文件名（省略） |
| 新增 | 新增行数 |
| 更新 | 更新行数 |
| 失败 | 失败行数 |
| 状态 | 成功/部分成功/失败 |
| 时间 | 导入开始时间 |
17.3.9 定时任务管理
定时任务管理提供系统所有后台调度任务的状态监控和管理功能。
统计卡片（4 张）
| 卡片 | 说明 |
|---|---|
| 运行中 | 当前活跃的定时任务数（绿色数字） |
| 已暂停 | 已暂停的任务数（灰色数字） |
| 总任务数 | 系统中所有任务数 |
| 调度器状态 | 绿色标签"调度器运行中"或红色标签"调度器未启动" |
筛选栏
| 筛选 | 选项 |
|---|---|
| 分类筛选 | 全部分类 / 计划触发 / 缓存同步 / 告警检查 / 分析计算 / 资产管理 / 系统维护 / 人员管理 |
筛选后显示「任务清单：共 N 个任务」计数。
任务列表
| 列名 | 说明 |
|---|---|
| 任务名称 | 内置任务的中文显示名称 |
| 分类 | 彩色标签（7 种分类各不同颜色） |
| 触发频率 | 如"每 5 分钟""每天 02:00" |
| 状态 | 徽标：🟢 就绪 / 🔵 运行中 / ⚪ 已暂停 / 🔴 异常 |
| 上次执行 | 时间 + 结果标签：OK / 部分失败 / FAIL |
| 下次执行 | 下次计划执行时间（无则为灰色） |
| 总执行次数 | 累计执行次数 |
| 失败次数 | 累计失败次数（红色加粗高亮） |
| 操作 | 立即执行 / 暂停 / 恢复 / 展开 |
内置任务（11 种）
| 任务ID | 显示名称 | 分类 |
|---|---|---|
maintenance_plan_trigger | 维护计划定时触发 | 计划触发 |
inspection_plan_trigger | 点检计划定时触发 | 计划触发 |
binding_cache_refresh | 绑定矩阵缓存刷新 | 缓存同步 |
binding_alert_check | 绑定告警检查 | 告警检查 |
health_score_calculation | 设备健康评分计算 | 分析计算 |
predictive_maintenance_prediction | 预测性维护自动预测 | 分析计算 |
equipment_lifecycle_alert | 设备生命周期预警 | 资产管理 |
data_cleanup | 历史数据清理 | 系统维护 |
mandatory_inspection_alert | 特种设备强检预警与工单生成 | 告警检查 |
certification_expiry_alert | 资质证书到期预警 | 人员管理 |
inventory_alert_check | 库存预警检查 | 告警检查 |
操作按钮
| 按钮 | 权限要求 | 说明 |
|---|---|---|
| 立即执行 | scheduler:execute | 手动触发任务（loading 状态） |
| 暂停 | scheduler:manage | 暂停正在运行的任务 |
| 恢复 | scheduler:manage | 恢复已暂停的任务 |
| 展开 | 无 | 展开/收起任务详情（当前任务高亮行） |
17.3.10 系统参数设定中心
「系统参数设定中心」用于租户级系统参数的在线确认与设定。采用白名单机制，仅允许管理预定义的配置项，敏感项只写不读，所有修改写入审计日志。
页面入口：PC 端「⚙️ 系统管理 → ⚙️ 系统参数」。需 system:config 权限。
17.3.10.1 页面布局
采用左右分栏布局：
- 左侧分类导航：按功能域分为 8 个分类 + 1 个变更记录入口：
| 分类 | 包含配置项示例 |
|---|---|
| 基础开关 | 功能启用/禁用类开关 |
| 业务流程 | SHIFT_DISPATCH_ON_DUTY_ENABLED（排班当班约束）、WORK_ORDER_QUALIFICATION_CHECK_ENABLED（作业资质校验）等 |
| 通知集成 | SMTP 邮件配置、企业微信通知配置 |
| AI 与 RAG | AI 模型配置、RAG 知识库配置 |
| OCR 与地图 | OCR 服务配置、地图 API 配置 |
| 文件与上传 | 文件存储配置、上传限制配置 |
| 基础设施 | 数据库主机/端口/库名等连接参数 |
| 安全 | JWT 密钥等核心安全参数 |
- 右侧配置表单：选中分类后展示该分类下所有配置项，按卡片形式排列
- 顶部操作栏：4 个全局操作按钮（→ §17.3.10.4）
注意：系统参数设定中心仅限 PC 端，移动端无入口。
17.3.10.2 配置项类型与操作
每个配置项根据其定义的数据类型，使用不同的表单控件：
| 控件类型 | 说明 | 示例 |
|---|---|---|
| Switch（开关） | 布尔值配置，蓝色滑块开关 | 功能启用/禁用 |
| InputNumber（数字） | 整数或小数输入，带步进按钮 | 超时秒数、阈值百分比 |
| Select（下拉选择） | 枚举值，从预定义选项中选择 | 日志级别、加密算法 |
| Input（文本输入） | 普通字符串输入 | URL 地址、API Key 前缀 |
| InputPassword（密钥） | 密码/密钥类型，输入框为 password 类型，脱敏展示 | SMTP 密码、API Secret |
密钥类配置项的特殊处理：
- 页面展示为带「🔒 已配置」或「⚠️ 未配置」标签的密码输入框
- 默认显示为空，不返回实际存储值
- 输入新值后保存生效，留空不修改已配置的密钥
17.3.10.3 标签体系
每个配置项左侧显示多个标签，帮助管理员了解该配置项的特性：
| 标签 | 颜色 | 含义 |
|---|---|---|
| 只读 | 灰色（默认色） | 仅可查看，不可修改（如 SECRET_KEY、DATABASE_URL 等核心安全参数） |
| 敏感 | 红色 | 含敏感信息，列表接口不返回明文，仅显示「已配置」/「未配置」 |
| 需重启 | 橙色 | 修改后需重启服务才生效 |
| 系统级 | 紫色 | 由系统全局统一维护，租户不可修改 |
| 租户级 | 蓝色 | 各租户独立设定，互不影响 |
| 数据来源 | 见下方 | 标识当前生效值的来源 |
「数据来源」标签有 5 种取值：
| 来源标签 | 颜色 | 说明 |
|---|---|---|
| 数据库 | 蓝色 | 值存储在数据库中，由本页面或其他途径写入 |
| 环境变量 | 绿色 | 值从 .env 文件的环境变量读取 |
| 环境导入 | 灰色（默认色） | 通过「从 .env 导入」功能从 env.copy 文件导入到数据库 |
| 页面保存 | 灰色（默认色） | 最近一次修改通过本页面的「保存变更」按钮提交 |
| 默认值 | 灰色（默认色） | 使用代码中预定义的默认值 |
17.3.10.4 操作按钮详解
顶部工具栏（4 个全局按钮）：
| 按钮 | 图标 | 说明 |
|---|---|---|
| 从 .env 导入 | 📥 | 从项目根目录的 env.copy 文件中读取白名单配置项，批量写入数据库。导入时跳过只读项和敏感项 |
| 刷新运行配置 | 🔄 | 通知后端服务重新加载所有配置缓存，使最近保存的变更立即生效（无需重启） |
| 重新读取列表 | 🔃 | 重新向后端请求最新的配置项列表，刷新当前页面显示 |
| 保存变更 (N) | 💾 | 提交所有未保存的修改，N 为未保存的变更数量。无变更时按钮禁用（灰显），显示的变更数量为 0 |
分类卡片内操作：
| 按钮 | 说明 |
|---|---|
| 撤销未保存 | 撤销当前分类下所有未保存的修改，恢复为最近一次保存的值 |
页面顶部提示条：
- 当存在标记「需重启」的配置项被修改时，页面顶部显示黄色提示条："部分修改的配置项需要重启服务才能生效，建议保存后执行重启操作"
- 无保存操作权限时，所有配置项显示为只读控件，顶部工具栏仅保留「重新读取列表」按钮
17.3.10.5 连接测试
部分分类支持连接测试功能，在填写相关配置后验证连通性：
| 测试类型 | 所属分类 | 测试内容 |
|---|---|---|
| SMTP 邮件测试 | 通知集成 | 使用当前填写的 SMTP 配置发送一封测试邮件到指定邮箱 |
| 企业微信测试 | 通知集成 | 使用当前填写的企业微信配置发送一条测试通知消息 |
| AI 连通测试 | AI 与 RAG | 测试 AI 模型 API 是否可连通（发送简单 ping 请求） |
| OCR 鉴权测试 | OCR 与地图 | 测试 OCR 服务的鉴权信息是否有效 |
| 地图 API 测试 | OCR 与地图 | 测试地图 API 是否可正常调用 |
连接测试结果以弹窗形式展示：成功时显示绿色 ✅ + 响应耗时；失败时显示红色 ❌ + 错误详情。
17.3.10.6 变更记录
左侧导航最下方的「变更记录」Tab 可查看所有配置修改的审计日志。
变更记录表格（6 列）：
| 列名 | 说明 |
|---|---|
| 配置键 | 修改的配置项 key |
| 旧值 | 修改前的值（敏感项脱敏显示为 ***） |
| 新值 | 修改后的值（敏感项脱敏显示为 ***） |
| 修改人 | 执行修改操作的用户名 |
| 来源 | 数据来源标签（数据库 / 环境导入 / 页面保存 等） |
| 时间 | 修改发生的精确时间 |
支持按配置键关键词、修改人、来源类型、时间范围进行筛选。
17.3.10.7 关键业务流程开关
以下两个租户级开关是系统参数设定中心中影响业务操作的核心配置项，均位于「业务流程」分类下：
| 配置键 | 默认值 | 功能说明 | 参考章节 |
|---|---|---|---|
SHIFT_DISPATCH_ON_DUTY_ENABLED | false | 开启后，工单派单时负责人候选列表默认仅显示当前部门+时间的当班人员 | Ch15 §15.7.1 |
WORK_ORDER_QUALIFICATION_CHECK_ENABLED | false | 开启后，工单分配时实时校验执行人是否满足该工单风险等级所需的作业资质 | Ch14 §14.11 |
注意：两个开关为租户级，各租户独立设定。默认关闭，开启后立即在工单分配弹窗和移动端快捷分配中生效。
17.3.10.8 安全说明
- 敏感项只写不读：密钥类配置项（
is_sensitive=true）在列表中仅显示脱敏值***，接口不返回明文 - 白名单机制：后端只接受预定义配置项白名单中的 key，拒绝写入未注册的 key，防止非法配置注入
- 核心安全参数保护：
SECRET_KEY、DB_PASSWORD等核心安全参数标记为只读，不可在线修改 - 需重启提示：修改标记「需重启」的配置项后，页面顶部显示黄色提示条
- 审计日志：所有修改写入
system_config_audit_logs表，可通过「变更记录」Tab 查看完整历史
17.3.10.9 AI 与 RAG 区块（租户级 LLM 配置）
「AI 与 RAG」分类使用专属布局（区别于其他分类的通用卡片列表），专用于配置各租户自己的大模型（LLM）服务。页面从上到下依次为：顶部状态指示 → 总开关 → 提供商选择 → 各提供商密钥与参数 → 共享参数。
顶部三态配置状态指示：一条彩色横幅，说明当前租户 LLM 的实际生效状态：
| 状态 | 颜色 | 含义 |
|---|---|---|
| ⚪ 总开关未启用 | 灰 | 「启用租户 LLM 自定义」总开关关闭，所有租户统一使用平台 LLM 服务 |
| 🟢 已启用 | 绿 | 已使用本租户自己的 LLM 配置（租户库中有可用 API 密钥） |
| 🟡 配置不完整 | 黄 | 已选定某提供商但该提供商密钥未填写，附「去补 Key」引导按钮 |
| ⚪ 未配置（正式 SaaS） | 红 | 正式 SaaS 订阅租户需使用自有 LLM，配置完成前 AI 功能不可用 |
| ⚪ 未配置 | 灰 | 尚未配置租户自有 LLM，使用平台 LLM 服务 |
「🟡 配置不完整」分两种提示：
- 缺 Key：已选定某提供商，但该提供商密钥未填写
- 错配：已选定某提供商，但填写的是另一家的密钥（将被忽略），提示改填所选提供商密钥，或清空选择改回「自动判定」
治理层总开关「启用租户 LLM 自定义」：
- 平台级开关，仅平台超级管理员可修改（普通租户管理员只读）
- 变更时需二次确认
- 开启后，正式 SaaS 订阅租户必须配置自己的 LLM（未配置则 AI 功能不可用，不会使用平台 LLM）；试用/私有化租户可配置自有 LLM，未配置时使用平台 LLM
LLM 提供商选择：
- 下拉提供「自动判定（按密钥）」与 4 家提供商（Kimi / DeepSeek / OpenAI / 通义千问 DashScope）
- 选择「自动判定」时，系统根据已填写的密钥自动选择提供商
- 选定某家后，下方仅展开该家的参数组，其余折叠
各提供商参数组（折叠卡片）：
- 卡片标题显示提供商名 + 「已配置 / 未配置」标签 + 「生效中」标签（当前实际使用该家时）
- 点标题展开 / 收起；展开后分两层：
- 必填区：仅该提供商的 API Key——这是唯一构成「已配置」的字段，只填模型名 / Base URL 不算已配置
- ▶ 高级选项（默认折叠）：内含「模型名」「Base URL」；折叠时显示「当前生效值 + 来源标签」
- DashScope 无 Base URL 字段
- 每个字段右侧有「来源」标签（数据库 / 环境变量 / 默认值），标识当前生效值的来源
共享参数：
- LLM 单次输出上限（所有提供商共用）
- RAG 检索参数：Top K、分块大小、分块重叠
AI 连通测试：点击「连通性测试」卡片中的「AI」按钮，按与实际运行时相同的解析逻辑发送测试请求，验证当前生效的提供商密钥是否可用。
保存校验：选定某提供商但未填写该家密钥时，保存前弹出警告，确认后仍可保存（也可点「去补 Key」补齐后再保存）。
17.3.11 自定义字段管理
自定义字段管理用于按业务实体（作用域，即 scope）维护扩展字段定义。字段值保存在各主表的 extra_attributes JSON 列，不修改数据库表结构。这是一种元数据驱动的扩展方案，允许系统在不进行数据迁移的前提下为设备、客户、工单、点检单等实体添加自定义属性。
页面布局
- 标题栏：页面标题「🧩 自定义字段管理」+ 操作按钮行
- 「显示已禁用」复选框：勾选后列表显示
is_active=false的已禁用字段 - 「刷新」按钮：重新加载当前作用域的字段定义
- 「新增字段」按钮（需
custom_field:create权限）
- 「显示已禁用」复选框：勾选后列表显示
- 提示条：蓝色信息条，说明字段定义的业务范围和数据存储方式
- 作用域标签页（
a-tabs）：按以下 4 个作用域切换
| 作用域 | scope 值 | 说明 |
|---|---|---|
| 设备 / 装备 | equipment | 设备台账的自定义字段 |
| 客户 | customer | 客户档案的自定义字段 |
| 工单 | work_order | 工单的自定义字段 |
| 点检单 | inspection_bill | 点检单的自定义字段 |
字段定义列表
表格列：
| 列名 | dataIndex | 说明 |
|---|---|---|
| 分组 | group_name | 字段分组名称，如"起重机参数" |
| 排序 | sort_order | 在同组内的排序，数字越小越靠前 |
| 字段编码 | field_code | 字段唯一标识（字母开头，仅含字母/数字/下划线），如 lift_height_m |
| 标签 | label | 字段显示名称 |
| 类型 | field_type | 标签显示类型（单行文本/多行文本/数字/日期/日期时间/单选下拉/多选下拉/布尔/附件） |
| 单位 | unit | 字段单位，如 m、t、kg |
| 必填 | required | ✓（红色）/ —（灰色） |
| 启用 | is_active | 绿色"启用" / 灰色"禁用"标签 |
| 来源 | legacy_source | 来源系统标记（如 parkday），无来源时为空 |
| 操作 | — | 编辑链接 + 禁用链接（按权限显示） |
新增/编辑自定义字段
点击「新增字段」或「编辑」按钮，弹出配置弹窗（宽 720px）。
基本信息行（3 列）：
| 字段 | 必填 | 控件 | 说明 |
|---|---|---|---|
| 作用域 | ✅ | a-select | 从 4 个作用域中选择；编辑时不可修改 |
| 字段编码 | ✅ | a-input | 字母开头，仅含字母/数字/下划线；编辑时不可修改 |
| 字段类型 | ✅ | a-select | 9 种类型：单行文本、多行文本、数字、日期、日期时间、单选下拉、多选下拉、布尔（开关）、附件 URL 列表 |
多语言标签行（3 列）：
| 字段 | 说明 |
|---|---|
| 显示标签（中文） | 必填，字段的中文显示名称 |
| English 标签 | 英文字段标签 |
| 日本語 ラベル | 日文字段标签 |
属性配置行（4 列）：
| 字段 | 控件 | 说明 |
|---|---|---|
| 单位 | a-input | 如 m、t、kg |
| 分组 | a-input | 如"起重机参数"，同组字段会编排在一起显示 |
| 排序 | a-input-number | 数字排序，最小值 0 |
| 必填 / 启用 | a-switch + a-switch | 两个开关控制必填和启用状态 |
扩展配置：
| 字段 | 控件 | 说明 |
|---|---|---|
| 占位提示 | a-input | 输入框的 placeholder 文字 |
| 默认值 | a-input | 字段的默认 JSON 值 |
| 帮助说明 | a-textarea | 字段下方的帮助文字，2 行 |
下拉选项编辑（仅单选下拉/多选下拉类型时显示）：
| 列 | 说明 |
|---|---|
| 选项值（value） | 实际存储值 |
| 选项标签（label） | 显示文本 |
| 设备类型前缀 meta | type_id_prefixes，用于设备按模板补齐场景。例：9010,9030 |
| 操作 | 删除按钮 |
支持「添加」按钮动态增加选项行。
来源系统标记行（2 列）：
| 字段 | 说明 |
|---|---|
| 来源系统标记（可选） | legacy_source，如 parkday，标识该字段的来源系统 |
| 来源字段名（可选） | legacy_field，如 QHeight，标识来源系统中的字段名 |
操作权限：
| 操作 | 所需权限 |
|---|---|
| 查看列表 | custom_field:view |
| 新增字段 | custom_field:create |
| 编辑字段 | custom_field:update |
| 禁用字段 | custom_field:delete |
注意：删除操作是软删除（设置
is_active=false），保留历史数据，只是不再在表单中显示该字段。
17.3.12 翻译管理
翻译管理是平台级的多语言在线编辑工具，让管理员在网页上直接校对 AI 机翻结果，无需手动修改 JSON 文件。支持三语（简体中文/English/日本語）并排编辑，保存时后端自动校验占位符一致性、备份原文件并原子写入，PC 端保存后前端热反射生效（无需刷新页面）。
注意：i18n UI 文案为所有租户共享的全局静态资源，编辑会影响全部租户，属于平台运维范畴，默认仅授予超级管理员。
页面布局
标题栏：
- 「🌐 多语言翻译管理」标题
- 未保存标签：橙色标签显示当前未保存的修改数量（
dirtyCount） - 「标记为已确认」复选框：勾选后保存时将修改的词条标记为
reviewed状态 - 「刷新」按钮：重新加载翻译词条数据
- 「导出 Excel」按钮：按当前筛选条件导出为 Excel 文件
- 「导入 Excel」按钮（需
i18n:update权限）：从 Excel 文件导入翻译，上传按钮 - 「保存修改」按钮（需
i18n:update权限）：提交当前页所有修改，dirtyCount === 0时禁用
提示条：蓝色信息条，说明翻译管理的作用和工作原理（AI 机翻 → 人工校对 → 保存校验 → 热刷新）
筛选栏：
| 筛选控件 | 说明 |
|---|---|
| 平台切换 | a-radio-group，按钮样式：「PC 端」/「移动端」 |
| 命名空间 | a-select，按 namespace 过滤，支持搜索，允许清空（全部） |
| 状态 | a-select，5 种状态：全部 / 机翻待审 / 已确认 / 缺失翻译 / 占位符不一致 |
| 关键词搜索 | a-input-search，搜索 key 或译文内容 |
| 总词条数 | 显示当前平台的总词条数 |
翻译编辑表格
| 列名 | 说明 |
|---|---|
| 键 (key) | 两行显示：上方等宽字体显示 key，下方灰色小字显示 namespace |
| 简体中文 | a-textarea，可编辑，auto-size 自适应 1-4 行高度，编辑即标记脏数据 |
| English | 同上 |
| 日本語 | 同上 |
| 状态 | 多标签显示：橙色"已修改"（dirty）/ 绿色"已确认"（reviewed）/ 灰色"机翻待审"（默认）/ 红色"缺失"（missing）/ 火山色"占位符"（placeholder_mismatch） |
表格操作：
- 点击单元格即可直接编辑三语译文，编辑后自动标记为脏数据（
dirty[record.key] = true） - 翻页或切换平台时若有未保存修改，弹出确认提示
底部分页栏：
- 支持切换每页条数（20/50/100/200）
- 显示"共 {n} 条"总数
- 翻页时若有未保存修改，弹出确认提示
保存机制：
| 步骤 | 说明 |
|---|---|
| 1. 收集修改 | 前端仅提交被标记为 dirty 的词条（与原始快照比较） |
| 2. 提交保存 | PUT /api/v1/i18n-admin/entries，payload 含 platform、changes、mark_reviewed |
| 3. 占位符校验 | 后端检测 {xxx} 占位符不一致时返回 400 + 错误详情（code: "i18n.placeholder_mismatch"），前端弹出确认框询问是否强制保存 |
| 4. 原子写入 | 校验通过后，后端备份当前 JSON 文件为 .bak，再原子写入新文件 |
| 5. 热刷新 | PC 端保存成功后，前端重新 fetch 最新 i18n JSON 并刷新 window.I18n.resources，更新 __i18nSignal 触发 Vue 模板重渲染 |
Excel 导入/导出：
| 操作 | 说明 |
|---|---|
| 导出 | 按当前筛选条件（平台/状态/keyword/namespace）导出为 .xlsx，文件名 i18n_{platform}.xlsx |
| 导入 | 上传 .xlsx/.xls 文件，后端执行批量更新。导入时同样做占位符校验，不一致时提示确认 |
操作权限：
| 操作 | 所需权限 |
|---|---|
| 查看翻译词条 | i18n:view |
| 编辑翻译词条 | i18n:update |
17.3.13 许可管理
「许可管理」是租户自助的只读视图，展示本租户在安装级授权池中的许可信息、配额与实时在线情况。入口需要「查看本租户许可」权限。
说明：系统采用安装级授权模式——一份许可覆盖整个安装，全部租户共享同一个用户/设备授权池。平台级证书管理（导入 .lic 证书、服务器绑定信息、跨租户监控）不在本页面，由平台超级管理员在系统管理中心操作。
许可信息卡片
卡片标题旁显示许可状态标签和「安装级授权 · 全租户共享池」标识：
| 状态 | 颜色 | 说明 |
|---|---|---|
| 有效 | 绿 | 许可正常使用中 |
| 宽容期（只读） | 橙 | 已到期但处于宽限期，系统只读 |
| 已过期 | 红 | 许可已过期 |
| 已暂停 | 橙 | 许可被暂停 |
| 已取消 | 灰 | 许可已取消 |
卡片内容：
| 项目 | 说明 |
|---|---|
| 版本 / 类型 | 许可版本与类型：试用 / 永久买断 / 月度订阅 / 年度订阅 |
| 生效 / 到期 | 生效日期与到期日期；到期显示「永久」表示无固定期限 |
| 可用模块 | 已开通的功能模块列表；未做模块限制时显示「全功能开放」 |
| 安装池用户 | 整个安装的用户用量进度条（当前值 / 上限，不限显示 ∞），下方标注本租户占用数 |
| 安装池设备 | 整个安装的设备用量进度条，同样标注本租户占用数 |
| 管理席位 / 现场席位 | 仅 Lite 双席位许可显示：两类席位的占用 / 上限；容量版许可不显示此项 |
用量进度条状态：正常为蓝色；接近上限时显示橙色「接近上限」标签；超过上限显示红色「超限」标签。
升级 / 续期：请联系厂家重新签发 .lic 证书，由平台超级管理员在系统管理中心导入后生效。
本租户配额卡片（只读）
展示本租户在安装授权池内被分配到的额度，供租户用户自行确认：
| 项目 | 说明 |
|---|---|
| 用户：占用 / 配额 | 本租户当前用户数与配额上限（未设限显示「不限」） |
| 设备：占用 / 配额 | 本租户当前设备数与配额上限 |
| 可用模块 | 本租户实际可用的功能模块 |
本租户在线用户卡片
标题右侧显示当前在线人数，可点击「刷新」按钮更新。表格列：
| 列名 | 说明 |
|---|---|
| 用户 | 登录用户名 |
| 设备 | 💻 桌面 / 📱 手机 / 📱 平板 |
| IP 地址 | 登录来源 IP |
| 登录时间 | 会话建立时间 |
| 最后活跃 | 最后一次操作时间及距今时长（如「5 分钟前」） |
| 在线时长 | 本次会话累计在线时长 |
超过 10 条记录时每页显示 10 条。
注意：没有「查看本租户许可」权限、或平台级账号（无租户上下文）访问时，对应卡片自动隐藏，不显示错误提示。
17.3.14 属性 Schema 设计器
「属性 Schema 设计器」用于为设备类型可视化设计属性字段模板（保存到设备类型的 attributes_schema）。设计完成后，该类型下的设备在新增/编辑时按此模板展示对应属性字段。入口需要「配置类型属性 Schema」权限。
顶部操作栏
| 元素 | 说明 |
|---|---|
| 设备类型选择 | 树形下拉（支持搜索），选择要设计的设备类型 |
| 「应用 LD 模板」 | 一键导入起重机（LD）4 个预置字段：额定载荷（integer·kg·必填）、跨度（number·m·必填）、工作级别（enum·A3~A8·必填）、钢丝绳规格（string·默认 6×37+IWR φ12） |
| 「保存」 | 保存当前类型的 Schema（未选择类型时禁用） |
| 语言切换 | 切换界面语言（字段标签按语言显示） |
三栏工作区
| 栏 | 内容 |
|---|---|
| 左：字段列表 | 全部字段行（key + 中文标签 + 类型 + 单位 + 必填标记），点击选中编辑，拖拽 ≡ 手柄调整顺序，行尾 × 删除；右上角「+ 新增字段」 |
| 中：字段详情 | 编辑选中字段：字段 key（英文）、中文标签、类型、单位、enum 选项（逗号分隔，仅 enum 类型显示）、默认值、必填勾选 |
| 右：JSON 预览 | 实时显示 Schema 的 JSON 结构，保存前可核对 |
字段类型共 6 种：string（文本）、integer（整数）、number（数值）、boolean（布尔）、date（日期）、enum（枚举）。
提示：设备类型档案本身的维护（新增/编辑类型）在「档案管理 → 设备类型档案」（§8.6）；本页面专注于类型的属性字段模板设计。
17.4 移动端操作
系统管理功能当前仅限 PC 端操作，移动端无直接入口。
移动端用户可通过「📊 工作台 → 常用功能」快捷方式跳转到授权范围内的 PC 端模块页面（如工单执行、点检执行等），但系统管理配置功能仅限 PC 端。
17.5 常见问题
Q1：创建的权限角色看不到权限配置面板？
A：请确认已点击左侧角色卡片列表中的角色名，右侧面板需要选中角色后才显示权限配置树。如果角色列表中无数据，请检查是否已登录且当前租户下是否有角色数据。
Q2：角色删除失败，提示"系统角色不可删除"？
A：super_admin（超级管理员）和 tenant_admin（租户管理员）等系统预定义角色（is_system=true）受保护，编辑和删除按钮均为禁用状态。如需禁用，可通过清空其权限实现。
Q3：为什么看不到「租户管理」菜单项？
A：「租户管理」需要 system:config 权限，仅超级管理员等全局角色可见。一般租户管理员无此权限。
Q4：CSV 导入失败，提示"缺少必填字段"？
A：请检查 CSV 文件表头是否与模板一致。红色粗体（带 * 标记）的列为必填字段，必须包含在 CSV 中且有值。可使用页面提供的「下载空白 CSV 模板」获取正确格式。
Q5：条码解析测试未匹配到任何规则？
A：请检查是否已创建条码规则。匹配基于正则表达式，确认条码格式与规则中的正则模式一致。可先创建一条测试规则，确保正则表达式正确。同时检查规则的优先级排序。
Q6：定时任务调度器状态显示"未启动"？
A：调度器状态红色表示后台调度服务（APScheduler）未运行。请检查服务器端调度器进程是否正常启动。此问题需联系系统管理员处理。
Q7：单据编号规则的操作列中看不到「序号状态」和「变更历史」按钮？
A：「序号状态」需要 doc:number:sequence:view 权限，「变更历史」需要 doc:number:rule:view 权限（与查看规则列表权限相同）。请确认当前角色拥有这些权限。
Q8：系统参数设定中心找不到某个想修改的配置项？
A：系统参数设定中心采用白名单机制，仅展示已在 ConfigService 中预定义的配置项。不在白名单中的 key 不可在线管理。如确实需要新增配置项，需由开发人员在代码中注册。
Q9：系统参数中的密钥类配置项显示"已配置"，能否查看当前值？
A：不能。密钥类配置项（is_sensitive=true）采用只写不读策略，接口不返回明文值。页面仅显示「🔒 已配置」或「⚠️ 未配置」标签，管理员只能输入新值覆盖，无法查看旧值。这是安全设计的一部分。
Q10：为什么看不到「许可管理」菜单项？
A：「许可管理」需要「查看本租户许可」权限。此外该页面是租户自助视图，平台级账号（无租户上下文）进入时卡片会自动隐藏。许可到期、升级或续期请联系厂家重新签发证书，由平台超级管理员在系统管理中心导入。
17.6 相关权限
系统管理模块涉及以下系统级和管理级权限：
| 权限 key | 权限名称 | 说明 |
|---|---|---|
system:config | 系统配置 | 访问租户管理、运维监控等系统级功能 |
system:config:wizard | 配置向导 | 使用配置向导进行系统初始化 |
system:import | 数据导入 | 批量导入业务数据 |
system:log:view | 查看系统日志 | 查看系统运行日志 |
system:audit:view | 查看审计日志 | 查看操作审计日志 |
system:audit:export | 导出审计日志 | 导出审计日志为文件 |
system:backup | 系统备份 | 创建系统数据备份 |
system:restore | 系统恢复 | 从备份恢复系统数据 |
scheduler:view | 查看定时任务 | 查看定时任务列表和状态 |
scheduler:execute | 执行定时任务 | 手动触发定时任务 |
scheduler:manage | 管理定时任务 | 暂停/恢复定时任务 |
scheduler:admin | 管理调度器 | 全局用户管理调度器配置 |
barcode_rule:view | 查看条码规则 | 查看条码规则列表 |
barcode_rule:create | 新增条码规则 | 创建新的条码匹配规则 |
barcode_rule:update | 编辑条码规则 | 修改条码规则 |
barcode_rule:delete | 删除条码规则 | 删除条码规则 |
role:view | 查看角色 | 查看角色列表和详情 |
role:create | 创建角色 | 新建租户角色 |
role:update | 更新角色 | 编辑角色信息 |
role:delete | 删除角色 | 删除非系统角色 |
role:assign_permission | 分配权限 | 为角色配置权限树 |
user:view | 查看用户 | 查看用户列表 |
user:create | 创建用户 | 新增租户用户 |
user:update | 更新用户 | 编辑用户信息 |
user:delete | 删除用户 | 删除用户 |
user:assign_role | 分配角色 | 为用户分配角色 |
user:reset_password | 重置密码 | 重置用户密码 |
data:rule:view | 查看数据规则 | 查看数据权限规则列表 |
data:rule:create | 创建数据规则 | 新建数据权限规则 |
data:rule:update | 编辑数据规则 | 修改数据权限规则 |
data:rule:delete | 删除数据规则 | 删除数据权限规则 |
approval:workflow:view | 查看审批流程 | 查看审批工作流列表 |
approval:workflow:manage | 管理审批流程 | 创建/编辑/启停/删除审批流程 |
approval:view | 查看审批列表 | 查看待审批和我的申请列表 |
approval:approve | 执行审批 | 审批通过/拒绝/退回操作 |
doc:number:rule:view | 查看编号规则 | 查看单据编号规则 |
doc:number:rule:create | 新建编号规则 | 新增单据编号规则 |
doc:number:rule:update | 编辑编号规则 | 修改单据编号规则 |
doc:number:rule:delete | 删除编号规则 | 删除单据编号规则 |
doc:number:rule:enable | 启用/禁用编号规则 | 切换规则的启用状态 |
doc:number:manual | 手动输入编号 | 允许手动输入单据编号 |
doc:number:log:view | 查看编号日志 | 查看编号生成历史 |
doc:number:sequence:view | 查看序号状态 | 查看规则序号使用情况 |
doc:number:sequence:reset | 重置序号 | 重置规则序号（高危操作） |
custom_field:view | 查看自定义字段 | 查看自定义字段定义列表 |
custom_field:create | 创建自定义字段 | 新增自定义字段定义 |
custom_field:update | 更新自定义字段 | 修改自定义字段定义 |
custom_field:delete | 删除自定义字段 | 删除/禁用自定义字段定义 |
i18n:view | 查看翻译词条 | 查看多语言 UI 翻译词条 |
i18n:update | 编辑翻译词条 | 编辑多语言 UI 翻译词条（影响全部租户） |
license:my:view | 查看本租户许可 | 租户自助查看本租户在安装池中的许可、配额与在线用户 |
equipment_type:design_schema | 配置类型属性 Schema | 为设备类型设计/保存属性字段模板 |