```

feat(game): 实现扭蛋系统批量物品添加功能并优化地图逻辑

- 新增ItemAddBatch方法用于批量添加物品，支持普通道具和特殊道具的分别处理
- 优化扭蛋游戏玩法中的物品添加逻辑，使用新的批量接口提升性能
- 在扭蛋机器人命令中实现完整的物品检查和批量添加流程

refactor(map): 重构地图控制器代码结构并添加注释

- 为EnterMap、LeaveMap、GetMapPlayerList等方法添加中文注释
- 统一地图相关的命名规范，如enter

modules/config/model/map_model.go

@@ -9,10 +9,21 @@ const (
 	TableNameMapModel = "map_model"
 )
 
-// 模型类型常量 (1:NPC, 2:精灵)
+// 模型类型常量 (0:精灵, 1:NPC)
 const (
+	MapModelTypePet = 0
 	MapModelTypeNPC = 1
-	MapModelTypePet = 2
+)
+
+const (
+	MapModelDirectionRight = iota
+	MapModelDirectionRightDown
+	MapModelDirectionDown
+	MapModelDirectionLeftDown
+	MapModelDirectionLeft
+	MapModelDirectionLeftUp
+	MapModelDirectionUp
+	MapModelDirectionRightUp
 )
 
 // MapModelBroadcastNode 地图模型广播节点配置
@@ -20,7 +31,7 @@ type MapModelBroadcastNode struct {
 	TriggerID uint32 `gorm:"comment:'触发器ID'" json:"trigger_id" description:"触发器ID"`
 	Pos       string `gorm:"type:varchar(255);default:'';comment:'位置'" json:"pos" description:"位置"`
 	HP        int32  `gorm:"type:int;default:0;comment:'血量'" json:"hp" description:"血量"`
-	Direction int32  `gorm:"type:int;default:0;comment:'方向'" json:"direction" description:"方向"`
+	Direction int32  `gorm:"type:int;default:2;comment:'BOSS方向(0-7)'" json:"direction" description:"BOSS方向"`
 }
 
 // MapModel 地图模型配置表(NPC/宠物)
@@ -34,7 +45,7 @@ type MapModel struct {
 
 	ModelID uint32 `gorm:"not null;default:0;comment:'模型ID(NPCID或精灵ID)'" json:"model_id" description:"模型ID"`
 
-	ModelType int32 `gorm:"type:int;default:1;comment:'模型类型(1:NPC,2:精灵)'" json:"model_type" description:"模型类型"`
+	ModelType int32 `gorm:"type:int;default:0;comment:'模型类型(0:精灵,1:NPC)'" json:"model_type" description:"模型类型"`
 
 	ModelName string `gorm:"type:varchar(100);default:'';comment:'模型名称'" json:"model_name" description:"模型名称"`
 

modules/config/model/map_node.go

@@ -29,7 +29,7 @@ type MapNode struct {
 	WinBonusID  int `gorm:"type:int;default:0;comment:'胜利奖励ID'" json:"win_bonus_id"`
 	FailBonusID int `gorm:"type:int;default:0;comment:'失败奖励ID'" json:"fail_bonus_id"`
 
-	IsBroadcast uint32 `gorm:"type:int;default:0;comment:'是否需要广播'" json:"is_broadcast"`
+	IsBroadcast uint32 `gorm:"type:int;default:0;comment:'广播模型ID(0表示不广播)'" json:"is_broadcast"`
 
 	TriggerPlotID uint32 `gorm:"default:0;comment:'触发剧情ID（0表示无剧情）'" json:"trigger_plot_id" description:"触发剧情ID"`