Files
AIRegulation-DocAnalysis/docs/superpowers/specs/2026-05-27-team-report-ppt-design.md
T

271 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 团队阶段性汇报 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 + 合规智能中枢`,白色,28ptbold
- 分隔线:白色,opacity 40%
- 团队标注:`T-Systems · AI 合规项目组`,白色,11pt
- 日期:`2026 年 05 月`,白色,11pt
**右侧内容区(x=3.4"):**
- 标签:`TEAM PROGRESS REPORT`,品牌色,10ptletter-spacing
- 副标题:`团队阶段性汇报`,深色,32ptbold
- 说明文字:`基于 Agent 协同的多模块法规合规智能平台`text213pt
- 3个数字指标卡(横排):
- `5` / 功能模块 / 品牌色
- `17+` / REST API 接口 / green
- `6+` / 法规来源覆盖 / orange
- 底部:`INTERNAL · CONFIDENTIAL`text39pt
---
### 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个组件badgeMilvus向量库 / MinIO对象库 / Embedding引擎 / Reranker / Sessions会话
- 描述:真实 Milvus 向量检索 + LLM 流式输出全链路贯通;会话管理、来源归因卡片、多轮追问
**右窄卡 — 系统状态监控(✓ 已完成):**
- 缩略图:`#F0ECFF``#E2D8FF`,内含健康检查badgeMilvus✓/MinIO✓/LLM✓)
- 描述:五项基础设施实时健康检查,文档统计,系统配置总览
---
### Slide 6 — 系统架构
**sectionLabel** 技术架构
**title** 系统分层架构
**sub** 清洁架构 + Ports & Adapters5 层分离,高内聚低耦合
**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
**内容(垂直居中):**
- 大字:`感谢聆听`,白色,44ptbold
- 副标题:`AI + 合规智能中枢 · 团队阶段性汇报`text3色,16pt
- 分隔线
- `Q & A`,品牌色,32ptbold
- 说明:`欢迎提问与交流`,白色,14pt
- 底部:`T-Systems · AI 合规项目组 · 2026.05 · INTERNAL CONFIDENTIAL`text310pt
---
## 输出规格
- **文件名:** `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: [...] }`