paper
All projects
全端開發者 / Ongoing

DoContrib

一個開源的團隊貢獻追蹤平台,結合即時協作文件功能,讓團隊成員可以記錄與檢視彼此在專案中的實際貢獻。

Next.js 15ReactTypeScriptTailwind CSSshadcn/uiSupabasePostgreSQLLiveblocksTiptapNextAuth.jsGoogle OAuth

Project links

Source link not published yet.

01 / Overview

The problem, and the approach.

Problem

團隊一起用文件協作時,每個人實際貢獻了多少很難被公平衡量,認真做事的人容易被搭便車、不做事卻分走功勞的成員稀釋掉貢獻。

Solution

讓團隊成員在同一份文件上即時協作編輯,同時在背後記錄每個人實際編輯與貢獻的內容,把原本看不見的貢獻量化並呈現出來。

02 / Architecture

How the system fits together.

選擇節點查看元件職責與它在整體系統中的位置。

client

Next.js Client

React 前端,搭配 shadcn/ui 元件庫。

Hover、focus 或點擊節點來探索架構。

03 / Request flow

Follow a request.

用一個具體請求理解資料與控制流程,而不只停留在技術名稱。

Illustrative request flow

  1. 01
    使用者編輯文件

    在 Tiptap 編輯器中輸入內容。

  2. 02
    Liveblocks 同步

    即時廣播變更給其他協作者。

  3. 03
    寫入 Supabase

    定期或觸發時將內容持久化。

04 / Engineering decisions

Trade-offs are part of the design.

記錄選項、選擇理由與代價,讓設計決策可以被理解,而不只是被展示。

為什麼選 Liveblocks 做即時協作

Problem

需要讓多個使用者同時編輯同一份文件並即時看到彼此的變更。

Options considered

  • 自行實作 WebSocket + CRDT
  • 使用 Liveblocks 這類現成的協作基礎設施

Decision

採用 Liveblocks 搭配 Tiptap。

Why

  • 不需要從零實作 CRDT 與連線管理
  • 與 Tiptap 有現成的整合方案,可以專注在產品邏輯而不是協作底層

Trade-offs

  • 依賴第三方服務,協作功能的可用性受限於 Liveblocks 本身
  • [EDIT: 補充實際遇到的限制或成本考量]
Project notes

Paper1988

GitHub Org

Vercel

部署平台