first commit

2026-01-09 12:54:53 +05:30
commit 7ccf44f7da
1070 changed files with 113036 additions and 0 deletions
--- a/app/Http/Controllers/Api/PriorityController.php
+++ b/app/Http/Controllers/Api/PriorityController.php
@@ -0,0 +1,220 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Requests\Priority\CreatePriorityRequest;
+use App\Http\Requests\Priority\DestroyPriorityRequest;
+use App\Http\Requests\Priority\ListPriorityRequest;
+use App\Http\Requests\Priority\ShowPriorityRequest;
+use App\Http\Requests\Priority\UpdatePriorityRequest;
+use App\Models\Priority;
+use Exception;
+use Illuminate\Http\JsonResponse;
+use Throwable;
+
+class PriorityController extends ItemController
+{
+    protected const MODEL = Priority::class;
+
+    /**
+     * @throws Throwable
+     * @api             {post} /priorities/show Show
+     * @apiDescription  Show priority.
+     *
+     * @apiVersion      4.0.0
+     * @apiName         Show Priority
+     * @apiGroup        Priority
+     *
+     * @apiUse          AuthHeader
+     *
+     * @apiParam {Integer} id  Priority ID
+     *
+     * @apiParamExample {json} Request Example
+     * {
+     *   "id": 1
+     * }
+     *
+     * @apiSuccess {Object}   res      Priority
+     *
+     * @apiUse          PriorityObject
+     *
+     * @apiSuccessExample {json} Response Example
+     *  HTTP/1.1 200 OK
+     *  {
+     *    "res": {
+     *      "id": 1
+     *      "name": "Normal",
+     *      "color": null
+     *    }
+     *  }
+     *
+     * @apiUse          400Error
+     * @apiUse          UnauthorizedError
+     *
+     */
+    public function show(ShowPriorityRequest $request): JsonResponse
+    {
+        return $this->_show($request);
+    }
+
+    /**
+     * @throws Exception
+     * @api             {get} /priorities/list List
+     * @apiDescription  Get list of priorities.
+     *
+     * @apiVersion      4.0.0
+     * @apiName         Priority List
+     * @apiGroup        Priority
+     *
+     * @apiUse          AuthHeader
+     *
+     * @apiSuccess {Object}   res      Priority
+     *
+     * @apiUse          PriorityObject
+     *
+     * @apiSuccessExample {json} Response Example
+     *  HTTP/1.1 200 OK
+     *  {
+     *    "res": [{
+     *      "id": 1
+     *      "name": "Normal",
+     *      "color": null
+     *    }]
+     *  }
+     *
+     * @apiUse          400Error
+     * @apiUse          UnauthorizedError
+     *
+     */
+    public function index(ListPriorityRequest $request): JsonResponse
+    {
+        return $this->_index($request);
+    }
+
+    /**
+     * @param CreatePriorityRequest $request
+     * @return JsonResponse
+     * @throws Throwable
+     * @api             {post} /priorities/create Create
+     * @apiDescription  Creates priority
+     *
+     * @apiVersion      4.0.0
+     * @apiName         Create Priority
+     * @apiGroup        Priority
+     *
+     * @apiUse          AuthHeader
+     *
+     * @apiParam {String}  name   Priority name
+     * @apiParam {String}  color  Priority color
+     *
+     * @apiParamExample {json} Request Example
+     *  {
+     *    "name": "Normal",
+     *    "color": null
+     *  }
+     *
+     * @apiSuccess {Object}   res      Priority
+     *
+     * @apiUse          PriorityObject
+     * @apiUse          400Error
+     * @apiUse          UnauthorizedError
+     */
+    public function create(CreatePriorityRequest $request): JsonResponse
+    {
+        return $this->_create($request);
+    }
+
+    /**
+     * @throws Throwable
+     * @api             {post} /priorities/edit Edit
+     * @apiDescription  Edit Priority
+     *
+     * @apiVersion      4.0.0
+     * @apiName         Edit
+     * @apiGroup        Priority
+     *
+     * @apiUse          AuthHeader
+     *
+     * @apiParam {Integer}  id           ID
+     * @apiParam {String}   name   Priority name
+     * @apiParam {String}   color  Priority color
+     *
+     * @apiParamExample {json} Simple Request Example
+     *  {
+     *    "id": 1,
+     *    "name": "Normal",
+     *    "color": null
+     *  }
+     *
+     * @apiSuccess {Object}   res      Priority
+     *
+     * @apiUse         PriorityObject
+     * @apiUse         400Error
+     * @apiUse         ValidationError
+     * @apiUse         UnauthorizedError
+     * @apiUse         ItemNotFoundError
+     */
+    public function edit(UpdatePriorityRequest $request): JsonResponse
+    {
+        return $this->_edit($request);
+    }
+
+    /**
+     * @throws Throwable
+     * @api             {post} /priorities/remove Destroy
+     * @apiDescription  Destroy User
+     *
+     * @apiVersion      4.0.0
+     * @apiName         Destroy Priority
+     * @apiGroup        Priority
+     *
+     * @apiUse          AuthHeader
+     *
+     * @apiParam {Integer}  id  ID of the target priority
+     *
+     * @apiParamExample {json} Request Example
+     * {
+     *   "id": 1
+     * }
+     *
+     * @apiSuccess {String}   message  Destroy status
+     *
+     * @apiSuccessExample {json} Response Example
+     *  HTTP/1.1 200 OK
+     *  {
+     *    "message": "Item has been removed"
+     *  }
+     *
+     * @apiUse          400Error
+     * @apiUse          ValidationError
+     * @apiUse          ForbiddenError
+     * @apiUse          UnauthorizedError
+     */
+    public function destroy(DestroyPriorityRequest $request): JsonResponse
+    {
+        return $this->_destroy($request);
+    }
+
+    /**
+     * @api             {get} /api/priorities/count Count Priorities
+     * @apiDescription  Returns the total count of priorities
+     *
+     * @apiVersion      4.0.0
+     * @apiName         CountPriorities
+     * @apiGroup        Priorities
+     *
+     * @apiUse          TotalSuccess
+     *
+     * @apiUse 400Error
+     * @apiUse UnauthorizedError
+     */
+    /**
+     * @param ListPriorityRequest $request
+     * @return JsonResponse
+     * @throws Exception
+     */
+    public function count(ListPriorityRequest $request): JsonResponse
+    {
+        return $this->_count($request);
+    }
+}