1

app/Module/ModulePlanning.md

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