diff --git a/doc/salesforce/setting/DataiConfigEnvironmentController/0001-environment-list.md b/doc/salesforce/setting/DataiConfigEnvironmentController/0001-environment-list.md index 8caa941..a968477 100644 --- a/doc/salesforce/setting/DataiConfigEnvironmentController/0001-environment-list.md +++ b/doc/salesforce/setting/DataiConfigEnvironmentController/0001-environment-list.md @@ -8,11 +8,11 @@ - **模块归属**: datai-salesforce-setting - **版本号**: v1.0 - **创建日期**: 2026-01-14 -- **最后更新**: 2026-01-14 +- **最后更新**: 2026-01-24 ## 功能描述 -查询配置环境列表,支持分页查询和多条件过滤。返回的环境数据包含环境ID、环境名称、环境编码、ORG类型、环境描述、是否激活等信息,便于用户管理和切换不同环境。 +查询配置环境列表,支持分页查询和多条件过滤。返回的环境数据包含环境ID、环境名称、环境编码、ORG类型、环境描述、是否激活、是否有效等信息,便于用户管理和切换不同环境。 ## 请求参数 @@ -20,7 +20,7 @@ | 参数名 | 类型 | 必填 | 描述 | 示例 | 默认值 | |--------|------|------|------|------|--------| -| pageNum | Integer | 否 | 页码 | 1 | 1 | +| pageNum | Integer | 否 | 页码 |1 | 1 | | pageSize | Integer | 否 | 每页数量 | 10 | 10 | | deptId | Long | 否 | 部门ID | 1 | - | | environmentName | String | 否 | 环境名称 | 生产环境 | - | @@ -28,6 +28,8 @@ | orgType | String | 否 | ORG类型 | source | - | | description | String | 否 | 环境描述 | 生产环境配置 | - | | isActive | Boolean | 否 | 是否激活 | true | - | +| isValid | Boolean | 否 | 是否有效 | true | - | +| datasourceId | Long | 否 | 数据源ID | 1 | - | | remark | String | 否 | 备注 | - | - | | createBy | String | 否 | 创建人 | admin | - | | createTime | Date | 否 | 创建时间 | 2026-01-01 00:00:00 | - | @@ -96,6 +98,8 @@ | orgType | String | ORG类型(source/target) | source | | description | String | 环境描述 | 生产环境配置 | | isActive | Boolean | 是否激活 | true | +| isValid | Boolean | 是否有效 | true | +| datasourceId | Long | 数据源ID | 1 | | remark | String | 备注 | 源ORG生产环境 | | createBy | String | 创建人 | admin | | createTime | String | 创建时间 | 2026-01-01 10:00:00 | diff --git a/doc/salesforce/setting/DataiConfigEnvironmentController/0003-get-info.md b/doc/salesforce/setting/DataiConfigEnvironmentController/0003-get-info.md index c907ec8..1c24007 100644 --- a/doc/salesforce/setting/DataiConfigEnvironmentController/0003-get-info.md +++ b/doc/salesforce/setting/DataiConfigEnvironmentController/0003-get-info.md @@ -8,11 +8,11 @@ - **模块归属**: datai-salesforce-setting - **版本号**: v1.0 - **创建日期**: 2026-01-14 -- **最后更新**: 2026-01-14 +- **最后更新**: 2026-01-24 ## 功能描述 -根据环境ID获取配置环境的详细信息,包括环境ID、环境名称、环境编码、ORG类型、环境描述、是否激活等完整信息,用于查看或编辑环境配置。 +根据环境ID获取配置环境的详细信息,包括环境ID、环境名称、环境编码、ORG类型、环境描述、是否激活、是否有效等完整信息,用于查看或编辑环境配置。 ## 请求参数 @@ -66,6 +66,8 @@ | orgType | String | ORG类型(source/target) | source | | description | String | 环境描述 | 生产环境配置 | | isActive | Boolean | 是否激活 | true | +| isValid | Boolean | 是否有效 | true | +| datasourceId | Long | 数据源ID | 1 | | remark | String | 备注 | 源ORG生产环境 | | createBy | String | 创建人 | admin | | createTime | String | 创建时间 | 2026-01-01 10:00:00 | diff --git a/doc/salesforce/setting/DataiConfigEnvironmentController/0004-add-environment.md b/doc/salesforce/setting/DataiConfigEnvironmentController/0004-add-environment.md index 2b182e1..f994541 100644 --- a/doc/salesforce/setting/DataiConfigEnvironmentController/0004-add-environment.md +++ b/doc/salesforce/setting/DataiConfigEnvironmentController/0004-add-environment.md @@ -8,7 +8,7 @@ - **模块归属**: datai-salesforce-setting - **版本号**: v1.0 - **创建日期**: 2026-01-14 -- **最后更新**: 2026-01-14 +- **最后更新**: 2026-01-24 ## 功能描述 diff --git a/doc/salesforce/setting/DataiConfigEnvironmentController/0005-edit-environment.md b/doc/salesforce/setting/DataiConfigEnvironmentController/0005-edit-environment.md index d89526e..9f3fb50 100644 --- a/doc/salesforce/setting/DataiConfigEnvironmentController/0005-edit-environment.md +++ b/doc/salesforce/setting/DataiConfigEnvironmentController/0005-edit-environment.md @@ -8,7 +8,7 @@ - **模块归属**: datai-salesforce-setting - **版本号**: v1.0 - **创建日期**: 2026-01-14 -- **最后更新**: 2026-01-14 +- **最后更新**: 2026-01-24 ## 功能描述 diff --git a/doc/salesforce/setting/DataiConfigEnvironmentController/0009-init-slave-datasource.md b/doc/salesforce/setting/DataiConfigEnvironmentController/0009-init-slave-datasource.md new file mode 100644 index 0000000..2f1dc92 --- /dev/null +++ b/doc/salesforce/setting/DataiConfigEnvironmentController/0009-init-slave-datasource.md @@ -0,0 +1,212 @@ +# 接口文档 + +## 接口信息 + +- **接口名称**: 初始化环境从库 +- **接口路径**: /setting/environment/initSlave +- **请求方法**: POST +- **模块归属**: datai-salesforce-setting +- **版本号**: v1.0 +- **创建日期**: 2026-01-24 +- **最后更新**: 2026-01-24 + +## 功能描述 + +为指定的环境初始化从库数据源。该接口会从配置文件读取主库配置,自动生成从库名称(slave_环境编码),创建数据库,写入数据源配置表,注册数据源到 DataSourceManager,并验证连接有效性。从库一经创建,不允许任何修改、删除或重新初始化。 + +## 请求参数 + +### 请求参数 + +| 参数名 | 类型 | 必填 | 描述 | 示例 | 默认值 | +|--------|------|------|------|------|--------| +| environmentId | Long | 是 | 环境ID | 1 | - | + +**参数说明**: +- `environmentId`: 要初始化从库的环境ID,必须是已存在的环境 + +## 响应数据 + +### 成功响应 + +**HTTP 状态码**: 200 OK + +```json +{ + "code": 200, + "msg": "操作成功", + "data": { + "id": 1, + "dsName": "PROD", + "dbName": "slave_PROD", + "dbHost": "localhost", + "dbPort": 3306, + "dbType": "mysql", + "username": "root", + "password": "******", + "status": "0", + "createBy": "admin", + "createTime": "2026-01-24 10:00:00", + "updateBy": "admin", + "updateTime": "2026-01-24 10:00:00" + } +} +``` + +| 字段名 | 类型 | 描述 | 示例 | +|--------|------|------|------| +| code | Integer | 响应码 | 200 | +| msg | String | 响应消息 | 操作成功 | +| data | Object | 创建的数据源配置详细信息 | - | + +**data 对象字段说明**: + +| 字段名 | 类型 | 描述 | 示例 | +|--------|------|------|------| +| id | Long | 数据源ID | 1 | +| dsName | String | 数据源名称(环境编码) | PROD | +| dbName | String | 数据库名称 | slave_PROD | +| dbHost | String | 数据库主机地址 | localhost | +| dbPort | Integer | 数据库端口 | 3306 | +| dbType | String | 数据库类型 | mysql | +| username | String | 数据库用户名 | root | +| password | String | 数据库密码(加密) | ****** | +| status | String | 状态(0-正常,1-停用) | 0 | +| createBy | String | 创建人 | admin | +| createTime | String | 创建时间 | 2026-01-24 10:00:00 | +| updateBy | String | 更新人 | admin | +| updateTime | String | 更新时间 | 2026-01-24 10:00:00 | + +### 失败响应 + +**HTTP 状态码**: 400/401/403/500 + +```json +{ + "code": 500, + "msg": "数据源名称已存在:PROD", + "data": null +} +``` + +| 错误码 | 错误信息 | 描述 | +|--------|----------|------| +| 400 | 参数错误 | 参数验证失败 | +| 401 | 您没有权限执行此操作 | 权限不足 | +| 403 | 访问被拒绝 | 访问被拒绝 | +| 500 | 数据源名称已存在:{环境编码} | 数据源已存在 | +| 500 | 主库配置不存在 | 主库配置不存在 | +| 500 | 数据库操作失败:{错误信息} | 数据库操作失败 | +| 500 | 数据源配置写入失败 | 数据源配置写入失败 | +| 500 | 数据源连接验证失败 | 数据源连接验证失败 | + +## 接口示例 + +### 请求示例 + +```bash +curl -X POST "http://localhost:8080/setting/environment/initSlave" \ + -H "Authorization: Bearer [token]" \ + -H "Content-Type: application/x-www-form-urlencoded" \ + -d "environmentId=1" +``` + +### 响应示例 + +**成功**: + +```json +{ + "code": 200, + "msg": "操作成功", + "data": { + "id": 1, + "dsName": "PROD", + "dbName": "slave_PROD", + "dbHost": "localhost", + "dbPort": 3306, + "dbType": "mysql", + "username": "root", + "password": "******", + "status": "0" + } +} +``` + +**失败**: + +```json +{ + "code": 500, + "msg": "数据源名称已存在:PROD", + "data": null +} +``` + +## 错误处理 + +1. **权限验证失败**: 检查用户是否具有 setting:environment:initSlave 权限 +2. **参数验证失败**: 检查必填参数是否完整,参数格式是否正确 +3. **主库配置不存在**: 检查 application-druid.yml 中是否配置了主库信息 +4. **数据源已存在**: 检查数据源名称是否已存在,如已存在则返回错误 +5. **数据库创建失败**: 检查数据库连接和权限,记录错误日志并返回错误信息 +6. **数据源配置写入失败**: 检查数据库连接和权限,记录错误日志并返回错误信息 +7. **数据源连接验证失败**: 检查数据源配置和连接,记录错误日志并返回错误信息 +8. **系统错误**: 记录错误日志并返回通用错误信息 + +## 注意事项 + +1. 接口需要登录认证,需要携带有效的 token +2. 接口需要 setting:environment:initSlave 权限 +3. 环境编码为必填项 +4. 从库名称自动生成为 slave_环境编码 +5. 数据库字符集为 utf8mb4,排序规则为 utf8mb4_general_ci +6. 从库一经创建,不允许任何修改、删除或重新初始化 +7. 使用 Spring 事务保证原子性,验证失败时自动回滚 +8. 初始化操作会记录到操作日志中 +9. 初始化成功后会返回创建的数据源配置信息 +10. 主库配置从 application-druid.yml 配置文件中读取 +11. 初始化过程包括:创建数据库、写入配置、注册数据源、切换到从库、验证连接、切换回主库 +12. 建议在初始化前先查询确认环境信息 + +## 相关接口 + +- [查询配置环境列表](0001-environment-list.md) - 查询配置环境列表 +- [获取配置环境详细信息](0003-get-info.md) - 获取单个环境的详细信息 +- [切换当前环境](0007-switch-environment.md) - 切换当前环境 +- [获取当前激活的环境](0008-get-current-environment.md) - 获取当前激活的环境 + +## 实现细节 + +1. 接收环境ID参数 +2. 根据环境ID查询环境信息 +3. 从环境信息中获取环境编码 +4. 调用 IDataiConfigEnvironmentService 的 initSlaveDatasource 方法 +5. 从 application-druid.yml 配置文件中读取主库配置 +6. 生成从库名称(slave_环境编码) +7. 检查数据源名称是否已存在 +8. 使用 JDBC 创建数据库(字符集:utf8mb4,排序规则:utf8mb4_general_ci) +9. 写入数据源配置表 +10. 注册数据源到 DataSourceManager +11. 切换到从库并验证连接有效性 +12. 切换回主库 +13. 使用 Spring 事务保证原子性,验证失败时自动回滚 +14. 返回创建的数据源配置信息 + +## 测试信息 + +### 测试环境 + +- **环境**: 本地开发环境 +- **版本**: v1.0 + +### 测试用例 + +| 测试场景 | 输入参数 | 预期结果 | 实际结果 | 状态 | +|----------|----------|----------|----------|------| +| 初始化生产环境从库 | environmentId=1 | 初始化成功 | 初始化成功 | 通过 | +| 初始化测试环境从库 | environmentId=2 | 初始化成功 | 初始化成功 | 通过 | +| 初始化已存在的从库 | environmentId=1(已存在) | 返回数据源已存在 | 返回数据源已存在 | 通过 | +| 初始化不存在的环境 | environmentId=999 | 返回错误 | 返回错误 | 通过 | +| 缺少必填参数 | 缺少environmentId | 返回参数错误 | 返回参数错误 | 通过 | +| 无权限访问 | 无权限token | 返回401错误 | 返回401错误 | 通过 | diff --git a/src/api/setting/environment.js b/src/api/setting/environment.js index 2843624..9ae5811 100644 --- a/src/api/setting/environment.js +++ b/src/api/setting/environment.js @@ -38,11 +38,11 @@ export function delEnvironment(id) { }) } -export function switchEnvironment(data) { +export function switchEnvironment(params) { return request({ url: '/setting/environment/switch', method: 'post', - data: data + params: params }) } @@ -53,3 +53,11 @@ export function getCurrentEnvironment(orgType) { params: { orgType } }) } + +export function initSlaveDatasource(environmentId) { + return request({ + url: '/setting/environment/initSlave', + method: 'post', + params: { environmentId } + }) +} diff --git a/src/api/system/datasourceConfig.js b/src/api/system/datasourceConfig.js new file mode 100644 index 0000000..7e6ae69 --- /dev/null +++ b/src/api/system/datasourceConfig.js @@ -0,0 +1,44 @@ +import request from '@/utils/request' + +// 查询数据源管理列表 +export function listDatasourceConfig(query) { + return request({ + url: '/system/datasourceConfig/list', + method: 'get', + params: query + }) +} + +// 查询数据源管理详细 +export function getDatasourceConfig(id) { + return request({ + url: '/system/datasourceConfig/' + id, + method: 'get' + }) +} + +// 新增数据源管理 +export function addDatasourceConfig(data) { + return request({ + url: '/system/datasourceConfig', + method: 'post', + data: data + }) +} + +// 修改数据源管理 +export function updateDatasourceConfig(data) { + return request({ + url: '/system/datasourceConfig', + method: 'put', + data: data + }) +} + +// 删除数据源管理 +export function delDatasourceConfig(id) { + return request({ + url: '/system/datasourceConfig/' + id, + method: 'delete' + }) +} diff --git a/src/api/system/exchangerate.js b/src/api/system/exchangerate.js new file mode 100644 index 0000000..5e87f5c --- /dev/null +++ b/src/api/system/exchangerate.js @@ -0,0 +1,44 @@ +import request from '@/utils/request' + +// 查询汇率管理列表 +export function listExchangerate(query) { + return request({ + url: '/system/exchangerate/list', + method: 'get', + params: query + }) +} + +// 查询汇率管理详细 +export function getExchangerate(id) { + return request({ + url: '/system/exchangerate/' + id, + method: 'get' + }) +} + +// 新增汇率管理 +export function addExchangerate(data) { + return request({ + url: '/system/exchangerate', + method: 'post', + data: data + }) +} + +// 修改汇率管理 +export function updateExchangerate(data) { + return request({ + url: '/system/exchangerate', + method: 'put', + data: data + }) +} + +// 删除汇率管理 +export function delExchangerate(id) { + return request({ + url: '/system/exchangerate/' + id, + method: 'delete' + }) +} diff --git a/src/views/setting/center/components/SourceEnvironmentTab.vue b/src/views/setting/center/components/SourceEnvironmentTab.vue index 39c2833..3798068 100644 --- a/src/views/setting/center/components/SourceEnvironmentTab.vue +++ b/src/views/setting/center/components/SourceEnvironmentTab.vue @@ -4,7 +4,10 @@ @@ -24,39 +27,107 @@ {{ currentEnvironment.isActive ? '是' : '否' }} + + + {{ currentEnvironment.isValid ? '是' : '否' }} + + + + {{ currentEnvironment.datasourceId }} + + + {{ currentEnvironment.remark }} + + + {{ currentEnvironment.createBy }} + {{ parseTime(currentEnvironment.createTime) }} + + {{ currentEnvironment.updateBy }} + + + {{ parseTime(currentEnvironment.updateTime) }} + - + + + + + + + + + + + + + + + + + + + + + + + + 搜索 + 重置 + + + - - - - + + + + + + + + + + - + + + + +