NexusPro 是多租戶 HR／OA SaaS 平台。本指南面向後端、前端、測試與維運人員，將「系統如何運作」與「如何驗證改動」放在同一條閱讀路線上。
找到你的閱讀路線
不必一次讀完所有文件。從你的工作出發，再回到共同的架構與交付標準。
| 你的角色 | 建議閱讀順序 | 讀完後能做到 |
|---|---|---|
| 後端工程師 | 快速開始 → 技術架構 → 後端規範 → 功能實戰 | 找到正確分層，先定契約再實作 |
| 前端工程師 | 前端啟動 → 前端開發 → 頁面規範 → 實戰串接 | 分辨真實 API 與 fixture，正確呈現預覽及錯誤 |
| 測試人員 | 功能地圖 → 測試策略 → 實戰驗證 | 區分單元證據、聯調與部署驗收 |
| 維運人員 | 後端啟動 → 整合邊界 → 部署排查 | 分辨存活與就緒，不以重建資料卷處理故障 |
文件分類
依真實前後端來源整理開發手冊、核心機制與業務板塊。功能全景與實作索引集中列出目前路由、前端頁面及各板塊閱讀入口；專案目錄協助定位程式碼。
一張圖理解核心架構
NexusPro 採 Go 模組化單體，不是微服務。不同業務域以 package 分工，並在同一套分層邊界內協作。
正在繪製架構圖…
查看圖表原始碼
flowchart LR A["前端 Next.js"] --> P["proxy.ts 轉發同源 /v1 請求"] P --> B["Gin HTTP adapter"] B --> C["Service / Facade"] C --> D["Repository interface"] D --> E["PostgreSQL Store / sqlc"] E --> F[(PostgreSQL + RLS)]
瀏覽器只呼叫同源 /v1/**，由前端 proxy.ts 在 server 端轉發並從 httpOnly cookie 注入 access token，不直連 Gin。PostgreSQL 是業務資料、查詢投影與 outbox 的唯一事實來源；單步冪等副作用走 outbox／jobs。Temporal 在架構上承載長流程編排，但目前只有 JML 流程（hr.onboarding.v1、hr.offboarding.v1）經 internal/platform/temporal 的 Orchestrator adapter；TEMPORAL_ENABLED 預設 false，此時改用 in-process fake，沒有長流程保證，WORKFLOW_JML_AUTO_START_ENABLED 也預設 false。表單審批是在租戶交易內同步推進的 PostgreSQL 狀態機（internal/service/form/instance），不經 Temporal。閱讀完整技術架構 →
關於這份指南
教學依序說明目標、前置條件、概念、操作、驗證與常見錯誤。程式碼、API 欄位與技術名稱保留英文；沒有可核實資料的地方明確標示「待確認」。
文件站獨立於業務系統，經授權公開閱讀。 不包含真實憑證、內部帳號或環境連線值；沒有影片素材，因此全部使用圖文教學。文件站發佈不代表業務服務已部署或通過驗收。