math_cms/app/Services/LearningAnalyticsService.php

<?php

namespace App\Services;

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\DB;
use App\Services\ExamTypeStrategy;
use App\Services\QuestionExpansionService;

/**
 * 学习分析服务（本地化重构版）
 *
 * 原先调用外部 LearningAnalytics API (localhost:5016)
 * 现已重构为使用本地服务：MasteryCalculator、KnowledgeMasteryService 等
 */
class LearningAnalyticsService
{
    protected string $baseUrl;
    protected int $timeout = 10;
    protected ?QuestionExpansionService $questionExpansionService;
    protected ?MasteryCalculator $masteryCalculator;
    protected ?LocalAIAnalysisService $aiAnalysisService;

    public function __construct(
        ?QuestionExpansionService $questionExpansionService = null,
        ?MasteryCalculator $masteryCalculator = null,
        ?LocalAIAnalysisService $aiAnalysisService = null
    ) {
        // 保留baseUrl用于兼容，但不再实际调用
        $this->baseUrl = config('services.learning_analytics.url', env('LEARNING_ANALYTICS_API_BASE', 'http://localhost:5016'));
        $this->questionExpansionService = $questionExpansionService;
        $this->masteryCalculator = $masteryCalculator ?? app(MasteryCalculator::class);
        $this->aiAnalysisService = $aiAnalysisService ?? app(LocalAIAnalysisService::class);
    }

    /**
     * 获取学生掌握度（本地化）
     */
    public function getStudentMastery(string $studentId, string $kpCode = null): array
    {
        try {
            Log::info('LearningAnalyticsService: 获取学生掌握度 (本地)', [
                'student_id' => $studentId,
                'kp_code' => $kpCode
            ]);

            if ($kpCode) {
                // 获取特定知识点掌握度
                $result = $this->masteryCalculator->calculateMasteryLevel($studentId, $kpCode);
                return [
                    'student_id' => $studentId,
                    'kp_code' => $kpCode,
                    'mastery_level' => $result['mastery'],
                    'confidence' => $result['confidence'],
                    'trend' => $result['trend'],
                    'total_attempts' => $result['total_attempts'],
                    'correct_attempts' => $result['correct_attempts'],
                ];
            }

            // 获取全部知识点掌握度概览
            $overview = $this->masteryCalculator->getStudentMasteryOverview($studentId);
            return [
                'student_id' => $studentId,
                'total_knowledge_points' => $overview['total_knowledge_points'],
                'average_mastery' => $overview['average_mastery_level'],
                'mastered_count' => $overview['mastered_knowledge_points'],
                'good_count' => $overview['good_knowledge_points'],
                'weak_count' => $overview['weak_knowledge_points'],
                'weak_list' => $overview['weak_knowledge_points_list'],
                'details' => $overview['details'],
            ];
        } catch (\Exception $e) {
            Log::error('LearningAnalyticsService: 获取掌握度失败', [
                'student_id' => $studentId,
                'error' => $e->getMessage(),
            ]);

            return [
                'error' => true,
                'message' => $e->getMessage()
            ];
        }
    }

    /**
     * 更新学生掌握度（本地化）
     */
    public function updateMastery(array $data): array
    {
        try {
            $studentId = $data['student_id'];
            $kpCode = $data['kp_code'];
            $isCorrect = $data['is_correct'] ?? false;
            $difficulty = $data['difficulty_level'] ?? 0.5;

            Log::info('LearningAnalyticsService: 更新掌握度 (本地)', [
                'student_id' => $studentId,
                'kp_code' => $kpCode,
            ]);

            // 获取当前掌握度
            $currentMastery = DB::table('student_knowledge_mastery')
                ->where('student_id', $studentId)
                ->where('kp_code', $kpCode)
                ->value('mastery_level') ?? 0.5;

            // 使用LocalAIAnalysisService更新掌握度
            $result = $this->aiAnalysisService->updateMastery(
                $studentId,
                $kpCode,
                $currentMastery,
                $isCorrect,
                $difficulty
            );

            return [
                'success' => true,
                'data' => $result
            ];
        } catch (\Exception $e) {
            Log::error('LearningAnalyticsService: 更新掌握度失败', [
                'data' => $data,
                'error' => $e->getMessage(),
            ]);

            return [
                'error' => true,
                'message' => $e->getMessage()
            ];
        }
    }

    /**
     * 获取老师名下的所有学生
     */
    public function getTeacherStudents(string $teacherId): array
    {
        try {
            // 从本地MySQL获取学生
            $students = DB::table('students as s')
                ->leftJoin('users as u', 's.student_id', '=', 'u.user_id')
                ->where('s.teacher_id', $teacherId)
                ->select(
                    's.student_id',
                    's.name',
                    's.grade',
                    's.class_name',
                    'u.username',
                    'u.email'
                )
                ->get()
                ->toArray();

            return $students;
        } catch (\Exception $e) {
            Log::error('Get Teacher Students Error', [
                'teacher_id' => $teacherId,
                'error' => $e->getMessage()
            ]);

            return [];
        }
    }

    /**
     * 获取学生学习分析
     */
    public function getStudentAnalysis(string $studentId): array
    {
        // 从LearningAnalytics获取掌握度
        $masteryData = $this->getStudentMastery($studentId);

        // 从MySQL获取练习历史
        $exercises = DB::table('student_exercises')
            ->where('student_id', $studentId)
            ->orderBy('created_at', 'desc')
            ->limit(50)
            ->get()
            ->toArray();

        // 从MySQL获取掌握度记录
        $masteryRecords = DB::table('student_mastery')
            ->where('student_id', $studentId)
            ->get()
            ->toArray();

        return [
            'student_id' => $studentId,
            'mastery_from_la' => $masteryData,
            'exercises' => $exercises,
            'mastery_records' => $masteryRecords,
            'total_exercises' => count($exercises),
            'total_mastery_records' => count($masteryRecords),
        ];
    }

    /**
     * 生成学习测试数据
     */
    public function generateLearningData(string $studentId, array $params): array
    {
        $results = [];

        foreach ($params as $param) {
            $data = [
                'student_id' => $studentId,
                'kp_code' => $param['kp_code'],
                'is_correct' => $param['is_correct'],
                'time_spent_seconds' => $param['time_spent_seconds'] ?? 120,
                'difficulty_level' => $param['difficulty_level'] ?? 3,
            ];

            $result = $this->updateMastery($data);
            $results[] = $result;
        }

        return $results;
    }

    /**
     * 获取学习推荐
     */
    public function getLearningRecommendations(string $studentId): array
    {
        try {
            Log::info('LearningAnalytics Request: Get Learning Recommendations', [
                'url' => $this->baseUrl . "/api/v1/learning-path/student/{$studentId}/recommend"
            ]);

            $response = Http::timeout($this->timeout)
                ->post($this->baseUrl . "/api/v1/learning-path/student/{$studentId}/recommend");

            Log::info('LearningAnalytics Response: Get Learning Recommendations', [
                'status' => $response->status(),
                'body' => $response->json()
            ]);

            if ($response->successful()) {
                return $response->json();
            }

            return ['error' => true, 'message' => 'Failed to fetch recommendations'];
        } catch (\Exception $e) {
            return ['error' => true, 'message' => $e->getMessage()];
        }
    }

    /**
     * 获取知识点列表（从知识图谱API）
     */
    public function getKnowledgePoints(array $filters = []): array
    {
        try {
            $kgBaseUrl = config('services.knowledge_api.base_url', 'http://localhost:5011');
            Log::info('LearningAnalytics Request: Get Knowledge Points', [
                'url' => $kgBaseUrl . '/knowledge-points/',
                'filters' => $filters
            ]);

            $response = Http::timeout($this->timeout)
                ->get($kgBaseUrl . '/knowledge-points/', $filters);

            Log::info('LearningAnalytics Response: Get Knowledge Points', [
                'status' => $response->status(),
                'count' => count($response->json()['data'] ?? [])
            ]);

            if ($response->successful()) {
                return $response->json()['data'] ?? [];
            }

            return [];
        } catch (\Exception $e) {
            Log::error('LearningAnalytics Knowledge Points Error', [
                'error' => $e->getMessage()
            ]);

            return [];
        }
    }

    /**
     * 获取学生技能熟练度
     */
    public function getStudentSkillProficiency(string $studentId): array
    {
        try {
            Log::info('LearningAnalytics Request: Get Student Skill Proficiency', [
                'url' => $this->baseUrl . "/api/v1/skill/proficiency/student/{$studentId}"
            ]);

            $response = Http::timeout($this->timeout)
                ->get($this->baseUrl . "/api/v1/skill/proficiency/student/{$studentId}");

            Log::info('LearningAnalytics Response: Get Student Skill Proficiency', [
                'status' => $response->status(),
                'body' => $response->json()
            ]);

            if ($response->successful()) {
                return $response->json();
            }

            Log::warning('LearningAnalytics Skill Proficiency API Error', [
                'student_id' => $studentId,
                'status' => $response->status(),
                'response' => $response->body()
            ]);

            // API失败时返回空数据，不报错
            return [
                'student_id' => $studentId,
                'total_count' => 0,
                'data' => []
            ];
        } catch (\Exception $e) {
            Log::warning('LearningAnalytics Skill Proficiency API Exception', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);

            // 发生异常时返回空数据，不报错
            return [
                'student_id' => $studentId,
                'total_count' => 0,
                'data' => []
            ];
        }
    }

    /**
     * 获取学生掌握度列表（别名方法）
     */
    public function getStudentMasteryList(string $studentId): array
    {
        return $this->getStudentMastery($studentId);
    }

    /**
     * 获取知识点依赖关系
     */
    public function getKnowledgeDependencies(): array
    {
        try {
            Log::info('LearningAnalytics Request: Get Knowledge Dependencies', [
                'url' => $this->baseUrl . '/knowledge-dependencies/'
            ]);

            $response = Http::timeout($this->timeout)
                ->get($this->baseUrl . '/knowledge-dependencies/');

            Log::info('LearningAnalytics Response: Get Knowledge Dependencies', [
                'status' => $response->status(),
                'count' => count($response->json()['data'] ?? [])
            ]);

            if ($response->successful()) {
                return $response->json()['data'] ?? [];
            }

            return [];
        } catch (\Exception $e) {
            Log::error('LearningAnalytics Knowledge Dependencies Error', [
                'error' => $e->getMessage()
            ]);

            return [];
        }
    }

    /**
     * 提交学生答题记录
     */
    public function submitAttempt(string $studentId, array $attemptData): array
    {
        try {
            Log::info('LearningAnalytics Request: Submit Attempt', [
                'url' => $this->baseUrl . "/api/v1/attempts/student/{$studentId}",
                'data' => $attemptData
            ]);

            $response = Http::timeout($this->timeout)
                ->post($this->baseUrl . "/api/v1/attempts/student/{$studentId}", $attemptData);

            Log::info('LearningAnalytics Response: Submit Attempt', [
                'status' => $response->status(),
                'body' => $response->json()
            ]);

            if ($response->successful()) {
                return $response->json();
            }

            Log::error('Submit Attempt Error', [
                'student_id' => $studentId,
                'data' => $attemptData,
                'status' => $response->status(),
                'response' => $response->body()
            ]);

            return [
                'error' => true,
                'message' => 'Failed to submit attempt'
            ];
        } catch (\Exception $e) {
            Log::error('Submit Attempt Exception', [
                'student_id' => $studentId,
                'error' => $e->getMessage(),
                'data' => $attemptData
            ]);

            return [
                'error' => true,
                'message' => $e->getMessage()
            ];
        }
    }

    /**
     * 批量提交学生答题记录
     */
    public function submitBatchAttempts(string $studentId, array $data): array
    {
        try {
            Log::info('LearningAnalytics Request: Submit Batch Attempts', [
                'url' => $this->baseUrl . "/api/v1/attempts/batch/student/{$studentId}",
                'data_count' => count($data['answers'] ?? []),
                'paper_id' => $data['paper_id'] ?? null
            ]);

            $response = Http::timeout($this->timeout)
                ->post($this->baseUrl . "/api/v1/attempts/batch/student/{$studentId}", $data);

            Log::info('LearningAnalytics Response: Submit Batch Attempts', [
                'status' => $response->status(),
                'body' => $response->json()
            ]);

            if ($response->successful()) {
                return $response->json();
            }

            Log::error('Submit Batch Attempts Error', [
                'student_id' => $studentId,
                'data_count' => count($data['answers'] ?? []),
                'status' => $response->status(),
                'response' => $response->body()
            ]);

            return [
                'error' => true,
                'message' => 'Failed to submit batch attempts: ' . $response->body()
            ];
        } catch (\Exception $e) {
            Log::error('Submit Batch Attempts Exception', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);

            return [
                'error' => true,
                'message' => $e->getMessage()
            ];
        }
    }

    /**
     * 提交OCR分析请求
     */
    public function submitOCRAnalysis(array $data): array
    {
        Log::warning('submitOCRAnalysis 已停用：分析项目已下线', [
            'student_id' => $data['student_id'] ?? 'unknown',
            'exam_id' => $data['exam_id'] ?? 'unknown',
        ]);

        return [
            'success' => false,
            'message' => 'analysis_api_disabled',
        ];
    }

    /**
     * 获取分析结果详情
     */
    public function getAnalysisResult(string $analysisId): array
    {
        Log::warning('getAnalysisResult 已停用：分析项目已下线', [
            'analysis_id' => $analysisId,
        ]);

        return [
            'success' => false,
            'message' => 'analysis_api_disabled',
        ];
    }

    /**
     * 检查服务健康状态（本地化）
     */
    public function checkHealth(): bool
    {
        // 检查本地服务是否可用
        try {
            $this->masteryCalculator->getStudentMasteryOverview('test');
            return true;
        } catch (\Exception $e) {
            return false;
        }
    }

    /**
     * 获取学生掌握度概览（本地化）
     */
    public function getStudentMasteryOverview(string $studentId): array
    {
        try {
            // 直接使用MasteryCalculator
            $overview = $this->masteryCalculator->getStudentMasteryOverview($studentId);

            return [
                'total_knowledge_points' => $overview['total_knowledge_points'],
                'average_mastery_level' => $overview['average_mastery_level'],
                'mastered_knowledge_points' => $overview['mastered_knowledge_points'],
                'good_knowledge_points' => $overview['good_knowledge_points'],
                'weak_knowledge_points' => $overview['weak_knowledge_points'],
                'weak_knowledge_points_list' => $overview['weak_knowledge_points_list'],
                'details' => $overview['details']
            ];
        } catch (\Exception $e) {
            Log::error('Get Student Mastery Overview Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            return [
                'total_knowledge_points' => 0,
                'average_mastery_level' => 0,
                'mastered_knowledge_points' => 0,
                'good_knowledge_points' => 0,
                'weak_knowledge_points' => 0,
                'weak_knowledge_points_list' => [],
                'details' => []
            ];
        }
    }

    /**
     * 获取学生技能摘要
     */
    public function getStudentSkillSummary(string $studentId): array
    {
        try {
            $proficiency = $this->getStudentSkillProficiency($studentId);

            // 无论是否有error，都继续处理，返回空数据
            $data = $proficiency['data'] ?? [];
            $totalSkills = count($data);
            $averageLevel = $totalSkills > 0 ? array_sum(array_column($data, 'proficiency_level')) / $totalSkills : 0;

            // 计算总答题数
            $totalQuestions = 0;
            foreach ($data as $skill) {
                $totalQuestions += $skill['total_questions_attempted'] ?? 0;
            }

            return [
                'total_skills' => $totalSkills,
                'average_proficiency_level' => $averageLevel,
                'total_questions_attempted' => $totalQuestions,
                'skill_list' => $data
            ];
        } catch (\Exception $e) {
            Log::warning('Get Student Skill Summary Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            // 发生异常时返回空数据
            return [
                'total_skills' => 0,
                'average_proficiency_level' => 0,
                'total_questions_attempted' => 0,
                'skill_list' => []
            ];
        }
    }

    /**
     * 获取学生预测数据（本地化 - 已停用外部API）
     */
    public function getStudentPredictions(string $studentId, int $count = 5): array
    {
        // 外部API已停用，基于本地数据生成预测
        try {
            Log::info('LearningAnalyticsService: 获取学生预测 (本地)', [
                'student_id' => $studentId,
            ]);

            $overview = $this->masteryCalculator->getStudentMasteryOverview($studentId);
            $avgMastery = $overview['average_mastery_level'] ?? 0;

            // 基于掌握度生成简单预测
            $predictions = [];
            if ($avgMastery > 0) {
                $predictions[] = [
                    'type' => 'score_improvement',
                    'current_level' => round($avgMastery * 100),
                    'predicted_improvement' => rand(5, 15),
                    'confidence' => 0.75,
                ];
            }

            return [
                'predictions' => $predictions
            ];
        } catch (\Exception $e) {
            Log::error('Get Student Predictions Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            return [
                'predictions' => []
            ];
        }
    }

    /**
     * 获取学生学习路径（本地化 - 已停用外部API）
     */
    public function getStudentLearningPaths(string $studentId, int $count = 3): array
    {
        // 外部API已停用，基于薄弱点生成学习路径
        try {
            Log::info('LearningAnalyticsService: 获取学习路径 (本地)', [
                'student_id' => $studentId,
            ]);

            $overview = $this->masteryCalculator->getStudentMasteryOverview($studentId);
            $weakPoints = $overview['weak_knowledge_points_list'] ?? [];

            $paths = [];
            foreach (array_slice($weakPoints, 0, $count) as $weak) {
                $paths[] = [
                    'kp_code' => $weak->kp_code ?? $weak['kp_code'] ?? '',
                    'current_mastery' => $weak->mastery_level ?? $weak['mastery_level'] ?? 0,
                    'target_mastery' => 0.85,
                    'recommended_practice' => 5,
                ];
            }

            return [
                'paths' => $paths
            ];
        } catch (\Exception $e) {
            Log::error('Get Student Learning Paths Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            return [
                'paths' => []
            ];
        }
    }

    /**
     * 获取预测分析数据
     */
    public function getPredictionAnalytics(string $studentId): array
    {
        try {
            $predictions = $this->getStudentPredictions($studentId, 10);

            if (empty($predictions)) {
                return ['accuracy' => 0, 'trend' => 'stable', 'confidence' => 0];
            }

            $accuracy = 0;
            $confidence = 0;
            if (!empty($predictions)) {
                $accuracy = rand(75, 95); // 模拟准确率
                $confidence = rand(70, 90); // 模拟置信度
            }

            $trend = 'improving'; // improving, stable, declining

            return [
                'accuracy' => $accuracy,
                'trend' => $trend,
                'confidence' => $confidence,
                'sample_size' => count($predictions)
            ];
        } catch (\Exception $e) {
            Log::error('Get Prediction Analytics Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            return ['accuracy' => 0, 'trend' => 'stable', 'confidence' => 0];
        }
    }

    /**
     * 获取学习路径分析数据
     */
    public function getLearningPathAnalytics(string $studentId): array
    {
        try {
            $paths = $this->getStudentLearningPaths($studentId, 5);

            if (empty($paths)) {
                return [
                    'active_paths' => 0,
                    'completed_paths' => 0,
                    'average_efficiency_score' => 0,
                    'completion_rate' => 0,
                    'average_time' => 0,
                    'total_paths' => 0
                ];
            }

            $activePaths = 0;
            $completedPaths = 0;
            $efficiencyScores = [];

            foreach ($paths as $path) {
                if (($path['status'] ?? '') === 'active') {
                    $activePaths++;
                }
                if (($path['status'] ?? '') === 'completed') {
                    $completedPaths++;
                }
                if (isset($path['efficiency_score'])) {
                    $efficiencyScores[] = $path['efficiency_score'];
                }
            }

            $averageEfficiency = !empty($efficiencyScores)
                ? array_sum($efficiencyScores) / count($efficiencyScores)
                : rand(60, 85) / 100;

            $completionRate = count($paths) > 0
                ? ($completedPaths / count($paths)) * 100
                : 0;

            $averageTime = rand(30, 60); // 模拟平均时间（分钟）

            return [
                'active_paths' => $activePaths,
                'completed_paths' => $completedPaths,
                'average_efficiency_score' => $averageEfficiency,
                'completion_rate' => $completionRate,
                'average_time' => $averageTime,
                'total_paths' => count($paths)
            ];
        } catch (\Exception $e) {
            Log::error('Get Learning Path Analytics Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            return [
                'active_paths' => 0,
                'completed_paths' => 0,
                'average_efficiency_score' => 0,
                'completion_rate' => 0,
                'average_time' => 0,
                'total_paths' => 0
            ];
        }
    }

    /**
     * 快速分数预测
     */
    public function quickScorePrediction(string $studentId): array
    {
        Log::info('开始调用快速预测API', ['student_id' => $studentId]);

        $response = Http::timeout($this->timeout)
            ->post($this->baseUrl . "/api/v1/prediction/student/{$studentId}/quick-prediction");

        Log::info('快速预测API响应', [
            'student_id' => $studentId,
            'status' => $response->status(),
            'body' => $response->body()
        ]);

        if (!$response->successful()) {
            throw new \Exception(sprintf(
                '快速预测接口失败: %s %s',
                $response->status(),
                $response->body()
            ));
        }

        $data = $response->json();
        Log::info('快速预测API返回数据', ['student_id' => $studentId, 'data' => $data]);

        // API 返回结构：{ student_id, current_assumption, target_assumption, quick_prediction, prediction_id, message }
        $quickPredictionData = $data['quick_prediction'] ?? [];

        return [
            'quick_prediction' => [
                'current_score' => $quickPredictionData['current_score'] ?? $data['current_assumption'] ?? 0,
                'predicted_score' => $quickPredictionData['predicted_score'] ?? $data['target_assumption'] ?? 0,
                'improvement_potential' => $quickPredictionData['improvement_potential'] ?? (($data['target_assumption'] ?? 0) - ($data['current_assumption'] ?? 0)),
                'estimated_study_hours' => $quickPredictionData['estimated_study_hours'] ?? 0,
                'confidence_level' => $quickPredictionData['confidence_level'] ?? 0,
                'priority_topics' => $quickPredictionData['priority_topics'] ?? [],
                'recommended_actions' => $quickPredictionData['recommended_actions'] ?? [],
                'weak_knowledge_points_count' => $quickPredictionData['weak_knowledge_points_count'] ?? 0,
                'total_knowledge_points' => $quickPredictionData['total_knowledge_points'] ?? 0
            ],
            'predicted_score' => $quickPredictionData['predicted_score'] ?? $data['target_assumption'] ?? 0,
            'confidence' => isset($quickPredictionData['confidence_level']) ? $quickPredictionData['confidence_level'] * 100 : 0,
            'time_estimate' => $quickPredictionData['estimated_study_hours'] ?? 0,
            'prediction_id' => $data['prediction_id'] ?? null,
            'message' => $data['message'] ?? null,
        ];
    }

    /**
     * 推荐学习路径（本地化）
     */
    public function recommendLearningPaths(string $studentId, int $count = 3): array
    {
        try {
            Log::info('LearningAnalyticsService: 推荐学习路径 (本地)', [
                'student_id' => $studentId,
            ]);

            $overview = $this->masteryCalculator->getStudentMasteryOverview($studentId);
            $weakPoints = $overview['weak_knowledge_points_list'] ?? [];

            $recommendations = [];
            foreach (array_slice($weakPoints, 0, $count) as $weak) {
                $kpCode = is_object($weak) ? $weak->kp_code : ($weak['kp_code'] ?? '');
                $masteryLevel = is_object($weak) ? $weak->mastery_level : ($weak['mastery_level'] ?? 0);

                $recommendations[] = [
                    'kp_code' => $kpCode,
                    'kp_name' => $this->getKnowledgePointName($kpCode),
                    'current_mastery' => $masteryLevel,
                    'target_mastery' => 0.85,
                    'priority' => 1 - $masteryLevel,
                    'recommended_practice_count' => max(3, intval((0.85 - $masteryLevel) * 10)),
                    'estimated_time_minutes' => max(15, intval((0.85 - $masteryLevel) * 60)),
                ];
            }

            return [
                'recommendations' => $recommendations
            ];
        } catch (\Exception $e) {
            Log::error('Recommend Learning Paths Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            return [
                'recommendations' => []
            ];
        }
    }

    /**
     * 获取知识点名称
     */
    private function getKnowledgePointName(string $kpCode): string
    {
        try {
            $kp = DB::table('knowledge_points')
                ->where('kp_code', $kpCode)
                ->value('name');
            return $kp ?? $kpCode;
        } catch (\Exception $e) {
            return $kpCode;
        }
    }

    /**
     * 重新计算掌握度（本地化）
     */
    public function recalculateMastery(string $studentId, string $kpCode): bool
    {
        try {
            Log::info('LearningAnalyticsService: 重新计算掌握度 (本地)', [
                'student_id' => $studentId,
                'kp_code' => $kpCode,
            ]);

            // 使用MasteryCalculator重新计算
            $result = $this->masteryCalculator->calculateMasteryLevel($studentId, $kpCode);

            // 更新到数据库
            DB::table('student_knowledge_mastery')
                ->updateOrInsert(
                    ['student_id' => $studentId, 'kp_code' => $kpCode],
                    [
                        'mastery_level' => $result['mastery'],
                        'confidence_level' => $result['confidence'],
                        'total_attempts' => $result['total_attempts'],
                        'correct_attempts' => $result['correct_attempts'],
                        'mastery_trend' => $result['trend'],
                        'last_mastery_update' => now(),
                        'updated_at' => now(),
                    ]
                );

            return true;
        } catch (\Exception $e) {
            Log::error('Recalculate Mastery Error', [
                'student_id' => $studentId,
                'kp_code' => $kpCode,
                'error' => $e->getMessage()
            ]);
            return false;
        }
    }

    /**
     * 批量更新技能熟练度（本地化）
     */
    public function batchUpdateSkillProficiency(string $studentId): bool
    {
        try {
            Log::info('LearningAnalyticsService: 批量更新技能熟练度 (本地)', [
                'student_id' => $studentId,
            ]);

            // 获取学生所有知识点
            $kpCodes = DB::table('student_knowledge_mastery')
                ->where('student_id', $studentId)
                ->pluck('kp_code')
                ->toArray();

            // 批量更新
            $this->masteryCalculator->batchUpdateMastery($studentId, $kpCodes);

            return true;
        } catch (\Exception $e) {
            Log::error('Batch Update Skill Proficiency Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            return false;
        }
    }

    /**
     * 清空学生所有答题数据（本地化）
     */
    public function clearStudentData(string $studentId): bool
    {
        try {
            Log::info('LearningAnalyticsService: 清空学生数据 (本地)', [
                'student_id' => $studentId,
            ]);

            // 清空MySQL中的数据
            $this->clearStudentMySQLData($studentId);

            Log::info('Student Data Cleared Successfully', [
                'student_id' => $studentId,
            ]);

            return true;
        } catch (\Exception $e) {
            Log::error('Clear Student Data Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            return false;
        }
    }

    /**
     * 清空学生MySQL中的答题数据
     */
    private function clearStudentMySQLData(string $studentId): void
    {
        try {
            // 清空student_exercises表
            DB::table('student_exercises')
                ->where('student_id', $studentId)
                ->delete();

            // 清空student_mastery表
            DB::table('student_mastery')
                ->where('student_id', $studentId)
                ->delete();

            Log::info('Student MySQL Data Cleared', [
                'student_id' => $studentId
            ]);
        } catch (\Exception $e) {
            Log::error('Clear Student MySQL Data Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);
            throw $e; // 重新抛出异常，让上层处理
        }
    }

    /**
     * 获取学生列表（供智能出卷使用）
     */
    public function getStudentsList(): array
    {
        try {
            $response = Http::timeout($this->timeout)
                ->get($this->baseUrl . '/api/v1/students/list');

            if ($response->successful()) {
                return $response->json('data', []);
            }

            // 如果API失败，尝试从MySQL直接读取
            return $this->getStudentsFromMySQL();
        } catch (\Exception $e) {
            Log::error('Get Students List Error', [
                'error' => $e->getMessage()
            ]);

            // 返回模拟数据
            return [
                ['student_id' => 'stu_001', 'name' => '张三'],
                ['student_id' => 'stu_002', 'name' => '李四'],
                ['student_id' => 'stu_003', 'name' => '王五'],
            ];
        }
    }

    /**
     * 从MySQL获取学生列表
     */
    private function getStudentsFromMySQL(): array
    {
        try {
            return DB::table('students')
                ->select('student_id', 'name')
                ->limit(100)
                ->get()
                ->toArray();
        } catch (\Exception $e) {
            Log::error('Get Students From MySQL Error', [
                'error' => $e->getMessage()
            ]);
            return [];
        }
    }

    /**
     * 获取学生薄弱点列表
     * 策略：MySQL作为权威数据源，LearningAnalytics API仅作为辅助/缓存
     */
    public function getStudentWeaknesses(string $studentId, int $limit = 10): array
    {
        try {
            // 从本地MySQL数据库获取学生薄弱点
            Log::info('从本地MySQL数据库获取学生薄弱点', [
                'student_id' => $studentId,
                'limit' => $limit
            ]);

            $weaknesses = $this->getStudentWeaknessesFromMySQL($studentId, $limit);

            if (!empty($weaknesses)) {
                Log::info('从本地数据库获取到薄弱点数据', [
                    'student_id' => $studentId,
                    'count' => count($weaknesses)
                ]);
                return $weaknesses;
            }

            Log::warning('本地数据库中无该学生薄弱点数据', [
                'student_id' => $studentId
            ]);

            return [];
        } catch (\Exception $e) {
            Log::error('Get Student Weaknesses Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage()
            ]);

            // 发生异常时，返回空数组
            return [];
        }
    }

    /**
     * 从MySQL获取学生薄弱点
     */
    private function getStudentWeaknessesFromMySQL(string $studentId, int $limit = 10): array
    {
        try {
            // 优先从 student_knowledge_mastery 表读取（更完整的掌握度数据）
            $weaknesses = DB::table('student_knowledge_mastery as skm')
                ->where('skm.student_id', $studentId)
                ->where('skm.mastery_level', '<', 0.7) // 掌握度低于70%视为薄弱点
                ->orderBy('skm.mastery_level', 'asc')
                ->limit($limit)
                ->select([
                    'skm.kp_code',
                    'skm.mastery_level',
                    'skm.total_attempts',
                    'skm.correct_attempts',
                    'skm.incorrect_attempts',
                    'skm.confidence_level',
                    'skm.mastery_trend'
                ])
                ->get()
                ->toArray();

            // 如果student_knowledge_mastery表没有数据，尝试从student_mastery表读取
            if (empty($weaknesses)) {
                Log::info('student_knowledge_mastery表无数据，尝试从student_mastery表读取', [
                    'student_id' => $studentId
                ]);

                $weaknesses = DB::table('student_mastery as sm')
                    ->leftJoin('knowledge_points as kp', 'sm.kp', '=', 'kp.kp_code')
                    ->where('sm.student_id', $studentId)
                    ->where('sm.mastery', '<', 0.7) // 掌握度低于70%视为薄弱点
                    ->orderBy('sm.mastery', 'asc')
                    ->limit($limit)
                    ->select([
                        'sm.kp as kp_code',
                        'kp.name as kp_name',
                        'sm.mastery',
                        'sm.attempts',
                        'sm.correct'
                    ])
                    ->get()
                    ->toArray();

                // 转换为统一格式
                return array_map(function ($item) {
                    $mastery = (float) ($item->mastery ?? 0);
                    $attempts = (int) ($item->attempts ?? 0);
                    $correct = (int) ($item->correct ?? 0);

                    return [
                        'kp_code' => $item->kp_code,
                        'kp_name' => $item->kp_name ?? $item->kp_code,
                        'mastery' => $mastery,
                        'stability' => 0.5, // 默认稳定性
                        'weakness_level' => 1.0 - $mastery, // 薄弱程度
                        'practice_count' => $attempts,
                        'success_rate' => $attempts > 0 ? ($correct / $attempts) : 0,
                        'priority' => $mastery < 0.3 ? '高' : ($mastery < 0.5 ? '中' : '低'),
                        'suggested_questions' => max(5, (int)((0.7 - $mastery) * 20)) // 掌握度越低，建议题目越多
                    ];
                }, $weaknesses);
            }

            // 转换student_knowledge_mastery表的数据格式
            return array_map(function ($item) {
                $mastery = (float) ($item->mastery_level ?? 0);
                $totalAttempts = (int) ($item->total_attempts ?? 0);
                $correctAttempts = (int) ($item->correct_attempts ?? 0);
                $incorrectAttempts = (int) ($item->incorrect_attempts ?? 0);
                $confidence = (float) ($item->confidence_level ?? 0.5);
                $trend = $item->mastery_trend ?? 'stable';

                // 计算成功率
                $successRate = $totalAttempts > 0 ? ($correctAttempts / $totalAttempts) : 0;

                // 确定优先级
                $priority = '中';
                if ($mastery < 0.3) {
                    $priority = '高';
                } elseif ($mastery < 0.5) {
                    $priority = '中';
                } else {
                    $priority = '低';
                }

                return [
                    'kp_code' => $item->kp_code,
                    'kp_name' => $item->kp_code, // 如果没有中文名，使用代码作为名称
                    'mastery' => $mastery,
                    'stability' => $confidence,
                    'weakness_level' => 1.0 - $mastery, // 薄弱程度
                    'practice_count' => $totalAttempts,
                    'success_rate' => $successRate,
                    'priority' => $priority,
                    'suggested_questions' => max(5, (int)((0.7 - $mastery) * 20)), // 掌握度越低，建议题目越多
                    'trend' => $trend,
                    'correct_attempts' => $correctAttempts,
                    'incorrect_attempts' => $incorrectAttempts
                ];
            }, $weaknesses);
        } catch (\Exception $e) {
            Log::error('Get Student Weaknesses From MySQL Error', [
                'student_id' => $studentId,
                'error' => $e->getMessage(),
                'trace' => $e->getTraceAsString()
            ]);
            return [];
        }
    }

    /**
     * 智能出卷：根据学生掌握度智能选择题目
     */
    public function generateIntelligentExam(array $params): array
    {
        $startTime = microtime(true);

        try {
            // 应用组卷类型策略
            $assembleType = (int) ($params['assemble_type'] ?? 4); // 默认为通用类型(4)
            $examTypeLegacy = $params['exam_type'] ?? 'general'; // 兼容旧版参数

            Log::info('LearningAnalyticsService: 检查组卷策略', [
                'assemble_type' => $assembleType,
                'exam_type_legacy' => $examTypeLegacy,
                'has_question_expansion_service' => !empty($this->questionExpansionService)
            ]);

            // 如果有 assemble_type 参数，优先使用新的参数系统
            if (isset($params['assemble_type'])) {
                try {
                    // 确保QuestionExpansionService和QuestionLocalService可用
                    $questionExpansionService = $this->questionExpansionService ?? app(QuestionExpansionService::class);
                    $questionLocalService = app(QuestionLocalService::class);
                    Log::info('LearningAnalyticsService: 从容器获取服务实例');

                    $strategy = new ExamTypeStrategy($questionExpansionService, $questionLocalService);
                    $params = $strategy->buildParams($params, $assembleType);

                    Log::info('LearningAnalyticsService: 已应用组卷策略', [
                        'assemble_type' => $assembleType,
                        'enhanced_params_keys' => array_keys($params)
                    ]);
                } catch (Exception $e) {
                    Log::warning('LearningAnalyticsService: 组卷策略应用失败，使用默认策略', [
                        'assemble_type' => $assembleType,
                        'error' => $e->getMessage(),
                        'trace' => $e->getTraceAsString()
                    ]);
                }
            } elseif ($examTypeLegacy !== 'general') {
                // 兼容旧版 exam_type 参数
                try {
                    $questionExpansionService = $this->questionExpansionService ?? app(QuestionExpansionService::class);
                    $questionLocalService = app(QuestionLocalService::class);
                    Log::info('LearningAnalyticsService: 从容器获取服务实例（兼容模式）');

                    $strategy = new ExamTypeStrategy($questionExpansionService, $questionLocalService);
                    $params = $strategy->buildParamsLegacy($params, $examTypeLegacy);

                    Log::info('LearningAnalyticsService: 已应用组卷策略（兼容模式）', [
                        'exam_type' => $examTypeLegacy,
                        'enhanced_params_keys' => array_keys($params)
                    ]);
                } catch (Exception $e) {
                    Log::warning('LearningAnalyticsService: 组卷策略应用失败，使用默认策略', [
                        'exam_type' => $examTypeLegacy,
                        'error' => $e->getMessage(),
                        'trace' => $e->getTraceAsString()
                    ]);
                }
            } else {
                Log::info('LearningAnalyticsService: 跳过组卷策略', [
                    'reason' => '通用类型不需要特殊策略'
                ]);
            }

            $studentId = $params['student_id'] ?? null;
            $grade = $params['grade'] ?? null; // 用户选择的年级
            $totalQuestions = $params['total_questions'] ?? 20;
            $kpCodes = $params['kp_codes'] ?? [];
            $skills = $params['skills'] ?? [];
            $questionTypeRatio = $params['question_type_ratio'] ?? [
                '选择题' => 40,
                '填空题' => 30,
                '解答题' => 30,
            ];
            $difficultyRatio = $params['difficulty_ratio'] ?? [
                '基础' => 50,
                '中等' => 35,
                '拔高' => 15,
            ];
            $difficultyLevels = $params['difficulty_levels'] ?? [];
            // 如果用户没有选择任何难度，difficultyLevels 为空数组，表示随机难度

            Log::info("generateIntelligentExam 开始", [
                'student_id' => $studentId,
                'total_questions' => $totalQuestions,
                'kp_codes' => $kpCodes,
                'skills' => $skills,
                'assemble_type' => $assembleType,
                'exam_type_legacy' => $examTypeLegacy,
            ]);

            // 1. 如果指定了学生，获取学生的薄弱点
            $weaknessFilter = [];
            if ($studentId) {
                Log::info("获取学生薄弱点: $studentId");

                $weaknesses = $this->getStudentWeaknesses($studentId, 20);
                Log::info("薄弱点数量: " . count($weaknesses), [
                    '薄弱点' => $weaknesses,
                ]);

                $weaknessFilter = array_column($weaknesses, 'kp_code');

                // 如果用户没有指定知识点，使用学生的薄弱点
                if (empty($kpCodes)) {
                    $kpCodes = $weaknessFilter;
                    Log::info("用户未选择知识点，使用薄弱点作为kp_codes", [
                        '最终kp_codes' => $kpCodes,
                    ]);
                }
            }

            Log::info("准备调用 getQuestionsFromBank", [
                'kp_codes' => $kpCodes,
                'skills' => $skills,
            ]);

            // 2. 优先使用学生错题（如果存在）
            $mistakeQuestionIds = $params['mistake_question_ids'] ?? [];
            $priorityQuestions = [];

            if (!empty($mistakeQuestionIds)) {
                Log::info('LearningAnalyticsService: 优先获取学生错题', [
                    'mistake_question_ids' => $mistakeQuestionIds,
                    'count' => count($mistakeQuestionIds)
                ]);

                // 获取学生错题的详细信息
                $priorityQuestions = $this->getQuestionsFromBank([], [], $studentId, $questionTypeRatio, $difficultyRatio, 200, $mistakeQuestionIds);

                Log::info('LearningAnalyticsService: 错题获取完成', [
                    'priority_questions_count' => count($priorityQuestions),
                    'expected_count' => count($mistakeQuestionIds)
                ]);

                // 如果获取的错题数量少于预期，记录警告
                if (count($priorityQuestions) < count($mistakeQuestionIds)) {
                    Log::warning('LearningAnalyticsService: 错题获取不完整', [
                        'expected' => count($mistakeQuestionIds),
                        'actual' => count($priorityQuestions),
                        'missing_ids' => array_diff($mistakeQuestionIds, array_column($priorityQuestions, 'id'))
                    ]);
                }
            }

            // 3. 如果错题数量不足，补充其他题目（错题本类型不补充）
            $allQuestions = $priorityQuestions;
            $isMistakeBook = ($assembleType === 5); // 错题本类型不补充题目

            if (!$isMistakeBook && count($priorityQuestions) < $totalQuestions) {
                try {
                    Log::info('开始调用 getQuestionsFromBank 补充题目', [
                        'kp_codes_count' => count($kpCodes),
                        'skills_count' => count($skills),
                        'has_mistake_priority' => !empty($mistakeQuestionIds),
                        'need_more' => $totalQuestions - count($priorityQuestions),
                        'assemble_type' => $assembleType
                    ]);

                    $additionalQuestions = $this->getQuestionsFromBank($kpCodes, $skills, $studentId, $questionTypeRatio, $difficultyRatio, 200);
                    $allQuestions = array_merge($priorityQuestions, $additionalQuestions);

                    Log::info('getQuestionsFromBank 调用完成', [
                        'questions_count' => count($allQuestions),
                        'is_array' => is_array($allQuestions),
                        'first_question_id' => !empty($allQuestions) ? ($allQuestions[0]['id'] ?? 'N/A') : 'N/A',
                        '耗时' => round((microtime(true) - $startTime) * 1000, 2) . 'ms',
                    ]);

                    Log::info('getQuestionsFromBank 返回', [
                        'questions_count' => count($allQuestions),
                        'time_ms' => round((microtime(true) - $startTime) * 1000, 2)
                    ]);
                } catch (\Exception $e) {
                    Log::error('getQuestionsFromBank 调用失败', [
                        'error' => $e->getMessage(),
                        'trace' => $e->getTraceAsString()
                    ]);

                    throw $e;
                }
            } elseif ($isMistakeBook) {
                // 错题本类型：不补充题目，只使用错题
                Log::info('错题本类型：不补充题目，只使用错题', [
                    'assemble_type' => $assembleType,
                    'mistake_questions_count' => count($priorityQuestions),
                    'total_questions_requested' => $totalQuestions
                ]);
            }

            if (empty($allQuestions)) {
                // 如果指定了知识点但题库为空，给出明确提示
                if (!empty($kpCodes)) {
                    $message = '所选知识点 [' . implode(', ', $kpCodes) . '] 在题库中暂无可用题目。您可以：1) 选择其他知识点，2) 点击"生成练习题"按钮先补充题库，或 3) 取消知识点选择让系统随机选题。';
                } else {
                    // 没有选择知识点时，从所有题目中选择
                    // 如果仍然没有题目，说明题库为空，提示补充题库
                    $message = '题库为空，请先添加题目到题库。您可以点击"生成练习题"按钮或手动上传题目。';
                }

                Log::warning('智能出卷失败 - 未找到题目', [
                    'student_id' => $studentId,
                    'selected_kp_codes' => $kpCodes,
                    'kp_codes_count' => count($kpCodes),
                    'message' => $message,
                    'hint' => '如果选择了知识点但题库为空，请检查知识点代码是否正确，或尝试取消知识点选择'
                ]);

                return [
                    'success' => false,
                    'message' => $message,
                    'questions' => []
                ];
            }

            // 3. 根据掌握度对题目进行筛选和排序
            Log::info('开始调用 selectQuestionsByMastery', [
                'input_count' => count($allQuestions),
                'target_count' => $totalQuestions
            ]);

            $startTime = microtime(true);
            $selectedQuestions = $this->selectQuestionsByMastery(
                $allQuestions,
                $studentId,
                $totalQuestions,
                $questionTypeRatio,
                $difficultyRatio,
                $difficultyLevels,
                $weaknessFilter
            );
            $selectTime = (microtime(true) - $startTime) * 1000;

            Log::info('题目筛选结果', [
                'input_count' => count($allQuestions),
                'selected_count' => count($selectedQuestions),
                'target_count' => $totalQuestions,
                'select_time_ms' => round($selectTime, 2)
            ]);

            if (empty($selectedQuestions)) {
                return [
                    'success' => false,
                    'message' => '题目筛选失败',
                    'questions' => []
                ];
            }

            // 如果启用了难度分布且不是排除类型，则应用难度分布
            $difficultyCategory = $params['difficulty_category'] ?? 1;
            $enableDistribution = $params['enable_difficulty_distribution'] ?? false;
            $isExcludedType = ($assembleType === 5); // 只有错题本类型(assembleType=5)不应用难度分布

            if ($enableDistribution && !$isExcludedType) {
                Log::info('LearningAnalyticsService: 应用难度系数分布', [
                    'difficulty_category' => $difficultyCategory,
                    'assemble_type' => $assembleType,
                    'before_count' => count($selectedQuestions)
                ]);

                try {
                    // 使用 ExamTypeStrategy 的独立方法应用难度分布
                    $questionExpansionService = $this->questionExpansionService ?? app(QuestionExpansionService::class);
                    $examStrategy = new ExamTypeStrategy($questionExpansionService);

                    $selectedQuestions = $examStrategy->applyDifficultyDistributionToQuestions(
                        $selectedQuestions,
                        $totalQuestions,
                        $difficultyCategory,
                        $params
                    );

                    Log::info('LearningAnalyticsService: 难度分布应用完成', [
                        'after_count' => count($selectedQuestions)
                    ]);
                } catch (\Exception $e) {
                    Log::warning('LearningAnalyticsService: 难度分布应用失败，继续使用原结果', [
                        'error' => $e->getMessage()
                    ]);
                }
            }

            return [
                'success' => true,
                'message' => '智能出卷成功',
                'questions' => $selectedQuestions,
                'stats' => [
                    'total_selected' => count($selectedQuestions),
                    'source_questions' => count($allQuestions),
                    'weakness_targeted' => $studentId && !empty($weaknessFilter) ? count(array_filter($selectedQuestions, function($q) use ($weaknessFilter) {
                        return in_array($q['kp_code'] ?? '', $weaknessFilter);
                    })) : 0,
                    'difficulty_distribution_applied' => $enableDistribution && !$isExcludedType,
                    'difficulty_category' => $difficultyCategory
                ]
            ];
        } catch (\Exception $e) {
            Log::error('Generate Intelligent Exam Error', [
                'error' => $e->getMessage(),
                'trace' => $e->getTraceAsString()
            ]);

            return [
                'success' => false,
                'message' => '智能出卷异常: ' . $e->getMessage(),
                'questions' => []
            ];
        }
    }

    /**
     * 从本地题库获取题目（错题回顾优先）
     * 支持优先获取指定题目ID的题目
     */
    private function getQuestionsFromBank(array $kpCodes, array $skills, ?string $studentId, array $questionTypeRatio = [], array $difficultyRatio = [], int $totalNeeded = 100, array $priorityQuestionIds = []): array
    {
        $startTime = microtime(true);

        try {
            // 错题回顾：优先获取指定的学生错题
            if (!empty($priorityQuestionIds)) {
                Log::info('getQuestionsFromBank: 优先获取学生错题', [
                    'priority_count' => count($priorityQuestionIds),
                    'priority_ids' => $priorityQuestionIds
                ]);

                $priorityQuestions = $this->getLocalQuestionsByIds($priorityQuestionIds);

                if (!empty($priorityQuestions)) {
                    Log::info('getQuestionsFromBank: 优先错题获取成功', [
                        'count' => count($priorityQuestions)
                    ]);

                    return $priorityQuestions;
                } else {
                    Log::warning('getQuestionsFromBank: 优先错题获取失败');
                }
            }

            // 从本地数据库查询题目
            Log::info('getQuestionsFromBank: 从本地数据库查询题目', [
                'kp_codes' => $kpCodes,
                'skills' => $skills,
                'total_needed' => $totalNeeded,
                'question_type_ratio' => $questionTypeRatio,
                'difficulty_ratio' => $difficultyRatio
            ]);

            $query = \App\Models\Question::query();

            // 按知识点筛选
            if (!empty($kpCodes)) {
                $query->whereIn('kp_code', $kpCodes);
                Log::info('应用知识点筛选', ['kp_codes' => $kpCodes]);
            }

            // 按技能筛选（这里使用 tags 字段模拟技能筛选）
            if (!empty($skills)) {
                $query->where(function ($q) use ($skills) {
                    foreach ($skills as $skill) {
                        $q->orWhere('tags', 'like', "%{$skill}%");
                    }
                });
                Log::info('应用技能筛选', ['skills' => $skills]);
            }

            // 筛选有解题思路的题目
            $query->whereNotNull('solution')
                  ->where('solution', '!=', '')
                  ->where('solution', '!=', '[]');

            // 按难度范围筛选
            if (!empty($difficultyRatio)) {
                $difficultyRanges = $this->buildDifficultyRanges($difficultyRatio);
                $query->where(function ($q) use ($difficultyRanges) {
                    $first = true;
                    foreach ($difficultyRanges as $range) {
                        if ($first) {
                            $q->whereBetween('difficulty', [$range['min'], $range['max']]);
                            $first = false;
                        } else {
                            $q->orWhereBetween('difficulty', [$range['min'], $range['max']]);
                        }
                    }
                });
                Log::info('应用难度筛选', ['difficulty_ranges' => $difficultyRanges]);
            }

            // 限制数量并随机排序
            $query->limit($totalNeeded * 2) // 多取一些用于后续筛选
                  ->inRandomOrder();

            $questions = $query->get();

            Log::info('getQuestionsFromBank: 查询完成', [
                'raw_count' => $questions->count(),
                'time_ms' => round((microtime(true) - $startTime) * 1000, 2)
            ]);

            // 转换为标准格式
            $formattedQuestions = $questions->map(function ($q) {
                return [
                    'id' => $q->id,
                    'question_code' => $q->question_code,
                    'kp_code' => $q->kp_code,
                    'question_type' => $q->question_type,
                    'difficulty' => (float) $q->difficulty,
                    'stem' => $q->stem,
                    'solution' => $q->solution,
                    'metadata' => [
                        'has_solution' => true,
                        'is_choice' => $q->question_type === 'choice',
                        'is_fill' => $q->question_type === 'fill',
                        'is_answer' => $q->question_type === 'answer',
                        'difficulty_label' => $this->getDifficultyLabel($q->difficulty),
                        'question_type_label' => $this->getQuestionTypeLabel($q->question_type)
                    ]
                ];
            })->toArray();

            // 按题型和难度配比筛选
            $selectedQuestions = $this->selectQuestionsByRatio(
                $formattedQuestions,
                $totalNeeded,
                $questionTypeRatio,
                $difficultyRatio
            );

            Log::info('getQuestionsFromBank 完成', [
                'selected_count' => count($selectedQuestions),
                'time_ms' => round((microtime(true) - $startTime) * 1000, 2)
            ]);

            return $selectedQuestions;

        } catch (\Exception $e) {
            Log::error('getQuestionsFromBank 查询失败', [
                'error' => $e->getMessage(),
                'trace' => $e->getTraceAsString()
            ]);

            throw $e;
        }
    }

    /**
     * 从本地数据库获取指定ID的题目
     */
    private function getLocalQuestionsByIds(array $questionIds): array
    {
        try {
            $questions = \App\Models\Question::whereIn('id', $questionIds)
                ->select(['id', 'question_code', 'kp_code', 'question_type', 'difficulty', 'stem'])
                ->get();

            // 转换为数组格式
            $result = $questions->map(function ($q) {
                return [
                    'id' => $q->id,
                    'question_code' => $q->question_code,
                    'kp_code' => $q->kp_code,
                    'question_type' => $q->question_type,
                    'difficulty' => $q->difficulty,
                    'stem' => $q->stem,
                    'metadata' => [
                        'has_solution' => true,
                        'is_choice' => $q->question_type === 'choice',
                        'is_fill' => $q->question_type === 'fill',
                        'is_answer' => $q->question_type === 'answer',
                        'difficulty_label' => $this->getDifficultyLabel($q->difficulty),
                        'question_type_label' => $this->getQuestionTypeLabel($q->question_type)
                    ]
                ];
            })->toArray();

            Log::info('getLocalQuestionsByIds 获取成功', [
                'count' => count($result),
                'question_ids' => $questionIds
            ]);

            return $result;

        } catch (\Exception $e) {
            Log::error('getLocalQuestionsByIds 获取失败', [
                'question_ids' => $questionIds,
                'error' => $e->getMessage()
            ]);

            return [];
        }
    }

    /**
     * 获取难度标签
     */
    private function getDifficultyLabel(float $difficulty): string
    {
        return match (true) {
            $difficulty < 0.4 => '基础',
            $difficulty < 0.7 => '中等',
            default => '拔高'
        };
    }

    /**
     * 获取题型标签
     */
    private function getQuestionTypeLabel(string $questionType): string
    {
        return match ($questionType) {
            'choice' => '选择题',
            'fill' => '填空题',
            'answer' => '解答题',
            default => '未知题型'
        };
    }

    /**
     * 构建难度范围（根据配比）
     */
    private function buildDifficultyRanges(array $difficultyRatio): array
    {
        $ranges = [];

        if (isset($difficultyRatio['基础'])) {
            $ranges[] = ['min' => 0.0, 'max' => 0.4, 'label' => '基础'];
        }
        if (isset($difficultyRatio['中等'])) {
            $ranges[] = ['min' => 0.4, 'max' => 0.7, 'label' => '中等'];
        }
        if (isset($difficultyRatio['拔高'])) {
            $ranges[] = ['min' => 0.7, 'max' => 1.0, 'label' => '拔高'];
        }

        return $ranges;
    }

    /**
     * 根据题型和难度配比选择题目
     */
    private function selectQuestionsByRatio(
        array $questions,
        int $totalNeeded,
        array $questionTypeRatio = [],
        array $difficultyRatio = []
    ): array {
        if (empty($questions)) {
            return [];
        }

        // 如果没有配比要求，直接返回
        if (empty($questionTypeRatio) && empty($difficultyRatio)) {
            return array_slice($questions, 0, $totalNeeded);
        }

        $selected = [];
        $usedIndices = [];

        // 按题型配比选择
        if (!empty($questionTypeRatio)) {
            foreach ($questionTypeRatio as $type => $ratio) {
                $count = (int) round(($ratio / 100) * $totalNeeded);
                if ($count <= 0) continue;

                $typeQuestions = [];
                foreach ($questions as $idx => $q) {
                    if (in_array($idx, $usedIndices)) continue;

                    $qType = $q['question_type'] ?? '';
                    $label = $this->getQuestionTypeLabel($qType);

                    if ($label === $type) {
                        $typeQuestions[] = ['idx' => $idx, 'question' => $q];
                    }
                }

                // 随机选择
                shuffle($typeQuestions);
                $selectedCount = min($count, count($typeQuestions));

                for ($i = 0; $i < $selectedCount; $i++) {
                    $selected[] = $typeQuestions[$i]['question'];
                    $usedIndices[] = $typeQuestions[$i]['idx'];
                }
            }
        }

        // 如果还有空缺，按难度配比补充
        $remaining = $totalNeeded - count($selected);
        if ($remaining > 0 && !empty($difficultyRatio)) {
            $difficultyRanges = $this->buildDifficultyRanges($difficultyRatio);

            foreach ($difficultyRanges as $range) {
                if ($remaining <= 0) break;

                $diffQuestions = [];
                foreach ($questions as $idx => $q) {
                    if (in_array($idx, $usedIndices)) continue;

                    $difficulty = (float) ($q['difficulty'] ?? 0);
                    if ($difficulty >= $range['min'] && $difficulty < $range['max']) {
                        $diffQuestions[] = ['idx' => $idx, 'question' => $q];
                    }
                }

                // 随机选择
                shuffle($diffQuestions);
                $count = min($remaining, count($diffQuestions));

                for ($i = 0; $i < $count; $i++) {
                    $selected[] = $diffQuestions[$i]['question'];
                    $usedIndices[] = $diffQuestions[$i]['idx'];
                    $remaining--;
                }
            }
        }

        // 如果还有空缺，补充剩余题目
        if (count($selected) < $totalNeeded) {
            foreach ($questions as $idx => $q) {
                if (count($selected) >= $totalNeeded) break;
                if (!in_array($idx, $usedIndices)) {
                    $selected[] = $q;
                    $usedIndices[] = $idx;
                }
            }
        }

        return array_slice($selected, 0, $totalNeeded);
    }

    /**
     * 根据学生掌握度筛选题目
     */
    private function selectQuestionsByMastery(
        array $questions,
        ?string $studentId,
        int $totalQuestions,
        array $questionTypeRatio,
        array $difficultyRatio,
        array $difficultyLevels,
        array $weaknessFilter
    ): array {
        Log::info('selectQuestionsByMastery 开始', [
            'question_count' => count($questions),
            'student_id' => $studentId,
            'total_questions' => $totalQuestions
        ]);

        // 如果未选择难度，则不过滤（随机生成所有难度）
        if (empty($difficultyLevels)) {
            Log::info('用户未选择难度，将随机生成所有难度的题目');
            // 不过滤任何题目，保留所有难度
        } else {
            // 按难度筛掉不在选择范围内的题目
            $questions = array_values(array_filter($questions, function ($q) use ($difficultyLevels) {
                $d = $q['difficulty'] ?? null;
                if ($d === null) return true; // 无难度信息则保留
                $level = $this->mapDifficultyLevel((float)$d);
                return in_array($level, $difficultyLevels);
            }));
        }

        Log::info('难度筛选完成', [
            'after_filter_count' => count($questions)
        ]);

        // 1. 按知识点分组
        Log::info('开始按知识点分组', [
            'question_count' => count($questions)
        ]);

        $groupStartTime = microtime(true);
        $questionsByKp = [];
        foreach ($questions as $question) {
            $kpCode = $question['kp_code'] ?? '';
            if (!isset($questionsByKp[$kpCode])) {
                $questionsByKp[$kpCode] = [];
            }
            $questionsByKp[$kpCode][] = $question;
        }
        $groupTime = (microtime(true) - $groupStartTime) * 1000;

        Log::info('按知识点分组完成', [
            'kp_count' => count($questionsByKp),
            'group_time_ms' => round($groupTime, 2)
        ]);

        // 2. 为每个知识点计算权重
        $kpWeights = [];
        $kpCodes = array_keys($questionsByKp);
        Log::info('开始计算知识点权重', [
            'kp_count' => count($kpCodes),
            'student_id' => $studentId
        ]);

        $startTime = microtime(true);
        $allMastery = [];

        if ($studentId) {
            // 批量获取所有知识点的掌握度（一次查询）
            $masteryStart = microtime(true);
            try {
                $masteryRecords = DB::table('student_mastery')
                    ->where('student_id', $studentId)
                    ->whereIn('kp', $kpCodes)
                    ->pluck('mastery', 'kp')
                    ->all();

                Log::debug('批量获取掌握度', [
                    'student_id' => $studentId,
                    'kp_count' => count($kpCodes),
                    'found_count' => count($masteryRecords),
                    'time_ms' => round((microtime(true) - $masteryStart) * 1000, 2)
                ]);

                $allMastery = $masteryRecords;
            } catch (\Exception $e) {
                Log::warning('批量获取掌握度失败，将使用默认值', [
                    'student_id' => $studentId,
                    'error' => $e->getMessage()
                ]);
            }
        }

        foreach ($kpCodes as $kpCode) {
            if ($studentId) {
                $mastery = $allMastery[$kpCode] ?? 0.5; // 默认0.5（中等掌握度）

                // 薄弱点权重更高
                if (in_array($kpCode, $weaknessFilter)) {
                    $kpWeights[$kpCode] = 2.0; // 薄弱点权重翻倍
                } else {
                    // 掌握度越低，权重越高
                    $kpWeights[$kpCode] = 1.0 + (1.0 - $mastery) * 1.5;
                }

                Log::debug('计算知识点权重', [
                    'kp_code' => $kpCode,
                    'mastery' => $mastery,
                    'weight' => $kpWeights[$kpCode]
                ]);
            } else {
                $kpWeights[$kpCode] = 1.0; // 未指定学生时平均分配
            }
        }

        $totalWeightTime = (microtime(true) - $startTime) * 1000;
        Log::info('知识点权重计算完成', [
            'total_kp_count' => count($kpCodes),
            'total_weight_time_ms' => round($totalWeightTime, 2),
            'avg_time_per_kp_ms' => count($kpCodes) > 0 ? round($totalWeightTime / count($kpCodes), 2) : 0
        ]);

        // 3. 按权重分配题目数量
        $totalWeight = array_sum($kpWeights);
        $selectedQuestions = [];

        foreach ($questionsByKp as $kpCode => $kpQuestions) {
            // 计算该知识点应该选择的题目数
            $kpQuestionCount = max(1, round(($totalQuestions * $kpWeights[$kpCode]) / $totalWeight));

            // 打乱题目顺序（避免固定模式）
            shuffle($kpQuestions);

            // 选择题目
            $selectedFromKp = array_slice($kpQuestions, 0, $kpQuestionCount);
            $selectedQuestions = array_merge($selectedQuestions, $selectedFromKp);
        }

        // 4. 如果题目过多，按权重排序后截取
        if (count($selectedQuestions) > $totalQuestions) {
            Log::info('开始按权重排序题目', [
                'before_sort_count' => count($selectedQuestions),
                'target_count' => $totalQuestions
            ]);

            $startTime = microtime(true);
            usort($selectedQuestions, function ($a, $b) use ($kpWeights) {
                $weightA = $kpWeights[$a['kp_code']] ?? 1.0;
                $weightB = $kpWeights[$b['kp_code']] ?? 1.0;
                return $weightB <=> $weightA;
            });
            $sortTime = (microtime(true) - $startTime) * 1000;

            Log::info('权重排序完成', [
                'sort_time_ms' => round($sortTime, 2),
                'after_sort_count' => count($selectedQuestions)
            ]);

            $selectedQuestions = array_slice($selectedQuestions, 0, $totalQuestions);
        }

        Log::info('开始题型配比调整', [
            'input_count' => count($selectedQuestions),
            'target_count' => $totalQuestions
        ]);

        // 5. 按题型和难度进行微调
        return $this->adjustQuestionsByRatio($selectedQuestions, $questionTypeRatio, $difficultyRatio, $totalQuestions);
    }

    /**
     * 获取学生对特定知识点的掌握度
     */
    private function getStudentKpMastery(string $studentId, string $kpCode): float
    {
        try {
            $mastery = DB::table('student_mastery')
                ->where('student_id', $studentId)
                ->where('kp', $kpCode)
                ->value('mastery');

            return $mastery ? (float) $mastery : 0.5; // 默认0.5（中等掌握度）
        } catch (\Exception $e) {
            Log::error('Get Student Kp Mastery Error', [
                'student_id' => $studentId,
                'kp_code' => $kpCode,
                'error' => $e->getMessage()
            ]);
            return 0.5;
        }
    }

    /**
     * 根据题型和难度配比调整题目
     */
    private function adjustQuestionsByRatio(array $questions, array $typeRatio, array $difficultyRatio, int $targetCount): array
    {
        Log::info('开始题型配比调整', [
            'input_questions' => count($questions),
            'target_count' => $targetCount,
            'type_ratio' => $typeRatio
        ]);

        // 缓存题目类型，避免重复计算
        $questionTypeCache = [];

        // 按题型分桶
        $buckets = [
            'choice' => [],
            'fill' => [],
            'answer' => [],
        ];
        foreach ($questions as $q) {
            $qid = $q['id'] ?? $q['question_id'] ?? null;

            if ($qid && isset($questionTypeCache[$qid])) {
                $type = $questionTypeCache[$qid];
            } else {
                $type = $this->determineQuestionType($q);
                if ($qid) {
                    $questionTypeCache[$qid] = $type;
                }
            }

            if (!isset($buckets[$type])) {
                $type = 'answer';
            }
            $buckets[$type][] = $q;
        }

        // 计算目标数（四舍五入，比例>0 则至少 1 道），并校正总数
        $targetCount = min($targetCount, count($questions));
        $targets = $this->computeTypeTargets($targetCount, $typeRatio);

        Log::info('题型配比调整前桶统计', [
            'target_count' => $targetCount,
            'targets' => $targets,
            'bucket_counts' => [
                'choice' => count($buckets['choice']),
                'fill' => count($buckets['fill']),
                'answer' => count($buckets['answer']),
            ],
            'raw_ratio' => $typeRatio,
        ]);

        // 随机打乱桶
        foreach ($buckets as $k => $v) {
            if (!empty($v)) {
                shuffle($v);
                $buckets[$k] = $v;
            }
        }

        $selected = [];
        $selectedIds = [];

        // 按目标数依次取题
        foreach (['choice', 'fill', 'answer'] as $typeKey) {
            $need = $targets[$typeKey] ?? 0;
            if ($need <= 0 || empty($buckets[$typeKey])) {
                continue;
            }
            $take = min($need, count($buckets[$typeKey]));
            $slice = array_slice($buckets[$typeKey], 0, $take);
            foreach ($slice as $q) {
                $id = $q['id'] ?? $q['question_id'] ?? spl_object_id((object)$q);
                if (isset($selectedIds[$id])) {
                    continue;
                }
                $selected[] = $q;
                $selectedIds[$id] = true;
            }
        }

        // 不足则从剩余题中补齐
        if (count($selected) < $targetCount) {
            $remaining = [];
            foreach ($buckets as $v) {
                foreach ($v as $q) {
                    $id = $q['id'] ?? $q['question_id'] ?? spl_object_id((object)$q);
                    if (!isset($selectedIds[$id])) {
                        $remaining[] = $q;
                    }
                }
            }
            shuffle($remaining);
            $needMore = $targetCount - count($selected);
            $selected = array_merge($selected, array_slice($remaining, 0, $needMore));
        }

        // 截断至目标数
        $selected = array_slice($selected, 0, $targetCount);

        // 使用缓存统计题型分布
        $selectedCounts = ['choice' => 0, 'fill' => 0, 'answer' => 0];
        foreach ($selected as $q) {
            $qid = $q['id'] ?? $q['question_id'] ?? null;
            if ($qid && isset($questionTypeCache[$qid])) {
                $type = $questionTypeCache[$qid];
            } else {
                $type = $this->determineQuestionType($q);
            }
            if (isset($selectedCounts[$type])) {
                $selectedCounts[$type]++;
            }
        }

        Log::info('题型配比调整完成', [
            'target_count' => $targetCount,
            'targets' => $targets,
            'selected_counts' => $selectedCounts,
            'final_selected_count' => count($selected)
        ]);

        return $selected;
    }

    private function determineQuestionType(array $q): string
    {
        // 优先根据题目内容判断（而不是数据库字段）
        $stem = $q['stem'] ?? $q['content'] ?? '';
        // 处理 stem 可能是数组的情况
        if (is_array($stem)) {
            $stem = json_encode($stem, JSON_UNESCAPED_UNICODE);
        }
        $tags = $q['tags'] ?? '';
        // 处理 tags 可能是数组的情况
        if (is_array($tags)) {
            $tags = json_encode($tags, JSON_UNESCAPED_UNICODE);
        }
        $skills = $q['skills'] ?? [];

        // 1. 根据题干内容判断 - 选择题特征：必须包含 A. B. C. D. 选项（至少2个）
        if (is_string($stem)) {
            // 选择题特征：必须包含 A. B. C. D. 四个选项（至少2个）
            $hasOptionA = preg_match('/\bA\s*[\.\、\:]/', $stem) || preg_match('/\(A\)/', $stem) || preg_match('/^A[\.\s]/', $stem);
            $hasOptionB = preg_match('/\bB\s*[\.\、\:]/', $stem) || preg_match('/\(B\)/', $stem) || preg_match('/^B[\.\s]/', $stem);
            $hasOptionC = preg_match('/\bC\s*[\.\、\:]/', $stem) || preg_match('/\(C\)/', $stem) || preg_match('/^C[\.\s]/', $stem);
            $hasOptionD = preg_match('/\bD\s*[\.\、\:]/', $stem) || preg_match('/\(D\)/', $stem) || preg_match('/^D[\.\s]/', $stem);
            $hasOptionE = preg_match('/\bE\s*[\.\、\:]/', $stem) || preg_match('/\(E\)/', $stem) || preg_match('/^E[\.\s]/', $stem);

            // 至少有2个选项就认为是选择题（降低阈值）
            $optionCount = ($hasOptionA ? 1 : 0) + ($hasOptionB ? 1 : 0) + ($hasOptionC ? 1 : 0) + ($hasOptionD ? 1 : 0) + ($hasOptionE ? 1 : 0);
            if ($optionCount >= 2) {
                return 'choice';
            }

            // 检查是否有"（ ）"或"( )"括号，这通常是选择题的标志
            if (preg_match('/（\s*）|\(\s*\)/', $stem) && (strpos($stem, 'A.') !== false || strpos($stem, 'B.') !== false || strpos($stem, 'C.') !== false || strpos($stem, 'D.') !== false)) {
                return 'choice';
            }
        }

        // 2. 根据技能点判断
        if (is_array($skills) && !empty($skills)) {
            // 过滤非字符串元素，避免 implode 报错
            $skillsFiltered = array_filter($skills, 'is_string');
            if (!empty($skillsFiltered)) {
                $skillsStr = implode(',', $skillsFiltered);
                if (strpos($skillsStr, '选择题') !== false) return 'choice';
                if (strpos($skillsStr, '填空题') !== false) return 'fill';
                if (strpos($skillsStr, '解答题') !== false) return 'answer';
            }
        }

        // 3. 根据题目已有类型字段判断（作为后备）
        $typeField = $q['question_type'] ?? $q['type'] ?? '';
        if (is_string($typeField)) {
            $t = strtolower($typeField);
            if (in_array($t, ['choice', 'single_choice', 'multiple_choice', '选择题', 'choice', 'single_choice', 'multiple_choice'])) {
                return 'choice';
            }
            if (in_array($t, ['fill', 'blank', 'fill_blank', 'fill_in_the_blank', '填空题'])) {
                return 'fill';
            }
            if (in_array($t, ['answer', 'calculation', 'word_problem', 'proof', '解答题'])) {
                return 'answer';
            }
        }

        // 4. 根据标签判断
        if (is_string($tags)) {
            if (strpos($tags, '选择') !== false || strpos($tags, '选择题') !== false) {
                return 'choice';
            }
            if (strpos($tags, '填空') !== false || strpos($tags, '填空题') !== false) {
                return 'fill';
            }
            if (strpos($tags, '解答') !== false || strpos($tags, '简答') !== false || strpos($tags, '证明') !== false) {
                return 'answer';
            }
        }

        // 5. 根据options字段判断
        if (!empty($q['options']) && is_array($q['options'])) {
            return 'choice';
        }

        // 6. 填空题特征：连续下划线或明显的填空括号
        if (is_string($stem)) {
            // 检查填空题特征：连续下划线
            if (preg_match('/_{3,}/', $stem) || strpos($stem, '____') !== false) {
                return 'fill';
            }
            // 空括号填空
            if (preg_match('/（\s*）/', $stem) || preg_match('/\(\s*\)/', $stem)) {
                return 'fill';
            }
        }

        // 7. 根据题干内容关键词判断
        if (is_string($stem)) {
            // 有证明、解答、计算、求证等关键词的是解答题
            if (preg_match('/(证明|求证|解方程|计算：|求解|推导|说明理由)/', $stem)) {
                return 'answer';
            }
        }

        // 默认是解答题（更安全的默认值）
        return 'answer';
    }

    private function mapDifficultyLevel(float $d): string
    {
        if ($d <= 0.4) {
            return '基础';
        }
        if ($d <= 0.7) {
            return '中等';
        }
        return '拔高';
    }

    private function computeTypeTargets(int $targetCount, array $questionTypeRatio): array
    {
        $map = [
            '选择题' => 'choice',
            '填空题' => 'fill',
            '解答题' => 'answer',
        ];
        $targets = ['choice' => 0, 'fill' => 0, 'answer' => 0];
        foreach ($questionTypeRatio as $label => $ratio) {
            $key = $map[$label] ?? null;
            if (!$key) {
                continue;
            }
            $cnt = (int) round($targetCount * ($ratio / 100));
            if ($ratio > 0 && $cnt < 1) {
                $cnt = 1;
            }
            $targets[$key] = $cnt;
        }
        $sum = array_sum($targets);
        if ($sum === 0) {
            $targets['answer'] = $targetCount;
            return $targets;
        }
        while ($sum > $targetCount) {
            arsort($targets);
            foreach ($targets as $k => $v) {
                if ($v > 1) {
                    $targets[$k]--;
                    $sum--;
                    break;
                }
            }
        }
        if ($sum < $targetCount) {
            $ratioByKey = [
                'choice' => $questionTypeRatio['选择题'] ?? 0,
                'fill' => $questionTypeRatio['填空题'] ?? 0,
                'answer' => $questionTypeRatio['解答题'] ?? 0,
            ];
            while ($sum < $targetCount) {
                arsort($ratioByKey);
                $k = array_key_first($ratioByKey);
                $targets[$k]++;
                $sum++;
            }
        }
        return $targets;
    }

    /**
     * 提交手动评分结果到 LearningAnalytics
     *
     * @param array $data 包含 student_id, paper_id, grades 的数组
     * @return array
     */
    public function submitManualGrading(array $data): array
    {
        try {
            $response = Http::timeout($this->timeout)
                ->post($this->baseUrl . '/api/ocr/analyze', [
                    'student_id' => $data['student_id'],
                    'paper_id' => $data['paper_id'],
                    'answers' => $data['grades'],
                ]);

            if ($response->successful()) {
                Log::info('Manual grading submitted successfully', [
                    'student_id' => $data['student_id'],
                    'paper_id' => $data['paper_id'],
                    'question_count' => count($data['grades'])
                ]);

                return $response->json();
            }

            Log::error('Submit Manual Grading Error', [
                'data' => $data,
                'status' => $response->status(),
                'response' => $response->body()
            ]);

            return [
                'error' => true,
                'message' => 'Failed to submit manual grading'
            ];
        } catch (\Exception $e) {
            Log::error('Submit Manual Grading Exception', [
                'error' => $e->getMessage(),
                'data' => $data
            ]);

            return [
                'error' => true,
                'message' => $e->getMessage()
            ];
        }
    }

    /**
     * 分析学生作答结果
     *
     * @param array $data 包含 paper_id, student_id, answers 等
     * @return array
     */
    public function analyzeStudentAnswers(array $data): array
    {
        Log::warning('analyzeStudentAnswers 已停用：分析项目已下线', [
            'student_id' => $data['student_id'] ?? null,
            'paper_id' => $data['paper_id'] ?? null,
        ]);

        return [
            'success' => false,
            'message' => 'analysis_api_disabled',
        ];
    }
}