Add script/TTS step handlers, dashboard, and pipeline UI (#35, #36, #43, #44)

StepHandler abstraction (app/Support/VideoWorkflow/StepHandlers/) plugs into WorkflowEngine without coupling it to how any given step type is actually executed: - ScriptGenerationHandler: builds a prompt from the project's title/ description (or an explicit outline/tone/keywords/target length in step input), generates via an active OpenAI AiProvider, stores the result as a 'script' asset. - TtsVoiceoverHandler: voices step.input.text, or falls back to the project's latest script asset, via an active ElevenLabs AiProvider; voice_id/model_id are configurable per step. No direct "speed" control — ElevenLabs' base TTS endpoint doesn't expose one. RunWorkflowStepJob resolves a step's handler by type and runs it on the queue, matching the existing PublishPostJob pattern (including a stale-dispatch guard: no-op if the step isn't 'in_progress' anymore). UI, under its own /video-projects routes and nav entry — separate from /projects per the earlier decision: - VideoProjects/Index (#43): list projects with status and step progress, create new ones. - VideoProjects/Show (#44): start a project from a WorkflowTemplate or a hardcoded default 8-step pipeline; per-step Run/Approve/Reject/ Retry/Skip actions; auto-queues the next step after any transition when a handler exists for its type (steps with no handler yet just sit in_progress rather than auto-failing); lists project assets. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-06 20:56:01 +03:00
parent 0e315ada04
commit 55fa2ebfda
17 changed files with 1105 additions and 0 deletions
@@ -0,0 +1,87 @@
+<?php
+
+namespace App\Support\VideoWorkflow\StepHandlers;
+
+use App\Models\AiProvider;
+use App\Models\WorkflowStep;
+use App\Support\AiProviders\AiGenerationException;
+use App\Support\AiProviders\AiProviderManager;
+use App\Support\AssetStorage\AssetStorage;
+use App\Support\VideoWorkflow\WorkflowEngine;
+
+/**
+ * Turns a project's title/description (or an explicit outline) into a full
+ * script via an OpenAI-backed AiProvider, with optional tone/SEO-keyword/
+ * length guidance from the step's input.
+ */
+class ScriptGenerationHandler implements StepHandler
+{
+    public function __construct(
+        private readonly AiProviderManager $aiProviders,
+        private readonly AssetStorage $assets,
+    ) {}
+
+    public function type(): string
+    {
+        return 'script_generation';
+    }
+
+    public function handle(WorkflowStep $step, WorkflowEngine $engine): void
+    {
+        $provider = AiProvider::query()->where('provider', 'openai')->where('is_active', true)->first();
+
+        if (! $provider) {
+            $engine->failStep($step, 'No active OpenAI provider configured.');
+
+            return;
+        }
+
+        try {
+            $result = $this->aiProviders->generate($provider, $this->buildPrompt($step));
+        } catch (AiGenerationException $e) {
+            $engine->failStep($step, $e->getMessage());
+
+            return;
+        }
+
+        $asset = $this->assets->store(
+            $step->videoProject,
+            'script',
+            $result->content,
+            'txt',
+            step: $step,
+            mimeType: 'text/plain',
+        );
+
+        $engine->completeStep($step, [
+            'asset_id' => $asset->id,
+            'word_count' => str_word_count($result->content),
+        ]);
+    }
+
+    private function buildPrompt(WorkflowStep $step): string
+    {
+        $input = $step->input ?? [];
+        $project = $step->videoProject;
+
+        $outline = $input['outline'] ?? trim(($project->title ?? '')."\n\n".($project->description ?? ''));
+
+        $prompt = "Write a complete, engaging YouTube video script.\n\nTopic/Outline:\n{$outline}";
+
+        if (! empty($input['tone'])) {
+            $prompt .= "\n\nTone: {$input['tone']}";
+        }
+
+        if (! empty($input['seo_keywords'])) {
+            $prompt .= "\n\nNaturally include these SEO keywords where relevant: ".implode(', ', $input['seo_keywords']);
+        }
+
+        if (! empty($input['target_words'])) {
+            $prompt .= "\n\nTarget length: approximately {$input['target_words']} words.";
+        }
+
+        $prompt .= "\n\nWrite only the script content, no preamble or explanation.";
+
+        return $prompt;
+    }
+}