portal-api/app/Http/Controllers/Api/Client/ClientController.php

<?php

namespace App\Http\Controllers\Api\Client;

use App\Http\Controllers\Controller;
use App\Http\Requests\Api\Client\ClientAuthRequest;
use App\Http\Requests\Api\Client\ClientRegisterRequest;
use App\Http\Resources\Api\Client\ClientResource;
use App\Services\Api\Client\ClientAuthService;
use Illuminate\Support\Facades\Auth;

/**
 * @OA\Tag(
 *     name="Client Authentication",
 *     description="API Endpoints for Client Authentication"
 * )
 */
class ClientController extends Controller
{
    protected $authService;

    public function __construct(ClientAuthService $authService)
    {
        $this->authService = $authService;
    }

    /**
     * @OA\Get(
     *     path="/client/me",
     *     operationId="getClientMe",
     *     tags={"Client Authentication"},
     *     summary="Get current client information",
     *     description="Returns the currently authenticated client's details",
     *     security={{"bearerAuth":{}}},
     *     @OA\Response(
     *         response=200,
     *         description="Successful operation",
     *         @OA\JsonContent(
     *             @OA\Property(property="customer", type="object",
     *                 @OA\Property(property="fullname", type="string", example="Nguyen Van A"),
     *                 @OA\Property(property="email", type="string", example="client@example.com"),
     *                 @OA\Property(property="phone", type="string", example="0987654321"),
     *                 @OA\Property(property="address", type="string", example="123 Street"),
     *                 @OA\Property(property="city", type="string", example="Hanoi"),
     *                 @OA\Property(property="ward", type="string", example="Ward 1"),
     *                 @OA\Property(property="province", type="string", example="Hanoi"),
     *                 @OA\Property(property="gender", type="string", example="Nam"),
     *                 @OA\Property(property="date", type="string", format="date-time", example="2024-01-01 12:00:00"),
     *                 @OA\Property(property="company", type="string", example="Company Ltd"),
     *                 @OA\Property(property="avatar", type="string", example="/uploads/avatar.jpg"),
     *                 @OA\Property(property="cmnd_after", type="string", example="cmnd_back.jpg"),
     *                 @OA\Property(property="cmnd_before", type="string", example="cmnd_front.jpg"),
     *                 @OA\Property(property="cmnd", type="string", example="123456789"),
     *                 @OA\Property(property="fb_link", type="string", nullable=true),
     *                 @OA\Property(property="active_2fa", type="integer", example=0),
     *                 @OA\Property(property="off_mail_marketing", type="integer", example=0),
     *                 @OA\Property(property="is_recharge_zalo", type="integer", example=0),
     *                 @OA\Property(property="is_verify_telegram", type="integer", example=0)
     *             ),
     *             @OA\Property(property="credit", type="object",
     *                 @OA\Property(property="credit", type="number", example=1000000),
     *                 @OA\Property(property="total", type="number", example=5000000),
     *                 @OA\Property(property="point", type="number", example=100),
     *                 @OA\Property(property="point_used", type="integer", example=0),
     *                 @OA\Property(property="point_total", type="number", example=100)
     *             ),
     *             @OA\Property(property="service", type="object",
     *                 @OA\Property(property="vps", type="integer", example=2),
     *                 @OA\Property(property="proxy", type="integer", example=0),
     *                 @OA\Property(property="server", type="integer", example=0),
     *                 @OA\Property(property="hosting", type="integer", example=1),
     *                 @OA\Property(property="domain", type="integer", example=3)
     *             )
     *         )
     *     ),
     *     @OA\Response(
     *         response=401,
     *         description="Unauthenticated"
     *     )
     * )
     */
    public function me()
    {
        return new ClientResource(auth('client')->user());
    }

    /**
     * @OA\Post(
     *     path="/client/login",
     *     operationId="clientLogin",
     *     tags={"Client Authentication"},
     *     summary="Client login",
     *     description="Authenticate a client and return access token",
     *     @OA\RequestBody(
     *         required=true,
     *         @OA\JsonContent(
     *             required={"email","password"},
     *             @OA\Property(property="email", type="string", format="email", example="client@example.com"),
     *             @OA\Property(property="password", type="string", format="password", example="password123")
     *         )
     *     ),
     *     @OA\Response(
     *         response=200,
     *         description="Login successful",
     *         @OA\JsonContent(
     *             @OA\Property(property="error", type="boolean", example=false),
     *             @OA\Property(property="data", type="object",
     *                 @OA\Property(property="client", type="object"),
     *                 @OA\Property(property="token", type="string", example="1|laravel_sanctum_token...")
     *             )
     *         )
     *     ),
     *     @OA\Response(
     *         response=422,
     *         description="Validation error"
     *     )
     * )
     */
    public function login(ClientAuthRequest $request)
    {
        $result = $this->authService->authenticateClient($request->validated());

        return response()->json([
            'error' => false,
            'data' => [
                'client' => new ClientResource($result['client']),
                'token' => $result['token'],
            ],
        ]);
    }

    /**
     * @OA\Post(
     *     path="/client/register",
     *     operationId="clientRegister",
     *     tags={"Client Authentication"},
     *     summary="Client registration",
     *     description="Register a new client account",
     *     @OA\RequestBody(
     *         required=true,
     *         @OA\JsonContent(
     *             required={"fullname","phone","email","password","password_confirmation"},
     *             @OA\Property(property="fullname", type="string", example="Nguyen Van A"),
     *             @OA\Property(property="phone", type="string", example="0987654321"),
     *             @OA\Property(property="email", type="string", format="email", example="client@example.com"),
     *             @OA\Property(property="password", type="string", format="password", example="password123"),
     *             @OA\Property(property="password_confirmation", type="string", format="password", example="password123")
     *         )
     *     ),
     *     @OA\Response(
     *         response=200,
     *         description="Registration successful",
     *         @OA\JsonContent(
     *             @OA\Property(property="error", type="boolean", example=false),
     *             @OA\Property(property="data", type="object",
     *                 @OA\Property(property="client", type="object"),
     *                 @OA\Property(property="token", type="string", example="1|laravel_sanctum_token...")
     *             )
     *         )
     *     ),
     *     @OA\Response(
     *         response=422,
     *         description="Validation error"
     *     )
     * )
     */
    public function register(ClientRegisterRequest $request)
    {
        $result = $this->authService->registerClient($request->validated());

        return response()->json([
            'error' => false,
            'data' => [
                'client' => new ClientResource($result['client']),
                'token' => $result['token'],
            ],
        ]);
    }

    /**
     * @OA\Post(
     *     path="/client/logout",
     *     operationId="clientLogout",
     *     tags={"Client Authentication"},
     *     summary="Client logout",
     *     description="Logout the currently authenticated client",
     *     security={{"bearerAuth":{}}},
     *     @OA\Response(
     *         response=200,
     *         description="Logout successful",
     *         @OA\JsonContent(
     *             @OA\Property(property="error", type="boolean", example=false),
     *             @OA\Property(property="message", type="string", example="Đã đăng xuất thành công.")
     *         )
     *     ),
     *     @OA\Response(
     *         response=401,
     *         description="Unauthenticated"
     *     )
     * )
     */
    public function logout()
    {
        auth('client')->logout();

        return response()->json([
            'error' => false,
            'message' => 'Đã đăng xuất thành công.',
        ]);
    }
}