RuoYi Cloud Plus Best Practices
Overview
Use this as the single entry skill for RuoYi-Cloud-Plus backend work. Apply it to keep architecture, base service boundaries, and code style consistent in one run.
Routing Rules
- Use DDD flow first when the task is a new domain capability, aggregate boundary change, or complex business refactor.
- Use basic-service flow first when the task is shared capability extraction or cross-service API design.
- Use code-convention flow first when the task is code review, PR cleanup, or style alignment.
- Run all three flows for medium-to-large feature delivery.
Unified Execution Flow
- Clarify scope and classify task type.
- Task type:
domain-design,base-capability,implementation, orreview. - Map impacted modules:
ruoyi-modules/*,ruoyi-api/*,ruoyi-common/*.
- Design architecture and boundaries.
- Apply DDD package and dependency constraints.
- Keep bounded context ownership clear.
- Keep cross-service contracts in
ruoyi-api.
- Place reusable capability correctly.
- Put reusable infrastructure in
ruoyi-common. - Put cross-service contracts in
ruoyi-api. - Put provider and business orchestration in
ruoyi-modules.
- Implement with project conventions.
- Keep
controller -> service -> mapperdirection. - Keep BO/VO/Entity separation and conversion strategy.
- Use required annotations for permission, logging, idempotency, transaction, and RPC.
- Run final quality checks.
- Check dependency direction and module coupling.
- Check API contract isolation from local entities.
- Check formatting and naming alignment with project conventions.
Output Contract
When using this skill, always output:
- Scope classification and impacted modules.
- Architecture and dependency decisions.
- File-level implementation plan or change list.
- Convention and risk checklist.
References
- DDD and layered design:
references/ddd.md - Foundational service split:
references/basic-service.md - Coding conventions and review checklist:
references/code-convention.md