feat(assessments): layered clinical assessment engine end-to-end

Add a template-driven assessment system with universal intake, clinical
pathways, disease instruments (stroke MVP + extended, diabetes, and ten
specialty packs), scoring, patient outcome trends, REST/API + FHIR
export, and Enterprise org-level assessment analytics. Seed packs and
design/licensing docs ship for deploy and pre-GA review.

app/Http/Controllers/Care/PatientController.php

@@ -6,6 +6,8 @@ use App\Http\Controllers\Controller;
 use App\Http\Controllers\Care\Concerns\ScopesToAccount;
 use App\Models\Branch;
 use App\Models\Patient;
+use App\Services\Care\CareFeatures;
+use App\Services\Care\CarePermissions;
 use App\Services\Care\OrganizationResolver;
 use App\Services\Care\PatientService;
 use Illuminate\Http\RedirectResponse;
@@ -91,13 +93,41 @@ class PatientController extends Controller
         $this->authorizePatient($request, $patient);
 
         $dashboard = $this->patients->dashboard($patient);
-        $canManage = app(\App\Services\Care\CarePermissions::class)
-            ->can($this->member($request), 'patients.manage');
+        $permissions = app(CarePermissions::class);
+        $member = $this->member($request);
+        $organization = $this->organization($request);
+        $canManage = $permissions->can($member, 'patients.manage');
         $credential = app(\App\Services\Messaging\MessagingCredentialsService::class)
-            ->forOrganization($this->organization($request));
+            ->forOrganization($organization);
         $suiteEmailReady = app(\App\Services\Billing\PlatformEmailClient::class)->isConfigured();
         $suiteSmsReady = app(\App\Services\Billing\PlatformSmsClient::class)->isConfigured();
 
+        $assessmentsEnabled = app(CareFeatures::class)->enabled($organization, CareFeatures::ASSESSMENTS_ENGINE);
+        $canViewAssessments = $assessmentsEnabled && $permissions->can($member, 'assessments.view');
+        $canCaptureAssessment = $assessmentsEnabled && (
+            $permissions->can($member, 'assessments.capture')
+            || $permissions->can($member, 'assessments.manage')
+        );
+        $recentAssessments = collect();
+        $latestUniversalIntake = null;
+        if ($canViewAssessments) {
+            $branchScope = app(OrganizationResolver::class)->branchScope($member);
+            $recentAssessments = $patient->assessments()
+                ->with('template')
+                ->when($branchScope, fn ($q) => $q->where('branch_id', $branchScope))
+                ->orderByDesc('created_at')
+                ->limit(10)
+                ->get();
+
+            $latestUniversalIntake = $patient->assessments()
+                ->with(['template', 'answers.question'])
+                ->when($branchScope, fn ($q) => $q->where('branch_id', $branchScope))
+                ->whereHas('template', fn ($q) => $q->where('code', 'universal_intake'))
+                ->whereIn('status', [\App\Models\Assessment::STATUS_DRAFT, \App\Models\Assessment::STATUS_COMPLETED])
+                ->orderByDesc('created_at')
+                ->first();
+        }
+
         return view('care.patients.show', array_merge($dashboard, [
             'canManage' => $canManage,
             'messagingSmsReady' => $suiteSmsReady || $credential->hasValidSms(),
@@ -109,6 +139,12 @@ class PatientController extends Controller
             'genders' => config('care.genders'),
             'allergySeverities' => config('care.allergy_severities'),
             'documentTypes' => config('care.document_types'),
+            'assessmentsEnabled' => $assessmentsEnabled,
+            'canViewAssessments' => $canViewAssessments,
+            'canCaptureAssessment' => $canCaptureAssessment,
+            'recentAssessments' => $recentAssessments,
+            'latestUniversalIntake' => $latestUniversalIntake,
+            'assessmentStatuses' => config('care.assessment_statuses'),
         ]));
     }