平台工程

#Note — 讓非工程人員把文件收進 Git 的協作平台

Note — 讓不會用 Git 的非工程人員(PM、設計、企劃⋯)也能把文件統一收斂進 Git repo,而不是散落在各種工具裡。把他們真正需要的功能整合進來——所見即所得編輯 HTML / Markdown、簡報播放、一鍵把 repo 內的 HTML 發行成獨立網站——讓底層的 Git 對使用者無感。已獲跨部門採用,核心機制另有公開重製版 note-bridge 可直接驗證。

React 19TypeScriptNode.js / ExpressSQLitemarked / DOMPurifyGitHub REST APIDocker + CI/CD
Note — 讓非工程人員把文件收進 Git 的協作平台 系統畫面

實際系統畫面 公開重寫版 note-bridge 實際畫面:左側是 VS Code 風格的巢狀檔案樹,展示模式下勾選檔案(勾資料夾=整個子樹)組成播放清單;右側是 repo 裡的 HTML 直接以獨立網頁渲染——CSS 與 JavaScript 一併載入(統計卡片就是頁內 JS 產生的),並以 sandbox 隔離確保外來程式碼碰不到平台本身。(點擊圖片看原圖)

// 遇到什麼問題

##問題

非工程人員的文件散落在簡報、雲端文件與聊天工具裡,沒有版本控制、也難以彙整成單一事實來源;而 Git 雖然理想,門檻對不寫程式的人太高,無法直接要求他們使用。

// 如何解決

##解法

把 Git 藏在無感的操作介面底下,文件直接以 Git repo 為單一事實來源、不另建內容資料庫(版本控制天生內建;後端僅用 SQLite 存 session 與分享連結,OAuth token 以 AES-256-GCM 加密、不代管任何文件內容)。整合非工程人員真正需要的功能:所見即所得編輯 markdown / HTML、勾選檔案(含整個資料夾)組成投影片播放、repo 內 HTML 以 sandbox 隔離渲染並一鍵發行成獨立分享網站(marked + DOMPurify)。公司內部版接 Gitea 並串自架 opencode AI gateway 輔助;公開重製版 note-bridge 改接 GitHub,React + Express 全端。

// 我負責什麼

##我的角色

定位與全端設計:把 Git 工作流封裝成非工程人員無感的協作平台(所見即所得編輯 / 投影片 / 一鍵發行獨立網站),設計以 Git repo 為單一事實來源、token 加密且不代管內容的分享模型(React / Express / SQLite);公司版串接自架 opencode AI gateway,並推動跨部門(含 PM 部門)導入。

// result

##成果

跨部門的非工程人員 Git 協作工具:其中 PM 部門由協理指定為全部門統一使用——從實驗專案成為部門標準流程。核心機制另以公開版 note-bridge(改接 GitHub)完整重現、可直接驗證。