使用手冊

立方設計工程專案管理系統

本系統提供室內設計與裝修工程公司從建案、派案、進度追蹤、里程碑管理、合約與請款、ISO 收發文、文件版本控管到跨案統計報表的完整流程管理。不同角色依職責看到對應的模組與資料範圍，所有異動皆有稽核紀錄可查。這份手冊不論是否登入都可以查閱；若你已經有帳號，可以直接登入開始使用。

登入查看角色權限

角色與權限

系統共有 5 種角色，帳號一律由系統管理員建立。每個角色看到的選單與資料範圍都不同——即使繞過畫面直接呼叫 API，資料庫的權限規則（RLS）仍然會擋下超出範圍的存取，所以下表列出的是「實際能用」的範圍，不只是選單看不看得到而已。

設計師

designer

負責被指派案件的實際執行——回報進度、標註卡關、上傳附件。只看得到跟自己有關的案件與資料。

模組	可視/可操作範圍
案件管理	只看得到自己是主責人員或協同人員的案件；可回報進度、標註卡關、上傳附件
派案中心	不可見
財務概況	不可見
ISO 文管	不可見
統計報表	WIP/逾期監控看板、人員工作負荷 Dashboard 可查看；財務期款追蹤表、全域稽核軌跡不可見
使用者管理	不可見

工務主管 / 專案主管

project_manager

掌管派案、進度追蹤與跨部門協調，看得到全部案件，對財務與文管資料有唯讀權限以掌握案件全貌。

模組	可視/可操作範圍
案件管理	完整讀寫，看得到全部案件；可新增案件、派案、調整里程碑。純工程案／設計+工程統包案可指派 PM 為主責或協同人員，被指派時比照設計師可回報進度、標註卡關、上傳附件
派案中心	完整讀寫；待派清單、KPI 卡片、設計師負載一覽
財務概況	唯讀（合約、期款、請款收款狀態）
ISO 文管	唯讀（收發文登記、文件版本庫）
統計報表	全部子頁皆可見，含財務期款追蹤表與全域稽核軌跡查詢
使用者管理	不可見

財務

finance

負責合約、期款拆分、追加減與請款收款登打，對案件基本資訊有唯讀存取以利選擇案件。

模組	可視/可操作範圍
案件管理	不可見（僅財務相關表單內可查詢案件供選擇）
派案中心	不可見
財務概況	完整讀寫（合約、期款、追加減、請款收款）
ISO 文管	不可見
統計報表	WIP/逾期監控看板、人員工作負荷、財務期款與現金流追蹤表可查看；全域稽核軌跡不可見
使用者管理	不可見

文管

doc_control

負責 ISO 收發文登記與文件版本庫管理，是唯一能查看文件調閱紀錄的角色（連同 admin）。

模組	可視/可操作範圍
案件管理	不可見（僅登記表單內可查詢案件供選擇）
派案中心	不可見
財務概況	不可見
ISO 文管	完整讀寫（收發文登記、文件上傳/升版、調閱紀錄查詢）
統計報表	WIP/逾期監控看板、人員工作負荷可查看；財務追蹤表、全域稽核軌跡不可見
使用者管理	不可見

系統管理員

admin

所有模組完整讀寫權限，是唯一能查看全域稽核軌跡查詢頁面的兩個角色之一（另一個是 PM）。

模組	可視/可操作範圍
案件管理	完整讀寫，看得到全部案件
派案中心	完整讀寫
財務概況	完整讀寫
ISO 文管	完整讀寫，含文件調閱紀錄查詢
統計報表	全部子頁皆可見，含財務期款追蹤表與全域稽核軌跡查詢
使用者管理	完整讀寫，僅此角色可見；可新增使用者、指派角色、停用/啟用帳號、重設密碼

使用情境範例

幾個常見的「我想做什麼」對應到系統裡的實際操作步驟，快速上手可以先對照下面的情境。

我想把一個新案件派給設計師

「案件管理」點「+ 新增案件」，填寫客戶、案件類型、案件模式等基本資料，狀態會落在「草稿」或「待派」。
到「派案中心」的「待派案件清單」找到該案件，點「派案」。
選擇主責人員、優先級、里程碑範本後送出——系統會自動依範本產生對應的里程碑清單，案件狀態變成「已派案」。

設計師

我要回報案件進度，或案件卡關了要通報

「案件管理」找到自己負責的案件，進入詳情頁。
「回報進度」填寫目前階段與說明送出——第一次回報會讓案件自動從「已派案」轉為「進行中」；進度百分比由系統依已完成里程碑自動算出，不用自己填。
如果卡關了，用「標註卡關」填寫卡關類型與原因，不需要等到下一次進度回報，隨時可以標註或解除。

財務

我要幫案件建立合約，並登記請款收款

「財務概況」點「新增合約」，選擇案件、輸入未稅金額（系統自動算稅額與含稅總額）。
「期款設定」拆分分期比例（例如簽約金 50% / 完工款 50%），百分比加總必須等於 100 才能儲存。
某一期要請款時，「新增請款紀錄」登打金額與日期；款項入帳後把狀態改成「已全額收款」並填實際收款日期/金額。

PM / admin

我想知道目前有哪些案件逾期或卡關中

「統計報表」進入「WIP & 逾期監控看板」。
「已逾期」卡片是任一里程碑最新完成日期已過且未完成的案件；「卡關中」卡片是目前有標註卡關的案件——同一案件可能同時出現在兩張卡片。
點卡片直接看到對應的案件清單，不用自己一筆一筆篩選。

文管

我要幫文件上傳新版本，並查看誰下載過

「ISO 文管」的「文件版本庫」找到該份文件，點「上傳文件」選擇「對既有文件上傳新版本」。
系統會自動遞增版號（例如 v1.0 → v1.1）並把前一版標記為非目前版本，舊版本仍然可以個別下載。
展開「查看調閱紀錄」可以看到這份文件（含全部歷史版本）被誰在何時瀏覽或下載過。

admin

我想稽核某個案件所有欄位被誰改過、改了什麼

「統計報表」進入「全域稽核軌跡查詢」（僅 admin/PM 可見）。
依案件、資料表（案件/里程碑/合約/請款）、操作人員或時間區間篩選。
同一次操作異動的多個欄位會合併成一筆時間軸項目，看得到修改前後的值與異動原因。

功能導覽

依六大模組整理主要操作步驟，實際看到的功能仍以登入後的角色權限為準。

案件管理

案件從建立到結案的完整生命週期都在這裡管理，支援進階篩選與 Excel 匯出。

「+ 新增案件」建立新案件（草稿或待派狀態），填寫客戶、案件類型、案件模式（純設計/純工程/設計+工程統包）等基本資料。
案件清單可依狀態、案件類型、案件模式、主責人員、日期區間（建立日期／預計交付日期／任一里程碑最新完成日期）與關鍵字組合篩選。
點「匯出 Excel」把目前篩選結果匯出成 .xlsx，匯出內容與畫面上看到的篩選結果保證一致。
進入單一案件可以派案、調整里程碑日期、標註/解除卡關、回報進度、上傳附件、管理協同人員，並在頁面下方看到該案件的完整稽核時間軸。
設計師只看得到自己是主責人員或協同人員的案件；PM/admin 看得到全部案件。

派案中心

PM/admin 專用，用來把「待派」案件指派給設計師，並掌握團隊產能。

頂部 4 張 KPI 卡片：待指派案件數、進行中案件數、設計師平均負載、本週到期里程碑數，點卡片可直接跳轉到對應的篩選清單。
「設計師目前負載」區塊列出每位設計師的負載等級（空閒/適中/偏忙/過載，依已派案+進行中案件數合計判斷）與案件數明細。
「待派案件清單」逐筆點「派案」，選擇主責人員、優先級與里程碑範本後送出，系統會自動依範本產生對應的里程碑清單。

財務概況

finance/admin 完整讀寫，PM 唯讀，管理合約、期款拆分與請款收款進度。

「新增合約」建立合約（一案一約），輸入未稅金額，系統自動算稅額與含稅總額（稅率固定 5%）。
「期款設定」拆分合約的分期比例（例如簽約金 50% / 完工款 50%），系統會檢查百分比加總必須等於 100 才能儲存。
有需要追加減金額時，用「新增追加減」登記異動項目與原因（只新增不編輯，本身就是完整紀錄）。
某一期期款要請款時，用「新增請款紀錄」登打請款金額與日期；款項入帳後把狀態更新為「已全額收款」並填實際收款日期/金額（若逾期未收則標記「逾期未付」）。
「/reports/finance 財務期款與現金流追蹤表」提供跨案件的已請款/已收款/未收款金額彙總與依收款狀態篩選。

ISO 文管

doc_control/admin 完整讀寫，PM 唯讀，管理正式收發文登記與文件版本庫。

「+ 新增收發文」登記外部來文/發文，填寫案由、對口單位、緊急程度、機密等級，`iso_doc_no` 由系統自動編號，不可手動指定。
「文件版本庫」上傳文件時可選擇「新文件」或「對既有文件上傳新版本」，同一份文件的新版本會自動遞增版號（例如 v1.0 → v1.1），並把前一版標記為非目前版本。
展開「查看版本紀錄」可看到完整歷史版本並個別下載；機密等級會實際限制哪些角色可以下載，不只是畫面上的標籤。
展開「查看調閱紀錄」（僅 doc_control/admin 可見）可查看誰在何時瀏覽或下載過這份文件的任一版本。

統計報表

跨案件的彙總視角，子頁依角色開放範圍不同（詳見「角色與權限」章節）。

「WIP & 逾期監控看板」：在建工程 (WIP)／即將到期／已逾期／卡關中四張分類卡片，即將到期以「最新完成日期在未來 7 天內且尚未實際完成」判斷，一個案件可能同時符合多個分類，點卡片可查看對應案件清單。
「人員工作負荷與產能統計」：每位設計師的負載、各狀態案件分佈與近 30 天完成案件數，跟派案中心的負載數字共用同一份資料，不會兜不起來。
「財務期款與現金流追蹤表」：依案件或收款狀態篩選，逐筆合約列出合約總額、已請款/已收款/未收款金額與預期入帳時程。
「全域稽核軌跡查詢」（僅 admin/PM）：跨案件查詢案件/里程碑/合約/請款欄位層級的異動紀錄，同一次操作的多欄位變更會合併成一筆時間軸項目，可依資料表、案件、操作人員、時間區間篩選。

使用者管理

僅 admin 可見，管理帳號、角色與啟用狀態，帳號一律由此建立，不開放自助註冊。

「+ 新增使用者」建立帳號，填寫 Email、初始密碼（至少 8 碼）、姓名、員編、部門/職稱與角色。
使用者清單可依角色、啟用狀態與關鍵字（姓名/員編/Email）篩選。
點「編輯」可修改姓名/員編/部門/職稱、指派角色、停用/啟用帳號，或重設密碼——但不能修改 Email，也不能透過這個頁面調整自己的角色或啟用狀態（要避免自己誤操作把自己鎖死，需請其他管理員協助）。
帳號只能停用不能刪除，是刻意的設計決策，確保歷史紀錄（稽核軌跡、案件指派）不會因為使用者被刪除而失去對應。

名詞解釋

系統畫面上出現的狀態與判斷邏輯說明，跟程式碼裡的定義保持一致。

案件狀態

草稿: 初步洽談中，案件類型/模式等資訊可能還不完整。
待派: 案件基本資料已確認，等待 PM 指派主責人員。
已派案: 已指派設計師與里程碑範本，尚未開始第一次進度回報。
進行中: 設計師送出第一次進度回報後，系統自動從「已派案」轉入此狀態。
已完成: 案件全部工作完工驗收。
取消: 案件中止，不再繼續執行。

里程碑階段

設計段: 現場丈量、概念提案、平面配置、3D 渲染、施工圖交付。
工程段: 室裝審查許可、開工進場、水電泥作、木作油漆、完工驗收。

其他名詞

最新完成日期: 每個里程碑除了原始的「計畫日期」外，PM 可依實際狀況調整「最新完成日期」——系統的逾期/即將到期判斷都是看這個欄位，不是看原始計畫日期。
逾期: 任一里程碑的最新完成日期已過，且尚未填寫實際完成日期。
即將到期: 任一里程碑的最新完成日期落在未來 7 天內，且尚未填寫實際完成日期。
卡關: 案件層級的獨立狀態（不是里程碑欄位），設計師可隨時標註卡關原因，不需要等到下一次進度回報。
案件進度百分比: 由已完成里程碑的權重（同案件全部里程碑權重加總固定為 100）自動加總算出，不是人工填寫的數字。
設計師負載等級: 依該設計師目前「已派案 + 進行中」案件數合計自動判斷：0 件是空閒、1~2 件是適中、3 件是偏忙、4 件以上是過載。派案中心的負載面板、指派主責人員時的負載參考、統計報表的人員工作負荷 Dashboard 都是同一套計算，數字不會兜不起來。目前只涵蓋設計師角色，純工程案如果主責是 PM，案件量不會反映在這個等級判斷裡。
稽核軌跡: 案件、里程碑、合約、請款紀錄的欄位異動都會自動記錄新舊值，同一次操作的多欄位變更會合併成一筆時間軸項目顯示。
調閱紀錄: 文件版本庫裡每次瀏覽/下載文件的紀錄，僅 doc_control/admin 可查看，涵蓋該文件的所有歷史版本。

英文縮寫

WIP: Work In Progress，直譯「在建工程／進行中的工作」。系統用來統稱目前尚未完工、正在執行中的案件，「WIP & 逾期監控看板」的 WIP 卡片就是列出這些案件。
KPI: Key Performance Indicator，中文常譯「關鍵績效指標」。派案中心、案件管理等頁面上方那幾張數字卡片（例如待指派案件數、本月新專案）就是 KPI 卡片，用來快速掌握整體概況的幾個關鍵數字。
PM: Project Manager，中文「專案經理」，系統裡對應「工務主管 / 專案主管」這個角色，手冊與畫面上常直接簡稱 PM。
RLS: Row-Level Security，中文「資料列層級安全性」，是資料庫（PostgreSQL / Supabase）內建的權限機制，用來限制每個使用者能讀寫哪些資料列——就算有人繞過畫面直接呼叫 API，這層規則仍然會擋下不該存取的資料。
ISO: International Organization for Standardization，中文「國際標準化組織」。「ISO 文管」模組指的是比照 ISO 品質管理系統慣例的正式收發文登記與文件版本控管流程，不是系統本身申請了 ISO 認證。
API: Application Programming Interface，中文「應用程式介面」，泛指程式之間互相溝通資料的介面/管道，畫面上的操作背後都是透過呼叫 API 存取資料庫。

常見問題

我沒有帳號，可以自己註冊嗎？

不行。帳號一律由系統管理員建立，請聯絡貴公司的系統管理員取得帳號。

忘記密碼或帳號被停用怎麼辦？

請聯絡系統管理員協助重設密碼或確認帳號啟用狀態。

為什麼有些選單/頁面我看不到？

系統依角色分配不同的模組與資料存取範圍，詳見上方「角色與權限」章節。如果你認為自己應該有更多權限，請洽系統管理員確認角色設定。