任务模块数据库设计

1. 数据库表概览

任务模块包含以下核心数据表，按功能分为三个部分：

1.1 任务定义相关表

task_categories - 任务分类表：存储任务的分类信息，用于对任务进行分组和管理。
task_tasks - 任务定义表：存储任务的基本定义信息，包括任务名称、描述、类型等。
task_rewards - 任务奖励定义表：存储任务的奖励内容，与任务定义表一对多关联。
task_costs - 任务接取消耗表：存储接取任务所需的消耗资源，与任务定义表一对多关联。
task_conditions - 任务条件表：定义系统中所有可用的条件类型，每种条件类型对应一个处理器类。
task_achievement_conditions - 任务达成条件表：关联任务和具体的条件，定义了完成任务需要满足的条件。

1.2 任务完成相关表

task_user_tasks - 用户任务关联表：存储用户与任务的关联信息，包括任务状态、进度、完成时间等。
task_user_progress - 用户任务进度表：存储用户任务的详细进度信息，关联到具体的任务达成条件。

1.3 日志记录相关表

task_completion_logs - 任务完成日志表：记录用户完成任务的详细信息，用于审计和数据分析。
task_reward_logs - 任务奖励发放日志表：记录任务奖励的发放情况，包括奖励内容、发放时间等。
task_cost_logs - 任务消耗日志表：记录用户接取任务时的资源消耗情况，包括消耗类型、数量、时间等。
task_reset_logs - 任务重置日志表：记录任务重置的情况，包括重置类型、重置时间、影响的任务数等。

2. 表结构详细设计

2.1 任务定义相关表

2.1.1 任务分类表 (task_categories)

存储任务的分类信息，用于对任务进行分组和管理。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
name	varchar(100)	否	-	分类名称
code	varchar(50)	否	-	分类编码（唯一）
description	varchar(255)	是	NULL	分类描述
sort_order	int	否	0	排序顺序
created_at	timestamp	是	NULL	创建时间
updated_at	timestamp	是	NULL	更新时间

索引：

PRIMARY KEY (id)
UNIQUE KEY idx_code (code)

2.1.2 任务定义表 (task_tasks)

存储任务的基本定义信息，包括任务名称、描述等。目标相关字段已拆分到任务达成条件表，奖励相关字段已拆分到任务奖励定义表。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
category_id	int	否	-	任务分类ID，外键关联task_categories表
name	varchar(100)	否	-	任务名称
description	varchar(500)	是	NULL	任务描述
type	varchar(20)	否	-	任务类型（daily, weekly, achievement, event, tutorial, team）
prerequisite_tasks	json	是	NULL	前置任务ID（JSON格式）
level_required	int	否	0	所需等级
time_limit	int	是	NULL	时间限制（秒，NULL表示无限制）
max_completions	int	否	1	最大完成次数（用于限制任务可完成的次数）
reset_type	varchar(20)	否	'none'	重置类型（none, daily, weekly, monthly）
reset_interval	int	否	0	重置间隔（秒），根据重置类型自动计算
reset_time_field	varchar(50)	是	NULL	重置时间字段，如"daily_reset_time"，用于存储具体重置时间点
display_params	json	是	NULL	显示参数（JSON格式，存储与任务显示相关的参数）
sort_order	int	否	0	排序权重（数值越大越靠前）
is_active	tinyint	否	1	是否激活（0:否, 1:是）
start_time	timestamp	是	NULL	开始时间（NULL表示立即开始）
end_time	timestamp	是	NULL	结束时间（NULL表示永不结束）
created_at	timestamp	是	NULL	创建时间
updated_at	timestamp	是	NULL	更新时间

索引：

PRIMARY KEY (id)
KEY idx_category (category_id)
KEY idx_type (type)
KEY idx_active_time (is_active, start_time, end_time)
KEY idx_sort (sort_order)

2.1.3 任务奖励定义表 (task_rewards)

存储任务的奖励内容，一个任务可以有多个不同类型的奖励。每个奖励需要两个参数：reward_param1和reward_param2，用于更精确地定义奖励。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
task_id	int	否	-	任务ID，外键关联task_tasks表
reward_type	varchar(50)	否	-	奖励类型（item, currency, experience, feature_unlock等）
reward_param1	varchar(100)	否	-	奖励参数1（如物品类型、货币类型等）
reward_param2	varchar(100)	否	-	奖励参数2（如物品ID、货币ID等）
quantity	int	否	1	奖励数量
extra_data	json	是	NULL	额外数据（JSON格式）
sort_order	int	否	0	排序权重（数值越大越靠前）
created_at	timestamp	是	NULL	创建时间
updated_at	timestamp	是	NULL	更新时间

索引：

PRIMARY KEY (id)
KEY idx_task_id (task_id)
KEY idx_reward_type (reward_type)
KEY idx_reward_params (reward_param1, reward_param2)
KEY idx_sort (sort_order)

2.1.4 任务接取消耗表 (task_costs)

存储接取任务所需的消耗资源，一个任务可以有多种不同类型的消耗资源。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
task_id	int	否	-	任务ID，外键关联task_tasks表
cost_type	varchar(50)	否	-	消耗类型（currency, item, energy, ticket等）
cost_param1	varchar(100)	否	-	消耗参数1（如货币类型、物品类型等）
cost_param2	varchar(100)	否	-	消耗参数2（如货币ID、物品ID等）
quantity	int	否	1	消耗数量
extra_data	json	是	NULL	额外数据（JSON格式）
sort_order	int	否	0	排序权重（数值越大越靠前）
created_at	timestamp	是	NULL	创建时间
updated_at	timestamp	是	NULL	更新时间

索引：

PRIMARY KEY (id)
KEY idx_task_id (task_id)
KEY idx_cost_type (cost_type)
KEY idx_cost_params (cost_param1, cost_param2)
KEY idx_sort (sort_order)

2.1.5 任务条件表 (task_conditions)

定义系统中所有可用的条件类型，每种条件类型对应一个处理器类，负责验证和更新该类型条件的进度。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
code	varchar(50)	否	-	条件代码（唯一），如'login', 'plant', 'harvest'
name	varchar(100)	否	-	条件名称，如'登录游戏', '种植作物', '收获作物'
description	varchar(255)	是	NULL	条件描述
param_schema	json	是	NULL	参数模式，定义此条件需要的参数及其类型
handler_class	varchar(255)	是	NULL	处理此条件的类名
is_active	tinyint	否	1	是否激活（0:否, 1:是）
created_at	timestamp	是	NULL	创建时间
updated_at	timestamp	是	NULL	更新时间

索引：

PRIMARY KEY (id)
UNIQUE KEY idx_code (code)

2.1.6 任务达成条件表 (task_achievement_conditions)

关联任务和具体的条件，定义了完成任务需要满足的条件。一个任务可以有多个条件，通过这个表可以实现复杂的任务逻辑。条件分为两种类型：前置条件和进度条件。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
task_id	int	否	-	任务ID，外键关联task_tasks表
condition_id	int	否	-	条件ID，外键关联task_conditions表
condition_type	varchar(20)	否	'progress'	条件类型（'prerequisite'=前置条件，'progress'=进度条件）
target_value	int	否	1	目标值，如需要完成的次数
params	json	是	NULL	条件参数，如特定物品ID、特定作物ID等
operator	varchar(10)	否	'='	运算符，如'=', '>=', '<='
sort_order	int	否	0	排序顺序，用于多条件任务
is_required	tinyint	否	1	是否必须满足此条件（0:否, 1:是）
created_at	timestamp	是	NULL	创建时间
updated_at	timestamp	是	NULL	更新时间

索引：

PRIMARY KEY (id)
KEY idx_task_id (task_id)
KEY idx_condition_id (condition_id)
KEY idx_task_condition (task_id, condition_id)
KEY idx_condition_type (condition_type)

2.2 任务完成相关表

2.2.1 用户任务关联表 (task_user_tasks)

存储用户与任务的关联信息，包括任务状态、进度、完成时间等。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
user_id	int	否	-	用户ID
task_id	int	否	-	任务ID，外键关联task_tasks表
status	tinyint	否	0	状态（0:未接取, 1:进行中, 2:已完成, 3:已领取奖励, 4:已失败, 5:已过期）
progress	int	否	0	当前进度
completed_at	timestamp	是	NULL	完成时间
rewarded_at	timestamp	是	NULL	奖励发放时间
expire_at	timestamp	是	NULL	过期时间
next_reset_time	timestamp	是	NULL	下次重置时间，用于快速判断是否需要重置
last_reset_time	timestamp	是	NULL	上次重置时间，用于计算下次重置时间
reset_count	int	否	0	重置次数，用于统计和分析
created_at	timestamp	是	NULL	创建时间
updated_at	timestamp	是	NULL	更新时间

索引：

PRIMARY KEY (id)
UNIQUE KEY idx_user_task (user_id, task_id)
KEY idx_next_reset_time (next_reset_time)
KEY idx_user_next_reset (user_id, next_reset_time)
KEY idx_user_status (user_id, status)
KEY idx_task (task_id)
KEY idx_expire (expire_at)

2.2.2 用户任务进度表 (task_user_progress)

存储用户任务的详细进度信息，关联到具体的任务达成条件。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
user_id	int	否	-	用户ID
task_id	int	否	-	任务ID，外键关联task_tasks表
achievement_condition_id	int	否	-	达成条件ID，外键关联task_achievement_conditions表
current_value	int	否	0	当前值
last_update_time	timestamp	是	NULL	最后更新时间
created_at	timestamp	是	NULL	创建时间
updated_at	timestamp	是	NULL	更新时间

索引：

PRIMARY KEY (id)
UNIQUE KEY idx_user_task_condition (user_id, task_id, achievement_condition_id)
KEY idx_user_task (user_id, task_id)
KEY idx_achievement_condition (achievement_condition_id)

2.3 日志记录相关表

2.3.1 任务完成日志表 (task_completion_logs)

记录用户完成任务的详细信息，用于审计和数据分析。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
user_id	int	否	-	用户ID
task_id	int	否	-	任务ID，外键关联task_tasks表
completed_at	timestamp	否	-	完成时间
time_spent	int	是	NULL	完成耗时（秒）
ip_address	varchar(45)	是	NULL	IP地址
device_info	varchar(255)	是	NULL	设备信息
created_at	timestamp	是	NULL	创建时间

索引：

PRIMARY KEY (id)
KEY idx_user (user_id)
KEY idx_task (task_id)
KEY idx_completed_at (completed_at)

2.3.2 任务奖励发放日志表 (task_reward_logs)

记录任务奖励的发放情况，包括奖励内容、发放时间等。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
user_id	int	否	-	用户ID
task_id	int	否	-	任务ID，外键关联task_tasks表
user_task_id	int	否	-	用户任务ID，外键关联task_user_tasks表
rewards	json	否	-	奖励内容（JSON格式）
rewarded_at	timestamp	否	-	奖励发放时间
ip_address	varchar(45)	是	NULL	IP地址
device_info	varchar(255)	是	NULL	设备信息
created_at	timestamp	是	NULL	创建时间

索引：

PRIMARY KEY (id)
KEY idx_user (user_id)
KEY idx_task (task_id)
KEY idx_user_task (user_task_id)
KEY idx_rewarded_at (rewarded_at)

2.3.3 任务消耗日志表 (task_cost_logs)

记录用户接取任务时的资源消耗情况，包括消耗类型、数量、时间等。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
user_id	int	否	-	用户ID
task_id	int	否	-	任务ID，外键关联task_tasks表
cost_type	varchar(50)	否	-	消耗类型（currency, item, energy, ticket等）
cost_param1	varchar(100)	否	-	消耗参数1（如货币类型、物品类型等）
cost_param2	varchar(100)	否	-	消耗参数2（如货币ID、物品ID等）
quantity	int	否	1	消耗数量
cost_at	timestamp	否	-	消耗时间
ip_address	varchar(45)	是	NULL	IP地址
device_info	varchar(255)	是	NULL	设备信息
created_at	timestamp	是	NULL	创建时间

索引：

PRIMARY KEY (id)
KEY idx_user (user_id)
KEY idx_task (task_id)
KEY idx_cost_type (cost_type)
KEY idx_cost_at (cost_at)

2.3.4 任务重置日志表 (task_reset_logs)

记录任务重置的情况，包括重置类型、重置时间、影响的任务数等。

字段名	类型	允许空	默认值	说明
id	int	否	自增	主键
reset_type	varchar(20)	否	-	重置类型（daily, weekly, monthly, manual, auto）
trigger_type	varchar(20)	是	NULL	触发类型（view, accept, update, reward, admin）
reset_time	timestamp	否	-	重置时间
affected_tasks	json	是	NULL	受影响的任务ID列表（JSON格式）
affected_count	int	否	0	受影响的任务数量
created_at	timestamp	是	NULL	创建时间

索引：

PRIMARY KEY (id)
KEY idx_reset_type (reset_type)
KEY idx_reset_time (reset_time)

3. 数据关系

3.1 数据关系图

erDiagram
    task_categories ||--o{ task_tasks : "包含"
    task_tasks ||--o{ task_rewards : "定义奖励"
    task_tasks ||--o{ task_costs : "定义消耗"
    task_tasks ||--o{ task_achievement_conditions : "设置"
    task_conditions ||--o{ task_achievement_conditions : "使用"
    task_tasks ||--o{ task_user_tasks : "接取"
    task_achievement_conditions ||--o{ task_user_progress : "进度"
    task_user_tasks ||--o{ task_completion_logs : "记录完成"
    task_user_tasks ||--o{ task_reward_logs : "记录奖励"
    task_user_tasks ||--o{ task_cost_logs : "记录消耗"
    task_reset_logs ||--o{ task_tasks : "重置"

    task_categories {
        int id PK "主键"
        varchar name "分类名称"
        varchar code "分类编码"
    }

    task_tasks {
        int id PK "主键"
        int category_id FK "分类ID"
        varchar name "任务名称"
        varchar type "任务类型"
        json prerequisite_tasks "前置任务"
        int max_completions "最大完成次数"
        json display_params "显示参数"
        int sort_order "排序权重"
    }

    task_rewards {
        int id PK "主键"
        int task_id FK "任务ID"
        varchar reward_type "奖励类型"
        varchar reward_param1 "奖励参数1"
        varchar reward_param2 "奖励参数2"
        int quantity "数量"
        int sort_order "排序权重"
    }

    task_costs {
        int id PK "主键"
        int task_id FK "任务ID"
        varchar cost_type "消耗类型"
        varchar cost_param1 "消耗参数1"
        varchar cost_param2 "消耗参数2"
        int quantity "数量"
        int sort_order "排序权重"
    }

    task_conditions {
        int id PK "主键"
        varchar code "条件代码"
        varchar name "条件名称"
        varchar handler_class "处理器类"
    }

    task_achievement_conditions {
        int id PK "主键"
        int task_id FK "任务ID"
        int condition_id FK "条件ID"
        varchar condition_type "条件类型"
        int target_value "目标值"
    }

    task_user_tasks {
        int id PK "主键"
        int user_id "用户ID"
        int task_id FK "任务ID"
        tinyint status "状态"
        int progress "进度"
    }

    task_user_progress {
        int id PK "主键"
        int user_id "用户ID"
        int task_id FK "任务ID"
        int achievement_condition_id FK "条件ID"
        int current_value "当前值"
    }

    task_completion_logs {
        int id PK "主键"
        int user_id "用户ID"
        int task_id FK "任务ID"
        timestamp completed_at "完成时间"
    }

    task_reward_logs {
        int id PK "主键"
        int user_id "用户ID"
        int task_id FK "任务ID"
        int user_task_id FK "用户任务ID"
        json rewards "奖励内容"
    }

    task_cost_logs {
        int id PK "主键"
        int user_id "用户ID"
        int task_id FK "任务ID"
        varchar cost_type "消耗类型"
        varchar cost_param1 "消耗参数1"
        varchar cost_param2 "消耗参数2"
        int quantity "数量"
        timestamp cost_at "消耗时间"
    }

    task_reset_logs {
        int id PK "主键"
        varchar reset_type "重置类型"
        timestamp reset_time "重置时间"
        int affected_count "影响数量"
    }

3.2 文本关系图

task_categories 1 --< task_tasks
task_tasks 1 --< task_rewards
task_tasks 1 --< task_costs
task_conditions 1 --< task_achievement_conditions
task_tasks 1 --< task_achievement_conditions
task_tasks 1 --< task_user_tasks
task_achievement_conditions 1 --< task_user_progress
task_user_tasks 1 --< task_completion_logs
task_user_tasks 1 --< task_reward_logs
task_user_tasks 1 --< task_cost_logs

3.3 关系说明

一个任务分类可以包含多个任务
一个任务可以有多个奖励定义
一个任务可以有多个接取消耗定义
一个条件类型可以用于多个任务达成条件
一个任务可以有多个达成条件
一个任务可以被多个用户接取
一个任务达成条件可以有多个用户进度记录
一个用户任务完成后会生成一条完成日志
一个用户任务领取奖励后会生成一条奖励发放日志
一个用户任务接取时会生成一条消耗日志
任务重置日志记录系统定期重置任务的情况

4. JSON字段结构

4.1 条件参数模式 (param_schema)

{
  "properties": {
    "seed_ids": {
      "type": "array",
      "items": {"type": "integer"},
      "description": "指定种子ID列表"
    },
    "land_type": {
      "type": "integer",
      "description": "指定土地类型"
    },
    "min_level": {
      "type": "integer",
      "description": "最低等级要求"
    }
  }
}

4.2 显示参数 (display_params)

任务定义表中的display_params字段用于存储与任务显示相关的参数，例如：

{
  "icon": "task_daily_login.png",
  "background": "task_bg_blue.jpg",
  "color_theme": "blue",
  "priority": 100,
  "ui_group": "main",
  "show_progress": true,
  "progress_style": "percentage",
  "show_timer": true,
  "timer_style": "countdown",
  "animation": "pulse",
  "jump_target": "farm",
  "tags": ["new", "hot", "limited"],
  "client_custom": {
    "show_in_dashboard": true,
    "notification_enabled": true,
    "highlight_effect": "glow"
  }
}

4.3 奖励内容 (extra_data)

任务奖励定义表中的extra_data字段可以存储额外的奖励信息，例如：

{
  "display_name": "高级化肥礼包",
  "icon_url": "items/fertilizer_premium.png",
  "description": "包含多种高级化肥的礼包",
  "unlock_requirements": {
    "level": 10,
    "vip": 2
  }
}

4.4 前置任务 (prerequisite_tasks)

{
  "required_tasks": [101, 102],     // 必须完成的任务ID
  "optional_tasks": [103, 104],     // 可选完成的任务ID
  "min_optional_count": 1           // 最少需要完成的可选任务数
}

5. 索引设计考虑

5.1 高频查询场景

获取用户当前进行中的任务
- 使用 idx_user_status 索引优化
获取特定类型的可用任务
- 使用 idx_type 和 idx_active_time 索引优化
检查用户是否完成特定任务
- 使用 idx_user_task 索引优化
获取即将过期的任务
- 使用 idx_expire 索引优化

5.2 写入优化

任务进度更新是高频操作，使用 task_user_progress 表分担 task_user_tasks 表的写入压力
日志表（task_completion_logs, task_reward_logs）可考虑按时间分区，提高写入性能

6. 数据迁移与升级策略

使用Laravel迁移文件管理表结构
版本化迁移文件，支持回滚
大型结构变更时考虑分步迁移，减少对系统的影响

7. 任务定义相关设计

7.1 前置条件与进度条件的区别

7.1.1 前置条件

前置条件是指用户必须满足才能接取任务的条件，但不计入任务的完成进度。前置条件的特点：

检查时机：在用户接取任务时检查
完成状态：只有“满足/不满足”两种状态，没有进度概念
典型例子：
- 用户等级要求（如“需要等级10级才能接取”）
- 前置任务要求（如“需要完成任务A才能接取”）
- 特定物品要求（如“需要拥有特定物品才能接取”）

7.1.2 进度条件

进度条件是指用户需要完成才能完成任务的条件，有明确的进度计算。进度条件的特点：

进度跟踪：有明确的当前值和目标值
动态更新：随着用户操作不断更新进度
典型例子：
- 种植作物（如“种植5次小麦”）
- 收获作物（如“收获10个苹果”）
- 使用物品（如“使用3次化肥”）

7.1.3 处理流程差异

前置条件处理：
- 在用户尝试接取任务时检查
- 如果不满足，拒绝接取并返回原因
- 不需要记录进度
进度条件处理：
- 接取任务后持续跟踪
- 根据用户操作更新进度
- 在用户任务进度表中记录当前值
- 当所有必要的进度条件都满足时，完成任务

7.2 任务类型设计

任务模块支持多种任务类型，每种类型有不同的特性和重置规则：

日常任务（daily）：每天重置，通常是简单的日常活动
每周任务（weekly）：每周重置，通常难度较高，奖励也更丰厚
成就任务（achievement）：不重置，只能完成一次，通常是长期目标
活动任务（event）：与特定活动关联，有明确的开始和结束时间
教程任务（tutorial）：新手引导任务，帮助用户学习游戏机制
团队任务（team）：需要多个用户合作完成的任务

8. 任务完成相关设计

8.1 条件处理器设计

每种条件类型都有一个对应的处理器类，负责验证和更新该类型条件的进度。

8.1.1 条件处理器接口

interface ConditionHandlerInterface
{
    /**
     * 验证事件是否满足条件
     *
     * @param array $event 事件数据
     * @param array $params 条件参数
     * @return bool
     */
    public function matches(array $event, array $params): bool;

    /**
     * 计算事件对条件进度的贡献值
     *
     * @param array $event 事件数据
     * @param array $params 条件参数
     * @return int
     */
    public function calculateProgress(array $event, array $params): int;

    /**
     * 检查条件是否已完成
     *
     * @param int $currentValue 当前值
     * @param int $targetValue 目标值
     * @param string $operator 运算符
     * @return bool
     */
    public function isCompleted(int $currentValue, int $targetValue, string $operator): bool;
}

8.1.2 基础条件处理器

abstract class BaseConditionHandler implements ConditionHandlerInterface
{
    /**
     * 检查条件是否已完成
     *
     * @param int $currentValue 当前值
     * @param int $targetValue 目标值
     * @param string $operator 运算符
     * @return bool
     */
    public function isCompleted(int $currentValue, int $targetValue, string $operator): bool
    {
        switch ($operator) {
            case '=':
                return $currentValue == $targetValue;
            case '>=':
                return $currentValue >= $targetValue;
            case '>':
                return $currentValue > $targetValue;
            case '<=':
                return $currentValue <= $targetValue;
            case '<':
                return $currentValue < $targetValue;
            default:
                return false;
        }
    }
}

8.2 任务进度更新流程

8.2.1 事件触发

用户执行操作（如登录、种植、收获等）
系统触发相应的事件

8.2.2 条件匹配

任务服务接收事件
查找与事件相关的所有活跃任务的进度条件
对每个条件，调用对应的处理器验证事件是否匹配

8.2.3 进度更新

对于匹配的条件，计算进度贡献值
更新用户任务进度表中的当前值
检查条件是否已完成

8.2.4 任务完成检查

当进度条件完成时，检查任务的所有必要的进度条件是否都已完成
如果所有必要的进度条件都已完成，将任务标记为已完成
触发任务完成事件

8.3 任务奖励领取流程

用户完成任务后，可以领取奖励
系统验证任务是否已完成且奖励未领取
发放奖励到用户账户
更新任务状态为已领取奖励
记录奖励发放日志

9. 任务示例

9.1 简单任务：每日登录

任务名称：每日登录
任务描述：今天登录游戏
任务类型：daily
条件：
  - 类型：login
  - 目标值：1
  - 参数：{}
  - 运算符：=
奖励：
  - 类型：currency
  - 奖励ID：1（金币）
  - 数量：100

9.2 多条件任务：农场管理

任务名称：农场管理大师
任务描述：种植3种不同作物，收获10次，升级1次土地
任务类型：weekly
条件：
  - 类型：plant
    目标值：3
    参数：{"seed_ids": [101, 102, 103, 104, 105]}
    运算符：>=
    是否必须：是
  - 类型：harvest
    目标值：10
    参数：{}
    运算符：>=
    是否必须：是
  - 类型：upgrade_land
    目标值：1
    参数：{}
    运算符：>=
    是否必须：是
奖励：
  - 类型：item
  - 奖励ID：2001（高级化肥）
  - 数量：3
  - 类型：currency
  - 奖励ID：1（金币）
  - 数量：500

9.3 带前置条件的任务示例

任务名称：高级农场主
任务描述：已经达到农场等级10级的玩家，可以尝试种植高级作物
任务类型：achievement
前置条件：
  - 类型：level_check
    目标值：10
    参数：{"level_type": "farm"}
    运算符：>=
    条件类型：prerequisite
  - 类型：task_completed
    目标值：1
    参数：{"task_ids": [101, 102]}
    运算符：>=
    条件类型：prerequisite
进度条件：
  - 类型：plant
    目标值：5
    参数：{"seed_ids": [201, 202]}
    运算符：>=
    条件类型：progress
    是否必须：是
  - 类型：harvest
    目标值：20
    参数：{"crop_ids": [301, 302]}
    运算符：>=
    条件类型：progress
    是否必须：是
奖励：
  - 类型：item
  - 奖励ID：3001（稀有种子）
  - 数量：1
  - 类型：currency
  - 奖励ID：1（金币）
  - 数量：1000

10. 日志记录相关设计

10.1 日志记录目的

审计追踪：记录用户任务完成和奖励领取的详细信息，便于后续审计和问题排查
数据分析：为游戏运营提供数据支持，分析用户行为和任务完成情况
安全保障：防止奖励重复发放，记录关键操作的IP和设备信息

10.2 日志记录策略

完成日志：记录任务完成的时间、耗时等信息
奖励日志：记录奖励发放的详细内容和时间
重置日志：记录系统定期重置任务的情况

10.3 日志数据维护

10.3.1 数据清理策略

定期清理过期的用户任务数据（可设置保留期限）
日志表数据可考虑归档处理
使用软删除机制，避免直接删除重要数据

10.3.2 数据备份策略

与系统整体备份策略保持一致
关键操作前进行数据备份
定期验证备份数据的完整性

数据库设计.md 29 KB 文件歷史 原始文件

任务模块数据库设计

1. 数据库表概览

1.1 任务定义相关表

1.2 任务完成相关表

1.3 日志记录相关表

2. 表结构详细设计

2.1 任务定义相关表

2.1.1 任务分类表 (task_categories)

2.1.2 任务定义表 (task_tasks)

2.1.3 任务奖励定义表 (task_rewards)

2.1.4 任务接取消耗表 (task_costs)

2.1.5 任务条件表 (task_conditions)

2.1.6 任务达成条件表 (task_achievement_conditions)

2.2 任务完成相关表

2.2.1 用户任务关联表 (task_user_tasks)

2.2.2 用户任务进度表 (task_user_progress)

2.3 日志记录相关表

2.3.1 任务完成日志表 (task_completion_logs)

2.3.2 任务奖励发放日志表 (task_reward_logs)

2.3.3 任务消耗日志表 (task_cost_logs)

2.3.4 任务重置日志表 (task_reset_logs)

3. 数据关系

3.1 数据关系图

3.2 文本关系图

3.3 关系说明

4. JSON字段结构

4.1 条件参数模式 (param_schema)

4.2 显示参数 (display_params)

4.3 奖励内容 (extra_data)

4.4 前置任务 (prerequisite_tasks)

5. 索引设计考虑

5.1 高频查询场景

5.2 写入优化

6. 数据迁移与升级策略

7. 任务定义相关设计

7.1 前置条件与进度条件的区别

7.1.1 前置条件

7.1.2 进度条件

7.1.3 处理流程差异

7.2 任务类型设计

8. 任务完成相关设计

8.1 条件处理器设计

8.1.1 条件处理器接口

8.1.2 基础条件处理器

8.2 任务进度更新流程

8.2.1 事件触发

8.2.2 条件匹配

8.2.3 进度更新

8.2.4 任务完成检查

8.3 任务奖励领取流程

9. 任务示例

9.1 简单任务：每日登录

9.2 多条件任务：农场管理

9.3 带前置条件的任务示例

10. 日志记录相关设计

10.1 日志记录目的

10.2 日志记录策略

10.3 日志数据维护

10.3.1 数据清理策略

10.3.2 数据备份策略

数据库设计.md 29 KB

文件歷史原始文件