sam-api/app/Http/Controllers/Api/V1/MemberController.php

<?php

namespace App\Http\Controllers\Api\V1;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use App\Services\MemberService;
use App\Helpers\ApiResponse;

class MemberController extends Controller
{
    /**
     * @OA\Get(
     *     path="/api/v1/member/index",
     *     summary="회원 목록 조회",
     *     description="회원 목록을 조회합니다.",
     *     tags={"Member"},
     *     security={{"ApiKeyAuth":{}}},
     *
     *     @OA\Parameter(
     *         name="user_token",
     *         in="query",
     *         required=true,
     *         description="회원 인증용 토큰",
     *         @OA\Schema(type="string", example="abc123token")
     *     ),
     *
     *     @OA\Response(
     *         response=200,
     *         description="회원 목록 조회 성공",
     *         @OA\JsonContent(
     *             type="object",
     *             @OA\Property(property="success", type="boolean", example=true),
     *             @OA\Property(property="message", type="string", example="회원목록 조회 성공"),
     *             @OA\Property(
     *                 property="data",
     *                 type="object",
     *                 @OA\Property(
     *                     property="1",
     *                     type="object",
     *                     @OA\Property(property="mb_num", type="integer", example=1),
     *                     @OA\Property(property="tn_num", type="string", example=null),
     *                     @OA\Property(property="mb_id", type="string", example="admin"),
     *                     @OA\Property(property="mb_name", type="string", example="권혁성"),
     *                     @OA\Property(property="mb_phone", type="string", example="010-4820-9104"),
     *                     @OA\Property(property="mb_mail", type="string", example="shine1324@gmail.com"),
     *                     @OA\Property(property="email_verified_at", type="string", format="date-time", example=null),
     *                     @OA\Property(property="mb_type", type="string", example=null),
     *                     @OA\Property(property="mb_level", type="integer", example=1),
     *                     @OA\Property(property="last_login", type="string", format="date-time", example=null),
     *                     @OA\Property(property="reg_date", type="string", format="date-time", example="2025-07-16T09:28:41.000000Z"),
     *                     @OA\Property(property="created_at", type="string", format="date-time", example=null),
     *                     @OA\Property(property="updated_at", type="string", format="date-time", example="2025-07-16T09:30:56.000000Z")
     *                 )
     *             )
     *         )
     *     ),
     *
     *     @OA\Response(response=401, description="인증 실패"),
     *     @OA\Response(response=403, description="권한 없음")
     * )
     */
    public function index(Request $request)
    {
        try {

            $type = $request->input('type', 'default');
            $userToken = $request->input('user_token', '');
            $debug = $request->boolean('debug', false);
            $result = MemberService::getMembers($userToken, $type, $debug);

            return ApiResponse::success($result['data'], '회원목록 조회 성공',$result['query']);
        } catch (\Throwable $e) {
            return ApiResponse::error('회원목록 조회 실패', 500, [
                'details' => $e->getMessage(),
            ]);
        }
    }


    /**
     * Show the form for creating a new resource.
     */
    public function create()
    {
        //
    }

    /**
     * Store a newly created resource in storage.
     */
    public function store(Request $request)
    {
        return ApiResponse::handle(function () use ($request) {
            return MemberService::setMember($request->all());
        }, '회원등록 성공', '회원등록 실패');
    }

    /**
     * @OA\Get (
     *     path="/api/member/V1/show/{user_no}",
     *     summary="회원 상세조회",
     *     description="user_no 기준으로 회원 상세 정보를 조회합니다.",
     *     tags={"Member"},
     *     security={{"ApiKeyAuth":{}}},
     *
     *     @OA\Parameter(
     *         name="user_no",
     *         in="path",
     *         required=true,
     *         description="회원 번호 (USER_NO)",
     *         @OA\Schema(type="integer", example=1)
     *     ),
     *     @OA\Parameter(
     *         name="debug",
     *         in="query",
     *         required=false,
     *         description="디버그 모드 여부 (쿼리 확인용)",
     *         @OA\Schema(type="boolean", example=true)
     *     ),
     *
     *     @OA\Response(
     *         response=200,
     *         description="조회 성공",
     *         @OA\JsonContent(
     *             type="object",
     *             @OA\Property(property="success", type="boolean", example=true),
     *             @OA\Property(property="message", type="string", example="회원 상세조회 성공"),
     *             @OA\Property(
     *                 property="data",
     *                 type="object",
     *                 @OA\Property(property="mb_num", type="integer", example=1),
     *                 @OA\Property(property="tn_num", type="string", example=null),
     *                 @OA\Property(property="mb_id", type="string", example="admin"),
     *                 @OA\Property(property="mb_name", type="string", example="권혁성"),
     *                 @OA\Property(property="mb_phone", type="string", example="010-4820-9104"),
     *                 @OA\Property(property="mb_mail", type="string", example="shine1324@gmail.com"),
     *                 @OA\Property(property="email_verified_at", type="string", format="date-time", example=null),
     *                 @OA\Property(property="mb_type", type="string", example=null),
     *                 @OA\Property(property="mb_level", type="integer", example=1),
     *                 @OA\Property(property="last_login", type="string", format="date-time", example=null),
     *                 @OA\Property(property="reg_date", type="string", format="date-time", example="2025-07-16T09:28:41.000000Z"),
     *                 @OA\Property(property="created_at", type="string", format="date-time", example=null),
     *                 @OA\Property(property="updated_at", type="string", format="date-time", example="2025-07-16T09:30:56.000000Z")
     *             )
     *         )
     *     ),
     *
     *     @OA\Response(response=404, description="회원 정보 없음"),
     *     @OA\Response(response=401, description="인증 실패")
     * )
     */
    public function show(Request $request, $userNo)
    {
        try {

            $debug = $request->boolean('debug', false);
            $result = MemberService::getMember($userNo, $debug);

            return ApiResponse::success($result['data'], '회원 상세조회 성공',$result['query']);
        } catch (\Throwable $e) {
            return ApiResponse::error('회원 상세조회 실패', 500, [
                'details' => $e->getMessage(),
            ]);
        }
    }

    /**
     * Show the form for editing the specified resource.
     */
    public function edit(string $id)
    {
        //
    }

    /**
     * Update the specified resource in storage.
     */
    public function update(Request $request, string $id)
    {
        //
    }

    /**
     * Remove the specified resource from storage.
     */
    public function delAdmin($userNo, Request $request)
    {
        return ApiResponse::handle(function () use ($userNo, $request) {
            return MemberService::delAdmin($userNo);
        }, '관리자 제외 성공', '관리자 제외 실패');
    }

    /**
     * 관리자 설정
     */
    public function setAdmin($userNo, Request $request)
    {
        return ApiResponse::handle(function () use ($userNo, $request) {
            return MemberService::setAdmin($userNo);
        }, '관리자 설정 성공', '관리자 설정 실패');
    }
}