服务等级管理系统 | zhuatech-sla

本次升级：维护排除口径与可用性错误预算

从服务期分钟中扣除经批准排除的维护分钟，单独核对计入停机分钟与目标可用性，避免把维护重复扣减。

新增已认证的结构化录入工作台（/operations.html），支持批量核算、逐条结果依据、分级复核和CSV/完整JSON导出。结果由真实后端算法计算，不是预置演示数字。所有数值精确传递，不调用外部模型。

这是只读核算：不写库、不审批、不自动执行财务、签署、销毁或设备控制。输入条件满足不是执行授权。算法、输入边界与接口说明。

简体中文 | English

面向企业服务台的知华科技 SLA 项目，由上海如静知华信息科技有限公司维护。它把服务承诺转成可核验的工单时限和超时事件，而不只是一个“工单状态”界面。官网：www.zhuatech.cn。

从协议到履约

服务协议（优先级 / 响应小时 / 解决小时）
  └─ 服务工单（UTC 受理时间）
      ├─ 响应计时 → 响应超时流水
      ├─ 解决计时 → 解决超时流水
      ├─ 自动巡检 / 升级记录
      └─ 解决 → 独立复核关闭 / 重开

协议要求响应时限不大于解决时限，已用于工单的协议不能覆盖改价式改写。每分钟巡检未结工单，超时只记录一次；人工响应/解决时也会同步检查，避免漏记。自动和人工升级均生成独立记录。升级事件须由管理员分派给本企业有效账号，记录处置要求；工单解决后，由不同审核人员复核关闭升级事件。所有升级事件完成前，工单不能结案。重新打开工单会开启新一轮计时并保留旧审计记录。

已交付的页面与接口

业务端有协议、工单、超时事件和升级记录列表，支持搜索、筛选、详情、操作轨迹与 CSV 导出；管理端可管理账号、角色并查看审计。后端提供事务、租户隔离、幂等键、并发版本和附件鉴权。

业务概览新增“服务时限风险”清单，可切换未来 4、24、72 小时窗口，区分首次响应与问题解决节点，显示截止时间、剩余分钟和已超时状态。对应只读接口为 GET /api/sla/risks?withinHours=4；范围仅限当前租户且仅包含未解决工单，查询不会写入超时流水或审计。

管理端账号与权限设置：

移动 H5 工作台：

时间口径：当前按 UTC 自然小时计算，不含企业专属工作日历、节假日、暂停计时和外部通知渠道。需按正式服务合同调整阈值与计时口径后再投入生产。

运行与验证

需要 Docker Compose。复制 .env.example 为 .env，分别设置 MySQL 与四种角色的独立强密码，然后执行：

docker compose up -d --build
sh scripts/test.sh

业务端与管理端共用 http://127.0.0.1:8088（管理入口 /admin）；后端健康检查为 http://127.0.0.1:18080/api/health。四个初始化账号为 admin、reviewer、operator、viewer，密码从环境变量读取。端口可通过 WEB_PORT、API_PORT 调整。可使用 .env.demo.example 做仅本机演示，但切勿连接真实业务数据库或向公网开放演示密码。

后端采用 Java 21 / Spring Boot 4 / MySQL 8.4 / Flyway；前端采用 Vue 3 / Vite，适配桌面与 H5。CI 在 MySQL 上运行后端测试；本机脚本默认用 H2 MySQL 兼容模式跑后端验收，再跑前端单测及生产构建。完整验收脚本见 backend/src/test/resources/acceptance.json。

使用边界与授权

本仓库是可运行的公开源码学习交流版本，不是 OSI 意义的开源许可。根据 LICENSE，源码仅限个人非商业学习、研究和交流。企业内部生产、客户交付、SaaS、收费服务及其他商用均须先取得上海如静知华信息科技有限公司书面授权。生产上线还需要企业自己的安全评估、备份恢复、合规与业务参数验收。

知华科技官网提供中小企业信息化、AI 转型、OPC 技术支持、软件项目外包、实施、FDE 外包与深度开发定制咨询。也可扫码添加微信咨询：

微信咨询一	微信咨询二

版权及项目维护：上海如静知华信息科技有限公司 · https://www.zhuatech.cn/