Files
compras/resources/js/pages/people/reports.tsx
T
2026-11-02 08:08:05 +02:00

664 lines
33 KiB
TypeScript

import { Head, Link, useForm } from '@inertiajs/react';
import {
PageTitle,
Panel,
FormErrors,
controlClass,
} from '@/components/procurement';
import { Button } from '@/components/ui/button';
import { peopleStates } from '@/lib/people-hiring';
const labels: Record<string, string> = {
service: 'Serviços individuais',
staff: 'Recrutamento e selecção',
};
type Filters = {
deadline_window?: string;
view?: string;
kind?: string;
status?: string;
search?: string;
from?: string;
to?: string;
};
type Props = {
deadlineReport: null | {
as_of: string;
window: string;
total_items: number;
matching_processes: number;
processes_considered: number;
pagination: {
current_page: number;
last_page: number;
prev_page_url: string | null;
next_page_url: string | null;
};
tasks: number;
approvals: number;
alerts: number;
without_deadline: number;
overdue_items: number;
items: {
id: string;
reference: string;
title: string;
category: string;
label: string;
responsibility: string;
due_on: string | null;
days_overdue: number | null;
href: string;
}[];
};
selectionMetrics: Record<
string,
{
selection_state: string;
proposed_at: string | null;
decided_at: string | null;
pending: string;
contract_visibility: string;
contract_reference: string | null;
contract_prepared_at: string | null;
contract_starts_on: string | null;
}
>;
applicationMetrics: Record<
string,
{
registered: number;
evaluation_complete: number;
evaluation_pending: number;
evaluation_unstarted: number;
evaluation_in_progress: number;
basis: string;
portal_received: number | null;
portal_accepted: number | null;
portal_rejected: number | null;
portal_pending: number | null;
}
>;
filters: Filters;
kinds: string[];
generatedAt: string;
summary: { kind: string; status: string; total: number | string }[];
processes: {
data: {
id: number;
title: string;
kind: string;
status: string;
closes_on: string;
created_at: string;
}[];
total: number;
current_page: number;
last_page: number;
prev_page_url: string | null;
next_page_url: string | null;
};
};
export default function Reports(props: Props) {
const form = useForm({
deadline_window: props.filters.deadline_window ?? 'all',
view: props.filters.view ?? 'processes',
kind: props.filters.kind ?? '',
status: props.filters.status ?? '',
search: props.filters.search ?? '',
from: props.filters.from ?? '',
to: props.filters.to ?? '',
});
const query = new URLSearchParams(
Object.entries(props.filters).filter(([, value]) => !!value) as [
string,
string,
][],
).toString();
return (
<>
<Head title="Relatórios de pessoas e contratações" />
<style>
{
'@media print { .people-report-tools { display: none !important; } }'
}
</style>
<div className="space-y-6 p-6">
<PageTitle
eyebrow="Pessoas e contratações"
title="Relatórios"
description="Dados reutilizados dos processos que está autorizado a consultar, no contexto seleccionado."
/>
<div className="people-report-tools flex flex-wrap gap-3">
<Link
href={`/pessoas/relatorios?${new URLSearchParams({ ...props.filters, view: 'deadlines' }).toString()}`}
>
Prazos e responsabilidades
</Link>
<Link
href={`/pessoas/relatorios?${new URLSearchParams({ ...props.filters, view: 'selections' }).toString()}`}
>
Selecções e contratações
</Link>
<Link
href={`/pessoas/relatorios?${new URLSearchParams({ ...props.filters, view: 'processes' }).toString()}`}
>
Processos e estados
</Link>
<Link
href={`/pessoas/relatorios?${new URLSearchParams({ ...props.filters, view: 'applications' }).toString()}`}
>
Candidaturas e avaliações
</Link>
<Link href="/pessoas">Voltar aos processos</Link>
<Button variant="outline" onClick={() => window.print()}>
Imprimir esta página
</Button>
<a
className="rounded-md border px-4 py-2 text-sm"
href={`/pessoas/relatorios.csv?${query}`}
>
Exportar resultados em CSV
</a>
</div>
<div className="people-report-tools">
<Panel
title="Filtrar relatório"
description="O período refere-se à criação dos processos. A exportação usa os filtros aplicados."
>
<form
className="grid gap-4 md:grid-cols-3"
onSubmit={(event) => {
event.preventDefault();
form.get('/pessoas/relatorios');
}}
>
<label>
Relatório
<select
className={controlClass}
value={form.data.view}
onChange={(e) =>
form.setData('view', e.target.value)
}
>
<option value="processes">
Processos e estados
</option>
<option value="applications">
Candidaturas e avaliações
</option>
<option value="deadlines">
Prazos e responsabilidades
</option>
<option value="selections">
Selecções e contratações
</option>
</select>
</label>
{form.data.view === 'deadlines' && (
<label>
Prazo da intervenção
<select
className={controlClass}
value={form.data.deadline_window}
onChange={(e) =>
form.setData(
'deadline_window',
e.target.value,
)
}
>
<option value="all">Todos</option>
<option value="overdue">
Vencidos
</option>
<option value="today">Hoje</option>
<option value="future">Futuros</option>
<option value="undated">
Sem prazo definido
</option>
</select>
</label>
)}
<label>
Percurso
<select
className={controlClass}
value={form.data.kind}
onChange={(e) =>
form.setData('kind', e.target.value)
}
>
<option value="">
Todos os autorizados
</option>
{props.kinds.map((kind) => (
<option key={kind} value={kind}>
{labels[kind]}
</option>
))}
</select>
</label>
<label>
Estado
<select
className={controlClass}
value={form.data.status}
onChange={(e) =>
form.setData('status', e.target.value)
}
>
<option value="">Todos</option>
{Object.entries(peopleStates).map(
([key, label]) => (
<option key={key} value={key}>
{label}
</option>
),
)}
</select>
</label>
<label>
Título ou referência
<input
className={controlClass}
value={form.data.search}
onChange={(e) =>
form.setData('search', e.target.value)
}
/>
</label>
<label>
Criado desde
<input
type="date"
className={controlClass}
value={form.data.from}
onChange={(e) =>
form.setData('from', e.target.value)
}
/>
</label>
<label>
Criado até
<input
type="date"
className={controlClass}
value={form.data.to}
onChange={(e) =>
form.setData('to', e.target.value)
}
/>
</label>
<div className="flex items-end gap-3">
<Button disabled={form.processing}>
Aplicar filtros
</Button>
<Link href="/pessoas/relatorios">Limpar</Link>
</div>
<FormErrors errors={form.errors} />
</form>
</Panel>
</div>
{props.deadlineReport && (
<Panel
title="Prazos e responsabilidades"
description={`Consulta em ${props.deadlineReport.as_of}. Totais de todos os resultados filtrados; a impressão inclui esta página e o CSV inclui todos.`}
>
<p className="mb-4 text-sm">
{props.deadlineReport.total_items} ocorrências em{' '}
{props.deadlineReport.matching_processes} processos,
entre {props.deadlineReport.processes_considered}{' '}
processos autorizados considerados. Filtro de prazo:{' '}
{
(
{
all: 'todos',
overdue: 'vencidos',
today: 'hoje',
future: 'futuros',
undated: 'sem prazo definido',
} as Record<string, string>
)[props.deadlineReport.window]
}
.
</p>
<p className="mb-4 text-sm">
Tarefas: {props.deadlineReport.tasks} ·
Conferências/decisões:{' '}
{props.deadlineReport.approvals} · Alertas:{' '}
{props.deadlineReport.alerts} · Ocorrências com
atraso: {props.deadlineReport.overdue_items} · Sem
prazo definido:{' '}
{props.deadlineReport.without_deadline}.
</p>
<p className="mb-4 text-sm">
Um alerta do processo não atribui responsabilidade
pessoal. Sem prazo definido não equivale a tarefa em
dia. Esta consulta não representa toda a carga de
trabalho da equipa; o mesmo processo pode ter várias
ocorrências.
</p>
<div className="overflow-x-auto">
<table className="w-full text-left text-sm">
<thead>
<tr>
{[
'Processo',
'Categoria e intervenção',
'Responsabilidade',
'Prazo',
'Dias de atraso',
].map((heading) => (
<th
key={heading}
className="border-b p-3"
>
{heading}
</th>
))}
</tr>
</thead>
<tbody>
{props.deadlineReport.items.map((item) => (
<tr key={item.id}>
<td className="border-b p-3">
<Link href={item.href}>
{item.reference} ·{' '}
{item.title}
</Link>
</td>
<td className="border-b p-3">
{item.category} · {item.label}
</td>
<td className="border-b p-3">
{item.responsibility}
</td>
<td className="border-b p-3">
{item.due_on ??
'Sem prazo definido'}
</td>
<td className="border-b p-3">
{item.days_overdue ??
'Não determinável'}
</td>
</tr>
))}
</tbody>
</table>
</div>
{props.deadlineReport.items.length === 0 && (
<p className="mt-3">
Sem intervenções ou alertas visíveis neste
âmbito.
</p>
)}
<p className="mt-4 text-sm">
Página{' '}
{props.deadlineReport.pagination.current_page} de{' '}
{props.deadlineReport.pagination.last_page}.
</p>
<div className="people-report-tools mt-3 flex gap-4">
{props.deadlineReport.pagination.prev_page_url && (
<Link
href={
props.deadlineReport.pagination
.prev_page_url
}
>
Anterior
</Link>
)}
{props.deadlineReport.pagination.next_page_url && (
<Link
href={
props.deadlineReport.pagination
.next_page_url
}
>
Seguinte
</Link>
)}
</div>
</Panel>
)}
{props.filters.view === 'selections' && (
<Panel
title="Selecções e contratações"
description="Situação e pendências dos processos desta página, a partir dos registos existentes. O período filtra a criação dos processos."
>
<p className="mb-4 text-sm">
Aprovar uma selecção e preparar uma minuta são
etapas distintas. O início previsto na minuta não
comprova assinatura nem admissão efectiva. Dados da
minuta exigem acesso contratual próprio.
</p>
{props.processes.data.map((process) => {
const m = props.selectionMetrics[process.id];
if (!m) return null;
return (
<div
key={process.id}
className="mb-4 rounded-md border p-4"
>
<Link
className="font-medium"
href={`/pessoas/${process.id}`}
>
PES-{process.id} · {process.title}
</Link>
<dl className="mt-3 grid gap-3 text-sm md:grid-cols-2">
{Object.entries({
Selecção: m.selection_state,
'Proposta em': m.proposed_at,
'Decisão em': m.decided_at,
Pendência: m.pending,
'Acesso à minuta':
m.contract_visibility,
'Referência da minuta':
m.contract_reference,
'Preparada em':
m.contract_prepared_at,
'Início previsto':
m.contract_starts_on,
}).map(([label, value]) => (
<div key={label}>
<dt className="font-medium">
{label}
</dt>
<dd>
{value ?? 'Não registado'}
</dd>
</div>
))}
</dl>
</div>
);
})}
{props.processes.data.length === 0 && (
<p>Sem processos nos filtros seleccionados.</p>
)}
</Panel>
)}
{props.filters.view === 'applications' && (
<Panel
title="Candidaturas e avaliações"
description="Contagens dos processos desta página. O período filtra a criação dos processos. Registadas inclui entradas manuais e candidaturas do portal admitidas, sem duplicação."
>
<p className="mb-4 text-sm">
Avaliação completa exige o mínimo de pareceres
elegíveis. Após aprovação da selecção usa-se a
fotografia preservada. Admissão para análise não
significa contratação. Sem acesso à triagem não
equivale a zero.
</p>
{props.processes.data.map((process) => {
const m = props.applicationMetrics[process.id];
if (!m) return null;
const count = (n: number | null) =>
n === null ? 'Sem acesso' : n;
return (
<div
key={process.id}
className="mb-4 rounded-md border p-4"
>
<Link
className="font-medium"
href={`/pessoas/${process.id}`}
>
PES-{process.id} · {process.title}
</Link>
<p className="mt-2 text-sm">
Registadas para avaliação:{' '}
{m.registered} · Completas:{' '}
{m.evaluation_complete} · Por concluir:{' '}
{m.evaluation_pending} (sem avaliação:{' '}
{m.evaluation_unstarted}; em curso:{' '}
{m.evaluation_in_progress}).
</p>
<p className="mt-2 text-sm">
Portal — recebidas:{' '}
{count(m.portal_received)} · admitidas
para análise: {count(m.portal_accepted)}{' '}
· não admitidas:{' '}
{count(m.portal_rejected)} · triagem
pendente: {count(m.portal_pending)}.
</p>
<p className="mt-2 text-xs">
Base:{' '}
{m.basis === 'selection_snapshot'
? 'selecção preservada'
: 'elegibilidade actual das avaliações'}
.
</p>
</div>
);
})}
{props.processes.data.length === 0 && (
<p>Sem processos nos filtros seleccionados.</p>
)}
</Panel>
)}
{!props.deadlineReport && (
<>
<Panel
title="Resumo dos resultados"
description="Uma minuta preparada não comprova contrato assinado nem admissão concluída."
>
<p className="mb-3 text-sm">
{props.processes.total} processos · Consulta em{' '}
{new Date(props.generatedAt).toLocaleString(
'pt-PT',
)}
</p>
{props.summary.length === 0 ? (
<p>
Sem processos no âmbito e filtros
seleccionados.
</p>
) : (
<ul className="grid gap-2 md:grid-cols-2">
{props.summary.map((row) => (
<li
key={`${row.kind}:${row.status}`}
className="rounded-md border p-3"
>
{labels[row.kind]} ·{' '}
{peopleStates[row.status] ??
row.status}
: <strong>{row.total}</strong>
</li>
))}
</ul>
)}
</Panel>
<Panel
title="Processos"
description={`Página ${props.processes.current_page} de ${props.processes.last_page}. A impressão inclui esta página; o CSV inclui todos os resultados filtrados.`}
>
<p className="mb-3 text-sm">
Filtros aplicados:{' '}
{labels[props.filters.kind ?? ''] ??
'todos os percursos autorizados'}{' '}
·{' '}
{peopleStates[props.filters.status ?? ''] ??
'todos os estados'}{' '}
· {props.filters.from ?? 'sem início'} a{' '}
{props.filters.to ?? 'sem fim'}
{props.filters.search
? ` · Pesquisa: ${props.filters.search}`
: ''}
</p>
<div className="overflow-x-auto">
<table className="w-full text-left text-sm">
<thead>
<tr>
{[
'Referência e título',
'Percurso',
'Estado',
'Fecho de candidaturas',
].map((heading) => (
<th
key={heading}
className="border-b p-3"
>
{heading}
</th>
))}
</tr>
</thead>
<tbody>
{props.processes.data.map((row) => (
<tr key={row.id}>
<td className="border-b p-3">
<Link
href={`/pessoas/${row.id}`}
>
PES-{row.id} ·{' '}
{row.title}
</Link>
<p className="mt-1 text-xs">
O processo permite
imprimir o relatório
individual.
</p>
</td>
<td className="border-b p-3">
{labels[row.kind]}
</td>
<td className="border-b p-3">
{peopleStates[row.status] ??
row.status}
</td>
<td className="border-b p-3">
{row.closes_on}
</td>
</tr>
))}
</tbody>
</table>
</div>
<div className="people-report-tools mt-4 flex gap-4">
{props.processes.prev_page_url && (
<Link href={props.processes.prev_page_url}>
Anterior
</Link>
)}
{props.processes.next_page_url && (
<Link href={props.processes.next_page_url}>
Seguinte
</Link>
)}
</div>
</Panel>
</>
)}
</div>
</>
);
}