feat(patients): phase B3 — medical records (پرونده پزشکی)

Add patient medical-exam entries: a new PatientMedicalRecord entity
(record-scoped, CASCADE) + repository, and owner-scoped CRUD endpoints
(GET list, POST create, PATCH, DELETE) under /api/v1/patient. Wire the
"پرونده پزشکی" tab in PatientDetailPage (list + add/edit modal with title,
date and notes + delete). PHPUnit covers CRUD + ownership + validation;
Vitest covers the tab. API docs updated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
hamed
2026-07-13 15:27:34 +03:30
co-authored by Claude Opus 4.8
parent 98943ac249
commit 293eb8a0d2
8 changed files with 450 additions and 0 deletions
@@ -0,0 +1,68 @@
<?php
namespace App\Patient\Entity;
use App\Patient\Repository\PatientMedicalRecordRepository;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Uid\Uuid;
/** A medical examination / note entry on a patient record (the «پرونده پزشکی» tab). */
#[ORM\Entity(repositoryClass: PatientMedicalRecordRepository::class)]
#[ORM\Table(name: 'patient_medical_records')]
#[ORM\Index(columns: ['record_id'], name: 'idx_pmr_record')]
class PatientMedicalRecord
{
#[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 $title;
#[ORM\Column(type: 'text', nullable: true)]
private ?string $body = null;
/** Exam date (Unix ts); defaults to creation time. */
#[ORM\Column(name: 'recorded_at', type: 'integer')]
private int $recordedAt;
#[ORM\Column(name: 'created_at', type: 'integer')]
private int $createdAt;
public function __construct(PatientRecord $record, string $title, ?string $body = null, ?int $recordedAt = null)
{
$this->uuid = Uuid::v4()->toRfc4122();
$this->record = $record;
$this->title = $title;
$this->body = $body;
$this->createdAt = time();
$this->recordedAt = $recordedAt ?? $this->createdAt;
}
public function getId(): ?int { return $this->id; }
public function getUuid(): string { return $this->uuid; }
public function getRecord(): PatientRecord { return $this->record; }
public function setTitle(string $v): self { $this->title = $v; return $this; }
public function setBody(?string $v): self { $this->body = $v; return $this; }
public function setRecordedAt(int $v): self { $this->recordedAt = $v; return $this; }
public function toArray(): array
{
return [
'uuid' => $this->uuid,
'title' => $this->title,
'body' => $this->body,
'recorded_at' => $this->recordedAt,
'created_at' => $this->createdAt,
];
}
}