实用的非入侵式的工作日志及加班管理模块，强大的任务耗时统计分析功能，通过登记取证强制要求组员每个工作日填写任务完成情况。独立模块安装，不影响禅道原来的功能。包括：工作日志（日历）、日志填写不完整自动检测并邮件提醒、上个工作超负荷邮件通知、日志不完整登记（日历）、工作日调整、耗时统计及明细、加班审批管理、加班转审批管理。

购买前咨询开发票或试用时遇到问题可以邮件：tonny0216@126.com

1. 工作日志管理

管理理念：零散的工作日志意义不大，无法统计分析；通过任务的准确分类和及时填报的耗时来统计研发管理各个环节的投入。此模块主要解决 2 个问题： 1 、确保每个人都每天都要领任务，并及时填报工作耗时。 2 、准确统计各个项目、各个分类下的工作成本。

强调的是对任务的处理情况的填报，而不是事后日志的追补。前者可预估可归类可统计；后者零散无法统计。所以，本模块的工作日志是在做任务时填写的处理情况，由系统自动生成工作日志，无需凭空回想登记。

1.1 工作日志 （ 日历 ）

以日历的方式查看一个月内每天的工作日志。

1) 以日历的方式展示。例如 3 月份有 31 天，就展示 31 个格子，每个格子代表一天。

2) 在格子里罗列 当天的 工作日志 条目 ， 包括：耗时、工作内容。

3) 点击每条工作日志条目时，可以关联到任务详情。

4) 鼠标停留到工作日志条目时，可以显示任务的基本信息：任务名称、项目名称、模块名称。以及这个在这个任务上工作的内容、耗时。

5) 支持按月查询。默认显示当前月份。

6) 当天的工作没填写够工作量（小于公司每天规定工时），标记出来。

7) 公司每天规定工时可以配置。默认是 8 小时。 可以在： \zentao\module\myworklog\config.php 里修改。

1.2 工作日志 （ 表格 ）

以表格的方式查看工作日志

1) 支持查询：按日志工作内容模糊查询、按工作日期的区间段查询。

1.3 日志填写不完整自动检测并邮件提醒

1) 每个工作日的指定时刻检查上一个工作日的日志完整，如果不完整（即：工作量小于公司每天规定工时），发邮件提醒
2) 日志填写不完整提醒的检测时刻可以配置。默认上午8点和10点各提醒一下。这个两个时间可以到禅道的后台-计划任务找到相应的记录来修改。

注： 需要确保禅道启动后，通过页面登录过禅道的任意页面 。

如果希望服务器重启（还没来得及登录禅道系统）后也能自动检测日志不完整，可以在windows下配置，开机即启动检测。见安装插件后的说明，配置方法见： { 安装路径 }\zentao\module\myworklog\doc\myworklog- 附件： Win10 系统下如何设置计划任务 .docx。

1.4 日志填写不完整自动检测 、 登记 入库 、邮件通知

1) 每个工作日的指定时刻检查 上 一个工作日的日志完整，如果不完整（即：工作量小于公司每天规定工时），发邮件通知并登记入库

2) 日志填写不完整登记的检测时刻可以配置。默认上午 11 点。这个时间可以到禅道的后台-计划任务找到相应的记录来修改。

注：需要确保禅道启动后，通过页面登录过禅道的任意页面 。

如果希望服务器重启（还没来得及登录禅道系统）后也能自动检测日志不完整，可以在windows下配置，开机即启动检测。见安装插件后的说明，配置方法见： { 安装路径 }\zentao\module\myworklog\doc\myworklog- 附件： Win10 系统下如何设置计划任务 .docx。

1.5 上个工作超负荷 邮件通知

1) 上个工作超负荷（大于15小时），会邮件提醒本人及其上级。同时也有提醒误填导致工作量过高的作用。超负荷的时长可以在：\zentao\module\myworklog\config.php 里修改。

注：暂时屏蔽。

1.6 日志 不完整登记 （ 日历 ）

以日历的方式查看一个月内 日志填写不完整的登记情况 。

1) 以日历的方式展示。例如 3 月份有 31 天，就展示 31 个格子，每个格子代表一天。

2) 在格子里罗列 单天日志填写不完整的用户。

3) 点击用户名称可以查看当时填写的日志内容，以便取证。

4) 支持按月查询。默认显示当前月份。

1.7 取消日志不完整登记

用户可能因为请假调休 \ 出差来不及登记日志，可以由管理员取消登记。

取消时需记录：取消时间、取消原因、取消操作 。

1.8 日志填写不完整次数统计

统计每月所有人登记的次数。

支持按月查询。

1.9 设置检查规则

可以设置指定用户的日志才需要被检查填写完整性。 对 此用户 ，

1) 可设置其汇报的上级 ， 支持 1 位上级

2) 可设置是否让上级接收邮件通知（这个通知是指：个人日志填写不完整自动检测并登记后会发出邮件通知）

3) 可以启用或禁用此检查规则，启用后系统才会检测日志填写的完整性、及系统自动发邮件通知功能。

支持批量添加检查规则（考虑到多个人的上级都是同一个人，批量添加可以减少维护工作量）

1.10 工作日 调整

根据国家节假日或公司要求调整工作日。

可以将指定日期设置为工作日或非工作日。

1.11 项目 耗时统计

1)默认统计各项目的耗时。可以点击进去查看此项目的各模块的耗时统计。
2)支持按模块的级别来统计，例如第三级别的耗时汇总到第2级，第2级的耗时汇总到第1级。
3)支持按部门过滤统计，默认统计所有部门
4)支持按用户过滤统计，默认统计所有用户
5)支持按项目过滤统计，默认统计所有项目
6)支持按开始时间、结束时间过滤统计，默认统计当前月的1号至今天
7)支持展示每个模块的耗时占比=当前模块的耗时/总耗时。（总耗时为查询的结果耗时的总和）。

1.12 项目 耗时明细

针对耗时统计出来的各个条目，可以查看此 条目的耗时明细 ， 包括 ：部门、用户、项目、模块、任务、工作内容、耗时、登记时间。

不支持在 耗时明细 界面上进一步过滤查询。

1.13 任务管理优化--（需安装插件： 任务剩余工时自动计算）

工作日志是任务里填写的备注自动生成的，所以需要约束备注的填写。同时为了方便填写工时，只需填写耗时，剩余工时自动计算。

1）任务里备注信息的字数要求
任务-“记录工时”页面和任务-“开始”的页面，备注字段的字数要求大于20个汉字，小于400个汉字。
可以在\zentao\module\task\ext\lang\zh-cn\zh-cn.php里调整字数的要求。

2）任务剩余工时自动计算
任务-“记录工时”页面，剩余工时自动计算。

1.14 数据权限控制

实现灵活的数据权限控制：

1)支持admin或具有“ 查看所有部门的工作日志”权限的用户可以查看所有部门的日志数据。

2)支持当前用户，通过配置实现：1）只能查看自己部门下所有人员的日志。或 2）可设置上级部门级别，可以看到此级别以及其下各个部门人员的工作日志。或 3）只能查看自己的数据（同部门其他组员的数据看不到）。admin或具有“查看所有部门的工作日志”权限的用户不受此配置控制。
3)项目经理只能查看自己管辖的项目的日志数据，也可以通过授权“ 查看所有项目的工作日志”来看所有项目的日志数据。
授权方式如下：

1.14 数据导出excel

支持工作日志（表格）、工作日志明细、耗时统计(人员)的数据导出。

1.15 耗时与人力成本换算

支持将耗时换算成费用成本。

每个人的月薪和时薪在用户信息里维护：

由于工资是敏感信息，加了数据权限控制。只有具备了“查看成本字段”权限的人才可以看到成本字段。

2.加班管理

管理理念：加班代表着成本，需要对这些成本进行管控。管控手段包括：加班时长异常提醒、加班内容审批。加班内容也是工作日志的内容，在填写工作日志时就可以生成加班的工时，对工作日志的审批就是对加班的审批。

2.1加班超负荷提醒

检查每天加班是否过多。如果一天的工作量多于15小时，8：00和11:10邮件提醒到个人和上级，但不登记入库。

2.2加班耗时显示

在工作日历中，显示加班的时长。
如果是工作日：加班的时长=当天工作总耗时-工作日正常上班的时长。
如果是非工作日：加班的时长=当天工作总耗时。

2.3设置加班默认审批人

配置成员的加班的默认审批人（1人）。

2.4加班审批（事后）

以日历的方式查看一个月内每天加班用户。
1)以日历的方式展示。例如3月份有31天，就展示31个格子，每个格子代表一天。
2)在格子里罗列单天有加班的用户。
3)审批人对加班进行审批，
填写如下内容：
系数：必填，0\0.1\0.2\0.3\0.4\0.5\0.6\0.7\0.8\0.9\1，默认是1。
原因：可选。
系统自动记录审批人和审批时间。
4)审批人只能对归属自己审批的成员进行审批。
5)已审批显示在"checked[X\Y]",X表示审批人同意的加班时长，Y表示审批人同意加班系数，点击checked 可以弹出审批详情页面：系数、原因、审批人、审批时间。
6)未审批的用户红色标记。在有权限的情况下，点击用户名可以弹出审批页面。
7)审批人可以对审批进行修改。没有日期限制。
8)在工作日志（日历）上也可以进行审批。

2.5加班转审批

审批人可以转审批（只能选一个人）。
转后的审批人可以再转审批。
默认的审批人和最后一位转审批的人才可以审批。
例如，成员出差他的工作可能在现场的领导更加清楚，那么原审核人可以通过转审批满足这种特殊情况。

2.6导出加班明细（已审批）

导出指定月份的已审批的的加班情况：日期、账号、姓名、是否工作日、工作内容、工作总时长（h）、审批前加班时长（h）、审批后加班时长（h）、审批后的加班系数、理由、审批时间、审批用户。

3. 安装说明

见插件详情-安装文档 说明

特别注意：安装后要分配权限（见安装文档 说明），才能看到“工作日志”菜单

4. 常见问题

1）无法自动检测不完整日志并发邮件

检查是否做了如下的事情：a)禅道启动后需要登录一次禅道（见“ 1.3 日志填写不完整自动检测并邮件提醒”说明）。b)是否为用户设置好了检测规则(规则要启动，见“ 1.9 设置检查规则”说明)，只要设置了才会自动检测这些用户的日志。c)邮件发送配置是否正确，到后台-发件里测试配置是否正确，可以测试发件来判断正确。

2）安装插件后，看不到“工作日志”菜单

以管理员身份登录禅道，导航至：组织-权限，点击分组右侧的“权限维护"按钮。弹开的页面中，点击“工作日志”，勾选要给此分组来分配权限，保存后，使用此分组下的用户重新登录，即可看到“工作日志”菜单（见“安装文档”说明）

3） 如果同时也安装了官方“日志管理”插件后，会导致与本插件冲突。

如果同时安装，会导致本插件功能异常：在工作日志-工作日志（日历）里看不到添加的工作日志。

请根据实际情况选择使用官方的“日志管理”插件还是本插件。都有各自的优点。

已安装了官方的日志管理插件的情况下，如何使用本插件，请邮件联系指导如何操作。

4）为什么“工作日志”页面没有填写日志的入口，或没有显示日志数据？

首先，看看是否同时安装了 “日志管理”插件，会导致与本插件冲突。

再就是， “工作日志”页面按设计就是不提供没有填写日志的入口，填写任务时填写的耗时和备注信息会自动转为工作日志。所以你开始做一下任务吧，再来看看是否有日志可查。

5）为什么工作日志（日历）里，有些记录只显示了耗时，没有显示工作日志内容？

解决办法：安装《 任务剩余工时自动计算》插件。可以约束填写工时时必须填写工作内容

6）安装报错

如果报如下错误：SQLSTATE[42000]: Syntax error or access violation: 1370 execute command denied to user 'zentao'@'localhost' for routine 'zentao.TryExec'。原因是zentao用户权限不足，无法创建存储过程。要改为root账号。

解决办法：

如果是windows一键安装的版本，打开{安装目录}\xampp\zentao\config\my.php文件， 将$config->db->user ='zentao' 改为 $config->db->user ='root'。保存文件后，无需重启禅道。重新上传插件就可以成功。

如果是linux一键安装的版本，编辑/opt/zbox/app/zentao/config/my.php，将$config->db->user ='zentao' 改为 $config->db->user ='root'。 保存文件后，无需重启禅道。重新上传插件就可以成功。

感谢您的使用。