Repository navigation
Home
wangmingyu edited this page Jul 3, 2013
·
5 revisions
Welcome to the pmmm wiki!
为了准确统计各项目的人力和阶段投入,根据本公司的实际工作流程和需要,决定自行研发融易通工时系统。本公司目前采用开源系统trac+mercurial的方式管理项目文档,代码,里程碑,ticket流转等相关事务。具体说明和使用方法见相关官方网站。
同时本公司为了方便项目的管理和维护,已经开发了一个trac的插件pmmm项目管理系统,同时在pmmm的基础上开发了工时系统,可以有效采用之前的一些框架和成果。
Pmmm是一个基于trac开发的插件,主要功能有:
- 用户管理
添加和删除用户。在工时系统界面添加新用户,英文名(RYTong的命名规范为姓.名)以及中文名(可选)和密码。在系统配置中可以将员工删 除。添加和删除用户的操作均是对.htaccess文件进行添加或者删除,在添加用户时.htaccess文件只保存用户英文名以及密码,在user表中 保存英文名以及中文名。在用户登陆系统时验证.htaccess文件中的信息是否正确,在修改用户密码时修改此处信息,crypt.crypt(password , salt())进行加密;
- 权限管理
管理用户的项目权限,可以将用户从一个项目中添加和删除,目前项目的trac信息保存在/home/trac目录下,源代码信息保存在/home/hg/ repos/proj/proj_name目录下,脚本通过遍历目录名来得到当前有哪些项目。在管理用户项目权限时修改/home/hg/acl/目录下的访问控 制文件。 管理用户的代码权限,可以将用户从一个模块中添加和删除,对模块代码权限控制的文件关联在/home/hg/scripts/conf/projects.conf文 件中描述。对不同模块目录的用户权限控制通过.htaccess文件命名规则来实现,文件名中包括项目名和模块名。即/home/hg/acl/.htaccess -proj-projectName-moduleName文件。
- 项目管理
创建一个新项目,可以在创建项目时在ModuleSpec处填写module spec,通过clone初始模块来建立项目。如果ModuleSpec为空,则创建一个 空项目,在创建项目时,必须为项目分配人员,否则项目建立不成功。在系统配置中,可以对项目进行删除以及添加项目经理。在工时系统界面点击 项目名,可进入项目维护界面,可以新建或者clone一个module、make a new release、make a new branch、clone this project ,对已有的modules进行删除或者Experiment、rename,可以查看项目员工以及删除和增加员工。
- 代码管理
创建新模块,即hg的repository创建模块,创建新模块有2种方式,第一种是创建空模块,第二种是通过clone来创建模块。Make branches 创建分支。可以基于主干和release建分支。Make release,发布版本。可基于主干和分支。在项目目录下有branches目录和release目录, 分别存放已经建立的分支和发布版本。建立branches是通过clone得到所有模块的源代码。release分支是通过clone得到所有模块的源代码, 对于release版本目录,通过修改配置文件模块下的配置文件.hg/hgrc,使得代码不可提交。在有代码权限时可以clone代码。
此外工时统计系统将作为pmmm插件的一部分嵌入到pmmm插件中,和pmmm插件公用一套用户管理和权限控制,在pmmm基础上添加工时系统的功能。该功能包括以下子功能模块:
- 工时记录查询
在进入工时界面时,普通员工仅显示时间段选择仅能查询自己工时记录;项目经理登陆界面显示内容不同,除了有固定的时间段选择外,还有选择查询 条件,可按项目或员工进行查询(在html页面通过div class="projAdmin" py:if="pm_is_project_admin"来判断登陆者是否可以显 示此div中的显示内容);按项目查询时选择项目进行提交,查询所选项目下的所有员工工时记录;按员工查询显示登陆用户项目下的员工,选择全 部或部分员工进行记录查询。
- 填报工时
在用户登陆填写工时界面时顶部会显示用户审核未通过的工时记录(在后台首先查询登陆用户的工时记录审核状态是否有不合格的,check_status 大于1的工时记录。),用户可以删除或者重新编辑;在proj_user表中,查询出登陆用户所在的所有项目,供填写时选择;由于不同的里程碑存放 在不同项目的数据库中,根据项目连接不同数据库路径查出对应项目的里程碑供填写时选择;在proj_type表中查询出所有工作类型。员工自己填 写工时以及选择工作日、填写工作内容等信息。
- 发送周报
由于每周末要进行本周工作总结以及汇报下周工作计划,在系统中添加自动发送周报功能;点击发送周报进入邮件填写界面,收件人为登录用户所在
部门邮箱;主题为登陆用户中文名 本周的日期;本周工作计划为登录用户本周所填写的全部工时记录。以上均是系统自动获取;只有下周计划根据
实际情况用户自己填写。在本周的周四至下周的周三所发周包内容均是本周的周报;发送邮件地址为'weeklyreport@rytong.com',在系统中
设置此邮件地址。
其中mail_host = 'mail.rytong.com',mail_user = 'weeklyreport@rytong.com',mail_pwd ='reportweek'。主要实现的方
法为:
s = smtplib.SMTP('mail.rytong.com',25) 说明:SMTP协议只能用来发送邮件,不能用来接收邮件。第一个参数为邮件服务器名,第
二个为SMTP协议的TCP端口号。
s.ehlo()
s.starttls()
s.ehlo()
s.login(mail_user,mail_pwd)
s.sendmail(mail_user,mail_to.split(','),msg.as_string())
s.quit()
- 工时审核
员工提交工时记录时。审核状态check_status=0,即未审核状态,员工的上属领导要进行审核才能生效。审核中可以根据实际情况进行工时审 核,也可填写备注。提交后,工时的审核状态变为相应的情况(审核通过、内容不符、时间不符)。
- 统计分析
1 按月统计员工工作量在统计分析界面,选择统计时间,显示出所有数据。其中project是proj_hours_record中的所有项目。用户为user表中的所有用户。查询的工 作量为每个用户在该月每个项目中审核通过的工时记录时间总和。统计的数据有员工在项目上每月审核通过的工时记录总和、每个项目在该月审核通 过的记录的时间总和、每个用户在该月审核通过的记录时间总和。2 统计部分员工月工作量与上面1统计方法相同,不同的是1中统计的是user表中所有用户,而这个可以选择某些人进行统计。显示的供选择的用户是user表中的用户数据。 统计方法和上面相同,就不做介绍。3 项目工时统计报表在统计中之前,要选择统计的项目以及统计时间跨度(即proj_name,startTime,endTime)。选择统计方法(按人员划分、按投入划分、按 工作岗位划分)进行统计,按人员统计得出员工工时数以及成本,按投入划分查询项目不同投入对应工时数,按工作岗位查询出项目在不同岗位上投 入的工时数。4 工时记录统计表统计表中统计工时记录填写不合格以及缺少工时记录数的数据;选择要统计的月份,根据实际情况填写统计月的工作日数进行统计。5 工作量统计汇总表工作量统计表直接得出的是excel文件,用户可以直接打开或者保存excel文件;统计前填写统计年份(例如:2012),选择统计方式(包括加 班、不包括加班)。包括加班计算方式时根据工时记录表中填写的实际情况计算,而不包括加班则限制人员每月填写的工作量最多为22个工作日。 得出的数据是每个项目中员工每月的工作量。6 财务汇总表财务汇总表仅财务服务器可以正常得出数据。填写统计的年份。按月计算出不同项目的支出情况。按月计算出项目的人力成本,即人员每月在此项 目上的工作量*每天的平均工资。此处的工作量也做了限制,最大工作量不能超过22天。
- Import Excel
由于外地项目网络限制,不能及时填写工时记录,所以可以将员工工时记录按照规范文档填写在excel中,最后由项目经理统一import 到proj_hours_record表中。 在导入中还可以导入考勤记录表数据到attendance_record表中,为以后添加其它功能提供数据。
- 项目财务填报
此功能模块仅在财务服务器上能完成,记录项目中每月的财务支出与收入情况。在填写时选择项目,财务类型,金额,日期,备注可选,记录项目 组的财务收入与支出信息。
- 系统配置
1 同步.htaccess文件和数据库由于删除离职员工或者其他原因,没能及时同步proj_user数据,所以在proj_user中的数据不准确,所以设置此功能,及时更新proj_user表 中数据。点击同步后,系统首先删除proj_user表中所有数据。通过获取的项目到home/hg/acl路径下访问.htaccess-proj-项目名文件, 查、询出项目的用户。最后将项目和项目用户写入proj_user表中。2 同步project表与proj_user表用户由于之前系统设计的不完善,有些用户已经离职,可是在project中仍然存在相关用户信息,所以要同步下用户信息;查询project表中 的proj_manager_name是否在proj_user,若不在,删除project表中此人的所有数据。3 删除项目和添加/删除项目经理勾选项目名进行项目删除(删除proj_user,proj_info,project表中数据);点击项目名进入项目经理维护界面,添加或删除项目经理。4 删除工作类型选择一个或多个工作类型,进行删除。对应删除proj_type表中信息。工作类型在填写工时记录时供员工选择本天工作类型。5 将项目和用户写入数据库此操作将会删除user表和proj_info表中数据,所以操作需谨慎。 第一步:删除user表和proj_info(proj_name,proj_name_zh)表中的所有数据。由于用户存放在.htaccess文件内,获取现在全部用 户;在/home/hg/repos/proj目录下存放了以项目名命名的文件夹,通过for p in os.listdir(self.PROJROOT): projs.append(p)获取所有项目名; 第二步:将得到的数据写入user表,将项目信息写入proj_info表。此时用户表中将恢复初始状态,即所有用户的信息均为u,””,0,0,"",0,""; proj_info中仅有项目英文名;6 添加或删除人员或项目中文名在界面显示员工和项目中文名信息,可以添加和删除中文名。界面显示的用户信息和项目信息分别为user表和proj_info表中信息。添加和删除 对应的操作都是对user表和proj_info表进行相应操作。将用户中文名或项目中文名设置为“”;7 添加部门信息1.新建部门:添加部门信息到department表。 2.编辑部门信息:点击部门名,进入部门信息界面。 在部门维护界面可以修改部门名、上属部门编号和部门邮件。操作的对象为department表。可以删除部门经理、部门副经理,添加部门经理、 部门副经理,删除部门人员,添加部门人员。在关于部门经理和副经理操作时,如果添加部门经理,在操作department表的同时,也要 在permission表中添加对应的权限。项目经理的权限为DEPARTMENT_ADMIN。在删除项目经理时同样将permission表中的有关数据一同删除; 在添加和删除部门用户时,则修改的是user表中关于dep_id列,如果是删除用户则是将user表中dep_id默认设置为0. 3.删除部门:将删除部门的用户dep_id设置为0;删除department表中关于项目的数据;8 删除或设置离职用户在界面显示user表中所有用户、在职用户和离职用户。在user表中有use_state列,0代表在职。 删除用户:删除user表以及proj_user表中数据。 离职用户:修改user表中use_state为1(离职),删除proj_user表中数据,如果用户为项目经理,同样删除project中相关信息。如果用户 为部门经理或是副经理,同样删除部门经理或副经理信息。对于离职用户仅保留proj_hours_record中的记录;9 用户级别维护显示用户级别信息(初级、中级、高级、专家级),修改用户级别时是修改user表中user_level列。10 用户工资维护此功能模块仅在财务服务器能够完成,用来添加修改员工工资信息。11 员工工作岗位维护显示员工工作岗位,仅显示在职人员。可根据实际情况修改员工工作岗位。修改时修改user表中use_work_type 列。