Restore artisan script

.gitignore

@@ -4,6 +4,7 @@
 .env
 .env.backup
 .env.production
+.env.test
 .env.*.local
 .phpactor.json
 .phpunit.result.cache
@@ -26,6 +27,7 @@
 /storage/*.key
 /storage/pail
 /storage/framework/views/*.php
+/bootstrap/cache/*.php
 /vendor
 Homestead.json
 Homestead.yaml

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 2026-02-08
+- Achieved 100% test coverage across the backend.
+- Added comprehensive Feature and Unit tests for controllers, models, services, and console commands.
+- Added extensive edge-case and error-path coverage (system update/status, versioning, attachments, forums, roles, ranks, settings, portal, etc.).
+
 ## 2026-01-12
 - Switched main SPA layouts to fluid containers to reduce wasted space.
 - Added username-or-email login with case-insensitive unique usernames.

NOTES.md

@@ -0,0 +1,7 @@
+TODO: Remove remaining IIFEs in ACP UI; prefer plain components/helpers.
+
+Progress (last 2 days):
+- Reached 100% test coverage across the codebase.
+- Added extensive Feature and Unit tests for controllers, models, services, and console commands.
+- Added coverage scripts and cleanup (tests for update/version flows, system update/status, attachments, forums, roles, ranks, settings, portal, etc.).
+- Hardened tests with fakes/mocks to cover error paths and edge cases.

app/Actions/BbcodeFormatter.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Actions;
+
+use s9e\TextFormatter\Configurator;
+use s9e\TextFormatter\Parser;
+use s9e\TextFormatter\Renderer;
+
+class BbcodeFormatter
+{
+    private static ?Parser $parser = null;
+    private static ?Renderer $renderer = null;
+
+    public static function format(?string $text): string
+    {
+        if ($text === null || $text === '') {
+            return '';
+        }
+
+        if (!self::$parser || !self::$renderer) {
+            [$parser, $renderer] = self::build();
+            self::$parser = $parser;
+            self::$renderer = $renderer;
+        }
+
+        $xml = self::$parser->parse($text);
+
+        return self::$renderer->render($xml);
+    }
+
+    private static function build(): array
+    {
+        $configurator = new Configurator();
+        $bbcodes = $configurator->plugins->load('BBCodes');
+        $bbcodes->addFromRepository('B');
+        $bbcodes->addFromRepository('I');
+        $bbcodes->addFromRepository('U');
+        $bbcodes->addFromRepository('S');
+        $bbcodes->addFromRepository('URL');
+        $bbcodes->addFromRepository('IMG');
+        $bbcodes->addFromRepository('QUOTE');
+        $bbcodes->addFromRepository('CODE');
+        $bbcodes->addFromRepository('LIST');
+        $bbcodes->addFromRepository('*');
+
+        $configurator->tags->add('BR')->template = '<br/>';
+
+        if (isset($configurator->tags['QUOTE'])) {
+            $configurator->tags['QUOTE']->template = <<<'XSL'
+<blockquote>
+  <xsl:if test="@author">
+    <cite><xsl:value-of select="@author"/> wrote:</cite>
+  </xsl:if>
+  <div><xsl:apply-templates/></div>
+</blockquote>
+XSL;
+        }
+
+        $bundle = $configurator->finalize();
+        $parser = $bundle['parser'] ?? null;
+        $renderer = $bundle['renderer'] ?? null;
+
+        if (!$parser || !$renderer) {
+            throw new \RuntimeException('Unable to initialize BBCode formatter.');
+        }
+
+        return [$parser, $renderer];
+    }
+}

app/Console/Commands/CronRun.php

@@ -0,0 +1,93 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\Attachment;
+use App\Services\AttachmentThumbnailService;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Storage;
+
+class CronRun extends Command
+{
+    protected $signature = 'speedbb:cron {--force : Recreate thumbnails even if already present} {--dry-run : Report without writing}';
+
+    protected $description = 'Run periodic maintenance tasks (currently: attachment thumbnail recreation).';
+
+    public function handle(AttachmentThumbnailService $thumbnailService): int
+    {
+        $force = (bool) $this->option('force');
+        $dryRun = (bool) $this->option('dry-run');
+
+        $stats = [
+            'checked' => 0,
+            'created' => 0,
+            'skipped' => 0,
+            'missing' => 0,
+            'non_image' => 0,
+        ];
+
+        $this->info('Processing attachment thumbnails...');
+
+        Attachment::query()
+            ->orderBy('id')
+            ->chunkById(200, function ($attachments) use ($thumbnailService, $force, $dryRun, &$stats) {
+                foreach ($attachments as $attachment) {
+                    $stats['checked']++;
+
+                    $mime = $attachment->mime_type ?? '';
+                    if (!str_starts_with($mime, 'image/')) {
+                        $stats['non_image']++;
+                        continue;
+                    }
+
+                    $disk = Storage::disk($attachment->disk);
+                    if (!$disk->exists($attachment->path)) {
+                        $stats['missing']++;
+                        continue;
+                    }
+
+                    $needsThumbnail = $force
+                        || !$attachment->thumbnail_path
+                        || !$disk->exists($attachment->thumbnail_path);
+
+                    if (!$needsThumbnail) {
+                        $stats['skipped']++;
+                        continue;
+                    }
+
+                    if ($dryRun) {
+                        $stats['created']++;
+                        continue;
+                    }
+
+                    if ($force && $attachment->thumbnail_path && $disk->exists($attachment->thumbnail_path)) {
+                        $disk->delete($attachment->thumbnail_path);
+                    }
+
+                    $payload = $thumbnailService->createForAttachment($attachment, $force);
+                    if (!$payload) {
+                        $stats['skipped']++;
+                        continue;
+                    }
+
+                    $attachment->thumbnail_path = $payload['path'] ?? null;
+                    $attachment->thumbnail_mime_type = $payload['mime'] ?? null;
+                    $attachment->thumbnail_size_bytes = $payload['size'] ?? null;
+                    $attachment->save();
+
+                    $stats['created']++;
+                }
+            });
+
+        $this->info(sprintf(
+            'Checked: %d | Created: %d | Skipped: %d | Missing: %d | Non-image: %d',
+            $stats['checked'],
+            $stats['created'],
+            $stats['skipped'],
+            $stats['missing'],
+            $stats['non_image']
+        ));
+
+        return self::SUCCESS;
+    }
+}

app/Console/Commands/VersionBump.php

@@ -0,0 +1,89 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\Setting;
+use Illuminate\Console\Command;
+
+class VersionBump extends Command
+{
+    protected $signature = 'version:bump';
+
+    protected $description = 'Bump the patch version (e.g. 26.0.1 -> 26.0.2).';
+
+    public function handle(): int
+    {
+        $current = Setting::query()->where('key', 'version')->value('value');
+        if (!$current) {
+            $this->error('Unable to determine current version from settings.');
+            return self::FAILURE;
+        }
+
+        $next = $this->bumpPatch($current);
+        if ($next === null) {
+            $this->error('Version format must be X.Y.Z (optionally with suffix).');
+            return self::FAILURE;
+        }
+
+        Setting::updateOrCreate(['key' => 'version'], ['value' => $next]);
+
+        if (!$this->syncComposerVersion($next)) {
+            $this->error('Failed to sync version to composer.json.');
+            return self::FAILURE;
+        }
+
+        $this->info("Version bumped: {$current} -> {$next}");
+
+        return self::SUCCESS;
+    }
+
+    private function bumpPatch(string $version): ?string
+    {
+        if (!preg_match('/^(\d+)\.(\d+)\.(\d+)(.*)?$/', $version, $matches)) {
+            return null;
+        }
+
+        $major = $matches[1];
+        $minor = $matches[2];
+        $patch = $matches[3];
+        $suffix = $matches[4] ?? '';
+
+        $patchWidth = strlen($patch);
+        $nextPatch = (string) ((int) $patch + 1);
+        if ($patchWidth > 1) {
+            $nextPatch = str_pad($nextPatch, $patchWidth, '0', STR_PAD_LEFT);
+        }
+
+        return "{$major}.{$minor}.{$nextPatch}{$suffix}";
+    }
+
+    private function syncComposerVersion(string $version): bool
+    {
+        $composerPath = base_path('composer.json');
+
+        if (!is_file($composerPath) || !is_readable($composerPath)) {
+            return false;
+        }
+
+        $raw = file_get_contents($composerPath);
+        if ($raw === false) {
+            return false;
+        }
+
+        $data = json_decode($raw, true);
+        if (!is_array($data)) {
+            return false;
+        }
+
+        $data['version'] = $version;
+
+        $encoded = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+        if ($encoded === false) {
+            return false;
+        }
+
+        $encoded .= "\n";
+
+        return file_put_contents($composerPath, $encoded) !== false;
+    }
+}

app/Console/Commands/VersionFetch.php

@@ -0,0 +1,97 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\Setting;
+use Illuminate\Console\Command;
+use Symfony\Component\Process\Process;
+
+class VersionFetch extends Command
+{
+    protected $signature = 'version:fetch';
+
+    protected $description = 'Update the build number based on the git commit count of master.';
+
+    public function handle(): int
+    {
+        $version = Setting::where('key', 'version')->value('value');
+        $build = $this->resolveBuildCount();
+
+        if ($version === null) {
+            $this->error('Unable to determine version from settings.');
+            return self::FAILURE;
+        }
+
+        if ($build === null) {
+            $this->error('Unable to determine build number from git.');
+            return self::FAILURE;
+        }
+
+        Setting::updateOrCreate(
+            ['key' => 'build'],
+            ['value' => (string) $build],
+        );
+
+        if (!$this->syncComposerMetadata($version, $build)) {
+            $this->error('Failed to sync version/build to composer.json.');
+            return self::FAILURE;
+        }
+
+        $this->info("Build number updated to {$build}.");
+
+        return self::SUCCESS;
+    }
+
+    private function resolveBuildCount(): ?int
+    {
+        $commands = [
+            ['git', 'rev-list', '--count', 'master'],
+            ['git', 'rev-list', '--count', 'HEAD'],
+        ];
+
+        foreach ($commands as $command) {
+            $process = new Process($command, base_path());
+            $process->run();
+
+            if ($process->isSuccessful()) {
+                $output = trim($process->getOutput());
+                if (is_numeric($output)) {
+                    return (int) $output;
+                }
+            }
+        }
+
+        return null;
+    }
+
+    private function syncComposerMetadata(string $version, int $build): bool
+    {
+        $composerPath = base_path('composer.json');
+
+        if (!is_file($composerPath) || !is_readable($composerPath)) {
+            return false;
+        }
+
+        $raw = file_get_contents($composerPath);
+        if ($raw === false) {
+            return false;
+        }
+
+        $data = json_decode($raw, true);
+        if (!is_array($data)) {
+            return false;
+        }
+
+        $data['version'] = $version;
+        $data['build'] = (string) $build;
+
+        $encoded = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+        if ($encoded === false) {
+            return false;
+        }
+
+        $encoded .= "\n";
+
+        return file_put_contents($composerPath, $encoded) !== false;
+    }
+}

app/Console/Commands/VersionRelease.php

@@ -0,0 +1,113 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\Setting;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Http;
+
+class VersionRelease extends Command
+{
+    protected $signature = 'version:release {--prerelease : Mark this release as a prerelease} {--target= : Override target commit (defaults to env GITEA_TARGET_COMMIT or master)}';
+
+    protected $description = 'Create or update a Gitea release for the current version.';
+
+    public function handle(): int
+    {
+        $version = Setting::query()->where('key', 'version')->value('value');
+        if (!$version) {
+            $this->error('Unable to determine version from settings.');
+            return self::FAILURE;
+        }
+
+        $token = env('GITEA_TOKEN');
+        $owner = env('GITEA_OWNER');
+        $repo = env('GITEA_REPO');
+        $apiBase = rtrim((string) env('GITEA_API_BASE', 'https://git.24unix.net/api/v1'), '/');
+        $target = $this->option('target') ?: env('GITEA_TARGET_COMMIT', 'master');
+        $prerelease = $this->option('prerelease') || filter_var(env('GITEA_PRERELEASE', false), FILTER_VALIDATE_BOOLEAN);
+
+        if (!$token || !$owner || !$repo) {
+            $this->error('Missing Gitea config. Set GITEA_TOKEN, GITEA_OWNER, and GITEA_REPO in .env.');
+            return self::FAILURE;
+        }
+
+        $tag = "v{$version}";
+        $body = $this->resolveChangelogBody($version);
+
+        $client = Http::withHeaders([
+            'Authorization' => "token {$token}",
+            'Accept' => 'application/json',
+        ]);
+
+        $payload = [
+            'tag_name' => $tag,
+            'target_commitish' => $target,
+            'name' => $tag,
+            'body' => $body,
+            'prerelease' => (bool) $prerelease,
+        ];
+
+        $createUrl = "{$apiBase}/repos/{$owner}/{$repo}/releases";
+        $response = $client->post($createUrl, $payload);
+
+        if ($response->successful()) {
+            $this->info("Release created: {$tag}");
+            return self::SUCCESS;
+        }
+
+        if ($response->status() === 409 || $response->status() === 422) {
+            $getUrl = "{$apiBase}/repos/{$owner}/{$repo}/releases/tags/{$tag}";
+            $existing = $client->get($getUrl);
+            if (!$existing->successful()) {
+                $this->error('Release already exists, but failed to fetch it for update.');
+                return self::FAILURE;
+            }
+            $id = $existing->json('id');
+            if (!$id) {
+                $this->error('Release already exists, but no ID was returned.');
+                return self::FAILURE;
+            }
+
+            $updateUrl = "{$apiBase}/repos/{$owner}/{$repo}/releases/{$id}";
+            $updatePayload = [
+                'name' => $tag,
+                'body' => $body,
+                'prerelease' => (bool) $prerelease,
+                'target_commitish' => $target,
+            ];
+            $updated = $client->patch($updateUrl, $updatePayload);
+            if ($updated->successful()) {
+                $this->info("Release updated: {$tag}");
+                return self::SUCCESS;
+            }
+
+            $this->error("Failed to update release: {$updated->status()}");
+            return self::FAILURE;
+        }
+
+        $this->error("Failed to create release: {$response->status()}");
+        return self::FAILURE;
+    }
+
+    private function resolveChangelogBody(string $version): string
+    {
+        $path = base_path('CHANGELOG.md');
+        if (!is_file($path) || !is_readable($path)) {
+            return 'See commit history for details.';
+        }
+
+        $raw = file_get_contents($path);
+        if ($raw === false) {
+            return 'See commit history for details.';
+        }
+
+        $pattern = '/^##\\s+' . preg_quote($version, '/') . '\\s*\\R(.*?)(?=^##\\s+|\\z)/ms';
+        if (preg_match($pattern, $raw, $matches)) {
+            $body = trim($matches[1] ?? '');
+            return $body !== '' ? $body : 'See commit history for details.';
+        }
+
+        return 'See commit history for details.';
+    }
+}

app/Console/Commands/VersionSet.php

@@ -0,0 +1,73 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\Setting;
+use Illuminate\Console\Command;
+
+class VersionSet extends Command
+{
+    protected $signature = 'version:set {version}';
+
+    protected $description = 'Set the forum version (e.g. 26.0.1).';
+
+    public function handle(): int
+    {
+        $version = trim((string) $this->argument('version'));
+        if (!$this->isValidVersion($version)) {
+            $this->error('Version format must be X.Y or X.Y.Z (optionally with suffix).');
+            return self::FAILURE;
+        }
+
+        $current = Setting::query()->where('key', 'version')->value('value');
+        Setting::updateOrCreate(['key' => 'version'], ['value' => $version]);
+
+        if (!$this->syncComposerVersion($version)) {
+            $this->error('Failed to sync version to composer.json.');
+            return self::FAILURE;
+        }
+
+        if ($current) {
+            $this->info("Version updated: {$current} -> {$version}");
+        } else {
+            $this->info("Version set to {$version}");
+        }
+
+        return self::SUCCESS;
+    }
+
+    private function isValidVersion(string $version): bool
+    {
+        return (bool) preg_match('/^\d+\.\d+(?:\.\d+)?(?:[-._][0-9A-Za-z.-]+)?$/', $version);
+    }
+
+    private function syncComposerVersion(string $version): bool
+    {
+        $composerPath = base_path('composer.json');
+
+        if (!is_file($composerPath) || !is_readable($composerPath)) {
+            return false;
+        }
+
+        $raw = file_get_contents($composerPath);
+        if ($raw === false) {
+            return false;
+        }
+
+        $data = json_decode($raw, true);
+        if (!is_array($data)) {
+            return false;
+        }
+
+        $data['version'] = $version;
+
+        $encoded = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+        if ($encoded === false) {
+            return false;
+        }
+
+        $encoded .= "\n";
+
+        return file_put_contents($composerPath, $encoded) !== false;
+    }
+}

app/Http/Controllers/AttachmentController.php

@@ -0,0 +1,351 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Attachment;
+use App\Models\AttachmentExtension;
+use App\Models\Post;
+use App\Services\AttachmentThumbnailService;
+use App\Services\AuditLogger;
+use App\Models\Thread;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+use Symfony\Component\HttpFoundation\Response;
+
+class AttachmentController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Attachment::query()
+            ->with(['extension', 'group'])
+            ->withoutTrashed();
+
+        $threadParam = $request->query('thread');
+        $postParam = $request->query('post');
+
+        if ($threadParam) {
+            $threadId = $this->parseThreadId($threadParam);
+            if ($threadId !== null) {
+                $query->where('thread_id', $threadId);
+            }
+        }
+
+        if ($postParam) {
+            $postId = $this->parsePostId($postParam);
+            if ($postId !== null) {
+                $query->where('post_id', $postId);
+            }
+        }
+
+        $attachments = $query
+            ->latest('created_at')
+            ->get()
+            ->map(fn (Attachment $attachment) => $this->serializeAttachment($attachment));
+
+        return response()->json($attachments);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $user = $request->user();
+        if (!$user) {
+            return response()->json(['message' => 'Unauthorized.'], 401);
+        }
+
+        $data = $request->validate([
+            'thread' => ['nullable', 'string'],
+            'post' => ['nullable', 'string'],
+            'file' => ['required', 'file'],
+        ]);
+
+        $threadId = $this->parseThreadId($data['thread'] ?? null);
+        $postId = $this->parsePostId($data['post'] ?? null);
+
+        if (($threadId && $postId) || (!$threadId && !$postId)) {
+            return response()->json(['message' => 'Provide either thread or post.'], 422);
+        }
+
+        $thread = null;
+        $post = null;
+        if ($threadId) {
+            $thread = Thread::query()->findOrFail($threadId);
+            if (!$this->canManageAttachments($user, $thread->user_id)) {
+                return response()->json(['message' => 'Not authorized to add attachments.'], 403);
+            }
+        }
+
+        if ($postId) {
+            $post = Post::query()->findOrFail($postId);
+            if (!$this->canManageAttachments($user, $post->user_id)) {
+                return response()->json(['message' => 'Not authorized to add attachments.'], 403);
+            }
+        }
+
+        $file = $request->file('file');
+        if (!$file) {
+            return response()->json(['message' => 'File missing.'], 422);
+        }
+
+        $mime = $file->getMimeType() ?? 'application/octet-stream';
+        $extension = strtolower((string) $file->getClientOriginalExtension());
+
+        $extensionRow = $this->resolveExtension($extension);
+        if (!$extensionRow || !$extensionRow->group || !$extensionRow->group->is_active) {
+            return response()->json(['message' => 'File type not allowed.'], 422);
+        }
+
+        $group = $extensionRow->group;
+        if (!$this->matchesAllowed($mime, $extensionRow->allowed_mimes)) {
+            return response()->json(['message' => 'File type not allowed.'], 422);
+        }
+
+        $maxSizeBytes = (int) $group->max_size_kb * 1024;
+        if ($file->getSize() > $maxSizeBytes) {
+            return response()->json(['message' => 'File exceeds allowed size.'], 422);
+        }
+
+        $scopeFolder = $threadId ? "threads/{$threadId}" : "posts/{$postId}";
+        $filename = Str::uuid()->toString();
+        if ($extension !== '') {
+            $filename .= ".{$extension}";
+        }
+
+        $disk = 'local';
+        $path = "attachments/{$scopeFolder}/{$filename}";
+        Storage::disk($disk)->putFileAs("attachments/{$scopeFolder}", $file, $filename);
+
+        $thumbnailPayload = app(AttachmentThumbnailService::class)
+            ->createForUpload($file, $scopeFolder, $disk);
+
+        $attachment = Attachment::create([
+            'thread_id' => $threadId,
+            'post_id' => $postId,
+            'attachment_extension_id' => $extensionRow->id,
+            'attachment_group_id' => $group->id,
+            'user_id' => $user->id,
+            'disk' => $disk,
+            'path' => $path,
+            'thumbnail_path' => $thumbnailPayload['path'] ?? null,
+            'thumbnail_mime_type' => $thumbnailPayload['mime'] ?? null,
+            'thumbnail_size_bytes' => $thumbnailPayload['size'] ?? null,
+            'original_name' => $file->getClientOriginalName(),
+            'extension' => $extension !== '' ? $extension : null,
+            'mime_type' => $mime,
+            'size_bytes' => (int) $file->getSize(),
+        ]);
+
+        app(AuditLogger::class)->log($request, 'attachment.created', $attachment, [
+            'thread_id' => $threadId,
+            'post_id' => $postId,
+            'original_name' => $attachment->original_name,
+            'size_bytes' => $attachment->size_bytes,
+        ]);
+
+        $attachment->loadMissing(['extension', 'group']);
+
+        return response()->json($this->serializeAttachment($attachment), 201);
+    }
+
+    public function show(Attachment $attachment): JsonResponse
+    {
+        if (!$this->canViewAttachment($attachment)) {
+            return response()->json(['message' => 'Not found.'], 404);
+        }
+
+        $attachment->loadMissing(['extension', 'group']);
+
+        return response()->json($this->serializeAttachment($attachment));
+    }
+
+    public function download(Attachment $attachment): Response
+    {
+        if (!$this->canViewAttachment($attachment)) {
+            abort(404);
+        }
+
+        $disk = Storage::disk($attachment->disk);
+        if (!$disk->exists($attachment->path)) {
+            abort(404);
+        }
+
+        $mime = $attachment->mime_type ?: 'application/octet-stream';
+
+        return $disk->download($attachment->path, $attachment->original_name, [
+            'Content-Type' => $mime,
+        ]);
+    }
+
+    public function thumbnail(Attachment $attachment): Response
+    {
+        if (!$this->canViewAttachment($attachment)) {
+            abort(404);
+        }
+
+        if (!$attachment->thumbnail_path) {
+            abort(404);
+        }
+
+        $disk = Storage::disk($attachment->disk);
+        if (!$disk->exists($attachment->thumbnail_path)) {
+            abort(404);
+        }
+
+        $mime = $attachment->thumbnail_mime_type ?: 'image/jpeg';
+
+        return $disk->response($attachment->thumbnail_path, null, [
+            'Content-Type' => $mime,
+        ]);
+    }
+
+    public function destroy(Request $request, Attachment $attachment): JsonResponse
+    {
+        $user = $request->user();
+        if (!$user) {
+            return response()->json(['message' => 'Unauthorized.'], 401);
+        }
+
+        if (!$this->canManageAttachments($user, $attachment->user_id)) {
+            return response()->json(['message' => 'Not authorized to delete attachments.'], 403);
+        }
+
+        app(AuditLogger::class)->log($request, 'attachment.deleted', $attachment, [
+            'thread_id' => $attachment->thread_id,
+            'post_id' => $attachment->post_id,
+            'original_name' => $attachment->original_name,
+            'size_bytes' => $attachment->size_bytes,
+        ]);
+
+        $attachment->delete();
+
+        return response()->json(null, 204);
+    }
+
+    private function resolveExtension(string $extension): ?AttachmentExtension
+    {
+        if ($extension === '') {
+            return null;
+        }
+
+        return AttachmentExtension::query()
+            ->where('extension', strtolower($extension))
+            ->with('group')
+            ->first();
+    }
+
+    private function matchesAllowed(string $value, ?array $allowed): bool
+    {
+        if (!$allowed || count($allowed) === 0) {
+            return true;
+        }
+
+        $normalized = strtolower(trim($value));
+
+        foreach ($allowed as $entry) {
+            if (strtolower(trim((string) $entry)) === $normalized) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    private function parseThreadId(?string $value): ?int
+    {
+        if (!$value) {
+            return null;
+        }
+
+        if (preg_match('#/threads/(\d+)$#', $value, $matches)) {
+            return (int) $matches[1];
+        }
+
+        if (is_numeric($value)) {
+            return (int) $value;
+        }
+
+        return null;
+    }
+
+    private function parsePostId(?string $value): ?int
+    {
+        if (!$value) {
+            return null;
+        }
+
+        if (preg_match('#/posts/(\d+)$#', $value, $matches)) {
+            return (int) $matches[1];
+        }
+
+        if (is_numeric($value)) {
+            return (int) $value;
+        }
+
+        return null;
+    }
+
+    private function canViewAttachment(Attachment $attachment): bool
+    {
+        if ($attachment->trashed()) {
+            return false;
+        }
+
+        if ($attachment->thread_id) {
+            $thread = Thread::withTrashed()->find($attachment->thread_id);
+            return $thread && !$thread->trashed();
+        }
+
+        if ($attachment->post_id) {
+            $post = Post::withTrashed()->find($attachment->post_id);
+            if (!$post || $post->trashed()) {
+                return false;
+            }
+            $thread = Thread::withTrashed()->find($post->thread_id);
+            return $thread && !$thread->trashed();
+        }
+
+        return false;
+    }
+
+    private function canManageAttachments($user, ?int $ownerId): bool
+    {
+        if (!$user) {
+            return false;
+        }
+
+        if ($user->roles()->where('name', 'ROLE_ADMIN')->exists()) {
+            return true;
+        }
+
+        return $ownerId !== null && $ownerId === $user->id;
+    }
+
+    private function serializeAttachment(Attachment $attachment): array
+    {
+        $isImage = str_starts_with((string) $attachment->mime_type, 'image/');
+
+        return [
+            'id' => $attachment->id,
+            'thread_id' => $attachment->thread_id,
+            'post_id' => $attachment->post_id,
+            'extension' => $attachment->extension,
+            'group' => $attachment->group ? [
+                'id' => $attachment->group->id,
+                'name' => $attachment->group->name,
+                'category' => $attachment->group->category,
+                'max_size_kb' => $attachment->group->max_size_kb,
+            ] : null,
+            'original_name' => $attachment->original_name,
+            'mime_type' => $attachment->mime_type,
+            'size_bytes' => $attachment->size_bytes,
+            'download_url' => "/api/attachments/{$attachment->id}/download",
+            'thumbnail_url' => $attachment->thumbnail_path
+                ? "/api/attachments/{$attachment->id}/thumbnail"
+                : null,
+            'is_image' => $isImage,
+            'created_at' => $attachment->created_at?->toIso8601String(),
+        ];
+    }
+
+}

app/Http/Controllers/AttachmentExtensionController.php

@@ -0,0 +1,147 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Attachment;
+use App\Models\AttachmentExtension;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class AttachmentExtensionController extends Controller
+{
+    private function ensureAdmin(Request $request): ?JsonResponse
+    {
+        $user = $request->user();
+        if (!$user || !$user->roles()->where('name', 'ROLE_ADMIN')->exists()) {
+            return response()->json(['message' => 'Forbidden'], 403);
+        }
+
+        return null;
+    }
+
+    public function index(Request $request): JsonResponse
+    {
+        if ($error = $this->ensureAdmin($request)) {
+            return $error;
+        }
+
+        $extensions = AttachmentExtension::query()
+            ->with('group')
+            ->orderBy('extension')
+            ->get()
+            ->map(fn (AttachmentExtension $extension) => $this->serializeExtension($extension));
+
+        return response()->json($extensions);
+    }
+
+    public function publicIndex(): JsonResponse
+    {
+        $extensions = AttachmentExtension::query()
+            ->whereNotNull('attachment_group_id')
+            ->whereHas('group', fn ($query) => $query->where('is_active', true))
+            ->orderBy('extension')
+            ->pluck('extension')
+            ->filter()
+            ->values();
+
+        return response()->json($extensions);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        if ($error = $this->ensureAdmin($request)) {
+            return $error;
+        }
+
+        $data = $this->validatePayload($request, true);
+        $extension = $this->normalizeExtension($data['extension']);
+        if ($extension === '') {
+            return response()->json(['message' => 'Invalid extension.'], 422);
+        }
+
+        if (AttachmentExtension::query()->where('extension', $extension)->exists()) {
+            return response()->json(['message' => 'Extension already exists.'], 422);
+        }
+
+        $created = AttachmentExtension::create([
+            'extension' => $extension,
+            'attachment_group_id' => $data['attachment_group_id'] ?? null,
+            'allowed_mimes' => $data['allowed_mimes'] ?? null,
+        ]);
+
+        $created->load('group');
+
+        return response()->json($this->serializeExtension($created), 201);
+    }
+
+    public function update(Request $request, AttachmentExtension $attachmentExtension): JsonResponse
+    {
+        if ($error = $this->ensureAdmin($request)) {
+            return $error;
+        }
+
+        $data = $this->validatePayload($request, false);
+
+        if (array_key_exists('attachment_group_id', $data)) {
+            $attachmentExtension->attachment_group_id = $data['attachment_group_id'];
+        }
+        if (array_key_exists('allowed_mimes', $data)) {
+            $attachmentExtension->allowed_mimes = $data['allowed_mimes'];
+        }
+
+        $attachmentExtension->save();
+        $attachmentExtension->load('group');
+
+        return response()->json($this->serializeExtension($attachmentExtension));
+    }
+
+    public function destroy(Request $request, AttachmentExtension $attachmentExtension): JsonResponse
+    {
+        if ($error = $this->ensureAdmin($request)) {
+            return $error;
+        }
+
+        if (Attachment::query()->where('attachment_extension_id', $attachmentExtension->id)->exists()) {
+            return response()->json(['message' => 'Extension is in use.'], 422);
+        }
+
+        $attachmentExtension->delete();
+
+        return response()->json(null, 204);
+    }
+
+    private function validatePayload(Request $request, bool $requireExtension): array
+    {
+        $rules = [
+            'attachment_group_id' => ['nullable', 'integer', 'exists:attachment_groups,id'],
+            'allowed_mimes' => ['nullable', 'array'],
+            'allowed_mimes.*' => ['string', 'max:150'],
+        ];
+
+        if ($requireExtension) {
+            $rules['extension'] = ['required', 'string', 'max:30'];
+        }
+
+        return $request->validate($rules);
+    }
+
+    private function normalizeExtension(string $value): string
+    {
+        return ltrim(strtolower(trim($value)), '.');
+    }
+
+    private function serializeExtension(AttachmentExtension $extension): array
+    {
+        return [
+            'id' => $extension->id,
+            'extension' => $extension->extension,
+            'attachment_group_id' => $extension->attachment_group_id,
+            'allowed_mimes' => $extension->allowed_mimes,
+            'group' => $extension->group ? [
+                'id' => $extension->group->id,
+                'name' => $extension->group->name,
+                'is_active' => $extension->group->is_active,
+            ] : null,
+        ];
+    }
+}

app/Http/Controllers/AttachmentGroupController.php

@@ -0,0 +1,190 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Attachment;
+use App\Models\AttachmentGroup;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class AttachmentGroupController extends Controller
+{
+    private function ensureAdmin(Request $request): ?JsonResponse
+    {
+        $user = $request->user();
+        if (!$user || !$user->roles()->where('name', 'ROLE_ADMIN')->exists()) {
+            return response()->json(['message' => 'Forbidden'], 403);
+        }
+
+        return null;
+    }
+
+    public function index(Request $request): JsonResponse
+    {
+        if ($error = $this->ensureAdmin($request)) {
+            return $error;
+        }
+
+        $groups = AttachmentGroup::query()
+            ->withCount('extensions')
+            ->orderBy('parent_id')
+            ->orderBy('position')
+            ->orderBy('name')
+            ->get()
+            ->map(fn (AttachmentGroup $group) => $this->serializeGroup($group));
+
+        return response()->json($groups);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        if ($error = $this->ensureAdmin($request)) {
+            return $error;
+        }
+
+        $data = $this->validatePayload($request);
+        $name = trim($data['name']);
+        $parentId = $this->normalizeParentId($data['parent_id'] ?? null);
+
+        if (AttachmentGroup::query()->whereRaw('LOWER(name) = ?', [strtolower($name)])->exists()) {
+            return response()->json(['message' => 'Attachment group already exists.'], 422);
+        }
+
+        $position = (AttachmentGroup::query()
+            ->where('parent_id', $parentId)
+            ->max('position') ?? 0) + 1;
+
+        $group = AttachmentGroup::create([
+            'name' => $name,
+            'parent_id' => $parentId,
+            'position' => $position,
+            'max_size_kb' => $data['max_size_kb'],
+            'is_active' => $data['is_active'],
+        ]);
+
+        $group->loadCount('extensions');
+
+        return response()->json($this->serializeGroup($group), 201);
+    }
+
+    public function update(Request $request, AttachmentGroup $attachmentGroup): JsonResponse
+    {
+        if ($error = $this->ensureAdmin($request)) {
+            return $error;
+        }
+
+        $data = $this->validatePayload($request);
+        $name = trim($data['name']);
+        $parentId = $this->normalizeParentId($data['parent_id'] ?? null);
+        $position = $attachmentGroup->position ?? 1;
+
+        if (AttachmentGroup::query()
+            ->where('id', '!=', $attachmentGroup->id)
+            ->whereRaw('LOWER(name) = ?', [strtolower($name)])
+            ->exists()
+        ) {
+            return response()->json(['message' => 'Attachment group already exists.'], 422);
+        }
+
+        if ($attachmentGroup->parent_id !== $parentId) {
+            $position = (AttachmentGroup::query()
+                ->where('parent_id', $parentId)
+                ->max('position') ?? 0) + 1;
+        }
+
+        $attachmentGroup->update([
+            'name' => $name,
+            'parent_id' => $parentId,
+            'position' => $position,
+            'max_size_kb' => $data['max_size_kb'],
+            'is_active' => $data['is_active'],
+        ]);
+
+        $attachmentGroup->loadCount('extensions');
+
+        return response()->json($this->serializeGroup($attachmentGroup));
+    }
+
+    public function destroy(Request $request, AttachmentGroup $attachmentGroup): JsonResponse
+    {
+        if ($error = $this->ensureAdmin($request)) {
+            return $error;
+        }
+
+        if ($attachmentGroup->extensions()->exists()) {
+            return response()->json(['message' => 'Attachment group has extensions.'], 422);
+        }
+
+        if (Attachment::query()->where('attachment_group_id', $attachmentGroup->id)->exists()) {
+            return response()->json(['message' => 'Attachment group is in use.'], 422);
+        }
+
+        $attachmentGroup->delete();
+
+        return response()->json(null, 204);
+    }
+
+    public function reorder(Request $request): JsonResponse
+    {
+        if ($error = $this->ensureAdmin($request)) {
+            return $error;
+        }
+
+        $data = $request->validate([
+            'parentId' => ['nullable'],
+            'orderedIds' => ['required', 'array'],
+            'orderedIds.*' => ['integer'],
+        ]);
+
+        $parentId = $data['parentId'] ?? null;
+        if ($parentId === '' || $parentId === 'null') {
+            $parentId = null;
+        } elseif ($parentId !== null) {
+            $parentId = (int) $parentId;
+        }
+
+        foreach ($data['orderedIds'] as $index => $groupId) {
+            AttachmentGroup::where('id', $groupId)
+                ->where('parent_id', $parentId)
+                ->update(['position' => $index + 1]);
+        }
+
+        return response()->json(['status' => 'ok']);
+    }
+
+    private function validatePayload(Request $request): array
+    {
+        return $request->validate([
+            'name' => ['required', 'string', 'max:150'],
+            'parent_id' => ['nullable', 'integer', 'exists:attachment_groups,id'],
+            'max_size_kb' => ['required', 'integer', 'min:1', 'max:512000'],
+            'is_active' => ['required', 'boolean'],
+        ]);
+    }
+
+    private function serializeGroup(AttachmentGroup $group): array
+    {
+        return [
+            'id' => $group->id,
+            'name' => $group->name,
+            'parent_id' => $group->parent_id,
+            'position' => $group->position,
+            'max_size_kb' => $group->max_size_kb,
+            'is_active' => $group->is_active,
+            'extensions_count' => $group->extensions_count ?? null,
+        ];
+    }
+
+    private function normalizeParentId($value): ?int
+    {
+        if ($value === '' || $value === 'null') {
+            return null;
+        }
+
+        if ($value === null) {
+            return null;
+        }
+
+        return (int) $value;
+    }
+}

app/Http/Controllers/AuditLogController.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\AuditLog;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class AuditLogController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $user = $request->user();
+        if (!$user) {
+            return response()->json(['message' => 'Unauthorized.'], 401);
+        }
+
+        $isAdmin = $user->roles()->where('name', 'ROLE_ADMIN')->exists();
+        if (!$isAdmin) {
+            return response()->json(['message' => 'Not authorized.'], 403);
+        }
+
+        $limit = (int) $request->query('limit', 200);
+        $limit = max(1, min(500, $limit));
+
+        $logs = AuditLog::query()
+            ->with(['user.roles'])
+            ->latest('created_at')
+            ->limit($limit)
+            ->get()
+            ->map(fn (AuditLog $log) => $this->serializeLog($log));
+
+        return response()->json($logs);
+    }
+
+    private function serializeLog(AuditLog $log): array
+    {
+        return [
+            'id' => $log->id,
+            'action' => $log->action,
+            'subject_type' => $log->subject_type,
+            'subject_id' => $log->subject_id,
+            'metadata' => $log->metadata,
+            'ip_address' => $log->ip_address,
+            'user_agent' => $log->user_agent,
+            'created_at' => $log->created_at?->toIso8601String(),
+            'user' => $log->user ? [
+                'id' => $log->user->id,
+                'name' => $log->user->name,
+                'email' => $log->user->email,
+                'roles' => $log->user->roles?->pluck('name')->values(),
+            ] : null,
+        ];
+    }
+}

app/Http/Controllers/AuthController.php

@@ -5,6 +5,7 @@ namespace App\Http\Controllers;
 use App\Actions\Fortify\CreateNewUser;
 use App\Actions\Fortify\PasswordValidationRules;
 use App\Models\User;
+use App\Services\AuditLogger;
 use Illuminate\Auth\Events\Verified;
 use Illuminate\Auth\Events\PasswordReset;
 use Illuminate\Http\JsonResponse;
@@ -32,6 +33,9 @@ class AuthController extends Controller
         $user = $creator->create(input: $input);
 
         $user->sendEmailVerificationNotification();
+        app(AuditLogger::class)->log($request, 'user.registered', $user, [
+            'email' => $user->email,
+        ], $user);
 
         return response()->json(data: [
             'user_id' => $user->id,
@@ -77,6 +81,10 @@ class AuthController extends Controller
 
         $token = $user->createToken(name: 'api')->plainTextToken;
 
+        app(AuditLogger::class)->log($request, 'user.login', $user, [
+            'login' => $login,
+        ], $user);
+
         return response()->json(data: [
             'token' => $token,
             'user_id' => $user->id,
@@ -130,13 +138,14 @@ class AuthController extends Controller
 
         $status = Password::reset(
             $request->only('email', 'password', 'password_confirmation', 'token'),
-            function (User $user, string $password) {
+            function (User $user, string $password) use ($request) {
                 $user->forceFill(attributes: [
                     'password' => Hash::make(value: $password),
                     'remember_token' => Str::random(length: 60),
                 ])->save();
 
                 event(new PasswordReset(user: $user));
+                app(AuditLogger::class)->log($request, 'user.password_reset', $user, [], $user);
             }
         );
 
@@ -169,11 +178,14 @@ class AuthController extends Controller
             'remember_token' => Str::random(length: 60),
         ])->save();
 
+        app(AuditLogger::class)->log($request, 'user.password_changed', $user, [], $user);
+
         return response()->json(data: ['message' => 'Password updated.']);
     }
 
     public function logout(Request $request): JsonResponse
     {
+        app(AuditLogger::class)->log($request, 'user.logout', $request->user());
         $request->user()?->currentAccessToken()?->delete();
 
         return response()->json(data: null, status: 204);

app/Http/Controllers/PortalController.php

@@ -99,6 +99,7 @@ class PortalController extends Controller
             'id' => $thread->id,
             'title' => $thread->title,
             'body' => $thread->body,
+            'solved' => (bool) $thread->solved,
             'forum' => "/api/forums/{$thread->forum_id}",
             'user_id' => $thread->user_id,
             'posts_count' => ($thread->posts_count ?? 0) + 1,

app/Http/Controllers/PostController.php

@@ -2,8 +2,11 @@
 
 namespace App\Http\Controllers;
 
+use App\Actions\BbcodeFormatter;
 use App\Models\Post;
 use App\Models\Thread;
+use App\Models\Setting;
+use App\Services\AuditLogger;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Storage;
@@ -16,6 +19,8 @@ class PostController extends Controller
             'user' => fn ($query) => $query
                 ->withCount(['posts', 'threads', 'thanksGiven', 'thanksReceived'])
                 ->with(['rank', 'roles']),
+            'attachments.extension',
+            'attachments.group',
         ]);
 
         $threadParam = $request->query('thread');
@@ -50,10 +55,16 @@ class PostController extends Controller
             'body' => $data['body'],
         ]);
 
+        app(AuditLogger::class)->log($request, 'post.created', $post, [
+            'thread_id' => $thread->id,
+        ]);
+
         $post->loadMissing([
             'user' => fn ($query) => $query
                 ->withCount(['posts', 'threads', 'thanksGiven', 'thanksReceived'])
                 ->with(['rank', 'roles']),
+            'attachments.extension',
+            'attachments.group',
         ]);
 
         return response()->json($this->serializePost($post), 201);
@@ -61,6 +72,13 @@ class PostController extends Controller
 
     public function destroy(Request $request, Post $post): JsonResponse
     {
+        $reason = $request->input('reason');
+        $reasonText = $request->input('reason_text');
+        app(AuditLogger::class)->log($request, 'post.deleted', $post, [
+            'thread_id' => $post->thread_id,
+            'reason' => $reason,
+            'reason_text' => $reasonText,
+        ]);
         $post->deleted_by = $request->user()?->id;
         $post->save();
         $post->delete();
@@ -68,6 +86,41 @@ class PostController extends Controller
         return response()->json(null, 204);
     }
 
+    public function update(Request $request, Post $post): JsonResponse
+    {
+        $user = $request->user();
+        if (!$user) {
+            return response()->json(['message' => 'Unauthorized.'], 401);
+        }
+
+        $isAdmin = $user->roles()->where('name', 'ROLE_ADMIN')->exists();
+        if (!$isAdmin && $post->user_id !== $user->id) {
+            return response()->json(['message' => 'Not authorized to edit posts.'], 403);
+        }
+
+        $data = $request->validate([
+            'body' => ['required', 'string'],
+        ]);
+
+        $post->body = $data['body'];
+        $post->save();
+        $post->refresh();
+
+        app(AuditLogger::class)->log($request, 'post.edited', $post, [
+            'thread_id' => $post->thread_id,
+        ]);
+
+        $post->loadMissing([
+            'user' => fn ($query) => $query
+                ->withCount(['posts', 'threads', 'thanksGiven', 'thanksReceived'])
+                ->with(['rank', 'roles']),
+            'attachments.extension',
+            'attachments.group',
+        ]);
+
+        return response()->json($this->serializePost($post));
+    }
+
     private function parseIriId(?string $value): ?int
     {
         if (!$value) {
@@ -87,9 +140,12 @@ class PostController extends Controller
 
     private function serializePost(Post $post): array
     {
+        $attachments = $post->relationLoaded('attachments') ? $post->attachments : collect();
+        $bodyHtml = $this->renderBody($post->body, $attachments);
         return [
             'id' => $post->id,
             'body' => $post->body,
+            'body_html' => $bodyHtml,
             'thread' => "/api/threads/{$post->thread_id}",
             'user_id' => $post->user_id,
             'user_name' => $post->user?->name,
@@ -111,9 +167,89 @@ class PostController extends Controller
             'user_group_color' => $this->resolveGroupColor($post->user),
             'created_at' => $post->created_at?->toIso8601String(),
             'updated_at' => $post->updated_at?->toIso8601String(),
+            'attachments' => $post->relationLoaded('attachments')
+                ? $attachments
+                    ->map(fn ($attachment) => [
+                        'id' => $attachment->id,
+                        'group' => $attachment->group ? [
+                            'id' => $attachment->group->id,
+                            'name' => $attachment->group->name,
+                        ] : null,
+                        'original_name' => $attachment->original_name,
+                        'extension' => $attachment->extension,
+                        'mime_type' => $attachment->mime_type,
+                        'size_bytes' => $attachment->size_bytes,
+                        'download_url' => "/api/attachments/{$attachment->id}/download",
+                        'thumbnail_url' => $attachment->thumbnail_path
+                            ? "/api/attachments/{$attachment->id}/thumbnail"
+                            : null,
+                        'is_image' => str_starts_with((string) $attachment->mime_type, 'image/'),
+                        'created_at' => $attachment->created_at?->toIso8601String(),
+                    ])
+                    ->values()
+                : [],
         ];
     }
 
+    private function renderBody(string $body, $attachments): string
+    {
+        $replaced = $this->replaceAttachmentTags($body, $attachments);
+        return BbcodeFormatter::format($replaced);
+    }
+
+    private function replaceAttachmentTags(string $body, $attachments): string
+    {
+        if (!$attachments || count($attachments) === 0) {
+            return $body;
+        }
+
+        $map = [];
+        foreach ($attachments as $attachment) {
+            $name = strtolower($attachment->original_name ?? '');
+            if ($name !== '') {
+                $map[$name] = [
+                    'url' => "/api/attachments/{$attachment->id}/download",
+                    'mime' => $attachment->mime_type ?? '',
+                    'thumb' => $attachment->thumbnail_path
+                        ? "/api/attachments/{$attachment->id}/thumbnail"
+                        : null,
+                ];
+            }
+        }
+
+        if (!$map) {
+            return $body;
+        }
+
+        return preg_replace_callback('/\\[attachment\\](.+?)\\[\\/attachment\\]/i', function ($matches) use ($map) {
+            $rawName = trim($matches[1]);
+            $key = strtolower($rawName);
+            if (!array_key_exists($key, $map)) {
+                return $matches[0];
+            }
+            $entry = $map[$key];
+            $url = $entry['url'];
+            $mime = $entry['mime'] ?? '';
+            if (str_starts_with($mime, 'image/') && $this->displayImagesInline()) {
+                if (!empty($entry['thumb'])) {
+                    $thumb = $entry['thumb'];
+                    return "[url={$url}][img]{$thumb}[/img][/url]";
+                }
+                return "[img]{$url}[/img]";
+            }
+            return "[url={$url}]{$rawName}[/url]";
+        }, $body) ?? $body;
+    }
+
+    private function displayImagesInline(): bool
+    {
+        $value = Setting::query()->where('key', 'attachments.display_images_inline')->value('value');
+        if ($value === null) {
+            return true;
+        }
+        return in_array(strtolower($value), ['1', 'true', 'yes', 'on'], true);
+    }
+
     private function resolveGroupColor(?\App\Models\User $user): ?string
     {
         if (!$user) {

app/Http/Controllers/PreviewController.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Actions\BbcodeFormatter;
+use Illuminate\Http\Request;
+
+class PreviewController extends Controller
+{
+    public function preview(Request $request)
+    {
+        $data = $request->validate([
+            'body' => ['required', 'string'],
+        ]);
+
+        return response()->json([
+            'html' => BbcodeFormatter::format($data['body']),
+        ]);
+    }
+}

app/Http/Controllers/StatsController.php

@@ -5,17 +5,157 @@ namespace App\Http\Controllers;
 use App\Models\Post;
 use App\Models\Thread;
 use App\Models\User;
+use App\Models\Attachment;
+use App\Models\Setting;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Storage;
 use Illuminate\Http\JsonResponse;
 
 class StatsController extends Controller
 {
     public function __invoke(): JsonResponse
     {
+        $threadsCount = Thread::query()->withoutTrashed()->count();
+        $postsCount = Post::query()->withoutTrashed()->count();
+        $usersCount = User::query()->count();
+        $attachmentsCount = Attachment::query()->withoutTrashed()->count();
+        $attachmentsSizeBytes = (int) Attachment::query()->withoutTrashed()->sum('size_bytes');
+
+        $boardStartedAt = $this->resolveBoardStartedAt();
+        $daysSinceStart = $boardStartedAt
+            ? max(1, Carbon::parse($boardStartedAt)->diffInSeconds(now()) / 86400)
+            : null;
+
+        $dbSizeBytes = $this->resolveDatabaseSize();
+        $dbServer = $this->resolveDatabaseServer();
+        $avatarSizeBytes = $this->resolveAvatarDirectorySize();
+        $orphanAttachments = $this->resolveOrphanAttachments();
+
+        $version = Setting::query()->where('key', 'version')->value('value');
+        $build = Setting::query()->where('key', 'build')->value('value');
+        $boardVersion = $version
+            ? ($build ? "{$version} (build {$build})" : $version)
+            : null;
+
         return response()->json([
-            'threads' => Thread::query()->withoutTrashed()->count(),
+            'threads' => $threadsCount,
-            'posts' => Post::query()->withoutTrashed()->count()
+            'posts' => $postsCount + $threadsCount,
-                + Thread::query()->withoutTrashed()->count(),
+            'users' => $usersCount,
-            'users' => User::query()->count(),
+            'attachments' => $attachmentsCount,
+            'board_started_at' => $boardStartedAt,
+            'attachments_size_bytes' => $attachmentsSizeBytes,
+            'avatar_directory_size_bytes' => $avatarSizeBytes,
+            'database_size_bytes' => $dbSizeBytes,
+            'database_server' => $dbServer,
+            'gzip_compression' => $this->resolveGzipCompression(),
+            'php_version' => PHP_VERSION,
+            'orphan_attachments' => $orphanAttachments,
+            'board_version' => $boardVersion,
+            'posts_per_day' => $daysSinceStart ? ($postsCount + $threadsCount) / $daysSinceStart : null,
+            'topics_per_day' => $daysSinceStart ? $threadsCount / $daysSinceStart : null,
+            'users_per_day' => $daysSinceStart ? $usersCount / $daysSinceStart : null,
+            'attachments_per_day' => $daysSinceStart ? $attachmentsCount / $daysSinceStart : null,
         ]);
     }
+
+    private function resolveBoardStartedAt(): ?string
+    {
+        $timestamps = [
+            User::query()->min('created_at'),
+            Thread::query()->min('created_at'),
+            Post::query()->min('created_at'),
+        ];
+
+        $min = null;
+        foreach ($timestamps as $value) {
+            if (!$value) {
+                continue;
+            }
+            $time = Carbon::parse($value)->timestamp;
+            if ($min === null || $time < $min) {
+                $min = $time;
+            }
+        }
+
+        return $min !== null ? Carbon::createFromTimestamp($min)->toIso8601String() : null;
+    }
+
+    private function resolveDatabaseSize(): ?int
+    {
+        try {
+            $driver = DB::connection()->getDriverName();
+            if ($driver === 'mysql') {
+                $row = DB::selectOne('SELECT SUM(data_length + index_length) AS size FROM information_schema.tables WHERE table_schema = DATABASE()');
+                return $row && isset($row->size) ? (int) $row->size : null;
+            }
+        } catch (\Throwable) {
+            return null;
+        }
+
+        return null;
+    }
+
+    private function resolveDatabaseServer(): ?string
+    {
+        try {
+            $row = DB::selectOne('SELECT VERSION() AS version');
+            return $row && isset($row->version) ? (string) $row->version : null;
+        } catch (\Throwable) {
+            return null;
+        }
+    }
+
+    private function resolveAvatarDirectorySize(): ?int
+    {
+        try {
+            $disk = Storage::disk('public');
+            $files = $disk->allFiles('avatars');
+            $total = 0;
+            foreach ($files as $file) {
+                $total += $disk->size($file);
+            }
+            return $total;
+        } catch (\Throwable) {
+            return null;
+        }
+    }
+
+    private function resolveOrphanAttachments(): int
+    {
+        try {
+            return (int) DB::table('attachments')
+                ->leftJoin('threads', 'attachments.thread_id', '=', 'threads.id')
+                ->leftJoin('posts', 'attachments.post_id', '=', 'posts.id')
+                ->whereNull('attachments.deleted_at')
+                ->where(function ($query) {
+                    $query
+                        ->whereNull('attachments.thread_id')
+                        ->whereNull('attachments.post_id')
+                        ->orWhere(function ($inner) {
+                            $inner->whereNotNull('attachments.thread_id')
+                                ->where(function ($inner2) {
+                                    $inner2->whereNull('threads.id')
+                                        ->orWhereNotNull('threads.deleted_at');
+                                });
+                        })
+                        ->orWhere(function ($inner) {
+                            $inner->whereNotNull('attachments.post_id')
+                                ->where(function ($inner2) {
+                                    $inner2->whereNull('posts.id')
+                                        ->orWhereNotNull('posts.deleted_at');
+                                });
+                        });
+                })
+                ->count();
+        } catch (\Throwable) {
+            return 0;
+        }
+    }
+
+    private function resolveGzipCompression(): bool
+    {
+        $value = ini_get('zlib.output_compression');
+        return in_array(strtolower((string) $value), ['1', 'on', 'true'], true);
+    }
 }

app/Http/Controllers/SystemStatusController.php

@@ -0,0 +1,150 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Symfony\Component\Process\Process;
+
+class SystemStatusController extends Controller
+{
+    public function __invoke(Request $request): JsonResponse
+    {
+        $user = $request->user();
+        if (!$user || !$user->roles()->where('name', 'ROLE_ADMIN')->exists()) {
+            return response()->json(['message' => 'Forbidden'], 403);
+        }
+
+        $phpDefaultPath = $this->resolveBinary('php');
+        $phpSelectedPath = PHP_BINARY ?: $phpDefaultPath;
+        $phpSelectedOk = (bool) $phpSelectedPath;
+        $phpSelectedVersion = PHP_VERSION;
+        $minVersions = $this->resolveMinVersions();
+        $composerPath = $this->resolveBinary('composer');
+        $nodePath = $this->resolveBinary('node');
+        $npmPath = $this->resolveBinary('npm');
+        $tarPath = $this->resolveBinary('tar');
+        $rsyncPath = $this->resolveBinary('rsync');
+        $procFunctions = [
+            'proc_open',
+            'proc_get_status',
+            'proc_close',
+        ];
+        $disabledFunctions = array_filter(array_map('trim', explode(',', (string) ini_get('disable_functions'))));
+        $disabledLookup = array_fill_keys($disabledFunctions, true);
+        $procFunctionStatus = [];
+        foreach ($procFunctions as $function) {
+            $procFunctionStatus[$function] = function_exists($function) && !isset($disabledLookup[$function]);
+        }
+
+        return response()->json([
+            'php' => PHP_VERSION,
+            'php_default' => $phpDefaultPath,
+            'php_selected_path' => $phpSelectedPath,
+            'php_selected_ok' => $phpSelectedOk,
+            'php_selected_version' => $phpSelectedVersion,
+            'min_versions' => $minVersions,
+            'composer' => $composerPath,
+            'composer_version' => $this->resolveBinaryVersion($composerPath, ['--version']),
+            'node' => $nodePath,
+            'node_version' => $this->resolveBinaryVersion($nodePath, ['--version']),
+            'npm' => $npmPath,
+            'npm_version' => $this->resolveBinaryVersion($npmPath, ['--version']),
+            'tar' => $tarPath,
+            'tar_version' => $this->resolveBinaryVersion($tarPath, ['--version']),
+            'rsync' => $rsyncPath,
+            'rsync_version' => $this->resolveBinaryVersion($rsyncPath, ['--version']),
+            'proc_functions' => $procFunctionStatus,
+            'storage_writable' => is_writable(storage_path()),
+            'updates_writable' => is_writable(storage_path('app/updates')) || @mkdir(storage_path('app/updates'), 0755, true),
+        ]);
+    }
+
+    private function resolveBinary(string $name): ?string
+    {
+        $process = new Process(['sh', '-lc', "command -v {$name}"]);
+        $process->setTimeout(5);
+        $process->run();
+
+        if (!$process->isSuccessful()) {
+            return null;
+        }
+
+        $output = trim($process->getOutput());
+        return $output !== '' ? $output : null;
+    }
+
+    private function resolvePhpVersion(string $path): ?string
+    {
+        $process = new Process([$path, '-r', 'echo PHP_VERSION;']);
+        $process->setTimeout(5);
+        $process->run();
+
+        if (!$process->isSuccessful()) {
+            return null;
+        }
+
+        $output = trim($process->getOutput());
+        return $output !== '' ? $output : null;
+    }
+
+    private function resolveBinaryVersion(?string $path, array $args): ?string
+    {
+        if (!$path) {
+            return null;
+        }
+
+        $process = new Process(array_merge([$path], $args));
+        $process->setTimeout(5);
+        $process->run();
+
+        if (!$process->isSuccessful()) {
+            return null;
+        }
+
+        $output = trim($process->getOutput());
+        if ($output === '') {
+            return null;
+        }
+
+        $line = strtok($output, "\n") ?: $output;
+        if (preg_match('/(\\d+\\.\\d+(?:\\.\\d+)?)/', $line, $matches)) {
+            return $matches[1];
+        }
+
+        return null;
+    }
+
+    private function resolveMinVersions(): array
+    {
+        $composerJson = $this->readJson(base_path('composer.json'));
+        $packageJson = $this->readJson(base_path('package.json'));
+
+        $php = $composerJson['require']['php'] ?? null;
+        $node = $packageJson['engines']['node'] ?? null;
+        $npm = $packageJson['engines']['npm'] ?? null;
+        $composer = $composerJson['require']['composer-runtime-api'] ?? null;
+
+        return [
+            'php' => is_string($php) ? $php : null,
+            'node' => is_string($node) ? $node : null,
+            'npm' => is_string($npm) ? $npm : null,
+            'composer' => is_string($composer) ? $composer : null,
+        ];
+    }
+
+    private function readJson(string $path): array
+    {
+        if (!is_file($path)) {
+            return [];
+        }
+
+        $contents = file_get_contents($path);
+        if ($contents === false) {
+            return [];
+        }
+
+        $data = json_decode($contents, true);
+        return is_array($data) ? $data : [];
+    }
+}

app/Http/Controllers/SystemUpdateController.php

@@ -0,0 +1,199 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Str;
+use Symfony\Component\Process\Process;
+
+class SystemUpdateController extends Controller
+{
+    public function __invoke(Request $request): JsonResponse
+    {
+        $user = $request->user();
+        if (!$user || !$user->roles()->where('name', 'ROLE_ADMIN')->exists()) {
+            return response()->json(['message' => 'Forbidden'], 403);
+        }
+
+        set_time_limit(0);
+
+        $owner = env('GITEA_OWNER');
+        $repo = env('GITEA_REPO');
+        $apiBase = rtrim((string) env('GITEA_API_BASE', 'https://git.24unix.net/api/v1'), '/');
+        $token = env('GITEA_TOKEN');
+
+        if (!$owner || !$repo) {
+            return response()->json(['message' => 'Missing Gitea configuration.'], 422);
+        }
+
+        $log = [];
+        $append = function (string $line) use (&$log) {
+            $log[] = $line;
+        };
+
+        try {
+            $client = Http::acceptJson();
+            if ($token) {
+                $client = $client->withHeaders(['Authorization' => "token {$token}"]);
+            }
+
+            $append('Fetching latest release...');
+            $response = $client->get("{$apiBase}/repos/{$owner}/{$repo}/releases/latest");
+            if (!$response->successful()) {
+                return response()->json([
+                    'message' => "Release check failed: {$response->status()}",
+                    'log' => $log,
+                ], 500);
+            }
+
+            $tag = (string) ($response->json('tag_name') ?? '');
+            if ($tag === '') {
+                return response()->json([
+                    'message' => 'Release tag not found.',
+                    'log' => $log,
+                ], 500);
+            }
+
+            $tarballUrl = (string) ($response->json('tarball_url') ?? '');
+            if ($tarballUrl === '') {
+                $tarballUrl = env('GITEA_TGZ_URL_TEMPLATE');
+                if ($tarballUrl) {
+                    $tarballUrl = str_replace('{{TAG}}', $tag, $tarballUrl);
+                    $tarballUrl = str_replace('{{VERSION}}', ltrim($tag, 'v'), $tarballUrl);
+                }
+            }
+
+            if ($tarballUrl === '') {
+                return response()->json([
+                    'message' => 'No tarball URL available.',
+                    'log' => $log,
+                ], 500);
+            }
+
+            $append("Downloading {$tag}...");
+            $archivePath = storage_path('app/updates/' . $tag . '.tar.gz');
+            File::ensureDirectoryExists(dirname($archivePath));
+
+            $download = $client->withOptions(['stream' => true])->get($tarballUrl);
+            if (!$download->successful()) {
+                return response()->json([
+                    'message' => "Download failed: {$download->status()}",
+                    'log' => $log,
+                ], 500);
+            }
+            File::put($archivePath, $download->body());
+
+            $extractDir = storage_path('app/updates/extract-' . Str::random(8));
+            File::ensureDirectoryExists($extractDir);
+
+            $append('Extracting archive...');
+            $tar = new Process(['tar', '-xzf', $archivePath, '-C', $extractDir]);
+            $tar->setTimeout(300);
+            $tar->run();
+            if (!$tar->isSuccessful()) {
+                return response()->json([
+                    'message' => 'Failed to extract archive.',
+                    'log' => array_merge($log, [$tar->getErrorOutput()]),
+                ], 500);
+            }
+
+            $entries = collect(File::directories($extractDir))->values();
+            if ($entries->isEmpty()) {
+                return response()->json([
+                    'message' => 'No extracted folder found.',
+                    'log' => $log,
+                ], 500);
+            }
+            $sourceDir = $entries->first();
+
+            $append('Syncing files...');
+            $usedRsync = false;
+            $rsyncPath = trim((string) shell_exec('command -v rsync'));
+            if ($rsyncPath !== '') {
+                $usedRsync = true;
+                $rsync = new Process([
+                    'rsync',
+                    '-a',
+                    '--delete',
+                    '--exclude=.env',
+                    '--exclude=storage',
+                    '--exclude=public/storage',
+                    $sourceDir . '/',
+                    base_path() . '/',
+                ]);
+                $rsync->setTimeout(600);
+                $rsync->run();
+                if (!$rsync->isSuccessful()) {
+                    return response()->json([
+                        'message' => 'rsync failed.',
+                        'log' => array_merge($log, [$rsync->getErrorOutput()]),
+                    ], 500);
+                }
+            } else {
+                File::copyDirectory($sourceDir, base_path());
+            }
+
+            $append('Installing composer dependencies...');
+            $composer = new Process(['composer', 'install', '--no-dev', '--optimize-autoloader'], base_path());
+            $composer->setTimeout(600);
+            $composer->run();
+            if (!$composer->isSuccessful()) {
+                return response()->json([
+                    'message' => 'Composer install failed.',
+                    'log' => array_merge($log, [$composer->getErrorOutput()]),
+                ], 500);
+            }
+
+            $append('Installing npm dependencies...');
+            $npmInstall = new Process(['npm', 'install'], base_path());
+            $npmInstall->setTimeout(600);
+            $npmInstall->run();
+            if (!$npmInstall->isSuccessful()) {
+                return response()->json([
+                    'message' => 'npm install failed.',
+                    'log' => array_merge($log, [$npmInstall->getErrorOutput()]),
+                ], 500);
+            }
+
+            $append('Building assets...');
+            $npmBuild = new Process(['npm', 'run', 'build'], base_path());
+            $npmBuild->setTimeout(900);
+            $npmBuild->run();
+            if (!$npmBuild->isSuccessful()) {
+                return response()->json([
+                    'message' => 'npm run build failed.',
+                    'log' => array_merge($log, [$npmBuild->getErrorOutput()]),
+                ], 500);
+            }
+
+            $phpBinary = PHP_BINARY ?: 'php';
+            $append("Running migrations (using {$phpBinary})...");
+            $migrate = new Process([$phpBinary, 'artisan', 'migrate', '--force'], base_path());
+            $migrate->setTimeout(600);
+            $migrate->run();
+            if (!$migrate->isSuccessful()) {
+                return response()->json([
+                    'message' => 'Migrations failed.',
+                    'log' => array_merge($log, [$migrate->getErrorOutput()]),
+                ], 500);
+            }
+
+            $append('Update complete.');
+
+            return response()->json([
+                'message' => 'Update finished.',
+                'log' => $log,
+                'tag' => $tag,
+                'used_rsync' => $usedRsync,
+            ]);
+        } catch (\Throwable $e) {
+            return response()->json([
+                'message' => 'Update failed.',
+                'log' => $log,
+            ], 500);
+        }
+    }
+}

app/Http/Controllers/ThreadController.php

@@ -4,6 +4,9 @@ namespace App\Http\Controllers;
 
 use App\Models\Forum;
 use App\Models\Thread;
+use App\Actions\BbcodeFormatter;
+use App\Models\Setting;
+use App\Services\AuditLogger;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
@@ -49,6 +52,8 @@ class ThreadController extends Controller
             'user' => fn ($query) => $query
                 ->withCount(['posts', 'threads', 'thanksGiven', 'thanksReceived'])
                 ->with(['rank', 'roles']),
+            'attachments.extension',
+            'attachments.group',
             'latestPost.user.rank',
             'latestPost.user.roles',
         ])->loadCount('posts');
@@ -77,10 +82,17 @@ class ThreadController extends Controller
             'body' => $data['body'],
         ]);
 
+        app(AuditLogger::class)->log($request, 'thread.created', $thread, [
+            'forum_id' => $forum->id,
+            'title' => $thread->title,
+        ]);
+
         $thread->loadMissing([
             'user' => fn ($query) => $query
                 ->withCount(['posts', 'threads', 'thanksGiven', 'thanksReceived'])
                 ->with(['rank', 'roles']),
+            'attachments.extension',
+            'attachments.group',
             'latestPost.user.rank',
             'latestPost.user.roles',
         ])->loadCount('posts');
@@ -90,6 +102,14 @@ class ThreadController extends Controller
 
     public function destroy(Request $request, Thread $thread): JsonResponse
     {
+        $reason = $request->input('reason');
+        $reasonText = $request->input('reason_text');
+        app(AuditLogger::class)->log($request, 'thread.deleted', $thread, [
+            'forum_id' => $thread->forum_id,
+            'title' => $thread->title,
+            'reason' => $reason,
+            'reason_text' => $reasonText,
+        ]);
         $thread->deleted_by = $request->user()?->id;
         $thread->save();
         $thread->delete();
@@ -97,6 +117,86 @@ class ThreadController extends Controller
         return response()->json(null, 204);
     }
 
+    public function update(Request $request, Thread $thread): JsonResponse
+    {
+        $user = $request->user();
+        if (!$user) {
+            return response()->json(['message' => 'Unauthorized.'], 401);
+        }
+
+        $isAdmin = $user->roles()->where('name', 'ROLE_ADMIN')->exists();
+        if (!$isAdmin && $thread->user_id !== $user->id) {
+            return response()->json(['message' => 'Not authorized to edit threads.'], 403);
+        }
+
+        $data = $request->validate([
+            'title' => ['sometimes', 'required', 'string'],
+            'body' => ['sometimes', 'required', 'string'],
+        ]);
+
+        if (array_key_exists('title', $data)) {
+            $thread->title = $data['title'];
+        }
+        if (array_key_exists('body', $data)) {
+            $thread->body = $data['body'];
+        }
+
+        $thread->save();
+        $thread->refresh();
+
+        app(AuditLogger::class)->log($request, 'thread.edited', $thread, [
+            'forum_id' => $thread->forum_id,
+            'title' => $thread->title,
+        ]);
+
+        $thread->loadMissing([
+            'user' => fn ($query) => $query
+                ->withCount(['posts', 'threads', 'thanksGiven', 'thanksReceived'])
+                ->with(['rank', 'roles']),
+            'attachments.extension',
+            'attachments.group',
+            'latestPost.user.rank',
+            'latestPost.user.roles',
+        ])->loadCount('posts');
+
+        return response()->json($this->serializeThread($thread));
+    }
+
+    public function updateSolved(Request $request, Thread $thread): JsonResponse
+    {
+        $user = $request->user();
+        if (!$user) {
+            return response()->json(['message' => 'Unauthorized.'], 401);
+        }
+
+        $isAdmin = $user->roles()->where('name', 'ROLE_ADMIN')->exists();
+        if (!$isAdmin && $thread->user_id !== $user->id) {
+            return response()->json(['message' => 'Not authorized to update solved status.'], 403);
+        }
+
+        $data = $request->validate([
+            'solved' => ['required', 'boolean'],
+        ]);
+
+        $thread->solved = $data['solved'];
+        $thread->save();
+        app(AuditLogger::class)->log($request, 'thread.solved_updated', $thread, [
+            'solved' => $thread->solved,
+        ]);
+        $thread->refresh();
+        $thread->loadMissing([
+            'user' => fn ($query) => $query
+                ->withCount(['posts', 'threads', 'thanksGiven', 'thanksReceived'])
+                ->with(['rank', 'roles']),
+            'attachments.extension',
+            'attachments.group',
+            'latestPost.user.rank',
+            'latestPost.user.roles',
+        ])->loadCount('posts');
+
+        return response()->json($this->serializeThread($thread));
+    }
+
     private function parseIriId(?string $value): ?int
     {
         if (!$value) {
@@ -116,10 +216,14 @@ class ThreadController extends Controller
 
     private function serializeThread(Thread $thread): array
     {
+        $attachments = $thread->relationLoaded('attachments') ? $thread->attachments : collect();
+        $bodyHtml = $this->renderBody($thread->body, $attachments);
         return [
             'id' => $thread->id,
             'title' => $thread->title,
             'body' => $thread->body,
+            'body_html' => $bodyHtml,
+            'solved' => (bool) $thread->solved,
             'forum' => "/api/forums/{$thread->forum_id}",
             'user_id' => $thread->user_id,
             'posts_count' => ($thread->posts_count ?? 0) + 1,
@@ -153,9 +257,89 @@ class ThreadController extends Controller
                 ?? $this->resolveGroupColor($thread->user),
             'created_at' => $thread->created_at?->toIso8601String(),
             'updated_at' => $thread->updated_at?->toIso8601String(),
+            'attachments' => $thread->relationLoaded('attachments')
+                ? $attachments
+                    ->map(fn ($attachment) => [
+                        'id' => $attachment->id,
+                        'group' => $attachment->group ? [
+                            'id' => $attachment->group->id,
+                            'name' => $attachment->group->name,
+                        ] : null,
+                        'original_name' => $attachment->original_name,
+                        'extension' => $attachment->extension,
+                        'mime_type' => $attachment->mime_type,
+                        'size_bytes' => $attachment->size_bytes,
+                        'download_url' => "/api/attachments/{$attachment->id}/download",
+                        'thumbnail_url' => $attachment->thumbnail_path
+                            ? "/api/attachments/{$attachment->id}/thumbnail"
+                            : null,
+                        'is_image' => str_starts_with((string) $attachment->mime_type, 'image/'),
+                        'created_at' => $attachment->created_at?->toIso8601String(),
+                    ])
+                    ->values()
+                : [],
         ];
     }
 
+    private function renderBody(string $body, $attachments): string
+    {
+        $replaced = $this->replaceAttachmentTags($body, $attachments);
+        return BbcodeFormatter::format($replaced);
+    }
+
+    private function replaceAttachmentTags(string $body, $attachments): string
+    {
+        if (!$attachments || count($attachments) === 0) {
+            return $body;
+        }
+
+        $map = [];
+        foreach ($attachments as $attachment) {
+            $name = strtolower($attachment->original_name ?? '');
+            if ($name !== '') {
+                $map[$name] = [
+                    'url' => "/api/attachments/{$attachment->id}/download",
+                    'mime' => $attachment->mime_type ?? '',
+                    'thumb' => $attachment->thumbnail_path
+                        ? "/api/attachments/{$attachment->id}/thumbnail"
+                        : null,
+                ];
+            }
+        }
+
+        if (!$map) {
+            return $body;
+        }
+
+        return preg_replace_callback('/\\[attachment\\](.+?)\\[\\/attachment\\]/i', function ($matches) use ($map) {
+            $rawName = trim($matches[1]);
+            $key = strtolower($rawName);
+            if (!array_key_exists($key, $map)) {
+                return $matches[0];
+            }
+            $entry = $map[$key];
+            $url = $entry['url'];
+            $mime = $entry['mime'] ?? '';
+            if (str_starts_with($mime, 'image/') && $this->displayImagesInline()) {
+                if (!empty($entry['thumb'])) {
+                    $thumb = $entry['thumb'];
+                    return "[url={$url}][img]{$thumb}[/img][/url]";
+                }
+                return "[img]{$url}[/img]";
+            }
+            return "[url={$url}]{$rawName}[/url]";
+        }, $body) ?? $body;
+    }
+
+    private function displayImagesInline(): bool
+    {
+        $value = Setting::query()->where('key', 'attachments.display_images_inline')->value('value');
+        if ($value === null) {
+            return true;
+        }
+        return in_array(strtolower($value), ['1', 'true', 'yes', 'on'], true);
+    }
+
     private function resolveGroupColor(?\App\Models\User $user): ?string
     {
         if (!$user) {

app/Http/Controllers/VersionCheckController.php

@@ -0,0 +1,72 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Setting;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\Http;
+
+class VersionCheckController extends Controller
+{
+    public function __invoke(): JsonResponse
+    {
+        $current = Setting::query()->where('key', 'version')->value('value');
+        $build = Setting::query()->where('key', 'build')->value('value');
+
+        $owner = env('GITEA_OWNER');
+        $repo = env('GITEA_REPO');
+        $apiBase = rtrim((string) env('GITEA_API_BASE', 'https://git.24unix.net/api/v1'), '/');
+        $token = env('GITEA_TOKEN');
+
+        if (!$owner || !$repo) {
+            return response()->json([
+                'current_version' => $current,
+                'current_build' => $build !== null ? (int) $build : null,
+                'latest_tag' => null,
+                'latest_version' => null,
+                'is_latest' => null,
+                'error' => 'Missing GITEA_OWNER/GITEA_REPO configuration.',
+            ]);
+        }
+
+        try {
+            $client = Http::acceptJson();
+            if ($token) {
+                $client = $client->withHeaders(['Authorization' => "token {$token}"]);
+            }
+
+            $response = $client->get("{$apiBase}/repos/{$owner}/{$repo}/releases/latest");
+            if (!$response->successful()) {
+                return response()->json([
+                    'current_version' => $current,
+                    'current_build' => $build !== null ? (int) $build : null,
+                    'latest_tag' => null,
+                    'latest_version' => null,
+                    'is_latest' => null,
+                    'error' => "Release check failed: {$response->status()}",
+                ]);
+            }
+
+            $tag = (string) ($response->json('tag_name') ?? '');
+            $latestVersion = ltrim($tag, 'v');
+            $isLatest = $current && $latestVersion ? $current === $latestVersion : null;
+
+            return response()->json([
+                'current_version' => $current,
+                'current_build' => $build !== null ? (int) $build : null,
+                'latest_tag' => $tag ?: null,
+                'latest_version' => $latestVersion ?: null,
+                'is_latest' => $isLatest,
+            ]);
+        } catch (\Throwable $e) {
+            return response()->json([
+                'current_version' => $current,
+                'current_build' => $build !== null ? (int) $build : null,
+                'latest_tag' => null,
+                'latest_version' => null,
+                'is_latest' => null,
+                'error' => 'Version check failed.',
+            ]);
+        }
+    }
+}

app/Models/Attachment.php

@@ -0,0 +1,74 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+/**
+ * @property int $id
+ * @property int|null $thread_id
+ * @property int|null $post_id
+ * @property int|null $attachment_extension_id
+ * @property int|null $attachment_group_id
+ * @property int|null $user_id
+ * @property string $disk
+ * @property string $path
+ * @property string $original_name
+ * @property string|null $extension
+ * @property string $mime_type
+ * @property int $size_bytes
+ * @mixin \Eloquent
+ */
+class Attachment extends Model
+{
+    use SoftDeletes;
+
+    protected $fillable = [
+        'thread_id',
+        'post_id',
+        'attachment_extension_id',
+        'attachment_group_id',
+        'user_id',
+        'disk',
+        'path',
+        'thumbnail_path',
+        'thumbnail_mime_type',
+        'thumbnail_size_bytes',
+        'original_name',
+        'extension',
+        'mime_type',
+        'size_bytes',
+    ];
+
+    protected $casts = [
+        'size_bytes' => 'int',
+        'thumbnail_size_bytes' => 'int',
+    ];
+
+    public function thread(): BelongsTo
+    {
+        return $this->belongsTo(Thread::class);
+    }
+
+    public function post(): BelongsTo
+    {
+        return $this->belongsTo(Post::class);
+    }
+
+    public function extension(): BelongsTo
+    {
+        return $this->belongsTo(AttachmentExtension::class, 'attachment_extension_id');
+    }
+
+    public function group(): BelongsTo
+    {
+        return $this->belongsTo(AttachmentGroup::class, 'attachment_group_id');
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/AttachmentExtension.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * @property int $id
+ * @property string $extension
+ * @property int|null $attachment_group_id
+ * @property array|null $allowed_mimes
+ * @mixin \Eloquent
+ */
+class AttachmentExtension extends Model
+{
+    protected $fillable = [
+        'extension',
+        'attachment_group_id',
+        'allowed_mimes',
+    ];
+
+    protected $casts = [
+        'allowed_mimes' => 'array',
+    ];
+
+    public function group(): BelongsTo
+    {
+        return $this->belongsTo(AttachmentGroup::class, 'attachment_group_id');
+    }
+}

app/Models/AttachmentGroup.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * @property int $id
+ * @property string $name
+ * @property int|null $parent_id
+ * @property int|null $position
+ * @property int $max_size_kb
+ * @property bool $is_active
+ * @mixin \Eloquent
+ */
+class AttachmentGroup extends Model
+{
+    protected $fillable = [
+        'name',
+        'parent_id',
+        'position',
+        'max_size_kb',
+        'is_active',
+    ];
+
+    protected $casts = [
+        'is_active' => 'bool',
+    ];
+
+    public function extensions(): HasMany
+    {
+        return $this->hasMany(AttachmentExtension::class, 'attachment_group_id');
+    }
+
+    public function parent(): BelongsTo
+    {
+        return $this->belongsTo(self::class, 'parent_id');
+    }
+
+    public function children(): HasMany
+    {
+        return $this->hasMany(self::class, 'parent_id');
+    }
+}

app/Models/AuditLog.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * @property int $id
+ * @property int|null $user_id
+ * @property string $action
+ * @property string|null $subject_type
+ * @property int|null $subject_id
+ * @property array|null $metadata
+ * @property string|null $ip_address
+ * @property string|null $user_agent
+ * @property \Illuminate\Support\Carbon|null $created_at
+ * @property \Illuminate\Support\Carbon|null $updated_at
+ * @mixin \Eloquent
+ */
+class AuditLog extends Model
+{
+    protected $fillable = [
+        'user_id',
+        'action',
+        'subject_type',
+        'subject_id',
+        'metadata',
+        'ip_address',
+        'user_agent',
+    ];
+
+    protected $casts = [
+        'metadata' => 'array',
+    ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/Post.php

@@ -14,6 +14,7 @@ use Illuminate\Database\Eloquent\SoftDeletes;
  * @property string $body
  * @property \Illuminate\Support\Carbon|null $created_at
  * @property \Illuminate\Support\Carbon|null $updated_at
+ * @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Attachment> $attachments
  * @property-read \App\Models\Thread $thread
  * @property-read \App\Models\User|null $user
  * @method static \Illuminate\Database\Eloquent\Builder<static>|Post newModelQuery()
@@ -51,4 +52,9 @@ class Post extends Model
     {
         return $this->hasMany(PostThank::class);
     }
+
+    public function attachments(): HasMany
+    {
+        return $this->hasMany(Attachment::class);
+    }
 }

app/Models/Thread.php

@@ -14,9 +14,11 @@ use Illuminate\Database\Eloquent\SoftDeletes;
  * @property int|null $user_id
  * @property string $title
  * @property string $body
+ * @property bool $solved
  * @property \Illuminate\Support\Carbon|null $created_at
  * @property \Illuminate\Support\Carbon|null $updated_at
  * @property-read \App\Models\Forum $forum
+ * @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Attachment> $attachments
  * @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Post> $posts
  * @property-read int|null $posts_count
  * @property-read \App\Models\User|null $user
@@ -41,6 +43,11 @@ class Thread extends Model
         'user_id',
         'title',
         'body',
+        'solved',
+    ];
+
+    protected $casts = [
+        'solved' => 'bool',
     ];
 
     public function forum(): BelongsTo
@@ -58,6 +65,11 @@ class Thread extends Model
         return $this->hasMany(Post::class);
     }
 
+    public function attachments(): HasMany
+    {
+        return $this->hasMany(Attachment::class);
+    }
+
     public function latestPost(): HasOne
     {
         return $this->hasOne(Post::class)->latestOfMany();

app/Services/AttachmentThumbnailService.php

@@ -0,0 +1,208 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Attachment;
+use App\Models\Setting;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+
+class AttachmentThumbnailService
+{
+    public function createForUpload(UploadedFile $file, string $scopeFolder, string $disk = 'local'): ?array
+    {
+        $mime = $file->getMimeType() ?? '';
+        if (!str_starts_with($mime, 'image/')) {
+            return null;
+        }
+
+        $sourcePath = $file->getPathname();
+        $extension = strtolower((string) $file->getClientOriginalExtension());
+
+        return $this->createThumbnail($sourcePath, $mime, $extension, $scopeFolder, $disk);
+    }
+
+    public function createForAttachment(Attachment $attachment, bool $force = false): ?array
+    {
+        if (!$force && $attachment->thumbnail_path) {
+            $thumbDisk = Storage::disk($attachment->disk);
+            if ($thumbDisk->exists($attachment->thumbnail_path)) {
+                return null;
+            }
+        }
+
+        $mime = $attachment->mime_type ?? '';
+        if (!str_starts_with($mime, 'image/')) {
+            return null;
+        }
+
+        $disk = Storage::disk($attachment->disk);
+        if (!$disk->exists($attachment->path)) {
+            return null;
+        }
+
+        $sourcePath = $disk->path($attachment->path);
+        $scopeFolder = $this->resolveScopeFolder($attachment);
+        $extension = strtolower((string) ($attachment->extension ?? ''));
+
+        return $this->createThumbnail($sourcePath, $mime, $extension, $scopeFolder, $attachment->disk);
+    }
+
+    private function resolveScopeFolder(Attachment $attachment): string
+    {
+        if ($attachment->thread_id) {
+            return "threads/{$attachment->thread_id}";
+        }
+
+        if ($attachment->post_id) {
+            return "posts/{$attachment->post_id}";
+        }
+
+        return 'misc';
+    }
+
+    private function createThumbnail(
+        string $sourcePath,
+        string $mime,
+        string $extension,
+        string $scopeFolder,
+        string $diskName
+    ): ?array {
+        if (!$this->settingBool('attachments.create_thumbnails', true)) {
+            return null;
+        }
+
+        $maxWidth = $this->settingInt('attachments.thumbnail_max_width', 300);
+        $maxHeight = $this->settingInt('attachments.thumbnail_max_height', 300);
+        if ($maxWidth <= 0 || $maxHeight <= 0) {
+            return null;
+        }
+
+        $info = @getimagesize($sourcePath);
+        if (!$info) {
+            return null;
+        }
+
+        [$width, $height] = $info;
+        if ($width <= 0 || $height <= 0) {
+            return null;
+        }
+
+        if ($width <= $maxWidth && $height <= $maxHeight) {
+            return null;
+        }
+
+        $ratio = min($maxWidth / $width, $maxHeight / $height);
+        $targetWidth = max(1, (int) round($width * $ratio));
+        $targetHeight = max(1, (int) round($height * $ratio));
+
+        $sourceImage = $this->createImageFromFile($sourcePath, $mime);
+        if (!$sourceImage) {
+            return null;
+        }
+
+        $thumbImage = imagecreatetruecolor($targetWidth, $targetHeight);
+        if (!$thumbImage) {
+            imagedestroy($sourceImage);
+            return null;
+        }
+
+        if (in_array($mime, ['image/png', 'image/gif'], true)) {
+            imagecolortransparent($thumbImage, imagecolorallocatealpha($thumbImage, 0, 0, 0, 127));
+            imagealphablending($thumbImage, false);
+            imagesavealpha($thumbImage, true);
+        }
+
+        imagecopyresampled(
+            $thumbImage,
+            $sourceImage,
+            0,
+            0,
+            0,
+            0,
+            $targetWidth,
+            $targetHeight,
+            $width,
+            $height
+        );
+
+        $quality = $this->settingInt('attachments.thumbnail_quality', 85);
+        $thumbBinary = $this->renderImageBinary($thumbImage, $mime, $quality);
+
+        imagedestroy($sourceImage);
+        imagedestroy($thumbImage);
+
+        if ($thumbBinary === null) {
+            return null;
+        }
+
+        $filename = Str::uuid()->toString();
+        if ($extension !== '') {
+            $filename .= ".{$extension}";
+        }
+
+        $thumbPath = "attachments/{$scopeFolder}/thumbs/{$filename}";
+        Storage::disk($diskName)->put($thumbPath, $thumbBinary);
+
+        return [
+            'path' => $thumbPath,
+            'mime' => $mime,
+            'size' => strlen($thumbBinary),
+        ];
+    }
+
+    private function createImageFromFile(string $path, string $mime)
+    {
+        return match ($mime) {
+            'image/jpeg', 'image/jpg' => @imagecreatefromjpeg($path),
+            'image/png' => @imagecreatefrompng($path),
+            'image/gif' => @imagecreatefromgif($path),
+            'image/webp' => function_exists('imagecreatefromwebp') ? @imagecreatefromwebp($path) : null,
+            default => null,
+        };
+    }
+
+    private function renderImageBinary($image, string $mime, int $quality): ?string
+    {
+        ob_start();
+        $success = false;
+
+        if (in_array($mime, ['image/jpeg', 'image/jpg'], true)) {
+            $success = imagejpeg($image, null, max(10, min(95, $quality)));
+        } elseif ($mime === 'image/png') {
+            $compression = (int) round(9 - (max(10, min(95, $quality)) / 100) * 9);
+            $success = imagepng($image, null, $compression);
+        } elseif ($mime === 'image/gif') {
+            $success = imagegif($image);
+        } elseif ($mime === 'image/webp' && function_exists('imagewebp')) {
+            $success = imagewebp($image, null, max(10, min(95, $quality)));
+        }
+
+        $data = ob_get_clean();
+
+        if (!$success) {
+            return null;
+        }
+
+        return $data !== false ? $data : null;
+    }
+
+    private function settingBool(string $key, bool $default): bool
+    {
+        $value = Setting::query()->where('key', $key)->value('value');
+        if ($value === null) {
+            return $default;
+        }
+        return in_array(strtolower($value), ['1', 'true', 'yes', 'on'], true);
+    }
+
+    private function settingInt(string $key, int $default): int
+    {
+        $value = Setting::query()->where('key', $key)->value('value');
+        if ($value === null) {
+            return $default;
+        }
+        return (int) $value;
+    }
+}

app/Services/AuditLogger.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\AuditLog;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Http\Request;
+
+class AuditLogger
+{
+    public function log(
+        Request $request,
+        string $action,
+        ?Model $subject = null,
+        array $metadata = [],
+        ?Model $actor = null
+    ): ?AuditLog {
+        try {
+            $actorUser = $actor ?? $request->user();
+
+            return AuditLog::create([
+                'user_id' => $actorUser?->id,
+                'action' => $action,
+                'subject_type' => $subject ? get_class($subject) : null,
+                'subject_id' => $subject?->getKey(),
+                'metadata' => $metadata ?: null,
+                'ip_address' => $request->ip(),
+                'user_agent' => $request->userAgent(),
+            ]);
+        } catch (\Throwable) {
+            return null;
+        }
+    }
+}

artisan

@@ -1,18 +1,19 @@
 #!/usr/bin/env php
 <?php
 
-use Illuminate\Foundation\Application;
+define('LARAVEL_START', microtime(true));
-use Symfony\Component\Console\Input\ArgvInput;
 
-define(constant_name: 'LARAVEL_START', value: microtime(as_float: true));
-
-// Register the Composer autoloader...
 require __DIR__.'/vendor/autoload.php';
 
-// Bootstrap Laravel and handle the command...
-/** @var Application $app */
 $app = require_once __DIR__.'/bootstrap/app.php';
 
-$status = $app->handleCommand(input: new ArgvInput);
+$kernel = $app->make(Illuminate\Contracts\Console\Kernel::class);
+
+$status = $kernel->handle(
+    $input = new Symfony\Component\Console\Input\ArgvInput,
+    new Symfony\Component\Console\Output\ConsoleOutput
+);
+
+$kernel->terminate($input, $status);
 
 exit($status);

bootstrap/app.php

@@ -11,6 +11,9 @@ return Application::configure(basePath: dirname(__DIR__))
         commands: __DIR__.'/../routes/console.php',
         health: '/up',
     )
+    ->withCommands([
+        __DIR__.'/../app/Console/Commands',
+    ])
     ->withMiddleware(function (Middleware $middleware): void {
         //
     })

bootstrap/cache/packages.php

@@ -62,4 +62,11 @@
       0 => 'Termwind\\Laravel\\TermwindServiceProvider',
     ),
   ),
+  'pestphp/pest-plugin-laravel' => 
+  array (
+    'providers' => 
+    array (
+      0 => 'Pest\\Laravel\\PestServiceProvider',
+    ),
+  ),
 );

bootstrap/cache/services.php

@@ -33,8 +33,9 @@
     29 => 'Carbon\\Laravel\\ServiceProvider',
     30 => 'NunoMaduro\\Collision\\Adapters\\Laravel\\CollisionServiceProvider',
     31 => 'Termwind\\Laravel\\TermwindServiceProvider',
-    32 => 'App\\Providers\\AppServiceProvider',
+    32 => 'Pest\\Laravel\\PestServiceProvider',
-    33 => 'App\\Providers\\FortifyServiceProvider',
+    33 => 'App\\Providers\\AppServiceProvider',
+    34 => 'App\\Providers\\FortifyServiceProvider',
   ),
   'eager' => 
   array (
@@ -54,8 +55,9 @@
     13 => 'Carbon\\Laravel\\ServiceProvider',
     14 => 'NunoMaduro\\Collision\\Adapters\\Laravel\\CollisionServiceProvider',
     15 => 'Termwind\\Laravel\\TermwindServiceProvider',
-    16 => 'App\\Providers\\AppServiceProvider',
+    16 => 'Pest\\Laravel\\PestServiceProvider',
-    17 => 'App\\Providers\\FortifyServiceProvider',
+    17 => 'App\\Providers\\AppServiceProvider',
+    18 => 'App\\Providers\\FortifyServiceProvider',
   ),
   'deferred' => 
   array (

composer.json

@@ -3,7 +3,10 @@
     "name": "laravel/laravel",
     "type": "project",
     "description": "The skeleton application for the Laravel framework.",
-    "keywords": ["laravel", "framework"],
+    "keywords": [
+        "laravel",
+        "framework"
+    ],
     "license": "MIT",
     "require": {
         "php": "^8.4",
@@ -11,6 +14,8 @@
         "laravel/framework": "^12.0",
         "laravel/sanctum": "*",
         "laravel/tinker": "^2.10.1",
+        "s9e/text-formatter": "^2.5",
+        "composer-runtime-api": "^2.2",
         "ext-pdo": "*"
     },
     "require-dev": {
@@ -21,7 +26,9 @@
         "laravel/sail": "^1.41",
         "mockery/mockery": "^1.6",
         "nunomaduro/collision": "^8.6",
-        "phpunit/phpunit": "^11.5.3",
+        "pestphp/pest": "^4.0",
+        "pestphp/pest-plugin-laravel": "^4.0",
+        "phpunit/phpunit": "^12.3",
         "squizlabs/php_codesniffer": "^4.0"
     },
     "autoload": {
@@ -54,6 +61,7 @@
             "@php artisan config:clear --ansi",
             "@php artisan test"
         ],
+        "test:coverage": "./vendor/bin/pest --coverage",
         "post-autoload-dump": [
             "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
             "@php artisan package:discover --ansi"
@@ -88,5 +96,6 @@
         }
     },
     "minimum-stability": "stable",
-    "prefer-stable": true
+    "prefer-stable": true,
+    "version": "26.0.1"
 }

database/migrations/2026_01_24_120000_add_solved_to_threads_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('threads', function (Blueprint $table) {
+            $table->boolean('solved')->default(false)->after('body');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('threads', function (Blueprint $table) {
+            $table->dropColumn('solved');
+        });
+    }
+};

database/migrations/2026_01_24_140100_create_attachments_table.php

@@ -0,0 +1,40 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('attachments', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('thread_id')->nullable()->constrained('threads')->nullOnDelete();
+            $table->foreignId('post_id')->nullable()->constrained('posts')->nullOnDelete();
+            $table->foreignId('user_id')->nullable()->constrained('users')->nullOnDelete();
+            $table->string('disk', 50)->default('local');
+            $table->string('path');
+            $table->string('original_name');
+            $table->string('extension', 30)->nullable();
+            $table->string('mime_type', 150);
+            $table->unsignedBigInteger('size_bytes');
+            $table->timestamps();
+            $table->softDeletes();
+
+            $table->index('thread_id', 'idx_attachments_thread_id');
+            $table->index('post_id', 'idx_attachments_post_id');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('attachments');
+    }
+};

database/migrations/2026_01_24_150000_create_attachment_groups_table.php

@@ -0,0 +1,54 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('attachment_groups', function (Blueprint $table) {
+            $table->id();
+            $table->string('name', 150);
+            $table->unsignedInteger('max_size_kb')->default(25600);
+            $table->boolean('is_active')->default(true);
+            $table->timestamps();
+        });
+
+        if (Schema::hasTable('attachment_types')) {
+            $types = DB::table('attachment_types')->orderBy('id')->get();
+            foreach ($types as $type) {
+                DB::table('attachment_groups')->insert([
+                    'name' => $type->label ?? $type->key ?? 'General',
+                    'max_size_kb' => $type->max_size_kb ?? 25600,
+                    'is_active' => $type->is_active ?? true,
+                    'created_at' => now(),
+                    'updated_at' => now(),
+                ]);
+            }
+        }
+
+        if (DB::table('attachment_groups')->count() === 0) {
+            DB::table('attachment_groups')->insert([
+                'name' => 'General',
+                'max_size_kb' => 25600,
+                'is_active' => true,
+                'created_at' => now(),
+                'updated_at' => now(),
+            ]);
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('attachment_groups');
+    }
+};

database/migrations/2026_01_24_150100_create_attachment_extensions_table.php

@@ -0,0 +1,65 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('attachment_extensions', function (Blueprint $table) {
+            $table->id();
+            $table->string('extension', 30)->unique();
+            $table->foreignId('attachment_group_id')->nullable()->constrained('attachment_groups')->nullOnDelete();
+            $table->json('allowed_mimes')->nullable();
+            $table->timestamps();
+        });
+
+        if (Schema::hasTable('attachment_types') && Schema::hasTable('attachment_groups')) {
+            $groups = DB::table('attachment_groups')->orderBy('id')->get()->values();
+            $types = DB::table('attachment_types')->orderBy('id')->get()->values();
+
+            foreach ($types as $index => $type) {
+                $group = $groups[$index] ?? null;
+                if (!$group) {
+                    continue;
+                }
+                $extensions = [];
+                if (!empty($type->allowed_extensions)) {
+                    $decoded = json_decode($type->allowed_extensions, true);
+                    if (is_array($decoded)) {
+                        $extensions = $decoded;
+                    }
+                }
+                foreach ($extensions as $ext) {
+                    $ext = strtolower(trim((string) $ext));
+                    if ($ext === '') {
+                        continue;
+                    }
+                    DB::table('attachment_extensions')->updateOrInsert(
+                        ['extension' => $ext],
+                        [
+                            'attachment_group_id' => $group->id,
+                            'allowed_mimes' => $type->allowed_mimes,
+                            'created_at' => now(),
+                            'updated_at' => now(),
+                        ]
+                    );
+                }
+            }
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('attachment_extensions');
+    }
+};

database/migrations/2026_01_24_150200_add_attachment_group_to_attachments_table.php

@@ -0,0 +1,53 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('attachments', function (Blueprint $table) {
+            $table->foreignId('attachment_extension_id')->nullable()->constrained('attachment_extensions')->nullOnDelete();
+            $table->foreignId('attachment_group_id')->nullable()->constrained('attachment_groups')->nullOnDelete();
+            $table->index('attachment_extension_id', 'idx_attachments_extension_id');
+            $table->index('attachment_group_id', 'idx_attachments_group_id');
+        });
+
+        if (Schema::hasTable('attachment_extensions')) {
+            $extensions = DB::table('attachment_extensions')->get()->keyBy('extension');
+            $attachments = DB::table('attachments')->select('id', 'extension')->get();
+            foreach ($attachments as $attachment) {
+                $ext = strtolower(trim((string) $attachment->extension));
+                if ($ext === '' || !$extensions->has($ext)) {
+                    continue;
+                }
+                $extRow = $extensions->get($ext);
+                DB::table('attachments')
+                    ->where('id', $attachment->id)
+                    ->update([
+                        'attachment_extension_id' => $extRow->id,
+                        'attachment_group_id' => $extRow->attachment_group_id,
+                    ]);
+            }
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('attachments', function (Blueprint $table) {
+            $table->dropIndex('idx_attachments_extension_id');
+            $table->dropIndex('idx_attachments_group_id');
+            $table->dropConstrainedForeignId('attachment_extension_id');
+            $table->dropConstrainedForeignId('attachment_group_id');
+        });
+    }
+};

database/migrations/2026_01_24_150300_drop_attachment_type_id_from_attachments_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        if (Schema::hasColumn('attachments', 'attachment_type_id')) {
+            Schema::table('attachments', function (Blueprint $table) {
+                $table->dropForeign(['attachment_type_id']);
+                $table->dropIndex('idx_attachments_type_id');
+                $table->dropColumn('attachment_type_id');
+            });
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        if (!Schema::hasColumn('attachments', 'attachment_type_id')) {
+            Schema::table('attachments', function (Blueprint $table) {
+                $table->foreignId('attachment_type_id')->constrained('attachment_types');
+                $table->index('attachment_type_id', 'idx_attachments_type_id');
+            });
+        }
+    }
+};

database/migrations/2026_01_24_150400_drop_attachment_types_table.php

@@ -0,0 +1,23 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::dropIfExists('attachment_types');
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        // Intentionally left empty. attachment_types is deprecated.
+    }
+};

database/migrations/2026_01_24_150500_move_group_mimes_to_extensions.php

@@ -0,0 +1,77 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        if (Schema::hasColumn('attachment_groups', 'category')) {
+            Schema::table('attachment_groups', function (Blueprint $table) {
+                $table->dropColumn('category');
+            });
+        }
+
+        if (Schema::hasColumn('attachment_groups', 'allowed_mimes')) {
+            if (Schema::hasTable('attachment_extensions')) {
+                if (!Schema::hasColumn('attachment_extensions', 'allowed_mimes')) {
+                    Schema::table('attachment_extensions', function (Blueprint $table) {
+                        $table->json('allowed_mimes')->nullable();
+                    });
+                }
+
+                $groups = DB::table('attachment_groups')
+                    ->select('id', 'allowed_mimes')
+                    ->get()
+                    ->keyBy('id');
+
+                $extensions = DB::table('attachment_extensions')
+                    ->select('id', 'attachment_group_id', 'allowed_mimes')
+                    ->get();
+
+                foreach ($extensions as $extension) {
+                    if (!empty($extension->allowed_mimes)) {
+                        continue;
+                    }
+                    $group = $groups->get($extension->attachment_group_id);
+                    if (!$group || empty($group->allowed_mimes)) {
+                        continue;
+                    }
+                    DB::table('attachment_extensions')
+                        ->where('id', $extension->id)
+                        ->update([
+                            'allowed_mimes' => $group->allowed_mimes,
+                        ]);
+                }
+            }
+
+            Schema::table('attachment_groups', function (Blueprint $table) {
+                $table->dropColumn('allowed_mimes');
+            });
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        if (!Schema::hasColumn('attachment_groups', 'category')) {
+            Schema::table('attachment_groups', function (Blueprint $table) {
+                $table->string('category', 50)->default('other');
+            });
+        }
+
+        if (!Schema::hasColumn('attachment_groups', 'allowed_mimes')) {
+            Schema::table('attachment_groups', function (Blueprint $table) {
+                $table->json('allowed_mimes')->nullable();
+            });
+        }
+    }
+};

database/migrations/2026_01_25_120000_add_hierarchy_to_attachment_groups.php

@@ -0,0 +1,41 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('attachment_groups', function (Blueprint $table) {
+            $table->foreignId('parent_id')->nullable()->constrained('attachment_groups')->nullOnDelete();
+            $table->unsignedInteger('position')->default(1);
+            $table->index(['parent_id', 'position'], 'idx_attachment_groups_parent_position');
+        });
+
+        $groups = DB::table('attachment_groups')->orderBy('id')->get();
+        $position = 1;
+        foreach ($groups as $group) {
+            DB::table('attachment_groups')
+                ->where('id', $group->id)
+                ->update(['position' => $position++]);
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('attachment_groups', function (Blueprint $table) {
+            $table->dropIndex('idx_attachment_groups_parent_position');
+            $table->dropConstrainedForeignId('parent_id');
+            $table->dropColumn('position');
+        });
+    }
+};

database/migrations/2026_01_29_000100_add_attachment_thumbnails.php

@@ -0,0 +1,24 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('attachments', function (Blueprint $table) {
+            $table->string('thumbnail_path')->nullable()->after('path');
+            $table->string('thumbnail_mime_type', 150)->nullable()->after('thumbnail_path');
+            $table->unsignedBigInteger('thumbnail_size_bytes')->nullable()->after('thumbnail_mime_type');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('attachments', function (Blueprint $table) {
+            $table->dropColumn(['thumbnail_path', 'thumbnail_mime_type', 'thumbnail_size_bytes']);
+        });
+    }
+};

database/migrations/2026_01_31_000000_create_audit_logs_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up(): void
+    {
+        Schema::create('audit_logs', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->nullable()->constrained()->nullOnDelete();
+            $table->string('action');
+            $table->string('subject_type')->nullable();
+            $table->unsignedBigInteger('subject_id')->nullable();
+            $table->json('metadata')->nullable();
+            $table->string('ip_address', 45)->nullable();
+            $table->string('user_agent', 255)->nullable();
+            $table->timestamps();
+
+            $table->index(['action', 'created_at']);
+            $table->index(['user_id', 'created_at']);
+            $table->index(['subject_type', 'subject_id']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('audit_logs');
+    }
+};

package-lock.json

@@ -2072,18 +2072,6 @@
                 "node": ">=6"
             }
         },
-        "node_modules/detect-libc": {
-            "version": "2.1.2",
-            "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
-            "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
-            "dev": true,
-            "license": "Apache-2.0",
-            "optional": true,
-            "peer": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
         "node_modules/dom-helpers": {
             "version": "5.2.1",
             "resolved": "https://registry.npmjs.org/dom-helpers/-/dom-helpers-5.2.1.tgz",
@@ -2888,18 +2876,6 @@
             "dev": true,
             "license": "ISC"
         },
-        "node_modules/jiti": {
-            "version": "2.6.1",
-            "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.1.tgz",
-            "integrity": "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==",
-            "dev": true,
-            "license": "MIT",
-            "optional": true,
-            "peer": true,
-            "bin": {
-                "jiti": "lib/jiti-cli.mjs"
-            }
-        },
         "node_modules/js-tokens": {
             "version": "4.0.0",
             "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
@@ -3010,280 +2986,6 @@
                 "node": ">= 0.8.0"
             }
         },
-        "node_modules/lightningcss": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.30.2.tgz",
-            "integrity": "sha512-utfs7Pr5uJyyvDETitgsaqSyjCb2qNRAtuqUeWIAKztsOYdcACf2KtARYXg2pSvhkt+9NfoaNY7fxjl6nuMjIQ==",
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "peer": true,
-            "dependencies": {
-                "detect-libc": "^2.0.3"
-            },
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            },
-            "optionalDependencies": {
-                "lightningcss-android-arm64": "1.30.2",
-                "lightningcss-darwin-arm64": "1.30.2",
-                "lightningcss-darwin-x64": "1.30.2",
-                "lightningcss-freebsd-x64": "1.30.2",
-                "lightningcss-linux-arm-gnueabihf": "1.30.2",
-                "lightningcss-linux-arm64-gnu": "1.30.2",
-                "lightningcss-linux-arm64-musl": "1.30.2",
-                "lightningcss-linux-x64-gnu": "1.30.2",
-                "lightningcss-linux-x64-musl": "1.30.2",
-                "lightningcss-win32-arm64-msvc": "1.30.2",
-                "lightningcss-win32-x64-msvc": "1.30.2"
-            }
-        },
-        "node_modules/lightningcss-android-arm64": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.30.2.tgz",
-            "integrity": "sha512-BH9sEdOCahSgmkVhBLeU7Hc9DWeZ1Eb6wNS6Da8igvUwAe0sqROHddIlvU06q3WyXVEOYDZ6ykBZQnjTbmo4+A==",
-            "cpu": [
-                "arm64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "android"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-darwin-arm64": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.30.2.tgz",
-            "integrity": "sha512-ylTcDJBN3Hp21TdhRT5zBOIi73P6/W0qwvlFEk22fkdXchtNTOU4Qc37SkzV+EKYxLouZ6M4LG9NfZ1qkhhBWA==",
-            "cpu": [
-                "arm64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "darwin"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-darwin-x64": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.30.2.tgz",
-            "integrity": "sha512-oBZgKchomuDYxr7ilwLcyms6BCyLn0z8J0+ZZmfpjwg9fRVZIR5/GMXd7r9RH94iDhld3UmSjBM6nXWM2TfZTQ==",
-            "cpu": [
-                "x64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "darwin"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-freebsd-x64": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.30.2.tgz",
-            "integrity": "sha512-c2bH6xTrf4BDpK8MoGG4Bd6zAMZDAXS569UxCAGcA7IKbHNMlhGQ89eRmvpIUGfKWNVdbhSbkQaWhEoMGmGslA==",
-            "cpu": [
-                "x64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "freebsd"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-linux-arm-gnueabihf": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.30.2.tgz",
-            "integrity": "sha512-eVdpxh4wYcm0PofJIZVuYuLiqBIakQ9uFZmipf6LF/HRj5Bgm0eb3qL/mr1smyXIS1twwOxNWndd8z0E374hiA==",
-            "cpu": [
-                "arm"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "linux"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-linux-arm64-gnu": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.30.2.tgz",
-            "integrity": "sha512-UK65WJAbwIJbiBFXpxrbTNArtfuznvxAJw4Q2ZGlU8kPeDIWEX1dg3rn2veBVUylA2Ezg89ktszWbaQnxD/e3A==",
-            "cpu": [
-                "arm64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "linux"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-linux-arm64-musl": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.30.2.tgz",
-            "integrity": "sha512-5Vh9dGeblpTxWHpOx8iauV02popZDsCYMPIgiuw97OJ5uaDsL86cnqSFs5LZkG3ghHoX5isLgWzMs+eD1YzrnA==",
-            "cpu": [
-                "arm64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "linux"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-linux-x64-gnu": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.30.2.tgz",
-            "integrity": "sha512-Cfd46gdmj1vQ+lR6VRTTadNHu6ALuw2pKR9lYq4FnhvgBc4zWY1EtZcAc6EffShbb1MFrIPfLDXD6Xprbnni4w==",
-            "cpu": [
-                "x64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "linux"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-linux-x64-musl": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.30.2.tgz",
-            "integrity": "sha512-XJaLUUFXb6/QG2lGIW6aIk6jKdtjtcffUT0NKvIqhSBY3hh9Ch+1LCeH80dR9q9LBjG3ewbDjnumefsLsP6aiA==",
-            "cpu": [
-                "x64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "linux"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-win32-arm64-msvc": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.30.2.tgz",
-            "integrity": "sha512-FZn+vaj7zLv//D/192WFFVA0RgHawIcHqLX9xuWiQt7P0PtdFEVaxgF9rjM/IRYHQXNnk61/H/gb2Ei+kUQ4xQ==",
-            "cpu": [
-                "arm64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "win32"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
-        "node_modules/lightningcss-win32-x64-msvc": {
-            "version": "1.30.2",
-            "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.30.2.tgz",
-            "integrity": "sha512-5g1yc73p+iAkid5phb4oVFMB45417DkRevRbt/El/gKXJk4jid+vPFF/AXbxn05Aky8PapwzZrdJShv5C0avjw==",
-            "cpu": [
-                "x64"
-            ],
-            "dev": true,
-            "license": "MPL-2.0",
-            "optional": true,
-            "os": [
-                "win32"
-            ],
-            "peer": true,
-            "engines": {
-                "node": ">= 12.0.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/parcel"
-            }
-        },
         "node_modules/locate-path": {
             "version": "6.0.0",
             "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",

package.json

@@ -2,10 +2,14 @@
     "$schema": "https://www.schemastore.org/package.json",
     "private": true,
     "type": "module",
+    "engines": {
+        "node": ">=20",
+        "npm": ">=10"
+    },
     "scripts": {
         "build": "vite build",
-        "build:watch": "vite build --watch",
         "dev": "vite",
+        "watch": "vite build --watch",
         "lint": "eslint ."
     },
     "dependencies": {

phpunit.xml

@@ -18,13 +18,11 @@
         </include>
     </source>
     <php>
-        <env name="APP_ENV" value="testing"/>
+        <env name="APP_ENV" value="test"/>
         <env name="APP_MAINTENANCE_DRIVER" value="file"/>
         <env name="BCRYPT_ROUNDS" value="4"/>
         <env name="BROADCAST_CONNECTION" value="null"/>
         <env name="CACHE_STORE" value="array"/>
-        <env name="DB_CONNECTION" value="sqlite"/>
-        <env name="DB_DATABASE" value=":memory:"/>
         <env name="MAIL_MAILER" value="array"/>
         <env name="QUEUE_CONNECTION" value="sync"/>
         <env name="SESSION_DRIVER" value="array"/>

resources/js/App.jsx

@@ -7,7 +7,7 @@ import ForumView from './pages/ForumView'
 import ThreadView from './pages/ThreadView'
 import Login from './pages/Login'
 import Register from './pages/Register'
-import Acp from './pages/Acp'
+import { Acp } from './pages/Acp'
 import BoardIndex from './pages/BoardIndex'
 import Ucp from './pages/Ucp'
 import Profile from './pages/Profile'

resources/js/api/client.js

@@ -62,6 +62,12 @@ export async function registerUser({ email, username, plainPassword }) {
     })
 }
 
+export async function logoutUser() {
+    return apiFetch('/logout', {
+        method: 'POST',
+    })
+}
+
 export async function listRootForums() {
     return getCollection('/forums?parent[exists]=false')
 }
@@ -109,6 +115,20 @@ export async function fetchVersion() {
     return apiFetch('/version')
 }
 
+export async function fetchVersionCheck() {
+    return apiFetch('/version/check')
+}
+
+export async function runSystemUpdate() {
+    return apiFetch('/system/update', {
+        method: 'POST',
+    })
+}
+
+export async function fetchSystemStatus() {
+    return apiFetch('/system/status')
+}
+
 export async function fetchStats() {
     return apiFetch('/stats')
 }
@@ -117,6 +137,13 @@ export async function fetchPortalSummary() {
     return apiFetch('/portal/summary')
 }
 
+export async function previewBbcode(body) {
+    return apiFetch('/preview', {
+        method: 'POST',
+        body: JSON.stringify({ body }),
+    })
+}
+
 export async function fetchSetting(key) {
     // TODO: Prefer fetchSettings() when multiple settings are needed.
     const cacheBust = Date.now()
@@ -246,14 +273,147 @@ export async function getThread(id) {
     return apiFetch(`/threads/${id}`)
 }
 
+export async function deleteThread(id, payload = null) {
+    return apiFetch(`/threads/${id}`, {
+        method: 'DELETE',
+        ...(payload ? { body: JSON.stringify(payload) } : {}),
+    })
+}
+
+export async function updateThread(id, payload) {
+    return apiFetch(`/threads/${id}`, {
+        method: 'PATCH',
+        headers: {
+            'Content-Type': 'application/merge-patch+json',
+        },
+        body: JSON.stringify(payload),
+    })
+}
+
+export async function updateThreadSolved(threadId, solved) {
+    return apiFetch(`/threads/${threadId}/solved`, {
+        method: 'PATCH',
+        headers: {
+            'Content-Type': 'application/merge-patch+json',
+        },
+        body: JSON.stringify({ solved }),
+    })
+}
+
+export async function listAttachmentsByThread(threadId) {
+    return getCollection(`/attachments?thread=/api/threads/${threadId}`)
+}
+
+export async function listAttachmentsByPost(postId) {
+    return getCollection(`/attachments?post=/api/posts/${postId}`)
+}
+
+export async function uploadAttachment({ threadId, postId, file }) {
+    const body = new FormData()
+    if (threadId) body.append('thread', `/api/threads/${threadId}`)
+    if (postId) body.append('post', `/api/posts/${postId}`)
+    body.append('file', file)
+    return apiFetch('/attachments', {
+        method: 'POST',
+        body,
+    })
+}
+
+export async function deleteAttachment(id) {
+    return apiFetch(`/attachments/${id}`, {
+        method: 'DELETE',
+    })
+}
+
+export async function listAttachmentGroups() {
+    return getCollection('/attachment-groups')
+}
+
+export async function createAttachmentGroup(payload) {
+    return apiFetch('/attachment-groups', {
+        method: 'POST',
+        body: JSON.stringify(payload),
+    })
+}
+
+export async function updateAttachmentGroup(id, payload) {
+    return apiFetch(`/attachment-groups/${id}`, {
+        method: 'PATCH',
+        body: JSON.stringify(payload),
+    })
+}
+
+export async function deleteAttachmentGroup(id) {
+    return apiFetch(`/attachment-groups/${id}`, {
+        method: 'DELETE',
+    })
+}
+
+export async function reorderAttachmentGroups(parentId, orderedIds) {
+    return apiFetch('/attachment-groups/reorder', {
+        method: 'POST',
+        body: JSON.stringify({ parentId, orderedIds }),
+    })
+}
+
+export async function listAttachmentExtensions() {
+    return getCollection('/attachment-extensions')
+}
+
+export async function listAttachmentExtensionsPublic() {
+    return getCollection('/attachment-extensions/public')
+}
+
+export async function createAttachmentExtension(payload) {
+    return apiFetch('/attachment-extensions', {
+        method: 'POST',
+        body: JSON.stringify(payload),
+    })
+}
+
+export async function updateAttachmentExtension(id, payload) {
+    return apiFetch(`/attachment-extensions/${id}`, {
+        method: 'PATCH',
+        body: JSON.stringify(payload),
+    })
+}
+
+export async function deleteAttachmentExtension(id) {
+    return apiFetch(`/attachment-extensions/${id}`, {
+        method: 'DELETE',
+    })
+}
+
 export async function listPostsByThread(threadId) {
     return getCollection(`/posts?thread=/api/threads/${threadId}`)
 }
 
+export async function updatePost(id, payload) {
+    return apiFetch(`/posts/${id}`, {
+        method: 'PATCH',
+        headers: {
+            'Content-Type': 'application/merge-patch+json',
+        },
+        body: JSON.stringify(payload),
+    })
+}
+
+export async function deletePost(id, payload = null) {
+    return apiFetch(`/posts/${id}`, {
+        method: 'DELETE',
+        ...(payload ? { body: JSON.stringify(payload) } : {}),
+    })
+}
+
 export async function listUsers() {
     return getCollection('/users')
 }
 
+export async function listAuditLogs(limit = 200) {
+    const query = Number.isFinite(limit) ? `?limit=${limit}` : ''
+    return getCollection(`/audit-logs${query}`)
+}
+
 export async function listRanks() {
     return getCollection('/ranks')
 }

resources/js/components/PortalTopicRow.jsx

@@ -39,6 +39,9 @@ export default function PortalTopicRow({ thread, forumName, forumId, showForum =
                 <div>
                     <Link to={`/thread/${thread.id}`} className="bb-portal-topic-title">
                         {thread.title}
+                        {thread.solved && (
+                            <span className="bb-thread-solved-badge">{t('thread.solved')}</span>
+                        )}
                     </Link>
                     <div className="bb-portal-topic-meta">
                         <div className="bb-portal-topic-meta-line">

resources/js/context/AuthContext.jsx

@@ -1,5 +1,5 @@
 import { createContext, useContext, useMemo, useState, useEffect } from 'react'
-import { login as apiLogin } from '../api/client'
+import { login as apiLogin, logoutUser } from '../api/client'
 
 const AuthContext = createContext(null)
 
@@ -46,7 +46,12 @@ export function AuthProvider({ children }) {
                 setToken(data.token)
                 setEmail(data.email || loginInput)
             },
-            logout() {
+            async logout() {
+                try {
+                    await logoutUser()
+                } catch {
+                    // Ignore logout failures; client state is cleared regardless.
+                }
                 localStorage.removeItem('speedbb_token')
                 localStorage.removeItem('speedbb_email')
                 localStorage.removeItem('speedbb_user_id')

resources/js/index.css

@@ -105,6 +105,40 @@ a {
   margin: 0;
   font-size: 1.6rem;
   color: var(--bb-accent, #f29b3f);
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+}
+
+.bb-thread-solved-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+  padding: 0.18rem 0.5rem;
+  border-radius: 999px;
+  background: var(--bb-accent, #f29b3f);
+  color: #0b0f17;
+  font-size: 0.75rem;
+  font-weight: 700;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  margin-left: 0.45rem;
+}
+
+.bb-thread-solved-toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+  color: var(--bb-accent, #f29b3f);
+  border-color: var(--bb-accent, #f29b3f);
+}
+
+.bb-thread-solved-toggle:hover,
+.bb-thread-solved-toggle:focus {
+  background: var(--bb-accent, #f29b3f);
+  border-color: var(--bb-accent, #f29b3f);
+  color: #0b0f17;
 }
 
 .bb-thread-meta {
@@ -136,6 +170,355 @@ a {
   flex-wrap: wrap;
 }
 
+.bb-thread-attachments {
+  border: 1px solid var(--bb-border);
+  border-radius: 12px;
+  padding: 0.8rem 1rem;
+  background: #141822;
+}
+
+.bb-thread-attachments-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  flex-wrap: wrap;
+  font-weight: 600;
+  color: var(--bb-ink);
+  margin-bottom: 0.6rem;
+}
+
+.bb-thread-attachments-actions {
+  display: flex;
+  align-items: center;
+  gap: 0.6rem;
+  flex-wrap: wrap;
+}
+
+.bb-thread-attachments-actions input[type='file'] {
+  max-width: 280px;
+  color: var(--bb-ink-muted);
+}
+
+.bb-thread-modal.modal-dialog {
+  max-width: 95vw !important;
+  width: 95vw !important;
+  height: 95vh;
+  margin: 2.5vh auto;
+}
+
+.bb-thread-modal.modal-dialog .modal-content {
+  height: 95vh;
+  width: 100%;
+}
+
+.bb-thread-modal.modal-dialog .modal-body {
+  overflow-y: auto;
+}
+
+.bb-lightbox-modal {
+  max-width: min(96vw, 1200px);
+}
+
+.bb-lightbox-modal .modal-content {
+  background: rgba(12, 16, 24, 0.98);
+}
+
+.bb-lightbox-body {
+  position: relative;
+  min-height: 200px;
+}
+
+.bb-lightbox-controls {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0 0.75rem;
+  pointer-events: none;
+}
+
+.bb-lightbox-btn {
+  pointer-events: auto;
+  border-radius: 999px;
+  width: 42px;
+  height: 42px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.bb-attachment-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.35rem;
+}
+
+.bb-post-content .bb-attachment-list {
+  margin-top: 0.4rem;
+}
+
+.bb-attachment-item {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  color: var(--bb-ink);
+  text-decoration: none;
+  padding: 0.35rem 0.5rem;
+  border-radius: 8px;
+  background: rgba(255, 255, 255, 0.04);
+  border: 1px solid rgba(255, 255, 255, 0.08);
+}
+
+.bb-attachment-item .bi-paperclip {
+  color: var(--bb-accent, #f29b3f);
+}
+
+.bb-attachment-item:hover {
+  border-color: var(--bb-accent, #f29b3f);
+  color: var(--bb-accent, #f29b3f);
+}
+
+.bb-attachment-name {
+  font-weight: 600;
+}
+
+.bb-attachment-meta {
+  color: var(--bb-ink-muted);
+  font-size: 0.8rem;
+}
+
+.bb-attachment-panel {
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  border-radius: 12px;
+  background: rgba(18, 23, 33, 0.9);
+  overflow: hidden;
+}
+
+.bb-attachment-tabs {
+  display: flex;
+  gap: 0.4rem;
+  padding: 0.6rem 0.8rem 0;
+}
+
+.bb-attachment-tab {
+  border: none;
+  background: #1a202b;
+  color: var(--bb-ink-muted);
+  padding: 0.35rem 0.75rem;
+  border-radius: 8px 8px 0 0;
+  font-size: 0.85rem;
+  font-weight: 600;
+}
+
+.bb-attachment-tab.is-active {
+  color: var(--bb-accent, #f29b3f);
+  background: #202735;
+}
+
+.bb-attachment-body {
+  padding: 0.8rem;
+  border-top: 1px solid rgba(255, 255, 255, 0.06);
+}
+
+.bb-attachment-actions {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin-bottom: 0.8rem;
+}
+
+.bb-attachment-drop {
+  border: 2px dashed color-mix(in srgb, var(--bb-accent, #f29b3f) 65%, transparent);
+  border-radius: 12px;
+  padding: 0.85rem 1rem;
+  background: rgba(18, 23, 33, 0.6);
+  color: var(--bb-ink-muted);
+  text-align: center;
+  margin-bottom: 0.8rem;
+  cursor: pointer;
+  transition: border-color 0.2s ease, background 0.2s ease, color 0.2s ease;
+}
+
+.bb-attachment-drop.is-dragover {
+  border-color: var(--bb-accent, #f29b3f);
+  background: rgba(242, 155, 63, 0.12);
+  color: var(--bb-ink);
+}
+
+.bb-attachment-drop-link {
+  border: 0;
+  padding: 0;
+  background: transparent;
+  color: var(--bb-accent, #f29b3f);
+  font-weight: 600;
+  text-decoration: underline;
+}
+
+.bb-attachment-drop-link:hover {
+  color: color-mix(in srgb, var(--bb-accent, #f29b3f) 80%, #fff);
+}
+
+.bb-attachment-input {
+  display: none;
+}
+
+.bb-attachment-table {
+  border-radius: 10px;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  overflow: hidden;
+  margin-bottom: 0;
+  color: var(--bb-ink);
+}
+
+.bb-attachment-table thead th {
+  font-size: 0.7rem;
+  text-transform: none;
+  letter-spacing: 0.02em;
+  color: var(--bb-ink-muted);
+  background: rgba(255, 255, 255, 0.03);
+  text-align: left;
+  border-bottom: 0;
+  padding: 0.6rem 0.8rem;
+}
+
+.bb-attachment-table tbody td {
+  border-top: 1px solid rgba(255, 255, 255, 0.06);
+  padding: 0.6rem 0.8rem;
+  vertical-align: middle;
+}
+
+.bb-attachment-table thead th:nth-child(3),
+.bb-attachment-table tbody td:nth-child(3) {
+  width: 90px;
+}
+
+.bb-attachment-table thead th:nth-child(4),
+.bb-attachment-table tbody td:nth-child(4) {
+  width: 80px;
+}
+
+.bb-attachment-table thead th:nth-child(5),
+.bb-attachment-table tbody td:nth-child(5) {
+  width: 1%;
+  white-space: nowrap;
+}
+
+.bb-attachment-name {
+  color: var(--bb-accent, #f29b3f);
+  font-weight: 600;
+}
+
+.bb-attachment-size {
+  color: var(--bb-ink-muted);
+  font-size: 0.85rem;
+}
+
+.bb-attachment-status {
+  color: #8bd98b;
+  font-size: 0.85rem;
+}
+
+.bb-attachment-comment {
+  background: #202734;
+  border-color: rgba(255, 255, 255, 0.08);
+  color: var(--bb-ink);
+  font-size: 0.85rem;
+}
+
+.bb-attachment-row-actions {
+  display: inline-flex;
+  align-items: center;
+  gap: 0;
+  justify-content: flex-end;
+  background: var(--bb-accent, #f29b3f);
+  border-radius: 10px;
+  padding: 0.2rem;
+  width: fit-content;
+}
+
+.bb-attachment-action {
+  border: 0;
+  background: transparent;
+  color: #0e121b;
+  width: 36px;
+  height: 32px;
+  border-radius: 8px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 0.95rem;
+  transition: transform 0.15s ease, border-color 0.15s ease, background 0.15s ease;
+}
+
+.bb-attachment-action:hover {
+  transform: translateY(-1px);
+  background: color-mix(in srgb, #fff 18%, transparent);
+  color: #0e121b;
+}
+
+.bb-attachment-remove {
+  border: none;
+  background: rgba(255, 255, 255, 0.06);
+  color: var(--bb-ink-muted);
+  width: 32px;
+  height: 28px;
+  border-radius: 6px;
+}
+
+.bb-attachment-remove:hover {
+  color: #f07f7f;
+  background: rgba(240, 127, 127, 0.12);
+}
+
+.bb-attachment-empty {
+  padding: 0.8rem;
+  color: var(--bb-ink-muted);
+  font-size: 0.85rem;
+}
+
+.bb-attachment-options {
+  display: flex;
+  flex-direction: column;
+  gap: 0.6rem;
+  padding: 0.2rem 0;
+}
+
+.bb-attachment-options .form-check-label {
+  color: var(--bb-ink);
+}
+
+.bb-attachment-options .form-check-input {
+  background-color: #1a202b;
+  border-color: rgba(255, 255, 255, 0.2);
+}
+
+.bb-attachment-options .form-check-input:checked {
+  background-color: var(--bb-accent, #f29b3f);
+  border-color: var(--bb-accent, #f29b3f);
+}
+
+.form-control:focus,
+.form-select:focus,
+.form-check-input:focus {
+  border-color: var(--bb-accent, #f29b3f);
+  box-shadow: 0 0 0 0.2rem color-mix(in srgb, var(--bb-accent, #f29b3f) 30%, transparent);
+}
+
+.tr-header {
+  border-bottom: 3px solid var(--bb-accent, #f29b3f);
+}
+
+.tr-header th {
+  border-bottom: 3px solid var(--bb-accent, #f29b3f);
+}
+
+.rdt_TableHeadRow {
+  border-bottom: 3px solid var(--bb-accent, #f29b3f);
+}
+
+
 .bb-thread-actions {
   display: flex;
   align-items: center;
@@ -317,6 +700,9 @@ a {
 
 .bb-post-content {
   padding: 1rem 1.35rem 1.2rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.8rem;
 }
 
 .bb-post-header {
@@ -378,21 +764,40 @@ a {
 
 .bb-post-content {
   position: relative;
-  padding-bottom: 3.5rem;
 }
 
 .bb-post-body {
   white-space: pre-wrap;
   color: var(--bb-ink);
   line-height: 1.6;
+  flex: 1 1 auto;
+}
+
+.bb-post-body blockquote {
+  margin: 1rem 0;
+  padding: 0.75rem 1rem;
+  border-left: 3px solid var(--bb-accent, #f29b3f);
+  background: rgba(255, 255, 255, 0.04);
+  color: var(--bb-ink-muted);
+  border-radius: 8px;
+}
+
+.bb-post-body blockquote > cite {
+  display: block;
+  font-style: normal;
+  font-weight: 600;
+  color: var(--bb-ink);
+  margin-bottom: 0.35rem;
+}
+
+.bb-post-body blockquote > div {
+  color: var(--bb-ink);
 }
 
 .bb-post-footer {
-  position: absolute;
-  right: 1rem;
-  bottom: 1rem;
   display: flex;
   justify-content: flex-end;
+  margin-top: auto;
 }
 
 .bb-thread-reply {
@@ -1771,6 +2176,14 @@ a {
   color: #0e121b;
 }
 
+.bb-accent-button:disabled,
+.bb-accent-button.disabled {
+  background: var(--bb-accent, #f29b3f);
+  border-color: var(--bb-accent, #f29b3f);
+  color: #0e121b;
+  opacity: 0.6;
+}
+
 .modal-content .modal-header {
   background: #0f1218;
   color: #e6e8eb;
@@ -1817,9 +2230,219 @@ a {
 }
 
 .bb-acp {
-  max-width: 1880px;
+  max-width: 100%;
 }
 
+.bb-acp-sidebar {
+  position: sticky;
+  top: 1rem;
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.bb-acp-sidebar-section {
+  background: rgba(16, 20, 30, 0.7);
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  border-radius: 10px;
+  padding: 0.75rem;
+}
+
+.bb-acp-sidebar-title {
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--bb-ink-muted);
+  margin-bottom: 0.5rem;
+}
+
+.bb-acp-sidebar .list-group-item {
+  background: transparent;
+  color: var(--bb-ink);
+  border: 0;
+  padding: 0.35rem 0.25rem;
+}
+
+.bb-acp-sidebar .list-group-item.is-active,
+.bb-acp-sidebar .list-group-item:hover {
+  color: var(--bb-accent, #f29b3f);
+}
+
+.bb-acp-panel {
+  background: rgba(18, 23, 33, 0.8);
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  border-radius: 12px;
+}
+
+.bb-acp-panel-header {
+  padding: 0.9rem 1rem;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
+}
+
+.bb-acp-panel-body {
+  padding: 1rem;
+}
+
+.bb-acp-stats-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+  gap: 1.5rem;
+}
+
+.bb-acp-stats-table {
+  width: 100%;
+  border-radius: 10px;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  background: rgba(12, 16, 24, 0.6);
+  overflow: hidden;
+  border-collapse: collapse;
+}
+
+.bb-acp-stats-table th {
+  text-align: left;
+  padding: 0.55rem 0.75rem;
+  font-size: 0.72rem;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--bb-ink-muted);
+  background: rgba(255, 255, 255, 0.04);
+}
+
+.bb-acp-stats-table td {
+  padding: 0.6rem 0.75rem;
+  border-top: 1px solid rgba(255, 255, 255, 0.06);
+  color: var(--bb-ink);
+}
+
+.bb-acp-stats-table tbody tr:nth-child(even) {
+  background: rgba(255, 255, 255, 0.03);
+}
+
+.bb-acp-stats-value {
+  text-align: right;
+  font-weight: 600;
+}
+
+.bb-acp-version-inline {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.75rem;
+  flex-wrap: wrap;
+}
+
+.bb-acp-version-link {
+  color: var(--bb-accent, #f29b3f);
+  text-decoration: none;
+  font-weight: 600;
+}
+
+.bb-acp-version-link:hover {
+  text-decoration: underline;
+}
+
+.bb-acp-version-meta {
+  color: var(--bb-ink-muted);
+  font-size: 0.85rem;
+}
+
+.bb-acp-update-log {
+  max-height: 240px;
+  overflow: auto;
+  background: rgba(12, 16, 24, 0.7);
+  border-radius: 8px;
+  padding: 0.75rem;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  color: var(--bb-ink);
+  font-size: 0.85rem;
+}
+
+.bb-status-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 1rem;
+}
+
+.bb-status-icon.is-ok {
+  color: #22c55e;
+}
+
+.bb-status-icon.is-bad {
+  color: #ef4444;
+}
+
+.bb-status-icon.is-warn {
+  color: #f59e0b;
+}
+
+[data-bs-theme="light"] .bb-acp-stats-table {
+  background: #ffffff;
+  border-color: rgba(14, 18, 27, 0.12);
+}
+
+[data-bs-theme="light"] .bb-acp-stats-table th {
+  background: rgba(14, 18, 27, 0.04);
+  color: #5b6678;
+}
+
+[data-bs-theme="light"] .bb-acp-stats-table td {
+  border-top-color: rgba(14, 18, 27, 0.06);
+}
+
+[data-bs-theme="light"] .bb-acp-stats-table tbody tr:nth-child(even) {
+  background: rgba(14, 18, 27, 0.02);
+}
+
+.bb-acp-admin-log__table {
+  width: 100%;
+  border-collapse: collapse;
+  border-radius: 10px;
+  overflow: hidden;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  background: rgba(12, 16, 24, 0.6);
+}
+
+.bb-acp-admin-log__table th {
+  text-align: left;
+  padding: 0.55rem 0.75rem;
+  font-size: 0.72rem;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--bb-ink-muted);
+  background: rgba(255, 255, 255, 0.04);
+}
+
+.bb-acp-admin-log__table td {
+  padding: 0.6rem 0.75rem;
+  border-top: 1px solid rgba(255, 255, 255, 0.06);
+  color: var(--bb-ink);
+}
+
+.bb-acp-admin-log__table tbody tr:nth-child(even) {
+  background: rgba(255, 255, 255, 0.03);
+}
+
+.bb-acp-admin-log__table tfoot td {
+  text-align: right;
+}
+
+[data-bs-theme="light"] .bb-acp-admin-log__table {
+  background: #ffffff;
+  border-color: rgba(14, 18, 27, 0.12);
+}
+
+[data-bs-theme="light"] .bb-acp-admin-log__table th {
+  background: rgba(14, 18, 27, 0.04);
+  color: #5b6678;
+}
+
+[data-bs-theme="light"] .bb-acp-admin-log__table td {
+  border-top-color: rgba(14, 18, 27, 0.06);
+}
+
+[data-bs-theme="light"] .bb-acp-admin-log__table tbody tr:nth-child(even) {
+  background: rgba(14, 18, 27, 0.02);
+}
 .bb-icon {
   width: 44px;
   height: 44px;
@@ -1887,6 +2510,104 @@ a {
   gap: 0.6rem;
 }
 
+.bb-attachment-type-main {
+  display: flex;
+  flex-direction: column;
+  gap: 0.2rem;
+}
+
+.bb-attachment-type-title {
+  font-weight: 600;
+  color: var(--bb-ink);
+}
+
+.bb-attachment-type-meta {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 0.4rem;
+  color: var(--bb-ink-muted);
+  font-size: 0.85rem;
+}
+
+.bb-attachment-type-rules {
+  margin-top: 0.2rem;
+  color: var(--bb-ink-muted);
+  font-size: 0.8rem;
+}
+
+.bb-attachment-admin {
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+}
+
+.bb-attachment-extension-form {
+  display: grid;
+  grid-template-columns: minmax(160px, 1fr) minmax(200px, 1.2fr) minmax(160px, 1fr) auto;
+  gap: 0.75rem;
+  align-items: center;
+  margin-bottom: 1rem;
+}
+
+.bb-attachment-extension-table {
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  overflow: hidden;
+  background: rgba(18, 23, 33, 0.8);
+}
+
+.bb-attachment-extension-table table {
+  margin-bottom: 0;
+  color: var(--bb-ink);
+}
+
+.bb-attachment-extension-table thead th {
+  font-size: 0.8rem;
+  color: var(--bb-ink-muted);
+  background: rgba(15, 19, 27, 0.7);
+  border-bottom: 0;
+  padding: 0.55rem 0.8rem;
+}
+
+.bb-attachment-extension-table tbody td {
+  border-top: 1px solid rgba(255, 255, 255, 0.08);
+  padding: 0.55rem 0.8rem;
+  vertical-align: middle;
+}
+
+.bb-attachment-extension-name {
+  font-weight: 600;
+  color: var(--bb-ink);
+}
+
+.bb-attachment-extension-actions {
+  display: flex;
+  justify-content: flex-end;
+}
+
+.bb-attachment-extension-meta {
+  color: var(--bb-ink-muted);
+  font-size: 0.9rem;
+}
+
+.bb-attachment-tree-toggle {
+  cursor: pointer;
+  flex: 1 1 auto;
+}
+
+.bb-attachment-tree-toggle:focus-visible {
+  outline: 2px solid color-mix(in srgb, var(--bb-accent, #f29b3f) 70%, #000);
+  outline-offset: 2px;
+  border-radius: 10px;
+}
+
+@media (max-width: 900px) {
+  .bb-attachment-extension-form {
+    grid-template-columns: 1fr;
+  }
+}
+
 .bb-rank-main img {
   height: 22px;
   width: auto;
@@ -2080,6 +2801,10 @@ a {
   max-width: 320px;
 }
 
+.bb-audit-limit {
+  max-width: 120px;
+}
+
 .bb-sort-label {
   display: flex;
   align-items: center;
@@ -2150,6 +2875,7 @@ a {
   }
 }
 
+
 .bb-collapse-toggle {
   width: 20px;
   height: 20px;

resources/js/pages/ForumView.jsx

@@ -1,7 +1,15 @@
 import { useEffect, useState } from 'react'
 import { Button, Badge, Card, Col, Container, Form, Modal, Row } from 'react-bootstrap'
 import { Link, useParams } from 'react-router-dom'
-import { createThread, getForum, listAllForums, listThreadsByForum } from '../api/client'
+import {
+    createThread,
+    getForum,
+    listAllForums,
+    listThreadsByForum,
+    uploadAttachment,
+    listAttachmentExtensionsPublic,
+    previewBbcode,
+} from '../api/client'
 import PortalTopicRow from '../components/PortalTopicRow'
 import { useAuth } from '../context/AuthContext'
 import { useTranslation } from 'react-i18next'
@@ -18,6 +26,24 @@ export default function ForumView() {
     const [title, setTitle] = useState('')
     const [body, setBody] = useState('')
     const [saving, setSaving] = useState(false)
+    const [threadFiles, setThreadFiles] = useState([])
+    const [uploading, setUploading] = useState(false)
+    const [allowedAttachmentExtensions, setAllowedAttachmentExtensions] = useState([])
+    const [attachmentValidationError, setAttachmentValidationError] = useState('')
+    const [threadDropActive, setThreadDropActive] = useState(false)
+    const [showPreview, setShowPreview] = useState(false)
+    const [previewHtml, setPreviewHtml] = useState('')
+    const [previewLoading, setPreviewLoading] = useState(false)
+    const [previewUrls, setPreviewUrls] = useState([])
+    const [attachmentTab, setAttachmentTab] = useState('options')
+    const [attachmentOptions, setAttachmentOptions] = useState({
+        disableBbcode: false,
+        disableSmilies: false,
+        disableAutoUrls: false,
+        attachSignature: true,
+        notifyReplies: false,
+        lockTopic: false,
+    })
     const { t } = useTranslation()
 
     const renderChildRows = (nodes) =>
@@ -178,24 +204,388 @@ export default function ForumView() {
         }
     }, [id])
 
+    useEffect(() => {
+        listAttachmentExtensionsPublic()
+            .then((data) => {
+                if (Array.isArray(data)) {
+                    setAllowedAttachmentExtensions(data.map((item) => String(item).toLowerCase()))
+                }
+            })
+            .catch(() => {})
+    }, [])
+
     const handleSubmit = async (event) => {
         event.preventDefault()
         setSaving(true)
         setError('')
         try {
-            await createThread({ title, body, forumId: id })
+            const created = await createThread({ title, body, forumId: id })
+            if (threadFiles.length > 0 && created?.id) {
+                setUploading(true)
+                for (const entry of threadFiles) {
+                    await uploadAttachment({ threadId: created.id, file: entry.file })
+                }
+            }
             setTitle('')
             setBody('')
+            setThreadFiles([])
             const updated = await listThreadsByForum(id)
             setThreads(updated)
             setShowModal(false)
         } catch (err) {
             setError(err.message)
         } finally {
+            setUploading(false)
             setSaving(false)
         }
     }
 
+    const formatBytes = (bytes) => {
+        if (!bytes && bytes !== 0) return ''
+        if (bytes < 1024) return `${bytes} B`
+        const kb = bytes / 1024
+        if (kb < 1024) return `${kb.toFixed(1)} KB`
+        const mb = kb / 1024
+        return `${mb.toFixed(1)} MB`
+    }
+
+    const handleInlineInsert = (entry) => {
+        const marker = `[attachment]${entry.file.name}[/attachment]`
+        setBody((prev) => (prev ? `${prev}\n${marker}` : marker))
+    }
+
+    const clearPreviewUrls = () => {
+        previewUrls.forEach((url) => URL.revokeObjectURL(url))
+        setPreviewUrls([])
+    }
+
+    const buildPreviewBody = (rawBody, entries) => {
+        if (!entries || entries.length === 0) {
+            return { body: rawBody, urls: [] }
+        }
+
+        const urls = []
+        const map = new Map()
+        entries.forEach((entry) => {
+            const file = entry.file
+            if (!file) return
+            const url = URL.createObjectURL(file)
+            urls.push(url)
+            map.set(String(file.name || '').toLowerCase(), { url, mime: file.type || '' })
+        })
+
+        const replaced = rawBody.replace(/\[attachment\](.+?)\[\/attachment\]/gi, (match, name) => {
+            const key = String(name || '').trim().toLowerCase()
+            if (!map.has(key)) return match
+            const { url, mime } = map.get(key)
+            if (mime.startsWith('image/')) {
+                return `[img]${url}[/img]`
+            }
+            return `[url=${url}]${name}[/url]`
+        })
+
+        return { body: replaced, urls }
+    }
+
+    const handlePreview = async () => {
+        setPreviewLoading(true)
+        setError('')
+        try {
+            clearPreviewUrls()
+            const { body: previewBody, urls } = buildPreviewBody(body || '', threadFiles)
+            const result = await previewBbcode(previewBody || '')
+            setPreviewHtml(result?.html || '')
+            setShowPreview(true)
+            setPreviewUrls(urls)
+        } catch (err) {
+            setError(err.message)
+        } finally {
+            setPreviewLoading(false)
+        }
+    }
+
+    const applyThreadFiles = (files) => {
+        const fileList = Array.from(files || [])
+        const allowed = allowedAttachmentExtensions
+        const rejected = []
+        const accepted = fileList.filter((file) => {
+            const ext = file.name.split('.').pop()?.toLowerCase() || ''
+            if (!ext || (allowed.length > 0 && !allowed.includes(ext))) {
+                rejected.push(file.name)
+                return false
+            }
+            return true
+        })
+
+        if (rejected.length > 0) {
+            setAttachmentValidationError(
+                t('attachment.invalid_extensions', { names: rejected.join(', ') })
+            )
+        } else {
+            setAttachmentValidationError('')
+        }
+
+        setThreadFiles(
+            accepted.map((file) => ({
+                id: `${file.name}-${file.lastModified}`,
+                file,
+                comment: '',
+            }))
+        )
+        setAttachmentTab('attachments')
+    }
+
+    const appendThreadFiles = (files) => {
+        const fileList = Array.from(files || [])
+        const allowed = allowedAttachmentExtensions
+        const rejected = []
+        const accepted = fileList.filter((file) => {
+            const ext = file.name.split('.').pop()?.toLowerCase() || ''
+            if (!ext || (allowed.length > 0 && !allowed.includes(ext))) {
+                rejected.push(file.name)
+                return false
+            }
+            return true
+        })
+
+        if (rejected.length > 0) {
+            setAttachmentValidationError(
+                t('attachment.invalid_extensions', { names: rejected.join(', ') })
+            )
+        } else if (accepted.length > 0) {
+            setAttachmentValidationError('')
+        }
+
+        if (accepted.length === 0) return
+        setThreadFiles((prev) => [
+            ...prev,
+            ...accepted.map((file) => ({
+                id: `${file.name}-${file.lastModified}`,
+                file,
+                comment: '',
+            })),
+        ])
+        setAttachmentTab('attachments')
+    }
+
+    const handleThreadPaste = (event) => {
+        const items = Array.from(event.clipboardData?.items || [])
+        if (items.length === 0) return
+        const imageItems = items.filter((item) => item.type?.startsWith('image/'))
+        if (imageItems.length === 0) return
+        event.preventDefault()
+        const files = imageItems
+            .map((item) => item.getAsFile())
+            .filter(Boolean)
+            .map((file) => {
+                const ext = file.type?.split('/')[1] || 'png'
+                const name = `pasted-${Date.now()}-${Math.floor(Math.random() * 1000)}.${ext}`
+                return new File([file], name, { type: file.type })
+            })
+        appendThreadFiles(files)
+        if (files.length > 0) {
+            const marker = `[attachment]${files[0].name}[/attachment]`
+            setBody((prev) => (prev ? `${prev}\n${marker}` : marker))
+        }
+    }
+
+    const renderAttachmentFooter = () => (
+        <div className="bb-attachment-panel">
+            <div className="bb-attachment-tabs">
+                <button
+                    type="button"
+                    className={`bb-attachment-tab ${attachmentTab === 'options' ? 'is-active' : ''}`}
+                    onClick={() => setAttachmentTab('options')}
+                >
+                    {t('attachment.tab_options')}
+                </button>
+                <button
+                    type="button"
+                    className={`bb-attachment-tab ${attachmentTab === 'attachments' ? 'is-active' : ''}`}
+                    onClick={() => setAttachmentTab('attachments')}
+                >
+                    {t('attachment.tab_attachments')}
+                </button>
+            </div>
+            <div className="bb-attachment-body">
+                {attachmentTab === 'options' && (
+                    <div className="bb-attachment-options">
+                        <Form.Check
+                            type="checkbox"
+                            id="bb-option-disable-bbcode"
+                            label={t('attachment.option_disable_bbcode')}
+                            checked={attachmentOptions.disableBbcode}
+                            onChange={(event) =>
+                                setAttachmentOptions((prev) => ({
+                                    ...prev,
+                                    disableBbcode: event.target.checked,
+                                }))
+                            }
+                        />
+                        <Form.Check
+                            type="checkbox"
+                            id="bb-option-disable-smilies"
+                            label={t('attachment.option_disable_smilies')}
+                            checked={attachmentOptions.disableSmilies}
+                            onChange={(event) =>
+                                setAttachmentOptions((prev) => ({
+                                    ...prev,
+                                    disableSmilies: event.target.checked,
+                                }))
+                            }
+                        />
+                        <Form.Check
+                            type="checkbox"
+                            id="bb-option-disable-auto-urls"
+                            label={t('attachment.option_disable_auto_urls')}
+                            checked={attachmentOptions.disableAutoUrls}
+                            onChange={(event) =>
+                                setAttachmentOptions((prev) => ({
+                                    ...prev,
+                                    disableAutoUrls: event.target.checked,
+                                }))
+                            }
+                        />
+                        <Form.Check
+                            type="checkbox"
+                            id="bb-option-attach-signature"
+                            label={t('attachment.option_attach_signature')}
+                            checked={attachmentOptions.attachSignature}
+                            onChange={(event) =>
+                                setAttachmentOptions((prev) => ({
+                                    ...prev,
+                                    attachSignature: event.target.checked,
+                                }))
+                            }
+                        />
+                        <Form.Check
+                            type="checkbox"
+                            id="bb-option-notify-replies"
+                            label={t('attachment.option_notify_replies')}
+                            checked={attachmentOptions.notifyReplies}
+                            onChange={(event) =>
+                                setAttachmentOptions((prev) => ({
+                                    ...prev,
+                                    notifyReplies: event.target.checked,
+                                }))
+                            }
+                        />
+                        <Form.Check
+                            type="checkbox"
+                            id="bb-option-lock-topic"
+                            label={t('attachment.option_lock_topic')}
+                            checked={attachmentOptions.lockTopic}
+                            onChange={(event) =>
+                                setAttachmentOptions((prev) => ({
+                                    ...prev,
+                                    lockTopic: event.target.checked,
+                                }))
+                            }
+                        />
+                    </div>
+                )}
+                {attachmentTab === 'attachments' && (
+                    <>
+                        <p className="bb-muted mb-2">
+                            {t('attachment.hint')}
+                        </p>
+                        <p className="bb-muted mb-3">
+                            {t('attachment.max_size', { size: '25 MB' })}
+                        </p>
+                        <div className="bb-attachment-actions">
+                            <Button
+                                type="button"
+                                size="sm"
+                                variant="outline-secondary"
+                                onClick={() => document.getElementById('bb-thread-attachment-input')?.click()}
+                            >
+                                {t('attachment.add_files')}
+                            </Button>
+                        </div>
+                        {attachmentValidationError && (
+                            <p className="text-danger mb-2">{attachmentValidationError}</p>
+                        )}
+                        <table className="table bb-attachment-table">
+                            <thead className="tr-header">
+                                <tr>
+                                    <th scope="col" className="text-start">{t('attachment.filename')}</th>
+                                    <th scope="col" className="text-start">{t('attachment.file_comment')}</th>
+                                    <th scope="col" className="text-start">{t('attachment.size')}</th>
+                                    <th scope="col" className="text-start">{t('attachment.status')}</th>
+                                    <th scope="col" className="text-start">{t('attachment.actions')}</th>
+                                </tr>
+                            </thead>
+                            <tbody>
+                                {threadFiles.length === 0 && (
+                                    <tr>
+                                        <td colSpan={5} className="bb-attachment-empty">
+                                            {t('attachment.empty')}
+                                        </td>
+                                    </tr>
+                                )}
+                                {threadFiles.map((entry) => (
+                                    <tr key={entry.id} className="bb-attachment-row">
+                                        <td className="bb-attachment-name text-start" style={{ color: 'var(--bb-accent)' }}>
+                                            {entry.file.name}
+                                        </td>
+                                        <td className="bb-attachment-cell-comment">
+                                            <Form.Control
+                                                className="bb-attachment-comment"
+                                                value={entry.comment}
+                                                onChange={(event) =>
+                                                    setThreadFiles((prev) =>
+                                                        prev.map((item) =>
+                                                            item.id === entry.id
+                                                                ? { ...item, comment: event.target.value }
+                                                                : item
+                                                        )
+                                                    )
+                                                }
+                                                placeholder={t('attachment.file_comment_placeholder')}
+                                            />
+                                        </td>
+                                        <td className="bb-attachment-size text-start" style={{ color: 'var(--bb-accent)' }}>
+                                            {formatBytes(entry.file.size)}
+                                        </td>
+                                        <td className="bb-attachment-status text-center">
+                                            <i className="bi bi-check-circle-fill text-success" aria-hidden="true" />
+                                        </td>
+                                        <td>
+                                            <div className="bb-attachment-row-actions">
+                                                <button
+                                                    type="button"
+                                                    className="bb-attachment-action"
+                                                    onClick={() => handleInlineInsert(entry)}
+                                                    title={t('attachment.place_inline')}
+                                                    aria-label={t('attachment.place_inline')}
+                                                >
+                                                    <i className="bi bi-paperclip" aria-hidden="true" />
+                                                </button>
+                                                <button
+                                                    type="button"
+                                                    className="bb-attachment-action"
+                                                    onClick={() =>
+                                                        setThreadFiles((prev) =>
+                                                            prev.filter((item) => item.id !== entry.id)
+                                                        )
+                                                    }
+                                                    title={t('attachment.delete_file')}
+                                                    aria-label={t('attachment.delete_file')}
+                                                >
+                                                    <i className="bi bi-trash" aria-hidden="true" />
+                                                </button>
+                                            </div>
+                                        </td>
+                                    </tr>
+                                ))}
+                            </tbody>
+                        </table>
+                    </>
+                )}
+            </div>
+        </div>
+    )
+
     return (
         <Container fluid className="py-5 bb-shell-container">
             {loading && <p className="bb-muted">{t('forum.loading')}</p>}
@@ -258,7 +648,7 @@ export default function ForumView() {
                                     </div>
                                     {!token && <p className="bb-muted mb-3">{t('forum.login_hint')}</p>}
                                     <div className="bb-portal-topic-table">
-                                        <div className="bb-portal-topic-header">
+                                        <div className="bb-portal-topic-header tr-header">
                                             <span>{t('portal.topic')}</span>
                                             <span>{t('thread.replies')}</span>
                                             <span>{t('thread.views')}</span>
@@ -284,13 +674,19 @@ export default function ForumView() {
                 </>
             )}
             {forum?.type === 'forum' && (
-                <Modal show={showModal} onHide={() => setShowModal(false)} centered size="lg">
+                <Modal
+                    show={showModal}
+                    onHide={() => setShowModal(false)}
+                    centered
+                    size="lg"
+                    dialogClassName="bb-thread-modal"
+                >
                     <Modal.Header closeButton>
                         <Modal.Title>{t('forum.start_thread')}</Modal.Title>
                     </Modal.Header>
-                    <Modal.Body>
+                    <Modal.Body className="d-flex flex-column p-0">
                         {!token && <p className="bb-muted mb-3">{t('forum.login_hint')}</p>}
-                        <Form onSubmit={handleSubmit}>
+                        <Form onSubmit={handleSubmit} className="d-flex flex-column flex-grow-1 px-3 pb-3 pt-2">
                             <Form.Group className="mb-3">
                                 <Form.Label>{t('form.title')}</Form.Label>
                                 <Form.Control
@@ -302,30 +698,113 @@ export default function ForumView() {
                                     required
                                 />
                             </Form.Group>
-                            <Form.Group className="mb-3">
+                            <Form.Group className="mb-3 d-flex flex-column flex-grow-1">
                                 <Form.Label>{t('form.body')}</Form.Label>
                                 <Form.Control
                                     as="textarea"
                                     rows={6}
+                                    className="flex-grow-1"
                                     placeholder={t('form.thread_body_placeholder')}
                                     value={body}
                                     onChange={(event) => setBody(event.target.value)}
+                                    onPaste={handleThreadPaste}
                                     disabled={!token || saving}
                                     required
                                 />
                             </Form.Group>
-                            <div className="d-flex gap-2 justify-content-between">
+                            <Form.Control
+                                id="bb-thread-attachment-input"
+                                type="file"
+                                multiple
+                                className="bb-attachment-input"
+                                disabled={!token || saving || uploading}
+                                onChange={(event) => {
+                                    applyThreadFiles(event.target.files)
+                                    event.target.value = ''
+                                }}
+                            />
+                            <div
+                                className={`bb-attachment-drop ${threadDropActive ? 'is-dragover' : ''}`}
+                                role="button"
+                                tabIndex={0}
+                                onClick={() => document.getElementById('bb-thread-attachment-input')?.click()}
+                                onKeyDown={(event) => {
+                                    if (event.key === 'Enter' || event.key === ' ') {
+                                        event.preventDefault()
+                                        document.getElementById('bb-thread-attachment-input')?.click()
+                                    }
+                                }}
+                                onDragOver={(event) => {
+                                    event.preventDefault()
+                                    setThreadDropActive(true)
+                                }}
+                                onDragLeave={() => setThreadDropActive(false)}
+                                onDrop={(event) => {
+                                    event.preventDefault()
+                                    setThreadDropActive(false)
+                                    applyThreadFiles(event.dataTransfer.files)
+                                }}
+                            >
+                                <span>
+                                    {t('attachment.drop_hint')}{' '}
+                                    <button
+                                        type="button"
+                                        className="bb-attachment-drop-link"
+                                        onClick={(event) => {
+                                            event.stopPropagation()
+                                            document.getElementById('bb-thread-attachment-input')?.click()
+                                        }}
+                                    >
+                                        {t('attachment.drop_browse')}
+                                    </button>
+                                </span>
+                            </div>
+                            {renderAttachmentFooter()}
+                            <Modal.Footer className="d-flex gap-2 justify-content-between mt-auto pt-2 px-0 border-0 mb-0 pb-0">
                                 <Button type="button" variant="outline-secondary" onClick={() => setShowModal(false)}>
                                     {t('acp.cancel')}
                                 </Button>
-                                <Button type="submit" className="bb-accent-button" disabled={!token || saving}>
+                                <div className="d-flex gap-2">
-                                    {saving ? t('form.posting') : t('form.create_thread')}
+                                    <Button
-                                </Button>
+                                        type="button"
-                            </div>
+                                        variant="outline-secondary"
+                                        onClick={handlePreview}
+                                        disabled={!token || saving || uploading || previewLoading}
+                                    >
+                                        {t('form.preview')}
+                                    </Button>
+                                    <Button
+                                        type="submit"
+                                        className="bb-accent-button"
+                                        disabled={!token || saving || uploading}
+                                    >
+                                        {saving || uploading ? t('form.posting') : t('form.create_thread')}
+                                    </Button>
+                                </div>
+                            </Modal.Footer>
                         </Form>
                     </Modal.Body>
                 </Modal>
             )}
+            <Modal
+                show={showPreview}
+                onHide={() => {
+                    setShowPreview(false)
+                    clearPreviewUrls()
+                }}
+                centered
+                size="lg"
+            >
+                <Modal.Header closeButton>
+                    <Modal.Title>{t('form.preview')}</Modal.Title>
+                </Modal.Header>
+                <Modal.Body>
+                    <div
+                        className="bb-post-body"
+                        dangerouslySetInnerHTML={{ __html: previewHtml || '' }}
+                    />
+                </Modal.Body>
+            </Modal>
         </Container>
     )
 }

resources/js/pages/Home.jsx

@@ -235,7 +235,7 @@ export default function Home() {
                         )}
                         {!loadingThreads && recentThreads.length > 0 && (
                             <div className="bb-portal-topic-table">
-                                <div className="bb-portal-topic-header">
+                                <div className="bb-portal-topic-header tr-header">
                                     <span>{t('portal.topic')}</span>
                                     <span>{t('thread.replies')}</span>
                                     <span>{t('thread.views')}</span>

resources/lang/de.json

@@ -46,10 +46,21 @@
   "acp.add_forum": "Forum hinzufügen",
   "acp.ranks": "Ränge",
   "acp.groups": "Gruppen",
+  "acp.attachments": "Anh\u00e4nge",
   "acp.forums_parent_root": "Wurzel (kein Parent)",
   "acp.forums_tree": "Forenbaum",
   "acp.forums_type": "Typ",
   "acp.general": "Allgemein",
+  "acp.quick_access": "Schnellzugriff",
+  "acp.board_configuration": "Board-Konfiguration",
+  "acp.client_communication": "Client-Kommunikation",
+  "acp.server_configuration": "Server-Konfiguration",
+  "acp.authentication": "Authentifizierung",
+  "acp.email_settings": "E-Mail-Einstellungen",
+  "acp.security_settings": "Sicherheitseinstellungen",
+  "acp.search_settings": "Sucheinstellungen",
+  "acp.welcome_title": "Willkommen bei speedBB",
+  "acp.general_settings": "Allgemeine Einstellungen",
   "acp.general_hint": "Globale Einstellungen und Board-Konfiguration erscheinen hier.",
   "acp.loading": "Laden...",
   "acp.new_category": "Neue Kategorie",
@@ -58,8 +69,14 @@
   "acp.refresh": "Aktualisieren",
   "acp.reset": "Zurücksetzen",
   "acp.save": "Speichern",
+  "acp.statistics": "Statistik",
   "acp.title": "Administrationsbereich",
   "acp.users": "Benutzer",
+  "acp.audit_logs": "Audit-Log",
+  "acp.system": "System",
+  "acp.admin_log_title": "Administrator-Aktionen",
+  "acp.admin_log_hint": "Uebersicht der letzten Administrator-Aktionen. Vollstaendiges Log unten.",
+  "acp.view_admin_log": "Administrator-Log anzeigen",
   "auth.login_hint": "Melde dich an, um neue Threads zu starten und zu antworten.",
   "auth.login_title": "Anmelden",
   "auth.login_identifier": "E-Mail oder Benutzername",
@@ -77,6 +94,9 @@
   "form.password": "Passwort",
   "form.post_reply": "Antwort posten",
   "form.posting": "Wird gesendet...",
+  "form.preview": "Vorschau",
+  "form.upload": "Hochladen",
+  "form.uploading": "Wird hochgeladen...",
   "form.registering": "Registrierung läuft...",
   "form.reply_placeholder": "Schreibe deine Antwort.",
   "form.sign_in": "Anmelden",
@@ -86,6 +106,18 @@
   "form.thread_title_placeholder": "Thema",
   "form.title": "Titel",
   "form.username": "Benutzername",
+  "thread.title": "Titel",
+  "thread.edit": "Bearbeiten",
+  "thread.delete": "Löschen",
+  "thread.quote": "Zitieren",
+  "thread.delete_confirm": "Diesen Thread löschen?",
+  "thread.delete_post_confirm": "Diesen Beitrag löschen?",
+  "thread.delete_reason": "Loeschgrund",
+  "thread.delete_reason_obsolete": "Obsolet",
+  "thread.delete_reason_double": "Doppelpost",
+  "thread.delete_reason_other": "Andere",
+  "thread.delete_reason_other_label": "Begruendung",
+  "thread.delete_reason_other_placeholder": "Kurze Begruendung...",
   "forum.children": "Unterforen",
   "forum.empty_children": "Noch keine Unterforen vorhanden.",
   "forum.empty_threads": "Noch keine Threads vorhanden. Starte unten einen.",
@@ -104,6 +136,64 @@
   "user.email": "E-Mail",
   "user.rank": "Rang",
   "user.rank_unassigned": "Nicht zugewiesen",
+  "audit.user": "Benutzer",
+  "audit.action": "Aktion",
+  "audit.subject": "Objekt",
+  "audit.ip": "IP",
+  "audit.created_at": "Zeitpunkt",
+  "audit.search": "Audit-Logs durchsuchen...",
+  "audit.empty": "Noch keine Audit-Einträge.",
+  "admin_log.username": "Benutzername",
+  "admin_log.user_ip": "Benutzer-IP",
+  "admin_log.time": "Zeit",
+  "admin_log.action": "Aktion",
+  "admin_log.empty": "Noch keine Administrator-Aktionen.",
+  "stats.statistic": "Statistik",
+  "stats.value": "Wert",
+  "stats.board_started": "Board gestartet",
+  "stats.avatar_directory_size": "Avatar-Verzeichnisgröße",
+  "stats.database_size": "Datenbankgröße",
+  "stats.attachments_size": "Groesse der Anhänge",
+  "stats.database_server": "Datenbankserver",
+  "stats.gzip_compression": "GZip-Kompression",
+  "stats.php_version": "PHP-Version",
+  "stats.orphan_attachments": "Verwaiste Anhänge",
+  "stats.board_version": "Board-Version",
+  "stats.posts": "Anzahl der Beiträge",
+  "stats.posts_per_day": "Beiträge pro Tag",
+  "stats.topics": "Anzahl der Themen",
+  "stats.topics_per_day": "Themen pro Tag",
+  "stats.users": "Anzahl der Benutzer",
+  "stats.users_per_day": "Benutzer pro Tag",
+  "stats.attachments": "Anzahl der Anhänge",
+  "stats.attachments_per_day": "Anhänge pro Tag",
+  "stats.on": "An",
+  "stats.off": "Aus",
+  "version.recheck": "Version prüfen",
+  "version.checking": "Prüfe…",
+  "version.up_to_date": "Aktuell",
+  "version.update_available": "Update verfügbar (v{{version}})",
+  "version.update_available_short": "Update verfügbar",
+  "version.unknown": "Version unbekannt",
+  "version.update_now": "Jetzt aktualisieren",
+  "version.update_title": "System aktualisieren",
+  "version.update_hint": "Letzte Version herunterladen, installieren, Migrationen ausführen und Assets neu bauen.",
+  "version.updating": "Aktualisiere…",
+  "system.requirements": "Systemanforderungen",
+  "system.check": "Prüfung",
+  "system.path": "Pfad",
+  "system.min_version": "Mindestversion",
+  "system.current_version": "Aktuelle Version",
+  "system.status": "Status",
+  "system.recheck": "Neu prüfen",
+  "system.none": "Keine",
+  "system.not_found": "Nicht gefunden",
+  "system.storage_writable": "Storage beschreibbar",
+  "system.updates_writable": "Updates beschreibbar",
+  "system.ok": "OK",
+  "system.not_ok": "Nicht OK",
+  "lightbox.prev": "Vorheriges Bild",
+  "lightbox.next": "Nächstes Bild",
   "user.edit_title": "Benutzer bearbeiten",
   "user.search": "Benutzer suchen...",
   "rank.name": "Rangname",
@@ -212,6 +302,69 @@
   "ucp.accent_override": "Akzentfarbe überschreiben",
   "ucp.accent_override_hint": "Wähle eine eigene Akzentfarbe für die Oberfläche.",
   "ucp.custom_color": "Eigene Farbe",
+  "attachment.groups_title": "Anhanggruppen",
+  "attachment.settings_title": "Anhang-Einstellungen",
+  "attachment.display_images_inline": "Bilder inline anzeigen",
+  "attachment.create_thumbnails": "Vorschaubilder erstellen",
+  "attachment.thumbnail_max_width": "Maximale Vorschaubreite (px)",
+  "attachment.thumbnail_max_height": "Maximale Vorschaubildhöhe (px)",
+  "attachment.thumbnail_quality": "Vorschaubild-Qualität (JPEG/WebP)",
+  "attachment.group_create": "Neue Anhanggruppe",
+  "attachment.group_create_title": "Anhanggruppe erstellen",
+  "attachment.group_edit_title": "Anhanggruppe bearbeiten",
+  "attachment.group_empty": "Noch keine Anhanggruppen.",
+  "attachment.seed_defaults": "Standard-Anhangset erstellen",
+  "attachment.seed_in_progress": "Standardwerte werden erstellt...",
+  "attachment.seed_hint": "Fügt eine Media- und Files-Struktur mit üblichen Endungen hinzu.",
+  "attachment.group_extensions": "{{count}} Endungen",
+  "attachment.group_delete_confirm": "Diese Anhanggruppe l\u00f6schen?",
+  "attachment.group_name": "Name",
+  "attachment.group_parent": "\u00dcbergeordnete Gruppe",
+  "attachment.group_parent_none": "Keine",
+  "attachment.group_max_size": "Max. Gr\u00f6\u00dfe (KB)",
+  "attachment.group_max_size_hint": "Standard 25600 KB (25 MB).",
+  "attachment.group_active": "Aktiv",
+  "attachment.group_add_child": "Untergruppe hinzuf\u00fcgen",
+  "attachment.group_auto_nest": "Standardgruppen automatisch verschachteln",
+  "attachment.group_auto_nest_hint": "Erstellt Media- und Files-Eltern und ordnet die Standardgruppen darunter ein.",
+  "attachment.extensions_title": "Dateiendungen verwalten",
+  "attachment.extension_placeholder": "Endung hinzuf\u00fcgen (z. B. pdf)",
+  "attachment.extension_mimes_placeholder": "Erlaubte MIME-Typen (kommagetrennt)",
+  "attachment.extension_unassigned": "Nicht zugewiesen",
+  "attachment.extension_add": "Endung hinzuf\u00fcgen",
+  "attachment.extension_edit": "Endung bearbeiten",
+  "attachment.extension_add_button": "Endung hinzuf\u00fcgen",
+  "attachment.extension_empty": "Noch keine Endungen.",
+  "attachment.extension": "Endung",
+  "attachment.extension_group": "Endungsgruppe",
+  "attachment.extension_delete_confirm": "Diese Endung l\u00f6schen?",
+  "attachment.actions": "Aktionen",
+  "attachment.allowed_mimes": "MIME-Typen:",
+  "attachment.active": "Aktiv",
+  "attachment.inactive": "Inaktiv",
+  "attachment.tab_options": "Optionen",
+  "attachment.tab_attachments": "Anh\u00e4nge",
+  "attachment.hint": "Wenn du Dateien anh\u00e4ngen m\u00f6chtest, f\u00fcge sie unten hinzu.",
+  "attachment.max_size": "Maximale Dateigr\u00f6\u00dfe pro Anhang: {{size}}.",
+  "attachment.add_files": "Dateien hinzuf\u00fcgen",
+  "attachment.drop_hint": "Sie k\u00f6nnen Dateien zum Hochladen hier hineinziehen oder",
+  "attachment.drop_browse": "Durchsuchen",
+  "attachment.filename": "Dateiname",
+  "attachment.size": "Gr\u00f6\u00dfe",
+  "attachment.status": "Status",
+  "attachment.empty": "Noch keine Dateien hinzugef\u00fcgt.",
+  "attachment.remove": "Datei entfernen",
+  "attachment.file_comment": "Dateikommentar",
+  "attachment.file_comment_placeholder": "Kommentar (optional)",
+  "attachment.place_inline": "Inline platzieren",
+  "attachment.delete_file": "Datei l\u00f6schen",
+  "attachment.option_disable_bbcode": "BBCode deaktivieren",
+  "attachment.option_disable_smilies": "Smileys deaktivieren",
+  "attachment.option_disable_auto_urls": "URLs nicht automatisch verlinken",
+  "attachment.option_attach_signature": "Signatur anh\u00e4ngen (über die UCP \u00e4nderbar)",
+  "attachment.option_notify_replies": "Bei Antworten benachrichtigen",
+  "attachment.option_lock_topic": "Thema sperren",
+  "attachment.invalid_extensions": "Nicht erlaubt: {{names}}.",
   "thread.anonymous": "Anonym",
   "thread.back_to_category": "Zurück zum Forum",
   "thread.category": "Forum:",
@@ -227,6 +380,11 @@
   "thread.reply_prefix": "Aw:",
   "thread.registered": "Registriert",
   "thread.replies": "Antworten",
+  "thread.solved": "Gel\u00f6st",
+  "thread.mark_solved": "Als gel\u00f6st markieren",
+  "thread.mark_unsolved": "Als ungel\u00f6st markieren",
+  "thread.attachments": "Anh\u00e4nge",
+  "thread.attach_files": "Dateien anh\u00e4ngen",
   "thread.views": "Zugriffe",
   "thread.last_post": "Letzter Beitrag",
   "thread.by": "von",

resources/lang/en.json

@@ -46,10 +46,21 @@
   "acp.add_forum": "Add forum",
   "acp.ranks": "Ranks",
   "acp.groups": "Groups",
+  "acp.attachments": "Attachments",
   "acp.forums_parent_root": "Root (no parent)",
   "acp.forums_tree": "Forum tree",
   "acp.forums_type": "Type",
   "acp.general": "General",
+  "acp.quick_access": "Quick access",
+  "acp.board_configuration": "Board configuration",
+  "acp.client_communication": "Client communication",
+  "acp.server_configuration": "Server configuration",
+  "acp.authentication": "Authentication",
+  "acp.email_settings": "Email settings",
+  "acp.security_settings": "Security settings",
+  "acp.search_settings": "Search settings",
+  "acp.welcome_title": "Welcome to speedBB",
+  "acp.general_settings": "General settings",
   "acp.general_hint": "Global settings and board configuration will appear here.",
   "acp.loading": "Loading...",
   "acp.new_category": "New category",
@@ -58,8 +69,14 @@
   "acp.refresh": "Refresh",
   "acp.reset": "Reset",
   "acp.save": "Save",
+  "acp.statistics": "Statistics",
   "acp.title": "Admin control panel",
   "acp.users": "Users",
+  "acp.audit_logs": "Audit log",
+  "acp.system": "System",
+  "acp.admin_log_title": "Logged administrator actions",
+  "acp.admin_log_hint": "Overview of the latest administrator actions. Full log is available below.",
+  "acp.view_admin_log": "View administrator log",
   "auth.login_hint": "Access your account to start new threads and reply.",
   "auth.login_title": "Log in",
   "auth.login_identifier": "Email or username",
@@ -77,6 +94,9 @@
   "form.password": "Password",
   "form.post_reply": "Post reply",
   "form.posting": "Posting...",
+  "form.preview": "Preview",
+  "form.upload": "Upload",
+  "form.uploading": "Uploading...",
   "form.registering": "Registering...",
   "form.reply_placeholder": "Share your reply.",
   "form.sign_in": "Sign in",
@@ -86,6 +106,18 @@
   "form.thread_title_placeholder": "Topic headline",
   "form.title": "Title",
   "form.username": "Username",
+  "thread.title": "Title",
+  "thread.edit": "Edit",
+  "thread.delete": "Delete",
+  "thread.quote": "Quote",
+  "thread.delete_confirm": "Delete this thread?",
+  "thread.delete_post_confirm": "Delete this post?",
+  "thread.delete_reason": "Delete reason",
+  "thread.delete_reason_obsolete": "Obsolete",
+  "thread.delete_reason_double": "Double post",
+  "thread.delete_reason_other": "Other",
+  "thread.delete_reason_other_label": "Reason details",
+  "thread.delete_reason_other_placeholder": "Add a short reason...",
   "forum.children": "Sub-forums",
   "forum.empty_children": "No sub-forums yet.",
   "forum.empty_threads": "No threads here yet. Start one below.",
@@ -106,6 +138,64 @@
   "user.rank_unassigned": "Unassigned",
   "user.edit_title": "Edit user",
   "user.search": "Search users...",
+  "stats.statistic": "Statistic",
+  "stats.value": "Value",
+  "stats.board_started": "Board started",
+  "stats.avatar_directory_size": "Avatar directory size",
+  "stats.database_size": "Database size",
+  "stats.attachments_size": "Size of posted attachments",
+  "stats.database_server": "Database server",
+  "stats.gzip_compression": "GZip compression",
+  "stats.php_version": "PHP version",
+  "stats.orphan_attachments": "Orphan attachments",
+  "stats.board_version": "Board version",
+  "stats.posts": "Number of posts",
+  "stats.posts_per_day": "Posts per day",
+  "stats.topics": "Number of topics",
+  "stats.topics_per_day": "Topics per day",
+  "stats.users": "Number of users",
+  "stats.users_per_day": "Users per day",
+  "stats.attachments": "Number of attachments",
+  "stats.attachments_per_day": "Attachments per day",
+  "stats.on": "On",
+  "stats.off": "Off",
+  "version.recheck": "Re-check version",
+  "version.checking": "Checking…",
+  "version.up_to_date": "Up to date",
+  "version.update_available": "Update available (v{{version}})",
+  "version.update_available_short": "Update available",
+  "version.unknown": "Version unknown",
+  "version.update_now": "Update now",
+  "version.update_title": "Update system",
+  "version.update_hint": "Download and install the latest release, then run migrations and rebuild assets.",
+  "version.updating": "Updating…",
+  "system.requirements": "System requirements",
+  "system.check": "Check",
+  "system.path": "Path",
+  "system.min_version": "Min version",
+  "system.current_version": "Current version",
+  "system.status": "Status",
+  "system.recheck": "Re-check",
+  "system.none": "None",
+  "system.not_found": "Not found",
+  "system.storage_writable": "Storage writable",
+  "system.updates_writable": "Updates writable",
+  "system.ok": "OK",
+  "system.not_ok": "Not OK",
+  "lightbox.prev": "Previous image",
+  "lightbox.next": "Next image",
+  "audit.user": "User",
+  "audit.action": "Action",
+  "audit.subject": "Subject",
+  "audit.ip": "IP",
+  "audit.created_at": "When",
+  "audit.search": "Search audit logs...",
+  "audit.empty": "No audit events yet.",
+  "admin_log.username": "Username",
+  "admin_log.user_ip": "User IP",
+  "admin_log.time": "Time",
+  "admin_log.action": "Action",
+  "admin_log.empty": "No administrator actions logged yet.",
   "rank.name": "Rank name",
   "rank.name_placeholder": "e.g. Operator",
   "rank.create": "Create rank",
@@ -212,6 +302,69 @@
   "ucp.accent_override": "Accent color override",
   "ucp.accent_override_hint": "Choose a custom accent color for your UI.",
   "ucp.custom_color": "Custom color",
+  "attachment.groups_title": "Attachment groups",
+  "attachment.settings_title": "Attachment settings",
+  "attachment.display_images_inline": "Display images inline",
+  "attachment.create_thumbnails": "Create thumbnails",
+  "attachment.thumbnail_max_width": "Maximum thumbnail width (px)",
+  "attachment.thumbnail_max_height": "Maximum thumbnail height (px)",
+  "attachment.thumbnail_quality": "Thumbnail quality (JPEG/WebP)",
+  "attachment.group_create": "New attachment group",
+  "attachment.group_create_title": "Create attachment group",
+  "attachment.group_edit_title": "Edit attachment group",
+  "attachment.group_empty": "No attachment groups yet.",
+  "attachment.seed_defaults": "Create default attachment set",
+  "attachment.seed_in_progress": "Creating defaults...",
+  "attachment.seed_hint": "Adds a Media and Files hierarchy with common extensions.",
+  "attachment.group_extensions": "{{count}} extensions",
+  "attachment.group_delete_confirm": "Delete this attachment group?",
+  "attachment.group_name": "Name",
+  "attachment.group_parent": "Parent group",
+  "attachment.group_parent_none": "No parent",
+  "attachment.group_max_size": "Max size (KB)",
+  "attachment.group_max_size_hint": "Default 25600 KB (25 MB).",
+  "attachment.group_active": "Active",
+  "attachment.group_add_child": "Add child group",
+  "attachment.group_auto_nest": "Auto-nest default groups",
+  "attachment.group_auto_nest_hint": "Creates Media and Files parents and nests the default groups underneath.",
+  "attachment.extensions_title": "Manage attachment extensions",
+  "attachment.extension_placeholder": "Add extension (e.g. pdf)",
+  "attachment.extension_mimes_placeholder": "Allowed MIME types (comma-separated)",
+  "attachment.extension_unassigned": "Not assigned",
+  "attachment.extension_add": "Add extension",
+  "attachment.extension_edit": "Edit extension",
+  "attachment.extension_add_button": "Add extension",
+  "attachment.extension_empty": "No extensions yet.",
+  "attachment.extension": "Extension",
+  "attachment.extension_group": "Extension group",
+  "attachment.extension_delete_confirm": "Delete this extension?",
+  "attachment.actions": "Actions",
+  "attachment.allowed_mimes": "MIME types:",
+  "attachment.active": "Active",
+  "attachment.inactive": "Inactive",
+  "attachment.tab_options": "Options",
+  "attachment.tab_attachments": "Attachments",
+  "attachment.hint": "If you wish to attach one or more files enter the details below.",
+  "attachment.max_size": "Maximum filesize per attachment: {{size}}.",
+  "attachment.add_files": "Add files",
+  "attachment.drop_hint": "Drag files here to upload or",
+  "attachment.drop_browse": "Browse",
+  "attachment.filename": "Filename",
+  "attachment.size": "Size",
+  "attachment.status": "Status",
+  "attachment.empty": "No files added yet.",
+  "attachment.remove": "Remove file",
+  "attachment.file_comment": "File comment",
+  "attachment.file_comment_placeholder": "Comment (optional)",
+  "attachment.place_inline": "Place inline",
+  "attachment.delete_file": "Delete file",
+  "attachment.option_disable_bbcode": "Disable BBCode",
+  "attachment.option_disable_smilies": "Disable smilies",
+  "attachment.option_disable_auto_urls": "Do not automatically parse URLs",
+  "attachment.option_attach_signature": "Attach a signature (signatures can be altered via the UCP)",
+  "attachment.option_notify_replies": "Notify me when a reply is posted",
+  "attachment.option_lock_topic": "Lock topic",
+  "attachment.invalid_extensions": "Not allowed: {{names}}.",
   "thread.anonymous": "Anonymous",
   "thread.back_to_category": "Back to forum",
   "thread.category": "Forum:",
@@ -227,6 +380,11 @@
   "thread.reply_prefix": "Re:",
   "thread.registered": "Registered",
   "thread.replies": "Replies",
+  "thread.solved": "Solved",
+  "thread.mark_solved": "Mark solved",
+  "thread.mark_unsolved": "Mark unsolved",
+  "thread.attachments": "Attachments",
+  "thread.attach_files": "Attach files",
   "thread.views": "Views",
   "thread.last_post": "Last post",
   "thread.by": "by",

routes/api.php

@@ -1,11 +1,16 @@
 <?php
 
+use App\Http\Controllers\AttachmentController;
+use App\Http\Controllers\AttachmentExtensionController;
+use App\Http\Controllers\AttachmentGroupController;
+use App\Http\Controllers\AuditLogController;
 use App\Http\Controllers\AuthController;
 use App\Http\Controllers\ForumController;
 use App\Http\Controllers\I18nController;
 use App\Http\Controllers\PortalController;
 use App\Http\Controllers\PostController;
 use App\Http\Controllers\PostThankController;
+use App\Http\Controllers\PreviewController;
 use App\Http\Controllers\SettingController;
 use App\Http\Controllers\StatsController;
 use App\Http\Controllers\ThreadController;
@@ -13,6 +18,9 @@ use App\Http\Controllers\UploadController;
 use App\Http\Controllers\UserSettingController;
 use App\Http\Controllers\UserController;
 use App\Http\Controllers\VersionController;
+use App\Http\Controllers\VersionCheckController;
+use App\Http\Controllers\SystemUpdateController;
+use App\Http\Controllers\SystemStatusController;
 use App\Http\Controllers\RankController;
 use App\Http\Controllers\RoleController;
 use Illuminate\Support\Facades\Route;
@@ -28,11 +36,15 @@ Route::post('/logout', [AuthController::class, 'logout'])->middleware('auth:sanc
 Route::post('/user/password', [AuthController::class, 'updatePassword'])->middleware('auth:sanctum');
 
 Route::get('/version', VersionController::class);
+Route::get('/version/check', VersionCheckController::class);
+Route::post('/system/update', SystemUpdateController::class)->middleware('auth:sanctum');
+Route::get('/system/status', SystemStatusController::class)->middleware('auth:sanctum');
 Route::get('/portal/summary', PortalController::class);
 Route::get('/stats', StatsController::class);
 Route::get('/settings', [SettingController::class, 'index']);
 Route::post('/settings', [SettingController::class, 'store'])->middleware('auth:sanctum');
 Route::post('/settings/bulk', [SettingController::class, 'bulkStore'])->middleware('auth:sanctum');
+Route::get('/audit-logs', [AuditLogController::class, 'index'])->middleware('auth:sanctum');
 Route::get('/user-settings', [UserSettingController::class, 'index'])->middleware('auth:sanctum');
 Route::post('/user-settings', [UserSettingController::class, 'store'])->middleware('auth:sanctum');
 Route::post('/uploads/logo', [UploadController::class, 'storeLogo'])->middleware('auth:sanctum');
@@ -57,6 +69,25 @@ Route::patch('/ranks/{rank}', [RankController::class, 'update'])->middleware('au
 Route::delete('/ranks/{rank}', [RankController::class, 'destroy'])->middleware('auth:sanctum');
 Route::post('/ranks/{rank}/badge-image', [RankController::class, 'uploadBadgeImage'])->middleware('auth:sanctum');
 
+Route::get('/attachment-groups', [AttachmentGroupController::class, 'index'])->middleware('auth:sanctum');
+Route::post('/attachment-groups', [AttachmentGroupController::class, 'store'])->middleware('auth:sanctum');
+Route::patch('/attachment-groups/{attachmentGroup}', [AttachmentGroupController::class, 'update'])->middleware('auth:sanctum');
+Route::delete('/attachment-groups/{attachmentGroup}', [AttachmentGroupController::class, 'destroy'])->middleware('auth:sanctum');
+Route::post('/attachment-groups/reorder', [AttachmentGroupController::class, 'reorder'])->middleware('auth:sanctum');
+
+Route::get('/attachment-extensions', [AttachmentExtensionController::class, 'index'])->middleware('auth:sanctum');
+Route::get('/attachment-extensions/public', [AttachmentExtensionController::class, 'publicIndex']);
+Route::post('/attachment-extensions', [AttachmentExtensionController::class, 'store'])->middleware('auth:sanctum');
+Route::patch('/attachment-extensions/{attachmentExtension}', [AttachmentExtensionController::class, 'update'])->middleware('auth:sanctum');
+Route::delete('/attachment-extensions/{attachmentExtension}', [AttachmentExtensionController::class, 'destroy'])->middleware('auth:sanctum');
+
+Route::get('/attachments', [AttachmentController::class, 'index']);
+Route::post('/attachments', [AttachmentController::class, 'store'])->middleware('auth:sanctum');
+Route::get('/attachments/{attachment}', [AttachmentController::class, 'show']);
+Route::get('/attachments/{attachment}/download', [AttachmentController::class, 'download']);
+Route::get('/attachments/{attachment}/thumbnail', [AttachmentController::class, 'thumbnail']);
+Route::delete('/attachments/{attachment}', [AttachmentController::class, 'destroy'])->middleware('auth:sanctum');
+
 Route::get('/forums', [ForumController::class, 'index']);
 Route::get('/forums/{forum}', [ForumController::class, 'show']);
 Route::post('/forums', [ForumController::class, 'store'])->middleware('auth:sanctum');
@@ -67,10 +98,14 @@ Route::delete('/forums/{forum}', [ForumController::class, 'destroy'])->middlewar
 Route::get('/threads', [ThreadController::class, 'index']);
 Route::get('/threads/{thread}', [ThreadController::class, 'show']);
 Route::post('/threads', [ThreadController::class, 'store'])->middleware('auth:sanctum');
+Route::patch('/threads/{thread}', [ThreadController::class, 'update'])->middleware('auth:sanctum');
+Route::patch('/threads/{thread}/solved', [ThreadController::class, 'updateSolved'])->middleware('auth:sanctum');
 Route::delete('/threads/{thread}', [ThreadController::class, 'destroy'])->middleware('auth:sanctum');
 
 Route::get('/posts', [PostController::class, 'index']);
 Route::post('/posts', [PostController::class, 'store'])->middleware('auth:sanctum');
 Route::post('/posts/{post}/thanks', [PostThankController::class, 'store'])->middleware('auth:sanctum');
 Route::delete('/posts/{post}/thanks', [PostThankController::class, 'destroy'])->middleware('auth:sanctum');
+Route::patch('/posts/{post}', [PostController::class, 'update'])->middleware('auth:sanctum');
 Route::delete('/posts/{post}', [PostController::class, 'destroy'])->middleware('auth:sanctum');
+Route::post('/preview', [PreviewController::class, 'preview'])->middleware('auth:sanctum');

scripts/build_release_assets.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+OUTPUT_DIR="${OUTPUT_DIR:-"$ROOT_DIR/dist"}"
+ALLOW_DIRTY="${ALLOW_DIRTY:-0}"
+
+if [[ "$ALLOW_DIRTY" != "1" ]]; then
+  if [[ -n "$(git -C "$ROOT_DIR" status --porcelain)" ]]; then
+    echo "Working tree is dirty. Set ALLOW_DIRTY=1 to override." >&2
+    exit 1
+  fi
+fi
+
+VERSION="$(php -r 'echo json_decode(file_get_contents("composer.json"), true)["version"] ?? "0.0.0";')"
+if [[ -z "$VERSION" ]]; then
+  echo "Could not determine version from composer.json" >&2
+  exit 1
+fi
+
+BUILD_DIR="$(mktemp -d)"
+cleanup() {
+  rm -rf "$BUILD_DIR"
+}
+trap cleanup EXIT
+
+exclude_args=(
+  --exclude ".git"
+  --exclude "node_modules"
+  --exclude "vendor"
+  --exclude "storage"
+  --exclude "dist"
+  --exclude "tests"
+  --exclude ".env"
+  --exclude ".env.test"
+  --exclude "public/build"
+)
+
+if command -v rsync >/dev/null 2>&1; then
+  rsync -a "${exclude_args[@]}" "$ROOT_DIR/" "$BUILD_DIR/"
+else
+  tar -C "$ROOT_DIR" -cf - \
+    --exclude=".git" \
+    --exclude="node_modules" \
+    --exclude="vendor" \
+    --exclude="storage" \
+    --exclude="dist" \
+    --exclude="tests" \
+    --exclude=".env" \
+    --exclude=".env.test" \
+    --exclude="public/build" \
+    . | tar -C "$BUILD_DIR" -xf -
+fi
+
+pushd "$BUILD_DIR" >/dev/null
+composer install --no-dev --optimize-autoloader
+npm install
+npm run build
+rm -rf node_modules
+popd >/dev/null
+
+mkdir -p "$OUTPUT_DIR"
+FULL_TAR="$OUTPUT_DIR/speedbb-full-v${VERSION}.tar.gz"
+SRC_TAR="$OUTPUT_DIR/speedbb-src-v${VERSION}.tar.gz"
+
+tar -C "$BUILD_DIR" -czf "$FULL_TAR" --exclude="tests" .
+tar -C "$BUILD_DIR" -czf "$SRC_TAR" --exclude="vendor" --exclude="public/build" --exclude="tests" .
+
+echo "Built:"
+echo "  $FULL_TAR"
+echo "  $SRC_TAR"

tests/Feature/AttachmentControllerTest.php

@@ -0,0 +1,284 @@
+<?php
+
+use App\Models\Attachment;
+use App\Models\AttachmentExtension;
+use App\Models\AttachmentGroup;
+use App\Models\Forum;
+use App\Models\Post;
+use App\Models\Thread;
+use App\Models\User;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\Storage;
+use Laravel\Sanctum\Sanctum;
+
+function makeThreadForAttachments(?User $owner = null): Thread
+{
+    $category = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $forum = Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    return Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $owner?->id,
+        'title' => 'Attachment Thread',
+        'body' => 'Thread Body',
+    ]);
+}
+
+function makeAttachmentConfig(string $extension = 'pdf', array $mimes = ['application/pdf']): AttachmentExtension
+{
+    $group = AttachmentGroup::create([
+        'name' => 'Docs',
+        'max_size_kb' => 25600,
+        'is_active' => true,
+    ]);
+
+    return AttachmentExtension::create([
+        'extension' => $extension,
+        'attachment_group_id' => $group->id,
+        'allowed_mimes' => $mimes,
+    ]);
+}
+
+it('requires authentication to upload attachments', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+
+    $response = $this->postJson('/api/attachments', [
+        'thread' => '/api/threads/1',
+        'file' => UploadedFile::fake()->create('doc.pdf', 10, 'application/pdf'),
+    ]);
+
+    $response->assertStatus(401);
+});
+
+it('rejects uploads without thread or post', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/attachments', [
+        'file' => UploadedFile::fake()->create('doc.pdf', 10, 'application/pdf'),
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Provide either thread or post.']);
+});
+
+it('rejects uploads with both thread and post', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+    $user = User::factory()->create();
+    $thread = makeThreadForAttachments($user);
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $user->id,
+        'body' => 'Post',
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->postJson('/api/attachments', [
+        'thread' => "/api/threads/{$thread->id}",
+        'post' => "/api/posts/{$post->id}",
+        'file' => UploadedFile::fake()->create('doc.pdf', 10, 'application/pdf'),
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Provide either thread or post.']);
+});
+
+it('forbids uploads when user is not owner', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+
+    $owner = User::factory()->create();
+    $other = User::factory()->create();
+    $thread = makeThreadForAttachments($owner);
+
+    Sanctum::actingAs($other);
+    $response = $this->postJson('/api/attachments', [
+        'thread' => "/api/threads/{$thread->id}",
+        'file' => UploadedFile::fake()->create('doc.pdf', 10, 'application/pdf'),
+    ]);
+
+    $response->assertStatus(403);
+});
+
+it('stores attachment for a thread', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+
+    $user = User::factory()->create();
+    $thread = makeThreadForAttachments($user);
+
+    Sanctum::actingAs($user);
+    $response = $this->postJson('/api/attachments', [
+        'thread' => "/api/threads/{$thread->id}",
+        'file' => UploadedFile::fake()->create('doc.pdf', 10, 'application/pdf'),
+    ]);
+
+    $response->assertStatus(201);
+    $attachmentId = $response->json('id');
+    $attachment = Attachment::findOrFail($attachmentId);
+
+    $this->assertDatabaseHas('attachments', [
+        'id' => $attachment->id,
+        'thread_id' => $thread->id,
+        'user_id' => $user->id,
+        'extension' => 'pdf',
+    ]);
+
+    Storage::disk('local')->assertExists($attachment->path);
+});
+
+it('filters attachments by thread', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+
+    $user = User::factory()->create();
+    $threadA = makeThreadForAttachments($user);
+    $threadB = makeThreadForAttachments($user);
+
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/attachments', [
+        'thread' => "/api/threads/{$threadA->id}",
+        'file' => UploadedFile::fake()->create('doc.pdf', 10, 'application/pdf'),
+    ]);
+    $response->assertStatus(201);
+    $attachmentId = $response->json('id');
+
+    $this->postJson('/api/attachments', [
+        'thread' => "/api/threads/{$threadB->id}",
+        'file' => UploadedFile::fake()->create('doc.pdf', 10, 'application/pdf'),
+    ])->assertStatus(201);
+
+    $response = $this->getJson("/api/attachments?thread=/api/threads/{$threadA->id}");
+
+    $response->assertOk();
+    $response->assertJsonCount(1);
+    $response->assertJsonFragment(['id' => $attachmentId]);
+});
+
+it('returns 404 when parent thread is deleted', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+
+    $user = User::factory()->create();
+    $thread = makeThreadForAttachments($user);
+
+    Sanctum::actingAs($user);
+    $response = $this->postJson('/api/attachments', [
+        'thread' => "/api/threads/{$thread->id}",
+        'file' => UploadedFile::fake()->create('doc.pdf', 10, 'application/pdf'),
+    ]);
+
+    $response->assertStatus(201);
+    $attachmentId = $response->json('id');
+
+    $thread->delete();
+
+    $this->getJson("/api/attachments/{$attachmentId}")
+        ->assertStatus(404);
+});
+
+it('downloads attachment file when available', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+
+    $user = User::factory()->create();
+    $thread = makeThreadForAttachments($user);
+
+    $attachment = Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => $user->id,
+        'disk' => 'local',
+        'path' => 'attachments/threads/'.$thread->id.'/file.pdf',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 4,
+    ]);
+
+    Storage::disk('local')->put($attachment->path, 'data');
+
+    $response = $this->get("/api/attachments/{$attachment->id}/download");
+    $response->assertOk();
+    $response->assertHeader('content-type', 'application/pdf');
+});
+
+it('serves attachment thumbnail when present', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+
+    $user = User::factory()->create();
+    $thread = makeThreadForAttachments($user);
+
+    $attachment = Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => $user->id,
+        'disk' => 'local',
+        'path' => 'attachments/threads/'.$thread->id.'/file.pdf',
+        'thumbnail_path' => 'attachments/threads/'.$thread->id.'/thumbs/thumb.jpg',
+        'thumbnail_mime_type' => 'image/jpeg',
+        'thumbnail_size_bytes' => 4,
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 4,
+    ]);
+
+    Storage::disk('local')->put($attachment->path, 'data');
+    Storage::disk('local')->put($attachment->thumbnail_path, 'thumb');
+
+    $response = $this->get("/api/attachments/{$attachment->id}/thumbnail");
+    $response->assertOk();
+    $response->assertHeader('content-type', 'image/jpeg');
+});
+
+it('soft deletes attachments when owner requests', function (): void {
+    Storage::fake('local');
+    makeAttachmentConfig();
+
+    $user = User::factory()->create();
+    $thread = makeThreadForAttachments($user);
+
+    $attachment = Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => $user->id,
+        'disk' => 'local',
+        'path' => 'attachments/threads/'.$thread->id.'/file.pdf',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 4,
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->deleteJson("/api/attachments/{$attachment->id}");
+
+    $response->assertStatus(204);
+    $this->assertSoftDeleted('attachments', ['id' => $attachment->id]);
+});

tests/Feature/AttachmentExtensionControllerTest.php

@@ -0,0 +1,114 @@
+<?php
+
+use App\Models\Attachment;
+use App\Models\AttachmentExtension;
+use App\Models\AttachmentGroup;
+use App\Models\Role;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+function makeAdminForAttachmentExtensions(): User
+{
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    return $admin;
+}
+
+it('lists extensions for admins', function (): void {
+    $admin = makeAdminForAttachmentExtensions();
+    $group = AttachmentGroup::create(['name' => 'General', 'max_size_kb' => 100, 'is_active' => true]);
+    AttachmentExtension::create([
+        'extension' => 'pdf',
+        'attachment_group_id' => $group->id,
+    ]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->getJson('/api/attachment-extensions');
+
+    $response->assertOk();
+    $response->assertJsonFragment(['extension' => 'pdf']);
+});
+
+it('lists public extensions for active groups', function (): void {
+    $active = AttachmentGroup::create(['name' => 'Active', 'max_size_kb' => 100, 'is_active' => true]);
+    $inactive = AttachmentGroup::create(['name' => 'Inactive', 'max_size_kb' => 100, 'is_active' => false]);
+
+    AttachmentExtension::create([
+        'extension' => 'png',
+        'attachment_group_id' => $active->id,
+    ]);
+
+    AttachmentExtension::create([
+        'extension' => 'exe',
+        'attachment_group_id' => $inactive->id,
+    ]);
+
+    $response = $this->getJson('/api/attachment-extensions/public');
+
+    $response->assertOk();
+    $response->assertJsonFragment(['png']);
+    $response->assertJsonMissing(['exe']);
+});
+
+it('creates extensions as admin and normalizes extension', function (): void {
+    $admin = makeAdminForAttachmentExtensions();
+    $group = AttachmentGroup::create(['name' => 'Docs', 'max_size_kb' => 100, 'is_active' => true]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->postJson('/api/attachment-extensions', [
+        'extension' => '.PDF',
+        'attachment_group_id' => $group->id,
+        'allowed_mimes' => ['application/pdf'],
+    ]);
+
+    $response->assertStatus(201);
+    $response->assertJsonFragment(['extension' => 'pdf']);
+});
+
+it('updates extensions as admin', function (): void {
+    $admin = makeAdminForAttachmentExtensions();
+    $group = AttachmentGroup::create(['name' => 'Images', 'max_size_kb' => 100, 'is_active' => true]);
+    $ext = AttachmentExtension::create([
+        'extension' => 'png',
+        'attachment_group_id' => null,
+    ]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/attachment-extensions/{$ext->id}", [
+        'attachment_group_id' => $group->id,
+        'allowed_mimes' => ['image/png'],
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment(['attachment_group_id' => $group->id]);
+});
+
+it('prevents deleting extensions in use', function (): void {
+    $admin = makeAdminForAttachmentExtensions();
+    $ext = AttachmentExtension::create([
+        'extension' => 'pdf',
+        'attachment_group_id' => null,
+    ]);
+
+    Attachment::create([
+        'thread_id' => null,
+        'post_id' => null,
+        'attachment_extension_id' => $ext->id,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/misc/file.pdf',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->deleteJson("/api/attachment-extensions/{$ext->id}");
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Extension is in use.']);
+});

tests/Feature/AttachmentGroupControllerTest.php

@@ -0,0 +1,136 @@
+<?php
+
+use App\Models\Attachment;
+use App\Models\AttachmentExtension;
+use App\Models\AttachmentGroup;
+use App\Models\Role;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+function makeAdminForAttachmentGroups(): User
+{
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    return $admin;
+}
+
+it('lists attachment groups for admins', function (): void {
+    $admin = makeAdminForAttachmentGroups();
+    AttachmentGroup::create(['name' => 'General', 'max_size_kb' => 10, 'is_active' => true]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->getJson('/api/attachment-groups');
+
+    $response->assertOk();
+    $response->assertJsonFragment(['name' => 'General']);
+});
+
+it('creates attachment groups as admin', function (): void {
+    $admin = makeAdminForAttachmentGroups();
+    Sanctum::actingAs($admin);
+
+    $response = $this->postJson('/api/attachment-groups', [
+        'name' => 'Images',
+        'parent_id' => null,
+        'max_size_kb' => 1024,
+        'is_active' => true,
+    ]);
+
+    $response->assertStatus(201);
+    $response->assertJsonFragment(['name' => 'Images']);
+});
+
+it('updates attachment groups as admin', function (): void {
+    $admin = makeAdminForAttachmentGroups();
+    $group = AttachmentGroup::create([
+        'name' => 'Docs',
+        'parent_id' => null,
+        'position' => 1,
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/attachment-groups/{$group->id}", [
+        'name' => 'Docs Updated',
+        'parent_id' => null,
+        'max_size_kb' => 200,
+        'is_active' => false,
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment(['name' => 'Docs Updated', 'is_active' => false]);
+});
+
+it('prevents deleting groups with extensions or attachments', function (): void {
+    $admin = makeAdminForAttachmentGroups();
+    $group = AttachmentGroup::create([
+        'name' => 'Protected',
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+
+    AttachmentExtension::create([
+        'extension' => 'pdf',
+        'attachment_group_id' => $group->id,
+    ]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->deleteJson("/api/attachment-groups/{$group->id}");
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Attachment group has extensions.']);
+
+    $group2 = AttachmentGroup::create([
+        'name' => 'InUse',
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+    Attachment::create([
+        'thread_id' => null,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => $group2->id,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/misc/file.pdf',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    $response = $this->deleteJson("/api/attachment-groups/{$group2->id}");
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Attachment group is in use.']);
+});
+
+it('reorders attachment groups', function (): void {
+    $admin = makeAdminForAttachmentGroups();
+    $first = AttachmentGroup::create([
+        'name' => 'First',
+        'position' => 1,
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+    $second = AttachmentGroup::create([
+        'name' => 'Second',
+        'position' => 2,
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->postJson('/api/attachment-groups/reorder', [
+        'parentId' => null,
+        'orderedIds' => [$second->id, $first->id],
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('attachment_groups', [
+        'id' => $second->id,
+        'position' => 1,
+    ]);
+});

tests/Feature/AuditLogControllerTest.php

@@ -0,0 +1,46 @@
+<?php
+
+use App\Models\AuditLog;
+use App\Models\Role;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+it('requires authentication to list audit logs', function (): void {
+    $response = $this->getJson('/api/audit-logs');
+
+    $response->assertStatus(401);
+});
+
+it('forbids non-admin audit log access', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->getJson('/api/audit-logs');
+
+    $response->assertStatus(403);
+});
+
+it('lists audit logs for admins', function (): void {
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    $log = AuditLog::create([
+        'user_id' => $admin->id,
+        'action' => 'test.action',
+        'subject_type' => null,
+        'subject_id' => null,
+        'metadata' => ['foo' => 'bar'],
+        'ip_address' => '127.0.0.1',
+        'user_agent' => 'test',
+    ]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->getJson('/api/audit-logs');
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $log->id,
+        'action' => 'test.action',
+    ]);
+});

tests/Feature/AuthControllerTest.php

@@ -0,0 +1,222 @@
+<?php
+
+use App\Models\User;
+use Illuminate\Auth\Notifications\VerifyEmail;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Facades\Notification;
+use Illuminate\Support\Facades\Password;
+use Illuminate\Support\Facades\URL;
+use Laravel\Sanctum\Sanctum;
+
+it('registers a user with username and plainPassword', function (): void {
+    Notification::fake();
+
+    $response = $this->postJson('/api/register', [
+        'username' => 'NewUser',
+        'email' => 'newuser@example.com',
+        'plainPassword' => 'Password123!',
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonStructure(['user_id', 'email', 'message']);
+
+    $this->assertDatabaseHas('users', [
+        'email' => 'newuser@example.com',
+        'name' => 'NewUser',
+        'name_canonical' => 'newuser',
+    ]);
+
+    $user = User::where('email', 'newuser@example.com')->firstOrFail();
+    Notification::assertSentTo($user, VerifyEmail::class);
+});
+
+it('rejects invalid login credentials', function (): void {
+    $user = User::factory()->create([
+        'password' => Hash::make('Password123!'),
+    ]);
+
+    $response = $this->postJson('/api/login', [
+        'login' => $user->email,
+        'password' => 'wrong-password',
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonValidationErrors(['login']);
+});
+
+it('blocks login for unverified email', function (): void {
+    $user = User::factory()->unverified()->create([
+        'password' => Hash::make('Password123!'),
+    ]);
+
+    $response = $this->postJson('/api/login', [
+        'login' => $user->email,
+        'password' => 'Password123!',
+    ]);
+
+    $response->assertStatus(403);
+    $response->assertJsonFragment(['message' => 'Email not verified.']);
+});
+
+it('logs in with username', function (): void {
+    $user = User::factory()->create([
+        'name' => 'TestUser',
+        'name_canonical' => 'testuser',
+        'password' => Hash::make('Password123!'),
+    ]);
+
+    $response = $this->postJson('/api/login', [
+        'login' => 'TestUser',
+        'password' => 'Password123!',
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonStructure(['token', 'user_id', 'email', 'roles']);
+});
+
+it('validates forgot password requests', function (): void {
+    $response = $this->postJson('/api/forgot-password', []);
+
+    $response->assertStatus(422);
+    $response->assertJsonValidationErrors(['email']);
+});
+
+it('sends a reset link for valid email', function (): void {
+    $user = User::factory()->create([
+        'email' => 'reset@example.com',
+    ]);
+
+    $response = $this->postJson('/api/forgot-password', [
+        'email' => $user->email,
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonStructure(['message']);
+});
+
+it('returns validation error when reset link cannot be sent', function (): void {
+    Password::shouldReceive('sendResetLink')
+        ->once()
+        ->andReturn(Password::INVALID_USER);
+
+    $response = $this->postJson('/api/forgot-password', [
+        'email' => 'missing@example.com',
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonValidationErrors(['email']);
+});
+
+it('resets a password with a valid token', function (): void {
+    $user = User::factory()->create([
+        'email' => 'reset2@example.com',
+        'password' => Hash::make('OldPassword123!'),
+    ]);
+
+    $token = Password::createToken($user);
+
+    $response = $this->postJson('/api/reset-password', [
+        'email' => $user->email,
+        'password' => 'NewPassword123!',
+        'password_confirmation' => 'NewPassword123!',
+        'token' => $token,
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonStructure(['message']);
+
+    $user->refresh();
+    expect(Hash::check('NewPassword123!', $user->password))->toBeTrue();
+});
+
+it('returns validation error when reset fails', function (): void {
+    Password::shouldReceive('reset')
+        ->once()
+        ->andReturn(Password::INVALID_TOKEN);
+
+    $response = $this->postJson('/api/reset-password', [
+        'email' => 'resetfail@example.com',
+        'password' => 'NewPassword123!',
+        'password_confirmation' => 'NewPassword123!',
+        'token' => 'bad-token',
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonValidationErrors(['email']);
+});
+
+it('verifies email and redirects to login', function (): void {
+    $user = User::factory()->unverified()->create();
+
+    $hash = sha1($user->getEmailForVerification());
+
+    $url = URL::signedRoute('verification.verify', [
+        'id' => $user->id,
+        'hash' => $hash,
+    ]);
+
+    $response = $this->get($url);
+
+    $response->assertRedirect('/login');
+    $user->refresh();
+    expect($user->hasVerifiedEmail())->toBeTrue();
+});
+
+it('rejects invalid email verification hash', function (): void {
+    $user = User::factory()->unverified()->create();
+
+    $url = URL::signedRoute('verification.verify', [
+        'id' => $user->id,
+        'hash' => sha1('wrong'),
+    ]);
+
+    $response = $this->get($url);
+
+    $response->assertStatus(403);
+});
+
+it('updates password for authenticated users', function (): void {
+    $user = User::factory()->create([
+        'password' => Hash::make('OldPass123!'),
+    ]);
+
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/user/password', [
+        'current_password' => 'OldPass123!',
+        'password' => 'NewPass123!',
+        'password_confirmation' => 'NewPass123!',
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment(['message' => 'Password updated.']);
+
+    $user->refresh();
+    expect(Hash::check('NewPass123!', $user->password))->toBeTrue();
+});
+
+it('rejects password update with wrong current password', function (): void {
+    $user = User::factory()->create([
+        'password' => Hash::make('OldPass123!'),
+    ]);
+
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/user/password', [
+        'current_password' => 'WrongPass123!',
+        'password' => 'NewPass123!',
+        'password_confirmation' => 'NewPass123!',
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonValidationErrors(['current_password']);
+});
+
+it('logs out authenticated users', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/logout');
+
+    $response->assertStatus(204);
+});

tests/Feature/ForumControllerTest.php

@@ -0,0 +1,473 @@
+<?php
+
+use App\Models\Forum;
+use App\Models\Post;
+use App\Models\Role;
+use App\Models\Thread;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+it('can filter forums by parent exists', function (): void {
+    $category = Forum::create([
+        'name' => 'Category 1',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $forum = Forum::create([
+        'name' => 'Forum A',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $response = $this->getJson('/api/forums?parent[exists]=false');
+    $response->assertOk();
+    $response->assertJsonCount(1);
+    $response->assertJsonFragment(['id' => $category->id]);
+
+    $response = $this->getJson('/api/forums?parent[exists]=true');
+    $response->assertOk();
+    $response->assertJsonCount(1);
+    $response->assertJsonFragment(['id' => $forum->id]);
+});
+
+it('filters forums by parent id and type', function (): void {
+    $category = Forum::create([
+        'name' => 'Category 2',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $forum = Forum::create([
+        'name' => 'Forum B',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $response = $this->getJson("/api/forums?parent=/api/forums/{$category->id}");
+    $response->assertOk();
+    $response->assertJsonCount(1);
+    $response->assertJsonFragment(['id' => $forum->id]);
+
+    $response = $this->getJson('/api/forums?type=category');
+    $response->assertOk();
+    $response->assertJsonFragment(['id' => $category->id]);
+});
+
+it('shows forum with last post data', function (): void {
+    $role = Role::create(['name' => 'ROLE_MEMBER', 'color' => '#00ff00']);
+    $user = User::factory()->create();
+    $user->roles()->attach($role);
+    $user->load('roles');
+
+    $category = Forum::create([
+        'name' => 'Category 3',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = Forum::create([
+        'name' => 'Forum C',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $user->id,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $user->id,
+        'body' => 'Reply',
+    ]);
+
+    $response = $this->getJson("/api/forums/{$forum->id}");
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $forum->id,
+        'last_post_user_id' => $user->id,
+    ]);
+    $payload = $response->getData(true);
+    expect($payload['last_post_user_group_color'])->toBe('#00ff00');
+});
+
+it('creates category and shifts positions', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    Forum::create([
+        'name' => 'Category A',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $response = $this->postJson('/api/forums', [
+        'name' => 'Category B',
+        'type' => 'category',
+        'description' => 'Desc',
+    ]);
+
+    $response->assertStatus(201);
+    $this->assertDatabaseHas('forums', [
+        'name' => 'Category A',
+        'position' => 2,
+    ]);
+});
+
+it('updates forum parent and description', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $categoryA = Forum::create([
+        'name' => 'Category A',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $categoryB = Forum::create([
+        'name' => 'Category B',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 2,
+    ]);
+    $forum = Forum::create([
+        'name' => 'Forum D',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $categoryA->id,
+        'position' => 1,
+    ]);
+
+    $response = $this->patchJson("/api/forums/{$forum->id}", [
+        'parent' => "/api/forums/{$categoryB->id}",
+        'description' => 'Updated',
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('forums', [
+        'id' => $forum->id,
+        'parent_id' => $categoryB->id,
+        'description' => 'Updated',
+    ]);
+});
+
+it('updates forum name and type', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $category = Forum::create([
+        'name' => 'Category H',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = Forum::create([
+        'name' => 'Forum H',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $response = $this->patchJson("/api/forums/{$forum->id}", [
+        'name' => 'Forum H Updated',
+        'type' => 'forum',
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('forums', [
+        'id' => $forum->id,
+        'name' => 'Forum H Updated',
+    ]);
+});
+
+it('rejects forum update without category parent', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $category = Forum::create([
+        'name' => 'Category Z',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = Forum::create([
+        'name' => 'Forum E',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $response = $this->patchJson("/api/forums/{$forum->id}", [
+        'parent' => null,
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Forums must belong to a category.']);
+});
+
+it('rejects forum update with non-category parent', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $category = Forum::create([
+        'name' => 'Category X',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $parent = Forum::create([
+        'name' => 'Not Category',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+    $forum = Forum::create([
+        'name' => 'Forum G',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $response = $this->patchJson("/api/forums/{$forum->id}", [
+        'parent' => "/api/forums/{$parent->id}",
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Parent must be a category.']);
+});
+
+it('destroys forum and sets deleted_by', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $forum = Forum::create([
+        'name' => 'Forum F',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $response = $this->deleteJson("/api/forums/{$forum->id}");
+    $response->assertStatus(204);
+
+    $forum->refresh();
+    expect($forum->deleted_by)->toBe($user->id);
+});
+
+it('reorders with string parent id', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $parent = Forum::create([
+        'name' => 'Cat Parent',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $first = Forum::create([
+        'name' => 'Forum 1',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $parent->id,
+        'position' => 1,
+    ]);
+    $second = Forum::create([
+        'name' => 'Forum 2',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $parent->id,
+        'position' => 2,
+    ]);
+
+    $response = $this->postJson('/api/forums/reorder', [
+        'parentId' => (string) $parent->id,
+        'orderedIds' => [$second->id, $first->id],
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('forums', ['id' => $second->id, 'position' => 1]);
+});
+
+it('reorders with empty parent id string', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $first = Forum::create([
+        'name' => 'Cat X',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $second = Forum::create([
+        'name' => 'Cat Y',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 2,
+    ]);
+
+    $response = $this->postJson('/api/forums/reorder', [
+        'parentId' => '',
+        'orderedIds' => [$second->id, $first->id],
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('forums', ['id' => $second->id, 'position' => 1]);
+});
+
+it('reorders with parent id null string', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $first = Forum::create([
+        'name' => 'Cat N1',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $second = Forum::create([
+        'name' => 'Cat N2',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 2,
+    ]);
+
+    $response = $this->postJson('/api/forums/reorder', [
+        'parentId' => 'null',
+        'orderedIds' => [$second->id, $first->id],
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('forums', ['id' => $second->id, 'position' => 1]);
+});
+
+it('creates forum under category and increments position', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $category = Forum::create([
+        'name' => 'Category P',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    Forum::create([
+        'name' => 'Forum P1',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $response = $this->postJson('/api/forums', [
+        'name' => 'Forum P2',
+        'type' => 'forum',
+        'parent' => "/api/forums/{$category->id}",
+    ]);
+
+    $response->assertStatus(201);
+    $this->assertDatabaseHas('forums', [
+        'name' => 'Forum P2',
+        'position' => 2,
+    ]);
+});
+
+it('rejects forum without category parent', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $response = $this->postJson('/api/forums', [
+        'name' => 'Bad Forum',
+        'type' => 'forum',
+        'parent' => null,
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Forums must belong to a category.']);
+});
+
+it('rejects non-category parent', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $category = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $parent = Forum::create([
+        'name' => 'Not Category',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $response = $this->postJson('/api/forums', [
+        'name' => 'Child Forum',
+        'type' => 'forum',
+        'parent' => "/api/forums/{$parent->id}",
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Parent must be a category.']);
+});
+
+it('reorders positions within parent scope', function (): void {
+    Sanctum::actingAs(User::factory()->create());
+
+    $first = Forum::create([
+        'name' => 'Cat A',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $second = Forum::create([
+        'name' => 'Cat B',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 2,
+    ]);
+
+    $response = $this->postJson('/api/forums/reorder', [
+        'parentId' => null,
+        'orderedIds' => [$second->id, $first->id],
+    ]);
+
+    $response->assertOk();
+
+    $this->assertDatabaseHas('forums', [
+        'id' => $second->id,
+        'position' => 1,
+    ]);
+    $this->assertDatabaseHas('forums', [
+        'id' => $first->id,
+        'position' => 2,
+    ]);
+});

tests/Feature/I18nControllerTest.php

@@ -0,0 +1,13 @@
+<?php
+
+it('returns translations for valid locale', function (): void {
+    $response = $this->getJson('/api/i18n/en');
+
+    $response->assertOk();
+});
+
+it('returns 404 for missing locale', function (): void {
+    $response = $this->getJson('/api/i18n/xx');
+
+    $response->assertStatus(404);
+});

tests/Feature/InstallerControllerTest.php

@@ -0,0 +1,23 @@
+<?php
+
+it('redirects installer when env exists', function (): void {
+    $response = $this->get('/install');
+
+    $response->assertRedirect('/');
+});
+
+it('blocks installer post when env exists', function (): void {
+    $response = $this->post('/install', [
+        'app_url' => 'https://example.com',
+        'db_host' => '127.0.0.1',
+        'db_port' => 3306,
+        'db_database' => 'test',
+        'db_username' => 'user',
+        'db_password' => 'pass',
+        'admin_name' => 'Admin',
+        'admin_email' => 'admin@example.com',
+        'admin_password' => 'Password123!',
+    ]);
+
+    $response->assertRedirect('/');
+});

tests/Feature/PortalControllerTest.php

@@ -0,0 +1,135 @@
+<?php
+
+use App\Models\Forum;
+use App\Models\Post;
+use App\Models\Rank;
+use App\Models\Role;
+use App\Models\Thread;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+it('returns portal summary payload', function (): void {
+    $user = User::factory()->create();
+
+    $category = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $forum = Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $user->id,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $user->id,
+        'body' => 'Reply',
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->getJson('/api/portal/summary');
+
+    $response->assertOk();
+    $response->assertJsonStructure(['forums', 'threads', 'stats', 'profile']);
+    $response->assertJsonFragment(['name' => 'Forum']);
+    $response->assertJsonFragment(['title' => 'Thread']);
+});
+
+it('includes avatar and rank data in portal threads', function (): void {
+    $rank = Rank::create([
+        'name' => 'Gold',
+        'badge_type' => 'image',
+        'badge_image_path' => 'ranks/gold.png',
+    ]);
+    $role = Role::create(['name' => 'ROLE_SPECIAL', 'color' => '#ff0000']);
+    $user = User::factory()->create([
+        'avatar_path' => 'avatars/u.png',
+        'rank_id' => $rank->id,
+    ]);
+    $user->roles()->attach($role);
+
+    $category = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $forum = Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $user->id,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->getJson('/api/portal/summary');
+
+    $response->assertOk();
+    $payload = $response->getData(true);
+    expect($payload['threads'][0]['user_avatar_url'])->not->toBeNull();
+    expect($payload['threads'][0]['user_rank_badge_url'])->not->toBeNull();
+    expect($payload['threads'][0]['user_group_color'])->toBe('#ff0000');
+});
+
+it('handles empty forum last posts and resolveGroupColor', function (): void {
+    $user = User::factory()->create();
+    $user->setRelation('roles', null);
+
+    $category = Forum::create([
+        'name' => 'Category2',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $forum = Forum::create([
+        'name' => 'Forum2',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->getJson('/api/portal/summary');
+
+    $response->assertOk();
+    $payload = $response->getData(true);
+    expect($payload['forums'][0]['last_post_user_group_color'])->toBeNull();
+});
+
+it('handles summary when no forums exist', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->getJson('/api/portal/summary');
+
+    $response->assertOk();
+    $payload = $response->getData(true);
+    expect($payload['forums'])->toBe([]);
+});

tests/Feature/PostControllerTest.php

@@ -0,0 +1,233 @@
+<?php
+
+use App\Models\Forum;
+use App\Models\Post;
+use App\Models\PostThank;
+use App\Models\Role;
+use App\Models\Thread;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+beforeEach(function (): void {
+    $parserProp = new ReflectionProperty(\App\Actions\BbcodeFormatter::class, 'parser');
+    $parserProp->setAccessible(true);
+    $parserProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Parser::class)
+            ->shouldReceive('parse')
+            ->andReturn('<r/>')
+            ->getMock()
+    );
+
+    $rendererProp = new ReflectionProperty(\App\Actions\BbcodeFormatter::class, 'renderer');
+    $rendererProp->setAccessible(true);
+    $rendererProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Renderer::class)
+            ->shouldReceive('render')
+            ->andReturn('<p></p>')
+            ->getMock()
+    );
+});
+
+afterEach(function (): void {
+    \Mockery::close();
+});
+
+function makeThread(): Thread
+{
+    $category = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $forum = Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    return Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread Title',
+        'body' => 'Thread Body',
+    ]);
+}
+
+it('creates a post in a thread', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $thread = makeThread();
+
+    $response = $this->postJson('/api/posts', [
+        'body' => 'First reply',
+        'thread' => "/api/threads/{$thread->id}",
+    ]);
+
+    $response->assertStatus(201);
+    $response->assertJsonFragment([
+        'body' => 'First reply',
+        'thread' => "/api/threads/{$thread->id}",
+    ]);
+
+    $this->assertDatabaseHas('posts', [
+        'thread_id' => $thread->id,
+        'user_id' => $user->id,
+        'body' => 'First reply',
+    ]);
+});
+
+it('validates required fields when creating posts', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/posts', []);
+
+    $response->assertStatus(422);
+    $response->assertJsonValidationErrors(['body', 'thread']);
+});
+
+it('enforces post update permissions', function (): void {
+    $thread = makeThread();
+    $owner = User::factory()->create();
+    $other = User::factory()->create();
+
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $owner->id,
+        'body' => 'Original body',
+    ]);
+
+    Sanctum::actingAs($other);
+    $response = $this->patchJson("/api/posts/{$post->id}", [
+        'body' => 'Hacked body',
+    ]);
+
+    $response->assertStatus(403);
+
+    Sanctum::actingAs($owner);
+    $response = $this->patchJson("/api/posts/{$post->id}", [
+        'body' => 'Owner update',
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('posts', [
+        'id' => $post->id,
+        'body' => 'Owner update',
+    ]);
+
+    $admin = User::factory()->create();
+    $role = Role::create(['name' => 'ROLE_ADMIN', 'color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/posts/{$post->id}", [
+        'body' => 'Admin update',
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('posts', [
+        'id' => $post->id,
+        'body' => 'Admin update',
+    ]);
+});
+
+it('requires authentication to update a post', function (): void {
+    $thread = makeThread();
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => null,
+        'body' => 'Original body',
+    ]);
+
+    $response = $this->patchJson("/api/posts/{$post->id}", [
+        'body' => 'Updated body',
+    ]);
+
+    $response->assertStatus(401);
+});
+
+it('deletes a post and tracks deleted_by', function (): void {
+    $thread = makeThread();
+    $user = User::factory()->create();
+
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $user->id,
+        'body' => 'To be deleted',
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->deleteJson("/api/posts/{$post->id}");
+
+    $response->assertStatus(204);
+
+    $this->assertSoftDeleted('posts', [
+        'id' => $post->id,
+    ]);
+
+    $this->assertDatabaseHas('posts', [
+        'id' => $post->id,
+        'deleted_by' => $user->id,
+    ]);
+});
+
+it('filters posts by thread', function (): void {
+    $threadA = makeThread();
+    $threadB = makeThread();
+
+    $postA = Post::create([
+        'thread_id' => $threadA->id,
+        'user_id' => null,
+        'body' => 'Post A',
+    ]);
+
+    Post::create([
+        'thread_id' => $threadB->id,
+        'user_id' => null,
+        'body' => 'Post B',
+    ]);
+
+    $response = $this->getJson("/api/posts?thread=/api/threads/{$threadA->id}");
+
+    $response->assertOk();
+    $response->assertJsonCount(1);
+    $response->assertJsonFragment([
+        'id' => $postA->id,
+        'body' => 'Post A',
+    ]);
+});
+
+it('allows users to thank and unthank posts', function (): void {
+    $thread = makeThread();
+    $author = User::factory()->create();
+    $thanker = User::factory()->create();
+
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $author->id,
+        'body' => 'Helpful answer',
+    ]);
+
+    Sanctum::actingAs($thanker);
+    $response = $this->postJson("/api/posts/{$post->id}/thanks");
+
+    $response->assertStatus(201);
+    $this->assertDatabaseHas('post_thanks', [
+        'post_id' => $post->id,
+        'user_id' => $thanker->id,
+    ]);
+
+    $response = $this->deleteJson("/api/posts/{$post->id}/thanks");
+
+    $response->assertStatus(204);
+    $this->assertDatabaseMissing('post_thanks', [
+        'post_id' => $post->id,
+        'user_id' => $thanker->id,
+    ]);
+});

tests/Feature/PostThankControllerTest.php

@@ -0,0 +1,162 @@
+<?php
+
+use App\Models\Forum;
+use App\Models\Post;
+use App\Models\PostThank;
+use App\Models\Thread;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+function makeThanksThread(): Thread
+{
+    $category = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $forum = Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    return Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thanks Thread',
+        'body' => 'Thread Body',
+    ]);
+}
+
+it('lists thanks given by a user', function (): void {
+    $thread = makeThanksThread();
+    $author = User::factory()->create(['name' => 'Author']);
+    $thanker = User::factory()->create(['name' => 'ThanksGiver']);
+
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $author->id,
+        'body' => 'Helpful post',
+    ]);
+
+    $thank = PostThank::create([
+        'post_id' => $post->id,
+        'user_id' => $thanker->id,
+    ]);
+
+    Sanctum::actingAs($thanker);
+    $response = $this->getJson("/api/user/{$thanker->id}/thanks/given");
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $thank->id,
+        'post_id' => $post->id,
+        'thread_id' => $thread->id,
+        'thread_title' => 'Thanks Thread',
+        'post_author_name' => 'Author',
+    ]);
+});
+
+it('lists thanks received for a user', function (): void {
+    $thread = makeThanksThread();
+    $author = User::factory()->create(['name' => 'Author']);
+    $thanker = User::factory()->create(['name' => 'ThanksGiver']);
+
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $author->id,
+        'body' => 'Helpful post',
+    ]);
+
+    $thank = PostThank::create([
+        'post_id' => $post->id,
+        'user_id' => $thanker->id,
+    ]);
+
+    Sanctum::actingAs($author);
+    $response = $this->getJson("/api/user/{$author->id}/thanks/received");
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $thank->id,
+        'post_id' => $post->id,
+        'thread_id' => $thread->id,
+        'thread_title' => 'Thanks Thread',
+        'thanker_name' => 'ThanksGiver',
+    ]);
+});
+
+it('requires auth to thank and unthank posts', function (): void {
+    $thread = makeThanksThread();
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => null,
+        'body' => 'Post',
+    ]);
+
+    $this->app['auth']->forgetGuards();
+    $response = $this->postJson("/api/posts/{$post->id}/thanks");
+    $response->assertStatus(401);
+
+    $this->app['auth']->forgetGuards();
+    $response = $this->deleteJson("/api/posts/{$post->id}/thanks");
+    $response->assertStatus(401);
+});
+
+it('creates and deletes thanks for a post', function (): void {
+    $thread = makeThanksThread();
+    $user = User::factory()->create();
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $user->id,
+        'body' => 'Post',
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->postJson("/api/posts/{$post->id}/thanks");
+    $response->assertStatus(201);
+
+    $response = $this->deleteJson("/api/posts/{$post->id}/thanks");
+    $response->assertStatus(204);
+});
+
+it('serializes group colors for thanks', function (): void {
+    $thread = makeThanksThread();
+    $authorRole = \App\Models\Role::create(['name' => 'ROLE_AUTHOR', 'color' => '#ff0000']);
+    $thankerRole = \App\Models\Role::create(['name' => 'ROLE_THANKER', 'color' => '#00ff00']);
+
+    $author = User::factory()->create(['name' => 'Author']);
+    $author->roles()->attach($authorRole);
+    $author->load('roles');
+    $thanker = User::factory()->create(['name' => 'ThanksGiver']);
+    $thanker->roles()->attach($thankerRole);
+    $thanker->load('roles');
+
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $author->id,
+        'body' => 'Helpful post',
+    ]);
+
+    PostThank::create([
+        'post_id' => $post->id,
+        'user_id' => $thanker->id,
+    ]);
+
+    Sanctum::actingAs($thanker);
+    $response = $this->getJson("/api/user/{$thanker->id}/thanks/given");
+    $response->assertOk();
+    $payload = $response->getData(true);
+    expect($payload[0]['post_author_group_color'])->toBe('#ff0000');
+
+    Sanctum::actingAs($author);
+    $response = $this->getJson("/api/user/{$author->id}/thanks/received");
+    $response->assertOk();
+    $payload = $response->getData(true);
+    expect($payload[0]['thanker_group_color'])->toBe('#00ff00');
+});

tests/Feature/PreviewControllerTest.php

@@ -0,0 +1,63 @@
+<?php
+
+it('renders bbcode preview', function (): void {
+    $parserProp = new ReflectionProperty(\App\Actions\BbcodeFormatter::class, 'parser');
+    $parserProp->setAccessible(true);
+    $parserProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Parser::class)
+            ->shouldReceive('parse')
+            ->andReturn('<r/>')
+            ->getMock()
+    );
+
+    $rendererProp = new ReflectionProperty(\App\Actions\BbcodeFormatter::class, 'renderer');
+    $rendererProp->setAccessible(true);
+    $rendererProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Renderer::class)
+            ->shouldReceive('render')
+            ->andReturn('<p></p>')
+            ->getMock()
+    );
+
+    $user = \App\Models\User::factory()->create();
+    \Laravel\Sanctum\Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/preview', [
+        'body' => '[b]Hello[/b]',
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonStructure(['html']);
+});
+
+it('validates preview body', function (): void {
+    $parserProp = new ReflectionProperty(\App\Actions\BbcodeFormatter::class, 'parser');
+    $parserProp->setAccessible(true);
+    $parserProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Parser::class)
+            ->shouldReceive('parse')
+            ->andReturn('<r/>')
+            ->getMock()
+    );
+
+    $rendererProp = new ReflectionProperty(\App\Actions\BbcodeFormatter::class, 'renderer');
+    $rendererProp->setAccessible(true);
+    $rendererProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Renderer::class)
+            ->shouldReceive('render')
+            ->andReturn('<p></p>')
+            ->getMock()
+    );
+
+    $user = \App\Models\User::factory()->create();
+    \Laravel\Sanctum\Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/preview', []);
+
+    $response->assertStatus(422);
+    $response->assertJsonValidationErrors(['body']);
+});
+
+afterEach(function (): void {
+    \Mockery::close();
+});

tests/Feature/RankControllerTest.php

@@ -0,0 +1,231 @@
+<?php
+
+use App\Models\Rank;
+use App\Models\Role;
+use App\Models\User;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\Storage;
+use Laravel\Sanctum\Sanctum;
+
+function makeAdminForRanks(): User
+{
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    return $admin;
+}
+
+it('lists ranks for authenticated users', function (): void {
+    $user = User::factory()->create();
+    Rank::create(['name' => 'Bronze']);
+
+    Sanctum::actingAs($user);
+    $response = $this->getJson('/api/ranks');
+
+    $response->assertOk();
+    $response->assertJsonFragment(['name' => 'Bronze']);
+});
+
+it('forbids non-admin rank changes', function (): void {
+    $user = User::factory()->create();
+    $rank = Rank::create(['name' => 'Nope']);
+
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/ranks', [
+        'name' => 'Silver',
+    ]);
+    $response->assertStatus(403);
+
+    $response = $this->patchJson("/api/ranks/{$rank->id}", [
+        'name' => 'Nope',
+    ]);
+    $response->assertStatus(403);
+
+    $response = $this->deleteJson("/api/ranks/{$rank->id}");
+    $response->assertStatus(403);
+
+    $response = $this->postJson("/api/ranks/{$rank->id}/badge-image", [
+        'file' => UploadedFile::fake()->image('badge.png', 50, 50),
+    ]);
+    $response->assertStatus(403);
+});
+
+it('creates ranks as admin', function (): void {
+    $admin = makeAdminForRanks();
+    Sanctum::actingAs($admin);
+
+    $response = $this->postJson('/api/ranks', [
+        'name' => 'Silver',
+        'badge_type' => 'text',
+        'badge_text' => 'S',
+        'color' => '#abcdef',
+    ]);
+
+    $response->assertStatus(201);
+    $response->assertJsonFragment([
+        'name' => 'Silver',
+        'badge_text' => 'S',
+    ]);
+});
+
+it('creates ranks with none badge type', function (): void {
+    $admin = makeAdminForRanks();
+    Sanctum::actingAs($admin);
+
+    $response = $this->postJson('/api/ranks', [
+        'name' => 'NoBadge',
+        'badge_type' => 'none',
+    ]);
+
+    $response->assertStatus(201);
+    $response->assertJsonFragment([
+        'name' => 'NoBadge',
+        'badge_text' => null,
+    ]);
+});
+
+it('updates ranks and clears badge images when switching to text', function (): void {
+    Storage::fake('public');
+
+    $admin = makeAdminForRanks();
+    $rank = Rank::create([
+        'name' => 'Gold',
+        'badge_type' => 'image',
+        'badge_text' => null,
+        'badge_image_path' => 'rank-badges/old.png',
+        'color' => '#ffaa00',
+    ]);
+
+    Storage::disk('public')->put('rank-badges/old.png', 'old');
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/ranks/{$rank->id}", [
+        'name' => 'Gold',
+        'badge_type' => 'text',
+        'badge_text' => 'G',
+        'color' => '#ffaa00',
+    ]);
+
+    $response->assertOk();
+    Storage::disk('public')->assertMissing('rank-badges/old.png');
+});
+
+it('updates ranks with badge_type none', function (): void {
+    $admin = makeAdminForRanks();
+    $rank = Rank::create([
+        'name' => 'Plain',
+        'badge_type' => 'text',
+        'badge_text' => 'P',
+    ]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/ranks/{$rank->id}", [
+        'name' => 'Plain',
+        'badge_type' => 'none',
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment(['badge_text' => null]);
+});
+
+it('updates ranks to image badge and keeps existing image', function (): void {
+    Storage::fake('public');
+
+    $admin = makeAdminForRanks();
+    $rank = Rank::create([
+        'name' => 'ImageRank',
+        'badge_type' => 'image',
+        'badge_text' => null,
+        'badge_image_path' => 'rank-badges/existing.png',
+    ]);
+
+    Storage::disk('public')->put('rank-badges/existing.png', 'existing');
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/ranks/{$rank->id}", [
+        'name' => 'ImageRank',
+        'badge_type' => 'image',
+    ]);
+
+    $response->assertOk();
+    Storage::disk('public')->assertExists('rank-badges/existing.png');
+});
+
+it('uploads a rank badge image', function (): void {
+    Storage::fake('public');
+
+    $admin = makeAdminForRanks();
+    $rank = Rank::create(['name' => 'Platinum']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->postJson("/api/ranks/{$rank->id}/badge-image", [
+        'file' => UploadedFile::fake()->image('badge.png', 50, 50),
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment(['badge_type' => 'image']);
+});
+
+it('includes badge image url in rank list when present', function (): void {
+    Storage::fake('public');
+    Storage::disk('public')->put('rank-badges/show.png', 'img');
+
+    $user = User::factory()->create();
+    Rank::create([
+        'name' => 'WithImage',
+        'badge_type' => 'image',
+        'badge_image_path' => 'rank-badges/show.png',
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->getJson('/api/ranks');
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'name' => 'WithImage',
+    ]);
+    expect($response->getData(true)[0]['badge_image_url'])->not->toBeNull();
+});
+
+it('uploads badge image replaces existing one', function (): void {
+    Storage::fake('public');
+
+    $admin = makeAdminForRanks();
+    $rank = Rank::create([
+        'name' => 'Replace',
+        'badge_type' => 'image',
+        'badge_image_path' => 'rank-badges/old.png',
+    ]);
+
+    Storage::disk('public')->put('rank-badges/old.png', 'old');
+
+    Sanctum::actingAs($admin);
+    $response = $this->postJson("/api/ranks/{$rank->id}/badge-image", [
+        'file' => UploadedFile::fake()->image('badge.png', 50, 50),
+    ]);
+
+    $response->assertOk();
+    Storage::disk('public')->assertMissing('rank-badges/old.png');
+});
+
+it('deletes ranks as admin', function (): void {
+    Storage::fake('public');
+
+    $admin = makeAdminForRanks();
+    $rank = Rank::create([
+        'name' => 'ToDelete',
+        'badge_type' => 'image',
+        'badge_image_path' => 'rank-badges/delete.png',
+    ]);
+
+    Storage::disk('public')->put('rank-badges/delete.png', 'old');
+
+    Sanctum::actingAs($admin);
+    $response = $this->deleteJson("/api/ranks/{$rank->id}");
+
+    $response->assertStatus(204);
+    Storage::disk('public')->assertMissing('rank-badges/delete.png');
+    $this->assertDatabaseMissing('ranks', ['id' => $rank->id]);
+});

tests/Feature/RoleControllerTest.php

@@ -0,0 +1,180 @@
+<?php
+
+use App\Models\Role;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+function makeAdminForRoles(): User
+{
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    return $admin;
+}
+
+it('forbids non-admin role access', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->getJson('/api/roles');
+
+    $response->assertStatus(403);
+});
+
+it('creates normalized roles as admin', function (): void {
+    $admin = makeAdminForRoles();
+    Sanctum::actingAs($admin);
+
+    $response = $this->postJson('/api/roles', [
+        'name' => 'moderator',
+        'color' => '#abcdef',
+    ]);
+
+    $response->assertStatus(201);
+    $response->assertJsonFragment([
+        'name' => 'ROLE_MODERATOR',
+        'color' => '#abcdef',
+    ]);
+
+    $this->assertDatabaseHas('roles', [
+        'name' => 'ROLE_MODERATOR',
+    ]);
+});
+
+it('lists roles for admins', function (): void {
+    $admin = makeAdminForRoles();
+    Role::create(['name' => 'ROLE_ALPHA', 'color' => '#111111']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->getJson('/api/roles');
+
+    $response->assertOk();
+    $response->assertJsonFragment(['name' => 'ROLE_ALPHA']);
+});
+
+it('prevents renaming core roles', function (): void {
+    $admin = makeAdminForRoles();
+    $core = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/roles/{$core->id}", [
+        'name' => 'ROLE_SUPER',
+        'color' => '#123456',
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Core roles cannot be renamed.']);
+});
+
+it('prevents creating duplicate roles after normalization', function (): void {
+    $admin = makeAdminForRoles();
+    Role::create(['name' => 'ROLE_TEST', 'color' => '#111111']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->postJson('/api/roles', [
+        'name' => 'test',
+        'color' => '#222222',
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Role already exists.']);
+});
+
+it('updates role color when provided and keeps name', function (): void {
+    $admin = makeAdminForRoles();
+    $role = Role::create(['name' => 'ROLE_EDIT', 'color' => '#111111']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/roles/{$role->id}", [
+        'name' => 'ROLE_EDIT',
+        'color' => '#222222',
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment(['color' => '#222222']);
+});
+
+it('prevents updating to duplicate normalized name', function (): void {
+    $admin = makeAdminForRoles();
+    $first = Role::create(['name' => 'ROLE_FIRST', 'color' => '#111111']);
+    $second = Role::create(['name' => 'ROLE_SECOND', 'color' => '#111111']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/roles/{$second->id}", [
+        'name' => 'first',
+        'color' => '#111111',
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Role already exists.']);
+});
+
+it('prevents deleting core roles', function (): void {
+    $admin = makeAdminForRoles();
+    $core = Role::firstOrCreate(['name' => 'ROLE_USER'], ['color' => '#111111']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->deleteJson("/api/roles/{$core->id}");
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Core roles cannot be deleted.']);
+});
+
+it('prevents deleting roles assigned to users', function (): void {
+    $admin = makeAdminForRoles();
+    $role = Role::create(['name' => 'ROLE_HELPER', 'color' => '#222222']);
+    $user = User::factory()->create();
+    $user->roles()->attach($role);
+
+    Sanctum::actingAs($admin);
+    $response = $this->deleteJson("/api/roles/{$role->id}");
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Role is assigned to users.']);
+});
+
+it('deletes non-core roles without assignments', function (): void {
+    $admin = makeAdminForRoles();
+    $role = Role::create(['name' => 'ROLE_CUSTOM', 'color' => '#333333']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->deleteJson("/api/roles/{$role->id}");
+
+    $response->assertStatus(204);
+    $this->assertDatabaseMissing('roles', ['id' => $role->id]);
+});
+
+it('forbids non-admin create update delete', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/roles', [
+        'name' => 'helper',
+        'color' => '#111111',
+    ]);
+    $response->assertStatus(403);
+
+    $role = Role::create(['name' => 'ROLE_TEMP', 'color' => '#111111']);
+    $response = $this->patchJson("/api/roles/{$role->id}", [
+        'name' => 'ROLE_TEMP',
+        'color' => '#222222',
+    ]);
+    $response->assertStatus(403);
+
+    $response = $this->deleteJson("/api/roles/{$role->id}");
+    $response->assertStatus(403);
+});
+
+it('normalizes invalid role names to ROLE_', function (): void {
+    $admin = makeAdminForRoles();
+    Sanctum::actingAs($admin);
+
+    $response = $this->postJson('/api/roles', [
+        'name' => '!!!',
+        'color' => '#111111',
+    ]);
+
+    $response->assertStatus(201);
+    $response->assertJsonFragment(['name' => 'ROLE_']);
+});

tests/Feature/SettingControllerTest.php

@@ -0,0 +1,102 @@
+<?php
+
+use App\Models\Role;
+use App\Models\Setting;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+function makeAdminUser(): User
+{
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    return $admin;
+}
+
+it('lists settings and supports key filtering', function (): void {
+    Setting::create(['key' => 'site.name', 'value' => 'SpeedBB']);
+    Setting::create(['key' => 'site.tagline', 'value' => 'Fast']);
+
+    $response = $this->getJson('/api/settings');
+
+    $response->assertOk();
+    $payload = $response->json();
+    expect($payload)->toBeArray();
+    expect(count($payload))->toBeGreaterThanOrEqual(2);
+    $response->assertJsonFragment(['key' => 'site.name', 'value' => 'SpeedBB']);
+    $response->assertJsonFragment(['key' => 'site.tagline', 'value' => 'Fast']);
+
+    $response = $this->getJson('/api/settings?key=site.name');
+    $response->assertOk();
+    $response->assertJsonCount(1);
+    $response->assertJsonFragment(['key' => 'site.name', 'value' => 'SpeedBB']);
+});
+
+it('forbids non-admin setting creation', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/settings', [
+        'key' => 'site.name',
+        'value' => 'SpeedBB',
+    ]);
+
+    $response->assertStatus(403);
+});
+
+it('creates or updates settings as admin', function (): void {
+    $admin = makeAdminUser();
+    Sanctum::actingAs($admin);
+
+    $response = $this->postJson('/api/settings', [
+        'key' => 'site.name',
+        'value' => 'SpeedBB',
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment(['key' => 'site.name', 'value' => 'SpeedBB']);
+
+    $response = $this->postJson('/api/settings', [
+        'key' => 'site.name',
+        'value' => 'SpeedBB 2',
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('settings', [
+        'key' => 'site.name',
+        'value' => 'SpeedBB 2',
+    ]);
+});
+
+it('bulk stores settings as admin', function (): void {
+    $admin = makeAdminUser();
+    Sanctum::actingAs($admin);
+
+    $response = $this->postJson('/api/settings/bulk', [
+        'settings' => [
+            ['key' => 'site.name', 'value' => 'SpeedBB'],
+            ['key' => 'site.tagline', 'value' => 'Fast'],
+        ],
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonCount(2);
+    $this->assertDatabaseHas('settings', [
+        'key' => 'site.tagline',
+        'value' => 'Fast',
+    ]);
+});
+
+it('bulk store forbids non-admin users', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/settings/bulk', [
+        'settings' => [
+            ['key' => 'site.name', 'value' => 'SpeedBB'],
+        ],
+    ]);
+
+    $response->assertStatus(403);
+});

tests/Feature/StatsControllerTest.php

@@ -0,0 +1,85 @@
+<?php
+
+use App\Models\Attachment;
+use App\Models\Forum;
+use App\Models\Post;
+use App\Models\Thread;
+use App\Models\User;
+use Illuminate\Support\Facades\Storage;
+
+it('returns forum statistics summary', function (): void {
+    Storage::fake('public');
+
+    $user = User::factory()->create();
+    $forum = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $child = Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $forum->id,
+        'position' => 1,
+    ]);
+
+    $thread = Thread::create([
+        'forum_id' => $child->id,
+        'user_id' => $user->id,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $user->id,
+        'body' => 'Post',
+    ]);
+
+    Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => $user->id,
+        'disk' => 'local',
+        'path' => 'attachments/threads/'.$thread->id.'/file.pdf',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 123,
+    ]);
+
+    $response = $this->getJson('/api/stats');
+
+    $response->assertOk();
+    $response->assertJsonStructure([
+        'threads',
+        'posts',
+        'users',
+        'attachments',
+        'board_started_at',
+        'attachments_size_bytes',
+        'avatar_directory_size_bytes',
+        'database_size_bytes',
+        'database_server',
+        'gzip_compression',
+        'php_version',
+        'orphan_attachments',
+        'board_version',
+        'posts_per_day',
+        'topics_per_day',
+        'users_per_day',
+        'attachments_per_day',
+    ]);
+
+    $response->assertJsonFragment([
+        'threads' => 1,
+        'users' => 1,
+        'attachments' => 1,
+        'attachments_size_bytes' => 123,
+    ]);
+});

tests/Feature/SystemStatusControllerTest.php

@@ -0,0 +1,13 @@
+<?php
+
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+it('forbids system status for non-admins', function (): void {
+    $user = User::factory()->create();
+
+    Sanctum::actingAs($user);
+    $response = $this->getJson('/api/system/status');
+
+    $response->assertStatus(403);
+});

tests/Feature/SystemUpdateControllerBranchesTest.php

@@ -0,0 +1,462 @@
+<?php
+
+use App\Models\Role;
+use App\Models\User;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Str;
+use Laravel\Sanctum\Sanctum;
+
+function makeAdminForSystemUpdate(): User
+{
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    return $admin;
+}
+
+function withFakeBin(array $scripts, callable $callback): void
+{
+    $dir = storage_path('app/test-bin-' . Str::random(6));
+    if (!is_dir($dir)) {
+        mkdir($dir, 0777, true);
+    }
+
+    foreach ($scripts as $name => $body) {
+        $path = $dir . DIRECTORY_SEPARATOR . $name;
+        file_put_contents($path, $body);
+        chmod($path, 0755);
+    }
+
+    $originalPath = getenv('PATH') ?: '';
+    putenv("PATH={$dir}");
+    $_ENV['PATH'] = $dir;
+    $_SERVER['PATH'] = $dir;
+
+    try {
+        $callback();
+    } finally {
+        putenv("PATH={$originalPath}");
+        $_ENV['PATH'] = $originalPath;
+        $_SERVER['PATH'] = $originalPath;
+        if (is_dir($dir)) {
+            $items = scandir($dir);
+            if (is_array($items)) {
+                foreach ($items as $item) {
+                    if ($item === '.' || $item === '..') {
+                        continue;
+                    }
+                    $path = $dir . DIRECTORY_SEPARATOR . $item;
+                    if (is_file($path)) {
+                        unlink($path);
+                    }
+                }
+            }
+            rmdir($dir);
+        }
+    }
+}
+
+it('uses token auth header and tarball template', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+    putenv('GITEA_TGZ_URL_TEMPLATE=https://git.example.test/tarball/{{TAG}}-{{VERSION}}.tgz');
+    putenv('GITEA_TOKEN=secrettoken');
+
+    $tarballUrl = 'https://git.example.test/tarball/v1.2.3-1.2.3.tgz';
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => '',
+        ], 200),
+        $tarballUrl => Http::response('archive-bytes', 200),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+    File::shouldReceive('put')->andReturnTrue();
+    File::shouldReceive('directories')->andReturn(['/tmp/extract/speedbb']);
+    File::shouldReceive('copyDirectory')->andReturnTrue();
+
+    $artisanPath = base_path('artisan');
+    $originalArtisan = file_get_contents($artisanPath);
+    file_put_contents($artisanPath, "#!/usr/bin/env php\n<?php exit(0);\n");
+    chmod($artisanPath, 0755);
+
+    withFakeBin([
+        'tar' => "#!/bin/sh\nexit 0\n",
+        'composer' => "#!/bin/sh\nexit 0\n",
+        'npm' => "#!/bin/sh\nexit 0\n",
+    ], function () use ($artisanPath, $originalArtisan): void {
+        try {
+            Sanctum::actingAs(makeAdminForSystemUpdate());
+            $response = $this->postJson('/api/system/update');
+
+            $response->assertOk();
+            $response->assertJsonFragment(['tag' => 'v1.2.3']);
+        } finally {
+            file_put_contents($artisanPath, $originalArtisan);
+        }
+    });
+
+    Http::assertSent(function ($request) use ($tarballUrl) {
+        if ($request->url() === $tarballUrl) {
+            return true;
+        }
+        return $request->hasHeader('Authorization', 'token secrettoken');
+    });
+});
+
+it('returns update failed on unexpected exception', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+
+    Http::fake(function () {
+        throw new RuntimeException('boom');
+    });
+
+    Sanctum::actingAs(makeAdminForSystemUpdate());
+    $response = $this->postJson('/api/system/update');
+
+    $response->assertStatus(500);
+    $response->assertJsonFragment(['message' => 'Update failed.']);
+});
+
+it('handles release check failures', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([], 500),
+    ]);
+
+    Sanctum::actingAs(makeAdminForSystemUpdate());
+    $response = $this->postJson('/api/system/update');
+
+    $response->assertStatus(500);
+    $response->assertJsonFragment(['message' => 'Release check failed: 500']);
+});
+
+it('handles missing tag in release response', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => '',
+        ], 200),
+    ]);
+
+    Sanctum::actingAs(makeAdminForSystemUpdate());
+    $response = $this->postJson('/api/system/update');
+
+    $response->assertStatus(500);
+    $response->assertJsonFragment(['message' => 'Release tag not found.']);
+});
+
+it('handles missing tarball url', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+    putenv('GITEA_TGZ_URL_TEMPLATE=');
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => '',
+        ], 200),
+    ]);
+
+    Sanctum::actingAs(makeAdminForSystemUpdate());
+    $response = $this->postJson('/api/system/update');
+
+    $response->assertStatus(500);
+    $response->assertJsonFragment(['message' => 'No tarball URL available.']);
+});
+
+it('handles tarball download failure', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => 'https://git.example.test/archive.tgz',
+        ], 200),
+        'https://git.example.test/archive.tgz' => Http::response('fail', 500),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+
+    Sanctum::actingAs(makeAdminForSystemUpdate());
+    $response = $this->postJson('/api/system/update');
+
+    $response->assertStatus(500);
+    $response->assertJsonFragment(['message' => 'Download failed: 500']);
+});
+
+it('handles extract failure', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => 'https://git.example.test/archive.tgz',
+        ], 200),
+        'https://git.example.test/archive.tgz' => Http::response('archive-bytes', 200),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+    File::shouldReceive('put')->andReturnTrue();
+
+    withFakeBin([
+        'tar' => "#!/bin/sh\nexit 1\n",
+        'composer' => "#!/bin/sh\nexit 0\n",
+        'npm' => "#!/bin/sh\nexit 0\n",
+    ], function (): void {
+        Sanctum::actingAs(makeAdminForSystemUpdate());
+        $response = $this->postJson('/api/system/update');
+
+        $response->assertStatus(500);
+        $response->assertJsonFragment(['message' => 'Failed to extract archive.']);
+    });
+});
+
+it('handles missing extracted folder', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => 'https://git.example.test/archive.tgz',
+        ], 200),
+        'https://git.example.test/archive.tgz' => Http::response('archive-bytes', 200),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+    File::shouldReceive('put')->andReturnTrue();
+    File::shouldReceive('directories')->andReturn([]);
+
+    withFakeBin([
+        'tar' => "#!/bin/sh\nexit 0\n",
+        'composer' => "#!/bin/sh\nexit 0\n",
+        'npm' => "#!/bin/sh\nexit 0\n",
+    ], function (): void {
+        Sanctum::actingAs(makeAdminForSystemUpdate());
+        $response = $this->postJson('/api/system/update');
+
+        $response->assertStatus(500);
+        $response->assertJsonFragment(['message' => 'No extracted folder found.']);
+    });
+});
+
+it('handles rsync failure when available', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => 'https://git.example.test/archive.tgz',
+        ], 200),
+        'https://git.example.test/archive.tgz' => Http::response('archive-bytes', 200),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+    File::shouldReceive('put')->andReturnTrue();
+    File::shouldReceive('directories')->andReturn(['/tmp/extract/speedbb']);
+
+    withFakeBin([
+        'tar' => "#!/bin/sh\nexit 0\n",
+        'rsync' => "#!/bin/sh\nexit 1\n",
+        'composer' => "#!/bin/sh\nexit 0\n",
+        'npm' => "#!/bin/sh\nexit 0\n",
+    ], function (): void {
+        Sanctum::actingAs(makeAdminForSystemUpdate());
+        $response = $this->postJson('/api/system/update');
+
+        $response->assertStatus(500);
+        $response->assertJsonFragment(['message' => 'rsync failed.']);
+    });
+});
+
+it('handles composer install failure after copyDirectory', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => 'https://git.example.test/archive.tgz',
+        ], 200),
+        'https://git.example.test/archive.tgz' => Http::response('archive-bytes', 200),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+    File::shouldReceive('put')->andReturnTrue();
+    File::shouldReceive('directories')->andReturn(['/tmp/extract/speedbb']);
+    File::shouldReceive('copyDirectory')->andReturnTrue();
+
+    withFakeBin([
+        'tar' => "#!/bin/sh\nexit 0\n",
+        'composer' => "#!/bin/sh\nexit 1\n",
+        'npm' => "#!/bin/sh\nexit 0\n",
+    ], function (): void {
+        Sanctum::actingAs(makeAdminForSystemUpdate());
+        $response = $this->postJson('/api/system/update');
+
+        $response->assertStatus(500);
+        $response->assertJsonFragment(['message' => 'Composer install failed.']);
+    });
+});
+
+it('handles npm install failure', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => 'https://git.example.test/archive.tgz',
+        ], 200),
+        'https://git.example.test/archive.tgz' => Http::response('archive-bytes', 200),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+    File::shouldReceive('put')->andReturnTrue();
+    File::shouldReceive('directories')->andReturn(['/tmp/extract/speedbb']);
+    File::shouldReceive('copyDirectory')->andReturnTrue();
+
+    withFakeBin([
+        'tar' => "#!/bin/sh\nexit 0\n",
+        'composer' => "#!/bin/sh\nexit 0\n",
+        'npm' => "#!/bin/sh\nif [ \"$1\" = \"install\" ]; then exit 1; fi\nexit 0\n",
+    ], function (): void {
+        Sanctum::actingAs(makeAdminForSystemUpdate());
+        $response = $this->postJson('/api/system/update');
+
+        $response->assertStatus(500);
+        $response->assertJsonFragment(['message' => 'npm install failed.']);
+    });
+});
+
+it('handles npm build failure', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => 'https://git.example.test/archive.tgz',
+        ], 200),
+        'https://git.example.test/archive.tgz' => Http::response('archive-bytes', 200),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+    File::shouldReceive('put')->andReturnTrue();
+    File::shouldReceive('directories')->andReturn(['/tmp/extract/speedbb']);
+    File::shouldReceive('copyDirectory')->andReturnTrue();
+
+    withFakeBin([
+        'tar' => "#!/bin/sh\nexit 0\n",
+        'composer' => "#!/bin/sh\nexit 0\n",
+        'npm' => "#!/bin/sh\nif [ \"$1\" = \"run\" ] && [ \"$2\" = \"build\" ]; then exit 1; fi\nexit 0\n",
+    ], function (): void {
+        Sanctum::actingAs(makeAdminForSystemUpdate());
+        $response = $this->postJson('/api/system/update');
+
+        $response->assertStatus(500);
+        $response->assertJsonFragment(['message' => 'npm run build failed.']);
+    });
+});
+
+it('handles migration failure', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => 'https://git.example.test/archive.tgz',
+        ], 200),
+        'https://git.example.test/archive.tgz' => Http::response('archive-bytes', 200),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+    File::shouldReceive('put')->andReturnTrue();
+    File::shouldReceive('directories')->andReturn(['/tmp/extract/speedbb']);
+    File::shouldReceive('copyDirectory')->andReturnTrue();
+
+    $artisanPath = base_path('artisan');
+    $originalArtisan = file_get_contents($artisanPath);
+    file_put_contents($artisanPath, "#!/usr/bin/env php\n<?php exit(1);\n");
+    chmod($artisanPath, 0755);
+
+    withFakeBin([
+        'tar' => "#!/bin/sh\nexit 0\n",
+        'composer' => "#!/bin/sh\nexit 0\n",
+        'npm' => "#!/bin/sh\nexit 0\n",
+    ], function () use ($artisanPath, $originalArtisan): void {
+        try {
+            Sanctum::actingAs(makeAdminForSystemUpdate());
+            $response = $this->postJson('/api/system/update');
+
+            $response->assertStatus(500);
+            $response->assertJsonFragment(['message' => 'Migrations failed.']);
+        } finally {
+            file_put_contents($artisanPath, $originalArtisan);
+        }
+    });
+});
+
+it('handles fallback copyDirectory update success', function (): void {
+    putenv('GITEA_OWNER=acme');
+    putenv('GITEA_REPO=speedbb');
+    putenv('GITEA_API_BASE=https://git.example.test/api/v1');
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+            'tarball_url' => 'https://git.example.test/archive.tgz',
+        ], 200),
+        'https://git.example.test/archive.tgz' => Http::response('archive-bytes', 200),
+    ]);
+
+    File::shouldReceive('ensureDirectoryExists')->andReturnTrue();
+    File::shouldReceive('put')->andReturnTrue();
+    File::shouldReceive('directories')->andReturn(['/tmp/extract/speedbb']);
+    File::shouldReceive('copyDirectory')->andReturnTrue();
+
+    $artisanPath = base_path('artisan');
+    $originalArtisan = file_get_contents($artisanPath);
+    file_put_contents($artisanPath, "#!/usr/bin/env php\n<?php exit(0);\n");
+    chmod($artisanPath, 0755);
+
+    withFakeBin([
+        'tar' => "#!/bin/sh\nexit 0\n",
+        'composer' => "#!/bin/sh\nexit 0\n",
+        'npm' => "#!/bin/sh\nexit 0\n",
+    ], function () use ($artisanPath, $originalArtisan): void {
+        try {
+            Sanctum::actingAs(makeAdminForSystemUpdate());
+            $response = $this->postJson('/api/system/update');
+
+            $response->assertOk();
+            $response->assertJsonFragment(['message' => 'Update finished.']);
+            $response->assertJsonStructure(['used_rsync']);
+        } finally {
+            file_put_contents($artisanPath, $originalArtisan);
+        }
+    });
+});

tests/Feature/SystemUpdateControllerTest.php

@@ -0,0 +1,31 @@
+<?php
+
+use App\Models\Role;
+use App\Models\User;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Http;
+use Laravel\Sanctum\Sanctum;
+
+it('forbids system update for non-admins', function (): void {
+    $user = User::factory()->create();
+
+    Sanctum::actingAs($user);
+    $response = $this->postJson('/api/system/update');
+
+    $response->assertStatus(403);
+});
+
+it('returns validation error when gitea config is missing', function (): void {
+    putenv('GITEA_OWNER=');
+    putenv('GITEA_REPO=');
+
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    Sanctum::actingAs($admin);
+    $response = $this->postJson('/api/system/update');
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Missing Gitea configuration.']);
+});

tests/Feature/ThreadControllerTest.php

@@ -0,0 +1,272 @@
+<?php
+
+use App\Models\Forum;
+use App\Models\Role;
+use App\Models\Thread;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+beforeEach(function (): void {
+    $parserProp = new ReflectionProperty(\App\Actions\BbcodeFormatter::class, 'parser');
+    $parserProp->setAccessible(true);
+    $parserProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Parser::class)
+            ->shouldReceive('parse')
+            ->andReturn('<r/>')
+            ->getMock()
+    );
+
+    $rendererProp = new ReflectionProperty(\App\Actions\BbcodeFormatter::class, 'renderer');
+    $rendererProp->setAccessible(true);
+    $rendererProp->setValue(
+        \Mockery::mock(\s9e\TextFormatter\Renderer::class)
+            ->shouldReceive('render')
+            ->andReturn('<p></p>')
+            ->getMock()
+    );
+});
+
+afterEach(function (): void {
+    \Mockery::close();
+});
+
+function makeForum(): Forum
+{
+    $category = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    return Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+}
+
+it('creates a thread inside a forum', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $forum = makeForum();
+
+    $response = $this->postJson('/api/threads', [
+        'title' => 'First Thread',
+        'body' => 'Hello world',
+        'forum' => "/api/forums/{$forum->id}",
+    ]);
+
+    $response->assertStatus(201);
+    $response->assertJsonFragment([
+        'title' => 'First Thread',
+        'forum' => "/api/forums/{$forum->id}",
+    ]);
+
+    $this->assertDatabaseHas('threads', [
+        'forum_id' => $forum->id,
+        'user_id' => $user->id,
+        'title' => 'First Thread',
+    ]);
+});
+
+it('rejects creating threads in a category', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $category = Forum::create([
+        'name' => 'Category Only',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    $response = $this->postJson('/api/threads', [
+        'title' => 'Nope',
+        'body' => 'Not allowed',
+        'forum' => "/api/forums/{$category->id}",
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Threads can only be created inside forums.']);
+});
+
+it('requires authentication to update a thread', function (): void {
+    $forum = makeForum();
+    $owner = User::factory()->create();
+
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $owner->id,
+        'title' => 'Original',
+        'body' => '',
+    ]);
+
+    $response = $this->patchJson("/api/threads/{$thread->id}", [
+        'title' => 'Updated',
+        'body' => 'Updated body',
+    ]);
+
+    $response->assertStatus(401);
+});
+
+it('enforces thread update permissions', function (): void {
+    $forum = makeForum();
+    $owner = User::factory()->create();
+    $other = User::factory()->create();
+
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $owner->id,
+        'title' => 'Original',
+        'body' => '',
+    ]);
+
+    Sanctum::actingAs($other);
+    $response = $this->patchJson("/api/threads/{$thread->id}", [
+        'title' => 'Updated',
+        'body' => 'Updated body',
+    ]);
+
+    $response->assertStatus(403);
+
+    Sanctum::actingAs($owner);
+    $response = $this->patchJson("/api/threads/{$thread->id}", [
+        'title' => 'Owner Update',
+        'body' => 'Owner body',
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('threads', [
+        'id' => $thread->id,
+        'title' => 'Owner Update',
+        'body' => 'Owner body',
+    ]);
+
+    $admin = User::factory()->create();
+    $role = Role::create(['name' => 'ROLE_ADMIN', 'color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/threads/{$thread->id}", [
+        'title' => 'Admin Update',
+        'body' => 'Admin body',
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('threads', [
+        'id' => $thread->id,
+        'title' => 'Admin Update',
+        'body' => 'Admin body',
+    ]);
+});
+
+it('enforces solved status permissions', function (): void {
+    $forum = makeForum();
+    $owner = User::factory()->create();
+    $other = User::factory()->create();
+
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $owner->id,
+        'title' => 'Original',
+        'body' => '',
+        'solved' => false,
+    ]);
+
+    Sanctum::actingAs($other);
+    $response = $this->patchJson("/api/threads/{$thread->id}/solved", [
+        'solved' => true,
+    ]);
+
+    $response->assertStatus(403);
+
+    Sanctum::actingAs($owner);
+    $response = $this->patchJson("/api/threads/{$thread->id}/solved", [
+        'solved' => true,
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('threads', [
+        'id' => $thread->id,
+        'solved' => 1,
+    ]);
+});
+
+it('filters threads by forum', function (): void {
+    $forumA = makeForum();
+    $forumB = makeForum();
+
+    $threadA = Thread::create([
+        'forum_id' => $forumA->id,
+        'user_id' => null,
+        'title' => 'Thread A',
+        'body' => '',
+    ]);
+
+    Thread::create([
+        'forum_id' => $forumB->id,
+        'user_id' => null,
+        'title' => 'Thread B',
+        'body' => '',
+    ]);
+
+    $response = $this->getJson("/api/threads?forum=/api/forums/{$forumA->id}");
+
+    $response->assertOk();
+    $response->assertJsonCount(1);
+    $response->assertJsonFragment([
+        'id' => $threadA->id,
+        'title' => 'Thread A',
+    ]);
+});
+
+it('increments views count when showing a thread', function (): void {
+    $forum = makeForum();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Viewed Thread',
+        'body' => '',
+        'views_count' => 0,
+    ]);
+
+    $response = $this->getJson("/api/threads/{$thread->id}");
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $thread->id,
+        'views_count' => 1,
+    ]);
+
+    $thread->refresh();
+    expect($thread->views_count)->toBe(1);
+});
+
+it('soft deletes a thread and tracks deleted_by', function (): void {
+    $forum = makeForum();
+    $user = User::factory()->create();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $user->id,
+        'title' => 'Delete Me',
+        'body' => 'Body',
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->deleteJson("/api/threads/{$thread->id}");
+
+    $response->assertStatus(204);
+    $this->assertSoftDeleted('threads', [
+        'id' => $thread->id,
+    ]);
+    $this->assertDatabaseHas('threads', [
+        'id' => $thread->id,
+        'deleted_by' => $user->id,
+    ]);
+});

tests/Feature/UploadControllerTest.php

@@ -0,0 +1,97 @@
+<?php
+
+use App\Models\Role;
+use App\Models\User;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\Storage;
+use Laravel\Sanctum\Sanctum;
+
+it('requires authentication for avatar upload', function (): void {
+    $response = $this->postJson('/api/user/avatar', [
+        'file' => UploadedFile::fake()->image('avatar.jpg', 100, 100),
+    ]);
+
+    $response->assertStatus(401);
+});
+
+it('uploads avatars for authenticated users', function (): void {
+    Storage::fake('public');
+
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/user/avatar', [
+        'file' => UploadedFile::fake()->image('avatar.jpg', 100, 100),
+    ]);
+
+    $response->assertOk();
+    $path = $response->json('path');
+
+    Storage::disk('public')->assertExists($path);
+});
+
+it('replaces existing avatar when uploading a new one', function (): void {
+    Storage::fake('public');
+
+    $user = User::factory()->create([
+        'avatar_path' => 'avatars/old.png',
+    ]);
+    Storage::disk('public')->put('avatars/old.png', 'old');
+
+    Sanctum::actingAs($user);
+    $response = $this->postJson('/api/user/avatar', [
+        'file' => UploadedFile::fake()->image('avatar.jpg', 100, 100),
+    ]);
+
+    $response->assertOk();
+    Storage::disk('public')->assertMissing('avatars/old.png');
+});
+
+it('forbids logo uploads for non-admins', function (): void {
+    Storage::fake('public');
+
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/uploads/logo', [
+        'file' => UploadedFile::fake()->image('logo.png', 200, 200),
+    ]);
+
+    $response->assertStatus(403);
+});
+
+it('forbids favicon uploads for non-admins', function (): void {
+    Storage::fake('public');
+
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/uploads/favicon', [
+        'file' => UploadedFile::fake()->image('favicon.png', 32, 32),
+    ]);
+
+    $response->assertStatus(403);
+});
+
+it('uploads logos and favicons as admin', function (): void {
+    Storage::fake('public');
+
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    Sanctum::actingAs($admin);
+    $logo = $this->postJson('/api/uploads/logo', [
+        'file' => UploadedFile::fake()->image('logo.png', 200, 200),
+    ]);
+
+    $logo->assertOk();
+    Storage::disk('public')->assertExists($logo->json('path'));
+
+    $favicon = $this->postJson('/api/uploads/favicon', [
+        'file' => UploadedFile::fake()->image('favicon.png', 32, 32),
+    ]);
+
+    $favicon->assertOk();
+    Storage::disk('public')->assertExists($favicon->json('path'));
+});

tests/Feature/UserControllerTest.php

@@ -0,0 +1,287 @@
+<?php
+
+use App\Models\Rank;
+use App\Models\Role;
+use App\Models\User;
+use Laravel\Sanctum\Sanctum;
+
+function makeAdmin(): User
+{
+    $admin = User::factory()->create();
+    $role = Role::firstOrCreate(['name' => 'ROLE_ADMIN'], ['color' => '#111111']);
+    $admin->roles()->attach($role);
+
+    return $admin;
+}
+
+it('requires authentication to list users', function (): void {
+    $response = $this->getJson('/api/users');
+
+    $response->assertStatus(401);
+});
+
+it('lists users with roles and group color', function (): void {
+    $admin = makeAdmin();
+    $role = Role::firstOrCreate(['name' => 'ROLE_MOD'], ['color' => '#ff0000']);
+    $user = User::factory()->create(['name' => 'Alice']);
+    $user->roles()->attach($role);
+
+    Sanctum::actingAs($admin);
+    $response = $this->getJson('/api/users');
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $user->id,
+        'name' => 'Alice',
+        'group_color' => '#ff0000',
+    ]);
+});
+
+it('returns current user profile from me endpoint', function (): void {
+    $user = User::factory()->create(['name' => 'Me']);
+
+    Sanctum::actingAs($user);
+    $response = $this->getJson('/api/user/me');
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $user->id,
+        'name' => 'Me',
+        'email' => $user->email,
+    ]);
+});
+
+it('rejects unauthenticated me requests', function (): void {
+    $response = $this->getJson('/api/user/me');
+
+    $response->assertStatus(401);
+    $response->assertJsonFragment(['message' => 'Unauthenticated.']);
+});
+
+it('returns user profile details', function (): void {
+    $viewer = User::factory()->create();
+    $target = User::factory()->create(['name' => 'ProfileUser']);
+
+    Sanctum::actingAs($viewer);
+    $response = $this->getJson("/api/user/profile/{$target->id}");
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $target->id,
+        'name' => 'ProfileUser',
+    ]);
+});
+
+it('updates user location via updateMe', function (): void {
+    $user = User::factory()->create(['location' => null]);
+
+    Sanctum::actingAs($user);
+    $response = $this->patchJson('/api/user/me', [
+        'location' => '  New York  ',
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $user->id,
+        'location' => 'New York',
+    ]);
+
+    $user->refresh();
+    expect($user->location)->toBe('New York');
+});
+
+it('rejects updateMe when unauthenticated', function (): void {
+    $response = $this->patchJson('/api/user/me', [
+        'location' => 'Somewhere',
+    ]);
+
+    $response->assertStatus(401);
+    $response->assertJsonFragment(['message' => 'Unauthenticated.']);
+});
+
+it('clears location when updateMe receives blank value', function (): void {
+    $user = User::factory()->create(['location' => 'Somewhere']);
+
+    Sanctum::actingAs($user);
+    $response = $this->patchJson('/api/user/me', [
+        'location' => '   ',
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $user->id,
+        'location' => null,
+    ]);
+
+    $user->refresh();
+    expect($user->location)->toBeNull();
+});
+
+it('forbids non-admin rank updates', function (): void {
+    $user = User::factory()->create();
+    $target = User::factory()->create();
+    $rank = Rank::create(['name' => 'Silver']);
+
+    Sanctum::actingAs($user);
+    $response = $this->patchJson("/api/users/{$target->id}/rank", [
+        'rank_id' => $rank->id,
+    ]);
+
+    $response->assertStatus(403);
+});
+
+it('forbids founder rank updates by non-founder admin', function (): void {
+    $admin = makeAdmin();
+    $founderRole = Role::firstOrCreate(['name' => 'ROLE_FOUNDER'], ['color' => '#111111']);
+    $founder = User::factory()->create();
+    $founder->roles()->attach($founderRole);
+    $rank = Rank::create(['name' => 'Founder Rank']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/users/{$founder->id}/rank", [
+        'rank_id' => $rank->id,
+    ]);
+
+    $response->assertStatus(403);
+});
+
+it('allows admins to update user rank', function (): void {
+    $admin = makeAdmin();
+    $target = User::factory()->create();
+    $rank = Rank::create(['name' => 'Gold']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/users/{$target->id}/rank", [
+        'rank_id' => $rank->id,
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonPath('id', $target->id);
+    $response->assertJsonPath('rank.id', $rank->id);
+    $response->assertJsonPath('rank.name', 'Gold');
+
+    $target->refresh();
+    expect($target->rank_id)->toBe($rank->id);
+});
+
+it('rejects update without admin role', function (): void {
+    $user = User::factory()->create();
+    $target = User::factory()->create();
+
+    Sanctum::actingAs($user);
+    $response = $this->patchJson("/api/users/{$target->id}", [
+        'name' => 'New Name',
+        'email' => 'new@example.com',
+        'rank_id' => null,
+    ]);
+
+    $response->assertStatus(403);
+});
+
+it('forbids updating founder user when actor is not founder', function (): void {
+    $admin = makeAdmin();
+    $founderRole = Role::firstOrCreate(['name' => 'ROLE_FOUNDER'], ['color' => '#111111']);
+    $founder = User::factory()->create();
+    $founder->roles()->attach($founderRole);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/users/{$founder->id}", [
+        'name' => 'New Name',
+        'email' => 'new@example.com',
+        'rank_id' => null,
+    ]);
+
+    $response->assertStatus(403);
+});
+
+it('rejects assigning founder role for non-founder admin', function (): void {
+    $admin = makeAdmin();
+    $target = User::factory()->create();
+    Role::firstOrCreate(['name' => 'ROLE_FOUNDER'], ['color' => '#111111']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/users/{$target->id}", [
+        'name' => 'New Name',
+        'email' => 'new@example.com',
+        'rank_id' => null,
+        'roles' => ['ROLE_FOUNDER'],
+    ]);
+
+    $response->assertStatus(403);
+    $response->assertJsonFragment(['message' => 'Forbidden']);
+});
+
+it('rejects duplicate canonical names', function (): void {
+    $admin = makeAdmin();
+    User::factory()->create([
+        'name' => 'Dupe',
+        'name_canonical' => 'dupe',
+        'email' => 'dupe@example.com',
+    ]);
+    $target = User::factory()->create([
+        'name' => 'Other',
+        'name_canonical' => 'other',
+        'email' => 'other@example.com',
+    ]);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/users/{$target->id}", [
+        'name' => 'Dupe',
+        'email' => 'other@example.com',
+        'rank_id' => null,
+    ]);
+
+    $response->assertStatus(422);
+    $response->assertJsonFragment(['message' => 'Name already exists.']);
+});
+
+it('normalizes roles and updates group color', function (): void {
+    $admin = makeAdmin();
+    $target = User::factory()->create([
+        'name' => 'Target',
+        'email' => 'target@example.com',
+    ]);
+
+    Role::firstOrCreate(['name' => 'ROLE_MOD'], ['color' => '#00ff00']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/users/{$target->id}", [
+        'name' => 'Target',
+        'email' => 'target@example.com',
+        'rank_id' => null,
+        'roles' => ['ROLE_MOD'],
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment(['group_color' => '#00ff00']);
+});
+
+it('updates user name and email as admin', function (): void {
+    $admin = makeAdmin();
+    $target = User::factory()->create([
+        'name' => 'Old Name',
+        'email' => 'old@example.com',
+        'email_verified_at' => now(),
+    ]);
+    Role::firstOrCreate(['name' => 'ROLE_MOD'], ['color' => '#00aa00']);
+
+    Sanctum::actingAs($admin);
+    $response = $this->patchJson("/api/users/{$target->id}", [
+        'name' => 'New Name',
+        'email' => 'new@example.com',
+        'rank_id' => null,
+        'roles' => ['ROLE_MOD'],
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'id' => $target->id,
+        'name' => 'New Name',
+        'email' => 'new@example.com',
+    ]);
+
+    $target->refresh();
+    expect($target->name)->toBe('New Name');
+    expect($target->email)->toBe('new@example.com');
+    expect($target->email_verified_at)->toBeNull();
+});

tests/Feature/UserSettingControllerTest.php

@@ -0,0 +1,63 @@
+<?php
+
+use App\Models\User;
+use App\Models\UserSetting;
+use Laravel\Sanctum\Sanctum;
+
+it('lists user settings with optional key filter', function (): void {
+    $user = User::factory()->create();
+    $other = User::factory()->create();
+
+    UserSetting::create([
+        'user_id' => $user->id,
+        'key' => 'editor',
+        'value' => ['theme' => 'dark'],
+    ]);
+
+    UserSetting::create([
+        'user_id' => $user->id,
+        'key' => 'notifications',
+        'value' => ['email' => true],
+    ]);
+
+    UserSetting::create([
+        'user_id' => $other->id,
+        'key' => 'editor',
+        'value' => ['theme' => 'light'],
+    ]);
+
+    Sanctum::actingAs($user);
+    $response = $this->getJson('/api/user-settings');
+
+    $response->assertOk();
+    $response->assertJsonCount(2);
+
+    $response = $this->getJson('/api/user-settings?key=editor');
+    $response->assertOk();
+    $response->assertJsonCount(1);
+    $response->assertJsonFragment(['key' => 'editor']);
+});
+
+it('creates or updates user settings', function (): void {
+    $user = User::factory()->create();
+    Sanctum::actingAs($user);
+
+    $response = $this->postJson('/api/user-settings', [
+        'key' => 'editor',
+        'value' => ['theme' => 'dark'],
+    ]);
+
+    $response->assertOk();
+    $response->assertJsonFragment(['key' => 'editor']);
+
+    $response = $this->postJson('/api/user-settings', [
+        'key' => 'editor',
+        'value' => ['theme' => 'light'],
+    ]);
+
+    $response->assertOk();
+    $this->assertDatabaseHas('user_settings', [
+        'user_id' => $user->id,
+        'key' => 'editor',
+    ]);
+});

tests/Feature/VersionCheckControllerTest.php

@@ -0,0 +1,107 @@
+<?php
+
+use App\Models\Setting;
+use Illuminate\Support\Facades\Http;
+
+function setGiteaEnv(?string $owner, ?string $repo, ?string $apiBase = null, ?string $token = null): void
+{
+    $pairs = [
+        'GITEA_OWNER' => $owner,
+        'GITEA_REPO' => $repo,
+        'GITEA_API_BASE' => $apiBase,
+        'GITEA_TOKEN' => $token,
+    ];
+
+    foreach ($pairs as $key => $value) {
+        if ($value === null || $value === '') {
+            putenv("{$key}=");
+            unset($_ENV[$key], $_SERVER[$key]);
+        } else {
+            putenv("{$key}={$value}");
+            $_ENV[$key] = $value;
+            $_SERVER[$key] = $value;
+        }
+    }
+}
+
+it('returns error when gitea config missing', function (): void {
+    setGiteaEnv(null, null);
+
+    Setting::updateOrCreate(['key' => 'version'], ['value' => '1.0.0']);
+
+    $response = $this->getJson('/api/version/check');
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'current_version' => '1.0.0',
+        'latest_tag' => null,
+    ]);
+});
+
+it('checks latest release and reports status', function (): void {
+    setGiteaEnv('acme', 'speedbb', 'https://git.example.test/api/v1', 'secrettoken');
+
+    Setting::updateOrCreate(['key' => 'version'], ['value' => '1.2.3']);
+    Setting::updateOrCreate(['key' => 'build'], ['value' => '7']);
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'tag_name' => 'v1.2.3',
+        ], 200),
+    ]);
+
+    $response = $this->getJson('/api/version/check');
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'current_version' => '1.2.3',
+        'latest_tag' => 'v1.2.3',
+        'is_latest' => true,
+    ]);
+
+    Http::assertSent(function ($request) {
+        return $request->hasHeader('Authorization', 'token secrettoken');
+    });
+});
+
+it('handles failed release responses', function (): void {
+    setGiteaEnv('acme', 'speedbb', 'https://git.example.test/api/v1');
+
+    Setting::updateOrCreate(['key' => 'version'], ['value' => '1.2.3']);
+
+    Http::fake([
+        'https://git.example.test/api/v1/repos/acme/speedbb/releases/latest' => Http::response([
+            'message' => 'oops',
+        ], 500),
+    ]);
+
+    $response = $this->getJson('/api/version/check');
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'current_version' => '1.2.3',
+        'latest_tag' => null,
+        'is_latest' => null,
+        'error' => 'Release check failed: 500',
+    ]);
+});
+
+it('handles release check exceptions', function (): void {
+    setGiteaEnv('acme', 'speedbb', 'https://git.example.test/api/v1');
+
+    Setting::updateOrCreate(['key' => 'version'], ['value' => '1.2.3']);
+
+    Http::fake(function () {
+        throw new RuntimeException('boom');
+    });
+
+    $response = $this->getJson('/api/version/check');
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'current_version' => '1.2.3',
+        'latest_tag' => null,
+        'is_latest' => null,
+        'error' => 'Version check failed.',
+    ]);
+});

tests/Feature/VersionControllerTest.php

@@ -0,0 +1,16 @@
+<?php
+
+use App\Models\Setting;
+
+it('returns version and build info', function (): void {
+    Setting::updateOrCreate(['key' => 'version'], ['value' => '1.2.3']);
+    Setting::updateOrCreate(['key' => 'build'], ['value' => '42']);
+
+    $response = $this->getJson('/api/version');
+
+    $response->assertOk();
+    $response->assertJsonFragment([
+        'version' => '1.2.3',
+        'build' => 42,
+    ]);
+});

tests/Pest.php

@@ -0,0 +1,5 @@
+<?php
+
+use Illuminate\Foundation\Testing\RefreshDatabase;
+
+uses(Tests\TestCase::class, RefreshDatabase::class)->in('Feature', 'Unit');

tests/Unit/AttachmentControllerUnitTest.php

@@ -0,0 +1,555 @@
+<?php
+
+use App\Http\Controllers\AttachmentController;
+use App\Models\Attachment;
+use App\Models\AttachmentExtension;
+use App\Models\AttachmentGroup;
+use App\Models\Forum;
+use App\Models\Post;
+use App\Models\Thread;
+use App\Models\User;
+use Illuminate\Http\Request;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\Storage;
+use Symfony\Component\HttpKernel\Exception\HttpException;
+
+function makeForumForAttachments(): Forum
+{
+    $category = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+
+    return Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+}
+
+it('store returns unauthorized without user', function (): void {
+    $controller = new AttachmentController();
+    $request = Request::create('/api/attachments', 'POST');
+    $request->setUserResolver(fn () => null);
+
+    $response = $controller->store($request);
+
+    expect($response->getStatusCode())->toBe(401);
+});
+
+it('store returns file missing when file not provided', function (): void {
+    $controller = new AttachmentController();
+    $user = User::factory()->create();
+
+    $request = Request::create('/api/attachments', 'POST', [
+        'thread' => '/api/threads/1',
+    ]);
+    $request->setUserResolver(fn () => $user);
+
+    try {
+        $controller->store($request);
+        $this->fail('Expected ValidationException not thrown.');
+    } catch (Illuminate\Validation\ValidationException $e) {
+        expect($e->errors())->toHaveKey('file');
+    }
+});
+
+it('store returns file missing when request file is null after validation', function (): void {
+    $controller = new AttachmentController();
+    $user = User::factory()->create();
+    $forum = makeForumForAttachments();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $user->id,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    $request = Mockery::mock(Request::class)->makePartial();
+    $request->shouldReceive('user')->andReturn($user);
+    $request->shouldReceive('validate')->andReturn([
+        'thread' => "/api/threads/{$thread->id}",
+        'post' => null,
+        'file' => 'ignored',
+    ]);
+    $request->shouldReceive('file')->andReturn(null);
+
+    $response = $controller->store($request);
+
+    expect($response->getStatusCode())->toBe(422);
+});
+
+it('store rejects disallowed extension and mime and size', function (): void {
+    Storage::fake('local');
+
+    $controller = new AttachmentController();
+    $user = User::factory()->create();
+    $forum = makeForumForAttachments();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $user->id,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    $group = AttachmentGroup::create([
+        'name' => 'Docs',
+        'max_size_kb' => 1,
+        'is_active' => false,
+    ]);
+
+    $ext = AttachmentExtension::create([
+        'extension' => 'pdf',
+        'attachment_group_id' => $group->id,
+        'allowed_mimes' => ['application/pdf'],
+    ]);
+
+    $file = UploadedFile::fake()->create('doc.pdf', 2, 'application/pdf');
+
+    $request = Request::create('/api/attachments', 'POST', [
+        'thread' => "/api/threads/{$thread->id}",
+    ], [], ['file' => $file]);
+    $request->setUserResolver(fn () => $user);
+
+    $response = $controller->store($request);
+
+    expect($response->getStatusCode())->toBe(422);
+
+    $group->is_active = true;
+    $group->save();
+
+    $response = $controller->store($request);
+    expect($response->getStatusCode())->toBe(422);
+
+    $group->max_size_kb = 1000;
+    $group->save();
+
+    $ext->allowed_mimes = ['image/png'];
+    $ext->save();
+
+    $response = $controller->store($request);
+    expect($response->getStatusCode())->toBe(422);
+
+    $ext->allowed_mimes = ['application/pdf'];
+    $ext->save();
+
+    $group->max_size_kb = 0;
+    $group->save();
+
+    $response = $controller->store($request);
+    expect($response->getStatusCode())->toBe(422);
+});
+
+it('store returns forbidden when user cannot attach to post', function (): void {
+    Storage::fake('local');
+
+    $controller = new AttachmentController();
+    $owner = User::factory()->create();
+    $viewer = User::factory()->create();
+    $forum = makeForumForAttachments();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $owner->id,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $owner->id,
+        'body' => 'Post',
+    ]);
+
+    $group = AttachmentGroup::create([
+        'name' => 'Images',
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+
+    AttachmentExtension::create([
+        'extension' => 'png',
+        'attachment_group_id' => $group->id,
+        'allowed_mimes' => ['image/png'],
+    ]);
+
+    $file = UploadedFile::fake()->image('photo.png');
+
+    $request = Request::create('/api/attachments', 'POST', [
+        'post' => "/api/posts/{$post->id}",
+    ], [], ['file' => $file]);
+    $request->setUserResolver(fn () => $viewer);
+
+    $response = $controller->store($request);
+
+    expect($response->getStatusCode())->toBe(403);
+});
+
+it('index filters by post id', function (): void {
+    $controller = new AttachmentController();
+    $forum = makeForumForAttachments();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+    $postA = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => null,
+        'body' => 'Post A',
+    ]);
+    $postB = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => null,
+        'body' => 'Post B',
+    ]);
+
+    Attachment::create([
+        'thread_id' => null,
+        'post_id' => $postA->id,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/posts/'.$postA->id.'/a.txt',
+        'original_name' => 'a.txt',
+        'extension' => 'txt',
+        'mime_type' => 'text/plain',
+        'size_bytes' => 1,
+    ]);
+    Attachment::create([
+        'thread_id' => null,
+        'post_id' => $postB->id,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/posts/'.$postB->id.'/b.txt',
+        'original_name' => 'b.txt',
+        'extension' => 'txt',
+        'mime_type' => 'text/plain',
+        'size_bytes' => 1,
+    ]);
+
+    $request = Request::create('/api/attachments', 'GET', [
+        'post' => "/api/posts/{$postA->id}",
+    ]);
+
+    $response = $controller->index($request);
+
+    expect($response->getStatusCode())->toBe(200);
+    $payload = $response->getData(true);
+    expect(count($payload))->toBe(1);
+    expect($payload[0]['post_id'])->toBe($postA->id);
+});
+
+it('show returns not found when attachment is not viewable', function (): void {
+    $controller = new AttachmentController();
+    $attachment = new Attachment([
+        'disk' => 'local',
+        'path' => 'missing',
+    ]);
+    $attachment->setRawAttributes(['id' => 1, 'deleted_at' => now()]);
+
+    $response = $controller->show($attachment);
+
+    expect($response->getStatusCode())->toBe(404);
+});
+
+it('show returns attachment when viewable', function (): void {
+    $controller = new AttachmentController();
+    $forum = makeForumForAttachments();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+    $attachment = Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/threads/'.$thread->id.'/file.pdf',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    $response = $controller->show($attachment);
+
+    expect($response->getStatusCode())->toBe(200);
+});
+
+it('download aborts when file missing or not viewable', function (): void {
+    Storage::fake('local');
+
+    $controller = new AttachmentController();
+    $forum = makeForumForAttachments();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+    $attachment = Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/threads/'.$thread->id.'/missing.pdf',
+        'original_name' => 'missing.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    expect(fn () => $controller->download($attachment))->toThrow(HttpException::class);
+});
+
+it('download aborts when attachment is not viewable', function (): void {
+    Storage::fake('local');
+
+    $controller = new AttachmentController();
+    $attachment = Attachment::create([
+        'thread_id' => null,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/threads/1/missing.pdf',
+        'original_name' => 'missing.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    expect(fn () => $controller->download($attachment))->toThrow(HttpException::class);
+});
+
+it('thumbnail aborts when missing path or file', function (): void {
+    Storage::fake('local');
+
+    $controller = new AttachmentController();
+    $forum = makeForumForAttachments();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+    $attachment = Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/threads/'.$thread->id.'/file.pdf',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    expect(fn () => $controller->thumbnail($attachment))->toThrow(HttpException::class);
+
+    $attachment->thumbnail_path = 'attachments/threads/'.$thread->id.'/thumb.jpg';
+    $attachment->save();
+
+    expect(fn () => $controller->thumbnail($attachment))->toThrow(HttpException::class);
+});
+
+it('thumbnail aborts when attachment is not viewable', function (): void {
+    Storage::fake('local');
+
+    $controller = new AttachmentController();
+    $attachment = Attachment::create([
+        'thread_id' => null,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/threads/1/file.pdf',
+        'thumbnail_path' => 'attachments/threads/1/thumb.jpg',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    expect(fn () => $controller->thumbnail($attachment))->toThrow(HttpException::class);
+});
+
+it('destroy returns unauthorized or forbidden', function (): void {
+    $controller = new AttachmentController();
+    $attachment = new Attachment(['user_id' => 999]);
+
+    $request = Request::create('/api/attachments/1', 'DELETE');
+    $request->setUserResolver(fn () => null);
+    $response = $controller->destroy($request, $attachment);
+    expect($response->getStatusCode())->toBe(401);
+
+    $user = User::factory()->create();
+    $request->setUserResolver(fn () => $user);
+    $response = $controller->destroy($request, $attachment);
+    expect($response->getStatusCode())->toBe(403);
+});
+
+it('private helpers cover parse and match branches', function (): void {
+    $controller = new AttachmentController();
+
+    $refThread = new ReflectionMethod($controller, 'parseThreadId');
+    $refThread->setAccessible(true);
+    $refPost = new ReflectionMethod($controller, 'parsePostId');
+    $refPost->setAccessible(true);
+    $refMatch = new ReflectionMethod($controller, 'matchesAllowed');
+    $refMatch->setAccessible(true);
+    $refResolve = new ReflectionMethod($controller, 'resolveExtension');
+    $refResolve->setAccessible(true);
+
+    expect($refThread->invoke($controller, null))->toBeNull();
+    expect($refThread->invoke($controller, '/threads/12'))->toBe(12);
+    expect($refThread->invoke($controller, '5'))->toBe(5);
+    expect($refThread->invoke($controller, 'abc'))->toBeNull();
+
+    expect($refPost->invoke($controller, null))->toBeNull();
+    expect($refPost->invoke($controller, '/posts/7'))->toBe(7);
+    expect($refPost->invoke($controller, '9'))->toBe(9);
+    expect($refPost->invoke($controller, 'nope'))->toBeNull();
+
+    expect($refMatch->invoke($controller, 'image/png', null))->toBeTrue();
+    expect($refMatch->invoke($controller, 'image/png', []))->toBeTrue();
+    expect($refMatch->invoke($controller, 'image/png', ['image/jpeg']))->toBeFalse();
+    expect($refMatch->invoke($controller, 'image/png', ['image/png']))->toBeTrue();
+
+    expect($refResolve->invoke($controller, ''))->toBeNull();
+});
+
+it('canViewAttachment handles trashed and missing parents', function (): void {
+    $controller = new AttachmentController();
+
+    $forum = makeForumForAttachments();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    $attachment = Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/threads/'.$thread->id.'/file.pdf',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    $refView = new ReflectionMethod($controller, 'canViewAttachment');
+    $refView->setAccessible(true);
+
+    expect($refView->invoke($controller, $attachment))->toBeTrue();
+
+    $attachment->delete();
+    expect($refView->invoke($controller, $attachment))->toBeFalse();
+
+    $attachment->restore();
+    $thread->delete();
+    expect($refView->invoke($controller, $attachment))->toBeFalse();
+
+    $thread->restore();
+
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => null,
+        'body' => 'Post',
+    ]);
+    $attachment->post_id = $post->id;
+    $attachment->thread_id = null;
+    $attachment->save();
+    expect($refView->invoke($controller, $attachment))->toBeTrue();
+
+    $post->delete();
+    expect($refView->invoke($controller, $attachment))->toBeFalse();
+
+    $attachment->post_id = null;
+    $attachment->thread_id = null;
+    $attachment->save();
+    expect($refView->invoke($controller, $attachment))->toBeFalse();
+});
+
+it('serializeAttachment returns thumbnail_url null when missing', function (): void {
+    $controller = new AttachmentController();
+
+    $attachment = new Attachment([
+        'id' => 1,
+        'thread_id' => null,
+        'post_id' => null,
+        'extension' => 'pdf',
+        'original_name' => 'file.pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    $ref = new ReflectionMethod($controller, 'serializeAttachment');
+    $ref->setAccessible(true);
+
+    $payload = $ref->invoke($controller, $attachment);
+
+    expect($payload['thumbnail_url'])->toBeNull();
+    expect($payload['is_image'])->toBeFalse();
+});
+
+it('serializeAttachment includes thumbnail url when present', function (): void {
+    $controller = new AttachmentController();
+
+    $attachment = new Attachment([
+        'id' => 2,
+        'thread_id' => null,
+        'post_id' => null,
+        'extension' => 'png',
+        'original_name' => 'file.png',
+        'mime_type' => 'image/png',
+        'thumbnail_path' => 'thumbs/file.png',
+        'size_bytes' => 10,
+    ]);
+
+    $ref = new ReflectionMethod($controller, 'serializeAttachment');
+    $ref->setAccessible(true);
+
+    $payload = $ref->invoke($controller, $attachment);
+
+    expect($payload['thumbnail_url'])->toContain('/thumbnail');
+    expect($payload['is_image'])->toBeTrue();
+});
+
+it('canManageAttachments handles null user and admin', function (): void {
+    $controller = new AttachmentController();
+    $ref = new ReflectionMethod($controller, 'canManageAttachments');
+    $ref->setAccessible(true);
+
+    expect($ref->invoke($controller, null, 1))->toBeFalse();
+
+    $admin = User::factory()->create();
+    $role = \App\Models\Role::create(['name' => 'ROLE_ADMIN']);
+    $admin->roles()->attach($role);
+
+    expect($ref->invoke($controller, $admin, 999))->toBeTrue();
+});

tests/Unit/AttachmentExtensionControllerUnitTest.php

@@ -0,0 +1,174 @@
+<?php
+
+use App\Http\Controllers\AttachmentExtensionController;
+use App\Models\Attachment;
+use App\Models\AttachmentExtension;
+use App\Models\AttachmentGroup;
+use App\Models\Role;
+use App\Models\User;
+use Illuminate\Http\Request;
+
+function makeAdminUserForExtensions(): User
+{
+    $admin = User::factory()->create();
+    $role = Role::create(['name' => 'ROLE_ADMIN']);
+    $admin->roles()->attach($role);
+    return $admin;
+}
+
+it('index returns forbidden for non admin', function (): void {
+    $controller = new AttachmentExtensionController();
+    $request = Request::create('/api/attachment-extensions', 'GET');
+    $request->setUserResolver(fn () => null);
+
+    $response = $controller->index($request);
+
+    expect($response->getStatusCode())->toBe(403);
+});
+
+it('store update destroy return forbidden for non admin', function (): void {
+    $controller = new AttachmentExtensionController();
+    $user = User::factory()->create();
+
+    $store = Request::create('/api/attachment-extensions', 'POST', [
+        'extension' => 'png',
+    ]);
+    $store->setUserResolver(fn () => $user);
+    $response = $controller->store($store);
+    expect($response->getStatusCode())->toBe(403);
+
+    $extension = AttachmentExtension::create(['extension' => 'gif']);
+
+    $update = Request::create('/api/attachment-extensions/'.$extension->id, 'PATCH', [
+        'allowed_mimes' => ['image/gif'],
+    ]);
+    $update->setUserResolver(fn () => $user);
+    $response = $controller->update($update, $extension);
+    expect($response->getStatusCode())->toBe(403);
+
+    $destroy = Request::create('/api/attachment-extensions/'.$extension->id, 'DELETE');
+    $destroy->setUserResolver(fn () => $user);
+    $response = $controller->destroy($destroy, $extension);
+    expect($response->getStatusCode())->toBe(403);
+});
+
+it('store rejects invalid or duplicate extension', function (): void {
+    $controller = new AttachmentExtensionController();
+    $admin = makeAdminUserForExtensions();
+
+    $request = Request::create('/api/attachment-extensions', 'POST', [
+        'extension' => '.',
+    ]);
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->store($request);
+    expect($response->getStatusCode())->toBe(422);
+
+    AttachmentExtension::create(['extension' => 'png']);
+
+    $request = Request::create('/api/attachment-extensions', 'POST', [
+        'extension' => 'PNG',
+    ]);
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->store($request);
+    expect($response->getStatusCode())->toBe(422);
+});
+
+it('store and update serialize group info', function (): void {
+    $controller = new AttachmentExtensionController();
+    $admin = makeAdminUserForExtensions();
+
+    $group = AttachmentGroup::create([
+        'name' => 'Images',
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+
+    $request = Request::create('/api/attachment-extensions', 'POST', [
+        'extension' => 'png',
+        'attachment_group_id' => $group->id,
+        'allowed_mimes' => ['image/png'],
+    ]);
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->store($request);
+    expect($response->getStatusCode())->toBe(201);
+
+    $extension = AttachmentExtension::query()->where('extension', 'png')->firstOrFail();
+
+    $request = Request::create('/api/attachment-extensions/'.$extension->id, 'PATCH', [
+        'allowed_mimes' => ['image/png', 'image/webp'],
+    ]);
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->update($request, $extension);
+    expect($response->getStatusCode())->toBe(200);
+    $payload = $response->getData(true);
+    expect($payload['group']['name'])->toBe('Images');
+});
+
+it('destroy returns error when extension in use then succeeds', function (): void {
+    $controller = new AttachmentExtensionController();
+    $admin = makeAdminUserForExtensions();
+
+    $extension = AttachmentExtension::create(['extension' => 'pdf']);
+
+    Attachment::create([
+        'thread_id' => null,
+        'post_id' => null,
+        'attachment_extension_id' => $extension->id,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/test.pdf',
+        'original_name' => 'test.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    $request = Request::create('/api/attachment-extensions/'.$extension->id, 'DELETE');
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->destroy($request, $extension);
+    expect($response->getStatusCode())->toBe(422);
+
+    Attachment::query()->delete();
+
+    $response = $controller->destroy($request, $extension);
+    expect($response->getStatusCode())->toBe(204);
+});
+
+it('public index only returns active grouped extensions', function (): void {
+    $controller = new AttachmentExtensionController();
+
+    $activeGroup = AttachmentGroup::create([
+        'name' => 'Active',
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+    $inactiveGroup = AttachmentGroup::create([
+        'name' => 'Inactive',
+        'max_size_kb' => 100,
+        'is_active' => false,
+    ]);
+
+    AttachmentExtension::create([
+        'extension' => 'png',
+        'attachment_group_id' => $activeGroup->id,
+    ]);
+    AttachmentExtension::create([
+        'extension' => 'zip',
+        'attachment_group_id' => $inactiveGroup->id,
+    ]);
+    AttachmentExtension::create([
+        'extension' => 'orphan',
+        'attachment_group_id' => null,
+    ]);
+
+    $response = $controller->publicIndex();
+    $payload = $response->getData(true);
+
+    expect($payload)->toBe(['png']);
+});

tests/Unit/AttachmentGroupControllerUnitTest.php

@@ -0,0 +1,277 @@
+<?php
+
+use App\Http\Controllers\AttachmentGroupController;
+use App\Models\Attachment;
+use App\Models\AttachmentExtension;
+use App\Models\AttachmentGroup;
+use App\Models\Role;
+use App\Models\User;
+use Illuminate\Http\Request;
+
+function makeAdminForGroupController(): User
+{
+    $admin = User::factory()->create();
+    $role = Role::create(['name' => 'ROLE_ADMIN']);
+    $admin->roles()->attach($role);
+    return $admin;
+}
+
+it('returns forbidden for non admin', function (): void {
+    $controller = new AttachmentGroupController();
+    $user = User::factory()->create();
+
+    $index = Request::create('/api/attachment-groups', 'GET');
+    $index->setUserResolver(fn () => $user);
+    expect($controller->index($index)->getStatusCode())->toBe(403);
+
+    $store = Request::create('/api/attachment-groups', 'POST', [
+        'name' => 'Images',
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+    $store->setUserResolver(fn () => $user);
+    expect($controller->store($store)->getStatusCode())->toBe(403);
+
+    $group = AttachmentGroup::create([
+        'name' => 'Docs',
+        'position' => 1,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+    $update = Request::create('/api/attachment-groups/'.$group->id, 'PATCH', [
+        'name' => 'Docs',
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+    $update->setUserResolver(fn () => $user);
+    expect($controller->update($update, $group)->getStatusCode())->toBe(403);
+
+    $destroy = Request::create('/api/attachment-groups/'.$group->id, 'DELETE');
+    $destroy->setUserResolver(fn () => $user);
+    expect($controller->destroy($destroy, $group)->getStatusCode())->toBe(403);
+
+    $reorder = Request::create('/api/attachment-groups/reorder', 'POST', [
+        'parentId' => null,
+        'orderedIds' => [],
+    ]);
+    $reorder->setUserResolver(fn () => $user);
+    expect($controller->reorder($reorder)->getStatusCode())->toBe(403);
+});
+
+it('stores group and rejects duplicates', function (): void {
+    $controller = new AttachmentGroupController();
+    $admin = makeAdminForGroupController();
+
+    $request = Request::create('/api/attachment-groups', 'POST', [
+        'name' => 'Images',
+        'parent_id' => null,
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->store($request);
+    expect($response->getStatusCode())->toBe(201);
+
+    $response = $controller->store($request);
+    expect($response->getStatusCode())->toBe(422);
+});
+
+it('updates group and handles parent change position', function (): void {
+    $controller = new AttachmentGroupController();
+    $admin = makeAdminForGroupController();
+
+    $parentA = AttachmentGroup::create([
+        'name' => 'Parent A',
+        'position' => 1,
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+    $parentB = AttachmentGroup::create([
+        'name' => 'Parent B',
+        'position' => 2,
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+    $group = AttachmentGroup::create([
+        'name' => 'Docs',
+        'parent_id' => $parentA->id,
+        'position' => 1,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+
+    $request = Request::create('/api/attachment-groups/'.$group->id, 'PATCH', [
+        'name' => 'Docs',
+        'parent_id' => $parentB->id,
+        'max_size_kb' => 10,
+        'is_active' => false,
+    ]);
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->update($request, $group);
+    expect($response->getStatusCode())->toBe(200);
+});
+
+it('update rejects duplicate group name', function (): void {
+    $controller = new AttachmentGroupController();
+    $admin = makeAdminForGroupController();
+
+    AttachmentGroup::create([
+        'name' => 'Images',
+        'position' => 1,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+    $group = AttachmentGroup::create([
+        'name' => 'Docs',
+        'position' => 2,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+
+    $request = Request::create('/api/attachment-groups/'.$group->id, 'PATCH', [
+        'name' => 'images',
+        'parent_id' => null,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->update($request, $group);
+    expect($response->getStatusCode())->toBe(422);
+});
+
+it('destroy returns errors for in-use group', function (): void {
+    $controller = new AttachmentGroupController();
+    $admin = makeAdminForGroupController();
+
+    $group = AttachmentGroup::create([
+        'name' => 'Images',
+        'position' => 1,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+    AttachmentExtension::create([
+        'extension' => 'png',
+        'attachment_group_id' => $group->id,
+    ]);
+
+    $request = Request::create('/api/attachment-groups/'.$group->id, 'DELETE');
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->destroy($request, $group);
+    expect($response->getStatusCode())->toBe(422);
+
+    AttachmentExtension::query()->delete();
+    Attachment::create([
+        'thread_id' => null,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => $group->id,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => 'attachments/test.txt',
+        'original_name' => 'test.txt',
+        'extension' => 'txt',
+        'mime_type' => 'text/plain',
+        'size_bytes' => 1,
+    ]);
+
+    $response = $controller->destroy($request, $group);
+    expect($response->getStatusCode())->toBe(422);
+});
+
+it('destroy deletes empty group', function (): void {
+    $controller = new AttachmentGroupController();
+    $admin = makeAdminForGroupController();
+
+    $group = AttachmentGroup::create([
+        'name' => 'Empty',
+        'position' => 1,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+
+    $request = Request::create('/api/attachment-groups/'.$group->id, 'DELETE');
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->destroy($request, $group);
+    expect($response->getStatusCode())->toBe(204);
+});
+
+it('reorders groups with string parent id handling', function (): void {
+    $controller = new AttachmentGroupController();
+    $admin = makeAdminForGroupController();
+
+    $groupA = AttachmentGroup::create([
+        'name' => 'A',
+        'position' => 1,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+    $groupB = AttachmentGroup::create([
+        'name' => 'B',
+        'position' => 2,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+
+    $request = Request::create('/api/attachment-groups/reorder', 'POST', [
+        'parentId' => 'null',
+        'orderedIds' => [$groupB->id, $groupA->id],
+    ]);
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->reorder($request);
+    expect($response->getStatusCode())->toBe(200);
+    $groupA->refresh();
+    $groupB->refresh();
+    expect($groupB->position)->toBe(1);
+    expect($groupA->position)->toBe(2);
+});
+
+it('reorders groups with numeric parent id string', function (): void {
+    $controller = new AttachmentGroupController();
+    $admin = makeAdminForGroupController();
+
+    $parent = AttachmentGroup::create([
+        'name' => 'Parent',
+        'position' => 1,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+    $groupA = AttachmentGroup::create([
+        'name' => 'A',
+        'parent_id' => $parent->id,
+        'position' => 1,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+    $groupB = AttachmentGroup::create([
+        'name' => 'B',
+        'parent_id' => $parent->id,
+        'position' => 2,
+        'max_size_kb' => 10,
+        'is_active' => true,
+    ]);
+
+    $request = Request::create('/api/attachment-groups/reorder', 'POST', [
+        'parentId' => (string) $parent->id,
+        'orderedIds' => [$groupB->id, $groupA->id],
+    ]);
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->reorder($request);
+    expect($response->getStatusCode())->toBe(200);
+});
+
+it('normalizeParentId handles empty and null values', function (): void {
+    $controller = new AttachmentGroupController();
+    $ref = new ReflectionMethod($controller, 'normalizeParentId');
+    $ref->setAccessible(true);
+
+    expect($ref->invoke($controller, ''))->toBeNull();
+    expect($ref->invoke($controller, 'null'))->toBeNull();
+    expect($ref->invoke($controller, null))->toBeNull();
+});

tests/Unit/AttachmentGroupModelTest.php

@@ -0,0 +1,33 @@
+<?php
+
+use App\Models\AttachmentExtension;
+use App\Models\AttachmentGroup;
+
+it('exposes attachment group hierarchy and extensions', function (): void {
+    $parent = AttachmentGroup::create([
+        'name' => 'Parent',
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+
+    $child = AttachmentGroup::create([
+        'name' => 'Child',
+        'parent_id' => $parent->id,
+        'position' => 1,
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+
+    $extension = AttachmentExtension::create([
+        'extension' => 'png',
+        'attachment_group_id' => $parent->id,
+        'allowed_mimes' => ['image/png'],
+    ]);
+
+    $parent->load(['children', 'extensions']);
+    $child->load('parent');
+
+    expect($parent->children->first()->id)->toBe($child->id);
+    expect($parent->extensions->first()->id)->toBe($extension->id);
+    expect($child->parent?->id)->toBe($parent->id);
+});

tests/Unit/AttachmentModelTest.php

@@ -0,0 +1,72 @@
+<?php
+
+use App\Models\Attachment;
+use App\Models\AttachmentExtension;
+use App\Models\AttachmentGroup;
+use App\Models\Forum;
+use App\Models\Post;
+use App\Models\Thread;
+use App\Models\User;
+
+it('exposes attachment relationships', function (): void {
+    $category = Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+
+    $user = User::factory()->create();
+    $thread = Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => $user->id,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+    $post = Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => $user->id,
+        'body' => 'Post',
+    ]);
+
+    $group = AttachmentGroup::create([
+        'name' => 'Docs',
+        'max_size_kb' => 100,
+        'is_active' => true,
+    ]);
+    $extension = AttachmentExtension::create([
+        'extension' => 'pdf',
+        'attachment_group_id' => $group->id,
+        'allowed_mimes' => ['application/pdf'],
+    ]);
+
+    $attachment = Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => $post->id,
+        'attachment_extension_id' => $extension->id,
+        'attachment_group_id' => $group->id,
+        'user_id' => $user->id,
+        'disk' => 'local',
+        'path' => 'attachments/posts/'.$post->id.'/file.pdf',
+        'original_name' => 'file.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    $attachment->load(['thread', 'post', 'extension', 'group', 'user']);
+
+    expect($attachment->thread?->id)->toBe($thread->id);
+    expect($attachment->post?->id)->toBe($post->id);
+    expect($attachment->extension()->first()?->id)->toBe($extension->id);
+    expect($attachment->group()->first()?->id)->toBe($group->id);
+    expect($attachment->user?->id)->toBe($user->id);
+});

tests/Unit/AttachmentThumbnailServiceBranchesTest.php

@@ -0,0 +1,214 @@
+<?php
+
+namespace App\Services {
+    if (!isset($GLOBALS['attachment_thumbnail_overrides'])) {
+        $GLOBALS['attachment_thumbnail_overrides'] = [
+            'force_imagecreatetruecolor_fail' => false,
+            'force_imagejpeg_fail' => false,
+            'force_imagecreatefromjpeg_fail' => false,
+            'fake_getimagesize' => null,
+        ];
+    }
+
+    if (!function_exists(__NAMESPACE__ . '\\imagecreatetruecolor')) {
+        function imagecreatetruecolor($width, $height)
+        {
+            if (!empty($GLOBALS['attachment_thumbnail_overrides']['force_imagecreatetruecolor_fail'])) {
+                return false;
+            }
+            return \imagecreatetruecolor($width, $height);
+        }
+    }
+
+    if (!function_exists(__NAMESPACE__ . '\\imagecreatefromjpeg')) {
+        function imagecreatefromjpeg($path)
+        {
+            if (!empty($GLOBALS['attachment_thumbnail_overrides']['force_imagecreatefromjpeg_fail'])) {
+                return false;
+            }
+            return \imagecreatefromjpeg($path);
+        }
+    }
+
+    if (!function_exists(__NAMESPACE__ . '\\getimagesize')) {
+        function getimagesize($path)
+        {
+            $override = $GLOBALS['attachment_thumbnail_overrides']['fake_getimagesize'] ?? null;
+            if ($override !== null) {
+                return $override;
+            }
+            return \getimagesize($path);
+        }
+    }
+
+    if (!function_exists(__NAMESPACE__ . '\\imagejpeg')) {
+        function imagejpeg($image, $to = null, $quality = null)
+        {
+            if (!empty($GLOBALS['attachment_thumbnail_overrides']['force_imagejpeg_fail'])) {
+                return false;
+            }
+            if ($quality === null) {
+                return \imagejpeg($image, $to);
+            }
+            return \imagejpeg($image, $to, $quality);
+        }
+    }
+}
+
+namespace {
+    use App\Models\Attachment;
+    use App\Models\Forum;
+    use App\Models\Post;
+    use App\Models\Setting;
+    use App\Models\Thread;
+    use App\Services\AttachmentThumbnailService;
+    use Illuminate\Http\UploadedFile;
+    use Illuminate\Support\Facades\Storage;
+
+    if (!function_exists('imagewebp')) {
+        function imagewebp($image, $to = null, $quality = null)
+        {
+            return false;
+        }
+    }
+
+    beforeEach(function (): void {
+        $GLOBALS['attachment_thumbnail_overrides'] = [
+            'force_imagecreatetruecolor_fail' => false,
+            'force_imagejpeg_fail' => false,
+            'force_imagecreatefromjpeg_fail' => false,
+            'fake_getimagesize' => null,
+        ];
+    });
+
+    it('uses misc scope for attachments without thread or post', function (): void {
+        if (!function_exists('imagecreatetruecolor')) {
+            $this->markTestSkipped('GD extension not available.');
+        }
+
+        Storage::fake('local');
+
+        Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+        Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+        Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+
+        $image = UploadedFile::fake()->image('photo.jpg', 800, 600);
+        $path = 'attachments/misc/photo.jpg';
+        Storage::disk('local')->put($path, file_get_contents($image->getPathname()));
+
+        $attachment = Attachment::create([
+            'thread_id' => null,
+            'post_id' => null,
+            'attachment_extension_id' => null,
+            'attachment_group_id' => null,
+            'user_id' => null,
+            'disk' => 'local',
+            'path' => $path,
+            'original_name' => 'photo.jpg',
+            'extension' => 'jpg',
+            'mime_type' => 'image/jpeg',
+            'size_bytes' => 1234,
+        ]);
+
+        $service = new AttachmentThumbnailService();
+        $result = $service->createForAttachment($attachment, true);
+
+        expect($result)->not->toBeNull();
+        expect($result['path'])->toContain('attachments/misc/thumbs/');
+    });
+
+    it('returns null when image dimensions are zero', function (): void {
+        Storage::fake('local');
+
+        Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+        Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+        Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+
+        $GLOBALS['attachment_thumbnail_overrides']['fake_getimagesize'] = [0, 0, IMAGETYPE_JPEG];
+
+        $service = new AttachmentThumbnailService();
+        $file = UploadedFile::fake()->image('photo.jpg', 800, 600);
+
+        $result = $service->createForUpload($file, 'threads/1', 'local');
+
+        expect($result)->toBeNull();
+    });
+
+    it('returns null when thumbnail image creation fails', function (): void {
+        if (!function_exists('imagecreatetruecolor')) {
+            $this->markTestSkipped('GD extension not available.');
+        }
+
+        Storage::fake('local');
+
+        Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+        Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+        Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+
+        $GLOBALS['attachment_thumbnail_overrides']['force_imagecreatetruecolor_fail'] = true;
+
+        $service = new AttachmentThumbnailService();
+        $file = UploadedFile::fake()->image('photo.jpg', 800, 600);
+
+        $result = $service->createForUpload($file, 'threads/1', 'local');
+
+        expect($result)->toBeNull();
+    });
+
+    it('returns null when renderer fails to encode', function (): void {
+        if (!function_exists('imagecreatetruecolor')) {
+            $this->markTestSkipped('GD extension not available.');
+        }
+
+        Storage::fake('local');
+
+        Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+        Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+        Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+
+        $GLOBALS['attachment_thumbnail_overrides']['force_imagejpeg_fail'] = true;
+
+        $service = new AttachmentThumbnailService();
+        $file = UploadedFile::fake()->image('photo.jpg', 800, 600);
+
+        $result = $service->createForUpload($file, 'threads/1', 'local');
+
+        expect($result)->toBeNull();
+    });
+
+    it('handles webp branch in image loader', function (): void {
+        $service = new AttachmentThumbnailService();
+        $ref = new ReflectionMethod($service, 'createImageFromFile');
+        $ref->setAccessible(true);
+
+        $temp = tempnam(sys_get_temp_dir(), 'webp');
+        file_put_contents($temp, 'not-a-real-webp');
+
+        $result = $ref->invoke($service, $temp, 'image/webp');
+        expect($result === null || $result === false)->toBeTrue();
+
+        unlink($temp);
+    });
+
+    it('handles webp branch in renderer when available', function (): void {
+        $service = new AttachmentThumbnailService();
+        $ref = new ReflectionMethod($service, 'renderImageBinary');
+        $ref->setAccessible(true);
+
+        $image = \imagecreatetruecolor(10, 10);
+        $data = $ref->invoke($service, $image, 'image/webp', 80);
+
+        expect($data === null || is_string($data))->toBeTrue();
+        imagedestroy($image);
+    });
+
+    it('returns default when setting is missing', function (): void {
+        $service = new AttachmentThumbnailService();
+        $ref = new ReflectionMethod($service, 'settingBool');
+        $ref->setAccessible(true);
+
+        $result = $ref->invoke($service, 'attachments.missing_flag', true);
+
+        expect($result)->toBeTrue();
+    });
+}

tests/Unit/AttachmentThumbnailServiceTest.php

@@ -0,0 +1,446 @@
+<?php
+
+use App\Models\Setting;
+use App\Services\AttachmentThumbnailService;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\Storage;
+
+it('returns null for non-images', function (): void {
+    Storage::fake('local');
+
+    $service = new AttachmentThumbnailService();
+    $file = UploadedFile::fake()->create('document.txt', 10, 'text/plain');
+
+    $result = $service->createForUpload($file, 'misc', 'local');
+
+    expect($result)->toBeNull();
+});
+
+it('creates thumbnail for large images', function (): void {
+    if (!function_exists('imagecreatetruecolor')) {
+        $this->markTestSkipped('GD extension not available.');
+    }
+
+    Storage::fake('local');
+
+    Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_quality'], ['value' => '80']);
+
+    $service = new AttachmentThumbnailService();
+    $file = UploadedFile::fake()->image('photo.jpg', 800, 600);
+
+    $result = $service->createForUpload($file, 'threads/10', 'local');
+
+    expect($result)->not->toBeNull();
+    expect($result)->toHaveKeys(['path', 'mime', 'size']);
+
+    Storage::disk('local')->assertExists($result['path']);
+});
+
+it('skips thumbnail when disabled or too small', function (): void {
+    if (!function_exists('imagecreatetruecolor')) {
+        $this->markTestSkipped('GD extension not available.');
+    }
+
+    Storage::fake('local');
+
+    Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'false']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '300']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '300']);
+
+    $service = new AttachmentThumbnailService();
+    $file = UploadedFile::fake()->image('small.jpg', 100, 100);
+
+    $result = $service->createForUpload($file, 'threads/1', 'local');
+
+    expect($result)->toBeNull();
+});
+
+it('skips thumbnail when image is within size limits', function (): void {
+    if (!function_exists('imagecreatetruecolor')) {
+        $this->markTestSkipped('GD extension not available.');
+    }
+
+    Storage::fake('local');
+
+    Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '300']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '300']);
+
+    $service = new AttachmentThumbnailService();
+    $file = UploadedFile::fake()->image('small.jpg', 100, 100);
+
+    $result = $service->createForUpload($file, 'threads/1', 'local');
+
+    expect($result)->toBeNull();
+});
+
+it('returns null when max dimensions are invalid', function (): void {
+    if (!function_exists('imagecreatetruecolor')) {
+        $this->markTestSkipped('GD extension not available.');
+    }
+
+    Storage::fake('local');
+
+    Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '0']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '0']);
+
+    $service = new AttachmentThumbnailService();
+    $file = UploadedFile::fake()->image('photo.jpg', 800, 600);
+
+    $result = $service->createForUpload($file, 'threads/1', 'local');
+
+    expect($result)->toBeNull();
+});
+
+it('returns null for invalid image payloads', function (): void {
+    Storage::fake('local');
+
+    Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+
+    $service = new AttachmentThumbnailService();
+    $file = UploadedFile::fake()->create('bad.jpg', 10, 'image/jpeg');
+
+    $result = $service->createForUpload($file, 'threads/1', 'local');
+
+    expect($result)->toBeNull();
+});
+
+it('creates thumbnail for existing attachments', function (): void {
+    if (!function_exists('imagecreatetruecolor')) {
+        $this->markTestSkipped('GD extension not available.');
+    }
+
+    Storage::fake('local');
+
+    Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+
+    $category = \App\Models\Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = \App\Models\Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+    $thread = \App\Models\Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    $image = UploadedFile::fake()->image('photo.jpg', 800, 600);
+    $path = "attachments/threads/{$thread->id}/photo.jpg";
+    Storage::disk('local')->put($path, file_get_contents($image->getPathname()));
+
+    $attachment = \App\Models\Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => $path,
+        'original_name' => 'photo.jpg',
+        'extension' => 'jpg',
+        'mime_type' => 'image/jpeg',
+        'size_bytes' => 1234,
+    ]);
+
+    $service = new AttachmentThumbnailService();
+    $result = $service->createForAttachment($attachment, true);
+
+    expect($result)->not->toBeNull();
+    Storage::disk('local')->assertExists($result['path']);
+});
+
+it('returns null for attachments without stored files', function (): void {
+    Storage::fake('local');
+
+    $category = \App\Models\Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = \App\Models\Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+    $thread = \App\Models\Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    $attachment = \App\Models\Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => "attachments/threads/{$thread->id}/missing.jpg",
+        'original_name' => 'missing.jpg',
+        'extension' => 'jpg',
+        'mime_type' => 'image/jpeg',
+        'size_bytes' => 10,
+    ]);
+
+    $service = new AttachmentThumbnailService();
+    $result = $service->createForAttachment($attachment, true);
+
+    expect($result)->toBeNull();
+});
+
+it('returns null when thumbnail already exists and not forcing', function (): void {
+    Storage::fake('local');
+
+    $category = \App\Models\Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = \App\Models\Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+    $thread = \App\Models\Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    $attachment = \App\Models\Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => "attachments/threads/{$thread->id}/photo.jpg",
+        'thumbnail_path' => "attachments/threads/{$thread->id}/thumbs/existing.jpg",
+        'original_name' => 'photo.jpg',
+        'extension' => 'jpg',
+        'mime_type' => 'image/jpeg',
+        'size_bytes' => 10,
+    ]);
+
+    Storage::disk('local')->put($attachment->thumbnail_path, 'thumb');
+
+    $service = new AttachmentThumbnailService();
+    $result = $service->createForAttachment($attachment, false);
+
+    expect($result)->toBeNull();
+});
+
+it('returns null for non-image attachments', function (): void {
+    Storage::fake('local');
+
+    $category = \App\Models\Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = \App\Models\Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+    $thread = \App\Models\Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    $attachment = \App\Models\Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => "attachments/threads/{$thread->id}/doc.pdf",
+        'original_name' => 'doc.pdf',
+        'extension' => 'pdf',
+        'mime_type' => 'application/pdf',
+        'size_bytes' => 10,
+    ]);
+
+    $service = new AttachmentThumbnailService();
+    $result = $service->createForAttachment($attachment, true);
+
+    expect($result)->toBeNull();
+});
+
+it('uses post scope when creating thumbnails', function (): void {
+    if (!function_exists('imagecreatetruecolor')) {
+        $this->markTestSkipped('GD extension not available.');
+    }
+
+    Storage::fake('local');
+
+    Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+
+    $category = \App\Models\Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = \App\Models\Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+    $thread = \App\Models\Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+    $post = \App\Models\Post::create([
+        'thread_id' => $thread->id,
+        'user_id' => null,
+        'body' => 'Post',
+    ]);
+
+    $image = UploadedFile::fake()->image('photo.png', 800, 600);
+    $path = "attachments/posts/{$post->id}/photo.png";
+    Storage::disk('local')->put($path, file_get_contents($image->getPathname()));
+
+    $attachment = \App\Models\Attachment::create([
+        'thread_id' => null,
+        'post_id' => $post->id,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => $path,
+        'original_name' => 'photo.png',
+        'extension' => 'png',
+        'mime_type' => 'image/png',
+        'size_bytes' => 1234,
+    ]);
+
+    $service = new AttachmentThumbnailService();
+    $result = $service->createForAttachment($attachment, true);
+
+    expect($result)->not->toBeNull();
+    expect($result['path'])->toContain("attachments/posts/{$post->id}/thumbs/");
+});
+
+it('returns null when mime is unsupported even if image data is valid', function (): void {
+    if (!function_exists('imagecreatetruecolor')) {
+        $this->markTestSkipped('GD extension not available.');
+    }
+
+    Storage::fake('local');
+
+    Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+
+    $category = \App\Models\Forum::create([
+        'name' => 'Category',
+        'description' => null,
+        'type' => 'category',
+        'parent_id' => null,
+        'position' => 1,
+    ]);
+    $forum = \App\Models\Forum::create([
+        'name' => 'Forum',
+        'description' => null,
+        'type' => 'forum',
+        'parent_id' => $category->id,
+        'position' => 1,
+    ]);
+    $thread = \App\Models\Thread::create([
+        'forum_id' => $forum->id,
+        'user_id' => null,
+        'title' => 'Thread',
+        'body' => 'Body',
+    ]);
+
+    $image = UploadedFile::fake()->image('photo.png', 800, 600);
+    $path = "attachments/threads/{$thread->id}/photo.png";
+    Storage::disk('local')->put($path, file_get_contents($image->getPathname()));
+
+    $attachment = \App\Models\Attachment::create([
+        'thread_id' => $thread->id,
+        'post_id' => null,
+        'attachment_extension_id' => null,
+        'attachment_group_id' => null,
+        'user_id' => null,
+        'disk' => 'local',
+        'path' => $path,
+        'original_name' => 'photo.png',
+        'extension' => 'png',
+        'mime_type' => 'image/avif',
+        'size_bytes' => 1234,
+    ]);
+
+    $service = new AttachmentThumbnailService();
+    $result = $service->createForAttachment($attachment, true);
+
+    expect($result)->toBeNull();
+});
+
+it('creates thumbnails for gif images', function (): void {
+    if (!function_exists('imagecreatetruecolor')) {
+        $this->markTestSkipped('GD extension not available.');
+    }
+
+    if (!function_exists('imagegif')) {
+        $this->markTestSkipped('GIF support not available.');
+    }
+
+    Storage::fake('local');
+
+    Setting::updateOrCreate(['key' => 'attachments.create_thumbnails'], ['value' => 'true']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_width'], ['value' => '100']);
+    Setting::updateOrCreate(['key' => 'attachments.thumbnail_max_height'], ['value' => '100']);
+
+    $service = new AttachmentThumbnailService();
+    $file = UploadedFile::fake()->image('photo.gif', 800, 600);
+
+    $result = $service->createForUpload($file, 'threads/1', 'local');
+
+    expect($result)->not->toBeNull();
+    Storage::disk('local')->assertExists($result['path']);
+});

tests/Unit/AuditLogControllerUnitTest.php

@@ -0,0 +1,55 @@
+<?php
+
+use App\Http\Controllers\AuditLogController;
+use App\Models\AuditLog;
+use App\Models\Role;
+use App\Models\User;
+use Illuminate\Http\Request;
+
+it('returns unauthorized when no user', function (): void {
+    $controller = new AuditLogController();
+    $request = Request::create('/api/audit-logs', 'GET');
+    $request->setUserResolver(fn () => null);
+
+    $response = $controller->index($request);
+
+    expect($response->getStatusCode())->toBe(401);
+});
+
+it('returns forbidden when user is not admin', function (): void {
+    $controller = new AuditLogController();
+    $user = User::factory()->create();
+    $request = Request::create('/api/audit-logs', 'GET');
+    $request->setUserResolver(fn () => $user);
+
+    $response = $controller->index($request);
+
+    expect($response->getStatusCode())->toBe(403);
+});
+
+it('returns logs for admin', function (): void {
+    $controller = new AuditLogController();
+    $admin = User::factory()->create();
+    $role = Role::create(['name' => 'ROLE_ADMIN']);
+    $admin->roles()->attach($role);
+
+    AuditLog::create([
+        'action' => 'test.action',
+        'subject_type' => 'post',
+        'subject_id' => 1,
+        'metadata' => ['foo' => 'bar'],
+        'ip_address' => '127.0.0.1',
+        'user_agent' => 'test',
+        'user_id' => $admin->id,
+    ]);
+
+    $request = Request::create('/api/audit-logs', 'GET');
+    $request->setUserResolver(fn () => $admin);
+
+    $response = $controller->index($request);
+
+    expect($response->getStatusCode())->toBe(200);
+    $payload = $response->getData(true);
+    expect($payload)->toHaveCount(1);
+    expect($payload[0]['user']['roles'][0])->toBe('ROLE_ADMIN');
+});

tests/Unit/AuditLoggerTest.php

@@ -0,0 +1,66 @@
+<?php
+
+use App\Models\AuditLog;
+use App\Models\User;
+use App\Services\AuditLogger;
+use Illuminate\Http\Request;
+
+it('creates audit log with actor and subject', function (): void {
+    $user = User::factory()->create();
+    $subject = User::factory()->create();
+
+    $request = Request::create('/api/test', 'POST');
+    $request->headers->set('User-Agent', 'phpunit');
+    $request->server->set('REMOTE_ADDR', '127.0.0.1');
+
+    $logger = new AuditLogger();
+    $result = $logger->log(
+        $request,
+        'user.updated',
+        $subject,
+        ['field' => 'name'],
+        $user
+    );
+
+    expect($result)->toBeInstanceOf(AuditLog::class);
+    $this->assertDatabaseHas('audit_logs', [
+        'user_id' => $user->id,
+        'action' => 'user.updated',
+        'subject_type' => $subject::class,
+        'subject_id' => $subject->id,
+        'ip_address' => '127.0.0.1',
+        'user_agent' => 'phpunit',
+    ]);
+});
+
+it('handles missing user', function (): void {
+    $request = Request::create('/api/test', 'POST');
+    $request->headers->set('User-Agent', 'phpunit');
+    $request->server->set('REMOTE_ADDR', '127.0.0.1');
+
+    $logger = new AuditLogger();
+    $result = $logger->log($request, 'system.ping');
+
+    expect($result)->toBeInstanceOf(AuditLog::class);
+    $this->assertDatabaseHas('audit_logs', [
+        'action' => 'system.ping',
+        'user_id' => null,
+    ]);
+});
+
+it('returns null when logging fails', function (): void {
+    AuditLog::creating(function () {
+        throw new RuntimeException('fail');
+    });
+
+    $request = Request::create('/api/test', 'POST');
+    $request->headers->set('User-Agent', 'phpunit');
+    $request->server->set('REMOTE_ADDR', '127.0.0.1');
+
+    $logger = new AuditLogger();
+    $result = $logger->log($request, 'system.fail');
+
+    expect($result)->toBeNull();
+
+    AuditLog::flushEventListeners();
+});

tests/Unit/BbcodeFormatterTest.php

@@ -0,0 +1,155 @@
+<?php
+
+namespace s9e\TextFormatter {
+    class Parser
+    {
+        public function parse(string $text): string
+        {
+            return '<r/>';
+        }
+    }
+
+    class Renderer
+    {
+        public function render(string $xml): string
+        {
+            return '<p>ok</p>';
+        }
+    }
+
+    class Configurator
+    {
+        public static bool $returnEmpty = false;
+        public object $plugins;
+        public object $tags;
+
+        public function __construct()
+        {
+            $this->plugins = new class {
+                public function load(string $name): object
+                {
+                    return new class {
+                        public function addFromRepository(string $name): self
+                        {
+                            return $this;
+                        }
+                    };
+                }
+            };
+
+            $this->tags = new class implements \ArrayAccess {
+                public array $store = [];
+                public function add($name)
+                {
+                    $obj = new \stdClass();
+                    $this->store[$name] = $obj;
+                    return $obj;
+                }
+                public function offsetExists($offset): bool
+                {
+                    return array_key_exists($offset, $this->store);
+                }
+                public function offsetGet($offset): mixed
+                {
+                    return $this->store[$offset] ?? null;
+                }
+                public function offsetSet($offset, $value): void
+                {
+                    $this->store[$offset] = $value;
+                }
+                public function offsetUnset($offset): void
+                {
+                    unset($this->store[$offset]);
+                }
+            };
+
+            $this->tags['QUOTE'] = new \stdClass();
+        }
+
+        public function finalize(): array
+        {
+            if (self::$returnEmpty) {
+                return [];
+            }
+
+            return [
+                'parser' => new Parser(),
+                'renderer' => new Renderer(),
+            ];
+        }
+    }
+}
+
+namespace {
+    use App\Actions\BbcodeFormatter;
+
+    it('returns empty string for null and empty input', function (): void {
+        expect(BbcodeFormatter::format(null))->toBe('');
+        expect(BbcodeFormatter::format(''))->toBe('');
+    });
+
+    it('formats bbcode content', function (): void {
+        $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
+        $parserProp->setAccessible(true);
+        $parserProp->setValue(
+            \Mockery::mock(\s9e\TextFormatter\Parser::class)
+                ->shouldReceive('parse')
+                ->andReturn('<r/>')
+                ->getMock()
+        );
+
+        $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
+        $rendererProp->setAccessible(true);
+        $rendererProp->setValue(
+            \Mockery::mock(\s9e\TextFormatter\Renderer::class)
+                ->shouldReceive('render')
+                ->andReturn('<b>Bold</b>')
+                ->getMock()
+        );
+
+        $html = BbcodeFormatter::format('[b]Bold[/b]');
+
+        expect($html)->toContain('<b>');
+    });
+
+    it('initializes parser and renderer when not set', function (): void {
+        $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
+        $parserProp->setAccessible(true);
+        $parserProp->setValue(null);
+
+        $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
+        $rendererProp->setAccessible(true);
+        $rendererProp->setValue(null);
+
+        $html = BbcodeFormatter::format('[b]Bold[/b]');
+
+        expect($html)->toBeString();
+        expect($parserProp->getValue())->not->toBeNull();
+        expect($rendererProp->getValue())->not->toBeNull();
+    });
+
+    it('throws when bbcode formatter cannot initialize', function (): void {
+        \s9e\TextFormatter\Configurator::$returnEmpty = true;
+
+        $parserProp = new ReflectionProperty(BbcodeFormatter::class, 'parser');
+        $parserProp->setAccessible(true);
+        $parserProp->setValue(null);
+
+        $rendererProp = new ReflectionProperty(BbcodeFormatter::class, 'renderer');
+        $rendererProp->setAccessible(true);
+        $rendererProp->setValue(null);
+
+        try {
+            BbcodeFormatter::format('test');
+            $this->fail('Expected exception not thrown.');
+        } catch (Throwable $e) {
+            expect($e)->toBeInstanceOf(RuntimeException::class);
+        } finally {
+            \s9e\TextFormatter\Configurator::$returnEmpty = false;
+        }
+    });
+
+    afterEach(function (): void {
+        \Mockery::close();
+    });
+}

tests/Unit/ConsoleCommandTest.php

@@ -0,0 +1,50 @@
+<?php
+
+use App\Models\Setting;
+use Illuminate\Support\Facades\Http;
+
+it('version bump fails when no version', function (): void {
+    Setting::where('key', 'version')->delete();
+    $exitCode = \Illuminate\Support\Facades\Artisan::call('version:bump');
+    expect($exitCode)->toBe(1);
+});
+
+it('version bump fails when invalid version', function (): void {
+    Setting::updateOrCreate(['key' => 'version'], ['value' => 'bad']);
+    $exitCode = \Illuminate\Support\Facades\Artisan::call('version:bump');
+    expect($exitCode)->toBe(1);
+});
+
+it('version set fails when invalid version', function (): void {
+    $exitCode = \Illuminate\Support\Facades\Artisan::call('version:set', ['version' => 'bad']);
+    expect($exitCode)->toBe(1);
+});
+
+it('version fetch fails when no version', function (): void {
+    Setting::where('key', 'version')->delete();
+    $exitCode = \Illuminate\Support\Facades\Artisan::call('version:fetch');
+    expect($exitCode)->toBe(1);
+});
+
+it('version release fails when missing config', function (): void {
+    Setting::updateOrCreate(['key' => 'version'], ['value' => '1.2.3']);
+    putenv('GITEA_TOKEN');
+    putenv('GITEA_OWNER');
+    putenv('GITEA_REPO');
+    $exitCode = \Illuminate\Support\Facades\Artisan::call('version:release');
+    expect($exitCode)->toBe(1);
+});
+
+it('version release handles create failure', function (): void {
+    Setting::updateOrCreate(['key' => 'version'], ['value' => '1.2.3']);
+    putenv('GITEA_TOKEN=token');
+    putenv('GITEA_OWNER=owner');
+    putenv('GITEA_REPO=repo');
+
+    Http::fake([
+        '*' => Http::response([], 500),
+    ]);
+
+    $exitCode = \Illuminate\Support\Facades\Artisan::call('version:release');
+    expect($exitCode)->toBe(1);
+});