docs: add team-report PPT design spec

docs/superpowers/specs/2026-05-27-team-report-ppt-design.md

@@ -0,0 +1,270 @@
+# 团队阶段性汇报 PPT 设计文档
+
+> 生成日期：2026-05-27  
+> 参考来源：boss-report.html、project-overview.html
+
+---
+
+## 目标
+
+将现有 boss-report.html 和 project-overview.html 的内容重新组织，生成一份面向**跨团队 Leader / 中层管理者**的团队阶段性汇报 PPT，输出格式为 `.pptx`。
+
+**与 boss-report.pptx 的核心差异：**
+- 增加"负责角色"维度，体现团队分工
+- 第9张改为"下阶段重点 & 分工"，含角色分工明细
+- 结尾改为 Q&A 互动页
+- 去掉纯技术实现细节（不过深）
+
+---
+
+## 视觉规范
+
+**尺寸：** LAYOUT_WIDE — 13.33" × 7.5"
+
+**配色（与 boss-report.html 一致）：**
+
+| 变量 | 颜色值 | 用途 |
+|------|--------|------|
+| accent | `E20074` | 品牌主色，标题/高亮/border |
+| accent-dk | `BE0060` | 深品牌色，hover/渐变终点 |
+| bg | `F7F7FA` | 页面背景 |
+| bg-card | `FFFFFF` | 卡片背景 |
+| bg-hover | `F0F0F5` | 分隔/hover |
+| text | `1A1A2E` | 主文字 |
+| text2 | `4A4A6A` | 次级文字 |
+| text3 | `8888AA` | 辅助/标注 |
+| green | `00896A` | 已完成/成功 |
+| orange | `CC6200` | 进行中/警告 |
+| blue | `2A68C8` | 信息/API |
+| purple | `5A46B4` | 基础设施 |
+| border | `E0E0EA` | 边框 |
+
+**字体：** Calibri（标题），Calibri Light（正文）  
+**注意：** pptxgenjs 颜色不加 `#` 前缀；使用 `makeShadow()` 工厂函数避免对象复用 bug。
+
+---
+
+## 幻灯片详细规格
+
+### Slide 1 — 封面
+
+**布局：** 左侧品牌色竖栏（宽 3.2"） + 右侧内容区
+
+**左栏（深色品牌色竖栏）：**
+- 背景：渐变 `B0005A` → `E20074`，宽 3.2"，全高
+- 垂直居中：
+  - 项目英文副标题：`EMS & EHS Compliance Intelligence Hub`，白色，14pt，斜体
+  - 大标题：`AI + 合规智能中枢`，白色，28pt，bold
+  - 分隔线：白色，opacity 40%
+  - 团队标注：`T-Systems · AI 合规项目组`，白色，11pt
+  - 日期：`2026 年 05 月`，白色，11pt
+
+**右侧内容区（x=3.4"）：**
+- 标签：`TEAM PROGRESS REPORT`，品牌色，10pt，letter-spacing
+- 副标题：`团队阶段性汇报`，深色，32pt，bold
+- 说明文字：`基于 Agent 协同的多模块法规合规智能平台`，text2，13pt
+- 3个数字指标卡（横排）：
+  - `5` / 功能模块 / 品牌色
+  - `17+` / REST API 接口 / green
+  - `6+` / 法规来源覆盖 / orange
+- 底部：`INTERNAL · CONFIDENTIAL`，text3，9pt
+
+---
+
+### Slide 2 — 项目背景
+
+**sectionLabel：** 项目背景  
+**title：** 为什么要做这个系统？  
+**sub：** 汽车行业合规管理三大核心痛点，传统人工方式已无法满足
+
+**3列卡片，各含顶部彩色3px条：**
+
+| 卡片 | 顶色 | 图标 | 标题 | 内容 |
+|------|------|------|------|------|
+| 1 | 品牌色渐变 | 📋 | 法规碎片化 | GB、MIIT、UN-ECE、IATF 16949、ISO 45001、EUR-Lex 等多源法规并存，更新频繁，人工跟踪极易遗漏，合规窗口期短 |
+| 2 | orange渐变 | ⏱ | 响应周期长 | 从法规发布到内部解读、影响评估、整改计划，人工流程往往需要数周，无法满足快速迭代的合规要求 |
+| 3 | green渐变 | 💼 | 人工成本高 | 合规专家大量时间消耗在文档检索、条款比对、报告撰写等重复性工作上，高价值判断时间被严重压缩 |
+
+---
+
+### Slide 3 — 本阶段工作总览
+
+**sectionLabel：** 阶段成果  
+**title：** 本阶段工作总览  
+**sub：** 5 个功能模块 · 核心 Agent 问答链路全通
+
+**5行模块表格，每行含：**
+- 左侧：图标圆角方块 + 模块名 + 编号
+- 中间：功能描述（1-2句）
+- 右侧：状态 badge + 负责角色
+
+| # | 图标 | 模块 | 简述 | 状态 | 负责角色 |
+|---|------|------|------|------|---------|
+| 01 | 📡 | 法规智能感知 | 六大法规源事件流，影响分级，SSE流式AI解读 | ⟳ 进行中 (orange) | 前端工程师 / 后端工程师 |
+| 02 | 📚 | 文档知识库管理 | PDF/Word入库，5步Pipeline，双引擎OCR解析 | ⟳ 进行中 (orange) | 后端工程师 / AI工程师 |
+| 03 | 🔍 | 合规分析审查 | 逐段风险评分，内嵌Agent对话，风险仪表盘 | ⟳ 进行中 (orange) | 全栈工程师 |
+| 04 | 💬 | 法规 Agent 对话 | Milvus向量检索+LLM全链路贯通，多轮追问 | ✓ 核心链路已通 (green) | AI工程师 / 后端工程师 |
+| 05 | 🖥️ | 系统状态监控 | 五项基础设施健康检查，17+ API，配置总览 | ✓ 已完成 (green) | 后端工程师 / 运维 |
+
+---
+
+### Slide 4 — 核心功能演示 1/2
+
+**sectionLabel：** 产品演示  
+**title：** 核心功能一览（1/2）  
+**sub：** 前3个模块已上线，功能可演示
+
+**3列功能卡，每卡含：**
+- 上方缩略图区（高 1.5"，浅色渐变背景 + 大图标 + 标签）
+- 下方：模块名（bold）+ 描述文字
+
+| 模块 | 缩略图色 | 图标 | 特色标签 | 描述 |
+|------|---------|------|---------|------|
+| 法规智能感知 | `#FCE8F3` → `#FCD5E8` | 📡 | 高/中/低影响 · LIVE | 六大法规源实时事件流，影响等级分级过滤，选中事件触发SSE流式AI影响分析 |
+| 文档知识库管理 | `#EEF2FD` → `#DCE8FB` | 📚 | LOAD→PARSE→CHUNK→EMBED→STORE | PDF/Word上传入库，5步Pipeline可视化，双引擎解析，文档列表管理 |
+| 合规分析审查 | `#FFF5E8` → `#FDE8CC` | 🔍 | ⚠ 高风险 · ✓ 合规 | 上传文件逐段风险评分，内嵌Agent对话针对具体条款实时问答，风险聚合仪表盘 |
+
+---
+
+### Slide 5 — 核心功能演示 2/2
+
+**sectionLabel：** 产品演示  
+**title：** 核心功能一览（2/2）  
+**sub：** Agent 对话核心链路真实运行，监控模块已完成
+
+**布局：左宽（2/3）+ 右窄（1/3）**
+
+**左宽卡 — 法规 Agent 对话（✓ 核心链路已通）：**
+- 缩略图：`#E8F5EF` → `#D0EDE2`，内含示例对话条
+- 示例文字：`"GB 18384 对我们的 BMS 设计有什么影响？" → Agent 检索 Milvus → 流式回答 + 来源引用`
+- 右侧5个组件badge：Milvus向量库 / MinIO对象库 / Embedding引擎 / Reranker / Sessions会话
+- 描述：真实 Milvus 向量检索 + LLM 流式输出全链路贯通；会话管理、来源归因卡片、多轮追问
+
+**右窄卡 — 系统状态监控（✓ 已完成）：**
+- 缩略图：`#F0ECFF` → `#E2D8FF`，内含健康检查badge（Milvus✓/MinIO✓/LLM✓）
+- 描述：五项基础设施实时健康检查，文档统计，系统配置总览
+
+---
+
+### Slide 6 — 系统架构
+
+**sectionLabel：** 技术架构  
+**title：** 系统分层架构  
+**sub：** 清洁架构 + Ports & Adapters，5 层分离，高内聚低耦合
+
+**5层堆叠图，每层含顶部渐变色 header + 内容 tags：**
+
+| 层 | 渐变色 | 图标 | 层名 | 副标题 | Tags |
+|----|--------|------|------|--------|------|
+| 用户层 | `B0005A`→`E20074` | 👥 | 用户层 | 合规专员/EHS专员/审核员/管理员 | 法规感知、文档分析、EHS合规、API集成、报告生成 |
+| 前端层 | `00A080`→`00D4AA` | 🖥️ | 前端层 | React 19 · TypeScript · Vite · React Router v7 | KeepAlive路由、三主题系统(Dark/Dim/Light)、shadcn/ui组件库、Tailwind v4 |
+| API层 | `2060A0`→`4A90D9` | ⚡ | API 层 | FastAPI · kbmp-service · mcp-server · Worker | 知识库管理API、合规检查API、文档解析API、检索问答API、订阅推送API |
+| AI引擎层 | `C05000`→`FF8800` | 🧠 | AI 引擎层 | Agent Orchestration · LLM · Embedding · Tools | Qwen/DeepSeek LLM、Agent协同编排、向量知识检索、工具调用(Tool Use)、阿里云DocMind OCR |
+| 基础设施层 | `5040B0`→`7B68EE` | 🗄️ | 基础设施层 | Milvus · PostgreSQL · MinIO · Prometheus · Grafana | Milvus向量数据库、PostgreSQL结构化存储、对象存储(文档/Markdown)、Prometheus+Grafana |
+
+层间用 `↕` 符号（品牌色）连接。
+
+---
+
+### Slide 7 — 业务价值
+
+**sectionLabel：** 业务价值  
+**title：** 有与没有的差距  
+**sub：** 量化对比：AI 智能中枢 vs 传统人工合规方式
+
+**左右对比框（3:1:3 比例）：**
+
+左侧（传统方式，浅红背景）：
+- 标题：❌ 传统人工方式（红色）
+- 5条对比项：数周法规解读 / 人工检索易遗漏 / 碎片化孤岛 / 高成本重复劳动 / 被动响应
+
+中间：`→`（品牌色箭头）
+
+右侧（AI平台，浅绿背景）：
+- 标题：✅ AI+合规智能中枢（绿色）
+- 5条对比项：分钟级响应 / Agent智能协同精准 / 统一平台多源融合 / 降低重复劳动70%+ / 主动预警订阅推送
+
+**底部4个KPI数字卡（横排）：**
+- `70%+` 重复性工作减少（品牌色）
+- `分钟级` 法规响应时间（green）
+- `6+` 法规源统一管理（orange）
+- `5` 业务场景覆盖（blue）
+
+---
+
+### Slide 8 — 四阶段路线图
+
+**sectionLabel：** 发展路线  
+**title：** 四阶段推进计划  
+**sub：** 当前处于第二阶段"Demo 打磨"，核心 Agent 链路已通，正在补全剩余模块
+
+**时间线设计：**
+- 顶部横线：左25% green，右25% 品牌色（进行中），后50% border色
+- 4个节点圆圈 + 下方内容卡
+
+| 阶段 | 圆圈 | 卡片border | 状态标 | 标题 | 要点 |
+|------|------|-----------|--------|------|------|
+| 01 | ✓ green | green | 已完成 | 技术验证 POC | 清洁架构+Ports&Adapters / Agent协同框架 / Milvus向量链路打通 / 前后端结构建立 |
+| 02 | ⟳ 品牌色(pulsing) | 品牌色(2px) | 进行中◀当前 | Demo 打磨 | 5页面前端上线 / Agent对话全通 / Pipeline已通 / EHS合规&监控开发中 |
+| 03 | 3 灰色 | border | 待启动 | 生产部署 | PLM/ERP/MES集成 / Agent扩展 / Milvus集群化 / 合规&监控完善 |
+| 04 | 4 灰色 | border | 待启动 | 规模推广 | 多租户 / 主动预警 / 1-2行业推广 / 数据治理&安全 |
+
+---
+
+### Slide 9 — 下阶段重点 & 分工
+
+**sectionLabel：** 下一步  
+**title：** 下阶段重点 & 角色分工  
+**sub：** Demo 收尾为核心目标，同步推进业务对齐与技术准备
+
+**左侧2×2行动卡（占约65%宽）：**
+
+| 卡片 | 图标 | 标题 | 要点 |
+|------|------|------|------|
+| 1 | 🎯 | Demo 收尾 | 补全 parse/embed Pipeline / 接入1-2个真实文档 / Mock替换真实LLM |
+| 2 | 🤝 | 业务对齐 | 确认演示场景 / 收集业务方反馈 / 需求优先级排序 |
+| 3 | 🔧 | 技术债清理 | RBAC权限设计 / 接入DocMind正式账号 / 前端性能优化 |
+| 4 | 📋 | 资源 & 决策 | GPU/算力评估 / 确认LLM方案 / 确定生产环境规划 |
+
+**右侧角色分工栏（占约30%宽）：**
+- 标题：角色分工
+- 4行：
+  - 前端工程师 — 法规感知UI / 文档管理 / 性能优化
+  - 后端工程师 — Pipeline补全 / API稳定性 / RBAC
+  - AI工程师 — Agent调优 / LLM接入 / Embedding优化
+  - 全栈/架构 — 合规分析模块 / 系统集成 / 文档
+
+---
+
+### Slide 10 — 结语 & Q&A
+
+**布局：** 深色背景封底（深海蓝 `1A1A2E`），品牌色顶部横条（3px）
+
+**内容（垂直居中）：**
+- 大字：`感谢聆听`，白色，44pt，bold
+- 副标题：`AI + 合规智能中枢 · 团队阶段性汇报`，text3色，16pt
+- 分隔线
+- `Q & A`，品牌色，32pt，bold
+- 说明：`欢迎提问与交流`，白色，14pt
+- 底部：`T-Systems · AI 合规项目组 · 2026.05 · INTERNAL CONFIDENTIAL`，text3，10pt
+
+---
+
+## 输出规格
+
+- **文件名：** `team-report.pptx`
+- **输出路径：** `C:/Projects/AIProjects/AIRegulations/AIRegulation-DocAnalysis-Demo/team-report.pptx`
+- **生成脚本：** `generate-team-ppt.js`
+- **依赖：** `require("C:/nvm4w/nodejs/node_modules/pptxgenjs")`
+- **布局：** `LAYOUT_WIDE` (13.33" × 7.5")
+- **颜色规范：** 不加 `#` 前缀，使用 `makeShadow()` 工厂函数
+
+---
+
+## 技术注意事项
+
+1. `makeShadow()` 必须每次返回新对象，不可复用同一引用
+2. pptxgenjs 中颜色值不加 `#`（如 `"E20074"` 而非 `"#E20074"`）
+3. 中文字体使用 `"Microsoft YaHei"` 或 `"Calibri"` 作为 fallback
+4. `ROUNDED_RECTANGLE` 在某些版本有问题，使用 `RECTANGLE` + 自定义 `rectRadius`
+5. 渐变使用 `fill: { type: "solid", color: "..." }` 或 `{ type: "grad", stops: [...] }`