$payload */ public function stageFromHistory(array $payload): string { $history = trim((string) ($payload['history'] ?? '')); if ($history !== '') { return self::STAGE_HISTORY; } return self::STAGE_CHECK_IN; } /** * @param array $payload */ public function stageFromExam(array $payload): string { if (! empty($payload['chief_complaint']) || ! empty($payload['exam_findings']) || ! empty($payload['fluid_status'])) { return self::STAGE_EXAM; } return self::STAGE_HISTORY; } /** * @param array $payload */ public function stageFromDialysis(array $payload): string { if (! empty($payload['session_type']) || ! empty($payload['notes'])) { return self::STAGE_DIALYSIS; } return self::STAGE_EXAM; } /** * @param array $payload */ public function stageFromPlan(array $payload): string { $plan = trim((string) ($payload['plan'] ?? '')); if ($plan !== '') { return self::STAGE_PLAN; } return self::STAGE_DIALYSIS; } /** * @param array $payload */ public function shouldCompleteVisit(array $payload): bool { $outcome = strtolower((string) ($payload['outcome'] ?? '')); return str_contains($outcome, 'completed') || str_contains($outcome, 'discharged'); } /** * @return array */ public function stageFlow(): array { return [ self::STAGE_CHECK_IN => ['next' => self::STAGE_HISTORY, 'label' => 'Start history'], self::STAGE_HISTORY => ['next' => self::STAGE_EXAM, 'label' => 'Move to exam'], self::STAGE_EXAM => ['next' => self::STAGE_DIALYSIS, 'label' => 'Move to dialysis / labs'], self::STAGE_DIALYSIS => ['next' => self::STAGE_PLAN, 'label' => 'Move to care plan'], self::STAGE_PLAN => ['next' => self::STAGE_COMPLETED, 'label' => 'Complete visit'], self::STAGE_COMPLETED => ['next' => self::STAGE_COMPLETED, 'label' => 'Completed'], ]; } }