基于禪道的研發資源Web報表系統的設計與開發

張麗麗 鄔錫江 劉洪

收稿日期：2023-07-28

DOI：10.19850/j.cnki.2096-4706.2024.06.008

摘? 要：禪道是研發管理中應用非常廣泛的項目管理軟件，它涵蓋從項目立項、需求、任務單，到資源投入等研發全要素管理。可視化管理是研發資源管理的重要應用，將采集到的研發要素數據，按項目階段，實時提供任務績效、員工績效等數據的可視化，將會提升項目過程管理效率。為了不改變禪道本身邏輯和不增加報表系統運維負擔，通過分析設計，在禪道數據庫上，以定義存儲過程的形式，進一步加工禪道項目管理系統的基礎數據。再以接口的方式實現跨系統調用，向管理者展現可視化報表。經自主開發實現，該Web報表系統的多維度靈活組合功能，確實有效提升了研發資源的可視化監測效率。

關鍵詞：禪道；可視化管理；Web報表系統；自主開發

中圖分類號：TP311? ? 文獻標識碼：A? 文章編號：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? ?引? 言

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

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

禪道項目管理流程核心流程[4]，先創建項目，形成需求列表，之后對需求進行分解，創建模塊，創建項目/階段/模塊的任務單，任務單記錄了任務類型，預計工時，工期，指派人員等信息；之后，任務執行人員匯報任務日志。過程中，若發生拆分任務，父項任務單若產生消耗，為保證數據一致性，系統會創建一條同名子任務記錄該消耗；拆分子項后，父項任務單只有拆分子項的功能，其預計工時、消耗、剩余均按子項合計；若指派人員發生了變化，管理上要求創建新的任務，且原任務單按實際消耗調整。

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

禪道項目管理軟件提供的標準度量統計，如組織類統計報表、項目類統計報表，在組織類統計報表，可以查詢員工負載，若要統計近幾天每天的員工負載，就需要查詢多次，反反復復非常浪費時間。統計組織里某個關鍵資源，只能統計總量，要觀察其在不同項目的投入情況，也是無法可視化的。項目類統計報表統計的是項目狀態（進行中、掛起）等，如要統計測試階段的，是無法統計的。度量統計的“雞肋”問題變相地阻礙著禪道項目管理軟件推廣和應用。

為了解決度量統計的“雞肋”問題，考慮到禪道軟件應用的廣泛性，為了不影響禪道本身邏輯，讓報表分析系統作為禪道系統的補充，而使用外掛系統[6]的方式。同時，為了不增加對外掛系統的運維工作量，如權限維護等，在用戶驗證和權限控制上，完全與禪道項目管理系統共用。

通過分析設計，在禪道數據庫上，以定義存儲過程的形式，進一步加工禪道項目管理系統的基礎數據，多項目多階段多模塊等多維度靈活組合，按天、按周和按月不同的粒度分布的視圖或存儲過程數據塊。再以，接口的方式實現跨系統調用，向管理者展現可視化報表。

在驗證查詢結果的過程中發現，禪道項目管理的數據校驗[7]非常弱，比如截止日期早于開始日期的錯誤，系統未基于邏輯校驗和提示。基礎數據的邏輯錯誤勢必影響報表數據分析。因此，在研發資源Web報表系統，針對發現基礎數據邏輯異常設計了若干識別規則，在查詢反饋的同時，將識別的異常清單一并反饋給報表管理者，讓管理者曉得統計結果的同時知曉數據是否存在質量問題，從而反向督促禪道使用人員錄單的正確性。

最終經過自主開發[8]，其成果的試運行驗證，該Web報表系統的多維度靈活組合、一次到位、支持導出等，大大提升了公司研發資源監測效率和準確度。

1? 設計模型

研發資源Web報表系統采用的是MVC [9]架構設計，通過封裝接口調用禪道項目管理業務數據，實現報表用戶與研發資源的交互查詢，系統架構如圖1所示。

圖1? Web報表系統架構

1.1? 安全設計

1）登錄驗證：嫁接禪道PMS的賬號和密碼。

2）訪問權限：嫁接禪道的權限管理，實現對Web報表系統的授權訪問。

研發資源Web報表的賬號密碼和權限，統一由禪道PMS管理員進行維護，不會增加額外的運維風險和負擔。

3）采用CORS控制，CORS是一個W3C標準，全稱是“跨域資源共享”（Cross-Origin Resource Sharing）。它允許瀏覽器向跨域的服務器，發出XMLHttpRequest請求，從而克服了AJAX只能同源使用的限制。

1.2? 流程設計

1）報表用戶登錄研發資源Web系統，驗證賬號密碼和權限。

2）報表用戶進入“研發資源監測”功能頁面，輸入項目、成員、模塊、顯示內容、統計周期、粒度、匯總級別，點擊查詢，展示查詢結果。

3）報表用戶進入“工作量統計-項目版”功能頁面，輸入項目、階段、模塊、成員、統計周期、匯總級別，點擊查詢，展示查詢結果。

4）報表用戶進入“工作量統計-員工版”功能頁面，輸入成員、項目、階段、模塊、統計周期、匯總級別，點擊查詢，展示查詢結果。

5）每次查詢，提示報表查詢人員存在異常邏輯的任務單及清單。

6）導出當前查詢方案和查詢結果，直接形成分析報表，方便匯報工作。

2? 開發實現

2.1? 接口開發

API接口[10]是通過封裝技術，實現對禪道PMS數據的調用。通過深入解析研發資源統計需求，梳理并設定研發資源Web報表系統用到的數據內容。通過解讀禪道PMS數據庫結構，采用數據庫跟蹤技術，并結合前后端互驗等，鎖定統計數據內容對應的PMS數據表。

2.1.1? 基礎接口

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

2.1.2? 單據接口

單據接口，是指查詢接口調用的接口。研發資源投入監測API，輸入查詢參數值，輸出查詢結構，傳遞參數為Project， Member， Module， Satge等，研發資源投入監測API清單如表2所示。

工作量統計API，輸入查詢參數值，輸出查詢結構，傳遞參數為P1，P2，P3等，工作量API清單如表3所示。

表3? 工作量（項目版和員工版）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，屬于系統驗證類。輸入參數，輸出驗證結構等，如表4所示。

表4? 其他API清單

接口名稱 P1 P2 備注

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

工作天數

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

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

2.2? 前端開發

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

前端開發，采用左側導航，右側查詢的布局。在上端設計過濾方案，下放呈現查詢結果，為了更好地分析數據，設計了隱藏過濾方案的功能，可最大化查詢結果的現實尺寸。

在查詢結果，左側三列做了固定處理，表頭做了固定處理，這樣不論是上下滾動條，還是左右滾動條，左側和表頭內容都能鎖定不動，模擬Excel的效果。

2.3? 后端開發

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

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

圖4? 部署配置

3? 結? 論

研發資源Web報表系統，經研發團隊試運行，取得很好的反饋，在研發資源統計上極大的支撐了管理的需要，不論是HR，還是研發領導，都能很好的滿足他們的數據需求。

目前，研發資源Web報表系統是能更好滿足領導或組織層面的使用。實際工作中，尤其是針對員工個人層面的數據查詢，比如僅且只能查詢自己的項目數據。優化建議，增加數據范圍的權限設置。

是否要優化數據范圍的權限設置，要結合研發項目團隊的實際工作氛圍，像禪道PMS是沒有數據范圍權限設置的，完全是基于信任模式進行管理。

本次研究以外掛系統的方式，主要是因為根據管理要求，整個系統工作均是VPN內網使用。如果在互聯網環境中使用Web報表系統，如何保障外掛軟件的安全性，避免信息安全事件的發生，是需要深入設計和考慮的。

參考文獻：

[1] 徐神玲.C公司研發項目管理優化研究 [D].上海：華東師范大學，2022.

[2] 劉宇，吳一坤，房馨.在基于IPD集成產品研發流程的績效研究 [J].價值工程，2023，42（15）：8-11.

[3] 孫黎黎.基于敏捷開發方法的軟件項目過程管理研究與實踐 [D].北京：北京郵電大學，2018.

[4] 高湘飛，趙星漢，高楓，等.軍用軟件測試項目管理系統設計與實現 [J].軟件導刊，2016，15（6）：100-103.

[5] 楊玉龍.企業數據統計報表系統的設計與實現 [D].北京：北京交通大學，2016.

[6] 封正，張昊，蔣少良，等.公安交管外掛軟件安全性檢驗技術研究及思考 [J].中國標準化，2022（1）：210-215.

[7] 姜瑞.基于微服務和規則引擎的數據校驗系統設計與實現 [D].武漢：華中科技大學，2021.

[8] 殷海鵬.Z公司軟件項目管理優化研究 [D].上海：華東師范大學，2022.

[9] 李小燕.基于MVC框架的醫院成本核算系統設計 [J].微型電腦應用，2021，37（10）：141-145.

[10] 張許.前后端分離框架之API接口開發與分析——紅色書籍抽獎系統 [J].網絡安全技術與應用，2021（12）：48-49.

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