头脑风暴框架
本项目技术约束（方案边界）
已集成技术
| 层面 |
技术 |
说明 |
| 框架 |
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 |
方案评估矩阵
|------|-------------|-----------|-------------|---------------|-------------|------|
| 方案A | ? | ? | ? | ? | ? | ? |
| 方案B | ? | ? | ? | ? | ? | ? |
评分说明：1-10分，分数越高越好
- 开发量：分数越高=工作量越少
方案探索模板
问题定义
- **是什么**: [功能描述]
- **模块归属**: base / mall / crm / iot / 新模块
- **端支持**: PC端 / 移动端 / 两者
- **租户**: 需要隔离 / 系统级
- **数据库**: MySQL only / 多库兼容
可复用资源盘点
|------|------|---------|
| ruoyi-common-xxx | 模块 | 完全/部分/参考 |
| 现有 Xxx 功能 | 代码 | 参考模式 |
方案对比（至少2个）
### 方案 A: 最大复用（优先考虑）
- **复用**: [列出模块/代码]
- **新开发**: [列出新写部分]
- **优缺点**: [简述]
### 方案 B: 适度扩展
- **复用**: [列出模块/代码]
- **新开发**: [列出新写部分]
- **优缺点**: [简述]
推荐方案
**推荐**: 方案 [X]
**理由**: [1-3条]
**实施步骤**:
1. [ ] 数据库设计 -> database-ops
2. [ ] 后端开发 -> crud-development
3. [ ] 测试验证
**风险点**: [风险] -> [应对策略]
典型场景速查
新增业务管理模块
需求示例：优惠券管理
模块归属 -> 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 还是本地缓存好" |