@feng-h/pdca-skill 1.0.0

package/system//345/267/245/345/205/267//344/273/252/350/241/250/346/235/277/347/224/237/346/210/220/345/231/250.md

@@ -0,0 +1,274 @@
+# 仪表板生成器
+
+基于巡检频率定期生成 Wiki 仪表板页面，提供项目进展的可视化概览。
+
+---
+
+## 概述
+
+**用途**：按照智能巡检频率定期从 Bitable 读取数据，生成包含核心指标、框架维度进度、任务列表、数据趋势、执行日志和 AI 分析洞察的仪表板页面。
+
+**核心价值**：
+- 一站式查看项目全貌，无需切换多个数据源
+- 自动化数据聚合，减少人工汇总工作
+- AI 分析洞察提供决策支持
+- 基于时间序列的趋势可视化
+
+---
+
+## 仪表板布局
+
+```
+┌────────────────────────────────────────────────────────────┐
+│  📊 [项目名称] 仪表板                                      │
+├────────────────────────────────────────────────────────────┤
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │  核心指标区                                          │   │
+│  │  - 完成度进度条                                      │   │
+│  │  - 剩余天数倒计时                                    │   │
+│  │  - 当前阶段标识                                      │   │
+│  │  - 任务完成率                                        │   │
+│  └─────────────────────────────────────────────────────┘   │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │  框架维度进度区                                      │   │
+│  │  - 各维度任务分布（如 TREND 的 T/R/E/N/D）          │   │
+│  │  - 维度完成度对比                                    │   │
+│  │  - 维度优先级标识                                    │   │
+│  └─────────────────────────────────────────────────────┘   │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │  当前阶段任务列表                                    │   │
+│  │  - 待办任务（高优先级优先）                          │   │
+│  │  - 进行中任务                                        │   │
+│  │  - 近期已完成任务                                    │   │
+│  └─────────────────────────────────────────────────────┘   │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │  研究数据区（趋势可视化）                            │   │
+│  │  - 关键指标趋势图                                    │   │
+│  │  - 基准值 vs 当前值                                  │   │
+│  │  - 目标达成进度                                      │   │
+│  └─────────────────────────────────────────────────────┘   │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │  执行日志区                                          │   │
+│  │  - 最近 7 条日志（按时间倒序）                       │   │
+│  │  - 日志类型标识（进展/问题/决策）                    │   │
+│  └─────────────────────────────────────────────────────┘   │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │  AI 分析洞察区                                        │   │
+│  │  - 进度异常预警                                      │   │
+│  │  - 趋势分析建议                                      │   │
+│  │  - 风险提示                                          │   │
+│  └─────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 数据来源
+
+| 区域 | 数据来源 | API | 说明 |
+|------|---------|-----|------|
+| 核心指标 | 项目主表 | `feishu_bitable_app_table_record.search` | 聚合项目级别统计 |
+| 框架维度进度 | 任务表 | `feishu_bitable_app_table_record.search` | 按「来源维度」分组聚合 |
+| 当前阶段任务 | 任务表 | `feishu_bitable_app_table_record.search` | 筛选当前阶段未完成任务 |
+| 研究数据 | 数据记录表 | `feishu_bitable_app_table_record.search` | 按指标名称分组获取时序数据 |
+| 执行日志 | 日志表 | `feishu_bitable_app_table_record.search` | 获取最近 N 条记录 |
+| AI 分析洞察 | AI 生成 | 基于以上数据分析 | LLM 分析生成建议 |
+
+---
+
+## 生成流程
+
+### 1. 读取 Bitable 数据
+
+```python
+# 伪代码示例
+def fetch_dashboard_data(project_id: str) -> dict:
+    """获取仪表板所需的所有数据"""
+
+    # 1. 核心指标（项目主表）
+    project_data = feishu_bitable_app_table_record.search(
+        filter={"项目ID": project_id}
+    )
+
+    # 2. 框架维度进度（任务表聚合）
+    tasks_by_dimension = feishu_bitable_app_table_record.search(
+        filter={"项目ID": project_id},
+        group_by="来源维度"
+    )
+
+    # 3. 当前阶段任务
+    current_phase_tasks = feishu_bitable_app_table_record.search(
+        filter={
+            "项目ID": project_id,
+            "状态": ["未开始", "进行中"]
+        },
+        sort_by=["优先级", "截止日期"],
+        limit=10
+    )
+
+    # 4. 研究数据（时序）
+    data_records = feishu_bitable_app_table_record.search(
+        filter={"项目ID": project_id},
+        sort_by="记录时间",
+        limit=100
+    )
+
+    # 5. 执行日志
+    logs = feishu_bitable_app_table_record.search(
+        filter={"项目ID": project_id},
+        sort_by="记录_time",
+        limit=7
+    )
+
+    return {
+        "project": project_data,
+        "dimensions": tasks_by_dimension,
+        "tasks": current_phase_tasks,
+        "data": data_records,
+        "logs": logs
+    }
+```
+
+### 2. 计算指标
+
+```python
+def calculate_metrics(data: dict) -> dict:
+    """计算各区域指标"""
+
+    project = data["project"]
+
+    # 核心指标
+    metrics = {
+        "完成度": project["完成度"],
+        "剩余天数": (project["预计结束日期"] - now).days,
+        "当前阶段": project["当前阶段"],
+        "任务完成率": completed_tasks / total_tasks * 100
+    }
+
+    # 框架维度进度
+    dimension_progress = {}
+    for dim in data["dimensions"]:
+        dimension_progress[dim["来源维度"]] = {
+            "总数": dim["total"],
+            "已完成": dim["completed"],
+            "完成率": dim["completed"] / dim["total"] * 100
+        }
+
+    # 数据趋势
+    trend_analysis = analyze_trend(data["data"])
+
+    return {
+        "metrics": metrics,
+        "dimensions": dimension_progress,
+        "trend": trend_analysis
+    }
+```
+
+### 3. 生成 AI 洞察
+
+```python
+def generate_ai_insights(metrics: dict) -> list[str]:
+    """基于指标生成 AI 分析洞察"""
+
+    insights = []
+
+    # 进度异常检测
+    if metrics["metrics"]["完成度"] < expected_progress:
+        insights.append("⚠️ 进度预警：当前完成度低于预期，建议关注高优先级任务")
+
+    # 趋势分析
+    if metrics["trend"]["direction"] == "declining":
+        insights.append("📉 趋势警示：核心指标呈下降趋势，建议检查执行计划")
+
+    # 维度平衡分析
+    unbalanced_dimensions = find_unbalanced_dimensions(metrics["dimensions"])
+    if unbalanced_dimensions:
+        insights.append(f"⚖️ 维度失衡：{unbalanced_dimensions} 进度滞后，建议调整资源分配")
+
+    # 风险提示
+    if metrics["metrics"]["剩余天数"] < 7 and metrics["metrics"]["完成度"] < 80:
+        insights.append("🚨 截止风险：剩余不足 7 天但完成度低于 80%，建议评估延期风险")
+
+    return insights
+```
+
+### 4. 渲染 Markdown
+
+使用模板引擎生成 Markdown 内容（详见 `pdca/references/dashboard-templates.md`）。
+
+### 5. 更新 Wiki
+
+```python
+def update_dashboard_wiki(project_id: str, content: str):
+    """更新仪表板 Wiki 页面"""
+
+    # 获取仪表板节点的 node_token
+    dashboard_node = get_dashboard_node(project_id)
+
+    # 调用 feishu_update_doc
+    feishu_update_doc(
+        node_token=dashboard_node,
+        content=content
+    )
+```
+
+---
+
+## 更新频率
+
+| 项目类型 | 基线频率 | 说明 |
+|---------|---------|------|
+| 健康/体能 (TREND) | 每日 | 数据每天更新 |
+| 制造业 (4M1E) | 每 8 小时 | 跟随生产班次 |
+| 软件开发 (PPTD) | 每日 | 日报节奏 |
+| 学习/教育 (COMET) | 每周 | 周报节奏 |
+| 其他 | 每日 | 最小每日更新 |
+
+**频率调整**：
+- 遵循 `_系统/工具/智能巡检频率.md` 中的动态调整策略
+- Do 阶段加倍频率
+- 高优先级项目加倍频率
+
+---
+
+## Wiki 路径
+
+```
+PDCA项目管理/
+└── 📁 [项目名称]/
+    └── 📊 仪表板.md
+```
+
+**创建时机**：项目创建时自动生成仪表板页面
+
+**更新方式**：使用 `feishu_update_doc` 覆盖更新
+
+---
+
+## 与巡检系统集成
+
+仪表板生成作为巡检流程的最后一步：
+
+```
+巡检循环
+    ↓
+1. Scrape（Wiki）- 获取项目文档
+    ↓
+2. Load（Logic）- 加载阶段要求
+    ↓
+3. Verify - 对比检查
+    ↓
+4. Message（Card）- 发送预警卡片
+    ↓
+5. [新增] Generate Dashboard - 更新仪表板
+    ↓
+完成本次巡检
+```
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更说明 |
+|------|------|---------|
+| v1.0 | 2026-04-04 | 初始版本，定义仪表板生成逻辑和布局 |

package/system//345/267/245/345/205/267//344/273/252/350/241/250/347/233/230/347/273/204/344/273/266/351/205/215/347/275/256.md

@@ -0,0 +1,66 @@
+# Bitable 仪表盘组件配置
+
+## 概述
+
+Bitable 仪表盘为项目提供实时的可视化展示，所有组件绑定到 Bitable 数据表作为数据源。
+
+## 仪表盘组件列表
+
+### 1. 核心指标区
+- **类型**: 指标卡片
+- **数据源**: 项目主表
+- **指标映射**:
+  | 指标 | 字段 | 展示方式 |
+  |------|------|---------|
+  | 目标达成度 | 完成度 | 进度条 (0-100%) |
+  | 剩余天数 | 预计结束日期 vs 当前日期 | 计算值 |
+  | 当前阶段 | 当前阶段 | 文本标签 |
+  | 任务完成率 | 任务表 (状态=已完成的记录数 / 总记录数) | 百分比 |
+
+### 2. 框架维度进度区
+- **类型**: 分组柱状图
+- **数据源**: 任务数据表
+- **分组字段**: 来源维度
+- **指标**: 任务状态分布
+- **交互**: 点击维度 → 筛选显示该维度任务
+
+### 3. 任务列表区
+- **类型**: 表格视图
+- **数据源**: 任务数据表
+- **筛选条件**: 任务状态 != "已取消"
+- **排序**: 优先级 DESC, 截止日期 ASC
+- **显示字段**: 任务标题、任务状态、负责人、截止日期、完成度
+
+### 4. 数据趋势图
+- **类型**: 折线图
+- **数据源**: 数据记录表
+- **X轴**: 记录时间
+- **Y轴**: 数值
+- **系列**: 按指标名称分组
+
+### 5. 执行日志区
+- **类型**: 列表视图
+- **数据源**: 执行日志表
+- **排序**: 记录时间 DESC
+- **显示条数**: 最近 10 条
+- **显示字段**: 阶段、日志类型、内容、记录时间
+
+### 6. AI 洞察区
+- **类型**: 文本卡片
+- **数据源**: 执行日志表 (筛选 日志类型=AI洞察)
+- **排序**: 记录时间 DESC
+- **显示条数**: 最近 5 条
+
+## 配置方式
+
+仪表盘通过 Bitable 原生仪表盘功能配置：
+1. 在 Bitable 应用中创建仪表盘视图
+2. 为每个组件选择对应的数据源表
+3. 配置数据绑定和筛选条件
+4. 设置刷新频率（推荐自动刷新）
+
+## 注意事项
+
+- Bitable 仪表盘组件能力有限，复杂自定义展示需配合 Wiki 页面补充
+- 剩余天数等计算值由 AI 巡检时计算并写入日志，仪表盘从日志表读取
+- 仪表盘数据源变更后需重新配置组件绑定