| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715 |
- <?php
- namespace App\Services;
- use App\Http\Controllers\ExamPdfController;
- use App\Models\Paper;
- use App\Models\PaperQuestion;
- use App\Models\Student;
- use Illuminate\Http\Request;
- use Illuminate\Support\Facades\File;
- use Illuminate\Support\Facades\Log;
- use Illuminate\Support\Facades\Storage;
- use Illuminate\Support\Facades\URL;
- use App\Services\LearningAnalyticsService;
- use App\Services\QuestionBankService;
- use App\Services\QuestionServiceApi;
- use App\Services\PdfStorageService;
- use Symfony\Component\Process\Exception\ProcessSignaledException;
- use Symfony\Component\Process\Exception\ProcessTimedOutException;
- use Symfony\Component\Process\Process;
- class ExamPdfExportService
- {
- private ExamPdfController $controller;
- private LearningAnalyticsService $learningAnalyticsService;
- private QuestionBankService $questionBankService;
- private PdfStorageService $pdfStorageService;
- public function __construct(
- ExamPdfController $controller,
- LearningAnalyticsService $learningAnalyticsService,
- QuestionBankService $questionBankService,
- PdfStorageService $pdfStorageService
- )
- {
- $this->controller = $controller;
- $this->learningAnalyticsService = $learningAnalyticsService;
- $this->questionBankService = $questionBankService;
- $this->pdfStorageService = $pdfStorageService;
- }
- /**
- 生成试卷 PDF(不含答案)
- */
- public function generateExamPdf(string $paperId): ?string
- {
- $url = $this->renderAndStore($paperId, includeAnswer: false, suffix: 'exam');
- // 如果生成成功,将 URL 写入数据库
- if ($url) {
- try {
- $paper = Paper::where('paper_id', $paperId)->first();
- if ($paper) {
- $paper->update(['exam_pdf_url' => $url]);
- Log::info('ExamPdfExportService: 试卷PDF URL已写入数据库', [
- 'paper_id' => $paperId,
- 'url' => $url,
- ]);
- }
- } catch (\Throwable $e) {
- Log::error('ExamPdfExportService: 写入试卷PDF URL失败', [
- 'paper_id' => $paperId,
- 'error' => $e->getMessage(),
- ]);
- }
- }
- return $url;
- }
- /**
- 生成判卷 PDF(含答案与解析)
- */
- public function generateGradingPdf(string $paperId): ?string
- {
- $url = $this->renderAndStore($paperId, includeAnswer: true, suffix: 'grading', useGradingView: true);
- // 如果生成成功,将 URL 写入数据库
- if ($url) {
- try {
- $paper = Paper::where('paper_id', $paperId)->first();
- if ($paper) {
- $paper->update(['grading_pdf_url' => $url]);
- Log::info('ExamPdfExportService: 判卷PDF URL已写入数据库', [
- 'paper_id' => $paperId,
- 'url' => $url,
- ]);
- }
- } catch (\Throwable $e) {
- Log::error('ExamPdfExportService: 写入判卷PDF URL失败', [
- 'paper_id' => $paperId,
- 'error' => $e->getMessage(),
- ]);
- }
- }
- return $url;
- }
- /**
- * 生成学情分析 PDF
- */
- public function generateAnalysisReportPdf(string $paperId, string $studentId, ?string $recordId = null): ?string
- {
- if (function_exists('set_time_limit')) {
- @set_time_limit(240);
- }
- try {
- $payload = $this->buildAnalysisPayload($paperId, $studentId);
- if (!$payload) {
- return null;
- }
- $html = view('exam-analysis.pdf-report', $payload)->render();
- $pdfBinary = $this->buildPdf($html);
- if (!$pdfBinary) {
- return null;
- }
- $version = time();
- $path = "analysis_reports/{$paperId}_{$studentId}_{$version}.pdf";
- $url = $this->pdfStorageService->put($path, $pdfBinary);
- if (!$url) {
- Log::error('ExamPdfExportService: 保存学情 PDF 失败', [
- 'path' => $path,
- ]);
- return null;
- }
- // 根据记录类型将 URL 写入不同表
- try {
- if ($recordId) {
- // OCR 记录:写入 ocr_records 表
- $ocrRecord = \App\Models\OCRRecord::find($recordId);
- if ($ocrRecord) {
- $ocrRecord->update(['analysis_pdf_url' => $url]);
- Log::info('ExamPdfExportService: OCR记录学情分析PDF URL已写入数据库', [
- 'record_id' => $recordId,
- 'paper_id' => $paperId,
- 'student_id' => $studentId,
- 'url' => $url,
- ]);
- }
- } else {
- // 学生记录:写入 students 表
- $student = \App\Models\Student::where('student_id', $studentId)->first();
- if ($student) {
- $student->update(['student_report_pdf_url' => $url]);
- Log::info('ExamPdfExportService: 学生学情报告PDF URL已写入数据库', [
- 'student_id' => $studentId,
- 'paper_id' => $paperId,
- 'url' => $url,
- ]);
- }
- }
- } catch (\Throwable $e) {
- Log::error('ExamPdfExportService: 写入学情分析PDF URL失败', [
- 'paper_id' => $paperId,
- 'student_id' => $studentId,
- 'record_id' => $recordId,
- 'error' => $e->getMessage(),
- ]);
- }
- return $url;
- } catch (\Throwable $e) {
- Log::error('ExamPdfExportService: 生成学情分析 PDF 失败', [
- 'paper_id' => $paperId,
- 'student_id' => $studentId,
- 'record_id' => $recordId,
- 'error' => $e->getMessage(),
- 'exception' => get_class($e),
- 'trace' => $e->getTraceAsString(),
- ]);
- return null;
- }
- }
- private function renderAndStore(
- string $paperId,
- bool $includeAnswer,
- string $suffix,
- bool $useGradingView = false
- ): ?string {
- // 放宽脚本执行时间,避免长耗时渲染被 PHP 全局超时打断
- if (function_exists('set_time_limit')) {
- @set_time_limit(240);
- }
- try {
- $html = $this->renderHtml($paperId, $includeAnswer, $useGradingView);
- if (!$html) {
- Log::error('ExamPdfExportService: 渲染 HTML 为空', [
- 'paper_id' => $paperId,
- 'include_answer' => $includeAnswer,
- 'use_grading_view' => $useGradingView,
- ]);
- return null;
- }
- $pdfBinary = $this->buildPdf($html);
- if (!$pdfBinary) {
- return null;
- }
- $path = "exams/{$paperId}_{$suffix}.pdf";
- $url = $this->pdfStorageService->put($path, $pdfBinary);
- if (!$url) {
- Log::error('ExamPdfExportService: 保存 PDF 失败', [
- 'path' => $path,
- ]);
- return null;
- }
- return $url;
- } catch (\Throwable $e) {
- Log::error('ExamPdfExportService: 生成 PDF 失败', [
- 'paper_id' => $paperId,
- 'suffix' => $suffix,
- 'error' => $e->getMessage(),
- 'exception' => get_class($e),
- 'trace' => $e->getTraceAsString(),
- ]);
- return null;
- }
- }
- private function renderHtml(string $paperId, bool $includeAnswer, bool $useGradingView): ?string
- {
- // 复用已有控制器的渲染逻辑,保证版式一致
- $request = Request::create(
- '/admin/intelligent-exam/' . ($useGradingView ? 'grading' : 'pdf') . '/' . $paperId,
- 'GET',
- ['answer' => $includeAnswer ? 'true' : 'false']
- );
- $view = $useGradingView
- ? $this->controller->showGrading($request, $paperId)
- : $this->controller->show($request, $paperId);
- if (is_object($view) && method_exists($view, 'render')) {
- return $this->ensureUtf8Html($view->render());
- }
- return null;
- }
- private function buildPdf(string $html): ?string
- {
- $tmpHtml = tempnam(sys_get_temp_dir(), 'exam_html_') . '.html';
- $utf8Html = $this->ensureUtf8Html($html);
- file_put_contents($tmpHtml, $utf8Html);
- // 仅使用 Chrome 渲染,去掉 wkhtmltopdf 兜底以暴露真实问题
- $chromePdf = $this->renderWithChrome($tmpHtml);
- @unlink($tmpHtml);
- return $chromePdf;
- }
- private function renderWithChrome(string $htmlPath): ?string
- {
- $tmpPdf = tempnam(sys_get_temp_dir(), 'exam_pdf_') . '.pdf';
- // 每次使用唯一的临时用户目录,彻底避免钥匙串问题
- $userDataDir = sys_get_temp_dir() . '/chrome-profile-' . uniqid();
- $chromeBinary = env('PDF_CHROME_BINARY');
- if (!$chromeBinary) {
- $candidates = [
- '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
- '/usr/bin/google-chrome-stable',
- '/usr/bin/google-chrome',
- '/usr/bin/chromium-browser',
- '/usr/bin/chromium',
- ];
- foreach ($candidates as $path) {
- if (is_file($path) && is_executable($path)) {
- $chromeBinary = $path;
- break;
- }
- }
- }
- if (!$chromeBinary) {
- Log::error('ExamPdfExportService: 未找到可用的 Chrome/Chromium,已停止导出', [
- 'html_path' => $htmlPath,
- 'path_env' => env('PATH'),
- 'candidates_checked' => $candidates ?? [],
- ]);
- return null;
- }
- // 为无权限环境设置可写的 HOME/XDG 目录,避免创建 /var/www/.local 报错
- $runtimeHome = sys_get_temp_dir() . '/chrome-home';
- $runtimeXdg = sys_get_temp_dir() . '/chrome-xdg';
- if (!File::exists($runtimeHome)) {
- @File::makeDirectory($runtimeHome, 0755, true);
- }
- if (!File::exists($runtimeXdg)) {
- @File::makeDirectory($runtimeXdg, 0755, true);
- }
- $process = new Process([
- $chromeBinary,
- '--headless',
- '--disable-gpu',
- '--no-sandbox',
- '--disable-setuid-sandbox',
- '--disable-dev-shm-usage',
- '--no-zygote',
- '--disable-features=VizDisplayCompositor',
- '--disable-software-rasterizer',
- '--disable-extensions',
- '--disable-background-networking',
- '--disable-component-update',
- '--disable-client-side-phishing-detection',
- '--disable-default-apps',
- '--disable-domain-reliability',
- '--disable-sync',
- '--safebrowsing-disable-auto-update',
- '--no-first-run',
- '--no-default-browser-check',
- '--disable-crash-reporter',
- '--disable-print-preview',
- '--disable-features=PrintHeaderFooter',
- '--disable-features=TranslateUI',
- '--disable-features=OptimizationHints',
- '--disable-ipc-flooding-protection',
- '--disable-background-networking',
- '--disable-background-timer-throttling',
- '--disable-backgrounding-occluded-windows',
- '--disable-renderer-backgrounding',
- '--disable-features=AudioServiceOutOfProcess',
- '--user-data-dir=' . $userDataDir,
- '--print-to-pdf=' . $tmpPdf,
- '--print-to-pdf-no-header',
- '--allow-file-access-from-files',
- 'file://' . $htmlPath,
- ], null, [
- 'HOME' => $runtimeHome,
- 'XDG_RUNTIME_DIR' => $runtimeXdg,
- ]);
- $process->setTimeout(60);
- $killSignal = \defined('SIGKILL') ? \SIGKILL : 9;
- try {
- $startedAt = microtime(true);
- Log::info('ExamPdfExportService: Chrome 渲染启动', [
- 'cmd' => $process->getCommandLine(),
- 'html_path' => $htmlPath,
- 'tmp_pdf' => $tmpPdf,
- 'user_data_dir' => $userDataDir,
- 'html_exists' => file_exists($htmlPath),
- 'html_size' => file_exists($htmlPath) ? filesize($htmlPath) : null,
- 'cwd' => $process->getWorkingDirectory(),
- ]);
- $process->start();
- $pdfGenerated = false;
- // 轮询检测 PDF 是否生成,尽快返回,避免等待 Chrome 完整退出
- $pollStart = microtime(true);
- $maxPollSeconds = 30;
- while ($process->isRunning() && (microtime(true) - $pollStart) < $maxPollSeconds) {
- if (file_exists($tmpPdf) && filesize($tmpPdf) > 0) {
- $pdfGenerated = true;
- Log::info('ExamPdfExportService: 发现 PDF 已生成,提前结束 Chrome', [
- 'duration_sec' => round(microtime(true) - $startedAt, 3),
- 'tmp_pdf_size' => filesize($tmpPdf),
- ]);
- $process->stop(5, $killSignal);
- break;
- }
- usleep(200_000); // 200ms
- }
- // 如果仍在运行且超过轮询窗口,则强制结束
- if ($process->isRunning()) {
- Log::warning('ExamPdfExportService: Chrome 轮询超时,强制结束', [
- 'duration_sec' => round(microtime(true) - $startedAt, 3),
- ]);
- $process->stop(5, $killSignal);
- }
- $process->wait();
- Log::info('ExamPdfExportService: Chrome 渲染完成', [
- 'duration_sec' => round(microtime(true) - $startedAt, 3),
- 'exit_code' => $process->getExitCode(),
- 'tmp_pdf_exists' => file_exists($tmpPdf),
- 'tmp_pdf_size' => file_exists($tmpPdf) ? filesize($tmpPdf) : null,
- 'stderr' => $process->getErrorOutput(),
- 'stdout' => $process->getOutput(),
- 'pdf_generated_during_poll' => $pdfGenerated,
- ]);
- } catch (ProcessTimedOutException|ProcessSignaledException $e) {
- Log::error('ExamPdfExportService: Chrome 进程异常', [
- 'cmd' => $process->getCommandLine(),
- 'signal' => method_exists($process, 'getTermSignal') ? $process->getTermSignal() : null,
- 'error' => $process->getErrorOutput(),
- 'output' => $process->getOutput(),
- 'exit_code' => $process->getExitCode(),
- 'exception' => $e->getMessage(),
- 'trace' => $e->getTraceAsString(),
- ]);
- if ($process->isRunning()) {
- $process->stop(5, $killSignal);
- }
- $pdfExists = file_exists($tmpPdf);
- $pdfSize = $pdfExists ? filesize($tmpPdf) : null;
- if ($pdfExists && $pdfSize > 0) {
- Log::warning('ExamPdfExportService: Chrome 异常但产生了 PDF,尝试继续返回', [
- 'tmp_pdf_exists' => $pdfExists,
- 'tmp_pdf_size' => $pdfSize,
- 'duration_sec' => isset($startedAt) ? round(microtime(true) - $startedAt, 3) : null,
- ]);
- $pdfBinary = file_get_contents($tmpPdf);
- @unlink($tmpPdf);
- File::deleteDirectory($userDataDir);
- return $pdfBinary ?: null;
- }
- @unlink($tmpPdf);
- File::deleteDirectory($userDataDir);
- return null;
- } catch (\Throwable $e) {
- Log::error('ExamPdfExportService: Chrome 调用异常', [
- 'cmd' => $process->getCommandLine(),
- 'error' => $e->getMessage(),
- 'exit_code' => $process->getExitCode(),
- 'stderr' => $process->getErrorOutput(),
- 'stdout' => $process->getOutput(),
- 'trace' => $e->getTraceAsString(),
- ]);
- if ($process->isRunning()) {
- $process->stop(5, $killSignal);
- }
- $pdfExists = file_exists($tmpPdf);
- $pdfSize = $pdfExists ? filesize($tmpPdf) : null;
- if ($pdfExists && $pdfSize > 0) {
- Log::warning('ExamPdfExportService: Chrome 调用异常但产生了 PDF,尝试继续返回', [
- 'tmp_pdf_exists' => $pdfExists,
- 'tmp_pdf_size' => $pdfSize,
- 'duration_sec' => isset($startedAt) ? round(microtime(true) - $startedAt, 3) : null,
- ]);
- $pdfBinary = file_get_contents($tmpPdf);
- @unlink($tmpPdf);
- File::deleteDirectory($userDataDir);
- return $pdfBinary ?: null;
- }
- @unlink($tmpPdf);
- File::deleteDirectory($userDataDir);
- return null;
- }
- $pdfExists = file_exists($tmpPdf);
- $pdfSize = $pdfExists ? filesize($tmpPdf) : null;
- if (!$process->isSuccessful()) {
- if ($pdfExists && $pdfSize > 0) {
- Log::warning('ExamPdfExportService: Chrome 进程异常但生成了 PDF,继续使用', [
- 'cmd' => implode(' ', (array) $process->getCommandLine()),
- 'exit_code' => $process->getExitCode(),
- 'error' => $process->getErrorOutput(),
- 'output' => $process->getOutput(),
- 'tmp_pdf_exists' => $pdfExists,
- 'tmp_pdf_size' => $pdfSize,
- 'html_path' => $htmlPath,
- 'user_data_dir' => $userDataDir,
- ]);
- } else {
- Log::error('ExamPdfExportService: Chrome 渲染失败', [
- 'cmd' => implode(' ', (array) $process->getCommandLine()),
- 'exit_code' => $process->getExitCode(),
- 'error' => $process->getErrorOutput(),
- 'output' => $process->getOutput(),
- 'tmp_pdf_exists' => $pdfExists,
- 'tmp_pdf_size' => $pdfSize,
- 'html_path' => $htmlPath,
- 'user_data_dir' => $userDataDir,
- ]);
- @unlink($tmpPdf);
- File::deleteDirectory($userDataDir);
- return null;
- }
- }
- $pdfBinary = $pdfExists ? file_get_contents($tmpPdf) : null;
- @unlink($tmpPdf);
- File::deleteDirectory($userDataDir);
- return $pdfBinary ?: null;
- }
- private function buildAnalysisPayload(string $paperId, string $studentId): ?array
- {
- $paper = Paper::with(['questions' => function ($query) {
- $query->orderBy('question_number')->orderBy('id');
- }])->find($paperId);
- if (!$paper) {
- Log::error('ExamPdfExportService: 未找到试卷,无法生成学情报告', [
- 'paper_id' => $paperId,
- 'student_id' => $studentId,
- ]);
- return null;
- }
- $student = Student::find($studentId);
- $studentInfo = [
- 'id' => $student?->student_id ?? $studentId,
- 'name' => $student?->name ?? $studentId,
- 'grade' => $student?->grade ?? '未知年级',
- 'class' => $student?->class_name ?? '未知班级',
- ];
- // 调用学习分析服务获取本卷分析与掌握度
- $analysisData = [];
- if (!empty($paper->analysis_id)) {
- $analysis = $this->learningAnalyticsService->getAnalysisResult($paper->analysis_id);
- if (!empty($analysis['data'])) {
- $analysisData = $analysis['data'];
- }
- }
- $masteryData = [];
- $masteryResponse = $this->learningAnalyticsService->getStudentMastery($studentId);
- if (!empty($masteryResponse['data'])) {
- $masteryData = $masteryResponse['data'];
- }
- $recommendations = [];
- $recommendationResponse = $this->learningAnalyticsService->getLearningRecommendations($studentId);
- if (!empty($recommendationResponse['data'])) {
- $recommendations = $recommendationResponse['data'];
- }
- $kpNameMap = $this->buildKnowledgePointNameMap();
- // 预取题库详情用于解析/解题思路
- $questionDetails = [];
- $questionIds = $paper->questions->pluck('question_id')->filter()->unique()->values();
- foreach ($questionIds as $qid) {
- try {
- $detail = $this->questionBankService->getQuestion((string) $qid);
- if (!empty($detail)) {
- $questionDetails[(string) $qid] = $detail;
- }
- } catch (\Throwable $e) {
- Log::warning('ExamPdfExportService: 获取题库题目详情失败', [
- 'question_id' => $qid,
- 'error' => $e->getMessage(),
- ]);
- }
- }
- // 分组保持卷面顺序:选择题 -> 填空题 -> 解答题
- $grouped = [
- 'choice' => [],
- 'fill' => [],
- 'answer' => [],
- ];
- $sortedQuestions = $paper->questions
- ->sortBy(function (PaperQuestion $q, int $idx) {
- $number = $q->question_number ?? $idx + 1;
- return is_numeric($number) ? (float) $number : ($q->id ?? $idx);
- });
- foreach ($sortedQuestions as $idx => $question) {
- $kpCode = $question->knowledge_point ?? '';
- $kpName = $kpNameMap[$kpCode] ?? $kpCode ?: '未标注';
- $detail = $questionDetails[(string) ($question->question_id ?? '')] ?? [];
- $solution = $detail['solution'] ?? $detail['解析'] ?? $detail['analysis'] ?? null;
- // 题型优先使用试卷记录,其次题库详情
- $typeRaw = $question->question_type ?? ($detail['question_type'] ?? $detail['type'] ?? '');
- $normalizedType = $this->normalizeQuestionType($typeRaw);
- $number = $question->question_number ?? ($idx + 1);
- $payload = [
- 'question_number' => $number,
- 'question_text' => is_array($question->question_text) ? json_encode($question->question_text, JSON_UNESCAPED_UNICODE) : ($question->question_text ?? ''),
- 'question_type' => $normalizedType,
- 'knowledge_point' => $kpCode,
- 'knowledge_point_name' => $kpName,
- 'score' => $question->score,
- 'solution' => $solution,
- ];
- $grouped[$normalizedType][] = $payload;
- }
- $ordered = array_merge($grouped['choice'], $grouped['fill'], $grouped['answer']);
- // 按卷面顺序重新编号以匹配判卷/显示
- foreach ($ordered as $i => &$q) {
- $q['display_number'] = $i + 1;
- }
- unset($q);
- $questions = $ordered;
- $questionInsights = $analysisData['question_results'] ?? [];
- $masterySummary = $this->buildMasterySummary($masteryData, $kpNameMap);
- return [
- 'paper' => [
- 'id' => $paper->paper_id,
- 'name' => $paper->paper_name,
- 'total_questions' => $paper->question_count,
- 'total_score' => $paper->total_score,
- 'created_at' => $paper->created_at,
- ],
- 'student' => $studentInfo,
- 'questions' => $questions,
- 'mastery' => $masterySummary,
- 'question_insights' => $questionInsights,
- 'recommendations' => $recommendations,
- 'analysis_data' => $analysisData,
- ];
- }
- private function buildKnowledgePointNameMap(): array
- {
- try {
- // 优先使用 QuestionServiceApi(已有知识点名称缓存)
- if (class_exists(QuestionServiceApi::class)) {
- /** @var QuestionServiceApi $service */
- $service = app(QuestionServiceApi::class);
- $options = $service->getKnowledgePointOptions();
- if (!empty($options)) {
- return $options;
- }
- }
- // 退回 QuestionBankService(可能缺少此方法)
- if (method_exists($this->questionBankService, 'getKnowledgePointOptions')) {
- $options = $this->questionBankService->getKnowledgePointOptions();
- $map = [];
- foreach ($options as $item) {
- if (is_array($item)) {
- $code = $item['kp_code'] ?? null;
- $name = $item['kp_name'] ?? $item['name'] ?? null;
- if ($code && $name) {
- $map[$code] = $name;
- }
- }
- }
- if (!empty($map)) {
- return $map;
- }
- }
- } catch (\Throwable $e) {
- Log::warning('ExamPdfExportService: 获取知识点名称失败,退回使用编码', [
- 'error' => $e->getMessage(),
- ]);
- }
- return [];
- }
- private function buildMasterySummary(array $masteryData, array $kpNameMap): array
- {
- $items = [];
- $total = 0;
- $count = 0;
- $hasMap = !empty($kpNameMap);
- foreach ($masteryData as $row) {
- $code = $row['kp_code'] ?? null;
- if ($hasMap && $code && !isset($kpNameMap[$code])) {
- // 不在知识图谱中的知识点不呈现
- continue;
- }
- $name = $row['kp_name'] ?? ($code ? ($kpNameMap[$code] ?? $code) : '未知知识点');
- $level = (float) ($row['mastery_level'] ?? 0);
- $delta = $row['mastery_change'] ?? null;
- $items[] = [
- 'kp_code' => $code,
- 'kp_name' => $name,
- 'mastery_level' => $level,
- 'mastery_change' => $delta,
- ];
- $total += $level;
- $count++;
- }
- $average = $count > 0 ? round($total / $count, 2) : null;
- // 按掌握度从低到高排序,便于突出薄弱点
- usort($items, fn($a, $b) => ($a['mastery_level'] <=> $b['mastery_level']));
- return [
- 'items' => $items,
- 'average' => $average,
- 'weak_list' => array_slice($items, 0, 5),
- ];
- }
- private function normalizeQuestionType(?string $type): string
- {
- $t = strtolower(trim((string) $type));
- return match (true) {
- str_contains($t, 'choice') || str_contains($t, '选择') => 'choice',
- str_contains($t, 'fill') || str_contains($t, 'blank') || str_contains($t, '填空') => 'fill',
- default => 'answer',
- };
- }
- private function ensureUtf8Html(string $html): string
- {
- $meta = '<meta charset="UTF-8">';
- if (stripos($html, '<head>') !== false) {
- return preg_replace('/<head>/i', "<head>{$meta}", $html, 1);
- }
- return $meta . $html;
- }
- }
|