dootask/resources/ai-kb/zh/concept/kpi/plugin.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
kpi.plugin.concept	KPI 插件元信息	concept	kpi	end-user	zh	KPI 插件 kpi 怎么装 绩效插件 绩效考核插件 community_kuaifan_kpi		application		KPI 不是主程序内置功能，未装插件时入口不会出现 插件升级不通过 git pull，需要在应用市场更新 主程序版本必须高于 1.4.67，否则插件无法安装	v1.7.90

KPI 插件元信息

定义

KPI 绩效考核在 DooTask 中由社区插件提供，应用市场 app id 为 community_kuaifan_kpi（当前版本 0.1.9），feature 短名 kpi。主程序不内置任何 KPI 代码，所有绩效逻辑都跑在独立 Docker 容器中，作为应用插件挂载到 DooTask 界面。

关键属性

• 作者：DooTask 官方
• 要求：主程序版本 > 1.4.67（依赖新 API 能力）
• 运行形态：单个 Docker 容器（镜像 dootask/kpi:<version>）
• 数据存储：独立 SQLite 数据库，本地卷 kpi_data 挂载到 /web/db，不入主库
• 菜单注入：安装后在「应用中心」注册「绩效考核」入口
• 重启策略：unless-stopped，主机重启容器自动恢复

用户生命周期钩子

插件订阅了 DooTask 的用户事件，自动维护 KPI 内部用户：

• user_onboard：DooTask 创建用户时，自动在 KPI 内建号
  • 部门不存在则自动创建该部门
  • DooTask 管理员自动设为 HR 角色
  • 部门负责人自动设为 manager 角色
  • 其余设为 employee 角色
• user_offboard：DooTask 删除用户时，KPI 同步清理

信息同步规则

用户登录 KPI 时：

• 自动更新姓名、职位
• 角色保持不变（不会因为 DooTask 角色变化而重新分配 KPI 角色）

不支持

• 不能离线安装到不联网的环境（需访问应用市场镜像源）
• 不能在主程序 < 1.4.67 的环境上安装

相关

• 是什么：kpi.concept
• 入口在哪：kpi.entry.menu-map
• 评分机制：kpi.scoring.concept