Skip to content
Raymond Setiawan edited this page Jul 21, 2026 · 8 revisions

Beam / Dataflow Sandbox 說明文件

On this wiki: 針對使用BEAM for Cyberbiz的application

内容

頁面 內容
架構總覽 整體架構圖、兩個套件(可重用框架 + 展示用 Demo)的關係
Repository Structure (EN) Repo layout, pipeline stages, and a reuse-vs-rewrite breakdown — in English
快速開始 安裝環境、本機執行 Pipeline、啟動 Dashboard,一步一步教學
儀表板操作說明 儀表板啟動方式與各分頁功能說明
情境範例 四個內建合成情境的說明表
安全機制 資料安全、雲端閘門(Cloud Gate)的運作方式
可重用框架 beam_pipeline_toolkit 的使用方式,如何套用到自己的管線
雲端佈署清單 未來要接上真實 GCP 資源時的檢查清單(目前預設關閉)

專案定位

  • 僅合成資料:所有商店代號、日期、訂單皆為固定的假資料。
  • 不連接 Cyberbiz 正式環境:不會存取正式程式庫、GCP 專案、使用者資料或憑證。
  • 本機模式已經可以運作:不需要任何雲端設定就能跑完整條 Pipeline。
  • 雲端模式預設關閉:需要三個明確的旗標同時開啟才會真正呼叫 GCP。

專案結構一覽

flowchart LR
    subgraph toolkit["beam_pipeline_toolkit/(可重用框架)"]
        P[pipeline/<br/>解析‧驗證‧彙總‧輸出]
        CP[controlplane/<br/>Dataflow 送出‧停止‧讀取證據]
        S[safety/<br/>禁止欄位掃描‧雲端閘門]
        EC[ecommerce/<br/>選用的電商擴充層]
    end
    subgraph demo["demo/(Cyberbiz 電商情境展示)"]
        APP[app/<br/>FastAPI Dashboard]
        DP[pipeline/<br/>電商 Beam Pipeline]
        SH[shared/<br/>合成資料‧安全規則]
    end
    demo -.套用形狀.-> toolkit
Loading

原始碼:https://github.com/sinlead/beam

Clone this wiki locally