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

任务时间: 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 验证：

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

总结

本次更新大幅提升了土地升级配置管理界面的信息展示能力，管理员现在可以直观地看到：

每个升级配置需要消耗的具体物品和数量
每个升级配置需要满足的具体条件
完整的配置信息，无需点击详情页面即可了解全貌

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

201444-土地升级配置管理列表显示消耗组和条件组详情.md 4.5 KB Permalink History Raw