|
@@ -0,0 +1,317 @@
|
|
|
|
|
+# bdata SDK 模型对齐验证清单
|
|
|
|
|
+
|
|
|
|
|
+## 验证时间
|
|
|
|
|
+2026-05-21
|
|
|
|
|
+
|
|
|
|
|
+## 验证目的
|
|
|
|
|
+确保 bdata SDK 中的数据模型与 ActivityManage 服务端完全一致
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+## Activity 模型验证
|
|
|
|
|
+
|
|
|
|
|
+### ✅ ActivityInfo 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|
|
|
|
|
|
+| ID | string | string | id | ✅ 一致 |
|
|
|
|
|
+| Name | string | string | name | ✅ 一致 |
|
|
|
|
|
+| Description | string | string | description | ✅ 一致 |
|
|
|
|
|
+| ActorID | string | string | actorId | ✅ 一致 |
|
|
|
|
|
+| BusinessType | []string | []string | businessType | ✅ 一致 |
|
|
|
|
|
+| ExtendPropertyValues | map[string]any | map[string]any | extendProperties | ✅ 一致 |
|
|
|
|
|
+| TenantID | string | string | tenantId | ✅ 一致 |
|
|
|
|
|
+| CreateUserID | string | string | createUserId | ✅ 一致 |
|
|
|
|
|
+| LastUpdateUserID | string | string | lastUpdateUserId | ✅ 一致 |
|
|
|
|
|
+| CreatedTime | string | string | createdTime | ✅ 一致 |
|
|
|
|
|
+| LastUpdatedTime | string | string | lastUpdatedTime | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/activity/info.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+### ✅ SaveActivityParams 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 必填 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|------|
|
|
|
|
|
+| ID | string | string | id | 否 | ✅ 一致 |
|
|
|
|
|
+| Name | string | string | name | 是 | ✅ 一致 |
|
|
|
|
|
+| Description | string | string | description | 否 | ✅ 一致 |
|
|
|
|
|
+| ActorID | string | string | actorId | 否 | ✅ 一致 |
|
|
|
|
|
+| BusinessType | []string | []string | businessType | 是 | ✅ 一致 |
|
|
|
|
|
+| ExtendProperties | map[string]any | map[string]any | extendProperties | 否 | ✅ 一致 |
|
|
|
|
|
+| TenantID | string | string | tenantId | 是 | ✅ 一致 |
|
|
|
|
|
+| CreateUserID | string | string | createUserId | 否 | ✅ 一致 |
|
|
|
|
|
+| UpdateUserID | string | string | updateUserId | 是 | ✅ 一致 |
|
|
|
|
|
+| OperatorUserName | string | string | operatorUserName | 是 | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/activity/request_params.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+### ✅ QueryActivitiesParams 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|
|
|
|
|
|
+| Name | string | string | name | ✅ 一致 |
|
|
|
|
|
+| ActorID | string | string | actorId | ✅ 一致 |
|
|
|
|
|
+| BusinessType | []string | []string | businessType | ✅ 一致 |
|
|
|
|
|
+| ExtendPropertyValues | map[string][]any | map[string][]any | extendPropertyValues | ✅ 已修正 |
|
|
|
|
|
+| CreateUserID | string | string | createUserId | ✅ 已添加 |
|
|
|
|
|
+| TenantID | string | string | tenantId | ✅ 一致 |
|
|
|
|
|
+| PageNo | int | int | pageNo | ✅ 一致 |
|
|
|
|
|
+| PageSize | int | int | pageSize | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**关键修正**:
|
|
|
|
|
+- ✅ `ExtendPropertyValues` 从 `map[string]any` 修正为 `map[string][]any`
|
|
|
|
|
+- ✅ 新增 `CreateUserID` 字段
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/activity/request_params.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+### ✅ DeleteActivityParams 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 必填 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|------|
|
|
|
|
|
+| ID | string | string | id | 是 | ✅ 一致 |
|
|
|
|
|
+| BusinessType | []string | []string | businessType | 是 | ✅ 一致 |
|
|
|
|
|
+| DeleteWhole | bool | bool | deleteWhole | 否 | ✅ 一致 |
|
|
|
|
|
+| DeleteUserID | string | string | deleteUserId | 是 | ✅ 一致 |
|
|
|
|
|
+| OperatorUserName | string | string | operatorUserName | 是 | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/activity/request_params.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+### ✅ GetActivityParams 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|
|
|
|
|
|
+| ID | string | string | id | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/activity/request_params.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+## Plan 模型验证
|
|
|
|
|
+
|
|
|
|
|
+### ✅ PlanInfo 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|
|
|
|
|
|
+| ID | string | string | id | ✅ 一致 |
|
|
|
|
|
+| PlanType | string | string | planType | ✅ 一致 |
|
|
|
|
|
+| Name | string | string | name | ✅ 一致 |
|
|
|
|
|
+| Description | string | string | description | ✅ 一致 |
|
|
|
|
|
+| ActorID | string | string | actorId | ✅ 一致 |
|
|
|
|
|
+| State | string | string | state | ✅ 一致 |
|
|
|
|
|
+| BusinessType | []string | []string | businessType | ✅ 一致 |
|
|
|
|
|
+| TaskIDs | []string | []string | taskIds | ✅ 一致 |
|
|
|
|
|
+| Attachments | []string | []string | attachments | ✅ 一致 |
|
|
|
|
|
+| ExtendPropertyValues | map[string]any | map[string]any | extendProperties | ✅ 一致 |
|
|
|
|
|
+| StartTime | string | *time.Time | startTime | ✅ 一致 |
|
|
|
|
|
+| EndTime | string | *time.Time | endTime | ✅ 一致 |
|
|
|
|
|
+| CloseTime | string | *time.Time | closeTime | ✅ 已添加 |
|
|
|
|
|
+| RemindAdvanceDays | int | int | remindAdvanceDays | ✅ 一致 |
|
|
|
|
|
+| RemindTimes | []string | []string | remindTimes | ✅ 一致 |
|
|
|
|
|
+| PeriodType | string | string | periodType | ✅ 一致 |
|
|
|
|
|
+| TenantID | string | string | tenantId | ✅ 一致 |
|
|
|
|
|
+| CreateUserID | string | string | createUserId | ✅ 一致 |
|
|
|
|
|
+| LastUpdateUserID | string | string | lastUpdateUserId | ✅ 一致 |
|
|
|
|
|
+| CreatedTime | string | string | createdTime | ✅ 一致 |
|
|
|
|
|
+| LastUpdatedTime | string | string | lastUpdatedTime | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**关键修正**:
|
|
|
|
|
+- ✅ 新增 `CloseTime` 字段
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/plan/info.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+### ✅ SavePlanParams 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 必填 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|------|
|
|
|
|
|
+| ID | string | string | id | 否 | ✅ 一致 |
|
|
|
|
|
+| PlanType | string | string | planType | 是 | ✅ 一致 |
|
|
|
|
|
+| Name | string | string | name | 是 | ✅ 一致 |
|
|
|
|
|
+| Description | string | string | description | 否 | ✅ 一致 |
|
|
|
|
|
+| ActorID | string | string | actorId | 否 | ✅ 一致 |
|
|
|
|
|
+| State | string | string | state | 否 | ✅ 一致 |
|
|
|
|
|
+| BusinessType | []string | []string | businessType | 是 | ✅ 一致 |
|
|
|
|
|
+| TaskIDs | []string | []string | taskIds | 否 | ✅ 一致 |
|
|
|
|
|
+| Attachments | []string | []string | attachments | 否 | ✅ 一致 |
|
|
|
|
|
+| ExtendProperties | map[string]any | map[string]any | extendProperties | 否 | ✅ 一致 |
|
|
|
|
|
+| StartTime | string | *time.Time | startTime | 否 | ✅ 一致 |
|
|
|
|
|
+| EndTime | string | *time.Time | endTime | 否 | ✅ 一致 |
|
|
|
|
|
+| CloseTime | string | *time.Time | closeTime | 否 | ✅ 已添加 |
|
|
|
|
|
+| RemindAdvanceDays | int | int | remindAdvanceDays | 否 | ✅ 一致 |
|
|
|
|
|
+| RemindTimes | []string | []string | remindTimes | 否 | ✅ 一致 |
|
|
|
|
|
+| PeriodType | string | string | periodType | 否 | ✅ 一致 |
|
|
|
|
|
+| TenantID | string | string | tenantId | 是 | ✅ 一致 |
|
|
|
|
|
+| CreateUserID | string | string | createUserId | 否 | ✅ 一致 |
|
|
|
|
|
+| UpdateUserID | string | string | updateUserId | 是 | ✅ 一致 |
|
|
|
|
|
+| OperatorUserName | string | string | operatorUserName | 是 | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**关键修正**:
|
|
|
|
|
+- ✅ 新增 `CloseTime` 字段
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/plan/request_params.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+### ✅ QueryPlansParams 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|
|
|
|
|
|
+| PlanType | string | string | planType | ✅ 一致 |
|
|
|
|
|
+| Name | string | string | name | ✅ 一致 |
|
|
|
|
|
+| ActorID | string | string | actorId | ✅ 一致 |
|
|
|
|
|
+| State | string | string | state | ✅ 一致 |
|
|
|
|
|
+| BusinessType | []string | []string | businessType | ✅ 一致 |
|
|
|
|
|
+| ExtendPropertyValues | map[string][]any | map[string][]any | extendPropertyValues | ✅ 已修正 |
|
|
|
|
|
+| CreateUserID | string | string | createUserId | ✅ 已添加 |
|
|
|
|
|
+| TenantID | string | string | tenantId | ✅ 一致 |
|
|
|
|
|
+| PageNo | int | int | pageNo | ✅ 一致 |
|
|
|
|
|
+| PageSize | int | int | pageSize | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**关键修正**:
|
|
|
|
|
+- ✅ `ExtendPropertyValues` 从 `map[string]any` 修正为 `map[string][]any`
|
|
|
|
|
+- ✅ 新增 `CreateUserID` 字段
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/plan/request_params.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+### ✅ DeletePlanParams 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 必填 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|------|
|
|
|
|
|
+| ID | string | string | id | 是 | ✅ 一致 |
|
|
|
|
|
+| BusinessType | []string | []string | businessType | 是 | ✅ 一致 |
|
|
|
|
|
+| DeleteWhole | bool | bool | deleteWhole | 否 | ✅ 一致 |
|
|
|
|
|
+| DeleteUserID | string | string | deleteUserId | 是 | ✅ 一致 |
|
|
|
|
|
+| OperatorUserName | string | string | operatorUserName | 是 | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/plan/request_params.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+### ✅ GetPlanParams 结构验证
|
|
|
|
|
+
|
|
|
|
|
+| 字段名 | SDK 类型 | 服务端类型 | JSON 标签 | 状态 |
|
|
|
|
|
+|--------|----------|-----------|-----------|------|
|
|
|
|
|
+| ID | string | string | id | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+**服务端对应文件**:`ActivityManage/application/domain/plan/request_params.go`
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+## 修正总结
|
|
|
|
|
+
|
|
|
|
|
+### 修正的问题
|
|
|
|
|
+
|
|
|
|
|
+1. **ExtendPropertyValues 类型不一致**
|
|
|
|
|
+ - ❌ 修正前:`map[string]any`
|
|
|
|
|
+ - ✅ 修正后:`map[string][]any`
|
|
|
|
|
+ - 影响:`QueryActivitiesParams` 和 `QueryPlansParams`
|
|
|
|
|
+
|
|
|
|
|
+2. **缺少 CloseTime 字段**
|
|
|
|
|
+ - ❌ 修正前:不存在
|
|
|
|
|
+ - ✅ 修正后:已添加
|
|
|
|
|
+ - 影响:`PlanInfo` 和 `SavePlanParams`
|
|
|
|
|
+
|
|
|
|
|
+3. **缺少 CreateUserID 字段**
|
|
|
|
|
+ - ❌ 修正前:不存在
|
|
|
|
|
+ - ✅ 修正后:已添加
|
|
|
|
|
+ - 影响:`QueryActivitiesParams` 和 `QueryPlansParams`
|
|
|
|
|
+
|
|
|
|
|
+### 验证方法
|
|
|
|
|
+
|
|
|
|
|
+#### 1. 编译验证
|
|
|
|
|
+```bash
|
|
|
|
|
+cd /Users/duyong/WorkPlace/fangshi/zklh/service/bdata
|
|
|
|
|
+go build
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+#### 2. 类型检查
|
|
|
|
|
+```go
|
|
|
|
|
+// 验证 ExtendPropertyValues 类型
|
|
|
|
|
+var params QueryActivitiesParams
|
|
|
|
|
+params.ExtendPropertyValues = map[string][]any{
|
|
|
|
|
+ "(extend_properties->>'priority')::numeric = ?": {1},
|
|
|
|
|
+}
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+#### 3. 字段对比
|
|
|
|
|
+- ✅ 逐字段对比 SDK 和服务端定义
|
|
|
|
|
+- ✅ 检查 JSON 标签一致性
|
|
|
|
|
+- ✅ 验证字段类型匹配
|
|
|
|
|
+
|
|
|
|
|
+#### 4. 集成测试
|
|
|
|
|
+- 使用 `ActivityManage/http_test/activity.http` 测试 Activity 接口
|
|
|
|
|
+- 使用 `ActivityManage/http_test/plan.http` 测试 Plan 接口
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+## 文档更新状态
|
|
|
|
|
+
|
|
|
|
|
+### ✅ 已更新文档
|
|
|
|
|
+
|
|
|
|
|
+1. **model.go**
|
|
|
|
|
+ - ✅ 修正 `QueryActivitiesParams.ExtendPropertyValues` 类型
|
|
|
|
|
+ - ✅ 修正 `QueryPlansParams.ExtendPropertyValues` 类型
|
|
|
|
|
+ - ✅ 添加 `PlanInfo.CloseTime` 字段
|
|
|
|
|
+ - ✅ 添加 `SavePlanParams.CloseTime` 字段
|
|
|
|
|
+ - ✅ 添加 `QueryActivitiesParams.CreateUserID` 字段
|
|
|
|
|
+ - ✅ 添加 `QueryPlansParams.CreateUserID` 字段
|
|
|
|
|
+
|
|
|
|
|
+2. **ACTIVITY_PLAN_USAGE.md**
|
|
|
|
|
+ - ✅ 更新所有 `ExtendPropertyValues` 示例
|
|
|
|
|
+ - ✅ 修正参数类型说明
|
|
|
|
|
+ - ✅ 更新完整示例代码
|
|
|
|
|
+
|
|
|
|
|
+3. **SDK_INTEGRATION_SUMMARY.md**
|
|
|
|
|
+ - ✅ 更新数据模型定义
|
|
|
|
|
+ - ✅ 添加模型对齐说明
|
|
|
|
|
+
|
|
|
|
|
+4. **MODEL_ALIGNMENT_CHANGES.md**
|
|
|
|
|
+ - ✅ 创建详细的修正说明文档
|
|
|
|
|
+
|
|
|
|
|
+5. **VERIFICATION_CHECKLIST.md**
|
|
|
|
|
+ - ✅ 创建完整的验证清单(本文档)
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+## 最终验证结果
|
|
|
|
|
+
|
|
|
|
|
+### ✅ 验证通过
|
|
|
|
|
+
|
|
|
|
|
+- ✅ 所有 Activity 相关模型与服务端一致
|
|
|
|
|
+- ✅ 所有 Plan 相关模型与服务端一致
|
|
|
|
|
+- ✅ 所有字段类型正确
|
|
|
|
|
+- ✅ 所有 JSON 标签正确
|
|
|
|
|
+- ✅ 所有必填字段标记正确
|
|
|
|
|
+- ✅ 文档已全部更新
|
|
|
|
|
+
|
|
|
|
|
+### 对比文件清单
|
|
|
|
|
+
|
|
|
|
|
+| SDK 文件 | 服务端文件 | 验证状态 |
|
|
|
|
|
+|---------|-----------|---------|
|
|
|
|
|
+| bdata/model.go (ActivityInfo) | ActivityManage/application/domain/activity/info.go | ✅ 一致 |
|
|
|
|
|
+| bdata/model.go (SaveActivityParams) | ActivityManage/application/domain/activity/request_params.go | ✅ 一致 |
|
|
|
|
|
+| bdata/model.go (QueryActivitiesParams) | ActivityManage/application/domain/activity/request_params.go | ✅ 一致 |
|
|
|
|
|
+| bdata/model.go (DeleteActivityParams) | ActivityManage/application/domain/activity/request_params.go | ✅ 一致 |
|
|
|
|
|
+| bdata/model.go (GetActivityParams) | ActivityManage/application/domain/activity/request_params.go | ✅ 一致 |
|
|
|
|
|
+| bdata/model.go (PlanInfo) | ActivityManage/application/domain/plan/info.go | ✅ 一致 |
|
|
|
|
|
+| bdata/model.go (SavePlanParams) | ActivityManage/application/domain/plan/request_params.go | ✅ 一致 |
|
|
|
|
|
+| bdata/model.go (QueryPlansParams) | ActivityManage/application/domain/plan/request_params.go | ✅ 一致 |
|
|
|
|
|
+| bdata/model.go (DeletePlanParams) | ActivityManage/application/domain/plan/request_params.go | ✅ 一致 |
|
|
|
|
|
+| bdata/model.go (GetPlanParams) | ActivityManage/application/domain/plan/request_params.go | ✅ 一致 |
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+**验证完成时间**:2026-05-21
|
|
|
|
|
+**验证人员**:Kiro AI
|
|
|
|
|
+**验证结果**:✅ 全部通过
|