背景

项目管理系统主要目的最开始是为了解决提高 PMO 手动出人效的效率.

我司的项目管理比较乱,核心数据存在了外部购买的系统上"teambition",比如项目排期、测试用例、bug 等数据.PMO 同学在做数据统计的时候,先要从 teambition 倒出一份原始数据,再按照 pmo 约定的规则计算人效,计算的效率极低.

由于 PMO 计算人效的公式是内部协商出来的:

1、当研发阶段的时候,开发人效 +1
2、当测试阶段的时候,开发人效 +0.5、测试人效 +1
3、当前上线阶段,开发人效 +0.5、测试人效 +1
等等还有一些公式

实现方案

1、经过调研在 teambition 开发,如果达成 pmo 的效果,需要给 teambition 提需求,经过沟通比较难实现.

2、自研项目管理系统,通过同步 teambition 把数据存储到研项目管理系统,把计算人效逻辑封装到后端服务中.

自研系统好处:

1) 锻炼前端后端开发技术

2) PMO、产品、研发共建系统,拉起目标

3) 向上管理工具

自研系统缺点:

1) 产品大多没有架构设计

2) bug 多,代码难维护

3) 代码服务没分层

业务架构

如下图是当时 pmo 设计得产品原型图,包含从项目管理角度出发覆盖研发效能到质量分报告,涉及得功能模块比较全.

首页图表

需求维度

质量分报告

如下图是产品架构

开发架构

前端

参考 vue admin 平台,隐藏不需要代码即可,开箱即用.

https://github.com/PanJiaChen/vue-element-admin

依赖如下库

vue2.x、axios、echarts、element-ui、stylus等库

后端

后端系统主要使用 django 全家桶开发,类库比较多、并且 ORM 功能强大、部署方便.

django全家桶、 mysql 、 redis 、 request 、gunicorn等库

经过几个迭代以后,代码越来越多,所有功能模块都写到一个服务上,变的越来越重.应该考虑微服务架构解耦代码问题.

定时任务

1、jenkins

jenkins 主要做同步数据脚本使用,配置方便

2、apscheduler

apscheduler 库,为了实现内部方法做定时任务使用.

接入公司的单点 sso 登录

每个公司为了统一账号密码登录控制,都会由运维部门统一认证后,才能登录各个子系统.目的在于安全、统一管理账号密码.

下图是单点登录的首页,支持账号密码登录或者扫描二维码登录.

接入后,登录后可以拿到姓名、岗位等信息,方便后续权限管理模块开发.

接单点登录系统,一般需要和单点登录系统注册,注册后会把给 client_id 和 client_secret 两个参数,为了安全性考虑.

需要在前端启动首页的时候,如果没有登录就去访问登录首页.

在 router.beforeEach 函数中,从 cookie 中获取 token,如果没有 token 跳转到登陆页面.

登陆页面的逻辑,首页会判断是有 code,没有的话调用接口获取 code,code 参数通过前端页面拦截获取,所以这样是很安全的.拿到 code 再去换 token,最后获取用户信息的接口携带 token 参数,跳转到首页.

共享登录状态

内部有很多系统都接入了单点登陆系统,为了能登陆一次系统后,再登陆其他系统就不需要再登陆,需要共享登陆状态.

如果设置 cookie 的话,把 cookie 种在根域下就可以,这样就通过 cookie 完成了共享登陆状态.

首页

数据来源

由于我们和"teambition"第三方公司签约到很久,需求数据、bug、测试用例都存在了
"teambition"平台.所以需要使用对接"teambition"的 api 完成数据同步.

teambition 接口鉴权这款还是比较复杂的,首先有管理员账号并且生成对应的 token.

使用 jwt 对参数进行编码解码等一系列操作生成 token,放在请求的 header 中.

def get_token():
    """
    生成token
    :return:
    """
    payload = {}
    iat = math.floor(int(time.time()) / 3600 * 3600)
    payload['iat'] = iat
    payload['_appId'] = appId

    headers = {
        "alg": "xxx",
        "typ": "JWT"
    }
    token = jwt.encode(payload, appSecret, headers=headers).decode('utf-8')
    return token

teambition 的官方接口文档,如果对接第三方系统,没有好的接口文档,开发的过程中会很痛苦.