# 开发计划

## 1. 创建基本目录结构 ✅

- [x] 创建 AdminControllers 目录
- [x] 创建 Commands 目录
- [x] 创建 Enums 目录
- [x] 创建 Events 目录
- [x] 创建 Logics 目录
- [x] 创建 Models 目录
- [x] 创建 Providers 目录
- [x] 创建 Repositorys 目录
- [x] 创建 Services 目录

## 2. 实现枚举类 ✅

- [x] REFERRAL_LEVEL - 推荐层级枚举
- [x] TALENT_LEVEL - 达人等级枚举
- [x] PROFIT_SOURCE_TYPE - 收益来源类型枚举
- [x] PROFIT_RECORD_STATUS - 收益记录状态枚举
- [x] TEAM_TASK_TYPE - 团队任务类型枚举
- [x] TEAM_TASK_STATUS - 团队任务状态枚举
- [x] REFERRAL_CODE_STATUS - 推荐码状态枚举

## 3. 实现模型类 ✅

- [x] TeamUserReferral - 用户推荐关系
- [x] TeamUserTalent - 达人等级
- [x] TeamProfit - 团队收益记录
- [x] TeamReferralCode - 推荐码
- [x] TeamTalentConfig - 达人等级配置
- [x] TeamProfitRule - 收益分成规则
- [x] TeamReferralChange - 推荐关系修改记录
- [x] TeamUserRelationCache - 用户关系缓存
- [x] TeamInviteReward - 邀请奖励记录
- [x] TeamReferralCodeUsage - 邀请码使用记录

## 4. 实现服务层和逻辑层 ✅

### 4.1 逻辑层（内部）

- [x] ReferralLogic - 推荐关系逻辑
- [x] TalentLogic - 达人等级逻辑
- [x] TeamProfitLogic - 团队收益逻辑
- [x] ReferralCodeLogic - 推荐码逻辑
- [x] RelationCacheLogic - 关系缓存逻辑

### 4.2 服务层（对外，静态方法）

- [x] ReferralService - 推荐关系服务
- [x] TalentService - 达人等级服务
- [x] TeamProfitService - 团队收益服务
- [x] ReferralCodeService - 推荐码服务

## 5. 实现数据仓库 ✅

- [x] TeamUserReferralRepository
- [x] TeamUserTalentRepository
- [x] TeamProfitRepository
- [x] TeamReferralCodeRepository
- [x] TeamTalentConfigRepository
- [x] TeamProfitRuleRepository
- [x] TeamReferralChangeRepository
- [x] TeamUserRelationCacheRepository
- [x] TeamInviteRewardRepository
- [x] TeamReferralCodeUsageRepository

## 6. 实现后台控制器 ✅

- [x] TeamUserReferralController - 用户推荐关系管理
- [x] TeamUserTalentController - 用户达人等级管理
- [x] TeamProfitController - 团队收益记录管理
- [x] TeamReferralCodeController - 推荐码管理
- [x] TeamTalentConfigController - 达人等级配置管理
- [x] TeamProfitRuleController - 收益分成规则管理
- [x] TeamReferralChangeController - 推荐关系修改记录管理
- [x] TeamUserRelationCacheController - 用户关系缓存管理
- [x] TeamInviteRewardController - 邀请奖励记录管理
- [x] TeamReferralCodeUsageController - 推荐码使用记录管理

## 7. 实现事件和监听器 ✅

### 7.1 事件

- [x] ReferralCreatedEvent - 推荐关系创建事件
- [x] ReferralUpdatedEvent - 推荐关系更新事件
- [x] TalentLevelChangedEvent - 达人等级变更事件
- [x] TeamProfitCreatedEvent - 团队收益创建事件

### 7.2 监听器

- [x] UpdateTeamCountsListener - 更新团队统计数据
- [x] UpdateTalentLevelListener - 更新达人等级
- [x] DistributeTeamProfitListener - 分配团队收益

## 8. 实现服务提供者 ✅

- [x] TeamServiceProvider - 注册服务、事件、命令等

## 9. 实现命令行工具 ✅

- [x] RebuildRelationCacheCommand - 重建推荐关系缓存
- [x] UpdateTalentLevelsCommand - 更新达人等级
- [x] CleanExpiredReferralCodesCommand - 清理过期推荐码

## 开发进度

- ✅ 已完成
- 🔄 进行中
- ⏳ 待开始

### 当前进度

- 已完成基本目录结构创建
- 已完成所有枚举类的实现
- 已完成所有模型类的实现
- 已完成所有逻辑层类的实现（ReferralLogic, TalentLogic, TeamProfitLogic, ReferralCodeLogic, RelationCacheLogic）
- 已完成所有服务层类的实现（ReferralService, TalentService, TeamProfitService, ReferralCodeService）
- 已完成所有数据仓库类的实现（10个仓库类，对应10个模型类）
- 已完成所有后台控制器的实现（10个控制器，对应10个模型类）
- 已完成所有事件和监听器的实现（4个事件，3个监听器）
- 已完成服务提供者的实现（TeamServiceProvider）
- 已完成所有命令行工具的实现（3个命令）

### 下一步计划

1. 编写单元测试
2. 编写文档