CoLinkery 後台管理系統 — 使用指南

本指南按五種身份逐步說明：由登入、申請機構帳戶、到日常管理（會員／發卡／福利／活動／帳單）。左側選單可直接跳去你需要的章節。

ℹ️ 關於截圖：本指南全部畫面截自本機示範環境（機構「示範協會」、示範帳號、假會員資料），唔包含任何真實用戶資料；畫面內容會隨版本更新而略有不同。

① 五種身份與入口

CoLinkery 只有一套登入（電話／電郵／編號＋ PIN）；登入後按你的身份帶你去相應的管理位置。

身份	你會用到	入口
個人用戶	名片管理、交換名片、人脈、我的會籍卡、福利	登入應用
公司（管理員）	員工卡、欄位、團隊、帳單	登入機構後台
協會（管理員）	會員名冊、會費、活動、發卡	登入機構後台
會籍擁有者	建立會籍、招會員、靠會員兌換福利賺佣金	登入機構後台
CoLinkery 平台管理員	全平台審批、機構、收費、審計、資料庫	登入平台後台

⚠️ 機構帳戶會獲派一個登入編號：公司 CLK-B######、協會 CLK-A######、會籍 CLK-M######。用「編號＋持有人 PIN」即可登入（見 ④）。

② 如何登入

去 colinkery.app/login（或由官網 colinkery.com/login 選擇你的身份）。
輸入電話號碼（8 位）、電郵、CLK-XXXXXXXX（個人身份號）或機構編號（CLK-B／A／M…）。
輸入 PIN，按「登入」。

登入後會前往哪裡？

系統會自動帶你去原本想開的頁面（例如你打 /manage/hksca 未登入 → 會帶你去機構後台登入，登入後返回該頁）。
機構管理員：登入後去 機構後台（新網址 business.colinkery.app；左側欄 22 節）。
平台管理員：登入後去 平台後台（business.colinkery.app/admin；左側欄 13 節）。

未驗證的電話／電郵

為安全起見，未驗證的憑證只可以在原本裝置登入。要換裝置：去「設定 → 登入方式」加一個電郵並完成驗證（即時可用），之後任何裝置都可以登入。

CoLinkery 登入頁（手機畫面） — 實際截圖登入頁（手機）：輸入電話／電郵／`CLK-` 編號＋ PIN；底部顯示身份去向提示

③ 個人用戶（名片／人脈）

功能	位置	做什麼
我的名片	/cards	新增／編輯名片、正面背面、人像、卡種
交換名片	/exchange	一對一（先展示 QR／連結）／一對多／多對多（活動房間）／掃描二維碼
名片夾	/contacts	查看已交換的聯絡人、標籤、星標、備註；未連結卡可「邀請」
我的會籍卡	我的卡 → 會籍卡	查看機構發的會籍卡（可翻面出示 QR）
福利	/benefits	查看你的會籍福利、領取（長按卡面）／核銷碼
會籍市場	/clubs	搜尋公開會籍、進入迷你網站
設定	/settings	登入方式、字級、外觀、通知、訊息靜音、機構後台入口（連去 console）

名片

交換

福利

會籍

我的

示意圖（非截圖）手機 App 底欄 5 個入口：名片｜交換｜福利｜會籍｜我的

④ 申請帳戶（機構／會籍擁有者）

先以個人身份登入（電話／電郵＋ PIN）。
去 /orgs（我的組織）→ 輸入機構名稱。
選擇帳戶類型：
- 公司 → 獲派 CLK-B######
- 協會 → 獲派 CLK-A######
- 會籍擁有者 → 獲派 CLK-M######
按「建立」→ 畫面即刻顯示你的登入編號（請記錄；清單亦會顯示）。
之後用「編號＋你的 PIN」即可登入，並直接進入機構後台（business.colinkery.app）。

申請時你要同意

《服務條款》—— 帳戶責任、禁止用途、費用與佣金、終止條款
《私隱政策》＋《資料處理附錄》—— 你（機構）為資料使用者、CoLinkery 為處理者
聲明你有權代表該公司／協會

合約草稿：.coappery/specs/ORG-TERMS-PRIVACY-DRAFT.md（⏳ 法務審批中，未正式上線）

⚠️ 要收會費或發官方會籍卡，需先完成 KYC（公司登記／BR 或已認證）。社團層可以免費入會。

⑤ 機構後台總覽

入口：/business → 選擇你的機構 → /manage/<機構>。左側欄共 6 組、22 節（下表由 SideNav.tsx 自動生成）：

組	節
manage.grp.start	manage.nav_dashboard｜manage.nav_setup
manage.grp.org	manage.nav_brand｜manage.nav_notify｜manage.nav_push｜manage.nav_posts｜manage.nav_events｜manage.nav_ads｜manage.nav_fields
manage.grp.people	manage.nav_club｜manage.nav_members｜manage.nav_team
manage.grp.cards	manage.nav_grants｜manage.nav_badges｜manage.nav_benefits｜manage.nav_pool
manage.grp.assistant	manage.nav_letters｜manage.nav_letter_sends
manage.grp.compliance	manage.nav_kyc｜manage.nav_billing｜manage.nav_agents｜manage.nav_audit

各節畫面（實際截圖·自動生成）

實際截圖**manage.nav_dashboard**：機構後台「概覽」：左側欄分 6 組；右邊係開台進度清單

實際截圖**manage.nav_setup**：開台助手：輸入一段描述 → 生成品牌／欄位／卡面

實際截圖manage.nav_brand：機構標誌、主色／副色、字體 → 影響卡面與迷你網站

實際截圖**manage.nav_notify**：選擇要接收的事件（通知只在本平台內）

實際截圖**manage.nav_push**：選擇對象 → 填寫內容 → 發送（App 內＋推播）

實際截圖**manage.nav_posts**：發佈機構公告；會員在前台「機構消息」看到；草稿會員看不到

實際截圖**manage.nav_events**：開新活動：時間、地點、人數上限、報名費（HK$）、FPS 轉帳資料

實際截圖**manage.nav_ads**：新上市頻道曝光；需公司帳戶＋商業登記驗證；每類別名額先到先得

實際截圖**manage.nav_fields**：勾選機構需要的欄位（依分類）；亦可自建；停用後已收集的值仍保留

實際截圖**manage.nav_club**：會籍檔案：層級、會籍網址、1:1 封面（1080×1080、≤10MB）、類別（市場搜尋，最多 3）

實際截圖**manage.nav_members**：篩選全部／在籍／已離開；加入會員、設會費、匯出

實際截圖**manage.nav_team**：為成員分配角色；權限一律由 API 檢查；持有人不可更改

實際截圖**manage.nav_grants**：卡片設計工房、單張發卡、批量發卡

實際截圖**manage.nav_badges**：兩類：驗證徽章（通過認證自動出現）＋可指派徽章（平台預設 10 款）

實際截圖**manage.nav_benefits**：建立只發給會員的免費福利（會員長按卡面領取、翻面核銷）

實際截圖**manage.nav_pool**：中央福利池：付費上架（定價由平台設定）

實際截圖**manage.nav_letters**：餵入過去幾年的參考信 → 作為 AI 草擬的參考

實際截圖**manage.nav_letter_sends**：群組（由會員欄位篩出）→ 撰寫 → 寄出（含 AI 草擬）

實際截圖**manage.nav_kyc**：提交機構證明後才可收會費／發官方會籍卡

實際截圖**manage.nav_billing**：機構訂單（例如中央福利池上架費、會籍成效費）

實際截圖**manage.nav_agents**：機構買 agent 位派給會員（例：記帳助手 $88／位、信件助手 $58／位）；派位即機構代付

實際截圖**manage.nav_audit**：最近的機構操作紀錄（發卡／停發…），可驗完整性

⑥ 會員／團隊

加會員

去「👥 會員」→ 輸入對方 CoLinkery ID（CLK-…） 或 8 位電話。
可同時設定會費有效至（授權依據：有效期內可收卡／用福利）。
會員亦可自助用 /o/<機構>/join 加入 → 你審批。

團隊與角色

去「🧑‍💼 團隊」建立角色（例如：櫃檯、會籍主任、財務），逐一勾選 capabilities（發卡／會員／福利／活動／帳單…）。職員用自己的帳號登入即可。

⚠️ 機構登入編號只對應持有人；其他職員請用自己的電話／電郵登入。

⑦ 發卡（單張／批量）

方式	位置	做法
單張發卡	🎫 發卡	輸入會員 `CLK-…`／電話 → 選卡種（名片／會籍）→ 發
批量發卡	🎫 發卡 → 批量	上載 CSV（欄名含 `clk_id` 或 `phone`，另可加 `member_no`／`kind`／`valid_until`／`name`）→ 預覽 → 確認
卡片設計	🎫 發卡 → 卡片設計工房	選擇模板 → 放欄位／人像／QR → 匯出 PNG／PDF（可批量）
停卡／重發	🎫 發卡	停卡係軟停用（紀錄保留、可復原）

會籍卡 QR 預設指向 https://colinkery.app/id/<會員編號>；已印舊卡用 colinkery.com/id/… 亦會自動轉去新網址（301）。

⑧ 福利與會籍市場

「🎁 福利」→ 建立 offer：標題、說明、封面圖（1:1、≤10MB）、條款、名額、有效期。
「🏛️ 中央池」→ 取用平台／供應商提供的 offer（機構策展）。
會員在 App「福利」tab 見到卡 → 長按卡面領取 → 翻面出示核銷碼。
機構側核銷 → 系統自動記錄（含成效費記錄）。

會籍市場（公開曝光）

設定會籍名、類別（最多 3）、封面（1:1）、公開開關。
公開後出現在 /clubs，並有迷你網站 <slug>.colinkery.app。
⚠️ 排序中性（不設買排名）；付費曝光一定標示「贊助」。

⑨ 活動與簽到

「✨ 開台助手／活動」→ 建立活動：名稱、日期地點、報名方式（公開連結／名單）。
活動當日開「交換房間」：參加者掃房 QR 或輸入短碼即可入房互換名片（支援一對多／多對多）。
簽到／收款（如適用）→ 紀錄可在「📜 審計」查。

房間短碼與 QR 在 /exchange（房主專區）都可以見到。

⑩ 帳單／收款

「🧾 帳單」：你的方案、應付費用、歷史紀錄。
會籍費／福利成效費：平台設定比率（讀中央配置，非硬編碼）；機構可在帳單見到。
付款入帳後由平台確認；如有爭議請保留付款參考號（介面可填「我已付款」）。

機構後台的帳務頁屬商家表面（web only），不會出現在手機 App 內。

⑪ CoLinkery 平台後台（內部）

入口：/admin（只有平台 owner）。左側欄 12 節：概覽／用戶／協會／公司／KYC／方案／收費／類別／廣告／中央池／審計／資料庫（唯讀）／推送。

⚠️ 平台後台係內部營運用途：⛔ 不會在官網公開宣傳；所有寫入操作都會留審計紀錄（可驗鏈）。

各節畫面（實際截圖·自動生成）

實際截圖**console.nav_overview**：平台後台總覽：關鍵數字＋左側欄 13 節

實際截圖**console.nav_analytics**：平台數據總覽：會員／交換／名片／搜尋／新聞／福利池 KPI、每日趨勢、交換漏斗、活躍與留存（只讀現有資料庫，不含姓名、電話、電郵或 IP）

實際截圖**console.nav_users**：搜尋、全部／啟用／已停用；只有營運者可看全庫

實際截圖**console.nav_orgs**：全平台機構一覽（付費曝光一律標示「贊助」）

實際截圖**console.nav_companies**：公司清單與協會共用同一資料表，以類型區分

實際截圖**console.nav_plans**：方案為唯讀顯示；調整方案需另行拍板

實際截圖**console.nav_fees**：平台收費參數（讀寫資料庫，非硬編碼）

實際截圖**console.nav_categories**：兩級類別樹：可加／改名／排序／停用（停用不會刪除）

實際截圖**console.nav_ads**：只限新上市（六個月內）；曝光規則讀資料庫

實際截圖**console.nav_pool**：⚠️ 本節尚未開放（細節待產品負責人拍板）

實際截圖**console.nav_audit**：全平台敏感操作（可驗完整性）

實際截圖**console.nav_db**：**只讀**瀏覽器：白名單表、排序、分頁、匯出 CSV／XLSX；寫入預設關閉

實際截圖**console.nav_push**：⚠️ 只有平台營運人員可發送；發送前先預覽人數

⑫ 帳號安全

項	做法
PIN	設定 → 🔐 帳戶安全：設／改 PIN（首次登入會要求設定）
登入方式	設定 → 🔗 登入方式：可掛電話、電郵；驗證後才可以跨裝置登入
失敗鎖定	同一帳號連續失敗 5 次 → 鎖 15 分鐘（另有 IP 限流）
機構編號	⚠️ 編號不可以單獨登入 —— 一定要配 PIN；請只交給持有人
換裝置	未驗證憑證只限原裝置；先加電郵並驗證即可換機

⑬ 資料與私隱（我們點保護）

項	做法（實際）
名片圖／人像／證明檔	存私密儲存（R2）：只可以經已登入的合法 session 讀取，沒有公開連結
個人資料加密	敏感欄位用 `ENVELOPE_MASTER_KEY` 加封（未設 key 時相關功能停用，不會以明文落庫）
身份證等特別資料	去識別化（不可逆雜湊）＋加封；只用於驗證，不外露
登入電話	⛔ 永不對外（不會出現在卡片／分享／搜尋結果）
機構資料範圍	機構只見到自己會籍範圍的會員資料（授權依會費有效期）
審計	所有敏感操作入不可篡改審計鏈（可驗證完整性）
刪除帳戶	App 內可自助刪除＋匯出資料；平台按法律要求保留必要紀錄（如帳務）
不賣資料	生態鐵律：⛔ 不會出售或交換個人資料

合約／政策草稿（服務條款、私隱政策、資料處理附錄）：.coappery/specs/ORG-TERMS-PRIVACY-DRAFT.md —— ⏳ 待法務審批。

⑭ 常見問題

不記得咗係邊個入口？

去 colinkery.com/login，選擇你的身份（個人／公司／協會／會籍／平台），系統會帶你去相應登入。

登入之後見不到機構後台？

① 確認你係該機構的持有人或管理員；② 由 /business 選擇機構；③ 如果乜都沒有 → 你未建立任何機構，去 /orgs 建立。

收不到驗證碼？

現階段電郵驗證已通；電話驗證（WhatsApp）待頻道開通。先用電郵。

機構編號可以改嗎？

編號永久（同帳戶綁定，用於對帳／客服）。如需更正，請聯絡平台管理員。

我係協會，可以收會費嗎？

可以，但要完成 KYC（社團層可免費入會但不可收費）。