feat(garden): 添加团队考核查询功能

- 新增 TeamAssessmentReqVO 和 TeamAssessmentRespVO 数据传输对象 - 在 OpenApiService 中添加 queryTeamAssessment 接口定义 - 实现团队考核查询逻辑，支持按班组和人员两种模式查询 - 添加考勤统计、工单统计、耗材统计等考核指标计算 - 创建 TeamAssessmentOpenController 提供开放 API 接口 - 实现个人考核指标和明细数据查询功能 - 添加扣分规则和考核得分计算机制

feat(garden): 添加团队考核查询功能
- 新增 TeamAssessmentReqVO 和 TeamAssessmentRespVO 数据传输对象 - 在 OpenApiService 中添加 queryTeamAssessment 接口定义 - 实现团队考核查询逻辑，支持按班组和人员两种模式查询 - 添加考勤统计、工单统计、耗材统计等考核指标计算 - 创建 TeamAssessmentOpenController 提供开放 API 接口 - 实现个人考核指标和明细数据查询功能 - 添加扣分规则和考核得分计算机制
王彪总
1 parent 116f6bb0
Showing 16 changed files with 6392 additions and 34 deletions
docs/all_test.html
docs/ppt-assets/animations.css
docs/ppt-assets/base.css
docs/ppt-assets/fonts.css
docs/ppt-assets/runtime.js
docs/ppt-assets/style.css
docs/urbanops-architecture-ppt.html
docs/urbanops-tech-sharing.html
docs/开放API对接接口文档.html
docs/开放API对接接口文档.md
docs/开放API对接接口文档.pdf
urbanops-module-garden/src/main/java/com/zteits/urbanops/module/garden/controller/open/assessment/TeamAssessmentOpenController.java
urbanops-module-garden/src/main/java/com/zteits/urbanops/module/garden/controller/open/assessment/vo/TeamAssessmentReqVO.java
urbanops-module-garden/src/main/java/com/zteits/urbanops/module/garden/controller/open/assessment/vo/TeamAssessmentRespVO.java
urbanops-module-garden/src/main/java/com/zteits/urbanops/module/garden/controller/open/service/OpenApiService.java
urbanops-module-garden/src/main/java/com/zteits/urbanops/module/garden/controller/open/service/OpenApiServiceImpl.java
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>UrbanOps 全域平台 · 技术架构全景分享</title>
+<link rel="stylesheet" href="ppt-assets/fonts.css">
+<link rel="stylesheet" href="ppt-assets/base.css">
+<link rel="stylesheet" href="ppt-assets/animations.css">
+<link rel="stylesheet" href="ppt-assets/style.css">
+<style>
+.tpl-tech-sharing .h1{font-size:68px;line-height:1.05}
+.tpl-tech-sharing .h2{font-size:44px}
+.tpl-tech-sharing .slide{padding:56px 72px}
+
+/* SVG diagram area */
+.svg-area{width:100%;max-width:1050px;flex:1;display:flex;align-items:center;justify-content:center;margin-top:8px}
+.svg-area svg{width:100%;height:100%;max-height:480px}
+
+/* Architecture layers */
+.arch-layers{margin-top:14px;display:grid;grid-template-rows:auto auto auto auto;gap:12px}
+.arch-layers .al{display:grid;grid-template-columns:110px 1fr;align-items:stretch;gap:12px}
+.arch-layers .al .al-name{display:flex;align-items:center;justify-content:center;background:var(--surface-2);border-radius:var(--radius);padding:12px 10px;font-family:'JetBrains Mono',monospace;font-size:11px;font-weight:600;color:var(--accent);text-align:center;border:1px solid var(--border)}
+.arch-layers .al .al-cells{display:grid;grid-template-columns:repeat(auto-fit,minmax(130px,1fr));gap:8px}
+.arch-layers .al .acell{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:12px 10px;text-align:center}
+.arch-layers .al .acell .aci{font-size:20px;margin-bottom:2px}
+.arch-layers .al .acell h4{font-size:13px;color:#fff;margin:3px 0 1px}
+.arch-layers .al .acell p{font-size:10px;color:var(--text-3);margin:0}
+.arch-layers .al.hl .acell{border-top:3px solid var(--accent);border-color:rgba(126,231,135,.35)}
+.arch-layers .al.fw .acell{border-top:3px solid var(--accent-2);border-color:rgba(121,192,255,.35)}
+
+.biz-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:12px;margin-top:14px}
+.biz-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:22px 18px}
+.biz-card .biz-icon{font-size:32px;margin-bottom:8px}
+.biz-card h4{font-size:17px;color:#fff;margin-bottom:6px}
+.biz-card p{font-size:12px;color:var(--text-2);line-height:1.6;margin:0}
+.biz-card .biz-tags{display:flex;flex-wrap:wrap;gap:5px;margin-top:10px}
+.biz-card .biz-tags span{font-family:'JetBrains Mono',monospace;font-size:10px;padding:2px 8px;border-radius:4px;background:var(--surface-2);color:var(--text-2);border:1px solid var(--border)}
+.biz-card.ac{border-top:3px solid var(--accent)}
+.biz-card.blue{border-top:3px solid var(--accent-2)}
+.biz-card.purple{border-top:3px solid #d2a8ff}
+
+.col2{display:grid;grid-template-columns:1fr 1fr;gap:20px;margin-top:14px}
+.col2 .box{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:22px}
+
+.flow-steps{display:flex;align-items:center;gap:8px;margin-top:14px}
+.flow-steps .fs{flex:1;background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:16px 12px;text-align:center}
+.flow-steps .fs .fs-icon{font-size:26px;margin-bottom:4px}
+.flow-steps .fs h4{font-size:13px;color:#fff;margin:3px 0}
+.flow-steps .fs p{font-size:10px;color:var(--text-3);margin:0}
+.flow-steps .fs-arr{color:var(--accent);font-size:20px;font-family:'JetBrains Mono',monospace;flex-shrink:0}
+.flow-steps .fs.hl{border-top:3px solid var(--accent)}
+
+.tg{display:grid;grid-template-columns:repeat(4,1fr);gap:10px;margin-top:12px}
+.tg .tgc{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:16px 12px;text-align:center}
+.tg .tgc .tgci{font-size:28px;margin-bottom:4px}
+.tg .tgc h4{font-size:14px;color:#fff;margin:4px 0}
+.tg .tgc .tgt{display:flex;flex-wrap:wrap;gap:4px;justify-content:center;margin-top:8px}
+.tg .tgc .tgt span{font-family:'JetBrains Mono',monospace;font-size:10px;padding:2px 7px;border-radius:4px;background:var(--surface-2);color:var(--text-2);border:1px solid var(--border)}
+
+.timeline{margin-top:14px}
+.timeline .tl-item{display:grid;grid-template-columns:100px 1fr;gap:16px;padding:14px 0;border-bottom:1px dashed var(--border)}
+.timeline .tl-item .tl-phase{font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent);font-weight:600}
+.timeline .tl-item .tl-body h4{font-size:16px;color:#fff;margin:0 0 4px}
+.timeline .tl-item .tl-body p{font-size:12px;color:var(--text-2);margin:0}
+
+.fw-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:10px;margin-top:12px}
+.fw-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:16px 14px}
+.fw-card .fwi{font-size:22px;margin-bottom:6px}
+.fw-card h4{font-size:14px;color:#fff;margin:4px 0}
+.fw-card p{font-size:11px;color:var(--text-3);margin:0}
+.fw-card.hl{border-top:2px solid var(--accent-2)}
+
+.roadmap-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:16px;margin-top:14px}
+.roadmap-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:22px 18px}
+.roadmap-card .r-period{font-family:'JetBrains Mono',monospace;font-size:11px;color:var(--accent);font-weight:600;margin-bottom:8px}
+.roadmap-card h4{font-size:18px;color:#fff;margin-bottom:8px}
+.roadmap-card ul{margin:0;padding-left:16px;font-size:12px;color:var(--text-2);line-height:1.8}
+.roadmap-card.now{border-top:3px solid var(--accent)}
+.roadmap-card.next{border-top:3px solid var(--accent-2)}
+.roadmap-card.future{border-top:3px solid #d2a8ff}
+
+.stats-row{display:grid;grid-template-columns:repeat(5,1fr);gap:12px;margin-top:14px}
+.stat-item{text-align:center;padding:18px 10px;background:var(--surface);border:1px solid var(--border);border-radius:var(--radius)}
+.stat-item .stat-num{font-size:38px;font-weight:800;color:var(--accent);font-family:'JetBrains Mono',monospace}
+.stat-item .stat-label{font-size:12px;color:var(--text-2);margin-top:4px}
+
+.invoc-flow{display:flex;flex-direction:column;gap:10px;margin-top:12px}
+.invoc-flow .invoc-row{display:flex;align-items:center;gap:8px}
+.invoc-flow .invoc-row .ir-label{width:100px;text-align:right;font-family:'JetBrains Mono',monospace;font-size:11px;color:var(--accent);font-weight:600;flex-shrink:0}
+.invoc-flow .invoc-row .ir-items{display:flex;gap:6px;flex:1;flex-wrap:wrap}
+.invoc-flow .invoc-row .ir-items span{font-family:'JetBrains Mono',monospace;font-size:10px;padding:4px 10px;border-radius:5px;background:var(--surface-2);color:var(--text-2);border:1px solid var(--border)}
+.invoc-flow .ir-arrow{color:var(--text-3);font-size:16px;font-family:'JetBrains Mono',monospace;text-align:center;padding:2px 0}
+
+.deploy-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:12px;margin-top:14px}
+.deploy-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:20px 16px;text-align:center}
+.deploy-card .di{font-size:34px;margin-bottom:8px}
+.deploy-card h4{font-size:16px;color:#fff;margin-bottom:6px}
+.deploy-card ul{margin:0;padding:0;list-style:none;font-size:11px;color:var(--text-2);line-height:1.8}
+.deploy-card.ci{border-top:3px solid var(--accent)}
+.deploy-card.cn{border-top:3px solid var(--accent-2)}
+.deploy-card.mon{border-top:3px solid #d2a8ff}
+
+.code-text{font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--text-2);background:var(--surface-2);padding:8px 14px;border-radius:8px;border:1px solid var(--border);display:inline-block}
+
+/* Layer stack (from file1) */
+.layer-stack{display:flex;flex-direction:column;gap:10px;width:100%;max-width:1000px;margin-top:14px}
+.layer-stack .layer{display:flex;align-items:center;gap:20px;padding:14px 22px;border-radius:12px;background:var(--surface);border:1px solid var(--border)}
+.layer-stack .layer-label{font-weight:700;font-size:12px;min-width:110px;text-align:right;color:var(--accent);font-family:'JetBrains Mono',monospace}
+.layer-stack .layer-content{display:flex;gap:6px;flex-wrap:wrap}
+
+/* Evolution flow */
+.evo-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap;justify-content:center;margin-top:12px}
+.evo-flow .evo-box{background:var(--surface);border:2px solid var(--border);border-radius:14px;padding:16px 24px;text-align:center;font-weight:600;min-width:120px;font-size:13px}
+.evo-flow .evo-box.accent{border-color:var(--accent);background:rgba(126,231,135,.08)}
+.evo-flow .evo-box.purple{border-color:#d2a8ff;background:rgba(210,168,255,.08)}
+.evo-flow .evo-box.green{border-color:var(--accent-2);background:rgba(121,192,255,.08)}
+.evo-flow .evo-arrow{font-size:1.6em;color:var(--text-3)}
+</style>
+</head>
+<body class="tpl-tech-sharing">
+<div class="deck">
+
+  <!-- ====== 1. Cover ====== -->
+  <section class="slide" data-title="Cover">
+    <p class="kicker">urbanops · tech-sharing</p>
+    <h1 class="h1 anim-fade-up" data-anim="fade-up">城市运营全域平台<br><span style="background:var(--grad);-webkit-background-clip:text;background-clip:text;color:transparent">技术架构全景解析</span></h1>
+    <p class="lede mt-m">业务架构 × 技术架构 × 系统架构 × 部署架构 — 一次讲透全域平台。</p>
+    <div class="speaker"><div class="av"></div><div><b>架构组</b><span>platform infra · 60 min + Q&amp;A</span></div></div>
+    <div class="deck-footer"><span class="mono">#spring-boot #smart-garden #urbanops #architecture #microservices</span><span class="slide-number" data-current="1" data-total="26"></span></div>
+  </section>
+
+  <!-- ====== 2. Agenda ====== -->
+  <section class="slide" data-title="Agenda">
+    <p class="kicker">agenda.yaml</p>
+    <h2 class="h2">今日路线图</h2>
+    <div class="stack mt-l">
+      <div class="agenda-row"><span class="num">01</span><span class="t">项目概述与业务架构全景</span><span class="d">~6min</span></div>
+      <div class="agenda-row"><span class="num">02</span><span class="t">业务布局：园林 · 工单 · BPM · 全局</span><span class="d">~10min</span></div>
+      <div class="agenda-row"><span class="num">03</span><span class="t">系统架构总览 & 模块依赖关系</span><span class="d">~6min</span></div>
+      <div class="agenda-row"><span class="num">04</span><span class="t">技术架构分层 & 基础设施层</span><span class="d">~6min</span></div>
+      <div class="agenda-row"><span class="num">05</span><span class="t">核心技术栈 & 数据存储策略</span><span class="d">~6min</span></div>
+      <div class="agenda-row"><span class="num">06</span><span class="t">数据流 & 模块调用逻辑</span><span class="d">~6min</span></div>
+      <div class="agenda-row"><span class="num">07</span><span class="t">安全架构 & 可观测性</span><span class="d">~6min</span></div>
+      <div class="agenda-row"><span class="num">08</span><span class="t">部署架构 & 后续演进规划</span><span class="d">~6min</span></div>
+      <div class="agenda-row"><span class="num">09</span><span class="t">总结 &amp; Q&amp;A</span><span class="d">~5min</span></div>
+    </div>
+  </section>
+
+  <!-- ====== 3. Project Overview ====== -->
+  <section class="slide" data-title="Project Overview">
+    <p class="kicker">// overview</p>
+    <h2 class="h2">UrbanOps 全域平台：<br>智慧城市运营管理底座</h2>
+    <p class="lede">基于 RuoYi-Vue-Pro 演进而来，面向城市园林绿化、工单调度、流程协同的综合运营管理平台。模块化单体架构向微服务演进中。</p>
+    <div class="stats-row mt-l">
+      <div class="stat-item anim-fade-up" data-anim="fade-up"><div class="stat-num">17</div><div class="stat-label">Maven 模块</div></div>
+      <div class="stat-item anim-fade-up" data-anim="fade-up" style="animation-delay:.05s"><div class="stat-num">7</div><div class="stat-label">激活业务模块</div></div>
+      <div class="stat-item anim-fade-up" data-anim="fade-up" style="animation-delay:.1s"><div class="stat-num">15</div><div class="stat-label">框架 Starter</div></div>
+      <div class="stat-item anim-fade-up" data-anim="fade-up" style="animation-delay:.15s"><div class="stat-num">10+</div><div class="stat-label">数据库支持</div></div>
+      <div class="stat-item anim-fade-up" data-anim="fade-up" style="animation-delay:.2s"><div class="stat-num">3.5.5</div><div class="stat-label">Spring Boot</div></div>
+    </div>
+    <div class="col2 mt-l">
+      <div class="box" style="border-top:3px solid var(--accent)">
+        <h4 style="color:#fff;margin:0 0 8px">后端技术基石</h4>
+        <p class="dim" style="font-size:13px;line-height:1.7">Java 17 · Spring Boot 3.5.5 · MyBatis Plus 3.5.14 · Spring Security 6.x · Flowable 7.0 · Redisson 3.51 · SkyWalking 9.5 · RocketMQ · Vert.x + MQTT · PF4J 插件框架</p>
+      </div>
+      <div class="box" style="border-top:3px solid var(--accent-2)">
+        <h4 style="color:#fff;margin:0 0 8px">前端生态 & 核心能力</h4>
+        <p class="dim" style="font-size:13px;line-height:1.7">Vue3 + Element Plus / Vben 双管理后台 · uni-app 移动端 · 大屏报表设计器 · 多租户 SaaS · IoT 设备接入 · 代码生成器 · Spring AI 集成</p>
+      </div>
+    </div>
+  </section>
+
+  <!-- ====== 4. Business Architecture Overview ====== -->
+  <section class="slide" data-title="Business Architecture">
+    <p class="kicker">business · architecture</p>
+    <h2 class="h2">业务架构全景：<br>四大核心域 + 两大支撑域</h2>
+    <div class="biz-grid">
+      <div class="biz-card ac anim-fade-up" data-anim="fade-up">
+        <div class="biz-icon">🌳</div><h4>智慧园林管理</h4>
+        <p>树木资产管理、巡检计划、养护计划、绩效评估、物料出入库、机械成本核算</p>
+        <div class="biz-tags"><span>Garden</span><span>巡检</span><span>养护</span><span>绩效</span></div>
+      </div>
+      <div class="biz-card blue anim-fade-up" data-anim="fade-up" style="animation-delay:.05s">
+        <div class="biz-icon">📋</div><h4>工单调度系统</h4>
+        <p>事件上报、工单流转、物料明细、附件管理、地理位置编码、园林事件映射</p>
+        <div class="biz-tags"><span>Workorder</span><span>事件</span><span>物料</span></div>
+      </div>
+      <div class="biz-card purple anim-fade-up" data-anim="fade-up" style="animation-delay:.1s">
+        <div class="biz-icon">🔄</div><h4>工作流引擎</h4>
+        <p>Flowable 驱动，仿钉钉/飞书 + BPMN 双设计器，会签、或签、转办、委派、加签全覆盖</p>
+        <div class="biz-tags"><span>BPM</span><span>Flowable</span><span>审批</span></div>
+      </div>
+      <div class="biz-card ac anim-fade-up" data-anim="fade-up" style="animation-delay:.15s">
+        <div class="biz-icon">🌐</div><h4>全局业务管理</h4>
+        <p>问题上报、道路信息、工单提交详情、流程路径想法、跨模块数据聚合</p>
+        <div class="biz-tags"><span>Global</span><span>道路</span><span>问题</span></div>
+      </div>
+      <div class="biz-card blue anim-fade-up" data-anim="fade-up" style="animation-delay:.2s">
+        <div class="biz-icon">⚙️</div><h4>系统管理</h4>
+        <p>用户/角色/菜单/部门/岗位管理、租户与套餐、字典、通知公告、应用管理</p>
+        <div class="biz-tags"><span>System</span><span>RBAC</span><span>多租户</span></div>
+      </div>
+      <div class="biz-card purple anim-fade-up" data-anim="fade-up" style="animation-delay:.25s">
+        <div class="biz-icon">🏗️</div><h4>基础设施</h4>
+        <p>代码生成、文件存储、定时任务、配置管理、消息队列、API 日志、监控追踪</p>
+        <div class="biz-tags"><span>Infra</span><span>代码生成</span><span>监控</span></div>
+      </div>
+    </div>
+  </section>
+
+  <!-- ====== 5. Garden Business ====== -->
+  <section class="slide" data-title="Business · Garden">
+    <p class="kicker">garden · smart-greening</p>
+    <h2 class="h2">核心业务：智慧园林管理</h2>
+    <p class="lede">覆盖园林绿化全生命周期——从资产登记到巡检养护，从绩效评估到成本核算。</p>
+    <div class="arch-layers">
+      <div class="al hl"><div class="al-name">管理端</div>
+        <div class="al-cells">
+          <div class="acell"><div class="aci">🌲</div><h4>树木资产管理</h4><p>古树名木 / 变更日志</p></div>
+          <div class="acell"><div class="aci">📅</div><h4>巡检计划管理</h4><p>计划制定 / 明细配置</p></div>
+          <div class="acell"><div class="aci">🔧</div><h4>养护计划管理</h4><p>养护任务 / 执行跟踪</p></div>
+          <div class="acell"><div class="aci">📊</div><h4>绩效管理</h4><p>指标定义 / 专家评定</p></div>
+          <div class="acell"><div class="aci">📦</div><h4>物料管理</h4><p>物料类型 / 出入库</p></div>
+          <div class="acell"><div class="aci">💰</div><h4>机械成本</h4><p>折旧 / 租赁核算</p></div>
+        </div>
+      </div>
+      <div class="al fw"><div class="al-name">移动端</div>
+        <div class="al-cells" style="grid-template-columns:repeat(5,1fr)">
+          <div class="acell"><div class="aci">📱</div><h4>首页概览</h4><p>数据汇总</p></div>
+          <div class="acell"><div class="aci">📍</div><h4>GPS 定位</h4><p>位置上报</p></div>
+          <div class="acell"><div class="aci">✅</div><h4>巡检提交</h4><p>现场打卡</p></div>
+          <div class="acell"><div class="aci">🛠️</div><h4>养护提交</h4><p>任务执行</p></div>
+          <div class="acell"><div class="aci">📝</div><h4>变更记录</h4><p>树木变更</p></div>
+        </div>
+      </div>
+    </div>
+    <div class="grid g4 mt-m">
+      <div class="card card-accent"><h4>定时任务</h4><p class="dim">自动生成巡检/养护计划</p></div>
+      <div class="card card-accent"><h4>数据权限</h4><p class="dim">按区域隔离园林数据</p></div>
+      <div class="card card-accent"><h4>时间区间</h4><p class="dim">灵活配置任务执行周期</p></div>
+      <div class="card card-accent"><h4>防重复提交</h4><p class="dim">计划明细幂等性保证</p></div>
+    </div>
+  </section>
+
+  <!-- ====== 6. Workorder Business ====== -->
+  <section class="slide" data-title="Business · Workorder">
+    <p class="kicker">workorder · dispatch</p>
+    <h2 class="h2">工单调度：事件驱动 + 流程闭环</h2>
+    <div class="col2">
+      <div>
+        <div class="card card-accent" style="padding:22px">
+          <h4 style="color:#fff;margin:0 0 12px">工单核心实体模型</h4>
+          <div class="stack">
+            <div class="tag">📋 MainInfo — 工单主信息</div>
+            <div class="tag">📎 Attachment — 附件管理</div>
+            <div class="tag">📦 MaterialDetail — 物料明细</div>
+            <div class="tag">🎯 EventInfo — 事件信息</div>
+            <div class="tag">🔗 EventMappingInfo — 事件映射</div>
+            <div class="tag">🌳 GardenRef — 园林业务关联</div>
+          </div>
+        </div>
+      </div>
+      <div>
+        <div class="card" style="padding:22px;border-top:3px solid var(--accent-2)">
+          <h4 style="color:#fff;margin:0 0 12px">工单处理流程</h4>
+          <div style="display:flex;flex-direction:column;gap:8px">
+            <div style="display:flex;align-items:center;gap:8px">
+              <div class="fs" style="flex:1"><div class="fs-icon">📝</div><h4>事件上报</h4></div>
+              <span class="fs-arr">→</span>
+              <div class="fs" style="flex:1"><div class="fs-icon">🔍</div><h4>工单生成</h4></div>
+              <span class="fs-arr">→</span>
+              <div class="fs hl" style="flex:1"><div class="fs-icon">👤</div><h4>人员指派</h4></div>
+            </div>
+            <div style="display:flex;align-items:center;gap:8px">
+              <div class="fs" style="flex:1"><div class="fs-icon">🔧</div><h4>现场处理</h4></div>
+              <span class="fs-arr">→</span>
+              <div class="fs" style="flex:1"><div class="fs-icon">📋</div><h4>结果反馈</h4></div>
+              <span class="fs-arr">→</span>
+              <div class="fs" style="flex:1"><div class="fs-icon">✅</div><h4>审核结单</h4></div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div class="code-text mt-m">WorkorderModule → GardenModule (Feign API) · EventMapping 策略 · GeoCode 位置服务 · 数据权限隔离</div>
+  </section>
+
+  <!-- ====== 7. BPM Business ====== -->
+  <section class="slide" data-title="Business · BPM">
+    <p class="kicker">bpm · flowable-engine</p>
+    <h2 class="h2">工作流引擎：同时支持<br>「轻量配置」与「深度编排」</h2>
+    <div class="grid g2 mt-l" style="align-items:start">
+      <div>
+        <div class="card card-accent" style="padding:22px">
+          <h4 style="color:var(--accent);font-family:'JetBrains Mono',monospace;font-size:13px">SIMPLE 设计器</h4>
+          <p class="dim" style="font-size:13px">仿钉钉/飞书体验，拖拽搭建表单流程，10 分钟完成配置</p>
+          <div class="stack mt-s">
+            <div class="tag">✦ 拖拽式表单设计</div>
+            <div class="tag">✦ 审批节点可视化配置</div>
+            <div class="tag">✦ 抄送人 / 条件分支</div>
+            <div class="tag">✦ 超时审批 / 自动提醒</div>
+          </div>
+        </div>
+      </div>
+      <div>
+        <div class="card" style="padding:22px;border-top:3px solid #d2a8ff">
+          <h4 style="color:#d2a8ff;font-family:'JetBrains Mono',monospace;font-size:13px">BPMN 设计器</h4>
+          <p class="dim" style="font-size:13px">基于 BPMN 2.0 标准，适配复杂多层级审批及自动化场景</p>
+          <div class="stack mt-s">
+            <div class="tag">✦ 会签 / 或签 / 依次审批</div>
+            <div class="tag">✦ 转办 / 委派 / 加签 / 减签</div>
+            <div class="tag">✦ 并行 / 包容 / 路由分支</div>
+            <div class="tag">✦ 父子流程 / 触发节点</div>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div class="grid g3 mt-m">
+      <div class="card"><h4 style="color:#fff;font-size:14px">Flowable 7.0</h4><p class="dim">核心流程引擎</p></div>
+      <div class="card"><h4 style="color:#fff;font-size:14px">信创数据库兼容</h4><p class="dim">DM8 / KingBase / OpenGauss</p></div>
+      <div class="card"><h4 style="color:#fff;font-size:14px">动态表单</h4><p class="dim">节点级只读/编辑/隐藏权限</p></div>
+    </div>
+  </section>
+
+  <!-- ====== 8. Global & System Business ====== -->
+  <section class="slide" data-title="Business · Global & System">
+    <p class="kicker">global · system · infra</p>
+    <h2 class="h2">业务支撑域：<br>公共服务与系统管理</h2>
+    <div class="grid g2 mt-l" style="align-items:start;gap:20px">
+      <div>
+        <h4 style="color:var(--accent-2);font-family:'JetBrains Mono',monospace;font-size:13px;margin-bottom:12px">🌐 Global 全局模块</h4>
+        <div class="stack">
+          <div class="card card-accent" style="padding:14px 16px"><h4 style="font-size:14px">问题上报管理</h4><p class="dim" style="font-size:11px">公共问题发现 → 流转到工单系统</p></div>
+          <div class="card card-accent" style="padding:14px 16px"><h4 style="font-size:14px">道路信息管理</h4><p class="dim" style="font-size:11px">道路基础数据维护</p></div>
+          <div class="card card-accent" style="padding:14px 16px"><h4 style="font-size:14px">工单提交详情</h4><p class="dim" style="font-size:11px">跨模块工单数据聚合视图</p></div>
+          <div class="card card-accent" style="padding:14px 16px"><h4 style="font-size:14px">流程路径想法</h4><p class="dim" style="font-size:11px">流程优化建议收集</p></div>
+        </div>
+      </div>
+      <div>
+        <h4 style="color:#d2a8ff;font-family:'JetBrains Mono',monospace;font-size:13px;margin-bottom:12px">⚙️ System + Infra 模块</h4>
+        <div class="stack">
+          <div class="card" style="padding:14px 16px;border-top:2px solid var(--accent-2)"><h4 style="font-size:14px">RBAC 权限体系</h4><p class="dim" style="font-size:11px">用户 → 角色 → 菜单 → 按钮权限 · 数据权限</p></div>
+          <div class="card" style="padding:14px 16px;border-top:2px solid var(--accent-2)"><h4 style="font-size:14px">SaaS 多租户</h4><p class="dim" style="font-size:11px">租户管理 · 套餐配置 · 数据隔离 · 透明化封装</p></div>
+          <div class="card" style="padding:14px 16px;border-top:2px solid var(--accent-2)"><h4 style="font-size:14px">代码生成器</h4><p class="dim" style="font-size:11px">一键生成 Java · Vue · SQL · 接口文档</p></div>
+          <div class="card" style="padding:14px 16px;border-top:2px solid var(--accent-2)"><h4 style="font-size:14px">消息通知中心</h4><p class="dim" style="font-size:11px">短信 · 邮件 · 站内信 · 多通道</p></div>
+        </div>
+      </div>
+    </div>
+  </section>
+
+  <!-- ====== 9. Tech Stack Layers (from file1) ====== -->
+  <section class="slide" data-title="Tech Stack Layers">
+    <p class="kicker">tech-stack · layers</p>
+    <h2 class="h2">技术栈七层全景</h2>
+    <div class="layer-stack">
+      <div class="layer"><div class="layer-label">前端</div><div class="layer-content"><span class="tag">Vue 3</span><span class="tag">Element Plus</span><span class="tag">Vben Admin</span><span class="tag">uni-app</span><span class="tag">TypeScript</span></div></div>
+      <div class="layer"><div class="layer-label">网关 & 接入</div><div class="layer-content"><span class="tag">Vert.x</span><span class="tag">MQTT</span><span class="tag">HTTP/2</span><span class="tag">TCP</span><span class="tag">WebSocket</span></div></div>
+      <div class="layer"><div class="layer-label">业务框架</div><div class="layer-content"><span class="tag">Spring Boot 3.5</span><span class="tag">Spring Security</span><span class="tag">Flowable 7</span><span class="tag">Quartz</span><span class="tag">Spring AI</span><span class="tag">PF4J</span></div></div>
+      <div class="layer"><div class="layer-label">数据层</div><div class="layer-content"><span class="tag">MyBatis Plus</span><span class="tag">Druid</span><span class="tag">MySQL 8</span><span class="tag">Redis Sentinel</span><span class="tag">Redisson</span><span class="tag">Dynamic DS</span></div></div>
+      <div class="layer"><div class="layer-label">消息 & 集成</div><div class="layer-content"><span class="tag">RocketMQ</span><span class="tag">Kafka</span><span class="tag">RabbitMQ</span><span class="tag">JustAuth</span><span class="tag">UAA SSO</span><span class="tag">S3</span></div></div>
+      <div class="layer"><div class="layer-label">可观测性</div><div class="layer-content"><span class="tag">SkyWalking</span><span class="tag">SBA Admin</span><span class="tag">OpenTracing</span><span class="tag">Actuator</span><span class="tag">Knife4j</span></div></div>
+      <div class="layer"><div class="layer-label">部署 & DevOps</div><div class="layer-content"><span class="tag">Docker</span><span class="tag">docker-compose</span><span class="tag">Eclipse Temurin 21</span><span class="tag">Maven</span><span class="tag">Git</span></div></div>
+    </div>
+  </section>
+
+  <!-- ====== 10. System Architecture Overview SVG (from file1 slide 4) ====== -->
+  <section class="slide" data-title="System Architecture Overview">
+    <p class="kicker">architecture · system-overview</p>
+    <h2 class="h2">系统架构总览 — 五层全景</h2>
+    <div class="svg-area">
+      <svg viewBox="0 0 1000 460" xmlns="http://www.w3.org/2000/svg">
+        <defs>
+          <linearGradient id="gAccent" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" stop-color="#38bdf8"/><stop offset="100%" stop-color="#818cf8"/></linearGradient>
+          <linearGradient id="gGreen" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" stop-color="#34d399"/><stop offset="100%" stop-color="#22c55e"/></linearGradient>
+          <linearGradient id="gPink" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" stop-color="#f472b6"/><stop offset="100%" stop-color="#e879f9"/></linearGradient>
+          <filter id="shadow"><feDropShadow dx="0" dy="2" stdDeviation="4" flood-opacity="0.3"/></filter>
+        </defs>
+        <rect x="30" y="10" width="940" height="60" rx="10" fill="#161b22" stroke="#1e2d45" stroke-width="1.5"/>
+        <text x="500" y="35" text-anchor="middle" fill="#8b949e" font-size="12" font-weight="600">接入层 CLIENT LAYER</text>
+        <rect x="60" y="42" width="100" height="22" rx="6" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1"/><text x="110" y="57" text-anchor="middle" fill="#38bdf8" font-size="10">Vue 3 Web</text>
+        <rect x="180" y="42" width="100" height="22" rx="6" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1"/><text x="230" y="57" text-anchor="middle" fill="#38bdf8" font-size="10">uni-app 小程序</text>
+        <rect x="300" y="42" width="100" height="22" rx="6" fill="rgba(129,140,248,.12)" stroke="#818cf8" stroke-width="1"/><text x="350" y="57" text-anchor="middle" fill="#818cf8" font-size="10">IoT 设备</text>
+        <rect x="420" y="42" width="100" height="22" rx="6" fill="rgba(129,140,248,.12)" stroke="#818cf8" stroke-width="1"/><text x="470" y="57" text-anchor="middle" fill="#818cf8" font-size="10">第三方系统</text>
+        <line x1="500" y1="70" x2="500" y2="90" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="4,3"/>
+
+        <rect x="30" y="90" width="940" height="80" rx="10" fill="#161b22" stroke="#1e2d45" stroke-width="1.5"/>
+        <text x="500" y="115" text-anchor="middle" fill="#8b949e" font-size="12" font-weight="600">网关与接入 GATEWAY LAYER</text>
+        <rect x="60" y="127" width="200" height="32" rx="8" fill="rgba(56,189,248,.1)" stroke="#38bdf8" stroke-width="1.5" filter="url(#shadow)"/><text x="160" y="147" text-anchor="middle" fill="#38bdf8" font-size="11" font-weight="600">UrbanOps Server :48081</text>
+        <rect x="300" y="127" width="200" height="32" rx="8" fill="rgba(52,211,153,.1)" stroke="#34d399" stroke-width="1.5" filter="url(#shadow)"/><text x="400" y="147" text-anchor="middle" fill="#34d399" font-size="11" font-weight="600">IoT 网关 :8092 (独立部署)</text>
+        <rect x="540" y="127" width="180" height="32" rx="8" fill="rgba(129,140,248,.1)" stroke="#818cf8" stroke-width="1.5" filter="url(#shadow)"/><text x="630" y="147" text-anchor="middle" fill="#818cf8" font-size="11" font-weight="600">UAA SSO :28201</text>
+        <line x1="500" y1="170" x2="500" y2="190" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="4,3"/>
+
+        <rect x="30" y="190" width="940" height="130" rx="10" fill="#161b22" stroke="#1e2d45" stroke-width="1.5"/>
+        <text x="500" y="215" text-anchor="middle" fill="#8b949e" font-size="12" font-weight="600">业务模块层 BUSINESS MODULES</text>
+        <rect x="50" y="228" width="145" height="42" rx="8" fill="rgba(56,189,248,.1)" stroke="#38bdf8" stroke-width="1.5"/><text x="122" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">system</text><text x="122" y="260" text-anchor="middle" fill="#8b949e" font-size="9">用户·权限·租户</text>
+        <rect x="210" y="228" width="145" height="42" rx="8" fill="rgba(129,140,248,.1)" stroke="#818cf8" stroke-width="1.5"/><text x="282" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">garden</text><text x="282" y="260" text-anchor="middle" fill="#8b949e" font-size="9">园林养护·巡检</text>
+        <rect x="370" y="228" width="145" height="42" rx="8" fill="rgba(52,211,153,.1)" stroke="#34d399" stroke-width="1.5"/><text x="442" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">workorder</text><text x="442" y="260" text-anchor="middle" fill="#8b949e" font-size="9">工单·调度</text>
+        <rect x="530" y="228" width="145" height="42" rx="8" fill="rgba(244,114,182,.1)" stroke="#f472b6" stroke-width="1.5"/><text x="602" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">bpm</text><text x="602" y="260" text-anchor="middle" fill="#8b949e" font-size="9">Flowable 流程</text>
+        <rect x="690" y="228" width="145" height="42" rx="8" fill="rgba(251,191,36,.1)" stroke="#fbbf24" stroke-width="1.5"/><text x="762" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">gloabl</text><text x="762" y="260" text-anchor="middle" fill="#8b949e" font-size="9">全域运营</text>
+        <rect x="250" y="280" width="500" height="30" rx="8" fill="rgba(255,255,255,.03)" stroke="#334155" stroke-width="1" stroke-dasharray="4,3"/><text x="500" y="299" text-anchor="middle" fill="#8b949e" font-size="10">API 契约层: garden-api · workorder-api (接口定义 + Feign 风格调用)</text>
+        <line x1="500" y1="320" x2="500" y2="340" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="4,3"/>
+
+        <rect x="30" y="340" width="940" height="50" rx="10" fill="#161b22" stroke="#1e2d45" stroke-width="1.5"/>
+        <text x="500" y="370" text-anchor="middle" fill="#8b949e" font-size="11" font-weight="600">基础设施层 INFRASTRUCTURE: 15个Spring Boot Starter (Web · Security · MyBatis · Redis · MQ · Job · Excel · WebSocket · Monitor · Protection · Tenant · DataPermission · IP · Test)</text>
+        <line x1="500" y1="390" x2="500" y2="408" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="4,3"/>
+
+        <rect x="30" y="408" width="940" height="45" rx="10" fill="#0d1117" stroke="#1e2d45" stroke-width="1.5"/>
+        <text x="500" y="435" text-anchor="middle" fill="#8b949e" font-size="11" font-weight="600">数据层: MySQL 8 · Redis Sentinel · RocketMQ · Kafka · RabbitMQ · S3 · Druid · Redisson</text>
+      </svg>
+    </div>
+  </section>
+
+  <!-- ====== 11. Module Dependencies SVG (from file1 slide 5) ====== -->
+  <section class="slide" data-title="Module Dependencies">
+    <p class="kicker">modules · dependency-graph</p>
+    <h2 class="h2">模块依赖关系图</h2>
+    <div class="svg-area">
+      <svg viewBox="0 0 1000 440" xmlns="http://www.w3.org/2000/svg">
+        <defs>
+          <marker id="arrowBlue" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#38bdf8"/></marker>
+          <marker id="arrowGray" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#64748b"/></marker>
+        </defs>
+        <rect x="350" y="8" width="300" height="38" rx="10" fill="rgba(251,191,36,.1)" stroke="#fbbf24" stroke-width="2"/><text x="500" y="32" text-anchor="middle" fill="#fbbf24" font-size="13" font-weight="700">urbanops-dependencies (BOM)</text>
+        <line x1="500" y1="46" x2="500" y2="70" stroke="#fbbf24" stroke-width="1.5" marker-end="url(#arrowBlue)"/>
+
+        <rect x="80" y="72" width="840" height="58" rx="10" fill="#161b22" stroke="#1e2d45" stroke-width="1.5"/>
+        <text x="500" y="94" text-anchor="middle" fill="#8b949e" font-size="11" font-weight="600">urbanops-framework</text>
+        <text x="500" y="113" text-anchor="middle" fill="#64748b" font-size="9">common · web · security · mybatis · redis · mq · job · excel · websocket · monitor · protection · tenant · data-permission · ip · test</text>
+
+        <line x1="300" y1="130" x2="300" y2="155" stroke="#64748b" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+        <line x1="500" y1="130" x2="500" y2="155" stroke="#64748b" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+        <line x1="700" y1="130" x2="700" y2="155" stroke="#64748b" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+
+        <rect x="210" y="158" width="180" height="40" rx="8" fill="rgba(99,102,241,.12)" stroke="#6366f1" stroke-width="1.5"/><text x="300" y="183" text-anchor="middle" fill="#a5b4fc" font-size="12" font-weight="600">module-infra</text>
+        <rect x="410" y="158" width="180" height="40" rx="8" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1.5"/><text x="500" y="183" text-anchor="middle" fill="#38bdf8" font-size="12" font-weight="600">module-system</text>
+        <rect x="610" y="158" width="180" height="40" rx="8" fill="rgba(251,191,36,.12)" stroke="#fbbf24" stroke-width="1.5"/><text x="700" y="183" text-anchor="middle" fill="#fbbf24" font-size="12" font-weight="600">module-gloabl</text>
+
+        <line x1="300" y1="198" x2="300" y2="230" stroke="#64748b" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+        <line x1="500" y1="198" x2="360" y2="230" stroke="#38bdf8" stroke-width="1.2"/>
+        <line x1="500" y1="198" x2="640" y2="230" stroke="#38bdf8" stroke-width="1.2"/>
+
+        <rect x="210" y="233" width="180" height="40" rx="8" fill="rgba(244,114,182,.12)" stroke="#f472b6" stroke-width="1.5"/><text x="300" y="258" text-anchor="middle" fill="#f472b6" font-size="12" font-weight="600">module-bpm</text>
+        <rect x="85" y="308" width="200" height="40" rx="8" fill="rgba(52,211,153,.12)" stroke="#34d399" stroke-width="2"/><text x="185" y="333" text-anchor="middle" fill="#34d399" font-size="12" font-weight="600">module-garden</text>
+        <rect x="420" y="308" width="200" height="40" rx="8" fill="rgba(52,211,153,.12)" stroke="#34d399" stroke-width="2"/><text x="520" y="333" text-anchor="middle" fill="#34d399" font-size="12" font-weight="600">module-workorder</text>
+        <rect x="680" y="308" width="220" height="40" rx="8" fill="rgba(129,140,248,.08)" stroke="#818cf8" stroke-width="1" stroke-dasharray="5,3"/><text x="790" y="333" text-anchor="middle" fill="#818cf8" font-size="11" font-weight="600">module-api (契约层)</text>
+
+        <line x1="240" y1="273" x2="185" y2="307" stroke="#f472b6" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+        <line x1="360" y1="273" x2="520" y2="307" stroke="#f472b6" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+        <line x1="285" y1="330" x2="420" y2="330" stroke="#818cf8" stroke-width="1" stroke-dasharray="5,3" marker-end="url(#arrowGray)"/>
+        <line x1="620" y1="330" x2="680" y2="330" stroke="#818cf8" stroke-width="1" stroke-dasharray="5,3" marker-end="url(#arrowGray)"/>
+
+        <rect x="420" y="380" width="220" height="40" rx="8" fill="rgba(239,68,68,.12)" stroke="#ef4444" stroke-width="1.5" stroke-dasharray="6,3"/><text x="530" y="405" text-anchor="middle" fill="#ef4444" font-size="12" font-weight="600">IoT 网关 (独立进程 :8092)</text>
+        <line x1="620" y1="348" x2="560" y2="379" stroke="#ef4444" stroke-width="1" stroke-dasharray="5,3"/>
+
+        <rect x="30" y="415" width="12" height="12" rx="2" fill="none" stroke="#34d399" stroke-width="1.5"/><text x="48" y="425" fill="#64748b" font-size="9">核心业务域</text>
+        <rect x="150" y="415" width="12" height="12" rx="2" fill="none" stroke="#38bdf8" stroke-width="1.5"/><text x="168" y="425" fill="#64748b" font-size="9">基础服务</text>
+        <rect x="260" y="415" width="12" height="12" rx="2" fill="none" stroke="#ef4444" stroke-width="1.5" stroke-dasharray="3,2"/><text x="278" y="425" fill="#64748b" font-size="9">独立部署</text>
+        <line x1="370" y1="421" x2="400" y2="421" stroke="#818cf8" stroke-width="1" stroke-dasharray="5,3"/><text x="408" y="425" fill="#64748b" font-size="9">API 契约调用</text>
+      </svg>
+    </div>
+  </section>
+
+  <!-- ====== 12. Tech Architecture 5-Layer Model ====== -->
+  <section class="slide" data-title="Tech Architecture">
+    <p class="kicker">architecture · layers</p>
+    <h2 class="h2">技术架构五层模型</h2>
+    <p class="lede">从用户端到底层基础设施，清晰分层、逐级解耦。</p>
+    <div class="arch-layers anim-stagger-list" data-anim-target>
+      <div class="al fw"><div class="al-name" style="color:var(--accent-2)">接入层</div>
+        <div class="al-cells" style="grid-template-columns:repeat(4,1fr)">
+          <div class="acell"><div class="aci">🖥️</div><h4>Web Admin</h4><p>Vue3 + Element Plus</p></div>
+          <div class="acell"><div class="aci">📱</div><h4>Mobile App</h4><p>uni-app 跨端</p></div>
+          <div class="acell"><div class="aci">📊</div><h4>大屏展示</h4><p>GoView 可视化</p></div>
+          <div class="acell"><div class="aci">🔗</div><h4>开放 API</h4><p>第三方对接</p></div>
+        </div>
+      </div>
+      <div class="al fw"><div class="al-name" style="color:var(--accent-2)">网关层</div>
+        <div class="al-cells" style="grid-template-columns:repeat(4,1fr)">
+          <div class="acell"><div class="aci">🔐</div><h4>认证鉴权</h4><p>Spring Security + Token</p></div>
+          <div class="acell"><div class="aci">🚪</div><h4>路由转发</h4><p>Nginx / Gateway</p></div>
+          <div class="acell"><div class="aci">⚖️</div><h4>负载均衡</h4><p>多实例分发</p></div>
+          <div class="acell"><div class="aci">🛡️</div><h4>安全防护</h4><p>XSS / CSRF / SQL注入</p></div>
+        </div>
+      </div>
+      <div class="al hl"><div class="al-name">服务层</div>
+        <div class="al-cells" style="grid-template-columns:repeat(6,1fr)">
+          <div class="acell"><div class="aci">🌳</div><h4>Garden</h4><p>园林管理</p></div>
+          <div class="acell"><div class="aci">📋</div><h4>Workorder</h4><p>工单调度</p></div>
+          <div class="acell"><div class="aci">🔄</div><h4>BPM</h4><p>工作流</p></div>
+          <div class="acell"><div class="aci">🌐</div><h4>Global</h4><p>全局服务</p></div>
+          <div class="acell"><div class="aci">⚙️</div><h4>System</h4><p>系统管理</p></div>
+          <div class="acell"><div class="aci">🏗️</div><h4>Infra</h4><p>基础设施</p></div>
+        </div>
+      </div>
+      <div class="al"><div class="al-name">中间件</div>
+        <div class="al-cells" style="grid-template-columns:repeat(5,1fr)">
+          <div class="acell"><div class="aci">🗄️</div><h4>MySQL</h4><p>OLTP</p></div>
+          <div class="acell"><div class="aci">⚡</div><h4>Redis</h4><p>缓存/锁</p></div>
+          <div class="acell"><div class="aci">📨</div><h4>RocketMQ</h4><p>消息队列</p></div>
+          <div class="acell"><div class="aci">🔍</div><h4>Elasticsearch</h4><p>全文检索</p></div>
+          <div class="acell"><div class="aci">📡</div><h4>TDengine</h4><p>时序数据</p></div>
+        </div>
+      </div>
+    </div>
+  </section>
+
+  <!-- ====== 13. Backend Layered Architecture ====== -->
+  <section class="slide" data-title="Backend Architecture">
+    <p class="kicker">backend · layered</p>
+    <h2 class="h2">后端分层架构：<br>Controller → Service → DAL 三层解耦</h2>
+    <div class="grid g2 mt-l" style="align-items:start;gap:20px">
+      <div class="stack">
+        <div class="card card-accent" style="padding:16px"><h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent)">controller/</h4><p class="dim" style="font-size:12px;margin-bottom:6px">接收请求、参数校验、VO 转换</p><div class="biz-tags"><span>admin/</span><span>app/</span><span>VO 对象</span><span>@Valid</span></div></div>
+        <div class="card card-accent" style="padding:16px"><h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent)">service/</h4><p class="dim" style="font-size:12px;margin-bottom:6px">业务逻辑编排、事务管理、策略模式</p><div class="biz-tags"><span>接口+实现</span><span>@Transactional</span><span>策略</span><span>Listener</span></div></div>
+        <div class="card card-accent" style="padding:16px"><h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent)">dal/</h4><p class="dim" style="font-size:12px;margin-bottom:6px">数据访问层：MySQL Mapper + Redis Cache</p><div class="biz-tags"><span>mysql/</span><span>redis/</span><span>dataobject/</span></div></div>
+      </div>
+      <div class="stack">
+        <div class="card" style="padding:16px;border-top:2px solid var(--accent-2)"><h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent-2)">convert/</h4><p class="dim" style="font-size:12px">MapStruct 对象转换层，编译期生成高性能映射代码</p></div>
+        <div class="card" style="padding:16px;border-top:2px solid var(--accent-2)"><h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent-2)">api/</h4><p class="dim" style="font-size:12px">模块间 Feign 接口定义 + DTO，实现跨模块调用</p></div>
+        <div class="card" style="padding:16px;border-top:2px solid var(--accent-2)"><h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent-2)">mq/ + job/</h4><p class="dim" style="font-size:12px">异步消息（producer/consumer）+ 定时任务调度</p></div>
+        <div class="card" style="padding:16px;border-top:2px solid var(--accent-2)"><h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent-2)">framework/</h4><p class="dim" style="font-size:12px">模块内框架代码：数据权限配置、Web 配置、操作日志等</p></div>
+      </div>
+    </div>
+  </section>
+
+  <!-- ====== 14. Framework Infrastructure ====== -->
+  <section class="slide" data-title="Framework Infrastructure">
+    <p class="kicker">framework · starters</p>
+    <h2 class="h2">基础设施层：<br>15 个 Spring Boot Starter</h2>
+    <p class="lede">将通用能力抽象为可复用的 Starter 组件，所有业务模块按需引入。</p>
+    <div class="fw-grid">
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up"><div class="fwi">🌐</div><h4>web</h4><p>全局异常处理 · 统一返回 · CORS · Swagger</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.05s"><div class="fwi">🔐</div><h4>security</h4><p>Spring Security · Token 鉴权 · SSO</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.1s"><div class="fwi">🗄️</div><h4>mybatis</h4><p>MyBatis Plus · 多数据源 · 联表查询</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.15s"><div class="fwi">⚡</div><h4>redis</h4><p>Redisson · 分布式锁 · 缓存策略</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.2s"><div class="fwi">📨</div><h4>mq</h4><p>RocketMQ 集成 · 消息幂等 · 重试</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.25s"><div class="fwi">🛡️</div><h4>protection</h4><p>分布式锁 · 幂等 · 限流 · 熔断</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.3s"><div class="fwi">📊</div><h4>monitor</h4><p>SkyWalking · Admin · 日志中心</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.35s"><div class="fwi">⏰</div><h4>job</h4><p>Quartz 定时任务 · 执行日志</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.4s"><div class="fwi">📝</div><h4>excel</h4><p>FastExcel 导入导出</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.45s"><div class="fwi">🔌</div><h4>websocket</h4><p>实时通信 · Token 校验 · 集群</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.5s"><div class="fwi">🏢</div><h4>biz-tenant</h4><p>多租户数据隔离 · 透明封装</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.55s"><div class="fwi">🔒</div><h4>biz-data-permission</h4><p>数据权限 · 行级过滤</p></div>
+    </div>
+  </section>
+
+  <!-- ====== 15. Core Tech Stack Grid ====== -->
+  <section class="slide" data-title="Tech Stack Grid">
+    <p class="kicker">tech-stack · ecosystem</p>
+    <h2 class="h2">核心技术栈全景</h2>
+    <div class="tg">
+      <div class="tgc anim-fade-up" data-anim="fade-up"><div class="tgci">☕</div><h4>核心框架</h4><div class="tgt"><span>Spring Boot 3.5.5</span><span>Spring MVC 6.x</span><span>Spring Security 6.x</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.05s"><div class="tgci">🗄️</div><h4>持久层</h4><div class="tgt"><span>MyBatis Plus 3.5.14</span><span>Druid 1.2.27</span><span>Dynamic-DS 4.3.1</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.1s"><div class="tgci">⚡</div><h4>缓存 & 锁</h4><div class="tgt"><span>Redis 7.x</span><span>Redisson 3.51</span><span>Lock4j 2.2.7</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.15s"><div class="tgci">📨</div><h4>消息队列</h4><div class="tgt"><span>RocketMQ</span><span>Spring-RocketMQ</span><span>Redis Stream</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.2s"><div class="tgci">🔄</div><h4>工作流</h4><div class="tgt"><span>Flowable 7.0.1</span><span>BPMN 2.0</span><span>SIMPLE 设计器</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.25s"><div class="tgci">📡</div><h4>IoT & 通信</h4><div class="tgt"><span>Vert.x 4.5.13</span><span>Netty 4.2.4</span><span>MQTT 1.2.5</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.3s"><div class="tgci">🔍</div><h4>可观测性</h4><div class="tgt"><span>SkyWalking 9.5</span><span>Admin 3.5.2</span><span>OpenTracing</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.35s"><div class="tgci">📋</div><h4>API 文档</h4><div class="tgt"><span>Springdoc 2.8.11</span><span>Knife4j 4.5.0</span><span>Swagger 3</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.4s"><div class="tgci">🔌</div><h4>插件 & 工具</h4><div class="tgt"><span>PF4J 0.9.0</span><span>MapStruct 1.6.3</span><span>Hutool 5.8+6.0</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.45s"><div class="tgci">🧪</div><h4>测试</h4><div class="tgt"><span>JUnit 5</span><span>Mockito 5.x</span><span>Jedis-Mock</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.5s"><div class="tgci">🗄️</div><h4>多数据库</h4><div class="tgt"><span>MySQL 8.x</span><span>DM8</span><span>KingBase</span><span>OpenGauss</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.55s"><div class="tgci">🐳</div><h4>部署运维</h4><div class="tgt"><span>Docker</span><span>K8s</span><span>Jenkins</span><span>Harbor</span></div></div>
+    </div>
+  </section>
+
+  <!-- ====== 16. Data Flow & Communication SVG (from file1 slide 7) ====== -->
+  <section class="slide" data-title="Data Flow & Communication">
+    <p class="kicker">data-flow · communication</p>
+    <h2 class="h2">数据流与通信架构</h2>
+    <div class="svg-area">
+      <svg viewBox="0 0 1000 420" xmlns="http://www.w3.org/2000/svg">
+        <defs>
+          <marker id="arrGreen" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#34d399"/></marker>
+          <marker id="arrBlue2" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#38bdf8"/></marker>
+          <marker id="arrPink" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#f472b6"/></marker>
+          <marker id="arrYellow" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#fbbf24"/></marker>
+        </defs>
+        <rect x="350" y="160" width="300" height="60" rx="14" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="2.5" filter="url(#shadow)"/><text x="500" y="187" text-anchor="middle" fill="#e2e8f0" font-size="15" font-weight="700">UrbanOps Server</text><text x="500" y="205" text-anchor="middle" fill="#8b949e" font-size="10">核心业务处理引擎</text>
+
+        <rect x="60" y="60" width="160" height="50" rx="10" fill="rgba(59,130,246,.12)" stroke="#3b82f6" stroke-width="1.5"/><text x="140" y="82" text-anchor="middle" fill="#60a5fa" font-size="12" font-weight="600">MySQL 8</text><text x="140" y="98" text-anchor="middle" fill="#8b949e" font-size="9">主从 + Druid 连接池</text>
+        <line x1="220" y1="85" x2="348" y2="175" stroke="#3b82f6" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrBlue2)"/>
+
+        <rect x="60" y="150" width="160" height="50" rx="10" fill="rgba(239,68,68,.12)" stroke="#ef4444" stroke-width="1.5"/><text x="140" y="172" text-anchor="middle" fill="#f87171" font-size="12" font-weight="600">Redis Sentinel</text><text x="140" y="188" text-anchor="middle" fill="#8b949e" font-size="9">缓存 · 分布式锁 · Token</text>
+        <line x1="220" y1="175" x2="348" y2="180" stroke="#ef4444" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrBlue2)"/>
+
+        <rect x="60" y="240" width="160" height="50" rx="10" fill="rgba(52,211,153,.12)" stroke="#34d399" stroke-width="1.5"/><text x="140" y="262" text-anchor="middle" fill="#4ade80" font-size="12" font-weight="600">MQ 消息队列</text><text x="140" y="278" text-anchor="middle" fill="#8b949e" font-size="9">RocketMQ · Kafka · RabbitMQ</text>
+        <line x1="220" y1="265" x2="348" y2="195" stroke="#34d399" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrGreen)"/>
+
+        <rect x="740" y="60" width="200" height="50" rx="10" fill="rgba(244,114,182,.12)" stroke="#f472b6" stroke-width="1.5"/><text x="840" y="82" text-anchor="middle" fill="#f472b6" font-size="12" font-weight="600">IoT 网关 :8092</text><text x="840" y="98" text-anchor="middle" fill="#8b949e" font-size="9">Vert.x · MQTT · TCP</text>
+        <line x1="740" y1="85" x2="652" y2="175" stroke="#f472b6" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrPink)"/>
+
+        <rect x="740" y="160" width="200" height="50" rx="10" fill="rgba(251,191,36,.12)" stroke="#fbbf24" stroke-width="1.5"/><text x="840" y="182" text-anchor="middle" fill="#fbbf24" font-size="12" font-weight="600">IoT 设备层</text><text x="840" y="198" text-anchor="middle" fill="#8b949e" font-size="9">传感器 · GPS · 控制器</text>
+        <line x1="740" y1="185" x2="940" y2="185" stroke="#fbbf24" stroke-width="1.2" stroke-dasharray="4,3"/>
+        <line x1="840" y1="210" x2="840" y2="350" stroke="#fbbf24" stroke-width="1" stroke-dasharray="4,3"/>
+
+        <rect x="740" y="240" width="200" height="50" rx="10" fill="rgba(129,140,248,.12)" stroke="#818cf8" stroke-width="1.5"/><text x="840" y="262" text-anchor="middle" fill="#a5b4fc" font-size="12" font-weight="600">对象存储 S3</text><text x="840" y="278" text-anchor="middle" fill="#8b949e" font-size="9">文件 · 图片 · 附件</text>
+        <line x1="740" y1="265" x2="652" y2="205" stroke="#818cf8" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrBlue2)"/>
+
+        <rect x="60" y="330" width="160" height="50" rx="10" fill="rgba(244,114,182,.12)" stroke="#f472b6" stroke-width="1.5"/><text x="140" y="352" text-anchor="middle" fill="#f472b6" font-size="12" font-weight="600">Flowable 7</text><text x="140" y="368" text-anchor="middle" fill="#8b949e" font-size="9">工作流引擎</text>
+        <line x1="220" y1="355" x2="348" y2="220" stroke="#f472b6" stroke-width="1.2" stroke-dasharray="6,3"/>
+
+        <rect x="320" y="340" width="160" height="50" rx="10" fill="rgba(251,191,36,.12)" stroke="#fbbf24" stroke-width="1.5"/><text x="400" y="362" text-anchor="middle" fill="#fbbf24" font-size="12" font-weight="600">Quartz 调度</text><text x="400" y="378" text-anchor="middle" fill="#8b949e" font-size="9">定时任务集群</text>
+        <line x1="480" y1="340" x2="500" y2="222" stroke="#fbbf24" stroke-width="1.2" stroke-dasharray="6,3"/>
+
+        <rect x="560" y="340" width="190" height="50" rx="10" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1.5"/><text x="655" y="362" text-anchor="middle" fill="#38bdf8" font-size="12" font-weight="600">WebSocket</text><text x="655" y="378" text-anchor="middle" fill="#8b949e" font-size="9">实时消息推送</text>
+        <line x1="560" y1="365" x2="502" y2="222" stroke="#38bdf8" stroke-width="1.2" stroke-dasharray="6,3"/>
+      </svg>
+    </div>
+  </section>
+
+  <!-- ====== 17. Data Storage Strategy ====== -->
+  <section class="slide" data-title="Data Storage">
+    <p class="kicker">database · strategy</p>
+    <h2 class="h2">数据存储策略：<br>多数据源 + 多数据库 + 读写分离</h2>
+    <div class="grid g2 mt-l" style="align-items:start;gap:20px">
+      <div>
+        <div class="card card-accent" style="padding:22px"><h4 style="font-family:'JetBrains Mono',monospace;font-size:14px;color:var(--accent)">Dynamic-Datasource 多数据源</h4>
+          <div class="stack mt-m"><div class="tag"><span style="color:var(--accent)">●</span> 一主多从读写分离</div><div class="tag"><span style="color:var(--accent)">●</span> @DS 注解切换数据源</div><div class="tag"><span style="color:var(--accent)">●</span> Druid 连接池监控</div></div></div>
+        <div class="card" style="padding:22px;border-top:3px solid var(--accent-2);margin-top:12px"><h4 style="font-family:'JetBrains Mono',monospace;font-size:14px;color:var(--accent-2)">Redis 缓存体系</h4>
+          <div class="stack mt-m"><div class="tag">○ Redisson 分布式锁 · 幂等键</div><div class="tag">○ Redis Stream 轻量 MQ</div><div class="tag">○ Token 存储 & 在线用户管理</div></div></div>
+      </div>
+      <div>
+        <div class="card" style="padding:22px;border-top:3px solid #d2a8ff"><h4 style="font-family:'JetBrains Mono',monospace;font-size:14px;color:#d2a8ff">多数据库兼容矩阵</h4>
+          <div class="stack mt-m"><div class="tag"><span style="color:#d2a8ff">■</span> MySQL 5.7/8.0+ — 主力库</div><div class="tag"><span style="color:#d2a8ff">■</span> 达梦 DM8 — 国产信创</div><div class="tag"><span style="color:#d2a8ff">■</span> 人大金仓 KingBase 8.6 — 信创</div><div class="tag"><span style="color:#d2a8ff">■</span> OpenGauss 5.1 — 华为开源</div><div class="tag"><span style="color:#d2a8ff">■</span> Oracle / PostgreSQL / SQL Server</div><div class="tag"><span style="color:#d2a8ff">■</span> TDengine 3.7 — IoT 时序数据</div></div></div>
+        <div class="card card-accent" style="padding:22px;margin-top:12px"><h4 style="font-size:14px;color:#fff">数据隔离策略</h4><p class="dim" style="font-size:12px">SaaS 多租户：共享数据表 + tenant_id 字段隔离，biz-tenant Starter 透明拦截 SQL</p></div>
+      </div>
+    </div>
+  </section>
+
+  <!-- ====== 18. Module Invocation Logic ====== -->
+  <section class="slide" data-title="Invocation Logic">
+    <p class="kicker">invocation · communication</p>
+    <h2 class="h2">模块调用逻辑：三种通信通道</h2>
+    <div class="invoc-flow mt-l">
+      <div class="invoc-row"><div class="ir-label" style="color:var(--accent)">Feign API</div><div class="ir-items"><span>System → Dept API</span><span>System → User API</span><span>Workorder → Garden API</span><span>Garden → System API</span></div></div>
+      <div class="ir-arrow">▼ 同步调用 · 模块间 RPC · 请求/响应模式 ▼</div>
+      <div class="invoc-row"><div class="ir-label" style="color:var(--accent-2)">MQ 消息</div><div class="ir-items"><span>SMS Producer → Consumer</span><span>Mail Producer → Consumer</span><span>Event → 多消费者</span><span>RocketMQ Topic</span><span>Redis Stream</span></div></div>
+      <div class="ir-arrow">▼ 异步解耦 · 事件驱动 · 最终一致性 ▼</div>
+      <div class="invoc-row"><div class="ir-label" style="color:#d2a8ff">直接依赖</div><div class="ir-items"><span>Server → All Modules</span><span>Workorder → Garden Service</span><span>BPM → System User</span><span>Garden → Infra File</span></div></div>
+    </div>
+    <div class="grid g3 mt-l">
+      <div class="card card-accent"><h4 style="font-size:14px">api/ 包设计</h4><p class="dim" style="font-size:12px">每个模块暴露 Feign 接口 + DTO，其他模块引入依赖即可调用，编译期类型安全。</p></div>
+      <div class="card card-accent"><h4 style="font-size:14px">mq/ 包设计</h4><p class="dim" style="font-size:12px">Producer 发送消息，Consumer 消费处理。SMS / Mail 异步发送，不解耦主流程。</p></div>
+      <div class="card card-accent"><h4 style="font-size:14px">service/ 直接注入</h4><p class="dim" style="font-size:12px">同模块内 Service 互相注入。跨模块通过 api 包或直接依赖。</p></div>
+    </div>
+  </section>
+
+  <!-- ====== 19. Message & Async ====== -->
+  <section class="slide" data-title="Message & Async">
+    <p class="kicker">async · event-driven</p>
+    <h2 class="h2">异步消息与事件驱动</h2>
+    <div class="col2">
+      <div><div class="card card-accent" style="padding:20px"><h4 style="color:#fff;margin:0 0 10px">RocketMQ 消息架构</h4>
+        <div class="stack"><div class="tag">📤 Producer → Topic</div><div class="tag">📥 Consumer 拉取并处理</div><div class="tag">🔄 消费失败自动重试</div><div class="tag">⚡ 顺序消息: 全局/分区有序</div><div class="tag">🔒 事务消息: 分布式事务最终一致性</div></div></div></div>
+      <div><div class="card" style="padding:20px;border-top:3px solid var(--accent-2)"><h4 style="color:#fff;margin:0 0 10px">典型异步场景</h4>
+        <div class="stack"><div class="tag">📧 SMS → MQ → 消费者推送</div><div class="tag">📨 邮件 → MQ → 消费者投递</div><div class="tag">🔔 站内信 → Redis Stream 广播</div><div class="tag">📋 操作日志 → 异步记录</div><div class="tag">🔄 工单事件 → 通知园林模块</div></div></div></div>
+    </div>
+    <div class="grid g2 mt-m">
+      <div class="card card-accent"><h4 style="font-size:14px">定时任务 (Quartz)</h4><p class="dim" style="font-size:12px">巡检计划自动生成 · 养护计划定时创建 · 数据统计报表 · 超时任务自动处理</p></div>
+      <div class="card card-accent"><h4 style="font-size:14px">服务保障 (Protection)</h4><p class="dim" style="font-size:12px">@Lock4j 分布式锁防并发 · @Idempotent 幂等性 · @RateLimiter 限流保护 · 熔断降级</p></div>
+    </div>
+  </section>
+
+  <!-- ====== 20. Security Architecture SVG (from file1 slide 8) ====== -->
+  <section class="slide" data-title="Security Architecture">
+    <p class="kicker">security · auth-flow</p>
+    <h2 class="h2">安全与认证架构</h2>
+    <div class="svg-area">
+      <svg viewBox="0 0 1000 400" xmlns="http://www.w3.org/2000/svg">
+        <rect x="30" y="30" width="120" height="60" rx="10" fill="rgba(56,189,248,.1)" stroke="#38bdf8" stroke-width="1.5"/><text x="90" y="55" text-anchor="middle" fill="#38bdf8" font-size="11" font-weight="600">客户端</text><text x="90" y="73" text-anchor="middle" fill="#8b949e" font-size="9">Web / 小程序 / App</text>
+
+        <rect x="200" y="30" width="760" height="60" rx="10" fill="#161b22" stroke="#1e2d45" stroke-width="1.5"/><text x="580" y="52" text-anchor="middle" fill="#8b949e" font-size="11" font-weight="600">Security Filter Chain</text>
+        <rect x="215" y="58" width="130" height="24" rx="6" fill="rgba(239,68,68,.12)" stroke="#ef4444" stroke-width="1"/><text x="280" y="74" text-anchor="middle" fill="#f87171" font-size="9">API 签名校验</text>
+        <rect x="355" y="58" width="120" height="24" rx="6" fill="rgba(251,191,36,.12)" stroke="#fbbf24" stroke-width="1"/><text x="415" y="74" text-anchor="middle" fill="#fbbf24" font-size="9">限流 & 幂等</text>
+        <rect x="485" y="58" width="120" height="24" rx="6" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1"/><text x="545" y="74" text-anchor="middle" fill="#38bdf8" font-size="9">Token 认证</text>
+        <rect x="615" y="58" width="100" height="24" rx="6" fill="rgba(129,140,248,.12)" stroke="#818cf8" stroke-width="1"/><text x="665" y="74" text-anchor="middle" fill="#a5b4fc" font-size="9">权限校验</text>
+        <rect x="725" y="58" width="100" height="24" rx="6" fill="rgba(52,211,153,.12)" stroke="#34d399" stroke-width="1"/><text x="775" y="74" text-anchor="middle" fill="#4ade80" font-size="9">数据脱敏</text>
+        <rect x="835" y="58" width="110" height="24" rx="6" fill="rgba(244,114,182,.12)" stroke="#f472b6" stroke-width="1"/><text x="890" y="74" text-anchor="middle" fill="#f472b6" font-size="9">操作日志</text>
+        <line x1="150" y1="60" x2="198" y2="60" stroke="#38bdf8" stroke-width="2" marker-end="url(#arrBlue2)"/>
+
+        <rect x="200" y="120" width="760" height="110" rx="10" fill="#161b22" stroke="#1e2d45" stroke-width="1.5"/><text x="580" y="145" text-anchor="middle" fill="#8b949e" font-size="11" font-weight="600">认证与授权中心</text>
+        <rect x="220" y="155" width="200" height="42" rx="8" fill="rgba(56,189,248,.1)" stroke="#38bdf8" stroke-width="1.5"/><text x="320" y="174" text-anchor="middle" fill="#e2e8f0" font-size="11" font-weight="600">JWT Token</text><text x="320" y="189" text-anchor="middle" fill="#8b949e" font-size="9">Redis 存储 · 自动续期</text>
+        <rect x="450" y="155" width="200" height="42" rx="8" fill="rgba(129,140,248,.1)" stroke="#818cf8" stroke-width="1.5"/><text x="550" y="174" text-anchor="middle" fill="#e2e8f0" font-size="11" font-weight="600">UAA SSO</text><text x="550" y="189" text-anchor="middle" fill="#8b949e" font-size="9">OAuth2 · 单点登录</text>
+        <rect x="680" y="155" width="250" height="42" rx="8" fill="rgba(52,211,153,.1)" stroke="#34d399" stroke-width="1.5"/><text x="805" y="174" text-anchor="middle" fill="#e2e8f0" font-size="11" font-weight="600">JustAuth 社交登录</text><text x="805" y="189" text-anchor="middle" fill="#8b949e" font-size="9">钉钉 · 企业微信 · 小程序 · 公众号</text>
+        <rect x="220" y="205" width="340" height="20" rx="5" fill="rgba(251,191,36,.08)" stroke="#fbbf24" stroke-width="0.8"/><text x="390" y="219" text-anchor="middle" fill="#fbbf24" font-size="9">多租户数据隔离 (SaaS)</text>
+        <rect x="580" y="205" width="350" height="20" rx="5" fill="rgba(244,114,182,.08)" stroke="#f472b6" stroke-width="0.8"/><text x="755" y="219" text-anchor="middle" fill="#f472b6" font-size="9">部门/用户级数据权限 (RBAC + Data Scope)</text>
+        <line x1="580" y1="230" x2="580" y2="260" stroke="#8b949e" stroke-width="1.5" stroke-dasharray="5,3"/><text x="600" y="250" fill="#64748b" font-size="9">授权通过</text>
+
+        <rect x="200" y="260" width="760" height="50" rx="10" fill="#0d1117" stroke="#1e2d45" stroke-width="1.5"/><text x="580" y="290" text-anchor="middle" fill="#8b949e" font-size="11" font-weight="600">业务模块: garden · workorder · bpm · gloabl · infra · system</text>
+        <rect x="30" y="320" width="120" height="50" rx="10" fill="rgba(251,191,36,.08)" stroke="#fbbf24" stroke-width="1"/><text x="90" y="342" text-anchor="middle" fill="#fbbf24" font-size="11" font-weight="600">AJ Captcha</text><text x="90" y="358" text-anchor="middle" fill="#8b949e" font-size="9">滑块验证</text>
+        <line x1="150" y1="345" x2="198" y2="285" stroke="#fbbf24" stroke-width="0.8" stroke-dasharray="4,3"/>
+        <rect x="30" y="200" width="120" height="50" rx="10" fill="rgba(239,68,68,.08)" stroke="#ef4444" stroke-width="1"/><text x="90" y="222" text-anchor="middle" fill="#f87171" font-size="11" font-weight="600">API 加密</text><text x="90" y="238" text-anchor="middle" fill="#8b949e" font-size="9">AES 算法</text>
+      </svg>
+    </div>
+  </section>
+
+  <!-- ====== 21. Security & Auth Details ====== -->
+  <section class="slide" data-title="Security & Auth">
+    <p class="kicker">security · auth · tenant</p>
+    <h2 class="h2">安全与权限体系详解</h2>
+    <div class="grid g3 mt-l">
+      <div class="card card-accent anim-fade-up" data-anim="fade-up" style="padding:22px"><h4 style="color:#fff;margin-bottom:8px">🔐 认证体系</h4><ul style="font-size:12px;color:var(--text-2);padding-left:16px;line-height:1.8;margin:0"><li>Spring Security 6.x 核心</li><li>Token + Redis 无状态会话</li><li>OAuth2 授权码模式</li><li>多终端（Web / App / 小程序）</li><li>SSO 单点登录</li><li>社交登录（JustAuth）</li></ul></div>
+      <div class="card card-accent anim-fade-up" data-anim="fade-up" style="padding:22px;animation-delay:.1s"><h4 style="color:#fff;margin-bottom:8px">🛡️ 授权体系</h4><ul style="font-size:12px;color:var(--text-2);padding-left:16px;line-height:1.8;margin:0"><li>RBAC：用户 → 角色 → 菜单</li><li>按钮级别权限控制</li><li>动态菜单加载</li><li>Redis 缓存权限信息</li><li>数据权限：行级过滤</li><li>部门数据范围隔离</li></ul></div>
+      <div class="card card-accent anim-fade-up" data-anim="fade-up" style="padding:22px;animation-delay:.2s"><h4 style="color:#fff;margin-bottom:8px">🏢 多租户</h4><ul style="font-size:12px;color:var(--text-2);padding-left:16px;line-height:1.8;margin:0"><li>tenant_id 字段隔离</li><li>MyBatis 拦截器自动注入</li><li>租户套餐权限定制</li><li>每个租户独立菜单/角色</li><li>透明化封装无侵入</li></ul></div>
+    </div>
+    <div class="code-text mt-l">SystemModule → Security Starter → Token + Redis → @PreAuthorize → DataPermission AOP → SQL Interceptor</div>
+  </section>
+
+  <!-- ====== 22. Observability ====== -->
+  <section class="slide" data-title="Observability">
+    <p class="kicker">observability · monitoring</p>
+    <h2 class="h2">可观测性与监控体系</h2>
+    <div class="grid g3 mt-l">
+      <div class="card" style="padding:22px;border-top:3px solid var(--accent)"><h4 style="color:#fff;font-size:16px;margin-bottom:8px">📝 日志体系</h4><p class="dim" style="font-size:12px;line-height:1.7">Logback + SkyWalking Logback Appender，TraceId 自动注入</p><div class="biz-tags mt-s"><span>操作日志</span><span>登录日志</span><span>API 访问日志</span><span>错误日志</span></div></div>
+      <div class="card" style="padding:22px;border-top:3px solid var(--accent-2)"><h4 style="color:#fff;font-size:16px;margin-bottom:8px">📊 指标监控</h4><p class="dim" style="font-size:12px;line-height:1.7">Spring Boot Admin + Druid SQL 监控 + Redis 监控面板</p><div class="biz-tags mt-s"><span>JVM 指标</span><span>连接池</span><span>QPS/RT</span><span>慢 SQL</span></div></div>
+      <div class="card" style="padding:22px;border-top:3px solid #d2a8ff"><h4 style="color:#fff;font-size:16px;margin-bottom:8px">🔍 链路追踪</h4><p class="dim" style="font-size:12px;line-height:1.7">Apache SkyWalking 9.5 分布式追踪，服务拓扑自动发现</p><div class="biz-tags mt-s"><span>调用链</span><span>拓扑图</span><span>慢端点</span><span>告警</span></div></div>
+    </div>
+    <div class="grid g2 mt-m">
+      <div class="card card-accent"><h4 style="font-size:14px">Monitor Starter 集成</h4><p class="dim" style="font-size:12px">SkyWalking · Admin Client · OpenTracing · 日志中心 · 一键接入</p></div>
+      <div class="card card-accent"><h4 style="font-size:14px">保护机制</h4><p class="dim" style="font-size:12px">分布式锁 (Lock4j) · 幂等性保证 · 限流降级 · 异常全局处理 · 错误码统一管理</p></div>
+    </div>
+  </section>
+
+  <!-- ====== 23. Deployment Architecture SVG (from file1 slide 9) ====== -->
+  <section class="slide" data-title="Deployment Architecture SVG">
+    <p class="kicker">deployment · docker</p>
+    <h2 class="h2">部署架构 — Docker 容器化</h2>
+    <div class="svg-area">
+      <svg viewBox="0 0 1000 400" xmlns="http://www.w3.org/2000/svg">
+        <rect x="20" y="20" width="960" height="360" rx="16" fill="#161b22" stroke="#1e2d45" stroke-width="2"/><text x="500" y="48" text-anchor="middle" fill="#64748b" font-size="13" font-weight="600">Docker Host</text>
+
+        <rect x="50" y="65" width="290" height="160" rx="12" fill="rgba(56,189,248,.08)" stroke="#38bdf8" stroke-width="2"/><text x="195" y="92" text-anchor="middle" fill="#38bdf8" font-size="14" font-weight="700">urbanops-server</text><text x="195" y="110" text-anchor="middle" fill="#8b949e" font-size="10">Eclipse Temurin 21 JRE</text><text x="195" y="126" text-anchor="middle" fill="#64748b" font-size="9">-Xms512m -Xmx512m</text>
+        <rect x="70" y="137" width="120" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/><text x="130" y="152" text-anchor="middle" fill="#8b949e" font-size="9">Port 48081</text>
+        <rect x="200" y="137" width="120" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/><text x="260" y="152" text-anchor="middle" fill="#8b949e" font-size="9">Actuator /actuator</text>
+        <rect x="70" y="165" width="250" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/><text x="195" y="180" text-anchor="middle" fill="#8b949e" font-size="9">包含所有业务模块 (fat JAR)</text>
+        <rect x="70" y="193" width="250" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/><text x="195" y="208" text-anchor="middle" fill="#8b949e" font-size="9">SpringDoc /v3/api-docs · Knife4j</text>
+
+        <rect x="370" y="65" width="260" height="160" rx="12" fill="rgba(239,68,68,.08)" stroke="#ef4444" stroke-width="2"/><text x="500" y="92" text-anchor="middle" fill="#f87171" font-size="14" font-weight="700">iot-gateway-server</text><text x="500" y="110" text-anchor="middle" fill="#8b949e" font-size="10">独立部署 · Vert.x 引擎</text>
+        <rect x="390" y="122" width="220" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/><text x="500" y="137" text-anchor="middle" fill="#8b949e" font-size="9">Port 8092</text>
+        <rect x="390" y="150" width="220" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/><text x="500" y="165" text-anchor="middle" fill="#8b949e" font-size="9">协议: MQTT · HTTP · TCP</text>
+        <rect x="390" y="178" width="220" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/><text x="500" y="193" text-anchor="middle" fill="#8b949e" font-size="9">设备接入 · 数据采集</text>
+        <rect x="390" y="206" width="220" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/><text x="500" y="221" text-anchor="middle" fill="#8b949e" font-size="9">HTTP RPC → Server :48080</text>
+
+        <rect x="660" y="65" width="180" height="72" rx="10" fill="rgba(59,130,246,.08)" stroke="#3b82f6" stroke-width="1.5"/><text x="750" y="92" text-anchor="middle" fill="#60a5fa" font-size="12" font-weight="600">MySQL 8</text><text x="750" y="110" text-anchor="middle" fill="#8b949e" font-size="9">:3306</text><text x="750" y="125" text-anchor="middle" fill="#64748b" font-size="8">主从读写分离</text>
+        <rect x="660" y="150" width="180" height="72" rx="10" fill="rgba(239,68,68,.08)" stroke="#ef4444" stroke-width="1.5"/><text x="750" y="177" text-anchor="middle" fill="#f87171" font-size="12" font-weight="600">Redis Sentinel</text><text x="750" y="195" text-anchor="middle" fill="#8b949e" font-size="9">:26379</text><text x="750" y="210" text-anchor="middle" fill="#64748b" font-size="8">高可用集群</text>
+
+        <rect x="860" y="65" width="110" height="72" rx="10" fill="rgba(52,211,153,.08)" stroke="#34d399" stroke-width="1.5"/><text x="915" y="92" text-anchor="middle" fill="#4ade80" font-size="11" font-weight="600">RocketMQ</text><text x="915" y="110" text-anchor="middle" fill="#8b949e" font-size="9">:9876</text>
+        <rect x="860" y="150" width="110" height="72" rx="10" fill="rgba(129,140,248,.08)" stroke="#818cf8" stroke-width="1.5"/><text x="915" y="177" text-anchor="middle" fill="#a5b4fc" font-size="11" font-weight="600">Kafka</text><text x="915" y="195" text-anchor="middle" fill="#8b949e" font-size="9">:9092</text>
+
+        <rect x="660" y="240" width="310" height="40" rx="10" fill="rgba(251,191,36,.08)" stroke="#fbbf24" stroke-width="1.5"/><text x="815" y="265" text-anchor="middle" fill="#fbbf24" font-size="11" font-weight="600">urbanops-admin (前端 Nginx) :8080</text>
+        <rect x="50" y="245" width="580" height="40" rx="10" fill="rgba(129,140,248,.06)" stroke="#6366f1" stroke-width="1.5"/><text x="340" y="270" text-anchor="middle" fill="#a5b4fc" font-size="11" font-weight="600">可观测性: SkyWalking Agent · Spring Boot Admin · OpenTracing · Actuator · 日志采集</text>
+        <rect x="50" y="298" width="580" height="32" rx="8" fill="rgba(244,114,182,.06)" stroke="#f472b6" stroke-width="1" stroke-dasharray="5,3"/><text x="340" y="319" text-anchor="middle" fill="#f472b6" font-size="10">PF4J 插件目录: ../plugins (动态扩展)</text>
+
+        <rect x="50" y="350" width="12" height="12" rx="2" fill="rgba(56,189,248,.3)" stroke="#38bdf8" stroke-width="1"/><text x="68" y="360" fill="#64748b" font-size="9">fat JAR</text>
+        <rect x="140" y="350" width="12" height="12" rx="2" fill="rgba(239,68,68,.3)" stroke="#ef4444" stroke-width="1"/><text x="158" y="360" fill="#64748b" font-size="9">独立进程</text>
+        <rect x="240" y="350" width="12" height="12" rx="2" fill="rgba(59,130,246,.3)" stroke="#3b82f6" stroke-width="1"/><text x="258" y="360" fill="#64748b" font-size="9">数据服务</text>
+        <rect x="340" y="350" width="12" height="12" rx="2" fill="rgba(52,211,153,.3)" stroke="#34d399" stroke-width="1"/><text x="358" y="360" fill="#64748b" font-size="9">消息中间件</text>
+      </svg>
+    </div>
+  </section>
+
+  <!-- ====== 24. CI/CD & Deployment Details ====== -->
+  <section class="slide" data-title="CI/CD & Deployment">
+    <p class="kicker">deployment · ci-cd</p>
+    <h2 class="h2">CI/CD 流水线与运维监控</h2>
+    <div class="deploy-grid mt-l">
+      <div class="deploy-card ci anim-fade-up" data-anim="fade-up"><div class="di">🚀</div><h4>CI 持续集成</h4><ul><li>Jenkins Pipeline</li><li>Maven 多模块构建</li><li>单元测试 + 代码扫描</li><li>Docker 镜像构建</li><li>推送 Harbor 私有仓库</li></ul></div>
+      <div class="deploy-card cn anim-fade-up" data-anim="fade-up" style="animation-delay:.1s"><div class="di">☸️</div><h4>容器编排</h4><ul><li>Kubernetes 集群</li><li>Deployment 滚动更新</li><li>Service 服务发现</li><li>ConfigMap 配置管理</li><li>Ingress 流量入口</li></ul></div>
+      <div class="deploy-card mon anim-fade-up" data-anim="fade-up" style="animation-delay:.2s"><div class="di">📊</div><h4>运维监控</h4><ul><li>Prometheus + Grafana</li><li>SkyWalking 链路追踪</li><li>ELK 日志收集</li><li>AlertManager 告警</li><li>Admin 应用监控</li></ul></div>
+    </div>
+    <div class="card card-accent mt-l" style="padding:22px">
+      <h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent);margin-bottom:12px">Dockerfile — 多阶段构建</h4>
+      <div class="terminal"><div class="bar"><span class="dot"></span><span class="dot"></span><span class="dot"></span><span>urbanops-server/Dockerfile</span></div>
+        <pre><span class="cmt"># Stage 1: 构建</span>
+<span class="kw">FROM</span> maven:3.9-eclipse-temurin-17 <span class="kw">AS</span> builder
+<span class="kw">COPY</span> . /app && <span class="kw">WORKDIR</span> /app
+<span class="kw">RUN</span> mvn clean package -DskipTests
+
+<span class="cmt"># Stage 2: 运行</span>
+<span class="kw">FROM</span> eclipse-temurin:17-jre
+<span class="kw">COPY</span> --from=builder /app/urbanops-server/target/*.jar app.jar
+<span class="kw">ENTRYPOINT</span> ["java","-jar","/app.jar"]</pre>
+      </div>
+    </div>
+  </section>
+
+  <!-- ====== 25. Future Planning & Roadmap ====== -->
+  <section class="slide" data-title="Future Planning">
+    <p class="kicker">roadmap · planning</p>
+    <h2 class="h2">后续扩展规划</h2>
+    <div class="roadmap-grid">
+      <div class="roadmap-card now anim-fade-up" data-anim="fade-up"><div class="r-period">Phase 1 · 近期</div><h4>🏗️ 架构夯实</h4><ul><li>完善 IoT 设备接入能力</li><li>会员中心 (Member) 激活</li><li>支付系统 (Pay) 集成</li><li>微信公众号 (MP) 接入</li><li>数据报表与大屏 (Report)</li><li>提升单元测试覆盖率</li></ul></div>
+      <div class="roadmap-card next anim-fade-up" data-anim="fade-up" style="animation-delay:.1s"><div class="r-period">Phase 2 · 中期</div><h4>🚀 业务扩展 & 微服务化</h4><ul><li>ERP / CRM 系统搭建</li><li>商城系统 (Mall)</li><li>AI 大模型集成 (AI)</li><li>Spring Cloud 微服务拆分</li><li>Nacos 注册 & 配置中心</li><li>Gateway + Sentinel 流量治理</li></ul></div>
+      <div class="roadmap-card future anim-fade-up" data-anim="fade-up" style="animation-delay:.2s"><div class="r-period">Phase 3 · 远期</div><h4>🌐 平台化 & 智能化</h4><ul><li>多租户 SaaS 化运营</li><li>开放平台 & API 市场</li><li>低代码/无代码搭建</li><li>PF4J 插件生态</li><li>边缘计算 + IoT 规模化</li><li>数据中台 & 智能决策</li></ul></div>
+    </div>
+    <div class="timeline mt-l">
+      <div class="tl-item"><div class="tl-phase">Q2 2025</div><div class="tl-body"><h4>物联网接入打通</h4><p>MQTT 协议适配 · 设备影子 · TDengine 时序存储</p></div></div>
+      <div class="tl-item"><div class="tl-phase">Q3 2025</div><div class="tl-body"><h4>业务模块激活</h4><p>Member + Pay + MP + Report 模块上线，补齐业务闭环</p></div></div>
+      <div class="tl-item"><div class="tl-phase">Q4 2025</div><div class="tl-body"><h4>微服务演进</h4><p>核心域拆分 · Spring Cloud 迁移 · 服务独立部署</p></div></div>
+    </div>
+  </section>
+
+  <!-- ====== 26. Architecture Evolution & Summary ====== -->
+  <section class="slide" data-title="Architecture Evolution">
+    <p class="kicker">evolution · target-architecture</p>
+    <h2 class="h2">架构演进目标：微服务全景</h2>
+    <div class="card card-accent" style="padding:24px;margin-top:14px">
+      <h4 style="color:var(--accent);font-family:'JetBrains Mono',monospace;font-size:13px;margin-bottom:12px">目标微服务架构</h4>
+      <div class="evo-flow">
+        <span class="evo-box accent">Nginx</span><span class="evo-arrow">→</span>
+        <span class="evo-box purple">Gateway</span><span class="evo-arrow">→</span>
+        <span class="evo-box green">Nacos</span><span class="evo-arrow">⇢</span>
+        <div style="display:flex;flex-direction:column;gap:6px">
+          <span class="tag">garden-service</span><span class="tag">workorder-service</span><span class="tag">bpm-service</span><span class="tag">system-service</span><span class="tag">iot-gateway (已有)</span>
+        </div>
+        <span class="evo-arrow">⇢</span>
+        <div style="display:flex;flex-direction:column;gap:6px">
+          <span class="tag">Sentinel</span><span class="tag">Seata</span><span class="tag">SkyWalking</span>
+        </div>
+      </div>
+    </div>
+    <div class="grid g3 mt-l">
+      <div class="card card-accent"><h4>1 · 业务驱动架构</h4><p class="dim">智慧园林 + 工单调度 + 流程协同，三大核心域支撑城市运营。</p></div>
+      <div class="card card-accent"><h4>2 · 分层清晰可扩展</h4><p class="dim">15 个 Starter 组件化，模块间 Feign API + MQ 双通道解耦。</p></div>
+      <div class="card card-accent"><h4>3 · 信创全栈兼容</h4><p class="dim">MySQL / DM8 / KingBase / OpenGauss 多数据库无缝切换。</p></div>
+      <div class="card card-accent"><h4>4 · 可观测性内置</h4><p class="dim">SkyWalking + Admin + 日志中心，三大支柱保障系统可靠。</p></div>
+      <div class="card card-accent"><h4>5 · 渐进式演进</h4><p class="dim">模块化先行 → API 契约驱动 → 渐进式拆分 → 独立部署验证。</p></div>
+      <div class="card card-accent"><h4>6 · IoT 独立先行</h4><p class="dim">IoT 网关已实现独立部署，为后续微服务化积累了宝贵经验。</p></div>
+    </div>
+    <div style="margin-top:24px;text-align:center">
+      <div class="mono" style="font-size:56px;color:var(--accent);font-weight:800;letter-spacing:-.04em">?</div>
+      <h2 class="h2">Questions &amp; Discussion</h2>
+      <p class="lede">感谢聆听 · 欢迎交流</p>
+      <div class="row mt-s" style="justify-content:center"><span class="tag">#urbanops</span><span class="tag">#spring-boot</span><span class="tag">#microservices</span><span class="tag">#smart-garden</span><span class="tag">#cloud-native</span></div>
+    </div>
+  </section>
+
+</div>
+<script src="ppt-assets/runtime.js"></script>
+</body></html>
+/* html-ppt :: animations.css
+ * Apply by adding class="anim-<name>" or data-anim="<name>".
+ * Durations are deliberately snappy; tweak --anim-dur per element.
+ */
+:root{--anim-dur:.7s;--anim-ease:cubic-bezier(.4,0,.2,1)}
+
+/* ---------- FADE DIRECTIONALS ---------- */
+@keyframes kf-fade-up{from{opacity:0;transform:translateY(32px)}to{opacity:1;transform:none}}
+@keyframes kf-fade-down{from{opacity:0;transform:translateY(-32px)}to{opacity:1;transform:none}}
+@keyframes kf-fade-left{from{opacity:0;transform:translateX(-40px)}to{opacity:1;transform:none}}
+@keyframes kf-fade-right{from{opacity:0;transform:translateX(40px)}to{opacity:1;transform:none}}
+.anim-fade-up{animation:kf-fade-up var(--anim-dur) var(--anim-ease) both}
+.anim-fade-down{animation:kf-fade-down var(--anim-dur) var(--anim-ease) both}
+.anim-fade-left{animation:kf-fade-left var(--anim-dur) var(--anim-ease) both}
+.anim-fade-right{animation:kf-fade-right var(--anim-dur) var(--anim-ease) both}
+
+/* ---------- RISE / DROP / ZOOM / BLUR / GLITCH ---------- */
+@keyframes kf-rise{from{opacity:0;transform:translateY(60px) scale(.97);filter:blur(6px)}to{opacity:1;transform:none;filter:none}}
+@keyframes kf-drop{from{opacity:0;transform:translateY(-60px) scale(.97)}to{opacity:1;transform:none}}
+@keyframes kf-zoom{0%{opacity:0;transform:scale(.6)}60%{transform:scale(1.04)}100%{opacity:1;transform:scale(1)}}
+@keyframes kf-blur{from{opacity:0;filter:blur(18px)}to{opacity:1;filter:none}}
+@keyframes kf-glitch{0%{opacity:0;transform:translateX(0);clip-path:inset(0 0 0 0)}
+  20%{opacity:1;transform:translateX(-6px);clip-path:inset(20% 0 30% 0)}
+  40%{transform:translateX(4px);clip-path:inset(50% 0 10% 0)}
+  60%{transform:translateX(-3px);clip-path:inset(10% 0 60% 0)}
+  80%{transform:translateX(2px);clip-path:inset(0 0 0 0)}
+  100%{opacity:1;transform:none}}
+.anim-rise-in{animation:kf-rise .9s var(--anim-ease) both}
+.anim-drop-in{animation:kf-drop .8s var(--anim-ease) both}
+.anim-zoom-pop{animation:kf-zoom .7s cubic-bezier(.22,1.3,.36,1) both}
+.anim-blur-in{animation:kf-blur .8s var(--anim-ease) both}
+.anim-glitch-in{animation:kf-glitch .8s steps(5,end) both}
+
+/* ---------- TYPEWRITER ---------- */
+.anim-typewriter{display:inline-block;overflow:hidden;white-space:nowrap;border-right:2px solid currentColor;
+  width:0;animation:kf-type 2.4s steps(40,end) forwards, kf-caret 1s step-end infinite}
+@keyframes kf-type{to{width:100%}}
+@keyframes kf-caret{50%{border-color:transparent}}
+
+/* ---------- GLOW / SHIMMER / GRADIENT-FLOW ---------- */
+@keyframes kf-neon{0%,100%{text-shadow:0 0 8px var(--accent),0 0 20px var(--accent)}
+  50%{text-shadow:0 0 16px var(--accent),0 0 40px var(--accent),0 0 80px var(--accent)}}
+.anim-neon-glow{animation:kf-neon 2s ease-in-out infinite}
+
+.anim-shimmer-sweep{position:relative;overflow:hidden}
+.anim-shimmer-sweep::after{content:"";position:absolute;inset:0;
+  background:linear-gradient(110deg,transparent 40%,rgba(255,255,255,.55) 50%,transparent 60%);
+  transform:translateX(-100%);animation:kf-shimmer 2.4s var(--anim-ease) infinite}
+@keyframes kf-shimmer{to{transform:translateX(100%)}}
+
+.anim-gradient-flow{background:linear-gradient(90deg,var(--accent),var(--accent-2,var(--accent)),var(--accent-3,var(--accent)),var(--accent));
+  background-size:300% 100%;-webkit-background-clip:text;background-clip:text;color:transparent;-webkit-text-fill-color:transparent;
+  animation:kf-gradflow 4s linear infinite}
+@keyframes kf-gradflow{to{background-position:300% 0}}
+
+/* ---------- STAGGER LIST ---------- */
+.anim-stagger-list > *{opacity:0;animation:kf-rise .65s var(--anim-ease) both}
+.anim-stagger-list > *:nth-child(1){animation-delay:.05s}
+.anim-stagger-list > *:nth-child(2){animation-delay:.15s}
+.anim-stagger-list > *:nth-child(3){animation-delay:.25s}
+.anim-stagger-list > *:nth-child(4){animation-delay:.35s}
+.anim-stagger-list > *:nth-child(5){animation-delay:.45s}
+.anim-stagger-list > *:nth-child(6){animation-delay:.55s}
+.anim-stagger-list > *:nth-child(7){animation-delay:.65s}
+.anim-stagger-list > *:nth-child(8){animation-delay:.75s}
+.anim-stagger-list > *:nth-child(n+9){animation-delay:.85s}
+
+/* ---------- COUNTER-UP (JS-driven, marker class only) ---------- */
+.counter{font-variant-numeric:tabular-nums}
+
+/* ---------- SVG PATH DRAW ---------- */
+.anim-path-draw path,.anim-path-draw line,.anim-path-draw polyline,.anim-path-draw circle,.anim-path-draw rect{
+  stroke-dasharray:1000;stroke-dashoffset:1000;animation:kf-draw 2s var(--anim-ease) forwards}
+@keyframes kf-draw{to{stroke-dashoffset:0}}
+
+/* ---------- PARALLAX TILT (hover) ---------- */
+.anim-parallax-tilt{transform-style:preserve-3d;transition:transform .4s var(--anim-ease)}
+.anim-parallax-tilt:hover{transform:perspective(900px) rotateX(6deg) rotateY(-8deg) translateZ(10px)}
+
+/* ---------- CARD FLIP 3D ---------- */
+@keyframes kf-flip{from{transform:perspective(1200px) rotateY(-90deg);opacity:0}
+  to{transform:perspective(1200px) rotateY(0);opacity:1}}
+.anim-card-flip-3d{animation:kf-flip .9s var(--anim-ease) both;transform-style:preserve-3d;backface-visibility:hidden}
+
+/* ---------- CUBE ROTATE 3D ---------- */
+@keyframes kf-cube{from{transform:perspective(1200px) rotateX(20deg) rotateY(-90deg) translateZ(-200px);opacity:0}
+  to{transform:perspective(1200px) rotateX(0) rotateY(0) translateZ(0);opacity:1}}
+.anim-cube-rotate-3d{animation:kf-cube 1s var(--anim-ease) both}
+
+/* ---------- PAGE TURN 3D ---------- */
+@keyframes kf-pageturn{from{transform:perspective(1600px) rotateY(-85deg);transform-origin:left center;opacity:0}
+  to{transform:perspective(1600px) rotateY(0);opacity:1}}
+.anim-page-turn-3d{animation:kf-pageturn 1s var(--anim-ease) both;transform-origin:left center}
+
+/* ---------- PERSPECTIVE ZOOM ---------- */
+@keyframes kf-pzoom{from{opacity:0;transform:perspective(1400px) translateZ(-400px) rotateX(12deg)}
+  to{opacity:1;transform:none}}
+.anim-perspective-zoom{animation:kf-pzoom 1s var(--anim-ease) both}
+
+/* ---------- MARQUEE SCROLL ---------- */
+.anim-marquee-scroll{display:flex;gap:48px;white-space:nowrap;animation:kf-marquee 20s linear infinite}
+@keyframes kf-marquee{from{transform:translateX(0)}to{transform:translateX(-50%)}}
+
+/* ---------- KEN BURNS ---------- */
+@keyframes kf-kenburns{0%{transform:scale(1) translate(0,0)}100%{transform:scale(1.15) translate(-2%,-1%)}}
+.anim-kenburns{animation:kf-kenburns 14s ease-in-out infinite alternate}
+
+/* ---------- CONFETTI BURST (pseudo — pure CSS sparkles) ---------- */
+.anim-confetti-burst{position:relative}
+.anim-confetti-burst::before,.anim-confetti-burst::after{
+  content:"";position:absolute;top:50%;left:50%;width:8px;height:8px;border-radius:50%;
+  background:var(--accent);box-shadow:
+    20px -30px 0 var(--accent-2,var(--accent)),-25px -20px 0 var(--accent-3,var(--accent)),
+    30px 20px 0 var(--good,#1aaf6c),-30px 25px 0 var(--warn,#f5a524),
+    40px -10px 0 var(--bad,#e0445a),-45px 0 0 var(--accent),
+    10px 40px 0 var(--accent-2,var(--accent)),-15px -40px 0 var(--accent-3,var(--accent));
+  opacity:0;animation:kf-confetti 1.2s var(--anim-ease) forwards}
+.anim-confetti-burst::after{animation-delay:.15s;transform:rotate(45deg)}
+@keyframes kf-confetti{0%{opacity:0;transform:scale(.2)}30%{opacity:1}100%{opacity:0;transform:scale(2.2)}}
+
+/* ---------- SPOTLIGHT ---------- */
+@keyframes kf-spot{0%{clip-path:circle(0% at 50% 50%)}100%{clip-path:circle(140% at 50% 50%)}}
+.anim-spotlight{animation:kf-spot 1.1s var(--anim-ease) both}
+
+/* ---------- MORPH SHAPE (SVG) ---------- */
+.anim-morph-shape path{animation:kf-morph 6s ease-in-out infinite alternate}
+@keyframes kf-morph{0%{d:path("M60,120 Q120,20 180,120 T300,120")}
+  100%{d:path("M60,120 Q120,220 180,120 T300,120")}}
+
+/* ---------- RIPPLE REVEAL ---------- */
+@keyframes kf-ripple{0%{clip-path:circle(0% at 20% 80%);opacity:.4}
+  100%{clip-path:circle(160% at 20% 80%);opacity:1}}
+.anim-ripple-reveal{animation:kf-ripple 1.2s var(--anim-ease) both}
+
+/* reduced motion */
+@media (prefers-reduced-motion: reduce){
+  [class*="anim-"]{animation:none!important;transition:none!important}
+}
+/* html-ppt :: base.css — reset + shared tokens + layout primitives */
+/* Default tokens. Themes in assets/themes/*.css override the :root block. */
+:root {
+  --bg: #ffffff;
+  --bg-soft: #f7f7f8;
+  --surface: #ffffff;
+  --surface-2: #f2f2f4;
+  --border: rgba(0,0,0,.08);
+  --border-strong: rgba(0,0,0,.16);
+  --text-1: #111216;
+  --text-2: #55596a;
+  --text-3: #8a8f9e;
+  --accent: #3b6cff;
+  --accent-2: #7a5cff;
+  --accent-3: #ff5c8a;
+  --good: #1aaf6c;
+  --warn: #f5a524;
+  --bad:  #e0445a;
+  --grad: linear-gradient(135deg,#3b6cff,#7a5cff 55%,#ff5c8a);
+  --grad-soft: linear-gradient(135deg,#eef2ff,#f5ecff 55%,#ffeef5);
+  --radius: 18px;
+  --radius-sm: 12px;
+  --radius-lg: 26px;
+  --shadow: 0 10px 30px rgba(18,24,40,.08), 0 2px 6px rgba(18,24,40,.04);
+  --shadow-lg: 0 24px 60px rgba(18,24,40,.14), 0 6px 16px rgba(18,24,40,.06);
+  --font-sans: 'Inter','Noto Sans SC',-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;
+  --font-serif: 'Playfair Display','Noto Serif SC',Georgia,serif;
+  --font-mono: 'JetBrains Mono','IBM Plex Mono',SFMono-Regular,Menlo,monospace;
+  --font-display: var(--font-sans);
+  --letter-tight: -.03em;
+  --letter-normal: -.01em;
+  --ease: cubic-bezier(.4,0,.2,1);
+}
+
+*,*::before,*::after{box-sizing:border-box}
+html,body{margin:0;padding:0;background:var(--bg);color:var(--text-1);
+  font-family:var(--font-sans);font-weight:400;line-height:1.6;
+  -webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;
+  letter-spacing:var(--letter-normal)}
+img,svg,video{max-width:100%;display:block}
+a{color:var(--accent);text-decoration:none}
+a:hover{text-decoration:underline}
+code,kbd,pre,samp{font-family:var(--font-mono)}
+
+/* ================= SLIDE SYSTEM ================= */
+.deck{position:relative;width:100vw;height:100vh;overflow:hidden;background:var(--bg)}
+.slide{
+  position:absolute;inset:0;
+  display:flex;flex-direction:column;justify-content:center;
+  padding:72px 96px;
+  box-sizing:border-box;
+  opacity:0;pointer-events:none;
+  transition:opacity .5s var(--ease), transform .5s var(--ease);
+  transform:translateX(30px);
+  overflow:hidden;
+}
+.slide.is-active{opacity:1;pointer-events:auto;transform:translateX(0);z-index:2}
+.slide.is-prev{transform:translateX(-30px)}
+
+/* single-page standalone (used when a layout file is opened directly) */
+body.single .slide{position:relative;width:100vw;height:100vh;opacity:1;transform:none;pointer-events:auto}
+
+/* ================= TYPOGRAPHY ================= */
+.eyebrow{font-size:13px;font-weight:500;letter-spacing:.16em;text-transform:uppercase;color:var(--text-3)}
+.kicker{font-size:14px;font-weight:600;color:var(--accent);letter-spacing:.08em;text-transform:uppercase}
+h1.title,.h1{font-family:var(--font-display);font-size:72px;line-height:1.05;font-weight:800;letter-spacing:var(--letter-tight);margin:0 0 18px;color:var(--text-1)}
+h2.title,.h2{font-family:var(--font-display);font-size:54px;line-height:1.1;font-weight:700;letter-spacing:var(--letter-tight);margin:0 0 14px}
+h3,.h3{font-size:32px;line-height:1.2;font-weight:600;letter-spacing:var(--letter-normal);margin:0 0 10px}
+h4,.h4{font-size:22px;line-height:1.3;font-weight:600;margin:0 0 8px}
+.lede{font-size:22px;line-height:1.55;color:var(--text-2);font-weight:300;max-width:62ch}
+.dim{color:var(--text-2)}
+.dim2{color:var(--text-3)}
+.mono{font-family:var(--font-mono)}
+.serif{font-family:var(--font-serif)}
+.gradient-text{background:var(--grad);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent;color:transparent}
+
+/* ================= LAYOUT PRIMITIVES ================= */
+.stack>*+*{margin-top:14px}
+.row{display:flex;gap:24px;align-items:center}
+.row.wrap{flex-wrap:wrap}
+.grid{display:grid;gap:24px}
+.g2{grid-template-columns:repeat(2,1fr)}
+.g3{grid-template-columns:repeat(3,1fr)}
+.g4{grid-template-columns:repeat(4,1fr)}
+.center{display:flex;align-items:center;justify-content:center;text-align:center}
+.fill{flex:1}
+.sp-t{padding-top:24px}.sp-b{padding-bottom:24px}
+.mt-s{margin-top:8px}.mt-m{margin-top:18px}.mt-l{margin-top:32px}
+.mb-s{margin-bottom:8px}.mb-m{margin-bottom:18px}.mb-l{margin-bottom:32px}
+
+/* ================= CARDS ================= */
+.card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);
+  padding:26px 28px;box-shadow:var(--shadow);position:relative;overflow:hidden}
+.card-soft{background:var(--surface-2);border:1px solid var(--border)}
+.card-outline{background:transparent;border:1.5px solid var(--border-strong);box-shadow:none}
+.card-accent{background:var(--surface);border-top:3px solid var(--accent)}
+.card-hover{transition:transform .3s var(--ease),box-shadow .3s var(--ease)}
+.card-hover:hover{transform:translateY(-4px);box-shadow:var(--shadow-lg)}
+
+.pill{display:inline-block;padding:4px 12px;border-radius:999px;font-size:12px;font-weight:500;
+  background:var(--surface-2);color:var(--text-2);border:1px solid var(--border)}
+.pill-accent{background:color-mix(in srgb,var(--accent) 12%,transparent);color:var(--accent);border-color:color-mix(in srgb,var(--accent) 28%,transparent)}
+
+/* ================= BARS / DIVIDERS ================= */
+.divider{height:1px;background:var(--border);width:100%}
+.divider-accent{height:3px;width:72px;background:var(--accent);border-radius:2px}
+
+/* ================= CHROME (header/footer/progress) ================= */
+.deck-header{position:absolute;top:24px;left:40px;right:40px;display:flex;align-items:center;justify-content:space-between;
+  font-size:12px;color:var(--text-3);letter-spacing:.12em;text-transform:uppercase;z-index:10;pointer-events:none}
+.deck-footer{position:absolute;bottom:24px;left:40px;right:40px;display:flex;align-items:center;justify-content:space-between;
+  font-size:12px;color:var(--text-3);z-index:10;pointer-events:none}
+.slide-number::before{content:attr(data-current)}
+.slide-number::after{content:" / " attr(data-total)}
+.progress-bar{position:fixed;left:0;right:0;bottom:0;height:3px;background:transparent;z-index:20}
+.progress-bar > span{display:block;height:100%;width:0;background:var(--accent);transition:width .3s var(--ease)}
+
+/* ================= PRESENTER / OVERVIEW ================= */
+.notes{display:none!important}
+.notes-overlay{position:fixed;inset:auto 0 0 0;max-height:42vh;background:rgba(20,22,30,.95);color:#e8ebf4;
+  padding:20px 32px;font-size:16px;line-height:1.6;border-top:1px solid rgba(255,255,255,.1);transform:translateY(100%);
+  transition:transform .3s var(--ease);z-index:40;overflow:auto;font-family:var(--font-sans)}
+.notes-overlay.open{transform:translateY(0)}
+.overview{position:fixed;inset:0;background:rgba(10,12,18,.92);backdrop-filter:blur(12px);z-index:50;
+  display:none;padding:40px;overflow:auto}
+.overview.open{display:grid;grid-template-columns:repeat(4,1fr);gap:20px;align-content:start}
+.overview .thumb{background:var(--surface);border:1px solid var(--border);border-radius:12px;
+  aspect-ratio:16/9;overflow:hidden;cursor:pointer;position:relative;color:var(--text-1);padding:16px;
+  font-size:11px;transition:transform .2s var(--ease)}
+.overview .thumb:hover{transform:scale(1.04)}
+.overview .thumb .n{position:absolute;top:8px;left:10px;font-weight:700;font-size:14px;color:var(--text-3)}
+.overview .thumb .t{position:absolute;bottom:10px;left:14px;right:14px;font-weight:600;color:var(--text-1)}
+
+/* ================= PRESENTER VIEW ================= */
+/* Presenter view opens in a separate popup window (S key).
+ * All presenter styles are self-contained in the popup HTML generated by runtime.js.
+ * The audience window (this file) is NOT affected — it stays as normal deck view.
+ * Only the .notes class below is needed to hide speaker notes from audience. */
+
+/* ================= UTILITY ================= */
+.hidden{display:none!important}
+.nowrap{white-space:nowrap}
+.tr{text-align:right}.tc{text-align:center}.tl{text-align:left}
+.uppercase{text-transform:uppercase;letter-spacing:.12em}
+
+/* ================= PRINT ================= */
+@media print{
+  .slide{position:relative;opacity:1!important;transform:none!important;page-break-after:always;height:100vh}
+  .deck-header,.deck-footer,.progress-bar,.notes-overlay,.overview{display:none!important}
+}
+/* html-ppt :: shared webfonts */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@200;300;400;500;600;700;800;900&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@200;300;400;500;600;700;900&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Noto+Serif+SC:wght@300;400;600;700&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@0,400;0,600;0,800;1,400&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@300;400;500;700&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Archivo+Black&display=swap');
+/* html-ppt :: runtime.js
+ * Keyboard-driven deck runtime. Zero dependencies.
+ *
+ * Features:
+ *   ← → / space / PgUp PgDn / Home End  navigation
+ *   F  fullscreen
+ *   S  presenter mode (opens a NEW WINDOW with current/next slide preview + notes + timer)
+ *       The original window stays as audience view, synced via BroadcastChannel.
+ *       Slide previews use CSS transform:scale() at design resolution for pixel-perfect layout.
+ *   N  quick notes overlay (bottom drawer)
+ *   O  slide overview grid
+ *   T  cycle themes (reads data-themes on <html> or <body>)
+ *   A  cycle demo animation on current slide
+ *   URL hash #/N  deep-link to slide N (1-based)
+ *   Progress bar auto-managed
+ */
+(function () {
+  'use strict';
+
+  const ANIMS = ['fade-up','fade-down','fade-left','fade-right','rise-in','drop-in',
+    'zoom-pop','blur-in','glitch-in','typewriter','neon-glow','shimmer-sweep',
+    'gradient-flow','stagger-list','counter-up','path-draw','parallax-tilt',
+    'card-flip-3d','cube-rotate-3d','page-turn-3d','perspective-zoom',
+    'marquee-scroll','kenburns','confetti-burst','spotlight','morph-shape','ripple-reveal'];
+
+  function ready(fn){ if(document.readyState!='loading')fn(); else document.addEventListener('DOMContentLoaded',fn);}
+
+  /* ========== Parse URL for preview-only mode ==========
+   * When loaded as iframe.src = "index.html?preview=3", runtime enters a
+   * locked single-slide mode: only slide N is visible, no chrome, no keys,
+   * no hash updates. This is how the presenter window shows pixel-perfect
+   * previews — by loading the actual deck file in an iframe and telling it
+   * to display only a specific slide.
+   */
+  function getPreviewIdx() {
+    const m = /[?&]preview=(\d+)/.exec(location.search || '');
+    return m ? parseInt(m[1], 10) - 1 : -1;
+  }
+
+  ready(function () {
+    const deck = document.querySelector('.deck');
+    if (!deck) return;
+    const slides = Array.from(deck.querySelectorAll('.slide'));
+    if (!slides.length) return;
+
+    const previewOnlyIdx = getPreviewIdx();
+    const isPreviewMode = previewOnlyIdx >= 0 && previewOnlyIdx < slides.length;
+
+    /* ===== Preview-only mode: show one slide, hide everything else ===== */
+    if (isPreviewMode) {
+      function showSlide(i) {
+        slides.forEach((s, j) => {
+          const active = (j === i);
+          s.classList.toggle('is-active', active);
+          s.style.display = active ? '' : 'none';
+          if (active) {
+            s.style.opacity = '1';
+            s.style.transform = 'none';
+            s.style.pointerEvents = 'auto';
+          }
+        });
+      }
+      showSlide(previewOnlyIdx);
+      /* Hide chrome that the presenter shouldn't see in preview */
+      const hideSel = '.progress-bar, .notes-overlay, .overview, .notes, aside.notes, .speaker-notes';
+      document.querySelectorAll(hideSel).forEach(el => { el.style.display = 'none'; });
+      document.documentElement.setAttribute('data-preview', '1');
+      document.body.setAttribute('data-preview', '1');
+      /* Auto-detect theme base path for theme switching in preview mode */
+      function getPreviewThemeBase() {
+        const base = document.documentElement.getAttribute('data-theme-base');
+        if (base) return base;
+        const tl = document.getElementById('theme-link');
+        if (tl) {
+          const raw = tl.getAttribute('href') || '';
+          const ls = raw.lastIndexOf('/');
+          if (ls >= 0) return raw.substring(0, ls + 1);
+        }
+        return 'assets/themes/';
+      }
+      const previewThemeBase = getPreviewThemeBase();
+
+      /* Listen for postMessage from parent presenter window:
+       *  - preview-goto: switch visible slide WITHOUT reloading
+       *  - preview-theme: switch theme CSS link to match audience window */
+      window.addEventListener('message', function(e) {
+        if (!e.data) return;
+        if (e.data.type === 'preview-goto') {
+          const n = parseInt(e.data.idx, 10);
+          if (n >= 0 && n < slides.length) showSlide(n);
+        } else if (e.data.type === 'preview-theme' && e.data.name) {
+          let link = document.getElementById('theme-link');
+          if (!link) {
+            link = document.createElement('link');
+            link.rel = 'stylesheet';
+            link.id = 'theme-link';
+            document.head.appendChild(link);
+          }
+          link.href = previewThemeBase + e.data.name + '.css';
+          document.documentElement.setAttribute('data-theme', e.data.name);
+        }
+      });
+      /* Signal to parent that preview iframe is ready */
+      try { window.parent && window.parent.postMessage({ type: 'preview-ready' }, '*'); } catch(e) {}
+      return;
+    }
+
+    let idx = 0;
+    const total = slides.length;
+
+    /* ===== BroadcastChannel for presenter sync ===== */
+    const CHANNEL_NAME = 'html-ppt-presenter-' + location.pathname;
+    let bc;
+    try { bc = new BroadcastChannel(CHANNEL_NAME); } catch(e) { bc = null; }
+
+    // Are we running inside the presenter popup? (legacy flag, now unused)
+    const isPresenterWindow = false;
+
+    /* ===== progress bar ===== */
+    let bar = document.querySelector('.progress-bar');
+    if (!bar) {
+      bar = document.createElement('div');
+      bar.className = 'progress-bar';
+      bar.innerHTML = '<span></span>';
+      document.body.appendChild(bar);
+    }
+    const barFill = bar.querySelector('span');
+
+    /* ===== notes overlay (N key) ===== */
+    let notes = document.querySelector('.notes-overlay');
+    if (!notes) {
+      notes = document.createElement('div');
+      notes.className = 'notes-overlay';
+      document.body.appendChild(notes);
+    }
+
+    /* ===== overview grid (O key) ===== */
+    let overview = document.querySelector('.overview');
+    if (!overview) {
+      overview = document.createElement('div');
+      overview.className = 'overview';
+      slides.forEach((s, i) => {
+        const t = document.createElement('div');
+        t.className = 'thumb';
+        // Force 16:9 aspect ratio robustly
+        t.style.padding = '0 0 56.25% 0';
+        t.style.height = '0';
+        t.style.position = 'relative';
+        t.style.overflow = 'hidden';
+
+        const title = s.getAttribute('data-title') ||
+          (s.querySelector('h1,h2,h3')||{}).textContent || ('Slide '+(i+1));
+        
+        // Create a container for the mini-slide
+        const mini = document.createElement('div');
+        mini.className = 'mini-slide';
+        mini.style.position = 'absolute';
+        mini.style.top = '0';
+        mini.style.left = '0';
+        mini.style.width = '1920px';
+        mini.style.height = '1080px';
+        mini.style.transformOrigin = 'top left';
+        mini.style.pointerEvents = 'none';
+        mini.style.background = 'var(--bg)';
+        
+        // Clone the slide content
+        const clone = s.cloneNode(true);
+        clone.className = 'slide is-active'; // force active styles
+        clone.style.position = 'absolute';
+        clone.style.inset = '0';
+        clone.style.transform = 'none';
+        clone.style.opacity = '1';
+        clone.style.padding = '72px 96px'; // ensure padding is kept
+        
+        mini.appendChild(clone);
+        t.appendChild(mini);
+
+        // Add the number and title overlay
+        const overlay = document.createElement('div');
+        overlay.style.position = 'absolute';
+        overlay.style.inset = '0';
+        overlay.style.background = 'linear-gradient(to bottom, rgba(0,0,0,0.2) 0%, transparent 40%, transparent 60%, rgba(0,0,0,0.8) 100%)';
+        overlay.style.color = '#fff';
+        overlay.style.zIndex = '10';
+        overlay.style.pointerEvents = 'none';
+        
+        const n = document.createElement('div');
+        n.className = 'n';
+        n.textContent = i + 1;
+        n.style.position = 'absolute';
+        n.style.top = '12px';
+        n.style.left = '16px';
+        n.style.fontWeight = '700';
+        n.style.fontSize = '16px';
+        n.style.color = '#fff';
+        n.style.textShadow = '0 1px 4px rgba(0,0,0,0.8)';
+        
+        const text = document.createElement('div');
+        text.className = 't';
+        text.textContent = title.trim().slice(0,80);
+        text.style.position = 'absolute';
+        text.style.bottom = '12px';
+        text.style.left = '16px';
+        text.style.right = '16px';
+        text.style.fontWeight = '600';
+        text.style.fontSize = '14px';
+        text.style.color = '#fff';
+        text.style.textShadow = '0 1px 4px rgba(0,0,0,0.8)';
+        
+        overlay.appendChild(n);
+        overlay.appendChild(text);
+        t.appendChild(overlay);
+
+        t.addEventListener('click', () => { go(i); toggleOverview(false); });
+        overview.appendChild(t);
+      });
+      document.body.appendChild(overview);
+    }
+
+    /* ===== navigation ===== */
+    function go(n, fromRemote){
+      n = Math.max(0, Math.min(total-1, n));
+      slides.forEach((s,i) => {
+        s.classList.toggle('is-active', i===n);
+        s.classList.toggle('is-prev', i<n);
+      });
+      idx = n;
+      barFill.style.width = ((n+1)/total*100)+'%';
+      const numEl = document.querySelector('.slide-number');
+      if (numEl) { numEl.setAttribute('data-current', n+1); numEl.setAttribute('data-total', total); }
+
+      // notes (bottom overlay)
+      const note = slides[n].querySelector('.notes, aside.notes, .speaker-notes');
+      notes.innerHTML = note ? note.innerHTML : '';
+
+      // hash
+      const hashTarget = '#/'+(n+1);
+      if (location.hash !== hashTarget && !isPresenterWindow) {
+        history.replaceState(null,'', hashTarget);
+      }
+
+      // re-trigger entry animations
+      slides[n].querySelectorAll('[data-anim]').forEach(el => {
+        const a = el.getAttribute('data-anim');
+        el.classList.remove('anim-'+a);
+        void el.offsetWidth;
+        el.classList.add('anim-'+a);
+      });
+
+      // counter-up
+      slides[n].querySelectorAll('.counter').forEach(el => {
+        const target = parseFloat(el.getAttribute('data-to')||el.textContent);
+        const dur = parseInt(el.getAttribute('data-dur')||'1200',10);
+        const start = performance.now();
+        const from = 0;
+        function tick(now){
+          const t = Math.min(1,(now-start)/dur);
+          const v = from + (target-from)*(1-Math.pow(1-t,3));
+          el.textContent = (target % 1 === 0) ? Math.round(v) : v.toFixed(1);
+          if (t<1) requestAnimationFrame(tick);
+        }
+        requestAnimationFrame(tick);
+      });
+
+      // Broadcast to other window (audience ↔ presenter)
+      if (!fromRemote && bc) {
+        bc.postMessage({ type: 'go', idx: n });
+      }
+    }
+
+    /* ===== listen for remote navigation / theme changes ===== */
+    if (bc) {
+      bc.onmessage = function(e) {
+        if (!e.data) return;
+        if (e.data.type === 'go' && typeof e.data.idx === 'number') {
+          go(e.data.idx, true);
+        } else if (e.data.type === 'theme' && e.data.name) {
+          /* Sync theme across windows */
+          const i = themes.indexOf(e.data.name);
+          if (i >= 0) themeIdx = i;
+          applyTheme(e.data.name);
+        }
+      };
+    }
+
+    function toggleNotes(force){ notes.classList.toggle('open', force!==undefined?force:!notes.classList.contains('open')); }
+    function toggleOverview(force){
+      const isOpen = force!==undefined ? force : !overview.classList.contains('open');
+      overview.classList.toggle('open', isOpen);
+      if (isOpen) {
+        requestAnimationFrame(() => {
+          const thumbs = overview.querySelectorAll('.thumb');
+          if (thumbs.length) {
+            const scale = thumbs[0].clientWidth / 1920;
+            overview.querySelectorAll('.mini-slide').forEach(m => {
+              m.style.transform = 'scale(' + scale + ')';
+            });
+          }
+        });
+      }
+    }
+
+    /* ========== PRESENTER MODE — Magnetic-card popup window ========== */
+    /* Opens a new window with 4 draggable, resizable cards:
+     *   CURRENT  — iframe(?preview=N)   pixel-perfect preview of current slide
+     *   NEXT     — iframe(?preview=N+1) pixel-perfect preview of next slide
+     *   SCRIPT   — large speaker notes (逐字稿)
+     *   TIMER    — elapsed timer + page counter + controls
+     * Cards remember position/size in localStorage.
+     * Two windows sync via BroadcastChannel.
+     */
+    let presenterWin = null;
+
+    function openPresenterWindow() {
+      if (presenterWin && !presenterWin.closed) {
+        presenterWin.focus();
+        return;
+      }
+
+      // Build absolute URL of THIS deck file (without hash/query)
+      const deckUrl = location.protocol + '//' + location.host + location.pathname;
+
+      // Collect slide titles + notes (HTML strings)
+      const slideMeta = slides.map((s, i) => {
+        const note = s.querySelector('.notes, aside.notes, .speaker-notes');
+        return {
+          title: s.getAttribute('data-title') ||
+            (s.querySelector('h1,h2,h3')||{}).textContent || ('Slide '+(i+1)),
+          notes: note ? note.innerHTML : ''
+        };
+      });
+
+      /* Capture current theme so presenter previews match the audience */
+      const currentTheme = root.getAttribute('data-theme') || (themes[themeIdx] || '');
+      const presenterHTML = buildPresenterHTML(deckUrl, slideMeta, total, idx, CHANNEL_NAME, currentTheme);
+
+      presenterWin = window.open('', 'html-ppt-presenter', 'width=1280,height=820,menubar=no,toolbar=no');
+      if (!presenterWin) {
+        alert('请允许弹出窗口以使用演讲者视图');
+        return;
+      }
+      presenterWin.document.open();
+      presenterWin.document.write(presenterHTML);
+      presenterWin.document.close();
+    }
+
+    function buildPresenterHTML(deckUrl, slideMeta, total, startIdx, channelName, currentTheme) {
+      const metaJSON = JSON.stringify(slideMeta);
+      const deckUrlJSON = JSON.stringify(deckUrl);
+      const channelJSON = JSON.stringify(channelName);
+      const themeJSON = JSON.stringify(currentTheme || '');
+      const storageKey = 'html-ppt-presenter:' + location.pathname;
+
+      // Build the document as a single template string for clarity
+      return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<title>Presenter View</title>
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  html, body {
+    width: 100%; height: 100%; overflow: hidden;
+    background: #1a1d24;
+    background-image:
+      radial-gradient(circle at 20% 30%, rgba(88,166,255,.04), transparent 50%),
+      radial-gradient(circle at 80% 70%, rgba(188,140,255,.04), transparent 50%);
+    color: #e6edf3;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans SC", sans-serif;
+  }
+  /* Stage: positioned area where cards live */
+  #stage { position: absolute; inset: 0; overflow: hidden; }
+
+  /* Magnetic card */
+  .pcard {
+    position: absolute;
+    background: #0d1117;
+    border: 1px solid rgba(255,255,255,.1);
+    border-radius: 12px;
+    box-shadow: 0 8px 32px rgba(0,0,0,.45), 0 0 0 1px rgba(255,255,255,.02);
+    display: flex; flex-direction: column;
+    overflow: hidden;
+    min-width: 180px; min-height: 100px;
+    transition: box-shadow .2s, border-color .2s;
+  }
+  .pcard.dragging { box-shadow: 0 16px 48px rgba(0,0,0,.6), 0 0 0 2px rgba(88,166,255,.5); border-color: #58a6ff; transition: none; z-index: 9999; }
+  .pcard.resizing { box-shadow: 0 16px 48px rgba(0,0,0,.6), 0 0 0 2px rgba(63,185,80,.5); border-color: #3fb950; transition: none; z-index: 9999; }
+  .pcard:hover { border-color: rgba(88,166,255,.3); }
+
+  /* Card header (drag handle) */
+  .pcard-head {
+    display: flex; align-items: center; gap: 10px;
+    padding: 8px 12px;
+    background: rgba(255,255,255,.04);
+    border-bottom: 1px solid rgba(255,255,255,.06);
+    cursor: move;
+    user-select: none;
+    flex-shrink: 0;
+  }
+  .pcard-dot { width: 8px; height: 8px; border-radius: 50%; background: var(--dot-color, #58a6ff); flex-shrink: 0; }
+  .pcard-title {
+    font-size: 11px; letter-spacing: .15em; text-transform: uppercase;
+    font-weight: 700; color: #8b949e; flex: 1;
+  }
+  .pcard-meta { font-size: 11px; color: #6e7681; }
+
+  /* Card body */
+  .pcard-body { flex: 1; position: relative; overflow: hidden; min-height: 0; }
+
+  /* Preview cards (CURRENT/NEXT) — iframe-based pixel-perfect render */
+  .pcard-preview .pcard-body { background: #000; }
+  .pcard-preview iframe {
+    position: absolute; top: 0; left: 0;
+    width: 1920px; height: 1080px;
+    border: none;
+    transform-origin: top left;
+    pointer-events: none;
+    background: transparent;
+  }
+  .pcard-preview .preview-end {
+    position: absolute; inset: 0;
+    display: flex; align-items: center; justify-content: center;
+    color: #484f58; font-size: 14px; letter-spacing: .12em;
+  }
+
+  /* Notes card */
+  .pcard-notes .pcard-body {
+    padding: 14px 18px;
+    overflow-y: auto;
+    font-size: 18px; line-height: 1.75;
+    color: #d0d7de;
+    font-family: "Noto Sans SC", -apple-system, sans-serif;
+  }
+  .pcard-notes .pcard-body p { margin: 0 0 .7em 0; }
+  .pcard-notes .pcard-body strong { color: #f0883e; }
+  .pcard-notes .pcard-body em { color: #58a6ff; font-style: normal; }
+  .pcard-notes .pcard-body code {
+    font-family: "SF Mono", monospace; font-size: .9em;
+    background: rgba(255,255,255,.08); padding: 1px 6px; border-radius: 4px;
+  }
+  .pcard-notes .empty { color: #484f58; font-style: italic; }
+
+  /* Timer card */
+  .pcard-timer .pcard-body {
+    display: flex; flex-direction: column; gap: 14px;
+    padding: 18px 20px; justify-content: center;
+  }
+  .timer-display {
+    font-family: "SF Mono", "JetBrains Mono", monospace;
+    font-size: 42px; font-weight: 700;
+    color: #3fb950;
+    letter-spacing: .04em;
+    line-height: 1;
+  }
+  .timer-row {
+    display: flex; align-items: center; gap: 12px;
+    font-size: 14px; color: #8b949e;
+  }
+  .timer-row .label { font-size: 10px; letter-spacing: .15em; text-transform: uppercase; color: #6e7681; }
+  .timer-row .val { color: #e6edf3; font-weight: 600; font-family: "SF Mono", monospace; }
+  .timer-controls { display: flex; gap: 8px; flex-wrap: wrap; }
+  .timer-btn {
+    background: rgba(255,255,255,.06);
+    border: 1px solid rgba(255,255,255,.1);
+    color: #e6edf3;
+    padding: 6px 12px;
+    border-radius: 6px;
+    font-size: 12px;
+    cursor: pointer;
+    font-family: inherit;
+  }
+  .timer-btn:hover { background: rgba(88,166,255,.15); border-color: #58a6ff; }
+  .timer-btn:active { transform: translateY(1px); }
+
+  /* Resize handle */
+  .pcard-resize {
+    position: absolute; right: 0; bottom: 0;
+    width: 18px; height: 18px;
+    cursor: nwse-resize;
+    background: linear-gradient(135deg, transparent 50%, rgba(255,255,255,.25) 50%, rgba(255,255,255,.25) 60%, transparent 60%, transparent 70%, rgba(255,255,255,.25) 70%, rgba(255,255,255,.25) 80%, transparent 80%);
+    z-index: 5;
+  }
+  .pcard-resize:hover { background: linear-gradient(135deg, transparent 50%, #58a6ff 50%, #58a6ff 60%, transparent 60%, transparent 70%, #58a6ff 70%, #58a6ff 80%, transparent 80%); }
+
+  /* Bottom hint bar */
+  .hint-bar {
+    position: fixed; bottom: 0; left: 0; right: 0;
+    background: rgba(0,0,0,.6);
+    backdrop-filter: blur(10px);
+    border-top: 1px solid rgba(255,255,255,.08);
+    padding: 6px 16px;
+    font-size: 11px; color: #8b949e;
+    display: flex; gap: 18px; align-items: center;
+    z-index: 1000;
+  }
+  .hint-bar kbd {
+    background: rgba(255,255,255,.08);
+    padding: 1px 6px; border-radius: 3px;
+    font-family: "SF Mono", monospace;
+    font-size: 10px;
+    border: 1px solid rgba(255,255,255,.1);
+    color: #e6edf3;
+  }
+  .hint-bar .reset-layout {
+    margin-left: auto;
+    background: transparent; border: 1px solid rgba(255,255,255,.15);
+    color: #8b949e; padding: 3px 10px; border-radius: 4px;
+    font-size: 11px; cursor: pointer; font-family: inherit;
+  }
+  .hint-bar .reset-layout:hover { background: rgba(248,81,73,.15); border-color: #f85149; color: #f85149; }
+
+  body.is-dragging-card * { user-select: none !important; }
+  body.is-dragging-card iframe { pointer-events: none !important; }
+</style>
+</head>
+<body>
+
+<div id="stage">
+  <div class="pcard pcard-preview" id="card-cur" style="--dot-color:#58a6ff">
+    <div class="pcard-head" data-drag>
+      <span class="pcard-dot"></span>
+      <span class="pcard-title">CURRENT</span>
+      <span class="pcard-meta" id="cur-meta">—</span>
+    </div>
+    <div class="pcard-body"><iframe id="iframe-cur"></iframe></div>
+    <div class="pcard-resize" data-resize></div>
+  </div>
+
+  <div class="pcard pcard-preview" id="card-nxt" style="--dot-color:#bc8cff">
+    <div class="pcard-head" data-drag>
+      <span class="pcard-dot"></span>
+      <span class="pcard-title">NEXT</span>
+      <span class="pcard-meta" id="nxt-meta">—</span>
+    </div>
+    <div class="pcard-body"><iframe id="iframe-nxt"></iframe></div>
+    <div class="pcard-resize" data-resize></div>
+  </div>
+
+  <div class="pcard pcard-notes" id="card-notes" style="--dot-color:#f0883e">
+    <div class="pcard-head" data-drag>
+      <span class="pcard-dot"></span>
+      <span class="pcard-title">SPEAKER SCRIPT · 逐字稿</span>
+    </div>
+    <div class="pcard-body" id="notes-body"></div>
+    <div class="pcard-resize" data-resize></div>
+  </div>
+
+  <div class="pcard pcard-timer" id="card-timer" style="--dot-color:#3fb950">
+    <div class="pcard-head" data-drag>
+      <span class="pcard-dot"></span>
+      <span class="pcard-title">TIMER</span>
+    </div>
+    <div class="pcard-body">
+      <div class="timer-display" id="timer-display">00:00</div>
+      <div class="timer-row">
+        <span class="label">Slide</span>
+        <span class="val" id="timer-count">1 / ${total}</span>
+      </div>
+      <div class="timer-controls">
+        <button class="timer-btn" id="btn-prev">← Prev</button>
+        <button class="timer-btn" id="btn-next">Next →</button>
+        <button class="timer-btn" id="btn-reset">⏱ Reset</button>
+      </div>
+    </div>
+    <div class="pcard-resize" data-resize></div>
+  </div>
+</div>
+
+<div class="hint-bar">
+  <span><kbd>← →</kbd> 翻页</span>
+  <span><kbd>R</kbd> 重置计时</span>
+  <span><kbd>Esc</kbd> 关闭</span>
+  <span style="color:#6e7681">拖动卡片头部移动 · 拖动右下角调整大小</span>
+  <button class="reset-layout" id="reset-layout">重置布局</button>
+</div>
+
+<script>
+(function(){
+  var slideMeta = ${metaJSON};
+  var total = ${total};
+  var idx = ${startIdx};
+  var deckUrl = ${deckUrlJSON};
+  var STORAGE_KEY = ${JSON.stringify(storageKey)};
+  var bc;
+  try { bc = new BroadcastChannel(${channelJSON}); } catch(e) {}
+
+  var iframeCur = document.getElementById('iframe-cur');
+  var iframeNxt = document.getElementById('iframe-nxt');
+  var notesBody = document.getElementById('notes-body');
+  var curMeta = document.getElementById('cur-meta');
+  var nxtMeta = document.getElementById('nxt-meta');
+  var timerDisplay = document.getElementById('timer-display');
+  var timerCount = document.getElementById('timer-count');
+
+  /* ===== Default card layout ===== */
+  function defaultLayout() {
+    var w = window.innerWidth;
+    var h = window.innerHeight - 36; /* leave room for hint bar */
+    return {
+      'card-cur':   { x: 16,        y: 16,            w: Math.round(w*0.55) - 24, h: Math.round(h*0.62) - 16 },
+      'card-nxt':   { x: Math.round(w*0.55) + 8, y: 16, w: w - Math.round(w*0.55) - 24, h: Math.round(h*0.42) - 16 },
+      'card-notes': { x: Math.round(w*0.55) + 8, y: Math.round(h*0.42) + 8, w: w - Math.round(w*0.55) - 24, h: h - Math.round(h*0.42) - 16 },
+      'card-timer': { x: 16,        y: Math.round(h*0.62) + 8, w: Math.round(w*0.55) - 24, h: h - Math.round(h*0.62) - 16 }
+    };
+  }
+
+  /* ===== Apply / save / restore layout ===== */
+  function applyLayout(layout) {
+    Object.keys(layout).forEach(function(id){
+      var el = document.getElementById(id);
+      var l = layout[id];
+      if (el && l) {
+        el.style.left = l.x + 'px';
+        el.style.top = l.y + 'px';
+        el.style.width = l.w + 'px';
+        el.style.height = l.h + 'px';
+      }
+    });
+    rescaleAll();
+  }
+  function readLayout() {
+    try {
+      var saved = localStorage.getItem(STORAGE_KEY);
+      if (saved) return JSON.parse(saved);
+    } catch(e) {}
+    return defaultLayout();
+  }
+  function saveLayout() {
+    var layout = {};
+    ['card-cur','card-nxt','card-notes','card-timer'].forEach(function(id){
+      var el = document.getElementById(id);
+      if (el) {
+        layout[id] = {
+          x: parseInt(el.style.left,10) || 0,
+          y: parseInt(el.style.top,10) || 0,
+          w: parseInt(el.style.width,10) || 300,
+          h: parseInt(el.style.height,10) || 200
+        };
+      }
+    });
+    try { localStorage.setItem(STORAGE_KEY, JSON.stringify(layout)); } catch(e) {}
+  }
+
+  /* ===== iframe rescale to fit card body ===== */
+  function rescaleIframe(iframe) {
+    if (!iframe || iframe.style.display === 'none') return;
+    var body = iframe.parentElement;
+    var cw = body.clientWidth, ch = body.clientHeight;
+    if (!cw || !ch) return;
+    var s = Math.min(cw / 1920, ch / 1080);
+    iframe.style.transform = 'scale(' + s + ')';
+    /* Center the scaled iframe in the body */
+    var sw = 1920 * s, sh = 1080 * s;
+    iframe.style.left = Math.max(0, (cw - sw) / 2) + 'px';
+    iframe.style.top = Math.max(0, (ch - sh) / 2) + 'px';
+  }
+  function rescaleAll() {
+    rescaleIframe(iframeCur);
+    rescaleIframe(iframeNxt);
+  }
+  window.addEventListener('resize', rescaleAll);
+
+  /* ===== Drag (move card by header) ===== */
+  document.querySelectorAll('[data-drag]').forEach(function(handle){
+    handle.addEventListener('mousedown', function(e){
+      if (e.button !== 0) return;
+      var card = handle.closest('.pcard');
+      if (!card) return;
+      e.preventDefault();
+      card.classList.add('dragging');
+      document.body.classList.add('is-dragging-card');
+      var startX = e.clientX, startY = e.clientY;
+      var startL = parseInt(card.style.left,10) || 0;
+      var startT = parseInt(card.style.top,10)  || 0;
+      function onMove(ev){
+        var nx = Math.max(0, Math.min(window.innerWidth - 100, startL + ev.clientX - startX));
+        var ny = Math.max(0, Math.min(window.innerHeight - 50, startT + ev.clientY - startY));
+        card.style.left = nx + 'px';
+        card.style.top = ny + 'px';
+      }
+      function onUp(){
+        card.classList.remove('dragging');
+        document.body.classList.remove('is-dragging-card');
+        document.removeEventListener('mousemove', onMove);
+        document.removeEventListener('mouseup', onUp);
+        saveLayout();
+      }
+      document.addEventListener('mousemove', onMove);
+      document.addEventListener('mouseup', onUp);
+    });
+  });
+
+  /* ===== Resize (drag bottom-right corner) ===== */
+  document.querySelectorAll('[data-resize]').forEach(function(handle){
+    handle.addEventListener('mousedown', function(e){
+      if (e.button !== 0) return;
+      var card = handle.closest('.pcard');
+      if (!card) return;
+      e.preventDefault(); e.stopPropagation();
+      card.classList.add('resizing');
+      document.body.classList.add('is-dragging-card');
+      var startX = e.clientX, startY = e.clientY;
+      var startW = parseInt(card.style.width,10)  || card.offsetWidth;
+      var startH = parseInt(card.style.height,10) || card.offsetHeight;
+      function onMove(ev){
+        var nw = Math.max(180, startW + ev.clientX - startX);
+        var nh = Math.max(100, startH + ev.clientY - startY);
+        card.style.width = nw + 'px';
+        card.style.height = nh + 'px';
+        if (card.querySelector('iframe')) rescaleIframe(card.querySelector('iframe'));
+      }
+      function onUp(){
+        card.classList.remove('resizing');
+        document.body.classList.remove('is-dragging-card');
+        document.removeEventListener('mousemove', onMove);
+        document.removeEventListener('mouseup', onUp);
+        rescaleAll();
+        saveLayout();
+      }
+      document.addEventListener('mousemove', onMove);
+      document.addEventListener('mouseup', onUp);
+    });
+  });
+
+  /* ===== Preview iframe ready tracking =====
+   * Each iframe loads the deck ONCE with ?preview=1 on init. Subsequent
+   * slide changes are sent via postMessage('preview-goto') so the iframe
+   * just toggles visibility of a different .slide — no reload, no flicker.
+   */
+  var iframeReady = { cur: false, nxt: false };
+  var currentTheme = ${themeJSON};
+  window.addEventListener('message', function(e) {
+    if (!e.data || e.data.type !== 'preview-ready') return;
+    var iframe = null;
+    if (e.source === iframeCur.contentWindow) {
+      iframeReady.cur = true;
+      iframe = iframeCur;
+      postPreviewGoto(iframeCur, idx);
+    } else if (e.source === iframeNxt.contentWindow) {
+      iframeReady.nxt = true;
+      iframe = iframeNxt;
+      postPreviewGoto(iframeNxt, idx + 1 < total ? idx + 1 : idx);
+    }
+    /* Sync current theme to the iframe */
+    if (iframe && currentTheme) {
+      try { iframe.contentWindow.postMessage({ type: 'preview-theme', name: currentTheme }, '*'); } catch(err) {}
+    }
+    if (iframe) rescaleIframe(iframe);
+  });
+
+  function postPreviewGoto(iframe, n) {
+    try {
+      iframe.contentWindow.postMessage({ type: 'preview-goto', idx: n }, '*');
+    } catch(e) {}
+  }
+
+  /* ===== Update content =====
+   * Smooth (no-reload) navigation: send postMessage to iframes instead of
+   * resetting src. Iframes stay loaded, just switch visible .slide.
+   */
+  function update(n) {
+    n = Math.max(0, Math.min(total - 1, n));
+    idx = n;
+
+    /* Current preview — postMessage (smooth) */
+    if (iframeReady.cur) postPreviewGoto(iframeCur, n);
+    curMeta.textContent = (n + 1) + '/' + total;
+
+    /* Next preview */
+    if (n + 1 < total) {
+      iframeNxt.style.display = '';
+      var endEl = document.querySelector('#card-nxt .preview-end');
+      if (endEl) endEl.remove();
+      if (iframeReady.nxt) postPreviewGoto(iframeNxt, n + 1);
+      nxtMeta.textContent = (n + 2) + '/' + total;
+    } else {
+      iframeNxt.style.display = 'none';
+      var body = document.querySelector('#card-nxt .pcard-body');
+      if (body && !body.querySelector('.preview-end')) {
+        var end = document.createElement('div');
+        end.className = 'preview-end';
+        end.textContent = '— END OF DECK —';
+        body.appendChild(end);
+      }
+      nxtMeta.textContent = 'END';
+    }
+
+    /* Notes */
+    var note = slideMeta[n].notes;
+    notesBody.innerHTML = note || '<span class="empty">（这一页还没有逐字稿）</span>';
+
+    /* Timer count */
+    timerCount.textContent = (n + 1) + ' / ' + total;
+  }
+
+  /* ===== Timer ===== */
+  var tStart = Date.now();
+  setInterval(function(){
+    var s = Math.floor((Date.now() - tStart) / 1000);
+    var mm = String(Math.floor(s/60)).padStart(2,'0');
+    var ss = String(s%60).padStart(2,'0');
+    timerDisplay.textContent = mm + ':' + ss;
+  }, 1000);
+  function resetTimer(){ tStart = Date.now(); timerDisplay.textContent = '00:00'; }
+
+  /* ===== BroadcastChannel sync ===== */
+  if (bc) {
+    bc.onmessage = function(e){
+      if (!e.data) return;
+      if (e.data.type === 'go') update(e.data.idx);
+      else if (e.data.type === 'theme' && e.data.name) {
+        currentTheme = e.data.name;
+        /* Forward theme change to preview iframes */
+        [iframeCur, iframeNxt].forEach(function(iframe){
+          try {
+            iframe.contentWindow.postMessage({ type: 'preview-theme', name: e.data.name }, '*');
+          } catch(err) {}
+        });
+      }
+    };
+  }
+  function go(n) {
+    update(n);
+    if (bc) bc.postMessage({ type: 'go', idx: idx });
+  }
+
+  /* ===== Buttons ===== */
+  document.getElementById('btn-prev').addEventListener('click', function(){ go(idx - 1); });
+  document.getElementById('btn-next').addEventListener('click', function(){ go(idx + 1); });
+  document.getElementById('btn-reset').addEventListener('click', resetTimer);
+  document.getElementById('reset-layout').addEventListener('click', function(){
+    if (confirm('恢复默认卡片布局？')) {
+      try { localStorage.removeItem(STORAGE_KEY); } catch(e){}
+      applyLayout(defaultLayout());
+    }
+  });
+
+  /* ===== Keyboard ===== */
+  document.addEventListener('keydown', function(e){
+    if (e.metaKey || e.ctrlKey || e.altKey) return;
+    switch(e.key) {
+      case 'ArrowRight': case ' ': case 'PageDown': go(idx + 1); e.preventDefault(); break;
+      case 'ArrowLeft':  case 'PageUp':   go(idx - 1); e.preventDefault(); break;
+      case 'Home': go(0); break;
+      case 'End':  go(total - 1); break;
+      case 'r': case 'R': resetTimer(); break;
+      case 'Escape': window.close(); break;
+    }
+  });
+
+  /* ===== Iframe load → rescale (catches initial size) ===== */
+  iframeCur.addEventListener('load', function(){ rescaleIframe(iframeCur); });
+  iframeNxt.addEventListener('load', function(){ rescaleIframe(iframeNxt); });
+
+  /* ===== Init =====
+   * Load each iframe ONCE with the deck file. After they post
+   * 'preview-ready', all subsequent navigation is via postMessage
+   * (smooth, no reload, no flicker).
+   */
+  applyLayout(readLayout());
+  iframeCur.src = deckUrl + '?preview=' + (idx + 1);
+  if (idx + 1 < total) iframeNxt.src = deckUrl + '?preview=' + (idx + 2);
+  /* Initialize notes/timer/count without touching iframes */
+  notesBody.innerHTML = slideMeta[idx].notes || '<span class="empty">（这一页还没有逐字稿）</span>';
+  curMeta.textContent = (idx + 1) + '/' + total;
+  nxtMeta.textContent = (idx + 2) + '/' + total;
+  timerCount.textContent = (idx + 1) + ' / ' + total;
+})();
+</` + `script>
+</body></html>`;
+    }
+
+    function fullscreen(){ const el=document.documentElement;
+      if (!document.fullscreenElement) el.requestFullscreen&&el.requestFullscreen();
+      else document.exitFullscreen&&document.exitFullscreen();
+    }
+
+    // theme cycling
+    const root = document.documentElement;
+    const themesAttr = root.getAttribute('data-themes') || document.body.getAttribute('data-themes');
+    const themes = themesAttr ? themesAttr.split(',').map(s=>s.trim()).filter(Boolean) : [];
+    let themeIdx = 0;
+
+    // Auto-detect theme base path from existing <link id="theme-link">
+    let themeBase = root.getAttribute('data-theme-base');
+    if (!themeBase) {
+      const existingLink = document.getElementById('theme-link');
+      if (existingLink) {
+        // el.getAttribute('href') gives the raw relative path written in HTML
+        const rawHref = existingLink.getAttribute('href') || '';
+        const lastSlash = rawHref.lastIndexOf('/');
+        themeBase = lastSlash >= 0 ? rawHref.substring(0, lastSlash + 1) : 'assets/themes/';
+      } else {
+        themeBase = 'assets/themes/';
+      }
+    }
+
+    function applyTheme(name) {
+      let link = document.getElementById('theme-link');
+      if (!link) {
+        link = document.createElement('link');
+        link.rel = 'stylesheet';
+        link.id = 'theme-link';
+        document.head.appendChild(link);
+      }
+      link.href = themeBase + name + '.css';
+      root.setAttribute('data-theme', name);
+      const ind = document.querySelector('.theme-indicator');
+      if (ind) ind.textContent = name;
+    }
+    function cycleTheme(fromRemote){
+      if (!themes.length) return;
+      themeIdx = (themeIdx+1) % themes.length;
+      const name = themes[themeIdx];
+      applyTheme(name);
+      /* Broadcast to other window (audience ↔ presenter) */
+      if (!fromRemote && bc) bc.postMessage({ type: 'theme', name: name });
+    }
+
+    // animation cycling on current slide
+    let animIdx = 0;
+    function cycleAnim(){
+      animIdx = (animIdx+1) % ANIMS.length;
+      const a = ANIMS[animIdx];
+      const target = slides[idx].querySelector('[data-anim-target]') || slides[idx];
+      ANIMS.forEach(x => target.classList.remove('anim-'+x));
+      void target.offsetWidth;
+      target.classList.add('anim-'+a);
+      target.setAttribute('data-anim', a);
+      const ind = document.querySelector('.anim-indicator');
+      if (ind) ind.textContent = a;
+    }
+
+    document.addEventListener('keydown', function (e) {
+      if (e.metaKey||e.ctrlKey||e.altKey) return;
+      switch (e.key) {
+        case 'ArrowRight': case ' ': case 'PageDown': case 'Enter': go(idx+1); e.preventDefault(); break;
+        case 'ArrowLeft': case 'PageUp': case 'Backspace': go(idx-1); e.preventDefault(); break;
+        case 'Home': go(0); break;
+        case 'End': go(total-1); break;
+        case 'f': case 'F': fullscreen(); break;
+        case 's': case 'S': openPresenterWindow(); break;
+        case 'n': case 'N': toggleNotes(); break;
+        case 'o': case 'O': toggleOverview(); break;
+        case 't': case 'T': cycleTheme(); break;
+        case 'a': case 'A': cycleAnim(); break;
+        case 'Escape': toggleOverview(false); toggleNotes(false); break;
+      }
+    });
+
+    // hash deep-link
+    function fromHash(){
+      const m = /^#\/(\d+)/.exec(location.hash||'');
+      if (m) go(Math.max(0, parseInt(m[1],10)-1));
+    }
+    window.addEventListener('hashchange', fromHash);
+    fromHash();
+    go(idx);
+  });
+})();
+/* tech-sharing — 技术分享 dark, code-forward */
+.tpl-tech-sharing{
+  --bg:#0d1117;--bg-soft:#161b22;--surface:#161b22;--surface-2:#1c2230;
+  --border:rgba(139,148,158,.22);--border-strong:rgba(139,148,158,.4);
+  --text-1:#e6edf3;--text-2:#8b949e;--text-3:#6e7681;
+  --accent:#7ee787;--accent-2:#79c0ff;--accent-3:#ff7b72;
+  --grad:linear-gradient(120deg,#7ee787 0%,#79c0ff 60%,#d2a8ff 100%);
+  --radius:14px;--radius-lg:20px;
+  --shadow:0 20px 60px rgba(0,0,0,.5);
+  font-family:'Inter','Noto Sans SC',sans-serif;
+}
+.tpl-tech-sharing{background:#0d1117;color:var(--text-1)}
+.tpl-tech-sharing .slide{padding:72px 96px;background:#0d1117;color:var(--text-1)}
+.tpl-tech-sharing .slide::before{content:"";position:absolute;inset:0;background:
+  radial-gradient(60% 50% at 90% 10%,rgba(121,192,255,.12),transparent 60%),
+  radial-gradient(50% 50% at 10% 90%,rgba(126,231,135,.08),transparent 60%);
+  pointer-events:none;z-index:0}
+.tpl-tech-sharing .slide>*{position:relative;z-index:1}
+.tpl-tech-sharing .h1{font-size:78px;line-height:1.03;font-weight:800;letter-spacing:-.03em;color:#fff}
+.tpl-tech-sharing .h2{font-size:54px;font-weight:700;letter-spacing:-.025em;color:#fff}
+.tpl-tech-sharing h3,.tpl-tech-sharing h4{color:#fff}
+.tpl-tech-sharing .kicker{color:var(--accent);font-family:'JetBrains Mono',monospace;font-size:13px;font-weight:600;text-transform:none;letter-spacing:.02em}
+.tpl-tech-sharing .kicker::before{content:"> "}
+.tpl-tech-sharing .mono{font-family:'JetBrains Mono','IBM Plex Mono',monospace}
+.tpl-tech-sharing .terminal{background:#010409;border:1px solid var(--border);border-radius:var(--radius);overflow:hidden;box-shadow:0 30px 80px rgba(0,0,0,.6);font-family:'JetBrains Mono',monospace;font-size:15px;line-height:1.65}
+.tpl-tech-sharing .terminal .bar{display:flex;align-items:center;gap:8px;padding:12px 16px;background:#161b22;border-bottom:1px solid var(--border);font-size:12px;color:var(--text-3)}
+.tpl-tech-sharing .terminal .dot{width:12px;height:12px;border-radius:50%;background:#ff5f56}
+.tpl-tech-sharing .terminal .dot:nth-child(2){background:#ffbd2e}
+.tpl-tech-sharing .terminal .dot:nth-child(3){background:#27c93f}
+.tpl-tech-sharing .terminal pre{margin:0;padding:24px 28px;color:#e6edf3;overflow:auto;max-height:440px}
+.tpl-tech-sharing .kw{color:#ff7b72}
+.tpl-tech-sharing .fn{color:#d2a8ff}
+.tpl-tech-sharing .str{color:#a5d6ff}
+.tpl-tech-sharing .cmt{color:#8b949e;font-style:italic}
+.tpl-tech-sharing .num{color:#79c0ff}
+.tpl-tech-sharing .card{background:var(--surface);border:1px solid var(--border);box-shadow:none}
+.tpl-tech-sharing .card-accent{border-top:3px solid var(--accent)}
+.tpl-tech-sharing .pill{background:var(--surface-2);color:var(--text-2);border-color:var(--border)}
+.tpl-tech-sharing .pill-accent{background:rgba(126,231,135,.12);color:var(--accent);border-color:rgba(126,231,135,.35)}
+.tpl-tech-sharing .tag{display:inline-flex;align-items:center;gap:6px;padding:4px 10px;border-radius:6px;font-family:'JetBrains Mono',monospace;font-size:12px;background:var(--surface-2);border:1px solid var(--border);color:var(--text-2)}
+.tpl-tech-sharing .agenda-row{display:flex;align-items:baseline;gap:24px;padding:18px 0;border-bottom:1px dashed var(--border);font-family:'JetBrains Mono',monospace}
+.tpl-tech-sharing .agenda-row .num{color:var(--accent);flex:none;width:48px}
+.tpl-tech-sharing .agenda-row .t{color:#fff;font-size:24px;flex:1;font-family:'Inter',sans-serif;font-weight:600}
+.tpl-tech-sharing .agenda-row .d{color:var(--text-3);font-size:13px}
+.tpl-tech-sharing .speaker{display:flex;align-items:center;gap:14px;margin-top:28px}
+.tpl-tech-sharing .speaker .av{width:56px;height:56px;border-radius:50%;background:var(--grad)}
+.tpl-tech-sharing .speaker b{display:block;color:#fff;font-size:18px}
+.tpl-tech-sharing .speaker span{color:var(--text-3);font-size:13px;font-family:'JetBrains Mono',monospace}
+.tpl-tech-sharing .lede{color:var(--text-2)}
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>全域运营平台 — 微服务架构技术分享</title>
+<style>
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;600;700;800&family=Noto+Sans+SC:wght@300;400;500;700;900&display=swap');
+
+:root {
+  --bg: #0a0e17;
+  --bg-card: #111827;
+  --bg-card2: #1a2332;
+  --border: #1e2d45;
+  --text: #e2e8f0;
+  --text-dim: #8899aa;
+  --accent: #38bdf8;
+  --accent2: #818cf8;
+  --accent3: #34d399;
+  --accent4: #f472b6;
+  --accent5: #fbbf24;
+  --red: #ef4444;
+  --orange: #f97316;
+  --green: #22c55e;
+  --blue: #3b82f6;
+}
+
+* { margin: 0; padding: 0; box-sizing: border-box; }
+
+body {
+  font-family: 'Inter', 'Noto Sans SC', -apple-system, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+  overflow: hidden;
+  height: 100vh;
+  width: 100vw;
+}
+
+.slides-container { width: 100%; height: 100%; position: relative; }
+
+.slide {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  padding: 60px 80px;
+  opacity: 0;
+  transform: scale(0.95);
+  transition: opacity .5s, transform .5s;
+  pointer-events: none;
+}
+.slide.active {
+  opacity: 1;
+  transform: scale(1);
+  pointer-events: all;
+}
+
+/* Navigation */
+.nav {
+  position: fixed; bottom: 30px; left: 50%; transform: translateX(-50%);
+  display: flex; gap: 12px; z-index: 100; align-items: center;
+}
+.nav button {
+  width: 44px; height: 44px; border-radius: 50%; border: 1px solid var(--border);
+  background: var(--bg-card); color: var(--text); cursor: pointer;
+  font-size: 18px; transition: all .2s; display: flex; align-items: center; justify-content: center;
+}
+.nav button:hover { background: var(--accent); color: #000; border-color: var(--accent); }
+.nav .page-indicator {
+  color: var(--text-dim); font-size: 14px; min-width: 80px; text-align: center;
+  font-variant-numeric: tabular-nums; font-family: 'Inter', monospace;
+}
+.nav .progress {
+  position: absolute; bottom: -8px; left: 0; height: 2px;
+  background: var(--accent); transition: width .4s; border-radius: 1px;
+}
+
+/* Typography */
+h1 { font-size: 3.2em; font-weight: 900; letter-spacing: -1px; line-height: 1.2; }
+h2 { font-size: 2.4em; font-weight: 700; margin-bottom: 40px; letter-spacing: -.5px; }
+h3 { font-size: 1.3em; font-weight: 600; margin-bottom: 12px; }
+.subtitle { font-size: 1.3em; color: var(--text-dim); margin-top: 16px; font-weight: 300; }
+.gradient-text {
+  background: linear-gradient(135deg, var(--accent), var(--accent2), var(--accent4));
+  -webkit-background-clip: text; -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+/* Cards */
+.card-grid { display: grid; gap: 20px; width: 100%; max-width: 1100px; }
+.card-grid.cols-2 { grid-template-columns: 1fr 1fr; }
+.card-grid.cols-3 { grid-template-columns: repeat(3, 1fr); }
+.card-grid.cols-4 { grid-template-columns: repeat(4, 1fr); }
+.card {
+  background: var(--bg-card); border: 1px solid var(--border); border-radius: 16px;
+  padding: 28px; transition: all .3s;
+}
+.card:hover { border-color: var(--accent); transform: translateY(-2px); }
+.card h3 { color: var(--accent); }
+.card p, .card li { color: var(--text-dim); font-size: .92em; line-height: 1.6; }
+.card ul { list-style: none; padding: 0; }
+.card ul li::before { content: "▸ "; color: var(--accent); }
+
+/* Tech tags */
+.tag {
+  display: inline-block; padding: 4px 12px; border-radius: 20px;
+  font-size: .78em; font-weight: 600; margin: 3px;
+}
+.tag.blue { background: rgba(56,189,248,.15); color: var(--accent); }
+.tag.purple { background: rgba(129,140,248,.15); color: var(--accent2); }
+.tag.green { background: rgba(52,211,153,.15); color: var(--accent3); }
+.tag.pink { background: rgba(244,114,182,.15); color: var(--accent4); }
+.tag.yellow { background: rgba(251,191,36,.15); color: var(--accent5); }
+.tag.red { background: rgba(239,68,68,.15); color: var(--red); }
+
+/* SVG area */
+.diagram-area { width: 100%; max-width: 1100px; flex: 1; display: flex; align-items: center; justify-content: center; }
+.diagram-area svg { width: 100%; height: 100%; max-height: 500px; }
+
+/* Flow arrows */
+.flow-grid { display: flex; align-items: center; gap: 20px; flex-wrap: wrap; justify-content: center; }
+.flow-box {
+  background: var(--bg-card); border: 2px solid var(--border); border-radius: 14px;
+  padding: 20px 30px; text-align: center; font-weight: 600; min-width: 140px;
+  transition: all .3s;
+}
+.flow-box.accent { border-color: var(--accent); background: rgba(56,189,248,.08); }
+.flow-box.purple { border-color: var(--accent2); background: rgba(129,140,248,.08); }
+.flow-box.green { border-color: var(--accent3); background: rgba(52,211,153,.08); }
+.flow-arrow { font-size: 1.8em; color: var(--text-dim); }
+
+/* Slide specific */
+.cover { text-align: center; }
+.cover .logo-area { margin-bottom: 40px; }
+.cover .badges { margin-top: 30px; display: flex; gap: 12px; justify-content: center; flex-wrap: wrap; }
+.cover .line { width: 80px; height: 4px; background: linear-gradient(90deg, var(--accent), var(--accent4)); border-radius: 2px; margin: 30px auto; }
+
+.section-header { text-align: center; }
+.section-header .line { width: 60px; height: 3px; background: var(--accent); margin: 20px auto; border-radius: 2px; }
+
+/* Layer diagram */
+.layer-stack { display: flex; flex-direction: column; gap: 12px; width: 100%; max-width: 1000px; }
+.layer {
+  display: flex; align-items: center; gap: 20px; padding: 16px 24px;
+  border-radius: 12px; background: var(--bg-card); border: 1px solid var(--border);
+}
+.layer-label {
+  font-weight: 700; font-size: .9em; min-width: 100px; text-align: right;
+  color: var(--accent);
+}
+.layer-content { display: flex; gap: 8px; flex-wrap: wrap; }
+
+/* Stats */
+.stat-row { display: flex; gap: 40px; justify-content: center; }
+.stat { text-align: center; }
+.stat .num { font-size: 3em; font-weight: 900; background: linear-gradient(135deg, var(--accent), var(--accent2));
+  -webkit-background-clip: text; -webkit-text-fill-color: transparent; background-clip: text; }
+.stat .label { color: var(--text-dim); font-size: .9em; margin-top: 4px; }
+
+/* Tree */
+.tree { font-family: 'SF Mono', 'Fira Code', monospace; font-size: .85em; line-height: 1.8; }
+.tree .root { color: var(--accent); font-weight: 700; }
+.tree .branch { color: var(--accent2); }
+.tree .leaf { color: var(--text-dim); }
+.tree .highlight { color: var(--accent3); font-weight: 600; }
+
+/* Mermaid-like diagram */
+.arch-diagram { position: relative; width: 100%; max-width: 1000px; height: 440px; }
+.arch-node {
+  position: absolute; padding: 14px 20px; border-radius: 10px;
+  font-size: .82em; font-weight: 600; text-align: center;
+  border: 2px solid; transition: all .3s;
+}
+.arch-node:hover { z-index: 10; transform: scale(1.05); }
+
+@media (max-width: 1024px) {
+  .slide { padding: 40px 30px; }
+  h1 { font-size: 2em; } h2 { font-size: 1.6em; }
+  .card-grid.cols-3, .card-grid.cols-4 { grid-template-columns: 1fr 1fr; }
+}
+</style>
+</head>
+<body>
+
+<div class="slides-container" id="slides">
+
+<!-- ==================== SLIDE 1: COVER ==================== -->
+<div class="slide active" data-slide="0">
+  <div class="cover">
+    <div class="logo-area">
+      <div style="font-size:5em;margin-bottom:10px">&#x1f3d9;</div>
+    </div>
+    <h1 class="gradient-text">全域运营平台</h1>
+    <h1 style="margin-top:4px">微服务架构技术分享</h1>
+    <div class="line"></div>
+    <p class="subtitle">模块化架构设计 · 技术栈全景 · 最佳实践</p>
+    <div class="badges">
+      <span class="tag blue">Spring Boot 3.5</span>
+      <span class="tag purple">JDK 17</span>
+      <span class="tag green">Maven 多模块</span>
+      <span class="tag pink">Flowable 7</span>
+      <span class="tag yellow">IoT 网关</span>
+      <span class="tag blue">Docker</span>
+    </div>
+    <p style="margin-top:40px;color:var(--text-dim);font-size:.85em">2026年5月 · 技术团队内部分享</p>
+  </div>
+</div>
+
+<!-- ==================== SLIDE 2: PROJECT OVERVIEW ==================== -->
+<div class="slide" data-slide="1">
+  <h2>项目概览</h2>
+  <div class="card-grid cols-2" style="max-width:1000px">
+    <div class="card">
+      <h3>定位</h3>
+      <p>面向城市运营管理的综合业务平台，覆盖园林养护、工单调度、IoT 设备管理、BPM 流程引擎等核心业务场景。</p>
+    </div>
+    <div class="card">
+      <h3>规模</h3>
+      <div class="stat-row" style="margin-top:8px">
+        <div class="stat"><div class="num">4,525+</div><div class="label">Java 源文件</div></div>
+        <div class="stat"><div class="num">15</div><div class="label">框架 Starter</div></div>
+        <div class="stat"><div class="num">10+</div><div class="label">业务模块</div></div>
+      </div>
+    </div>
+    <div class="card">
+      <h3>架构风格</h3>
+      <p><strong>模块化单体</strong> 向微服务演进中 — 通过 Maven 多模块 + API 契约层实现模块解耦，IoT 网关已独立部署。</p>
+    </div>
+    <div class="card">
+      <h3>核心能力</h3>
+      <ul>
+        <li>多租户 SaaS 架构</li>
+        <li>Flowable 工作流引擎</li>
+        <li>IoT 设备接入网关 (MQTT/HTTP/TCP)</li>
+        <li>分布式消息 & 定时任务</li>
+        <li>Spring AI 多模型接入</li>
+      </ul>
+    </div>
+  </div>
+</div>
+
+<!-- ==================== SLIDE 3: TECH STACK ==================== -->
+<div class="slide" data-slide="2">
+  <h2>技术栈全景图</h2>
+  <div class="layer-stack">
+    <div class="layer">
+      <div class="layer-label">前端</div>
+      <div class="layer-content">
+        <span class="tag blue">Vue 3</span><span class="tag blue">Element Plus</span>
+        <span class="tag purple">Vben Admin</span><span class="tag blue">Vue 2</span>
+        <span class="tag green">uni-app</span><span class="tag pink">TypeScript</span>
+      </div>
+    </div>
+    <div class="layer">
+      <div class="layer-label">网关 & 接入</div>
+      <div class="layer-content">
+        <span class="tag blue">Vert.x</span><span class="tag green">MQTT</span>
+        <span class="tag purple">HTTP/2</span><span class="tag pink">TCP</span>
+        <span class="tag blue">WebSocket</span>
+      </div>
+    </div>
+    <div class="layer">
+      <div class="layer-label">业务框架</div>
+      <div class="layer-content">
+        <span class="tag blue">Spring Boot 3.5</span><span class="tag purple">Spring Security</span>
+        <span class="tag green">Flowable 7</span><span class="tag pink">Quartz</span>
+        <span class="tag yellow">Spring AI</span><span class="tag blue">PF4J</span>
+      </div>
+    </div>
+    <div class="layer">
+      <div class="layer-label">数据层</div>
+      <div class="layer-content">
+        <span class="tag blue">MyBatis Plus</span><span class="tag purple">Druid</span>
+        <span class="tag green">MySQL 8</span><span class="tag pink">Redis Sentinel</span>
+        <span class="tag yellow">Redisson</span><span class="tag blue">Dynamic DS</span>
+      </div>
+    </div>
+    <div class="layer">
+      <div class="layer-label">消息 & 集成</div>
+      <div class="layer-content">
+        <span class="tag green">RocketMQ</span><span class="tag blue">Kafka</span>
+        <span class="tag purple">RabbitMQ</span><span class="tag pink">JustAuth</span>
+        <span class="tag yellow">UAA SSO</span><span class="tag blue">S3</span>
+      </div>
+    </div>
+    <div class="layer">
+      <div class="layer-label">可观测性</div>
+      <div class="layer-content">
+        <span class="tag blue">SkyWalking</span><span class="tag purple">SBA Admin</span>
+        <span class="tag green">OpenTracing</span><span class="tag pink">Actuator</span>
+        <span class="tag yellow">Knife4j</span>
+      </div>
+    </div>
+    <div class="layer">
+      <div class="layer-label">部署 & DevOps</div>
+      <div class="layer-content">
+        <span class="tag blue">Docker</span><span class="tag green">docker-compose</span>
+        <span class="tag purple">Eclipse Temurin 21</span><span class="tag pink">Maven</span>
+        <span class="tag yellow">Git</span>
+      </div>
+    </div>
+  </div>
+</div>
+
+<!-- ==================== SLIDE 4: ARCHITECTURE OVERVIEW ==================== -->
+<div class="slide" data-slide="3">
+  <h2>系统架构总览</h2>
+  <div class="diagram-area">
+    <svg viewBox="0 0 1000 460" xmlns="http://www.w3.org/2000/svg">
+      <defs>
+        <linearGradient id="gAccent" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" stop-color="#38bdf8"/><stop offset="100%" stop-color="#818cf8"/></linearGradient>
+        <linearGradient id="gGreen" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" stop-color="#34d399"/><stop offset="100%" stop-color="#22c55e"/></linearGradient>
+        <linearGradient id="gPink" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" stop-color="#f472b6"/><stop offset="100%" stop-color="#e879f9"/></linearGradient>
+        <linearGradient id="gYellow" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" stop-color="#fbbf24"/><stop offset="100%" stop-color="#f59e0b"/></linearGradient>
+        <filter id="shadow"><feDropShadow dx="0" dy="2" stdDeviation="4" flood-opacity="0.3"/></filter>
+      </defs>
+
+      <!-- Top: Client Layer -->
+      <rect x="30" y="10" width="940" height="60" rx="10" fill="#111827" stroke="#1e3a5f" stroke-width="1.5"/>
+      <text x="500" y="35" text-anchor="middle" fill="#8899aa" font-size="12" font-weight="600">接入层 CLIENT LAYER</text>
+      <rect x="60" y="42" width="100" height="22" rx="6" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1"/>
+      <text x="110" y="57" text-anchor="middle" fill="#38bdf8" font-size="10">Vue 3 Web</text>
+      <rect x="180" y="42" width="100" height="22" rx="6" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1"/>
+      <text x="230" y="57" text-anchor="middle" fill="#38bdf8" font-size="10">uni-app 小程序</text>
+      <rect x="300" y="42" width="100" height="22" rx="6" fill="rgba(129,140,248,.12)" stroke="#818cf8" stroke-width="1"/>
+      <text x="350" y="57" text-anchor="middle" fill="#818cf8" font-size="10">IoT 设备</text>
+      <rect x="420" y="42" width="100" height="22" rx="6" fill="rgba(129,140,248,.12)" stroke="#818cf8" stroke-width="1"/>
+      <text x="470" y="57" text-anchor="middle" fill="#818cf8" font-size="10">第三方系统</text>
+
+      <!-- Arrow Client -> Gateway -->
+      <line x1="500" y1="70" x2="500" y2="90" stroke="#8899aa" stroke-width="1.5" stroke-dasharray="4,3"/>
+
+      <!-- Gateway Layer -->
+      <rect x="30" y="90" width="940" height="80" rx="10" fill="#111827" stroke="#1e3a5f" stroke-width="1.5"/>
+      <text x="500" y="115" text-anchor="middle" fill="#8899aa" font-size="12" font-weight="600">网关与接入 GATEWAY LAYER</text>
+      <rect x="60" y="127" width="200" height="32" rx="8" fill="rgba(56,189,248,.1)" stroke="#38bdf8" stroke-width="1.5" filter="url(#shadow)"/>
+      <text x="160" y="147" text-anchor="middle" fill="#38bdf8" font-size="11" font-weight="600">UrbanOps Server :48081</text>
+      <rect x="300" y="127" width="200" height="32" rx="8" fill="rgba(52,211,153,.1)" stroke="#34d399" stroke-width="1.5" filter="url(#shadow)"/>
+      <text x="400" y="147" text-anchor="middle" fill="#34d399" font-size="11" font-weight="600">IoT 网关 :8092 (独立部署)</text>
+      <rect x="540" y="127" width="180" height="32" rx="8" fill="rgba(129,140,248,.1)" stroke="#818cf8" stroke-width="1.5" filter="url(#shadow)"/>
+      <text x="630" y="147" text-anchor="middle" fill="#818cf8" font-size="11" font-weight="600">UAA SSO :28201</text>
+
+      <!-- Arrow Gateway -> Business -->
+      <line x1="500" y1="170" x2="500" y2="190" stroke="#8899aa" stroke-width="1.5" stroke-dasharray="4,3"/>
+
+      <!-- Business Module Layer -->
+      <rect x="30" y="190" width="940" height="130" rx="10" fill="#111827" stroke="#1e3a5f" stroke-width="1.5"/>
+      <text x="500" y="215" text-anchor="middle" fill="#8899aa" font-size="12" font-weight="600">业务模块层 BUSINESS MODULES</text>
+
+      <rect x="50" y="228" width="145" height="42" rx="8" fill="rgba(56,189,248,.1)" stroke="#38bdf8" stroke-width="1.5"/>
+      <text x="122" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">system</text>
+      <text x="122" y="260" text-anchor="middle" fill="#8899aa" font-size="9">用户·权限·租户</text>
+
+      <rect x="210" y="228" width="145" height="42" rx="8" fill="rgba(129,140,248,.1)" stroke="#818cf8" stroke-width="1.5"/>
+      <text x="282" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">garden</text>
+      <text x="282" y="260" text-anchor="middle" fill="#8899aa" font-size="9">园林养护·巡检</text>
+
+      <rect x="370" y="228" width="145" height="42" rx="8" fill="rgba(52,211,153,.1)" stroke="#34d399" stroke-width="1.5"/>
+      <text x="442" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">workorder</text>
+      <text x="442" y="260" text-anchor="middle" fill="#8899aa" font-size="9">工单·调度</text>
+
+      <rect x="530" y="228" width="145" height="42" rx="8" fill="rgba(244,114,182,.1)" stroke="#f472b6" stroke-width="1.5"/>
+      <text x="602" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">bpm</text>
+      <text x="602" y="260" text-anchor="middle" fill="#8899aa" font-size="9">Flowable 流程</text>
+
+      <rect x="690" y="228" width="145" height="42" rx="8" fill="rgba(251,191,36,.1)" stroke="#fbbf24" stroke-width="1.5"/>
+      <text x="762" y="246" text-anchor="middle" fill="#e2e8f0" font-size="10" font-weight="600">gloabl</text>
+      <text x="762" y="260" text-anchor="middle" fill="#8899aa" font-size="9">全域运营·微信</text>
+
+      <!-- API Contract row -->
+      <rect x="250" y="280" width="500" height="30" rx="8" fill="rgba(255,255,255,.03)" stroke="#334155" stroke-width="1" stroke-dasharray="4,3"/>
+      <text x="500" y="299" text-anchor="middle" fill="#8899aa" font-size="10">API 契约层: garden-api · workorder-api (接口定义 + Feign 风格调用)</text>
+
+      <!-- Arrow Business -> Infra -->
+      <line x1="500" y1="320" x2="500" y2="340" stroke="#8899aa" stroke-width="1.5" stroke-dasharray="4,3"/>
+
+      <!-- Infrastructure Layer -->
+      <rect x="30" y="340" width="940" height="50" rx="10" fill="#111827" stroke="#1e3a5f" stroke-width="1.5"/>
+      <text x="500" y="370" text-anchor="middle" fill="#8899aa" font-size="12" font-weight="600">基础设施层 INFRASTRUCTURE: 15个Spring Boot Starter (Web · Security · MyBatis · Redis · MQ · Job · Excel · WebSocket · Monitor · Protection · Tenant · DataPermission · IP · Test)</text>
+
+      <!-- Arrow Infra -> Data -->
+      <line x1="500" y1="390" x2="500" y2="408" stroke="#8899aa" stroke-width="1.5" stroke-dasharray="4,3"/>
+
+      <!-- Data Layer -->
+      <rect x="30" y="408" width="940" height="45" rx="10" fill="#0a0e17" stroke="#1e2e45" stroke-width="1.5"/>
+      <text x="500" y="435" text-anchor="middle" fill="#8899aa" font-size="12" font-weight="600">数据层: MySQL 8 · Redis Sentinel · RocketMQ · Kafka · RabbitMQ · S3 · Druid · Redisson</text>
+    </svg>
+  </div>
+</div>
+
+<!-- ==================== SLIDE 5: MODULE DEPENDENCIES ==================== -->
+<div class="slide" data-slide="4">
+  <h2>模块依赖关系图</h2>
+  <div class="diagram-area">
+    <svg viewBox="0 0 1000 440" xmlns="http://www.w3.org/2000/svg">
+      <defs>
+        <marker id="arrowBlue" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#38bdf8"/></marker>
+        <marker id="arrowGray" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#64748b"/></marker>
+      </defs>
+
+      <!-- Top level: dependencies BOM -->
+      <rect x="350" y="8" width="300" height="38" rx="10" fill="rgba(251,191,36,.1)" stroke="#fbbf24" stroke-width="2"/>
+      <text x="500" y="32" text-anchor="middle" fill="#fbbf24" font-size="13" font-weight="700">urbanops-dependencies (BOM)</text>
+
+      <line x1="500" y1="46" x2="500" y2="70" stroke="#fbbf24" stroke-width="1.5" marker-end="url(#arrowBlue)"/>
+
+      <!-- Framework layer -->
+      <rect x="80" y="72" width="840" height="58" rx="10" fill="#111827" stroke="#1e3a5f" stroke-width="1.5"/>
+      <text x="500" y="94" text-anchor="middle" fill="#8899aa" font-size="11" font-weight="600">urbanops-framework</text>
+      <text x="500" y="113" text-anchor="middle" fill="#64748b" font-size="9">common · web · security · mybatis · redis · mq · job · excel · websocket · monitor · protection · tenant · data-permission · ip · test</text>
+
+      <line x1="300" y1="130" x2="300" y2="155" stroke="#64748b" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+      <line x1="500" y1="130" x2="500" y2="155" stroke="#64748b" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+      <line x1="700" y1="130" x2="700" y2="155" stroke="#64748b" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+
+      <!-- infra -->
+      <rect x="210" y="158" width="180" height="40" rx="8" fill="rgba(99,102,241,.12)" stroke="#6366f1" stroke-width="1.5"/>
+      <text x="300" y="183" text-anchor="middle" fill="#a5b4fc" font-size="12" font-weight="600">module-infra</text>
+
+      <!-- system -->
+      <rect x="410" y="158" width="180" height="40" rx="8" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1.5"/>
+      <text x="500" y="183" text-anchor="middle" fill="#38bdf8" font-size="12" font-weight="600">module-system</text>
+
+      <!-- global -->
+      <rect x="610" y="158" width="180" height="40" rx="8" fill="rgba(251,191,36,.12)" stroke="#fbbf24" stroke-width="1.5"/>
+      <text x="700" y="183" text-anchor="middle" fill="#fbbf24" font-size="12" font-weight="600">module-gloabl</text>
+
+      <!-- Arrows down from infra and system -->
+      <line x1="300" y1="198" x2="300" y2="230" stroke="#64748b" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+      <line x1="500" y1="198" x2="360" y2="230" stroke="#38bdf8" stroke-width="1.2"/>
+      <line x1="500" y1="198" x2="640" y2="230" stroke="#38bdf8" stroke-width="1.2"/>
+
+      <!-- bpm -->
+      <rect x="210" y="233" width="180" height="40" rx="8" fill="rgba(244,114,182,.12)" stroke="#f472b6" stroke-width="1.5"/>
+      <text x="300" y="258" text-anchor="middle" fill="#f472b6" font-size="12" font-weight="600">module-bpm</text>
+
+      <!-- garden -->
+      <rect x="85" y="308" width="200" height="40" rx="8" fill="rgba(52,211,153,.12)" stroke="#34d399" stroke-width="2"/>
+      <text x="185" y="333" text-anchor="middle" fill="#34d399" font-size="12" font-weight="600">module-garden</text>
+
+      <!-- workorder -->
+      <rect x="420" y="308" width="200" height="40" rx="8" fill="rgba(52,211,153,.12)" stroke="#34d399" stroke-width="2"/>
+      <text x="520" y="333" text-anchor="middle" fill="#34d399" font-size="12" font-weight="600">module-workorder</text>
+
+      <!-- API modules -->
+      <rect x="680" y="308" width="220" height="40" rx="8" fill="rgba(129,140,248,.08)" stroke="#818cf8" stroke-width="1" stroke-dasharray="5,3"/>
+      <text x="790" y="333" text-anchor="middle" fill="#818cf8" font-size="11" font-weight="600">module-api (契约层)</text>
+
+      <!-- Arrows from bpm -->
+      <line x1="240" y1="273" x2="185" y2="307" stroke="#f472b6" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+      <line x1="360" y1="273" x2="520" y2="307" stroke="#f472b6" stroke-width="1.2" marker-end="url(#arrowGray)"/>
+
+      <!-- API arrows -->
+      <line x1="285" y1="330" x2="420" y2="330" stroke="#818cf8" stroke-width="1" stroke-dasharray="5,3" marker-end="url(#arrowGray)"/>
+      <line x1="620" y1="330" x2="680" y2="330" stroke="#818cf8" stroke-width="1" stroke-dasharray="5,3" marker-end="url(#arrowGray)"/>
+
+      <!-- IoT (separate) -->
+      <rect x="420" y="380" width="220" height="40" rx="8" fill="rgba(239,68,68,.12)" stroke="#ef4444" stroke-width="1.5" stroke-dasharray="6,3"/>
+      <text x="530" y="405" text-anchor="middle" fill="#ef4444" font-size="12" font-weight="600">IoT 网关 (独立进程 :8092)</text>
+      <text x="530" y="395" text-anchor="middle" fill="#f87171" font-size="8" font-weight="400">Vert.x · MQTT · HTTP · TCP</text>
+
+      <line x1="620" y1="348" x2="560" y2="379" stroke="#ef4444" stroke-width="1" stroke-dasharray="5,3"/>
+
+      <!-- Legend -->
+      <rect x="30" y="415" width="12" height="12" rx="2" fill="none" stroke="#34d399" stroke-width="1.5"/>
+      <text x="48" y="425" fill="#64748b" font-size="9">核心业务域</text>
+      <rect x="150" y="415" width="12" height="12" rx="2" fill="none" stroke="#38bdf8" stroke-width="1.5"/>
+      <text x="168" y="425" fill="#64748b" font-size="9">基础服务</text>
+      <rect x="260" y="415" width="12" height="12" rx="2" fill="none" stroke="#ef4444" stroke-width="1.5" stroke-dasharray="3,2"/>
+      <text x="278" y="425" fill="#64748b" font-size="9">独立部署</text>
+      <line x1="370" y1="421" x2="400" y2="421" stroke="#818cf8" stroke-width="1" stroke-dasharray="5,3"/>
+      <text x="408" y="425" fill="#64748b" font-size="9">API 契约调用</text>
+    </svg>
+  </div>
+</div>
+
+<!-- ==================== SLIDE 6: FRAMEWORK ARCHITECTURE ==================== -->
+<div class="slide" data-slide="5">
+  <h2>框架层 — 15 个 Spring Boot Starter</h2>
+  <div class="card-grid cols-4" style="max-width:1100px">
+    <div class="card"><h3>web</h3><p>全局异常处理、API 访问日志、敏感数据脱敏、错误码体系</p></div>
+    <div class="card"><h3>security</h3><p>Spring Security + Token 认证、操作日志(bizlog)、权限校验</p></div>
+    <div class="card"><h3>mybatis</h3><p>MyBatis Plus + Join、动态数据源、多数据库适配</p></div>
+    <div class="card"><h3>redis</h3><p>Redis Sentinel 集群、Redisson 分布式锁、Spring Cache</p></div>
+    <div class="card"><h3>mq</h3><p>消息队列抽象层 — RocketMQ / Kafka / RabbitMQ 统一接口</p></div>
+    <div class="card"><h3>job</h3><p>Quartz 分布式定时任务、JDBC 持久化、集群调度</p></div>
+    <div class="card"><h3>excel</h3><p>FastExcel 导入导出、模板下载、大数据量流式处理</p></div>
+    <div class="card"><h3>websocket</h3><p>WebSocket 集群广播，支持 Redis/MQ 跨节点消息同步</p></div>
+    <div class="card"><h3>monitor</h3><p>Spring Boot Admin、SkyWalking 链路追踪、OpenTracing</p></div>
+    <div class="card"><h3>protection</h3><p>分布式锁(Lock4j)、幂等性、限流、API 签名校验</p></div>
+    <div class="card"><h3>tenant</h3><p>多租户数据隔离、租户上下文传递、SaaS 计费</p></div>
+    <div class="card"><h3>data-permission</h3><p>数据权限控制 — 部门/用户级数据隔离</p></div>
+    <div class="card"><h3>ip</h3><p>IP 归属地解析、地区库自动更新</p></div>
+    <div class="card"><h3>test</h3><p>单元测试工具、Mock 工具集</p></div>
+    <div class="card"><h3>common</h3><p>通用工具、枚举、基础类、Hutool + Guava 集成</p></div>
+  </div>
+</div>
+
+<!-- ==================== SLIDE 7: DATA FLOW & COMMUNICATION ==================== -->
+<div class="slide" data-slide="6">
+  <h2>数据流与通信架构</h2>
+  <div class="diagram-area">
+    <svg viewBox="0 0 1000 420" xmlns="http://www.w3.org/2000/svg">
+      <defs>
+        <marker id="arrGreen" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#34d399"/></marker>
+        <marker id="arrBlue" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#38bdf8"/></marker>
+        <marker id="arrPink" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#f472b6"/></marker>
+        <marker id="arrYellow" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><path d="M0,0 L8,3 L0,6 Z" fill="#fbbf24"/></marker>
+      </defs>
+
+      <!-- Central: UrbanOps Server -->
+      <rect x="350" y="160" width="300" height="60" rx="14" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="2.5" filter="url(#shadow)"/>
+      <text x="500" y="187" text-anchor="middle" fill="#e2e8f0" font-size="15" font-weight="700">UrbanOps Server</text>
+      <text x="500" y="205" text-anchor="middle" fill="#8899aa" font-size="10">核心业务处理引擎</text>
+
+      <!-- SQL -->
+      <rect x="60" y="60" width="160" height="50" rx="10" fill="rgba(59,130,246,.12)" stroke="#3b82f6" stroke-width="1.5"/>
+      <text x="140" y="82" text-anchor="middle" fill="#60a5fa" font-size="12" font-weight="600">MySQL 8</text>
+      <text x="140" y="98" text-anchor="middle" fill="#8899aa" font-size="9">主从 + Druid 连接池</text>
+      <line x1="220" y1="85" x2="348" y2="175" stroke="#3b82f6" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrBlue)"/>
+
+      <!-- Redis -->
+      <rect x="60" y="150" width="160" height="50" rx="10" fill="rgba(239,68,68,.12)" stroke="#ef4444" stroke-width="1.5"/>
+      <text x="140" y="172" text-anchor="middle" fill="#f87171" font-size="12" font-weight="600">Redis Sentinel</text>
+      <text x="140" y="188" text-anchor="middle" fill="#8899aa" font-size="9">缓存 · 分布式锁 · Token</text>
+      <line x1="220" y1="175" x2="348" y2="180" stroke="#ef4444" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrBlue)"/>
+
+      <!-- MQ -->
+      <rect x="60" y="240" width="160" height="50" rx="10" fill="rgba(52,211,153,.12)" stroke="#34d399" stroke-width="1.5"/>
+      <text x="140" y="262" text-anchor="middle" fill="#4ade80" font-size="12" font-weight="600">MQ 消息队列</text>
+      <text x="140" y="278" text-anchor="middle" fill="#8899aa" font-size="9">RocketMQ · Kafka · RabbitMQ</text>
+      <line x1="220" y1="265" x2="348" y2="195" stroke="#34d399" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrGreen)"/>
+
+      <!-- IoT Gateway -->
+      <rect x="740" y="60" width="200" height="50" rx="10" fill="rgba(244,114,182,.12)" stroke="#f472b6" stroke-width="1.5"/>
+      <text x="840" y="82" text-anchor="middle" fill="#f472b6" font-size="12" font-weight="600">IoT 网关 :8092</text>
+      <text x="840" y="98" text-anchor="middle" fill="#8899aa" font-size="9">Vert.x · MQTT · TCP</text>
+      <line x1="740" y1="85" x2="652" y2="175" stroke="#f472b6" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrPink)"/>
+
+      <!-- Devices -->
+      <rect x="740" y="160" width="200" height="50" rx="10" fill="rgba(251,191,36,.12)" stroke="#fbbf24" stroke-width="1.5"/>
+      <text x="840" y="182" text-anchor="middle" fill="#fbbf24" font-size="12" font-weight="600">IoT 设备层</text>
+      <text x="840" y="198" text-anchor="middle" fill="#8899aa" font-size="9">传感器 · GPS · 控制器</text>
+      <line x1="740" y1="185" x2="940" y2="185" stroke="#fbbf24" stroke-width="1.2" stroke-dasharray="4,3"/>
+      <line x1="840" y1="210" x2="840" y2="350" stroke="#fbbf24" stroke-width="1" stroke-dasharray="4,3"/>
+
+      <!-- S3 -->
+      <rect x="740" y="240" width="200" height="50" rx="10" fill="rgba(129,140,248,.12)" stroke="#818cf8" stroke-width="1.5"/>
+      <text x="840" y="262" text-anchor="middle" fill="#a5b4fc" font-size="12" font-weight="600">对象存储 S3</text>
+      <text x="840" y="278" text-anchor="middle" fill="#8899aa" font-size="9">文件 · 图片 · 附件</text>
+      <line x1="740" y1="265" x2="652" y2="205" stroke="#818cf8" stroke-width="1.2" stroke-dasharray="6,3" marker-end="url(#arrBlue)"/>
+
+      <!-- Flowable -->
+      <rect x="60" y="330" width="160" height="50" rx="10" fill="rgba(244,114,182,.12)" stroke="#f472b6" stroke-width="1.5"/>
+      <text x="140" y="352" text-anchor="middle" fill="#f472b6" font-size="12" font-weight="600">Flowable 7</text>
+      <text x="140" y="368" text-anchor="middle" fill="#8899aa" font-size="9">工作流引擎</text>
+      <line x1="220" y1="355" x2="348" y2="220" stroke="#f472b6" stroke-width="1.2" stroke-dasharray="6,3"/>
+
+      <!-- Quartz -->
+      <rect x="320" y="340" width="160" height="50" rx="10" fill="rgba(251,191,36,.12)" stroke="#fbbf24" stroke-width="1.5"/>
+      <text x="400" y="362" text-anchor="middle" fill="#fbbf24" font-size="12" font-weight="600">Quartz 调度</text>
+      <text x="400" y="378" text-anchor="middle" fill="#8899aa" font-size="9">定时任务集群</text>
+      <line x1="480" y1="340" x2="500" y2="222" stroke="#fbbf24" stroke-width="1.2" stroke-dasharray="6,3"/>
+
+      <!-- WebSocket -->
+      <rect x="560" y="340" width="190" height="50" rx="10" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1.5"/>
+      <text x="655" y="362" text-anchor="middle" fill="#38bdf8" font-size="12" font-weight="600">WebSocket</text>
+      <text x="655" y="378" text-anchor="middle" fill="#8899aa" font-size="9">实时消息推送</text>
+      <line x1="560" y1="365" x2="502" y2="222" stroke="#38bdf8" stroke-width="1.2" stroke-dasharray="6,3"/>
+    </svg>
+  </div>
+</div>
+
+<!-- ==================== SLIDE 8: SECURITY ==================== -->
+<div class="slide" data-slide="7">
+  <h2>安全与认证架构</h2>
+  <div class="diagram-area">
+    <svg viewBox="0 0 1000 400" xmlns="http://www.w3.org/2000/svg">
+      <!-- Client -->
+      <rect x="30" y="30" width="120" height="60" rx="10" fill="rgba(56,189,248,.1)" stroke="#38bdf8" stroke-width="1.5"/>
+      <text x="90" y="55" text-anchor="middle" fill="#38bdf8" font-size="11" font-weight="600">客户端</text>
+      <text x="90" y="73" text-anchor="middle" fill="#8899aa" font-size="9">Web / 小程序 / App</text>
+
+      <!-- Filter Chain -->
+      <rect x="200" y="30" width="760" height="60" rx="10" fill="#111827" stroke="#1e3a5f" stroke-width="1.5"/>
+      <text x="580" y="52" text-anchor="middle" fill="#8899aa" font-size="11" font-weight="600">Security Filter Chain</text>
+
+      <rect x="215" y="58" width="130" height="24" rx="6" fill="rgba(239,68,68,.12)" stroke="#ef4444" stroke-width="1"/>
+      <text x="280" y="74" text-anchor="middle" fill="#f87171" font-size="9">API 签名校验</text>
+
+      <rect x="355" y="58" width="120" height="24" rx="6" fill="rgba(251,191,36,.12)" stroke="#fbbf24" stroke-width="1"/>
+      <text x="415" y="74" text-anchor="middle" fill="#fbbf24" font-size="9">限流 & 幂等</text>
+
+      <rect x="485" y="58" width="120" height="24" rx="6" fill="rgba(56,189,248,.12)" stroke="#38bdf8" stroke-width="1"/>
+      <text x="545" y="74" text-anchor="middle" fill="#38bdf8" font-size="9">Token 认证</text>
+
+      <rect x="615" y="58" width="100" height="24" rx="6" fill="rgba(129,140,248,.12)" stroke="#818cf8" stroke-width="1"/>
+      <text x="665" y="74" text-anchor="middle" fill="#a5b4fc" font-size="9">权限校验</text>
+
+      <rect x="725" y="58" width="100" height="24" rx="6" fill="rgba(52,211,153,.12)" stroke="#34d399" stroke-width="1"/>
+      <text x="775" y="74" text-anchor="middle" fill="#4ade80" font-size="9">数据脱敏</text>
+
+      <rect x="835" y="58" width="110" height="24" rx="6" fill="rgba(244,114,182,.12)" stroke="#f472b6" stroke-width="1"/>
+      <text x="890" y="74" text-anchor="middle" fill="#f472b6" font-size="9">操作日志</text>
+
+      <!-- Arrow -->
+      <line x1="150" y1="60" x2="198" y2="60" stroke="#38bdf8" stroke-width="2" marker-end="url(#arrBlue)"/>
+
+      <!-- Business Layer -->
+      <rect x="200" y="120" width="760" height="110" rx="10" fill="#111827" stroke="#1e3a5f" stroke-width="1.5"/>
+      <text x="580" y="145" text-anchor="middle" fill="#8899aa" font-size="11" font-weight="600">认证与授权中心</text>
+
+      <!-- JWT -->
+      <rect x="220" y="155" width="200" height="42" rx="8" fill="rgba(56,189,248,.1)" stroke="#38bdf8" stroke-width="1.5"/>
+      <text x="320" y="174" text-anchor="middle" fill="#e2e8f0" font-size="11" font-weight="600">JWT Token</text>
+      <text x="320" y="189" text-anchor="middle" fill="#8899aa" font-size="9">Redis 存储 · 自动续期</text>
+
+      <!-- SSO -->
+      <rect x="450" y="155" width="200" height="42" rx="8" fill="rgba(129,140,248,.1)" stroke="#818cf8" stroke-width="1.5"/>
+      <text x="550" y="174" text-anchor="middle" fill="#e2e8f0" font-size="11" font-weight="600">UAA SSO</text>
+      <text x="550" y="189" text-anchor="middle" fill="#8899aa" font-size="9">OAuth2 · 单点登录</text>
+
+      <!-- Social -->
+      <rect x="680" y="155" width="250" height="42" rx="8" fill="rgba(52,211,153,.1)" stroke="#34d399" stroke-width="1.5"/>
+      <text x="805" y="174" text-anchor="middle" fill="#e2e8f0" font-size="11" font-weight="600">JustAuth 社交登录</text>
+      <text x="805" y="189" text-anchor="middle" fill="#8899aa" font-size="9">钉钉 · 企业微信 · 小程序 · 公众号</text>
+
+      <!-- Tenant + Data Permission -->
+      <rect x="220" y="205" width="340" height="20" rx="5" fill="rgba(251,191,36,.08)" stroke="#fbbf24" stroke-width="0.8"/>
+      <text x="390" y="219" text-anchor="middle" fill="#fbbf24" font-size="9">多租户数据隔离 (SaaS)</text>
+
+      <rect x="580" y="205" width="350" height="20" rx="5" fill="rgba(244,114,182,.08)" stroke="#f472b6" stroke-width="0.8"/>
+      <text x="755" y="219" text-anchor="middle" fill="#f472b6" font-size="9">部门/用户级数据权限 (RBAC + Data Scope)</text>
+
+      <!-- Arrow to Business -->
+      <line x1="580" y1="230" x2="580" y2="260" stroke="#8899aa" stroke-width="1.5" stroke-dasharray="5,3"/>
+      <text x="600" y="250" fill="#64748b" font-size="9">授权通过</text>
+
+      <!-- Business modules -->
+      <rect x="200" y="260" width="760" height="50" rx="10" fill="#0a0e17" stroke="#1e2e45" stroke-width="1.5"/>
+      <text x="580" y="290" text-anchor="middle" fill="#8899aa" font-size="11" font-weight="600">业务模块: garden · workorder · bpm · gloabl · infra · system</text>
+
+      <!-- Captcha -->
+      <rect x="30" y="320" width="120" height="50" rx="10" fill="rgba(251,191,36,.08)" stroke="#fbbf24" stroke-width="1"/>
+      <text x="90" y="342" text-anchor="middle" fill="#fbbf24" font-size="11" font-weight="600">AJ Captcha</text>
+      <text x="90" y="358" text-anchor="middle" fill="#8899aa" font-size="9">滑块验证</text>
+      <line x1="150" y1="345" x2="198" y2="285" stroke="#fbbf24" stroke-width="0.8" stroke-dasharray="4,3"/>
+
+      <!-- AES -->
+      <rect x="30" y="200" width="120" height="50" rx="10" fill="rgba(239,68,68,.08)" stroke="#ef4444" stroke-width="1"/>
+      <text x="90" y="222" text-anchor="middle" fill="#f87171" font-size="11" font-weight="600">API 加密</text>
+      <text x="90" y="238" text-anchor="middle" fill="#8899aa" font-size="9">AES 算法</text>
+    </svg>
+  </div>
+</div>
+
+<!-- ==================== SLIDE 9: DEPLOYMENT ==================== -->
+<div class="slide" data-slide="8">
+  <h2>部署架构</h2>
+  <div class="diagram-area">
+    <svg viewBox="0 0 1000 400" xmlns="http://www.w3.org/2000/svg">
+      <!-- Docker Host -->
+      <rect x="20" y="20" width="960" height="360" rx="16" fill="#111827" stroke="#1e3a5f" stroke-width="2"/>
+      <text x="500" y="48" text-anchor="middle" fill="#64748b" font-size="13" font-weight="600">Docker Host</text>
+
+      <!-- urbanops-server -->
+      <rect x="50" y="65" width="290" height="160" rx="12" fill="rgba(56,189,248,.08)" stroke="#38bdf8" stroke-width="2"/>
+      <text x="195" y="92" text-anchor="middle" fill="#38bdf8" font-size="14" font-weight="700">urbanops-server</text>
+      <text x="195" y="110" text-anchor="middle" fill="#8899aa" font-size="10">Eclipse Temurin 21 JRE</text>
+      <text x="195" y="126" text-anchor="middle" fill="#64748b" font-size="9">-Xms512m -Xmx512m</text>
+      <rect x="70" y="137" width="120" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/>
+      <text x="130" y="152" text-anchor="middle" fill="#8899aa" font-size="9">Port 48081</text>
+      <rect x="200" y="137" width="120" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/>
+      <text x="260" y="152" text-anchor="middle" fill="#8899aa" font-size="9">Actuator /actuator</text>
+      <rect x="70" y="165" width="250" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/>
+      <text x="195" y="180" text-anchor="middle" fill="#8899aa" font-size="9">包含所有业务模块 (fat JAR)</text>
+      <rect x="70" y="193" width="250" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/>
+      <text x="195" y="208" text-anchor="middle" fill="#8899aa" font-size="9">SpringDoc /v3/api-docs · Knife4j</text>
+
+      <!-- IoT Gateway -->
+      <rect x="370" y="65" width="260" height="160" rx="12" fill="rgba(239,68,68,.08)" stroke="#ef4444" stroke-width="2"/>
+      <text x="500" y="92" text-anchor="middle" fill="#f87171" font-size="14" font-weight="700">iot-gateway-server</text>
+      <text x="500" y="110" text-anchor="middle" fill="#8899aa" font-size="10">独立部署 · Vert.x 引擎</text>
+      <rect x="390" y="122" width="220" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/>
+      <text x="500" y="137" text-anchor="middle" fill="#8899aa" font-size="9">Port 8092</text>
+      <rect x="390" y="150" width="220" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/>
+      <text x="500" y="165" text-anchor="middle" fill="#8899aa" font-size="9">协议: MQTT · HTTP · TCP</text>
+      <rect x="390" y="178" width="220" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/>
+      <text x="500" y="193" text-anchor="middle" fill="#8899aa" font-size="9">设备接入 · 数据采集</text>
+      <rect x="390" y="206" width="220" height="22" rx="5" fill="rgba(255,255,255,.04)" stroke="#334155" stroke-width="0.8"/>
+      <text x="500" y="221" text-anchor="middle" fill="#8899aa" font-size="9">HTTP RPC → Server :48080</text>
+
+      <!-- MySQL -->
+      <rect x="660" y="65" width="180" height="72" rx="10" fill="rgba(59,130,246,.08)" stroke="#3b82f6" stroke-width="1.5"/>
+      <text x="750" y="92" text-anchor="middle" fill="#60a5fa" font-size="12" font-weight="600">MySQL 8</text>
+      <text x="750" y="110" text-anchor="middle" fill="#8899aa" font-size="9">:3306</text>
+      <text x="750" y="125" text-anchor="middle" fill="#64748b" font-size="8">主从读写分离</text>
+
+      <!-- Redis -->
+      <rect x="660" y="150" width="180" height="72" rx="10" fill="rgba(239,68,68,.08)" stroke="#ef4444" stroke-width="1.5"/>
+      <text x="750" y="177" text-anchor="middle" fill="#f87171" font-size="12" font-weight="600">Redis Sentinel</text>
+      <text x="750" y="195" text-anchor="middle" fill="#8899aa" font-size="9">:26379</text>
+      <text x="750" y="210" text-anchor="middle" fill="#64748b" font-size="8">高可用集群</text>
+
+      <!-- MQ -->
+      <rect x="860" y="65" width="110" height="72" rx="10" fill="rgba(52,211,153,.08)" stroke="#34d399" stroke-width="1.5"/>
+      <text x="915" y="92" text-anchor="middle" fill="#4ade80" font-size="11" font-weight="600">RocketMQ</text>
+      <text x="915" y="110" text-anchor="middle" fill="#8899aa" font-size="9">:9876</text>
+      <text x="915" y="125" text-anchor="middle" fill="#64748b" font-size="8">消息驱动</text>
+
+      <rect x="860" y="150" width="110" height="72" rx="10" fill="rgba(129,140,248,.08)" stroke="#818cf8" stroke-width="1.5"/>
+      <text x="915" y="177" text-anchor="middle" fill="#a5b4fc" font-size="11" font-weight="600">Kafka</text>
+      <text x="915" y="195" text-anchor="middle" fill="#8899aa" font-size="9">:9092</text>
+      <text x="915" y="210" text-anchor="middle" fill="#64748b" font-size="8">流式处理</text>
+
+      <!-- Frontend -->
+      <rect x="660" y="240" width="310" height="40" rx="10" fill="rgba(251,191,36,.08)" stroke="#fbbf24" stroke-width="1.5"/>
+      <text x="815" y="265" text-anchor="middle" fill="#fbbf24" font-size="11" font-weight="600">urbanops-admin (前端 Nginx) :8080</text>
+
+      <!-- Monitoring -->
+      <rect x="50" y="245" width="580" height="40" rx="10" fill="rgba(129,140,248,.06)" stroke="#6366f1" stroke-width="1.5"/>
+      <text x="340" y="270" text-anchor="middle" fill="#a5b4fc" font-size="11" font-weight="600">可观测性: SkyWalking Agent · Spring Boot Admin · OpenTracing · Actuator · 日志采集</text>
+
+      <!-- PF4J Plugins -->
+      <rect x="50" y="298" width="580" height="32" rx="8" fill="rgba(244,114,182,.06)" stroke="#f472b6" stroke-width="1" stroke-dasharray="5,3"/>
+      <text x="340" y="319" text-anchor="middle" fill="#f472b6" font-size="10">PF4J 插件目录: ../plugins (动态扩展)</text>
+
+      <!-- Labels -->
+      <rect x="50" y="350" width="12" height="12" rx="2" fill="rgba(56,189,248,.3)" stroke="#38bdf8" stroke-width="1"/>
+      <text x="68" y="360" fill="#64748b" font-size="9">fat JAR</text>
+      <rect x="140" y="350" width="12" height="12" rx="2" fill="rgba(239,68,68,.3)" stroke="#ef4444" stroke-width="1"/>
+      <text x="158" y="360" fill="#64748b" font-size="9">独立进程</text>
+      <rect x="240" y="350" width="12" height="12" rx="2" fill="rgba(59,130,246,.3)" stroke="#3b82f6" stroke-width="1"/>
+      <text x="258" y="360" fill="#64748b" font-size="9">数据服务</text>
+      <rect x="340" y="350" width="12" height="12" rx="2" fill="rgba(52,211,153,.3)" stroke="#34d399" stroke-width="1"/>
+      <text x="358" y="360" fill="#64748b" font-size="9">消息中间件</text>
+    </svg>
+  </div>
+</div>
+
+<!-- ==================== SLIDE 10: SUMMARY & ROADMAP ==================== -->
+<div class="slide" data-slide="9">
+  <h2>总结与架构演进</h2>
+  <div class="card-grid cols-2" style="max-width:1050px">
+    <div class="card">
+      <h3>当前架构优势</h3>
+      <ul>
+        <li>Maven 多模块清晰分层，业务边界明确</li>
+        <li>15 个框架 Starter 封装最佳实践</li>
+        <li>API 契约层实现模块间松耦合</li>
+        <li>IoT 网关已实现独立部署验证</li>
+        <li>多租户 + 数据权限完备</li>
+        <li>消息队列抽象层支持多中间件切换</li>
+      </ul>
+    </div>
+
+    <div class="card">
+      <h3>演进方向</h3>
+      <ul>
+        <li><strong>服务拆分</strong>: garden / workorder -> 独立微服务</li>
+        <li><strong>注册中心</strong>: 引入 Nacos 实现服务发现与配置管理</li>
+        <li><strong>API 网关</strong>: Spring Cloud Gateway 统一入口</li>
+        <li><strong>流量治理</strong>: Sentinel 限流熔断</li>
+        <li><strong>分布式事务</strong>: Seata 保障跨服务数据一致性</li>
+        <li><strong>容器编排</strong>: docker-compose -> Kubernetes</li>
+      </ul>
+    </div>
+
+    <div class="card" style="grid-column: 1 / -1">
+      <h3>目标微服务架构</h3>
+      <div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap;justify-content:center;margin-top:12px">
+        <span class="flow-box accent" style="font-size:.8em;padding:10px 16px">Nginx</span>
+        <span class="flow-arrow">→</span>
+        <span class="flow-box purple" style="font-size:.8em;padding:10px 16px">Gateway</span>
+        <span class="flow-arrow">→</span>
+        <span class="flow-box green" style="font-size:.8em;padding:10px 16px">Nacos</span>
+        <span class="flow-arrow">⇢</span>
+        <div style="display:flex;flex-direction:column;gap:6px">
+          <span class="tag blue">garden-service</span>
+          <span class="tag purple">workorder-service</span>
+          <span class="tag green">bpm-service</span>
+          <span class="tag pink">system-service</span>
+          <span class="tag yellow">iot-gateway (已有)</span>
+        </div>
+        <span class="flow-arrow">⇢</span>
+        <div style="display:flex;flex-direction:column;gap:6px">
+          <span class="tag red">Sentinel</span>
+          <span class="tag blue">Seata</span>
+          <span class="tag green">SkyWalking</span>
+        </div>
+      </div>
+    </div>
+
+    <div class="card" style="grid-column: 1 / -1; text-align:center">
+      <p style="font-size:1.1em;color:var(--text);margin-bottom:8px"><strong>关键原则</strong></p>
+      <p style="color:var(--text-dim)">
+        模块化先行 → API 契约驱动 → 渐进式拆分 → 独立部署验证 → 全链路可观测
+      </p>
+    </div>
+  </div>
+</div>
+
+</div>
+
+<!-- Navigation -->
+<div class="nav" id="nav">
+  <button onclick="prevSlide()" title="上一页">&#x2190;</button>
+  <span class="page-indicator" id="pageIndicator">1 / 10</span>
+  <button onclick="nextSlide()" title="下一页">&#x2192;</button>
+  <div class="progress" id="progress" style="width:10%"></div>
+</div>
+
+<script>
+let current = 0;
+const slides = document.querySelectorAll('.slide');
+const total = slides.length;
+const indicator = document.getElementById('pageIndicator');
+const progress = document.getElementById('progress');
+
+function showSlide(n) {
+  slides[current].classList.remove('active');
+  current = (n + total) % total;
+  slides[current].classList.add('active');
+  indicator.textContent = (current + 1) + ' / ' + total;
+  progress.style.width = ((current + 1) / total * 100) + '%';
+}
+
+function nextSlide() { showSlide(current + 1); }
+function prevSlide() { showSlide(current - 1); }
+
+document.addEventListener('keydown', e => {
+  if (e.key === 'ArrowRight' || e.key === 'ArrowDown' || e.key === ' ') {
+    e.preventDefault(); nextSlide();
+  } else if (e.key === 'ArrowLeft' || e.key === 'ArrowUp') {
+    e.preventDefault(); prevSlide();
+  } else if (e.key === 'Home') { e.preventDefault(); showSlide(0); }
+  else if (e.key === 'End') { e.preventDefault(); showSlide(total - 1); }
+});
+
+// Touch support
+let touchStartX = 0;
+document.addEventListener('touchstart', e => { touchStartX = e.touches[0].clientX; });
+document.addEventListener('touchend', e => {
+  const diff = touchStartX - e.changedTouches[0].clientX;
+  if (Math.abs(diff) > 50) { diff > 0 ? nextSlide() : prevSlide(); }
+});
+
+// Click on edges
+document.addEventListener('click', e => {
+  if (e.target.closest('.nav') || e.target.closest('a') || e.target.closest('button')) return;
+  if (e.clientX > window.innerWidth * 0.85) nextSlide();
+  else if (e.clientX < window.innerWidth * 0.15) prevSlide();
+});
+</script>
+</body>
+</html>
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>城市运营全域平台 · 技术架构分享</title>
+<link rel="stylesheet" href="ppt-assets/fonts.css">
+<link rel="stylesheet" href="ppt-assets/base.css">
+<link rel="stylesheet" href="ppt-assets/animations.css">
+<link rel="stylesheet" href="ppt-assets/style.css">
+<style>
+/* Override for 20+ slides */
+.tpl-tech-sharing .h1{font-size:68px;line-height:1.05}
+.tpl-tech-sharing .h2{font-size:46px}
+.tpl-tech-sharing .slide{padding:60px 80px}
+
+/* Architecture diagram layers */
+.arch-layers{margin-top:18px;display:grid;grid-template-rows:auto auto auto auto;gap:12px}
+.arch-layers .al{display:grid;grid-template-columns:110px 1fr;align-items:stretch;gap:12px}
+.arch-layers .al .al-name{display:flex;align-items:center;justify-content:center;background:var(--surface-2);border-radius:var(--radius);padding:12px 10px;font-family:'JetBrains Mono',monospace;font-size:11px;font-weight:600;color:var(--accent);text-align:center;border:1px solid var(--border)}
+.arch-layers .al .al-cells{display:grid;grid-template-columns:repeat(auto-fit,minmax(130px,1fr));gap:8px}
+.arch-layers .al .acell{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:12px 10px;text-align:center}
+.arch-layers .al .acell .aci{font-size:20px;margin-bottom:2px}
+.arch-layers .al .acell h4{font-size:13px;color:#fff;margin:3px 0 1px}
+.arch-layers .al .acell p{font-size:10px;color:var(--text-3);margin:0}
+.arch-layers .al.hl .acell{border-top:3px solid var(--accent);border-color:rgba(126,231,135,.35)}
+.arch-layers .al.fw .acell{border-top:3px solid var(--accent-2);border-color:rgba(121,192,255,.35)}
+
+/* Biz domain grid */
+.biz-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:12px;margin-top:16px}
+.biz-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:22px 18px}
+.biz-card .biz-icon{font-size:32px;margin-bottom:8px}
+.biz-card h4{font-size:17px;color:#fff;margin-bottom:6px}
+.biz-card p{font-size:12px;color:var(--text-2);line-height:1.6;margin:0}
+.biz-card .biz-tags{display:flex;flex-wrap:wrap;gap:5px;margin-top:10px}
+.biz-card .biz-tags span{font-family:'JetBrains Mono',monospace;font-size:10px;padding:2px 8px;border-radius:4px;background:var(--surface-2);color:var(--text-2);border:1px solid var(--border)}
+.biz-card.ac{border-top:3px solid var(--accent)}
+.biz-card.blue{border-top:3px solid var(--accent-2)}
+.biz-card.purple{border-top:3px solid #d2a8ff}
+
+/* Two column custom */
+.col2{display:grid;grid-template-columns:1fr 1fr;gap:20px;margin-top:16px}
+.col2 .box{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:22px}
+
+/* Flow steps */
+.flow-steps{display:flex;align-items:center;gap:8px;margin-top:18px}
+.flow-steps .fs{flex:1;background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:16px 12px;text-align:center}
+.flow-steps .fs .fs-icon{font-size:26px;margin-bottom:4px}
+.flow-steps .fs h4{font-size:13px;color:#fff;margin:3px 0}
+.flow-steps .fs p{font-size:10px;color:var(--text-3);margin:0}
+.flow-steps .fs-arr{color:var(--accent);font-size:20px;font-family:'JetBrains Mono',monospace;flex-shrink:0}
+.flow-steps .fs.hl{border-top:3px solid var(--accent)}
+
+/* Tech grid mini */
+.tg{display:grid;grid-template-columns:repeat(4,1fr);gap:10px;margin-top:14px}
+.tg .tgc{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:16px 12px;text-align:center}
+.tg .tgc .tgci{font-size:28px;margin-bottom:4px}
+.tg .tgc h4{font-size:14px;color:#fff;margin:4px 0}
+.tg .tgc .tgt{display:flex;flex-wrap:wrap;gap:4px;justify-content:center;margin-top:8px}
+.tg .tgc .tgt span{font-family:'JetBrains Mono',monospace;font-size:10px;padding:2px 7px;border-radius:4px;background:var(--surface-2);color:var(--text-2);border:1px solid var(--border)}
+
+/* Timeline */
+.timeline{margin-top:18px}
+.timeline .tl-item{display:grid;grid-template-columns:100px 1fr;gap:16px;padding:14px 0;border-bottom:1px dashed var(--border)}
+.timeline .tl-item .tl-phase{font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent);font-weight:600}
+.timeline .tl-item .tl-body h4{font-size:16px;color:#fff;margin:0 0 4px}
+.timeline .tl-item .tl-body p{font-size:12px;color:var(--text-2);margin:0}
+
+/* Framework grid */
+.fw-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:10px;margin-top:14px}
+.fw-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:16px 14px}
+.fw-card .fwi{font-size:22px;margin-bottom:6px}
+.fw-card h4{font-size:14px;color:#fff;margin:4px 0}
+.fw-card p{font-size:11px;color:var(--text-3);margin:0}
+.fw-card.hl{border-top:2px solid var(--accent-2)}
+
+/* Roadmap */
+.roadmap-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:16px;margin-top:16px}
+.roadmap-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:22px 18px}
+.roadmap-card .r-period{font-family:'JetBrains Mono',monospace;font-size:11px;color:var(--accent);font-weight:600;margin-bottom:8px}
+.roadmap-card h4{font-size:18px;color:#fff;margin-bottom:8px}
+.roadmap-card ul{margin:0;padding-left:16px;font-size:12px;color:var(--text-2);line-height:1.8}
+.roadmap-card.now{border-top:3px solid var(--accent)}
+.roadmap-card.next{border-top:3px solid var(--accent-2)}
+.roadmap-card.future{border-top:3px solid #d2a8ff}
+
+/* Stats row */
+.stats-row{display:grid;grid-template-columns:repeat(5,1fr);gap:12px;margin-top:16px}
+.stat-item{text-align:center;padding:18px 10px;background:var(--surface);border:1px solid var(--border);border-radius:var(--radius)}
+.stat-item .stat-num{font-size:38px;font-weight:800;color:var(--accent);font-family:'JetBrains Mono',monospace}
+.stat-item .stat-label{font-size:12px;color:var(--text-2);margin-top:4px}
+
+/* Invocation flow */
+.invoc-flow{display:flex;flex-direction:column;gap:10px;margin-top:14px}
+.invoc-flow .invoc-row{display:flex;align-items:center;gap:8px}
+.invoc-flow .invoc-row .ir-label{width:100px;text-align:right;font-family:'JetBrains Mono',monospace;font-size:11px;color:var(--accent);font-weight:600;flex-shrink:0}
+.invoc-flow .invoc-row .ir-items{display:flex;gap:6px;flex:1;flex-wrap:wrap}
+.invoc-flow .invoc-row .ir-items span{font-family:'JetBrains Mono',monospace;font-size:10px;padding:4px 10px;border-radius:5px;background:var(--surface-2);color:var(--text-2);border:1px solid var(--border)}
+.invoc-flow .ir-arrow{color:var(--text-3);font-size:16px;font-family:'JetBrains Mono',monospace;text-align:center;padding:2px 0}
+
+/* Deployment diagram */
+.deploy-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:12px;margin-top:16px}
+.deploy-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:20px 16px;text-align:center}
+.deploy-card .di{font-size:34px;margin-bottom:8px}
+.deploy-card h4{font-size:16px;color:#fff;margin-bottom:6px}
+.deploy-card ul{margin:0;padding:0;list-style:none;font-size:11px;color:var(--text-2);line-height:1.8}
+.deploy-card.ci{border-top:3px solid var(--accent)}
+.deploy-card.cn{border-top:3px solid var(--accent-2)}
+.deploy-card.mon{border-top:3px solid #d2a8ff}
+
+/* Full width code-like text */
+.code-text{font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--text-2);background:var(--surface-2);padding:8px 14px;border-radius:8px;border:1px solid var(--border);display:inline-block}
+</style>
+</head>
+<body class="tpl-tech-sharing">
+<div class="deck">
+
+  <!-- 1. Cover -->
+  <section class="slide" data-title="Cover">
+    <p class="kicker">urbanops · tech-sharing</p>
+    <h1 class="h1 anim-fade-up" data-anim="fade-up">城市运营全域平台<br><span style="background:var(--grad);-webkit-background-clip:text;background-clip:text;color:transparent">技术架构深度解析</span></h1>
+    <p class="lede mt-m">从业务架构到技术架构，从单体模块到微服务演进——一文讲透全域平台。</p>
+    <div class="speaker"><div class="av"></div><div><b>架构组</b><span>platform infra · 50 min + Q&amp;A</span></div></div>
+    <div class="deck-footer"><span class="mono">#spring-boot #smart-garden #urbanops #architecture</span><span class="slide-number" data-current="1" data-total="20"></span></div>
+  </section>
+
+  <!-- 2. Agenda -->
+  <section class="slide" data-title="Agenda">
+    <p class="kicker">agenda.yaml</p>
+    <h2 class="h2">今日路线图</h2>
+    <div class="stack mt-l">
+      <div class="agenda-row"><span class="num">01</span><span class="t">项目概述与业务背景</span><span class="d">~3min</span></div>
+      <div class="agenda-row"><span class="num">02</span><span class="t">业务架构全景与业务布局</span><span class="d">~8min</span></div>
+      <div class="agenda-row"><span class="num">03</span><span class="t">技术架构总览与分层设计</span><span class="d">~8min</span></div>
+      <div class="agenda-row"><span class="num">04</span><span class="t">核心技术栈与基础设施层</span><span class="d">~6min</span></div>
+      <div class="agenda-row"><span class="num">05</span><span class="t">数据存储与多数据库策略</span><span class="d">~5min</span></div>
+      <div class="agenda-row"><span class="num">06</span><span class="t">模块调用逻辑与通信机制</span><span class="d">~6min</span></div>
+      <div class="agenda-row"><span class="num">07</span><span class="t">安全权限与可观测性</span><span class="d">~5min</span></div>
+      <div class="agenda-row"><span class="num">08</span><span class="t">部署架构与后续规划</span><span class="d">~5min</span></div>
+      <div class="agenda-row"><span class="num">09</span><span class="t">总结 &amp; Q&amp;A</span><span class="d">~4min</span></div>
+    </div>
+  </section>
+
+  <!-- 3. Project Overview -->
+  <section class="slide" data-title="Project Overview">
+    <p class="kicker">// overview</p>
+    <h2 class="h2">UrbanOps 全域平台：<br>智慧城市运营管理底座</h2>
+    <p class="lede">基于 RuoYi-Vue-Pro 演进而来，面向城市园林绿化、工单调度、流程协同的综合运营管理平台。</p>
+    <div class="stats-row mt-l">
+      <div class="stat-item anim-fade-up" data-anim="fade-up"><div class="stat-num">17</div><div class="stat-label">Maven 模块</div></div>
+      <div class="stat-item anim-fade-up" data-anim="fade-up" style="animation-delay:.05s"><div class="stat-num">7</div><div class="stat-label">激活业务模块</div></div>
+      <div class="stat-item anim-fade-up" data-anim="fade-up" style="animation-delay:.1s"><div class="stat-num">10+</div><div class="stat-label">数据库支持</div></div>
+      <div class="stat-item anim-fade-up" data-anim="fade-up" style="animation-delay:.15s"><div class="stat-num">3.5.5</div><div class="stat-label">Spring Boot</div></div>
+      <div class="stat-item anim-fade-up" data-anim="fade-up" style="animation-delay:.2s"><div class="stat-num">MIT</div><div class="stat-label">开源协议</div></div>
+    </div>
+    <div class="col2 mt-l">
+      <div class="box" style="border-top:3px solid var(--accent)">
+        <h4 style="color:#fff;margin:0 0 8px">后端技术基石</h4>
+        <p class="dim" style="font-size:13px;line-height:1.7">Java 17 · Spring Boot 3.5.5 · MyBatis Plus 3.5.14 · Spring Security 6.x · Flowable 7.0 · Redisson 3.51 · SkyWalking 9.5 · RocketMQ · Vert.x + MQTT</p>
+      </div>
+      <div class="box" style="border-top:3px solid var(--accent-2)">
+        <h4 style="color:#fff;margin:0 0 8px">前端生态</h4>
+        <p class="dim" style="font-size:13px;line-height:1.7">Vue3 + element-plus 管理后台 · Vue3 + vben(ant-design-vue) 高级后台 · uni-app 移动端 · 大屏报表设计器 · 代码生成器一键生成前后端</p>
+      </div>
+    </div>
+  </section>
+
+  <!-- 4. Business Architecture Overview -->
+  <section class="slide" data-title="Business Architecture">
+    <p class="kicker">business · architecture</p>
+    <h2 class="h2">业务架构全景：<br>四大核心域 + 三大支撑域</h2>
+    <div class="biz-grid">
+      <div class="biz-card ac anim-fade-up" data-anim="fade-up">
+        <div class="biz-icon">🌳</div><h4>智慧园林管理</h4>
+        <p>树木资产管理、巡检计划、养护计划、绩效评估、物料出入库、机械成本核算</p>
+        <div class="biz-tags"><span>Garden</span><span>巡检</span><span>养护</span><span>绩效</span></div>
+      </div>
+      <div class="biz-card blue anim-fade-up" data-anim="fade-up" style="animation-delay:.05s">
+        <div class="biz-icon">📋</div><h4>工单调度系统</h4>
+        <p>事件上报、工单流转、物料明细、附件管理、地理位置编码、园林事件映射</p>
+        <div class="biz-tags"><span>Workorder</span><span>事件</span><span>物料</span></div>
+      </div>
+      <div class="biz-card purple anim-fade-up" data-anim="fade-up" style="animation-delay:.1s">
+        <div class="biz-icon">🔄</div><h4>工作流引擎</h4>
+        <p>Flowable 驱动，仿钉钉/飞书 + BPMN 双设计器，会签、或签、转办、委派、加签全覆盖</p>
+        <div class="biz-tags"><span>BPM</span><span>Flowable</span><span>审批</span></div>
+      </div>
+      <div class="biz-card ac anim-fade-up" data-anim="fade-up" style="animation-delay:.15s">
+        <div class="biz-icon">🌐</div><h4>全局业务管理</h4>
+        <p>问题上报、道路信息、工单提交详情、流程路径想法、跨模块数据聚合</p>
+        <div class="biz-tags"><span>Global</span><span>道路</span><span>问题</span></div>
+      </div>
+      <div class="biz-card blue anim-fade-up" data-anim="fade-up" style="animation-delay:.2s">
+        <div class="biz-icon">⚙️</div><h4>系统管理</h4>
+        <p>用户/角色/菜单/部门/岗位管理、租户与套餐、字典、通知公告、应用管理</p>
+        <div class="biz-tags"><span>System</span><span>RBAC</span><span>多租户</span></div>
+      </div>
+      <div class="biz-card purple anim-fade-up" data-anim="fade-up" style="animation-delay:.25s">
+        <div class="biz-icon">🏗️</div><h4>基础设施</h4>
+        <p>代码生成、文件存储、定时任务、配置管理、消息队列、API 日志、监控追踪</p>
+        <div class="biz-tags"><span>Infra</span><span>代码生成</span><span>监控</span></div>
+      </div>
+    </div>
+  </section>
+
+  <!-- 5. Business Layout - Garden -->
+  <section class="slide" data-title="Business · Garden">
+    <p class="kicker">garden · smart-greening</p>
+    <h2 class="h2">核心业务：智慧园林管理</h2>
+    <p class="lede">覆盖园林绿化全生命周期——从资产登记到巡检养护，从绩效评估到成本核算。</p>
+    <div class="arch-layers">
+      <div class="al hl"><div class="al-name">管理端</div>
+        <div class="al-cells">
+          <div class="acell"><div class="aci">🌲</div><h4>树木资产管理</h4><p>古树名木 / 变更日志</p></div>
+          <div class="acell"><div class="aci">📅</div><h4>巡检计划管理</h4><p>计划制定 / 明细配置</p></div>
+          <div class="acell"><div class="aci">🔧</div><h4>养护计划管理</h4><p>养护任务 / 执行跟踪</p></div>
+          <div class="acell"><div class="aci">📊</div><h4>绩效管理</h4><p>指标定义 / 专家评定</p></div>
+          <div class="acell"><div class="aci">📦</div><h4>物料管理</h4><p>物料类型 / 出入库</p></div>
+          <div class="acell"><div class="aci">💰</div><h4>机械成本</h4><p>折旧 / 租赁核算</p></div>
+        </div>
+      </div>
+      <div class="al fw"><div class="al-name">移动端</div>
+        <div class="al-cells" style="grid-template-columns:repeat(5,1fr)">
+          <div class="acell"><div class="aci">📱</div><h4>首页概览</h4><p>数据汇总</p></div>
+          <div class="acell"><div class="aci">📍</div><h4>GPS 定位</h4><p>位置上报</p></div>
+          <div class="acell"><div class="aci">✅</div><h4>巡检提交</h4><p>现场打卡</p></div>
+          <div class="acell"><div class="aci">🛠️</div><h4>养护提交</h4><p>任务执行</p></div>
+          <div class="acell"><div class="aci">📝</div><h4>变更记录</h4><p>树木变更</p></div>
+        </div>
+      </div>
+    </div>
+    <div class="grid g4 mt-m">
+      <div class="card card-accent"><h4>定时任务</h4><p class="dim">自动生成巡检/养护计划</p></div>
+      <div class="card card-accent"><h4>数据权限</h4><p class="dim">按区域隔离园林数据</p></div>
+      <div class="card card-accent"><h4>时间区间</h4><p class="dim">灵活配置任务执行周期</p></div>
+      <div class="card card-accent"><h4>防重复提交</h4><p class="dim">计划明细幂等性保证</p></div>
+    </div>
+  </section>
+
+  <!-- 6. Business Layout - Work Order -->
+  <section class="slide" data-title="Business · Workorder">
+    <p class="kicker">workorder · dispatch</p>
+    <h2 class="h2">工单调度：事件驱动 + 流程闭环</h2>
+    <div class="col2">
+      <div>
+        <div class="card card-accent" style="padding:22px">
+          <h4 style="color:#fff;margin:0 0 12px">工单核心实体模型</h4>
+          <div class="stack">
+            <div class="tag">📋 MainInfo — 工单主信息</div>
+            <div class="tag">📎 Attachment — 附件管理</div>
+            <div class="tag">📦 MaterialDetail — 物料明细</div>
+            <div class="tag">🎯 EventInfo — 事件信息</div>
+            <div class="tag">🔗 EventMappingInfo — 事件映射</div>
+            <div class="tag">🌳 GardenRef — 园林业务关联</div>
+          </div>
+        </div>
+      </div>
+      <div>
+        <div class="card" style="padding:22px;border-top:3px solid var(--accent-2)">
+          <h4 style="color:#fff;margin:0 0 12px">工单处理流程</h4>
+          <div class="flow-steps" style="flex-direction:column;gap:8px">
+            <div style="display:flex;align-items:center;gap:8px">
+              <div class="fs" style="flex:1"><div class="fs-icon">📝</div><h4>事件上报</h4></div>
+              <span class="fs-arr">→</span>
+              <div class="fs" style="flex:1"><div class="fs-icon">🔍</div><h4>工单生成</h4></div>
+              <span class="fs-arr">→</span>
+              <div class="fs hl" style="flex:1"><div class="fs-icon">👤</div><h4>人员指派</h4></div>
+            </div>
+            <div style="display:flex;align-items:center;gap:8px">
+              <div class="fs" style="flex:1"><div class="fs-icon">🔧</div><h4>现场处理</h4></div>
+              <span class="fs-arr">→</span>
+              <div class="fs" style="flex:1"><div class="fs-icon">📋</div><h4>结果反馈</h4></div>
+              <span class="fs-arr">→</span>
+              <div class="fs" style="flex:1"><div class="fs-icon">✅</div><h4>审核结单</h4></div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div class="code-text mt-m">WorkorderModule → GardenModule (Feign API) · EventMapping 策略 · GeoCode 位置服务 · 数据权限隔离</div>
+  </section>
+
+  <!-- 7. Business Layout - BPM -->
+  <section class="slide" data-title="Business · BPM">
+    <p class="kicker">bpm · flowable-engine</p>
+    <h2 class="h2">工作流引擎：同时支持<br>「轻量配置」与「深度编排」</h2>
+    <div class="grid g2 mt-l" style="align-items:start">
+      <div>
+        <div class="card card-accent" style="padding:22px">
+          <h4 style="color:var(--accent);font-family:'JetBrains Mono',monospace;font-size:13px">SIMPLE 设计器</h4>
+          <p class="dim" style="font-size:13px">仿钉钉/飞书体验，拖拽搭建表单流程，10 分钟完成配置</p>
+          <div class="stack mt-s">
+            <div class="tag">✦ 拖拽式表单设计</div>
+            <div class="tag">✦ 审批节点可视化配置</div>
+            <div class="tag">✦ 抄送人 / 条件分支</div>
+            <div class="tag">✦ 超时审批 / 自动提醒</div>
+          </div>
+        </div>
+      </div>
+      <div>
+        <div class="card" style="padding:22px;border-top:3px solid #d2a8ff">
+          <h4 style="color:#d2a8ff;font-family:'JetBrains Mono',monospace;font-size:13px">BPMN 设计器</h4>
+          <p class="dim" style="font-size:13px">基于 BPMN 2.0 标准，适配复杂多层级审批及自动化场景</p>
+          <div class="stack mt-s">
+            <div class="tag">✦ 会签 / 或签 / 依次审批</div>
+            <div class="tag">✦ 转办 / 委派 / 加签 / 减签</div>
+            <div class="tag">✦ 并行 / 包容 / 路由分支</div>
+            <div class="tag">✦ 父子流程 / 触发节点</div>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div class="grid g3 mt-m">
+      <div class="card"><h4 style="color:#fff;font-size:14px">Flowable 7.0</h4><p class="dim">核心流程引擎</p></div>
+      <div class="card"><h4 style="color:#fff;font-size:14px">信创数据库兼容</h4><p class="dim">DM8 / KingBase / OpenGauss</p></div>
+      <div class="card"><h4 style="color:#fff;font-size:14px">动态表单</h4><p class="dim">节点级只读/编辑/隐藏权限</p></div>
+    </div>
+  </section>
+
+  <!-- 8. Business Layout - Global & System -->
+  <section class="slide" data-title="Business · Global & System">
+    <p class="kicker">global · system · infra</p>
+    <h2 class="h2">业务支撑域：<br>公共服务与系统管理</h2>
+    <div class="grid g2 mt-l" style="align-items:start;gap:20px">
+      <div>
+        <h4 style="color:var(--accent-2);font-family:'JetBrains Mono',monospace;font-size:13px;margin-bottom:12px">🌐 Global 全局模块</h4>
+        <div class="stack">
+          <div class="card card-accent" style="padding:14px 16px"><h4 style="font-size:14px">问题上报管理</h4><p class="dim" style="font-size:11px">公共问题发现 → 流转到工单系统</p></div>
+          <div class="card card-accent" style="padding:14px 16px"><h4 style="font-size:14px">道路信息管理</h4><p class="dim" style="font-size:11px">道路基础数据维护</p></div>
+          <div class="card card-accent" style="padding:14px 16px"><h4 style="font-size:14px">工单提交详情</h4><p class="dim" style="font-size:11px">跨模块工单数据聚合视图</p></div>
+          <div class="card card-accent" style="padding:14px 16px"><h4 style="font-size:14px">流程路径想法</h4><p class="dim" style="font-size:11px">流程优化建议收集</p></div>
+        </div>
+      </div>
+      <div>
+        <h4 style="color:#d2a8ff;font-family:'JetBrains Mono',monospace;font-size:13px;margin-bottom:12px">⚙️ System + Infra 模块</h4>
+        <div class="stack">
+          <div class="card" style="padding:14px 16px;border-top:2px solid var(--accent-2)"><h4 style="font-size:14px">RBAC 权限体系</h4><p class="dim" style="font-size:11px">用户 → 角色 → 菜单 → 按钮权限 · 数据权限</p></div>
+          <div class="card" style="padding:14px 16px;border-top:2px solid var(--accent-2)"><h4 style="font-size:14px">SaaS 多租户</h4><p class="dim" style="font-size:11px">租户管理 · 套餐配置 · 数据隔离 · 透明化封装</p></div>
+          <div class="card" style="padding:14px 16px;border-top:2px solid var(--accent-2)"><h4 style="font-size:14px">代码生成器</h4><p class="dim" style="font-size:11px">一键生成 Java · Vue · SQL · 接口文档</p></div>
+          <div class="card" style="padding:14px 16px;border-top:2px solid var(--accent-2)"><h4 style="font-size:14px">消息通知中心</h4><p class="dim" style="font-size:11px">短信 · 邮件 · 站内信 · 多通道</p></div>
+        </div>
+      </div>
+    </div>
+  </section>
+
+  <!-- 9. Tech Architecture Overview -->
+  <section class="slide" data-title="Tech Architecture">
+    <p class="kicker">architecture · layers</p>
+    <h2 class="h2">技术架构五层模型</h2>
+    <p class="lede">从用户端到底层基础设施，清晰分层、逐级解耦。</p>
+    <div class="arch-layers anim-stagger-list" data-anim-target>
+      <div class="al fw">
+        <div class="al-name" style="color:var(--accent-2)">接入层</div>
+        <div class="al-cells" style="grid-template-columns:repeat(4,1fr)">
+          <div class="acell"><div class="aci">🖥️</div><h4>Web Admin</h4><p>Vue3 + Element Plus</p></div>
+          <div class="acell"><div class="aci">📱</div><h4>Mobile App</h4><p>uni-app 跨端</p></div>
+          <div class="acell"><div class="aci">📊</div><h4>大屏展示</h4><p>GoView 可视化</p></div>
+          <div class="acell"><div class="aci">🔗</div><h4>开放 API</h4><p>第三方对接</p></div>
+        </div>
+      </div>
+      <div class="al fw" style="grid-template-columns:110px 1fr">
+        <div class="al-name" style="color:var(--accent-2)">网关层</div>
+        <div class="al-cells" style="grid-template-columns:repeat(4,1fr)">
+          <div class="acell"><div class="aci">🔐</div><h4>认证鉴权</h4><p>Spring Security + Token</p></div>
+          <div class="acell"><div class="aci">🚪</div><h4>路由转发</h4><p>Nginx / Gateway</p></div>
+          <div class="acell"><div class="aci">⚖️</div><h4>负载均衡</h4><p>多实例分发</p></div>
+          <div class="acell"><div class="aci">🛡️</div><h4>安全防护</h4><p>XSS / CSRF / SQL注入</p></div>
+        </div>
+      </div>
+      <div class="al hl">
+        <div class="al-name">服务层</div>
+        <div class="al-cells" style="grid-template-columns:repeat(6,1fr)">
+          <div class="acell"><div class="aci">🌳</div><h4>Garden</h4><p>园林管理</p></div>
+          <div class="acell"><div class="aci">📋</div><h4>Workorder</h4><p>工单调度</p></div>
+          <div class="acell"><div class="aci">🔄</div><h4>BPM</h4><p>工作流</p></div>
+          <div class="acell"><div class="aci">🌐</div><h4>Global</h4><p>全局服务</p></div>
+          <div class="acell"><div class="aci">⚙️</div><h4>System</h4><p>系统管理</p></div>
+          <div class="acell"><div class="aci">🏗️</div><h4>Infra</h4><p>基础设施</p></div>
+        </div>
+      </div>
+      <div class="al">
+        <div class="al-name">中间件</div>
+        <div class="al-cells" style="grid-template-columns:repeat(5,1fr)">
+          <div class="acell"><div class="aci">🗄️</div><h4>MySQL</h4><p>OLTP</p></div>
+          <div class="acell"><div class="aci">⚡</div><h4>Redis</h4><p>缓存/锁</p></div>
+          <div class="acell"><div class="aci">📨</div><h4>RocketMQ</h4><p>消息队列</p></div>
+          <div class="acell"><div class="aci">🔍</div><h4>Elasticsearch</h4><p>全文检索</p></div>
+          <div class="acell"><div class="aci">📡</div><h4>TDengine</h4><p>时序数据</p></div>
+        </div>
+      </div>
+    </div>
+  </section>
+
+  <!-- 10. Backend Layered Architecture -->
+  <section class="slide" data-title="Backend Architecture">
+    <p class="kicker">backend · layered</p>
+    <h2 class="h2">后端分层架构：<br>Controller → Service → DAL 三层解耦</h2>
+    <div class="grid g2 mt-l" style="align-items:start;gap:20px">
+      <div>
+        <div class="stack">
+          <div class="card card-accent" style="padding:16px">
+            <h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent)">controller/</h4>
+            <p class="dim" style="font-size:12px;margin-bottom:6px">接收请求、参数校验、VO 转换</p>
+            <div class="biz-tags"><span>admin/</span><span>app/</span><span>VO 对象</span><span>@Valid</span></div>
+          </div>
+          <div class="card card-accent" style="padding:16px">
+            <h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent)">service/</h4>
+            <p class="dim" style="font-size:12px;margin-bottom:6px">业务逻辑编排、事务管理、策略模式</p>
+            <div class="biz-tags"><span>接口+实现</span><span>@Transactional</span><span>策略</span><span>Listener</span></div>
+          </div>
+          <div class="card card-accent" style="padding:16px">
+            <h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent)">dal/</h4>
+            <p class="dim" style="font-size:12px;margin-bottom:6px">数据访问层：MySQL Mapper + Redis Cache</p>
+            <div class="biz-tags"><span>mysql/</span><span>redis/</span><span>dataobject/</span></div>
+          </div>
+        </div>
+      </div>
+      <div>
+        <div class="stack">
+          <div class="card" style="padding:16px;border-top:2px solid var(--accent-2)">
+            <h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent-2)">convert/</h4>
+            <p class="dim" style="font-size:12px">MapStruct 对象转换层，编译期生成高性能映射代码</p>
+          </div>
+          <div class="card" style="padding:16px;border-top:2px solid var(--accent-2)">
+            <h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent-2)">api/</h4>
+            <p class="dim" style="font-size:12px">模块间 Feign 接口定义 + DTO，实现跨模块调用</p>
+          </div>
+          <div class="card" style="padding:16px;border-top:2px solid var(--accent-2)">
+            <h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent-2)">mq/ + job/</h4>
+            <p class="dim" style="font-size:12px">异步消息（producer/consumer）+ 定时任务调度</p>
+          </div>
+          <div class="card" style="padding:16px;border-top:2px solid var(--accent-2)">
+            <h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent-2)">framework/</h4>
+            <p class="dim" style="font-size:12px">模块内框架代码：数据权限配置、Web 配置、操作日志等</p>
+          </div>
+        </div>
+      </div>
+    </div>
+  </section>
+
+  <!-- 11. Framework Infrastructure -->
+  <section class="slide" data-title="Framework Infrastructure">
+    <p class="kicker">framework · starters</p>
+    <h2 class="h2">基础设施层：<br>15 个 Spring Boot Starter</h2>
+    <p class="lede">将通用能力抽象为可复用的 Starter 组件，所有业务模块按需引入。</p>
+    <div class="fw-grid">
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up"><div class="fwi">🌐</div><h4>web</h4><p>全局异常处理 · 统一返回 · CORS · Swagger</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.05s"><div class="fwi">🔐</div><h4>security</h4><p>Spring Security · Token 鉴权 · SSO</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.1s"><div class="fwi">🗄️</div><h4>mybatis</h4><p>MyBatis Plus · 多数据源 · 联表查询</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.15s"><div class="fwi">⚡</div><h4>redis</h4><p>Redisson · 分布式锁 · 缓存策略</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.2s"><div class="fwi">📨</div><h4>mq</h4><p>RocketMQ 集成 · 消息幂等 · 重试</p></div>
+      <div class="fw-card hl anim-fade-up" data-anim="fade-up" style="animation-delay:.25s"><div class="fwi">🛡️</div><h4>protection</h4><p>分布式锁 · 幂等 · 限流 · 熔断</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.3s"><div class="fwi">📊</div><h4>monitor</h4><p>SkyWalking · Admin · 日志中心</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.35s"><div class="fwi">⏰</div><h4>job</h4><p>Quartz 定时任务 · 执行日志</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.4s"><div class="fwi">📝</div><h4>excel</h4><p>FastExcel 导入导出</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.45s"><div class="fwi">🔌</div><h4>websocket</h4><p>实时通信 · Token 校验 · 集群</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.5s"><div class="fwi">🏢</div><h4>biz-tenant</h4><p>多租户数据隔离 · 透明封装</p></div>
+      <div class="fw-card anim-fade-up" data-anim="fade-up" style="animation-delay:.55s"><div class="fwi">🔒</div><h4>biz-data-permission</h4><p>数据权限 · 行级过滤</p></div>
+    </div>
+  </section>
+
+  <!-- 12. Core Tech Stack -->
+  <section class="slide" data-title="Tech Stack">
+    <p class="kicker">tech-stack · ecosystem</p>
+    <h2 class="h2">核心技术栈全景</h2>
+    <div class="tg">
+      <div class="tgc anim-fade-up" data-anim="fade-up"><div class="tgci">☕</div><h4>核心框架</h4><div class="tgt"><span>Spring Boot 3.5.5</span><span>Spring MVC 6.x</span><span>Spring Security 6.x</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.05s"><div class="tgci">🗄️</div><h4>持久层</h4><div class="tgt"><span>MyBatis Plus 3.5.14</span><span>Druid 1.2.27</span><span>Dynamic-DS 4.3.1</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.1s"><div class="tgci">⚡</div><h4>缓存 & 锁</h4><div class="tgt"><span>Redis 7.x</span><span>Redisson 3.51</span><span>Lock4j 2.2.7</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.15s"><div class="tgci">📨</div><h4>消息队列</h4><div class="tgt"><span>RocketMQ</span><span>Spring-RocketMQ</span><span>Redis Stream</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.2s"><div class="tgci">🔄</div><h4>工作流</h4><div class="tgt"><span>Flowable 7.0.1</span><span>BPMN 2.0</span><span>SIMPLE 设计器</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.25s"><div class="tgci">📡</div><h4>IoT & 通信</h4><div class="tgt"><span>Vert.x 4.5.13</span><span>Netty 4.2.4</span><span>MQTT 1.2.5</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.3s"><div class="tgci">🔍</div><h4>可观测性</h4><div class="tgt"><span>SkyWalking 9.5</span><span>Admin 3.5.2</span><span>OpenTracing</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.35s"><div class="tgci">📋</div><h4>API 文档</h4><div class="tgt"><span>Springdoc 2.8.11</span><span>Knife4j 4.5.0</span><span>Swagger 3</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.4s"><div class="tgci">🔌</div><h4>插件 & 工具</h4><div class="tgt"><span>PF4J 0.9.0</span><span>MapStruct 1.6.3</span><span>Hutool 5.8+6.0</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.45s"><div class="tgci">🧪</div><h4>测试</h4><div class="tgt"><span>JUnit 5</span><span>Mockito 5.x</span><span>Jedis-Mock</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.5s"><div class="tgci">🗄️</div><h4>多数据库</h4><div class="tgt"><span>MySQL 8.x</span><span>DM8</span><span>KingBase</span><span>OpenGauss</span></div></div>
+      <div class="tgc anim-fade-up" data-anim="fade-up" style="animation-delay:.55s"><div class="tgci">🐳</div><h4>部署运维</h4><div class="tgt"><span>Docker</span><span>K8s</span><span>Jenkins</span><span>Harbor</span></div></div>
+    </div>
+  </section>
+
+  <!-- 13. Data Storage Strategy -->
+  <section class="slide" data-title="Data Storage">
+    <p class="kicker">database · strategy</p>
+    <h2 class="h2">数据存储策略：<br>多数据源 + 多数据库 + 读写分离</h2>
+    <div class="grid g2 mt-l" style="align-items:start;gap:20px">
+      <div>
+        <div class="card card-accent" style="padding:22px">
+          <h4 style="font-family:'JetBrains Mono',monospace;font-size:14px;color:var(--accent)">Dynamic-Datasource 多数据源</h4>
+          <div class="stack mt-m">
+            <div class="tag"><span style="color:var(--accent)">●</span> 一主多从读写分离</div>
+            <div class="tag"><span style="color:var(--accent)">●</span> @DS 注解切换数据源</div>
+            <div class="tag"><span style="color:var(--accent)">●</span> 多库事务（本地事务 + 补偿）</div>
+            <div class="tag"><span style="color:var(--accent)">●</span> Druid 连接池监控</div>
+          </div>
+        </div>
+        <div class="card" style="padding:22px;border-top:3px solid var(--accent-2);margin-top:12px">
+          <h4 style="font-family:'JetBrains Mono',monospace;font-size:14px;color:var(--accent-2)">Redis 缓存体系</h4>
+          <div class="stack mt-m">
+            <div class="tag">○ Redisson 分布式锁 · 幂等键</div>
+            <div class="tag">○ Redis Stream 轻量 MQ</div>
+            <div class="tag">○ 菜单/字典/租户权限缓存</div>
+            <div class="tag">○ Token 存储 & 在线用户管理</div>
+          </div>
+        </div>
+      </div>
+      <div>
+        <div class="card" style="padding:22px;border-top:3px solid #d2a8ff">
+          <h4 style="font-family:'JetBrains Mono',monospace;font-size:14px;color:#d2a8ff">多数据库兼容矩阵</h4>
+          <div class="stack mt-m">
+            <div class="tag"><span style="color:#d2a8ff">■</span> MySQL 5.7 / 8.0+ — 主力库</div>
+            <div class="tag"><span style="color:#d2a8ff">■</span> 达梦 DM8 — 国产信创</div>
+            <div class="tag"><span style="color:#d2a8ff">■</span> 人大金仓 KingBase 8.6 — 信创</div>
+            <div class="tag"><span style="color:#d2a8ff">■</span> OpenGauss 5.1 — 华为开源</div>
+            <div class="tag"><span style="color:#d2a8ff">■</span> Oracle / PostgreSQL / SQL Server</div>
+            <div class="tag"><span style="color:#d2a8ff">■</span> TDengine 3.7 — IoT 时序数据</div>
+          </div>
+        </div>
+        <div class="card card-accent" style="padding:22px;margin-top:12px">
+          <h4 style="font-size:14px;color:#fff">数据隔离策略</h4>
+          <p class="dim" style="font-size:12px">SaaS 多租户：共享数据表 + tenant_id 字段隔离，biz-tenant Starter 透明拦截 SQL，自动添加租户条件</p>
+        </div>
+      </div>
+    </div>
+  </section>
+
+  <!-- 14. Module Invocation Logic -->
+  <section class="slide" data-title="Invocation Logic">
+    <p class="kicker">invocation · communication</p>
+    <h2 class="h2">模块调用逻辑：<br>三种通信通道</h2>
+    <div class="invoc-flow mt-l">
+      <div class="invoc-row">
+        <div class="ir-label" style="color:var(--accent)">Feign API</div>
+        <div class="ir-items"><span>System → Dept API</span><span>System → User API</span><span>System → Dict API</span><span>Workorder → Garden API</span><span>Garden → System API</span></div>
+      </div>
+      <div class="ir-arrow">▼ 同步调用 · 模块间 RPC · 请求/响应模式 ▼</div>
+      <div class="invoc-row">
+        <div class="ir-label" style="color:var(--accent-2)">MQ 消息</div>
+        <div class="ir-items"><span>SMS Producer → Consumer</span><span>Mail Producer → Consumer</span><span>Event → 多消费者</span><span>RocketMQ Topic</span><span>Redis Stream</span></div>
+      </div>
+      <div class="ir-arrow">▼ 异步解耦 · 事件驱动 · 最终一致性 ▼</div>
+      <div class="invoc-row">
+        <div class="ir-label" style="color:#d2a8ff">直接依赖</div>
+        <div class="ir-items"><span>Server → All Modules</span><span>Workorder → Garden Service</span><span>BPM → System User</span><span>Garden → Infra File</span></div>
+      </div>
+    </div>
+    <div class="grid g3 mt-l">
+      <div class="card card-accent"><h4 style="font-size:14px">api/ 包设计</h4><p class="dim" style="font-size:12px">每个模块暴露 Feign 接口 + DTO，其他模块引入依赖即可调用，编译期类型安全。</p></div>
+      <div class="card card-accent"><h4 style="font-size:14px">mq/ 包设计</h4><p class="dim" style="font-size:12px">Producer 发送消息，Consumer 消费处理。SMS / Mail 异步发送，不解耦主流程。</p></div>
+      <div class="card card-accent"><h4 style="font-size:14px">service/ 直接注入</h4><p class="dim" style="font-size:12px">同模块内 Service 互相注入。跨模块通过 api 包或直接依赖。</p></div>
+    </div>
+  </section>
+
+  <!-- 15. Message & Async -->
+  <section class="slide" data-title="Message & Async">
+    <p class="kicker">async · event-driven</p>
+    <h2 class="h2">异步消息与事件驱动</h2>
+    <div class="col2">
+      <div>
+        <div class="card card-accent" style="padding:20px">
+          <h4 style="color:#fff;margin:0 0 10px">RocketMQ 消息架构</h4>
+          <div class="stack">
+            <div class="tag">📤 Producer: 业务服务发送消息到 Topic</div>
+            <div class="tag">📥 Consumer: 独立消费组拉取并处理</div>
+            <div class="tag">🔄 重试机制: 消费失败自动重试</div>
+            <div class="tag">⚡ 顺序消息: 全局/分区有序</div>
+            <div class="tag">🔒 事务消息: 分布式事务最终一致性</div>
+          </div>
+        </div>
+      </div>
+      <div>
+        <div class="card" style="padding:20px;border-top:3px solid var(--accent-2)">
+          <h4 style="color:#fff;margin:0 0 10px">典型异步场景</h4>
+          <div class="stack">
+            <div class="tag">📧 SMS 发送 → MQ 异步 → 消费者推送</div>
+            <div class="tag">📨 邮件发送 → MQ 异步 → 消费者投递</div>
+            <div class="tag">🔔 站内信通知 → Redis Stream 广播</div>
+            <div class="tag">📋 操作日志 → 异步记录不影响主流程</div>
+            <div class="tag">🔄 工单事件 → MQ 通知园林模块更新</div>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div class="grid g2 mt-m">
+      <div class="card card-accent"><h4 style="font-size:14px">定时任务 (Quartz)</h4><p class="dim" style="font-size:12px">巡检计划自动生成 · 养护计划定时创建 · 数据统计报表 · 超时任务自动处理</p></div>
+      <div class="card card-accent"><h4 style="font-size:14px">服务保障 (Protection)</h4><p class="dim" style="font-size:12px">@Lock4j 分布式锁防并发 · @Idempotent 幂等性 · @RateLimiter 限流保护 · 熔断降级</p></div>
+    </div>
+  </section>
+
+  <!-- 16. Security & Auth -->
+  <section class="slide" data-title="Security & Auth">
+    <p class="kicker">security · auth · tenant</p>
+    <h2 class="h2">安全与权限体系</h2>
+    <div class="grid g3 mt-l">
+      <div class="card card-accent anim-fade-up" data-anim="fade-up" style="padding:22px">
+        <h4 style="color:#fff;margin-bottom:8px">🔐 认证体系</h4>
+        <ul style="font-size:12px;color:var(--text-2);padding-left:16px;line-height:1.8;margin:0">
+          <li>Spring Security 6.x 核心</li>
+          <li>Token + Redis 无状态会话</li>
+          <li>OAuth2 授权码模式</li>
+          <li>多终端（Web / App / 小程序）</li>
+          <li>SSO 单点登录</li>
+          <li>社交登录（JustAuth）</li>
+        </ul>
+      </div>
+      <div class="card card-accent anim-fade-up" data-anim="fade-up" style="padding:22px;animation-delay:.1s">
+        <h4 style="color:#fff;margin-bottom:8px">🛡️ 授权体系</h4>
+        <ul style="font-size:12px;color:var(--text-2);padding-left:16px;line-height:1.8;margin:0">
+          <li>RBAC：用户 → 角色 → 菜单</li>
+          <li>按钮级别权限控制</li>
+          <li>动态菜单加载</li>
+          <li>Redis 缓存权限信息</li>
+          <li>数据权限：行级过滤</li>
+          <li>部门数据范围隔离</li>
+        </ul>
+      </div>
+      <div class="card card-accent anim-fade-up" data-anim="fade-up" style="padding:22px;animation-delay:.2s">
+        <h4 style="color:#fff;margin-bottom:8px">🏢 多租户</h4>
+        <ul style="font-size:12px;color:var(--text-2);padding-left:16px;line-height:1.8;margin:0">
+          <li>tenant_id 字段隔离</li>
+          <li>MyBatis 拦截器自动注入</li>
+          <li>租户套餐权限定制</li>
+          <li>每个租户独立菜单/角色</li>
+          <li>透明化封装无侵入</li>
+          <li>支持租户禁用/过期</li>
+        </ul>
+      </div>
+    </div>
+    <div class="code-text mt-l">SystemModule → Security Starter → Token + Redis → @PreAuthorize → DataPermission AOP → SQL Interceptor</div>
+  </section>
+
+  <!-- 17. Observability -->
+  <section class="slide" data-title="Observability">
+    <p class="kicker">observability · monitoring</p>
+    <h2 class="h2">可观测性与监控体系</h2>
+    <div class="grid g3 mt-l">
+      <div class="card" style="padding:22px;border-top:3px solid var(--accent)">
+        <h4 style="color:#fff;font-size:16px;margin-bottom:8px">📝 日志体系</h4>
+        <p class="dim" style="font-size:12px;line-height:1.7">Logback + SkyWalking Logback Appender，TraceId 自动注入，一键关联链路</p>
+        <div class="biz-tags mt-s"><span>操作日志</span><span>登录日志</span><span>API 访问日志</span><span>错误日志</span></div>
+      </div>
+      <div class="card" style="padding:22px;border-top:3px solid var(--accent-2)">
+        <h4 style="color:#fff;font-size:16px;margin-bottom:8px">📊 指标监控</h4>
+        <p class="dim" style="font-size:12px;line-height:1.7">Spring Boot Admin 应用监控 + Druid SQL 监控 + Redis 监控面板</p>
+        <div class="biz-tags mt-s"><span>JVM 指标</span><span>连接池</span><span>QPS/RT</span><span>慢 SQL</span></div>
+      </div>
+      <div class="card" style="padding:22px;border-top:3px solid #d2a8ff">
+        <h4 style="color:#fff;font-size:16px;margin-bottom:8px">🔍 链路追踪</h4>
+        <p class="dim" style="font-size:12px;line-height:1.7">Apache SkyWalking 9.5 分布式追踪，服务拓扑自动发现</p>
+        <div class="biz-tags mt-s"><span>调用链</span><span>拓扑图</span><span>慢端点</span><span>告警</span></div>
+      </div>
+    </div>
+    <div class="grid g2 mt-m">
+      <div class="card card-accent"><h4 style="font-size:14px">Monitor Starter 集成</h4><p class="dim" style="font-size:12px">SkyWalking · Admin Client · OpenTracing · 日志中心 · 一键接入</p></div>
+      <div class="card card-accent"><h4 style="font-size:14px">保护机制</h4><p class="dim" style="font-size:12px">分布式锁 (Lock4j) · 幂等性保证 · 限流降级 · 异常全局处理 · 错误码统一管理</p></div>
+    </div>
+  </section>
+
+  <!-- 18. Deployment Architecture -->
+  <section class="slide" data-title="Deployment Architecture">
+    <p class="kicker">deployment · ci-cd</p>
+    <h2 class="h2">部署架构与 CI/CD 流水线</h2>
+    <div class="deploy-grid mt-l">
+      <div class="deploy-card ci anim-fade-up" data-anim="fade-up">
+        <div class="di">🚀</div><h4>CI 持续集成</h4>
+        <ul><li>Jenkins Pipeline</li><li>Maven 多模块构建</li><li>单元测试 + 代码扫描</li><li>Docker 镜像构建</li><li>推送 Harbor 私有仓库</li></ul>
+      </div>
+      <div class="deploy-card cn anim-fade-up" data-anim="fade-up" style="animation-delay:.1s">
+        <div class="di">☸️</div><h4>容器编排</h4>
+        <ul><li>Kubernetes 集群</li><li>Deployment 滚动更新</li><li>Service 服务发现</li><li>ConfigMap 配置管理</li><li>Ingress 流量入口</li></ul>
+      </div>
+      <div class="deploy-card mon anim-fade-up" data-anim="fade-up" style="animation-delay:.2s">
+        <div class="di">📊</div><h4>运维监控</h4>
+        <ul><li>Prometheus + Grafana</li><li>SkyWalking 链路追踪</li><li>ELK 日志收集</li><li>AlertManager 告警</li><li>Admin 应用监控</li></ul>
+      </div>
+    </div>
+    <div class="card card-accent mt-l" style="padding:22px">
+      <h4 style="font-family:'JetBrains Mono',monospace;font-size:13px;color:var(--accent);margin-bottom:12px">Dockerfile — 多阶段构建</h4>
+      <div class="terminal">
+        <div class="bar"><span class="dot"></span><span class="dot"></span><span class="dot"></span><span>urbanops-server/Dockerfile</span></div>
+        <pre><span class="cmt"># Stage 1: 构建</span>
+<span class="kw">FROM</span> maven:3.9-eclipse-temurin-17 <span class="kw">AS</span> builder
+<span class="kw">COPY</span> . /app && <span class="kw">WORKDIR</span> /app
+<span class="kw">RUN</span> mvn clean package -DskipTests
+
+<span class="cmt"># Stage 2: 运行</span>
+<span class="kw">FROM</span> eclipse-temurin:17-jre
+<span class="kw">COPY</span> --from=builder /app/urbanops-server/target/*.jar app.jar
+<span class="kw">ENTRYPOINT</span> ["java","-jar","/app.jar"]</pre>
+      </div>
+    </div>
+  </section>
+
+  <!-- 19. Future Planning & Roadmap -->
+  <section class="slide" data-title="Future Planning">
+    <p class="kicker">roadmap · planning</p>
+    <h2 class="h2">后续扩展规划</h2>
+    <div class="roadmap-grid">
+      <div class="roadmap-card now anim-fade-up" data-anim="fade-up">
+        <div class="r-period">Phase 1 · 近期</div>
+        <h4>🏗️ 架构夯实</h4>
+        <ul>
+          <li>完善 IoT 设备接入能力 (MQTT + Vert.x)</li>
+          <li>会员中心模块激活 (Member)</li>
+          <li>支付系统集成 (Pay)</li>
+          <li>微信公众号接入 (MP)</li>
+          <li>数据报表与大屏 (Report)</li>
+          <li>完善单元测试覆盖率</li>
+        </ul>
+      </div>
+      <div class="roadmap-card next anim-fade-up" data-anim="fade-up" style="animation-delay:.1s">
+        <div class="r-period">Phase 2 · 中期</div>
+        <h4>🚀 业务扩展</h4>
+        <ul>
+          <li>ERP 企业资源管理</li>
+          <li>CRM 客户关系管理</li>
+          <li>商城系统搭建 (Mall)</li>
+          <li>AI 大模型集成 (AI)</li>
+          <li>微服务拆分：Spring Cloud</li>
+          <li>服务网格：Istio 引入</li>
+        </ul>
+      </div>
+      <div class="roadmap-card future anim-fade-up" data-anim="fade-up" style="animation-delay:.2s">
+        <div class="r-period">Phase 3 · 远期</div>
+        <h4>🌐 平台化</h4>
+        <ul>
+          <li>多租户 SaaS 化运营</li>
+          <li>开放平台 & API 市场</li>
+          <li>低代码/无代码搭建</li>
+          <li>PF4J 插件生态</li>
+          <li>边缘计算 + IoT 规模化</li>
+          <li>数据中台 & 智能决策</li>
+        </ul>
+      </div>
+    </div>
+    <div class="timeline mt-l">
+      <div class="tl-item"><div class="tl-phase">Q2 2025</div><div class="tl-body"><h4>物联网接入打通</h4><p>MQTT 协议适配 · 设备影子 · 数据上行 · TDengine 时序存储</p></div></div>
+      <div class="tl-item"><div class="tl-phase">Q3 2025</div><div class="tl-body"><h4>业务模块激活</h4><p>Member + Pay + MP + Report 模块上线，补齐业务闭环</p></div></div>
+      <div class="tl-item"><div class="tl-phase">Q4 2025</div><div class="tl-body"><h4>微服务演进</h4><p>核心域拆分 · Spring Cloud 迁移 · 服务独立部署</p></div></div>
+    </div>
+  </section>
+
+  <!-- 20. Summary & Q&A -->
+  <section class="slide center tc" data-title="Summary & QA">
+    <div>
+      <p class="kicker" style="text-align:center">// key-takeaways</p>
+      <h2 class="h2">五个核心要点</h2>
+      <div class="grid g3 mt-l" style="max-width:960px;margin-left:auto;margin-right:auto;gap:14px">
+        <div class="card card-accent"><h4>1 · 业务驱动架构</h4><p class="dim">智慧园林 + 工单调度 + 流程协同，三大核心域支撑城市运营。</p></div>
+        <div class="card card-accent"><h4>2 · 分层清晰可扩展</h4><p class="dim">15 个 Starter 组件化，模块间 Feign API + MQ 双通道解耦。</p></div>
+        <div class="card card-accent"><h4>3 · 信创全栈兼容</h4><p class="dim">MySQL / DM8 / KingBase / OpenGauss 多数据库无缝切换。</p></div>
+        <div class="card card-accent"><h4>4 · 可观测性内置</h4><p class="dim">SkyWalking + Admin + 日志中心，三大支柱保障系统可靠。</p></div>
+        <div class="card card-accent"><h4>5 · 渐进式演进</h4><p class="dim">从模块化到微服务化，从单应用到平台化，路径清晰可落地。</p></div>
+      </div>
+      <div style="margin-top:36px">
+        <div class="mono" style="font-size:72px;color:var(--accent);font-weight:800;letter-spacing:-.04em">?</div>
+        <h2 class="h2">Questions &amp; Discussion</h2>
+        <p class="lede" style="margin:14px auto">感谢聆听 · 欢迎交流</p>
+        <div class="row mt-m" style="justify-content:center">
+          <span class="tag">#urbanops</span>
+          <span class="tag">#spring-boot</span>
+          <span class="tag">#microservices</span>
+          <span class="tag">#smart-garden</span>
+          <span class="tag">#cloud-native</span>
+        </div>
+      </div>
+    </div>
+  </section>
+
+</div>
+<script src="ppt-assets/runtime.js"></script>
+</body></html>
+# UrbanOps 开放 API 对接接口文档
+
+> **版本**: v1.1  
+> **更新日期**: 2026-06-25  
+> **适用对象**: 第三方系统对接开发人员 / Co-Claw AI 助手  
+> **鉴权方式**: HMAC-SHA256 API 签名  
+
+---
+
+## 目录
+
+1. [概述](#1-概述)
+2. [签名鉴权机制](#2-签名鉴权机制)
+3. [通用规范](#3-通用规范)
+4. [接口 1：团队考核查询（Co-Claw AI 专用）](#4-接口-1团队考核查询Co-Claw-ai-专用)
+5. [接口 2：人员查询](#5-接口-2人员查询)
+6. [接口 3：班组查询](#6-接口-3班组查询)
+7. [接口 4：考勤查询](#7-接口-4考勤查询)
+8. [接口 5：工单查询](#8-接口-5工单查询)
+9. [接口 6：物料查询](#9-接口-6物料查询)
+10. [接口 7：全量工单统计](#10-接口-7全量工单统计)
+11. [错误码说明](#11-错误码说明)
+12. [附录：客户端签名代码示例](#12-附录客户端签名代码示例)
+
+---
+
+## 1. 概述
+
+### 1.1 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 接口协议 | HTTPS |
+| 接口地址 | `https://{host}/open-api/` |
+| 鉴权方式 | HMAC-SHA256 API 签名（详见第2节） |
+| 响应格式 | JSON |
+| 字符编码 | UTF-8 |
+
+### 1.2 接口列表
+
+| # | 接口名称 | 路径 | 方法 | 说明 |
+|---|---------|------|------|------|
+| 1 | **团队考核查询** ⭐ | `/open-api/team-assessment/query` | GET | **Co-Claw AI 专用**：班组/人员考核聚合接口，含考勤/工单/耗材三维评分 |
+| 2 | 人员查询 | `/open-api/staff/query` | GET | 获取人员档案，支持按部门筛选 |
+| 3 | 班组查询 | `/open-api/teams/query` | GET | 获取班组信息，含班组长和人员数量 |
+| 4 | 考勤查询 | `/open-api/attendance/query` | GET | 获取考勤打卡数据 |
+| 5 | 工单查询 | `/open-api/tasks/query` | GET | 获取工单全生命周期数据 |
+| 6 | 物料查询 | `/open-api/materials/query` | GET | 获取物料消耗与照片数据 |
+| 7 | 全量工单统计 | `/open-api/full-order-statistics/query` | GET | 获取公司/班组工单/巡查/养护完成数量 |
+
+### 1.3 接入前提
+
+接入前需向 UrbanOps 平台申请以下凭证（由运维人员配置到 Redis）：
+
+| 参数 | 说明 |
+|------|------|
+| `appId` | 应用唯一标识（由平台分配） |
+| `appSecret` | 应用密钥（妥善保管，不可泄露） |
+
+---
+
+## 2. 签名鉴权机制
+
+### 2.1 签名参数
+
+每个请求必须携带以下 **4 个请求头**：
+
+| 请求头 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| `appId` | String | ✅ | 平台分配的应用 ID |
+| `timestamp` | String | ✅ | 当前 Unix 时间戳（**毫秒**），与服务器时间误差不能超过 60 秒 |
+| `nonce` | String | ✅ | 随机字符串，**长度 ≥ 10**，每次请求必须不同（防重放） |
+| `sign` | String | ✅ | 签名字符串（SHA256 计算结果，**小写十六进制**） |
+
+### 2.2 签名算法
+
+#### 签名字符串构造规则
+
+```
+签名字符串 = queryParams(按key字母序排列的value拼接) 
+           + headerParams(按key字母序排列的value拼接)
+           + appSecret
+```
+
+**具体步骤：**
+
+1. **排序 Query 参数值**：将 URL 中所有 query 参数按 key 字母升序排列，拼接所有 value
+2. **拼接 Header 参数值**：按 key 字母升序（即 `appId` → `nonce` → `timestamp`），依次拼接它们的值
+3. **追加 appSecret**：在最后拼接 `appSecret`
+4. **计算 SHA256**：对上述完整字符串计算 SHA256 哈希，转为**小写十六进制**字符串
+
+#### 签名公式
+
+```
+sign = SHA256(
+    sortedQueryParamValues 
+    + appId值 + nonce值 + timestamp值 
+    + appSecret
+)
+```
+
+> **注意**：GET 请求无 body，body 部分为空字符串（不参与签名）。
+
+### 2.3 签名示例
+
+假设：
+- `appId` = `my_app_001`
+- `appSecret` = `abc123xyz`
+- 请求 URL：`/open-api/staff/query?deptId=100`
+
+**步骤拆解：**
+
+```
+queryParams(sorted by key): 
+  deptId=100
+  → values = "100"
+
+headerParams(sorted by key):
+  appId=my_app_001, nonce=a1b2c3d4e5f6, timestamp=1749696000000
+  → values = "my_app_001" + "a1b2c3d4e5f6" + "1749696000000"
+
+signStr = "100" + "my_app_001" + "a1b2c3d4e5f6" + "1749696000000" + "abc123xyz"
+
+sign = SHA256(signStr)
+```
+
+### 2.4 签名校验规则
+
+| 校验项 | 规则 | 失败返回 |
+|--------|------|----------|
+| appId 非空 | 必须传递 | `400 签名不正确` |
+| timestamp 时效 | `|serverTime - timestamp| ≤ 60s` | `400 签名不正确` |
+| nonce 长度 | `len(nonce) ≥ 10` | `400 签名不正确` |
+| sign 非空 | 必须传递 | `400 签名不正确` |
+| 签名比对 | `serverSign == clientSign` | `400 签名不正确` |
+| nonce 防重放 | 同一 appId + nonce 组合只能使用一次 | `900 存在重复请求` |
+
+---
+
+## 3. 通用规范
+
+### 3.1 通用响应格式
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": [ ... ]
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `code` | Integer | `0` 表示成功，非 `0` 表示失败 |
+| `msg` | String | 提示信息 |
+| `data` | Array | 业务数据列表（根据查询条件返回所有匹配记录） |
+
+### 3.2 日期时间格式
+
+所有日期时间字段统一使用格式：`yyyy-MM-dd HH:mm:ss`
+
+示例：`2026-06-11 09:00:00`
+
+---
+
+## 4. 接口 1：团队考核查询（Co-Claw AI 专用）⭐
+
+> **设计定位**：本接口专为 Co-Claw AI 助手设计，提供班组/人员考核数据的**一站式聚合查询**。
+> 接口内部完成考勤、工单、耗材三维度评分计算，Co-Claw 可直接使用返回的得分和扣分明细进行考核分析，
+> 无需自行计算。默认只返回汇总指标（`includeDetail=false`），Token 友好。
+
+### 4.1 考核背景
+
+本接口基于《房山区园林所养护队智慧化管理制度》设计，考核满分 100 分，三大维度：
+
+| 维度 | 满分 | 主要扣分规则 |
+|------|------|-------------|
+| 工单上线率与及时率 | **40分** | 超24h补录 -1分/次 · 超时>2h -1分/次 |
+| 人员考勤管理 | **30分** | 缺勤/未打卡 -1分/次 · 缺共同处理人 -1分/次 · 未佩戴工卡 -1分/次 · 班组长记录仪未开 -1分/次 |
+| 人机材录入 | **30分** | 工单完成24h内未上报耗材 -2分/次 |
+
+### 4.2 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 路径 | `/open-api/team-assessment/query` |
+| 方法 | `GET` |
+| 说明 | 团队考核聚合查询。支持 **team 模式**（班组→人员+工单→考勤+耗材，三层结构）和 **staff 模式**（人员→考勤+工单→耗材） |
+
+### 4.3 请求参数
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `keyword` | String | **是** | — | 查询关键字：班组名称或人员姓名，**支持模糊匹配** |
+| `queryMode` | String | 否 | `team` | 查询模式：`team` 按班组查询 / `staff` 按人员查询 |
+| `startDate` | String | 否 | 当月1日 | 考核开始日期（格式：yyyy-MM-dd） |
+| `endDate` | String | 否 | 今天 | 考核结束日期（格式：yyyy-MM-dd） |
+| `includeDetail` | Boolean | 否 | `false` | 是否返回明细数据。`false` 仅返回汇总指标（推荐），`true` 同时返回考勤明细和工单耗材明细 |
+
+### 4.4 响应字段（queryMode=team）
+
+#### 顶层结构
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `queryMode` | String | 查询模式（`team` 或 `staff`） |
+| `period` | PeriodVO | 考核周期 |
+| `teams` | Array\<TeamVO\> | 班组考核列表（team 模式） |
+| `staffList` | Array\<StaffVO\> | 人员考核列表（staff 模式，与 teams 互斥） |
+
+#### TeamVO — 班组考核（第一层）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `teamId` | Long | 班组ID |
+| `teamName` | String | 班组名称 |
+| `parentTeamName` | String | 上级部门名称（所属养护所） |
+| `leaderName` | String | 班组长姓名 |
+| `totalMembers` | Long | 班组人数 |
+| `score` | ScoreVO | 考核得分（详见下方） |
+| `orderStats` | OrderStatsVO | 工单统计 |
+| `attendanceStats` | AttendanceStatsVO | 考勤统计 |
+| `materialStats` | MaterialStatsVO | 耗材统计 |
+| `members` | Array\<MemberVO\> | 人员列表（**第二层**，含个人考核指标） |
+| `orders` | Array\<OrderVO\> | 工单列表（**第二层**，含耗材） |
+
+#### ScoreVO — 考核得分
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `total` | Integer | 总分（满分100） |
+| `orderScore` | Integer | 工单得分（满分40） |
+| `attendanceScore` | Integer | 考勤得分（满分30） |
+| `materialScore` | Integer | 人机材得分（满分30） |
+| `deductions` | Array\<DeductionVO\> | 扣分明细列表 |
+
+**DeductionVO：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `rule` | String | 扣分规则描述 |
+| `count` | Integer | 触发次数 |
+| `points` | Integer | 扣分（负数） |
+
+#### OrderStatsVO — 工单统计
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `totalOrders` | Long | 总工单数 |
+| `completedOrders` | Long | 已完成工单数 |
+| `completionRate` | BigDecimal | 完成率（%） |
+| `onlineRate` | BigDecimal | 线上化率（%） |
+| `responseWithin30Min` | Long | 30分钟内响应数 |
+| `responseRate30Min` | BigDecimal | 30分钟响应率（%） |
+| `overdueOrders` | Long | 超期工单数 |
+| `lateSupplementOrders` | Long | 超24小时补录工单数 |
+
+#### AttendanceStatsVO — 考勤统计
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `totalCheckins` | Long | 总打卡次数 |
+| `absentCount` | Long | 缺勤人次 |
+| `missedCheckinCount` | Long | 未触发电子围栏打卡次数 |
+| `trajectoryLowCount` | Long | 轨迹覆盖率不达标次数 |
+| `missingCoHandlerCount` | Long | 缺共同处理人次数 |
+| `missingCardCount` | Long | 未佩戴工卡次数 |
+| `multiCardViolation` | Boolean | 是否存在一人多卡违规 |
+| `leaderRecorderOffCount` | Long | 班组长记录仪未开机次数 |
+
+#### MaterialStatsVO — 耗材统计
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `ordersWithMaterial` | Long | 已上报耗材的工单数 |
+| `ordersMissingMaterial` | Long | 缺耗材上报的工单数 |
+| `totalMaterialItems` | Long | 耗材总用量 |
+| `materialTypes` | Long | 耗材种类数 |
+
+#### MemberVO — 人员信息（第二层）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `userId` | Long | 人员ID |
+| `userName` | String | 姓名 |
+| `mobile` | String | 手机号 |
+| `postNames` | String | 岗位名称（逗号分隔） |
+| `cardNumber` | String | 工卡号 |
+| `isInner` | Integer | 是否内部人员（1=内部，2=外部） |
+| `personalScore` | PersonalScoreVO | 个人考核指标 |
+| `attendances` | Array\<AttendanceRecordVO\> | 考勤明细（**第三层**，`includeDetail=true` 时返回） |
+| `orders` | Array\<OrderVO\> | 个人工单（**第三层**，`includeDetail=true` 时返回） |
+
+#### PersonalScoreVO — 个人考核指标
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `attendanceDays` | Long | 出勤天数 |
+| `lateCount` | Long | 迟到次数 |
+| `absentCount` | Long | 缺勤次数 |
+| `assignedOrders` | Long | 承担工单数 |
+| `completedOrders` | Long | 完成工单数 |
+| `completionRate` | BigDecimal | 完成率（%） |
+| `overdueOrders` | Long | 超期工单数 |
+| `materialReported` | Long | 已上报耗材工单数 |
+| `materialMissing` | Long | 缺耗材上报工单数 |
+
+#### OrderVO — 工单信息（第二层/第三层）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `orderNo` | String | 工单号 |
+| `orderName` | String | 工单名称 |
+| `orderType` | String | 工单类型：Q=快速，C=普通，O=其他 |
+| `workerName` | String | 接单人姓名 |
+| `status` | Integer | 审批状态 |
+| `buzStatus` | String | 业务状态（completed=已完成） |
+| `commitDate` | String | 发布时间 |
+| `finishDate` | String | 完成时间 |
+| `expectedFinishDate` | String | 期望完成时间 |
+| `responseMinutes` | Long | 响应时长（分钟） |
+| `isOverdue` | Boolean | 是否超期（`finishDate > expectedFinishDate`） |
+| `isLateSupplement` | Boolean | 是否超24小时补录 |
+| `hasMaterialReported` | Boolean | 是否已上报耗材 |
+| `coHandlers` | Array\<String\> | 共同处理人姓名 |
+| `materials` | Array\<MaterialVO\> | 耗材明细（**第三层**，`includeDetail=true` 时返回） |
+
+#### 其他嵌套 VO
+
+**AttendanceRecordVO：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `punchType` | String | 打卡类型（上班/下班） |
+| `punchTime` | String | 打卡时间 |
+| `address` | String | 打卡地址 |
+
+**MaterialVO：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `materialName` | String | 耗材名称 |
+| `specifications` | String | 规格 |
+| `userCount` | Long | 使用数量 |
+| `unitName` | String | 单位 |
+| `classifyName` | String | 分类 |
+
+**PeriodVO：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `start` | String | 考核开始日期（yyyy-MM-dd） |
+| `end` | String | 考核结束日期（yyyy-MM-dd） |
+
+### 4.5 请求示例
+
+```bash
+# team 模式：按班组名称查询考核数据（仅汇总）
+curl -X GET "https://test.jichengshanshui.com.cn:28302/open-api/team-assessment/query?keyword=养护一班&queryMode=team&startDate=2026-06-01&endDate=2026-06-30" \
+  -H "appId: my_app_001" \
+  -H "timestamp: 1749696000000" \
+  -H "nonce: c3d4e5f6g7h8i9j0" \
+  -H "sign: ..."
+
+# staff 模式：按人员姓名查询考核数据（含考勤明细和工单耗材）
+curl -X GET "https://test.jichengshanshui.com.cn:28302/open-api/team-assessment/query?keyword=张三&queryMode=staff&includeDetail=true" \
+  -H "appId: my_app_001" \
+  -H "timestamp: 1749696000000" \
+  -H "nonce: d4e5f6g7h8i9j0k1" \
+  -H "sign: ..."
+```
+
+### 4.6 响应示例（team 模式，includeDetail=false）
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": {
+    "queryMode": "team",
+    "period": {
+      "start": "2026-06-01",
+      "end": "2026-06-30"
+    },
+    "teams": [
+      {
+        "teamId": 100,
+        "teamName": "养护一班",
+        "parentTeamName": "房山区园林所",
+        "leaderName": "张三",
+        "totalMembers": 15,
+        "score": {
+          "total": 85,
+          "orderScore": 34,
+          "attendanceScore": 25,
+          "materialScore": 26,
+          "deductions": [
+            { "rule": "工单超24小时补录", "count": 1, "points": -1 },
+            { "rule": "工单超时>2小时", "count": 2, "points": -2 },
+            { "rule": "缺勤/未打卡", "count": 5, "points": -5 },
+            { "rule": "人机材24h内未上报", "count": 1, "points": -2 }
+          ]
+        },
+        "orderStats": {
+          "totalOrders": 45,
+          "completedOrders": 42,
+          "completionRate": 93.3,
+          "onlineRate": 97.8,
+          "responseWithin30Min": 40,
+          "responseRate30Min": 88.9,
+          "overdueOrders": 2,
+          "lateSupplementOrders": 1
+        },
+        "attendanceStats": {
+          "totalCheckins": 570,
+          "absentCount": 5,
+          "missedCheckinCount": 5,
+          "trajectoryLowCount": 1,
+          "missingCoHandlerCount": 0,
+          "missingCardCount": 0,
+          "multiCardViolation": false,
+          "leaderRecorderOffCount": 0
+        },
+        "materialStats": {
+          "ordersWithMaterial": 42,
+          "ordersMissingMaterial": 1,
+          "totalMaterialItems": 230,
+          "materialTypes": 15
+        },
+        "members": [
+          {
+            "userId": 1001,
+            "userName": "张三",
+            "mobile": "13800138001",
+            "postNames": "班组长,技术员",
+            "cardNumber": "DEV001",
+            "isInner": 1,
+            "personalScore": {
+              "attendanceDays": 28,
+              "lateCount": 0,
+              "absentCount": 0,
+              "assignedOrders": 8,
+              "completedOrders": 8,
+              "completionRate": 100.0,
+              "overdueOrders": 0,
+              "materialReported": 8,
+              "materialMissing": 0
+            }
+          }
+        ],
+        "orders": [
+          {
+            "orderNo": "WO202606250001",
+            "orderName": "树木修剪",
+            "orderType": "C",
+            "workerName": "张三",
+            "status": 1,
+            "buzStatus": "completed",
+            "commitDate": "2026-06-25 09:00:00",
+            "finishDate": "2026-06-25 16:30:00",
+            "expectedFinishDate": "2026-06-25 18:00:00",
+            "responseMinutes": 15,
+            "isOverdue": false,
+            "isLateSupplement": false,
+            "hasMaterialReported": true,
+            "coHandlers": ["李四"]
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### 4.7 响应示例（staff 模式，includeDetail=true）
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": {
+    "queryMode": "staff",
+    "period": {
+      "start": "2026-06-01",
+      "end": "2026-06-25"
+    },
+    "staffList": [
+      {
+        "userId": 1001,
+        "userName": "张三",
+        "mobile": "13800138001",
+        "deptId": 100,
+        "deptName": "养护一班",
+        "postNames": "班组长",
+        "cardNumber": "DEV001",
+        "isInner": 1,
+        "assessment": {
+          "attendanceDays": 28,
+          "lateCount": 0,
+          "absentCount": 0,
+          "assignedOrders": 8,
+          "completedOrders": 8,
+          "completionRate": 100.0,
+          "overdueOrders": 0,
+          "materialReported": 8,
+          "materialMissing": 0
+        },
+        "attendances": [
+          { "punchType": "上班", "punchTime": "2026-06-25 08:00:00", "address": "北京市房山区xx路" },
+          { "punchType": "下班", "punchTime": "2026-06-25 17:30:00", "address": "北京市房山区xx路" }
+        ],
+        "orders": [
+          {
+            "orderNo": "WO202606250001",
+            "orderName": "树木修剪",
+            "orderType": "C",
+            "workerName": "张三",
+            "status": 1,
+            "buzStatus": "completed",
+            "commitDate": "2026-06-25 09:00:00",
+            "finishDate": "2026-06-25 16:30:00",
+            "expectedFinishDate": "2026-06-25 18:00:00",
+            "responseMinutes": 15,
+            "isOverdue": false,
+            "isLateSupplement": false,
+            "hasMaterialReported": true,
+            "coHandlers": ["李四"],
+            "materials": [
+              {
+                "materialName": "高效氯氰菊酯",
+                "specifications": "500ml/瓶",
+                "userCount": 2,
+                "unitName": "瓶",
+                "classifyName": "药品"
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### 4.8 使用建议（Co-ClawCo-Claw）
+
+| 场景 | 推荐参数 | 说明 |
+|------|----------|------|
+| 月底考核排名 | `keyword=养护&queryMode=team` | 模糊查询所有养护班组，返回考核得分用于排名 |
+| 单班组详情分析 | `keyword=养护一班&queryMode=team&includeDetail=true` | 查看特定班组全部明细，分析扣分原因 |
+| 个人绩效查询 | `keyword=张三&queryMode=staff&includeDetail=true` | 查看某人出勤、工单、耗材完整记录 |
+| 日常快速巡检 | `keyword=养护&includeDetail=false` | 只看汇总指标，Token 最少 |
+
+---
+
+## 5. 接口 2：人员查询
+
+### 4.1 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 路径 | `/open-api/staff/query` |
+| 方法 | `GET` |
+| 说明 | 获取人员基础档案信息，支持按部门、姓名、手机号等条件筛选 |
+
+### 4.2 请求参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `name` | String | 否 | 姓名，模糊匹配 |
+| `mobile` | String | 否 | 手机号，模糊匹配 |
+| `deptId` | Long | 否 | 部门ID，精确匹配 |
+| `status` | Integer | 否 | 状态：0=启用，1=禁用 |
+| `busiLine` | String | 否 | 业务线：yl=园林，wy=物业，sz=市政 |
+
+### 4.3 响应字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | Long | 人员ID |
+| `username` | String | 用户名 |
+| `nickname` | String | 姓名 |
+| `mobile` | String | 手机号 |
+| `deptId` | Long | 部门ID |
+| `deptName` | String | 部门名称（如"养护一班"） |
+| `postIds` | Array\<Long\> | 岗位ID列表 |
+| `postNames` | String | 岗位名称（逗号分隔，如"班组长,技术员"） |
+| `busiLine` | String | 业务线 |
+| `status` | Integer | 状态（0=启用，1=禁用） |
+| `cardNumber` | String | 工卡号（设备编号，用于考勤打卡） |
+| `isInner` | Integer | 是否内部人员（1=内部，2=外部） |
+| `createTime` | String | 入职日期（格式：yyyy-MM-dd HH:mm:ss） |
+
+### 4.4 请求示例
+
+```bash
+curl -X GET "https://test.jichengshanshui.com.cn:28302/open-api/staff/query?deptId=100" \
+  -H "appId: my_app_001" \
+  -H "timestamp: 1749696000000" \
+  -H "nonce: a1b2c3d4e5f6g7h8" \
+  -H "sign: 3a5f8c9e2b1d4f6a8c0e2b4d6f8a0c2e4b6d8f0a"
+```
+
+### 4.5 响应示例
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": [
+    {
+        "id": 1001,
+        "username": "zhangsan",
+        "nickname": "张三",
+        "mobile": "13800138001",
+        "deptId": 100,
+        "deptName": "养护一班",
+        "postIds": [10, 20],
+        "postNames": "班组长,技术员",
+        "busiLine": "yl",
+        "status": 0,
+        "cardNumber": "DEV001",
+        "isInner": 1,
+        "createTime": "2024-01-15 00:00:00"
+      }
+    ],
+    "total": 150
+  }
+```
+
+---
+
+## 6. 接口 3：班组查询
+
+### 5.1 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 路径 | `/open-api/teams/query` |
+| 方法 | `GET` |
+| 说明 | 获取组织架构班组信息，含班组长、所属养护所、人员数量 |
+
+### 5.2 请求参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `name` | String | 否 | 班组名称，模糊匹配 |
+| `parentId` | Long | 否 | 父部门ID（上级组织），精确匹配 |
+| `status` | Integer | 否 | 状态：0=启用，1=禁用 |
+
+### 5.3 响应字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | Long | 班组ID |
+| `name` | String | 班组名称 |
+| `parentId` | Long | 父部门ID |
+| `parentName` | String | 父部门名称（所属养护所） |
+| `leaderUserId` | Long | 班组长人员ID（Staff.id） |
+| `leaderUserName` | String | 班组长姓名 |
+| `memberCount` | Long | 人员数量 |
+| `sort` | Integer | 排序 |
+| `status` | Integer | 状态（0=启用，1=禁用） |
+
+### 5.4 请求示例
+
+```bash
+curl -X GET "https://test.jichengshanshui.com.cn:28302/open-api/teams/query" \
+  -H "appId: my_app_001" \
+  -H "timestamp: 1749696000000" \
+  -H "nonce: b2c3d4e5f6g7h8i9" \
+  -H "sign: ..."
+```
+
+### 5.5 响应示例
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": [
+    {
+        "id": 100,
+        "name": "养护一班",
+        "parentId": 1,
+        "parentName": "蓟城山水集团",
+        "leaderUserId": 1001,
+        "leaderUserName": "张三",
+        "memberCount": 15,
+        "sort": 1,
+        "status": 0
+      }
+    ],
+    "total": 12
+  }
+}
+```
+
+---
+
+## 7. 接口 4：考勤查询
+
+### 6.1 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 路径 | `/open-api/attendance/query` |
+| 方法 | `GET` |
+| 说明 | 获取电子围栏打卡与位置数据，支持按班组、人员、时间范围筛选 |
+
+### 6.2 请求参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `userId` | Long | 否 | 人员ID，精确匹配 |
+| `deptId` | Long | 否 | 部门ID（班组），精确匹配 |
+| `busiLine` | String | 否 | 业务线 |
+| `punchType` | String | 否 | 打卡类型（上班/下班） |
+| `startTime` | String | 否 | 开始时间（格式：yyyy-MM-dd HH:mm:ss） |
+| `endTime` | String | 否 | 结束时间（格式：yyyy-MM-dd HH:mm:ss） |
+
+### 6.3 响应字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | Integer | 记录ID |
+| `deviceCode` | String | 设备编码 |
+| `deviceName` | String | 设备名称 |
+| `punchType` | String | 打卡类型 |
+| `userId` | Long | 人员ID |
+| `nickname` | String | 人员姓名 |
+| `deptId` | Long | 部门ID |
+| `deptName` | String | 部门名称 |
+| `address` | String | 打卡地址 |
+| `latGcj02` | BigDecimal | 高德纬度（GCJ-02坐标系） |
+| `lngGcj02` | BigDecimal | 高德经度（GCJ-02坐标系） |
+| `lat` | BigDecimal | WGS84纬度 |
+| `lng` | BigDecimal | WGS84经度 |
+| `createTime` | String | 打卡时间 |
+
+> **注意**：当前版本暂不支持"轨迹点集""是否佩戴工卡""记录仪状态"字段（数据库无对应存储）。待业务系统确认后将补充。
+
+### 6.4 响应示例
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": [
+    {
+        "id": 1,
+        "deviceCode": "DEV001",
+        "deviceName": "打卡机01",
+        "punchType": "上班",
+        "userId": 1001,
+        "nickname": "张三",
+        "deptId": 100,
+        "deptName": "养护一班",
+        "address": "北京市西城区xx路xx号",
+        "latGcj02": 39.9042,
+        "lngGcj02": 116.4074,
+        "lat": 39.9010,
+        "lng": 116.4030,
+        "createTime": "2026-06-11 08:30:00"
+      }
+    ],
+    "total": 320
+  }
+}
+```
+
+---
+
+## 8. 接口 5：工单查询
+
+### 7.1 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 路径 | `/open-api/tasks/query` |
+| 方法 | `GET` |
+| 说明 | 获取工单全生命周期数据，含发布时间、状态、接单渠道、共同处理人 |
+
+### 7.2 请求参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `orderNo` | String | 否 | 工单号，模糊匹配 |
+| `orderName` | String | 否 | 工单名称，模糊匹配 |
+| `busiLine` | String | 否 | 业务线 |
+| `status` | Integer | 否 | 审批状态 |
+| `buzStatus` | String | 否 | 业务状态 |
+| `workerId` | Long | 否 | 接单人ID |
+| `startDate` | String | 否 | 发布时间起始（yyyy-MM-dd HH:mm:ss） |
+| `endDate` | String | 否 | 发布时间截止（yyyy-MM-dd HH:mm:ss） |
+
+### 7.3 响应字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | Long | 工单ID |
+| `orderNo` | String | 工单号 |
+| `orderName` | String | 工单名称 |
+| `orderType` | String | 工单类型：Q=快速，C=普通，O=其他 |
+| `busiLine` | String | 业务线 |
+| `commitDate` | String | 发布时间（工单派发时间） |
+| `finishDate` | String | 完成时间 |
+| `userId` | Long | 发布人ID |
+| `userName` | String | 发布人姓名 |
+| `workerId` | Long | 接单人ID |
+| `workerName` | String | 接单人姓名 |
+| `coHandlers` | Array\<String\> | 共同处理人姓名列表 |
+| `woSourceName` | String | 接单渠道（小程序/人工派单等） |
+| `status` | Integer | 审批状态 |
+| `buzStatus` | String | 业务状态 |
+| `remark` | String | 备注 |
+| `photos` | Array\<PhotoVO\> | 工单附件照片 |
+
+**PhotoVO 结构：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `busiType` | String | 业务类型：`01`=问题照片，`02`=处理中，`03`=完成 |
+| `fileName` | String | 文件名 |
+| `url` | String | 文件URL |
+
+### 7.4 响应示例
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": [
+    {
+        "id": 5001,
+        "orderNo": "WO202606110001",
+        "orderName": "树木修剪",
+        "orderType": "C",
+        "busiLine": "yl",
+        "commitDate": "2026-06-11 09:00:00",
+        "finishDate": null,
+        "userId": 1,
+        "userName": "管理员",
+        "workerId": 1001,
+        "workerName": "张三",
+        "coHandlers": ["李四", "王五"],
+        "woSourceName": "小程序",
+        "status": 1,
+        "buzStatus": "processing",
+        "remark": "紧急处理",
+        "photos": [
+          {
+            "busiType": "01",
+            "fileName": "problem.jpg",
+            "url": "https://xxx.com/file/abc.jpg"
+          }
+        ]
+      }
+    ],
+    "total": 85
+  }
+}
+```
+
+---
+
+## 9. 接口 6：物料查询
+
+### 8.1 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 路径 | `/open-api/materials/query` |
+| 方法 | `GET` |
+| 说明 | 获取物料消耗记录与人机材照片数据，支持按工单筛选 |
+
+### 8.2 请求参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `orderNo` | String | 否 | 工单号，精确匹配 |
+| `classifyName` | String | 否 | 物料分类名，模糊匹配 |
+| `typeName` | String | 否 | 物料类型名，模糊匹配 |
+| `userId` | Long | 否 | 使用人ID |
+| `startDate` | String | 否 | 开始时间（yyyy-MM-dd HH:mm:ss） |
+| `endDate` | String | 否 | 结束时间（yyyy-MM-dd HH:mm:ss） |
+
+### 8.3 响应字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | Long | 记录ID |
+| `orderNo` | String | 关联工单号 |
+| `materialName` | String | 物料名称 |
+| `specifications` | String | 规格 |
+| `userCount` | Long | 使用数量 |
+| `unitName` | String | 单位 |
+| `classifyName` | String | 物料分类 |
+| `typeName` | String | 物料类型 |
+| `typeDetailName` | String | 物料明细类型 |
+| `userId` | Long | 使用人ID |
+| `userName` | String | 使用人姓名 |
+| `source` | Integer | 来源：1=工单，2=巡检，3=养护 |
+| `createTime` | String | 上传时间 |
+| `photos` | Array\<PhotoVO\> | 人机材照片（结构同工单接口） |
+
+### 8.4 响应示例
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": [
+    {
+        "id": 3001,
+        "orderNo": "WO202606110001",
+        "materialName": "高效氯氰菊酯",
+        "specifications": "500ml/瓶",
+        "userCount": 5,
+        "unitName": "瓶",
+        "classifyName": "药品",
+        "typeName": "杀虫剂",
+        "typeDetailName": "有机磷",
+        "userId": 1001,
+        "userName": "张三",
+        "source": 1,
+        "createTime": "2026-06-11 14:30:00",
+        "photos": [
+          {
+            "busiType": "02",
+            "fileName": "material.jpg",
+            "url": "https://xxx.com/file/def.jpg"
+          }
+        ]
+      }
+    ],
+    "total": 45
+  }
+}
+```
+
+---
+
+## 10. 接口 7：全量工单统计
+
+### 9.1 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 路径 | `/open-api/full-order-statistics/query` |
+| 方法 | `GET` |
+| 说明 | 获取各公司/班组在一段时间内实际完成的工单数量、巡查记录数量、养护记录数量 |
+
+### 9.2 请求参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `companyId` | Long | 否 | 公司/班组ID，精确匹配 |
+| `companyName` | String | 否 | 公司/班组名称，模糊匹配 |
+| `type` | Integer | 否 | 类型：1=按公司，2=按班组 |
+| `startDate` | String | 否 | 统计开始日期（格式：yyyy-MM-dd，返回开始日期>=该值的记录） |
+| `endDate` | String | 否 | 统计结束日期（格式：yyyy-MM-dd，返回结束日期<=该值的记录） |
+
+### 9.3 响应字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | Long | 记录ID |
+| `companyId` | Long | 公司/班组ID |
+| `companyName` | String | 公司/班组名称 |
+| `type` | Integer | 类型：1=按公司，2=按班组 |
+| `startDate` | String | 统计开始日期 |
+| `endDate` | String | 统计结束日期 |
+| `workOrderCount` | Integer | 工单完成数量 |
+| `inspectionCount` | Integer | 巡查记录数量 |
+| `maintenanceCount` | Integer | 养护记录数量 |
+| `remark` | String | 备注 |
+| `createTime` | String | 创建时间 |
+
+### 9.4 请求示例
+
+```bash
+curl -X GET "https://test.jichengshanshui.com.cn:28302/open-api/full-order-statistics/query?type=1&startDate=2026-06-01&endDate=2026-06-30" \
+  -H "appId: my_app_001" \
+  -H "timestamp: 1749696000000" \
+  -H "nonce: f6g7h8i9j0k1l2m3" \
+  -H "sign: ..."
+```
+
+### 9.5 响应示例
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": [
+    {
+      "id": 1,
+      "companyId": 100,
+      "companyName": "养护一班",
+      "type": 1,
+      "startDate": "2026-06-01",
+      "endDate": "2026-06-30",
+      "workOrderCount": 85,
+      "inspectionCount": 120,
+      "maintenanceCount": 60,
+      "remark": "二季度统计",
+      "createTime": "2026-06-11 10:00:00"
+    }
+  ]
+}
+```
+
+---
+
+## 11. 错误码说明
+
+### 11.1 签名相关错误
+
+| code | msg | 说明 |
+|------|-----|------|
+| 400 | 签名不正确 | 签名验证失败（appId不存在/timestamp超时/nonce长度不足/签名不匹配） |
+| 900 | 存在重复请求 | nonce 已被使用（重放攻击检测） |
+
+### 11.2 业务接口错误
+
+| code | msg | 说明 |
+|------|-----|------|
+| 1-100-020-001 | 人员查询失败 | 人员查询内部错误 |
+| 1-100-020-002 | 班组查询失败 | 班组查询内部错误 |
+| 1-100-020-003 | 考勤查询失败 | 考勤查询内部错误 |
+| 1-100-020-004 | 工单查询失败 | 工单查询内部错误 |
+| 1-100-020-005 | 物料查询失败 | 物料查询内部错误 |
+| 1-100-020-006 | 团队考核查询失败 | 团队考核聚合查询内部错误 |
+| 1-900-005-001 | 全量工单统计不存在 | 记录不存在 |
+| 1-900-005-002 | 相同公司/班组同时间段统计已存在 | 重复数据校验 |
+
+### 11.3 通用错误
+
+| code | msg | 说明 |
+|------|-----|------|
+| 400 | 参数校验失败 | 请求参数格式或值不正确 |
+| 500 | 系统内部错误 | 服务器内部异常 |
+
+---
+
+## 12. 附录：客户端签名代码示例
+
+### 12.1 Java 示例
+
+```java
+import cn.hutool.crypto.digest.DigestUtil;
+import cn.hutool.http.HttpRequest;
+import cn.hutool.http.HttpResponse;
+import cn.hutool.core.util.RandomUtil;
+
+import java.util.Map;
+import java.util.TreeMap;
+
+public class OpenApiClient {
+
+    private static final String BASE_URL = "https://test.jichengshanshui.com.cn:28302";
+    private static final String APP_ID = "your_app_id";
+    private static final String APP_SECRET = "your_app_secret";
+
+    public static String call(String path, Map<String, Object> params) {
+        String timestamp = String.valueOf(System.currentTimeMillis());
+        String nonce = RandomUtil.randomString(16);
+        String sign = buildSign(params, timestamp, nonce);
+
+        String url = BASE_URL + path;
+        HttpResponse response = HttpRequest.get(url)
+                .form(params)
+                .header("appId", APP_ID)
+                .header("timestamp", timestamp)
+                .header("nonce", nonce)
+                .header("sign", sign)
+                .execute();
+        return response.body();
+    }
+
+    private static String buildSign(Map<String, Object> params,
+                                     String timestamp, String nonce) {
+        StringBuilder sb = new StringBuilder();
+
+        // 1. 排序 query 参数值
+        if (params != null && !params.isEmpty()) {
+            new TreeMap<>(params).values().stream()
+                    .map(String::valueOf).forEach(sb::append);
+        }
+
+        // 2. header 参数值（appId, nonce, timestamp 字母序）
+        sb.append(APP_ID);
+        sb.append(nonce);
+        sb.append(timestamp);
+
+        // 3. 追加 appSecret + SHA256
+        sb.append(APP_SECRET);
+        return DigestUtil.sha256Hex(sb.toString());
+    }
+}
+```
+
+### 12.2 Python 示例
+
+```python
+import hashlib
+import time
+import random
+import string
+import requests
+
+BASE_URL = "https://test.jichengshanshui.com.cn:28302"
+APP_ID = "your_app_id"
+APP_SECRET = "your_app_secret"
+
+def build_sign(params, timestamp, nonce):
+    parts = []
+    if params:
+        for key in sorted(params.keys()):
+            parts.append(str(params[key]))
+    parts.append(APP_ID)
+    parts.append(nonce)
+    parts.append(timestamp)
+    parts.append(APP_SECRET)
+    sign_str = "".join(parts)
+    return hashlib.sha256(sign_str.encode()).hexdigest()
+
+def call(path, params=None):
+    if params is None:
+        params = {}
+    timestamp = str(int(time.time() * 1000))
+    nonce = "".join(random.choices(string.ascii_lowercase + string.digits, k=16))
+    sign = build_sign(params, timestamp, nonce)
+    headers = {
+        "appId": APP_ID,
+        "timestamp": timestamp,
+        "nonce": nonce,
+        "sign": sign
+    }
+    response = requests.get(BASE_URL + path, params=params, headers=headers)
+    return response.json()
+```
+
+### 12.3 Shell (cURL) 示例
+
+```bash
+#!/bin/bash
+APP_ID="your_app_id"
+APP_SECRET="your_app_secret"
+TIMESTAMP=$(date +%s%3N)
+NONCE=$(openssl rand -hex 16)
+
+# 示例：/open-api/staff/query?deptId=100
+# query params 排序后 values: deptId=100 → "100"
+QUERY_VALUES="100"
+HEADER_VALUES="${APP_ID}${NONCE}${TIMESTAMP}"
+SIGN_STR="${QUERY_VALUES}${HEADER_VALUES}${APP_SECRET}"
+SIGN=$(echo -n "$SIGN_STR" | openssl dgst -sha256 -hex | awk '{print $2}')
+
+curl -X GET "https://test.jichengshanshui.com.cn:28302/open-api/staff/query?deptId=100" \
+  -H "appId: ${APP_ID}" \
+  -H "timestamp: ${TIMESTAMP}" \
+  -H "nonce: ${NONCE}" \
+  -H "sign: ${SIGN}"
+```
+
+---
+
+> **本文档基于 2026-06-11 代码生成，如有接口变更请同步更新。**
 # UrbanOps 开放 API 对接接口文档
-> **版本**: v1.0  
-> **更新日期**: 2026-06-11  
-> **适用对象**: 第三方系统对接开发人员  
+> **版本**: v1.1  
+> **更新日期**: 2026-06-25  
+> **适用对象**: 第三方系统对接开发人员 / Co-Claw AI 助手  
 > **鉴权方式**: HMAC-SHA256 API 签名  
 ---
@@ -12,14 +12,15 @@
 1. [概述](#1-概述)
 2. [签名鉴权机制](#2-签名鉴权机制)
 3. [通用规范](#3-通用规范)
-4. [接口 1：人员查询](#4-接口-1人员查询)
-5. [接口 2：班组查询](#5-接口-2班组查询)
-6. [接口 3：考勤查询](#6-接口-3考勤查询)
-7. [接口 4：工单查询](#7-接口-4工单查询)
-8. [接口 5：物料查询](#8-接口-5物料查询)
-9. [接口 6：全量工单统计](#9-接口-6全量工单统计)
-10. [错误码说明](#10-错误码说明)
-11. [附录：客户端签名代码示例](#11-附录客户端签名代码示例)
+4. [接口 1：团队考核查询（Co-Claw AI 专用）](#4-接口-1团队考核查询Co-Claw-ai-专用)
+5. [接口 2：人员查询](#5-接口-2人员查询)
+6. [接口 3：班组查询](#6-接口-3班组查询)
+7. [接口 4：考勤查询](#7-接口-4考勤查询)
+8. [接口 5：工单查询](#8-接口-5工单查询)
+9. [接口 6：物料查询](#9-接口-6物料查询)
+10. [接口 7：全量工单统计](#10-接口-7全量工单统计)
+11. [错误码说明](#11-错误码说明)
+12. [附录：客户端签名代码示例](#12-附录客户端签名代码示例)
 ---
@@ -39,12 +40,13 @@
 | # | 接口名称 | 路径 | 方法 | 说明 |
 |---|---------|------|------|------|
-| 1 | 人员查询 | `/open-api/staff/query` | GET | 获取人员档案，支持按部门筛选 |
-| 2 | 班组查询 | `/open-api/teams/query` | GET | 获取班组信息，含班组长和人员数量 |
-| 3 | 考勤查询 | `/open-api/attendance/query` | GET | 获取考勤打卡数据 |
-| 4 | 工单查询 | `/open-api/tasks/query` | GET | 获取工单全生命周期数据 |
-| 5 | 物料查询 | `/open-api/materials/query` | GET | 获取物料消耗与照片数据 |
-| 6 | 全量工单统计 | `/open-api/full-order-statistics/query` | GET | 获取公司/班组工单/巡查/养护完成数量 |
+| 1 | **团队考核查询** ⭐ | `/open-api/team-assessment/query` | GET | **Co-Claw AI 专用**：班组/人员考核聚合接口，含考勤/工单/耗材三维评分 |
+| 2 | 人员查询 | `/open-api/staff/query` | GET | 获取人员档案，支持按部门筛选 |
+| 3 | 班组查询 | `/open-api/teams/query` | GET | 获取班组信息，含班组长和人员数量 |
+| 4 | 考勤查询 | `/open-api/attendance/query` | GET | 获取考勤打卡数据 |
+| 5 | 工单查询 | `/open-api/tasks/query` | GET | 获取工单全生命周期数据 |
+| 6 | 物料查询 | `/open-api/materials/query` | GET | 获取物料消耗与照片数据 |
+| 7 | 全量工单统计 | `/open-api/full-order-statistics/query` | GET | 获取公司/班组工单/巡查/养护完成数量 |
 ### 1.3 接入前提
@@ -161,7 +163,397 @@ sign = SHA256(signStr)
 ---
-## 4. 接口 1：人员查询
+## 4. 接口 1：团队考核查询（Co-Claw AI 专用）⭐
+
+> **设计定位**：本接口专为 Co-Claw AI 助手设计，提供班组/人员考核数据的**一站式聚合查询**。
+> 接口内部完成考勤、工单、耗材三维度评分计算，Co-Claw 可直接使用返回的得分和扣分明细进行考核分析，
+> 无需自行计算。默认只返回汇总指标（`includeDetail=false`），Token 友好。
+
+### 4.1 考核背景
+
+本接口基于《房山区园林所养护队智慧化管理制度》设计，考核满分 100 分，三大维度：
+
+| 维度 | 满分 | 主要扣分规则 |
+|------|------|-------------|
+| 工单上线率与及时率 | **40分** | 超24h补录 -1分/次 · 超时>2h -1分/次 |
+| 人员考勤管理 | **30分** | 缺勤/未打卡 -1分/次 · 缺共同处理人 -1分/次 · 未佩戴工卡 -1分/次 · 班组长记录仪未开 -1分/次 |
+| 人机材录入 | **30分** | 工单完成24h内未上报耗材 -2分/次 |
+
+### 4.2 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 路径 | `/open-api/team-assessment/query` |
+| 方法 | `GET` |
+| 说明 | 团队考核聚合查询。支持 **team 模式**（班组→人员+工单→考勤+耗材，三层结构）和 **staff 模式**（人员→考勤+工单→耗材） |
+
+### 4.3 请求参数
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `keyword` | String | **是** | — | 查询关键字：班组名称或人员姓名，**支持模糊匹配** |
+| `queryMode` | String | 否 | `team` | 查询模式：`team` 按班组查询 / `staff` 按人员查询 |
+| `startDate` | String | 否 | 当月1日 | 考核开始日期（格式：yyyy-MM-dd） |
+| `endDate` | String | 否 | 今天 | 考核结束日期（格式：yyyy-MM-dd） |
+| `includeDetail` | Boolean | 否 | `false` | 是否返回明细数据。`false` 仅返回汇总指标（推荐），`true` 同时返回考勤明细和工单耗材明细 |
+
+### 4.4 响应字段（queryMode=team）
+
+#### 顶层结构
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `queryMode` | String | 查询模式（`team` 或 `staff`） |
+| `period` | PeriodVO | 考核周期 |
+| `teams` | Array\<TeamVO\> | 班组考核列表（team 模式） |
+| `staffList` | Array\<StaffVO\> | 人员考核列表（staff 模式，与 teams 互斥） |
+
+#### TeamVO — 班组考核（第一层）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `teamId` | Long | 班组ID |
+| `teamName` | String | 班组名称 |
+| `parentTeamName` | String | 上级部门名称（所属养护所） |
+| `leaderName` | String | 班组长姓名 |
+| `totalMembers` | Long | 班组人数 |
+| `score` | ScoreVO | 考核得分（详见下方） |
+| `orderStats` | OrderStatsVO | 工单统计 |
+| `attendanceStats` | AttendanceStatsVO | 考勤统计 |
+| `materialStats` | MaterialStatsVO | 耗材统计 |
+| `members` | Array\<MemberVO\> | 人员列表（**第二层**，含个人考核指标） |
+| `orders` | Array\<OrderVO\> | 工单列表（**第二层**，含耗材） |
+
+#### ScoreVO — 考核得分
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `total` | Integer | 总分（满分100） |
+| `orderScore` | Integer | 工单得分（满分40） |
+| `attendanceScore` | Integer | 考勤得分（满分30） |
+| `materialScore` | Integer | 人机材得分（满分30） |
+| `deductions` | Array\<DeductionVO\> | 扣分明细列表 |
+
+**DeductionVO：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `rule` | String | 扣分规则描述 |
+| `count` | Integer | 触发次数 |
+| `points` | Integer | 扣分（负数） |
+
+#### OrderStatsVO — 工单统计
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `totalOrders` | Long | 总工单数 |
+| `completedOrders` | Long | 已完成工单数 |
+| `completionRate` | BigDecimal | 完成率（%） |
+| `onlineRate` | BigDecimal | 线上化率（%） |
+| `responseWithin30Min` | Long | 30分钟内响应数 |
+| `responseRate30Min` | BigDecimal | 30分钟响应率（%） |
+| `overdueOrders` | Long | 超期工单数 |
+| `lateSupplementOrders` | Long | 超24小时补录工单数 |
+
+#### AttendanceStatsVO — 考勤统计
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `totalCheckins` | Long | 总打卡次数 |
+| `absentCount` | Long | 缺勤人次 |
+| `missedCheckinCount` | Long | 未触发电子围栏打卡次数 |
+| `trajectoryLowCount` | Long | 轨迹覆盖率不达标次数 |
+| `missingCoHandlerCount` | Long | 缺共同处理人次数 |
+| `missingCardCount` | Long | 未佩戴工卡次数 |
+| `multiCardViolation` | Boolean | 是否存在一人多卡违规 |
+| `leaderRecorderOffCount` | Long | 班组长记录仪未开机次数 |
+
+#### MaterialStatsVO — 耗材统计
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `ordersWithMaterial` | Long | 已上报耗材的工单数 |
+| `ordersMissingMaterial` | Long | 缺耗材上报的工单数 |
+| `totalMaterialItems` | Long | 耗材总用量 |
+| `materialTypes` | Long | 耗材种类数 |
+
+#### MemberVO — 人员信息（第二层）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `userId` | Long | 人员ID |
+| `userName` | String | 姓名 |
+| `mobile` | String | 手机号 |
+| `postNames` | String | 岗位名称（逗号分隔） |
+| `cardNumber` | String | 工卡号 |
+| `isInner` | Integer | 是否内部人员（1=内部，2=外部） |
+| `personalScore` | PersonalScoreVO | 个人考核指标 |
+| `attendances` | Array\<AttendanceRecordVO\> | 考勤明细（**第三层**，`includeDetail=true` 时返回） |
+| `orders` | Array\<OrderVO\> | 个人工单（**第三层**，`includeDetail=true` 时返回） |
+
+#### PersonalScoreVO — 个人考核指标
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `attendanceDays` | Long | 出勤天数 |
+| `lateCount` | Long | 迟到次数 |
+| `absentCount` | Long | 缺勤次数 |
+| `assignedOrders` | Long | 承担工单数 |
+| `completedOrders` | Long | 完成工单数 |
+| `completionRate` | BigDecimal | 完成率（%） |
+| `overdueOrders` | Long | 超期工单数 |
+| `materialReported` | Long | 已上报耗材工单数 |
+| `materialMissing` | Long | 缺耗材上报工单数 |
+
+#### OrderVO — 工单信息（第二层/第三层）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `orderNo` | String | 工单号 |
+| `orderName` | String | 工单名称 |
+| `orderType` | String | 工单类型：Q=快速，C=普通，O=其他 |
+| `workerName` | String | 接单人姓名 |
+| `status` | Integer | 审批状态 |
+| `buzStatus` | String | 业务状态（completed=已完成） |
+| `commitDate` | String | 发布时间 |
+| `finishDate` | String | 完成时间 |
+| `expectedFinishDate` | String | 期望完成时间 |
+| `responseMinutes` | Long | 响应时长（分钟） |
+| `isOverdue` | Boolean | 是否超期（`finishDate > expectedFinishDate`） |
+| `isLateSupplement` | Boolean | 是否超24小时补录 |
+| `hasMaterialReported` | Boolean | 是否已上报耗材 |
+| `coHandlers` | Array\<String\> | 共同处理人姓名 |
+| `materials` | Array\<MaterialVO\> | 耗材明细（**第三层**，`includeDetail=true` 时返回） |
+
+#### 其他嵌套 VO
+
+**AttendanceRecordVO：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `punchType` | String | 打卡类型（上班/下班） |
+| `punchTime` | String | 打卡时间 |
+| `address` | String | 打卡地址 |
+
+**MaterialVO：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `materialName` | String | 耗材名称 |
+| `specifications` | String | 规格 |
+| `userCount` | Long | 使用数量 |
+| `unitName` | String | 单位 |
+| `classifyName` | String | 分类 |
+
+**PeriodVO：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `start` | String | 考核开始日期（yyyy-MM-dd） |
+| `end` | String | 考核结束日期（yyyy-MM-dd） |
+
+### 4.5 请求示例
+
+```bash
+# team 模式：按班组名称查询考核数据（仅汇总）
+curl -X GET "https://test.jichengshanshui.com.cn:28302/open-api/team-assessment/query?keyword=养护一班&queryMode=team&startDate=2026-06-01&endDate=2026-06-30" \
+  -H "appId: my_app_001" \
+  -H "timestamp: 1749696000000" \
+  -H "nonce: c3d4e5f6g7h8i9j0" \
+  -H "sign: ..."
+
+# staff 模式：按人员姓名查询考核数据（含考勤明细和工单耗材）
+curl -X GET "https://test.jichengshanshui.com.cn:28302/open-api/team-assessment/query?keyword=张三&queryMode=staff&includeDetail=true" \
+  -H "appId: my_app_001" \
+  -H "timestamp: 1749696000000" \
+  -H "nonce: d4e5f6g7h8i9j0k1" \
+  -H "sign: ..."
+```
+
+### 4.6 响应示例（team 模式，includeDetail=false）
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": {
+    "queryMode": "team",
+    "period": {
+      "start": "2026-06-01",
+      "end": "2026-06-30"
+    },
+    "teams": [
+      {
+        "teamId": 100,
+        "teamName": "养护一班",
+        "parentTeamName": "房山区园林所",
+        "leaderName": "张三",
+        "totalMembers": 15,
+        "score": {
+          "total": 85,
+          "orderScore": 34,
+          "attendanceScore": 25,
+          "materialScore": 26,
+          "deductions": [
+            { "rule": "工单超24小时补录", "count": 1, "points": -1 },
+            { "rule": "工单超时>2小时", "count": 2, "points": -2 },
+            { "rule": "缺勤/未打卡", "count": 5, "points": -5 },
+            { "rule": "人机材24h内未上报", "count": 1, "points": -2 }
+          ]
+        },
+        "orderStats": {
+          "totalOrders": 45,
+          "completedOrders": 42,
+          "completionRate": 93.3,
+          "onlineRate": 97.8,
+          "responseWithin30Min": 40,
+          "responseRate30Min": 88.9,
+          "overdueOrders": 2,
+          "lateSupplementOrders": 1
+        },
+        "attendanceStats": {
+          "totalCheckins": 570,
+          "absentCount": 5,
+          "missedCheckinCount": 5,
+          "trajectoryLowCount": 1,
+          "missingCoHandlerCount": 0,
+          "missingCardCount": 0,
+          "multiCardViolation": false,
+          "leaderRecorderOffCount": 0
+        },
+        "materialStats": {
+          "ordersWithMaterial": 42,
+          "ordersMissingMaterial": 1,
+          "totalMaterialItems": 230,
+          "materialTypes": 15
+        },
+        "members": [
+          {
+            "userId": 1001,
+            "userName": "张三",
+            "mobile": "13800138001",
+            "postNames": "班组长,技术员",
+            "cardNumber": "DEV001",
+            "isInner": 1,
+            "personalScore": {
+              "attendanceDays": 28,
+              "lateCount": 0,
+              "absentCount": 0,
+              "assignedOrders": 8,
+              "completedOrders": 8,
+              "completionRate": 100.0,
+              "overdueOrders": 0,
+              "materialReported": 8,
+              "materialMissing": 0
+            }
+          }
+        ],
+        "orders": [
+          {
+            "orderNo": "WO202606250001",
+            "orderName": "树木修剪",
+            "orderType": "C",
+            "workerName": "张三",
+            "status": 1,
+            "buzStatus": "completed",
+            "commitDate": "2026-06-25 09:00:00",
+            "finishDate": "2026-06-25 16:30:00",
+            "expectedFinishDate": "2026-06-25 18:00:00",
+            "responseMinutes": 15,
+            "isOverdue": false,
+            "isLateSupplement": false,
+            "hasMaterialReported": true,
+            "coHandlers": ["李四"]
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### 4.7 响应示例（staff 模式，includeDetail=true）
+
+```json
+{
+  "code": 0,
+  "msg": "成功",
+  "data": {
+    "queryMode": "staff",
+    "period": {
+      "start": "2026-06-01",
+      "end": "2026-06-25"
+    },
+    "staffList": [
+      {
+        "userId": 1001,
+        "userName": "张三",
+        "mobile": "13800138001",
+        "deptId": 100,
+        "deptName": "养护一班",
+        "postNames": "班组长",
+        "cardNumber": "DEV001",
+        "isInner": 1,
+        "assessment": {
+          "attendanceDays": 28,
+          "lateCount": 0,
+          "absentCount": 0,
+          "assignedOrders": 8,
+          "completedOrders": 8,
+          "completionRate": 100.0,
+          "overdueOrders": 0,
+          "materialReported": 8,
+          "materialMissing": 0
+        },
+        "attendances": [
+          { "punchType": "上班", "punchTime": "2026-06-25 08:00:00", "address": "北京市房山区xx路" },
+          { "punchType": "下班", "punchTime": "2026-06-25 17:30:00", "address": "北京市房山区xx路" }
+        ],
+        "orders": [
+          {
+            "orderNo": "WO202606250001",
+            "orderName": "树木修剪",
+            "orderType": "C",
+            "workerName": "张三",
+            "status": 1,
+            "buzStatus": "completed",
+            "commitDate": "2026-06-25 09:00:00",
+            "finishDate": "2026-06-25 16:30:00",
+            "expectedFinishDate": "2026-06-25 18:00:00",
+            "responseMinutes": 15,
+            "isOverdue": false,
+            "isLateSupplement": false,
+            "hasMaterialReported": true,
+            "coHandlers": ["李四"],
+            "materials": [
+              {
+                "materialName": "高效氯氰菊酯",
+                "specifications": "500ml/瓶",
+                "userCount": 2,
+                "unitName": "瓶",
+                "classifyName": "药品"
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### 4.8 使用建议（Co-ClawCo-Claw）
+
+| 场景 | 推荐参数 | 说明 |
+|------|----------|------|
+| 月底考核排名 | `keyword=养护&queryMode=team` | 模糊查询所有养护班组，返回考核得分用于排名 |
+| 单班组详情分析 | `keyword=养护一班&queryMode=team&includeDetail=true` | 查看特定班组全部明细，分析扣分原因 |
+| 个人绩效查询 | `keyword=张三&queryMode=staff&includeDetail=true` | 查看某人出勤、工单、耗材完整记录 |
+| 日常快速巡检 | `keyword=养护&includeDetail=false` | 只看汇总指标，Token 最少 |
+
+---
+
+## 5. 接口 2：人员查询
 ### 4.1 基本信息
@@ -238,7 +630,7 @@ curl -X GET &quot;https://test.jichengshanshui.com.cn:28302/open-api/staff/query?dept
 ---
-## 5. 接口 2：班组查询
+## 6. 接口 3：班组查询
 ### 5.1 基本信息
@@ -306,7 +698,7 @@ curl -X GET &quot;https://test.jichengshanshui.com.cn:28302/open-api/teams/query&quot; \
 ---
-## 6. 接口 3：考勤查询
+## 7. 接口 4：考勤查询
 ### 6.1 基本信息
@@ -379,7 +771,7 @@ curl -X GET &quot;https://test.jichengshanshui.com.cn:28302/open-api/teams/query&quot; \
 ---
-## 7. 接口 4：工单查询
+## 8. 接口 5：工单查询
 ### 7.1 基本信息
@@ -472,7 +864,7 @@ curl -X GET &quot;https://test.jichengshanshui.com.cn:28302/open-api/teams/query&quot; \
 ---
-## 8. 接口 5：物料查询
+## 9. 接口 6：物料查询
 ### 8.1 基本信息
@@ -549,7 +941,7 @@ curl -X GET &quot;https://test.jichengshanshui.com.cn:28302/open-api/teams/query&quot; \
 ---
-## 9. 接口 6：全量工单统计
+## 10. 接口 7：全量工单统计
 ### 9.1 基本信息
@@ -621,18 +1013,16 @@ curl -X GET &quot;https://test.jichengshanshui.com.cn:28302/open-api/full-order-stati
 ---
-## 10. 错误码说明  
+## 11. 错误码说明
-### 10.1 签名相关错误
-
-### 10.2 业务相关错误
+### 11.1 签名相关错误
 | code | msg | 说明 |
 |------|-----|------|
 | 400 | 签名不正确 | 签名验证失败（appId不存在/timestamp超时/nonce长度不足/签名不匹配） |
 | 900 | 存在重复请求 | nonce 已被使用（重放攻击检测） |
-### 10.3 通用错误
+### 11.2 业务接口错误
 | code | msg | 说明 |
 |------|-----|------|
@@ -641,11 +1031,11 @@ curl -X GET &quot;https://test.jichengshanshui.com.cn:28302/open-api/full-order-stati
 | 1-100-020-003 | 考勤查询失败 | 考勤查询内部错误 |
 | 1-100-020-004 | 工单查询失败 | 工单查询内部错误 |
 | 1-100-020-005 | 物料查询失败 | 物料查询内部错误 |
-
+| 1-100-020-006 | 团队考核查询失败 | 团队考核聚合查询内部错误 |
 | 1-900-005-001 | 全量工单统计不存在 | 记录不存在 |
 | 1-900-005-002 | 相同公司/班组同时间段统计已存在 | 重复数据校验 |
-### 10.3 通用错误
+### 11.3 通用错误
 | code | msg | 说明 |
 |------|-----|------|
@@ -654,9 +1044,9 @@ curl -X GET &quot;https://test.jichengshanshui.com.cn:28302/open-api/full-order-stati
 ---
-## 11. 附录：客户端签名代码示例
+## 12. 附录：客户端签名代码示例
-### 10.1 Java 示例
+### 12.1 Java 示例
 ```java
 import cn.hutool.crypto.digest.DigestUtil;
@@ -711,7 +1101,7 @@ public class OpenApiClient {
 }
 ```
-### 10.2 Python 示例
+### 12.2 Python 示例
 ```python
 import hashlib
@@ -752,7 +1142,7 @@ def call(path, params=None):
     return response.json()
 ```
-### 10.3 Shell (cURL) 示例
+### 12.3 Shell (cURL) 示例
 ```bash
 #!/bin/bash
+package com.zteits.urbanops.module.garden.controller.open.assessment;
+
+import com.zteits.urbanops.framework.common.pojo.CommonResult;
+import com.zteits.urbanops.framework.signature.core.annotation.ApiSignature;
+import com.zteits.urbanops.module.garden.controller.open.assessment.vo.TeamAssessmentReqVO;
+import com.zteits.urbanops.module.garden.controller.open.assessment.vo.TeamAssessmentRespVO;
+import com.zteits.urbanops.module.garden.controller.open.service.OpenApiService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.concurrent.TimeUnit;
+
+import static com.zteits.urbanops.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "开放API - 团队考核查询")
+@RestController
+@RequestMapping("/open-api/team-assessment")
+@Slf4j
+@jakarta.annotation.security.PermitAll
+@ApiSignature(timeout = 60, timeUnit = TimeUnit.SECONDS)
+public class TeamAssessmentOpenController {
+
+    @Resource
+    private OpenApiService openApiService;
+
+    @GetMapping("/query")
+    @Operation(summary = "查询班组/人员考核数据（供 OpenClaw AI 助手使用）")
+    public CommonResult<TeamAssessmentRespVO> queryTeamAssessment(
+            @Valid TeamAssessmentReqVO reqVO) {
+        return success(openApiService.queryTeamAssessment(reqVO));
+    }
+}
+package com.zteits.urbanops.module.garden.controller.open.assessment.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.io.Serializable;
+import java.time.LocalDate;
+
+import static com.zteits.urbanops.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY;
+
+@Schema(description = "开放API - 团队考核查询 Request VO")
+@Data
+public class TeamAssessmentReqVO implements Serializable {
+
+    @Schema(description = "查询关键字：班组名称或人员姓名（支持模糊匹配）", example = "养护一班", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String keyword;
+
+    @Schema(description = "查询模式：team 按班组查询 / staff 按人员查询", example = "team", defaultValue = "team")
+    private String queryMode;
+
+    @Schema(description = "考核开始日期（默认当月1日）", example = "2026-06-01")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY)
+    private LocalDate startDate;
+
+    @Schema(description = "考核结束日期（默认今天）", example = "2026-06-25")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY)
+    private LocalDate endDate;
+
+    @Schema(description = "是否返回明细数据（考勤明细、工单耗材明细）", example = "false", defaultValue = "false")
+    private Boolean includeDetail;
+}
+package com.zteits.urbanops.module.garden.controller.open.assessment.vo;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static com.zteits.urbanops.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY;
+import static com.zteits.urbanops.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+import static com.zteits.urbanops.framework.common.util.date.DateUtils.TIME_ZONE_DEFAULT;
+
+@Schema(description = "开放API - 团队考核查询 Response VO")
+@Data
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class TeamAssessmentRespVO {
+
+    @Schema(description = "查询模式", example = "team")
+    private String queryMode;
+
+    @Schema(description = "考核周期")
+    private PeriodVO period;
+
+    @Schema(description = "班组考核列表（queryMode=team 时返回）")
+    private List<TeamVO> teams;
+
+    @Schema(description = "人员考核列表（queryMode=staff 时返回）")
+    private List<StaffVO> staffList;
+
+    // ==================== 考核周期 ====================
+
+    @Data
+    public static class PeriodVO {
+        @Schema(description = "开始日期", example = "2026-06-01")
+        @JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY, timezone = TIME_ZONE_DEFAULT)
+        private LocalDate start;
+
+        @Schema(description = "结束日期", example = "2026-06-25")
+        @JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY, timezone = TIME_ZONE_DEFAULT)
+        private LocalDate end;
+    }
+
+    // ==================== 班组（第一层） ====================
+
+    @Data
+    public static class TeamVO {
+        @Schema(description = "班组ID", example = "100")
+        private Long teamId;
+
+        @Schema(description = "班组名称", example = "养护一班")
+        private String teamName;
+
+        @Schema(description = "上级部门名称", example = "房山区园林所")
+        private String parentTeamName;
+
+        @Schema(description = "班组长姓名", example = "张三")
+        private String leaderName;
+
+        @Schema(description = "班组人数", example = "15")
+        private Long totalMembers;
+
+        @Schema(description = "考核得分")
+        private ScoreVO score;
+
+        @Schema(description = "工单统计")
+        private OrderStatsVO orderStats;
+
+        @Schema(description = "考勤统计")
+        private AttendanceStatsVO attendanceStats;
+
+        @Schema(description = "耗材统计")
+        private MaterialStatsVO materialStats;
+
+        @Schema(description = "人员列表（第二层）")
+        private List<MemberVO> members;
+
+        @Schema(description = "工单列表（第二层）")
+        private List<OrderVO> orders;
+    }
+
+    // ==================== 考核得分 ====================
+
+    @Data
+    public static class ScoreVO {
+        @Schema(description = "总分", example = "85")
+        private Integer total;
+
+        @Schema(description = "工单得分（满分40）", example = "34")
+        private Integer orderScore;
+
+        @Schema(description = "考勤得分（满分30）", example = "25")
+        private Integer attendanceScore;
+
+        @Schema(description = "人机材得分（满分30）", example = "26")
+        private Integer materialScore;
+
+        @Schema(description = "扣分明细")
+        private List<DeductionVO> deductions;
+    }
+
+    @Data
+    public static class DeductionVO {
+        @Schema(description = "扣分规则", example = "工单超时>2小时")
+        private String rule;
+
+        @Schema(description = "触发次数", example = "2")
+        private Integer count;
+
+        @Schema(description = "扣分", example = "-2")
+        private Integer points;
+    }
+
+    // ==================== 工单统计 ====================
+
+    @Data
+    public static class OrderStatsVO {
+        @Schema(description = "总工单数", example = "45")
+        private Long totalOrders;
+
+        @Schema(description = "已完成工单数", example = "42")
+        private Long completedOrders;
+
+        @Schema(description = "完成率(%)", example = "93.3")
+        private BigDecimal completionRate;
+
+        @Schema(description = "线上化率(%)", example = "97.8")
+        private BigDecimal onlineRate;
+
+        @Schema(description = "30分钟内响应数", example = "40")
+        private Long responseWithin30Min;
+
+        @Schema(description = "30分钟响应率(%)", example = "88.9")
+        private BigDecimal responseRate30Min;
+
+        @Schema(description = "超期工单数", example = "2")
+        private Long overdueOrders;
+
+        @Schema(description = "超24小时补录工单数", example = "1")
+        private Long lateSupplementOrders;
+    }
+
+    // ==================== 考勤统计 ====================
+
+    @Data
+    public static class AttendanceStatsVO {
+        @Schema(description = "总打卡次数", example = "570")
+        private Long totalCheckins;
+
+        @Schema(description = "缺勤人次", example = "5")
+        private Long absentCount;
+
+        @Schema(description = "未触发电子围栏打卡次数", example = "3")
+        private Long missedCheckinCount;
+
+        @Schema(description = "轨迹覆盖率不达标次数", example = "1")
+        private Long trajectoryLowCount;
+
+        @Schema(description = "缺共同处理人次数", example = "0")
+        private Long missingCoHandlerCount;
+
+        @Schema(description = "未佩戴工卡次数", example = "0")
+        private Long missingCardCount;
+
+        @Schema(description = "是否存在一人多卡违规", example = "false")
+        private Boolean multiCardViolation;
+
+        @Schema(description = "班组长记录仪未开机次数", example = "0")
+        private Long leaderRecorderOffCount;
+    }
+
+    // ==================== 耗材统计 ====================
+
+    @Data
+    public static class MaterialStatsVO {
+        @Schema(description = "已上报耗材的工单数", example = "42")
+        private Long ordersWithMaterial;
+
+        @Schema(description = "缺耗材上报的工单数", example = "1")
+        private Long ordersMissingMaterial;
+
+        @Schema(description = "耗材总用量", example = "230")
+        private Long totalMaterialItems;
+
+        @Schema(description = "耗材种类数", example = "15")
+        private Long materialTypes;
+    }
+
+    // ==================== 人员（第二层） ====================
+
+    @Data
+    public static class MemberVO {
+        @Schema(description = "人员ID", example = "1001")
+        private Long userId;
+
+        @Schema(description = "姓名", example = "张三")
+        private String userName;
+
+        @Schema(description = "手机号", example = "13800138000")
+        private String mobile;
+
+        @Schema(description = "岗位名称", example = "班组长,技术员")
+        private String postNames;
+
+        @Schema(description = "工卡号", example = "DEV001")
+        private String cardNumber;
+
+        @Schema(description = "是否内部人员", example = "1")
+        private Integer isInner;
+
+        @Schema(description = "个人考核指标")
+        private PersonalScoreVO personalScore;
+
+        @Schema(description = "考勤明细 / 第三层（includeDetail=true 时返回）")
+        private List<AttendanceRecordVO> attendances;
+
+        @Schema(description = "个人工单 / 第三层（includeDetail=true 时返回）")
+        private List<OrderVO> orders;
+    }
+
+    @Data
+    public static class PersonalScoreVO {
+        @Schema(description = "出勤天数", example = "28")
+        private Long attendanceDays;
+
+        @Schema(description = "迟到次数", example = "0")
+        private Long lateCount;
+
+        @Schema(description = "缺勤次数", example = "0")
+        private Long absentCount;
+
+        @Schema(description = "承担工单数", example = "8")
+        private Long assignedOrders;
+
+        @Schema(description = "完成工单数", example = "8")
+        private Long completedOrders;
+
+        @Schema(description = "完成率(%)", example = "100.0")
+        private BigDecimal completionRate;
+
+        @Schema(description = "超期工单数", example = "0")
+        private Long overdueOrders;
+
+        @Schema(description = "已上报耗材工单数", example = "8")
+        private Long materialReported;
+
+        @Schema(description = "缺耗材上报工单数", example = "0")
+        private Long materialMissing;
+    }
+
+    @Data
+    public static class AttendanceRecordVO {
+        @Schema(description = "打卡类型", example = "上班")
+        private String punchType;
+
+        @Schema(description = "打卡时间", example = "2026-06-25 08:00:00")
+        @JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, timezone = TIME_ZONE_DEFAULT)
+        private LocalDateTime punchTime;
+
+        @Schema(description = "打卡地址", example = "北京市房山区xx路")
+        private String address;
+    }
+
+    // ==================== 工单（第二层/第三层） ====================
+
+    @Data
+    public static class OrderVO {
+        @Schema(description = "工单号", example = "WO202606250001")
+        private String orderNo;
+
+        @Schema(description = "工单名称", example = "树木修剪")
+        private String orderName;
+
+        @Schema(description = "工单类型", example = "C")
+        private String orderType;
+
+        @Schema(description = "接单人姓名", example = "张三")
+        private String workerName;
+
+        @Schema(description = "审批状态", example = "1")
+        private Integer status;
+
+        @Schema(description = "业务状态", example = "completed")
+        private String buzStatus;
+
+        @Schema(description = "发布时间", example = "2026-06-25 09:00:00")
+        @JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, timezone = TIME_ZONE_DEFAULT)
+        private LocalDateTime commitDate;
+
+        @Schema(description = "完成时间", example = "2026-06-25 16:30:00")
+        @JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, timezone = TIME_ZONE_DEFAULT)
+        private LocalDateTime finishDate;
+
+        @Schema(description = "期望完成时间", example = "2026-06-25 18:00:00")
+        @JsonFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, timezone = TIME_ZONE_DEFAULT)
+        private LocalDateTime expectedFinishDate;
+
+        @Schema(description = "响应时长（分钟）", example = "15")
+        private Long responseMinutes;
+
+        @Schema(description = "是否超期", example = "false")
+        private Boolean isOverdue;
+
+        @Schema(description = "是否超24小时补录", example = "false")
+        private Boolean isLateSupplement;
+
+        @Schema(description = "是否已上报耗材", example = "true")
+        private Boolean hasMaterialReported;
+
+        @Schema(description = "共同处理人姓名")
+        private List<String> coHandlers;
+
+        @Schema(description = "耗材明细 / 第三层（includeDetail=true 时返回）")
+        private List<MaterialVO> materials;
+    }
+
+    @Data
+    public static class MaterialVO {
+        @Schema(description = "耗材名称", example = "高效氯氰菊酯")
+        private String materialName;
+
+        @Schema(description = "规格", example = "500ml/瓶")
+        private String specifications;
+
+        @Schema(description = "使用数量", example = "2")
+        private Long userCount;
+
+        @Schema(description = "单位", example = "瓶")
+        private String unitName;
+
+        @Schema(description = "分类", example = "药品")
+        private String classifyName;
+    }
+
+    // ==================== 人员模式 ====================
+
+    @Data
+    public static class StaffVO {
+        @Schema(description = "人员ID", example = "1001")
+        private Long userId;
+
+        @Schema(description = "姓名", example = "张三")
+        private String userName;
+
+        @Schema(description = "手机号", example = "13800138000")
+        private String mobile;
+
+        @Schema(description = "部门ID", example = "100")
+        private Long deptId;
+
+        @Schema(description = "部门名称", example = "养护一班")
+        private String deptName;
+
+        @Schema(description = "岗位名称", example = "班组长")
+        private String postNames;
+
+        @Schema(description = "工卡号", example = "DEV001")
+        private String cardNumber;
+
+        @Schema(description = "是否内部人员", example = "1")
+        private Integer isInner;
+
+        @Schema(description = "个人考核汇总")
+        private PersonalScoreVO assessment;
+
+        @Schema(description = "考勤明细")
+        private List<AttendanceRecordVO> attendances;
+
+        @Schema(description = "工单列表（含耗材）")
+        private List<OrderVO> orders;
+    }
+}
@@ -8,6 +8,8 @@ import com.zteits.urbanops.module.garden.controller.open.staff.vo.StaffQueryReqV
 import com.zteits.urbanops.module.garden.controller.open.staff.vo.StaffQueryRespVO;
 import com.zteits.urbanops.module.garden.controller.open.task.vo.TaskQueryReqVO;
 import com.zteits.urbanops.module.garden.controller.open.task.vo.TaskQueryRespVO;
+import com.zteits.urbanops.module.garden.controller.open.assessment.vo.TeamAssessmentReqVO;
+import com.zteits.urbanops.module.garden.controller.open.assessment.vo.TeamAssessmentRespVO;
 import com.zteits.urbanops.module.garden.controller.open.team.vo.TeamQueryReqVO;
 import com.zteits.urbanops.module.garden.controller.open.team.vo.TeamQueryRespVO;
@@ -15,6 +17,8 @@ import java.util.List;
 public interface OpenApiService {
+    TeamAssessmentRespVO queryTeamAssessment(TeamAssessmentReqVO reqVO);
+
     List<StaffQueryRespVO> queryStaffList(StaffQueryReqVO reqVO);
     List<TeamQueryRespVO> queryTeamList(TeamQueryReqVO reqVO);
@@ -3,6 +3,8 @@ package com.zteits.urbanops.module.garden.controller.open.service;
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.StrUtil;
 import com.zteits.urbanops.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.zteits.urbanops.module.garden.controller.open.assessment.vo.TeamAssessmentReqVO;
+import com.zteits.urbanops.module.garden.controller.open.assessment.vo.TeamAssessmentRespVO;
 import com.zteits.urbanops.module.garden.controller.open.attendance.vo.AttendanceQueryReqVO;
 import com.zteits.urbanops.module.garden.controller.open.attendance.vo.AttendanceQueryRespVO;
 import com.zteits.urbanops.module.garden.controller.open.material.vo.MaterialQueryReqVO;
@@ -33,6 +35,12 @@ import jakarta.annotation.Resource;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.Duration;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
 import java.util.*;
 import java.util.stream.Collectors;
@@ -379,4 +387,569 @@ public class OpenApiServiceImpl implements OpenApiService {
         }
         return voList;
     }
+
+    // ==================== 团队考核聚合查询 ====================
+
+    @Override
+    public TeamAssessmentRespVO queryTeamAssessment(TeamAssessmentReqVO reqVO) {
+        String queryMode = StrUtil.blankToDefault(reqVO.getQueryMode(), "team");
+        LocalDate startDate = reqVO.getStartDate() != null ? reqVO.getStartDate()
+                : LocalDate.now().withDayOfMonth(1);
+        LocalDate endDate = reqVO.getEndDate() != null ? reqVO.getEndDate() : LocalDate.now();
+        boolean includeDetail = Boolean.TRUE.equals(reqVO.getIncludeDetail());
+        LocalDateTime startDateTime = startDate.atStartOfDay();
+        LocalDateTime endDateTime = endDate.plusDays(1).atStartOfDay();
+
+        TeamAssessmentRespVO resp = new TeamAssessmentRespVO();
+        resp.setQueryMode(queryMode);
+        TeamAssessmentRespVO.PeriodVO period = new TeamAssessmentRespVO.PeriodVO();
+        period.setStart(startDate);
+        period.setEnd(endDate);
+        resp.setPeriod(period);
+
+        String keyword = reqVO.getKeyword();
+        if (StrUtil.isBlank(keyword)) {
+            return resp;
+        }
+
+        if ("staff".equals(queryMode)) {
+            resp.setStaffList(buildStaffAssessment(keyword, startDateTime, endDateTime, includeDetail));
+        } else {
+            resp.setTeams(buildTeamAssessment(keyword, startDateTime, endDateTime, includeDetail));
+        }
+        return resp;
+    }
+
+    // ==================== 班组考核构建 ====================
+
+    private List<TeamAssessmentRespVO.TeamVO> buildTeamAssessment(
+            String keyword, LocalDateTime startDateTime, LocalDateTime endDateTime, boolean includeDetail) {
+
+        // 1. 按班组名称模糊查询
+        List<DeptDO> deptList = deptMapper.selectList(
+                new LambdaQueryWrapperX<DeptDO>()
+                        .like(DeptDO::getName, keyword)
+                        .eq(DeptDO::getStatus, 0));
+        if (CollUtil.isEmpty(deptList)) {
+            return Collections.emptyList();
+        }
+
+        Set<Long> deptIds = deptList.stream().map(DeptDO::getId).collect(Collectors.toSet());
+
+        // 2. 批量查父部门名、班组长名
+        Set<Long> parentIds = deptList.stream().map(DeptDO::getParentId)
+                .filter(Objects::nonNull).filter(id -> id > 0).collect(Collectors.toSet());
+        Map<Long, String> parentNameMap = CollUtil.isNotEmpty(parentIds)
+                ? deptMapper.selectList(DeptDO::getId, parentIds).stream()
+                        .collect(Collectors.toMap(DeptDO::getId, DeptDO::getName, (a, b) -> a))
+                : Collections.emptyMap();
+        Set<Long> leaderIds = deptList.stream().map(DeptDO::getLeaderUserId)
+                .filter(Objects::nonNull).collect(Collectors.toSet());
+        Map<Long, String> leaderNameMap = CollUtil.isNotEmpty(leaderIds)
+                ? adminUserMapper.selectList(AdminUserDO::getId, leaderIds).stream()
+                        .collect(Collectors.toMap(AdminUserDO::getId, AdminUserDO::getNickname, (a, b) -> a))
+                : Collections.emptyMap();
+
+        // 3. 批量查所有成员
+        List<AdminUserDO> allMembers = adminUserMapper.selectList(
+                new LambdaQueryWrapperX<AdminUserDO>().in(AdminUserDO::getDeptId, deptIds));
+        Map<Long, List<AdminUserDO>> deptMemberMap = allMembers.stream()
+                .collect(Collectors.groupingBy(AdminUserDO::getDeptId));
+        Set<Long> allUserIds = allMembers.stream().map(AdminUserDO::getId).collect(Collectors.toSet());
+
+        // 4. 批量查岗位名、工卡号
+        Map<Long, String> postNameMap = buildPostNameMap(allMembers);
+        Map<Long, String> cardNumberMap = buildCardNumberMap(allUserIds);
+
+        // 5. 批量查考勤记录
+        List<DeviceClockRecordDO> allClockRecords;
+        Map<Long, List<DeviceClockRecordDO>> userClockMap;
+        if (CollUtil.isNotEmpty(allUserIds)) {
+            allClockRecords = deviceClockRecordMapper.selectList(
+                    new LambdaQueryWrapperX<DeviceClockRecordDO>()
+                            .in(DeviceClockRecordDO::getUserId, allUserIds)
+                            .between(DeviceClockRecordDO::getCreateTime, startDateTime, endDateTime));
+            userClockMap = allClockRecords.stream()
+                    .collect(Collectors.groupingBy(DeviceClockRecordDO::getUserId));
+        } else {
+            allClockRecords = Collections.emptyList();
+            userClockMap = Collections.emptyMap();
+        }
+
+        // 6. 批量查工单（按实施人员ID或部门ID）
+        List<MainInfoDO> allOrders = mainInfoMapper.selectList(
+                new LambdaQueryWrapperX<MainInfoDO>()
+                        .in(MainInfoDO::getDeptId, deptIds)
+                        .between(MainInfoDO::getCommitDate, startDateTime, endDateTime));
+        Map<Long, List<MainInfoDO>> deptOrderMap = allOrders.stream()
+                .collect(Collectors.groupingBy(MainInfoDO::getDeptId));
+
+        // 7. 批量查耗材
+        Set<String> allOrderNos = allOrders.stream().map(MainInfoDO::getOrderNo)
+                .filter(Objects::nonNull).collect(Collectors.toSet());
+        Map<String, List<MaterialDetailDO>> orderMaterialMap;
+        if (CollUtil.isNotEmpty(allOrderNos)) {
+            List<MaterialDetailDO> allMaterials = materialDetailMapper.selectList(
+                    new LambdaQueryWrapperX<MaterialDetailDO>().in(MaterialDetailDO::getOrderNo, allOrderNos));
+            orderMaterialMap = allMaterials.stream()
+                    .collect(Collectors.groupingBy(MaterialDetailDO::getOrderNo));
+        } else {
+            orderMaterialMap = Collections.emptyMap();
+        }
+
+        // 8. 构建每个班组的考核数据
+        List<TeamAssessmentRespVO.TeamVO> teams = new ArrayList<>();
+        for (DeptDO dept : deptList) {
+            TeamAssessmentRespVO.TeamVO team = new TeamAssessmentRespVO.TeamVO();
+            team.setTeamId(dept.getId());
+            team.setTeamName(dept.getName());
+            team.setParentTeamName(dept.getParentId() != null && dept.getParentId() > 0
+                    ? parentNameMap.getOrDefault(dept.getParentId(), "") : "");
+            team.setLeaderName(leaderNameMap.getOrDefault(dept.getLeaderUserId(), ""));
+
+            List<AdminUserDO> members = deptMemberMap.getOrDefault(dept.getId(), Collections.emptyList());
+            team.setTotalMembers((long) members.size());
+
+            // 班组工单
+            List<MainInfoDO> deptOrders = deptOrderMap.getOrDefault(dept.getId(), Collections.emptyList());
+            // 班组考勤（所有成员的打卡记录）
+            List<DeviceClockRecordDO> deptClocks = members.stream()
+                    .flatMap(m -> userClockMap.getOrDefault(m.getId(), Collections.emptyList()).stream())
+                    .collect(Collectors.toList());
+
+            // 计算考核得分和统计
+            computeTeamScore(team, deptOrders, deptClocks, members, orderMaterialMap,
+                    userClockMap, cardNumberMap, startDateTime, endDateTime);
+
+            // 构建成员列表
+            team.setMembers(buildMemberList(members, userClockMap, deptOrders, orderMaterialMap,
+                    postNameMap, cardNumberMap, startDateTime, endDateTime, includeDetail));
+
+            // 构建工单列表
+            team.setOrders(buildOrderList(deptOrders, orderMaterialMap, includeDetail));
+
+            teams.add(team);
+        }
+        return teams;
+    }
+
+    // ==================== 人员考核构建 ====================
+
+    private List<TeamAssessmentRespVO.StaffVO> buildStaffAssessment(
+            String keyword, LocalDateTime startDateTime, LocalDateTime endDateTime, boolean includeDetail) {
+
+        // 1. 按姓名或手机号模糊查询
+        List<AdminUserDO> userList = adminUserMapper.selectList(
+                new LambdaQueryWrapperX<AdminUserDO>()
+                        .like(AdminUserDO::getNickname, keyword)
+                        .or(w -> w.like(AdminUserDO::getMobile, keyword)));
+        if (CollUtil.isEmpty(userList)) {
+            return Collections.emptyList();
+        }
+
+        Set<Long> userIds = userList.stream().map(AdminUserDO::getId).collect(Collectors.toSet());
+
+        // 2. 批量查部门名、岗位名、工卡号
+        Set<Long> deptIds = userList.stream().map(AdminUserDO::getDeptId)
+                .filter(Objects::nonNull).collect(Collectors.toSet());
+        Map<Long, String> deptNameMap = CollUtil.isNotEmpty(deptIds)
+                ? deptMapper.selectList(DeptDO::getId, deptIds).stream()
+                        .collect(Collectors.toMap(DeptDO::getId, DeptDO::getName, (a, b) -> a))
+                : Collections.emptyMap();
+        Map<Long, String> postNameMap = buildPostNameMap(userList);
+        Map<Long, String> cardNumberMap = buildCardNumberMap(userIds);
+
+        // 3. 批量查考勤
+        List<DeviceClockRecordDO> allClocks = deviceClockRecordMapper.selectList(
+                new LambdaQueryWrapperX<DeviceClockRecordDO>()
+                        .in(DeviceClockRecordDO::getUserId, userIds)
+                        .between(DeviceClockRecordDO::getCreateTime, startDateTime, endDateTime));
+        Map<Long, List<DeviceClockRecordDO>> userClockMap = allClocks.stream()
+                .collect(Collectors.groupingBy(DeviceClockRecordDO::getUserId));
+
+        // 4. 批量查工单
+        List<MainInfoDO> allOrders = mainInfoMapper.selectList(
+                new LambdaQueryWrapperX<MainInfoDO>()
+                        .in(MainInfoDO::getWorkerId, userIds)
+                        .between(MainInfoDO::getCommitDate, startDateTime, endDateTime));
+        Map<Long, List<MainInfoDO>> userOrderMap = allOrders.stream()
+                .collect(Collectors.groupingBy(MainInfoDO::getWorkerId));
+
+        // 5. 批量查耗材
+        Set<String> allOrderNos2 = allOrders.stream().map(MainInfoDO::getOrderNo)
+                .filter(Objects::nonNull).collect(Collectors.toSet());
+        Map<String, List<MaterialDetailDO>> orderMaterialMap2;
+        if (CollUtil.isNotEmpty(allOrderNos2)) {
+            List<MaterialDetailDO> allMaterials = materialDetailMapper.selectList(
+                    new LambdaQueryWrapperX<MaterialDetailDO>().in(MaterialDetailDO::getOrderNo, allOrderNos2));
+            orderMaterialMap2 = allMaterials.stream()
+                    .collect(Collectors.groupingBy(MaterialDetailDO::getOrderNo));
+        } else {
+            orderMaterialMap2 = Collections.emptyMap();
+        }
+
+        // 6. 构建人员考核VO
+        List<TeamAssessmentRespVO.StaffVO> staffList = new ArrayList<>();
+        for (AdminUserDO user : userList) {
+            TeamAssessmentRespVO.StaffVO staff = new TeamAssessmentRespVO.StaffVO();
+            staff.setUserId(user.getId());
+            staff.setUserName(user.getNickname());
+            staff.setMobile(user.getMobile());
+            staff.setDeptId(user.getDeptId());
+            staff.setDeptName(deptNameMap.getOrDefault(user.getDeptId(), ""));
+            staff.setPostNames(postNameMap.getOrDefault(user.getId(), ""));
+            staff.setCardNumber(cardNumberMap.getOrDefault(user.getId(), ""));
+            staff.setIsInner(user.getIsInner());
+
+            List<DeviceClockRecordDO> clocks = userClockMap.getOrDefault(user.getId(), Collections.emptyList());
+            List<MainInfoDO> orders = userOrderMap.getOrDefault(user.getId(), Collections.emptyList());
+
+            // 个人考核指标
+            staff.setAssessment(buildPersonalScore(clocks, orders, orderMaterialMap2,
+                    startDateTime, endDateTime));
+
+            // 考勤明细
+            if (includeDetail) {
+                staff.setAttendances(buildAttendanceRecords(clocks));
+                staff.setOrders(buildOrderList(orders, orderMaterialMap2, true));
+            }
+
+            staffList.add(staff);
+        }
+        return staffList;
+    }
+
+    // ==================== 辅助方法 ====================
+
+    private void computeTeamScore(TeamAssessmentRespVO.TeamVO team,
+            List<MainInfoDO> orders, List<DeviceClockRecordDO> clocks,
+            List<AdminUserDO> members,
+            Map<String, List<MaterialDetailDO>> orderMaterialMap,
+            Map<Long, List<DeviceClockRecordDO>> userClockMap,
+            Map<Long, String> cardNumberMap,
+            LocalDateTime startDateTime, LocalDateTime endDateTime) {
+
+        int totalDays = (int) Math.max(1,
+                java.time.Duration.between(startDateTime, endDateTime).toDays());
+
+        // --- 工单统计 ---
+        long totalOrders = orders.size();
+        long completedOrders = orders.stream()
+                .filter(o -> "completed".equals(o.getBuzStatus())).count();
+        long overdueOrders = orders.stream()
+                .filter(o -> o.getExpectedFinishDate() != null && o.getFinishDate() != null
+                        && o.getFinishDate().isAfter(o.getExpectedFinishDate()))
+                .count();
+        long lateSupplementOrders = orders.stream()
+                .filter(o -> o.getCommitDate() != null && o.getCreateTime() != null
+                        && java.time.Duration.between(o.getCommitDate(), o.getCreateTime()).toHours() > 24)
+                .count();
+        long responseWithin30Min = orders.stream()
+                .filter(o -> o.getCommitDate() != null && o.getCreateTime() != null
+                        && java.time.Duration.between(o.getCreateTime(), o.getCommitDate()).toMinutes() <= 30)
+                .count();
+
+        TeamAssessmentRespVO.OrderStatsVO orderStats = new TeamAssessmentRespVO.OrderStatsVO();
+        orderStats.setTotalOrders(totalOrders);
+        orderStats.setCompletedOrders(completedOrders);
+        orderStats.setCompletionRate(totalOrders > 0
+                ? BigDecimal.valueOf(completedOrders * 100.0 / totalOrders).setScale(1, java.math.RoundingMode.HALF_UP)
+                : BigDecimal.ZERO);
+        orderStats.setOnlineRate(totalOrders > 0
+                ? BigDecimal.valueOf((totalOrders - lateSupplementOrders) * 100.0 / totalOrders)
+                        .setScale(1, java.math.RoundingMode.HALF_UP)
+                : BigDecimal.ZERO);
+        orderStats.setResponseWithin30Min(responseWithin30Min);
+        orderStats.setResponseRate30Min(totalOrders > 0
+                ? BigDecimal.valueOf(responseWithin30Min * 100.0 / totalOrders)
+                        .setScale(1, java.math.RoundingMode.HALF_UP)
+                : BigDecimal.ZERO);
+        orderStats.setOverdueOrders(overdueOrders);
+        orderStats.setLateSupplementOrders(lateSupplementOrders);
+        team.setOrderStats(orderStats);
+
+        // --- 考勤统计 ---
+        int totalMembers = members.size();
+        long totalCheckins = clocks.size();
+        // 缺勤：每个成员应有2次/天，缺少的算缺勤
+        int expectedCheckinsPerPerson = totalDays * 2;
+        long absentCount = Math.max(0,
+                (long) totalMembers * expectedCheckinsPerPerson - totalCheckins) / 2;
+        // 未打卡：无工卡绑定的成员
+        long missingCardCount = members.stream()
+                .filter(m -> StrUtil.isBlank(cardNumberMap.getOrDefault(m.getId(), "")))
+                .count();
+        // 缺共同处理人：>2人任务但co_handlers为空
+        long missingCoHandlerCount = orders.stream()
+                .filter(o -> CollUtil.isEmpty(o.getCoHandlers()))
+                .count();
+        // 轨迹覆盖率不达标（暂用打卡次数<天数的用户数近似）
+        long trajectoryLowCount = members.stream()
+                .filter(m -> {
+                    List<DeviceClockRecordDO> uc = userClockMap.getOrDefault(m.getId(), Collections.emptyList());
+                    return uc.size() < totalDays;
+                })
+                .count();
+        // 一人多卡违规（同一天同一用户多张卡打卡）
+        boolean multiCardViolation = false;
+        for (List<DeviceClockRecordDO> uc : userClockMap.values()) {
+            Map<java.time.LocalDate, List<DeviceClockRecordDO>> byDay = uc.stream()
+                    .collect(Collectors.groupingBy(c -> c.getCreateTime().toLocalDate()));
+            for (List<DeviceClockRecordDO> dayRecords : byDay.values()) {
+                Set<String> devices = dayRecords.stream()
+                        .map(DeviceClockRecordDO::getDeviceCode)
+                        .filter(Objects::nonNull).collect(Collectors.toSet());
+                if (devices.size() > 2) { multiCardViolation = true; break; }
+            }
+            if (multiCardViolation) break;
+        }
+
+        TeamAssessmentRespVO.AttendanceStatsVO attStats = new TeamAssessmentRespVO.AttendanceStatsVO();
+        attStats.setTotalCheckins(totalCheckins);
+        attStats.setAbsentCount(absentCount);
+        attStats.setMissedCheckinCount(absentCount); // 缺勤=未打卡近似
+        attStats.setTrajectoryLowCount(trajectoryLowCount);
+        attStats.setMissingCoHandlerCount(missingCoHandlerCount);
+        attStats.setMissingCardCount(missingCardCount);
+        attStats.setMultiCardViolation(multiCardViolation);
+        attStats.setLeaderRecorderOffCount(0L); // 记录仪数据暂不可用
+        team.setAttendanceStats(attStats);
+
+        // --- 耗材统计 ---
+        long ordersWithMaterial = orders.stream()
+                .filter(o -> orderMaterialMap.containsKey(o.getOrderNo())).count();
+        long ordersMissingMaterial = totalOrders - ordersWithMaterial;
+        long totalMaterialItems = orderMaterialMap.values().stream()
+                .flatMap(List::stream).mapToLong(m -> m.getUserCount() != null ? m.getUserCount() : 0).sum();
+        long materialTypes = orderMaterialMap.values().stream()
+                .flatMap(List::stream).map(MaterialDetailDO::getTypeName)
+                .filter(Objects::nonNull).distinct().count();
+
+        TeamAssessmentRespVO.MaterialStatsVO matStats = new TeamAssessmentRespVO.MaterialStatsVO();
+        matStats.setOrdersWithMaterial(ordersWithMaterial);
+        matStats.setOrdersMissingMaterial(ordersMissingMaterial);
+        matStats.setTotalMaterialItems(totalMaterialItems);
+        matStats.setMaterialTypes(materialTypes);
+        team.setMaterialStats(matStats);
+
+        // --- 考核得分计算 ---
+        // 工单得分（40分）
+        int orderDeduction = (int) (lateSupplementOrders * 1 + overdueOrders * 1);
+        int orderScore = Math.max(0, 40 - orderDeduction);
+
+        // 考勤得分（30分）
+        int attDeduction = (int) (absentCount * 1 + missingCoHandlerCount * 1
+                + missingCardCount * 1 + attStats.getLeaderRecorderOffCount() * 1);
+        int attScore = Math.max(0, 30 - attDeduction);
+
+        // 人机材得分（30分）
+        int matDeduction = (int) (ordersMissingMaterial * 2);
+        int matScore = Math.max(0, 30 - matDeduction);
+
+        int totalScore = orderScore + attScore + matScore;
+
+        TeamAssessmentRespVO.ScoreVO score = new TeamAssessmentRespVO.ScoreVO();
+        score.setTotal(totalScore);
+        score.setOrderScore(orderScore);
+        score.setAttendanceScore(attScore);
+        score.setMaterialScore(matScore);
+
+        List<TeamAssessmentRespVO.DeductionVO> deductions = new ArrayList<>();
+        if (lateSupplementOrders > 0) {
+            TeamAssessmentRespVO.DeductionVO d = new TeamAssessmentRespVO.DeductionVO();
+            d.setRule("工单超24小时补录"); d.setCount((int) lateSupplementOrders);
+            d.setPoints((int) -lateSupplementOrders); deductions.add(d);
+        }
+        if (overdueOrders > 0) {
+            TeamAssessmentRespVO.DeductionVO d = new TeamAssessmentRespVO.DeductionVO();
+            d.setRule("工单超时>2小时"); d.setCount((int) overdueOrders);
+            d.setPoints((int) -overdueOrders); deductions.add(d);
+        }
+        if (absentCount > 0) {
+            TeamAssessmentRespVO.DeductionVO d = new TeamAssessmentRespVO.DeductionVO();
+            d.setRule("缺勤/未打卡"); d.setCount((int) absentCount);
+            d.setPoints((int) -absentCount); deductions.add(d);
+        }
+        if (missingCoHandlerCount > 0) {
+            TeamAssessmentRespVO.DeductionVO d = new TeamAssessmentRespVO.DeductionVO();
+            d.setRule(">2人任务缺共同处理人"); d.setCount((int) missingCoHandlerCount);
+            d.setPoints((int) -missingCoHandlerCount); deductions.add(d);
+        }
+        if (missingCardCount > 0) {
+            TeamAssessmentRespVO.DeductionVO d = new TeamAssessmentRespVO.DeductionVO();
+            d.setRule("未佩戴工卡"); d.setCount((int) missingCardCount);
+            d.setPoints((int) -missingCardCount); deductions.add(d);
+        }
+        if (ordersMissingMaterial > 0) {
+            TeamAssessmentRespVO.DeductionVO d = new TeamAssessmentRespVO.DeductionVO();
+            d.setRule("人机材24h内未上报"); d.setCount((int) ordersMissingMaterial);
+            d.setPoints((int) (-ordersMissingMaterial * 2)); deductions.add(d);
+        }
+        score.setDeductions(deductions);
+        team.setScore(score);
+    }
+
+    private List<TeamAssessmentRespVO.MemberVO> buildMemberList(
+            List<AdminUserDO> members,
+            Map<Long, List<DeviceClockRecordDO>> userClockMap,
+            List<MainInfoDO> deptOrders,
+            Map<String, List<MaterialDetailDO>> orderMaterialMap,
+            Map<Long, String> postNameMap, Map<Long, String> cardNumberMap,
+            LocalDateTime startDateTime, LocalDateTime endDateTime,
+            boolean includeDetail) {
+
+        Map<Long, List<MainInfoDO>> userOrderMap = deptOrders.stream()
+                .collect(Collectors.groupingBy(MainInfoDO::getWorkerId));
+
+        List<TeamAssessmentRespVO.MemberVO> voList = new ArrayList<>();
+        for (AdminUserDO user : members) {
+            TeamAssessmentRespVO.MemberVO vo = new TeamAssessmentRespVO.MemberVO();
+            vo.setUserId(user.getId());
+            vo.setUserName(user.getNickname());
+            vo.setMobile(user.getMobile());
+            vo.setPostNames(postNameMap.getOrDefault(user.getId(), ""));
+            vo.setCardNumber(cardNumberMap.getOrDefault(user.getId(), ""));
+            vo.setIsInner(user.getIsInner());
+
+            List<DeviceClockRecordDO> clocks = userClockMap.getOrDefault(user.getId(), Collections.emptyList());
+            List<MainInfoDO> orders = userOrderMap.getOrDefault(user.getId(), Collections.emptyList());
+
+            // 个人考核指标
+            vo.setPersonalScore(buildPersonalScore(clocks, orders, orderMaterialMap,
+                    startDateTime, endDateTime));
+
+            // 明细
+            if (includeDetail) {
+                vo.setAttendances(buildAttendanceRecords(clocks));
+                vo.setOrders(buildOrderList(orders, orderMaterialMap, true));
+            }
+
+            voList.add(vo);
+        }
+        return voList;
+    }
+
+    private TeamAssessmentRespVO.PersonalScoreVO buildPersonalScore(
+            List<DeviceClockRecordDO> clocks, List<MainInfoDO> orders,
+            Map<String, List<MaterialDetailDO>> orderMaterialMap,
+            LocalDateTime startDateTime, LocalDateTime endDateTime) {
+
+        int totalDays = (int) Math.max(1,
+                java.time.Duration.between(startDateTime, endDateTime).toDays());
+
+        // 出勤天数（有打卡记录的天数）
+        long attendanceDays = clocks.stream()
+                .map(c -> c.getCreateTime().toLocalDate()).distinct().count();
+        // 迟到次数（上班打卡晚于9点的次数）
+        long lateCount = clocks.stream()
+                .filter(c -> "上班".equals(c.getPunchType()))
+                .filter(c -> c.getCreateTime().toLocalTime().isAfter(java.time.LocalTime.of(9, 0)))
+                .count();
+        long absentCount = Math.max(0, totalDays - attendanceDays);
+
+        long assignedOrders = orders.size();
+        long completedOrders = orders.stream()
+                .filter(o -> "completed".equals(o.getBuzStatus())).count();
+        long overdueOrders = orders.stream()
+                .filter(o -> o.getExpectedFinishDate() != null && o.getFinishDate() != null
+                        && o.getFinishDate().isAfter(o.getExpectedFinishDate()))
+                .count();
+        long materialReported = orders.stream()
+                .filter(o -> orderMaterialMap.containsKey(o.getOrderNo())).count();
+        long materialMissing = assignedOrders - materialReported;
+
+        TeamAssessmentRespVO.PersonalScoreVO score = new TeamAssessmentRespVO.PersonalScoreVO();
+        score.setAttendanceDays(attendanceDays);
+        score.setLateCount(lateCount);
+        score.setAbsentCount(absentCount);
+        score.setAssignedOrders(assignedOrders);
+        score.setCompletedOrders(completedOrders);
+        score.setCompletionRate(assignedOrders > 0
+                ? BigDecimal.valueOf(completedOrders * 100.0 / assignedOrders)
+                        .setScale(1, java.math.RoundingMode.HALF_UP)
+                : BigDecimal.ZERO);
+        score.setOverdueOrders(overdueOrders);
+        score.setMaterialReported(materialReported);
+        score.setMaterialMissing(materialMissing);
+        return score;
+    }
+
+    private List<TeamAssessmentRespVO.AttendanceRecordVO> buildAttendanceRecords(
+            List<DeviceClockRecordDO> clocks) {
+        return clocks.stream().map(c -> {
+            TeamAssessmentRespVO.AttendanceRecordVO vo = new TeamAssessmentRespVO.AttendanceRecordVO();
+            vo.setPunchType(c.getPunchType());
+            vo.setPunchTime(c.getCreateTime());
+            vo.setAddress(c.getAddress());
+            return vo;
+        }).collect(Collectors.toList());
+    }
+
+    private List<TeamAssessmentRespVO.OrderVO> buildOrderList(
+            List<MainInfoDO> orders,
+            Map<String, List<MaterialDetailDO>> orderMaterialMap,
+            boolean includeMaterial) {
+
+        return orders.stream().map(o -> {
+            TeamAssessmentRespVO.OrderVO vo = new TeamAssessmentRespVO.OrderVO();
+            vo.setOrderNo(o.getOrderNo());
+            vo.setOrderName(o.getOrderName());
+            vo.setOrderType(o.getOrderType());
+            vo.setWorkerName(o.getWorkerName());
+            vo.setStatus(o.getStatus());
+            vo.setBuzStatus(o.getBuzStatus());
+            vo.setCommitDate(o.getCommitDate());
+            vo.setFinishDate(o.getFinishDate());
+            vo.setExpectedFinishDate(o.getExpectedFinishDate());
+            // 响应时长
+            if (o.getCommitDate() != null && o.getCreateTime() != null) {
+                vo.setResponseMinutes(java.time.Duration.between(
+                        o.getCreateTime(), o.getCommitDate()).toMinutes());
+            }
+            vo.setIsOverdue(o.getExpectedFinishDate() != null && o.getFinishDate() != null
+                    && o.getFinishDate().isAfter(o.getExpectedFinishDate()));
+            vo.setIsLateSupplement(o.getCommitDate() != null && o.getCreateTime() != null
+                    && java.time.Duration.between(o.getCommitDate(), o.getCreateTime()).toHours() > 24);
+            vo.setHasMaterialReported(orderMaterialMap.containsKey(o.getOrderNo()));
+            if (CollUtil.isNotEmpty(o.getCoHandlers())) {
+                vo.setCoHandlers(new ArrayList<>(o.getCoHandlers().stream()
+                        .map(String::valueOf).collect(Collectors.toList())));
+            }
+            // 耗材
+            if (includeMaterial) {
+                List<MaterialDetailDO> mats = orderMaterialMap.getOrDefault(
+                        o.getOrderNo(), Collections.emptyList());
+                vo.setMaterials(mats.stream().map(m -> {
+                    TeamAssessmentRespVO.MaterialVO mv = new TeamAssessmentRespVO.MaterialVO();
+                    mv.setMaterialName(m.getMaterialName());
+                    mv.setSpecifications(m.getSpecifications());
+                    mv.setUserCount(m.getUserCount());
+                    mv.setUnitName(m.getUnitName());
+                    mv.setClassifyName(m.getClassifyName());
+                    return mv;
+                }).collect(Collectors.toList()));
+            }
+            return vo;
+        }).collect(Collectors.toList());
+    }
+
+    private Map<Long, String> buildPostNameMap(List<AdminUserDO> users) {
+        Set<Long> allPostIds = users.stream()
+                .filter(u -> CollUtil.isNotEmpty(u.getPostIds()))
+                .flatMap(u -> u.getPostIds().stream())
+                .collect(Collectors.toSet());
+        return CollUtil.isNotEmpty(allPostIds)
+                ? postMapper.selectList(PostDO::getId, allPostIds).stream()
+                        .collect(Collectors.toMap(PostDO::getId, PostDO::getName, (a, b) -> a))
+                : Collections.emptyMap();
+    }
+
+    private Map<Long, String> buildCardNumberMap(Set<Long> userIds) {
+        return CollUtil.isNotEmpty(userIds)
+                ? deviceUserMapper.selectList(
+                        new LambdaQueryWrapperX<DeviceUserDO>().in(DeviceUserDO::getUserId, userIds))
+                        .stream().collect(Collectors.toMap(DeviceUserDO::getUserId,
+                                d -> StrUtil.blankToDefault(d.getDeviceNo(), ""), (a, b) -> a))
+                : Collections.emptyMap();
+    }
 }