Add first edition of AndyTranscribe.

app/Http/Controllers/Controller.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace App\Http\Controllers;
+
+abstract class Controller
+{
+    //
+}

app/Http/Controllers/RecordingController.php

@@ -0,0 +1,95 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\StoreRecordingRequest;
+use App\Models\Recording;
+use App\Services\Mp3MetadataService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\View\View;
+
+class RecordingController extends Controller
+{
+    /**
+     * Display a listing of recordings.
+     */
+    public function index(Request $request): View
+    {
+        $query = Recording::query()->latest();
+
+        if ($search = $request->string('q')->trim()->toString()) {
+            $query->where(function ($builder) use ($search) {
+                $builder->where('title', 'like', "%{$search}%")
+                    ->orWhere('artist', 'like', "%{$search}%")
+                    ->orWhere('album', 'like', "%{$search}%")
+                    ->orWhere('original_filename', 'like', "%{$search}%")
+                    ->orWhere('transcript', 'like', "%{$search}%");
+            });
+        }
+
+        $recordings = $query->paginate(20)->withQueryString();
+
+        return view('recordings.index', compact('recordings', 'search'));
+    }
+
+    /**
+     * Show the upload form.
+     */
+    public function create(): View
+    {
+        return view('recordings.create');
+    }
+
+    /**
+     * Store a newly uploaded recording.
+     */
+    public function store(StoreRecordingRequest $request, Mp3MetadataService $metadata): RedirectResponse
+    {
+        $file = $request->file('audio');
+        $path = $file->store('recordings', 'local');
+        $absolutePath = Storage::disk('local')->path($path);
+        $tags = $metadata->extract($absolutePath);
+
+        $title = $request->string('title')->trim()->toString()
+            ?: ($tags['title'] ?? pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME));
+
+        $recording = Recording::create([
+            'title' => $title,
+            'original_filename' => $file->getClientOriginalName(),
+            'file_path' => $path,
+            'duration_seconds' => $tags['duration_seconds'],
+            'recorded_at' => $tags['recorded_at'],
+            'artist' => $tags['artist'],
+            'album' => $tags['album'],
+            'file_size_bytes' => $file->getSize() ?: 0,
+            'transcription_status' => 'pending',
+        ]);
+
+        return redirect()
+            ->route('recordings.show', $recording)
+            ->with('success', 'Recording uploaded successfully.');
+    }
+
+    /**
+     * Display the specified recording.
+     */
+    public function show(Recording $recording): View
+    {
+        return view('recordings.show', compact('recording'));
+    }
+
+    /**
+     * Remove the specified recording.
+     */
+    public function destroy(Recording $recording): RedirectResponse
+    {
+        $recording->deleteFile();
+        $recording->delete();
+
+        return redirect()
+            ->route('recordings.index')
+            ->with('success', 'Recording deleted.');
+    }
+}

app/Http/Controllers/TranscribeController.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\TranscribeRecordingRequest;
+use App\Jobs\TranscribeRecording;
+use App\Models\Recording;
+use Illuminate\Http\RedirectResponse;
+
+class TranscribeController extends Controller
+{
+    /**
+     * Queue transcription for the recording with the chosen engine.
+     */
+    public function __invoke(TranscribeRecordingRequest $request, Recording $recording): RedirectResponse
+    {
+        if (in_array($recording->transcription_status, ['processing'], true)) {
+            return back()->with('error', 'Transcription is already in progress.');
+        }
+
+        $driver = $request->validated('driver');
+
+        $recording->update([
+            'transcription_driver' => $driver,
+            'ollama_url' => $driver === 'ollama' ? rtrim($request->validated('ollama_url'), '/') : null,
+            'transcription_status' => 'pending',
+            'transcript' => null,
+            'transcribed_at' => null,
+        ]);
+
+        TranscribeRecording::dispatch($recording->fresh());
+
+        return back()->with('success', 'Transcription started. Refresh in a moment to see the result.');
+    }
+}

app/Http/Requests/StoreRecordingRequest.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreRecordingRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'audio' => ['required', 'file', 'mimes:mp3,mpeg', 'max:102400'],
+            'title' => ['nullable', 'string', 'max:255'],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'audio.required' => 'Please choose an MP3 file to upload.',
+            'audio.mimes' => 'Only MP3 files are supported.',
+            'audio.max' => 'The audio file may not be larger than 100 MB.',
+        ];
+    }
+}

app/Http/Requests/TranscribeRecordingRequest.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class TranscribeRecordingRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'driver' => ['required', Rule::in(['cloud', 'local', 'ollama'])],
+            'ollama_url' => [
+                Rule::requiredIf(fn () => $this->input('driver') === 'ollama'),
+                'nullable',
+                'url',
+                'regex:/^https?:\/\//i',
+            ],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'driver.required' => 'Choose a transcription engine.',
+            'ollama_url.required' => 'Enter the URL of the Ollama host (OpenAI-compatible Whisper endpoint).',
+            'ollama_url.url' => 'Enter a valid URL, e.g. http://192.168.1.50:8000',
+            'ollama_url.regex' => 'The host URL must start with http:// or https://',
+        ];
+    }
+}