zkxw/docs/superpowers/specs/2026-07-30-oa-overtime-kit-design.md

OA 表单设计 · 加班套件（Overtime Kit）设计文档

日期: 2026-07-30
状态: 已实现
范围: web-admin 审批设计器「套件」Tab + 发起/详情运行时；发布白名单
前置: 请假套件 docs/superpowers/specs/2026-07-30-oa-leave-kit-design.md

---

1. 目标

套件 Tab 增加 加班套件：一键插入 4 个字段。

字段	控件	说明
加班人	person（多选，与人员组件一致）	必填
开始时间	datePicker datetime YYYY-MM-DD HH:mm	必填
结束时间	datePicker datetime YYYY-MM-DD HH:mm	必填
时长（h）	inputNumber 1 位小数	仅手动填写，无自动计算

2. 实现要点

• 容器类型：overtimeKit（布局类，不计可填字段数）
• 运行时不渲染套件边框/标题（同请假）
• 无套件级工时属性、无前后端时长重算
• 打印 / 发布白名单纳入 overtimeKit

3. 文件

• OaOvertimeKit.vue
• oa-overtime-kit-rule.ts / oa-form-create-overtime-kit.ts / oa-overtime-kit-runtime.ts
• main.ts / oa-fc-host/main.ts 注册
• oa_publish.py LAYOUT_TYPES
• oa-approval-print.ts 布局 unwrap