Add full Eye Care (ophthalmology) specialty clinical suite.

Mirror Emergency/Blood Bank depth with stages, workspace tabs, workflow/analytics services, reports/print, demo clinical seed, and feature tests.

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

tests/Feature/CareOphthalmologySuiteTest.php

@@ -0,0 +1,231 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Http\Middleware\EnsurePlatformSession;
+use App\Models\Appointment;
+use App\Models\Branch;
+use App\Models\Department;
+use App\Models\Member;
+use App\Models\Organization;
+use App\Models\Patient;
+use App\Models\SpecialtyClinicalRecord;
+use App\Models\User;
+use App\Models\Visit;
+use App\Services\Care\SpecialtyModuleService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class CareOphthalmologySuiteTest extends TestCase
+{
+    use RefreshDatabase;
+
+    protected User $owner;
+
+    protected Organization $organization;
+
+    protected Branch $branch;
+
+    protected Patient $patient;
+
+    protected Visit $visit;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->withoutMiddleware(EnsurePlatformSession::class);
+
+        $this->owner = User::create([
+            'public_id' => 'eye-owner',
+            'name' => 'Owner',
+            'email' => 'eye-owner@example.com',
+        ]);
+
+        $this->organization = Organization::create([
+            'owner_ref' => $this->owner->public_id,
+            'name' => 'Eye Clinic',
+            'slug' => 'eye-clinic',
+            'settings' => [
+                'onboarded' => true,
+                'facility_type' => 'clinic',
+                'plan' => 'pro',
+                'plan_expires_at' => now()->addMonth()->toIso8601String(),
+                'queue_integration_enabled' => true,
+            ],
+        ]);
+
+        Member::create([
+            'owner_ref' => $this->owner->public_id,
+            'organization_id' => $this->organization->id,
+            'user_ref' => $this->owner->public_id,
+            'role' => 'hospital_admin',
+            'branch_id' => null,
+        ]);
+
+        $this->branch = Branch::create([
+            'owner_ref' => $this->owner->public_id,
+            'organization_id' => $this->organization->id,
+            'name' => 'Main',
+            'is_active' => true,
+        ]);
+
+        app(SpecialtyModuleService::class)->activate(
+            $this->organization,
+            $this->owner->public_id,
+            'ophthalmology',
+        );
+
+        $department = Department::query()
+            ->where('branch_id', $this->branch->id)
+            ->where('type', 'ophthalmology')
+            ->firstOrFail();
+
+        $this->patient = Patient::create([
+            'owner_ref' => $this->owner->public_id,
+            'organization_id' => $this->organization->id,
+            'branch_id' => $this->branch->id,
+            'patient_number' => 'P-EYE-SUITE',
+            'first_name' => 'Ama',
+            'last_name' => 'Mensah',
+            'gender' => 'female',
+            'date_of_birth' => '1990-05-12',
+        ]);
+
+        $this->visit = Visit::create([
+            'owner_ref' => $this->owner->public_id,
+            'organization_id' => $this->organization->id,
+            'branch_id' => $this->branch->id,
+            'patient_id' => $this->patient->id,
+            'status' => Visit::STATUS_IN_PROGRESS,
+            'checked_in_at' => now(),
+            'specialty_stage' => 'check_in',
+        ]);
+
+        Appointment::create([
+            'owner_ref' => $this->owner->public_id,
+            'organization_id' => $this->organization->id,
+            'branch_id' => $this->branch->id,
+            'patient_id' => $this->patient->id,
+            'department_id' => $department->id,
+            'visit_id' => $this->visit->id,
+            'type' => Appointment::TYPE_WALK_IN,
+            'status' => Appointment::STATUS_IN_CONSULTATION,
+            'scheduled_at' => now(),
+            'waiting_at' => now(),
+            'checked_in_at' => now(),
+            'started_at' => now(),
+        ]);
+    }
+
+    public function test_overview_and_refraction_tabs_render(): void
+    {
+        $this->actingAs($this->owner)
+            ->get(route('care.specialty.workspace', [
+                'module' => 'ophthalmology',
+                'visit' => $this->visit,
+                'tab' => 'overview',
+            ]))
+            ->assertOk()
+            ->assertSee('Eye care overview')
+            ->assertSee('Visit stage')
+            ->assertSee('Eye care reports');
+
+        $this->actingAs($this->owner)
+            ->get(route('care.specialty.workspace', [
+                'module' => 'ophthalmology',
+                'visit' => $this->visit,
+                'tab' => 'refraction',
+            ]))
+            ->assertOk()
+            ->assertSee('Visual acuity OD')
+            ->assertSee('Sphere OD');
+    }
+
+    public function test_exam_sets_stage_and_iop_alerts(): void
+    {
+        $this->actingAs($this->owner)
+            ->post(route('care.specialty.clinical.save', [
+                'module' => 'ophthalmology',
+                'visit' => $this->visit,
+            ]), [
+                'tab' => 'exam',
+                'payload' => [
+                    'chief_complaint' => 'Blurry vision',
+                    'iop_od' => 32,
+                    'iop_os' => 18,
+                    'findings' => 'Elevated IOP OD',
+                    'va_od' => '6/60',
+                ],
+            ])
+            ->assertRedirect();
+
+        $this->assertSame('exam', $this->visit->fresh()->specialty_stage);
+
+        $record = SpecialtyClinicalRecord::query()
+            ->where('visit_id', $this->visit->id)
+            ->where('record_type', 'eye_exam')
+            ->firstOrFail();
+
+        $codes = collect($record->alerts)->pluck('code')->all();
+        $this->assertContains('eye.critical_iop', $codes);
+        $this->assertContains('eye.low_vision', $codes);
+    }
+
+    public function test_stage_advance_and_procedure_completes_visit(): void
+    {
+        $this->actingAs($this->owner)
+            ->post(route('care.specialty.ophthalmology.stage', $this->visit), [
+                'stage' => 'treatment',
+            ])
+            ->assertRedirect();
+
+        $this->assertSame('treatment', $this->visit->fresh()->specialty_stage);
+
+        $this->actingAs($this->owner)
+            ->post(route('care.specialty.ophthalmology.procedure', $this->visit), [
+                'tab' => 'treat',
+                'payload' => [
+                    'procedure' => 'Foreign body removal',
+                    'eye' => 'OD',
+                    'outcome' => 'Completed uneventfully',
+                    'post_op_plan' => 'Antibiotic drops 5 days',
+                ],
+            ])
+            ->assertRedirect(route('care.specialty.workspace', [
+                'module' => 'ophthalmology',
+                'visit' => $this->visit,
+                'tab' => 'treat',
+            ]));
+
+        $this->assertSame('completed', $this->visit->fresh()->specialty_stage);
+        $this->assertSame(Visit::STATUS_COMPLETED, $this->visit->fresh()->status);
+        $this->assertDatabaseHas('care_specialty_clinical_records', [
+            'visit_id' => $this->visit->id,
+            'record_type' => 'eye_procedure',
+            'status' => SpecialtyClinicalRecord::STATUS_COMPLETED,
+        ]);
+    }
+
+    public function test_reports_and_print(): void
+    {
+        $this->actingAs($this->owner)
+            ->get(route('care.specialty.ophthalmology.reports'))
+            ->assertOk()
+            ->assertSee('Eye care reports')
+            ->assertSee('Arrivals today');
+
+        $this->actingAs($this->owner)
+            ->get(route('care.specialty.ophthalmology.print', $this->visit))
+            ->assertOk()
+            ->assertSee('Eye care summary')
+            ->assertSee($this->patient->fullName());
+    }
+
+    public function test_list_index_does_not_auto_open_patient(): void
+    {
+        $this->actingAs($this->owner)
+            ->get(route('care.specialty.show', 'ophthalmology'))
+            ->assertOk()
+            ->assertDontSee('Eye care overview');
+    }
+}

tests/Feature/CareSpecialtyClinicalTest.php

@@ -202,9 +202,11 @@ class CareSpecialtyClinicalTest extends TestCase
             ->fieldsFor('ophthalmology', 'eye_exam');
         $names = collect($fields)->pluck('name')->all();
 
-        $this->assertContains('va_od', $names);
+        $this->assertContains('iop_od', $names);
         $this->assertContains('iop_os', $names);
-        $this->assertNotContains('notes', $names);
+        $this->assertContains('findings', $names);
+        $this->assertContains('chief_complaint', $names);
+        $this->assertNotContains('working_diagnosis', $names);
 
         [$visit] = $this->activateWithVisit('ophthalmology', 'ophthalmology');
 
@@ -215,7 +217,7 @@ class CareSpecialtyClinicalTest extends TestCase
                 'tab' => 'exam',
             ]))
             ->assertOk()
-            ->assertSee('Visual acuity OD')
+            ->assertSee('Chief complaint')
             ->assertSee('IOP OS');
     }
 }