ModulePlanning.md 13 KB
开心农场系统模块规划
根据系统需求和现有模块分析，以下是缺失模块的规划建议。
1. 农场模块 (Farm)
功能概述
农场模块是开心农场系统的核心，负责管理用户的农场、土地、作物种植和收获等核心玩法。
目录结构
app/Module/Farm/
├── AdminControllers/ # 后台管理控制器
│ ├── Helper/ # 控制器辅助类
│ ├── Actions/ # 控制器动作类
│ └── LazyRenderable/ # 懒加载渲染类
├── Commands/ # 命令行工具
├── Casts/ # 自定义类型转换器
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Exceptions/ # 异常类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- FarmUser - 用户农场信息
- FarmLand - 农场土地信息
- FarmCrop - 农场作物信息
- FarmDisaster - 农场灾害记录
- FarmHarvestLog - 收获记录
- FarmLevelConfig - 农场等级配置
主要功能
- 土地管理（普通、红土、黑土、特殊土地）
- 作物种植与生长周期管理
- 灾害系统（干旱、虫害、杂草）
- 收获系统
- 农场等级系统
- 土地升级系统
2. 房屋模块 (House)
功能概述
房屋模块负责管理用户的房屋等级、升级和相关属性，影响土地产出和其他游戏机制。
目录结构
app/Module/House/
├── AdminControllers/ # 后台管理控制器
├── Commands/ # 命令行工具
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- HouseUser - 用户房屋信息
- HouseLevelConfig - 房屋等级配置
- HouseUpgradeLog - 房屋升级记录
- HouseUpgradeMaterial - 升级所需材料配置
主要功能
- 房屋等级管理（共12级）
- 房屋升级系统
- 房屋降级机制
- 房屋对土地产出的影响计算
3. 种子模块 (Seed)
功能概述
种子模块负责管理游戏中的各类种子，包括普通种子、神秘种子和巨化种子等。
目录结构
app/Module/Seed/
├── AdminControllers/ # 后台管理控制器
├── Commands/ # 命令行工具
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- SeedBase - 种子基础信息
- SeedCategory - 种子分类
- SeedGrowthConfig - 种子生长配置
- SeedUser - 用户种子关联
- SeedMysteryConfig - 神秘种子配置
主要功能
- 种子类型管理（普通、神秘、巨化）
- 种子生长周期配置
- 种子产量计算
- 神秘种子随机产出逻辑
4. 团队模块 (Team)
功能概述
团队模块负责管理用户的推荐关系、团队结构和相关奖励机制。
目录结构
app/Module/Team/
├── AdminControllers/ # 后台管理控制器
├── Commands/ # 命令行工具
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- TeamUser - 用户团队信息
- TeamRelation - 团队关系表
- TeamReward - 团队奖励记录
- TeamLevelConfig - 团队等级配置
- TeamAchievement - 团队成就记录
主要功能
- 推荐关系管理
- 团队结构维护
- 直推/间推奖励计算
- 达人等级系统
- 团队奖励分成机制
5. 兑换中心模块 (Exchange)
功能概述
兑换中心模块负责管理游戏中的物品兑换、礼包系统和相关功能。
目录结构
app/Module/Exchange/
├── AdminControllers/ # 后台管理控制器
├── Commands/ # 命令行工具
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- ExchangeItem - 可兑换物品配置
- ExchangeLog - 兑换记录
- ExchangePackage - 礼包配置
- ExchangePackageItem - 礼包内容配置
- ExchangePackageLog - 礼包领取记录
主要功能
- 物品兑换系统
- 礼包系统（推荐礼包、补偿礼包、新人礼包等）
- 自定义奖励池配置
- 奖励发放方式（全部/随机）
6. 争霸赛模块 (Battle)
功能概述
争霸赛模块负责管理松狮争霸赛相关的功能，包括赛季、队伍、战斗等。
目录结构
app/Module/Battle/
├── AdminControllers/ # 后台管理控制器
├── Commands/ # 命令行工具
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- BattleSeason - 争霸赛赛季
- BattleTeam - 争霸赛队伍
- BattleTeamMember - 队伍成员
- BattleBoss - Boss配置
- BattleLog - 战斗记录
- BattleReward - 奖励配置
主要功能
- 赛季管理
- 队伍组建与管理
- Boss战斗机制
- 奖池分配机制
- 战斗记录与排名
7. 安全模块 (Security)
功能概述
安全模块负责管理系统的安全机制，包括防爆破、反作弊、安全验证等功能。
目录结构
app/Module/Security/
├── AdminControllers/ # 后台管理控制器
├── Commands/ # 命令行工具
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- SecurityLog - 安全日志
- SecurityBlock - 封禁记录
- SecurityVerification - 验证记录
- SecurityConfig - 安全配置
主要功能
- 登录错误限制
- 验证码错误限制
- 前端版本号校验
- 非法请求标记
- 非APP端登录检测
- 累计标记机制
8. 用户模块 (User)
功能概述
用户模块负责管理用户的基本信息、认证、状态等功能。
目录结构
app/Module/User/
├── AdminControllers/ # 后台管理控制器
├── Commands/ # 命令行工具
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- User - 用户基本信息
- UserAuth - 用户认证信息
- UserStatus - 用户状态
- UserProfile - 用户详细资料
- UserLog - 用户操作日志
主要功能
- 用户注册与登录
- 实名认证
- 密码管理
- 用户状态管理（冻结、解冻等）
- 用户日志记录
9. 任务模块 (Task)
功能概述
任务模块负责管理游戏中的各类任务，包括日常任务、成就任务等。
目录结构
app/Module/Task/
├── AdminControllers/ # 后台管理控制器
├── Commands/ # 命令行工具
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- TaskBase - 任务基础信息
- TaskCategory - 任务分类
- TaskCondition - 任务条件
- TaskReward - 任务奖励
- TaskUser - 用户任务进度
- TaskLog - 任务完成记录
主要功能
- 任务类型管理
- 任务条件配置
- 任务奖励配置
- 任务进度追踪
- 任务完成与奖励发放
10. 商店模块 (Shop)
功能概述
商店模块负责管理游戏内的商店系统，包括商品、购买、支付等功能。
目录结构
app/Module/Shop/
├── AdminControllers/ # 后台管理控制器
├── Commands/ # 命令行工具
├── Databases/ # 数据库相关文件
│ └── createsql/ # 表创建SQL文件
├── Enums/ # 枚举类型定义
├── Events/ # 事件类
├── Logics/ # 业务逻辑类
├── Models/ # 数据模型
├── Providers/ # 服务提供者
├── Repositorys/ # 数据仓库
├── Services/ # 服务类
└── README.md # 模块文档
核心数据模型
- ShopItem - 商店商品
- ShopCategory - 商品分类
- ShopOrder - 购买订单
- ShopDiscount - 折扣配置
- ShopLimitConfig - 限购配置
- ShopPayment - 支付记录
主要功能
- 商品管理
- 商品分类
- 限购机制
- 折扣系统
- 订单处理
- 支付集成
总结
以上规划的10个模块涵盖了开心农场系统的主要功能需求。每个模块都遵循相同的目录结构规范，保持了代码组织的一致性。模块之间通过事件系统和服务接口进行通信，保持了低耦合高内聚的设计原则。
在实际开发中，可以根据业务需求的优先级和资源情况，分阶段实施这些模块的开发。建议先完成核心的农场、种子、物品和用户模块，然后再逐步实现其他功能模块。