Files
compras/resources/js/pages/stock/replenishment.tsx
T
2026-11-03 11:51:44 +02:00

655 lines
28 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { Head, Link, useForm, router } from '@inertiajs/react';
import {
PageTitle,
Panel,
FormErrors,
controlClass,
} from '@/components/procurement';
import { Button } from '@/components/ui/button';
type RecordRow = {
canApprove?: boolean;
canSuspend?: boolean;
id: number;
record_key: string;
version: number;
state: string;
reason: string;
created_at: string;
data: {
policy_key?: string;
requester_id?: number;
cost_center_id?: number;
unit_price?: string;
tax_rate?: string;
needed_days?: number;
equipment_id?: number;
valid_until?: string;
message?: string;
purchases?: { id: number; number: string; quantity_milli: number }[];
};
snapshot: {
item: { id: number; code?: string; name?: string };
warehouse: { id: number; name?: string };
requester?: { name: string };
cost_center?: { code: string; name: string };
origins?: {
warehouse_request_id: number;
destination: string;
equipment: { code: string; description: string } | null;
remaining_milli: number;
}[];
};
};
type Page<T> = {
data: T[];
total: number;
from: number | null;
to: number | null;
prev_page_url: string | null;
next_page_url: string | null;
};
function Pagination<T>({
page,
label,
}: {
page: Page<T> | null;
label: string;
}) {
return page ? (
<nav aria-label={label} className="mt-4 flex flex-wrap gap-4 text-sm">
<span>
{page.from ?? 0}–{page.to ?? 0} de {page.total}
</span>
{page.prev_page_url && (
<Link preserveScroll href={page.prev_page_url}>
Anterior
</Link>
)}
{page.next_page_url && (
<Link preserveScroll href={page.next_page_url}>
Seguinte
</Link>
)}
</nav>
) : null;
}
type Props = {
focusRuleId?: number | null;
focusChanged?: boolean;
ready: boolean;
canPrepare: boolean;
canReview: boolean;
rules: Page<RecordRow> | null;
needs: Page<RecordRow> | null;
history: Page<RecordRow> | null;
filters: { need_state: string };
recoveryReady: boolean;
workItems: Page<{
id: number;
code: string;
name: string;
warehouse: string;
last_error: string | null;
due_at: string;
failures: number;
}> | null;
scanMinutes: number;
schedulerStatus: { finished_at: string; result: string } | null;
schedulerRecent: boolean;
work: {
total: number;
pending: number | null;
failed: number | null;
last_run_at: string | null;
} | null;
policies: RecordRow[];
requesters: { id: number; name: string; department_id: number }[];
centers: {
id: number;
code: string;
name: string;
department_id: number;
}[];
equipment: {
id: number;
code: string;
description: string;
department_id: number;
}[];
catalogueTypes: Record<number, string>;
};
const states: Record<string, string> = {
draft: 'Por activar',
approved: 'Activa',
suspended: 'Suspensa',
pending: 'Necessidade pendente',
created: 'Rascunho criado',
covered: 'Reposição em curso',
satisfied: 'Disponibilidade suficiente',
};
function RuleForm({ props, rule }: { props: Props; rule?: RecordRow }) {
const form = useForm({
operation_key: crypto.randomUUID(),
record_key: rule?.record_key ?? null,
version: rule?.version ?? 0,
action: 'save',
reason: '',
data: {
policy_key: rule?.data.policy_key ?? '',
requester_id: rule?.data.requester_id?.toString() ?? '',
cost_center_id: rule?.data.cost_center_id?.toString() ?? '',
unit_price: rule?.data.unit_price ?? '',
tax_rate: rule?.data.tax_rate ?? '',
needed_days: rule?.data.needed_days?.toString() ?? '',
equipment_id: rule?.data.equipment_id?.toString() ?? '',
valid_until: rule?.data.valid_until ?? '',
},
});
const requester = props.requesters.find(
(u) => u.id.toString() === form.data.data.requester_id,
);
const set = (key: keyof typeof form.data.data, value: string) =>
form.setData('data', {
...form.data.data,
[key]: value,
...(key === 'requester_id'
? { cost_center_id: '', equipment_id: '' }
: {}),
...(key === 'policy_key' ? { equipment_id: '' } : {}),
});
return (
<form
className="grid gap-3 md:grid-cols-2"
onSubmit={(e) => {
e.preventDefault();
form.post('/stock/reposicao', { preserveState: 'errors' });
}}
>
<FormErrors errors={form.errors} />
<label>
Política aprovada · artigo/armazém
<select
required
className={controlClass}
value={form.data.data.policy_key}
onChange={(e) => set('policy_key', e.target.value)}
>
<option value="">Seleccione</option>
{props.policies.map((p) => (
<option key={p.record_key} value={p.record_key}>
{p.snapshot.item.code} · {p.snapshot.item.name} ·{' '}
{p.snapshot.warehouse.name}
</option>
))}
</select>
</label>
<label>
Requisitante responsável
<select
required
className={controlClass}
value={form.data.data.requester_id}
onChange={(e) => set('requester_id', e.target.value)}
>
<option value="">Seleccione</option>
{props.requesters.map((u) => (
<option key={u.id} value={u.id}>
{u.name}
</option>
))}
</select>
</label>
<label>
Centro de custo
<select
required
className={controlClass}
value={form.data.data.cost_center_id}
onChange={(e) => set('cost_center_id', e.target.value)}
>
<option value="">Seleccione</option>
{props.centers
.filter(
(c) => c.department_id === requester?.department_id,
)
.map((c) => (
<option key={c.id} value={c.id}>
{c.code} · {c.name}
</option>
))}
</select>
</label>
{props.catalogueTypes[
props.policies.find(
(p) => p.record_key === form.data.data.policy_key,
)?.snapshot.item.id ?? 0
] === 'spare_part' && (
<label>
Equipamento de destino da peça
<select
required
className={controlClass}
value={form.data.data.equipment_id}
onChange={(e) => set('equipment_id', e.target.value)}
>
<option value="">
Seleccione um equipamento compatível
</option>
{props.equipment
.filter(
(e) =>
e.department_id ===
requester?.department_id,
)
.map((e) => (
<option key={e.id} value={e.id}>
{e.code} · {e.description}
</option>
))}
</select>
</label>
)}
<label>
Preço estimado (MZN), se não existir no acordo
<input
inputMode="decimal"
placeholder="Vazio: reutilizar acordo em MZN"
className={controlClass}
value={form.data.data.unit_price}
onChange={(e) => set('unit_price', e.target.value)}
/>
</label>
<label>
Imposto estimado (%), se diferente do parâmetro da empresa
<input
inputMode="decimal"
placeholder="Vazio: reutilizar parâmetro da empresa"
className={controlClass}
value={form.data.data.tax_rate}
onChange={(e) => set('tax_rate', e.target.value)}
/>
</label>
<label>
Prazo pretendido após geração (dias)
<input
required
type="number"
min="0"
max="366"
className={controlClass}
value={form.data.data.needed_days}
onChange={(e) => set('needed_days', e.target.value)}
/>
</label>
<label>
Validade desta parametrização e estimativa
<input
required
type="date"
className={controlClass}
value={form.data.data.valid_until}
onChange={(e) => set('valid_until', e.target.value)}
/>
</label>
<label>
Fundamento
<textarea
required
minLength={10}
className={controlClass}
value={form.data.reason}
onChange={(e) => form.setData('reason', e.target.value)}
/>
</label>
<p className="text-sm md:col-span-2">
Mínimo, alvo, máximo e embalagem são reutilizados da política
aprovada. A activação exige outro responsável. Alterar uma regra
exige nova activação e afecta apenas novas gerações; documentos
existentes conservam a sua origem.
</p>
<Button disabled={form.processing}>Guardar para activação</Button>
</form>
);
}
function Decision({
rule,
action,
}: {
rule: RecordRow;
action: 'approve' | 'suspend';
}) {
const form = useForm({
operation_key: crypto.randomUUID(),
record_key: rule.record_key,
version: rule.version,
action,
reason: '',
data: {},
});
return (
<form
className="mt-3 flex flex-wrap gap-3"
onSubmit={(e) => {
e.preventDefault();
form.post('/stock/reposicao', { preserveState: 'errors' });
}}
>
<FormErrors errors={form.errors} />
<input
aria-label="Fundamento da decisão"
required
minLength={10}
placeholder="Fundamento da decisão"
className={controlClass}
value={form.data.reason}
onChange={(e) => form.setData('reason', e.target.value)}
/>
<Button disabled={form.processing}>
{action === 'approve'
? 'Activar parametrização'
: 'Suspender parametrização'}
</Button>
</form>
);
}
export default function Replenishment(props: Props) {
return (
<>
<Head title="Reposição automática" />
<div className="space-y-6 p-6">
<PageTitle
eyebrow="Armazém e compras"
title="Reposição automática"
description="Reutilizar a política aprovada e preparar a compra quando houver falta ou atingir o mínimo. As aprovações de compra mantêm-se."
/>
<div className="flex gap-4">
<Link href="/stock/disponibilidade">Disponibilidade</Link>
<Link href="/stock/requisicoes">
Requisições ao armazém
</Link>
<Link href="/compras/fornecimento?view=calendar">
Políticas de reposição
</Link>
</div>
{!props.ready ? (
<Panel title="Instalação pendente">
<p>
Instale a reserva e reposição para activar estas
regras.
</p>
</Panel>
) : (
<>
{props.focusRuleId != null && (
<Link className="underline" href="/stock/reposicao">
Ver todas as parametrizações e necessidades
</Link>
)}
{props.focusChanged && (
<p className="rounded border p-3 text-sm">
A parametrização mudou desde o encaminhamento.
Confira a versão actual e o histórico antes de
intervir.
</p>
)}
{props.canPrepare && props.focusRuleId == null && (
<Panel title="Parametrizar artigo e armazém">
<RuleForm props={props} />
</Panel>
)}
<Panel title="Verificação e recuperação da reposição">
<p>
{props.recoveryReady
? 'Recuperação durável instalada. A verificação periódica depende do serviço de agendamento em execução.'
: 'Instalação da recuperação durável pendente.'}
</p>
{props.recoveryReady && (
<p>
Intervalo de verificação por artigo/armazém:{' '}
{props.scanMinutes} minutos. Serviço:{' '}
{props.schedulerStatus
? `${!props.schedulerRecent ? 'sem passagem recente confirmada; último registo' : props.schedulerStatus.result === 'passed' ? 'última passagem concluída' : 'recuperação pendente'} em ${props.schedulerStatus.finished_at}`
: 'sem confirmação recente nesta interface'}
.
</p>
)}
{props.work && (
<p>
Trabalhos acompanhados: {props.work.total} ·
Sinais pendentes: {props.work.pending ?? 0}{' '}
· A recuperar: {props.work.failed ?? 0} ·
Última verificação:{' '}
{props.work.last_run_at ??
'Ainda sem execução registada'}
</p>
)}
</Panel>
{props.workItems && props.workItems.total > 0 && (
<Panel title="Verificações pendentes e interrompidas">
{props.workItems.data.map((w) => (
<div
key={w.id}
className="mb-3 rounded border p-3"
>
<p>
{w.code} · {w.name} · {w.warehouse}
</p>
<p>
{w.last_error ??
'Alteração registada; avaliação pendente.'}{' '}
Próxima tentativa: {w.due_at}
</p>
{(props.canPrepare ||
props.canReview) && (
<Button
variant="outline"
onClick={() =>
router.post(
`/stock/reposicao/trabalhos/${w.id}/avaliar`,
{},
{
preserveState:
'errors',
},
)
}
>
Reavaliar agora
</Button>
)}
</div>
))}
<Pagination
page={props.workItems}
label="Páginas dos trabalhos pendentes"
/>
</Panel>
)}
<Panel title="Parametrizações">
{(props.rules?.data.length ?? 0) === 0 ? (
<p>
Sem parametrizações. Não são assumidos
requisitantes ou centros de custo.
</p>
) : (
props.rules?.data.map((r) => (
<div
id={`supply-rule-${r.id}`}
className="mb-4 rounded border p-4"
key={r.id}
>
<p className="font-medium">
{r.snapshot.item.code} ·{' '}
{r.snapshot.item.name} ·{' '}
{r.snapshot.warehouse.name}
</p>
<p>
{states[r.state]} · Versão{' '}
{r.version} ·{' '}
{r.snapshot.requester?.name} ·{' '}
{r.snapshot.cost_center?.code}
</p>
<p>
Preço estimado {r.data.unit_price}{' '}
MZN · Imposto {r.data.tax_rate}% ·
Validade {r.data.valid_until}
</p>
{r.canApprove && (
<Decision
key={`approve:${r.id}`}
rule={r}
action="approve"
/>
)}
{r.canSuspend && (
<Decision
key={`suspend:${r.id}`}
rule={r}
action="suspend"
/>
)}
{props.canPrepare && (
<details className="mt-3">
<summary>
Rever parametrização
</summary>
<RuleForm
key={r.id}
props={props}
rule={r}
/>
</details>
)}
</div>
))
)}
<Pagination
page={props.rules}
label="Páginas das parametrizações"
/>
</Panel>
<Panel title="Necessidades e compras associadas">
<label>
Estado
<select
className={controlClass}
value={props.filters.need_state}
onChange={(e) =>
router.get(
'/stock/reposicao',
{ need_state: e.target.value },
{ preserveScroll: true },
)
}
>
<option value="all">
Todos · pendências primeiro
</option>
{[
'pending',
'created',
'covered',
'satisfied',
].map((s) => (
<option key={s} value={s}>
{states[s]}
</option>
))}
</select>
</label>
{(props.needs?.data.length ?? 0) === 0 ? (
<p>
Sem necessidades registadas após alterações
de stock ou activação de regras.
</p>
) : (
props.needs?.data.map((n) => (
<div
key={n.id}
className="mb-4 rounded border p-4"
>
<p className="font-medium">
{n.snapshot.item.code} ·{' '}
{n.snapshot.item.name} ·
{n.snapshot.warehouse.name} ·{' '}
{states[n.state]}
</p>
<p>{n.data.message}</p>
{n.snapshot.origins?.map((o, i) => (
<p key={i}>
<Link
href={`/stock/requisicoes/${o.warehouse_request_id}`}
>
RA-{o.warehouse_request_id}
</Link>{' '}
· {o.destination}
{o.equipment
? ` · ${o.equipment.code} · ${o.equipment.description}`
: ''}{' '}
· Pendente{' '}
{o.remaining_milli / 1000}
</p>
))}
{n.data.purchases?.map((p) => (
<p key={p.id}>
<Link
href={`/requisicoes/${p.id}`}
>
{p.number}
</Link>{' '}
· Quantidade original{' '}
{p.quantity_milli / 1000}
</p>
))}
{(props.canPrepare ||
props.canReview) && (
<Button
variant="outline"
className="mt-3"
onClick={() =>
router.post(
`/stock/reposicao/${n.id}/avaliar`,
{},
{
preserveState:
'errors',
},
)
}
>
Reavaliar necessidade
</Button>
)}
</div>
))
)}
<Pagination
page={props.needs}
label="Páginas das necessidades"
/>
</Panel>
<Panel title="Histórico">
<details>
<summary>
Consultar versões e fundamentos
</summary>
{props.history?.data.map((h) => (
<p key={h.id} className="mt-2">
#{h.id} · {h.created_at} · Versão{' '}
{h.version} · {states[h.state]} ·{' '}
{h.reason}
</p>
))}
<Pagination
page={props.history}
label="Páginas do histórico"
/>
</details>
</Panel>
</>
)}
</div>
</>
);
}