First iteration of SendProposal feature

src/ForSendProposals/SendProposal/SendProposal.php

@@ -0,0 +1,21 @@
+<?php
+
+declare (strict_types=1);
+
+namespace App\ForSendProposals\SendProposal;
+
+
+final readonly class SendProposal
+{
+    public function __construct(
+        public string $title,
+        public string $description,
+        public string $name,
+        public string $email,
+        public string $type,
+        public bool   $sponsored,
+        public string $location
+    )
+    {
+    }
+}

src/ForSendProposals/SendProposal/SendProposalHandler.php

@@ -0,0 +1,14 @@
+<?php
+
+declare (strict_types=1);
+
+namespace App\ForSendProposals\SendProposal;
+
+
+class SendProposalHandler
+{
+    public function __invoke(SendProposal $command): SendProposalResponse
+    {
+        throw new \RuntimeException('Implement __invoke() method.');
+    }
+}

src/ForSendProposals/SendProposal/SendProposalResponse.php

@@ -0,0 +1,16 @@
+<?php
+
+declare (strict_types=1);
+
+namespace App\ForSendProposals\SendProposal;
+
+
+final readonly class SendProposalResponse
+{
+    public function __construct(
+        public bool   $success,
+        public string $id,
+        public string $title)
+    {
+    }
+}

tests/ForSendProposals/SendProposal/PayloadExample.php

@@ -0,0 +1,21 @@
+<?php
+
+declare (strict_types=1);
+
+namespace App\Tests\ForSendProposals\SendProposal;
+
+class PayloadExample
+{
+    public static function wellFormedWithTitle(string $title): array
+    {
+        return [
+            'title' => $title,
+            'description' => 'A description or abstract of the proposal',
+            'author' => 'Fran Iglesias',
+            'email' => 'fran.iglesias@example.com',
+            'type' => 'talk',
+            'sponsored' => true,
+            'location' => 'Vigo, Galicia',
+        ];
+    }
+}

tests/ForSendProposals/SendProposal/SendProposalControllerTest.php

@@ -0,0 +1,67 @@
+<?php
+
+declare (strict_types=1);
+
+namespace App\Tests\ForSendProposals\SendProposal;
+
+use App\ForSendProposals\SendProposal\SendProposal;
+use App\ForSendProposals\SendProposal\SendProposalController;
+use App\ForSendProposals\SendProposal\SendProposalHandler;
+use App\ForSendProposals\SendProposal\SendProposalResponse;
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\HttpFoundation\Request;
+use function PHPUnit\Framework\assertEquals;
+use function PHPUnit\Framework\assertStringContainsString;
+
+final class SendProposalControllerTest extends TestCase
+{
+    /** @test */
+    public function should_accept_well_formed_proposal(): void
+    {
+        $payload = PayloadExample::wellFormedWithTitle('Proposal Title');
+
+        $request = Request::create(
+            '/api/proposals',
+            'POST',
+            [],
+            [],
+            [],
+            ['CONTENT-TYPE' => 'json/application'],
+            json_encode($payload)
+        );
+        $handler = $this->createMock(SendProposalHandler::class);
+
+        $command = new SendProposal(
+            'Proposal Title',
+            'A description or abstract of the proposal',
+            'Fran Iglesias',
+            'fran.iglesias@example.com',
+            'talk',
+            true,
+            'Vigo, Galicia',
+        );
+
+        $expected = new SendProposalResponse(
+            true,
+            'proposal-id',
+            'Proposal Title'
+        );
+
+        $handler
+            ->method('__invoke')
+            ->with($command)
+            ->willReturn($expected);
+
+        $controller = new SendProposalController($handler);
+        $response = ($controller)($request);
+
+        assertEquals(202, $response->getStatusCode());
+        assertEquals('https://localhost/api/proposals/proposal-id', $response->headers->get("Location"));
+
+        $content = json_decode($response->getContent(), true);
+        assertStringContainsString(
+            'Your proposal titled "Proposal Title" was registered.',
+            $content['message']
+        );
+    }
+}