# 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  
**验证结果**：✅ 全部通过