權限與角色
核心概念
- 角色:一組權限,例如「建立訂單」「核准退款」。員工能做的事,就是他角色裡勾選的那些。
- 訂單資料範圍:角色的另一個設定,決定看得到「只有自己名下的訂單」還是「全公司訂單」。
- 模組:整個功能是否開通。模組沒開通時,就算角色有權限也用不了。見模組與串接選擇。
後台側欄只顯示這個角色進得去的頁面。API 金鑰與 CLI 也套用同一個角色,詳見 API 串接基礎。
內建角色
系統提供七個內建角色。內建角色不能改名或刪除。業務、線控、會計的權限可以直接調整,見調整內建角色的權限;管理員、會員、嚮導與靠行業務的權限由系統定義。要另開一個角色時,把內建角色複製成自訂角色再改,見複製既有角色。
下表是系統預設。調整過的角色以後台顯示的權限為準。
| 角色 | 典型範圍 | 訂單資料範圍 |
|---|---|---|
| 管理員 | 全部功能,包含員工、角色、公司設定與稽核日誌 | 全公司訂單 |
| 業務 | 自己負責的訂單與客戶、同業、行程內容 | 只看自己的訂單 |
| 線控 | 出團作業:行程與梯次編輯、排班、備辦、裝備、資格審核;K 單與登記收款 | 全公司訂單 |
| 會計 | 財務:收款、請款核簽、退款核准、內外帳、損益、對帳 | 全公司訂單 |
| 會員 | 旅客本人,只看自己的訂單與個人資料 | 只看自己的訂單 |
| 嚮導 | 只能進嚮導 portal,登記自己帶團的成本 | 只看自己的訂單 |
| 靠行業務 | 只能進靠行專用入口(需靠行請款模組);帳號由公司建立、停用與重新啟用 | 只看自己的訂單 |
會員、嚮導與靠行業務不是後台角色,不能進後台,也不會出現在員工清單。靠行業務的登入方式在後台 →「公司設定」→「靠行登入方式」設定,預設只用電子郵件驗證碼。
公司端查看靠行申請要有「查看靠行請款與回覆留言」權限(affiliated_sales.read)。內建只有管理員持有;要讓會計或其他人查看,用自訂角色或調整內建角色授予。持有這個權限的人在後台「財務 › 靠行請款 › 申請案件」只看到靠行業務送出的版本,看不到還沒送出的草稿與撤回後的修改。
核准、退回補件、拒絕與撤銷核准靠行申請,要有「核准·退回補件·拒絕靠行請款」權限(affiliated_sales.approve),而且也要有上面的查看權限。內建同樣只有管理員持有。申請的建立者不能處理自己的申請。
公司在銀行匯款後,到申請明細「登記匯款」:填匯款日期並附匯款證明。這要有「登記靠行請款匯款·撤銷誤登」權限(affiliated_sales.record_payout),也要有查看權限。同一人可以既核准又登記匯款。登記錯了用「撤銷誤登」並填原因,申請回到已核准,原登記與證明保留;這只更正系統紀錄,不會撤回銀行款項,也不會產生會計分錄。
到後台 →「團隊與權限」→「角色與權限」,可以看到每個角色的權限數、成員數,以及「內建角色權限對照」表。
調整內建角色的權限
業務、線控、會計以系統預設為起點,可以加勾或取消權限。例如會計要在「出團準備」登記付款,幫會計加勾「出團準備」的管理權限。
- 到後台 →「團隊與權限」→「角色與權限」,在角色那一列按「調整權限」。
- 重新輸入密碼或驗證碼,確認是你本人。
- 加勾或取消動作。和預設不同的動作標「已加上」或「已拿掉」。
- 按「儲存權限」。持有這個角色的人重新整理頁面後立即生效,不需要等系統更新。
規則:
- 系統更新只更新預設,不覆蓋你的調整。調整過的角色卡標「已改過預設」。
- 要還原時,在同一個對話框按「回到預設」,再按「儲存權限」。
- 管理員、會員、嚮導與靠行業務不能調整。顯示名與訂單資料範圍不能改。
- 角色管理只能給管理員,矩陣不列出這一項。認領一個人、稽核日誌、業績排行這類預設只給管理員的權限,勾選時會顯示提示。
- 每次調整都記在稽核日誌:誰、什麼時候、哪個角色、增加與移除了哪些權限。
- 從內建角色複製時,新角色帶入調整後的權限。
管理員工
在後台 →「團隊與權限」→「員工」邀請員工、變更角色或凍結帳號。改角色會停用他名下的 API 金鑰。步驟見員工帳號。
建立自訂角色
內建角色不符合需求時,例如「資深業務」或「外部機器人」,建立自訂角色。
- 到後台 →「團隊與權限」→「角色與權限」,按「新增角色」。
- 填「角色代碼」:小寫英數與底線,以字母開頭,2 到 32 字。建立後不能修改。
- 填「顯示名」,例如「資深業務」。後台各處都顯示這個名稱。
- 選「訂單資料範圍」,見下一節。
- 勾選這個角色可以做的動作。
- 按「建立角色」。
- 到「員工」頁,把角色指派給成員。
勾選時注意:
- 權限清單由平台定義,每一項都有中文說明。不能自創新權限。
- 有些動作標為高風險,例如動到金額、權限或個資。把游標停在動作上可以看說明。
- 按「全選」時,如果會一併授予高風險動作,系統會先逐條列出,要你確認。不需要的話,取消後改成逐項勾選。
要修改,按角色卡上的「編輯權限」。要刪除,按「刪除」;還有成員使用這個角色時不能刪除,要先改派。
複製既有角色
想要「和線控一樣,再多幾項或少幾項權限」時,複製線控,不要從空白開始勾。
- 到後台 →「團隊與權限」→「角色與權限」,在來源角色那一列按「複製」。
- 填新角色的「角色代碼」與「顯示名」。
- 按「建立角色」。新角色帶入來源目前的全部權限與訂單資料範圍。
- 在新角色那一列按「編輯權限」,加減權限。
- 到「員工」頁,把新角色指派給成員。改動立即生效,不需要等系統更新。
規則:
- 業務、線控、會計與自訂角色可以複製。管理員、會員、嚮導與靠行業務不能複製。
- 新角色帶入來源目前的權限,含內建角色在後台的調整。
- 複製後兩個角色各自獨立。改新角色不影響來源;改來源也不改變已經複製出來的角色。系統更新內建角色時,不會覆蓋新角色。
- 從線控複製的角色,和線控一樣可以被指派為梯次的承辦,也看得到「我負責的團」。從業務複製的角色,和業務一樣可以接單。從會計複製的角色,工作台和會計一樣是財務視角;公司設定開了「會計可開退款單」時,也和會計一樣可以開退款單。退款核准名單照角色判斷,要讓新角色核准退款,到公司設定另外勾選。手動新建的自訂角色沒有這些資格,即使勾了一樣的權限。角色卡上的「源自線控」「源自業務」「源自會計」標出這個關係。
- 複製與之後每一次權限調整都記在稽核日誌:誰、什麼時候、從哪個角色複製、增加與移除了哪些權限。
訂單資料範圍
| 選項 | 看得到 |
|---|---|
| 只看自己名下的訂單 | 只有自己負責的訂單。新建的自訂角色預設是這個。 |
| 全公司訂單 | 所有訂單,也包含旅客完整的身分證與護照號碼。 |
選「全公司訂單」後,這個角色可以對任何一張訂單執行它權限內的動作,例如取消、退款、產生補款連結。只授予真的需要看全部訂單的職務。
範圍外的訂單,對這個角色來說等於不存在:列表不會出現,直接開網址也查無資料。這個範圍由系統依登入者判斷,不能用網址或參數改變。
訂單資料範圍不是公司之間的隔離。每家公司的資料本來就完全分開。
被擋下時怎麼查
| 現象 | 原因與處理 |
|---|---|
| 側欄沒有某個頁面,或頁面顯示「沒有權限」 | 角色沒有對應權限。請管理員調整角色,或換一個角色。 |
| 頁面說模組未開通 | 公司沒有開通該模組。到「公司設定」→「方案模組」確認,再聯絡平台。 |
| 找不到某張訂單 | 角色的訂單資料範圍是「只看自己名下的訂單」,而這張訂單不是他負責的。 |
›權限字串與 API 對應
每個權限寫成 resource.action(資源 + 動作)。API 參考逐端點標了它要求的權限。
| 權限 | 允許的動作 | 範例 |
|---|---|---|
order.read | 讀訂單 | GET /orders |
order.create | 建訂單 | POST /orders |
order.adjust | 掛帳、少收、加收、沖正 | 訂單應收調整 |
trip.manage | 建立、編輯、刪除行程與梯次 | trips |
trip.status | 上下架行程、梯次停售、恢復與取消 | 梯次狀態變更 |
payable.approve | 核准請款 | payment-requests |
refund.approve | 核准退款 | orders 的退款 |
ledger.read | 看內外帳與毛利 | internal-external-ledger |
role.manage | 管理角色與員工 | roles、staff |
audit.read | 檢視稽核日誌 | audit |
讀與寫分開授權。例如線控預設有 order.read、order.create、order.update、order.adjust;會計預設只有 order.read。租戶開啟「少收必須經核准」時,非管理員的 order.adjust 只能加收,也只能沖正自己開的加收列,見訂單與金流模型。內建角色的預設中,只有管理員有 role.manage 與 audit.read。role.manage 不能給管理員以外的角色。
檢查順序:伺服器先檢查來源與認證,再檢查權限,最後檢查模組。
- 寫入請求的來源不符:
403 invalid_origin。 - 權限不足:
403 forbidden。同時缺權限與模組時,先回這個。 - 模組未開通:
403 module_disabled。 - 資源在訂單資料範圍外:
404 not_found,不回403,避免透露資料是否存在。
角色與員工 API
- 角色:
GET /roles、GET /roles/catalog、GET /roles/{id}、POST /roles、POST /roles/{id}/copy、PATCH /roles/{id}、DELETE /roles/{id}。訂單資料範圍欄位是orderScope,值為own或all,省略時為own。複製只收新角色的name與label,權限與orderScope照抄來源;回應的baseRole是新角色源自的內建角色。 - 角色路徑的
{id}:GET、PATCH、DELETE /roles/{id}收角色 ID(role_開頭)。內建角色也可以用代碼,例如sales。自訂角色只收 ID。查不到的值回404 not_found。 - 調整內建角色:
PATCH /roles/{id}也收業務、線控、會計,但只能改權限。label要帶目前的顯示名,orderScope省略或帶目前的值,否則回409 conflict。GET /roles/{id}的defaultPermissions是系統預設,把它整組送回就是回到預設。內建角色省略permissions時權限不變;自訂角色省略時照舊清空。權限含role.*時回422 validation。 - 員工:
GET /staff、POST /staff/invite、PATCH /staff/{userId}/role、POST /staff/{userId}/ban、POST /staff/{userId}/unban、DELETE /staff/{userId}。
以上端點都需要 role.manage。