diff --git a/docs/superpowers/specs/2026-05-27-team-report-ppt-design.md b/docs/superpowers/specs/2026-05-27-team-report-ppt-design.md new file mode 100644 index 0000000..08f3909 --- /dev/null +++ b/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: [...] }`