# 企业 OKR 闭环重构规格

## 目标

以 Open Design 原型的视觉和信息架构为目标，将现有系统重构为可运行的企业 OKR 闭环：HR 创建周期并冻结配置，CEO 发布公司目标，各级员工按汇报关系逐级承接和审核，执行期跟踪 KR，考评期逐级评分、申诉、沟通，满足条件后生成不可变快照并归档。

## 已确认业务规则

1. 公司级 OKR 只能由组织树唯一顶级业务负责人创建。
2. 绩效考评人只取周期发布时冻结的直属汇报关系，不按实时组织关系回溯修改。
3. 参与人没有直属上级时默认豁免绩效考评，不创建自评、上级评分、面谈和归档阻塞项。
4. HR 管理周期、参与人、模板、维度、申诉和审计，不默认代替 CEO 创建公司级目标。
5. 系统权限角色与业务汇报层级分离；`SUPER_ADMIN` 不自动代表 CEO。
6. 每个参与人每周期可创建 1～5 个 Objective；Objective 权重合计 100，每个 Objective 包含 2～5 个 KR，KR 权重在 Objective 内合计 100。
7. OKR 满分 60，绩效维度满分 40；维度评分默认填入其满分的 60%；加分与扣分各自上限 20；最终分限制在 0～100。

## 生命周期

### DRAFT

HR 创建周期，配置阶段日期和参与范围。系统预览每位参与人的部门、岗位、直属上级和考评人。没有直属上级的参与人标记 `EXEMPT_NO_EVALUATOR`。

### OKR_ALIGN

发布周期时冻结参与人和汇报关系快照。CEO 先创建公司级 Objective；其下各级人员只能在周期快照中的直属上级已有已批准 OKR 后提交。部门负责人可创建部门级 Objective，员工创建个人 Objective。直属上级根据快照关系审核。

### EXECUTING

所有非豁免参与人必须具有已批准 Objective 集合和已锁定绩效配置。进入执行后 Objective 和 KR 结构锁定，只允许更新 KR 当前值、状态、进度说明和风险。

### ASSESSING

非豁免参与人先自评，快照考评人再提交上级评分并发布最终结果。员工可以确认或申诉。接受申诉会使最终结果进入待修正，修正后重新发布并要求重新确认。主管记录绩效沟通，员工回复后主管关闭。

### ARCHIVED

归档要求所有非豁免参与人完成自评、上级评分、最终结果发布与确认、绩效沟通关闭，并且没有未结申诉。归档生成 Objective/KR、绩效配置、维度、评分明细、参与人和汇报关系的完整快照。

## 权限边界

- CEO：按周期快照识别唯一顶级业务负责人；创建公司级 OKR，查看公司对齐树。
- 部门负责人：创建部门级 OKR，查看本部门与授权下级数据。
- 直属主管：审核直属下属 OKR，执行绩效评分与沟通。
- 员工：维护自己的 OKR、进度、自评、确认、申诉和沟通回复。
- HR：管理周期、参与人、模板、维度、申诉、统计和审计修正。
- 超级管理员：拥有系统管理能力，但业务动作仍遵循周期快照中的汇报关系；只有显式的审计修正接口允许越级处理。

## 数据模型

### 周期与参与人

`assessment_period` 增加五个阶段日期。`period_participant` 增加部门、岗位、角色、直属上级和考评人快照字段，并使用 `participation_status` 表示 `ACTIVE`、`EXEMPT_MANUAL`、`EXEMPT_NO_EVALUATOR`。

### OKR

`okr_objective` 增加 `description` 和 `weight`。`okr_alignment` 保存 Objective 的主要父级和可选 KR 来源关系，替代 CSV。`okr_review_record` 保存每次提交、通过、驳回及版本。

### 执行

`kr_key_result` 增加 `baseline_value`、`unit`、`start_date`、`due_date`。timeline 只使用真实日期，不再根据列表序号构造视觉位置。

### 绩效配置和归档

`period_dimension` 保存周期维度快照。`kpi_template_assignment` 显式绑定模板和岗位/部门/用户。`performance_score`、`performance_feedback`、`kpi_config` 增加业务唯一约束。

## API 原则

- 使用显式 DTO 和结构化 blocker/action，不使用自由 Map 作为核心写入契约。
- 页面只消费真实接口数据；没有数据时显示 empty state，不填充原型 mock。
- 所有待办、风险、通知都返回可导航的 `targetUrl`。
- 历史页面读取归档快照，不重新组合当前组织、维度和模板。

## 视觉原则

保留 Open Design 的 240px 白色侧栏、56px 顶栏、白色卡片、1px 中性边框、深靛蓝与青色品牌色。移除医院、科室、医生、护士、患者等医疗样例。登录页不显示虚构统计；管理入口按权限隐藏；深色容器不再嵌套浅色标签造成冲突。

## 验收

使用 CEO、一级主管、员工、HR 四个独立账号完成全周期 E2E。任一 blocker 必须阻止状态流转并给出准确的用户和跳转目标。归档后修改组织、模板或全局维度不得改变历史详情。