BreakPoint -> Starter Dev

.vscode/settings.json

@@ -0,0 +1,22 @@
+{
+    "workbench.colorCustomizations": {
+        "activityBar.activeBackground": "#7c83e9",
+        "activityBar.background": "#7c83e9",
+        "activityBar.foreground": "#15202b",
+        "activityBar.inactiveForeground": "#15202b99",
+        "activityBarBadge.background": "#f6c8cb",
+        "activityBarBadge.foreground": "#15202b",
+        "commandCenter.border": "#e7e7e799",
+        "sash.hoverBorder": "#7c83e9",
+        "statusBar.background": "#505ae2",
+        "statusBar.foreground": "#e7e7e7",
+        "statusBarItem.hoverBackground": "#7c83e9",
+        "statusBarItem.remoteBackground": "#505ae2",
+        "statusBarItem.remoteForeground": "#e7e7e7",
+        "titleBar.activeBackground": "#505ae2",
+        "titleBar.activeForeground": "#e7e7e7",
+        "titleBar.inactiveBackground": "#505ae299",
+        "titleBar.inactiveForeground": "#e7e7e799"
+    },
+    "peacock.color": "#505ae2"
+}

app/api/.env.sample

@@ -18,7 +18,7 @@ DB_USERNAME=root
 DB_PASSWORD=password
 
 BROADCAST_DRIVER=log
-CACHE_DRIVER=memcached
+CACHE_DRIVER=file
 SESSION_DRIVER=file
 SESSION_LIFETIME=120
 QUEUE_CONNECTION=sync
@@ -27,13 +27,14 @@ REDIS_HOST=redis
 REDIS_PASSWORD=null
 REDIS_PORT=6379
 
-MAIL_DRIVER=smtp
-MAIL_HOST=smtp.mailtrap.io
-MAIL_PORT=587
-MAIL_USERNAME=14b3bc30ce304d
-MAIL_PASSWORD=22b08660b859f6
-MAIL_FROM_ADDRESS="[email protected]"
-MAIL_FROM_NAME="${APP_NAME}"
+MAIL_MAILER=smtp
+MAIL_HOST=sandbox.smtp.mailtrap.io
+MAIL_PORT=2525
+MAIL_USERNAME=USERNAME
+MAIL_PASSWORD=PASSWORD
+MAIL_ENCRYPTION=tls
+[email protected]
+MAIL_FROM_NAME="Leave Management System"
 
 AWS_ACCESS_KEY_ID=
 AWS_SECRET_ACCESS_KEY=
@@ -55,3 +56,5 @@ VITE_PUSHER_HOST="${PUSHER_HOST}"
 VITE_PUSHER_PORT="${PUSHER_PORT}"
 VITE_PUSHER_SCHEME="${PUSHER_SCHEME}"
 VITE_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
+
+HOLIDAYS_YEAR="2025"

app/api/app/Applications/Document/Controllers/DocumentController.php

@@ -0,0 +1,82 @@
+<?php
+
+namespace App\Applications\Document\Controllers;
+
+use App\Applications\Document\DTO\DocumentDTO;
+use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
+use App\Applications\Document\Services\DocumentServiceInterface;
+use Illuminate\Support\Facades\Route;
+use Illuminate\Validation\ValidationException;
+use Symfony\Component\HttpFoundation\JsonResponse;
+
+/**
+ * @property DocumentServiceInterface $documentService
+ */
+class DocumentController extends Controller
+{
+    public function __construct(
+        DocumentServiceInterface $documentService
+    ) {
+        $this->documentService = $documentService;
+    }
+
+    /**
+     * Get a JSON with all the users
+     *
+     * @return JsonResponse
+     */
+    public function getAll(): JsonResponse
+    {
+        $leaveTypeDTOs = $this->documentService->getAll();
+        return response()->json($leaveTypeDTOs);
+    }
+
+    /**
+     * Get a JSON with a user by ID
+     *
+     * @param  integer  $id
+     * @return JsonResponse
+     */
+    public function get(int $id): JsonResponse
+    {
+        $leaveTypeDTO = $this->documentService->get($id);
+        return response()->json($leaveTypeDTO);
+    }
+
+    /**
+     * Get a paginated, filtered and sorted array of Users.
+     * This endpoint requires some data in the request.
+     *
+     * @param  Request  $request
+     * @return JsonResponse
+     */
+    public function draw(Request $request): JsonResponse
+    {
+        try {
+            $data = $request->all();
+            $leaveTypesDTO = $this->documentService->draw($data);
+
+            return response()->json($leaveTypesDTO);
+        } catch (\InvalidArgumentException $e) {
+            // Handle specific exceptions like InvalidArgumentException
+            return response()->json([
+                'error' => 'Invalid Argument',
+                'message' => $e->getMessage(),
+            ], 400); // Bad Request status code
+        } catch (\ValidationException $e) {
+            // Handle validation exceptions
+            return response()->json([
+                'error' => 'Validation Error',
+                'message' => $e->getMessage(),
+                'errors' => $e->errors(),
+            ], 422); // Unprocessable Entity status code
+        } catch (\Exception $e) {
+            // Handle any other general exceptions
+            return response()->json([
+                'error' => 'Server Error',
+                'message' => $e->getMessage(),
+            ], 500); // Internal Server Error status code
+        }
+    }
+}

app/api/app/Applications/Document/DTO/DocumentDTO.php

@@ -0,0 +1,86 @@
+<?php
+
+namespace App\Applications\Document\DTO;
+
+use App\Applications\Document\Model\Document;
+use Illuminate\Http\Request;
+
+class DocumentDTO
+{
+    public string $file_name;
+    public string $file_path;
+    public int $id;
+    public int $leave_request_id;
+    public int $user_id;
+
+    public function __construct(
+        string $file_name,
+        string $file_path,
+        int $id = 0,
+        int $leave_request_id = 0,
+        int $user_id = 0,
+    ) {
+        $this->file_name = $file_name;
+        $this->file_path = $file_path;
+        $this->id = $id;
+        $this->leave_request_id = $leave_request_id;
+        $this->user_id = $user_id;
+    }
+
+    public static function fromRequest(Request $request): self
+    {
+        return new self(
+            $request->input('file_name'),
+            $request->input('file_path'),
+            $request->input('id', 0),
+            $request->input('leave_request_id', 0),
+            $request->input('user_id', 0),
+        );
+    }
+
+    public static function fromRequestForCreate(Request $request): self
+    {
+        return new self(
+            $request->input('file_name'),
+            $request->input('file_path'),
+            id: 0,
+            leave_request_id: 0,
+            user_id: 0,
+        );
+    }
+
+    public static function fromModel(Document $document): self
+    {
+        return new self(
+            $document->file_name,
+            $document->file_path,
+            $document->id,
+            $document->leave_request_id,
+            $document->user_id,
+
+        );
+    }
+
+    public function jsonSerialize(): array
+    {
+        return $this->toArray();
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->file_name,
+            'slug' => $this->file_path,
+            'id' => $this->id,
+            'leave_request_id' => $this->leave_request_id,
+            'user_id' => $this->user_id,
+        ];
+    }
+
+    public static function fromCollection(iterable $leaveTypes): array
+    {
+        return array_map(function (Document $leaveType) {
+            return self::fromModel($leaveType);
+        }, $leaveTypes->all());
+    }
+}

app/api/app/Applications/Document/Model/Document.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace App\Applications\Document\Model;
+
+use Illuminate\Database\Eloquent\Model;
+
+class Document extends Model
+{
+    protected $fillable = ['user_id', 'leave_request_id', 'file_name', 'file_path'];
+    public $timestamps = true;
+}

app/api/app/Applications/Document/Providers/DocumentServiceProvider.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Applications\Document\Providers;
+
+use App\Applications\Document\Repositories\DocumentRepository;
+use App\Applications\Document\Repositories\DocumentRepositoryInterface;
+use App\Applications\Document\Services\DocumentService;
+use App\Applications\Document\Services\DocumentServiceInterface;
+use Illuminate\Support\Facades\Route;
+use Illuminate\Support\ServiceProvider;
+
+class DocumentServiceProvider extends ServiceProvider
+{
+    /**
+     * Set the service provider namespace
+     *
+     */
+    protected $namespace = 'App\Applications\Document';
+    /**
+     * Bootstrap the application services.
+     *
+     * @return void
+     */
+    public function boot()
+    {
+        if ($this->app->routesAreCached()) {
+         //  This is already done in the main RouteServiceProvider so not needed here
+        } else {
+
+            $this->app->call([$this, 'map']);
+
+            $this->app->booted(function () {
+                $this->app['router']->getRoutes()->refreshNameLookups();
+                $this->app['router']->getRoutes()->refreshActionLookups();
+            });
+        }
+    }
+
+    /**
+     * Register the application services.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        $this->app->bind(DocumentRepositoryInterface::class, DocumentRepository::class);
+        $this->app->bind(DocumentServiceInterface::class, DocumentService::class);
+    }
+
+    public function map()
+    {
+        Route::prefix('api')
+             ->middleware('api')
+             ->namespace($this->namespace)
+             ->group(base_path('routes/Document/api.php'));
+    }
+
+}

app/api/app/Applications/Document/Repositories/DocumentRepository.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Applications\Document\Repositories;
+
+use App\Applications\Document\DTO\DocumentDTO;
+use App\Applications\Pagination\StarterPaginator;
+use App\Applications\Document\Model\Document;
+
+
+/**
+ * @property Document $document
+ */
+class DocumentRepository implements DocumentRepositoryInterface
+{
+    public function __construct(
+        Document $document,
+    ) {
+        $this->document = $document;
+    }
+
+    private const COLUMNS_MAP = [
+        'file_name' => 'documents.file_name',
+        'file_path' => 'documents.file_path',
+    ];
+
+    public function getAll(): array
+    {
+        $documents = $this->document::all();
+        return DocumentDTO::fromCollection($documents);
+    }
+
+    public function get($id): Document
+    {
+        return $this->document::findOrFail($id);
+    }
+
+    public function draw($data): StarterPaginator
+    {
+        //        $paginatedUsers = $this->prepareDatatableQuery($data, [User::ADMIN, User::EDITOR, User::COLLABORATOR]);
+        $query = $this->document->query();
+
+        // $query->whereIn('roles.name', $roles);
+
+        if (array_key_exists($data['column'], self::COLUMNS_MAP)) {
+            $query->orderBy(self::COLUMNS_MAP[$data['column']], $data['dir']);
+        }
+
+        $userId = $data['userId'];
+        if ($userId ) {
+            $query->where('documents.user_id', '=', $userId);
+        }
+
+        return $query->paginate($data['length']);
+    }
+}

app/api/app/Applications/Document/Repositories/DocumentRepositoryInterface.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Applications\Document\Repositories;
+
+use App\Applications\Pagination\StarterPaginator;
+use App\Applications\Document\DTO\DocumentDTO;
+use App\Applications\Document\Model\Document;
+
+/**
+ * Interface DocumentRepositoryInterface
+ * @package App\Applications\Document
+ */
+
+interface DocumentRepositoryInterface
+{
+    /**
+     * @return array
+     */
+    public function getAll(): array;
+
+    /**
+     * @param integer $id
+     * @return Document
+     */
+    public function get($id);
+
+    /**
+     * @param array $data
+     * @return StarterPaginator
+     */
+    public function draw(array $data): StarterPaginator;
+
+}