feat(patients): phase B2 — attachments (ضمیمه)

Add patient file attachments: a new PatientAttachment entity (record-scoped, CASCADE) + repository, and endpoints GET /patient/{uuid}/attachments, POST /patient/{uuid}/attachment (raw-body upload) and DELETE /patient/attachment/{uuid} (owner-scoped). Factor the shared raw-body upload logic into FileUploadService. Wire the "ضمیمه" tab in PatientDetailPage (upload + list + delete). PHPUnit covers list/delete/ownership; Vitest covers the tab. API docs updated. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-13 15:20:00 +03:30
parent 4c52316a49
commit 537bb8c7b3
10 changed files with 446 additions and 2 deletions
@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Patient\Entity;
+
+use App\Patient\Repository\PatientAttachmentRepository;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Component\Uid\Uuid;
+
+/** A file attached to a patient record (the «ضمیمه» tab). */
+#[ORM\Entity(repositoryClass: PatientAttachmentRepository::class)]
+#[ORM\Table(name: 'patient_attachments')]
+#[ORM\Index(columns: ['record_id'], name: 'idx_patient_attachments_record')]
+class PatientAttachment
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column(type: 'integer')]
+    private ?int $id = null;
+
+    #[ORM\Column(type: 'string', length: 36, unique: true)]
+    private string $uuid;
+
+    #[ORM\ManyToOne(targetEntity: PatientRecord::class)]
+    #[ORM\JoinColumn(name: 'record_id', nullable: false, onDelete: 'CASCADE')]
+    private PatientRecord $record;
+
+    #[ORM\Column(type: 'string', length: 200)]
+    private string $name;
+
+    #[ORM\Column(type: 'string', length: 500)]
+    private string $url;
+
+    #[ORM\Column(type: 'string', length: 100, nullable: true)]
+    private ?string $mime = null;
+
+    #[ORM\Column(type: 'integer', nullable: true)]
+    private ?int $size = null;
+
+    #[ORM\Column(name: 'created_at', type: 'integer')]
+    private int $createdAt;
+
+    public function __construct(PatientRecord $record, string $name, string $url, ?string $mime = null, ?int $size = null)
+    {
+        $this->uuid      = Uuid::v4()->toRfc4122();
+        $this->record    = $record;
+        $this->name      = $name;
+        $this->url       = $url;
+        $this->mime      = $mime;
+        $this->size      = $size;
+        $this->createdAt = time();
+    }
+
+    public function getId(): ?int            { return $this->id; }
+    public function getUuid(): string        { return $this->uuid; }
+    public function getRecord(): PatientRecord { return $this->record; }
+    public function getUrl(): string         { return $this->url; }
+
+    public function toArray(): array
+    {
+        return [
+            'uuid'       => $this->uuid,
+            'name'       => $this->name,
+            'url'        => $this->url,
+            'mime'       => $this->mime,
+            'size'       => $this->size,
+            'created_at' => $this->createdAt,
+        ];
+    }
+}