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

806 lines
41 KiB
TypeScript

import { InventoryEventActions } from '@/components/inventory-event-actions';
import { Head, useForm } from '@inertiajs/react';
import {
FormErrors,
PageTitle,
Panel,
controlClass,
} from '@/components/procurement';
import { Button } from '@/components/ui/button';
type Metadata = {
code: string | null;
expires_on: string | null;
no_expiry: boolean;
quantity_milli: number;
};
type RecordEntry = {
id: number;
record_key: string;
version: number;
kind: string;
state: string;
reason: string;
created_at: string;
data: {
stock_item_id: number;
warehouse_id: number;
requires_expiry: boolean;
minimum_remaining_days: number;
quarantine_on_receipt?: boolean;
lots: Metadata[];
};
snapshot: {
contributors: number[];
actor: { name: string };
item: { code: string; name: string; unit: string };
warehouse: { name: string };
balance: { quantity: number; version: number };
previous_setup_id?: number | null;
impact?: { before_milli: number; after_milli: number } | null;
};
};
type Lot = {
id: number;
record_key: string;
version: number;
metadata_id: number;
data: Metadata;
quantity_milli: number;
usable_milli: number;
eligible: boolean;
state: string;
state_version: number;
contributors: number[];
last_usable_on: string | null;
release_mode?: string;
release_setup_id?: number | null;
};
type Props = {
ready: boolean;
actorId: number;
capabilities: Record<string, boolean>;
records: RecordEntry[];
contexts: Record<
string,
{
reconciled: boolean;
physical: { quantity: number };
usable_milli: number;
blocked_milli: number;
lots: Lot[];
}
>;
items: { id: number; code: string; name: string; unit: string }[];
warehouses: { id: number; code: string; name: string }[];
history: RecordEntry[];
};
const qty = (n: number) =>
(n / 1000).toLocaleString('pt-MZ', { maximumFractionDigits: 3 });
const states: Record<string, string> = {
held: 'Em quarentena',
released: 'Libertado',
expired: 'Validade insuficiente',
unidentified: 'Identificação incompleta',
active: 'Activo',
draft: 'Para conferência',
registered: 'Identificação registada',
};
function Prepare({ props, old }: { props: Props; old?: RecordEntry }) {
const revision =
old?.state === 'active' || !!old?.snapshot.previous_setup_id;
const form = useForm({
operation_key: crypto.randomUUID(),
record_key: old?.record_key,
version: old?.version ?? 0,
action: 'prepare',
reason: '',
data: {
stock_item_id: old ? String(old.data.stock_item_id) : '',
warehouse_id: old ? String(old.data.warehouse_id) : '',
requires_expiry: old?.data.requires_expiry ?? true,
quarantine_on_receipt: old?.data.quarantine_on_receipt ?? true,
minimum_remaining_days: String(
old?.data.minimum_remaining_days ?? 0,
),
lots: revision
? []
: (old?.data.lots.map((l) => ({
code: l.code ?? '',
expires_on: l.expires_on ?? '',
no_expiry: l.no_expiry,
quantity: String(l.quantity_milli / 1000),
})) ?? []),
},
});
return (
<form
className="space-y-4"
onSubmit={(e) => {
e.preventDefault();
form.post('/stock/lotes');
}}
>
<FormErrors errors={form.errors} />
<div className="grid gap-4 md:grid-cols-2">
<label className="grid gap-1 text-sm">
Artigo
<select
required
className={controlClass}
value={form.data.data.stock_item_id}
disabled={revision}
onChange={(e) =>
form.setData('data', {
...form.data.data,
stock_item_id: e.target.value,
})
}
>
<option value="">Seleccione</option>
{props.items.map((i) => (
<option key={i.id} value={i.id}>
{i.code} · {i.name} ({i.unit})
</option>
))}
</select>
</label>
<label className="grid gap-1 text-sm">
Armazém
<select
required
className={controlClass}
value={form.data.data.warehouse_id}
disabled={revision}
onChange={(e) =>
form.setData('data', {
...form.data.data,
warehouse_id: e.target.value,
})
}
>
<option value="">Seleccione</option>
{props.warehouses.map((w) => (
<option key={w.id} value={w.id}>
{w.code} · {w.name}
</option>
))}
</select>
</label>
<label className="grid gap-1 text-sm">
Dias mínimos de validade restante
<input
type="number"
required
min={0}
max={3650}
className={controlClass}
value={form.data.data.minimum_remaining_days}
onChange={(e) =>
form.setData('data', {
...form.data.data,
minimum_remaining_days: e.target.value,
})
}
/>
</label>
<label className="flex items-center gap-2 text-sm">
<input
type="checkbox"
checked={form.data.data.requires_expiry}
onChange={(e) =>
form.setData('data', {
...form.data.data,
requires_expiry: e.target.checked,
})
}
/>
Este artigo exige prazo de validade
</label>
<label className="flex items-center gap-2 text-sm">
<input
type="checkbox"
checked={form.data.data.quarantine_on_receipt}
onChange={(e) =>
form.setData('data', {
...form.data.data,
quarantine_on_receipt: e.target.checked,
})
}
/>
Exigir quarentena nas novas recepções
</label>
</div>
<p className="text-sm text-muted-foreground">
Dispensar quarentena exige aprovação independente desta
configuração. Aplica-se apenas a futuras recepções conformes,
identificadas e com validade suficiente. Reservas de qualidade,
transferências, saldo inicial e quantidades encontradas em
contagem continuam em quarentena.
</p>
{revision ? (
<p className="text-sm">
A revisão reutiliza a configuração activa e não cria saldo
nem altera movimentos. Validade exigida e dias mínimos
passam a determinar a disponibilidade actual; a regra de
quarentena aplica-se às novas recepções.
</p>
) : (
<>
<p className="text-sm text-muted-foreground">
O saldo actual é reutilizado. Sem repartição, será
criado um lote por identificar com a totalidade do
saldo. Um só lote dispensa repetir a quantidade; vários
lotes exigem repartição exacta.
</p>
{form.data.data.lots.map((lot, i) => (
<fieldset
key={i}
className="grid gap-3 rounded border p-3 md:grid-cols-4"
>
<legend>Lote {i + 1}</legend>
{(['code', 'expires_on', 'quantity'] as const).map(
(key) => (
<label
key={key}
className="grid gap-1 text-sm"
>
{
{
code: 'Código',
expires_on: 'Validade',
quantity: 'Quantidade',
}[key]
}
<input
className={controlClass}
type={
key === 'expires_on'
? 'date'
: 'text'
}
value={lot[key]}
onChange={(e) =>
form.setData('data', {
...form.data.data,
lots: form.data.data.lots.map(
(l, index) =>
index === i
? {
...l,
[key]: e
.target
.value,
}
: l,
),
})
}
/>
</label>
),
)}
<label className="flex items-center gap-2 text-sm">
<input
type="checkbox"
checked={lot.no_expiry}
onChange={(e) =>
form.setData('data', {
...form.data.data,
lots: form.data.data.lots.map(
(l, index) =>
index === i
? {
...l,
no_expiry:
e.target
.checked,
}
: l,
),
})
}
/>
Sem prazo
</label>
<Button
type="button"
variant="outline"
onClick={() =>
form.setData('data', {
...form.data.data,
lots: form.data.data.lots.filter(
(_, index) => index !== i,
),
})
}
>
Remover repartição
</Button>
</fieldset>
))}
<Button
type="button"
variant="outline"
onClick={() =>
form.setData('data', {
...form.data.data,
lots: [
...form.data.data.lots,
{
code: '',
expires_on: '',
no_expiry: false,
quantity: '',
},
],
})
}
>
Acrescentar lote ao saldo existente
</Button>
</>
)}
<label className="grid gap-1 text-sm">
Evidência da conferência
<textarea
required
minLength={10}
className={controlClass}
value={form.data.reason}
onChange={(e) => form.setData('reason', e.target.value)}
/>
</label>
<Button disabled={form.processing}>Guardar preparação</Button>
</form>
);
}
function Decision({
record,
lot,
action,
}: {
record: { record_key: string; version: number };
lot?: Lot & { warehouse_id: number };
action: 'activate' | 'hold' | 'release';
}) {
return (
<InventoryEventActions
route="/stock/lotes"
record={record}
choices={[
{
value: action,
label:
action === 'activate'
? 'Conferir e activar'
: action === 'hold'
? 'Colocar em quarentena'
: 'Conferir e libertar',
},
]}
data={
lot
? {
lot_id: lot.id,
warehouse_id: lot.warehouse_id,
state_version: lot.state_version,
}
: {}
}
/>
);
}
function Identify({ lot }: { lot: Lot }) {
const form = useForm({
operation_key: crypto.randomUUID(),
record_key: lot.record_key,
version: lot.version,
action: 'identify',
reason: '',
data: {
code: lot.data.code ?? '',
expires_on: lot.data.expires_on ?? '',
no_expiry: lot.data.no_expiry,
},
});
return (
<details className="mt-3">
<summary className="cursor-pointer text-sm">
Identificar ou corrigir dados do lote
</summary>
<form
className="mt-3 grid gap-3 md:grid-cols-2"
onSubmit={(e) => {
e.preventDefault();
form.post('/stock/lotes');
}}
>
<p className="text-sm text-muted-foreground md:col-span-2">
A correcção preserva o histórico e exige nova libertação
independente em todos os locais.
</p>
<FormErrors errors={form.errors} />
<label className="grid gap-1 text-sm">
Código do lote
<input
className={controlClass}
value={form.data.data.code}
onChange={(e) =>
form.setData('data', {
...form.data.data,
code: e.target.value,
})
}
/>
</label>
<label className="grid gap-1 text-sm">
Validade
<input
type="date"
className={controlClass}
value={form.data.data.expires_on}
onChange={(e) =>
form.setData('data', {
...form.data.data,
expires_on: e.target.value,
})
}
/>
</label>
<label className="flex items-center gap-2 text-sm">
<input
type="checkbox"
checked={form.data.data.no_expiry}
onChange={(e) =>
form.setData('data', {
...form.data.data,
no_expiry: e.target.checked,
})
}
/>
Confirmo que o artigo não tem prazo de validade
</label>
<label className="grid gap-1 text-sm">
Motivo / evidência
<input
required
minLength={10}
className={controlClass}
value={form.data.reason}
onChange={(e) => form.setData('reason', e.target.value)}
/>
</label>
<Button disabled={form.processing}>
Registar identificação
</Button>
</form>
</details>
);
}
export default function Lots(props: Props) {
return (
<>
<Head title="Lotes, validade e quarentena" />
<div className="mx-auto flex w-full max-w-6xl flex-col gap-6 p-5 lg:p-8">
<PageTitle
eyebrow="Armazém"
title="Lotes, validade e quarentena"
description="O saldo físico mantém a sua origem. A qualidade determina a quantidade utilizável."
/>
<Panel title="Antes de activar">
<p className="text-sm">
A activação é por artigo e armazém e exige conferência
por outra pessoa. O saldo inicial entra sempre em
quarentena. Novas recepções seguem a regra de quarentena
aprovada. As saídas escolhem automaticamente os lotes
libertados com validade mais próxima.
</p>
<p className="mt-2 text-sm text-muted-foreground">
Transferências exigem controlo activo nos dois armazéns.
A chegada coloca o lote inteiro no destino em
quarentena, incluindo quantidades desse lote já
existentes no local. Ajustes por lote reutilizam uma
contagem com conferência independente. Os parâmetros
podem ser revistos com impacto conferido. A previsão
exclui entradas futuras sem qualificação do lote.
</p>
</Panel>
{!props.ready ? (
<Panel title="Instalação pendente">
<p>
O controlo por lotes ainda não está instalado neste
ambiente.
</p>
</Panel>
) : (
<>
{props.capabilities.prepare && (
<Panel title="Preparar novo controlo">
<Prepare props={props} />
</Panel>
)}
{props.records.map((record) => {
const context = props.contexts[record.record_key];
return (
<Panel
key={record.id}
title={`${record.snapshot.item.code} · ${record.snapshot.item.name} · ${record.snapshot.warehouse.name}`}
description={
states[record.state] ?? record.state
}
>
<p className="mb-3 text-sm text-muted-foreground">
Validade{' '}
{record.data.requires_expiry
? 'obrigatória'
: 'ou confirmação explícita de artigo sem prazo'}{' '}
· Mínimo restante:{' '}
{record.data.minimum_remaining_days}{' '}
dias · Novas recepções:{' '}
{(record.data.quarantine_on_receipt ??
true)
? 'quarentena obrigatória'
: 'dispensa apenas quando conformes e completamente identificadas'}
.
</p>
{record.snapshot.impact &&
record.state === 'draft' && (
<p className="mb-3 text-sm font-medium">
Impacto conferido da revisão:
utilizável actual{' '}
{qty(
record.snapshot.impact
.before_milli,
)}{' '}
→{' '}
{qty(
record.snapshot.impact
.after_milli,
)}{' '}
{record.snapshot.item.unit}.
Mudanças no saldo ou qualidade
exigem actualizar esta
preparação.
</p>
)}
{record.state === 'draft' ? (
<>
<p className="text-sm">
Saldo conferido:{' '}
{qty(
record.snapshot.balance
.quantity,
)}{' '}
{record.snapshot.item.unit}.
{record.snapshot
.previous_setup_id
? 'A revisão não volta a repartir o saldo; activa apenas os parâmetros conferidos.'
: 'Todo o saldo ficará em quarentena após activação.'}
</p>
{record.data.lots.map((lot, i) => (
<p
key={i}
className="mt-2 text-sm"
>
{lot.code ??
'Por identificar'}{' '}
·{' '}
{lot.expires_on ??
(lot.no_expiry
? 'Sem prazo confirmado'
: 'Validade por confirmar')}{' '}
· {qty(lot.quantity_milli)}
</p>
))}
{props.capabilities.prepare && (
<details className="mt-3">
<summary>
Actualizar preparação
após nova conferência
</summary>
<Prepare
props={props}
old={record}
/>
</details>
)}
{props.capabilities.review &&
!record.snapshot.contributors.includes(
props.actorId,
) && (
<Decision
record={record}
action="activate"
/>
)}
</>
) : (
context && (
<>
<p className="text-sm">
Físico:{' '}
{qty(
context.physical
.quantity,
)}{' '}
· Utilizável:{' '}
{qty(context.usable_milli)}{' '}
· Indisponível:{' '}
{qty(context.blocked_milli)}{' '}
{record.snapshot.item.unit}
</p>
{!context.reconciled && (
<p
role="alert"
className="mt-2 text-destructive"
>
Repartição divergente.
Confira as origens antes
de operar.
</p>
)}
{props.capabilities.prepare &&
!props.records.some(
(r) =>
r.record_key ===
record.record_key &&
r.state === 'draft',
) && (
<details className="mt-4">
<summary className="cursor-pointer text-sm">
Rever parâmetros
por referência a
esta
configuração
</summary>
<Prepare
props={props}
old={record}
/>
</details>
)}
{context.lots.map((lot) => (
<article
key={lot.id}
className="mt-4 rounded-lg border p-4"
>
<p className="font-medium">
{lot.data.code ??
`Lote por identificar #${lot.id}`}{' '}
·{' '}
{states[lot.state]}
</p>
{lot.state ===
'released' &&
lot.release_mode ===
'receipt_policy' && (
<p className="text-sm text-muted-foreground">
Dispensa de
quarentena
pela
configuração
aprovada #
{
lot.release_setup_id
}
. Não
corresponde
a uma
conferência
manual deste
lote.
</p>
)}
<p className="text-sm text-muted-foreground">
{qty(
lot.quantity_milli,
)}{' '}
{
record.snapshot
.item.unit
}{' '}
· Validade:{' '}
{lot.data
.expires_on ??
(lot.data
.no_expiry
? 'Sem prazo confirmado'
: 'Por confirmar')}
{lot.last_usable_on &&
` · Último dia utilizável: ${lot.last_usable_on}`}
</p>
{props.capabilities
.prepare && (
<Identify
key={`identify-${lot.version}`}
lot={lot}
/>
)}
{context.reconciled &&
lot.quantity_milli >
0 && (
<>
{props
.capabilities
.release &&
lot.eligible &&
lot.state !==
'released' &&
!lot.contributors.includes(
props.actorId,
) && (
<Decision
key={`release-${lot.version}-${lot.state_version}`}
record={
lot
}
lot={{
...lot,
warehouse_id:
record
.data
.warehouse_id,
}}
action="release"
/>
)}
{props
.capabilities
.hold &&
lot.state ===
'released' && (
<Decision
key={`hold-${lot.version}-${lot.state_version}`}
record={
lot
}
lot={{
...lot,
warehouse_id:
record
.data
.warehouse_id,
}}
action="hold"
/>
)}
</>
)}
</article>
))}
</>
)
)}
</Panel>
);
})}
<Panel title="Histórico de conferências">
<details>
<summary className="cursor-pointer text-sm">
Consultar os últimos 200 registos
</summary>
<div className="mt-3 space-y-3">
{props.history.map((record) => (
<p key={record.id} className="text-sm">
#{record.id} ·{' '}
{states[record.state] ??
record.state}{' '}
· {record.snapshot.actor.name} ·{' '}
{record.created_at} ·{' '}
{record.reason}
</p>
))}
</div>
</details>
</Panel>
</>
)}
</div>
</>
);
}