mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 10:25:59 +00:00
69 lines
2.7 KiB
Markdown
69 lines
2.7 KiB
Markdown
---
|
||
id: system-setting.checkin.howto
|
||
title: 签到规则设置
|
||
type: howto
|
||
feature: system-setting
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 签到设置
|
||
- 打卡规则
|
||
- 配置签到
|
||
- 签到时间
|
||
- 上下班时间
|
||
- 地理围栏
|
||
- 人脸打卡
|
||
- 配置打卡
|
||
- 跨天打卡
|
||
- 签到地图
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites:
|
||
- 需要系统管理员权限
|
||
- 启用人脸模式必须先安装 face 插件
|
||
- 启用定位模式必须有对应地图服务商的 Key
|
||
negative:
|
||
- 提前 + 延后时间之和必须 < 24h-工时，否则报「提前和延后时间设置存在重叠」
|
||
- 关闭签到（open=close）时 key 会自动轮换（再开启需要重新分发设备）
|
||
- 不支持给不同部门设置不同打卡规则，全公司共享一套
|
||
- 不支持自动按公历节假日跳过打卡
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 签到规则设置
|
||
|
||
## 入口
|
||
桌面端：左上角头像 →「系统设置」→「签到」。
|
||
对应后端：`POST api/system/setting/checkin`，参数 `type=save`。
|
||
|
||
## 字段说明
|
||
|
||
- **open** — 签到总开关（`open` / `close`）
|
||
- **time** — 上下班时间数组，如 `["09:00","18:00"]`（支持跨天班次）
|
||
- **advance** — 允许提前打卡分钟数（默认 120）
|
||
- **delay** — 允许延后打卡分钟数（默认 120）
|
||
- **remindin** — 上班前 X 分钟提醒（默认 5）
|
||
- **remindexceed** — 下班后超 X 分钟未打卡提醒（默认 10）
|
||
- **edit** — 是否允许员工自行补卡（`open` / `close`）
|
||
- **modes** — 支持的打卡方式数组，取值 `auto` / `manual` / `locat` / `face`
|
||
- **manual_remark** — 手动签到的展示文案
|
||
- **face_upload / face_remark / face_retip** — 人脸打卡配置
|
||
- **locat_map_type** — 地图服务商（`baidu` / `amap` / `tencent`）
|
||
- **locat_bd_lbs_key / locat_amap_key / locat_tencent_key** — 对应地图 Key
|
||
- **locat_*_point** — `{lng, lat, radius}` 单点电子围栏
|
||
- **key** — 签到机器自动生成的访问密钥（关闭再开启会重置）
|
||
|
||
## 操作步骤
|
||
1. 选择支持的打卡方式（多选）
|
||
2. 填写上下班时间、提前/延后窗口
|
||
3. 启用「定位」时选地图服务商并填 Key + 中心点+半径
|
||
4. 启用「人脸」时确认 face 插件已装
|
||
5. 保存后系统会自动创建/复用 `check-in` 机器人账号
|
||
6. 服务端返回 `cmd` 字段（base64），是签到机/考勤机的接入命令
|
||
|
||
## 不支持
|
||
- 不支持单日多班次（如午休拆成 4 个时间点），只取 `time[0]` 和 `time[1]`
|
||
- 不支持给部门 / 项目单独配置规则
|
||
- 不允许提前 + 延后窗口之和超过「24 小时 - 工时长度」（会校验失败）
|
||
- 人脸模式必须依赖 face 插件，不能用浏览器 WebRTC 直采
|