簡介本資源是面向項(xiàng)目管理初學(xué)者與中小型研發(fā)團(tuán)隊(duì)的《禪道使用手冊(cè)完整版》系統(tǒng)覆蓋禪道項(xiàng)目管理工具的核心功能與實(shí)操路徑重點(diǎn)解決項(xiàng)目協(xié)作低效、需求跟蹤混亂、Bug閉環(huán)不及時(shí)等典型痛點(diǎn)。手冊(cè)內(nèi)容結(jié)構(gòu)清晰涵蓋基本介紹含角色權(quán)限、登錄流程、最簡工作流、個(gè)人事務(wù)管理待辦創(chuàng)建與瀏覽、我的任務(wù)/BUG、檔案維護(hù)、產(chǎn)品經(jīng)理專屬模塊產(chǎn)品維護(hù)、需求全生命周期管理、發(fā)布計(jì)劃與統(tǒng)計(jì)報(bào)表以及項(xiàng)目經(jīng)理高頻場(chǎng)景項(xiàng)目組建、任務(wù)分解、燃盡圖應(yīng)用等四大板塊知識(shí)點(diǎn)詳實(shí)且具備強(qiáng)落地性。資源為單文件docx文檔大小4.02MB格式規(guī)范、排版工整便于查閱與打印。目前已有5210人學(xué)習(xí)下載適合剛接觸禪道的新手快速上手也適合作為團(tuán)隊(duì)內(nèi)部培訓(xùn)的標(biāo)準(zhǔn)參考材料。1. 禪道不是“點(diǎn)開就能用”的項(xiàng)目管理軟件它是一套需要配置、校準(zhǔn)和持續(xù)維護(hù)的協(xié)作操作系統(tǒng)很多人第一次打開禪道以為填幾個(gè)需求、建兩個(gè)任務(wù)、拉幾個(gè)人進(jìn)群就叫“上了禪道”。結(jié)果兩周后發(fā)現(xiàn)需求狀態(tài)沒人更新、Bug復(fù)現(xiàn)步驟寫得像小說、測(cè)試報(bào)告里找不到對(duì)應(yīng)版本號(hào)、研發(fā)說“沒收到指派”測(cè)試說“早就提了但沒人理”——這不是禪道不好而是跳過了它最核心的環(huán)節(jié)初始化配置與角色語義對(duì)齊?！抖U道使用手冊(cè)完整版》這個(gè)標(biāo)題里的“完整版”三個(gè)字恰恰暗示它覆蓋的不是界面按鈕怎么點(diǎn)而是從數(shù)據(jù)庫初始化、權(quán)限樹構(gòu)建、工作流建模、字段級(jí)定制到日常巡檢清單的全鏈路落地邏輯。它面向的不是單點(diǎn)操作者而是團(tuán)隊(duì)中那個(gè)要為交付節(jié)奏兜底的人可能是技術(shù)負(fù)責(zé)人、過程改進(jìn)工程師或是被臨時(shí)推上前線的項(xiàng)目協(xié)調(diào)人。如果你正面臨需求漏轉(zhuǎn)、進(jìn)度失真、跨角色扯皮反復(fù)發(fā)生又不想靠人工表格微信群硬扛那這份手冊(cè)真正要解決的是讓禪道從“系統(tǒng)在線”變成“語義在線”——所有人對(duì)“待處理”“已解決”“重新打開”這些狀態(tài)的理解完全一致對(duì)“需求優(yōu)先級(jí)P0/P1”“Bug嚴(yán)重程度致命/嚴(yán)重/一般”的判定有據(jù)可依且能被系統(tǒng)自動(dòng)捕獲、統(tǒng)計(jì)、預(yù)警。這才是“完整版”的真實(shí)分量。2. 從零部署禪道避開官方一鍵包的三大隱性代價(jià)禪道官網(wǎng)提供 Windows/Linux 一鍵安裝包新手常直接雙擊運(yùn)行。但某高校實(shí)驗(yàn)室在部署模擬項(xiàng)目X時(shí)發(fā)現(xiàn)三個(gè)月后無法升級(jí)到新版本自定義字段丟失MySQL字符集報(bào)錯(cuò)頻發(fā)。根本原因在于一鍵包把 Apache、PHP、MySQL 全部打包進(jìn)私有路徑導(dǎo)致后續(xù)所有運(yùn)維動(dòng)作都脫離標(biāo)準(zhǔn) Linux 發(fā)行版管理邏輯。我們改用分離式部署用系統(tǒng)原生包管理器控制基礎(chǔ)組件禪道僅作為 Web 應(yīng)用部署雖多花30分鐘但換來未來三年的可維護(hù)性。2.1 用系統(tǒng)包管理器安裝 LAMP 基礎(chǔ)棧以 Ubuntu 22.04 為例# 安裝系統(tǒng)級(jí)組件非一鍵包私有路徑 sudo apt update sudo apt install -y apache2 mysql-server php php-mysql php-gd php-curl php-xml php-mbstring php-zip # 配置 MySQL 字符集為 utf8mb4關(guān)鍵否則中文搜索、Emoji 會(huì)亂碼 sudo sed -i /\[mysqld\]/a\character-set-server utf8mb4\ncollation-server utf8mb4_unicode_ci /etc/mysql/mysql.conf.d/mysqld.cnf sudo systemctl restart mysql # 創(chuàng)建禪道專用數(shù)據(jù)庫非默認(rèn)的 zentao mysql -u root -p -e CREATE DATABASE zentao_prod CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;提示utf8mb4是必須項(xiàng)。禪道5.0 版本大量使用 JSON 字段存儲(chǔ)動(dòng)態(tài)表單而 MySQL 的utf8實(shí)際只支持3字節(jié) UTF-8 字符不支持 Emoji 和部分生僻漢字強(qiáng)行用utf8會(huì)導(dǎo)致json_encode()失敗、頁面白屏。這是新手部署后第二天就翻車的高頻問題。2.2 手動(dòng)解壓禪道源碼并配置 Apache 虛擬主機(jī)# 下載官方源碼包非一鍵包取最新穩(wěn)定版如 18.6.stable wget https://dl.cnezsoft.com/zentao/18.6.stable/zentao.zip unzip zentao.zip -d /var/www/html/zentao/ # 設(shè)置目錄權(quán)限Apache 用戶 www-data 必須有寫權(quán)限 sudo chown -R www-data:www-data /var/www/html/zentao/ sudo chmod -R 755 /var/www/html/zentao/ # 創(chuàng)建 Apache 虛擬主機(jī)配置避免污染 default site sudo tee /etc/apache2/sites-available/zentao.conf EOF VirtualHost *:80 ServerAdmin webmasterlocalhost DocumentRoot /var/www/html/zentao/www Directory /var/www/html/zentao/www Options FollowSymLinks AllowOverride All Require all granted /Directory ErrorLog ${APACHE_LOG_DIR}/zentao_error.log CustomLog ${APACHE_LOG_DIR}/zentao_access.log combined /VirtualHost EOF sudo a2ensite zentao.conf sudo systemctl reload apache2參數(shù)說明AllowOverride All啟用.htaccess重寫規(guī)則這是禪道 URL 路由如/bug-view-123.html生效的前提DocumentRoot指向www/子目錄而非根目錄因禪道源碼結(jié)構(gòu)中www/才是真正的 Web 入口其他目錄lib/,module/需嚴(yán)格禁止外部訪問。2.3 執(zhí)行首次安裝向?qū)Р⒔米詣?dòng)更新檢查瀏覽器訪問http://your-server-ip/進(jìn)入安裝頁后務(wù)必在最后一步取消勾選“自動(dòng)檢查更新”。原因有三自動(dòng)檢查會(huì)向禪道官方服務(wù)器發(fā)送 IP、版本號(hào)、插件列表等信息不符合內(nèi)部系統(tǒng)安全策略檢查請(qǐng)求超時(shí)尤其在內(nèi)網(wǎng)環(huán)境會(huì)導(dǎo)致安裝卡在“正在配置”界面長達(dá)2分鐘誤判為失敗后續(xù)所有升級(jí)必須走離線包手動(dòng)導(dǎo)入開啟自動(dòng)檢查反而干擾升級(jí)流程。安裝完成后立即修改/var/www/html/zentao/config/config.php將checkVersion true改為false并添加debug false關(guān)閉調(diào)試模式——生產(chǎn)環(huán)境開啟 debug 會(huì)暴露 PHP 錯(cuò)誤堆棧構(gòu)成信息泄露風(fēng)險(xiǎn)。3. 權(quán)限體系不是“給個(gè)角色就行”必須按職能切分三級(jí)權(quán)限組禪道默認(rèn)提供“管理員”“項(xiàng)目經(jīng)理”“開發(fā)”“測(cè)試”等角色但某公司上線初期直接套用結(jié)果出現(xiàn)測(cè)試人員能刪除需求、開發(fā)能修改 Bug 嚴(yán)重等級(jí)、產(chǎn)品經(jīng)理看不到燃盡圖。問題根源在于禪道的權(quán)限模型是對(duì)象級(jí) 行級(jí) 字段級(jí)三重疊加而默認(rèn)角色只是預(yù)設(shè)組合。我們必須基于 RACI 模型Responsible, Accountable, Consulted, Informed重建權(quán)限組。3.1 創(chuàng)建三個(gè)核心權(quán)限組執(zhí)行組、決策組、協(xié)同組組名對(duì)應(yīng)職能關(guān)鍵權(quán)限差異點(diǎn)執(zhí)行組Dev/QA編碼、測(cè)試執(zhí)行只能修改自己創(chuàng)建或被指派的 Bug/任務(wù)不能編輯需求描述、不能關(guān)閉需求Bug 狀態(tài)只能流轉(zhuǎn)為“已解決”“已關(guān)閉”不能跳過“已確認(rèn)”直接“已關(guān)閉”決策組PM/PO需求評(píng)審、排期決策可編輯所有需求字段含優(yōu)先級(jí)、預(yù)計(jì)工時(shí)可強(qiáng)制關(guān)閉任何 Bug可批量修改任務(wù)狀態(tài)但不能刪除任何數(shù)據(jù)防誤操作協(xié)同組Scrum Master/BA過程監(jiān)督、文檔歸檔可查看全部數(shù)據(jù)可導(dǎo)出報(bào)表可修改“備注”“附件”字段但不能修改狀態(tài)、不能指派任務(wù)、不能編輯原始需求內(nèi)容注意禪道不支持“只讀角色”所謂“只讀”必須通過顯式禁用所有寫權(quán)限實(shí)現(xiàn)。例如給協(xié)同組分配權(quán)限時(shí)在后臺(tái) → 后臺(tái) → 權(quán)限 → 編輯組 → “產(chǎn)品”模塊下取消勾選全部操作項(xiàng)創(chuàng)建、編輯、刪除、導(dǎo)出僅保留“查看”。3.2 用 SQL 批量修正歷史用戶權(quán)限歸屬安裝后默認(rèn)所有用戶屬于“admin”組需批量遷移。以下 SQL 將郵箱域名匹配dev.example.com的用戶移入執(zhí)行組ID5pm.example.com的移入決策組ID3-- 先確認(rèn)目標(biāo)組ID在后臺(tái) → 后臺(tái) → 用戶 → 組 中查看URL參數(shù)gid -- 假設(shè)執(zhí)行組gid5決策組gid3 UPDATE zt_user SET role dev, groups 5 WHERE email LIKE %dev.example.com; UPDATE zt_user SET role pm, groups 3 WHERE email LIKE %pm.example.com; -- 強(qiáng)制清除緩存禪道權(quán)限緩存時(shí)間為1小時(shí)需手動(dòng)刷新 sudo rm -f /var/www/html/zentao/tmp/cache/*血淚經(jīng)驗(yàn)不要依賴后臺(tái)界面逐個(gè)修改用戶組某項(xiàng)目有200用戶界面操作耗時(shí)4小時(shí)且中途斷連會(huì)丟失進(jìn)度。SQL 直接操作數(shù)據(jù)庫表zt_user.groups字段存逗號(hào)分隔的組ID字符串是唯一可靠方案。操作前務(wù)必備份zt_user表mysqldump -u root -p zentao_prod zt_user zt_user_backup.sql3.3 字段級(jí)權(quán)限隱藏敏感字段暴露關(guān)鍵字段默認(rèn)情況下所有用戶都能看到 Bug 的“重現(xiàn)步驟”“環(huán)境信息”字段但實(shí)際工作中這兩項(xiàng)常包含內(nèi)網(wǎng)IP、服務(wù)器路徑等敏感信息。我們通過后臺(tái) → 后臺(tái) → 自定義 → 字段 → 編輯“Bug”模塊將steps重現(xiàn)步驟和env環(huán)境字段的“可見范圍”設(shè)為“僅指派人、處理人、抄送人”而將mailto郵件通知字段設(shè)為“所有人可見”——確保問題升級(jí)路徑透明。4. 避坑禪道部署與權(quán)限配置的5個(gè)高發(fā)故障點(diǎn)4.1 現(xiàn)象安裝完成后訪問首頁顯示“500 Internal Server Error”錯(cuò)誤日志中出現(xiàn)PHP Fatal error: Uncaught Error: Call to undefined function mb_strlen()原因Ubuntu 22.04 默認(rèn)安裝的 PHP 8.1 不再內(nèi)置mbstring擴(kuò)展而禪道核心類庫大量依賴該擴(kuò)展進(jìn)行中文字符串截取。解決sudo apt install php-mbstring sudo systemctl restart apache24.2 現(xiàn)象創(chuàng)建需求后狀態(tài)始終卡在“草稿”無法流轉(zhuǎn)為“已確認(rèn)”點(diǎn)擊狀態(tài)下拉框無反應(yīng)原因Apache 的mod_rewrite模塊未啟用導(dǎo)致禪道前端路由如/product-create.html無法解析為真實(shí) PHP 文件路徑。解決sudo a2enmod rewrite sudo systemctl restart apache2并確認(rèn)虛擬主機(jī)配置中AllowOverride All已生效。4.3 現(xiàn)象測(cè)試人員提交 Bug 后研發(fā)人員收不到郵件通知但系統(tǒng)日志顯示“郵件發(fā)送成功”原因禪道郵件配置中的 SMTP 密碼含特殊字符如、/未進(jìn)行 URL 編碼導(dǎo)致 PHPparse_url()解析失敗實(shí)際連接的是錯(cuò)誤的 SMTP 服務(wù)器。解決將密碼中的替換為%40/替換為%2F再填入后臺(tái) → 后臺(tái) → 郵件 → SMTP 密碼框。4.4 現(xiàn)象權(quán)限組配置后用戶仍能編輯已被鎖定的需求或刪除他人創(chuàng)建的 Bug原因禪道的“刪除”權(quán)限控制粒度極細(xì)——“刪除需求”和“刪除需求下的用例”是兩個(gè)獨(dú)立權(quán)限項(xiàng)后臺(tái)界面默認(rèn)只勾選前者。解決進(jìn)入權(quán)限組編輯頁 → 展開“產(chǎn)品”模塊 → 找到“需求”子項(xiàng) →同時(shí)勾選“刪除”和“刪除用例”同理“Bug”模塊下需同時(shí)勾選“刪除”和“刪除評(píng)論”。4.5 現(xiàn)象升級(jí)禪道到新版后所有自定義字段消失原有數(shù)據(jù)無法顯示原因升級(jí)包未包含custom/目錄該目錄存放所有字段定制配置而官方升級(jí)腳本默認(rèn)只覆蓋www/、lib/等核心目錄。解決升級(jí)前備份/var/www/html/zentao/custom/整個(gè)目錄升級(jí)后將備份的custom/目錄完整覆蓋回原位置并執(zhí)行sudo chown -R www-data:www-data /var/www/html/zentao/custom/5. 讓禪道真正驅(qū)動(dòng)協(xié)作用“三張表”固化團(tuán)隊(duì)協(xié)作契約部署和權(quán)限只是起點(diǎn)禪道能否發(fā)揮價(jià)值取決于是否把團(tuán)隊(duì)約定的協(xié)作規(guī)則翻譯成系統(tǒng)可執(zhí)行、可審計(jì)、可追溯的配置。我們不用寫SOP文檔而是用禪道內(nèi)置的三張表把模糊的“應(yīng)該怎么做”變成明確的“系統(tǒng)不允許那樣做”。5.1 第一張表需求狀態(tài)機(jī)State Machine——定義“什么條件下才能變更狀態(tài)”默認(rèn)禪道需求狀態(tài)只有“草稿→已確認(rèn)→已計(jì)劃→進(jìn)行中→已驗(yàn)收→已關(guān)閉”但某跨平臺(tái)系統(tǒng)要求“已確認(rèn)”需求必須關(guān)聯(lián)至少1個(gè)測(cè)試用例才能進(jìn)入“已計(jì)劃”“進(jìn)行中”需求若超過3天未更新進(jìn)展自動(dòng)觸發(fā)郵件提醒負(fù)責(zé)人“已驗(yàn)收”狀態(tài)只能由測(cè)試組長非普通測(cè)試設(shè)置。這些規(guī)則無法靠人工監(jiān)督必須通過自定義工作流實(shí)現(xiàn)后臺(tái) → 后臺(tái) → 自定義 → 工作流 → 新建工作流 → 選擇“需求”模塊 → 在“已確認(rèn)”節(jié)點(diǎn)下添加條件“關(guān)聯(lián)用例數(shù) ≥ 1”在“進(jìn)行中”節(jié)點(diǎn)下添加定時(shí)規(guī)則“停留時(shí)間 3天” → 動(dòng)作“發(fā)送郵件至指派人”。5.2 第二張表Bug 嚴(yán)重等級(jí)與響應(yīng)時(shí)效對(duì)照表SLA Table——把“盡快修復(fù)”變成可度量指標(biāo)禪道 Bug 嚴(yán)重等級(jí)致命/嚴(yán)重/一般/建議本身無業(yè)務(wù)含義必須綁定響應(yīng)時(shí)效嚴(yán)重等級(jí)響應(yīng)時(shí)效解決時(shí)效自動(dòng)升級(jí)規(guī)則致命≤15分鐘≤2小時(shí)超時(shí)自動(dòng)抄送CTO郵箱嚴(yán)重≤2小時(shí)≤1工作日超時(shí)自動(dòng)創(chuàng)建阻塞任務(wù)一般≤1工作日≤3工作日超時(shí)自動(dòng)標(biāo)記為“延期”建議≤3工作日≤1周無自動(dòng)動(dòng)作此表通過自定義字段定時(shí)任務(wù)落地新增字段“SLA起始時(shí)間”日期時(shí)間型當(dāng) Bug 狀態(tài)變?yōu)椤耙汛_認(rèn)”時(shí)用禪道API或數(shù)據(jù)庫觸發(fā)器自動(dòng)寫入當(dāng)前時(shí)間再用 Linux cron 每5分鐘執(zhí)行腳本比對(duì)now() - SLA起始時(shí)間與上表閾值觸發(fā)郵件或狀態(tài)變更。5.3 第三張表每日站會(huì)檢查清單Daily Standup Checklist——用禪道任務(wù)反向驅(qū)動(dòng)會(huì)議質(zhì)量很多團(tuán)隊(duì)站會(huì)變成“報(bào)流水賬”我們把它改造為“問題攔截器”每天早10點(diǎn)禪道自動(dòng)創(chuàng)建一個(gè)名為“【站會(huì)】YYYY-MM-DD”的任務(wù)指派給全體成員截止時(shí)間設(shè)為10:15。該任務(wù)描述中嵌入結(jié)構(gòu)化清單? 昨日承諾完成事項(xiàng)鏈接至對(duì)應(yīng)任務(wù)/Bug?? 今日最大阻塞點(diǎn)必須選擇“阻塞類型”環(huán)境/依賴/設(shè)計(jì)/其他 需要跨角色同步的關(guān)鍵信息自動(dòng)相關(guān)角色成員必須填寫完畢才能標(biāo)記為“已完成”否則任務(wù)始終顯示為紅色。連續(xù)3次未完成系統(tǒng)自動(dòng)推送至部門周報(bào)。這倒逼每個(gè)人提前整理信息也讓阻塞點(diǎn)在發(fā)生當(dāng)天就被暴露。我?guī)н^的每個(gè)團(tuán)隊(duì)上線禪道后第1個(gè)月都在調(diào)這張表——不是調(diào)功能是調(diào)人。當(dāng)“已確認(rèn)”需求必須關(guān)聯(lián)用例才允許排期當(dāng)“致命Bug”超15分鐘未響應(yīng)就抄送高管當(dāng)站會(huì)任務(wù)不填完就影響個(gè)人KPI系統(tǒng)就不再是工具而成了團(tuán)隊(duì)共同遵守的契約。這種契約感不會(huì)來自一份PDF手冊(cè)只會(huì)來自你親手配置的每一個(gè)字段、每一條規(guī)則、每一次對(duì)超時(shí)的干預(yù)。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取