移除废弃模块

app/Module/SocialFarm/Databases/createsql/social_farm_tables.sql

@@ -1,202 +0,0 @@
--- SocialFarm模块数据表创建SQL
--- 创建时间: 2025-07-02
--- 模块: SocialFarm
--- 描述: 社交农场系统相关数据表
-
--- 1. 偷菜记录表
-CREATE TABLE `kku_social_farm_steal_logs` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `stealer_id` bigint(20) unsigned NOT NULL COMMENT '偷菜者用户ID',
-  `owner_id` bigint(20) unsigned NOT NULL COMMENT '农场主用户ID',
-  `land_id` bigint(20) unsigned NOT NULL COMMENT '被偷的土地ID',
-  `crop_id` bigint(20) unsigned NOT NULL COMMENT '被偷的作物ID',
-  `item_id` bigint(20) unsigned NOT NULL COMMENT '偷到的物品ID',
-  `item_amount` int(11) NOT NULL DEFAULT '0' COMMENT '偷到的物品数量',
-  `original_amount` int(11) NOT NULL DEFAULT '0' COMMENT '作物原始数量',
-  `steal_ratio` decimal(5,4) NOT NULL DEFAULT '0.0000' COMMENT '偷菜比例',
-  `steal_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '偷菜时间',
-  `steal_status` tinyint(4) NOT NULL DEFAULT '1' COMMENT '偷菜状态:1成功,2失败,3被保护',
-  `ip_address` varchar(45) DEFAULT NULL COMMENT '偷菜者IP地址',
-  `user_agent` text COMMENT '用户代理信息',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  KEY `idx_stealer_time` (`stealer_id`, `steal_time`),
-  KEY `idx_owner_time` (`owner_id`, `steal_time`),
-  KEY `idx_land_crop` (`land_id`, `crop_id`),
-  KEY `idx_steal_status` (`steal_status`, `steal_time`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='偷菜记录表';
-
--- 2. 农场访问记录表
-CREATE TABLE `kku_social_farm_visit_logs` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `visitor_id` bigint(20) unsigned NOT NULL COMMENT '访问者用户ID',
-  `owner_id` bigint(20) unsigned NOT NULL COMMENT '农场主用户ID',
-  `visit_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '访问时间',
-  `visit_type` tinyint(4) NOT NULL DEFAULT '1' COMMENT '访问类型:1普通访问,2偷菜访问,3互助访问',
-  `actions` json DEFAULT NULL COMMENT '访问期间的行为记录',
-  `duration` int(11) NOT NULL DEFAULT '0' COMMENT '访问持续时间(秒)',
-  `steal_count` int(11) NOT NULL DEFAULT '0' COMMENT '本次访问偷菜次数',
-  `help_count` int(11) NOT NULL DEFAULT '0' COMMENT '本次访问互助次数',
-  `ip_address` varchar(45) DEFAULT NULL COMMENT '访问者IP地址',
-  `user_agent` text COMMENT '用户代理信息',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  KEY `idx_visitor_time` (`visitor_id`, `visit_time`),
-  KEY `idx_owner_time` (`owner_id`, `visit_time`),
-  KEY `idx_visit_type` (`visit_type`, `visit_time`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='农场访问记录表';
-
--- 3. 社交设置表
-CREATE TABLE `kku_social_farm_settings` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `user_id` bigint(20) unsigned NOT NULL COMMENT '用户ID',
-  `allow_steal` tinyint(4) NOT NULL DEFAULT '1' COMMENT '允许偷菜:1允许,0禁止',
-  `allow_help` tinyint(4) NOT NULL DEFAULT '1' COMMENT '允许互助:1允许,0禁止',
-  `allow_visit` tinyint(4) NOT NULL DEFAULT '1' COMMENT '允许访问:1允许,0禁止',
-  `steal_protection_hours` int(11) NOT NULL DEFAULT '0' COMMENT '偷菜保护时长(小时)',
-  `daily_steal_limit` int(11) NOT NULL DEFAULT '10' COMMENT '每日被偷次数限制',
-  `daily_help_limit` int(11) NOT NULL DEFAULT '20' COMMENT '每日被帮助次数限制',
-  `notification_enabled` tinyint(4) NOT NULL DEFAULT '1' COMMENT '通知开关:1开启,0关闭',
-  `auto_revenge` tinyint(4) NOT NULL DEFAULT '0' COMMENT '自动反偷:1开启,0关闭',
-  `friend_only` tinyint(4) NOT NULL DEFAULT '1' COMMENT '仅好友可访问:1是,0否',
-  `blacklist_users` json DEFAULT NULL COMMENT '黑名单用户ID列表',
-  `whitelist_users` json DEFAULT NULL COMMENT '白名单用户ID列表',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_user_id` (`user_id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='社交农场设置表';
-
--- 4. 互助记录表
-CREATE TABLE `kku_social_farm_help_logs` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `helper_id` bigint(20) unsigned NOT NULL COMMENT '帮助者用户ID',
-  `owner_id` bigint(20) unsigned NOT NULL COMMENT '农场主用户ID',
-  `land_id` bigint(20) unsigned NOT NULL COMMENT '帮助的土地ID',
-  `help_type` tinyint(4) NOT NULL COMMENT '帮助类型:1浇水,2施肥,3除草,4杀虫,5收获',
-  `help_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '帮助时间',
-  `item_consumed_id` bigint(20) unsigned DEFAULT NULL COMMENT '消耗的道具ID',
-  `item_consumed_amount` int(11) NOT NULL DEFAULT '0' COMMENT '消耗的道具数量',
-  `reward_item_id` bigint(20) unsigned DEFAULT NULL COMMENT '奖励物品ID',
-  `reward_amount` int(11) NOT NULL DEFAULT '0' COMMENT '奖励数量',
-  `exp_reward` int(11) NOT NULL DEFAULT '0' COMMENT '经验奖励',
-  `help_effect` json DEFAULT NULL COMMENT '帮助效果详情',
-  `ip_address` varchar(45) DEFAULT NULL COMMENT '帮助者IP地址',
-  `user_agent` text COMMENT '用户代理信息',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  KEY `idx_helper_time` (`helper_id`, `help_time`),
-  KEY `idx_owner_time` (`owner_id`, `help_time`),
-  KEY `idx_land_type` (`land_id`, `help_type`),
-  KEY `idx_help_type` (`help_type`, `help_time`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='互助记录表';
-
--- 5. 社交统计表
-CREATE TABLE `kku_social_farm_stats` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `user_id` bigint(20) unsigned NOT NULL COMMENT '用户ID',
-  `stat_date` date NOT NULL COMMENT '统计日期',
-  `steal_count` int(11) NOT NULL DEFAULT '0' COMMENT '偷菜次数',
-  `stolen_count` int(11) NOT NULL DEFAULT '0' COMMENT '被偷次数',
-  `help_count` int(11) NOT NULL DEFAULT '0' COMMENT '帮助次数',
-  `helped_count` int(11) NOT NULL DEFAULT '0' COMMENT '被帮助次数',
-  `visit_count` int(11) NOT NULL DEFAULT '0' COMMENT '访问次数',
-  `visited_count` int(11) NOT NULL DEFAULT '0' COMMENT '被访问次数',
-  `steal_items_gained` int(11) NOT NULL DEFAULT '0' COMMENT '偷菜获得物品数',
-  `steal_items_lost` int(11) NOT NULL DEFAULT '0' COMMENT '被偷失去物品数',
-  `help_rewards_gained` int(11) NOT NULL DEFAULT '0' COMMENT '互助获得奖励数',
-  `total_exp_gained` int(11) NOT NULL DEFAULT '0' COMMENT '总经验获得',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_user_date` (`user_id`, `stat_date`),
-  KEY `idx_stat_date` (`stat_date`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='社交农场统计表';
-
--- 6. 偷菜保护记录表
-CREATE TABLE `kku_social_farm_protections` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `user_id` bigint(20) unsigned NOT NULL COMMENT '用户ID',
-  `land_id` bigint(20) unsigned DEFAULT NULL COMMENT '土地ID(NULL表示全农场保护)',
-  `protection_type` tinyint(4) NOT NULL COMMENT '保护类型:1时间保护,2道具保护,3系统保护',
-  `start_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '保护开始时间',
-  `end_time` timestamp NOT NULL COMMENT '保护结束时间',
-  `protection_item_id` bigint(20) unsigned DEFAULT NULL COMMENT '保护道具ID',
-  `is_active` tinyint(4) NOT NULL DEFAULT '1' COMMENT '是否激活:1激活,0失效',
-  `created_by` bigint(20) unsigned DEFAULT NULL COMMENT '创建者ID',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  KEY `idx_user_active` (`user_id`, `is_active`),
-  KEY `idx_land_active` (`land_id`, `is_active`),
-  KEY `idx_end_time` (`end_time`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='偷菜保护记录表';
-
--- 插入默认配置数据
--- 注意：实际使用时需要根据具体需求调整这些默认值
-
--- 为现有用户创建默认社交设置（如果需要）
--- INSERT INTO kku_social_farm_settings (user_id) 
--- SELECT id FROM kku_users 
--- WHERE id NOT IN (SELECT user_id FROM kku_social_farm_settings);
-
--- 创建索引优化查询性能
--- 这些索引在表创建时已经包含，这里仅作为说明
-
--- 偷菜记录表的复合索引
--- ALTER TABLE kku_social_farm_steal_logs ADD INDEX idx_stealer_owner_time (stealer_id, owner_id, steal_time);
-
--- 访问记录表的复合索引  
--- ALTER TABLE kku_social_farm_visit_logs ADD INDEX idx_visitor_owner_time (visitor_id, owner_id, visit_time);
-
--- 互助记录表的复合索引
--- ALTER TABLE kku_social_farm_help_logs ADD INDEX idx_helper_owner_time (helper_id, owner_id, help_time);
-
--- 统计表的日期范围索引
--- ALTER TABLE kku_social_farm_stats ADD INDEX idx_user_date_range (user_id, stat_date);
-
--- 保护表的时间范围索引
--- ALTER TABLE kku_social_farm_protections ADD INDEX idx_time_range (start_time, end_time);
-
--- 创建视图用于常用查询（可选）
-
--- 用户每日偷菜统计视图
-CREATE VIEW v_daily_steal_stats AS
-SELECT 
-    user_id,
-    DATE(steal_time) as steal_date,
-    COUNT(*) as steal_count,
-    SUM(item_amount) as total_items
-FROM kku_social_farm_steal_logs 
-WHERE steal_status = 1
-GROUP BY user_id, DATE(steal_time);
-
--- 用户社交活跃度视图
-CREATE VIEW v_user_social_activity AS
-SELECT 
-    u.id as user_id,
-    u.nickname,
-    COALESCE(s.steal_count, 0) as today_steal_count,
-    COALESCE(s.help_count, 0) as today_help_count,
-    COALESCE(s.visit_count, 0) as today_visit_count,
-    COALESCE(settings.allow_steal, 1) as allow_steal,
-    COALESCE(settings.allow_help, 1) as allow_help,
-    COALESCE(settings.allow_visit, 1) as allow_visit
-FROM kku_users u
-LEFT JOIN kku_social_farm_stats s ON u.id = s.user_id AND s.stat_date = CURDATE()
-LEFT JOIN kku_social_farm_settings settings ON u.id = settings.user_id;
-
--- 添加表注释说明
-ALTER TABLE kku_social_farm_steal_logs COMMENT = '偷菜记录表 - 记录所有偷菜行为的详细信息';
-ALTER TABLE kku_social_farm_visit_logs COMMENT = '农场访问记录表 - 记录用户访问好友农场的行为';
-ALTER TABLE kku_social_farm_settings COMMENT = '社交设置表 - 存储用户的社交农场相关设置';
-ALTER TABLE kku_social_farm_help_logs COMMENT = '互助记录表 - 记录用户间的互助行为';
-ALTER TABLE kku_social_farm_stats COMMENT = '社交统计表 - 记录用户的社交行为统计数据';
-ALTER TABLE kku_social_farm_protections COMMENT = '偷菜保护记录表 - 记录偷菜保护状态';
-
--- 数据表创建完成
--- 请根据实际需求调整表结构和索引策略
--- 建议在生产环境部署前进行充分的性能测试

app/Module/SocialFarm/Docs/API接口文档.md

@@ -1,448 +0,0 @@
-# SocialFarm模块API接口文档
-
-## 概述
-
-SocialFarm模块提供社交农场功能的API接口，包括偷菜、互助、访问等功能。所有接口都需要用户认证。
-
-## 基础信息
-
-- **模块路径**: `/api/social-farm`
-- **认证方式**: Bearer Token
-- **响应格式**: JSON
-- **字符编码**: UTF-8
-
-## 通用响应格式
-
-### 成功响应
-```json
-{
-    "success": true,
-    "data": {
-        // 具体数据
-    },
-    "message": "操作成功"
-}
-```
-
-### 失败响应
-```json
-{
-    "success": false,
-    "code": "ERROR_CODE",
-    "message": "错误描述",
-    "data": null
-}
-```
-
-## 接口列表
-
-### 1. 获取可偷菜的好友列表
-
-**接口地址**: `GET /api/social-farm/stealable-friends`
-
-**功能描述**: 获取当前用户可以偷菜的好友列表
-
-**请求参数**: 无
-
-**响应示例**:
-```json
-{
-    "success": true,
-    "data": [
-        {
-            "user_id": 123,
-            "nickname": "农场主小明",
-            "avatar": "https://example.com/avatar.jpg",
-            "level": 15,
-            "stealable_count": 3,
-            "last_visit_time": "2025-07-02 10:30:00"
-        }
-    ]
-}
-```
-
-### 2. 访问好友农场
-
-**接口地址**: `POST /api/social-farm/visit-farm`
-
-**功能描述**: 访问指定好友的农场
-
-**请求参数**:
-```json
-{
-    "owner_id": 123,
-    "visit_type": 1
-}
-```
-
-**参数说明**:
-- `owner_id`: 农场主用户ID (必填)
-- `visit_type`: 访问类型 (可选，默认1普通访问)
-
-**响应示例**:
-```json
-{
-    "success": true,
-    "data": {
-        "visit_id": 456,
-        "farm_info": {
-            "owner": {
-                "user_id": 123,
-                "nickname": "农场主小明",
-                "level": 15
-            },
-            "lands": [
-                {
-                    "id": 1,
-                    "position_x": 0,
-                    "position_y": 0,
-                    "crop": {
-                        "id": 789,
-                        "item_id": 1001,
-                        "item_name": "胡萝卜",
-                        "growth_stage": 4,
-                        "is_mature": true,
-                        "can_steal": true,
-                        "steal_reason": ""
-                    },
-                    "help_types": [1, 2]
-                }
-            ]
-        },
-        "permissions": {
-            "can_steal": true,
-            "can_help": true,
-            "daily_steal_remaining": 8
-        }
-    }
-}
-```
-
-### 3. 偷菜操作
-
-**接口地址**: `POST /api/social-farm/steal-crop`
-
-**功能描述**: 偷取指定土地的作物
-
-**请求参数**:
-```json
-{
-    "owner_id": 123,
-    "land_id": 456
-}
-```
-
-**参数说明**:
-- `owner_id`: 农场主用户ID (必填)
-- `land_id`: 土地ID (必填)
-
-**响应示例**:
-```json
-{
-    "success": true,
-    "data": {
-        "steal_id": 789,
-        "item_id": 1001,
-        "item_name": "胡萝卜",
-        "item_amount": 5,
-        "original_amount": 20,
-        "steal_ratio": 0.25,
-        "exp_gained": 10,
-        "message": "成功偷到5个胡萝卜！"
-    }
-}
-```
-
-**错误响应示例**:
-```json
-{
-    "success": false,
-    "code": "CROP_NOT_READY",
-    "message": "作物还未成熟，无法偷菜"
-}
-```
-
-### 4. 互助操作
-
-**接口地址**: `POST /api/social-farm/help-friend`
-
-**功能描述**: 帮助好友处理农场事务
-
-**请求参数**:
-```json
-{
-    "owner_id": 123,
-    "land_id": 456,
-    "help_type": 1
-}
-```
-
-**参数说明**:
-- `owner_id`: 农场主用户ID (必填)
-- `land_id`: 土地ID (必填)
-- `help_type`: 帮助类型 (必填，1浇水 2施肥 3除草 4杀虫 5收获)
-
-**响应示例**:
-```json
-{
-    "success": true,
-    "data": {
-        "help_id": 321,
-        "help_type": 1,
-        "help_type_name": "浇水",
-        "exp_gained": 5,
-        "reward_item": {
-            "item_id": 2001,
-            "item_name": "经验药水",
-            "amount": 1
-        },
-        "message": "成功帮助好友浇水，获得5点经验！"
-    }
-}
-```
-
-### 5. 获取用户社交设置
-
-**接口地址**: `GET /api/social-farm/settings`
-
-**功能描述**: 获取当前用户的社交农场设置
-
-**请求参数**: 无
-
-**响应示例**:
-```json
-{
-    "success": true,
-    "data": {
-        "allow_steal": true,
-        "allow_help": true,
-        "allow_visit": true,
-        "steal_protection_hours": 2,
-        "daily_steal_limit": 10,
-        "daily_help_limit": 20,
-        "notification_enabled": true,
-        "auto_revenge": false,
-        "friend_only": true,
-        "blacklist_count": 0,
-        "whitelist_count": 0
-    }
-}
-```
-
-### 6. 更新用户社交设置
-
-**接口地址**: `PUT /api/social-farm/settings`
-
-**功能描述**: 更新当前用户的社交农场设置
-
-**请求参数**:
-```json
-{
-    "allow_steal": true,
-    "allow_help": true,
-    "allow_visit": true,
-    "steal_protection_hours": 2,
-    "daily_steal_limit": 10,
-    "daily_help_limit": 20,
-    "notification_enabled": true,
-    "auto_revenge": false,
-    "friend_only": true
-}
-```
-
-**响应示例**:
-```json
-{
-    "success": true,
-    "data": {
-        "allow_steal": true,
-        "allow_help": true,
-        "allow_visit": true,
-        "steal_protection_hours": 2,
-        "daily_steal_limit": 10,
-        "daily_help_limit": 20,
-        "notification_enabled": true,
-        "auto_revenge": false,
-        "friend_only": true
-    },
-    "message": "设置更新成功"
-}
-```
-
-### 7. 获取社交统计
-
-**接口地址**: `GET /api/social-farm/stats`
-
-**功能描述**: 获取用户的社交行为统计数据
-
-**请求参数**:
-- `date`: 统计日期 (可选，格式：YYYY-MM-DD，默认今天)
-
-**响应示例**:
-```json
-{
-    "success": true,
-    "data": {
-        "steal_count": 5,
-        "stolen_count": 3,
-        "help_count": 8,
-        "helped_count": 6,
-        "visit_count": 12,
-        "visited_count": 9,
-        "steal_items_gained": 25,
-        "steal_items_lost": 15,
-        "help_rewards_gained": 3,
-        "total_exp_gained": 45
-    }
-}
-```
-
-### 8. 获取偷菜记录
-
-**接口地址**: `GET /api/social-farm/steal-logs`
-
-**功能描述**: 获取用户的偷菜记录
-
-**请求参数**:
-- `type`: 记录类型 (可选，steal我偷的 stolen被偷的，默认steal)
-- `page`: 页码 (可选，默认1)
-- `limit`: 每页数量 (可选，默认20)
-
-**响应示例**:
-```json
-{
-    "success": true,
-    "data": {
-        "items": [
-            {
-                "id": 123,
-                "stealer": {
-                    "user_id": 456,
-                    "nickname": "偷菜小能手"
-                },
-                "owner": {
-                    "user_id": 789,
-                    "nickname": "农场主大佬"
-                },
-                "item": {
-                    "item_id": 1001,
-                    "item_name": "胡萝卜",
-                    "amount": 5
-                },
-                "steal_time": "2025-07-02 14:30:00",
-                "steal_status": 1,
-                "steal_status_desc": "偷菜成功"
-            }
-        ],
-        "pagination": {
-            "current_page": 1,
-            "total_pages": 5,
-            "total_items": 100,
-            "per_page": 20
-        }
-    }
-}
-```
-
-### 9. 获取访问记录
-
-**接口地址**: `GET /api/social-farm/visit-logs`
-
-**功能描述**: 获取农场访问记录
-
-**请求参数**:
-- `type`: 记录类型 (可选，visit我访问的 visited被访问的，默认visit)
-- `page`: 页码 (可选，默认1)
-- `limit`: 每页数量 (可选，默认20)
-
-**响应示例**:
-```json
-{
-    "success": true,
-    "data": {
-        "items": [
-            {
-                "id": 456,
-                "visitor": {
-                    "user_id": 123,
-                    "nickname": "访客小明"
-                },
-                "owner": {
-                    "user_id": 789,
-                    "nickname": "农场主大佬"
-                },
-                "visit_time": "2025-07-02 15:20:00",
-                "visit_type": 2,
-                "visit_type_desc": "偷菜访问",
-                "duration": 180,
-                "steal_count": 2,
-                "help_count": 1
-            }
-        ],
-        "pagination": {
-            "current_page": 1,
-            "total_pages": 3,
-            "total_items": 60,
-            "per_page": 20
-        }
-    }
-}
-```
-
-## 错误码说明
-
-| 错误码 | 描述 |
-|--------|------|
-| NO_PERMISSION | 无权限访问 |
-| NOT_FRIEND | 不是好友关系 |
-| FARM_NOT_FOUND | 农场不存在 |
-| LAND_NOT_FOUND | 土地不存在 |
-| CROP_NOT_FOUND | 作物不存在 |
-| CROP_NOT_READY | 作物未成熟 |
-| ALREADY_STOLEN | 作物已被偷过 |
-| STEAL_LIMIT_EXCEEDED | 超过偷菜次数限制 |
-| HELP_LIMIT_EXCEEDED | 超过互助次数限制 |
-| UNDER_PROTECTION | 农场受保护中 |
-| INSUFFICIENT_ITEMS | 道具不足 |
-| INVALID_HELP_TYPE | 无效的帮助类型 |
-| OPERATION_FAILED | 操作失败 |
-
-## 状态码说明
-
-### 偷菜状态 (steal_status)
-- 1: 偷菜成功
-- 2: 偷菜失败
-- 3: 受保护无法偷
-- 4: 无权限偷菜
-- 5: 超过次数限制
-- 6: 作物未成熟
-- 7: 已被偷过
-
-### 访问类型 (visit_type)
-- 1: 普通访问
-- 2: 偷菜访问
-- 3: 互助访问
-- 4: 社交访问
-- 5: 报复访问
-
-### 帮助类型 (help_type)
-- 1: 浇水
-- 2: 施肥
-- 3: 除草
-- 4: 杀虫
-- 5: 收获
-
-## 注意事项
-
-1. **频率限制**: 每个用户每分钟最多调用100次API
-2. **数据缓存**: 农场信息会缓存5分钟，偷菜后立即更新
-3. **事务处理**: 偷菜和互助操作使用数据库事务确保数据一致性
-4. **日志记录**: 所有关键操作都会记录详细日志
-5. **安全验证**: 所有操作前都会验证用户权限和好友关系
-
-## 开发建议
-
-1. **错误处理**: 客户端应该妥善处理各种错误情况
-2. **用户体验**: 建议在操作前显示确认对话框
-3. **数据刷新**: 操作成功后应该刷新相关页面数据
-4. **离线处理**: 网络异常时应该提供重试机制

app/Module/SocialFarm/Docs/数据库设计.md

@@ -1,309 +0,0 @@
-# SocialFarm模块数据库设计
-
-## 概述
-
-SocialFarm模块的数据库设计围绕社交农场互动功能，主要包括偷菜记录、访问记录、互助记录和用户社交设置等核心数据表。
-
-## 数据表设计
-
-### 1. 偷菜记录表 (kku_social_farm_steal_logs)
-
-记录所有偷菜行为的详细信息。
-
-```sql
-CREATE TABLE `kku_social_farm_steal_logs` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `stealer_id` bigint(20) unsigned NOT NULL COMMENT '偷菜者用户ID',
-  `owner_id` bigint(20) unsigned NOT NULL COMMENT '农场主用户ID',
-  `land_id` bigint(20) unsigned NOT NULL COMMENT '被偷的土地ID',
-  `crop_id` bigint(20) unsigned NOT NULL COMMENT '被偷的作物ID',
-  `item_id` bigint(20) unsigned NOT NULL COMMENT '偷到的物品ID',
-  `item_amount` int(11) NOT NULL DEFAULT '0' COMMENT '偷到的物品数量',
-  `original_amount` int(11) NOT NULL DEFAULT '0' COMMENT '作物原始数量',
-  `steal_ratio` decimal(5,4) NOT NULL DEFAULT '0.0000' COMMENT '偷菜比例',
-  `steal_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '偷菜时间',
-  `steal_status` tinyint(4) NOT NULL DEFAULT '1' COMMENT '偷菜状态:1成功,2失败,3被保护',
-  `ip_address` varchar(45) DEFAULT NULL COMMENT '偷菜者IP地址',
-  `user_agent` text COMMENT '用户代理信息',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  KEY `idx_stealer_time` (`stealer_id`, `steal_time`),
-  KEY `idx_owner_time` (`owner_id`, `steal_time`),
-  KEY `idx_land_crop` (`land_id`, `crop_id`),
-  KEY `idx_steal_status` (`steal_status`, `steal_time`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='偷菜记录表';
-```
-
-### 2. 农场访问记录表 (kku_social_farm_visit_logs)
-
-记录用户访问好友农场的行为。
-
-```sql
-CREATE TABLE `kku_social_farm_visit_logs` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `visitor_id` bigint(20) unsigned NOT NULL COMMENT '访问者用户ID',
-  `owner_id` bigint(20) unsigned NOT NULL COMMENT '农场主用户ID',
-  `visit_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '访问时间',
-  `visit_type` tinyint(4) NOT NULL DEFAULT '1' COMMENT '访问类型:1普通访问,2偷菜访问,3互助访问',
-  `actions` json DEFAULT NULL COMMENT '访问期间的行为记录',
-  `duration` int(11) NOT NULL DEFAULT '0' COMMENT '访问持续时间(秒)',
-  `steal_count` int(11) NOT NULL DEFAULT '0' COMMENT '本次访问偷菜次数',
-  `help_count` int(11) NOT NULL DEFAULT '0' COMMENT '本次访问互助次数',
-  `ip_address` varchar(45) DEFAULT NULL COMMENT '访问者IP地址',
-  `user_agent` text COMMENT '用户代理信息',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  KEY `idx_visitor_time` (`visitor_id`, `visit_time`),
-  KEY `idx_owner_time` (`owner_id`, `visit_time`),
-  KEY `idx_visit_type` (`visit_type`, `visit_time`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='农场访问记录表';
-```
-
-### 3. 社交设置表 (kku_social_farm_settings)
-
-存储用户的社交农场相关设置。
-
-```sql
-CREATE TABLE `kku_social_farm_settings` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `user_id` bigint(20) unsigned NOT NULL COMMENT '用户ID',
-  `allow_steal` tinyint(4) NOT NULL DEFAULT '1' COMMENT '允许偷菜:1允许,0禁止',
-  `allow_help` tinyint(4) NOT NULL DEFAULT '1' COMMENT '允许互助:1允许,0禁止',
-  `allow_visit` tinyint(4) NOT NULL DEFAULT '1' COMMENT '允许访问:1允许,0禁止',
-  `steal_protection_hours` int(11) NOT NULL DEFAULT '0' COMMENT '偷菜保护时长(小时)',
-  `daily_steal_limit` int(11) NOT NULL DEFAULT '10' COMMENT '每日被偷次数限制',
-  `daily_help_limit` int(11) NOT NULL DEFAULT '20' COMMENT '每日被帮助次数限制',
-  `notification_enabled` tinyint(4) NOT NULL DEFAULT '1' COMMENT '通知开关:1开启,0关闭',
-  `auto_revenge` tinyint(4) NOT NULL DEFAULT '0' COMMENT '自动反偷:1开启,0关闭',
-  `friend_only` tinyint(4) NOT NULL DEFAULT '1' COMMENT '仅好友可访问:1是,0否',
-  `blacklist_users` json DEFAULT NULL COMMENT '黑名单用户ID列表',
-  `whitelist_users` json DEFAULT NULL COMMENT '白名单用户ID列表',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_user_id` (`user_id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='社交农场设置表';
-```
-
-### 4. 互助记录表 (kku_social_farm_help_logs)
-
-记录用户间的互助行为。
-
-```sql
-CREATE TABLE `kku_social_farm_help_logs` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `helper_id` bigint(20) unsigned NOT NULL COMMENT '帮助者用户ID',
-  `owner_id` bigint(20) unsigned NOT NULL COMMENT '农场主用户ID',
-  `land_id` bigint(20) unsigned NOT NULL COMMENT '帮助的土地ID',
-  `help_type` tinyint(4) NOT NULL COMMENT '帮助类型:1浇水,2施肥,3除草,4杀虫,5收获',
-  `help_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '帮助时间',
-  `item_consumed_id` bigint(20) unsigned DEFAULT NULL COMMENT '消耗的道具ID',
-  `item_consumed_amount` int(11) NOT NULL DEFAULT '0' COMMENT '消耗的道具数量',
-  `reward_item_id` bigint(20) unsigned DEFAULT NULL COMMENT '奖励物品ID',
-  `reward_amount` int(11) NOT NULL DEFAULT '0' COMMENT '奖励数量',
-  `exp_reward` int(11) NOT NULL DEFAULT '0' COMMENT '经验奖励',
-  `help_effect` json DEFAULT NULL COMMENT '帮助效果详情',
-  `ip_address` varchar(45) DEFAULT NULL COMMENT '帮助者IP地址',
-  `user_agent` text COMMENT '用户代理信息',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  KEY `idx_helper_time` (`helper_id`, `help_time`),
-  KEY `idx_owner_time` (`owner_id`, `help_time`),
-  KEY `idx_land_type` (`land_id`, `help_type`),
-  KEY `idx_help_type` (`help_type`, `help_time`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='互助记录表';
-```
-
-### 5. 社交统计表 (kku_social_farm_stats)
-
-记录用户的社交行为统计数据。
-
-```sql
-CREATE TABLE `kku_social_farm_stats` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `user_id` bigint(20) unsigned NOT NULL COMMENT '用户ID',
-  `stat_date` date NOT NULL COMMENT '统计日期',
-  `steal_count` int(11) NOT NULL DEFAULT '0' COMMENT '偷菜次数',
-  `stolen_count` int(11) NOT NULL DEFAULT '0' COMMENT '被偷次数',
-  `help_count` int(11) NOT NULL DEFAULT '0' COMMENT '帮助次数',
-  `helped_count` int(11) NOT NULL DEFAULT '0' COMMENT '被帮助次数',
-  `visit_count` int(11) NOT NULL DEFAULT '0' COMMENT '访问次数',
-  `visited_count` int(11) NOT NULL DEFAULT '0' COMMENT '被访问次数',
-  `steal_items_gained` int(11) NOT NULL DEFAULT '0' COMMENT '偷菜获得物品数',
-  `steal_items_lost` int(11) NOT NULL DEFAULT '0' COMMENT '被偷失去物品数',
-  `help_rewards_gained` int(11) NOT NULL DEFAULT '0' COMMENT '互助获得奖励数',
-  `total_exp_gained` int(11) NOT NULL DEFAULT '0' COMMENT '总经验获得',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `uk_user_date` (`user_id`, `stat_date`),
-  KEY `idx_stat_date` (`stat_date`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='社交农场统计表';
-```
-
-### 6. 偷菜保护记录表 (kku_social_farm_protections)
-
-记录偷菜保护状态。
-
-```sql
-CREATE TABLE `kku_social_farm_protections` (
-  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
-  `user_id` bigint(20) unsigned NOT NULL COMMENT '用户ID',
-  `land_id` bigint(20) unsigned DEFAULT NULL COMMENT '土地ID(NULL表示全农场保护)',
-  `protection_type` tinyint(4) NOT NULL COMMENT '保护类型:1时间保护,2道具保护,3系统保护',
-  `start_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '保护开始时间',
-  `end_time` timestamp NOT NULL COMMENT '保护结束时间',
-  `protection_item_id` bigint(20) unsigned DEFAULT NULL COMMENT '保护道具ID',
-  `is_active` tinyint(4) NOT NULL DEFAULT '1' COMMENT '是否激活:1激活,0失效',
-  `created_by` bigint(20) unsigned DEFAULT NULL COMMENT '创建者ID',
-  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-  PRIMARY KEY (`id`),
-  KEY `idx_user_active` (`user_id`, `is_active`),
-  KEY `idx_land_active` (`land_id`, `is_active`),
-  KEY `idx_end_time` (`end_time`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='偷菜保护记录表';
-```
-
-## 索引设计说明
-
-### 主要索引策略
-
-1. **时间范围查询索引**
-   - `idx_stealer_time`: 支持查询某用户的偷菜历史
-   - `idx_owner_time`: 支持查询某农场的被偷历史
-   - `idx_visitor_time`: 支持查询访问记录
-
-2. **状态查询索引**
-   - `idx_steal_status`: 支持按偷菜状态查询
-   - `idx_visit_type`: 支持按访问类型查询
-   - `idx_help_type`: 支持按帮助类型查询
-
-3. **关联查询索引**
-   - `idx_land_crop`: 支持土地作物关联查询
-   - `idx_user_active`: 支持用户保护状态查询
-
-## 数据完整性约束
-
-### 外键关系
-
-虽然表结构中没有显式定义外键约束，但存在以下逻辑外键关系：
-
-1. **用户关系**
-   - `stealer_id`, `owner_id`, `visitor_id`, `helper_id` → `kku_users.id`
-   - `user_id` → `kku_users.id`
-
-2. **农场关系**
-   - `land_id` → `kku_farm_land_users.id`
-   - `crop_id` → `kku_farm_crop_users.id`
-
-3. **物品关系**
-   - `item_id`, `reward_item_id` → `kku_item_configs.id`
-
-### 数据验证规则
-
-1. **偷菜记录验证**
-   - `stealer_id` ≠ `owner_id` (不能偷自己的菜)
-   - `item_amount` > 0 (偷到的数量必须大于0)
-   - `steal_ratio` ∈ [0, 1] (偷菜比例在0-1之间)
-
-2. **访问记录验证**
-   - `visitor_id` ≠ `owner_id` (不记录访问自己农场)
-   - `duration` ≥ 0 (访问时长不能为负)
-
-3. **设置表验证**
-   - `steal_protection_hours` ≥ 0 (保护时长不能为负)
-   - `daily_steal_limit` > 0 (每日限制必须大于0)
-
-## 性能优化建议
-
-### 1. 分区策略
-
-对于日志类表，建议按时间分区：
-
-```sql
--- 偷菜记录表按月分区
-ALTER TABLE kku_social_farm_steal_logs 
-PARTITION BY RANGE (YEAR(steal_time) * 100 + MONTH(steal_time)) (
-    PARTITION p202501 VALUES LESS THAN (202502),
-    PARTITION p202502 VALUES LESS THAN (202503),
-    -- ... 更多分区
-);
-```
-
-### 2. 数据清理策略
-
-定期清理过期数据：
-
-```sql
--- 清理3个月前的访问记录
-DELETE FROM kku_social_farm_visit_logs 
-WHERE visit_time < DATE_SUB(NOW(), INTERVAL 3 MONTH);
-
--- 清理6个月前的偷菜记录
-DELETE FROM kku_social_farm_steal_logs 
-WHERE steal_time < DATE_SUB(NOW(), INTERVAL 6 MONTH);
-```
-
-### 3. 缓存策略
-
-建议缓存的数据：
-
-1. **用户社交设置**: 缓存时间1小时
-2. **每日统计数据**: 缓存时间30分钟
-3. **保护状态**: 缓存时间10分钟
-4. **好友农场状态**: 缓存时间5分钟
-
-## 数据迁移注意事项
-
-### 1. 初始化数据
-
-新用户注册时需要初始化社交设置：
-
-```sql
-INSERT INTO kku_social_farm_settings (user_id) 
-VALUES (?) 
-ON DUPLICATE KEY UPDATE updated_at = CURRENT_TIMESTAMP;
-```
-
-### 2. 历史数据处理
-
-如果有历史的偷菜数据需要迁移，注意：
-
-1. 数据格式转换
-2. 时间戳统一
-3. 状态码映射
-4. 用户ID验证
-
-### 3. 数据一致性检查
-
-定期执行数据一致性检查：
-
-```sql
--- 检查孤立的偷菜记录
-SELECT * FROM kku_social_farm_steal_logs s
-LEFT JOIN kku_users u1 ON s.stealer_id = u1.id
-LEFT JOIN kku_users u2 ON s.owner_id = u2.id
-WHERE u1.id IS NULL OR u2.id IS NULL;
-```
-
-## 备份和恢复策略
-
-### 1. 备份策略
-
-- **全量备份**: 每日凌晨执行
-- **增量备份**: 每4小时执行
-- **日志备份**: 实时备份binlog
-
-### 2. 恢复策略
-
-- **数据恢复**: 基于时间点恢复
-- **表恢复**: 单表恢复机制
-- **应急恢复**: 快速恢复关键表
-
----
-
-本文档详细描述了SocialFarm模块的数据库设计，包括表结构、索引、约束和优化建议。在实际开发中，请根据具体需求调整表结构和索引策略。

app/Module/SocialFarm/Docs/设计.md

@@ -1,2 +0,0 @@
-# 社交农场
-

app/Module/SocialFarm/Enums/HELP_TYPE.php

@@ -1,149 +0,0 @@
-<?php
-
-namespace App\Module\SocialFarm\Enums;
-
-/**
- * 互助类型枚举
- * 
- * 定义农场互助的各种类型
- */
-enum HELP_TYPE: int
-{
-    case WATER = 1;      // 浇水
-    case FERTILIZE = 2;  // 施肥
-    case WEED = 3;       // 除草
-    case PEST = 4;       // 杀虫
-    case HARVEST = 5;    // 收获
-
-    /**
-     * 获取互助类型描述
-     */
-    public function getDescription(): string
-    {
-        return match($this) {
-            self::WATER => '浇水',
-            self::FERTILIZE => '施肥',
-            self::WEED => '除草',
-            self::PEST => '杀虫',
-            self::HARVEST => '收获',
-        };
-    }
-
-    /**
-     * 获取互助类型图标
-     */
-    public function getIcon(): string
-    {
-        return match($this) {
-            self::WATER => '💧',
-            self::FERTILIZE => '🌱',
-            self::WEED => '🌿',
-            self::PEST => '🐛',
-            self::HARVEST => '🌾',
-        ];
-    }
-
-    /**
-     * 获取对应的农场灾害类型
-     */
-    public function getDisasterType(): ?int
-    {
-        return match($this) {
-            self::WEED => \App\Module\Farm\Enums\DISASTER_TYPE::WEED->value,
-            self::PEST => \App\Module\Farm\Enums\DISASTER_TYPE::PEST->value,
-            default => null,
-        };
-    }
-
-    /**
-     * 获取需要消耗的道具类型
-     */
-    public function getRequiredItemType(): ?string
-    {
-        return match($this) {
-            self::WATER => 'water_tool',
-            self::FERTILIZE => 'fertilizer',
-            self::WEED => 'weed_killer',
-            self::PEST => 'pesticide',
-            self::HARVEST => null, // 收获不需要道具
-        };
-    }
-
-    /**
-     * 获取基础经验奖励
-     */
-    public function getBaseExpReward(): int
-    {
-        return match($this) {
-            self::WATER => 2,
-            self::FERTILIZE => 3,
-            self::WEED => 5,
-            self::PEST => 5,
-            self::HARVEST => 8,
-        };
-    }
-
-    /**
-     * 获取奖励概率
-     */
-    public function getRewardProbability(): float
-    {
-        return match($this) {
-            self::WATER => 0.1,      // 10%
-            self::FERTILIZE => 0.15, // 15%
-            self::WEED => 0.2,       // 20%
-            self::PEST => 0.2,       // 20%
-            self::HARVEST => 0.3,    // 30%
-        };
-    }
-
-    /**
-     * 是否需要消耗道具
-     */
-    public function requiresItem(): bool
-    {
-        return $this->getRequiredItemType() !== null;
-    }
-
-    /**
-     * 是否为灾害处理类型
-     */
-    public function isDisasterHelp(): bool
-    {
-        return in_array($this, [self::WEED, self::PEST]);
-    }
-
-    /**
-     * 是否为作物护理类型
-     */
-    public function isCropCare(): bool
-    {
-        return in_array($this, [self::WATER, self::FERTILIZE]);
-    }
-
-    /**
-     * 获取所有互助类型选项（用于后台管理）
-     */
-    public static function getOptions(): array
-    {
-        return [
-            self::WATER->value => self::WATER->getDescription(),
-            self::FERTILIZE->value => self::FERTILIZE->getDescription(),
-            self::WEED->value => self::WEED->getDescription(),
-            self::PEST->value => self::PEST->getDescription(),
-            self::HARVEST->value => self::HARVEST->getDescription(),
-        ];
-    }
-
-    /**
-     * 根据农场灾害类型获取对应的互助类型
-     */
-    public static function fromDisasterType(int $disasterType): ?self
-    {
-        return match($disasterType) {
-            \App\Module\Farm\Enums\DISASTER_TYPE::WEED->value => self::WEED,
-            \App\Module\Farm\Enums\DISASTER_TYPE::PEST->value => self::PEST,
-            default => null,
-        };
-    }
-}

app/Module/SocialFarm/Enums/SOCIAL_ACTION.php

@@ -1,136 +0,0 @@
-<?php
-
-namespace App\Module\SocialFarm\Enums;
-
-/**
- * 社交行为枚举
- * 
- * 定义社交农场中的各种行为类型
- */
-enum SOCIAL_ACTION: string
-{
-    case STEAL = 'steal';           // 偷菜
-    case HELP_WATER = 'help_water'; // 帮助浇水
-    case HELP_FERTILIZE = 'help_fertilize'; // 帮助施肥
-    case HELP_WEED = 'help_weed';   // 帮助除草
-    case HELP_PEST = 'help_pest';   // 帮助杀虫
-    case HELP_HARVEST = 'help_harvest'; // 帮助收获
-    case VISIT = 'visit';           // 访问农场
-    case GIFT = 'gift';             // 赠送礼物
-    case LIKE = 'like';             // 点赞
-
-    /**
-     * 获取行为描述
-     */
-    public function getDescription(): string
-    {
-        return match($this) {
-            self::STEAL => '偷菜',
-            self::HELP_WATER => '帮助浇水',
-            self::HELP_FERTILIZE => '帮助施肥',
-            self::HELP_WEED => '帮助除草',
-            self::HELP_PEST => '帮助杀虫',
-            self::HELP_HARVEST => '帮助收获',
-            self::VISIT => '访问农场',
-            self::GIFT => '赠送礼物',
-            self::LIKE => '点赞',
-        };
-    }
-
-    /**
-     * 获取行为图标
-     */
-    public function getIcon(): string
-    {
-        return match($this) {
-            self::STEAL => '🥕',
-            self::HELP_WATER => '💧',
-            self::HELP_FERTILIZE => '🌱',
-            self::HELP_WEED => '🌿',
-            self::HELP_PEST => '🐛',
-            self::HELP_HARVEST => '🌾',
-            self::VISIT => '👀',
-            self::GIFT => '🎁',
-            self::LIKE => '👍',
-        };
-    }
-
-    /**
-     * 是否为帮助类行为
-     */
-    public function isHelpAction(): bool
-    {
-        return in_array($this, [
-            self::HELP_WATER,
-            self::HELP_FERTILIZE,
-            self::HELP_WEED,
-            self::HELP_PEST,
-            self::HELP_HARVEST,
-        ]);
-    }
-
-    /**
-     * 是否为负面行为
-     */
-    public function isNegativeAction(): bool
-    {
-        return $this === self::STEAL;
-    }
-
-    /**
-     * 是否为正面行为
-     */
-    public function isPositiveAction(): bool
-    {
-        return $this->isHelpAction() || in_array($this, [
-            self::GIFT,
-            self::LIKE,
-        ]);
-    }
-
-    /**
-     * 获取行为分类
-     */
-    public function getCategory(): string
-    {
-        return match($this) {
-            self::STEAL => 'steal',
-            self::HELP_WATER, self::HELP_FERTILIZE, self::HELP_WEED, 
-            self::HELP_PEST, self::HELP_HARVEST => 'help',
-            self::VISIT => 'visit',
-            self::GIFT, self::LIKE => 'social',
-        };
-    }
-
-    /**
-     * 获取所有帮助类行为
-     */
-    public static function getHelpActions(): array
-    {
-        return [
-            self::HELP_WATER,
-            self::HELP_FERTILIZE,
-            self::HELP_WEED,
-            self::HELP_PEST,
-            self::HELP_HARVEST,
-        ];
-    }
-
-    /**
-     * 获取所有行为选项（用于后台管理）
-     */
-    public static function getOptions(): array
-    {
-        return [
-            self::STEAL->value => self::STEAL->getDescription(),
-            self::HELP_WATER->value => self::HELP_WATER->getDescription(),
-            self::HELP_FERTILIZE->value => self::HELP_FERTILIZE->getDescription(),
-            self::HELP_WEED->value => self::HELP_WEED->getDescription(),
-            self::HELP_PEST->value => self::HELP_PEST->getDescription(),
-            self::HELP_HARVEST->value => self::HELP_HARVEST->getDescription(),
-            self::VISIT->value => self::VISIT->getDescription(),
-            self::GIFT->value => self::GIFT->getDescription(),
-            self::LIKE->value => self::LIKE->getDescription(),
-        ];
-    }
-}

app/Module/SocialFarm/Enums/STEAL_STATUS.php

@@ -1,83 +0,0 @@
-<?php
-
-namespace App\Module\SocialFarm\Enums;
-
-/**
- * 偷菜状态枚举
- * 
- * 定义偷菜操作的各种状态
- */
-enum STEAL_STATUS: int
-{
-    case SUCCESS = 1;      // 偷菜成功
-    case FAILED = 2;       // 偷菜失败
-    case PROTECTED = 3;    // 受保护无法偷
-    case NO_PERMISSION = 4; // 无权限偷菜
-    case LIMIT_EXCEEDED = 5; // 超过次数限制
-    case CROP_NOT_READY = 6; // 作物未成熟
-    case ALREADY_STOLEN = 7; // 已被偷过
-
-    /**
-     * 获取状态描述
-     */
-    public function getDescription(): string
-    {
-        return match($this) {
-            self::SUCCESS => '偷菜成功',
-            self::FAILED => '偷菜失败',
-            self::PROTECTED => '受保护无法偷菜',
-            self::NO_PERMISSION => '无权限偷菜',
-            self::LIMIT_EXCEEDED => '超过每日偷菜次数限制',
-            self::CROP_NOT_READY => '作物未成熟',
-            self::ALREADY_STOLEN => '作物已被偷过',
-        };
-    }
-
-    /**
-     * 获取状态颜色（用于前端显示）
-     */
-    public function getColor(): string
-    {
-        return match($this) {
-            self::SUCCESS => 'green',
-            self::FAILED => 'red',
-            self::PROTECTED => 'orange',
-            self::NO_PERMISSION => 'red',
-            self::LIMIT_EXCEEDED => 'orange',
-            self::CROP_NOT_READY => 'gray',
-            self::ALREADY_STOLEN => 'gray',
-        };
-    }
-
-    /**
-     * 是否为成功状态
-     */
-    public function isSuccess(): bool
-    {
-        return $this === self::SUCCESS;
-    }
-
-    /**
-     * 是否为失败状态
-     */
-    public function isFailed(): bool
-    {
-        return !$this->isSuccess();
-    }
-
-    /**
-     * 获取所有状态选项（用于后台管理）
-     */
-    public static function getOptions(): array
-    {
-        return [
-            self::SUCCESS->value => self::SUCCESS->getDescription(),
-            self::FAILED->value => self::FAILED->getDescription(),
-            self::PROTECTED->value => self::PROTECTED->getDescription(),
-            self::NO_PERMISSION->value => self::NO_PERMISSION->getDescription(),
-            self::LIMIT_EXCEEDED->value => self::LIMIT_EXCEEDED->getDescription(),
-            self::CROP_NOT_READY->value => self::CROP_NOT_READY->getDescription(),
-            self::ALREADY_STOLEN->value => self::ALREADY_STOLEN->getDescription(),
-        ];
-    }
-}

app/Module/SocialFarm/Enums/VISIT_TYPE.php

@@ -1,103 +0,0 @@
-<?php
-
-namespace App\Module\SocialFarm\Enums;
-
-/**
- * 访问类型枚举
- * 
- * 定义农场访问的各种类型
- */
-enum VISIT_TYPE: int
-{
-    case NORMAL = 1;        // 普通访问
-    case STEAL_VISIT = 2;   // 偷菜访问
-    case HELP_VISIT = 3;    // 互助访问
-    case SOCIAL_VISIT = 4;  // 社交访问（点赞、留言等）
-    case REVENGE_VISIT = 5; // 报复访问
-
-    /**
-     * 获取访问类型描述
-     */
-    public function getDescription(): string
-    {
-        return match($this) {
-            self::NORMAL => '普通访问',
-            self::STEAL_VISIT => '偷菜访问',
-            self::HELP_VISIT => '互助访问',
-            self::SOCIAL_VISIT => '社交访问',
-            self::REVENGE_VISIT => '报复访问',
-        };
-    }
-
-    /**
-     * 获取访问类型颜色
-     */
-    public function getColor(): string
-    {
-        return match($this) {
-            self::NORMAL => 'blue',
-            self::STEAL_VISIT => 'red',
-            self::HELP_VISIT => 'green',
-            self::SOCIAL_VISIT => 'purple',
-            self::REVENGE_VISIT => 'orange',
-        };
-    }
-
-    /**
-     * 获取访问类型图标
-     */
-    public function getIcon(): string
-    {
-        return match($this) {
-            self::NORMAL => '👀',
-            self::STEAL_VISIT => '🥕',
-            self::HELP_VISIT => '🤝',
-            self::SOCIAL_VISIT => '💬',
-            self::REVENGE_VISIT => '⚔️',
-        };
-    }
-
-    /**
-     * 是否为负面访问
-     */
-    public function isNegative(): bool
-    {
-        return in_array($this, [
-            self::STEAL_VISIT,
-            self::REVENGE_VISIT,
-        ]);
-    }
-
-    /**
-     * 是否为正面访问
-     */
-    public function isPositive(): bool
-    {
-        return in_array($this, [
-            self::HELP_VISIT,
-            self::SOCIAL_VISIT,
-        ]);
-    }
-
-    /**
-     * 是否为中性访问
-     */
-    public function isNeutral(): bool
-    {
-        return $this === self::NORMAL;
-    }
-
-    /**
-     * 获取所有访问类型选项（用于后台管理）
-     */
-    public static function getOptions(): array
-    {
-        return [
-            self::NORMAL->value => self::NORMAL->getDescription(),
-            self::STEAL_VISIT->value => self::STEAL_VISIT->getDescription(),
-            self::HELP_VISIT->value => self::HELP_VISIT->getDescription(),
-            self::SOCIAL_VISIT->value => self::SOCIAL_VISIT->getDescription(),
-            self::REVENGE_VISIT->value => self::REVENGE_VISIT->getDescription(),
-        ];
-    }
-}

app/Module/SocialFarm/Models/SocialFarmSetting.php

@@ -1,358 +0,0 @@
-<?php
-
-namespace App\Module\SocialFarm\Models;
-
-use UCore\ModelCore;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
-
-/**
- * 社交农场设置模型
- * 
- * @property int $id 主键ID
- * @property int $user_id 用户ID
- * @property bool $allow_steal 允许偷菜
- * @property bool $allow_help 允许互助
- * @property bool $allow_visit 允许访问
- * @property int $steal_protection_hours 偷菜保护时长(小时)
- * @property int $daily_steal_limit 每日被偷次数限制
- * @property int $daily_help_limit 每日被帮助次数限制
- * @property bool $notification_enabled 通知开关
- * @property bool $auto_revenge 自动反偷
- * @property bool $friend_only 仅好友可访问
- * @property array|null $blacklist_users 黑名单用户ID列表
- * @property array|null $whitelist_users 白名单用户ID列表
- * @property \Carbon\Carbon $created_at 创建时间
- * @property \Carbon\Carbon $updated_at 更新时间
- */
-class SocialFarmSetting extends ModelCore
-{
-    /**
-     * 数据表名
-     */
-    protected $table = 'social_farm_settings';
-
-    /**
-     * 可批量赋值的属性
-     */
-    protected $fillable = [
-        'user_id',
-        'allow_steal',
-        'allow_help',
-        'allow_visit',
-        'steal_protection_hours',
-        'daily_steal_limit',
-        'daily_help_limit',
-        'notification_enabled',
-        'auto_revenge',
-        'friend_only',
-        'blacklist_users',
-        'whitelist_users',
-    ];
-
-    /**
-     * 属性类型转换
-     */
-    protected $casts = [
-        'user_id' => 'integer',
-        'allow_steal' => 'boolean',
-        'allow_help' => 'boolean',
-        'allow_visit' => 'boolean',
-        'steal_protection_hours' => 'integer',
-        'daily_steal_limit' => 'integer',
-        'daily_help_limit' => 'integer',
-        'notification_enabled' => 'boolean',
-        'auto_revenge' => 'boolean',
-        'friend_only' => 'boolean',
-        'blacklist_users' => 'array',
-        'whitelist_users' => 'array',
-        'created_at' => 'datetime',
-        'updated_at' => 'datetime',
-    ];
-
-    /**
-     * 默认属性值
-     */
-    protected $attributes = [
-        'allow_steal' => true,
-        'allow_help' => true,
-        'allow_visit' => true,
-        'steal_protection_hours' => 0,
-        'daily_steal_limit' => 10,
-        'daily_help_limit' => 20,
-        'notification_enabled' => true,
-        'auto_revenge' => false,
-        'friend_only' => true,
-        'blacklist_users' => null,
-        'whitelist_users' => null,
-    ];
-
-    /**
-     * 获取用户信息
-     */
-    public function user(): BelongsTo
-    {
-        return $this->belongsTo(\App\Module\User\Models\User::class, 'user_id');
-    }
-
-    /**
-     * 检查用户是否在黑名单中
-     */
-    public function isUserBlacklisted(int $userId): bool
-    {
-        if (empty($this->blacklist_users)) {
-            return false;
-        }
-        return in_array($userId, $this->blacklist_users);
-    }
-
-    /**
-     * 检查用户是否在白名单中
-     */
-    public function isUserWhitelisted(int $userId): bool
-    {
-        if (empty($this->whitelist_users)) {
-            return false;
-        }
-        return in_array($userId, $this->whitelist_users);
-    }
-
-    /**
-     * 添加用户到黑名单
-     */
-    public function addToBlacklist(int $userId): void
-    {
-        $blacklist = $this->blacklist_users ?: [];
-        if (!in_array($userId, $blacklist)) {
-            $blacklist[] = $userId;
-            $this->blacklist_users = $blacklist;
-            $this->save();
-        }
-    }
-
-    /**
-     * 从黑名单移除用户
-     */
-    public function removeFromBlacklist(int $userId): void
-    {
-        $blacklist = $this->blacklist_users ?: [];
-        $key = array_search($userId, $blacklist);
-        if ($key !== false) {
-            unset($blacklist[$key]);
-            $this->blacklist_users = array_values($blacklist);
-            $this->save();
-        }
-    }
-
-    /**
-     * 添加用户到白名单
-     */
-    public function addToWhitelist(int $userId): void
-    {
-        $whitelist = $this->whitelist_users ?: [];
-        if (!in_array($userId, $whitelist)) {
-            $whitelist[] = $userId;
-            $this->whitelist_users = $whitelist;
-            $this->save();
-        }
-    }
-
-    /**
-     * 从白名单移除用户
-     */
-    public function removeFromWhitelist(int $userId): void
-    {
-        $whitelist = $this->whitelist_users ?: [];
-        $key = array_search($userId, $whitelist);
-        if ($key !== false) {
-            unset($whitelist[$key]);
-            $this->whitelist_users = array_values($whitelist);
-            $this->save();
-        }
-    }
-
-    /**
-     * 检查是否允许偷菜
-     */
-    public function canBeStolen(int $stealerId): bool
-    {
-        // 基础设置检查
-        if (!$this->allow_steal) {
-            return false;
-        }
-
-        // 黑名单检查
-        if ($this->isUserBlacklisted($stealerId)) {
-            return false;
-        }
-
-        // 如果有白名单，检查是否在白名单中
-        if (!empty($this->whitelist_users) && !$this->isUserWhitelisted($stealerId)) {
-            return false;
-        }
-
-        return true;
-    }
-
-    /**
-     * 检查是否允许互助
-     */
-    public function canBeHelped(int $helperId): bool
-    {
-        // 基础设置检查
-        if (!$this->allow_help) {
-            return false;
-        }
-
-        // 黑名单检查
-        if ($this->isUserBlacklisted($helperId)) {
-            return false;
-        }
-
-        // 如果有白名单，检查是否在白名单中
-        if (!empty($this->whitelist_users) && !$this->isUserWhitelisted($helperId)) {
-            return false;
-        }
-
-        return true;
-    }
-
-    /**
-     * 检查是否允许访问
-     */
-    public function canBeVisited(int $visitorId): bool
-    {
-        // 基础设置检查
-        if (!$this->allow_visit) {
-            return false;
-        }
-
-        // 黑名单检查
-        if ($this->isUserBlacklisted($visitorId)) {
-            return false;
-        }
-
-        // 如果有白名单，检查是否在白名单中
-        if (!empty($this->whitelist_users) && !$this->isUserWhitelisted($visitorId)) {
-            return false;
-        }
-
-        return true;
-    }
-
-    /**
-     * 获取保护结束时间
-     */
-    public function getProtectionEndTime(): ?\Carbon\Carbon
-    {
-        if ($this->steal_protection_hours <= 0) {
-            return null;
-        }
-
-        // 这里需要根据实际的保护机制来计算
-        // 可能需要查询最近的保护记录
-        return now()->addHours($this->steal_protection_hours);
-    }
-
-    /**
-     * 是否在保护期内
-     */
-    public function isUnderProtection(): bool
-    {
-        $endTime = $this->getProtectionEndTime();
-        return $endTime && now()->lt($endTime);
-    }
-
-    /**
-     * 获取黑名单用户数量
-     */
-    public function getBlacklistCountAttribute(): int
-    {
-        return count($this->blacklist_users ?: []);
-    }
-
-    /**
-     * 获取白名单用户数量
-     */
-    public function getWhitelistCountAttribute(): int
-    {
-        return count($this->whitelist_users ?: []);
-    }
-
-    /**
-     * 作用域：按用户查询
-     */
-    public function scopeByUser($query, int $userId)
-    {
-        return $query->where('user_id', $userId);
-    }
-
-    /**
-     * 作用域：允许偷菜的用户
-     */
-    public function scopeAllowSteal($query)
-    {
-        return $query->where('allow_steal', true);
-    }
-
-    /**
-     * 作用域：允许互助的用户
-     */
-    public function scopeAllowHelp($query)
-    {
-        return $query->where('allow_help', true);
-    }
-
-    /**
-     * 作用域：允许访问的用户
-     */
-    public function scopeAllowVisit($query)
-    {
-        return $query->where('allow_visit', true);
-    }
-
-    /**
-     * 获取或创建用户设置
-     */
-    public static function getOrCreateForUser(int $userId): self
-    {
-        return static::firstOrCreate(
-            ['user_id' => $userId],
-            [
-                'allow_steal' => true,
-                'allow_help' => true,
-                'allow_visit' => true,
-                'steal_protection_hours' => 0,
-                'daily_steal_limit' => 10,
-                'daily_help_limit' => 20,
-                'notification_enabled' => true,
-                'auto_revenge' => false,
-                'friend_only' => true,
-            ]
-        );
-    }
-
-    /**
-     * 批量更新设置
-     */
-    public function updateSettings(array $settings): bool
-    {
-        $allowedFields = [
-            'allow_steal', 'allow_help', 'allow_visit',
-            'steal_protection_hours', 'daily_steal_limit', 'daily_help_limit',
-            'notification_enabled', 'auto_revenge', 'friend_only'
-        ];
-
-        $updateData = [];
-        foreach ($allowedFields as $field) {
-            if (array_key_exists($field, $settings)) {
-                $updateData[$field] = $settings[$field];
-            }
-        }
-
-        if (empty($updateData)) {
-            return false;
-        }
-
-        return $this->update($updateData);
-    }
-}

app/Module/SocialFarm/Models/SocialFarmStealLog.php

@@ -1,318 +0,0 @@
-<?php
-
-namespace App\Module\SocialFarm\Models;
-
-use UCore\ModelCore;
-use App\Module\SocialFarm\Enums\STEAL_STATUS;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
-
-/**
- * 偷菜记录模型
- * 
- * @property int $id 主键ID
- * @property int $stealer_id 偷菜者用户ID
- * @property int $owner_id 农场主用户ID
- * @property int $land_id 被偷的土地ID
- * @property int $crop_id 被偷的作物ID
- * @property int $item_id 偷到的物品ID
- * @property int $item_amount 偷到的物品数量
- * @property int $original_amount 作物原始数量
- * @property float $steal_ratio 偷菜比例
- * @property string $steal_time 偷菜时间
- * @property int $steal_status 偷菜状态
- * @property string|null $ip_address 偷菜者IP地址
- * @property string|null $user_agent 用户代理信息
- * @property \Carbon\Carbon $created_at 创建时间
- * @property \Carbon\Carbon $updated_at 更新时间
- */
-class SocialFarmStealLog extends ModelCore
-{
-    /**
-     * 数据表名
-     */
-    protected $table = 'social_farm_steal_logs';
-
-    /**
-     * 可批量赋值的属性
-     */
-    protected $fillable = [
-        'stealer_id',
-        'owner_id',
-        'land_id',
-        'crop_id',
-        'item_id',
-        'item_amount',
-        'original_amount',
-        'steal_ratio',
-        'steal_time',
-        'steal_status',
-        'ip_address',
-        'user_agent',
-    ];
-
-    /**
-     * 属性类型转换
-     */
-    protected $casts = [
-        'stealer_id' => 'integer',
-        'owner_id' => 'integer',
-        'land_id' => 'integer',
-        'crop_id' => 'integer',
-        'item_id' => 'integer',
-        'item_amount' => 'integer',
-        'original_amount' => 'integer',
-        'steal_ratio' => 'decimal:4',
-        'steal_time' => 'datetime',
-        'steal_status' => 'integer',
-        'created_at' => 'datetime',
-        'updated_at' => 'datetime',
-    ];
-
-    /**
-     * 日期字段
-     */
-    protected $dates = [
-        'steal_time',
-        'created_at',
-        'updated_at',
-    ];
-
-    /**
-     * 获取偷菜者用户信息
-     */
-    public function stealer(): BelongsTo
-    {
-        return $this->belongsTo(\App\Module\User\Models\User::class, 'stealer_id');
-    }
-
-    /**
-     * 获取农场主用户信息
-     */
-    public function owner(): BelongsTo
-    {
-        return $this->belongsTo(\App\Module\User\Models\User::class, 'owner_id');
-    }
-
-    /**
-     * 获取土地信息
-     */
-    public function land(): BelongsTo
-    {
-        return $this->belongsTo(\App\Module\Farm\Models\FarmLandUser::class, 'land_id');
-    }
-
-    /**
-     * 获取作物信息
-     */
-    public function crop(): BelongsTo
-    {
-        return $this->belongsTo(\App\Module\Farm\Models\FarmCropUser::class, 'crop_id');
-    }
-
-    /**
-     * 获取物品信息
-     */
-    public function item(): BelongsTo
-    {
-        return $this->belongsTo(\App\Module\GameItems\Models\ItemConfig::class, 'item_id');
-    }
-
-    /**
-     * 获取偷菜状态枚举
-     */
-    public function getStealStatusEnum(): STEAL_STATUS
-    {
-        return STEAL_STATUS::from($this->steal_status);
-    }
-
-    /**
-     * 获取偷菜状态描述
-     */
-    public function getStealStatusDescAttribute(): string
-    {
-        return $this->getStealStatusEnum()->getDescription();
-    }
-
-    /**
-     * 获取偷菜状态颜色
-     */
-    public function getStealStatusColorAttribute(): string
-    {
-        return $this->getStealStatusEnum()->getColor();
-    }
-
-    /**
-     * 是否偷菜成功
-     */
-    public function isSuccess(): bool
-    {
-        return $this->getStealStatusEnum()->isSuccess();
-    }
-
-    /**
-     * 是否偷菜失败
-     */
-    public function isFailed(): bool
-    {
-        return $this->getStealStatusEnum()->isFailed();
-    }
-
-    /**
-     * 获取偷菜收益率
-     */
-    public function getYieldRateAttribute(): float
-    {
-        if ($this->original_amount <= 0) {
-            return 0;
-        }
-        return round($this->item_amount / $this->original_amount, 4);
-    }
-
-    /**
-     * 获取格式化的偷菜时间
-     */
-    public function getFormattedStealTimeAttribute(): string
-    {
-        return $this->steal_time->format('Y-m-d H:i:s');
-    }
-
-    /**
-     * 获取偷菜时间距离现在的描述
-     */
-    public function getStealTimeHumanAttribute(): string
-    {
-        return $this->steal_time->diffForHumans();
-    }
-
-    /**
-     * 作用域：按偷菜者查询
-     */
-    public function scopeByStealer($query, int $stealerId)
-    {
-        return $query->where('stealer_id', $stealerId);
-    }
-
-    /**
-     * 作用域：按农场主查询
-     */
-    public function scopeByOwner($query, int $ownerId)
-    {
-        return $query->where('owner_id', $ownerId);
-    }
-
-    /**
-     * 作用域：按偷菜状态查询
-     */
-    public function scopeByStatus($query, int $status)
-    {
-        return $query->where('steal_status', $status);
-    }
-
-    /**
-     * 作用域：成功的偷菜记录
-     */
-    public function scopeSuccessful($query)
-    {
-        return $query->where('steal_status', STEAL_STATUS::SUCCESS->value);
-    }
-
-    /**
-     * 作用域：失败的偷菜记录
-     */
-    public function scopeFailed($query)
-    {
-        return $query->where('steal_status', '!=', STEAL_STATUS::SUCCESS->value);
-    }
-
-    /**
-     * 作用域：按时间范围查询
-     */
-    public function scopeByTimeRange($query, string $startTime, string $endTime)
-    {
-        return $query->whereBetween('steal_time', [$startTime, $endTime]);
-    }
-
-    /**
-     * 作用域：今日记录
-     */
-    public function scopeToday($query)
-    {
-        return $query->whereDate('steal_time', today());
-    }
-
-    /**
-     * 作用域：本周记录
-     */
-    public function scopeThisWeek($query)
-    {
-        return $query->whereBetween('steal_time', [
-            now()->startOfWeek(),
-            now()->endOfWeek()
-        ]);
-    }
-
-    /**
-     * 作用域：本月记录
-     */
-    public function scopeThisMonth($query)
-    {
-        return $query->whereMonth('steal_time', now()->month)
-                    ->whereYear('steal_time', now()->year);
-    }
-
-    /**
-     * 获取用户今日偷菜次数
-     */
-    public static function getTodayStealCount(int $stealerId): int
-    {
-        return static::byStealer($stealerId)
-                    ->today()
-                    ->count();
-    }
-
-    /**
-     * 获取用户今日被偷次数
-     */
-    public static function getTodayStolenCount(int $ownerId): int
-    {
-        return static::byOwner($ownerId)
-                    ->today()
-                    ->successful()
-                    ->count();
-    }
-
-    /**
-     * 获取用户偷菜统计
-     */
-    public static function getStealStats(int $userId, string $date = null): array
-    {
-        $date = $date ?: today()->toDateString();
-        
-        $stealCount = static::byStealer($userId)
-                           ->whereDate('steal_time', $date)
-                           ->successful()
-                           ->count();
-                           
-        $stolenCount = static::byOwner($userId)
-                            ->whereDate('steal_time', $date)
-                            ->successful()
-                            ->count();
-                            
-        $itemsGained = static::byStealer($userId)
-                            ->whereDate('steal_time', $date)
-                            ->successful()
-                            ->sum('item_amount');
-                            
-        $itemsLost = static::byOwner($userId)
-                          ->whereDate('steal_time', $date)
-                          ->successful()
-                          ->sum('item_amount');
-
-        return [
-            'steal_count' => $stealCount,
-            'stolen_count' => $stolenCount,
-            'items_gained' => $itemsGained,
-            'items_lost' => $itemsLost,
-        ];
-    }
-}

app/Module/SocialFarm/Providers/SocialFarmServiceProvider.php

@@ -1,93 +0,0 @@
-<?php
-
-namespace App\Module\SocialFarm\Providers;
-
-use Illuminate\Support\ServiceProvider;
-use Illuminate\Support\Facades\Event;
-
-/**
- * SocialFarm模块服务提供者
- */
-class SocialFarmServiceProvider extends ServiceProvider
-{
-    /**
-     * 注册服务
-     */
-    public function register(): void
-    {
-        // 注册配置文件
-        $this->mergeConfigFrom(
-            __DIR__ . '/../config/socialfarm.php',
-            'socialfarm'
-        );
-    }
-
-    /**
-     * 启动服务
-     */
-    public function boot(): void
-    {
-        // 发布配置文件
-        if ($this->app->runningInConsole()) {
-            $this->publishes([
-                __DIR__ . '/../config/socialfarm.php' => config_path('socialfarm.php'),
-            ], 'socialfarm-config');
-        }
-
-        // 注册事件监听器
-        $this->registerEventListeners();
-
-        // 注册命令
-        $this->registerCommands();
-    }
-
-    /**
-     * 注册事件监听器
-     */
-    protected function registerEventListeners(): void
-    {
-        // 偷菜成功事件
-        Event::listen(
-            \App\Module\SocialFarm\Events\CropStolenEvent::class,
-            \App\Module\SocialFarm\Listeners\SendStealNotificationListener::class
-        );
-
-        Event::listen(
-            \App\Module\SocialFarm\Events\CropStolenEvent::class,
-            \App\Module\SocialFarm\Listeners\UpdateSocialStatsListener::class
-        );
-
-        // 农场访问事件
-        Event::listen(
-            \App\Module\SocialFarm\Events\FarmVisitedEvent::class,
-            \App\Module\SocialFarm\Listeners\UpdateSocialStatsListener::class
-        );
-
-        // 互助行为事件
-        Event::listen(
-            \App\Module\SocialFarm\Events\HelpActionEvent::class,
-            \App\Module\SocialFarm\Listeners\UpdateSocialStatsListener::class
-        );
-    }
-
-    /**
-     * 注册命令
-     */
-    protected function registerCommands(): void
-    {
-        if ($this->app->runningInConsole()) {
-            $this->commands([
-                \App\Module\SocialFarm\Commands\CleanExpiredLogsCommand::class,
-                \App\Module\SocialFarm\Commands\SocialFarmStatsCommand::class,
-            ]);
-        }
-    }
-
-    /**
-     * 获取提供的服务
-     */
-    public function provides(): array
-    {
-        return [];
-    }
-}

app/Module/SocialFarm/README.md

@@ -1,286 +0,0 @@
-# SocialFarm模块 - 社交农场系统
-
-SocialFarm模块是开心农场系统的社交互动核心模块，负责处理好友间的农场互动功能，包括偷菜、互助、访问等社交玩法。
-
-## 📋 目录
-
-- [模块概述](#模块概述)
-- [核心功能](#核心功能)
-- [架构设计](#架构设计)
-- [数据库设计](#数据库设计)
-- [API接口](#api接口)
-- [模块交互](#模块交互)
-- [配置说明](#配置说明)
-- [开发指南](#开发指南)
-
-## 🎯 模块概述
-
-### 基本信息
-- **模块名称**: SocialFarm
-- **功能定位**: 社交农场互动系统
-- **开发状态**: 🚧 开发中
-- **依赖模块**: Friend、Farm、GameItems、User、Notification
-
-### 主要特性
-- **好友农场访问**: 访问好友农场，查看农场状态
-- **偷菜系统**: 偷取好友成熟作物，获得物品奖励
-- **互助功能**: 帮助好友处理农场事务（浇水、施肥、除草等）
-- **社交记录**: 完整的社交行为记录和统计
-- **权限控制**: 灵活的农场访问权限设置
-- **防护机制**: 偷菜保护、次数限制等平衡机制
-
-## 🎮 核心功能
-
-### 1. 偷菜系统
-- **偷菜条件检查**: 好友关系、作物状态、权限验证
-- **偷菜执行**: 计算收益、更新作物、记录日志
-- **偷菜限制**: 每日次数限制、冷却时间、保护机制
-- **收益计算**: 基于作物类型、成熟度的动态收益
-
-### 2. 好友农场访问
-- **农场浏览**: 查看好友农场布局和作物状态
-- **访问记录**: 记录访问行为和时间
-- **权限控制**: 基于好友关系的访问权限
-- **实时状态**: 获取农场实时数据
-
-### 3. 互助功能
-- **帮助浇水**: 帮助好友给作物浇水
-- **协助施肥**: 使用道具帮助好友施肥
-- **清除灾害**: 帮助清除好友农场的灾害
-- **互助奖励**: 互助行为的奖励机制
-
-### 4. 社交设置
-- **隐私控制**: 设置农场访问权限
-- **偷菜保护**: 开启偷菜保护时间
-- **互助设置**: 允许/禁止好友互助
-- **通知设置**: 社交行为通知开关
-
-## 🏗️ 架构设计
-
-### 目录结构
-```
-app/Module/SocialFarm/
-├── AdminControllers/        # 后台管理控制器
-│   ├── StealLogController.php          # 偷菜记录管理
-│   ├── VisitLogController.php          # 访问记录管理
-│   ├── SocialSettingController.php     # 社交设置管理
-│   └── Helper/                         # 辅助类
-├── Commands/                           # 命令行工具
-│   ├── CleanExpiredLogsCommand.php     # 清理过期日志
-│   └── SocialFarmStatsCommand.php      # 社交统计命令
-├── Databases/                          # 数据库相关文件
-│   ├── createsql/                      # 表创建SQL
-│   └── GenerateSql/                    # 生成的SQL文件
-├── Docs/                               # 详细文档目录
-│   ├── 设计概述.md                      # 设计概述
-│   ├── 数据库设计.md                    # 数据库设计
-│   ├── API接口文档.md                   # API接口文档
-│   ├── 偷菜系统设计.md                  # 偷菜系统设计
-│   └── 互助系统设计.md                  # 互助系统设计
-├── Dtos/                               # 数据传输对象
-│   ├── FarmVisitDto.php                # 农场访问DTO
-│   ├── StealResultDto.php              # 偷菜结果DTO
-│   └── SocialActionDto.php             # 社交行为DTO
-├── Enums/                              # 枚举定义
-│   ├── STEAL_STATUS.php                # 偷菜状态枚举
-│   ├── SOCIAL_ACTION.php               # 社交行为枚举
-│   ├── VISIT_TYPE.php                  # 访问类型枚举
-│   └── PROTECTION_TYPE.php             # 保护类型枚举
-├── Events/                             # 事件类
-│   ├── CropStolenEvent.php             # 作物被偷事件
-│   ├── FarmVisitedEvent.php            # 农场被访问事件
-│   └── HelpActionEvent.php             # 互助行为事件
-├── Listeners/                          # 事件监听器
-│   ├── SendStealNotificationListener.php   # 发送偷菜通知
-│   └── UpdateSocialStatsListener.php       # 更新社交统计
-├── Logics/                             # 业务逻辑类
-│   ├── StealLogic.php                  # 偷菜逻辑
-│   ├── VisitLogic.php                  # 访问逻辑
-│   ├── HelpLogic.php                   # 互助逻辑
-│   └── PermissionLogic.php             # 权限逻辑
-├── Models/                             # 数据模型
-│   ├── SocialFarmStealLog.php          # 偷菜记录模型
-│   ├── SocialFarmVisitLog.php          # 访问记录模型
-│   ├── SocialFarmSetting.php           # 社交设置模型
-│   └── SocialFarmHelpLog.php           # 互助记录模型
-├── Providers/                          # 服务提供者
-│   └── SocialFarmServiceProvider.php   # 模块服务提供者
-├── Repositories/                       # 数据仓库（后台专用）
-│   ├── StealLogRepository.php          # 偷菜记录仓库
-│   └── VisitLogRepository.php          # 访问记录仓库
-├── Services/                           # 对外服务类
-│   ├── SocialFarmService.php           # 主服务类
-│   ├── StealService.php                # 偷菜服务
-│   ├── VisitService.php                # 访问服务
-│   └── HelpService.php                 # 互助服务
-├── Validations/                        # 验证规则
-│   ├── StealValidation.php             # 偷菜验证
-│   └── VisitValidation.php             # 访问验证
-├── Validators/                         # 验证器
-│   ├── StealValidator.php              # 偷菜验证器
-│   └── PermissionValidator.php         # 权限验证器
-└── README.md                           # 本文档
-```
-
-### 核心类设计
-
-#### 1. 服务层 (Services)
-- **SocialFarmService**: 主服务类，提供统一的对外接口
-- **StealService**: 偷菜功能服务
-- **VisitService**: 农场访问服务
-- **HelpService**: 互助功能服务
-
-#### 2. 逻辑层 (Logics)
-- **StealLogic**: 偷菜业务逻辑处理
-- **VisitLogic**: 访问权限和逻辑处理
-- **HelpLogic**: 互助行为逻辑处理
-- **PermissionLogic**: 权限验证逻辑
-
-#### 3. 数据层 (Models)
-- **SocialFarmStealLog**: 偷菜记录数据模型
-- **SocialFarmVisitLog**: 访问记录数据模型
-- **SocialFarmSetting**: 用户社交设置模型
-- **SocialFarmHelpLog**: 互助记录数据模型
-
-## 📊 数据库设计
-
-### 核心数据表
-
-#### 1. 偷菜记录表 (social_farm_steal_logs)
-| 字段名 | 类型 | 说明 |
-|--------|------|------|
-| id | bigint | 主键ID |
-| stealer_id | bigint | 偷菜者用户ID |
-| owner_id | bigint | 农场主用户ID |
-| land_id | bigint | 被偷的土地ID |
-| crop_id | bigint | 被偷的作物ID |
-| item_id | bigint | 偷到的物品ID |
-| item_amount | int | 偷到的物品数量 |
-| steal_time | timestamp | 偷菜时间 |
-| steal_status | tinyint | 偷菜状态 |
-
-#### 2. 农场访问记录表 (social_farm_visit_logs)
-| 字段名 | 类型 | 说明 |
-|--------|------|------|
-| id | bigint | 主键ID |
-| visitor_id | bigint | 访问者用户ID |
-| owner_id | bigint | 农场主用户ID |
-| visit_time | timestamp | 访问时间 |
-| visit_type | tinyint | 访问类型 |
-| actions | json | 访问期间的行为记录 |
-| duration | int | 访问持续时间(秒) |
-
-#### 3. 社交设置表 (social_farm_settings)
-| 字段名 | 类型 | 说明 |
-|--------|------|------|
-| id | bigint | 主键ID |
-| user_id | bigint | 用户ID |
-| allow_steal | tinyint | 允许偷菜 |
-| allow_help | tinyint | 允许互助 |
-| allow_visit | tinyint | 允许访问 |
-| steal_protection_hours | int | 偷菜保护时长 |
-| daily_steal_limit | int | 每日偷菜次数限制 |
-| notification_enabled | tinyint | 通知开关 |
-
-#### 4. 互助记录表 (social_farm_help_logs)
-| 字段名 | 类型 | 说明 |
-|--------|------|------|
-| id | bigint | 主键ID |
-| helper_id | bigint | 帮助者用户ID |
-| owner_id | bigint | 农场主用户ID |
-| land_id | bigint | 帮助的土地ID |
-| help_type | tinyint | 帮助类型 |
-| help_time | timestamp | 帮助时间 |
-| reward_item_id | bigint | 奖励物品ID |
-| reward_amount | int | 奖励数量 |
-
-## 🔧 配置说明
-
-### 系统配置
-```php
-// config/socialfarm.php
-return [
-    // 偷菜配置
-    'steal' => [
-        'daily_limit' => 10,           // 每日偷菜次数限制
-        'cooldown_minutes' => 5,       // 偷菜冷却时间(分钟)
-        'protection_hours' => 2,       // 默认保护时长(小时)
-        'min_yield_ratio' => 0.1,      // 最小偷菜收益比例
-        'max_yield_ratio' => 0.3,      // 最大偷菜收益比例
-    ],
-    
-    // 访问配置
-    'visit' => [
-        'max_duration' => 1800,        // 最大访问时长(秒)
-        'log_retention_days' => 30,    // 访问日志保留天数
-    ],
-    
-    // 互助配置
-    'help' => [
-        'daily_limit' => 20,           // 每日互助次数限制
-        'reward_probability' => 0.3,   // 互助奖励概率
-        'exp_reward' => 5,             // 互助经验奖励
-    ],
-];
-```
-
-## 🚀 开发计划
-
-### 第一阶段：基础功能 (预计2周)
-- [x] 模块目录结构创建
-- [ ] 数据库表设计和创建
-- [ ] 基础模型和枚举定义
-- [ ] 核心服务类框架
-- [ ] 基础偷菜功能实现
-
-### 第二阶段：完善功能 (预计2周)
-- [ ] 农场访问功能
-- [ ] 权限控制系统
-- [ ] 社交设置管理
-- [ ] 通知系统集成
-- [ ] 后台管理界面
-
-### 第三阶段：扩展功能 (预计1周)
-- [ ] 互助功能实现
-- [ ] 社交统计和排行
-- [ ] 性能优化
-- [ ] 测试和文档完善
-
-## 📚 相关文档
-
-- [设计概述](Docs/设计概述.md) - 模块整体设计思路
-- [数据库设计](Docs/数据库设计.md) - 详细的数据库表结构
-- [API接口文档](Docs/API接口文档.md) - 完整的API接口说明
-- [偷菜系统设计](Docs/偷菜系统设计.md) - 偷菜功能详细设计
-- [互助系统设计](Docs/互助系统设计.md) - 互助功能详细设计
-
-## 🔗 模块依赖
-
-### 依赖的模块
-- **Friend模块**: 获取好友关系和好友列表
-- **Farm模块**: 获取农场和作物信息
-- **GameItems模块**: 处理物品奖励和消耗
-- **User模块**: 获取用户基础信息
-- **Notification模块**: 发送社交行为通知
-
-### 被依赖的模块
-- **AppGame模块**: 提供客户端接口处理
-
-## 📝 开发注意事项
-
-1. **数据一致性**: 所有涉及多个操作的功能都使用数据库事务
-2. **性能优化**: 社交查询和统计应考虑缓存策略
-3. **安全验证**: 所有操作前验证用户权限和好友关系
-4. **防刷机制**: 实现完善的防刷和限流机制
-5. **日志记录**: 记录关键操作，便于问题排查和数据分析
-
-## 📈 版本信息
-
-- **创建时间**: 2025年07月02日
-- **当前版本**: v1.0.0-dev
-- **开发状态**: 🚧 开发中
-- **维护者**: 开发团队
-
----
-
-如需了解具体功能的详细信息，请查看Docs目录下的相关文档。

app/Module/SocialFarm/Services/SocialFarmService.php

@@ -1,394 +0,0 @@
-<?php
-
-namespace App\Module\SocialFarm\Services;
-
-use App\Module\SocialFarm\Logics\StealLogic;
-use App\Module\SocialFarm\Logics\VisitLogic;
-use App\Module\SocialFarm\Logics\HelpLogic;
-use App\Module\SocialFarm\Logics\PermissionLogic;
-use App\Module\SocialFarm\Models\SocialFarmSetting;
-use App\Module\SocialFarm\Enums\STEAL_STATUS;
-use App\Module\SocialFarm\Enums\VISIT_TYPE;
-use App\Module\SocialFarm\Enums\HELP_TYPE;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\Log;
-
-/**
- * 社交农场主服务类
- * 
- * 提供社交农场功能的统一对外接口
- */
-class SocialFarmService
-{
-    /**
-     * 访问好友农场
-     *
-     * @param int $visitorId 访问者ID
-     * @param int $ownerId 农场主ID
-     * @param int $visitType 访问类型
-     * @return array 访问结果
-     */
-    public static function visitFriendFarm(int $visitorId, int $ownerId, int $visitType = VISIT_TYPE::NORMAL->value): array
-    {
-        try {
-            // 验证访问权限
-            $permissionCheck = PermissionLogic::checkVisitPermission($visitorId, $ownerId);
-            if (!$permissionCheck['allowed']) {
-                return [
-                    'success' => false,
-                    'code' => 'NO_PERMISSION',
-                    'message' => $permissionCheck['reason']
-                ];
-            }
-
-            // 执行访问逻辑
-            $visitResult = VisitLogic::recordVisit($visitorId, $ownerId, $visitType);
-
-            // 获取农场信息
-            $farmInfo = static::getFriendFarmInfo($ownerId, $visitorId);
-
-            return [
-                'success' => true,
-                'data' => [
-                    'visit_id' => $visitResult['visit_id'],
-                    'farm_info' => $farmInfo,
-                    'permissions' => $permissionCheck['permissions']
-                ]
-            ];
-
-        } catch (\Exception $e) {
-            Log::error('访问好友农场失败', [
-                'visitor_id' => $visitorId,
-                'owner_id' => $ownerId,
-                'error' => $e->getMessage()
-            ]);
-
-            return [
-                'success' => false,
-                'code' => 'VISIT_FAILED',
-                'message' => '访问失败，请稍后重试'
-            ];
-        }
-    }
-
-    /**
-     * 偷菜操作
-     *
-     * @param int $stealerId 偷菜者ID
-     * @param int $ownerId 农场主ID
-     * @param int $landId 土地ID
-     * @return array 偷菜结果
-     */
-    public static function stealCrop(int $stealerId, int $ownerId, int $landId): array
-    {
-        try {
-            // 开启事务
-            return DB::transaction(function () use ($stealerId, $ownerId, $landId) {
-                // 验证偷菜条件
-                $canSteal = StealLogic::canSteal($stealerId, $ownerId, $landId);
-                if (!$canSteal['allowed']) {
-                    return [
-                        'success' => false,
-                        'code' => $canSteal['code'],
-                        'message' => $canSteal['reason']
-                    ];
-                }
-
-                // 执行偷菜
-                $stealResult = StealLogic::executeSteal($stealerId, $ownerId, $landId);
-
-                // 记录访问（如果还没有记录）
-                VisitLogic::recordVisit($stealerId, $ownerId, VISIT_TYPE::STEAL_VISIT->value);
-
-                return [
-                    'success' => true,
-                    'data' => $stealResult
-                ];
-            });
-
-        } catch (\Exception $e) {
-            Log::error('偷菜操作失败', [
-                'stealer_id' => $stealerId,
-                'owner_id' => $ownerId,
-                'land_id' => $landId,
-                'error' => $e->getMessage()
-            ]);
-
-            return [
-                'success' => false,
-                'code' => 'STEAL_FAILED',
-                'message' => '偷菜失败，请稍后重试'
-            ];
-        }
-    }
-
-    /**
-     * 互助操作
-     *
-     * @param int $helperId 帮助者ID
-     * @param int $ownerId 农场主ID
-     * @param int $landId 土地ID
-     * @param int $helpType 帮助类型
-     * @return array 互助结果
-     */
-    public static function helpFriend(int $helperId, int $ownerId, int $landId, int $helpType): array
-    {
-        try {
-            // 开启事务
-            return DB::transaction(function () use ($helperId, $ownerId, $landId, $helpType) {
-                // 验证互助条件
-                $canHelp = HelpLogic::canHelp($helperId, $ownerId, $landId, $helpType);
-                if (!$canHelp['allowed']) {
-                    return [
-                        'success' => false,
-                        'code' => $canHelp['code'],
-                        'message' => $canHelp['reason']
-                    ];
-                }
-
-                // 执行互助
-                $helpResult = HelpLogic::executeHelp($helperId, $ownerId, $landId, $helpType);
-
-                // 记录访问（如果还没有记录）
-                VisitLogic::recordVisit($helperId, $ownerId, VISIT_TYPE::HELP_VISIT->value);
-
-                return [
-                    'success' => true,
-                    'data' => $helpResult
-                ];
-            });
-
-        } catch (\Exception $e) {
-            Log::error('互助操作失败', [
-                'helper_id' => $helperId,
-                'owner_id' => $ownerId,
-                'land_id' => $landId,
-                'help_type' => $helpType,
-                'error' => $e->getMessage()
-            ]);
-
-            return [
-                'success' => false,
-                'code' => 'HELP_FAILED',
-                'message' => '互助失败，请稍后重试'
-            ];
-        }
-    }
-
-    /**
-     * 获取可偷菜的好友列表
-     *
-     * @param int $userId 用户ID
-     * @return array 好友列表
-     */
-    public static function getStealableFriends(int $userId): array
-    {
-        try {
-            // 获取好友列表
-            $friends = \App\Module\Friend\Services\FriendService::getFriendList($userId);
-
-            $stealableFriends = [];
-            foreach ($friends['items'] as $friend) {
-                $friendId = $friend['user_id'];
-                
-                // 检查是否允许偷菜
-                $permission = PermissionLogic::checkStealPermission($userId, $friendId);
-                if (!$permission['allowed']) {
-                    continue;
-                }
-
-                // 获取可偷菜的作物数量
-                $stealableCount = StealLogic::getStealableCropCount($friendId);
-                if ($stealableCount > 0) {
-                    $friend['stealable_count'] = $stealableCount;
-                    $friend['last_visit_time'] = VisitLogic::getLastVisitTime($userId, $friendId);
-                    $stealableFriends[] = $friend;
-                }
-            }
-
-            return [
-                'success' => true,
-                'data' => $stealableFriends
-            ];
-
-        } catch (\Exception $e) {
-            Log::error('获取可偷菜好友列表失败', [
-                'user_id' => $userId,
-                'error' => $e->getMessage()
-            ]);
-
-            return [
-                'success' => false,
-                'message' => '获取好友列表失败'
-            ];
-        }
-    }
-
-    /**
-     * 获取好友农场信息
-     *
-     * @param int $ownerId 农场主ID
-     * @param int $visitorId 访问者ID
-     * @return array 农场信息
-     */
-    public static function getFriendFarmInfo(int $ownerId, int $visitorId): array
-    {
-        try {
-            // 获取农场基础信息
-            $farmInfo = \App\Module\Farm\Services\FarmService::getFarmInfo($ownerId);
-            
-            // 获取土地信息（包含作物状态）
-            $lands = \App\Module\Farm\Services\LandService::getUserLands($ownerId);
-            
-            // 为每块土地添加社交相关信息
-            foreach ($lands as &$land) {
-                if ($land['crop']) {
-                    // 检查是否可偷菜
-                    $canSteal = StealLogic::canStealCrop($visitorId, $ownerId, $land['id']);
-                    $land['can_steal'] = $canSteal['allowed'];
-                    $land['steal_reason'] = $canSteal['reason'] ?? '';
-                    
-                    // 检查是否可互助
-                    $canHelp = HelpLogic::getAvailableHelpTypes($visitorId, $ownerId, $land['id']);
-                    $land['help_types'] = $canHelp;
-                }
-            }
-
-            return [
-                'farm_info' => $farmInfo,
-                'lands' => $lands,
-                'owner_settings' => static::getUserSocialSettings($ownerId)
-            ];
-
-        } catch (\Exception $e) {
-            Log::error('获取好友农场信息失败', [
-                'owner_id' => $ownerId,
-                'visitor_id' => $visitorId,
-                'error' => $e->getMessage()
-            ]);
-
-            return [];
-        }
-    }
-
-    /**
-     * 获取用户社交设置
-     *
-     * @param int $userId 用户ID
-     * @return array 社交设置
-     */
-    public static function getUserSocialSettings(int $userId): array
-    {
-        $settings = SocialFarmSetting::where('user_id', $userId)->first();
-        
-        if (!$settings) {
-            // 创建默认设置
-            $settings = SocialFarmSetting::create(['user_id' => $userId]);
-        }
-
-        return [
-            'allow_steal' => $settings->allow_steal,
-            'allow_help' => $settings->allow_help,
-            'allow_visit' => $settings->allow_visit,
-            'steal_protection_hours' => $settings->steal_protection_hours,
-            'daily_steal_limit' => $settings->daily_steal_limit,
-            'daily_help_limit' => $settings->daily_help_limit,
-            'notification_enabled' => $settings->notification_enabled,
-            'friend_only' => $settings->friend_only,
-        ];
-    }
-
-    /**
-     * 更新用户社交设置
-     *
-     * @param int $userId 用户ID
-     * @param array $settings 设置数据
-     * @return array 更新结果
-     */
-    public static function updateUserSocialSettings(int $userId, array $settings): array
-    {
-        try {
-            $userSettings = SocialFarmSetting::where('user_id', $userId)->first();
-            
-            if (!$userSettings) {
-                $userSettings = new SocialFarmSetting(['user_id' => $userId]);
-            }
-
-            // 更新设置
-            $allowedFields = [
-                'allow_steal', 'allow_help', 'allow_visit',
-                'steal_protection_hours', 'daily_steal_limit', 'daily_help_limit',
-                'notification_enabled', 'auto_revenge', 'friend_only'
-            ];
-
-            foreach ($allowedFields as $field) {
-                if (isset($settings[$field])) {
-                    $userSettings->$field = $settings[$field];
-                }
-            }
-
-            $userSettings->save();
-
-            return [
-                'success' => true,
-                'data' => $userSettings->toArray()
-            ];
-
-        } catch (\Exception $e) {
-            Log::error('更新用户社交设置失败', [
-                'user_id' => $userId,
-                'settings' => $settings,
-                'error' => $e->getMessage()
-            ]);
-
-            return [
-                'success' => false,
-                'message' => '设置更新失败'
-            ];
-        }
-    }
-
-    /**
-     * 获取用户社交统计
-     *
-     * @param int $userId 用户ID
-     * @param string $date 统计日期（可选，默认今天）
-     * @return array 统计数据
-     */
-    public static function getUserSocialStats(int $userId, string $date = null): array
-    {
-        try {
-            $date = $date ?: date('Y-m-d');
-            
-            $stats = \App\Module\SocialFarm\Models\SocialFarmStats::where('user_id', $userId)
-                ->where('stat_date', $date)
-                ->first();
-
-            if (!$stats) {
-                return [
-                    'steal_count' => 0,
-                    'stolen_count' => 0,
-                    'help_count' => 0,
-                    'helped_count' => 0,
-                    'visit_count' => 0,
-                    'visited_count' => 0,
-                    'steal_items_gained' => 0,
-                    'steal_items_lost' => 0,
-                    'help_rewards_gained' => 0,
-                    'total_exp_gained' => 0,
-                ];
-            }
-
-            return $stats->toArray();
-
-        } catch (\Exception $e) {
-            Log::error('获取用户社交统计失败', [
-                'user_id' => $userId,
-                'date' => $date,
-                'error' => $e->getMessage()
-            ]);
-
-            return [];
-        }
-    }
-}

app/Module/SocialFarm/config/socialfarm.php

@@ -1,234 +0,0 @@
-<?php
-
-return [
-    /*
-    |--------------------------------------------------------------------------
-    | 社交农场配置
-    |--------------------------------------------------------------------------
-    |
-    | 这里配置社交农场模块的各种参数和规则
-    |
-    */
-
-    // 偷菜相关配置
-    'steal' => [
-        // 每日偷菜次数限制
-        'daily_limit' => env('SOCIAL_FARM_DAILY_STEAL_LIMIT', 10),
-        
-        // 偷菜冷却时间(分钟)
-        'cooldown_minutes' => env('SOCIAL_FARM_STEAL_COOLDOWN', 5),
-        
-        // 默认保护时长(小时)
-        'protection_hours' => env('SOCIAL_FARM_PROTECTION_HOURS', 2),
-        
-        // 最小偷菜收益比例
-        'min_yield_ratio' => env('SOCIAL_FARM_MIN_YIELD_RATIO', 0.1),
-        
-        // 最大偷菜收益比例
-        'max_yield_ratio' => env('SOCIAL_FARM_MAX_YIELD_RATIO', 0.3),
-        
-        // 偷菜经验奖励
-        'exp_reward' => env('SOCIAL_FARM_STEAL_EXP', 10),
-        
-        // 是否允许偷取未成熟作物
-        'allow_unripe' => env('SOCIAL_FARM_ALLOW_UNRIPE', false),
-        
-        // 偷菜成功率(0-1)
-        'success_rate' => env('SOCIAL_FARM_STEAL_SUCCESS_RATE', 0.8),
-    ],
-
-    // 访问相关配置
-    'visit' => [
-        // 最大访问时长(秒)
-        'max_duration' => env('SOCIAL_FARM_MAX_VISIT_DURATION', 1800),
-        
-        // 访问日志保留天数
-        'log_retention_days' => env('SOCIAL_FARM_VISIT_LOG_RETENTION', 30),
-        
-        // 是否记录访问详情
-        'record_details' => env('SOCIAL_FARM_RECORD_VISIT_DETAILS', true),
-        
-        // 访问频率限制(次/小时)
-        'hourly_limit' => env('SOCIAL_FARM_VISIT_HOURLY_LIMIT', 50),
-    ],
-
-    // 互助相关配置
-    'help' => [
-        // 每日互助次数限制
-        'daily_limit' => env('SOCIAL_FARM_DAILY_HELP_LIMIT', 20),
-        
-        // 互助奖励概率
-        'reward_probability' => env('SOCIAL_FARM_HELP_REWARD_PROBABILITY', 0.3),
-        
-        // 互助经验奖励
-        'exp_reward' => env('SOCIAL_FARM_HELP_EXP', 5),
-        
-        // 互助冷却时间(分钟)
-        'cooldown_minutes' => env('SOCIAL_FARM_HELP_COOLDOWN', 2),
-        
-        // 是否消耗道具
-        'consume_items' => env('SOCIAL_FARM_HELP_CONSUME_ITEMS', true),
-        
-        // 互助类型配置
-        'types' => [
-            'water' => [
-                'exp_reward' => 2,
-                'reward_probability' => 0.1,
-                'required_item_type' => 'water_tool',
-            ],
-            'fertilize' => [
-                'exp_reward' => 3,
-                'reward_probability' => 0.15,
-                'required_item_type' => 'fertilizer',
-            ],
-            'weed' => [
-                'exp_reward' => 5,
-                'reward_probability' => 0.2,
-                'required_item_type' => 'weed_killer',
-            ],
-            'pest' => [
-                'exp_reward' => 5,
-                'reward_probability' => 0.2,
-                'required_item_type' => 'pesticide',
-            ],
-            'harvest' => [
-                'exp_reward' => 8,
-                'reward_probability' => 0.3,
-                'required_item_type' => null,
-            ],
-        ],
-    ],
-
-    // 通知相关配置
-    'notification' => [
-        // 是否启用通知
-        'enabled' => env('SOCIAL_FARM_NOTIFICATION_ENABLED', true),
-        
-        // 偷菜通知
-        'steal_notification' => env('SOCIAL_FARM_STEAL_NOTIFICATION', true),
-        
-        // 互助通知
-        'help_notification' => env('SOCIAL_FARM_HELP_NOTIFICATION', true),
-        
-        // 访问通知
-        'visit_notification' => env('SOCIAL_FARM_VISIT_NOTIFICATION', false),
-        
-        // 通知延迟发送(秒)
-        'delay_seconds' => env('SOCIAL_FARM_NOTIFICATION_DELAY', 0),
-        
-        // 批量通知阈值
-        'batch_threshold' => env('SOCIAL_FARM_NOTIFICATION_BATCH_THRESHOLD', 5),
-    ],
-
-    // 权限相关配置
-    'permission' => [
-        // 是否只允许好友访问
-        'friend_only_default' => env('SOCIAL_FARM_FRIEND_ONLY_DEFAULT', true),
-        
-        // 黑名单最大数量
-        'max_blacklist_size' => env('SOCIAL_FARM_MAX_BLACKLIST_SIZE', 100),
-        
-        // 白名单最大数量
-        'max_whitelist_size' => env('SOCIAL_FARM_MAX_WHITELIST_SIZE', 50),
-        
-        // 是否允许自动反偷
-        'allow_auto_revenge' => env('SOCIAL_FARM_ALLOW_AUTO_REVENGE', true),
-        
-        // 新用户默认设置
-        'default_settings' => [
-            'allow_steal' => true,
-            'allow_help' => true,
-            'allow_visit' => true,
-            'steal_protection_hours' => 0,
-            'daily_steal_limit' => 10,
-            'daily_help_limit' => 20,
-            'notification_enabled' => true,
-            'auto_revenge' => false,
-            'friend_only' => true,
-        ],
-    ],
-
-    // 统计相关配置
-    'stats' => [
-        // 是否启用统计
-        'enabled' => env('SOCIAL_FARM_STATS_ENABLED', true),
-        
-        // 统计数据保留天数
-        'retention_days' => env('SOCIAL_FARM_STATS_RETENTION', 90),
-        
-        // 是否实时更新统计
-        'realtime_update' => env('SOCIAL_FARM_STATS_REALTIME', true),
-        
-        // 统计任务执行时间
-        'cron_schedule' => env('SOCIAL_FARM_STATS_CRON', '0 1 * * *'),
-    ],
-
-    // 缓存相关配置
-    'cache' => [
-        // 缓存前缀
-        'prefix' => env('SOCIAL_FARM_CACHE_PREFIX', 'social_farm'),
-        
-        // 农场信息缓存时间(分钟)
-        'farm_info_ttl' => env('SOCIAL_FARM_CACHE_FARM_INFO_TTL', 5),
-        
-        // 用户设置缓存时间(分钟)
-        'user_settings_ttl' => env('SOCIAL_FARM_CACHE_USER_SETTINGS_TTL', 60),
-        
-        // 好友列表缓存时间(分钟)
-        'friend_list_ttl' => env('SOCIAL_FARM_CACHE_FRIEND_LIST_TTL', 30),
-        
-        // 统计数据缓存时间(分钟)
-        'stats_ttl' => env('SOCIAL_FARM_CACHE_STATS_TTL', 30),
-    ],
-
-    // 安全相关配置
-    'security' => [
-        // API调用频率限制(次/分钟)
-        'api_rate_limit' => env('SOCIAL_FARM_API_RATE_LIMIT', 100),
-        
-        // 是否记录IP地址
-        'log_ip_address' => env('SOCIAL_FARM_LOG_IP_ADDRESS', true),
-        
-        // 是否记录用户代理
-        'log_user_agent' => env('SOCIAL_FARM_LOG_USER_AGENT', true),
-        
-        // 异常操作检测
-        'anomaly_detection' => env('SOCIAL_FARM_ANOMALY_DETECTION', true),
-        
-        // 异常操作阈值
-        'anomaly_threshold' => env('SOCIAL_FARM_ANOMALY_THRESHOLD', 50),
-    ],
-
-    // 数据清理配置
-    'cleanup' => [
-        // 是否启用自动清理
-        'enabled' => env('SOCIAL_FARM_CLEANUP_ENABLED', true),
-        
-        // 偷菜记录保留天数
-        'steal_logs_retention' => env('SOCIAL_FARM_STEAL_LOGS_RETENTION', 180),
-        
-        // 访问记录保留天数
-        'visit_logs_retention' => env('SOCIAL_FARM_VISIT_LOGS_RETENTION', 30),
-        
-        // 互助记录保留天数
-        'help_logs_retention' => env('SOCIAL_FARM_HELP_LOGS_RETENTION', 90),
-        
-        // 清理任务执行时间
-        'cron_schedule' => env('SOCIAL_FARM_CLEANUP_CRON', '0 2 * * 0'),
-    ],
-
-    // 调试相关配置
-    'debug' => [
-        // 是否启用调试模式
-        'enabled' => env('SOCIAL_FARM_DEBUG', false),
-        
-        // 详细日志记录
-        'verbose_logging' => env('SOCIAL_FARM_VERBOSE_LOGGING', false),
-        
-        // 性能监控
-        'performance_monitoring' => env('SOCIAL_FARM_PERFORMANCE_MONITORING', false),
-        
-        // 测试模式
-        'test_mode' => env('SOCIAL_FARM_TEST_MODE', false),
-    ],
-];