#Note — 讓非工程人員把文件收進 Git 的協作平台
Note — 讓不會用 Git 的非工程人員(PM、設計、企劃⋯)也能把文件統一收斂進 Git repo,而不是散落在各種工具裡。把他們真正需要的功能整合進來——所見即所得編輯 HTML / Markdown、簡報播放、一鍵把 repo 內的 HTML 發行成獨立網站——讓底層的 Git 對使用者無感。已獲跨部門採用,核心機制另有公開重製版 note-bridge 可直接驗證。
// 遇到什麼問題
##問題
非工程人員的文件散落在簡報、雲端文件與聊天工具裡,沒有版本控制、也難以彙整成單一事實來源;而 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)完整重現、可直接驗證。
