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>
This commit is contained in:
@@ -3,7 +3,10 @@
|
||||
namespace App\Http\Controllers\Api;
|
||||
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\Api\UpdateNotificationPreferencesRequest;
|
||||
use App\Http\Resources\NotificationPreferenceResource;
|
||||
use App\Http\Resources\NotificationResource;
|
||||
use App\Models\NotificationPreference;
|
||||
use App\Services\NotificationService;
|
||||
use App\Traits\ApiResponse;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
@@ -86,4 +89,93 @@ class NotificationController extends Controller
|
||||
|
||||
return $this->success('همه نوتیفیکیشنها خوانده شد.');
|
||||
}
|
||||
|
||||
#[OA\Get(
|
||||
path: '/notifications/preferences',
|
||||
description: 'Get the authenticated user notification preferences',
|
||||
summary: 'Show notification preferences',
|
||||
security: [['sanctum' => []]],
|
||||
tags: ['Notifications'],
|
||||
responses: [
|
||||
new OA\Response(
|
||||
response: 200,
|
||||
description: 'Notification preferences fetched successfully',
|
||||
content: new OA\JsonContent(
|
||||
properties: [
|
||||
new OA\Property(property: 'message', type: 'string', example: 'تنظیمات اعلانها با موفقیت دریافت شد.'),
|
||||
new OA\Property(
|
||||
property: 'data',
|
||||
properties: [
|
||||
new OA\Property(property: 'preferences', ref: '#/components/schemas/NotificationPreference'),
|
||||
],
|
||||
type: 'object'
|
||||
),
|
||||
]
|
||||
)
|
||||
),
|
||||
new OA\Response(response: 401, description: 'Unauthenticated'),
|
||||
]
|
||||
)]
|
||||
public function preferences(Request $request): JsonResponse
|
||||
{
|
||||
$preferences = $this->firstOrCreatePreferences($request);
|
||||
|
||||
return $this->success('تنظیمات اعلانها با موفقیت دریافت شد.', [
|
||||
'preferences' => new NotificationPreferenceResource($preferences),
|
||||
]);
|
||||
}
|
||||
|
||||
#[OA\Put(
|
||||
path: '/notifications/preferences',
|
||||
description: 'Update the authenticated user notification preferences',
|
||||
summary: 'Update notification preferences',
|
||||
security: [['sanctum' => []]],
|
||||
tags: ['Notifications'],
|
||||
requestBody: new OA\RequestBody(
|
||||
required: true,
|
||||
content: new OA\JsonContent(ref: '#/components/schemas/NotificationPreference')
|
||||
),
|
||||
responses: [
|
||||
new OA\Response(
|
||||
response: 200,
|
||||
description: 'Notification preferences updated successfully',
|
||||
content: new OA\JsonContent(
|
||||
properties: [
|
||||
new OA\Property(property: 'message', type: 'string', example: 'تنظیمات اعلانها با موفقیت بهروزرسانی شد.'),
|
||||
new OA\Property(
|
||||
property: 'data',
|
||||
properties: [
|
||||
new OA\Property(property: 'preferences', ref: '#/components/schemas/NotificationPreference'),
|
||||
],
|
||||
type: 'object'
|
||||
),
|
||||
]
|
||||
)
|
||||
),
|
||||
new OA\Response(response: 401, description: 'Unauthenticated'),
|
||||
new OA\Response(response: 422, description: 'Validation error'),
|
||||
]
|
||||
)]
|
||||
public function updatePreferences(UpdateNotificationPreferencesRequest $request): JsonResponse
|
||||
{
|
||||
$preferences = $this->firstOrCreatePreferences($request);
|
||||
|
||||
$preferences->update($request->validated());
|
||||
|
||||
return $this->success('تنظیمات اعلانها با موفقیت بهروزرسانی شد.', [
|
||||
'preferences' => new NotificationPreferenceResource($preferences->fresh()),
|
||||
]);
|
||||
}
|
||||
|
||||
private function firstOrCreatePreferences(Request $request): NotificationPreference
|
||||
{
|
||||
return $request->user()->notificationPreference()->firstOrCreate([], [
|
||||
'comment_on_presentation' => true,
|
||||
'form_reply' => false,
|
||||
'new_follower' => false,
|
||||
'news_announcements' => false,
|
||||
'weekly_product_updates' => true,
|
||||
'weekly_blog_digest' => false,
|
||||
]);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -3,10 +3,13 @@
|
||||
namespace App\Http\Controllers\Api;
|
||||
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\Profile\ChangePasswordRequest;
|
||||
use App\Http\Requests\Profile\UpdateProfileRequest;
|
||||
use App\Http\Resources\UserResource;
|
||||
use App\Traits\ApiResponse;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
use OpenApi\Attributes as OA;
|
||||
|
||||
class ProfileController extends Controller
|
||||
@@ -89,10 +92,97 @@ class ProfileController extends Controller
|
||||
{
|
||||
$user = $request->user();
|
||||
|
||||
$user->update($request->validated());
|
||||
$data = $request->safe()->except('avatar');
|
||||
|
||||
if ($request->hasFile('avatar')) {
|
||||
if ($user->avatar_path) {
|
||||
Storage::disk('public')->delete($user->avatar_path);
|
||||
}
|
||||
|
||||
$data['avatar_path'] = $request->file('avatar')->store('avatars', 'public');
|
||||
}
|
||||
|
||||
$user->update($data);
|
||||
|
||||
return $this->success('پروفایل با موفقیت بهروزرسانی شد.', [
|
||||
'user' => new UserResource($user->fresh()),
|
||||
]);
|
||||
}
|
||||
|
||||
#[OA\Put(
|
||||
path: '/profile/password',
|
||||
description: 'Change the authenticated user password',
|
||||
summary: 'Change password',
|
||||
security: [['sanctum' => []]],
|
||||
tags: ['Profile'],
|
||||
requestBody: new OA\RequestBody(
|
||||
required: true,
|
||||
content: new OA\JsonContent(
|
||||
required: ['current_password', 'password', 'password_confirmation'],
|
||||
properties: [
|
||||
new OA\Property(property: 'current_password', type: 'string', format: 'password'),
|
||||
new OA\Property(property: 'password', type: 'string', format: 'password'),
|
||||
new OA\Property(property: 'password_confirmation', type: 'string', format: 'password'),
|
||||
]
|
||||
)
|
||||
),
|
||||
responses: [
|
||||
new OA\Response(
|
||||
response: 200,
|
||||
description: 'Password changed successfully',
|
||||
content: new OA\JsonContent(
|
||||
properties: [
|
||||
new OA\Property(property: 'message', type: 'string', example: 'رمز عبور با موفقیت تغییر کرد.'),
|
||||
new OA\Property(property: 'data', type: 'object'),
|
||||
]
|
||||
)
|
||||
),
|
||||
new OA\Response(response: 401, description: 'Unauthenticated'),
|
||||
new OA\Response(response: 422, description: 'Validation error'),
|
||||
]
|
||||
)]
|
||||
public function changePassword(ChangePasswordRequest $request): JsonResponse
|
||||
{
|
||||
$user = $request->user();
|
||||
|
||||
$user->update(['password' => $request->validated('password')]);
|
||||
|
||||
$currentTokenId = $user->currentAccessToken()?->id;
|
||||
|
||||
if ($currentTokenId) {
|
||||
$user->tokens()->where('id', '!=', $currentTokenId)->delete();
|
||||
}
|
||||
|
||||
return $this->success('رمز عبور با موفقیت تغییر کرد.');
|
||||
}
|
||||
|
||||
#[OA\Delete(
|
||||
path: '/profile',
|
||||
description: 'Delete the authenticated user account',
|
||||
summary: 'Delete account',
|
||||
security: [['sanctum' => []]],
|
||||
tags: ['Profile'],
|
||||
responses: [
|
||||
new OA\Response(
|
||||
response: 200,
|
||||
description: 'Account deleted successfully',
|
||||
content: new OA\JsonContent(
|
||||
properties: [
|
||||
new OA\Property(property: 'message', type: 'string', example: 'حساب کاربری با موفقیت حذف شد.'),
|
||||
new OA\Property(property: 'data', type: 'object'),
|
||||
]
|
||||
)
|
||||
),
|
||||
new OA\Response(response: 401, description: 'Unauthenticated'),
|
||||
]
|
||||
)]
|
||||
public function destroy(Request $request): JsonResponse
|
||||
{
|
||||
$user = $request->user();
|
||||
|
||||
$user->tokens()->delete();
|
||||
$user->delete();
|
||||
|
||||
return $this->success('حساب کاربری با موفقیت حذف شد.');
|
||||
}
|
||||
}
|
||||
|
||||
@@ -2,9 +2,11 @@
|
||||
|
||||
namespace App\Http\Controllers\Api;
|
||||
|
||||
use App\Enums\TemplateGenerationSource;
|
||||
use App\Enums\TemplateGenerationStatus;
|
||||
use App\Enums\TemplateKeyType;
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\Api\GenerateAiPresentationRequest;
|
||||
use App\Http\Requests\Api\GenerateTemplateRequest;
|
||||
use App\Http\Resources\TemplateGenerationResource;
|
||||
use App\Jobs\GenerateTemplateJob;
|
||||
@@ -12,6 +14,7 @@ use App\Models\Template;
|
||||
use App\Models\TemplateGeneration;
|
||||
use App\Traits\ApiResponse;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Http\Response;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
use Illuminate\Support\Str;
|
||||
@@ -89,6 +92,117 @@ class TemplateGenerationController extends Controller
|
||||
], 202);
|
||||
}
|
||||
|
||||
#[OA\Post(
|
||||
path: '/templates/{slug}/generate-from-text',
|
||||
description: 'Start generating a presentation from free-form text using AI',
|
||||
summary: 'Generate presentation from text (AI)',
|
||||
security: [['sanctum' => []]],
|
||||
tags: ['Templates'],
|
||||
parameters: [
|
||||
new OA\Parameter(name: 'slug', description: 'Template slug', in: 'path', required: true, schema: new OA\Schema(type: 'string')),
|
||||
],
|
||||
requestBody: new OA\RequestBody(
|
||||
required: true,
|
||||
content: new OA\JsonContent(
|
||||
required: ['title', 'language', 'slide_count', 'text'],
|
||||
properties: [
|
||||
new OA\Property(property: 'title', type: 'string', example: 'گزارش فروش سال ۱۴۰۴'),
|
||||
new OA\Property(property: 'language', type: 'string', example: 'fa'),
|
||||
new OA\Property(property: 'slide_count', type: 'integer', example: 10),
|
||||
new OA\Property(property: 'text', type: 'string', example: 'متن، عناوین، بولتها و قوانین موردنظر...'),
|
||||
]
|
||||
)
|
||||
),
|
||||
responses: [
|
||||
new OA\Response(
|
||||
response: 202,
|
||||
description: 'Generation started',
|
||||
content: new OA\JsonContent(
|
||||
properties: [
|
||||
new OA\Property(property: 'message', type: 'string', example: 'درخواست تولید پاورپوینت ثبت شد.'),
|
||||
new OA\Property(
|
||||
property: 'data',
|
||||
properties: [
|
||||
new OA\Property(property: 'generation', ref: '#/components/schemas/TemplateGeneration'),
|
||||
],
|
||||
type: 'object'
|
||||
),
|
||||
]
|
||||
)
|
||||
),
|
||||
new OA\Response(response: 401, description: 'Unauthenticated'),
|
||||
new OA\Response(response: 422, description: 'Validation error'),
|
||||
]
|
||||
)]
|
||||
public function storeFromText(GenerateAiPresentationRequest $request, Template $template): JsonResponse
|
||||
{
|
||||
$generation = TemplateGeneration::query()->create([
|
||||
'template_id' => $template->id,
|
||||
'uuid' => (string) Str::uuid(),
|
||||
'source' => TemplateGenerationSource::AiText,
|
||||
'title' => $request->validated('title'),
|
||||
'language' => $request->validated('language'),
|
||||
'slide_count' => $request->validated('slide_count'),
|
||||
'source_text' => $request->validated('text'),
|
||||
'status' => TemplateGenerationStatus::Pending,
|
||||
'requested_by' => $request->user()->id,
|
||||
]);
|
||||
|
||||
GenerateTemplateJob::dispatch($generation);
|
||||
|
||||
return $this->success('درخواست تولید پاورپوینت ثبت شد.', [
|
||||
'generation' => new TemplateGenerationResource($generation),
|
||||
], 202);
|
||||
}
|
||||
|
||||
#[OA\Get(
|
||||
path: '/generations',
|
||||
description: 'List the authenticated user presentation generations (both template-based and AI-generated)',
|
||||
summary: 'List my presentations',
|
||||
security: [['sanctum' => []]],
|
||||
tags: ['Templates'],
|
||||
parameters: [
|
||||
new OA\Parameter(name: 'per_page', description: 'Items per page', in: 'query', schema: new OA\Schema(type: 'integer', example: 15)),
|
||||
],
|
||||
responses: [
|
||||
new OA\Response(
|
||||
response: 200,
|
||||
description: 'Generations fetched successfully',
|
||||
content: new OA\JsonContent(
|
||||
properties: [
|
||||
new OA\Property(property: 'message', type: 'string', example: 'پاورپوینتهای شما با موفقیت دریافت شد.'),
|
||||
new OA\Property(
|
||||
property: 'data',
|
||||
properties: [
|
||||
new OA\Property(
|
||||
property: 'generations',
|
||||
type: 'array',
|
||||
items: new OA\Items(ref: '#/components/schemas/TemplateGeneration')
|
||||
),
|
||||
],
|
||||
type: 'object'
|
||||
),
|
||||
]
|
||||
)
|
||||
),
|
||||
new OA\Response(response: 401, description: 'Unauthenticated'),
|
||||
]
|
||||
)]
|
||||
public function index(Request $request): JsonResponse
|
||||
{
|
||||
$perPage = min(max((int) $request->integer('per_page', 15), 1), 100);
|
||||
|
||||
$generations = TemplateGeneration::query()
|
||||
->with('template')
|
||||
->where('requested_by', $request->user()->id)
|
||||
->latest()
|
||||
->paginate($perPage);
|
||||
|
||||
return $this->success('پاورپوینتهای شما با موفقیت دریافت شد.', [
|
||||
'generations' => TemplateGenerationResource::collection($generations)->response()->getData(true),
|
||||
]);
|
||||
}
|
||||
|
||||
#[OA\Get(
|
||||
path: '/generations/{uuid}',
|
||||
description: 'Get the status of a presentation generation request',
|
||||
|
||||
89
app/Http/Controllers/Api/WalletDepositController.php
Normal file
89
app/Http/Controllers/Api/WalletDepositController.php
Normal file
@@ -0,0 +1,89 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Api;
|
||||
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\Api\InitiateDepositRequest;
|
||||
use App\Http\Resources\WalletDepositResource;
|
||||
use App\Models\WalletDeposit;
|
||||
use App\Services\WalletDepositService;
|
||||
use App\Traits\ApiResponse;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\RedirectResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use OpenApi\Attributes as OA;
|
||||
|
||||
class WalletDepositController extends Controller
|
||||
{
|
||||
use ApiResponse;
|
||||
|
||||
public function __construct(private readonly WalletDepositService $walletDepositService) {}
|
||||
|
||||
#[OA\Post(
|
||||
path: '/wallet/deposits',
|
||||
description: 'Initiate a wallet top-up and get a payment redirect URL',
|
||||
summary: 'Initiate wallet deposit',
|
||||
security: [['sanctum' => []]],
|
||||
tags: ['Wallet'],
|
||||
requestBody: new OA\RequestBody(
|
||||
required: true,
|
||||
content: new OA\JsonContent(
|
||||
required: ['amount'],
|
||||
properties: [
|
||||
new OA\Property(property: 'amount', type: 'integer', example: 500000),
|
||||
]
|
||||
)
|
||||
),
|
||||
responses: [
|
||||
new OA\Response(
|
||||
response: 201,
|
||||
description: 'Deposit initiated successfully',
|
||||
content: new OA\JsonContent(
|
||||
properties: [
|
||||
new OA\Property(property: 'message', type: 'string', example: 'درخواست شارژ کیف پول ثبت شد.'),
|
||||
new OA\Property(
|
||||
property: 'data',
|
||||
properties: [
|
||||
new OA\Property(property: 'deposit', ref: '#/components/schemas/WalletDeposit'),
|
||||
new OA\Property(property: 'payment_url', type: 'string'),
|
||||
],
|
||||
type: 'object'
|
||||
),
|
||||
]
|
||||
)
|
||||
),
|
||||
new OA\Response(response: 401, description: 'Unauthenticated'),
|
||||
new OA\Response(response: 422, description: 'Validation error'),
|
||||
]
|
||||
)]
|
||||
public function store(InitiateDepositRequest $request): JsonResponse
|
||||
{
|
||||
$result = $this->walletDepositService->initiate($request->user(), $request->validated('amount'));
|
||||
|
||||
return $this->success('درخواست شارژ کیف پول ثبت شد.', [
|
||||
'deposit' => new WalletDepositResource($result['deposit']),
|
||||
'payment_url' => $result['payment_url'],
|
||||
], 201);
|
||||
}
|
||||
|
||||
#[OA\Get(
|
||||
path: '/wallet/deposits/{deposit}/callback',
|
||||
description: 'Public callback the payment gateway redirects to after a payment attempt',
|
||||
summary: 'Wallet deposit callback',
|
||||
tags: ['Wallet'],
|
||||
parameters: [
|
||||
new OA\Parameter(name: 'deposit', description: 'Deposit id', in: 'path', required: true, schema: new OA\Schema(type: 'integer')),
|
||||
],
|
||||
responses: [
|
||||
new OA\Response(response: 302, description: 'Redirects to the frontend wallet page with a status query param'),
|
||||
]
|
||||
)]
|
||||
public function callback(WalletDeposit $deposit, Request $request): RedirectResponse
|
||||
{
|
||||
$success = $this->walletDepositService->handleCallback($deposit, $request->query());
|
||||
|
||||
return redirect()->away(
|
||||
rtrim((string) config('app.frontend_url'), '/').'/wallet?status='.($success ? 'success' : 'failed')
|
||||
);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user