Skip to main content

部门分析

Asset
ADP-PLN-FEAT-DOC-0005
Feature
department-analytics
领域
plane-core
作用域
application-level
文档状态
draft
产品生命周期
active
文档 Owner
DOC
事实源
canonical-docs
工程 Owner
PLN
Development Ready
not-ready
更新
2026/10/14

FEATURE DEVELOPMENT PACKAGE

工程就绪状态

工程 Owner：PLN · 仓库：PLN

BLOCKED
development · not ready
  • 原子需求与验收
  • 设计与工程合同
  • 代码与仓库定位
  • 里程碑与工作包
  • 验证计划
  • 无阻断决策
verification · not ready
  • Development Ready 已通过
  • 验收标准已覆盖
  • 正式测试已登记
  • Fixture 与环境已定义
  • 测试规格已物化到正式测试
release · not ready
  • Verification Ready 已通过
  • 实现修订可定位
  • 发布证据已登记
  • 兼容与迁移已定义
  • Runbook 与回滚已定义
查看阻断项（5）
  • Development Ready 缺少：原子需求与验收
  • Development Ready 缺少：设计与工程合同
  • Development Ready 缺少：代码与仓库定位
  • Development Ready 缺少：里程碑与工作包
  • Development Ready 缺少：验证计划
查看完整 readiness查看关联资产

目标与页面​

页面顺序为“关键数字 → 趋势/成员分布 → 风险事项”。工作项摘要展示当前概览；独立分析展示历史趋势、成员/项目比较。事项数量不称工时、利用率或绩效。移除完成率与全部审批指标，不新建计划完成率。

当前范围始终按有效成员当前部门动态解析；历史按事件时部门快照。Project membership 与现有 Issue/评论限制同时生效，部门关系不能扩权。Lead/Analyst 聚合权限、成员明细和 CSV 独立授权继续保留；权限不充分时不返回成员可识别明细。部门/成员/项目筛选只能缩小范围。

当前指标与风险​

当前承担集合为 assignee 与有效当前阶段责任的并集，排除已完成/取消，并按 Issue 去重；创建/订阅不计负荷。当前指标不随历史时间窗口变化。

指标定义
未完成承担事项当前承担集合大小。
待执行我的工作待执行规则，含运行/阻塞阶段，与其它数字可重叠。
执行中当前承担且 progress_role=running。
待验收/待测试当前有效 human 责任与 professional_acceptance/test 匹配。
逾期target_date 早于 Workspace 时区的今天。
阻塞progress_role=blocked 或已有有效 blocking Issue 关系。
临近到期今天至今天+7天（含端点）到期且未完成。
长时间未更新updated_at 早于当前时间14天，说明“14天无更新”；不冒充验收等待时长。

成员分布分别展示执行承担、专业验收、测试承担及去重总数；总数不是各列相加。点击数字、成员或风险必须进入相同部门工作项并携带对应关系、成员、项目、状态、生命周期、风险或事件时间条件，不跳默认列表。

历史事件、趋势与覆盖​

默认近30天，可选近7天/近90天与自定义闭区间日期，最大365天；按 Workspace 时区转为半开时间区间，结束日包含整天。API clean break 使用同一 start_date/end_date 合同，不保留旧窗口映射或双模式。

新增以 created 事件，完成以非 completed → completed 事件，重开以 completed → 非终态事件为准；期间数量在各部门按 Issue 去重，每日趋势在每天内按 Issue 去重，同一天多次完成不累加，跨天事件可分别出现在趋势。重复 source_event_key 不重复摄取。当前终态不能倒算历史，历史窗口不改变当前数量。

事件时冻结有效 assignee 与阶段职责、部门 ID/名称和成员 ID；完成前捕获有效责任，防止终态清空负责人丢失归属。共同承担多部门可各出现一次，Workspace 总体按 Issue/event 去重，不能相加部门或成员行。调岗不改写旧事实；当前视图不读取 latest snapshot 充当当前归属。

旧快照若只有 assignee 证据，显式标记职责覆盖不足；没有可靠事件时快照显示 unknown/覆盖不足，不按当前部门回填，不伪造零。展示数据更新时间、可靠覆盖起点、unknown/no_department/estimated 与异常提示；无新增事件不等同管道故障。历史计数返回有证据值并说明覆盖不足，不能声明完整历史。

CSV 与权限​

页面、下钻和 CSV 共用权限/范围/时区/指标定义。导出保存查询日期、部门/成员/项目、权限范围、schema version 和 watermark；生成及下载重新检查权限，撤权失败并审计。CSV 24小时过期清理，最大365天；旧格式待生成任务终止，不保留审批字段。

聚合、成员和项目比较使用可见 Issue 去重；不能因分析角色获得未加入项目的数据。明细和导出能力分别检查，不从 Lead/Analyst 身份推导无限权限。生成失败、过期、无权限和覆盖不足显示简洁业务提示。

实现与验证边界​

源事件在业务状态事务内持久化，幂等键与源版本防止重放漂移；快照不反向修复业务。当前查询与历史查询分离但复用授权范围，分页/导出重验。来源/调用方和迁移盘点见 WEN-51 OpenSpec change；外部 CI 和发布保存证据，本地验证禁止，不新增未授权测试。

Last updated on by source2728