Item 基础物品模块

模块定位

基础服务模块，仅提供核心物品管理能力：

不实现具体业务逻辑（如合成、宝箱）
不提供外部API接口
通过静态Service方法供其他模块调用

核心功能

物品定义管理：
- 统一属性物品（堆叠存储）
- 单独属性物品（实例存储）
仓库系统：
- 多仓库支持（基础能力）
- 仓库间物品转移
- 独立容量配置
基础服务：
- 物品添加/获取
- 仓库管理
- 属性扩展支持

服务接口

// 添加物品到仓库
ItemService::addItem(
    userId: int, 
    itemId: int, 
    quantity: int, 
    warehouse: string
);

// 仓库间转移物品
ItemService::transferItem(
    userId: int,
    itemId: int,
    fromWarehouse: string,
    toWarehouse: string,
    quantity: int
);

// 获取仓库物品列表
ItemService::getWarehouseItems(
    userId: int,
    warehouse: string
);

模块依赖

模块	依赖类型	说明
Game	强依赖	仓库容量扩展依赖玩家等级
Log	弱依赖	物品操作日志记录（可选）

设计文档