ruoyi-vue-pro 開發指南
使用此技能進行 ruoyi-vue-pro / Yudao 基礎開發。請先遵循實際的儲存庫分支;這些說明僅填補代理程式常遺漏的慣例。
快速工作流程
- 釐清模組、管理端/應用端、頁面入口、權限、租戶/資料範圍需求、字典、匯入/匯出、審計/日誌,以及專案選用的分支/JDK。
- 在編輯前,先檢視附近已實作的模組。重複使用現有的 Controller、Service、Mapper、VO、API、頁面和 SQL 模式。
- 在實作前,先設計資料模型、API 合約、權限字串、選單和字典。保持 SQL 與後端註解及前端權限檢查一致。
- 僅閱讀任務所需的參考文件:
- 儲存庫結構與分支檢查:
references/repo-map.md - 後端慣例:
references/backend-conventions.md - Vue3 管理後端前端:
references/frontend-vue3-conventions.md - uni-app 前端:
references/frontend-uniapp-conventions.md - MySQL SQL、選單、權限、字典:
references/db-mysql-conventions.md - Redis / 分析資料庫 / 外部系統邊界:
references/integration-boundaries.md - 模擬或種子資料:
references/mock-data.md
- 儲存庫結構與分支檢查:
- 以最小相關檢查進行驗證:編譯/測試觸及的後端模組、對觸及的前端套件進行型別檢查/Lint,並審查生成的 SQL 以確保權限和編碼正確。
全域規則
- 保持檔案為 UTF-8 編碼。技能/參考檔案和新專案檔案偏好使用 LF 換行。
- 任何資料庫變更都必須以 SQL 表達(結構和資料)。
- 前端只能呼叫後端 API。不允許瀏覽器、應用程式或大螢幕頁面直接連線資料庫、Redis 或訊息佇列。
- 除非現有的 ruoyi/Yudao 模組、框架輔助函式或平台功能不足以滿足需求,否則不要新增依賴項。
- 僅在無法安全推斷模組、入口、權限、資料所有權或報表語義時,才提出有針對性的問題。