soheilkhaledabadi/hoshpoint-backend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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:
soheil khaledabadi
2026-08-29 01:36:17 +03:30
parent fe2090a5af
commit 46ae711a20
42 changed files with 1632 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files

92
app/Http/Controllers/Api/NotificationController.php
View File

@@ -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,
]);
}
}

92
app/Http/Controllers/Api/ProfileController.php
View File

@@ -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('حساب کاربری با موفقیت حذف شد.');
}
}

114
app/Http/Controllers/Api/TemplateGenerationController.php
View File

@@ -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
View 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')
);
}
}

57
app/Http/Requests/Api/GenerateAiPresentationRequest.php Normal file
View File

@@ -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 کاراکتر باشد.',
];
}
}

35
app/Http/Requests/Api/InitiateDepositRequest.php Normal file
View File

@@ -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 تومان است.',
];
}
}

28
app/Http/Requests/Api/UpdateNotificationPreferencesRequest.php Normal file
View File

@@ -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'],
];
}
}

38
app/Http/Requests/Profile/ChangePasswordRequest.php Normal file
View File

@@ -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' => 'تکرار رمز عبور جدید مطابقت ندارد.',
];
}
}

4
app/Http/Requests/Profile/UpdateProfileRequest.php
View File

@@ -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' => 'حداکثر حجم تصویر ۳ مگابایت است.',
];
}
}

38
app/Http/Resources/NotificationPreferenceResource.php Normal file
View File

@@ -0,0 +1,38 @@
<?php
namespace App\Http\Resources;
use App\Models\NotificationPreference;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
use OpenApi\Attributes as OA;
#[OA\Schema(
schema: 'NotificationPreference',
properties: [
new OA\Property(property: 'comment_on_presentation', type: 'boolean', example: true),
new OA\Property(property: 'form_reply', type: 'boolean', example: false),
new OA\Property(property: 'new_follower', type: 'boolean', example: false),
new OA\Property(property: 'news_announcements', type: 'boolean', example: false),
new OA\Property(property: 'weekly_product_updates', type: 'boolean', example: true),
new OA\Property(property: 'weekly_blog_digest', type: 'boolean', example: false),
]
)]
/** @mixin NotificationPreference */
class NotificationPreferenceResource extends JsonResource
{
/**
* @return array<string, mixed>
*/
public function toArray(Request $request): array
{
return [
'comment_on_presentation' => $this->comment_on_presentation,
'form_reply' => $this->form_reply,
'new_follower' => $this->new_follower,
'news_announcements' => $this->news_announcements,
'weekly_product_updates' => $this->weekly_product_updates,
'weekly_blog_digest' => $this->weekly_blog_digest,
];
}
}

23
app/Http/Resources/TemplateGenerationResource.php
View File

@@ -11,6 +11,20 @@ use OpenApi\Attributes as OA;
schema: 'TemplateGeneration',
properties: [
new OA\Property(property: 'uuid', type: 'string', example: '9d6f0b1e-9a3a-4f0a-8a1a-6c9a2e5b3d10'),
new OA\Property(property: 'title', type: 'string', example: 'گزارش فروش سال ۱۴۰۴'),
new OA\Property(property: 'source', type: 'string', example: 'ai_text'),
new OA\Property(property: 'source_label', type: 'string', example: 'ساخت با هوش مصنوعی از متن'),
new OA\Property(property: 'language', type: 'string', example: 'fa', nullable: true),
new OA\Property(property: 'slide_count', type: 'integer', example: 10, nullable: true),
new OA\Property(
property: 'template',
properties: [
new OA\Property(property: 'title', type: 'string'),
new OA\Property(property: 'slug', type: 'string'),
],
type: 'object',
nullable: true
),
new OA\Property(property: 'status', type: 'string', example: 'completed'),
new OA\Property(property: 'status_label', type: 'string', example: 'تکمیل شده'),
new OA\Property(property: 'error_message', type: 'string', example: null, nullable: true),
@@ -28,6 +42,15 @@ class TemplateGenerationResource extends JsonResource
{
return [
'uuid' => $this->uuid,
'title' => $this->title ?: $this->template?->title,
'source' => $this->source->value,
'source_label' => $this->source->label(),
'language' => $this->language,
'slide_count' => $this->slide_count,
'template' => $this->template ? [
'title' => $this->template->title,
'slug' => $this->template->slug,
] : null,
'status' => $this->status->value,
'status_label' => $this->status->label(),
'error_message' => $this->error_message,

5
app/Http/Resources/UserResource.php
View File

@@ -5,6 +5,7 @@ namespace App\Http\Resources;
use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
use Illuminate\Support\Facades\Storage;
use OpenApi\Attributes as OA;
#[OA\Schema(
@@ -15,6 +16,8 @@ use OpenApi\Attributes as OA;
new OA\Property(property: 'username', type: 'string', example: 'ali'),
new OA\Property(property: 'email', type: 'string', format: 'email', example: 'ali@example.com'),
new OA\Property(property: 'mobile', type: 'string', example: '09123456789'),
new OA\Property(property: 'avatar_url', type: 'string', example: 'https://example.com/storage/avatars/1.png', nullable: true),
new OA\Property(property: 'is_public', type: 'boolean', example: false),
new OA\Property(property: 'created_at', type: 'string', format: 'date-time'),
]
)]
@@ -32,6 +35,8 @@ class UserResource extends JsonResource
'username' => $this->username,
'email' => $this->email,
'mobile' => $this->mobile,
'avatar_url' => $this->avatar_path ? Storage::disk('public')->url($this->avatar_path) : null,
'is_public' => $this->is_public,
'created_at' => $this->created_at?->toIso8601String(),
];
}

38
app/Http/Resources/WalletDepositResource.php Normal file
View File

@@ -0,0 +1,38 @@
<?php
namespace App\Http\Resources;
use App\Models\WalletDeposit;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
use OpenApi\Attributes as OA;
#[OA\Schema(
schema: 'WalletDeposit',
properties: [
new OA\Property(property: 'id', type: 'integer', example: 1),
new OA\Property(property: 'amount', type: 'integer', example: 500000),
new OA\Property(property: 'status', type: 'string', example: 'pending'),
new OA\Property(property: 'status_label', type: 'string', example: 'در انتظار پرداخت'),
new OA\Property(property: 'gateway', type: 'string', example: 'fake'),
new OA\Property(property: 'created_at', type: 'string', format: 'date-time'),
]
)]
/** @mixin WalletDeposit */
class WalletDepositResource extends JsonResource
{
/**
* @return array<string, mixed>
*/
public function toArray(Request $request): array
{
return [
'id' => $this->id,
'amount' => $this->amount,
'status' => $this->status->value,
'status_label' => $this->status->label(),
'gateway' => $this->gateway,
'created_at' => $this->created_at?->toIso8601String(),
];
}
}