Add full Vaccination, Pathology, and Infusion specialty clinical suites.

Mirror Oncology-depth stage flows, workspace controllers, clinical forms, reports/print, demo seed, and suite tests. Pathology stays clinic specialty complementary to the Lab app.

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

app/Http/Controllers/Care/InfusionWorkspaceController.php

@@ -0,0 +1,214 @@
+<?php
+
+namespace App\Http\Controllers\Care;
+
+use App\Http\Controllers\Care\Concerns\ScopesToAccount;
+use App\Http\Controllers\Controller;
+use App\Models\SpecialtyClinicalRecord;
+use App\Models\Visit;
+use App\Services\Care\Infusion\InfusionAnalyticsService;
+use App\Services\Care\Infusion\InfusionWorkflowService;
+use App\Services\Care\SpecialtyClinicalRecordService;
+use App\Services\Care\SpecialtyModuleService;
+use App\Services\Care\SpecialtyShellService;
+use App\Services\Care\SpecialtyVisitStageService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class InfusionWorkspaceController extends Controller
+{
+    use ScopesToAccount;
+
+    protected function assertInfusionAccess(Request $request, SpecialtyModuleService $modules): void
+    {
+        $organization = $this->organization($request);
+        abort_unless($modules->memberCanAccess($organization, $this->member($request), 'infusion'), 403);
+    }
+
+    protected function assertInfusionManage(Request $request, SpecialtyModuleService $modules): void
+    {
+        $organization = $this->organization($request);
+        abort_unless($modules->memberCanManage($organization, $this->member($request), 'infusion'), 403);
+    }
+
+    protected function assertVisit(Request $request, Visit $visit): void
+    {
+        abort_unless($visit->organization_id === $this->organization($request)->id, 404);
+        $this->authorizeBranch($request, (int) $visit->branch_id);
+    }
+
+    public function setStage(
+        Request $request,
+        Visit $visit,
+        SpecialtyModuleService $modules,
+        SpecialtyVisitStageService $stages,
+        SpecialtyShellService $shell,
+    ): RedirectResponse {
+        $this->authorizeAbility($request, 'consultations.manage');
+        $this->assertInfusionManage($request, $modules);
+        $this->assertVisit($request, $visit);
+
+        $validated = $request->validate([
+            'stage' => ['required', 'string', 'max:32'],
+        ]);
+
+        try {
+            $stages->setStage(
+                $this->organization($request),
+                $visit,
+                'infusion',
+                $validated['stage'],
+                $this->ownerRef($request),
+                $this->actorRef($request),
+            );
+        } catch (\InvalidArgumentException $e) {
+            return back()->with('error', $e->getMessage());
+        }
+
+        return redirect()
+            ->route('care.specialty.workspace', [
+                'module' => 'infusion',
+                'visit' => $visit,
+                'tab' => $shell->workspaceTabForStage('infusion', $validated['stage']),
+            ])
+            ->with('success', 'Visit stage updated.');
+    }
+
+    public function saveMonitoring(
+        Request $request,
+        Visit $visit,
+        SpecialtyModuleService $modules,
+        SpecialtyClinicalRecordService $clinical,
+        SpecialtyVisitStageService $stages,
+        InfusionWorkflowService $workflow,
+    ): RedirectResponse {
+        $this->authorizeAbility($request, 'consultations.manage');
+        $this->assertInfusionManage($request, $modules);
+        $this->assertVisit($request, $visit);
+
+        $organization = $this->organization($request);
+        $owner = $this->ownerRef($request);
+
+        $payload = (array) $request->input('payload', []);
+        foreach ($clinical->fieldsFor('infusion', 'infusion_monitoring') as $field) {
+            if (($field['type'] ?? '') === 'boolean') {
+                $payload[$field['name']] = $request->boolean('payload.'.$field['name']);
+            }
+        }
+        $request->merge(['payload' => $payload, 'tab' => 'monitoring']);
+
+        $validated = $request->validate(array_merge([
+            'tab' => ['required', 'string'],
+        ], $clinical->validationRules('infusion', 'infusion_monitoring')));
+
+        $record = $clinical->upsert(
+            $organization,
+            $visit,
+            'infusion',
+            'infusion_monitoring',
+            $clinical->payloadFromRequest($validated),
+            $owner,
+            $owner,
+            InfusionWorkflowService::STAGE_MONITORING,
+            SpecialtyClinicalRecord::STATUS_COMPLETED,
+        );
+
+        try {
+            $stages->setStage(
+                $organization,
+                $visit,
+                'infusion',
+                InfusionWorkflowService::STAGE_MONITORING,
+                $owner,
+                $owner,
+            );
+        } catch (\InvalidArgumentException) {
+        }
+
+        if ($workflow->shouldCompleteVisit($record->payload ?? [])) {
+            try {
+                $stages->setStage(
+                    $organization,
+                    $visit,
+                    'infusion',
+                    InfusionWorkflowService::STAGE_COMPLETED,
+                    $owner,
+                    $owner,
+                );
+            } catch (\InvalidArgumentException) {
+            }
+
+            $visit->refresh();
+            if ($visit->status !== Visit::STATUS_COMPLETED) {
+                $visit->update([
+                    'status' => Visit::STATUS_COMPLETED,
+                    'completed_at' => $visit->completed_at ?? now(),
+                ]);
+            }
+
+            $appointment = $visit->appointment;
+            if ($appointment && $appointment->status !== \App\Models\Appointment::STATUS_COMPLETED) {
+                $appointment->update([
+                    'status' => \App\Models\Appointment::STATUS_COMPLETED,
+                    'completed_at' => $appointment->completed_at ?? now(),
+                ]);
+            }
+        }
+
+        return redirect()
+            ->route('care.specialty.workspace', ['module' => 'infusion', 'visit' => $visit, 'tab' => 'monitoring'])
+            ->with('success', 'Infusion monitoring saved.');
+    }
+
+    public function reports(
+        Request $request,
+        SpecialtyModuleService $modules,
+        SpecialtyShellService $shell,
+        InfusionAnalyticsService $analytics,
+    ): View {
+        $this->authorizeAbility($request, 'consultations.view');
+        $this->assertInfusionAccess($request, $modules);
+
+        $organization = $this->organization($request);
+        $branchScope = app(\App\Services\Care\OrganizationResolver::class)->branchScope($this->member($request));
+
+        $report = $analytics->report(
+            $organization,
+            $this->ownerRef($request),
+            $branchScope,
+            $request->query('from'),
+            $request->query('to'),
+        );
+
+        return view('care.specialty.infusion.reports', [
+            'moduleKey' => 'infusion',
+            'definition' => $modules->definition('infusion'),
+            'shellNav' => $shell->navItems('infusion'),
+            'report' => $report,
+            'currency' => strtoupper((string) config('care.billing.currency', config('care.currency', 'GHS'))),
+        ]);
+    }
+
+    public function printSummary(
+        Request $request,
+        Visit $visit,
+        SpecialtyModuleService $modules,
+        SpecialtyClinicalRecordService $clinical,
+    ): View {
+        $this->authorizeAbility($request, 'consultations.view');
+        $this->assertInfusionAccess($request, $modules);
+        $this->assertVisit($request, $visit);
+
+        $visit->loadMissing(['patient', 'appointment.practitioner', 'branch']);
+
+        return view('care.specialty.infusion.print', [
+            'visit' => $visit,
+            'patient' => $visit->patient,
+            'assessment' => $clinical->findForVisit($visit, 'infusion', 'infusion_assessment'),
+            'protocol' => $clinical->findForVisit($visit, 'infusion', 'infusion_protocol'),
+            'session' => $clinical->findForVisit($visit, 'infusion', 'infusion_session'),
+            'monitoring' => $clinical->findForVisit($visit, 'infusion', 'infusion_monitoring'),
+        ]);
+    }
+}

app/Http/Controllers/Care/PathologyWorkspaceController.php

@@ -0,0 +1,215 @@
+<?php
+
+namespace App\Http\Controllers\Care;
+
+use App\Http\Controllers\Care\Concerns\ScopesToAccount;
+use App\Http\Controllers\Controller;
+use App\Models\SpecialtyClinicalRecord;
+use App\Models\Visit;
+use App\Services\Care\Pathology\PathologyAnalyticsService;
+use App\Services\Care\Pathology\PathologyWorkflowService;
+use App\Services\Care\SpecialtyClinicalRecordService;
+use App\Services\Care\SpecialtyModuleService;
+use App\Services\Care\SpecialtyShellService;
+use App\Services\Care\SpecialtyVisitStageService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class PathologyWorkspaceController extends Controller
+{
+    use ScopesToAccount;
+
+    protected function assertPathologyAccess(Request $request, SpecialtyModuleService $modules): void
+    {
+        $organization = $this->organization($request);
+        abort_unless($modules->memberCanAccess($organization, $this->member($request), 'pathology'), 403);
+    }
+
+    protected function assertPathologyManage(Request $request, SpecialtyModuleService $modules): void
+    {
+        $organization = $this->organization($request);
+        abort_unless($modules->memberCanManage($organization, $this->member($request), 'pathology'), 403);
+    }
+
+    protected function assertVisit(Request $request, Visit $visit): void
+    {
+        abort_unless($visit->organization_id === $this->organization($request)->id, 404);
+        $this->authorizeBranch($request, (int) $visit->branch_id);
+    }
+
+    public function setStage(
+        Request $request,
+        Visit $visit,
+        SpecialtyModuleService $modules,
+        SpecialtyVisitStageService $stages,
+        SpecialtyShellService $shell,
+    ): RedirectResponse {
+        $this->authorizeAbility($request, 'consultations.manage');
+        $this->assertPathologyManage($request, $modules);
+        $this->assertVisit($request, $visit);
+
+        $validated = $request->validate([
+            'stage' => ['required', 'string', 'max:32'],
+        ]);
+
+        try {
+            $stages->setStage(
+                $this->organization($request),
+                $visit,
+                'pathology',
+                $validated['stage'],
+                $this->ownerRef($request),
+                $this->actorRef($request),
+            );
+        } catch (\InvalidArgumentException $e) {
+            return back()->with('error', $e->getMessage());
+        }
+
+        return redirect()
+            ->route('care.specialty.workspace', [
+                'module' => 'pathology',
+                'visit' => $visit,
+                'tab' => $shell->workspaceTabForStage('pathology', $validated['stage']),
+            ])
+            ->with('success', 'Visit stage updated.');
+    }
+
+    public function saveVerification(
+        Request $request,
+        Visit $visit,
+        SpecialtyModuleService $modules,
+        SpecialtyClinicalRecordService $clinical,
+        SpecialtyVisitStageService $stages,
+        PathologyWorkflowService $workflow,
+    ): RedirectResponse {
+        $this->authorizeAbility($request, 'consultations.manage');
+        $this->assertPathologyManage($request, $modules);
+        $this->assertVisit($request, $visit);
+
+        $organization = $this->organization($request);
+        $owner = $this->ownerRef($request);
+
+        $payload = (array) $request->input('payload', []);
+        foreach ($clinical->fieldsFor('pathology', 'path_verification') as $field) {
+            if (($field['type'] ?? '') === 'boolean') {
+                $payload[$field['name']] = $request->boolean('payload.'.$field['name']);
+            }
+        }
+        $request->merge(['payload' => $payload, 'tab' => 'verification']);
+
+        $validated = $request->validate(array_merge([
+            'tab' => ['required', 'string'],
+        ], $clinical->validationRules('pathology', 'path_verification')));
+
+        $record = $clinical->upsert(
+            $organization,
+            $visit,
+            'pathology',
+            'path_verification',
+            $clinical->payloadFromRequest($validated),
+            $owner,
+            $owner,
+            PathologyWorkflowService::STAGE_VERIFIED,
+            SpecialtyClinicalRecord::STATUS_COMPLETED,
+        );
+
+        try {
+            $stages->setStage(
+                $organization,
+                $visit,
+                'pathology',
+                PathologyWorkflowService::STAGE_VERIFIED,
+                $owner,
+                $owner,
+            );
+        } catch (\InvalidArgumentException) {
+        }
+
+        if ($workflow->shouldCompleteVisit($record->payload ?? [])) {
+            try {
+                $stages->setStage(
+                    $organization,
+                    $visit,
+                    'pathology',
+                    PathologyWorkflowService::STAGE_COMPLETED,
+                    $owner,
+                    $owner,
+                );
+            } catch (\InvalidArgumentException) {
+            }
+
+            $visit->refresh();
+            if ($visit->status !== Visit::STATUS_COMPLETED) {
+                $visit->update([
+                    'status' => Visit::STATUS_COMPLETED,
+                    'completed_at' => $visit->completed_at ?? now(),
+                ]);
+            }
+
+            $appointment = $visit->appointment;
+            if ($appointment && $appointment->status !== \App\Models\Appointment::STATUS_COMPLETED) {
+                $appointment->update([
+                    'status' => \App\Models\Appointment::STATUS_COMPLETED,
+                    'completed_at' => $appointment->completed_at ?? now(),
+                ]);
+            }
+        }
+
+        return redirect()
+            ->route('care.specialty.workspace', ['module' => 'pathology', 'visit' => $visit, 'tab' => 'verification'])
+            ->with('success', 'Pathology verification saved.');
+    }
+
+    public function reports(
+        Request $request,
+        SpecialtyModuleService $modules,
+        SpecialtyShellService $shell,
+        PathologyAnalyticsService $analytics,
+    ): View {
+        $this->authorizeAbility($request, 'consultations.view');
+        $this->assertPathologyAccess($request, $modules);
+
+        $organization = $this->organization($request);
+        $branchScope = app(\App\Services\Care\OrganizationResolver::class)->branchScope($this->member($request));
+
+        $report = $analytics->report(
+            $organization,
+            $this->ownerRef($request),
+            $branchScope,
+            $request->query('from'),
+            $request->query('to'),
+        );
+
+        return view('care.specialty.pathology.reports', [
+            'moduleKey' => 'pathology',
+            'definition' => $modules->definition('pathology'),
+            'shellNav' => $shell->navItems('pathology'),
+            'report' => $report,
+            'currency' => strtoupper((string) config('care.billing.currency', config('care.currency', 'GHS'))),
+        ]);
+    }
+
+    public function printSummary(
+        Request $request,
+        Visit $visit,
+        SpecialtyModuleService $modules,
+        SpecialtyClinicalRecordService $clinical,
+    ): View {
+        $this->authorizeAbility($request, 'consultations.view');
+        $this->assertPathologyAccess($request, $modules);
+        $this->assertVisit($request, $visit);
+
+        $visit->loadMissing(['patient', 'appointment.practitioner', 'branch']);
+
+        return view('care.specialty.pathology.print', [
+            'visit' => $visit,
+            'patient' => $visit->patient,
+            'requestRecord' => $clinical->findForVisit($visit, 'pathology', 'path_request'),
+            'specimen' => $clinical->findForVisit($visit, 'pathology', 'path_specimen'),
+            'processing' => $clinical->findForVisit($visit, 'pathology', 'path_processing'),
+            'report' => $clinical->findForVisit($visit, 'pathology', 'path_report'),
+            'verification' => $clinical->findForVisit($visit, 'pathology', 'path_verification'),
+        ]);
+    }
+}

app/Http/Controllers/Care/SpecialtyModuleController.php

@@ -165,6 +165,9 @@ class SpecialtyModuleController extends Controller
                 'oncology' => 'history',
                 'renal' => 'history',
                 'surgery' => 'history',
+                'vaccination' => 'eligibility',
+                'pathology' => 'request',
+                'infusion' => 'assessment',
                 default => (collect(array_keys($shellTabs))
                     ->first(fn (string $tab) => $clinical->recordTypeForTab($module, $tab) !== null)
                     ?? 'clinical_notes'),
@@ -248,6 +251,9 @@ class SpecialtyModuleController extends Controller
             'oncology' => 'history',
             'renal' => 'history',
             'surgery' => 'history',
+            'vaccination' => 'eligibility',
+            'pathology' => 'request',
+            'infusion' => 'assessment',
             default => (collect(array_keys($shellTabs))
                 ->first(fn (string $tab) => $clinical->recordTypeForTab($module, $tab) !== null)
                 ?? 'clinical_notes'),
@@ -915,6 +921,104 @@ class SpecialtyModuleController extends Controller
             }
         }
 
+        if ($module === 'vaccination' && in_array($recordType, ['vax_eligibility', 'vax_consent', 'vax_admin'], true)) {
+            $workflow = app(\App\Services\Care\Vaccination\VaccinationWorkflowService::class);
+            $stageService = app(\App\Services\Care\SpecialtyVisitStageService::class);
+            $suggested = match ($recordType) {
+                'vax_eligibility' => $workflow->stageFromEligibility($record->payload ?? []),
+                'vax_consent' => $workflow->stageFromConsent($record->payload ?? []),
+                'vax_admin' => $workflow->stageFromAdmin($record->payload ?? []),
+                default => null,
+            };
+            $current = $visit->specialty_stage;
+            $early = ['check_in', 'waiting', null, ''];
+            $order = [
+                'check_in' => 0,
+                'eligibility' => 1,
+                'consent' => 2,
+                'administer' => 3,
+                'observation' => 4,
+                'completed' => 5,
+            ];
+            if ($suggested && (! $current || in_array($current, $early, true))) {
+                try {
+                    $stageService->setStage($organization, $visit, 'vaccination', $suggested, $this->ownerRef($request), $this->ownerRef($request));
+                } catch (\InvalidArgumentException) {
+                }
+            } elseif ($suggested && $suggested !== $current && ($order[$suggested] ?? 0) > ($order[$current] ?? 0)) {
+                try {
+                    $stageService->setStage($organization, $visit, 'vaccination', $suggested, $this->ownerRef($request), $this->ownerRef($request));
+                } catch (\InvalidArgumentException) {
+                }
+            }
+        }
+
+        if ($module === 'pathology' && in_array($recordType, ['path_request', 'path_specimen', 'path_processing', 'path_report'], true)) {
+            $workflow = app(\App\Services\Care\Pathology\PathologyWorkflowService::class);
+            $stageService = app(\App\Services\Care\SpecialtyVisitStageService::class);
+            $suggested = match ($recordType) {
+                'path_request' => $workflow->stageFromRequest($record->payload ?? []),
+                'path_specimen' => $workflow->stageFromSpecimen($record->payload ?? []),
+                'path_processing' => $workflow->stageFromProcessing($record->payload ?? []),
+                'path_report' => $workflow->stageFromReport($record->payload ?? []),
+                default => null,
+            };
+            $current = $visit->specialty_stage;
+            $early = ['check_in', 'waiting', null, ''];
+            $order = [
+                'check_in' => 0,
+                'request' => 1,
+                'specimen' => 2,
+                'processing' => 3,
+                'report' => 4,
+                'verified' => 5,
+                'completed' => 6,
+            ];
+            if ($suggested && (! $current || in_array($current, $early, true))) {
+                try {
+                    $stageService->setStage($organization, $visit, 'pathology', $suggested, $this->ownerRef($request), $this->ownerRef($request));
+                } catch (\InvalidArgumentException) {
+                }
+            } elseif ($suggested && $suggested !== $current && ($order[$suggested] ?? 0) > ($order[$current] ?? 0)) {
+                try {
+                    $stageService->setStage($organization, $visit, 'pathology', $suggested, $this->ownerRef($request), $this->ownerRef($request));
+                } catch (\InvalidArgumentException) {
+                }
+            }
+        }
+
+        if ($module === 'infusion' && in_array($recordType, ['infusion_assessment', 'infusion_protocol', 'infusion_session'], true)) {
+            $workflow = app(\App\Services\Care\Infusion\InfusionWorkflowService::class);
+            $stageService = app(\App\Services\Care\SpecialtyVisitStageService::class);
+            $suggested = match ($recordType) {
+                'infusion_assessment' => $workflow->stageFromAssessment($record->payload ?? []),
+                'infusion_protocol' => $workflow->stageFromProtocol($record->payload ?? []),
+                'infusion_session' => $workflow->stageFromSession($record->payload ?? []),
+                default => null,
+            };
+            $current = $visit->specialty_stage;
+            $early = ['check_in', 'waiting', null, ''];
+            $order = [
+                'check_in' => 0,
+                'assessment' => 1,
+                'protocol' => 2,
+                'session' => 3,
+                'monitoring' => 4,
+                'completed' => 5,
+            ];
+            if ($suggested && (! $current || in_array($current, $early, true))) {
+                try {
+                    $stageService->setStage($organization, $visit, 'infusion', $suggested, $this->ownerRef($request), $this->ownerRef($request));
+                } catch (\InvalidArgumentException) {
+                }
+            } elseif ($suggested && $suggested !== $current && ($order[$suggested] ?? 0) > ($order[$current] ?? 0)) {
+                try {
+                    $stageService->setStage($organization, $visit, 'infusion', $suggested, $this->ownerRef($request), $this->ownerRef($request));
+                } catch (\InvalidArgumentException) {
+                }
+            }
+        }
+
         return redirect()
             ->route('care.specialty.workspace', [
                 'module' => $module,
@@ -1392,6 +1496,25 @@ class SpecialtyModuleController extends Controller
         $surgeryPostop = null;
         $surgeryStageCodes = [];
         $surgeryStageFlow = [];
+        $vaccinationEligibility = null;
+        $vaccinationConsent = null;
+        $vaccinationAdmin = null;
+        $vaccinationObservation = null;
+        $vaccinationStageCodes = [];
+        $vaccinationStageFlow = [];
+        $pathologyRequest = null;
+        $pathologySpecimen = null;
+        $pathologyProcessing = null;
+        $pathologyReport = null;
+        $pathologyVerification = null;
+        $pathologyStageCodes = [];
+        $pathologyStageFlow = [];
+        $infusionAssessment = null;
+        $infusionProtocol = null;
+        $infusionSession = null;
+        $infusionMonitoring = null;
+        $infusionStageCodes = [];
+        $infusionStageFlow = [];
         $activeTab = (string) $request->query('tab', array_key_first($shell->workspaceTabs($module)) ?: 'overview');
         $clinical = app(SpecialtyClinicalRecordService::class);
 
@@ -1616,6 +1739,34 @@ class SpecialtyModuleController extends Controller
                 $surgeryStageFlow = app(\App\Services\Care\Surgery\SurgeryWorkflowService::class)->stageFlow();
             }
 
+            if ($module === 'vaccination') {
+                $vaccinationEligibility = $clinical->findForVisit($workspaceVisit, 'vaccination', 'vax_eligibility');
+                $vaccinationConsent = $clinical->findForVisit($workspaceVisit, 'vaccination', 'vax_consent');
+                $vaccinationAdmin = $clinical->findForVisit($workspaceVisit, 'vaccination', 'vax_admin');
+                $vaccinationObservation = $clinical->findForVisit($workspaceVisit, 'vaccination', 'vax_observation');
+                $vaccinationStageCodes = collect($shell->stages('vaccination'))->pluck('code')->all();
+                $vaccinationStageFlow = app(\App\Services\Care\Vaccination\VaccinationWorkflowService::class)->stageFlow();
+            }
+
+            if ($module === 'pathology') {
+                $pathologyRequest = $clinical->findForVisit($workspaceVisit, 'pathology', 'path_request');
+                $pathologySpecimen = $clinical->findForVisit($workspaceVisit, 'pathology', 'path_specimen');
+                $pathologyProcessing = $clinical->findForVisit($workspaceVisit, 'pathology', 'path_processing');
+                $pathologyReport = $clinical->findForVisit($workspaceVisit, 'pathology', 'path_report');
+                $pathologyVerification = $clinical->findForVisit($workspaceVisit, 'pathology', 'path_verification');
+                $pathologyStageCodes = collect($shell->stages('pathology'))->pluck('code')->all();
+                $pathologyStageFlow = app(\App\Services\Care\Pathology\PathologyWorkflowService::class)->stageFlow();
+            }
+
+            if ($module === 'infusion') {
+                $infusionAssessment = $clinical->findForVisit($workspaceVisit, 'infusion', 'infusion_assessment');
+                $infusionProtocol = $clinical->findForVisit($workspaceVisit, 'infusion', 'infusion_protocol');
+                $infusionSession = $clinical->findForVisit($workspaceVisit, 'infusion', 'infusion_session');
+                $infusionMonitoring = $clinical->findForVisit($workspaceVisit, 'infusion', 'infusion_monitoring');
+                $infusionStageCodes = collect($shell->stages('infusion'))->pluck('code')->all();
+                $infusionStageFlow = app(\App\Services\Care\Infusion\InfusionWorkflowService::class)->stageFlow();
+            }
+
             if ($patientHeader !== null) {
                 $patientHeader['clinical_alerts'] = $clinicalAlerts;
             }
@@ -1785,6 +1936,25 @@ class SpecialtyModuleController extends Controller
             'surgeryPostop' => $surgeryPostop,
             'surgeryStageCodes' => $surgeryStageCodes,
             'surgeryStageFlow' => $surgeryStageFlow,
+            'vaccinationEligibility' => $vaccinationEligibility,
+            'vaccinationConsent' => $vaccinationConsent,
+            'vaccinationAdmin' => $vaccinationAdmin,
+            'vaccinationObservation' => $vaccinationObservation,
+            'vaccinationStageCodes' => $vaccinationStageCodes,
+            'vaccinationStageFlow' => $vaccinationStageFlow,
+            'pathologyRequest' => $pathologyRequest,
+            'pathologySpecimen' => $pathologySpecimen,
+            'pathologyProcessing' => $pathologyProcessing,
+            'pathologyReport' => $pathologyReport,
+            'pathologyVerification' => $pathologyVerification,
+            'pathologyStageCodes' => $pathologyStageCodes,
+            'pathologyStageFlow' => $pathologyStageFlow,
+            'infusionAssessment' => $infusionAssessment,
+            'infusionProtocol' => $infusionProtocol,
+            'infusionSession' => $infusionSession,
+            'infusionMonitoring' => $infusionMonitoring,
+            'infusionStageCodes' => $infusionStageCodes,
+            'infusionStageFlow' => $infusionStageFlow,
             'queueStubs' => $modules->queueStubsFor($organization, $module),
             'branchId' => $branchId,
             'branchLabel' => $branchLabel,

app/Http/Controllers/Care/VaccinationWorkspaceController.php

@@ -0,0 +1,214 @@
+<?php
+
+namespace App\Http\Controllers\Care;
+
+use App\Http\Controllers\Care\Concerns\ScopesToAccount;
+use App\Http\Controllers\Controller;
+use App\Models\SpecialtyClinicalRecord;
+use App\Models\Visit;
+use App\Services\Care\SpecialtyClinicalRecordService;
+use App\Services\Care\SpecialtyModuleService;
+use App\Services\Care\SpecialtyShellService;
+use App\Services\Care\SpecialtyVisitStageService;
+use App\Services\Care\Vaccination\VaccinationAnalyticsService;
+use App\Services\Care\Vaccination\VaccinationWorkflowService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class VaccinationWorkspaceController extends Controller
+{
+    use ScopesToAccount;
+
+    protected function assertVaccinationAccess(Request $request, SpecialtyModuleService $modules): void
+    {
+        $organization = $this->organization($request);
+        abort_unless($modules->memberCanAccess($organization, $this->member($request), 'vaccination'), 403);
+    }
+
+    protected function assertVaccinationManage(Request $request, SpecialtyModuleService $modules): void
+    {
+        $organization = $this->organization($request);
+        abort_unless($modules->memberCanManage($organization, $this->member($request), 'vaccination'), 403);
+    }
+
+    protected function assertVisit(Request $request, Visit $visit): void
+    {
+        abort_unless($visit->organization_id === $this->organization($request)->id, 404);
+        $this->authorizeBranch($request, (int) $visit->branch_id);
+    }
+
+    public function setStage(
+        Request $request,
+        Visit $visit,
+        SpecialtyModuleService $modules,
+        SpecialtyVisitStageService $stages,
+        SpecialtyShellService $shell,
+    ): RedirectResponse {
+        $this->authorizeAbility($request, 'consultations.manage');
+        $this->assertVaccinationManage($request, $modules);
+        $this->assertVisit($request, $visit);
+
+        $validated = $request->validate([
+            'stage' => ['required', 'string', 'max:32'],
+        ]);
+
+        try {
+            $stages->setStage(
+                $this->organization($request),
+                $visit,
+                'vaccination',
+                $validated['stage'],
+                $this->ownerRef($request),
+                $this->actorRef($request),
+            );
+        } catch (\InvalidArgumentException $e) {
+            return back()->with('error', $e->getMessage());
+        }
+
+        return redirect()
+            ->route('care.specialty.workspace', [
+                'module' => 'vaccination',
+                'visit' => $visit,
+                'tab' => $shell->workspaceTabForStage('vaccination', $validated['stage']),
+            ])
+            ->with('success', 'Visit stage updated.');
+    }
+
+    public function saveObservation(
+        Request $request,
+        Visit $visit,
+        SpecialtyModuleService $modules,
+        SpecialtyClinicalRecordService $clinical,
+        SpecialtyVisitStageService $stages,
+        VaccinationWorkflowService $workflow,
+    ): RedirectResponse {
+        $this->authorizeAbility($request, 'consultations.manage');
+        $this->assertVaccinationManage($request, $modules);
+        $this->assertVisit($request, $visit);
+
+        $organization = $this->organization($request);
+        $owner = $this->ownerRef($request);
+
+        $payload = (array) $request->input('payload', []);
+        foreach ($clinical->fieldsFor('vaccination', 'vax_observation') as $field) {
+            if (($field['type'] ?? '') === 'boolean') {
+                $payload[$field['name']] = $request->boolean('payload.'.$field['name']);
+            }
+        }
+        $request->merge(['payload' => $payload, 'tab' => 'observation']);
+
+        $validated = $request->validate(array_merge([
+            'tab' => ['required', 'string'],
+        ], $clinical->validationRules('vaccination', 'vax_observation')));
+
+        $record = $clinical->upsert(
+            $organization,
+            $visit,
+            'vaccination',
+            'vax_observation',
+            $clinical->payloadFromRequest($validated),
+            $owner,
+            $owner,
+            VaccinationWorkflowService::STAGE_OBSERVATION,
+            SpecialtyClinicalRecord::STATUS_COMPLETED,
+        );
+
+        try {
+            $stages->setStage(
+                $organization,
+                $visit,
+                'vaccination',
+                VaccinationWorkflowService::STAGE_OBSERVATION,
+                $owner,
+                $owner,
+            );
+        } catch (\InvalidArgumentException) {
+        }
+
+        if ($workflow->shouldCompleteVisit($record->payload ?? [])) {
+            try {
+                $stages->setStage(
+                    $organization,
+                    $visit,
+                    'vaccination',
+                    VaccinationWorkflowService::STAGE_COMPLETED,
+                    $owner,
+                    $owner,
+                );
+            } catch (\InvalidArgumentException) {
+            }
+
+            $visit->refresh();
+            if ($visit->status !== Visit::STATUS_COMPLETED) {
+                $visit->update([
+                    'status' => Visit::STATUS_COMPLETED,
+                    'completed_at' => $visit->completed_at ?? now(),
+                ]);
+            }
+
+            $appointment = $visit->appointment;
+            if ($appointment && $appointment->status !== \App\Models\Appointment::STATUS_COMPLETED) {
+                $appointment->update([
+                    'status' => \App\Models\Appointment::STATUS_COMPLETED,
+                    'completed_at' => $appointment->completed_at ?? now(),
+                ]);
+            }
+        }
+
+        return redirect()
+            ->route('care.specialty.workspace', ['module' => 'vaccination', 'visit' => $visit, 'tab' => 'observation'])
+            ->with('success', 'Vaccination observation saved.');
+    }
+
+    public function reports(
+        Request $request,
+        SpecialtyModuleService $modules,
+        SpecialtyShellService $shell,
+        VaccinationAnalyticsService $analytics,
+    ): View {
+        $this->authorizeAbility($request, 'consultations.view');
+        $this->assertVaccinationAccess($request, $modules);
+
+        $organization = $this->organization($request);
+        $branchScope = app(\App\Services\Care\OrganizationResolver::class)->branchScope($this->member($request));
+
+        $report = $analytics->report(
+            $organization,
+            $this->ownerRef($request),
+            $branchScope,
+            $request->query('from'),
+            $request->query('to'),
+        );
+
+        return view('care.specialty.vaccination.reports', [
+            'moduleKey' => 'vaccination',
+            'definition' => $modules->definition('vaccination'),
+            'shellNav' => $shell->navItems('vaccination'),
+            'report' => $report,
+            'currency' => strtoupper((string) config('care.billing.currency', config('care.currency', 'GHS'))),
+        ]);
+    }
+
+    public function printSummary(
+        Request $request,
+        Visit $visit,
+        SpecialtyModuleService $modules,
+        SpecialtyClinicalRecordService $clinical,
+    ): View {
+        $this->authorizeAbility($request, 'consultations.view');
+        $this->assertVaccinationAccess($request, $modules);
+        $this->assertVisit($request, $visit);
+
+        $visit->loadMissing(['patient', 'appointment.practitioner', 'branch']);
+
+        return view('care.specialty.vaccination.print', [
+            'visit' => $visit,
+            'patient' => $visit->patient,
+            'eligibility' => $clinical->findForVisit($visit, 'vaccination', 'vax_eligibility'),
+            'consent' => $clinical->findForVisit($visit, 'vaccination', 'vax_consent'),
+            'admin' => $clinical->findForVisit($visit, 'vaccination', 'vax_admin'),
+            'observation' => $clinical->findForVisit($visit, 'vaccination', 'vax_observation'),
+        ]);
+    }
+}