[TITLE]
考勤日志概览与管理指南

[DESCRIPTION]
本文详细介绍 Odoo 考勤应用的概览仪表板、日志颜色状态、时间周期切换、过滤与分组、高价值过滤示例、考勤详情及错误处理方法，帮助管理员快速定位并纠正考勤异常。

[KEYWORDS]
考勤日志, 考勤概览, 打卡记录, 工作时间, 错误处理, 过滤与分组, 考勤详情, Odoo 考勤, 仪表板, 考勤错误

考勤日志

进入 考勤 应用时，默认显示 概览 仪表板，展示当前日期所有用户的考勤日志（签到与签退信息）。如果用户拥有 访问权限 <attendances/access-rights> 或是特定员工的 审批人 <attendances/approvers>，这些员工的考勤日志也会出现在 概览 仪表板上。

概览 仪表板按小时划分当前日期，当前小时以黄色高亮。仪表板的显示方式由员工记录中的 工作计划 <employees/schedule> 决定。员工的工作时间以白色显示，其他时间以灰色显示，便于管理者直观看出员工是否在工作时间之外工作。

员工按名字首字母排序显示。每条考勤日志显示总工时以及具体的签到和签退时间。日志颜色表示以下状态：

  • 灰色：已完成的记录，员工已签到并签退。
  • 绿色：进行中的记录，员工已签到但尚未签退。
  • 红色：出现错误的记录（例如员工双重签到，或忘记签退）。

颜色条显示员工当天已记录的工时占预期总工时的比例。将鼠标悬停在颜色条上可查看该员工当日的详细信息。实色表示已记录的工时（包含开始和结束时间），淡色表示员工已签到但未签退。只有 已完成 的考勤日志（同时有签到和签退时间）会计入已记录工时的汇总。

::: example
Abigail Peterson 的排班为：上午 9:00‑12:00 工作，12:00‑13:00 吃午饭，13:00‑18:00 工作，总计 8 小时。

Abigail 9:00 签到，12:00 签退。13:00 再次签到。当前时间为 14:15。悬停信息显示 [3h / 8h]，表示她已完成 3 小时的工作。淡绿色的线段延伸至汇总块之外，说明她 13:00 已签到但尚未签退，线段长度代表已工作的时长。


:::

考勤 仪表板支持切换显示时间段，可选择 天、周、月、季、年 或自定义时间段。随时点击 今天 按钮可快速回到当前日期。

:::: note
::: title
注意
:::

出现错误的考勤日志会以红色显示，需由拥有相应 访问权限 <attendances/access-rights> 或是该员工 审批人 <attendances/approvers> 的用户进行处理。
::::

有时考勤员和管理者需要查看特定记录，例如所有自动签退，以判断哪些员工经常忘记签退，或按部门查看，以判断哪个团队加班最多。

此时可使用搜索栏选择 fa-filter 过滤器 或 oi-group 分组方式，或两者结合，呈现所需信息。

::: seealso
../../essentials/search
:::

过滤器常见使用场景
在岗在关闭大楼前确认员工仍在现场，或进行人数清点。
错误查看所有错误，以在工资处理前进行修正。
自动签退审计哪些员工经常忘记签退。
日期将结果限制在特定的薪资周期或审计窗口。
在职/已离职员工在审计历史数据时切换当前在职员工与已离职员工。
分组方式适用情形
员工在 1:1 会议中查看个人考勤日志。
部门对比人员配置和工时，判断加班或不足的团队。
经理确定考勤跟进问题应向哪位经理提出。
方法发现考勤方式的趋势，以便解决硬件问题。
日期（天/周/月）识别缺勤高峰或季节性模式。

Odoo 会记录每次签到和签退的时间与地点，字段会随使用的方式而异。这些详细的考勤日志可以确认员工在任意工作日的所在位置，对采用混合工作制的公司尤为重要，可用于审计合规性。

要查看考勤日志，点击 概览 仪表板中的任意考勤条目，日志会在弹窗中显示，摘要包括：

  • 员工：员工姓名。
  • 签到：员工签到的日期和时间。
  • 签退：员工签退的日期和时间，仅在已签退时显示。
  • 工作时长：该条目记录的工作时长，格式为 HH:MM。
  • 额外工作时长：超出排班的未付加班时长，仅在存在时显示。
  • 加班时长：已批准的加班时长（工作时长 减去已批准的 额外工作时长）。

点击弹窗右上角的 fa-expand 展开 图标，可加载更详细的记录。以下信息会在 签到 与 签退 两部分中同时出现：

  • 方式：考勤提交方式，可选：
    • 系统托盘：员工直接在数据库中签到/签退 <../attendances/check_in_check_out>。
    • 自助终端：员工使用考勤终端 <attendances/kiosk-mode-entry>。
    • 手动：管理员或 考勤 应用管理员手动创建记录 <attendances/create-records>，通常用于员工忘记签到或签退。
  • IP 地址：用于签到/签退的设备 IP。
  • 浏览器：员工使用的网页浏览器。
  • 定位：设备 IP 所在的城市和国家。
  • GPS 坐标：签到/签退时的具体坐标。点击 oi-arrow-right 在地图上查看 按钮可在新标签页打开地图并标注位置。

出现错误的条目在概览仪表板中以红色显示。在 fa-tasks 甘特 视图中，条目背景为红色；在 oi-view-list 列表 视图中，文字为红色。

错误情形包括：员工签到后 24 小时内未签退，或单次签到时长超过 16 小时。

  1. 点击出错条目，弹出包含该条目详情的窗口。
  2. 若需修改 签到 或 签退，点击相应字段，会出现日历选择器。先选日期，再在日历下方的时间选择器中设定具体时间。完成后点击 应用。
  3. 确认所有信息正确后，点击 保存并关闭。错误消除后，条目颜色会变为灰色。

若决定直接删除，点击弹窗中的红色 删除 按钮即可。

[SUMMARY]

  • 考勤日志
    • 概览仪表板
      • 当前日期与小时高亮
      • 工作计划显示（白色工作时间，灰色非工作时间）
      • 日志颜色状态（灰：已完成，绿：进行中，红：错误）
      • 颜色条显示已记录工时比例
    • 示例说明（Abigail 的签到/签退情况）
    • 时间周期切换（天/周/月/季/年/自定义）
    • 快速返回今天按钮
    • 错误日志红色提示与处理权限
    • 过滤与分组
      • 高价值过滤（在岗、错误、自动签退、日期、在职/已离职）
      • 有洞察的分组（员工、部门、经理、方式、日期）
    • 考勤日志详情
      • 基本信息（员工、签到、签退、工作时长、额外工作时长、加班时长）
      • 签入/签出详细信息
        • 方式、IP 地址、浏览器、定位、GPS 坐标
        • 在地图上查看坐标
    • 考勤错误处理
      • 错误显示（红色）
      • 修复步骤（修改或删除）
      • 删除记录方法