# 土地升级配置管理列表显示消耗组和条件组详情

**任务时间**: 2025年06月20日 14:44  
**任务状态**: ✅ 已完成  
**提交哈希**: af0e13bd

## 任务描述

为土地升级配置管理后台页面增加消耗组和条件组的详细内容显示，替代原有的简单名称显示，提升管理界面的信息完整性和实用性。

## 实现内容

### 1. 新增GridHelper方法

**文件**: `app/Module/Farm/AdminControllers/Helper/GridHelperTrait.php`

#### columnConsumeGroupDetails方法
- 显示消耗组名称和编码
- 展示详细的消耗项表格，包含：
  - 消耗类型（物品、账户种类等）
  - 目标名称（具体物品名或账户名）
  - 消耗数量
- 支持空值处理，显示"使用 materials 字段"提示
- 使用响应式表格布局，设置300px宽度

#### columnConditionGroupDetails方法
- 显示条件组名称和编码
- 展示详细的条件项表格，包含：
  - 条件类型（土地等级、房屋等级等）
  - 目标名称（具体土地类型名等）
  - 操作符（大于等于、等于等）
  - 要求值
- 支持空值处理，显示"使用 conditions 字段"提示
- 使用响应式表格布局，设置300px宽度

#### getOperatorName辅助方法
- 将数字操作符转换为中文名称
- 支持等于、不等于、小于、大于等于、小于等于、大于等操作符

### 2. 更新控制器

**文件**: `app/Module/Farm/AdminControllers/FarmLandUpgradeConfigController.php`

- 替换原有的简单消耗组和条件组显示
- 使用新的详情列方法：
  - `$helper->columnConsumeGroupDetails()`
  - `$helper->columnConditionGroupDetails()`

### 3. 显示效果

#### 消耗组详情显示
```
土地升级1-2 (land_update_2)
┌─────────┬──────┬──────┐
│消耗类型 │ 目标 │ 数量 │
├─────────┼──────┼──────┤
│ 物品    │ 萝卜 │ 300  │
│账户种类 │ 钻石 │ 300  │
│ 物品    │ 辣椒 │ 300  │
└─────────┴──────┴──────┘
```

#### 条件组详情显示
```
默认条件 (c1)
┌─────────┬─────────┬─────────┬──────┐
│条件类型 │  目标   │ 操作符  │要求值│
├─────────┼─────────┼─────────┼──────┤
│土地等级 │ 普通土地│ 大于等于│  1   │
└─────────┴─────────┴─────────┴──────┘
```

## 技术要点

### 1. 数据关联加载
- 使用`with('consumeItems')`和`with('conditionItems')`预加载关联数据
- 避免N+1查询问题，提升性能

### 2. 类型转换和名称获取
- 使用`CONSUME_TYPE::getName()`获取消耗类型中文名
- 使用`CONDITION_TYPE::getName()`获取条件类型中文名
- 调用模型的`getTargetName()`方法获取目标名称
- 使用`ConditionTypeDescriptor::getTargetNameFromModel()`获取条件目标名称

### 3. 界面优化
- 使用Bootstrap表格样式和响应式布局
- 添加颜色标识：消耗类型用info徽章，条件类型用primary徽章
- 数量和要求值使用加粗绿色显示，突出重要信息
- 操作符使用secondary徽章显示

### 4. 错误处理
- 对不存在的消耗组/条件组显示错误提示
- 对空的消耗项/条件项显示友好提示
- 保持向后兼容，支持旧版本的字段显示

## 数据示例

### 消耗组数据
- **土地升级1-2**: 萝卜300个 + 钻石300 + 辣椒300个
- **土地升级2-3**: 苹果1000个 + 钻石1000 + 西瓜1000个  
- **土地升级3-4**: 西瓜8000个 + 钻石2000 + 南瓜800个

### 条件组数据
- **默认条件**: 土地等级 >= 1（普通土地）

## 效果验证

通过浏览器访问 `http://kku_laravel.local.gd/admin/farm-land-upgrade-configs` 验证：

1. ✅ 消耗组详情正确显示组名、编码和详细消耗项
2. ✅ 条件组详情正确显示组名、编码和详细条件项  
3. ✅ 表格布局美观，信息层次清晰
4. ✅ 数据类型转换正确，中文显示友好
5. ✅ 响应式布局适配不同屏幕尺寸

## 总结

本次更新大幅提升了土地升级配置管理界面的信息展示能力，管理员现在可以直观地看到：
- 每个升级配置需要消耗的具体物品和数量
- 每个升级配置需要满足的具体条件
- 完整的配置信息，无需点击详情页面即可了解全貌

这为游戏平衡性调整和配置管理提供了更好的数据支持。