招培上課 LMS｜NEXUS-LEARN 技術架構

系統邊界

LMS 是課程版本、排期、enrollment、學習與證書的權威來源；商城商品和支付屬於商城系統。

01 / 分層架構圖

功能在技術層中的位置

01界面層 · Next.js

用戶端報名、學習、考試、問卷、證書

統一管理端課程、講師、排期、題庫、申報

02接口層 · Node.js

LMS API課程、報名、學習會話、考核、證書

監管 API活動版本、快照、證據匯出

03業務功能層

課程與報名版本、排期、容量、enrollment

學習與監管進度、考核、完課、證書、申報

04異步處理層

Node.js Worker心跳聚合、完課、發證、學時、通知、證據包

05資料層

lms_db課程版本、排期、報名、學習、答卷、證書

物件儲存教材、影片、證書、申報材料

06外部與共用

內部接口人員身份、合規規則、商城席位

監管材料MPFA／HKCAAVQ 接口；待確認

圖中箭頭表示由界面經 API 及業務模組進入處理與資料層；外部交互須經受控適配器。

02 / 功能模組

具體功能與責任

課程內容與排期

課程主檔、教材版本、講師、排期、指派／自主報名、候補和七工作日變更通知。

學習與考核

播放器心跳、活躍時長、隨機再驗證、題庫抽題、考試補考與強制課後問卷。

完課、證書與學時

完課規則、證書 PDF 與公開驗證連結；合資格內部學員的有效學時事件。

監管活動與證據

MPFA 活動版本、申請快照凍結、QA 材料與可導出的證據包。

03 / 系統交互

接口與資料同步

來源 → 目標	接口／方式	傳遞內容與規則
人員 → LMS	身份事件／只讀查詢	員工 ID、在職狀態和主管關係
LMS → 人員	完課事件	試用期培訓完成率
LMS → 合規	LearningHoursAwarded 事件	內部合資格學員的學時與證據引用
LMS → 商城	課程／排期事件＋容量 API	可售課程版本、排期和即時名額
商城 → LMS	付款／席位啟用事件	以 source_allocation_id 建立 enrollment
LMS → 審計中心	證據引用事件	學習心跳、考核、證書和申報快照

04 / 技術組成

落地約束

外部買家完課可獲學習紀錄與證書，不自動寫入內部牌照台帳。
MPFA 申請先凍結快照並計算哈希，再由負責人簽署；退回修改必須建立新版本並重新簽署。
LMS 保存證書簽發、撤銷與當前狀態；已簽發證書及審計證據不可因退款直接刪除。

Next.jsNode.jsTypeScriptPostgreSQLOutbox + Worker物件儲存

05 / 關鍵時序

MPFA 申請快照、簽署與重新提交

sequenceDiagram
    participant 營運
    participant LMS as M3 活動與申請
    participant 負責人
    participant MPFA as MPFA 渠道（待確認）
    營運->>LMS: 完成活動版本及材料檢查
    LMS->>LMS: 凍結申請快照並計算 snapshot_hash
    負責人->>LMS: 審閱並簽署 snapshot_hash
    LMS->>LMS: 保存簽署人、職位、時間及材料版本
    LMS->>MPFA: 提交已簽署申請（方式待確認）
    alt 查詢或退回
        MPFA-->>LMS: Query 或退回
        營運->>LMS: 基於原版建立新申請版本
        LMS->>LMS: 重新凍結並計算新哈希
        負責人->>LMS: 重新簽署新哈希
        LMS->>MPFA: 重新提交新版本
    else 獲批
        MPFA-->>LMS: 審批結果及編號
        LMS->>LMS: 按獲批版本發佈允許公開的字段
    end

實線為同步請求；虛線為回執或異步事件。外部接口以實際聯調契約為準。

接口／事件	資料權威與關鍵 ID	冪等、時限及失敗處理
申請快照	M3：activity_version_id、application_version_id、snapshot_hash、材料引用	凍結後不可原地改；簽署前校驗材料和申請學時不超過實際學習時長。
負責人簽署	M3：簽署人、職位、時間、聲明版本及 snapshot_hash	簽署僅對該快照有效；退回修改必須建立新版本並重新凍結、簽署。
提交與結果	M3：提交編號、渠道回執、Query、審批結果及公開字段	渠道接口和自動提交範圍待確認；未知回執先核查，不盲目重複提交。