头脑风暴框架
本项目技术约束（方案边界）
已集成技术
层面 技术 说明
框架 Spring Boot 3.5.9 核心框架
ORM MyBatis-Plus 3.5.16 数据持久层
缓存 Redis + Redisson（Caffeine 本地缓存） 分布式+本地缓存
消息 Redis Streams 轻量消息队列
定时 SnailJob + @Scheduled 分布式定时任务
认证 Sa-Token 1.44.0 权限与认证
实时 WebSocket + SSE 实时推送
存储 AWS S3 SDK MinIO 兼容
加密 AES/RSA 字段级加密
短信 SMS4j 多平台短信
邮件 Spring Mail 邮件发送
登录 JustAuth OAuth2（30+ 平台）
Excel FastExcel 导入导出
需自行扩展的技术
技术 场景
RocketMQ 高吞吐消息队列、分布式事务
MQTT IoT 设备通信（mica-mqtt）
LangChain4j AI 大模型集成
支付模块 微信/支付宝（IJPay 等）
可复用 Common 模块（24个）
核心: core, web, security, log, doc, bom 数据: mybatis, redis, json, encrypt, sensitive, oss, excel 认证: satoken, tenant, social 通信: mail, sms, websocket, sse 业务: job(SnailJob), idempotent, ratelimiter, translation
决策维度（必须考虑）
维度 关键问题 实现要点
三层架构 如何分层？ Controller -> Service -> Mapper（无 DAO 层）
模块归属 属于哪个模块？ sys/demo/wf（标准）或 b/m/iot/crm（业务）
多租户 需要隔离？ Entity 继承 TenantEntity，自动 SQL 过滤
多端 哪些端需要？ 同一套 API，按需扩展前端
多数据库 要兼容多库？ SQL 脚本同步 MySQL/Oracle/PG/SQLServer
方案评估矩阵
| 方案 | 复用度(25%) | 多端(20%) | 多租户(20%) | 多数据库(15%) | 开发量(20%) | 总分 |
|---|---|---|---|---|---|---|
| 方案A | ? | ? | ? | ? | ? | ? |
| 方案B | ? | ? | ? | ? | ? | ? |
评分说明：1-10分，分数越高越好
- 开发量：分数越高=工作量越少
方案探索模板
问题定义
- 是什么: [功能描述]
- 模块归属: base / mall / crm / iot / 新模块
- 端支持: PC端 / 移动端 / 两者
- 租户: 需要隔离 / 系统级
- 数据库: MySQL only / 多库兼容
可复用资源盘点
| 资源 | 类型 | 复用程度 |
|---|---|---|
| ruoyi-common-xxx | 模块 | 完全/部分/参考 |
| 现有 Xxx 功能 | 代码 | 参考模式 |
方案对比（至少2个）
方案 A: 最大复用（优先考虑）
- 复用: [列出模块/代码]
- 新开发: [列出新写部分]
- 优缺点: [简述]
方案 B: 适度扩展
- 复用: [列出模块/代码]
- 新开发: [列出新写部分]
- 优缺点: [简述]
推荐方案
推荐: 方案 [X] 理由: [1-3条] 实施步骤:
- 数据库设计 -> database-ops
- 后端开发 -> crud-development
- 测试验证 风险点: [风险] -> [应对策略]
典型场景速查
新增业务管理模块
需求示例：优惠券管理
模块归属 -> mall（商城相关） 功能拆解 -> 模板管理 / 发放 / 使用 / 统计 可复用 -> Ad模块(CRUD模板) + redis(分布式锁) + SnailJob(过期作废) + 字典(类型/状态) 表设计 -> m_coupon_template, m_coupon_record
接入第三方服务
可复用 -> encrypt(密钥存储) + redis(结果缓存) + Platform(配置存储) 实现 -> 接口+实现类（策略模式支持扩展） 注意 -> 密钥加密 + @RateLimiter频率限制 + 失败降级
实时通信
WebSocket(双向,已集成) ✅ 首选 | SSE(单向推送,已集成) | 轮询(不推荐) 消息类型 -> 广播(全连接) / 点对点(特定用户) / 组播(群组) / 主题订阅 可复用 -> websocket模块 + redis(在线状态/多实例同步)
数据统计报表
方案选择 -> 小数据(<100万):实时查询 | 中数据:预计算+缓存(推荐) | 大数据:分析引擎 可复用 -> FastExcel(导出) + SnailJob(预计算) + redis(结果缓存)
AI 功能集成
需自行引入 LangChain4j Maven 依赖 可复用 -> SSE(流式响应) + redis(会话上下文) 模型推荐 -> DeepSeek(国产便宜) / ChatGPT / Claude 需开发 -> ChatSession表 + ChatMessage表 + AiService + 模型配置
常见问题快速决策
问题 推荐 原因
新功能放哪个模块？ 看业务相关性 base=基础、mall=商城、crm=客户、iot=设备
WebSocket vs SSE？ WebSocket 双向通信、已有封装
RocketMQ vs Redis？ Redis 优先 Streams 简单场景够用
要支持多数据库？ 是 项目标准，SQL 脚本同步 4 库
要支持多租户？ 业务数据要 TenantEntity 自动隔离
定时任务用什么？ 简单->@Scheduled，复杂->SnailJob 按复杂度选
文件上传？ AWS S3 SDK 已集成、MinIO 兼容
敏感数据？ @EncryptField ruoyi-common-encrypt
防重复提交？ @RepeatSubmit ruoyi-common-idempotent
接口限流？ @RateLimiter ruoyi-common-ratelimiter
分布式锁？ Redisson 已集成
Skill 联动路径
brainstorm（本 Skill） |-- 需要建表 -> database-ops |-- 需要后端开发 -> crud-development |-- 需要定时任务 -> scheduled-jobs |-- 需要安全认证 -> security-guard |-- 需要数据权限 -> data-permission |-- 需要异常处理 -> error-handler |-- 需要技术对比 -> tech-decision |-- 需要代码规范 -> code-patterns
头脑风暴结论 下一步 Skill 触发方式
需要新建业务模块 crud-development "帮我开发 xxx 模块"
需要数据库设计 database-ops "帮我设计 xxx 表"
需要安全认证 security-guard "怎么控制权限访问"
需要技术对比 tech-decision "Redis 还是本地缓存好"