Initial baseline: LaraBlog core with plugin commerce surface.

Captures the current working tree after theme slots, ArticleAccess, and the payment / paid-content plugins so subsequent work has a reviewable git history.
2026-08-12 01:15:38 +08:00
commit 263b98b218
337 changed files with 31393 additions and 0 deletions
@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Ai\Jobs;
+
+use App\Models\Article;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * Phase-2 stub: auto-pick or generate a cover image for an article.
+ * Dispatch later from import scripts / artisan batch; process via Workerman/queue.
+ */
+class GenerateArticleCoverJob implements ShouldQueue
+{
+    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
+
+    public function __construct(
+        public int $articleId,
+        public string $strategy = 'auto', // auto|from_content|generate
+    ) {
+        $this->onQueue('ai-content');
+    }
+
+    public function handle(): void
+    {
+        $article = Article::query()->find($this->articleId);
+        if ($article === null) {
+            return;
+        }
+
+        // Intentionally unimplemented in phase 1.
+        Log::info('GenerateArticleCoverJob stub skipped', [
+            'article_id' => $article->id,
+            'strategy' => $this->strategy,
+            'cover_status' => $article->cover_status,
+        ]);
+    }
+}
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Ai\Jobs;
+
+use App\Contracts\LlmProvider;
+use App\Models\Comment;
+use App\Settings\AiSettings;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Queue\Queueable;
+use Illuminate\Support\Facades\Log;
+
+class ModerateCommentJob implements ShouldQueue
+{
+    use Queueable;
+
+    public function __construct(
+        public int $commentId,
+    ) {
+        $this->onQueue('ai-moderation');
+    }
+
+    public function handle(LlmProvider $llm, AiSettings $settings): void
+    {
+        if (! $settings->comment_moderation_enabled) {
+            return;
+        }
+
+        $comment = Comment::query()->find($this->commentId);
+
+        if ($comment === null) {
+            return;
+        }
+
+        if ($comment->moderation_status !== Comment::STATUS_PENDING_AI) {
+            $comment->update(['moderation_status' => Comment::STATUS_PENDING_AI]);
+        }
+
+        try {
+            $result = $llm->moderate($comment->content);
+            $status = match ($result['status'] ?? 'needs_human') {
+                'approved' => Comment::STATUS_APPROVED,
+                'rejected' => Comment::STATUS_REJECTED,
+                default => Comment::STATUS_NEEDS_HUMAN,
+            };
+
+            $comment->forceFill([
+                'moderation_status' => $status,
+                'published_at' => $status === Comment::STATUS_APPROVED
+                    ? ($comment->published_at ?? now())
+                    : $comment->published_at,
+            ])->save();
+        } catch (\Throwable $exception) {
+            Log::warning('Comment moderation failed.', [
+                'comment_id' => $this->commentId,
+                'message' => $exception->getMessage(),
+            ]);
+
+            $comment->update(['moderation_status' => Comment::STATUS_NEEDS_HUMAN]);
+        }
+    }
+}
@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Ai\Jobs;
+
+use App\Contracts\LlmProvider;
+use App\Models\Article;
+use App\Settings\AiSettings;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Queue\Queueable;
+use Illuminate\Support\Facades\Log;
+
+class OptimizeArticleContentJob implements ShouldQueue
+{
+    use Queueable;
+
+    public function __construct(
+        public int $articleId,
+    ) {
+        $this->onQueue('ai-content');
+    }
+
+    public function handle(LlmProvider $llm, AiSettings $settings): void
+    {
+        if (! $settings->content_optimization_enabled) {
+            return;
+        }
+
+        $article = Article::query()->find($this->articleId);
+
+        if ($article === null) {
+            return;
+        }
+
+        try {
+            $result = $llm->complete($article->content, [
+                'title' => $article->title,
+                'article_id' => $article->id,
+            ]);
+
+            $article->forceFill([
+                'ai_summary' => $result['summary'] ?? null,
+                'ai_suggestions' => $result['suggestions'] ?? [],
+            ])->save();
+        } catch (\Throwable $exception) {
+            Log::warning('Article content optimization failed.', [
+                'article_id' => $this->articleId,
+                'message' => $exception->getMessage(),
+            ]);
+        }
+    }
+}
@@ -0,0 +1,107 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Ai;
+
+use App\Contracts\LlmProvider;
+use App\Settings\AiSettings;
+use Illuminate\Support\Facades\Http;
+use RuntimeException;
+
+class OpenAiCompatibleLlmProvider implements LlmProvider
+{
+    public function __construct(
+        protected AiSettings $settings,
+    ) {}
+
+    public function complete(string $prompt, array $context = []): array
+    {
+        $response = $this->request([
+            'model' => $this->settings->model ?? 'gpt-4o-mini',
+            'messages' => [
+                [
+                    'role' => 'system',
+                    'content' => 'You optimize blog article content. Respond with JSON containing summary (string) and suggestions (array of strings).',
+                ],
+                [
+                    'role' => 'user',
+                    'content' => $prompt,
+                ],
+            ],
+            'response_format' => ['type' => 'json_object'],
+        ]);
+
+        $content = data_get($response, 'choices.0.message.content');
+
+        if (! is_string($content)) {
+            throw new RuntimeException('LLM completion response missing content.');
+        }
+
+        $decoded = json_decode($content, true);
+
+        if (! is_array($decoded)) {
+            throw new RuntimeException('LLM completion response is not valid JSON.');
+        }
+
+        return [
+            'summary' => (string) ($decoded['summary'] ?? ''),
+            'suggestions' => array_values($decoded['suggestions'] ?? []),
+        ];
+    }
+
+    public function moderate(string $content): array
+    {
+        $response = $this->request([
+            'model' => $this->settings->model ?? 'gpt-4o-mini',
+            'messages' => [
+                [
+                    'role' => 'system',
+                    'content' => 'Moderate blog comments. Respond with JSON: {"status":"approved|rejected|needs_human","reason":"..."}',
+                ],
+                [
+                    'role' => 'user',
+                    'content' => $content,
+                ],
+            ],
+            'response_format' => ['type' => 'json_object'],
+        ]);
+
+        $payload = data_get($response, 'choices.0.message.content');
+        $decoded = is_string($payload) ? json_decode($payload, true) : null;
+
+        if (! is_array($decoded) || ! isset($decoded['status'])) {
+            return [
+                'status' => 'needs_human',
+                'reason' => 'Unable to parse moderation response.',
+            ];
+        }
+
+        return [
+            'status' => (string) $decoded['status'],
+            'reason' => isset($decoded['reason']) ? (string) $decoded['reason'] : null,
+        ];
+    }
+
+    /**
+     * @param  array<string, mixed>  $payload
+     * @return array<string, mixed>
+     */
+    protected function request(array $payload): array
+    {
+        $baseUrl = rtrim($this->settings->api_base_url ?? 'https://api.openai.com/v1', '/');
+
+        $response = Http::withToken($this->settings->api_key ?? '')
+            ->acceptJson()
+            ->timeout(60)
+            ->post("{$baseUrl}/chat/completions", $payload)
+            ->throw()
+            ->json();
+
+        if (! is_array($response)) {
+            throw new RuntimeException('LLM provider returned an invalid response.');
+        }
+
+        return $response;
+    }
+}
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Ai;
+
+use App\Contracts\LlmProvider;
+
+class StubLlmProvider implements LlmProvider
+{
+    public function complete(string $prompt, array $context = []): array
+    {
+        return [
+            'summary' => 'Stub summary for content optimization.',
+            'suggestions' => [
+                'Review headings for clarity.',
+                'Add a concise meta description.',
+            ],
+        ];
+    }
+
+    public function moderate(string $content): array
+    {
+        $blocked = str_contains(strtolower($content), 'spam');
+
+        return [
+            'status' => $blocked ? 'rejected' : 'approved',
+            'reason' => $blocked ? 'Detected spam keyword in stub provider.' : null,
+        ];
+    }
+}