Add visit placement on care units and beds.

Patients can be admitted, transferred, and discharged from unit/bed stays with occupancy sync, so MAR and ward boards have inpatient context.

Co-authored-by: Cursor <cursoragent@cursor.com>

app/Models/Bed.php

@@ -5,6 +5,8 @@ namespace App\Models;
 use App\Models\Concerns\BelongsToOwner;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\HasOne;
 use Illuminate\Database\Eloquent\SoftDeletes;
 
 class Bed extends Model
@@ -41,4 +43,18 @@ class Bed extends Model
     {
         return $this->belongsTo(CareUnit::class, 'care_unit_id');
     }
+
+    public function stays(): HasMany
+    {
+        return $this->hasMany(BedStay::class, 'bed_id');
+    }
+
+    public function activeStay(): HasOne
+    {
+        return $this->hasOne(BedStay::class, 'bed_id')
+            ->ofMany(
+                ['id' => 'max'],
+                fn ($query) => $query->where('status', BedStay::STATUS_ACTIVE),
+            );
+    }
 }

app/Models/BedStay.php

@@ -0,0 +1,67 @@
+<?php
+
+namespace App\Models;
+
+use App\Models\Concerns\BelongsToOwner;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class BedStay extends Model
+{
+    use BelongsToOwner;
+
+    public const STATUS_ACTIVE = 'active';
+
+    public const STATUS_ENDED = 'ended';
+
+    protected $table = 'care_bed_stays';
+
+    protected $fillable = [
+        'owner_ref',
+        'organization_id',
+        'visit_id',
+        'care_unit_id',
+        'bed_id',
+        'status',
+        'admitted_at',
+        'discharged_at',
+        'admitted_by',
+        'discharged_by',
+        'reason',
+        'notes',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'admitted_at' => 'datetime',
+            'discharged_at' => 'datetime',
+        ];
+    }
+
+    public function organization(): BelongsTo
+    {
+        return $this->belongsTo(Organization::class, 'organization_id');
+    }
+
+    public function visit(): BelongsTo
+    {
+        return $this->belongsTo(Visit::class, 'visit_id');
+    }
+
+    public function careUnit(): BelongsTo
+    {
+        return $this->belongsTo(CareUnit::class, 'care_unit_id');
+    }
+
+    public function bed(): BelongsTo
+    {
+        return $this->belongsTo(Bed::class, 'bed_id');
+    }
+
+    public function scopeActive(Builder $query): Builder
+    {
+        return $query->where('status', self::STATUS_ACTIVE);
+    }
+}

app/Models/CareUnit.php

@@ -53,6 +53,16 @@ class CareUnit extends Model
         return $this->hasMany(StaffAssignment::class, 'care_unit_id');
     }
 
+    public function visits(): HasMany
+    {
+        return $this->hasMany(Visit::class, 'care_unit_id');
+    }
+
+    public function activeStays(): HasMany
+    {
+        return $this->hasMany(BedStay::class, 'care_unit_id')->where('status', BedStay::STATUS_ACTIVE);
+    }
+
     public function supportsBeds(): bool
     {
         return $this->kind === 'inpatient';

app/Models/Visit.php

@@ -24,6 +24,7 @@ class Visit extends Model
 
     protected $fillable = [
         'uuid', 'owner_ref', 'organization_id', 'branch_id', 'patient_id',
+        'care_unit_id', 'bed_id', 'placed_at', 'placed_by',
         'status', 'specialty_stage', 'checked_in_at', 'completed_at', 'checked_in_by',
     ];
 
@@ -32,6 +33,7 @@ class Visit extends Model
         return [
             'checked_in_at' => 'datetime',
             'completed_at' => 'datetime',
+            'placed_at' => 'datetime',
         ];
     }
 
@@ -64,6 +66,30 @@ class Visit extends Model
         return $this->belongsTo(Organization::class, 'organization_id');
     }
 
+    public function careUnit(): BelongsTo
+    {
+        return $this->belongsTo(CareUnit::class, 'care_unit_id');
+    }
+
+    public function bed(): BelongsTo
+    {
+        return $this->belongsTo(Bed::class, 'bed_id');
+    }
+
+    public function bedStays(): HasMany
+    {
+        return $this->hasMany(BedStay::class, 'visit_id');
+    }
+
+    public function activeBedStay(): HasOne
+    {
+        return $this->hasOne(BedStay::class, 'visit_id')
+            ->ofMany(
+                ['id' => 'max'],
+                fn ($query) => $query->where('status', BedStay::STATUS_ACTIVE),
+            );
+    }
+
     public function appointment(): HasOne
     {
         return $this->hasOne(Appointment::class, 'visit_id');