saqel/backend/app/Controllers/CurriculumController.php

<?php

namespace App\Controllers;

use App\Core\Request;
use App\Core\Response;
use App\Services\CurriculumService;
use App\Services\CurriculumExtractorService;

class CurriculumController
{
    /**
     * Upload and Queue Real Ministry PDF Document for Deep Extraction
     */
    public function uploadPdf(Request $request, Response $response): void
    {
        if (empty($_FILES['pdf_file']) || $_FILES['pdf_file']['error'] !== UPLOAD_ERR_OK) {
            $response->status(400)->json([
                'status'  => 'error',
                'message' => 'يرجى اختيار ملف PDF صالح للمنهاج الوزاري.'
            ]);
            return;
        }

        $file = $_FILES['pdf_file'];
        $origName = $file['name'];
        $tmpPath = $file['tmp_name'];
        $taskId = uniqid('task_');

        // Setup processing directory
        $processingDir = __DIR__ . '/../../storage/curriculum/processing';
        if (!is_dir($processingDir)) {
            mkdir($processingDir, 0777, true);
        }

        $savedPdfPath = $processingDir . '/' . $taskId . '.pdf';
        move_uploaded_file($tmpPath, $savedPdfPath);

        // Initialize Task State
        $taskState = [
            'task_id'   => $taskId,
            'status'    => 'queued',
            'progress'  => 0,
            'message'   => 'تم استلام الملف وجاري تحويله للمعالجة المعمقة...',
            'orig_name' => $origName
        ];
        file_put_contents($processingDir . '/' . $taskId . '.json', json_encode($taskState, JSON_UNESCAPED_UNICODE));

        // Prepare task paths
        $scriptPath = realpath(__DIR__ . '/../../scripts/curriculum_worker.php');
        $logPath = $processingDir . '/' . $taskId . '.log';

        // Send processing response immediately
        $response->json([
            'status'  => 'processing',
            'task_id' => $taskId,
            'message' => 'تم استلام الكتاب، وجاري المعالجة المعمقة بواسطة الذكاء الاصطناعي. يرجى الانتظار...'
        ]);
        
        // Terminate request and flush buffers so the client receives the JSON immediately
        if (function_exists('fastcgi_finish_request')) {
            fastcgi_finish_request();
        } else {
            // Fallback for non-FPM
            ob_end_flush();
            flush();
        }

        // Run worker natively in the same PHP process (in the background from client's perspective)
        try {
            // Capture all output to log file
            ini_set('display_errors', 1);
            error_reporting(E_ALL);
            ob_start();
            
            // CRITICAL: Set $GLOBALS['argv'] so the required worker script can access $argv[1]
            // (In a web request, $argv is empty — we must set it globally before requiring the worker)
            $GLOBALS['argv'] = ['curriculum_worker.php', $taskId];
            $_SERVER['argv'] = $GLOBALS['argv'];
            
            require $scriptPath;
            
            $output = ob_get_clean();
            file_put_contents($logPath, $output, FILE_APPEND);
        } catch (\Exception $e) {
            $err = "[Exception] " . $e->getMessage() . " in " . $e->getFile() . ":" . $e->getLine();
            file_put_contents($logPath, $err . "
", FILE_APPEND);
            
            // Update state file to error
            $stateFile = $processingDir . '/' . $taskId . '.json';
            if (file_exists($stateFile)) {
                $st = json_decode(file_get_contents($stateFile), true);
                $st['status'] = 'error';
                $st['message'] = 'تعطل النظام أثناء التحليل (Crash). يرجى مراجعة سجل الأخطاء.';
                file_put_contents($stateFile, json_encode($st, JSON_UNESCAPED_UNICODE));
            }
        }
        
        // Ensure script stops here so it doesn't return anything else
        exit;
    }

    /**
     * Poll Upload Status
     */
    public function getUploadStatus(Request $request, Response $response): void
    {
        $taskId = $request->getQueryParams()['task_id'] ?? '';
        if (empty($taskId)) {
            $response->status(400)->json(['status' => 'error', 'message' => 'رقم المهمة مفقود']);
            return;
        }

        $processingDir = __DIR__ . '/../../storage/curriculum/processing';
        $stateFile = $processingDir . '/' . $taskId . '.json';
        
        if (!file_exists($stateFile)) {
            $response->status(404)->json(['status' => 'error', 'message' => 'المهمة غير موجودة']);
            return;
        }

        $state = json_decode(file_get_contents($stateFile), true);
        $response->json($state);
    }


    /**
     * Get Upload Log
     */
    public function getUploadLog(Request $request, Response $response): void
    {
        $taskId = $request->getQueryParams()['task_id'] ?? '';
        if (empty($taskId)) {
            $response->status(400)->json(['status' => 'error', 'message' => 'رقم المهمة مفقود']);
            return;
        }

        $processingDir = __DIR__ . '/../../storage/curriculum/processing';
        $logFile = $processingDir . '/' . $taskId . '.log';
        
        if (!file_exists($logFile)) {
            $response->status(404)->json(['status' => 'error', 'message' => 'سجل الأخطاء غير موجود']);
            return;
        }

        $logContent = file_get_contents($logFile);
        $response->json(['status' => 'success', 'log' => $logContent]);
    }

    /**
     * Get Complete Live Tree
     */

    public function getTree(Request $request, Response $response): void
    {
        $response->json([
            'status' => 'success',
            'data'   => CurriculumService::getCurriculumTree()
        ]);
    }

    /**
     * Get Single Lesson Markdown Content
     */
    public function getLessonContent(Request $request, Response $response): void
    {
        $file = $request->getQueryParams()['file'] ?? '';
        if (empty($file)) {
            $response->status(400)->json(['status' => 'error', 'message' => 'مسار الملف مطلوب']);
            return;
        }
        $content = CurriculumService::getLessonMarkdown($file);
        $serverFullPath = realpath(__DIR__ . '/../../storage/curriculum') . '/' . ltrim($file, '/');

        $response->json([
            'status'           => 'success',
            'file'             => $file,
            'server_full_path' => $serverFullPath,
            'content'          => $content
        ]);
    }

    /**
     * Save Lesson Markdown Content
     */
    public function saveLessonContent(Request $request, Response $response): void
    {
        $body = $request->getBody();
        $file = $body['file'] ?? '';
        $content = $body['content'] ?? '';

        if (empty($file) || empty($content)) {
            $response->status(400)->json(['status' => 'error', 'message' => 'بيانات الحفظ غير مكتملة']);
            return;
        }

        CurriculumService::saveLessonMarkdown($file, $content);
        $serverFullPath = realpath(__DIR__ . '/../../storage/curriculum') . '/' . ltrim($file, '/');

        $response->json([
            'status'           => 'success',
            'message'          => 'تم حفظ واعتماد محتوى الدرس في المنهاج بنجاح!',
            'server_full_path' => $serverFullPath
        ]);
    }
}