|
@@ -1,317 +0,0 @@
|
|
|
-# 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
|
|
|
|
|
-**验证结果**:✅ 全部通过
|
|
|