Consolida recepcoes, stock, equipamentos e identidade SGC

This commit is contained in:
2026-10-28 13:54:53 +02:00
parent eb1c8b8074
commit 75ffdb395c
76 changed files with 6933 additions and 152 deletions
+312
View File
@@ -0,0 +1,312 @@
import { Head, Link, useForm } from '@inertiajs/react';
import { InventoryNotice, InventoryPagination } from '@/components/inventory';
import {
FormErrors,
PageTitle,
Panel,
controlClass,
} from '@/components/procurement';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { Label } from '@/components/ui/label';
import { date } from '@/types/procurement';
import { quantity } from '@/types/inventory';
import type {
Page,
StockItem,
StockMovement,
Warehouse,
} from '@/types/inventory';
type Props = {
items: StockItem[];
warehouses: Warehouse[];
balances: {
stock_item_id: number;
warehouse_id: number;
quantity_milli: number;
}[];
movements: Page<StockMovement>;
filters: { search?: string; warehouse_id?: number };
canManage: boolean;
};
export default function Stock({
items,
warehouses,
balances,
movements,
filters,
canManage,
}: Props) {
const search = useForm({
search: filters.search ?? '',
warehouse_id: filters.warehouse_id ? String(filters.warehouse_id) : '',
});
const item = useForm({ code: '', name: '', unit: '' });
const warehouse = useForm({ code: '', name: '' });
return (
<>
<Head title="Stock e movimentos" />
<div className="mx-auto flex w-full max-w-7xl flex-col gap-7 p-5 lg:p-8">
<PageTitle
eyebrow="Armazém"
title="Existências e movimentos"
description="Saldo por artigo e armazém, calculado a partir de entradas, saídas, transferências e ajustes confirmados. O histórico permanece preservado."
/>
<InventoryNotice />
<Link
href="/stock/operacoes"
className="font-semibold text-teal-700"
>
Saídas, transferências e inventários →
</Link>
<Panel title="Existências">
<form
className="mb-5 flex flex-wrap gap-3"
onSubmit={(e) => {
e.preventDefault();
search.get('/stock', { preserveState: true });
}}
>
<Input
className="max-w-sm"
aria-label="Pesquisar artigo"
placeholder="Código ou nome do artigo"
value={search.data.search}
onChange={(e) =>
search.setData('search', e.target.value)
}
/>
<select
className={`${controlClass} max-w-xs`}
aria-label="Filtrar armazém"
value={search.data.warehouse_id}
onChange={(e) =>
search.setData('warehouse_id', e.target.value)
}
>
<option value="">Todos os armazéns</option>
{warehouses.map((w) => (
<option key={w.id} value={w.id}>
{w.code} · {w.name}
</option>
))}
</select>
<Button variant="outline">Filtrar</Button>
</form>
<div className="overflow-x-auto">
<table className="w-full text-left text-sm">
<thead className="border-b text-muted-foreground">
<tr>
<th className="pr-4 pb-3">Artigo</th>
<th className="pr-4">Armazém</th>
<th>Quantidade em stock</th>
</tr>
</thead>
<tbody>
{balances.map((balance) => {
const article = items.find(
(i) => i.id === balance.stock_item_id,
);
return (
<tr
className="border-b last:border-0"
key={`${balance.stock_item_id}-${balance.warehouse_id}`}
>
<td className="py-4 pr-4">
<strong>{article?.code}</strong>{' '}
· {article?.name}
</td>
<td className="pr-4">
{
warehouses.find(
(w) =>
w.id ===
balance.warehouse_id,
)?.name
}
</td>
<td className="font-medium">
{quantity(
balance.quantity_milli,
)}{' '}
{article?.unit}
</td>
</tr>
);
})}
</tbody>
</table>
</div>
{balances.length === 0 && (
<p className="py-6 text-sm text-muted-foreground">
Não há entradas confirmadas para estes filtros.
Criar um artigo não cria stock.
</p>
)}
</Panel>
<Panel title="Histórico de entradas">
<div className="space-y-4">
{movements.data.map((m) => (
<div
key={m.id}
className="flex flex-wrap justify-between gap-3 rounded-lg border p-4 text-sm"
>
<div>
<strong>
{m.quantity_milli > 0 ? '+' : ''}
{quantity(m.quantity_milli)}{' '}
{m.snapshot.stock_item.unit} ·{' '}
{m.snapshot.stock_item.code}
</strong>
<p className="mt-1 text-muted-foreground">
{m.snapshot.stock_item.name} ·{' '}
{m.snapshot.warehouse.name}
{m.snapshot.equipment &&
` · Equipamento ${m.snapshot.equipment.code}`}
</p>
<p className="mt-1 text-xs">
{date(m.moved_at)} · Utilizador #
{m.moved_by} ·{' '}
{m.snapshot.reference ??
m.snapshot.order_number}{' '}
· {m.movement_type}
{m.snapshot.delivery_note &&
` · Guia ${m.snapshot.delivery_note}`}
</p>
</div>
<Link
href={
m.snapshot.receipt_id
? `/recepcoes/${m.snapshot.receipt_id}`
: '/stock/operacoes'
}
className="text-teal-700 dark:text-teal-400"
>
{m.snapshot.receipt_id
? 'Abrir recepção'
: 'Abrir operações'}
</Link>
</div>
))}
</div>
{movements.data.length === 0 && (
<p className="text-sm text-muted-foreground">
Ainda não há movimentos disponíveis.
</p>
)}
<InventoryPagination page={movements} />
<p className="mt-4 text-xs text-muted-foreground">
Movimentos confirmados preservados. As transferências
têm duas linhas ligadas à mesma operação.
</p>
</Panel>
<div className="grid gap-6 lg:grid-cols-2">
<Panel
title="Catálogo de artigos"
description="Identificação explícita dos artigos: descrições iguais não são agregadas automaticamente."
>
<div className="mb-5 space-y-2 text-sm">
{items.map((i) => (
<p key={i.id}>
<strong>{i.code}</strong> · {i.name} ·{' '}
{i.unit}
</p>
))}
</div>
{canManage && (
<form
className="space-y-4 border-t pt-4"
onSubmit={(e) => {
e.preventDefault();
item.post('/stock/artigos', {
preserveScroll: true,
onSuccess: () => item.reset(),
});
}}
>
<FormErrors errors={item.errors} />
{(['code', 'name', 'unit'] as const).map(
(key) => (
<div className="space-y-2" key={key}>
<Label htmlFor={`stock-${key}`}>
{key === 'code'
? 'Código'
: key === 'name'
? 'Designação'
: 'Unidade (igual à ordem)'}
</Label>
<Input
id={`stock-${key}`}
required
value={item.data[key]}
onChange={(e) =>
item.setData(
key,
e.target.value,
)
}
/>
</div>
),
)}
<Button disabled={item.processing}>
Criar artigo sem saldo inicial
</Button>
</form>
)}
</Panel>
<Panel title="Armazéns">
<div className="mb-5 space-y-2 text-sm">
{warehouses.map((w) => (
<p key={w.id}>
<strong>{w.code}</strong> · {w.name}
</p>
))}
</div>
{canManage && (
<form
className="space-y-4 border-t pt-4"
onSubmit={(e) => {
e.preventDefault();
warehouse.post('/stock/armazens', {
preserveScroll: true,
onSuccess: () => warehouse.reset(),
});
}}
>
<FormErrors errors={warehouse.errors} />
{(['code', 'name'] as const).map((key) => (
<div className="space-y-2" key={key}>
<Label htmlFor={`warehouse-${key}`}>
{key === 'code'
? 'Código'
: 'Nome do armazém'}
</Label>
<Input
id={`warehouse-${key}`}
required
value={warehouse.data[key]}
onChange={(e) =>
warehouse.setData(
key,
e.target.value,
)
}
/>
</div>
))}
<Button disabled={warehouse.processing}>
Criar armazém
</Button>
</form>
)}
</Panel>
</div>
</div>
</>
);
}
Stock.layout = {
breadcrumbs: [{ title: 'Stock e movimentos', href: '/stock' }],
};
+541
View File
@@ -0,0 +1,541 @@
import { Head, useForm } from '@inertiajs/react';
import { useState } from 'react';
import { InventoryNotice, InventoryPagination } from '@/components/inventory';
import {
PageTitle,
Panel,
FormErrors,
controlClass,
} from '@/components/procurement';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { quantity } from '@/types/inventory';
import type { StockItem, Warehouse, Page } from '@/types/inventory';
type Operation = {
id: number;
kind: string;
reference: string;
reason: string;
destination?: string;
quantity_milli: number;
theoretical_milli: number;
stock_item_id: number;
warehouse_id: number;
recorded_at: string;
snapshot: {
actor: { name: string };
responsible: { name: string };
stock_item: { name: string; unit: string };
warehouse: { name: string };
destination_warehouse?: { name: string } | null;
equipment?: { code: string; description: string } | null;
};
};
type Props = {
items: StockItem[];
warehouses: Warehouse[];
users: { id: number; name: string }[];
balances: {
stock_item_id: number;
warehouse_id: number;
quantity: number;
version: number;
}[];
operations: Page<Operation>;
counts: Operation[];
canOperate: boolean;
demo?: boolean;
equipment?: { id: number; code: string; description: string }[];
};
const kinds: Record<string, string> = {
issue: 'Saída',
transfer: 'Transferência',
count: 'Contagem física',
adjustment: 'Ajuste de inventário',
};
export default function Operations({
items,
warehouses,
users,
balances,
operations,
counts,
canOperate,
demo = false,
equipment = [],
}: Props) {
const [message, setMessage] = useState('');
const form = useForm({
kind: 'issue',
reference: '',
idempotency_key: crypto.randomUUID(),
stock_item_id: String(items[0]?.id ?? ''),
warehouse_id: String(warehouses[0]?.id ?? ''),
destination_warehouse_id: '',
responsible_id: '',
destination: '',
reason: '',
quantity: '',
count_id: '',
ledger_version: 0,
equipment_id: '',
});
const balance = balances.find(
(b) =>
String(b.stock_item_id) === form.data.stock_item_id &&
String(b.warehouse_id) === form.data.warehouse_id,
);
return (
<>
<Head title="Operações de stock" />
<div className="mx-auto flex w-full max-w-7xl flex-col gap-6 p-5 lg:p-8">
<PageTitle
eyebrow="Armazém"
title="Saídas, transferências e inventários"
description="Movimentos com fundamento, contagens físicas e histórico preservado."
/>
<InventoryNotice />
{canOperate && form.data.kind === 'issue' && (
<label className="grid gap-2 text-sm">
Equipamento de destino (obrigatório para peças
associadas)
<select
className={controlClass}
value={form.data.equipment_id}
onChange={(e) =>
form.setData('equipment_id', e.target.value)
}
>
<option value="">Sem equipamento</option>
{equipment.map((e) => (
<option key={e.id} value={e.id}>
{e.code} · {e.description}
</option>
))}
</select>
</label>
)}
{demo && (
<p className="rounded-lg border bg-teal-50 p-4 text-sm text-teal-900">
Demonstração pública com dados fictícios. O formulário
apenas simula a revisão.
</p>
)}
<Panel
title="Registar operação"
description="Só Recepção / Armazém executa movimentos. Administração, Procurement e Finanças consultam. Periodicidade, tolerâncias e investigação de divergências aguardam decisão da empresa."
>
{canOperate ? (
<form
className="grid gap-4 sm:grid-cols-2"
onSubmit={(e) => {
e.preventDefault();
if (demo) {
setMessage(
'Simulação revista. Nenhum movimento real foi criado.',
);
return;
}
form.transform((d) => ({
...d,
ledger_version: balance?.version ?? 0,
}));
form.post('/stock/operacoes', {
onSuccess: () => {
form.setData({
...form.data,
idempotency_key:
crypto.randomUUID(),
reference: '',
quantity: '',
reason: '',
});
},
});
}}
>
<label className="grid gap-2 text-sm">
Operação
<select
className={controlClass}
value={form.data.kind}
onChange={(e) =>
form.setData('kind', e.target.value)
}
>
{Object.entries(kinds).map(([k, v]) => (
<option key={k} value={k}>
{v}
</option>
))}
</select>
</label>
<label className="grid gap-2 text-sm">
Referência única do documento
<Input
required
value={form.data.reference}
onChange={(e) =>
form.setData(
'reference',
e.target.value,
)
}
/>
</label>
<label className="grid gap-2 text-sm">
Artigo
<select
className={controlClass}
value={form.data.stock_item_id}
onChange={(e) =>
form.setData(
'stock_item_id',
e.target.value,
)
}
>
{items.map((i) => (
<option key={i.id} value={i.id}>
{i.code} · {i.name} ({i.unit})
</option>
))}
</select>
</label>
<label className="grid gap-2 text-sm">
Armazém de origem / contagem
<select
className={controlClass}
value={form.data.warehouse_id}
onChange={(e) =>
form.setData(
'warehouse_id',
e.target.value,
)
}
>
{warehouses.map((w) => (
<option key={w.id} value={w.id}>
{w.code} · {w.name}
</option>
))}
</select>
</label>
<p className="text-sm font-semibold sm:col-span-2">
Stock teórico:{' '}
{quantity(balance?.quantity ?? 0)} · versão{' '}
{balance?.version ?? 0}. Confirme a contagem
física sobre este saldo; movimentos posteriores
exigem nova contagem.
</p>
{form.data.kind === 'transfer' && (
<label className="grid gap-2 text-sm">
Armazém de destino
<select
required
className={controlClass}
value={
form.data.destination_warehouse_id
}
onChange={(e) =>
form.setData(
'destination_warehouse_id',
e.target.value,
)
}
>
<option value="">Seleccionar</option>
{warehouses
.filter(
(w) =>
String(w.id) !==
form.data.warehouse_id,
)
.map((w) => (
<option key={w.id} value={w.id}>
{w.name}
</option>
))}
</select>
</label>
)}
{form.data.kind === 'issue' && (
<label className="grid gap-2 text-sm">
Destino (departamento, requisição ou
utilização)
<Input
required
value={form.data.destination}
onChange={(e) =>
form.setData(
'destination',
e.target.value,
)
}
/>
</label>
)}
{form.data.kind === 'adjustment' ? (
<label className="grid gap-2 text-sm">
Contagem a ajustar
<select
required
className={controlClass}
value={form.data.count_id}
onChange={(e) =>
form.setData(
'count_id',
e.target.value,
)
}
>
<option value="">
Seleccionar contagem
</option>
{counts
.filter(
(c) =>
String(c.warehouse_id) ===
form.data
.warehouse_id &&
String(c.stock_item_id) ===
form.data.stock_item_id,
)
.map((c) => (
<option key={c.id} value={c.id}>
{c.reference}: contado{' '}
{quantity(c.quantity_milli)}
, teórico{' '}
{quantity(
c.theoretical_milli,
)}
</option>
))}
</select>
</label>
) : (
<label className="grid gap-2 text-sm">
{form.data.kind === 'count'
? 'Quantidade física contada (inclui zero)'
: 'Quantidade'}
<Input
required
type="number"
min={
form.data.kind === 'count'
? 0
: 0.001
}
step="0.001"
value={form.data.quantity}
onChange={(e) =>
form.setData(
'quantity',
e.target.value,
)
}
/>
</label>
)}
<label className="grid gap-2 text-sm">
Responsável
<select
required
className={controlClass}
value={form.data.responsible_id}
onChange={(e) =>
form.setData(
'responsible_id',
e.target.value,
)
}
>
<option value="">Seleccionar</option>
{users.map((u) => (
<option key={u.id} value={u.id}>
{u.name}
</option>
))}
</select>
</label>
<label className="grid gap-2 text-sm sm:col-span-2">
Fundamento / explicação da divergência
<textarea
required
className={controlClass}
value={form.data.reason}
onChange={(e) =>
form.setData('reason', e.target.value)
}
/>
</label>
<div className="sm:col-span-2">
<FormErrors errors={form.errors} />
<Button disabled={form.processing}>
{demo
? 'Rever simulação'
: 'Confirmar operação'}
</Button>
<p role="status" className="mt-3 text-sm">
{message}
</p>
</div>
</form>
) : (
<p className="text-sm">
Consulta do histórico. O seu perfil não executa
operações de armazém.
</p>
)}
</Panel>
<Panel
title="Histórico auditado"
description="Contagens não alteram o saldo. Ajustes usam a diferença exacta de uma contagem válida; transferências registam saída e entrada na mesma transacção."
>
<div className="space-y-4">
{operations.data.map((o) => (
<article
key={o.id}
className="rounded-lg border p-4 text-sm"
>
<div className="flex flex-wrap justify-between gap-2">
<strong>
{o.reference} · {kinds[o.kind]}
</strong>
<time>
{new Date(o.recorded_at).toLocaleString(
'pt-MZ',
)}
</time>
</div>
<p className="mt-2">
{o.snapshot.stock_item.name} ·{' '}
{quantity(o.quantity_milli)}{' '}
{o.snapshot.stock_item.unit} ·{' '}
{o.snapshot.warehouse.name}
{o.snapshot.destination_warehouse &&
` → ${o.snapshot.destination_warehouse.name}`}
{o.destination && ` → ${o.destination}`}
</p>
{(o.kind === 'count' ||
o.kind === 'adjustment') && (
<p>
Teórico: {quantity(o.theoretical_milli)}{' '}
· Contado: {quantity(o.quantity_milli)}{' '}
· Divergência:{' '}
{quantity(
o.quantity_milli -
o.theoretical_milli,
)}
</p>
)}
<p className="mt-2">{o.reason}</p>
{o.snapshot.equipment && (
<p className="mt-2">
Equipamento no momento da saída:{' '}
{o.snapshot.equipment.code} ·{' '}
{o.snapshot.equipment.description}
</p>
)}
<p className="mt-2 text-muted-foreground">
Registado por {o.snapshot.actor.name} ·
Responsável: {o.snapshot.responsible.name}
</p>
</article>
))}
{operations.data.length === 0 && (
<p className="text-sm">Sem operações registadas.</p>
)}
</div>
<InventoryPagination page={operations} />
</Panel>
</div>
</>
);
}
export function OperationsDemo() {
const snapshot = {
actor: { name: 'Operador fictício de armazém' },
responsible: { name: 'Responsável fictício de produção' },
stock_item: { name: 'Papel A4 de exemplo', unit: 'resma' },
warehouse: { name: 'Central fictício' },
destination_warehouse: null,
};
const base = {
stock_item_id: 1,
warehouse_id: 1,
recorded_at: '2026-10-28T10:00:00+02:00',
snapshot,
theoretical_milli: 12000,
};
const data: Operation[] = [
{
...base,
id: 3,
kind: 'count',
reference: 'INV-DEMO-003',
quantity_milli: 11000,
reason: 'Contagem física fictícia: menos uma resma que o saldo teórico.',
},
{
...base,
id: 2,
kind: 'transfer',
reference: 'TRF-DEMO-002',
quantity_milli: 3000,
reason: 'Reposição do armazém secundário.',
snapshot: {
...snapshot,
destination_warehouse: { name: 'Secundário fictício' },
},
},
{
...base,
id: 1,
kind: 'issue',
reference: 'SAI-DEMO-001',
quantity_milli: 2000,
destination: 'Produção fictícia · REQ-DEMO-001',
reason: 'Consumo de material na produção.',
},
{
...base,
id: 4,
kind: 'adjustment',
reference: 'AJ-DEMO-004',
quantity_milli: 11000,
reason: 'Exemplo independente de ajuste de −1 resma: divergência física confirmada e fundamentada na contagem INV-DEMO-004.',
},
];
return (
<Operations
demo
canOperate
items={[
{
id: 1,
code: 'PAP-DEMO',
name: 'Papel A4 fictício',
unit: 'resma',
},
]}
warehouses={[
{ id: 1, code: 'CENTRAL', name: 'Central fictício' },
{ id: 2, code: 'SEC', name: 'Secundário fictício' },
]}
users={[{ id: 1, name: 'Responsável fictício' }]}
balances={[
{
stock_item_id: 1,
warehouse_id: 1,
quantity: 12000,
version: 3,
},
]}
counts={[data[0]]}
operations={{ data, prev_page_url: null, next_page_url: null }}
/>
);
}