Add EditPostDto for wrapping PostEntity with accessor methods

README.md

@@ -1 +1,74 @@
-# Laravel-React-Portfolio
+# Laravel DDD API
+
+A Laravel-based API project built with Domain-Driven Design and Clean Architecture principles.  
+Designed for modularity, testability, and long-term maintainability.
+
+## Architecture
+
+This project follows a layered Clean Architecture:
+
+- **Presentation Layer**: Controllers, ViewModels
+- **Application Layer**: UseCases, Commands, DTOs, QueryServiceInterfaces
+- **Domain Layer**: Entities, Value Objects, RepositoryInterfaces
+- **Infrastructure Layer**: Eloquent Repositories, QueryServices
+
+### API Flow
+
+1. Controller constructs a Command object from request input.
+2. The Command is passed to a UseCase.
+3. UseCase invokes domain logic and persists data via a Repository.
+4. Resulting Entity is mapped to a DTO.
+5. The DTO is passed to a ViewModel and returned as a JsonResponse.
+
+## Tech Stack
+
+- PHP 8.x / Laravel 10.x
+- MySQL or PostgreSQL
+- PHPUnit (Unit/Feature testing)
+- Laravel Scout + Elasticsearch (optional)
+
+## Directory Structure
+```
+app/
+└── Posts/
+    ├── Application/
+    │   ├── ApplicationTests/
+    │   ├── UseCases/
+    │   ├── UseCommands/
+    │   ├── Dtos/
+    │   └── QueryServiceInterface/
+    ├── Domain/
+    │   ├── DomainTests/
+    │   ├── Entities/
+    │   ├── ValueObjects/
+    │   └── RepositoryInterfaces/
+    ├── Infrastructure/
+    │   ├── InfrastructureTests/
+    │   ├── Repositories/
+    │   └── QueryServices/
+    └── Presentation/
+        ├── Controllers/
+        ├── PresentationTests/
+        └── ViewModels/
+
+└── Users/
+    ├── Application/
+    │   ├── ApplicationTests/
+    │   ├── UseCases/
+    │   ├── UseCommands/
+    │   ├── Dtos/
+    │   └── QueryServiceInterface/
+    ├── Domain/
+    │   ├── DomainTests/
+    │   ├── Entities/
+    │   ├── ValueObjects/
+    │   └── RepositoryInterfaces/
+    ├── Infrastructure/
+    │   ├── InfrastructureTests/
+    │   ├── Repositories/
+    │   └── QueryServices/
+    └── Presentation/
+        ├── Controllers/
+        ├── PresentationTests/
+        └── ViewModels/
+```

src/.gitignore

@@ -22,4 +22,4 @@ yarn-error.log
 /.nova
 /.vscode
 /.zed
-.idea/workspace.xml
+.idea/

src/app/Common/Application/ApplicationTest/PaginationDtoTest.php

@@ -0,0 +1,63 @@
+<?php
+
+namespace App\Common\Application\ApplicationTest;
+
+use Tests\TestCase;
+use App\Common\Application\Dto\Pagination;
+use App\Common\Application\DtoFactory\PaginationFactory;
+
+class PaginationDtoTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+    }
+
+    protected function tearDown(): void
+    {
+        parent::tearDown();
+    }
+
+    private function arrayData(): array
+    {
+        return [
+            'data' => [
+                'id' =>1,
+                'title' => 'Portugal was the winner of the Nations League 2025',
+            ],
+            'current_page' => 2,
+            'from' => 11,
+            'to' => 20,
+            'per_page' => 10,
+            'path' => '/posts',
+            'last_page' => 5,
+            'total' => 50,
+            'first_page_url' => '/posts?page=1',
+            'last_page_url' => '/posts?page=5',
+            'next_page_url' => '/posts?page=3',
+            'prev_page_url' => '/posts?page=1',
+            'links' => [],
+        ];
+    }
+
+
+    public function test_check_pagination_type(): void
+    {
+        $result = PaginationFactory::build($this->arrayData()['data'], $this->arrayData());
+
+        $this->assertInstanceOf(Pagination::class, $result);
+    }
+
+    public function test_check_pagination_values(): void
+    {
+        $result = PaginationFactory::build($this->arrayData()['data'], $this->arrayData());
+
+        foreach ($this->arrayData() as $key => $expectedValue) {
+            if ($key === 'data') {
+                continue;
+            }
+            $getter = 'get' . ucfirst(str_replace('_', '', ucwords($key, '_')));
+            $this->assertEquals($expectedValue, $result->$getter());
+        }
+    }
+}