<?php
declare(strict_types=1);
const IT_MAX_FILE=5242880;
function it_manager(array $a): bool {return $a['role']==='manager';}
function it_staff(array $a): bool {return in_array($a['role'],['manager','technician'],true);}
function it_readable(array $a,array $t,bool $watching): bool {
 return it_manager($a)||(int)$t['reporter_id']===(int)$a['id']||(int)($t['assignee_id']??0)===(int)$a['id']||$watching;
}
function it_progress_allowed(array $a,array $t): bool {return it_manager($a)||(it_staff($a)&&(int)($t['assignee_id']??0)===(int)$a['id']);}
function it_watch_allowed(array $a,array $t): bool {return it_manager($a)||(int)($t['assigner_id']??0)===(int)$a['id'];}
function it_transition(string $from,string $to,bool $manager): bool {
 if($from==='closed')return $manager&&$to==='in_progress';
 return in_array($to,['in_progress','waiting','resolved','closed'],true);
}
function it_validate_progress(int $percent,string $status,string $resolution): ?string {
 if($percent<0||$percent>100||$percent%10!==0)return 'Select progress in steps of 10%.';
 if(in_array($status,['resolved','closed'],true)&&$percent!==100)return 'Resolved and closed tickets require 100% progress.';
 if($status==='closed'&&trim($resolution)==='')return 'Explain how the request was fulfilled before closing.';
 return null;
}
function it_acl(array $a,array &$args,string $alias='t'): string {
 if(it_manager($a))return 'TRUE';
 $args[]=$a['id'];$args[]=$a['id'];$args[]=$a['id'];
 return "($alias.reporter_id=? OR $alias.assignee_id=? OR EXISTS(SELECT 1 FROM it_watchers w WHERE w.ticket_id=$alias.id AND w.user_id=?))";
}
