datai/docs/decisions/template.md

82 lines
1.3 KiB
Markdown
Raw Normal View History

feat: 实现动态数据源延迟加载功能 (2026-01-21-001) ## 功能概述 - 实现动态数据源的延迟加载机制,支持应用启动时只加载主库,从库按需动态加载和切换 - 从库配置存储在主库中,支持运行时灵活切换从库库名 - 使用现有的 @DataSource 注解进行数据源切换,业务代码无需修改 ## 新增功能 - 动态数据源管理接口 IDynamicDataSourceManager - 动态数据源服务接口 IDynamicDataSourceService - 动态数据源服务实现 DynamicDataSourceServiceImpl - 数据源管理控制器 DatasourceController - 数据源配置表 sys_datasource_config ## 新增文档 - 需求文档: docs/requirements/2026-01-21-001-动态数据源延迟加载.md - 设计文档: docs/design/2026-01-21-001-动态数据源延迟加载设计.md - 决策记录: docs/decisions/2026-01-21-001-ADR-动态数据源延迟加载.md - SQL 脚本: docs/sql/2026-01-21-001-sys_datasource_config.sql - 提示词: docs/prompts/2026-01-21-001-动态数据源延迟加载代码生成提示词.md - 会话记录: docs/sessions/2026-01-21-001-session.md - 变更日志: docs/changelog/2026-01-21-001-changelog.md - 复盘文档: docs/retros/2026-01-21-001-retro.md - API 文档: docs/api-docs/2026-01-21-001-api.md - 根目录变更日志: CHANGELOG.md ## 修改功能 - 扩展 DataSourceManager 类,添加动态数据源管理方法 - 扩展 SysDatasourceConfigMapper 接口,添加 selectSysDatasourceConfigByDsName 方法 - 更新项目索引和 Authentication.canvas ## 修复问题 - 修复循环依赖问题:创建 IDynamicDataSourceManager 接口解决 datai-system 和 datai-framework 互相依赖 - 修复导入错误:删除 DynamicDataSourceServiceImpl 中未使用的导入 - 修复异常处理:将 setFilters() 调用移到 try-catch 块内 ## API 接口 - POST /system/datasource/loadSlave - 加载从库数据源 - POST /system/datasource/switchSlave/{dbName} - 切换从库库名 - GET /system/datasource/getSlaveConfig - 获取从库配置 - POST /system/datasource/switch/{dsName} - 切换数据源 - DELETE /system/datasource/{dsName} - 移除数据源
2026-01-21 18:24:24 +08:00
# 决策记录模板
## 基本信息
- 标题ADR-XXX: [决策标题]
- 编号XXX
- 日期YYYY-MM-DD
- 状态:提议/已接受/已拒绝/已废弃
- 作者:
## 决策背景
[决策背景描述]
## 问题描述
[问题描述]
## 约束条件
[约束条件]
## 决策选项
### 选项 1[选项名称]
- **描述**
- **优点**
- 优点1
- 优点2
- **缺点**
- 缺点1
- 缺点2
### 选项 2[选项名称]
- **描述**
- **优点**
- 优点1
- 优点2
- **缺点**
- 缺点1
- 缺点2
### 选项 3[选项名称]
- **描述**
- **优点**
- 优点1
- 优点2
- **缺点**
- 缺点1
- 缺点2
## 决策结果
- **选择的选项**
- **决策理由**
- 理由1
- 理由2
## 影响评估
### 正面影响
- 影响1
- 影响2
### 负面影响
- 影响1
- 影响2
### 风险和缓解措施
| 风险 | 缓解措施 |
| ---- | ------ |
| 风险1 | 缓解措施1 |
| 风险2 | 缓解措施2 |
## 实施计划
| 步骤 | 责任人 | 截止日期 |
| ---- | ------ | -------- |
| 步骤1 | 责任人1 | YYYY-MM-DD |
| 步骤2 | 责任人2 | YYYY-MM-DD |
## 相关链接
- [相关文档链接]
- [相关 issue/PR 链接]
## 相关文档
- [需求文档](../requirements/YYYY-MM-DD-00X-需求名.md)
- [设计文档](../design/YYYY-MM-DD-00X-设计名.md)