mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 18:35:56 +00:00
61 lines
2.1 KiB
Markdown
61 lines
2.1 KiB
Markdown
---
|
||
id: kpi.plugin.concept
|
||
title: KPI 插件元信息
|
||
type: concept
|
||
feature: kpi
|
||
scope: end-user
|
||
locale: zh
|
||
aliases:
|
||
- KPI 插件
|
||
- kpi 怎么装
|
||
- 绩效插件
|
||
- 绩效考核插件
|
||
- community_kuaifan_kpi
|
||
related_tools: []
|
||
related_pages: [application]
|
||
prerequisites: []
|
||
negative:
|
||
- KPI 不是主程序内置功能，未装插件时入口不会出现
|
||
- 插件升级不通过 git pull，需要在应用市场更新
|
||
- 主程序版本必须高于 1.4.67，否则插件无法安装
|
||
last_verified: 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]]
|