数据库设计.md 20 KB
农场模块数据库设计
1. 数据库表概览
农场模块包含以下核心数据表：
- farm_users - 用户农场信息表
- farm_god_buffs - 神灵加持表
- farm_lands - 土地信息表
- farm_crops - 作物信息表
- farm_seeds - 种子配置表
- farm_house_configs - 房屋等级配置表
- farm_land_types - 土地类型配置表
- farm_land_upgrade_configs - 土地升级配置表
- farm_harvest_logs - 收获记录表
- farm_upgrade_logs - 升级记录表
- farm_user_referrals - 用户推荐关系表
- farm_user_talents - 达人等级表
- farm_team_profits - 团队收益记录表
2. 表结构详细设计
2.1 用户农场表 (farm_users)
存储用户的农场基本信息，包括房屋等级等。
CREATE TABLE `farm_users` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`user_id` bigint(20) NOT NULL COMMENT '用户ID',
`house_level` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '房屋等级',
`last_upgrade_time` timestamp NULL DEFAULT NULL COMMENT '最后升级时间',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_user_id` (`user_id`),
KEY `idx_house_level` (`house_level`),
KEY `idx_last_upgrade_time` (`last_upgrade_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户农场信息表';
2.2 神灵加持表 (farm_god_buffs)
存储用户的神灵加持状态，包括加持类型和过期时间。
CREATE TABLE `farm_god_buffs` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`user_id` bigint(20) NOT NULL COMMENT '用户ID',
`buff_type` tinyint(3) unsigned NOT NULL COMMENT 'buff类型:1丰收之神,2雨露之神,3屠草之神,4拭虫之神',
`expire_time` timestamp NOT NULL COMMENT '过期时间',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_expire_time` (`expire_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='神灵加持表';
2.3 土地表 (farm_lands)
存储用户的土地信息，包括位置、类型和状态。
CREATE TABLE `farm_lands` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`user_id` bigint(20) NOT NULL COMMENT '用户ID',
`position` tinyint(3) unsigned NOT NULL COMMENT '土地位置(1-20)',
`land_type` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '土地类型:1普通,2红土,3黑土,4金,5蓝,6紫',
`status` tinyint(3) unsigned NOT NULL DEFAULT '0' COMMENT '土地状态:0空闲,1种植中,2灾害,3可收获,4枯萎',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_user_position` (`user_id`,`position`),
KEY `idx_user_id` (`user_id`),
KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='土地信息表';
2.4 作物表 (farm_crops)
存储种植的作物信息，包括生长阶段、灾害等。
CREATE TABLE `farm_crops` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`land_id` bigint(20) unsigned NOT NULL COMMENT '土地ID',
`user_id` bigint(20) NOT NULL COMMENT '用户ID',
`seed_id` bigint(20) unsigned NOT NULL COMMENT '种子ID',
`plant_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '种植时间',
`growth_stage` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '生长阶段:1种子期,2发芽期,3生长期,4成熟期,5枯萎期',
`stage_end_time` timestamp NULL DEFAULT NULL COMMENT '当前阶段结束时间',
`disasters` json DEFAULT NULL COMMENT '灾害情况',
`fertilized` tinyint(1) NOT NULL DEFAULT '0' COMMENT '当前阶段是否已使用化肥',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_land_id` (`land_id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_seed_id` (`seed_id`),
KEY `idx_growth_stage` (`growth_stage`),
KEY `idx_stage_end_time` (`stage_end_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='作物信息表';
2.5 种子表 (farm_seeds)
存储种子的基本配置信息。
CREATE TABLE `farm_seeds` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`name` varchar(50) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '种子名称',
`type` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '种子类型:1普通,2神秘,3巨化',
`seed_time` int(10) unsigned NOT NULL COMMENT '种子期时间(秒)',
`sprout_time` int(10) unsigned NOT NULL COMMENT '发芽期时间(秒)',
`growth_time` int(10) unsigned NOT NULL COMMENT '生长期时间(秒)',
`min_output` int(10) unsigned NOT NULL COMMENT '最小产出',
`max_output` int(10) unsigned NOT NULL COMMENT '最大产出',
`disaster_resistance` json DEFAULT NULL COMMENT '灾害抵抗',
`display_attributes` json DEFAULT NULL COMMENT '显示属性',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_type` (`type`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='种子配置表';
2.6 房屋等级配置表 (farm_house_configs)
存储不同房屋等级的配置信息。
CREATE TABLE `farm_house_configs` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`level` tinyint(3) unsigned NOT NULL COMMENT '等级',
`output_bonus` decimal(5,2) NOT NULL DEFAULT '0.00' COMMENT '产出加成',
`special_land_limit` tinyint(3) unsigned NOT NULL DEFAULT '0' COMMENT '特殊土地上限',
`upgrade_materials` json NOT NULL COMMENT '升级所需材料',
`downgrade_days` int(10) unsigned DEFAULT NULL COMMENT '降级天数,NULL表示不降级',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_level` (`level`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='房屋等级配置表';
2.7 土地类型配置表 (farm_land_types)
存储不同土地类型的属性，如产量加成、灾害抵抗等。
CREATE TABLE `farm_land_types` (
`id` tinyint(3) unsigned NOT NULL AUTO_INCREMENT COMMENT '土地类型ID',
`name` varchar(50) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '土地类型名称',
`code` varchar(20) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '土地类型编码',
`output_bonus` decimal(5,2) NOT NULL DEFAULT '0.00' COMMENT '产量加成',
`disaster_resistance` decimal(5,2) NOT NULL DEFAULT '0.00' COMMENT '灾害抵抗',
`unlock_house_level` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '解锁所需房屋等级',
`is_special` tinyint(1) NOT NULL DEFAULT '0' COMMENT '是否为特殊土地',
`icon` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '图标路径',
`description` text COLLATE utf8mb4_unicode_ci COMMENT '描述',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_code` (`code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='土地类型配置表';
2.8 土地升级配置表 (farm_land_upgrade_configs)
存储土地升级路径和所需材料。
CREATE TABLE `farm_land_upgrade_configs` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`from_type_id` tinyint(3) unsigned NOT NULL COMMENT '起始土地类型ID',
`to_type_id` tinyint(3) unsigned NOT NULL COMMENT '目标土地类型ID',
`materials` json NOT NULL COMMENT '升级所需材料',
`conditions` json DEFAULT NULL COMMENT '其他升级条件',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_from_to` (`from_type_id`,`to_type_id`),
KEY `idx_from_type` (`from_type_id`),
KEY `idx_to_type` (`to_type_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='土地升级配置表';
2.9 收获记录表 (farm_harvest_logs)
记录作物收获的历史数据。
CREATE TABLE `farm_harvest_logs` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`user_id` bigint(20) NOT NULL COMMENT '用户ID',
`land_id` bigint(20) unsigned NOT NULL COMMENT '土地ID',
`crop_id` bigint(20) unsigned NOT NULL COMMENT '作物ID',
`seed_id` bigint(20) unsigned NOT NULL COMMENT '种子ID',
`output_amount` int(10) unsigned NOT NULL COMMENT '产出数量',
`harvest_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '收获时间',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
PRIMARY KEY (`id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_harvest_time` (`harvest_time`),
KEY `idx_seed_id` (`seed_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='收获记录表';
2.8 升级记录表 (farm_upgrade_logs)
记录土地和房屋升级的历史数据。
CREATE TABLE `farm_upgrade_logs` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`user_id` bigint(20) NOT NULL COMMENT '用户ID',
`upgrade_type` tinyint(3) unsigned NOT NULL COMMENT '升级类型:1土地,2房屋',
`target_id` bigint(20) unsigned DEFAULT NULL COMMENT '目标ID(土地ID)',
`old_level` tinyint(3) unsigned NOT NULL COMMENT '旧等级/类型',
`new_level` tinyint(3) unsigned NOT NULL COMMENT '新等级/类型',
`materials_consumed` json NOT NULL COMMENT '消耗的材料',
`upgrade_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '升级时间',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
PRIMARY KEY (`id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_upgrade_time` (`upgrade_time`),
KEY `idx_upgrade_type` (`upgrade_type`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='升级记录表';
2.9 用户推荐关系表 (farm_user_referrals)
存储用户之间的推荐关系，包括直推和间推关系。
CREATE TABLE `farm_user_referrals` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`user_id` bigint(20) NOT NULL COMMENT '用户ID',
`referrer_id` bigint(20) NOT NULL COMMENT '推荐人ID',
`level` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '推荐层级:1直推,2间推',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_user_referrer` (`user_id`,`referrer_id`),
KEY `idx_referrer_id` (`referrer_id`),
KEY `idx_user_id` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户推荐关系表';
2.11 达人等级表 (farm_user_talents)
存储用户的达人等级信息，包括直推人数和团队总人数。
CREATE TABLE `farm_user_talents` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`user_id` bigint(20) NOT NULL COMMENT '用户ID',
`talent_level` tinyint(3) unsigned NOT NULL DEFAULT '0' COMMENT '达人等级:0无,1初级,2中级,3高级,4资深,5顶级',
`direct_count` int(11) NOT NULL DEFAULT '0' COMMENT '直推人数',
`team_count` int(11) NOT NULL DEFAULT '0' COMMENT '团队总人数',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_user_id` (`user_id`),
KEY `idx_talent_level` (`talent_level`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='达人等级表';
2.12 团队收益记录表 (farm_team_profits)
记录团队成员收获作物时产生的分成收益。
CREATE TABLE `farm_team_profits` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`user_id` bigint(20) NOT NULL COMMENT '获得收益的用户ID',
`team_member_id` bigint(20) NOT NULL COMMENT '团队成员ID',
`harvest_id` bigint(20) NOT NULL COMMENT '收获记录ID',
`profit_amount` int(11) NOT NULL COMMENT '分成收益数量',
`profit_rate` decimal(5,4) NOT NULL COMMENT '分成比例',
`created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
PRIMARY KEY (`id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_team_member_id` (`team_member_id`),
KEY `idx_harvest_id` (`harvest_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='团队收益记录表';
3. 数据关系
3.1 主要关系图
farm_user_referrals
^
|
|
farm_users (1) ------ (N) farm_lands |
| | |
| | |
| | |
| | |
v v |
farm_house_configs farm_crops |
| |
| |
| |
v |
farm_seeds |
| |
| |
v |
farm_harvest_logs -----+
|
|
v
farm_team_profits
farm_land_types <---- farm_lands
^
|
v
farm_land_upgrade_configs
3.2 关系说明
- 用户与土地：一个用户可以拥有多块土地（1:N）
- 土地与作物：一块土地上最多种植一个作物（1:1）
- 作物与种子：一个作物对应一种种子类型（N:1）
- 用户与房屋：一个用户拥有一个房屋（1:1）
- 房屋与配置：房屋等级对应配置表中的等级（N:1）
- 用户与推荐关系：一个用户可以有多个推荐人和被推荐人（M:N）
- 用户与达人等级：一个用户有一个达人等级记录（1:1）
- 收获与团队收益：一次收获可以产生多条团队收益记录（1:N）
- 土地与土地类型：土地表中的 land_type 字段关联到 farm_land_types 表的 id 字段（N:1）
- 土地升级配置：farm_land_upgrade_configs 表通过 from_type_id 和 to_type_id 字段关联到 farm_land_types 表（M:N）
4. 索引设计
4.1 主键索引
所有表都使用自增的id字段作为主键。
4.2 唯一索引
farm_users:user_id（确保每个用户只有一条农场记录）farm_lands:user_id, position（确保每个用户的土地位置唯一）farm_crops:land_id（确保一块土地只有一个作物）farm_house_configs:level（确保等级唯一）farm_land_types:code（确保土地类型编码唯一）farm_land_upgrade_configs:from_type_id, to_type_id（确保升级路径唯一）farm_user_referrals:user_id, referrer_id（确保推荐关系不重复）farm_user_talents:user_id（确保每个用户只有一条达人记录）
4.3 普通索引
farm_users:house_level,last_upgrade_timefarm_lands:user_id,status,land_typefarm_crops:user_id,seed_id,growth_stage,stage_end_timefarm_seeds:typefarm_land_types:is_special,unlock_house_levelfarm_land_upgrade_configs:from_type_id,to_type_idfarm_harvest_logs:user_id,harvest_time,seed_idfarm_upgrade_logs:user_id,upgrade_time,upgrade_type
5. JSON字段结构
5.1 灾害JSON (disasters)
{
"disasters": [
{
"type": 1,
"occurred_at": "2023-05-01 12:00:00"
},
{
"type": 3,
"occurred_at": "2023-05-01 14:30:00"
}
]
}
5.2 升级材料JSON (upgrade_materials)
{
"materials": [
{"item_id": 1001, "amount": 20},
{"item_id": 1002, "amount": 10}
]
}
5.3 灾害抵抗JSON (disaster_resistance)
{
"drought": 0.1,
"pest": 0.05,
"weed": 0.15
}
5.4 显示属性JSON (display_attributes)
{
"icon": "seed_icon_001.png",
"color": "#FF5500",
"description": "一种生长迅速的萝卜种子，适合新手种植。"
}
5.5 土地升级条件JSON (conditions)
{
"house_level_min": 7,
"special_land_check": true,
"user_level_min": 10,
"quest_completed": [101, 102],
"time_limited": {
"start_time": "2023-01-01 00:00:00",
"end_time": "2023-12-31 23:59:59"
}
}
6. 数据初始化
6.1 种子数据
初始化基本的种子数据，包括普通种子、神秘种子和巨化种子。
6.2 房屋配置数据
初始化12级房屋的配置数据，包括产出加成、特殊土地上限、升级材料和降级天数。
6.3 土地类型配置数据
初始化土地类型配置数据：
INSERT INTO `farm_land_types` (`id`, `name`, `code`, `output_bonus`, `disaster_resistance`, `unlock_house_level`, `is_special`) VALUES
(1, '普通土地', 'NORMAL', 0.00, 0.00, 1, 0),
(2, '红土地', 'RED', 0.10, 0.05, 1, 0),
(3, '黑土地', 'BLACK', 0.25, 0.10, 1, 0),
(4, '金色特殊土地', 'GOLD', 0.50, 0.15, 7, 1),
(5, '蓝色特殊土地', 'BLUE', 0.40, 0.25, 7, 1),
(6, '紫色特殊土地', 'PURPLE', 0.60, 0.10, 7, 1);
6.4 土地升级配置数据
初始化土地升级配置数据：
INSERT INTO `farm_land_upgrade_configs` (`from_type_id`, `to_type_id`, `materials`, `conditions`) VALUES
(1, 2, '{"materials": [{"item_name": "木材", "amount": 10}]}', NULL),
(2, 3, '{"materials": [{"item_name": "石材", "amount": 10}]}', NULL),
(3, 4, '{"materials": [{"item_name": "钢材", "amount": 10}, {"item_name": "钻石", "amount": 5}]}', '{"house_level_min": 7, "special_land_check": true}'),
(3, 5, '{"materials": [{"item_name": "钢材", "amount": 10}, {"item_name": "钻石", "amount": 5}]}', '{"house_level_min": 7, "special_land_check": true}'),
(3, 6, '{"materials": [{"item_name": "钢材", "amount": 10}, {"item_name": "钻石", "amount": 5}]}', '{"house_level_min": 7, "special_land_check": true}');
6.5 新用户初始化
新用户注册时，需要：
- 创建用户农场记录，设置房屋等级为1
- 创建6块初始普通土地，位置为1-6
7. 数据维护
7.1 定期任务
- 作物生长更新：定期检查和更新作物生长阶段
- 灾害生成：定期为生长中的作物生成灾害
- 房屋降级检查：定期检查和处理房屋降级
7.2 数据清理
- 收获记录清理：定期归档或清理过旧的收获记录
- 升级记录清理：定期归档或清理过旧的升级记录
7.3 数据备份
定期备份关键数据表，特别是配置表和用户数据表。
8. 性能优化
8.1 分表策略
当用户数量增长到一定规模时，可以考虑按用户ID范围对farm_lands、farm_crops和farm_harvest_logs表进行分表。
8.2 缓存策略
- 缓存种子配置和房屋配置等静态数据
- 缓存用户农场和土地信息等频繁访问的数据
8.3 批量操作
使用批量插入和更新操作处理大量数据，如批量更新作物生长状态。