feat: GetChapters endpoint + tests

src/Domain/Manga/Application/Query/GetMangaChapters.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace App\Domain\Manga\Application\Query;
+
+readonly class GetMangaChapters
+{
+    public function __construct(
+        public string $mangaId,
+        public ?int $page = 1,
+        public ?int $limit = 20,
+        public ?string $sortOrder = 'desc'
+    ) {}
+} 

src/Domain/Manga/Application/QueryHandler/GetMangaChaptersHandler.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Domain\Manga\Application\QueryHandler;
+
+use App\Domain\Manga\Application\Query\GetMangaChapters;
+use App\Domain\Manga\Application\Response\ChapterListResponse;
+use App\Domain\Manga\Application\Response\ChapterResponse;
+use App\Domain\Manga\Domain\Contract\Repository\MangaRepositoryInterface;
+use App\Domain\Manga\Domain\Exception\MangaNotFoundException;
+
+readonly class GetMangaChaptersHandler
+{
+    public function __construct(
+        private MangaRepositoryInterface $mangaRepository
+    ) {}
+
+    public function handle(GetMangaChapters $query): ChapterListResponse
+    {
+        $manga = $this->mangaRepository->findById($query->mangaId);
+        if (!$manga) {
+            throw new MangaNotFoundException();
+        }
+
+        $chapters = $this->mangaRepository->findChapters(
+            mangaId: $query->mangaId,
+            page: $query->page,
+            limit: $query->limit,
+            sortOrder: $query->sortOrder
+        );
+
+        $total = $this->mangaRepository->countChapters($query->mangaId);
+
+        return new ChapterListResponse(
+            chapters: array_map(
+                fn ($chapter) => new ChapterResponse(
+                    id: $chapter->getId(),
+                    number: $chapter->getNumber(),
+                    title: $chapter->getTitle(),
+                    volume: $chapter->getVolume(),
+                    isVisible: $chapter->isVisible(),
+                    createdAt: $chapter->getCreatedAt()
+                ),
+                $chapters
+            ),
+            total: $total,
+            page: $query->page,
+            limit: $query->limit
+        );
+    }
+} 

src/Domain/Manga/Application/Response/ChapterListResponse.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Domain\Manga\Application\Response;
+
+readonly class ChapterListResponse
+{
+    public function __construct(
+        public array $chapters,
+        public int $total,
+        public int $page,
+        public int $limit
+    ) {}
+
+    public function getTotalPages(): int
+    {
+        return (int) ceil($this->total / $this->limit);
+    }
+
+    public function hasNextPage(): bool
+    {
+        return $this->page < $this->getTotalPages();
+    }
+
+    public function hasPreviousPage(): bool
+    {
+        return $this->page > 1;
+    }
+} 

src/Domain/Manga/Application/Response/ChapterResponse.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Domain\Manga\Application\Response;
+
+readonly class ChapterResponse
+{
+    public function __construct(
+        public string $id,
+        public float $number,
+        public ?string $title,
+        public ?int $volume,
+        public bool $isVisible,
+        public \DateTimeImmutable $createdAt
+    ) {}
+} 

src/Domain/Manga/Domain/Contract/Repository/MangaRepositoryInterface.php

@@ -11,4 +11,6 @@ interface MangaRepositoryInterface
     public function findById(string $id): ?Manga;
     public function save(Manga $manga): void;
     public function delete(Manga $manga): void;
+    public function findChapters(string $mangaId, int $page = 1, int $limit = 20, string $sortOrder = 'desc'): array;
+    public function countChapters(string $mangaId): int;
 } 

src/Domain/Manga/Domain/Model/Chapter.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Domain\Manga\Domain\Model;
+
+use App\Domain\Manga\Domain\Model\ValueObject\ChapterId;
+
+readonly class Chapter
+{
+    public function __construct(
+        private ChapterId $id,
+        private string $mangaId,
+        private float $number,
+        private ?string $title,
+        private ?int $volume,
+        private bool $isVisible,
+        private \DateTimeImmutable $createdAt
+    ) {}
+
+    public function getId(): string
+    {
+        return $this->id->getValue();
+    }
+
+    public function getNumber(): float
+    {
+        return $this->number;
+    }
+
+    public function getTitle(): ?string
+    {
+        return $this->title;
+    }
+
+    public function getVolume(): ?int
+    {
+        return $this->volume;
+    }
+
+    public function isVisible(): bool
+    {
+        return $this->isVisible;
+    }
+
+    public function getCreatedAt(): \DateTimeImmutable
+    {
+        return $this->createdAt;
+    }
+} 

src/Domain/Manga/Domain/Model/ValueObject/ChapterId.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Domain\Manga\Domain\Model\ValueObject;
+
+readonly class ChapterId
+{
+    public function __construct(
+        private string $value
+    ) {}
+
+    public function getValue(): string
+    {
+        return $this->value;
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+} 

src/Domain/Manga/Infrastructure/ApiPlatform/Dto/ChapterCollection.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace App\Domain\Manga\Infrastructure\ApiPlatform\Dto;
+
+readonly class ChapterCollection
+{
+    public function __construct(
+        /** @var ChapterListItem[] */
+        public array $items,
+        public int $total,
+        public int $page,
+        public int $limit,
+        public bool $hasNextPage,
+        public bool $hasPreviousPage
+    ) {}
+} 

src/Domain/Manga/Infrastructure/ApiPlatform/Dto/ChapterListItem.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Domain\Manga\Infrastructure\ApiPlatform\Dto;
+
+use ApiPlatform\Metadata\ApiProperty;
+
+readonly class ChapterListItem
+{
+    public function __construct(
+        #[ApiProperty(identifier: true)]
+        public string $id,
+        public float $number,
+        public ?string $title,
+        public ?int $volume,
+        public bool $isVisible,
+        public string $createdAt
+    ) {}
+} 

src/Domain/Manga/Infrastructure/ApiPlatform/Resource/MangaChaptersResource.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Domain\Manga\Infrastructure\ApiPlatform\Resource;
+
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Get;
+use App\Domain\Manga\Infrastructure\ApiPlatform\Dto\ChapterCollection;
+use App\Domain\Manga\Infrastructure\ApiPlatform\State\Provider\GetMangaChaptersStateProvider;
+
+#[ApiResource(
+    shortName: 'MangaChapters',
+    operations: [
+        new Get(
+            uriTemplate: '/mangas/{id}/chapters',
+            provider: GetMangaChaptersStateProvider::class,
+            output: ChapterCollection::class
+        )
+    ]
+)]
+class MangaChaptersResource
+{
+} 

src/Domain/Manga/Infrastructure/ApiPlatform/State/Provider/GetMangaChaptersStateProvider.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Domain\Manga\Infrastructure\ApiPlatform\State\Provider;
+
+use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\ProviderInterface;
+use App\Domain\Manga\Application\Query\GetMangaChapters;
+use App\Domain\Manga\Application\QueryHandler\GetMangaChaptersHandler;
+use App\Domain\Manga\Application\Response\ChapterResponse;
+use App\Domain\Manga\Infrastructure\ApiPlatform\Dto\ChapterCollection;
+use App\Domain\Manga\Infrastructure\ApiPlatform\Dto\ChapterListItem;
+
+readonly class GetMangaChaptersStateProvider implements ProviderInterface
+{
+    public function __construct(
+        private GetMangaChaptersHandler $handler
+    ) {}
+
+    public function provide(Operation $operation, array $uriVariables = [], array $context = []): ChapterCollection
+    {
+        $page = $context['filters']['page'] ?? 1;
+        $limit = $context['filters']['limit'] ?? 20;
+        $sortOrder = $context['filters']['sortOrder'] ?? 'desc';
+
+        $query = new GetMangaChapters(
+            mangaId: $uriVariables['id'],
+            page: $page,
+            limit: $limit,
+            sortOrder: $sortOrder
+        );
+
+        $response = $this->handler->handle($query);
+
+        return new ChapterCollection(
+            items: array_map(
+                fn (ChapterResponse $chapter) => $this->createChapterListItem($chapter),
+                $response->chapters
+            ),
+            total: $response->total,
+            page: $response->page,
+            limit: $response->limit,
+            hasNextPage: $response->hasNextPage(),
+            hasPreviousPage: $response->hasPreviousPage()
+        );
+    }
+
+    private function createChapterListItem(ChapterResponse $chapter): ChapterListItem
+    {
+        return new ChapterListItem(
+            id: $chapter->id,
+            number: $chapter->number,
+            title: $chapter->title,
+            volume: $chapter->volume,
+            isVisible: $chapter->isVisible,
+            createdAt: $chapter->createdAt->format(\DateTimeInterface::RFC3339)
+        );
+    }
+} 

src/Domain/Manga/Infrastructure/Persistence/LegacyMangaRepository.php

@@ -10,6 +10,9 @@ use App\Domain\Manga\Domain\Model\ValueObject\MangaSlug;
 use App\Domain\Manga\Domain\Model\ValueObject\MangaTitle;
 use App\Entity\Manga as EntityManga;
 use Doctrine\ORM\EntityManagerInterface;
+use App\Domain\Manga\Domain\Model\Chapter;
+use App\Domain\Manga\Domain\Model\ValueObject\ChapterId;
+use App\Entity\Chapter as EntityChapter;
 
 readonly class LegacyMangaRepository implements MangaRepositoryInterface
 {
@@ -71,6 +74,36 @@ readonly class LegacyMangaRepository implements MangaRepositoryInterface
         }
     }
 
+    public function findChapters(string $mangaId, int $page = 1, int $limit = 20, string $sortOrder = 'desc'): array
+    {
+        $offset = ($page - 1) * $limit;
+        
+        $queryBuilder = $this->entityManager->createQueryBuilder()
+            ->select('c')
+            ->from(EntityChapter::class, 'c')
+            ->where('c.manga = :mangaId')
+            ->orderBy('c.number', $sortOrder)
+            ->setParameter('mangaId', $mangaId)
+            ->setFirstResult($offset)
+            ->setMaxResults($limit);
+
+        return array_map(
+            fn (EntityChapter $entity) => $this->toChapterDomain($entity),
+            $queryBuilder->getQuery()->getResult()
+        );
+    }
+
+    public function countChapters(string $mangaId): int
+    {
+        return $this->entityManager->createQueryBuilder()
+            ->select('COUNT(c.id)')
+            ->from(EntityChapter::class, 'c')
+            ->where('c.manga = :mangaId')
+            ->setParameter('mangaId', $mangaId)
+            ->getQuery()
+            ->getSingleScalarResult();
+    }
+
     private function toDomain(EntityManga $entity): DomainManga
     {
         return new DomainManga(
@@ -110,4 +143,17 @@ readonly class LegacyMangaRepository implements MangaRepositoryInterface
             $entity->setRating($manga->getRating());
         }
     }
+
+    private function toChapterDomain(EntityChapter $entity): Chapter
+    {
+        return new Chapter(
+            id: new ChapterId((string)$entity->getId()),
+            mangaId: $entity->getManga()->getId(),
+            number: $entity->getNumber(),
+            title: $entity->getTitle(),
+            volume: $entity->getVolume(),
+            isVisible: $entity->isVisible(),
+            createdAt: new \DateTimeImmutable()
+        );
+    }
 }