#Note — 技術與非技術部門共用的文件協作平台
讓非技術人員用熟悉的 Google Docs 體驗寫文件、規格書,底層直接存進 Git;工程師也在同一套系統看得到這些文件。文件可以直接播成投影片,HTML 也能一鍵分享成獨立網站。
一份文件、兩種介面,同一個真相來源。非技術人員在 Note 上用所見即所得的方式編輯,涵蓋大多數 Google Docs 的能力,不需要理解 Git;工程師則可以選擇在 Note 上讀寫,或直接用 Gitea 操作同一份 repo。兩邊看到的永遠是同一份內容,版本控制是底層 Git 免費附贈的。
// 遇到什麼問題
##問題
非工程人員的文件散落在簡報、雲端文件與聊天工具裡,沒有版本控制、也難以彙整成單一事實來源;而 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
##成果
目前累積 204 份文件(Markdown 165 份、HTML 39 份),分布在 14 個 repo,22 位使用者,近四週每週有 5–10 位不同作者實際編輯。除了文件協作,HTML 分享成獨立網站的功能也讓非工程人員有了自己的發布管道 —— 曾經有 PM 在 Note 上完成測試後,把程式碼送上正式環境。
