線稿索引

Spec 索引

specs/*.md 的建構期快照（共 41 份），分 core（實體 / 狀態機 / 架構橫切）與 feature（功能切片）。 各頁線稿右下「UI / Spec」可看該頁相關 spec。

核心 Core

實體 · 狀態機 · 架構橫切

架構 / 橫切

系統設計總綱2026-06-20
系統邊界、租戶架構、核心資料模型與安全不變式的總覽入口
system-design
租戶架構2026-06-20
多租戶三層架構：control_db 目錄、auth 下放租戶 DB、admin plugin RBAC
tenant-architecture
App 拓撲2026-07-07
前後台分離成兩個 Cloud Run service + 共用 packages/core
app-topology
模組化2026-07-01
登山 / 海外 / 訂房 / 抽籤 / 進階會計五個可拆售模組 + 平台授權與行程旗標兩層 gate
modules
進階會計模組（帳務拆分點）2026-07-02
掛帳台帳留核心 + Excel 匯出；金流對帳結算損益收進一個 module_accounting 可拆售模組
accounting-module
動態 RBAC2026-07-02
角色→權限指派從 code 搬進 DB，admin 用 resource×level 矩陣編輯
dynamic-rbac
後台 Design System2026-06-23
後台元件目錄與 import / 治理紀律（@toko-cloud/ui 為唯一 primitive）
admin-design-system
Email 寄送2026-07-03
平台單一 Resend 帳號代所有租戶寄交易信，可選自有 domain
emails

實體核心

訂單2026-06-05
kind-agnostic 外殼 + lines + 三軸狀態，金流真相在 order-money-model
orders
旅客2026-06-11
訂單明細層的旅客 PII（綁 order_id 非綁 user），非會員 / owner 錨點
travelers
行程與梯次2026-07-01
行程產品 trips 與可賣梯次 departures 的實體核心入口
trips

金流核心

訂單金流模型2026-07-04
七層分類帳模型、核心公式、不變量與狀態機的 SSOT
order-money-model

功能 Feature

功能切片

金流 / 財務

團控財務與請款核簽2026-07-01
掛帳、梯次成本、優惠價、payables 請款核簽
control-finance
內外帳與真實成本2026-07-07
一筆成本並存內帳真實額與外帳可申報額，派生淨利與報稅雙視圖
internal-external-ledger
多收款帳戶分流與對帳2026-07-03
收款落哪個帳戶的維度 + 逐帳戶對帳視圖
payment-accounts-reconciliation
代收轉付電子收據整合2026-07-07
收據開立 / 折讓 / 作廢 / 查回，憑證 per-tenant 比照 ECPay
travelinvoice-integration
折扣碼與分潤快照2026-06-20
折扣碼以負 charge line 扣應收 + KOL 分潤快照
discount-code
系列團成本範本2026-07-03
可重用成本範本綁行程，梯次自動帶入成本行、數量綁人數動態重算
cost-template

行程銷售 / 內容 / 定價

行程定價與付款政策2026-06-05
直客 / 同業價、梯次覆寫、訂金尾款、團費包含、包團價的 SSOT
trip-pricing
內容編輯（MDX）2026-07-01
後台 MDX 編輯器、public 渲染、journal 與 tour 內容元件 SSOT
content-authoring
團號系統2026-10-10
梯次對外識別碼：年份+地區+航空+出發日+流水序，併發安全產號
group-code

排團 / 出團

批次開團2026-06-23
上傳 Excel / CSV 兩階段批次建立行程與梯次
bulk-trip-import
抽籤整合2026-07-02
ERP↔GS 抽籤契約：推應募名單、收中籤結果、觸發下游
lottery-integration
備案行程自動轉單2026-06-30
未中籤自動取消主單、轉成立備案梯次並帶過訂金催尾款
backup-itinerary-failover
登山分級審核器2026-07-04
對照行程難度與客人能力，攔截越級報名、警示轉人工
climbing-screening
旅客資料驗證2026-07-01
逐人驗證資料完整正確，讀時計算不落 DB
traveler-validation
證件效期提醒2026-07-03
手動輸入護照到期日，於團控 / 儀表板被動呈現效期警示
document-expiry
護照上傳與 OCR2030-03-15
上傳護照影像、OCR 抽 MRZ 自動填 traveler，KMS 加密短期保留
passport-ocr
團控分房2026-06-22
梯次住宿房間、旅客分房、房升補款與分房表匯出
room-assignment
出團前置作業2026-06-24
梯次行政期限警戒（工作天倒數）與許可證文件附掛
departure-prep
裝備庫存彙總與警示2026-07-02
登山模組裝備品項 / 庫存 / 需求彙總與警示（草圖）
equipment-inventory
嚮導 / 領隊 Portal2026-07-02
嚮導受限 login，scoped 看自己梯次 dossier + 成本 / 發票填報，取代 Google 表單
guide-portal

訂房

旅宿庫存脊椎2026-06-01
自家旅宿主檔 + 房型 + 每晚共用庫存 + 日曆價
lodging-inventory
訂房散客直訂2026-06-05
散客直訂成交 flow，扣每晚庫存、建 order line、接金流
lodging-direct-booking
行程配套住宿2026-06-20
行程固定配自家旅宿，出團整塊預留團體床位扣共用庫存
lodging-tour-package

會員 / CRM

會員與業務歸屬2026-07-01
客戶層負責業務 owner + 同業 agencies 表
member-ownership
會員自助 PDPA2026-06-03
前台旅客端：下載我的資料 + 終止會員（真正匿名化）
member-pdpa-self-service

後台營運

訂單派發機制2026-07-03
自動 / 主管審核兩種派發，建立 sales attribution 底層
order-assignment
角色化儀表板2026-07-06
依角色切換指標範圍，業務排行 / 熱銷只給 admin
dashboard
租戶設定2026-07-07
tenant_settings 單例與 /admin/settings 8 tab 的 SSOT
settings

Reference

現行 GS 模型對 ERP 缺口2026-05-30
GS 主檔運算層公式還原與 ERP 缺口逐項對照（快照）
legacy-gs-gap