<?php

declare(strict_types=1);

/**
 * Rockview official-request routing scope policy.
 *
 * IMPORTANT: Include/use this rule in the actual workflow backend wherever it:
 * - resolves next_routes;
 * - selects the assigned administrator;
 * - authorizes action_required / route actions;
 * - creates routing notifications.
 *
 * The origin campus is used ONLY for Registrar. DVC1, Accountant, CFO and CEO are
 * central institutional offices and must always resolve from Head Quarters.
 */
function rvuRequestNormalizeStage(string $stage): string
{
    $clean = strtolower(trim($stage));

    if ($clean === 'registrar' || str_contains($clean, 'registrar')) {
        return 'registrar';
    }
    if ($clean === 'dvc1' || str_contains($clean, 'deputy vice')) {
        return 'dvc1';
    }
    if ($clean === 'accountant' || str_contains($clean, 'accountant')) {
        return 'accountant';
    }
    if ($clean === 'cfo' || str_contains($clean, 'chief financial')) {
        return 'cfo';
    }
    if ($clean === 'ceo' || str_contains($clean, 'chief executive')) {
        return 'ceo';
    }

    return $clean;
}

function rvuRequestRoutingCampus(
    string $stage,
    string $originCampus,
    string $headquartersCampus = 'HQ CAMPUS'
): string {
    $normalized = rvuRequestNormalizeStage($stage);

    if ($normalized === 'registrar') {
        return trim($originCampus);
    }

    if (in_array($normalized, ['dvc1', 'accountant', 'cfo', 'ceo'], true)) {
        return trim($headquartersCampus);
    }

    throw new InvalidArgumentException('Unsupported official-request routing stage: ' . $stage);
}
