基于禪道的研發(fā)資源Web報(bào)表系統(tǒng)的設(shè)計(jì)與開發(fā)

張麗麗 鄔錫江 劉洪

收稿日期：2023-07-28

DOI：10.19850/j.cnki.2096-4706.2024.06.008

摘? 要：禪道是研發(fā)管理中應(yīng)用非常廣泛的項(xiàng)目管理軟件，它涵蓋從項(xiàng)目立項(xiàng)、需求、任務(wù)單，到資源投入等研發(fā)全要素管理?？梢暬芾硎茄邪l(fā)資源管理的重要應(yīng)用，將采集到的研發(fā)要素?cái)?shù)據(jù)，按項(xiàng)目階段，實(shí)時(shí)提供任務(wù)績(jī)效、員工績(jī)效等數(shù)據(jù)的可視化，將會(huì)提升項(xiàng)目過(guò)程管理效率。為了不改變禪道本身邏輯和不增加報(bào)表系統(tǒng)運(yùn)維負(fù)擔(dān)，通過(guò)分析設(shè)計(jì)，在禪道數(shù)據(jù)庫(kù)上，以定義存儲(chǔ)過(guò)程的形式，進(jìn)一步加工禪道項(xiàng)目管理系統(tǒng)的基礎(chǔ)數(shù)據(jù)。再以接口的方式實(shí)現(xiàn)跨系統(tǒng)調(diào)用，向管理者展現(xiàn)可視化報(bào)表。經(jīng)自主開發(fā)實(shí)現(xiàn)，該Web報(bào)表系統(tǒng)的多維度靈活組合功能，確實(shí)有效提升了研發(fā)資源的可視化監(jiān)測(cè)效率。

關(guān)鍵詞：禪道；可視化管理；Web報(bào)表系統(tǒng)；自主開發(fā)

中圖分類號(hào)：TP311? ? 文獻(xiàn)標(biāo)識(shí)碼：A? 文章編號(hào)：2096-4706（2024）06-0035-05

Design and Development of a Web Reporting System for Research and

Development Resource Based on ZenTao

ZHANG Lili， WU Xijiang， LIU Hong

（Whayer Intelligent Technology （Group） Co.， Ltd.， Chengdu? 610041， China）

Abstract： ZenTao is a very widely used project management software in research and development management， which covers research and development total factor management from project establishment， demand， task list， to resource input. The visual management is an important application of research and development resource management. The collected research and development element data will provide real-time visualization of task performance， employee performance， and other data according to project stages， which will improve the efficiency of project process management. In order to not change the logic of ZenTao itself and not increase the burden of report system operation and maintenance， through analysis and design， the basic data of ZenTao project management system is further processed in the form of defined stored procedures on the ZenTao database. By implementing cross system calls through interfaces， visual reports are presented to managers. After independent development and implementation， the multi-dimensional and flexible combination function of this Web report system has effectively improved the visual monitoring efficiency of research and development resources.

Keywords： ZenTao; visual management; Web reporting system; independent development

0? ?引? 言

項(xiàng)目管理作為現(xiàn)代管理科學(xué)的重要分支之一，研發(fā)項(xiàng)目管理，是項(xiàng)目管理特定領(lǐng)域的分支，從軟件工程開始，總在努力對(duì)研發(fā)工作項(xiàng)目管理的分析和探討。如研究需求生命周期管理，從需求變更，到如期交付及合理運(yùn)用有限的研發(fā)資源，來(lái)提升企業(yè)競(jìng)爭(zhēng)力[1]。如基于IPD集成研發(fā)體系下績(jī)效研究[2]等。同時(shí)，隨著理論研究的不斷完善和成熟，軟件市場(chǎng)上紛紛出現(xiàn)了專門的研發(fā)項(xiàng)目管理工具，如曼索的數(shù)字化集成研發(fā)平臺(tái)、禪道等。

禪道項(xiàng)目管理軟件（ZenTao Project Management System， ZenTaoPMS）[3]第一款國(guó)產(chǎn)的開源研發(fā)類項(xiàng)目管理軟件，2014年就出現(xiàn)了與其相關(guān)的文獻(xiàn)研究成果。禪道集產(chǎn)品管理、項(xiàng)目管理、測(cè)試管理于一體。為了平衡項(xiàng)目臨時(shí)性特征和組織穩(wěn)定性，一個(gè)研發(fā)資源身兼多個(gè)項(xiàng)目的開發(fā)任務(wù)是非常常見配置原則，通過(guò)禪道項(xiàng)目管理軟件的實(shí)施，能很好地量化工作量，為研發(fā)績(jī)效提供客觀的數(shù)據(jù)依據(jù)，鑒于該軟件基于開源的ZPL協(xié)議，使用PHP+MySQL開發(fā)，成了很多中小型企業(yè)項(xiàng)目管理的首選。

禪道項(xiàng)目管理流程核心流程[4]，先創(chuàng)建項(xiàng)目，形成需求列表，之后對(duì)需求進(jìn)行分解，創(chuàng)建模塊，創(chuàng)建項(xiàng)目/階段/模塊的任務(wù)單，任務(wù)單記錄了任務(wù)類型，預(yù)計(jì)工時(shí)，工期，指派人員等信息；之后，任務(wù)執(zhí)行人員匯報(bào)任務(wù)日志。過(guò)程中，若發(fā)生拆分任務(wù)，父項(xiàng)任務(wù)單若產(chǎn)生消耗，為保證數(shù)據(jù)一致性，系統(tǒng)會(huì)創(chuàng)建一條同名子任務(wù)記錄該消耗；拆分子項(xiàng)后，父項(xiàng)任務(wù)單只有拆分子項(xiàng)的功能，其預(yù)計(jì)工時(shí)、消耗、剩余均按子項(xiàng)合計(jì)；若指派人員發(fā)生了變化，管理上要求創(chuàng)建新的任務(wù)，且原任務(wù)單按實(shí)際消耗調(diào)整。

報(bào)表是可視化管理的手段之一[5]，經(jīng)過(guò)調(diào)研研發(fā)業(yè)務(wù)管理需求，了解到一組實(shí)時(shí)掌握研發(fā)資源投入狀態(tài)的報(bào)表，可有效幫助研發(fā)組織的管理者協(xié)調(diào)資源。比如，面對(duì)變更類需求，這種臨時(shí)性，但又緊急的研發(fā)資源投入，如果能及時(shí)掌握所有成員，在近一周每天的負(fù)載情況，將能非常高效的篩選出合適符合的資源去響應(yīng)緊急變更類需求。比如，面對(duì)新項(xiàng)目時(shí)，通過(guò)查詢處于測(cè)試階段的所有項(xiàng)目，了解它們占用資源的復(fù)核狀態(tài)后，及時(shí)圈定可釋放的資源來(lái)順滑地轉(zhuǎn)移到新項(xiàng)目的啟動(dòng)。比如，在資源發(fā)生搶奪時(shí)，期望通過(guò)查詢?cè)撡Y源在不同項(xiàng)目上的分布情況，通過(guò)項(xiàng)目?jī)?yōu)先級(jí)考慮，釋放此資源在低優(yōu)先級(jí)項(xiàng)目上的投入，轉(zhuǎn)而投入到高優(yōu)先級(jí)項(xiàng)目。這樣的報(bào)表數(shù)據(jù)，將最大化的利用研發(fā)資源，而不影響項(xiàng)目進(jìn)度，通過(guò)靈敏的資源協(xié)調(diào)，來(lái)有效緩解研發(fā)資源短缺的沖突。

禪道項(xiàng)目管理軟件提供的標(biāo)準(zhǔn)度量統(tǒng)計(jì)，如組織類統(tǒng)計(jì)報(bào)表、項(xiàng)目類統(tǒng)計(jì)報(bào)表，在組織類統(tǒng)計(jì)報(bào)表，可以查詢員工負(fù)載，若要統(tǒng)計(jì)近幾天每天的員工負(fù)載，就需要查詢多次，反反復(fù)復(fù)非常浪費(fèi)時(shí)間。統(tǒng)計(jì)組織里某個(gè)關(guān)鍵資源，只能統(tǒng)計(jì)總量，要觀察其在不同項(xiàng)目的投入情況，也是無(wú)法可視化的。項(xiàng)目類統(tǒng)計(jì)報(bào)表統(tǒng)計(jì)的是項(xiàng)目狀態(tài)（進(jìn)行中、掛起）等，如要統(tǒng)計(jì)測(cè)試階段的，是無(wú)法統(tǒng)計(jì)的。度量統(tǒng)計(jì)的“雞肋”問題變相地阻礙著禪道項(xiàng)目管理軟件推廣和應(yīng)用。

為了解決度量統(tǒng)計(jì)的“雞肋”問題，考慮到禪道軟件應(yīng)用的廣泛性，為了不影響禪道本身邏輯，讓報(bào)表分析系統(tǒng)作為禪道系統(tǒng)的補(bǔ)充，而使用外掛系統(tǒng)[6]的方式。同時(shí)，為了不增加對(duì)外掛系統(tǒng)的運(yùn)維工作量，如權(quán)限維護(hù)等，在用戶驗(yàn)證和權(quán)限控制上，完全與禪道項(xiàng)目管理系統(tǒng)共用。

通過(guò)分析設(shè)計(jì)，在禪道數(shù)據(jù)庫(kù)上，以定義存儲(chǔ)過(guò)程的形式，進(jìn)一步加工禪道項(xiàng)目管理系統(tǒng)的基礎(chǔ)數(shù)據(jù)，多項(xiàng)目多階段多模塊等多維度靈活組合，按天、按周和按月不同的粒度分布的視圖或存儲(chǔ)過(guò)程數(shù)據(jù)塊。再以，接口的方式實(shí)現(xiàn)跨系統(tǒng)調(diào)用，向管理者展現(xiàn)可視化報(bào)表。

在驗(yàn)證查詢結(jié)果的過(guò)程中發(fā)現(xiàn)，禪道項(xiàng)目管理的數(shù)據(jù)校驗(yàn)[7]非常弱，比如截止日期早于開始日期的錯(cuò)誤，系統(tǒng)未基于邏輯校驗(yàn)和提示?；A(chǔ)數(shù)據(jù)的邏輯錯(cuò)誤勢(shì)必影響報(bào)表數(shù)據(jù)分析。因此，在研發(fā)資源Web報(bào)表系統(tǒng)，針對(duì)發(fā)現(xiàn)基礎(chǔ)數(shù)據(jù)邏輯異常設(shè)計(jì)了若干識(shí)別規(guī)則，在查詢反饋的同時(shí)，將識(shí)別的異常清單一并反饋給報(bào)表管理者，讓管理者曉得統(tǒng)計(jì)結(jié)果的同時(shí)知曉數(shù)據(jù)是否存在質(zhì)量問題，從而反向督促禪道使用人員錄單的正確性。

最終經(jīng)過(guò)自主開發(fā)[8]，其成果的試運(yùn)行驗(yàn)證，該Web報(bào)表系統(tǒng)的多維度靈活組合、一次到位、支持導(dǎo)出等，大大提升了公司研發(fā)資源監(jiān)測(cè)效率和準(zhǔn)確度。

1? 設(shè)計(jì)模型

研發(fā)資源Web報(bào)表系統(tǒng)采用的是MVC [9]架構(gòu)設(shè)計(jì)，通過(guò)封裝接口調(diào)用禪道項(xiàng)目管理業(yè)務(wù)數(shù)據(jù)，實(shí)現(xiàn)報(bào)表用戶與研發(fā)資源的交互查詢，系統(tǒng)架構(gòu)如圖1所示。

圖1? Web報(bào)表系統(tǒng)架構(gòu)

1.1? 安全設(shè)計(jì)

1）登錄驗(yàn)證：嫁接禪道PMS的賬號(hào)和密碼。

2）訪問權(quán)限：嫁接禪道的權(quán)限管理，實(shí)現(xiàn)對(duì)Web報(bào)表系統(tǒng)的授權(quán)訪問。

研發(fā)資源Web報(bào)表的賬號(hào)密碼和權(quán)限，統(tǒng)一由禪道PMS管理員進(jìn)行維護(hù)，不會(huì)增加額外的運(yùn)維風(fēng)險(xiǎn)和負(fù)擔(dān)。

3）采用CORS控制，CORS是一個(gè)W3C標(biāo)準(zhǔn)，全稱是“跨域資源共享”（Cross-Origin Resource Sharing）。它允許瀏覽器向跨域的服務(wù)器，發(fā)出XMLHttpRequest請(qǐng)求，從而克服了AJAX只能同源使用的限制。

1.2? 流程設(shè)計(jì)

1）報(bào)表用戶登錄研發(fā)資源Web系統(tǒng)，驗(yàn)證賬號(hào)密碼和權(quán)限。

2）報(bào)表用戶進(jìn)入“研發(fā)資源監(jiān)測(cè)”功能頁(yè)面，輸入項(xiàng)目、成員、模塊、顯示內(nèi)容、統(tǒng)計(jì)周期、粒度、匯總級(jí)別，點(diǎn)擊查詢，展示查詢結(jié)果。

3）報(bào)表用戶進(jìn)入“工作量統(tǒng)計(jì)-項(xiàng)目版”功能頁(yè)面，輸入項(xiàng)目、階段、模塊、成員、統(tǒng)計(jì)周期、匯總級(jí)別，點(diǎn)擊查詢，展示查詢結(jié)果。

4）報(bào)表用戶進(jìn)入“工作量統(tǒng)計(jì)-員工版”功能頁(yè)面，輸入成員、項(xiàng)目、階段、模塊、統(tǒng)計(jì)周期、匯總級(jí)別，點(diǎn)擊查詢，展示查詢結(jié)果。

5）每次查詢，提示報(bào)表查詢?nèi)藛T存在異常邏輯的任務(wù)單及清單。

6）導(dǎo)出當(dāng)前查詢方案和查詢結(jié)果，直接形成分析報(bào)表，方便匯報(bào)工作。

2? 開發(fā)實(shí)現(xiàn)

2.1? 接口開發(fā)

API接口[10]是通過(guò)封裝技術(shù)，實(shí)現(xiàn)對(duì)禪道PMS數(shù)據(jù)的調(diào)用。通過(guò)深入解析研發(fā)資源統(tǒng)計(jì)需求，梳理并設(shè)定研發(fā)資源Web報(bào)表系統(tǒng)用到的數(shù)據(jù)內(nèi)容。通過(guò)解讀禪道PMS數(shù)據(jù)庫(kù)結(jié)構(gòu)，采用數(shù)據(jù)庫(kù)跟蹤技術(shù)，并結(jié)合前后端互驗(yàn)等，鎖定統(tǒng)計(jì)數(shù)據(jù)內(nèi)容對(duì)應(yīng)的PMS數(shù)據(jù)表。

2.1.1? 基礎(chǔ)接口

基礎(chǔ)接口，是指查詢參數(shù)調(diào)用的接口，傳遞參數(shù)為P1，P2，P3。分別定義了查詢項(xiàng)目名稱、項(xiàng)目成員、模塊、成員等數(shù)據(jù)從PMS的讀取，基礎(chǔ)API清單如表1所示。

2.1.2? 單據(jù)接口

單據(jù)接口，是指查詢接口調(diào)用的接口。研發(fā)資源投入監(jiān)測(cè)API，輸入查詢參數(shù)值，輸出查詢結(jié)構(gòu)，傳遞參數(shù)為Project， Member， Module， Satge等，研發(fā)資源投入監(jiān)測(cè)API清單如表2所示。

工作量統(tǒng)計(jì)API，輸入查詢參數(shù)值，輸出查詢結(jié)構(gòu)，傳遞參數(shù)為P1，P2，P3等，工作量API清單如表3所示。

表3? 工作量（項(xiàng)目版和員工版）API清單

a01 P1 P2 … P7

類型 粒度 … 模塊

1 MemberProjectModuleWorkload Days … ，-1，

2 MemberProjectWorkload Weeks … 〝? 〞

3 MemberWorkload Months … 〝? 〞

4 MemberProjectModuleCoefficient 〝? 〞 … 〝? 〞

5 MemberProjectCoefficient 〝? 〞 … 〝? 〞

6 MemberCoefficient 〝? 〞 … 〝? 〞

2.1.3? 其他接口

其他API，屬于系統(tǒng)驗(yàn)證類。輸入?yún)?shù)，輸出驗(yàn)證結(jié)構(gòu)等，如表4所示。

表4? 其他API清單

接口名稱 P1 P2 備注

API/GetEffectiveDays 2021-01-01 2021/12/31 獲取有效

工作天數(shù)

API/SignIn 成功為1失敗為0 〝? 〞 登錄接口

API/logout 〝? 〞 〝? 〞 退出接口

2.2? 前端開發(fā)

采用的VUE-element框架，前端UI界面示例如圖2所示。

前端開發(fā)，采用左側(cè)導(dǎo)航，右側(cè)查詢的布局。在上端設(shè)計(jì)過(guò)濾方案，下放呈現(xiàn)查詢結(jié)果，為了更好地分析數(shù)據(jù)，設(shè)計(jì)了隱藏過(guò)濾方案的功能，可最大化查詢結(jié)果的現(xiàn)實(shí)尺寸。

在查詢結(jié)果，左側(cè)三列做了固定處理，表頭做了固定處理，這樣不論是上下滾動(dòng)條，還是左右滾動(dòng)條，左側(cè)和表頭內(nèi)容都能鎖定不動(dòng)，模擬Excel的效果。

2.3? 后端開發(fā)

采用的CI框架，PHP開發(fā)，開發(fā)界面如圖3所示。

項(xiàng)目編譯打包后的文件->部署配置，如圖4所示，其中在dist＼js＼路徑下找到以app.開頭的js文件記事本打開查找admin："userName"替換為以下代碼：admin：window.zentaoLoginUserName。

圖4? 部署配置

3? 結(jié)? 論

研發(fā)資源Web報(bào)表系統(tǒng)，經(jīng)研發(fā)團(tuán)隊(duì)試運(yùn)行，取得很好的反饋，在研發(fā)資源統(tǒng)計(jì)上極大的支撐了管理的需要，不論是HR，還是研發(fā)領(lǐng)導(dǎo)，都能很好的滿足他們的數(shù)據(jù)需求。

目前，研發(fā)資源Web報(bào)表系統(tǒng)是能更好滿足領(lǐng)導(dǎo)或組織層面的使用。實(shí)際工作中，尤其是針對(duì)員工個(gè)人層面的數(shù)據(jù)查詢，比如僅且只能查詢自己的項(xiàng)目數(shù)據(jù)。優(yōu)化建議，增加數(shù)據(jù)范圍的權(quán)限設(shè)置。

是否要優(yōu)化數(shù)據(jù)范圍的權(quán)限設(shè)置，要結(jié)合研發(fā)項(xiàng)目團(tuán)隊(duì)的實(shí)際工作氛圍，像禪道PMS是沒有數(shù)據(jù)范圍權(quán)限設(shè)置的，完全是基于信任模式進(jìn)行管理。

本次研究以外掛系統(tǒng)的方式，主要是因?yàn)楦鶕?jù)管理要求，整個(gè)系統(tǒng)工作均是VPN內(nèi)網(wǎng)使用。如果在互聯(lián)網(wǎng)環(huán)境中使用Web報(bào)表系統(tǒng)，如何保障外掛軟件的安全性，避免信息安全事件的發(fā)生，是需要深入設(shè)計(jì)和考慮的。

參考文獻(xiàn)：

[1] 徐神玲.C公司研發(fā)項(xiàng)目管理優(yōu)化研究 [D].上海：華東師范大學(xué)，2022.

[2] 劉宇，吳一坤，房馨.在基于IPD集成產(chǎn)品研發(fā)流程的績(jī)效研究 [J].價(jià)值工程，2023，42（15）：8-11.

[3] 孫黎黎.基于敏捷開發(fā)方法的軟件項(xiàng)目過(guò)程管理研究與實(shí)踐 [D].北京：北京郵電大學(xué)，2018.

[4] 高湘飛，趙星漢，高楓，等.軍用軟件測(cè)試項(xiàng)目管理系統(tǒng)設(shè)計(jì)與實(shí)現(xiàn) [J].軟件導(dǎo)刊，2016，15（6）：100-103.

[5] 楊玉龍.企業(yè)數(shù)據(jù)統(tǒng)計(jì)報(bào)表系統(tǒng)的設(shè)計(jì)與實(shí)現(xiàn) [D].北京：北京交通大學(xué)，2016.

[6] 封正，張昊，蔣少良，等.公安交管外掛軟件安全性檢驗(yàn)技術(shù)研究及思考 [J].中國(guó)標(biāo)準(zhǔn)化，2022（1）：210-215.

[7] 姜瑞.基于微服務(wù)和規(guī)則引擎的數(shù)據(jù)校驗(yàn)系統(tǒng)設(shè)計(jì)與實(shí)現(xiàn) [D].武漢：華中科技大學(xué)，2021.

[8] 殷海鵬.Z公司軟件項(xiàng)目管理優(yōu)化研究 [D].上海：華東師范大學(xué)，2022.

[9] 李小燕.基于MVC框架的醫(yī)院成本核算系統(tǒng)設(shè)計(jì) [J].微型電腦應(yīng)用，2021，37（10）：141-145.

[10] 張?jiān)S.前后端分離框架之API接口開發(fā)與分析——紅色書籍抽獎(jiǎng)系統(tǒng) [J].網(wǎng)絡(luò)安全技術(shù)與應(yīng)用，2021（12）：48-49.

作者簡(jiǎn)介：張麗麗（1988—），女，漢族，山東菏澤人，需求工程師和項(xiàng)目經(jīng)理，碩士，研究方向：企業(yè)信息化；鄔錫江（1985—），男，漢族，四川成都人，PHP開發(fā)工程師，本科，研究方向：程序開發(fā)；劉洪（1996—），男，漢族，四川成都人，Web前端開發(fā)工程師，本科，研究方向：UI開發(fā)。