feat(api): add AI text-to-deck generation, wallet deposit structure, and profile/notification endpoints

Fills the gaps between the admin panel screens and the backend: a full
free-text + slide-count + language -> AI-generated presentation flow with
new slide-cloning logic in TemplateFillService, a "my presentations" list
endpoint, a swappable payment-gateway structure for wallet top-ups (fake
driver for now), and avatar upload / public-profile toggle / account
deletion / password change / notification preference endpoints.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

app/Http/Requests/Api/GenerateAiPresentationRequest.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Http\Requests\Api;
+
+use App\Models\Template;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Validator;
+
+class GenerateAiPresentationRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'title' => ['required', 'string', 'max:255'],
+            'language' => ['required', 'string', 'in:fa,en,ar'],
+            'slide_count' => ['required', 'integer', 'min:3', 'max:30'],
+            'text' => ['required', 'string', 'min:20'],
+        ];
+    }
+
+    public function withValidator(Validator $validator): void
+    {
+        $validator->after(function (Validator $validator): void {
+            /** @var Template $template */
+            $template = $this->route('template');
+
+            if (! $template->is_ai_enabled) {
+                $validator->errors()->add('template', 'این قالب برای ساخت پاورپوینت با هوش مصنوعی فعال نیست.');
+            }
+        });
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'title.required' => 'عنوان پاورپوینت الزامی است.',
+            'language.required' => 'زبان ارائه الزامی است.',
+            'language.in' => 'زبان انتخاب‌شده پشتیبانی نمی‌شود.',
+            'slide_count.required' => 'تعداد اسلاید الزامی است.',
+            'slide_count.min' => 'تعداد اسلاید باید حداقل :min باشد.',
+            'slide_count.max' => 'تعداد اسلاید باید حداکثر :max باشد.',
+            'text.required' => 'متن ورودی الزامی است.',
+            'text.min' => 'متن ورودی باید حداقل :min کاراکتر باشد.',
+        ];
+    }
+}

app/Http/Requests/Api/InitiateDepositRequest.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Http\Requests\Api;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class InitiateDepositRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'amount' => ['required', 'integer', 'min:10000'],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'amount.required' => 'مبلغ شارژ الزامی است.',
+            'amount.integer' => 'مبلغ باید عدد باشد.',
+            'amount.min' => 'حداقل مبلغ شارژ :min تومان است.',
+        ];
+    }
+}

app/Http/Requests/Api/UpdateNotificationPreferencesRequest.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests\Api;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateNotificationPreferencesRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'comment_on_presentation' => ['sometimes', 'boolean'],
+            'form_reply' => ['sometimes', 'boolean'],
+            'new_follower' => ['sometimes', 'boolean'],
+            'news_announcements' => ['sometimes', 'boolean'],
+            'weekly_product_updates' => ['sometimes', 'boolean'],
+            'weekly_blog_digest' => ['sometimes', 'boolean'],
+        ];
+    }
+}

app/Http/Requests/Profile/ChangePasswordRequest.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Http\Requests\Profile;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class ChangePasswordRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'current_password' => ['required', 'string', 'current_password'],
+            'password' => ['required', 'string', 'min:8', 'confirmed'],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'current_password.required' => 'رمز عبور فعلی الزامی است.',
+            'current_password.current_password' => 'رمز عبور فعلی صحیح نیست.',
+            'password.required' => 'رمز عبور جدید الزامی است.',
+            'password.min' => 'رمز عبور جدید باید حداقل ۸ کاراکتر باشد.',
+            'password.confirmed' => 'تکرار رمز عبور جدید مطابقت ندارد.',
+        ];
+    }
+}

app/Http/Requests/Profile/UpdateProfileRequest.php

@@ -25,6 +25,8 @@ class UpdateProfileRequest extends FormRequest
             'email' => ['sometimes', 'required', 'string', 'email', 'max:255', Rule::unique('users', 'email')->ignore($userId)],
             'mobile' => ['sometimes', 'required', 'string', 'regex:/^09\d{9}$/', Rule::unique('users', 'mobile')->ignore($userId)],
             'password' => ['sometimes', 'required', 'string', 'min:8'],
+            'avatar' => ['sometimes', 'nullable', 'image', 'max:3072'],
+            'is_public' => ['sometimes', 'nullable', 'boolean'],
         ];
     }
 
@@ -45,6 +47,8 @@ class UpdateProfileRequest extends FormRequest
             'mobile.unique' => 'این شماره موبایل قبلاً ثبت شده است.',
             'password.required' => 'رمز عبور الزامی است.',
             'password.min' => 'رمز عبور باید حداقل ۸ کاراکتر باشد.',
+            'avatar.image' => 'فایل ارسالی باید تصویر باشد.',
+            'avatar.max' => 'حداکثر حجم تصویر ۳ مگابایت است.',
         ];
     }
 }