datai/docs/decisions/template.md
Kris b7163d555b 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

82 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 决策记录模板
## 基本信息
- 标题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)