01 / 09智光耀城 · 智慧路灯管理平台
智光耀城 · 智慧路灯管理平台
Zhi Guang Yao Cheng
面向城市道路照明与多功能灯杆的综合管控台，基于 OpenAPI 契约生成与 SSE 响应式遥测事件驱动。
02 / SYSTEMS & INTERFACES
系统界面与交互实录。
当前系统为 Mock 数据演示版系统（非真实生产服务器），请勿随意删除或修改演示数据，以免影响他人体验系统效果。
02.1 // 演示凭据
系统预置测试账号与访问权限边界
| 角色 | 账号 | 密码 | 体验范围 |
|---|---|---|---|
| 超级管理员 | 完整管理端功能演示 |
03 / PROBLEM CONSTRAINTS
工程背景与核心约束。
市政照明与物联设备管理平台在工程落地中面临两类典型挑战：一是前后端接口定义脱节导致的运行时类型漂移与联调消耗；二是高频设备状态巡检若依赖定时轮询，会在多管理员并发监控下对数据库连接池与服务端线程造成无谓的查询风暴。
智光耀城以 SpringDoc OpenAPI 3.1 规范为单一真源，构建工具链自动生成强类型 TypeScript 客户端与 Mock 桩；服务端通过 @TransactionalEventListener 监听事务提交，经由 Server-Sent Events (SSE) 单向广播实时遥测。平台内建离散场景仿真引擎验证告警至工单的业务状态机闭环（当前全部设备、遥测、控制结果和告警均为模拟数据，不连接真实灯杆。195 / 425 / 9 是 2026-07-21 的归档验收基线）。
04 / ARCHITECTURE SLICES
内核切面与实现机制。
OpenAPI 3.1 快照生成唯一的前端请求面
orval.config.ts 读取 openapi/api-docs.json，先通过 transformer 解开 ApiResponse<T> 信封，再以 single 模式生成入口与 models。所有函数最终进入同一个 orvalRequest，继续复用项目既有的鉴权与错误处理。
仓库内有可离线复现的 OpenAPI 3.1 快照和只读生成目录，接口改动能进入类型检查。
output: {
clean: true,
mode: "single",
schemas: "./src/api/generated/models",
target: "./src/api/generated/index.ts",
override: {
mutator: { name: "orvalRequest", path: "./src/api/request/orval-mutator.ts" },
},
}05 / ENGINEERING DECISIONS
架构抉择与取舍论证。
选择左侧架构决策，查看问题背景、技术方案、架构收益与设计代价。
06 / SPEC READINGS
工程规格与测试读数。
07 / EVOLUTION & BOUNDARIES
演进边界与已知限制。
09 // RECRUITMENT