本表統一前面各章的常用名稱,也可用來查閱英文程式碼、記錄和平台主控台中的概念。中文採用本文慣例,檔名、型別、設定欄位、指令和協定識別碼則保留原始碼寫法。
表中說明以目前範本和文件的語境為準,不代表專案已實作列出的每一種技術或恢復機制。精確欄位和預設值請查閱參考手冊,個別問題請查閱疑難排解。
- 首次介紹不熟悉的概念時,可以寫成「中文名稱(English Name)」,後文保持一致。
- Cloudflare、Stripe、OAuth、Webhook、API、URL、JSON、SQL 等名稱保留英文,不必強行直譯。
- 識別碼、路徑、指令和字面值使用反引號,例如
DB、SAAS_SECRET、payment_succeeded。
- 中文句子優先使用逗號和句號。分號用於確實需要區分層次的並列句,不作為清單和一般句子的預設結尾。
- 同一英文詞在不同領域有不同含義時,請寫明語境。例如,資料庫交易和付款交易都可能對應
transaction。
- 「範本預設設定」指範本原始檔中的值,「初始化後的設定」可能已由 CLI 改寫,「目前生效的設定」還取決於執行環境和已部署版本。
- 「支援」應有實際實作和呼叫入口。出現型別、錯誤碼或註解範例,不代表對應業務已開放。
- 使用「讀取、寫入、傳送、比對、授予、撤銷」等動作說明行為,避免只寫「處理完成」,卻未說明完成到哪一步。
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| Saavo | Saavo | 產品名稱,保留原文 |
| Saavo CLI | Saavo 命令列工具 | 用於登入、選擇範本和建立專案等,不等於應用程式執行環境 |
| template | 範本 | 用來建立專案的基礎原始碼與設定 |
| project / application | 專案 / 應用程式 | 「專案」著重原始碼和開發,「應用程式」著重執行後的產品 |
| initialization | 初始化 | 準備專案或資源的初始狀態,必須說明是本機還是遠端 |
| template version | 範本版本 | 取得範本時的來源版本,與應用程式版本分別記錄 |
| application version | 應用程式版本 | 自己的產品版本,不能據此反推範本來源 |
| dependency | 相依套件 | 專案安裝並使用的第三方套件或模組 |
| lockfile | 相依套件鎖定檔 | 記錄解析後的相依套件版本,例如 package-lock.json |
| build | 建置 | 將原始碼轉換為建置檔案,不等於部署或資料庫遷移 |
| type checking | 型別檢查 | TypeScript 靜態檢查,不等於 Vite 建置 |
| lint | 程式碼規範檢查 | 檢查已設定的程式碼規則,不能取代業務測試 |
| test | 測試 | 透過輸入、操作和斷言驗證預期行為 |
| branch | 分支 | Git 中用來組織獨立開發工作的參照 |
| commit | 提交 | Git 中的程式碼快照,也指提交操作 |
| tag | 標籤 | 標記一個 Git 狀態,不代表已部署 |
| diff | 差異 | 兩個程式碼或設定狀態之間的變更 |
| merge conflict | 合併衝突 | 兩邊修改無法直接自動合併,需要理解後處理 |
| source archive | 原始碼套件 | 某個明確原始碼狀態的封存檔,不包含執行資料或 Secret |
| changelog / release notes | 變更紀錄 / 更新說明 | 內部紀錄說明實作細節,公開說明則描述使用者可見的變更 |
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| configuration / config | 設定 | 應用程式的設定及規則,注意區分靜態設定與執行變數 |
| source of truth | 權威來源 / 唯一依據 | 某項資料或規則應以哪個定義為準 |
| schema | Schema / 資料結構 | 設定和輸入驗證常寫 Schema,資料庫語境則寫資料表結構或資料結構 |
| domain | 業務領域 | 描述業務概念,與網站的「網域」區分 |
| service | 服務層 / Service | 負責業務規則與流程組織,具體程式碼名稱保持原樣 |
| repository | 儲存庫層 / Repository | 呼叫資料庫存取層,將儲存值轉換為業務值,不是 Git 儲存庫 |
| DB access / DAO | 資料庫存取層 | 負責 SQL、原始資料列和資料庫操作,DB 單獨出現時也可能是 Binding |
| UI | 介面 / UI | 面向使用者時寫「介面」,說明分層時可保留 UI |
| DTO | 資料傳輸物件(DTO) | API 邊界上的請求或回應結構,不等於資料庫原始資料列 |
| contract | 約定 / 契約 | 例如介面約定、資料約定,描述呼叫雙方需遵守的規則 |
| route | 路由 | 請求路徑、方法與處理入口之間的比對關係 |
| endpoint | 端點 / Endpoint | 對外呼叫入口,平台主控台中的物件名稱可以保留英文 |
| handler | 處理函式 | 處理請求、訊息、事件或命令的函式 |
| middleware | 中介軟體 | 在請求處理過程中執行的共用邏輯 |
| guard | 存取守衛(Guard) | 檢查存取條件,具體回傳或重新導向行為以呼叫處為準 |
| provider | 服務供應商 / Provider | 商業語境指外部服務供應商,程式碼語境也指實作某項功能的配接器 |
| runtime | 執行階段 | 執行程式碼的環境或入口語境,例如 fetch、queue、scheduled |
| context | 執行脈絡 | 目前執行所需的環境、語言和記錄等資訊,例如 Ctx、WorkerCtx |
| serialization | 序列化 | 將資料轉換為可儲存或傳輸的形式,不等於加密 |
| validation | 驗證 | 檢查輸入格式、型別或約束,不應一概視為使用者身分驗證 |
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| Cloudflare Workers | Cloudflare Workers | 平台名稱,單一部署應用程式可稱 Worker,不譯為工作執行緒 |
| Binding | 資源繫結 / Binding | Worker 存取資源的設定關係,名稱如 MAIN_KV |
| resource name / resource ID | 資源名稱 / 資源 ID | 平台資源的名稱和識別碼,不等於程式碼中的 Binding 名稱 |
| environment variable | 環境變數 | 隨執行或建置環境提供的設定,變數名稱保留原始碼寫法 |
| Secret | Secret / 敏感設定 | Worker 中敏感變數的儲存方式,其值可能是金鑰、權杖或密碼 |
SAAS_SECRET | 應用程式主金鑰 | 專案長期用於加密、簽章等操作的金鑰,不是版本號碼 |
| build-time variable | 建置時變數 | 建置過程中讀取,且可能寫入建置檔案的值,修改後通常需重新建置 |
| runtime variable | 執行階段變數 | 應用程式執行時讀取的值,需核對實際 Worker 設定 |
| D1 | D1 資料庫 | 範本透過 DB 和 ANALYTICS_DB 存取兩套資料庫 |
DB | 業務資料庫 Binding | 儲存帳號、付款、權限等業務資料 |
ANALYTICS_DB | 統計資料庫 Binding | 儲存第一方造訪統計資料 |
| KV | KV 儲存 | 索引鍵值儲存,範本用於內容、記錄、客服案件內文等,不只是快取 |
| R2 | R2 物件儲存 | R2 是服務名稱,Bucket 才是個別儲存貯體 |
| bucket | 儲存貯體 | 物件儲存中的容器,例如 MAIN_R2 指向的 Bucket |
| object key | 物件 Key / 物件識別碼 | 物件在儲存貯體中的名稱,不是加密金鑰 |
| Durable Object / DO | Durable Object / DO | 提供可持久保存的狀態與協調能力的 Cloudflare 元件,保留名稱 |
| local environment | 本機環境 | 在本機執行,資源狀態與遠端環境分別管理 |
| local preview | 本機預覽 | 打包後在本機查看,不代表已設定獨立測試 Worker |
| staging environment | 預備環境 | 用來獨立驗證接近正式環境行為的環境,範本不會自動提供完整的一套 |
| production environment | 正式環境 | 正式對外提供服務的環境 |
| Origin | 來源 / Origin | 由通訊協定、主機和連接埠組成的來源,不包含 URL 路徑 |
| hostname | 主機名稱 | 例如 app.example.com,不包含通訊協定和路徑 |
| custom domain | 自訂網域 | 綁定至應用程式的自有網域 |
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| database | 資料庫 | 明確說明是業務、統計、本機還是遠端資料庫 |
| baseline / initial schema | 初始資料表結構 / 資料庫基準 | 本文件中的「基準」指初始化起點,不是備份或增量遷移 |
| initialization script | 初始化指令碼 | 準備初始結構,範本的 *-init.sql 包含刪除資料表的操作 |
| migration | 資料庫遷移 | 對既有結構或資料進行版本化變更,不只是複製資料 |
| seed data | 初始化資料 | 為新環境寫入的基礎或範例資料,不代表範本提供通用 seed 指令 |
| record / row | 紀錄 / 資料列 | 業務描述常寫紀錄,SQL 語境常寫資料列 |
| raw row | 原始資料列 | 資料庫直接傳回、尚未轉換為業務型別的資料 |
| transaction | 資料庫交易 | 資料庫操作的交易邊界,與付款交易區分 |
| primary key | 主索引鍵 | 用來識別資料表中紀錄的索引鍵 |
| foreign key | 外部索引鍵 | 約束紀錄之間的參照關係 |
| unique constraint | 唯一約束 | 限制指定欄位組合不能重複 |
| index | 索引 | 資料庫索引與搜尋索引,需寫明所屬情境 |
| backfill | 資料補寫 | 為歷史紀錄補上新規則需要的值 |
| soft delete | 虛刪除 | 保留紀錄並標記為已刪除,能否還原取決於業務實作 |
| purge | 徹底清除 / 實體刪除 | 實際移除紀錄,沒有一般復原操作,還原需依靠備份等方式 |
| revoke | 撤銷 | 取消授權、角色、權益或權杖效力,不等於刪除歷史紀錄 |
| expire / expiration | 過期 / 到期 | 有效期限結束,不代表紀錄已被實際清除 |
| retention | 資料保留原則 / 保留期間 | 「保留期間」是時間,「保留原則」也包含清理範圍和執行規則 |
| Unix timestamp | Unix 時間戳記 | 說明使用秒還是毫秒,範本大多數儲存的時間使用毫秒 |
| UTC | 國際標準時間(UTC) | 時間基準,不能直接當作訪客所在時區 |
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| authentication | 身分驗證 / 使用者驗證 | 確認訪客身分,內文可依語境簡稱驗證 |
| verification | 驗證 | 確認某項事實或提交值,例如電子郵件地址所有權、驗證碼 |
| authorization | 授權 / 權限控制 | OAuth 語境寫授權,業務存取判定可寫權限控制 |
| account | 使用者帳號 | 使用者身分,不等於某一次工作階段 |
| session | 工作階段 | 登入工作階段、驗證工作階段、OAuth 工作階段應依用途區分 |
| Cookie | Cookie | 瀏覽器儲存並依規則傳送的資料,不等於伺服器端工作階段本身 |
| sign up | 註冊 | 建立帳號的流程 |
| sign in / log in | 登入 | 兩種英文統一使用「登入」 |
| sign out / log out | 登出 | 不與註銷帳號混用 |
| account deletion | 註銷帳號 | 結束帳號使用並依業務規則處理資料,不是登出目前工作階段 |
| password reset | 重設密碼 | 通常用於無法使用原密碼時的恢復流程,與變更密碼區分 |
| email verification | 電子郵件驗證 | 確認電子郵件地址所有權,需區分本站驗證與第三方供應商宣告 |
| two-factor authentication / 2FA | 雙重驗證(2FA) | 使用第二種驗證因素,不等於重複輸入密碼 |
| TOTP | 以時間為基礎的一次性密碼(TOTP) | 驗證器依時間產生的動態碼 |
| recovery code | 復原碼 | 2FA 的備用驗證方式,與電子郵件驗證碼區分 |
| step-up authentication | 敏感操作再次驗證 | 執行特定操作前重新確認身分,不一定使用新的驗證因素 |
| rate limit / throttling | 流量限制 / 請求節流 | 限制操作頻率,不等於永久停用帳號 |
| Turnstile | Cloudflare Turnstile | 防止自動化操作的驗證服務,不是使用者身分驗證或角色授權 |
| OAuth 2.0 | OAuth 2.0 | 授權協定,名稱保留空格 |
| OAuth Client | OAuth 用戶端 | 發起授權並使用權杖的應用程式,不等於登入使用者 |
| authorization server | 授權伺服器 | 處理授權並核發權杖的一方 |
| Redirect URI | 回呼網址 / 重新導向 URI | OAuth 返回用戶端的網址,實際值必須依協定與設定核對 |
| authorization code | 授權碼 | 授權流程中用來交換權杖的代碼,不是電子郵件驗證碼 |
| Access Token | 存取權杖 | 存取受保護資源時使用的權杖 |
| Refresh Token | 重新整理權杖 | 用來取得新的權杖,不是重新下載專案原始碼 |
| Client Secret | 用戶端 Secret | 用戶端驗證資訊,不等於使用者密碼或應用程式主金鑰 |
| PKCE | PKCE | 將授權請求與權杖交換請求關聯的驗證機制,參數名稱保留原文 |
| Scope | 授權範圍(Scope) | OAuth 權杖的存取範圍,也常稱為作用範圍,不是使用者角色 |
| consent | 授權確認 / 同意 | OAuth 頁面寫授權確認,Cookie 偏好設定語境則寫同意 |
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| access control | 存取控制 | 頁面、API 和業務操作的整體存取規則 |
| Subject | 授權主體(Subject) | 角色與權益的授予對象,具體型別以專案定義為準 |
| role | 角色 | 一組身分或職責對應的靜態能力定義,例如 admin |
| capability | 能力 | 角色和權益包含的基礎授權單位,不限於靜態權限 |
| static capability | 靜態能力 | 對應 CapabilityType.Static,由角色設定提供 |
| boolean capability | 布林能力 | 對應 CapabilityType.Boolean,表達功能是否可用 |
| numeric capability | 數值能力 | 對應 CapabilityType.Numeric,表達可計量的資源或額度 |
| entitlement | 權益 | 授予主體的產品使用資格或資源規則,可包含動態能力 |
| grant | 授予 | 為主體新增角色或權益,並保留來源關係 |
| grant source | 授予來源 | 說明權限來自哪次購買、訂閱或系統操作 |
| quota | 額度 / 配額 | 資源可使用的數量或限額,具體含義由業務定義 |
| credits | 點數 | 產品定義的可消耗數值資源,不自動等於貨幣餘額 |
| entitlement cycle | 權益週期 | 週期權益的處理節奏,需與付款扣款週期分別描述 |
例如,角色可以提供管理使用者的靜態能力,下載權益可以提供是否允許下載的布林能力,也可以包含下載次數的數值能力。角色或權益的名稱不是能力檢查結果,購買某個方案也不自動等於擁有所有付費功能。
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| product | 產品 | 應用程式自己的產品設定,與 Stripe Product 物件分別說明 |
| Plan | 方案 | 產品下的購買選項,不交替寫成計畫、套餐或訂閱級別 |
| Stripe Product | Stripe Product | Stripe 中的產品物件 |
| Stripe Price / Price ID | Stripe Price / Price ID | Stripe 的價格物件及識別碼,實際值如 price_... |
| connection ID | 付款連線 ID | 專案用來辨識付款連線的穩定識別碼,例如 STRIPE_CONNECTION_ID |
| billing | 計費 | 描述收費方式和週期,不將整個模組一概稱為帳單 |
| subscription | 訂閱 | 週期性計費關係,不等於某一次扣款交易 |
| one-time purchase | 一次性購買 | 一次性付款,不自動表示永久權益或終身服務 |
| Checkout | Checkout / 結帳頁面 | 付款結帳流程或頁面 |
| Checkout Session | Checkout 工作階段 | 一次結帳流程的物件,不是使用者登入工作階段 |
| payment customer | 付款客戶 | 付款服務供應商端的客戶關聯,不等於應用程式使用者紀錄 |
| transaction | 交易 | 付款語境中的業務交易,與資料庫交易區分 |
| line item | 明細項目 | 交易、訂閱等物件中的一筆產品或費用明細 |
| Billing Portal | 帳單入口 | 使用者管理付款與訂閱資訊的入口 |
| Invoice | 帳單 / Stripe Invoice | 技術說明保留物件名稱,不應預設理解為中國稅務發票 |
| trial period | 試用期 | 依方案或訂閱規則提供的試用時間 |
| Coupon | 優惠券(Coupon) | Stripe 中儲存折扣規則的物件 |
| Promotion Code | 促銷代碼 | 使用者可輸入,且與 Coupon 關聯的代碼 |
| Coupon Offer | 動態優惠活動 | 範本透過連結選擇優惠的功能,章節中也稱動態優惠碼 |
| refund | 退款 | 區分申請、處理中、成功與失敗,不等於自動撤銷權益 |
| affiliate | 聯盟行銷 | 推廣者透過推薦取得收益的功能 |
| referral | 推薦 / 推廣來源 | 聯盟語境寫推廣連結或推廣來源,避免與付款回呼混用 |
| commission | 佣金 | 聯盟行銷產生的收益紀錄 |
| payout | 佣金付款 / 收益付款 | 將可結算收益支付給推廣者,不是退款給購買者 |
顯示價格、Stripe Price、購買交易和存取權益,是四個不同概念。頁面顯示的金額不會修改 Stripe 收費,付款完成後,也不能單憑成功頁面就證明權益已授予。
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| API | API / 介面 | 路徑、方法和參數保留實際定義 |
| request / response | 請求 / 回應 | HTTP 或明確呼叫邊界中的輸入和回傳 |
| request body / payload | 請求本文 / 承載資料 | 請求本文屬於 HTTP,承載資料也可能是訊息或事件資料 |
| callback | 回呼 | 泛指完成某一步後呼叫另一入口,需說明是 OAuth 還是業務回呼 |
| Webhook | Webhook / 伺服器端回呼 | 外部服務主動向應用程式投遞事件,不是瀏覽器返回成功頁面 |
| signature verification | 簽章驗證 | 驗證來源與完整性,不等於解密內容 |
| raw body | 原始請求本文 | 未重新解析和序列化的請求內容,Webhook 簽章驗證需保留 |
| HTTP status code | HTTP 狀態碼 | 例如 200、401、403、500,不等於業務錯誤碼 |
| result code / error code | 結果碼 / 錯誤碼 | 供程式判斷結果,需區分專案數值碼與第三方字串錯誤碼 |
APIResponse<T> | API 回應型別約定 | 範本提供的型別,並非每個實際端點都傳回相同的完整結構 |
| retryable | 可重試 | 允許在對應條件下再次嘗試,不保證下次成功 |
| non-retryable | 不可重試 | 目前的失敗不應自動重試,可能需要先修正輸入或核對副作用 |
| fallback | 備用值 / 備用處理 | 說明具體使用哪個備用值或路徑,不與版本回復混用 |
| side effect | 副作用 / 外部效果 | 資料寫入、郵件寄送、付款等實際效果,可能無法隨程式碼版本回復而撤銷 |
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| background job | 背景工作 | 在背景完成的工作,不自動等於已排入 Queue |
| Cloudflare Queues / Queue | 佇列 | 用來投遞訊息,佇列名稱和 Binding 保留原文 |
| producer / consumer | 產生者 / 取用者 | 傳送訊息的一方,以及接收並處理訊息的一方 |
| enqueue | 排入佇列 | 將訊息放入佇列,不表示業務已完成 |
| acknowledgement / ack | 訊息確認 | 表示不再要求這次訊息投遞繼續重試,不一定代表業務成功 |
| redelivery | 重新投遞 | 佇列或服務供應商再次投遞訊息或事件 |
| retry | 重試 | 必須說明是 Command 執行重試、HTTP 重試,還是 Queue 重新投遞 |
| replay | 重播 | 再次處理歷史事件或工作,應先核對等冪性與已發生的效果 |
| idempotency | 等冪性 / 等冪處理 | 重複處理同一業務操作時,不會重複產生約定範圍內的效果 |
| idempotency key | 等冪鍵 | 在對應範圍內識別同一業務操作,例如 idempotencyKey |
| lease | 租用 | 在一定時間內取得的處理權,用來協調並行執行 |
| dead-letter queue / DLQ | 死信佇列(DLQ) | 接收失敗訊息的佇列,不能暗示目前範本已為所有佇列設定 |
| Reaction | Reaction | 專案內部組織業務事件與命令執行的系統 |
| Event | 業務事件 / Reaction Event | 描述已發生的業務事實,型別名稱如 PaymentSucceededEvent |
| Command | 業務命令 / Reaction Command | 事件產生的執行步驟,型別名稱如 GrantRoleCommand |
| Event execution | Event 執行紀錄 | 對應 event_execution,需與外部服務供應商的 Event ID 區分 |
| Command execution | Command 執行紀錄 | 對應 command_execution,儲存步驟狀態與執行資訊 |
| synchronous / sync | 同步 | 在目前執行流程中直接處理 |
| asynchronous / async | 非同步 | 與目前步驟分開安排,範本的非同步 Command 由佇列處理 |
| Cron Trigger | Cron 排程觸發程序 | 決定何時觸發工作,運算式稱為 Cron 運算式 |
| scheduled handler | 排程工作入口 | Worker 中處理排程觸發的入口 |
| 狀態 | 本專案中的含義 |
|---|
Webhook processing | 事件處理紀錄持有租用,還需搭配更新時間判斷實際進展 |
Webhook succeeded | 這個事件的成功處理已記錄,不保證所有後續非同步效果都已完成 |
Webhook failed | 這個事件處理失敗,需要搭配錯誤紀錄排查 |
Command pending | 尚未結束,可能等待執行或重試 |
Command succeeded | 命令成功,且結果已儲存 |
Command failed | 命令以業務失敗結束 |
Command errored | 命令以例外結束 |
Event completed | 根據所屬 Command 計算的完成狀態 |
Event partial_failed | 允許失敗後繼續執行,全部步驟結束,且有業務失敗 |
Event 狀態由 Command 狀態計算,event_execution 中沒有另外儲存的 status 欄位。表格並未完整列舉所有狀態,詳細說明請見領域事件與命令。
同一個詞 Event 也可能指 Stripe 事件或統計事件。說明跨系統流程時,應寫出「Stripe Event ID」、「Reaction 執行 ID」或「統計事件」,不要只使用一個「事件 ID」貫穿所有系統。
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| MDX | MDX | 支援元件內容的 Markdown 檔案形式,依專案元件慣例撰寫 |
| Frontmatter | Frontmatter / 文件中繼資料 | 檔案開頭由 --- 包住的標題、描述等資訊 |
| content collection | 內容集合 | 從文件、部落格等原始檔產生的結構化內容 |
| search index | 搜尋索引 | 供搜尋查詢使用的建置檔案,不等於內文或資料庫索引 |
| Slug | 路徑識別碼(Slug) | 內容 URL 中的路徑識別碼,實際路徑由路由規則決定 |
| analytics | 造訪統計 / 統計 | 本專案的流量和行為統計功能 |
| first-party analytics | 第一方造訪統計 | 本應用程式自行提供的統計資料收集與報表 |
| third-party analytics | 第三方統計服務 | 例如 Google Analytics、Clarity,需與第一方設定區分 |
| tracking event | 統計事件 / 事件收集 | 前者指紀錄,後者指收集動作,不等於業務 Event |
| page view / PV | 網頁瀏覽 / 網頁瀏覽量 | 瀏覽行為或其計數,不等於不重複訪客人數 |
| visitor / visit / session | 訪客 / 造訪 / 統計工作階段 | 依統計實作區分身分與造訪過程,不等於登入工作階段 |
| funnel | 轉換漏斗 | 依一組步驟觀察完成與轉換情況 |
| Do Not Track / DNT | 不要追蹤(DNT) | 瀏覽器的追蹤偏好訊號,不等於 Cookie 同意紀錄 |
| Cookie consent | Cookie 同意管理 | 管理同意偏好及相關指令碼的啟用條件 |
| internationalization / i18n | 國際化 | 讓應用程式具備支援多語言的結構與機制 |
| localization / l10n | 在地化 | 為某種語言或地區翻譯內容,並調整呈現方式 |
| locale | 語言識別碼 / Locale | 本文件常指 en、zh-Hans 等識別碼,未必包含地區 |
| language code | 語言代碼 | 具體設定值保留原文,例如 zh-Hant |
| translation key | 文案索引鍵 | 在標準語言資源中查找文字的路徑 |
LocalizedText | 可在地化文案設定 | 設定中的 key 和 value 物件,不是一般字串 |
| translation fallback | 文案備用值 | 缺少翻譯時使用的內容,不代表翻譯已完成 |
| Newsletter | 電子郵件訂閱 | 網站更新郵件的訂閱功能,不是付費產品訂閱 |
統計資料用來觀察造訪行為,不能取代付款帳本或稽核紀錄。統計工作階段數也不能直接當作登入使用者人數。
| English / 程式碼 | 中文名稱 | 含義與用法 |
|---|
| deployment | 部署 | 將應用程式和相關執行設定發布至目標環境 |
| release | 發布 / 版本發布 | 範圍可能包含程式碼、設定、資料和公開說明,需寫明實際操作 |
| upgrade / update | 升級 / 更新 | 明確說明對象是 CLI、範本、相依套件,還是線上應用程式 |
| breaking change | 不相容變更 | 使原有資料、設定或呼叫方式無法直接繼續使用的變更 |
| backward compatibility | 回溯相容性 | 新實作仍能處理約定範圍內的舊輸入或狀態,不代表永遠相容 |
| health check | 健康狀態檢查 | 檢查指定入口或條件,不等於完整業務驗收 |
| backup | 備份 | 為還原保留的副本,應說明包含哪些資源 |
| restore | 還原 | 從副本或還原點重建狀態,可能影響還原點之後的寫入 |
| recovery point | 還原點 | 可用於還原的明確歷史狀態 |
| Time Travel | D1 Time Travel | D1 的時間點還原機制,不等於整個應用程式的自動回復 |
| rollback | 回復舊版本 / 版本回復 | 必須說明回復的是程式碼、設定還是資料,不能一概承諾全部撤銷 |
| roll forward | 向前修正 | 透過後續變更修正目前狀態,而非還原舊版本 |
| log / audit log | 記錄 / 稽核記錄 | 前者記錄執行資訊,後者追蹤需要稽核的操作 |
| alert | 警示 | 需要關注或處理的異常通知,不等於一般業務通知 |
| observability | 可觀測性 | 透過記錄、指標和執行紀錄,了解系統狀態的能力 |
| incident / troubleshooting | 故障 / 疑難排解 | 故障是問題,排查則是蒐集證據並定位原因的過程 |
升級 CLI 不會自動更新已建立的專案。deploy:update 發布目前目錄的程式碼,也不會下載新版範本。回復舊版程式碼,不會自動撤銷資料庫遷移、已付款交易或已寄送的郵件,詳細說明請見升級與維護。
只有在多篇文章會重複使用、譯法容易混淆,或誤解會影響設定與業務行為時,才需要新增術語。請保持定義簡明,詳細流程連結至對應章節,不在術語表中再複製一套教學。
修改術語時,先核對負責該概念的原始碼與既有文章。如果只是補充英文別名或釐清語境,不必機械式替換所有表述。如果變更了已使用的中文名稱,應同步檢查內文、標題和連結,避免本表與教學各用一套名稱。