admin
a58e5eb60e
- Laravel 11.51 + PHP 8.4 in backend/
- MySQL 9 connection (DBngin, db: verde)
- Installed Sanctum, Spatie permission/activitylog/model-states,
matanyadaev/laravel-eloquent-spatial
- API routes prefixed /api/v1 in bootstrap/app.php
- Standard response envelope { success, data, message, errors, meta }
via ApiResponse + ApiController base class
- Global exception handlers for validation/auth/not-found/http errors
on api/* routes (always JSON, never redirect to login)
- Extended users migration: uuid, phone+verified_at, role enum
(admin/resident/driver/helper/scanner/store_partner), status,
first/middle/last name, avatar_path, preferred_language, fcm_token,
last_login_at, soft deletes
- User model: HasApiTokens, HasRoles, LogsActivity, SoftDeletes,
role/status constants, auto-uuid on create
- Health endpoint at GET /api/v1/health verifies DB connection
- backend/CLAUDE.md documenting backend conventions
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
47 lines
1.4 KiB
PHP
47 lines
1.4 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Controllers\Api\V1;
|
|
|
|
use App\Http\Controllers\Controller;
|
|
use App\Http\Responses\ApiResponse;
|
|
use Illuminate\Http\JsonResponse;
|
|
use Symfony\Component\HttpFoundation\Response;
|
|
|
|
abstract class ApiController extends Controller
|
|
{
|
|
protected function ok(mixed $data = null, ?string $message = null, array $meta = []): JsonResponse
|
|
{
|
|
return ApiResponse::success($data, $message, $meta);
|
|
}
|
|
|
|
protected function created(mixed $data = null, ?string $message = null): JsonResponse
|
|
{
|
|
return ApiResponse::success($data, $message, [], Response::HTTP_CREATED);
|
|
}
|
|
|
|
protected function noContent(): JsonResponse
|
|
{
|
|
return ApiResponse::success(null, null, [], Response::HTTP_NO_CONTENT);
|
|
}
|
|
|
|
protected function fail(string $message, mixed $errors = null, int $status = Response::HTTP_BAD_REQUEST): JsonResponse
|
|
{
|
|
return ApiResponse::error($message, $errors, $status);
|
|
}
|
|
|
|
protected function notFound(string $message = 'Resource not found'): JsonResponse
|
|
{
|
|
return ApiResponse::error($message, null, Response::HTTP_NOT_FOUND);
|
|
}
|
|
|
|
protected function unauthorized(string $message = 'Unauthorized'): JsonResponse
|
|
{
|
|
return ApiResponse::error($message, null, Response::HTTP_UNAUTHORIZED);
|
|
}
|
|
|
|
protected function forbidden(string $message = 'Forbidden'): JsonResponse
|
|
{
|
|
return ApiResponse::error($message, null, Response::HTTP_FORBIDDEN);
|
|
}
|
|
}
|