$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'])) { return self::STAGE_EXAM; } return self::STAGE_HISTORY; } /** * @param array $payload */ public function stageFromInvestigation(array $payload): string { $findings = trim((string) ($payload['findings'] ?? '')); if ($findings !== '') { return self::STAGE_INVESTIGATION; } return self::STAGE_EXAM; } /** * @param array $payload */ public function stageFromPlan(array $payload): string { if (! empty($payload['procedure_planned'])) { return self::STAGE_PROCEDURE; } $plan = trim((string) ($payload['plan'] ?? '')); if ($plan !== '') { return self::STAGE_PLAN; } return self::STAGE_INVESTIGATION; } /** * @param array $payload */ public function stageFromProcedure(array $payload): string { if (! empty($payload['procedure']) || ! empty($payload['outcome'])) { return self::STAGE_PROCEDURE; } return self::STAGE_PLAN; } /** * @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 pre-op history'], self::STAGE_HISTORY => ['next' => self::STAGE_EXAM, 'label' => 'Move to exam'], self::STAGE_EXAM => ['next' => self::STAGE_INVESTIGATION, 'label' => 'Move to investigations'], self::STAGE_INVESTIGATION => ['next' => self::STAGE_PLAN, 'label' => 'Move to consent / plan'], self::STAGE_PLAN => ['next' => self::STAGE_PROCEDURE, 'label' => 'Move to procedure'], self::STAGE_PROCEDURE => ['next' => self::STAGE_POSTOP, 'label' => 'Move to post-op'], self::STAGE_POSTOP => ['next' => self::STAGE_COMPLETED, 'label' => 'Complete visit'], self::STAGE_COMPLETED => ['next' => self::STAGE_COMPLETED, 'label' => 'Completed'], ]; } }