<?php
declare(strict_types=1);
function practical_exam_marks(array $data,bool $publish): array {
 $out=[];foreach(['level_one'=>25,'level_two'=>25,'final_exam'=>50] as $field=>$max){$value=$data[$field]??null;if($value===null||$value===''){if($publish)throw new InvalidArgumentException('Enter all three examination marks before publishing.');$out[$field]=null;continue;}
  if((!is_string($value)&&!is_int($value)&&!is_float($value))||!preg_match('/^\d{1,3}(?:\.\d{1,2})?$/D',(string)$value)||(float)$value>$max)throw new InvalidArgumentException(str_replace('_',' ',$field).' must be from 0 to '.$max.' with at most two decimal places.');$out[$field]=(float)$value;
 }return $out;
}
function practical_exam_grade(array $row): array {
 foreach(['level_one','level_two','final_exam'] as $field)if(!isset($row[$field]))return ['total'=>null,'band'=>null];
 $total=round((float)$row['level_one']+(float)$row['level_two']+(float)$row['final_exam'],2);
 return ['total'=>$total,'band'=>$total<=50?'D':($total<=60?'B':($total<=70?'B+':($total<=80?'A':'A+')))];
}
function practical_exam_scope(array $user,string $alias='e'): array {
 if(in_array($user['role'],['staff','admin'],true))return ['1=1',[]];
 if($user['role']==='hod')return ['EXISTS(SELECT 1 FROM hod_assignments h WHERE h.user_id=? AND h.department_id='.$alias.'.department_id AND h.campus_id='.$alias.'.campus_id)',[$user['id']]];
 if($user['role']==='student')return ['EXISTS(SELECT 1 FROM practical_exam_results mine WHERE mine.exam_id='.$alias.'.id AND mine.student_user_id=? AND mine.published_at IS NOT NULL)',[$user['id']]];
 throw new InvalidArgumentException('Examinations are unavailable for this account.');
}
function practical_exam_get(array $user,int $id): array {
 [$where,$args]=practical_exam_scope($user);$q=db()->prepare('SELECT e.*,c.course_name,c.course_code,d.department_name,ca.campus_name FROM practical_exams e JOIN courses c ON c.id=e.course_id JOIN departments d ON d.id=e.department_id JOIN campuses ca ON ca.id=e.campus_id WHERE e.id=? AND '.$where);$q->execute(array_merge([$id],$args));$exam=$q->fetch();if(!$exam)reply(404,['message'=>'Examination not found in your access scope.']);return $exam;
}
function practical_exam_components(array $user): array {
 if($user['role']==='staff')return ['level_one','level_two','final_exam'];
 if($user['role']==='hod')return ['level_one','level_two'];
 return [];
}
function practical_exam_component_update(array $user,array $old,array $data): array {
 $component=(string)($data['component']??'');
 if(!in_array($component,practical_exam_components($user),true))throw new DomainException('You cannot enter marks for this examination stage. Final examination marks are staff-only.');
 $marks=practical_exam_marks([$component=>$data['mark']??null],false);
 $out=$old;$out[$component]=$marks[$component];return $out;
}
