Compare commits

...
5 Commits
Author SHA1 Message Date
nala 70163c0184 commit2
tests / ci (push) Canceled after 0s
2026-10-28 14:35:06 +02:00
nala 332cb9f1b7 Implementa conferencia de facturas e consumo por empresa 2026-10-28 14:26:18 +02:00
nala f86ecef44d Valida concorrencia e aplica orcamento com recuperacao verificada 2026-10-28 14:13:00 +02:00
nala c05dc12aea Adiciona dotacoes e reservas orcamentais por empresa 2026-10-28 14:06:03 +02:00
nala 75ffdb395c Consolida recepcoes, stock, equipamentos e identidade SGC 2026-10-28 13:54:53 +02:00
117 changed files with 10447 additions and 145 deletions
+22 -4
View File
@@ -1,4 +1,4 @@
# ProcuraFlow
# Sistema de Gestão de Compras (SGC)
Sistema de gestão de compras em Laravel 13, React, TypeScript e Inertia. Esta entrega implementa a base de requisições e aprovações da especificação de procurement.
@@ -23,6 +23,24 @@ Crie um pedido, guarde o rascunho, confira os valores e submeta. Entre com as co
## Entrega actual
- Facturas por empresa/fornecedor/ordem, conferência exacta com recepções aceites,
facturação parcial, validação independente por Finanças e conversão de compromisso
em consumo. Migração 000010 aplicada após backup/restauro verificados; três
cenários concorrentes PostgreSQL aprovados. Sem facturas fictícias na base real.
Interface em `/facturas`; exemplo público em `/consulta/facturas`.
- Orçamentos por empresa, centro de custo e exercício, com montante e base
com/sem IVA explícitos, aprovação independente, reservas e compromissos auditados.
Migração 000009 aplicada após backup e restauro verificados; cinco cenários
concorrentes PostgreSQL aprovados. Sem dotações fictícias na base real.
Centros sem dotação mantêm o circuito de desenvolvimento sem controlo.
Reforços e pagamentos continuam pendentes; não constitui validação
operacional integral do orçamento. Interface em `/orcamentos`.
- Equipamentos e peças ligados aos artigos existentes, compatibilidades, criticidade configurada, mínimos explícitos e alertas, saídas rastreáveis e validação técnica. Finanças é obrigatória para equipamento em qualquer valor; a adjudicação/emissão de investimento continua bloqueada até definição do limite próprio. Migração 000008 aplicada no lote 9 após backup recuperável e verificação da preservação. Demonstração em `/consulta/equipamentos`.
- Página inicial em `/`, demonstração pública por módulo em `/consulta` e navegação autenticada agrupada por área e perfil.
- Recepções parciais/totais com qualidade, divergências, quantidades pendentes e segregação do emitente. Entradas de stock apenas para quantidades físicas aceites, sem duplicação; catálogo, armazéns, existências e histórico por empresa.
- Saídas com destino, responsável e fundamento; transferências atómicas; contagens físicas e ajustes justificados, com histórico e protecção contra saldos negativos e contagens desactualizadas. Migração 000007 aplicada na base actual, lote 8, após backup com recuperação ensaiada e confirmação da preservação dos registos; demonstração em `/consulta/operacoes-stock`.
- Empresas com filtragem de consultas por organização e testes de isolamento.
- Departamentos, centros de custo e criação administrativa de contas com perfis.
- Requisições com rascunho editável, linhas, categoria, quantidade, preço e IVA indicado por linha.
@@ -51,13 +69,13 @@ O IVA é informado pelo utilizador e calculado no servidor. A taxa inicial de 0%
## Próximas etapas
Recepção parcial e qualidade; equipamentos e peças com aprovação técnica e stock; dados bancários com dupla validação; orçamento, facturas e pagamentos; moedas e câmbio; subscrições, licenças e Docker. A política de periodicidade, validade e levantamento de conflitos e os procedimentos de revisão/cancelamento de adjudicações continuam por definir.
Revisão visual dos módulos entregues; reposição de stock; dados bancários com dupla validação; reforços orçamentais, correcções de facturas e pagamentos; moedas e câmbio; subscrições, licenças e Docker. Equipamentos, peças, validação técnica e alertas de mínimo já estão implementados; a adjudicação de equipamento aguarda a definição da regra de investimento. Periodicidade dos inventários, tolerâncias e investigação de divergências exigem decisão da empresa. A política de periodicidade, validade e levantamento de conflitos e os procedimentos de revisão/cancelamento de adjudicações continuam por definir.
O cadastro guarda referências e ficheiros anexos no disco privado `supplier_documents`, em `storage/app/supplier-documents`, fora da pasta pública e sem URLs públicas. As fichas abrem pelo directório **Fornecedores → Ver ficha → Abrir ficha, edição e documentos**. As versões antigas e documentos existentes são preservados na auditoria e no armazenamento; nesta entrega não há eliminação de documentos, antivírus, quotas acumuladas ou política de retenção. A validação do NUIT é de formato e unicidade, sem consulta a uma autoridade fiscal. Além das declarações por operação, existem declarações pessoais por fornecedor e processo; a periodicidade anual e a política de validade/levantamento ainda não foram definidas. As propostas e avaliações registadas não são editáveis nesta etapa. Os pesos 40/20/15/15/10 são provisórios e ficam guardados por proposta. A comparação liga à fase de adjudicação e emissão. A ordem exige novas aprovações do valor final e revalidação no servidor. As propostas usam MZN; a multimoeda fica para a fase correspondente.
Esta base não implementa ainda os onze controlos anti-fraude nem todos os requisitos não funcionais do documento. MFA obrigatório, gestão completa do ciclo de vida dos acessos, delegações, política de levantamento de conflitos, alteração de regras com dupla aprovação, retenção, cópias de segurança e restauro por empresa serão tratados nas etapas correspondentes. Não usar para compras reais antes da validação destas regras e controlos.
As declarações pessoais abrem no menu **Conflitos de interesses**. Só o autor pode corrigir os próprios fundamentos/datas, acrescentando histórico; Administração e Finanças podem consultar as declarações da empresa. Não existe caducidade automática nem retirada de conflitos. A revisão visual autenticada e a concorrência real continuam pendentes; consulte [o relatório de desenvolvimento](docs/desenvolvimento.md).
As declarações pessoais abrem no menu **Conflitos de interesses**. Só o autor pode corrigir os próprios fundamentos/datas, acrescentando histórico; Administração e Finanças podem consultar as declarações da empresa. Não existe caducidade automática nem retirada de conflitos. A revisão visual continua pendente. Estão documentados quatro cenários reais de concorrência de recepção e sete de stock aprovados em PostgreSQL isolado; isto não valida a concorrência de todos os módulos nem a carga. Consulte [o relatório de desenvolvimento](docs/desenvolvimento.md).
## Verificação
@@ -70,4 +88,4 @@ npm run types:check
npm run build
```
Os testes cobrem cálculos, entradas manipuladas, limites de aprovação, separação de funções, ordem das decisões, rejeição e acesso entre empresas. A concorrência real em PostgreSQL requer testes com várias ligações; SQLite em memória não demonstra o comportamento dos bloqueios em produção.
Os testes cobrem cálculos, entradas manipuladas, limites de aprovação, separação de funções, ordem das decisões, rejeição, recepção, stock, navegação e acesso entre empresas. SQLite em memória não demonstra os bloqueios PostgreSQL. Para os quatro cenários simultâneos de recepção, execute `php tests/Concurrency/run-receipts.php`: exige permissão de criar bases, cria uma base exclusiva `compras_receipts_test_*`, verifica o isolamento antes de migrar e elimina-a no final. Não altera o `.env` nem executa fixtures na base real. O orçamento ainda não é validado.
+71
View File
@@ -0,0 +1,71 @@
<?php
namespace App\Http\Controllers;
use App\Enums\PurchasingRole;
use App\Models\Budget;
use App\Models\BudgetConsumption;
use App\Models\BudgetEntry;
use App\Models\CostCenter;
use App\Services\ConflictGuard;
use App\Services\RequisitionWorkflow;
use Brick\Math\BigDecimal;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\Rule;
use Inertia\Inertia;
use Inertia\Response;
class BudgetController extends Controller
{
private function access(Request $request): void
{
abort_unless(in_array($request->user()->purchasing_role, [PurchasingRole::Admin, PurchasingRole::Finance]), 403);
}
public function index(Request $request): Response
{
$this->access($request);
return Inertia::render('budgets/index', ['centers' => CostCenter::query()->orderBy('code')->get(), 'budgets' => Budget::query()->latest('id')->get()->map(function (Budget $budget) {
$entries = BudgetEntry::query()->where('budget_id', $budget->id);
$reserved = (int) (clone $entries)->sum('reserved_minor');
$committed = (int) $entries->sum('committed_minor');
$consumed = (int) BudgetConsumption::query()->where('budget_id', $budget->id)->sum('amount_minor');
return [...$budget->toArray(), 'reserved_minor' => $reserved, 'committed_minor' => $committed, 'consumed_minor' => $consumed, 'available_minor' => $budget->amount_minor - $reserved - $committed - $consumed];
})]);
}
public function store(Request $request): RedirectResponse
{
$this->access($request);
$data = $request->validate(['cost_center_id' => ['required', 'integer', Rule::exists('cost_centers', 'id')->where('tenant_id', $request->user()->tenant_id)], 'year' => 'required|integer|min:2026|max:2100', 'includes_tax' => 'required|boolean', 'amount' => ['required', 'regex:/^\d{1,12}(\.\d{1,2})?$/'], 'reason' => 'required|string|max:4000']);
DB::transaction(function () use ($request, $data) {
app(ConflictGuard::class)->lockCompany($request->user());
abort_if(Budget::query()->where('cost_center_id', $data['cost_center_id'])->where('year', $data['year'])->exists(), 409, 'Já existe dotação para este centro e exercício.');
$budget = Budget::query()->create(['tenant_id' => $request->user()->tenant_id, 'created_by' => $request->user()->id, 'cost_center_id' => $data['cost_center_id'], 'year' => $data['year'], 'includes_tax' => $data['includes_tax'], 'amount_minor' => BigDecimal::of($data['amount'])->multipliedBy(100)->toInt(), 'reason' => $data['reason']]);
app(RequisitionWorkflow::class)->audit($request->user(), 'budget.created', null, null, $budget->toArray());
});
return back();
}
public function approve(Request $request, Budget $budget): RedirectResponse
{
$this->access($request);
DB::transaction(function () use ($request, $budget) {
app(ConflictGuard::class)->lockCompany($request->user());
$budget = Budget::query()->lockForUpdate()->findOrFail($budget->id);
abort_if($budget->created_by === $request->user()->id, 403);
if ($budget->approved_by) {
return;
}
$budget->update(['approved_by' => $request->user()->id, 'approved_at' => now()]);
app(RequisitionWorkflow::class)->audit($request->user(), 'budget.approved', null, null, $budget->toArray());
});
return back();
}
}
@@ -0,0 +1,121 @@
<?php
namespace App\Http\Controllers;
use App\Enums\PurchasingRole;
use App\Models\CriticalityLevel;
use App\Models\Department;
use App\Models\Equipment;
use App\Models\EquipmentSparePart;
use App\Models\SparePart;
use App\Models\StockItem;
use App\Models\StockMovement;
use App\Models\StockOperation;
use App\Services\ConflictGuard;
use App\Services\ReceiptWorkflow;
use App\Services\RequisitionWorkflow;
use Brick\Math\BigDecimal;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;
use Illuminate\Validation\Rule;
use Illuminate\Validation\ValidationException;
use Inertia\Inertia;
use Inertia\Response;
class EquipmentController extends Controller
{
public function index(Request $request): Response
{
abort_unless(in_array($request->user()->purchasing_role, [PurchasingRole::Admin, PurchasingRole::Warehouse, PurchasingRole::Procurement, PurchasingRole::Finance, PurchasingRole::DepartmentHead]), 403);
$assets = Equipment::query();
if ($request->user()->purchasing_role === PurchasingRole::DepartmentHead) {
$assets->where('department_id', $request->user()->department_id);
}
$equipment = $assets->orderBy('code')->get();
$links = EquipmentSparePart::query()->whereIn('equipment_id', $equipment->pluck('id'))->get();
$parts = SparePart::query();
if ($request->user()->purchasing_role === PurchasingRole::DepartmentHead) {
$parts->whereIn('id', $links->pluck('spare_part_id'));
}
$parts = $parts->get()->map(function (SparePart $part) {
$sum = StockMovement::query()->where('stock_item_id', $part->stock_item_id)->sum('quantity_milli');
$balance = BigDecimal::of((string) $sum)->toInt();
return [...$part->toArray(), 'balance_milli' => $balance, 'below_minimum' => $balance < $part->minimum_milli];
});
$items = StockItem::query();
$departments = Department::query();
if ($request->user()->purchasing_role === PurchasingRole::DepartmentHead) {
$items->whereIn('id', $parts->pluck('stock_item_id')->merge($equipment->pluck('stock_item_id')->filter()));
$departments->whereKey($request->user()->department_id);
}
return Inertia::render('equipment/index', [
'equipment' => $equipment, 'parts' => $parts, 'links' => $links, 'levels' => CriticalityLevel::query()->orderBy('code')->get(),
'items' => $items->orderBy('code')->get(['id', 'code', 'name', 'unit']),
'departments' => $departments->orderBy('name')->get(['id', 'name']),
'history' => StockOperation::query()->whereNotNull('equipment_id')->whereIn('equipment_id', $equipment->pluck('id'))->latest('id')->paginate(15),
'canManage' => in_array($request->user()->purchasing_role, [PurchasingRole::Admin, PurchasingRole::Warehouse, PurchasingRole::Procurement]),
'canConfigure' => $request->user()->purchasing_role === PurchasingRole::Admin,
]);
}
public function store(Request $request, string $kind): RedirectResponse
{
$user = $request->user();
abort_unless(in_array($kind, ['categorias', 'activos', 'pecas', 'associacoes']), 404);
abort_unless($kind === 'categorias' ? $user->purchasing_role === PurchasingRole::Admin : in_array($user->purchasing_role, [PurchasingRole::Admin, PurchasingRole::Warehouse, PurchasingRole::Procurement]), 403);
$tenant = $user->tenant_id;
$exists = fn (string $table) => Rule::exists($table, 'id')->where('tenant_id', $tenant);
$request->merge(['code' => Str::upper(Str::squish($request->string('code')->toString()))]);
$rules = match ($kind) {
'categorias' => ['code' => ['required', 'regex:/^[A-Z0-9][A-Z0-9._-]{0,29}$/', Rule::unique('criticality_levels')->where('tenant_id', $tenant)], 'name' => 'required|string|max:150', 'criteria' => 'required|string|max:4000', 'is_critical' => 'required|boolean'],
'activos' => ['id' => ['nullable', 'integer', $exists('equipment')], 'version' => 'nullable|required_with:id|integer|min:1', 'code' => ['required', 'regex:/^[A-Z0-9][A-Z0-9._-]{0,29}$/', Rule::unique('equipment')->where('tenant_id', $tenant)->ignore($request->input('id'))], 'description' => 'required|string|max:255', 'area' => 'required|string|max:200', 'serial_number' => 'nullable|string|max:100', 'status' => ['required', Rule::in(['active', 'stopped', 'retired'])], 'department_id' => ['required', 'integer', $exists('departments')], 'stock_item_id' => ['nullable', 'integer', $exists('stock_items')], 'criticality_level_id' => ['required', 'integer', $exists('criticality_levels')]],
'pecas' => ['id' => ['nullable', 'integer', $exists('spare_parts')], 'version' => 'nullable|required_with:id|integer|min:1', 'stock_item_id' => ['required', 'integer', $exists('stock_items'), Rule::unique('spare_parts')->ignore($request->input('id'))], 'criticality_level_id' => ['required', 'integer', $exists('criticality_levels')], 'minimum_quantity' => ['required', 'regex:/^\d{1,9}(\.\d{1,3})?$/']],
'associacoes' => ['equipment_id' => ['required', 'integer', $exists('equipment')], 'spare_part_id' => ['required', 'integer', $exists('spare_parts')]],
};
$data = $request->validate($rules);
DB::transaction(function () use ($data, $kind, $user) {
app(ConflictGuard::class)->lockCompany($user);
$model = match ($kind) {
'categorias' => new CriticalityLevel,'activos' => new Equipment,'pecas' => new SparePart,'associacoes' => new EquipmentSparePart
};
$id = $data['id'] ?? null;
$before = null;
$input = $data;
unset($input['id'],$input['version']);
if ($id) {
$model = $model->newQuery()->whereKey($id)->lockForUpdate()->firstOrFail();
if (! $model instanceof Equipment && ! $model instanceof SparePart) {
throw new \LogicException('Este cadastro é apenas de acréscimo.');
}
$before = $model->toArray();
if ((int) $data['version'] !== $model->version) {
throw ValidationException::withMessages(['version' => 'Ficha alterada. Actualize antes de guardar.']);
}if ($kind === 'pecas' && (int) $input['stock_item_id'] !== $model->stock_item_id) {
throw ValidationException::withMessages(['stock_item_id' => 'O artigo de uma peça não pode ser substituído; preserve a rastreabilidade.']);
}$input['version'] = $model->version + 1;
}
if ($kind === 'pecas') {
$input['minimum_milli'] = ReceiptWorkflow::milli($input['minimum_quantity']);
unset($input['minimum_quantity']);
}
if ($kind === 'associacoes' && EquipmentSparePart::query()->where('equipment_id', $input['equipment_id'])->where('spare_part_id', $input['spare_part_id'])->exists()) {
throw ValidationException::withMessages(['spare_part_id' => 'Esta associação já existe e permanece no histórico.']);
}
if (! $id) {
$input['tenant_id'] = $user->tenant_id;
$input['created_by'] = $user->id;
}
if (in_array($kind, ['categorias', 'associacoes'])) {
$input['created_at'] = now();
}
$model->fill($input)->save();
app(RequisitionWorkflow::class)->audit($user, 'equipment.'.$kind.($id ? '_updated' : '_created'), null, $before, $model->toArray());
});
return back();
}
}
@@ -0,0 +1,81 @@
<?php
namespace App\Http\Controllers;
use App\Enums\PurchasingRole;
use App\Http\Requests\ConfirmReceiptRequest;
use App\Models\GoodsReceipt;
use App\Models\PurchaseOrder;
use App\Models\Requisition;
use App\Models\StockItem;
use App\Models\StockMovement;
use App\Models\Warehouse;
use App\Services\ReceiptWorkflow;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Gate;
use Inertia\Inertia;
use Inertia\Response;
class GoodsReceiptController extends Controller
{
/** @return Builder<PurchaseOrder> */
private function visibleOrders(Request $request): Builder
{
Gate::authorize('viewAny', GoodsReceipt::class);
$orders = PurchaseOrder::query();
if ($request->user()->purchasing_role === PurchasingRole::DepartmentHead) {
$orders->whereIn('requisition_id', Requisition::query()->visibleTo($request->user())->select('id'));
}
return $orders;
}
public function index(Request $request, ReceiptWorkflow $workflow): Response
{
$orders = $this->visibleOrders($request);
return Inertia::render('receipts/index', [
'orders' => (clone $orders)->latest('id')->paginate(15)->through(fn (PurchaseOrder $order) => [
'id' => $order->id, 'number' => $order->number, 'supplier_name' => $order->snapshot['supplier']['name'], 'progress' => $workflow->progress($order),
]),
'receipts' => GoodsReceipt::query()->whereIn('purchase_order_id', (clone $orders)->select('id'))->latest('id')->paginate(15, ['*'], 'receipts_page'),
]);
}
public function order(Request $request, PurchaseOrder $order, ReceiptWorkflow $workflow): Response
{
Gate::authorize('viewOrder', [GoodsReceipt::class, $order]);
return Inertia::render('receipts/order', [
'order' => $order->only(['id', 'number', 'issued_by']), 'supplier_name' => $order->snapshot['supplier']['name'],
'progress' => $workflow->progress($order),
'receipts' => GoodsReceipt::query()->where('purchase_order_id', $order->id)->latest('id')->get(),
'warehouses' => Warehouse::query()->orderBy('code')->get(['id', 'code', 'name']),
'stockItems' => StockItem::query()->orderBy('code')->get(['id', 'code', 'name', 'unit']),
'canConfirm' => $request->user()->can('create', [GoodsReceipt::class, $order]),
]);
}
public function store(ConfirmReceiptRequest $request, PurchaseOrder $order, ReceiptWorkflow $workflow): JsonResponse|RedirectResponse
{
$receipt = $workflow->confirm($request->user(), $order, $request->validated());
if ($request->expectsJson()) {
return response()->json(['id' => $receipt->id, 'number' => $receipt->number, 'created' => $receipt->wasRecentlyCreated, 'status' => $receipt->status], $receipt->wasRecentlyCreated ? 201 : 200);
}
return to_route('receipts.show', $receipt);
}
public function show(GoodsReceipt $receipt): Response
{
Gate::authorize('view', $receipt);
return Inertia::render('receipts/show', [
'receipt' => $receipt->load('items'),
'movements' => StockMovement::query()->whereIn('goods_receipt_item_id', $receipt->items()->select('id'))->orderBy('id')->get(),
]);
}
}
@@ -0,0 +1,39 @@
<?php
namespace App\Http\Controllers;
use App\Enums\PurchasingRole;
use App\Models\Invoice;
use App\Models\PurchaseOrder;
use App\Services\InvoiceWorkflow;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Inertia\Inertia;
use Inertia\Response;
class InvoiceController extends Controller
{
public function index(Request $request): Response
{
abort_unless(in_array($request->user()->purchasing_role, [PurchasingRole::Admin, PurchasingRole::Finance]), 403);
return Inertia::render('invoices/index', ['invoices' => Invoice::query()->with('items')->latest('id')->paginate(15), 'orders' => PurchaseOrder::query()->with('items')->latest('id')->get()->map(fn ($order) => ['id' => $order->id, 'number' => $order->number, 'supplier' => $order->snapshot['supplier']['name'], 'items' => $order->items]), 'canManage' => $request->user()->purchasing_role === PurchasingRole::Finance]);
}
public function store(Request $request, PurchaseOrder $order, InvoiceWorkflow $workflow): RedirectResponse
{
abort_unless($request->user()->purchasing_role === PurchasingRole::Finance, 403);
$decimal = ['required', 'regex:/^\d{1,12}(\.\d{1,2})?$/'];
$data = $request->validate(['number' => 'required|string|max:100', 'issued_on' => 'required|date_format:Y-m-d', 'subtotal' => $decimal, 'tax' => $decimal, 'total' => $decimal, 'items' => 'required|array|min:1|max:50', 'items.*.purchase_order_item_id' => 'required|integer|distinct', 'items.*.quantity' => ['required', 'regex:/^\d{1,9}(\.\d{1,3})?$/'], 'items.*.unit' => 'required|string|max:30', 'items.*.unit_price' => $decimal, 'items.*.tax_rate' => ['required', 'regex:/^\d{1,3}(\.\d{1,2})?$/']]);
$workflow->register($request->user(), $order, $data);
return to_route('invoices.index');
}
public function validateInvoice(Request $request, Invoice $invoice, InvoiceWorkflow $workflow): RedirectResponse
{
$workflow->validate($request->user(), $invoice);
return back();
}
}
@@ -5,9 +5,15 @@ namespace App\Http\Controllers;
use App\Http\Requests\StoreRequisitionRequest;
use App\Models\AuditLog;
use App\Models\CostCenter;
use App\Models\Equipment;
use App\Models\EquipmentSparePart;
use App\Models\Requisition;
use App\Models\SparePart;
use App\Models\StockItem;
use App\Models\TechnicalReview;
use App\Models\Tenant;
use App\Services\ConflictGuard;
use App\Services\EquipmentWorkflow;
use App\Services\RequisitionWorkflow;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
@@ -39,6 +45,7 @@ class RequisitionController extends Controller
return Inertia::render('requisitions/form', [
'costCenters' => CostCenter::query()->where('department_id', $request->user()->department_id)->orderBy('code')->get(),
'requisition' => null,
...$this->equipmentOptions($request),
]);
}
@@ -60,6 +67,11 @@ class RequisitionController extends Controller
'canDecide' => $requisition->canDecide($request->user()),
'conflictBlocked' => app(ConflictGuard::class)->participationBlocked($request->user(), $requisition),
'audit' => AuditLog::query()->where('requisition_id', $requisition->id)->orderBy('id')->get(['id', 'action', 'user_id', 'created_at']),
'technical' => [
'canReview' => app(EquipmentWorkflow::class)->canReview($request->user(), $requisition),
'basis_hash' => app(EquipmentWorkflow::class)->basis($requisition),
'reviews' => TechnicalReview::query()->where('requisition_id', $requisition->id)->orderBy('id')->get(),
],
]);
}
@@ -70,9 +82,27 @@ class RequisitionController extends Controller
return Inertia::render('requisitions/form', [
'requisition' => $requisition->load('items'),
'costCenters' => CostCenter::query()->where('department_id', $request->user()->department_id)->orderBy('code')->get(),
...$this->equipmentOptions($request),
]);
}
/** @return array<string,mixed> */
private function equipmentOptions(Request $request): array
{
$equipment = Equipment::query()->where('department_id', $request->user()->department_id)->orderBy('code')->get(['id', 'code', 'description']);
$parts = SparePart::query()->whereIn('id', EquipmentSparePart::query()->whereIn('equipment_id', $equipment->pluck('id'))->select('spare_part_id'))->get(['id', 'stock_item_id']);
return ['equipment' => $equipment, 'spareParts' => $parts, 'stockItems' => StockItem::query()->whereIn('id', $parts->pluck('stock_item_id'))->get(['id', 'code', 'name', 'unit'])];
}
public function technical(Request $request, Requisition $requisition): RedirectResponse
{
$data = $request->validate(['basis_hash' => 'required|string|size:64', 'decision' => ['required', Rule::in(['approved', 'rejected'])], 'reason' => 'required|string|max:4000']);
app(EquipmentWorkflow::class)->review($request->user(), $requisition, $data['basis_hash'], $data['decision'], $data['reason']);
return back();
}
public function update(StoreRequisitionRequest $request, Requisition $requisition, RequisitionWorkflow $workflow): RedirectResponse
{
$workflow->save($request->user(), $request->validated(), $requisition);
+87
View File
@@ -0,0 +1,87 @@
<?php
namespace App\Http\Controllers;
use App\Enums\PurchasingRole;
use App\Models\StockItem;
use App\Models\StockMovement;
use App\Models\Warehouse;
use App\Services\RequisitionWorkflow;
use Brick\Math\BigDecimal;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;
use Illuminate\Validation\Rule;
use Inertia\Inertia;
use Inertia\Response;
class StockController extends Controller
{
private function access(Request $request, bool $manage = false): void
{
$roles = $manage ? [PurchasingRole::Admin, PurchasingRole::Warehouse] : [PurchasingRole::Admin, PurchasingRole::Warehouse, PurchasingRole::Procurement, PurchasingRole::Finance];
abort_unless(in_array($request->user()->purchasing_role, $roles), 403);
}
public function index(Request $request): Response
{
$this->access($request);
$filters = $request->validate([
'search' => 'nullable|string|max:100',
'warehouse_id' => ['nullable', 'integer', Rule::exists('warehouses', 'id')->where('tenant_id', $request->user()->tenant_id)],
]);
$items = StockItem::query()->orderBy('code')->get(['id', 'code', 'name', 'unit']);
$warehouses = Warehouse::query()->orderBy('code')->get(['id', 'code', 'name']);
$selected = StockItem::query();
if (! empty($filters['search'])) {
$selected->where(fn ($q) => $q->where('code', 'like', '%'.$filters['search'].'%')->orWhere('name', 'like', '%'.$filters['search'].'%'));
}
$movements = StockMovement::query()->whereIn('stock_item_id', $selected->select('id'));
if (! empty($filters['warehouse_id'])) {
$movements->where('warehouse_id', $filters['warehouse_id']);
}
$balances = (clone $movements)->selectRaw('stock_item_id, warehouse_id, SUM(quantity_milli) as quantity_milli')->groupBy('stock_item_id', 'warehouse_id')->get()->map(fn ($balance) => [
'stock_item_id' => $balance->stock_item_id, 'warehouse_id' => $balance->warehouse_id,
'quantity_milli' => BigDecimal::of($balance->quantity_milli)->toInt(),
]);
return Inertia::render('stock/index', [
'items' => $items, 'warehouses' => $warehouses, 'balances' => $balances,
'movements' => $movements->latest('id')->paginate(20)->withQueryString(), 'filters' => $filters,
'canManage' => in_array($request->user()->purchasing_role, [PurchasingRole::Admin, PurchasingRole::Warehouse]),
]);
}
public function item(Request $request, RequisitionWorkflow $audit): RedirectResponse
{
$this->access($request, true);
$request->merge(['code' => Str::upper(trim($request->string('code')->toString())), 'unit' => Str::lower(trim($request->string('unit')->toString()))]);
$data = $request->validate([
'code' => ['required', 'regex:/^[A-Z0-9][A-Z0-9._-]{0,29}$/', Rule::unique('stock_items')->where('tenant_id', $request->user()->tenant_id)],
'name' => 'required|string|max:200', 'unit' => 'required|string|max:30',
]);
DB::transaction(function () use ($request, $audit, $data) {
$item = StockItem::query()->create([...$data, 'tenant_id' => $request->user()->tenant_id, 'created_by' => $request->user()->id]);
$audit->audit($request->user(), 'stock.item_created', null, null, $item->toArray());
});
return back();
}
public function warehouse(Request $request, RequisitionWorkflow $audit): RedirectResponse
{
$this->access($request, true);
$request->merge(['code' => Str::upper(trim($request->string('code')->toString()))]);
$data = $request->validate([
'code' => ['required', 'regex:/^[A-Z0-9][A-Z0-9._-]{0,29}$/', Rule::unique('warehouses')->where('tenant_id', $request->user()->tenant_id)],
'name' => 'required|string|max:200',
]);
DB::transaction(function () use ($request, $audit, $data) {
$warehouse = Warehouse::query()->create([...$data, 'tenant_id' => $request->user()->tenant_id, 'created_by' => $request->user()->id]);
$audit->audit($request->user(), 'stock.warehouse_created', null, null, $warehouse->toArray());
});
return back();
}
}
@@ -0,0 +1,77 @@
<?php
namespace App\Http\Controllers;
use App\Enums\PurchasingRole;
use App\Models\Equipment;
use App\Models\StockItem;
use App\Models\StockOperation;
use App\Models\User;
use App\Models\Warehouse;
use App\Services\StockWorkflow;
use Brick\Math\BigDecimal;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Str;
use Illuminate\Validation\Rule;
use Inertia\Inertia;
use Inertia\Response;
class StockOperationController extends Controller
{
public function index(Request $request, StockWorkflow $workflow): Response
{
abort_unless(in_array($request->user()->purchasing_role, [PurchasingRole::Warehouse, PurchasingRole::Admin, PurchasingRole::Finance, PurchasingRole::Procurement]), 403);
$items = StockItem::query()->orderBy('code')->get(['id', 'code', 'name', 'unit']);
$warehouses = Warehouse::query()->orderBy('code')->get(['id', 'code', 'name']);
$balances = [];
foreach ($items as $item) {
foreach ($warehouses as $warehouse) {
$balances[] = ['stock_item_id' => $item->id, 'warehouse_id' => $warehouse->id, ...$workflow->balance($item->id, $warehouse->id)];
}
}
return Inertia::render('stock/operations', [
'items' => $items, 'warehouses' => $warehouses, 'balances' => $balances,
'users' => User::query()->where('tenant_id', $request->user()->tenant_id)->orderBy('name')->get(['id', 'name']),
'operations' => StockOperation::query()->latest('id')->paginate(20),
'counts' => StockOperation::query()->where('kind', 'count')->whereNotIn('id', StockOperation::query()->whereNotNull('count_id')->select('count_id'))->latest('id')->get(),
'canOperate' => $request->user()->purchasing_role === PurchasingRole::Warehouse,
'equipment' => Equipment::query()->orderBy('code')->get(['id', 'code', 'description']),
]);
}
public function store(Request $request, StockWorkflow $workflow): JsonResponse|RedirectResponse
{
abort_unless($request->user()->purchasing_role === PurchasingRole::Warehouse, 403);
$request->merge(['reference' => Str::upper(Str::squish($request->string('reference')->toString())), 'reason' => trim($request->string('reason')->toString()), 'destination' => trim($request->string('destination')->toString())]);
$tenant = $request->user()->tenant_id;
$data = $request->validate([
'kind' => ['required', Rule::in(['issue', 'transfer', 'count', 'adjustment'])],
'reference' => 'required|string|max:100', 'idempotency_key' => 'required|uuid', 'reason' => 'required|string|max:4000',
'responsible_id' => ['required', 'integer', Rule::exists('users', 'id')->where('tenant_id', $tenant)],
'warehouse_id' => ['required', 'integer', Rule::exists('warehouses', 'id')->where('tenant_id', $tenant)],
'stock_item_id' => ['required', 'integer', Rule::exists('stock_items', 'id')->where('tenant_id', $tenant)],
'destination_warehouse_id' => ['exclude_unless:kind,transfer', 'required', 'integer', Rule::exists('warehouses', 'id')->where('tenant_id', $tenant)],
'destination' => 'exclude_unless:kind,issue|required|string|max:200',
'equipment_id' => ['exclude_unless:kind,issue', 'nullable', 'integer', Rule::exists('equipment', 'id')->where('tenant_id', $tenant)],
'quantity' => ['exclude_if:kind,adjustment', 'required', 'regex:/^\d{1,9}(\.\d{1,3})?$/', $request->input('kind') === 'count' ? 'gte:0' : 'gt:0'],
'ledger_version' => 'exclude_unless:kind,count|required|integer|min:0',
'count_id' => ['exclude_unless:kind,adjustment', 'required', 'integer', Rule::exists('stock_operations', 'id')->where('tenant_id', $tenant)->where('kind', 'count')],
]);
if (empty($data['equipment_id'])) {
unset($data['equipment_id']);
}
foreach (['responsible_id', 'warehouse_id', 'stock_item_id', 'destination_warehouse_id', 'ledger_version', 'count_id', 'equipment_id'] as $key) {
if (isset($data[$key])) {
$data[$key] = (int) $data[$key];
}
}
$data['quantity'] = isset($data['quantity']) ? (string) BigDecimal::of($data['quantity'])->toScale(3) : '0.000';
ksort($data);
$operation = $workflow->record($request->user(), $data);
return $request->expectsJson() ? response()->json(['id' => $operation->id, 'created' => $operation->wasRecentlyCreated], $operation->wasRecentlyCreated ? 201 : 200) : back();
}
}
@@ -0,0 +1,55 @@
<?php
namespace App\Http\Controllers;
use App\Enums\PurchasingRole;
use App\Models\Supplier;
use App\Models\SupplierBankDetail;
use App\Models\SupplierBankReview;
use App\Services\RequisitionWorkflow;
use App\Services\SupplierBankWorkflow;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Str;
use Inertia\Inertia;
use Symfony\Component\HttpFoundation\Response;
class SupplierBankController extends Controller
{
public function show(Request $request, Supplier $supplier, SupplierBankWorkflow $workflow): Response
{
abort_unless(in_array($request->user()->purchasing_role, [PurchasingRole::Admin, PurchasingRole::Procurement, PurchasingRole::Finance]), 403);
$details = SupplierBankDetail::query()->where('supplier_id', $supplier->id)->latest('revision')->get();
$current = $details->first();
$canRead = in_array($request->user()->purchasing_role, [PurchasingRole::Procurement, PurchasingRole::Finance]);
$data = null;
if ($current && $canRead) {
app(RequisitionWorkflow::class)->audit($request->user(), 'supplier.bank_viewed', null, null, ['supplier_id' => $supplier->id, 'bank_detail_id' => $current->id]);
$data = [...$current->toArray(), ...$current->only(['account_identifier', 'beneficiary', 'evidence_reference', 'reason'])];
}
Inertia::encryptHistory();
$response = Inertia::render('suppliers/bank', ['supplier' => $supplier->only(['id', 'name']), 'current' => $data, 'currentId' => $current->id ?? 0, 'state' => $workflow->state($supplier), 'history' => $details->map(fn ($detail) => $detail->only(['id', 'revision', 'created_by', 'created_at'])), 'reviews' => SupplierBankReview::query()->whereIn('supplier_bank_detail_id', $details->pluck('id'))->orderBy('id')->get(), 'canPropose' => $request->user()->purchasing_role === PurchasingRole::Procurement, 'canReview' => $current && $request->user()->purchasing_role === PurchasingRole::Finance && $current->created_by !== $request->user()->id && ! SupplierBankReview::query()->where('supplier_bank_detail_id', $current->id)->where('reviewed_by', $request->user()->id)->exists()])->toResponse($request);
$response->headers->set('Cache-Control', 'private, no-store, max-age=0');
return $response;
}
public function store(Request $request, Supplier $supplier, SupplierBankWorkflow $workflow): RedirectResponse
{
$request->merge(['country' => Str::upper(trim($request->string('country')->toString())), 'currency' => Str::upper(trim($request->string('currency')->toString())), 'account_identifier' => Str::upper(preg_replace('/\s+/', '', $request->string('account_identifier')->toString()) ?? '')]);
$data = $request->validate(['previous_id' => 'required|integer|min:0', 'bank_name' => 'required|string|max:200', 'country' => ['required', 'regex:/^[A-Z]{2}$/'], 'currency' => ['required', 'regex:/^[A-Z]{3}$/'], 'beneficiary' => 'required|string|max:200', 'account_identifier' => ['required', 'regex:/^[A-Z0-9.\/-]{4,100}$/'], 'evidence_reference' => 'required|string|max:1000', 'reason' => 'required|string|max:2000']);
$workflow->propose($request->user(), $supplier, $data);
return back();
}
public function review(Request $request, Supplier $supplier, SupplierBankDetail $detail, SupplierBankWorkflow $workflow): RedirectResponse
{
abort_unless($detail->supplier_id === $supplier->id, 404);
$data = $request->validate(['decision' => 'required|in:approved,rejected', 'reason' => 'required|string|max:2000', 'independently_verified' => 'accepted']);
$workflow->review($request->user(), $detail, $data['decision'], $data['reason']);
return back();
}
}
@@ -0,0 +1,53 @@
<?php
namespace App\Http\Requests;
use App\Models\GoodsReceipt;
use App\Models\PurchaseOrder;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
class ConfirmReceiptRequest extends FormRequest
{
public function authorize(): bool
{
$order = $this->route('order');
return $order instanceof PurchaseOrder && ($this->user()?->can('create', [GoodsReceipt::class, $order]) ?? false);
}
/** @return array<string, mixed> */
public function rules(): array
{
return [
'idempotency_key' => 'required|uuid', 'delivery_note' => 'required|string|max:100',
'received_on' => 'required|date_format:Y-m-d|before_or_equal:today',
'warehouse_id' => ['nullable', 'integer', Rule::exists('warehouses', 'id')->where('tenant_id', $this->user()?->tenant_id)],
'items' => 'required|array|min:1|max:100', 'items.*.purchase_order_item_id' => 'required|integer|distinct',
'items.*.received_quantity' => ['required', 'string', 'numeric', 'gt:0', 'max:1000000', 'regex:/^\d+(\.\d{1,3})?$/'],
'items.*.accepted_quantity' => ['required', 'string', 'numeric', 'min:0', 'max:1000000', 'regex:/^\d+(\.\d{1,3})?$/'],
'items.*.quality_status' => ['required', Rule::in(['compliant', 'reservations', 'nonconforming'])],
'items.*.notes' => 'nullable|string|max:3000',
'items.*.stock_item_id' => ['nullable', 'integer', Rule::exists('stock_items', 'id')->where('tenant_id', $this->user()?->tenant_id)],
'tenant_id' => 'prohibited', 'received_by' => 'prohibited', 'status' => 'prohibited', 'snapshot' => 'prohibited',
];
}
/** @return array<string, string> */
public function messages(): array
{
return [
'delivery_note.required' => 'Indique a guia de remessa do fornecedor.',
'received_on.before_or_equal' => 'A recepção não pode ser registada numa data futura.',
'items.required' => 'Seleccione pelo menos uma linha para conferir.',
'items.min' => 'Seleccione pelo menos uma linha para conferir.',
'items.*.received_quantity.regex' => 'Use quantidades com até três casas decimais.',
'items.*.accepted_quantity.regex' => 'Use quantidades com até três casas decimais.',
'items.*.received_quantity.string' => 'Envie a quantidade recebida como texto decimal para manter a precisão.',
'items.*.accepted_quantity.string' => 'Envie a quantidade aceite como texto decimal para manter a precisão.',
'warehouse_id.exists' => 'Seleccione um armazém da sua empresa.',
'items.*.stock_item_id.exists' => 'Seleccione um artigo de stock da sua empresa.',
'idempotency_key.uuid' => 'A chave de confirmação é inválida. Reabra o formulário.',
];
}
}
@@ -25,7 +25,11 @@ class StoreRequisitionRequest extends FormRequest
'items' => ['required', 'array', 'min:1', 'max:50'],
'items.*.description' => ['required', 'string', 'max:255'],
'items.*.category' => ['required', 'string', 'max:100'],
'items.*.purchase_type' => ['required', Rule::in(['consumable', 'service', 'other'])],
'items.*.purchase_type' => ['required', Rule::in(['consumable', 'service', 'other', 'equipment', 'spare_part'])],
'items.*.equipment_id' => ['exclude_unless:items.*.purchase_type,spare_part', 'required', 'integer', Rule::exists('equipment', 'id')->where('tenant_id', $this->user()?->tenant_id)->where('department_id', $this->user()?->department_id)],
'items.*.spare_part_id' => ['exclude_unless:items.*.purchase_type,spare_part', 'required', 'integer', Rule::exists('spare_parts', 'id')->where('tenant_id', $this->user()?->tenant_id)],
'items.*.production_area' => 'exclude_unless:items.*.purchase_type,equipment|required|string|max:200',
'items.*.downtime_started_at' => 'exclude_unless:items.*.purchase_type,spare_part|nullable|date_format:Y-m-d\TH:i|before_or_equal:now',
'items.*.quantity' => ['required', 'numeric', 'min:0.001', 'max:1000000', 'regex:/^\d+(\.\d{1,3})?$/'],
'items.*.unit' => ['required', 'string', 'max:30'],
'items.*.unit_price' => ['required', 'numeric', 'min:0.01', 'max:100000000', 'regex:/^\d+(\.\d{1,2})?$/'],
+37
View File
@@ -0,0 +1,37 @@
<?php
namespace App\Models;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
/** @property int $id
* @property int $amount_minor
* @property int $created_by
* @property int|null $approved_by
*/
class Budget extends Model
{
use BelongsToTenant;
protected $guarded = ['id'];
protected static function booted(): void
{
static::updating(function (Budget $budget) {
if ($budget->getRawOriginal('approved_by') !== null) {
throw new \LogicException('Uma dotação aprovada não pode ser reescrita.');
}
});
static::deleting(function (Budget $budget) {
if ($budget->approved_by !== null) {
throw new \LogicException('Preservar a dotação aprovada e os seus movimentos.');
}
});
}
protected function casts(): array
{
return ['includes_tax' => 'boolean'];
}
}
+16
View File
@@ -0,0 +1,16 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class BudgetConsumption extends Model
{
use AppendOnlyInventoryRecord, BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
}
+16
View File
@@ -0,0 +1,16 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class BudgetEntry extends Model
{
use AppendOnlyInventoryRecord, BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
}
@@ -0,0 +1,14 @@
<?php
namespace App\Models\Concerns;
use LogicException;
trait AppendOnlyInventoryRecord
{
protected static function bootAppendOnlyInventoryRecord(): void
{
static::updating(fn () => throw new LogicException('O histórico de recepção e stock não pode ser reescrito.'));
static::deleting(fn () => throw new LogicException('O histórico de recepção e stock não pode ser eliminado.'));
}
}
+23
View File
@@ -0,0 +1,23 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class CriticalityLevel extends Model
{
use AppendOnlyInventoryRecord;
use BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
/** @return array<string,string> */
protected function casts(): array
{
return ['is_critical' => 'boolean'];
}
}
+13
View File
@@ -0,0 +1,13 @@
<?php
namespace App\Models;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class Equipment extends Model
{
use BelongsToTenant;
protected $guarded = ['id'];
}
+17
View File
@@ -0,0 +1,17 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class EquipmentSparePart extends Model
{
use AppendOnlyInventoryRecord;
use BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
}
+36
View File
@@ -0,0 +1,36 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
/**
* @property int $id
* @property int $tenant_id
* @property int $purchase_order_id
* @property int $received_by
* @property string $payload_hash
* @property array<string, mixed> $snapshot
*/
class GoodsReceipt extends Model
{
use AppendOnlyInventoryRecord, BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
protected function casts(): array
{
return ['snapshot' => 'array', 'received_on' => 'date:Y-m-d', 'confirmed_at' => 'datetime'];
}
/** @return HasMany<GoodsReceiptItem, $this> */
public function items(): HasMany
{
return $this->hasMany(GoodsReceiptItem::class)->orderBy('id');
}
}
+21
View File
@@ -0,0 +1,21 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class GoodsReceiptItem extends Model
{
use AppendOnlyInventoryRecord, BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
protected function casts(): array
{
return ['snapshot' => 'array'];
}
}
+42
View File
@@ -0,0 +1,42 @@
<?php
namespace App\Models;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
/** @property int $id
* @property int $tenant_id
* @property int $purchase_order_id
* @property int $created_by
* @property string $status
* @property array<string,mixed> $snapshot
*/
class Invoice extends Model
{
use BelongsToTenant;
protected $guarded = ['id'];
protected function casts(): array
{
return ['snapshot' => 'array'];
}
protected static function booted(): void
{
static::updating(function (Invoice $invoice) {
if ($invoice->getRawOriginal('status') !== 'pending' || array_diff(array_keys($invoice->getDirty()), ['status', 'validated_by', 'validated_at', 'updated_at']) !== []) {
throw new \LogicException('Preservar a factura registada e a validação.');
}
});
static::deleting(fn () => throw new \LogicException('Preservar o histórico de facturas.'));
}
/** @return HasMany<InvoiceItem,$this> */
public function items(): HasMany
{
return $this->hasMany(InvoiceItem::class);
}
}
+22
View File
@@ -0,0 +1,22 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
/** @property array<string,mixed> $snapshot */
class InvoiceItem extends Model
{
use AppendOnlyInventoryRecord, BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
protected function casts(): array
{
return ['snapshot' => 'array'];
}
}
+5
View File
@@ -6,6 +6,11 @@ use App\Models\Concerns\BelongsToTenant;
use App\Models\Concerns\ImmutablePurchaseRecord;
use Illuminate\Database\Eloquent\Model;
/**
* @property string $quantity
* @property int|null $equipment_id
* @property int|null $spare_part_id
*/
class PurchaseOrderItem extends Model
{
use BelongsToTenant, ImmutablePurchaseRecord;
+2
View File
@@ -10,6 +10,8 @@ use Illuminate\Database\Eloquent\Model;
*
* @property string $quantity
* @property string $tax_rate
* @property int|null $equipment_id
* @property int|null $spare_part_id
*/
class RequisitionItem extends Model
{
+13
View File
@@ -0,0 +1,13 @@
<?php
namespace App\Models;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class SparePart extends Model
{
use BelongsToTenant;
protected $guarded = ['id'];
}
+13
View File
@@ -0,0 +1,13 @@
<?php
namespace App\Models;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class StockItem extends Model
{
use BelongsToTenant;
protected $guarded = ['id'];
}
+21
View File
@@ -0,0 +1,21 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class StockMovement extends Model
{
use AppendOnlyInventoryRecord, BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
protected function casts(): array
{
return ['snapshot' => 'array', 'moved_at' => 'datetime'];
}
}
+27
View File
@@ -0,0 +1,27 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
/**
* @property array<string, mixed> $snapshot
* @property int|null $equipment_id
* @property int|null $spare_part_id
*/
class StockOperation extends Model
{
use AppendOnlyInventoryRecord, BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
/** @return array<string, string> */
protected function casts(): array
{
return ['snapshot' => 'array', 'recorded_at' => 'datetime', 'quantity_milli' => 'integer', 'theoretical_milli' => 'integer', 'ledger_version' => 'integer'];
}
}
+31
View File
@@ -0,0 +1,31 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
/** @property int $id
* @property int $tenant_id
* @property int $supplier_id
* @property int $created_by
* @property int $revision
* @property string $account_identifier
* @property string $beneficiary
*/
class SupplierBankDetail extends Model
{
use AppendOnlyInventoryRecord, BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
protected $hidden = ['account_identifier', 'beneficiary', 'evidence_reference', 'reason'];
protected function casts(): array
{
return ['account_identifier' => 'encrypted', 'beneficiary' => 'encrypted', 'evidence_reference' => 'encrypted', 'reason' => 'encrypted'];
}
}
+23
View File
@@ -0,0 +1,23 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class SupplierBankReview extends Model
{
use AppendOnlyInventoryRecord, BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
protected $hidden = ['reason'];
protected function casts(): array
{
return ['reason' => 'encrypted'];
}
}
+23
View File
@@ -0,0 +1,23 @@
<?php
namespace App\Models;
use App\Models\Concerns\AppendOnlyInventoryRecord;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class TechnicalReview extends Model
{
use AppendOnlyInventoryRecord;
use BelongsToTenant;
public $timestamps = false;
protected $guarded = ['id'];
/** @return array<string,string> */
protected function casts(): array
{
return ['snapshot' => 'array', 'reviewed_at' => 'datetime'];
}
}
+13
View File
@@ -0,0 +1,13 @@
<?php
namespace App\Models;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
class Warehouse extends Model
{
use BelongsToTenant;
protected $guarded = ['id'];
}
+35
View File
@@ -0,0 +1,35 @@
<?php
namespace App\Policies;
use App\Enums\PurchasingRole;
use App\Models\GoodsReceipt;
use App\Models\PurchaseOrder;
use App\Models\Requisition;
use App\Models\User;
class GoodsReceiptPolicy
{
public function viewAny(User $user): bool
{
return $user->tenant_id !== null && in_array($user->purchasing_role, [PurchasingRole::Admin, PurchasingRole::Procurement, PurchasingRole::Finance, PurchasingRole::Warehouse, PurchasingRole::DepartmentHead]);
}
public function viewOrder(User $user, PurchaseOrder $order): bool
{
return $this->viewAny($user) && $user->tenant_id === $order->tenant_id &&
($user->purchasing_role !== PurchasingRole::DepartmentHead || Requisition::query()->whereKey($order->requisition_id)->where('department_id', $user->department_id)->exists());
}
public function view(User $user, GoodsReceipt $receipt): bool
{
$order = PurchaseOrder::query()->find($receipt->purchase_order_id);
return $order !== null && $this->viewOrder($user, $order);
}
public function create(User $user, PurchaseOrder $order): bool
{
return $user->tenant_id === $order->tenant_id && $user->purchasing_role === PurchasingRole::Warehouse && $user->id !== $order->issued_by;
}
}
+65
View File
@@ -0,0 +1,65 @@
<?php
namespace App\Services;
use App\Models\Budget;
use App\Models\BudgetConsumption;
use App\Models\BudgetEntry;
use App\Models\Requisition;
use App\Models\User;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException;
class BudgetWorkflow
{
/** Called inside the procurement transaction, after the company lock.
* @return array<string,int>|null
*/
public function record(User $user, Requisition $request, string $kind, int $amount = 0, ?int $subtotal = null): ?array
{
abort_unless(auth()->id() === $user->id && $user->tenant_id !== null && $request->tenant_id === $user->tenant_id, 403);
if (DB::connection()->transactionLevel() === 0) {
throw new \LogicException('Movimentos de orçamento exigem transacção.');
}
app(ConflictGuard::class)->lockCompany($user);
$existing = BudgetEntry::query()->where('requisition_id', $request->id)->orderBy('id')->first();
$budget = $existing
? Budget::query()->lockForUpdate()->findOrFail($existing->budget_id)
: Budget::query()->where('cost_center_id', $request->cost_center_id)->where('year', now()->year)->lockForUpdate()->first();
// Unconfigured legacy processes remain development documents, explicitly unchecked.
if (! $budget) {
return null;
}
if (! $budget->approved_by || ($kind !== 'release' && (int) $budget->year !== now()->year)) {
throw ValidationException::withMessages(['budget' => 'Dotação pendente de aprovação ou exercício encerrado.']);
}
if (! $budget->includes_tax && in_array($kind, ['reserve', 'award', 'commit'])) {
$amount = $subtotal ?? throw new \LogicException('Subtotal necessário para a base sem IVA.');
}
if (BudgetEntry::query()->where('requisition_id', $request->id)->where('kind', $kind)->exists()) {
return ['budget_id' => $budget->id, 'year' => (int) $budget->year];
}
$own = BudgetEntry::query()->where('requisition_id', $request->id);
$reserved = (int) (clone $own)->sum('reserved_minor');
$committed = (int) $own->sum('committed_minor');
if ($committed !== 0 || ($kind !== 'reserve' && ! $existing)) {
throw ValidationException::withMessages(['budget' => 'Processo sem reserva válida ou já comprometido.']);
}
[$reserveDelta, $commitDelta] = match ($kind) {
'reserve', 'award' => [$amount - $reserved, 0],
'release' => [-$reserved, 0],
'commit' => [-$reserved, $amount],
default => throw new \LogicException('Movimento orçamental inválido.'),
};
$ledger = BudgetEntry::query()->where('budget_id', $budget->id);
$used = (int) (clone $ledger)->sum('reserved_minor') + (int) $ledger->sum('committed_minor');
$used += (int) BudgetConsumption::query()->where('budget_id', $budget->id)->sum('amount_minor');
if ($used + $reserveDelta + $commitDelta > $budget->amount_minor) {
throw ValidationException::withMessages(['budget' => 'Saldo orçamental insuficiente. Não são permitidos excessos.']);
}
BudgetEntry::query()->create(['tenant_id' => $user->tenant_id, 'budget_id' => $budget->id, 'requisition_id' => $request->id, 'created_by' => $user->id, 'kind' => $kind, 'reserved_minor' => $reserveDelta, 'committed_minor' => $commitDelta, 'created_at' => now()]);
app(RequisitionWorkflow::class)->audit($user, 'budget.'.$kind, $request, null, ['budget_id' => $budget->id, 'reserved_minor' => $reserveDelta, 'committed_minor' => $commitDelta]);
return ['budget_id' => $budget->id, 'year' => (int) $budget->year];
}
}
+2
View File
@@ -84,6 +84,8 @@ class ConflictGuard
'requisition.created', 'requisition.updated', 'requisition.submitted',
'approval.approved', 'approval.rejected', 'quotation.created', 'quotation.evaluated',
'award.created', 'award.approved', 'award.rejected', 'purchase_order.issued',
'equipment.technical_approved', 'equipment.technical_rejected',
'invoice.created', 'invoice.validated',
])->pluck('user_id'))
->unique()->values()->all();
$ids = [];
+96
View File
@@ -0,0 +1,96 @@
<?php
namespace App\Services;
use App\Enums\PurchasingRole;
use App\Models\CriticalityLevel;
use App\Models\Equipment;
use App\Models\EquipmentSparePart;
use App\Models\Requisition;
use App\Models\SparePart;
use App\Models\StockItem;
use App\Models\TechnicalReview;
use App\Models\User;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException;
class EquipmentWorkflow
{
public function linkedPart(int $partId, int $equipmentId, ?int $departmentId = null): SparePart
{
$part = SparePart::query()->findOrFail($partId);
$asset = Equipment::query()->findOrFail($equipmentId);
if (($departmentId !== null && $asset->department_id !== $departmentId) || ! EquipmentSparePart::query()->where('equipment_id', $asset->id)->where('spare_part_id', $part->id)->exists()) {
throw ValidationException::withMessages(['equipment_id' => 'A peça deve estar associada a um equipamento da área de destino e da mesma empresa.']);
}
return $part;
}
/** @param array<string,mixed> $line */
public function line(array $line, int $departmentId, string $priority): void
{
if ($line['purchase_type'] === 'equipment' && empty(trim($line['production_area'] ?? ''))) {
throw ValidationException::withMessages(['items' => 'Indique a área ou linha de produção do equipamento novo.']);
}
if ($line['purchase_type'] !== 'spare_part') {
return;
}
$part = $this->linkedPart((int) ($line['spare_part_id'] ?? 0), (int) ($line['equipment_id'] ?? 0), $departmentId);
$stock = StockItem::query()->findOrFail($part->stock_item_id);
if (mb_strtolower(trim($stock->unit)) !== mb_strtolower(trim($line['unit']))) {
throw ValidationException::withMessages(['items' => 'A unidade da peça deve coincidir com o artigo de stock, sem conversões automáticas.']);
}
$level = CriticalityLevel::query()->findOrFail($part->criticality_level_id);
if ($priority === 'urgent' && $level->is_critical && empty($line['downtime_started_at'])) {
throw ValidationException::withMessages(['items' => 'Peça crítica urgente: indique o início da paragem do equipamento (RF-AF-07).']);
}
}
public function basis(Requisition $requisition): string
{
return hash('sha256', json_encode([$requisition->only(['id', 'tenant_id', 'department_id', 'requester_id', 'priority', 'needed_by', 'justification', 'total_minor']), $requisition->items()->orderBy('id')->get()->toArray()], JSON_THROW_ON_ERROR));
}
public function canReview(User $user, Requisition $requisition): bool
{
return $requisition->status === 'draft' && $requisition->items()->where('purchase_type', 'equipment')->exists() && $this->eligible($user, $requisition);
}
private function eligible(User $user, Requisition $requisition): bool
{
return $requisition->tenant_id === $user->tenant_id && $user->purchasing_role === PurchasingRole::DepartmentHead && $user->department_id === $requisition->department_id && $user->id !== $requisition->requester_id && ! app(ConflictGuard::class)->participationBlocked($user, $requisition);
}
public function review(User $user, Requisition $requisition, string $basis, string $decision, string $reason): TechnicalReview
{
return DB::transaction(function () use ($user, $requisition, $basis, $decision, $reason) {
app(ConflictGuard::class)->lockCompany($user);
$requisition = Requisition::query()->lockForUpdate()->findOrFail($requisition->id);
abort_unless($this->canReview($user, $requisition), 403);
app(ConflictGuard::class)->assertParticipation($user, $requisition);
if ($basis !== $this->basis($requisition)) {
throw ValidationException::withMessages(['basis_hash' => 'O pedido mudou. Reveja a versão actual antes de decidir.']);
}
if (TechnicalReview::query()->where('requisition_id', $requisition->id)->where('basis_hash', $basis)->exists()) {
throw ValidationException::withMessages(['technical' => 'Esta versão já tem uma decisão técnica. A decisão anterior permanece no histórico.']);
}
$review = TechnicalReview::query()->create(['tenant_id' => $user->tenant_id, 'requisition_id' => $requisition->id, 'reviewed_by' => $user->id, 'basis_hash' => $basis, 'decision' => $decision, 'reason' => $reason, 'reviewed_at' => now(), 'snapshot' => ['reviewer' => $user->only(['id', 'name', 'department_id']), 'items' => $requisition->items()->get()->toArray(), 'development_only' => true, 'budget_checked' => false]]);
app(RequisitionWorkflow::class)->audit($user, 'equipment.technical_'.$decision, $requisition, null, $review->toArray());
return $review;
});
}
public function assertTechnical(Requisition $requisition): void
{
if (! $requisition->items()->where('purchase_type', 'equipment')->exists()) {
return;
}
$review = TechnicalReview::query()->where('requisition_id', $requisition->id)->where('basis_hash', $this->basis($requisition))->first();
$user = $review ? User::query()->where('tenant_id', $requisition->tenant_id)->find($review->reviewed_by) : null;
if (! $review || $review->decision !== 'approved' || ! $user || ! $this->eligible($user, $requisition)) {
throw ValidationException::withMessages(['technical' => 'É necessária validação técnica válida do responsável da área, distinto do solicitante, para a versão actual.']);
}
}
}
+150
View File
@@ -0,0 +1,150 @@
<?php
namespace App\Services;
use App\Enums\PurchasingRole;
use App\Models\Budget;
use App\Models\BudgetConsumption;
use App\Models\BudgetEntry;
use App\Models\GoodsReceiptItem;
use App\Models\Invoice;
use App\Models\InvoiceItem;
use App\Models\PurchaseOrder;
use App\Models\Requisition;
use App\Models\User;
use Brick\Math\BigDecimal;
use Brick\Math\RoundingMode;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;
use Illuminate\Validation\ValidationException;
class InvoiceWorkflow
{
private function access(User $user): void
{
abort_unless(auth()->id() === $user->id && $user->tenant_id !== null && $user->purchasing_role === PurchasingRole::Finance, 403);
}
private function invalid(string $message): never
{
throw ValidationException::withMessages(['invoice' => $message]);
}
/** @param list<array<string,mixed>> $inputs
* @return list<array<string,mixed>>
*/
private function lines(PurchaseOrder $order, array $inputs): array
{
$sources = $order->items()->get()->keyBy('id');
$seen = [];
$lines = [];
foreach ($inputs as $input) {
$source = $sources->get($input['purchase_order_item_id']);
if (! $source || in_array($source->id, $seen, true)) {
$this->invalid('Linhas distintas e pertencentes à ordem são obrigatórias.');
}
$seen[] = $source->id;
$quantity = ReceiptWorkflow::milli((string) $input['quantity']);
$previous = InvoiceItem::query()->where('purchase_order_item_id', $source->id)->whereIn('invoice_id', Invoice::query()->where('status', 'validated')->select('id'))->sum('quantity_milli');
$accepted = GoodsReceiptItem::query()->where('purchase_order_item_id', $source->id)->sum('accepted_milli');
if ($quantity <= 0 || (int) $previous + $quantity > (int) $accepted || (int) $previous + $quantity > ReceiptWorkflow::milli($source->quantity)) {
$this->invalid('Quantidade superior à recepção aceite ainda não facturada. Serviços também exigem aceitação.');
}
if (BigDecimal::of((string) $input['unit_price'])->multipliedBy(100)->compareTo($source->unit_price_minor) !== 0 || BigDecimal::of((string) $input['tax_rate'])->compareTo((string) $source->tax_rate) !== 0 || trim((string) $input['unit']) !== $source->unit) {
$this->invalid('Preço, unidade e IVA devem coincidir exactamente com a ordem. Não há tolerância ou excepção configurada.');
}
// Cumulative rounding ensures partial invoices sum exactly to the frozen order.
$subtotal = fn (int $milli) => BigDecimal::of($milli)->multipliedBy($source->unit_price_minor)->dividedBy(1000, 0, RoundingMode::HalfUp)->toInt();
$tax = fn (int $minor) => BigDecimal::of($minor)->multipliedBy((string) $source->tax_rate)->dividedBy(100, 0, RoundingMode::HalfUp)->toInt();
$before = $subtotal((int) $previous);
$after = $subtotal((int) $previous + $quantity);
$lines[] = ['tenant_id' => $order->tenant_id, 'purchase_order_item_id' => $source->id, 'quantity_milli' => $quantity, 'subtotal_minor' => $after - $before, 'tax_minor' => $tax($after) - $tax($before), 'snapshot' => $source->only(['description', 'unit', 'unit_price_minor', 'tax_rate'])];
}
if ($lines === []) {
$this->invalid('Indique pelo menos uma linha.');
}
return $lines;
}
/** @param array<string,mixed> $data */
public function register(User $user, PurchaseOrder $order, array $data): Invoice
{
$this->access($user);
abort_unless($order->tenant_id === $user->tenant_id, 403);
return DB::transaction(function () use ($user, $order, $data) {
app(ConflictGuard::class)->lockCompany($user);
$order = PurchaseOrder::query()->lockForUpdate()->findOrFail($order->id);
$request = Requisition::query()->findOrFail($order->requisition_id);
app(ConflictGuard::class)->assertProcess($request, $order->supplier_id, $user);
$number = Str::upper(Str::squish($data['number']));
if ($number === '' || Invoice::query()->where('supplier_id', $order->supplier_id)->where('number', $number)->exists()) {
$this->invalid('Número de factura vazio ou já registado para este fornecedor.');
}
if ($order->status !== 'issued' || $order->currency !== 'MZN' || substr($data['issued_on'], 0, 4) !== now()->format('Y') || $data['issued_on'] > today()->format('Y-m-d') || $data['issued_on'] < substr((string) $order->getRawOriginal('issued_at'), 0, 10)) {
$this->invalid('Factura deve referir ordem emitida em MZN, com data válida no exercício actual e posterior à emissão.');
}
$lines = $this->lines($order, $data['items']);
$subtotal = array_sum(array_column($lines, 'subtotal_minor'));
$tax = array_sum(array_column($lines, 'tax_minor'));
foreach (['subtotal' => $subtotal, 'tax' => $tax, 'total' => $subtotal + $tax] as $key => $expected) {
if (BigDecimal::of((string) $data[$key])->multipliedBy(100)->compareTo($expected) !== 0) {
$this->invalid('Totais da factura divergem da conferência com a ordem e recepção. Verifique os arredondamentos das facturas parciais.');
}
}
$invoice = Invoice::query()->create(['tenant_id' => $user->tenant_id, 'purchase_order_id' => $order->id, 'supplier_id' => $order->supplier_id, 'created_by' => $user->id, 'number' => $number, 'issued_on' => $data['issued_on'], 'subtotal_minor' => $subtotal, 'tax_minor' => $tax, 'total_minor' => $subtotal + $tax, 'snapshot' => ['supplier' => $order->snapshot['supplier'], 'order_number' => $order->number, 'author' => $user->only(['id', 'name']), 'currency' => 'MZN', 'development_only' => true, 'matching_tolerance' => 'zero', 'rounding' => 'cumulative_half_up']]);
$invoice->items()->createMany($lines);
app(RequisitionWorkflow::class)->audit($user, 'invoice.created', $request, null, $invoice->load('items')->toArray());
return $invoice;
});
}
public function validate(User $user, Invoice $invoice): void
{
$this->access($user);
abort_unless($invoice->tenant_id === $user->tenant_id && $invoice->created_by !== $user->id, 403);
DB::transaction(function () use ($user, $invoice) {
app(ConflictGuard::class)->lockCompany($user);
$invoice = Invoice::query()->lockForUpdate()->findOrFail($invoice->id);
if ($invoice->status === 'validated') {
return;
}
$order = PurchaseOrder::query()->lockForUpdate()->findOrFail($invoice->purchase_order_id);
$request = Requisition::query()->findOrFail($order->requisition_id);
app(ConflictGuard::class)->assertProcess($request, $order->supplier_id, $user);
if (substr((string) $invoice->issued_on, 0, 4) !== now()->format('Y')) {
$this->invalid('Conferência entre exercícios não suportada.');
}
$stored = $invoice->items()->orderBy('id')->get();
$inputs = [];
foreach ($stored as $line) {
$inputs[] = ['purchase_order_item_id' => $line->purchase_order_item_id, 'quantity' => (string) BigDecimal::of($line->quantity_milli)->dividedBy(1000, 3), 'unit' => $line->snapshot['unit'], 'unit_price' => (string) BigDecimal::of($line->snapshot['unit_price_minor'])->dividedBy(100, 2), 'tax_rate' => $line->snapshot['tax_rate']];
}
$current = $this->lines($order, $inputs);
foreach ($current as $index => $line) {
if ($line['subtotal_minor'] !== $stored[$index]->subtotal_minor || $line['tax_minor'] !== $stored[$index]->tax_minor) {
$this->invalid('Conferência alterada por outra factura; a validação está bloqueada.');
}
}
$commit = BudgetEntry::query()->where('requisition_id', $request->id)->where('kind', 'commit')->first();
if (! $commit) {
$this->invalid('A ordem não possui compromisso orçamental. Factura permanece pendente; não é criado saldo retroactivo.');
}
$budget = Budget::query()->lockForUpdate()->findOrFail($commit->budget_id);
if (! $budget->approved_by || (int) $budget->year !== now()->year) {
$this->invalid('Orçamento não aprovado ou fora do exercício.');
}
$amount = (int) ($budget->includes_tax ? $invoice->total_minor : $invoice->subtotal_minor);
$remaining = (int) BudgetEntry::query()->where('requisition_id', $request->id)->sum('committed_minor');
if ($amount > $remaining) {
$this->invalid('Compromisso insuficiente para a factura.');
}
BudgetEntry::query()->create(['tenant_id' => $user->tenant_id, 'budget_id' => $budget->id, 'requisition_id' => $request->id, 'created_by' => $user->id, 'kind' => 'invoice-'.$invoice->id, 'reserved_minor' => 0, 'committed_minor' => -$amount, 'created_at' => now()]);
BudgetConsumption::query()->create(['tenant_id' => $user->tenant_id, 'budget_id' => $budget->id, 'invoice_id' => $invoice->id, 'created_by' => $user->id, 'amount_minor' => $amount, 'created_at' => now()]);
$invoice->update(['status' => 'validated', 'validated_by' => $user->id, 'validated_at' => now()]);
app(RequisitionWorkflow::class)->audit($user, 'invoice.validated', $request, null, ['invoice_id' => $invoice->id, 'budget_id' => $budget->id, 'consumed_minor' => $amount]);
});
}
}
+19 -4
View File
@@ -3,12 +3,14 @@
namespace App\Services;
use App\Enums\PurchasingRole;
use App\Models\Equipment;
use App\Models\ProposalEvaluation;
use App\Models\PurchaseAward;
use App\Models\PurchaseOrder;
use App\Models\Quotation;
use App\Models\QuotationItem;
use App\Models\Requisition;
use App\Models\SparePart;
use App\Models\Supplier;
use App\Models\Tenant;
use App\Models\User;
@@ -30,10 +32,11 @@ class PurchaseWorkflow
throw ValidationException::withMessages(['award' => 'Este processo já tem uma adjudicação. Não é permitida uma segunda selecção.']);
}
$rules = $this->rules($requisition);
$this->sourceApproved($requisition, $rules);
$this->supportedItems($requisition);
$this->sourceApproved($requisition, $rules);
$quote = Quotation::query()->where('requisition_id', $requisition->id)->lockForUpdate()->findOrFail($data['quotation_id']);
$result = $this->checkComparison($user, $requisition, $quote);
app(BudgetWorkflow::class)->record($user, $requisition, 'award', $quote->total_minor, $quote->subtotal_minor);
$award = PurchaseAward::query()->create([
'tenant_id' => $user->tenant_id, 'requisition_id' => $requisition->id, 'quotation_id' => $quote->id,
'created_by' => $user->id, 'justification' => $data['justification'], 'delivery_date' => $data['delivery_date'],
@@ -78,6 +81,9 @@ class PurchaseWorkflow
$step->update(['decision' => $decision, 'approver_id' => $user->id, 'comment' => $comment, 'decided_at' => now()]);
$status = $decision === 'rejected' ? 'rejected' : ($award->approvals()->where('decision', 'pending')->exists() ? 'pending' : 'approved');
$award->update(['status' => $status]);
if ($decision === 'rejected') {
app(BudgetWorkflow::class)->record($user, $requisition, 'release');
}
$this->audit->audit($user, 'award.'.$decision, $requisition, ['status' => 'pending'], ['award_id' => $award->id, 'status' => $status, 'approval' => $step->toArray()]);
});
}
@@ -113,6 +119,7 @@ class PurchaseWorkflow
$lines[] = [
...$item->only(['requisition_item_id', 'description', 'quantity', 'unit_price_minor', 'tax_rate', 'subtotal_minor', 'tax_minor', 'total_minor']),
...$source->only(['unit', 'category', 'purchase_type']), 'tenant_id' => $user->tenant_id,
'equipment_id' => $source->equipment_id, 'spare_part_id' => $source->spare_part_id,
];
}
$validUntil = $quote->attributesToArray()['valid_until'] ?? null;
@@ -122,6 +129,7 @@ class PurchaseWorkflow
}
$snapshot = [
'development_only' => true, 'budget_checked' => false,
'budget_control' => app(BudgetWorkflow::class)->record($user, $requisition, 'commit', $quote->total_minor, $quote->subtotal_minor),
'company' => Tenant::query()->findOrFail($user->tenant_id)->only(['id', 'name']),
'requisition' => $requisition->only(['id', 'number', 'justification']),
'department' => $requisition->department->only(['id', 'name']),
@@ -134,6 +142,7 @@ class PurchaseWorkflow
'estimate_approvals' => $requisition->steps()->get()->toArray(),
'final_approvals' => $award->approvals()->get()->toArray(),
'decision_matrix' => $this->comparison->inspect($requisition)['rows'], 'items' => $lines,
'equipment_context' => $requisition->items()->whereNotNull('equipment_id')->get()->map(fn ($line) => ['requisition_item_id' => $line->id, 'equipment' => Equipment::query()->findOrFail($line->equipment_id)->toArray(), 'spare_part' => SparePart::query()->findOrFail($line->spare_part_id)->toArray(), 'downtime_started_at' => $line->downtime_started_at])->all(),
];
$order = PurchaseOrder::query()->create([
'tenant_id' => $user->tenant_id, 'requisition_id' => $requisition->id, 'purchase_award_id' => $award->id,
@@ -154,8 +163,8 @@ class PurchaseWorkflow
private function currentBasis(User $user, PurchaseAward $award, Requisition $requisition): Quotation
{
$rules = $this->rules($requisition);
$this->sourceApproved($requisition, $rules);
$this->supportedItems($requisition);
$this->sourceApproved($requisition, $rules);
$quote = Quotation::query()->where('requisition_id', $requisition->id)->lockForUpdate()->findOrFail($award->quotation_id);
$result = $this->checkComparison($user, $requisition, $quote);
if ($result['fingerprint'] !== $award->comparison_hash || $award->approval_snapshot !== $rules ||
@@ -258,8 +267,14 @@ class PurchaseWorkflow
private function supportedItems(Requisition $requisition): void
{
if ($requisition->items()->whereNotIn('purchase_type', ['consumable', 'service', 'other'])->exists()) {
throw ValidationException::withMessages(['purchase_type' => 'Equipamento e peças exigem regras adicionais ainda não suportadas. A emissão para estes tipos está bloqueada.']);
if ($requisition->items()->where('purchase_type', 'equipment')->exists()) {
throw ValidationException::withMessages(['purchase_type' => 'O limite próprio de investimento e a sua regra de aplicação ainda não foram definidos pela empresa. A validação técnica e Finanças não dispensam essa decisão; adjudicação e emissão de equipamento bloqueadas.']);
}
foreach ($requisition->items()->get() as $line) {
if (! in_array($line->purchase_type, ['consumable', 'service', 'other', 'spare_part']) || ($line->purchase_type === 'spare_part' && (! $line->equipment_id || ! $line->spare_part_id))) {
throw ValidationException::withMessages(['purchase_type' => 'Tipo não suportado ou peça sem equipamento/artigo associado. Complete o cadastro antes da compra.']);
}
app(EquipmentWorkflow::class)->line($line->toArray(), $requisition->department_id, $requisition->priority);
}
}
}
+198
View File
@@ -0,0 +1,198 @@
<?php
namespace App\Services;
use App\Models\GoodsReceipt;
use App\Models\GoodsReceiptItem;
use App\Models\PurchaseOrder;
use App\Models\Requisition;
use App\Models\StockItem;
use App\Models\StockMovement;
use App\Models\User;
use App\Models\Warehouse;
use Brick\Math\BigDecimal;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Gate;
use Illuminate\Support\Str;
use Illuminate\Validation\ValidationException;
class ReceiptWorkflow
{
public function __construct(private ConflictGuard $conflicts, private RequisitionWorkflow $audit) {}
public static function milli(string $quantity): int
{
return BigDecimal::of($quantity)->multipliedBy(1000)->toScale(0)->toInt();
}
private function recordedQuantity(int $lineId, string $column): int
{
$sum = GoodsReceiptItem::query()->where('purchase_order_item_id', $lineId)->sum($column);
if (! is_int($sum) && ! is_string($sum)) {
throw new \LogicException('A soma das quantidades deve ser um inteiro exacto.');
}
return BigDecimal::of($sum)->toInt();
}
/** @return array{lines: list<array<string, mixed>>, state: string, has_divergences: bool} */
public function progress(PurchaseOrder $order): array
{
$lines = [];
$complete = true;
$delivered = true;
$started = false;
$divergences = false;
foreach ($order->items()->orderBy('id')->get() as $item) {
$ordered = self::milli($item->quantity);
$received = $this->recordedQuantity($item->id, 'received_milli');
$accepted = $this->recordedQuantity($item->id, 'accepted_milli');
$lines[] = [
...$item->only(['id', 'description', 'unit', 'purchase_type']),
'ordered_milli' => $ordered, 'received_milli' => $received, 'accepted_milli' => $accepted,
'rejected_milli' => $received - $accepted, 'delivery_pending_milli' => $ordered - $received, 'acceptance_pending_milli' => $ordered - $accepted,
];
$complete = $complete && $accepted === $ordered;
$delivered = $delivered && $received === $ordered;
$started = $started || $received > 0;
$divergences = $divergences || GoodsReceiptItem::query()->where('purchase_order_item_id', $item->id)->where('quality_status', '!=', 'compliant')->exists();
}
return ['lines' => $lines, 'state' => ! $started ? 'not_received' : ($complete ? 'complete' : ($delivered ? 'quality_pending' : 'partial')), 'has_divergences' => $divergences];
}
/** @param array<string, mixed> $data */
public function confirm(User $user, PurchaseOrder $order, array $data): GoodsReceipt
{
return DB::transaction(function () use ($user, $order, $data) {
$this->conflicts->lockCompany($user);
$order = PurchaseOrder::query()->lockForUpdate()->findOrFail($order->id);
Gate::authorize('create', [GoodsReceipt::class, $order]);
$deliveryNote = Str::squish(Str::upper($data['delivery_note']));
if ($deliveryNote === '') {
throw ValidationException::withMessages(['delivery_note' => 'Indique a guia de remessa do fornecedor.']);
}
$inputs = [];
/** @var list<array{purchase_order_item_id: int, received_quantity: string, accepted_quantity: string, quality_status: string, stock_item_id?: int|null, notes?: string|null}> $requested */
$requested = $data['items'];
foreach ($requested as $line) {
$inputs[] = [
'purchase_order_item_id' => $line['purchase_order_item_id'],
'received_milli' => self::milli($line['received_quantity']), 'accepted_milli' => self::milli($line['accepted_quantity']),
'quality_status' => $line['quality_status'], 'stock_item_id' => $line['stock_item_id'] ?? null,
'notes' => isset($line['notes']) ? trim($line['notes']) : null,
];
}
usort($inputs, fn ($a, $b) => $a['purchase_order_item_id'] <=> $b['purchase_order_item_id']);
$canonical = ['delivery_note' => $deliveryNote, 'received_on' => $data['received_on'], 'warehouse_id' => $data['warehouse_id'] ?? null, 'items' => $inputs];
// Normalize form-encoded identifiers to the same representation used by JSON requests.
$canonical['warehouse_id'] = $canonical['warehouse_id'] === null ? null : (string) $canonical['warehouse_id'];
foreach ($canonical['items'] as &$line) {
$line['purchase_order_item_id'] = (string) $line['purchase_order_item_id'];
$line['stock_item_id'] = $line['stock_item_id'] === null ? null : (string) $line['stock_item_id'];
}
unset($line);
$hash = hash('sha256', json_encode($canonical, JSON_THROW_ON_ERROR));
$existing = GoodsReceipt::query()->where('purchase_order_id', $order->id)->where('idempotency_key', $data['idempotency_key'])->first();
if ($existing) {
if ($existing->payload_hash !== $hash) {
throw ValidationException::withMessages(['idempotency_key' => 'Esta chave já confirmou uma recepção com dados diferentes.']);
}
return $existing;
}
if (GoodsReceipt::query()->where('purchase_order_id', $order->id)->where('delivery_note', $deliveryNote)->exists()) {
throw ValidationException::withMessages(['delivery_note' => 'Esta guia já foi confirmada nesta ordem. Consulte o histórico em vez de repetir a recepção.']);
}
if ($order->status !== 'issued' || $data['received_on'] < substr((string) $order->getRawOriginal('issued_at'), 0, 10)) {
throw ValidationException::withMessages(['received_on' => 'A recepção deve referir uma ordem emitida e não pode anteceder a sua emissão.']);
}
$requisition = Requisition::query()->findOrFail($order->requisition_id);
$this->conflicts->assertParticipation($user, $requisition);
$this->conflicts->assertProcess($requisition, $order->supplier_id, $user);
$warehouse = ! empty($data['warehouse_id']) ? Warehouse::query()->whereKey($data['warehouse_id'])->lockForUpdate()->firstOrFail() : null;
$ordered = $order->items()->orderBy('id')->lockForUpdate()->get()->keyBy('id');
$lines = [];
$seen = [];
$acceptedTotal = 0;
foreach ($inputs as $input) {
$source = $ordered->get($input['purchase_order_item_id']);
if (! $source || in_array($source->id, $seen, true)) {
throw ValidationException::withMessages(['items' => 'As linhas devem ser distintas e pertencer à ordem de compra.']);
}
$seen[] = $source->id;
$received = $input['received_milli'];
$accepted = $input['accepted_milli'];
$previous = $this->recordedQuantity($source->id, 'received_milli');
if ($received <= 0 || $accepted < 0 || $accepted > $received || $previous + $received > self::milli($source->quantity)) {
throw ValidationException::withMessages(['items' => 'Quantidade inválida ou superior à quantidade pendente autorizada na ordem.']);
}
if (($input['quality_status'] === 'compliant' && $accepted !== $received) || ($input['quality_status'] === 'nonconforming' && $accepted !== 0)) {
throw ValidationException::withMessages(['items' => 'Conforme exige aceitar a quantidade recebida; Não conforme exige rejeitá-la integralmente. Use Conforme com reservas para aceitação parcial.']);
}
if ($input['quality_status'] !== 'compliant' && empty($input['notes'])) {
throw ValidationException::withMessages(['items' => 'Descreva as reservas, danos ou divergências de qualidade.']);
}
$stockItem = ! empty($input['stock_item_id']) ? StockItem::query()->lockForUpdate()->findOrFail($input['stock_item_id']) : null;
$physical = in_array($source->purchase_type, ['consumable', 'other', 'spare_part']);
if ($source->purchase_type === 'spare_part') {
if (! $source->spare_part_id || ! $source->equipment_id) {
throw ValidationException::withMessages(['items' => 'Peça sem associação autorizada na ordem. A recepção está bloqueada.']);
}
$part = app(EquipmentWorkflow::class)->linkedPart((int) $source->spare_part_id, (int) $source->equipment_id, $requisition->department_id);
if ($accepted > 0 && $stockItem?->id !== $part->stock_item_id) {
throw ValidationException::withMessages(['items' => 'A peça recebida deve usar o artigo de stock autorizado na ordem.']);
}
}
if (! $physical && $source->purchase_type !== 'service') {
throw ValidationException::withMessages(['items' => 'Este tipo de artigo exige controlos adicionais ainda não implementados.']);
}
if ($physical && $accepted > 0 && (! $warehouse || ! $stockItem || Str::lower(trim($stockItem->unit)) !== Str::lower(trim($source->unit)))) {
throw ValidationException::withMessages(['items' => 'Para bens aceites, indique armazém e artigo de stock com a mesma unidade da ordem. Não há conversões automáticas.']);
}
if (! $physical && $stockItem !== null) {
throw ValidationException::withMessages(['items' => 'Serviços não geram existências nem recebem artigo de stock.']);
}
$acceptedTotal += $accepted;
$lines[] = [
'tenant_id' => $user->tenant_id, 'purchase_order_item_id' => $source->id,
'stock_item_id' => $stockItem?->id, 'received_milli' => $received, 'accepted_milli' => $accepted,
'rejected_milli' => $received - $accepted, 'quality_status' => $input['quality_status'], 'notes' => $input['notes'],
'snapshot' => [
'order_item' => $source->only(['id', 'description', 'unit', 'purchase_type', 'quantity']),
'stock_item' => $stockItem?->only(['id', 'code', 'name', 'unit']),
'warehouse' => $warehouse?->only(['id', 'code', 'name']),
'physical' => $physical,
'equipment_id' => $source->equipment_id, 'spare_part_id' => $source->spare_part_id,
],
];
}
$receipt = GoodsReceipt::query()->create([
'tenant_id' => $user->tenant_id, 'purchase_order_id' => $order->id, 'received_by' => $user->id, 'warehouse_id' => $warehouse?->id,
'idempotency_key' => $data['idempotency_key'], 'payload_hash' => $hash, 'delivery_note' => $deliveryNote,
'received_on' => $data['received_on'], 'status' => 'partial', 'confirmed_at' => now(),
'snapshot' => ['order' => $order->only(['id', 'number']), 'supplier' => $order->snapshot['supplier'], 'receiver' => $user->only(['id', 'name']), 'warehouse' => $warehouse?->only(['id', 'code', 'name']), 'development_only' => true, 'budget_checked' => false],
]);
foreach ($lines as $line) {
$item = $receipt->items()->create($line);
if ($line['accepted_milli'] > 0 && $line['snapshot']['physical']) {
StockMovement::query()->create([
'tenant_id' => $user->tenant_id, 'goods_receipt_item_id' => $item->id, 'stock_item_id' => $line['stock_item_id'],
'warehouse_id' => $warehouse?->id, 'moved_by' => $user->id, 'quantity_milli' => $line['accepted_milli'], 'moved_at' => now(),
'equipment_id' => $line['snapshot']['equipment_id'], 'spare_part_id' => $line['snapshot']['spare_part_id'],
'snapshot' => [...$line['snapshot'], 'receipt_id' => $receipt->id, 'order_number' => $order->number, 'delivery_note' => $deliveryNote],
]);
}
}
$progress = $this->progress($order);
$status = $acceptedTotal === 0 ? 'rejected' : ($progress['state'] === 'complete' ? 'complete' : 'partial');
// Complete the reference/status before exposing this append-only confirmation.
DB::table('goods_receipts')->where('id', $receipt->id)->update(['number' => sprintf('REC-%s-%06d', now()->format('Y'), $receipt->id), 'status' => $status]);
$receipt->refresh();
$receipt->load('items');
$this->audit->audit($user, 'receipt.confirmed', $requisition, null, ['receipt' => $receipt->toArray(), 'order_progress' => $progress]);
return $receipt;
});
}
}
+15 -2
View File
@@ -27,9 +27,10 @@ class RequisitionWorkflow
$items = [];
$subtotal = 0;
$tax = 0;
/** @var list<array{description: string, category: string, purchase_type: string, quantity: string, unit: string, unit_price: string, tax_rate: string}> $lines */
/** @var list<array{description: string, category: string, purchase_type: string, quantity: string, unit: string, unit_price: string, tax_rate: string, equipment_id?: int, spare_part_id?: int, production_area?: string, downtime_started_at?: string|null}> $lines */
$lines = $data['items'];
foreach ($lines as $line) {
app(EquipmentWorkflow::class)->line($line, (int) $user->department_id, $data['priority']);
$price = BigDecimal::of($line['unit_price'])->multipliedBy(100)->toScale(0)->toInt();
$lineSubtotal = BigDecimal::of($line['quantity'])->multipliedBy($price)->toScale(0, RoundingMode::HalfUp)->toInt();
$lineTax = BigDecimal::of($lineSubtotal)->multipliedBy($line['tax_rate'])->dividedBy(100, 0, RoundingMode::HalfUp)->toInt();
@@ -37,6 +38,7 @@ class RequisitionWorkflow
'tenant_id' => $user->tenant_id,
'description' => $line['description'], 'category' => $line['category'],
'purchase_type' => $line['purchase_type'], 'quantity' => $line['quantity'], 'unit' => $line['unit'],
'equipment_id' => $line['equipment_id'] ?? null, 'spare_part_id' => $line['spare_part_id'] ?? null, 'production_area' => $line['production_area'] ?? null, 'downtime_started_at' => $line['downtime_started_at'] ?? null,
'unit_price_minor' => $price, 'tax_rate' => $line['tax_rate'],
'subtotal_minor' => $lineSubtotal, 'tax_minor' => $lineTax, 'total_minor' => $lineSubtotal + $lineTax,
];
@@ -71,16 +73,21 @@ class RequisitionWorkflow
$requisition = Requisition::query()->lockForUpdate()->findOrFail($requisition->id);
abort_unless($requisition->requester_id === $user->id && $requisition->status === 'draft', 403);
app(ConflictGuard::class)->assertParticipation($user, $requisition);
foreach ($requisition->items()->get() as $item) {
app(EquipmentWorkflow::class)->line($item->toArray(), $requisition->department_id, $requisition->priority);
}
app(EquipmentWorkflow::class)->assertTechnical($requisition);
if ($requisition->needed_by < today()) {
throw ValidationException::withMessages(['submission' => 'Actualize a data de entrega antes de submeter.']);
}
$tenant = Tenant::query()->findOrFail($user->tenant_id);
app(BudgetWorkflow::class)->record($user, $requisition, 'reserve', $requisition->total_minor, $requisition->subtotal_minor);
$amount = $tenant->approval_includes_tax ? $requisition->total_minor : $requisition->subtotal_minor;
$roles = ['department_head'];
if ($amount > $tenant->first_limit_minor) {
$roles[] = 'procurement';
}
if ($amount > $tenant->second_limit_minor) {
if ($amount > $tenant->second_limit_minor || $requisition->items()->where('purchase_type', 'equipment')->exists()) {
$roles[] = 'finance';
}
foreach ($roles as $position => $role) {
@@ -99,11 +106,17 @@ class RequisitionWorkflow
$requisition = Requisition::query()->lockForUpdate()->findOrFail($requisition->id);
$requisition->load('steps');
abort_unless($requisition->canDecide($user), 403);
if ($decision === 'approved') {
app(EquipmentWorkflow::class)->assertTechnical($requisition);
}
$step = $requisition->steps->firstWhere('decision', 'pending');
abort_if($step === null, 409);
$step->update(['decision' => $decision, 'approver_id' => $user->id, 'comment' => $comment, 'decided_at' => now()]);
$status = $decision === 'rejected' ? 'rejected' : ($requisition->steps()->where('decision', 'pending')->exists() ? 'pending' : 'approved');
$requisition->update(['status' => $status]);
if ($decision === 'rejected') {
app(BudgetWorkflow::class)->record($user, $requisition, 'release');
}
$this->audit($user, 'approval.'.$decision, $requisition, ['status' => 'pending'], ['status' => $status, 'step_id' => $step->id, 'role' => $step->role, 'comment' => $comment]);
});
}
+110
View File
@@ -0,0 +1,110 @@
<?php
namespace App\Services;
use App\Enums\PurchasingRole;
use App\Models\Equipment;
use App\Models\SparePart;
use App\Models\StockItem;
use App\Models\StockMovement;
use App\Models\StockOperation;
use App\Models\User;
use App\Models\Warehouse;
use Brick\Math\BigDecimal;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException;
class StockWorkflow
{
/** @return array{quantity: int, version: int} */
public function balance(int $item, int $warehouse): array
{
$query = StockMovement::query()->where('stock_item_id', $item)->where('warehouse_id', $warehouse);
return ['quantity' => BigDecimal::of((string) (clone $query)->sum('quantity_milli'))->toInt(), 'version' => (int) $query->max('id')];
}
/** @param array{kind: string, reference: string, idempotency_key: string, responsible_id: int, warehouse_id: int, stock_item_id: int, destination_warehouse_id?: int, quantity: string, reason: string, destination?: string, count_id?: int, ledger_version?: int, equipment_id?: int} $data */
public function record(User $actor, array $data): StockOperation
{
abort_unless($actor->tenant_id !== null && $actor->purchasing_role === PurchasingRole::Warehouse && auth()->id() === $actor->id, 403);
return DB::transaction(function () use ($actor, $data) {
// Same first lock as receipts: includes empty balances and concurrent receipts.
app(ConflictGuard::class)->lockCompany($actor);
$hash = hash('sha256', json_encode($data, JSON_THROW_ON_ERROR));
$existing = StockOperation::query()->where('idempotency_key', $data['idempotency_key'])->first();
if ($existing) {
if ($existing->payload_hash !== $hash) {
throw ValidationException::withMessages(['idempotency_key' => 'Chave já utilizada com dados diferentes.']);
}
return $existing;
}
if (StockOperation::query()->where('reference', $data['reference'])->exists()) {
throw ValidationException::withMessages(['reference' => 'Referência já registada. Consulte o histórico.']);
}
$responsible = User::query()->where('tenant_id', $actor->tenant_id)->findOrFail($data['responsible_id']);
$warehouse = Warehouse::query()->findOrFail($data['warehouse_id']);
$item = StockItem::query()->findOrFail($data['stock_item_id']);
$equipment = $data['kind'] === 'issue' && isset($data['equipment_id']) ? Equipment::query()->findOrFail($data['equipment_id']) : null;
$part = $data['kind'] === 'issue' ? SparePart::query()->where('stock_item_id', $item->id)->first() : null;
if ($part) {
if (! $equipment) {
throw ValidationException::withMessages(['equipment_id' => 'Seleccione o equipamento de destino associado à peça.']);
}
app(EquipmentWorkflow::class)->linkedPart($part->id, $equipment->id);
}
$destination = $data['kind'] === 'transfer' ? Warehouse::query()->findOrFail($data['destination_warehouse_id'] ?? 0) : null;
if ($destination?->id === $warehouse->id) {
throw ValidationException::withMessages(['destination_warehouse_id' => 'Escolha outro armazém da mesma empresa.']);
}
$balance = $this->balance($item->id, $warehouse->id);
$quantity = ReceiptWorkflow::milli($data['quantity']);
$delta = -$quantity;
$count = null;
if ($data['kind'] === 'count') {
if (($data['ledger_version'] ?? -1) !== $balance['version']) {
throw ValidationException::withMessages(['ledger_version' => 'Existem movimentos posteriores. Actualize o saldo e repita a contagem física.']);
}
$delta = 0;
} elseif ($data['kind'] === 'adjustment') {
$count = StockOperation::query()->where('kind', 'count')->findOrFail($data['count_id'] ?? 0);
if ($count->stock_item_id !== $item->id || $count->warehouse_id !== $warehouse->id || $count->ledger_version !== $balance['version'] || StockOperation::query()->where('count_id', $count->id)->exists()) {
throw ValidationException::withMessages(['count_id' => 'Contagem já ajustada, incompatível ou desactualizada. Faça nova contagem após movimentos.']);
}
$quantity = $count->quantity_milli;
$delta = $quantity - $balance['quantity'];
if ($delta === 0) {
throw ValidationException::withMessages(['count_id' => 'Contagem sem divergência; não há ajuste a efectuar.']);
}
}
if ($balance['quantity'] + $delta < 0) {
throw ValidationException::withMessages(['quantity' => 'Stock insuficiente. A operação não pode produzir saldo negativo.']);
}
$operation = StockOperation::query()->create([
'tenant_id' => $actor->tenant_id, 'created_by' => $actor->id, 'responsible_id' => $responsible->id,
'warehouse_id' => $warehouse->id, 'destination_warehouse_id' => $destination?->id, 'stock_item_id' => $item->id,
'count_id' => $count?->id, 'kind' => $data['kind'], 'reference' => $data['reference'], 'idempotency_key' => $data['idempotency_key'],
'equipment_id' => $equipment?->id, 'spare_part_id' => $part?->id,
'payload_hash' => $hash, 'destination' => $data['destination'] ?? null, 'reason' => $data['reason'],
'quantity_milli' => $quantity, 'theoretical_milli' => $balance['quantity'], 'ledger_version' => $balance['version'], 'recorded_at' => now(),
'snapshot' => ['actor' => $actor->only(['id', 'name']), 'responsible' => $responsible->only(['id', 'name']), 'stock_item' => $item->only(['id', 'code', 'name', 'unit']), 'warehouse' => $warehouse->only(['id', 'code', 'name']), 'destination_warehouse' => $destination?->only(['id', 'code', 'name']), 'equipment' => $equipment?->toArray(), 'spare_part' => $part?->toArray(), 'difference_milli' => $quantity - $balance['quantity'], 'budget_checked' => false, 'development_only' => true],
]);
if ($delta !== 0) {
$this->movement($actor, $operation, $warehouse->id, $delta, $data['kind'] === 'transfer' ? 'transfer_out' : $data['kind']);
if ($destination) {
$this->movement($actor, $operation, $destination->id, $quantity, 'transfer_in');
}
}
app(RequisitionWorkflow::class)->audit($actor, 'stock.'.$data['kind'], null, null, $operation->toArray());
return $operation;
});
}
private function movement(User $actor, StockOperation $operation, int $warehouse, int $quantity, string $type): void
{
StockMovement::query()->create(['tenant_id' => $actor->tenant_id, 'stock_operation_id' => $operation->id, 'stock_item_id' => $operation->stock_item_id, 'warehouse_id' => $warehouse, 'equipment_id' => $operation->equipment_id, 'spare_part_id' => $operation->spare_part_id, 'moved_by' => $actor->id, 'movement_type' => $type, 'quantity_milli' => $quantity, 'snapshot' => [...$operation->snapshot, 'warehouse' => Warehouse::query()->findOrFail($warehouse)->only(['id', 'code', 'name']), 'reference' => $operation->reference, 'reason' => $operation->reason], 'moved_at' => now()]);
}
}
+100
View File
@@ -0,0 +1,100 @@
<?php
namespace App\Services;
use App\Enums\PurchasingRole;
use App\Models\Supplier;
use App\Models\SupplierBankDetail;
use App\Models\SupplierBankReview;
use App\Models\User;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException;
class SupplierBankWorkflow
{
private function actor(User $user, Supplier $supplier): void
{
abort_unless(auth()->id() === $user->id && $user->tenant_id !== null && $supplier->tenant_id === $user->tenant_id, 403);
if (app(ConflictGuard::class)->hasConflict($user->id, $supplier->id, null)) {
throw ValidationException::withMessages(['bank' => 'Conflito de interesses com este fornecedor.']);
}
}
/** @param array<string,mixed> $data */
public function propose(User $user, Supplier $supplier, array $data): SupplierBankDetail
{
$this->actor($user, $supplier);
abort_unless($user->purchasing_role === PurchasingRole::Procurement, 403);
return DB::transaction(function () use ($user, $supplier, $data) {
app(ConflictGuard::class)->lockCompany($user);
$supplier = Supplier::query()->lockForUpdate()->findOrFail($supplier->id);
$this->actor($user, $supplier);
$latest = SupplierBankDetail::query()->where('supplier_id', $supplier->id)->latest('revision')->first();
if ((int) $data['previous_id'] !== ($latest->id ?? 0)) {
throw ValidationException::withMessages(['previous_id' => 'Dados bancários alterados. Reabra a ficha antes de propor outra versão.']);
}
$detail = SupplierBankDetail::query()->create(['tenant_id' => $user->tenant_id, 'supplier_id' => $supplier->id, 'created_by' => $user->id, 'revision' => ($latest->revision ?? 0) + 1, ...array_intersect_key($data, array_flip(['bank_name', 'country', 'currency', 'beneficiary', 'account_identifier', 'evidence_reference', 'reason'])), 'created_at' => now()]);
app(RequisitionWorkflow::class)->audit($user, 'supplier.bank_proposed', null, null, ['supplier_id' => $supplier->id, 'bank_detail_id' => $detail->id, 'revision' => $detail->revision]);
return $detail;
});
}
public function review(User $user, SupplierBankDetail $detail, string $decision, string $reason): void
{
abort_unless($user->purchasing_role === PurchasingRole::Finance && $detail->tenant_id === $user->tenant_id && $detail->created_by !== $user->id, 403);
if (! in_array($decision, ['approved', 'rejected']) || trim($reason) === '') {
throw ValidationException::withMessages(['bank' => 'Decisão e fundamento obrigatórios.']);
}
DB::transaction(function () use ($user, $detail, $decision, $reason) {
app(ConflictGuard::class)->lockCompany($user);
$supplier = Supplier::query()->lockForUpdate()->findOrFail($detail->supplier_id);
$this->actor($user, $supplier);
$latest = SupplierBankDetail::query()->where('supplier_id', $supplier->id)->latest('revision')->firstOrFail();
if ($latest->id !== $detail->id) {
throw ValidationException::withMessages(['bank' => 'Versão substituída. Reveja os dados bancários actuais.']);
}
$existing = SupplierBankReview::query()->where('supplier_bank_detail_id', $detail->id)->where('reviewed_by', $user->id)->first();
if ($existing) {
if ($existing->decision !== $decision || $existing->reason !== $reason) {
throw ValidationException::withMessages(['bank' => 'A decisão anterior é imutável. Proponha nova versão para corrigir dados.']);
}
return;
}
if (! $supplier->eligible() || SupplierBankReview::query()->where('supplier_bank_detail_id', $detail->id)->where('decision', 'rejected')->exists() || SupplierBankReview::query()->where('supplier_bank_detail_id', $detail->id)->count() >= 2) {
throw ValidationException::withMessages(['bank' => 'Fornecedor não elegível ou versão já decidida.']);
}
SupplierBankReview::query()->create(['tenant_id' => $user->tenant_id, 'supplier_bank_detail_id' => $detail->id, 'reviewed_by' => $user->id, 'decision' => $decision, 'reason' => $reason, 'created_at' => now()]);
app(RequisitionWorkflow::class)->audit($user, 'supplier.bank_'.$decision, null, null, ['supplier_id' => $supplier->id, 'bank_detail_id' => $detail->id]);
});
}
/** Re-evaluate inside the payment transaction in the future; UI readiness is not authorisation. */
public function state(Supplier $supplier): string
{
$detail = SupplierBankDetail::query()->where('supplier_id', $supplier->id)->latest('revision')->first();
if (! $detail) {
return 'missing';
}
$reviews = SupplierBankReview::query()->where('supplier_bank_detail_id', $detail->id)->get();
if ($reviews->contains('decision', 'rejected')) {
return 'rejected';
}
if ($reviews->count() < 2) {
return 'pending';
}
if (! $supplier->eligible() || app(ConflictGuard::class)->hasConflict($detail->created_by, $supplier->id, null)) {
return 'blocked';
}
foreach ($reviews as $review) {
$user = User::query()->where('tenant_id', $supplier->tenant_id)->find($review->reviewed_by);
if (! $user || $user->purchasing_role !== PurchasingRole::Finance || $user->id === $detail->created_by || app(ConflictGuard::class)->hasConflict($user->id, $supplier->id, null)) {
return 'blocked';
}
}
return 'approved';
}
}
+1
View File
@@ -24,6 +24,7 @@ return Application::configure(basePath: dirname(__DIR__))
]);
})
->withExceptions(function (Exceptions $exceptions): void {
$exceptions->dontFlash(['account_identifier', 'beneficiary', 'evidence_reference', 'reason']);
$exceptions->shouldRenderJsonWhen(
fn (Request $request) => $request->is('api/*') || $request->expectsJson(),
);
@@ -0,0 +1,84 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
public function up(): void
{
Schema::create('warehouses', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->string('code', 30);
$table->string('name', 200);
$table->timestamps();
$table->unique(['tenant_id', 'code']);
});
Schema::create('stock_items', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->string('code', 30);
$table->string('name', 200);
$table->string('unit', 30);
$table->timestamps();
$table->unique(['tenant_id', 'code']);
});
Schema::create('goods_receipts', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('purchase_order_id')->constrained()->restrictOnDelete();
$table->foreignId('received_by')->constrained('users')->restrictOnDelete();
$table->foreignId('warehouse_id')->nullable()->constrained()->restrictOnDelete();
$table->string('number')->nullable()->unique();
$table->uuid('idempotency_key');
$table->string('payload_hash', 64);
$table->string('delivery_note', 100);
$table->date('received_on');
$table->string('status');
$table->json('snapshot');
$table->timestamp('confirmed_at');
$table->unique(['purchase_order_id', 'idempotency_key']);
$table->unique(['purchase_order_id', 'delivery_note']);
});
Schema::create('goods_receipt_items', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('goods_receipt_id')->constrained()->restrictOnDelete();
$table->foreignId('purchase_order_item_id')->constrained()->restrictOnDelete();
$table->foreignId('stock_item_id')->nullable()->constrained()->restrictOnDelete();
$table->unsignedBigInteger('received_milli');
$table->unsignedBigInteger('accepted_milli');
$table->unsignedBigInteger('rejected_milli');
$table->string('quality_status');
$table->text('notes')->nullable();
$table->json('snapshot');
$table->unique(['goods_receipt_id', 'purchase_order_item_id']);
});
Schema::create('stock_movements', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('goods_receipt_item_id')->unique()->constrained()->restrictOnDelete();
$table->foreignId('stock_item_id')->constrained()->restrictOnDelete();
$table->foreignId('warehouse_id')->constrained()->restrictOnDelete();
$table->foreignId('moved_by')->constrained('users')->restrictOnDelete();
$table->string('movement_type')->default('receipt_in');
$table->unsignedBigInteger('quantity_milli');
$table->json('snapshot');
$table->timestamp('moved_at');
$table->index(['tenant_id', 'stock_item_id', 'warehouse_id']);
});
}
public function down(): void
{
Schema::dropIfExists('stock_movements');
Schema::dropIfExists('goods_receipt_items');
Schema::dropIfExists('goods_receipts');
Schema::dropIfExists('stock_items');
Schema::dropIfExists('warehouses');
}
};
@@ -0,0 +1,47 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
public function up(): void
{
Schema::create('stock_operations', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->foreignId('responsible_id')->constrained('users')->restrictOnDelete();
$table->foreignId('warehouse_id')->constrained()->restrictOnDelete();
$table->foreignId('destination_warehouse_id')->nullable()->constrained('warehouses')->restrictOnDelete();
$table->foreignId('stock_item_id')->constrained()->restrictOnDelete();
$table->foreignId('count_id')->nullable()->unique()->constrained('stock_operations')->restrictOnDelete();
$table->string('kind');
$table->string('reference', 100);
$table->uuid('idempotency_key');
$table->string('payload_hash', 64);
$table->string('destination', 200)->nullable();
$table->text('reason');
$table->bigInteger('quantity_milli');
$table->bigInteger('theoretical_milli')->nullable();
$table->unsignedBigInteger('ledger_version')->nullable();
$table->json('snapshot');
$table->timestamp('recorded_at');
$table->unique(['tenant_id', 'reference']);
$table->unique(['tenant_id', 'idempotency_key']);
});
Schema::table('stock_movements', function (Blueprint $table) {
$table->unsignedBigInteger('goods_receipt_item_id')->nullable()->change();
$table->bigInteger('quantity_milli')->change();
$table->foreignId('stock_operation_id')->nullable()->constrained()->restrictOnDelete();
$table->unique(['stock_operation_id', 'warehouse_id']);
});
}
public function down(): void
{
// Signed ledger entries must never be coerced back to unsigned quantities.
throw new LogicException('Migração de histórico irreversível; preservar movimentos e usar migrações aditivas.');
}
};
@@ -0,0 +1,85 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
public function up(): void
{
Schema::create('criticality_levels', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->string('code', 30);
$table->string('name', 150);
$table->text('criteria');
$table->boolean('is_critical');
$table->timestamp('created_at');
$table->unique(['tenant_id', 'code']);
});
Schema::create('equipment', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->foreignId('department_id')->constrained()->restrictOnDelete();
$table->foreignId('stock_item_id')->nullable()->constrained()->restrictOnDelete();
$table->foreignId('criticality_level_id')->constrained()->restrictOnDelete();
$table->string('code', 30);
$table->string('description', 255);
$table->string('area', 200);
$table->string('serial_number', 100)->nullable();
$table->string('status', 30);
$table->unsignedInteger('version')->default(1);
$table->timestamps();
$table->unique(['tenant_id', 'code']);
});
Schema::create('spare_parts', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->foreignId('stock_item_id')->unique()->constrained()->restrictOnDelete();
$table->foreignId('criticality_level_id')->constrained()->restrictOnDelete();
$table->unsignedBigInteger('minimum_milli');
$table->unsignedInteger('version')->default(1);
$table->timestamps();
});
Schema::create('equipment_spare_parts', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('equipment_id')->constrained('equipment')->restrictOnDelete();
$table->foreignId('spare_part_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->timestamp('created_at');
$table->unique(['equipment_id', 'spare_part_id']);
});
Schema::create('technical_reviews', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('requisition_id')->constrained()->restrictOnDelete();
$table->foreignId('reviewed_by')->constrained('users')->restrictOnDelete();
$table->string('basis_hash', 64);
$table->string('decision', 30);
$table->text('reason');
$table->json('snapshot');
$table->timestamp('reviewed_at');
$table->unique(['requisition_id', 'basis_hash']);
});
foreach (['stock_operations', 'stock_movements', 'requisition_items', 'purchase_order_items'] as $name) {
Schema::table($name, function (Blueprint $table) {
$table->foreignId('equipment_id')->nullable()->constrained('equipment')->restrictOnDelete();
$table->foreignId('spare_part_id')->nullable()->constrained()->restrictOnDelete();
});
}
Schema::table('requisition_items', function (Blueprint $table) {
$table->string('production_area', 200)->nullable();
$table->timestamp('downtime_started_at')->nullable();
});
}
public function down(): void
{
throw new LogicException('Preservar cadastro, associações e decisões técnicas; usar migrações aditivas.');
}
};
@@ -0,0 +1,43 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
public function up(): void
{
Schema::create('budgets', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('cost_center_id')->constrained()->restrictOnDelete();
$table->unsignedSmallInteger('year');
$table->bigInteger('amount_minor');
$table->boolean('includes_tax');
$table->text('reason');
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->foreignId('approved_by')->nullable()->constrained('users')->restrictOnDelete();
$table->timestamp('approved_at')->nullable();
$table->timestamps();
$table->unique(['tenant_id', 'cost_center_id', 'year']);
});
Schema::create('budget_entries', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('budget_id')->constrained()->restrictOnDelete();
$table->foreignId('requisition_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->string('kind');
$table->bigInteger('reserved_minor');
$table->bigInteger('committed_minor');
$table->timestamp('created_at');
$table->unique(['requisition_id', 'kind']);
});
}
public function down(): void
{
throw new LogicException('Preservar dotações e movimentos orçamentais.');
}
};
@@ -0,0 +1,55 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
public function up(): void
{
Schema::create('invoices', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('purchase_order_id')->constrained()->restrictOnDelete();
$table->foreignId('supplier_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->foreignId('validated_by')->nullable()->constrained('users')->restrictOnDelete();
$table->string('number', 100);
$table->date('issued_on');
$table->string('status')->default('pending');
$table->bigInteger('subtotal_minor');
$table->bigInteger('tax_minor');
$table->bigInteger('total_minor');
$table->json('snapshot');
$table->timestamp('validated_at')->nullable();
$table->timestamps();
$table->unique(['tenant_id', 'supplier_id', 'number']);
});
Schema::create('invoice_items', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('invoice_id')->constrained()->restrictOnDelete();
$table->foreignId('purchase_order_item_id')->constrained()->restrictOnDelete();
$table->bigInteger('quantity_milli');
$table->bigInteger('subtotal_minor');
$table->bigInteger('tax_minor');
$table->json('snapshot');
$table->unique(['invoice_id', 'purchase_order_item_id']);
});
Schema::create('budget_consumptions', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('budget_id')->constrained()->restrictOnDelete();
$table->foreignId('invoice_id')->unique()->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->bigInteger('amount_minor');
$table->timestamp('created_at');
});
}
public function down(): void
{
throw new LogicException('Preservar facturas, conferências e consumo.');
}
};
@@ -0,0 +1,43 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
public function up(): void
{
Schema::create('supplier_bank_details', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('supplier_id')->constrained()->restrictOnDelete();
$table->foreignId('created_by')->constrained('users')->restrictOnDelete();
$table->unsignedInteger('revision');
$table->string('bank_name', 200);
$table->string('country', 2);
$table->string('currency', 3);
$table->text('beneficiary');
$table->text('account_identifier');
$table->text('evidence_reference');
$table->text('reason');
$table->timestamp('created_at');
$table->unique(['supplier_id', 'revision']);
});
Schema::create('supplier_bank_reviews', function (Blueprint $table) {
$table->id();
$table->foreignId('tenant_id')->constrained()->restrictOnDelete();
$table->foreignId('supplier_bank_detail_id')->constrained()->restrictOnDelete();
$table->foreignId('reviewed_by')->constrained('users')->restrictOnDelete();
$table->string('decision');
$table->text('reason');
$table->timestamp('created_at');
$table->unique(['supplier_bank_detail_id', 'reviewed_by']);
});
}
public function down(): void
{
throw new LogicException('Preservar versões bancárias e validações.');
}
};
+30
View File
@@ -0,0 +1,30 @@
{
"tested_at_utc": "2026-10-28T12:32:47+00:00",
"separate_database": true,
"transport": "Independent PHP service transactions and PostgreSQL connections",
"scenarios": [
{
"name": "distinct_approvals",
"passed": true,
"overlapping_lock_waits": 2,
"state": "approved",
"review_count": 2
},
{
"name": "same_approval",
"passed": true,
"overlapping_lock_waits": 2,
"state": "pending",
"review_count": 1
},
{
"name": "competing_revisions",
"passed": true,
"overlapping_lock_waits": 2,
"state": "pending",
"review_count": 0
}
],
"passed": true,
"test_database_dropped": true
}
+16
View File
@@ -0,0 +1,16 @@
{
"verified_at_utc": "2026-10-28T12:33:53+00:00",
"migration": "2026_10_28_000011_create_supplier_bank_details",
"batch": 12,
"backup_created": true,
"backup_bytes": 230372,
"restore_verified": true,
"restored_tables": 42,
"restore_database_dropped": true,
"business_records_unchanged": true,
"existing_constraints_preserved": true,
"env_unchanged": true,
"bank_details_count": 0,
"bank_reviews_count": 0,
"operational_validation": false
}
+54 -60
View File
@@ -1,76 +1,70 @@
# Consolidação do ProcuraFlow
# Compatibilidade e estado do SGC
Estado verificado em 28 de Outubro de 2026.
Estado actualizado em 28 de Outubro de 2026. Projecto activo: C:\laragon\www\compras, Laravel + React + PostgreSQL, http://127.0.0.1:8015. Preservar conta, dados, configuração, cookie e porta. SGF Tempo e Investmoz são independentes. A implementação Python separada fica apenas como referência; não importar contas, sessões ou bases experimentais.
## Projecto activo
| Área | Implementado no Laravel | Pendente |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Acesso e organização | Fortify, conta, empresa, equipa, departamentos e centros de custo | MFA obrigatório e ciclo completo de acessos |
| Requisições e aprovações | Rascunhos, cálculos exactos, etapas, segregação e snapshots | Validação empresarial das regras provisórias |
| Fornecedores | Cadastro, edição, renovação, validação independente e anexos privados | Dados bancários com dupla validação |
| Cotações | Propostas, avaliações e matriz comparativa | Multimoeda e revisão das propostas |
| RF-AF-01 | Declarações pessoais, histórico e ConflictGuard no servidor | Política de periodicidade, validade e levantamento |
| Adjudicação | Escolha fundamentada, revalidação e aprovação do valor final | Excepções, revisão e cancelamento sem política ficam bloqueados |
| Ordens | Emissão única/idempotente, snapshots, consulta e impressão | Orçamento não validado; documentos de desenvolvimento |
| Recepção | Parcial/total, qualidade, divergências, pendentes, segregação do emitente e auditoria | Substituições e anexos; rejeições não autorizam receber acima do total |
| Stock | Artigos, armazéns, entradas, saídas fundamentadas, transferências atómicas, contagens e ajustes auditados por empresa | Revisão visual, reposição e conversões |
| Equipamentos e peças | Cadastro, compatibilidade, mínimos, alertas, validação técnica e rastreabilidade | Regra de investimento; adjudicação/emissão de equipamento bloqueadas |
| Orçamento | Dotação por empresa/centro/exercício, aprovação independente, reservas e compromissos | Revisão visual, reforços e validação operacional integral |
| Facturas e pagamentos | Registo por empresa, conferência, validação independente e consumo orçamental | Dados bancários, pagamentos, notas de crédito e anexos |
| Início e navegação | Página inicial própria, menus por área/perfil e consulta pública por módulo | Revisão visual |
| Auditoria | Histórico das operações implementadas | Exportações, retenção e protecção contra SQL administrativo |
O projecto activo é `C:\laragon\www\compras`, em Laravel, React, TypeScript,
Inertia e PostgreSQL, em http://127.0.0.1:8015. A conta já foi criada.
Preservar `APP_URL=http://127.0.0.1:8015`, `SERVER_PORT=8015`,
`SESSION_COOKIE=procuraflow_session` e `SESSION_DRIVER=database`.
O SGF Tempo é independente.
Preservar enums, políticas, modelos relacionais, Brick Math e isolamento por empresa. As regras guardadas nos snapshots não são substituídas pela configuração actual. Ausência de conflito não anula conflito registado. Exemplos públicos fictícios não dão acesso aos dados de negócio.
A implementação Python/React na pasta de outputs da conversa fica descontinuada
como aplicação executável e preservada apenas como referência. Não importar
contas sintéticas, bases SQLite, sessões ou palavras-passe. Não executar os seus
servidores ou contentores. O iniciador antigo passa a indicar o endereço do projecto Laravel, sem iniciar outro servidor.
## Verificação actual
## Compatibilidade funcional
Facturas e consumo entregues: migração 000010 aplicada no lote 11 após backup e
restauro verificados de 39 tabelas. Três cenários concorrentes PostgreSQL e
22 testes de facturas aprovados. Suite completa actual: **298 aprovados,
3 ignorados, 2.449 asserções**. Novas tabelas vazias na base real. Revisão visual,
dados bancários, pagamentos, reforços e regras de investimento continuam pendentes.
| Área | Base a preservar | Adaptação da referência experimental |
| ------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| Acesso | Fortify, conta existente, sessões e equipa | Não transportar login Python nem contas fictícias |
| Organização | Empresa, departamentos, centros de custo e isolamento | Aplicar o mesmo isolamento nos novos módulos |
| Requisições | Rascunhos editáveis, validações, relações e numeração | Acrescentar funções sem substituir as existentes |
| Aprovações | RequisitionWorkflow, perfis, etapas e snapshots | Adaptar cenários e testes adicionais |
| Valores | Brick Math e centavos | Não importar o armazenamento genérico JSON |
| Fornecedores e cotações | Cadastro, validação, propostas e comparação implementados no Laravel | Adaptados com tabelas próprias, isolamento, centavos e auditoria existentes |
| Ordens, recepções e facturas | Ainda ausentes nesta base | Adaptar estados, recepções parciais e conferência |
| Stock, equipamentos e orçamento | Ainda ausentes nesta base | Adaptar movimentos, mínimos, inventários e compromissos |
| Relatórios e auditoria | Indicadores e histórico existentes | Adaptar exportação e controlos adicionais |
### Histórico da aplicação do orçamento
A consolidação inicial definiu a base única de continuidade. Posteriormente,
fornecedores e cotações foram adaptados ao Laravel; os restantes módulos
experimentais continuam por implementar nesta base.
Actualização de orçamento: cadastro e aprovação independente de dotações por
empresa/centro/exercício, com base de IVA explícita, reservas, libertações e
compromissos implementados. Migração 000009 aplicada no lote 10 após backup e
restauro verificados de 37 tabelas. Cinco cenários concorrentes PostgreSQL
aprovados; 14 testes de orçamento passaram com 40 asserções. Não foram criadas
dotações na base real. Facturas, reforços, pagamentos e validação operacional
integral continuam pendentes. Ver [relatório actual](desenvolvimento.md).
## Diferenças a resolver em cada adaptação
### Referência anterior à aplicação do orçamento
- Laravel aplica provisoriamente escalões com IVA; o protótipo Python usava sem
IVA. Preservar a configuração existente e snapshots, até decisão de Finanças.
- Perfis e estados têm identificadores diferentes: usar os enums e políticas
Laravel, sem criar perfis concorrentes.
- Preservar as tabelas relacionais e o isolamento por empresa. Não importar a
tabela JSON genérica do protótipo.
- Manter a edição de rascunhos e a gestão da equipa já existentes no Laravel.
- Não apresentar funcionalidades ainda ausentes como implementadas nem considerar
o protótipo uma validação para compras reais.
Referência consolidada: `75ffdb3`, com **262 testes aprovados, 3 ignorados e
2.327 asserções**. Nova verificação dirigida de equipamentos, adjudicação,
ordens e navegação: **87 testes aprovados, 1.163 asserções**. As onze migrações,
incluindo 000008 no lote 9, foram confirmadas aplicadas por `migrate:status`.
As páginas públicas inicial, consulta, equipamentos, recepções, stock e operações
responderam HTTP 200. Os acessos sem sessão a equipamentos, recepções, stock e
ordens responderam 302 para login. Estes resultados não são revisão visual.
## Verificação
O navegador voltou a reportar `The browser access host is unavailable`.
Revisão visual pública, autenticada e de impressão permanece pendente.
Orçamento e facturas não estão implementados; as regras empresariais ainda
estão por definir. A [proposta de regras financeiras](proposta-regras-financeiras.md)
é um documento para decisão, não uma aprovação. **O orçamento continua sem validação.**
Sete cenários PostgreSQL de stock constam da evidência histórica, incluindo
saída de peça com equipamento; não foram novamente executados nesta revisão.
- Página de entrada em 8015: HTTP 200 e texto “Entrar no ProcuraFlow”.
- Testes Laravel: 47 passaram, 3 ignorados, 219 asserções.
- Testes em SQLite em memória, conforme phpunit.xml; não na base real.
- Nenhuma conta, credencial ou dado real foi alterado nesta consolidação.
## Histórico da entrega de stock anterior aos equipamentos
## Adaptação de fornecedores e cotações
Na implementação, 233 testes passaram, 3 ignorados, 2.163 asserções em SQLite em memória; PHPStan, Pint, frontend, TypeScript e compilação aprovados. **Migrações até 000007 efectivamente aplicadas na base actual; 000007 no lote 8, sem migrações pendentes.** Antes da aplicação foi criado backup custom PostgreSQL e restaurado com sucesso numa base temporária exclusiva, depois eliminada. Contagens e hashes das 31 tabelas anteriores coincidiram antes/depois; restrições existentes preservadas. Mantêm-se 1 utilizador, 1 empresa, 1 departamento e 1 centro de custo. Sem seeds, recriação de contas ou movimentos fictícios; `stock_movements` e `stock_operations` vazias. `.env` inalterado. [Evidência da migração e recuperação](stock-migracao-000007.json).
A migração aditiva `2026_10_28_000002_create_suppliers_and_quotations` criou
suppliers, quotations, quotation_items e proposal_evaluations no PostgreSQL.
A comparação dos registos antes e depois confirmou que utilizadores, empresas,
departamentos, centros de custo, requisições, linhas e aprovações permaneceram
inalterados. Não foram criadas contas ou dados sintéticos na base real.
Backup privado: `storage/app/private/backups/stock-000007-20261028-111943-4deef2/`, com `database.dump`, manifesto, cópia do ambiente e instruções de recuperação para uma base nova. Nenhuma restauração foi feita sobre a base actual. A migração acrescenta a tabela e ligação de operações, relaxa a obrigatoriedade da recepção e preserva os valores existentes; o PostgreSQL já utilizava `bigint` assinado. `down()` permanece bloqueado para proteger o histórico.
Validações: 54 testes passaram, 3 ignorados, 305 asserções; análise estática PHP,
tipos TypeScript, formatação e compilação da interface aprovadas.
Quatro cenários simultâneos de recepção passaram numa base PostgreSQL separada, eliminada no final: excesso, repetição, quantidades complementares e guia duplicada. [Evidência](recepcao-concorrencia-postgresql.json). Não constitui teste de carga ou de concorrência dos outros módulos.
Âmbito: cadastro e validação de fornecedores, propostas por requisição aprovada,
preços em MZN, IVA herdado, avaliação independente e indicação de completude
da matriz. Os módulos usam a conta/sessão Laravel existente. O navegador abriu
a entrada na porta 8015; a inspecção visual das páginas autenticadas fica
dependente do início de sessão do utilizador. Não foi pedida nem alterada a senha.
Seis cenários simultâneos de stock aprovados em PostgreSQL separado, eliminado no final: excesso de saídas, repetição de saída/transferência/ajuste, transferências opostas e ajuste desactualizado. [Evidência](stock-concorrencia-postgresql.json). Apenas Armazém executa; Administração, Procurement e Finanças consultam. Contagens não movimentam stock; ajustes fundamentados exigem contagem compatível e sem movimentos posteriores. Periodicidade, tolerâncias e investigação/resolução das divergências exigem decisão da empresa; não foi inventado um circuito de aprovação.
Edição/renovação de fornecedores e anexos privados foram acrescentados no
incremento descrito em [desenvolvimento.md](desenvolvimento.md). Continuam
pendentes dados bancários, registo anual de conflitos, adjudicação, ordens,
recepção e restantes módulos. Os resultados anteriores acima referem-se à
adaptação inicial; consultar o relatório de desenvolvimento para a validação actual.
Após a aplicação, `/consulta/operacoes-stock` respondeu HTTP 200 e `/stock/operacoes` redireccionou para login (302) no cliente sem sessão. Os resultados desta secção são históricos. A entrega posterior de equipamentos substitui as antigas indicações de que esse módulo ainda não tinha sido iniciado. Resultados e limitações em [desenvolvimento.md](desenvolvimento.md).
+15 -16
View File
@@ -1,21 +1,20 @@
# Consulta livre para revisão visual
# Página inicial e consulta livre
A entrada `/` encaminha para `/consulta`, uma demonstração pública sem login,
criada a pedido do utilizador para avaliar navegação, ecrãs e cores.
A entrada `/` apresenta uma página inicial própria, com acesso à demonstração e ao login. A área autenticada tem menus agrupados por área e perfil.
O ecrã usa exclusivamente exemplos fictícios locais e não consulta registos de
negócio. Não permite gravar, aprovar, adjudicar ou descarregar documentos reais.
As rotas operacionais mantêm autenticação e as permissões existentes. A conta,
os dados e a configuração da empresa foram preservados.
A demonstração sem login usa endereços próprios, permitindo actualizar e usar o histórico do navegador:
Implementação: `routes/preview.php` e `resources/js/pages/preview/index.tsx`.
O login oferece também uma ligação à demonstração. A página não usa o layout
autenticado e não recebe a identidade do utilizador nas propriedades públicas.
- `/consulta`: visão geral.
- `/consulta/requisicoes`, `/consulta/fornecedores` e `/consulta/cotacoes`.
- `/consulta/conflitos` e `/consulta/ordens`.
- `/consulta/recepcoes`: entregas parciais, qualidade, divergências e pendentes fictícios.
- `/consulta/stock`: existências, pesquisa e detalhe de movimentos fictícios.
- `/consulta/operacoes-stock`: saídas, transferências, contagens físicas e ajustes fictícios; formulário apenas de simulação.
- `/consulta/equipamentos`: equipamentos, peças, criticidade e mínimos fictícios, compatibilidades, saída rastreável e formulários sem escrita.
- `/consulta/aparencia`: apresentação visual.
Ao desenvolver novos módulos, manter a demonstração identificada como fictícia.
Os exemplos de ordens são ilustrativos; não constituem prova de implementação
do fluxo operacional. Não substituir os controlos de acesso por acesso anónimo.
Todos os exemplos são locais e fictícios. Os formulários demonstrativos não gravam nem consultam dados de negócio. As rotas operacionais mantêm autenticação e permissões. As propriedades públicas não incluem a identidade do utilizador, mesmo quando já tem sessão iniciada.
Validação: quatro testes dirigidos passaram, com 41 asserções, incluindo a
entrada livre, ausência de identidade e manutenção da autenticação nas rotas
de negócio. Revisão visual no navegador pendente por falha da ligação de controlo.
Implementação em routes/preview.php, resources/js/pages/home.tsx e resources/js/pages/preview/. A conta, dados e configuração foram preservados. Ordens, recepção e stock reais existem separadamente; exemplos públicos não constituem validação do fluxo ou do orçamento.
Os testes HTTP/Inertia verificam a página inicial, os endereços por módulo, ausência de identidade e protecção das operações. Resultados em [desenvolvimento.md](desenvolvimento.md). Após aplicação da migração 000007, `/consulta/operacoes-stock` voltou a responder HTTP 200. Revisão visual pública e autenticada continuam pendentes: a tentativa de acesso ao navegador devolveu `The browser access host is unavailable`, sem permitir verificar uma sessão autenticada. HTTP 200 não constitui revisão visual.
+278 -4
View File
@@ -1,4 +1,278 @@
# Desenvolvimento do ProcuraFlow
# Desenvolvimento do SGC
## Facturas, conferência e consumo orçamental
Implementado `/facturas`: Administração consulta; Finanças regista e outra pessoa
de Finanças valida. Número normalizado único por empresa/fornecedor. Conferência
exacta de quantidade, unidade, preço, IVA e totais com a ordem congelada e a
recepção aceite ainda não facturada. Serviços também exigem aceitação.
Diferenças impedem registo/validação, sem correcção automática do documento.
Facturação parcial com arredondamento acumulado por linha para preservar os
centavos e IVA da ordem. Validação revalida quantidades e conflitos dentro da
transacção com bloqueio da empresa; repetição não duplica lançamentos. Sem
compromisso aprovado do exercício actual, a factura permanece pendente. Na
validação, a parcela facturada converte compromisso em consumo. O disponível
desconta reservas, compromisso remanescente e consumo, sem duplicar despesa
ou libertar saldo ao facturar. Falha de auditoria reverte toda a operação.
Cada documento, orçamento e configuração pertence à empresa correspondente.
A base com/sem IVA é a escolhida pela empresa; não existem dotações globais.
Autores de facturas integram os intervenientes auditados do processo. Facturas,
linhas e consumos não admitem reescrita/eliminação pelos modelos.
`/consulta/facturas` apresenta somente exemplos fictícios, sem consultar ou
gravar dados de negócio; os valores não são configurações predefinidas.
### Verificação e aplicação
**22 testes de facturas aprovados, 82 asserções**: independência, isolamento,
valores, duplicação, concorrência lógica de pendentes, auditoria/rollback,
compromisso obrigatório, serviços, consumo e arredondamento parcial de IVA.
Suite completa actual: **298 aprovados, 3 ignorados e 2.449 asserções**.
PHPStan, Pint, TypeScript, compilação e verificação frontend aprovados.
Três cenários concorrentes PostgreSQL aprovados: excesso de facturação, mesma
validação e facturas complementares. Duas ligações em processos PHP independentes,
observadas simultaneamente à espera de bloqueios, por cenário. Saldos, consumo
e número de facturas validadas confirmados. Base temporária eliminada.
São testes de serviço, não HTTP ou carga.
[Evidência](facturas-concorrencia-postgresql.json).
Migração 000010 aplicada no **lote 11** após backup custom PostgreSQL de
**216.008 bytes** e restauro verificado de **39 tabelas** numa base temporária,
depois eliminada. Dump e manifesto partilharam um snapshot consistente.
Registos de negócio, restrições anteriores e `.env` preservados. Novas tabelas
de facturas, linhas e consumos vazias; sem seeds, contas novas ou alteração de
credenciais. Backup e manifesto privados, fora do Git.
[Evidência sem dados privados](facturas-migracao-000010.json).
### Limitações e próximo passo
Pagamentos, dados bancários com dupla validação, reforços, notas de crédito,
anexos de factura, adiantamentos, compras sem ordem e operações cambiais não
estão implementados. Facturas entre exercícios ou sem compromisso ficam
bloqueadas. Conferência alterada por outra factura bloqueia a validação; ainda
não existe correcção/substituição do registo pendente.
Nova tentativa de acesso ao navegador: `The browser access host is unavailable`.
**Revisão visual pública, autenticada e de impressão continua pendente.**
Não constitui validação operacional integral do orçamento nem autorização de
compras/pagamentos reais. Próximo passo: dados bancários com dupla validação,
antes de pagamentos; reforços e regras de investimento configuráveis por empresa.
Equipamento continua bloqueado para adjudicação/emissão sem regra própria.
## Aplicação e validação PostgreSQL do orçamento
- Migração 000009 aplicada à base actual no **lote 10**, sem migrações pendentes.
Backup custom PostgreSQL 17 de 206.615 bytes em armazenamento privado;
manifesto privado com hashes e instruções de recuperação. O dump e o manifesto
partilharam um snapshot consistente. Restauro verificado em base temporária:
**37 tabelas** coincidiram em contagens e hashes. Base de restauro eliminada.
- Registos de negócio anteriores e restrições preservados; `.env` inalterado.
Nenhuma conta, dotação ou movimento financeiro foi criado na base real.
As tabelas `budgets` e `budget_entries` permanecem vazias. Sessões, caches
e filas não integram a comparação de negócio, pois podem variar com os acessos.
[Evidência sem dados privados](orcamento-migracao-000009.json).
- **Cinco cenários concorrentes PostgreSQL aprovados**: excesso de reservas,
mesma reserva, mesmo compromisso, mesma libertação e excesso na adjudicação.
Duas transacções de serviço em processos PHP e ligações independentes por
cenário, observadas simultaneamente à espera de bloqueios. Saldos exactos e
ausência de duplicações confirmados. Base exclusiva de teste eliminada.
Isto não é teste HTTP, de carga ou de todos os fluxos financeiros.
[Evidência](orcamento-concorrencia-postgresql.json).
- Reforçada a autorização no serviço: autor autenticado, empresa do processo,
transacção obrigatória e bloqueio da empresa. Dotação já aprovada não admite
reescrita nem eliminação pelo modelo. Corrigida a legenda da dotação para
respeitar a base com/sem IVA escolhida pela empresa.
- **14 testes de orçamento aprovados, 40 asserções**, incluindo submissão real
sem saldo e rollback, submissão/reserva seguida de rejeição/libertação,
isolamento no serviço e imutabilidade da dotação aprovada.
- Suite completa concluída: **275 aprovados, 3 ignorados e 2.364 asserções**;
inclui os 13 casos de orçamento existentes no início dessa execução. O caso
adicional de imutabilidade foi validado depois no conjunto de 14 acima.
PHPStan, Pint, TypeScript, compilação e formatação/lint frontend aprovados.
- `/` e `/consulta/equipamentos` responderam HTTP 200; `/orcamentos` sem sessão
respondeu 302 para login. Nova tentativa de acesso ao navegador devolveu
`The browser access host is unavailable`. **Revisão visual pública, autenticada
e de impressão permanece pendente.**
Cada empresa mantém dotações e base de IVA próprias; não existem valores
monetários de orçamento comuns a todos os clientes. Centros sem dotação continuam
no circuito de desenvolvimento sem controlo orçamental. Facturas, consumo validado,
reforços, pagamentos e regras próprias de investimento não estão implementados.
**A validação operacional integral do orçamento permanece pendente**, embora
as reservas e compromissos tenham sido testados e a migração esteja aplicada.
## Histórico do primeiro incremento de orçamento
## Primeiro incremento de orçamento por empresa
Implementados cadastro de dotação anual por empresa/centro de custo, montantes
explícitos em centavos MZN e escolha obrigatória da base com/sem IVA. Preparação
e aprovação por pessoas distintas de Administração/Finanças. Sem valores de
dotação predefinidos. A configuração pertence exclusivamente à empresa actual.
Reservas na submissão, ajuste na adjudicação, libertação na rejeição e conversão
em compromisso na emissão reutilizam a transacção e o bloqueio por empresa.
Movimentos imutáveis, idempotência por processo/operação e auditoria transaccional.
Dotação pendente ou insuficiente bloqueia operações no centro/exercício configurado.
Centros sem dotação preservam o fluxo anterior de desenvolvimento, explicitamente
sem controlo orçamental. Não há activação global implícita para todos os clientes.
O snapshot mantém `budget_checked=false`, acrescentando a referência ao controlo
efectuado; não constitui validação financeira completa ou autorização de compra real.
Interface em `/orcamentos`, restrita a Administração e Finanças. Não existem
reforços, edição de dotações, facturas, pagamentos ou migração financeira de
processos anteriores. Os limites de investimento continuam por definir por empresa;
equipamentos permanecem bloqueados para adjudicação/emissão.
Migração aditiva 000009 preparada e testada apenas em SQLite isolado; **não aplicada
à base real**. Exige backup/restauro verificado antes da aplicação. Não foram
alteradas contas, configurações, credenciais ou dados de negócio. Dez testes novos
passaram, com 27 asserções; PHPStan e TypeScript aprovados. Revisão visual e
concorrência PostgreSQL deste módulo continuam pendentes. **O orçamento continua
sem validação operacional.**
## Validação das pendências após consolidação
Recolhido o resultado final da nova execução dirigida: **87 testes aprovados,
1.163 asserções**, abrangendo equipamentos/peças, adjudicação/ordens e navegação.
Não substitui o resultado da suite completa consolidada de 262 aprovados e 3
ignorados. Onze migrações confirmadas aplicadas, sem pendentes. Seis entradas
públicas responderam HTTP 200; quatro rotas protegidas responderam 302 para login.
O acesso ao navegador continua indisponível (`The browser access host is unavailable`).
A revisão visual pública, autenticada e de impressão não foi concluída.
O utilizador confirmou que as regras financeiras estão por definir. Foi preparada
uma [proposta de regras](proposta-regras-financeiras.md) para decisão empresarial,
sem activar orçamento, facturas ou desbloquear investimentos. **O orçamento
continua sem validação.** Corrigido o mapa de compatibilidade que ainda descrevia
equipamentos como não iniciados.
## Revisão e consolidação — 28 de Outubro de 2026
- Recolhido o resultado final da execução da suite: **262 testes aprovados,
3 ignorados e 2.327 asserções**, em 71,928 segundos. Os testes usam SQLite
em memória; esta revisão não repetiu os ensaios PostgreSQL históricos.
- PHPStan e Pint aprovados. TypeScript e compilação de produção aprovados.
Corrigida a formatação da evidência JSON da migração 000008.
- Confirmada no código a marca Sistema de Gestão de Compras (SGC) na página
inicial e SGC no logótipo, demonstração, painel, títulos e impressão.
A configuração existente e o cookie de sessão foram preservados.
- Revistos os diffs da integração e os controlos de perfis, isolamento,
validação técnica, recepção e movimentos. Actualizados README e continuidade
para distinguir funcionalidades entregues de instruções históricas.
- **Revisão visual não concluída**: o controlo do computador foi interrompido
porque não conseguiu determinar com confiança o URL actual do navegador.
Não foi validado o aspecto dos ecrãs públicos, autenticados ou da impressão.
A compilação e os testes não substituem essa revisão.
## Incremento de equipamentos e peças — 28 de Outubro de 2026
Implementado no mesmo projecto `C:\laragon\www\compras`, porta 8015, após consulta de procurement.docx (2.2, 2.3, 3.0, RF-AF-07/08, RNF-17/18, 6.6 e decisões de 10.0), documentação e módulos existentes. Preservadas as alterações locais, incluindo a actualização paralela da marca visível para SGC. Não foram alterados outros projectos nem recriadas contas.
### Entregue
- `/equipamentos`: cadastro de código, descrição, área/linha, departamento, série, estado, criticidade e artigo de stock opcional. Fichas de equipamento e peças podem ser actualizadas com versão obrigatória para impedir sobrescrita de uma ficha entretanto alterada. Cada criação/alteração gera auditoria com antes/depois. Não há eliminação pela interface.
- Criticidade configurada explicitamente por Administração: código, nome, critério escrito e indicação expressa de ser crítica ou não. **Sem categorias, critérios, escalões ou valores de mínimo predefinidos.** Os critérios são de acréscimo; criar outra categoria preserva o significado da anterior. Esta configuração não altera limites financeiros ou regras de aprovação. RF-AF-08 não foi dispensado: não foi disponibilizada edição de limites financeiros sem dupla aprovação administrativa.
- Cada peça reutiliza exactamente um artigo de stock, sem saldo separado. Referência, descrição e unidade vêm desse artigo; o artigo de uma peça existente não pode ser substituído. Mínimo explícito em milésimos, incluindo zero, e alerta visual quando a soma dos movimentos desse artigo nos armazéns da empresa fica **abaixo** do mínimo. Não é um mínimo por máquina/armazém. Estar abaixo do mínimo alerta, sem inventar uma proibição de consumo.
- Associações peça/equipamento dentro da empresa, permitindo a mesma peça em várias máquinas sem duplicar existências. Associações são de acréscimo e únicas por par; não há remoção destrutiva. Administração, Procurement e Armazém mantêm o cadastro; só Administração define categorias. Finanças consulta; chefes consultam os equipamentos, associações e saídas do seu departamento. As opções de requisição também respeitam o departamento. Só Armazém continua a executar movimentos.
- Nas saídas de artigos cadastrados como peça, o servidor exige equipamento de destino associado. A operação e o movimento guardam identificadores e snapshots de equipamento/peça no momento da saída. Alterar depois nome, mínimo ou criticidade não reescreve o movimento. Para outros artigos, equipamento de destino é opcional. Operações anteriores mantêm associações nulas, sem atribuições retroactivas inventadas.
- Requisições distinguem `equipment` e `spare_part`. Equipamento novo exige área/linha de produção. Peça exige cadastro, equipamento associado do departamento e unidade igual à do artigo. Peça crítica urgente exige início da paragem, registado explicitamente em UTC. Continua o circuito normal de três cotações; não foi criada dispensa automática por urgência.
- Validação técnica de equipamento na versão do rascunho, pelo responsável da área representado pelo perfil Chefe do departamento, distinto do solicitante. Aprovar ou rejeitar exige fundamento e fica num registo imutável, com hash da base, autor e snapshot. Pedido alterado invalida o aproveitamento da decisão, sem a apagar; formulário de decisão sobre versão antiga é recusado. Confirma-se novamente a elegibilidade e conflitos do revisor antes da submissão e das aprovações. Uma rejeição não permite submeter. Finanças integra o ciclo de aprovação de equipamento **para qualquer valor**, além dos escalões existentes. A validação técnica não substitui a aprovação financeira.
- **Adjudicação e emissão de equipamento continuam bloqueadas** porque o limite próprio de investimento e a sua regra de aplicação não foram definidos pela empresa. Não se inventou um valor nem se interpretou um limite indefinido como tecto ou autorização irrestrita. Nem validação técnica nem aprovação de Finanças removem este impedimento. As mensagens e ecrãs explicam o motivo.
- Peças com associações válidas seguem os escalões normais e o fluxo existente de cotações, adjudicação e ordens. A ordem congela os destinos e contexto de peça/equipamento; a recepção exige o artigo de stock autorizado e transmite os identificadores aos movimentos. A recepção não consome a peça na máquina: o consumo continua a exigir uma saída própria. O ensaio completo de compra, recepção e saída foi realizado apenas em fixtures isoladas.
- `/consulta/equipamentos`: equipamentos, peça crítica, alerta de mínimo, associações, histórico de saída e formulários fictícios de simulação. Não consulta nem grava dados de negócio. As novas opções de navegação preservam as entradas públicas e autenticadas anteriores.
### Verificação e aplicação da migração
- **262 testes aprovados, 3 ignorados, 2.327 asserções** na suite completa SQLite em memória. Inclui 28 casos de equipamentos/peças e um caso integrado adicional no conjunto de adjudicação/ordens: perfis, autoria, isolamento, associações, critérios/mínimos explícitos, versões, rastreabilidade congelada, validação técnica, rejeição, alteração de base, Finanças em qualquer valor, investimento bloqueado, início de paragem, rollback de auditoria e recepção/saída de peças.
- PHPStan, Pint, TypeScript e compilação de produção aprovados. Formatação/lint frontend e `git diff --check` verificados no fecho. Os resultados anteriores de outras entregas permanecem como histórico abaixo.
- **Sete cenários simultâneos PostgreSQL isolados aprovados**, incluindo o novo `spare_part_issue`: duas saídas para o equipamento associado disputam o saldo; uma confirma e outra é recusada por falta de stock. Os seis cenários anteriores também passaram com o novo esquema. Duas ligações independentes foram observadas simultaneamente à espera de bloqueio por cenário. A base temporária foi eliminada. Não é teste de carga nem validação de concorrência de todas as alterações do cadastro/decisões técnicas. [Evidência actualizada](stock-concorrencia-postgresql.json).
- Migração **`2026_10_28_000008_create_equipment_and_spare_parts` aplicada à base actual `compras_dev`, lote 9**. Todas as onze migrações executadas, sem pendentes. SQL revisto: apenas cria cinco tabelas novas e acrescenta colunas opcionais e chaves estrangeiras às tabelas existentes; não elimina, recria ou converte dados anteriores. `down()` recusa reversão destrutiva para preservar associações e decisões.
- Antes da aplicação: backup custom PostgreSQL 17 em `storage/app/private/backups/equipment-000008-20261028-113652-8b46ef/`, **177.950 bytes**, SHA-256 `3ff9f9a0f16975465ff008ff6ffaf34d9798d36e37fa946e44c6de39e62d6fdb`. Dump consistente, manifesto privado com hashes/contagens, cópia de ambiente e `RECUPERACAO.txt`. Restaurado com sucesso numa base nova `compras_restore_check_*`; as **32 tabelas** coincidiram em contagens e hashes. Base de verificação eliminada. Não havia documentos de fornecedor para copiar. O backup é privado, fora de `public/` e do Git; não publicar o seu conteúdo.
- Comparação imediatamente antes/depois da migração: todos os registos e colunas anteriores das 32 tabelas, e todas as restrições anteriores do esquema público, preservados. Mantêm-se 1 utilizador, 1 empresa, 1 departamento, 1 centro de custo e 1 registo de auditoria. A única nova linha foi a migração. As cinco tabelas novas e os movimentos/operações de stock permanecem vazios. **Sem seeds ou movimentos fictícios na base real.** [Evidência sem credenciais](equipamentos-migracao-000008.json).
- `.env` inalterado, SHA-256 `C9EE71EDBF3B4D303203DC851B9A15A9B687DEA1E83DD06B7B04B23054CA5BC5`. Conta, credenciais, configurações e porta preservadas. Os acessos HTTP normais podem criar/actualizar sessões; não são movimentos de negócio.
- `/consulta/equipamentos` respondeu HTTP 200; `/equipamentos` sem sessão redireccionou para login (302). **Revisão visual pública e autenticada continuam pendentes**: nova descoberta do navegador devolveu `The browser access host is unavailable`. Não foi possível inspeccionar a sessão existente nem validar visualmente os ecrãs. Testes HTTP/Inertia e compilação não são apresentados como revisão visual.
### Limitações e decisões ainda necessárias
**O orçamento ainda não é validado; os documentos de desenvolvimento não autorizam compras reais.** O limite próprio de investimento, a sua aplicação e eventuais escalões/documentos próprios para peças críticas precisam de decisão empresarial antes de desbloquear os caminhos correspondentes. Não há configuração fictícia de limite com semântica presumida. Regras de urgência/fornecedor único em escalão superior continuam sem excepção implementada; pedidos urgentes não dispensam os controlos normais.
Os critérios e mínimos têm de ser registados pelos perfis autorizados com base nas decisões da empresa. Não há classificação automática por texto ou correspondência automática de descrições de compras a artigos; a associação é explícita. O cadastro não cria entradas de stock, não capitaliza activos e não comprova a aquisição de um equipamento existente. Não há remoção/revisão de compatibilidades, reconciliação automática do legado, manutenção preventiva, notificações externas de mínimo, configuração de períodos de reposição/consumo anómalo ou relatório completo dos indicadores financeiros/paragens de 6.6. O alerta de mínimo é consultado no ecrã de equipamentos. Não foi acrescentada uma separação entre revisor técnico e aprovador departamental que a especificação não exige; mantêm-se a exclusão do solicitante e a segregação entre pessoas nas etapas financeiras existentes.
## Actualização da marca — 28 de Outubro de 2026
Nome visível actualizado para **Sistema de Gestão de Compras (SGC)** no início, entrada, navegação, demonstração, títulos e impressão. A documentação foi alinhada. Preservados os identificadores técnicos, incluindo `procuraflow_session`, a conta, porta 8015, base de dados, APP_KEY e `.env`. Esta alteração não aplica migrações nem modifica dados de negócio. Revisão visual continua pendente.
Verificação desta correcção: 13 testes dirigidos aprovados, 185 asserções; frontend sem erros de lint, TypeScript e compilação aprovados; `git diff --check` aprovado. Pesquisa das fontes e documentação não encontrou a marca antiga em textos visíveis; só permanece o identificador técnico de sessão. SHA-256 do `.env` inalterado.
## Fecho da entrega de stock: migração aplicada — 28 de Outubro de 2026
A migração `2026_10_28_000007_create_stock_operations` foi aplicada à base actual `compras_dev`, **lote 8**, após autorização expressa para concluir a entrega. `migrate:status` confirma todas as dez migrações executadas, sem pendentes. Não se avançou para equipamentos. As alterações locais sem commit foram preservadas.
- Revisão do PHP, do SQL de `migrate --pretend` e do esquema real: cria apenas a nova tabela `stock_operations`; acrescenta `stock_operation_id` opcional e respectivas restrições; torna opcional `goods_receipt_item_id`. No PostgreSQL, `quantity_milli` já era `bigint` assinado e permanece desse tipo, sem conversão estreitante. As cláusulas geradas de remoção de default/identity/comentário para essas duas colunas não removem metadados existentes: ambos já eram nulos/ausentes. A chave primária e a sua sequência não são alteradas. Todas as chaves estrangeiras e a unicidade da linha de recepção foram confirmadas após a aplicação. Não houve DROP/TRUNCATE/DELETE de tabelas ou registos existentes, nem recriação de tabelas. A restrição NOT NULL da recepção é relaxada para permitir os novos movimentos. A reversão `down()` continua bloqueada para preservar histórico.
- **Backup recuperável preparado e ensaiado antes da aplicação**, em `storage/app/private/backups/stock-000007-20261028-111943-4deef2/`. `database.dump`, formato custom PostgreSQL 17, 169.365 bytes; SHA-256 `5df038437e94870e80d1fab61e7d53223043b4167ded71eb52703db1c4d47942`. O dump usa um snapshot exportado consistente. A pasta privada contém também `manifest.json`, cópia do ambiente original e `RECUPERACAO.txt`; está excluída do Git e fora de `public/`. Não publicar o seu conteúdo. Não existiam documentos de fornecedor para copiar.
- O dump foi restaurado com `pg_restore --exit-on-error` numa base nova e exclusiva `compras_restore_check_*`. Contagens e hashes SHA-256 dos registos das **31 tabelas** coincidiram com a origem. A base de verificação foi eliminada; nenhuma restauração foi executada sobre a base actual. O dump inclui esquema, dados, sequências e ownership/ACL; as roles globais são as existentes no servidor. As instruções locais explicam a recuperação numa base nova, sem `--clean` e sem reversão destrutiva da base actual.
- Imediatamente antes e depois da migração, comparação de todas as linhas e colunas anteriores das 31 tabelas: **preservação integral**, incluindo utilizador, credenciais, empresa, equipa, auditoria, sessões e configuração persistida. A única linha adicional nesse momento foi o registo da migração, passando de 9 para 10. Mantiveram-se 1 utilizador, 1 empresa, 1 departamento, 1 centro de custo e 1 entrada de auditoria. Requisições, fornecedores, ordens, recepções, artigos e armazéns mantiveram zero registos; `stock_movements` e a nova `stock_operations` continuam com **zero movimentos/operações**. Não houve seeds ou dados fictícios. Os acessos HTTP subsequentes podem criar/actualizar sessões normais; não são movimentos de negócio.
- `.env` original inalterado, SHA-256 `C9EE71EDBF3B4D303203DC851B9A15A9B687DEA1E83DD06B7B04B23054CA5BC5`. Não se alteraram contas, credenciais, porta 8015 ou outros projectos. A aplicação usou apenas a migração 000007, com limites de espera de bloqueio e execução no processo de manutenção.
- `/consulta/operacoes-stock` respondeu HTTP 200. A rota operacional mantém redireccionamento para login quando não há sessão no cliente HTTP. **Revisão visual pública e autenticada continuam pendentes**: nesta tentativa, a descoberta do navegador devolveu `The browser access host is unavailable`, sem acesso às abas ou à sessão autenticada. Não foi apresentada a resposta HTTP como revisão visual. Não se efectuou login nem se alteraram credenciais.
Evidência sem credenciais em [stock-migracao-000007.json](stock-migracao-000007.json). O manifesto privado conserva os hashes e contagens por tabela. Os resultados anteriores de 233 testes, análise estática e seis cenários PostgreSQL continuam documentados abaixo; não foram repetidos nesta aplicação, que não alterou código funcional. A entrega está disponível no esquema actual, sujeita às permissões existentes; a aceitação visual permanece pendente.
**O orçamento continua sem validação.** Permanecem por decidir periodicidade, tolerâncias, investigação/resolução de divergências e eventual aprovação de ajustes. Equipamentos não foram iniciados.
## Implementação de saídas, transferências e inventários — 28 de Outubro de 2026
Consultadas as secções 2.2, 4.0, RF-AF-11, 5.3, RNF-18 e decisões da secção 10.0 de procurement.docx, README, compatibilidade e orientações de continuidade. Implementação no mesmo Laravel, porta 8015, sobre o catálogo, armazéns, movimentos e auditoria existentes. As alterações locais anteriores permanecem sem commit; recepção não foi reimplementada. As secções seguintes conservam o histórico das entregas anteriores.
- `/stock/operacoes`: saídas com destino, responsável da mesma empresa, documento único e fundamento obrigatório; transferências entre armazéns distintos da mesma empresa com débito e crédito atómicos. O saldo continua a ser a soma exacta dos movimentos em milésimos, agora com sinais. A listagem de stock apresenta os sinais, referências e ligações adequados para todos os movimentos.
- Inventários por artigo/armazém: contagem física, incluindo zero, saldo teórico, versão do histórico e diferença preservados. A contagem não altera existências. Um ajuste separado exige fundamento e contagem compatível ainda não ajustada, e lança exactamente a diferença. Divergência zero não gera movimento. Movimentos posteriores, incluindo recepções, invalidam a contagem para ajuste; o operador deve actualizar e repetir a contagem física. Formulários de contagem sobre uma versão antiga também são recusados.
- Apenas Recepção / Armazém executa estas operações, conforme a especificação; Administração, Procurement e Finanças consultam na própria empresa. Administração não substitui o perfil operacional. Autor real e responsável indicado ficam separados no snapshot. Não foi criada aprovação por Finanças, dupla contagem obrigatória ou proibição de o operador ser responsável: essas regras não constam da especificação para estes movimentos. As segregações de requisição/aprovação, emissão/recepção e recepção/pagamento dos módulos existentes mantêm-se.
- Bloqueio inicial da empresa partilhado com recepções, transacção única, unicidade de referência por empresa, chave idempotente com comparação de conteúdo e unicidade da contagem ajustada. Repetições idênticas devolvem o mesmo registo; referência repetida com nova chave ou chave com conteúdo diferente são recusadas. Falhar o crédito da transferência ou a auditoria reverte também o débito e a operação. Os modelos impedem edição/eliminação do histórico; SQL administrativo continua dependente das permissões da base.
- Migração aditiva `2026_10_28_000007_create_stock_operations`: nova tabela de operações, ligação opcional ao movimento, recepção opcional para novos tipos e quantidades assinadas. Conserva linhas existentes e as restrições de unicidade de recepção. Inicialmente testada apenas em bases isoladas; **aplicada posteriormente à base actual, lote 8, após backup com recuperação ensaiada**, conforme o fecho acima. A reversão destrutiva é explicitamente bloqueada para não converter movimentos negativos em quantidades sem sinal.
- `/consulta/operacoes-stock`: exemplos fictícios de saída, transferência, contagem e ajuste, formulário com alternância entre operações e simulação sem escrita ou leitura de negócio. Reutiliza a interface operacional. Ligação nos menus de armazém e na listagem de stock.
### Verificação efectuada neste incremento
- Suite completa: **233 testes aprovados, 3 ignorados, 2.163 asserções**, SQLite em memória. Os **25 testes novos** cobrem quantidades exactas, falta de saldo, idempotência incluindo formulários, referências repetidas, transferências, ajustes positivos/negativos/zero, contagens desactualizadas, perfis, recursos e consultas entre empresas, imutabilidade, demonstração e rollback de auditoria e da segunda metade da transferência.
- PHPStan, Pint e TypeScript aprovados; compilação de produção aprovada. `npm run check` aprovado em todos os ficheiros verificados, sem avisos ou erros; `git diff --check` sem erros. A formatação da evidência anterior de recepção foi normalizada, preservando o seu conteúdo.
- **Seis cenários simultâneos em PostgreSQL isolado aprovados**: excesso de saídas, mesma saída, mesma transferência, transferências opostas, mesmo ajuste e contagem desactualizada. Dois processos PHP independentes por cenário executam o kernel HTTP com duas ligações observadas simultaneamente à espera de bloqueio. Validam saldos e integridade das duas pernas das transferências. Isto não é teste de carga ou ensaio TCP. Evidência: [stock-concorrencia-postgresql.json](stock-concorrencia-postgresql.json); execução: `php tests/Concurrency/run-stock.php`.
- O ensaio reutiliza fixtures protegidas pelo prefixo `compras_receipts_test_*`, verifica a base e o alias de esquema antes de migrar, cria uma base exclusiva e elimina-a no final. A primeira tentativa revelou interferência entre dois aliases do processo de preparação; foi cancelada apenas a consulta nessa base temporária, que foi eliminada. A preparação usa agora um único alias, mantendo processos independentes para a concorrência. Outra tentativa identificou reutilização indevida da chave da contagem na fixture de ajuste; corrigida antes da execução aprovada. Nenhum destes resultados incompletos é apresentado como aprovação.
- HTTP 200 em `http://127.0.0.1:8015/consulta/operacoes-stock`. Testes Inertia confirmam propriedades públicas sem identidade nem dados de negócio. **Revisão visual pública não concluída:** a skill computer-use foi tentada, mas o serviço interrompeu o controlo por não conseguir determinar o URL do navegador com confiança. Revisão visual autenticada continua separadamente pendente; não foram pedidas nem alteradas credenciais.
- Sem seeds, migrações ou fixtures na base real. Contagem de utilizadores reais inalterada durante o ensaio. `.env` conserva SHA-256 `C9EE71EDBF3B4D303203DC851B9A15A9B687DEA1E83DD06B7B04B23054CA5BC5`; conta, configuração e outros projectos preservados.
### Limitações e decisões necessárias
**O orçamento ainda não é validado.** A interface mantém o aviso de desenvolvimento, sem autorizar compras reais. A migração 000007 já está aplicada; a revisão visual autenticada permanece pendente.
A empresa deve definir periodicidade de inventários, tolerâncias, quem investiga e resolve divergências e eventual circuito de aprovação dos ajustes. O ajuste aqui regista uma correcção fundamentada por Armazém; não equivale a aprovação financeira nem ao encerramento de uma investigação. Todas as diferenças são mostradas sem tolerância presumida. Não há aprovação automática por escalão, alertas de consumo anómalo com limites inventados, mínimos, reposição, equipamento/peça associado, conversões, devoluções, cancelamento ou edição de movimentos. O destino da saída é texto obrigatório; não valida uma requisição/equipamento nem substitui os futuros alertas RNF-18 para saídas sem essas ligações. Inventários são contagens pontuais por artigo/local, sem sessões de contagem em lote ou congelamento do armazém. Referências distintas e chaves distintas representam operações distintas; não há deduplicação heurística de documentos externos. Bloqueios serializam escritas por empresa; desempenho e carga não foram medidos.
## Incremento actual: recepção, stock e navegação
Implementado em 28 de Outubro de 2026, consultando procurement.docx, o mapa de compatibilidade e as orientações de continuidade. Os incrementos anteriores abaixo ficam como registo histórico; os seus números de testes e pendências descrevem a data respectiva.
- Página inicial própria em `/`, com acesso à demonstração e à entrada. A navegação autenticada está agrupada por área e perfil. A consulta pública passou a ter endereços por módulo, incluindo `/consulta/recepcoes` e `/consulta/stock`, preservando a página ao actualizar e navegar para trás. Os exemplos são fictícios, sem consultas a dados de negócio ou gravações.
- Recepções parciais e totais de ordens emitidas, quantidades recebidas, aceites, rejeitadas e pendentes por linha. Conferência conforme, com reservas ou não conforme; divergências exigem fundamento. O estado é derivado das recepções, sem reescrever a ordem congelada.
- Apenas Armazém confirma; o emitente da ordem fica impedido mesmo após mudar de perfil. `ConflictGuard` revalida a participação e os intervenientes anteriores. Consultas respeitam empresa, perfil e, para chefes, departamento; o formulário de Armazém não expõe os valores financeiros da ordem.
- Quantidades exactas em milésimos, sem aritmética de ponto flutuante. O recebido acumulado, incluindo rejeitados, não ultrapassa a quantidade autorizada. Uma rejeição não autoriza automaticamente uma substituição: esta política permanece por definir. O ecrã distingue falta de entrega de falta de aceitação.
- Catálogo de artigos e armazéns por empresa. Só as quantidades físicas aceites originam entradas, com unidade compatível e ligação única à linha da recepção. Serviços não movimentam stock. Existências calculadas a partir dos movimentos, com pesquisa e histórico.
- Transacções, bloqueios, chave de confirmação e unicidade da guia por ordem evitam duplicações. Repetir uma confirmação idêntica devolve o registo existente; alterar o conteúdo da mesma chave é bloqueado. Falhar a auditoria reverte toda a operação. Não existem rotas de edição/eliminação do histórico; os modelos também recusam essas alterações. A protecção contra SQL administrativo directo depende das permissões da base de dados.
- A migração aditiva `2026_10_28_000006_create_receipts_and_stock` está aplicada. Conta, configuração e módulos anteriores preservados; `.env` mantém o SHA-256 `C9EE71EDBF3B4D303203DC851B9A15A9B687DEA1E83DD06B7B04B23054CA5BC5`. Não foram executados seeds na base real, recriadas contas ou alterados SGF Tempo/Investmoz.
### Resultados verificados
- Suite Laravel: **208 passaram, 3 ignorados, 2.038 asserções**, em SQLite em memória. Inclui permissões, isolamento, segregação, limites, qualidade, repetição, auditoria e navegação pública.
- PHPStan sem erros; Pint, verificação/formatação frontend, TypeScript e compilação aprovados. `/`, `/consulta/recepcoes` e `/consulta/stock` responderam HTTP 200 na porta 8015.
- **Quatro cenários de concorrência real PostgreSQL passaram**: excesso acumulado, repetição da mesma confirmação, quantidades complementares e guia repetida. Processos PHP independentes executaram pedidos pelo kernel HTTP Laravel, com duas ligações simultaneamente à espera de bloqueio em cada cenário. Não se trata de teste de carga TCP. Evidência: [recepcao-concorrencia-postgresql.json](recepcao-concorrencia-postgresql.json).
- A base temporária foi criada com nome exclusivo `compras_receipts_test_*`, verificada antes das migrações e eliminada no final. Fixtures recusam bases de negócio. Uma primeira execução detectou uma ligação Schema em cache e falhou por tabela já existente; o isolamento foi corrigido para ambas as ligações e verificado antes de migrar, sem recriar tabelas existentes. A contagem de utilizadores reais permaneceu igual.
### Limitações e próximo passo
**O orçamento ainda não é validado.** Ordens e recepções continuam identificadas como desenvolvimento e não autorizam compras reais.
Revisão visual pública, autenticada e de impressão continua pendente: o serviço de controlo do navegador está indisponível. Os quatro cenários de concorrência de recepção foram efectivamente realizados; concorrência dos outros módulos e testes de carga permanecem pendentes.
Não foram implementados saídas, transferências, inventários, mínimos, devoluções/substituições, conversões de unidade ou anexos da recepção. Equipamentos e peças continuam dependentes das regras técnicas aprovadas. Próximo incremento funcional: orçamento e facturas, após definição das respectivas regras; completar os controlos de stock conforme prioridade da empresa. Não foram inventadas tolerâncias, excepções ou autorizações de substituição.
## Incremento actual de adjudicação e ordens de compra
@@ -36,7 +310,7 @@ Implementado em 28 de Outubro de 2026 no projecto Laravel existente, segundo a s
- PHPStan aprovado, sem erros; Pint aprovado em todos os ficheiros PHP; verificação frontend sem avisos ou erros; TypeScript aprovado; compilação aprovada; `git diff --check` sem erros.
- Migração aditiva `2026_10_28_000005_create_purchase_awards_and_orders` aplicada no PostgreSQL local após os testes. Contagens antes/depois iguais: 1 utilizador, 1 empresa e 0 requisições, fornecedores, cotações, avaliações, documentos e declarações de conflito. Novas tabelas de adjudicações, aprovações finais, ordens e linhas vazias. Não foram criados registos sintéticos na base real.
- O SHA-256 do `.env` manteve-se igual antes e depois. Não houve seeds, alterações de credenciais ou configuração, nem reinicialização de dados.
- As rotas de ordens/adjudicação estão registadas. O acesso sem autenticação a `/ordens` redireccionou para a entrada ProcuraFlow em 8015, com HTTP 200. As páginas autenticadas e o conteúdo da impressão foram verificados em testes HTTP/Inertia, não visualmente.
- As rotas de ordens/adjudicação estão registadas. O acesso sem autenticação a `/ordens` redireccionou para a entrada SGC em 8015, com HTTP 200. As páginas autenticadas e o conteúdo da impressão foram verificados em testes HTTP/Inertia, não visualmente.
Foram detectadas alterações paralelas na pré-visualização pública, na entrada e nas respectivas rotas/testes; foram preservadas e incluídas na verificação final, sem as apresentar como parte desta implementação. As alterações funcionais deste incremento permanecem limitadas à adjudicação/ordens e à integração necessária com os módulos anteriores.
@@ -83,7 +357,7 @@ Declarações pessoais de conflito de interesses na base Laravel e React existen
- PHPStan aprovado, sem erros; Pint aprovado; verificação frontend sem avisos ou erros; TypeScript aprovado; compilação aprovada; `git diff --check` sem erros. Os testes usam SQLite em memória, não a base de negócio.
- Migração aditiva `2026_10_28_000004_create_conflict_declarations` aplicada no PostgreSQL local depois dos testes. Contagens antes/depois preservadas: 1 utilizador, 1 empresa e 0 requisições, fornecedores, cotações, avaliações e documentos. A nova tabela está vazia; não foram criadas declarações sintéticas na base real.
- O SHA-256 do `.env` permaneceu igual antes e depois. Não houve seeds, recriação de contas, alteração de credenciais, reinicialização de dados ou mudanças de configuração.
- As quatro rotas de conflitos estão registadas. O acesso HTTP sem sessão a `/conflitos` redireccionou para a entrada ProcuraFlow na porta 8015, que respondeu HTTP 200. Isto não constitui revisão visual autenticada.
- As quatro rotas de conflitos estão registadas. O acesso HTTP sem sessão a `/conflitos` redireccionou para a entrada SGC na porta 8015, que respondeu HTTP 200. Isto não constitui revisão visual autenticada.
### Pendências e próximo passo
@@ -124,7 +398,7 @@ Migração `2026_10_28_000003_add_supplier_maintenance_and_documents`; `Supplier
- Testes Laravel: 74 passaram, 3 ignorados, 447 asserções. Cobrem edição, versões antigas, renovação, validação independente, MIME/extensão/tamanho, permissões, isolamento entre empresas, ligação documento/fornecedor, downloads auditados e reversão quando falha a auditoria.
- PHPStan sem erros; Pint aprovado; verificação frontend sem avisos ou erros; TypeScript e compilação aprovados; `git diff --check` sem erros.
- Migração aditiva `2026_10_28_000003` aplicada no PostgreSQL local depois dos testes. Contagens anteriores e posteriores iguais: 1 utilizador, 1 empresa, 0 requisições, 0 fornecedores, 0 cotações e 0 avaliações; nova tabela de documentos vazia. Não foram executados seeds, criadas contas ou alteradas credenciais/configuração.
- Entrada em http://127.0.0.1:8015/login confirmada com HTTP 200 e identificação ProcuraFlow; oito rotas de fornecedores registadas. As páginas autenticadas e as permissões foram verificadas nos testes Inertia; não foi feita inspecção visual autenticada no navegador.
- Entrada em http://127.0.0.1:8015/login confirmada com HTTP 200 e identificação SGC; oito rotas de fornecedores registadas. As páginas autenticadas e as permissões foram verificadas nos testes Inertia; não foi feita inspecção visual autenticada no navegador.
As verificações funcionais usam SQLite em memória e armazenamento simulado, sem ficheiros ou registos de teste na base real. A migração é a única escrita realizada na base real neste incremento.
+64
View File
@@ -0,0 +1,64 @@
{
"verified_at_utc": "2026-10-28T11:38:12+00:00",
"database": "compras_dev",
"migration": {
"migration": "2026_10_28_000008_create_equipment_and_spare_parts",
"batch": 9
},
"backup_directory": "storage\/app\/private\/backups\/equipment-000008-20261028-113652-8b46ef",
"backup_bytes": 177950,
"backup_sha256": "3ff9f9a0f16975465ff008ff6ffaf34d9798d36e37fa946e44c6de39e62d6fdb",
"restore_verified": true,
"restored_tables": 32,
"restore_database_dropped": true,
"existing_records_unchanged": true,
"existing_constraints_preserved": true,
"env_unchanged": true,
"stock_operations_count": 0,
"stock_movements_count": 0,
"existing_table_counts": {
"approval_steps": 0,
"audit_logs": 1,
"cache": 6,
"cache_locks": 0,
"conflict_declarations": 0,
"cost_centers": 1,
"departments": 1,
"failed_jobs": 0,
"goods_receipt_items": 0,
"goods_receipts": 0,
"job_batches": 0,
"jobs": 0,
"migrations": 10,
"password_reset_tokens": 0,
"proposal_evaluations": 0,
"purchase_award_approvals": 0,
"purchase_awards": 0,
"purchase_order_items": 0,
"purchase_orders": 0,
"quotation_items": 0,
"quotations": 0,
"requisition_items": 0,
"requisitions": 0,
"sessions": 16,
"stock_items": 0,
"stock_movements": 0,
"stock_operations": 0,
"supplier_documents": 0,
"suppliers": 0,
"tenants": 1,
"users": 1,
"warehouses": 0
},
"migration_rows_added": 1,
"new_table_counts": {
"equipment": 0,
"spare_parts": 0,
"criticality_levels": 0,
"equipment_spare_parts": 0,
"technical_reviews": 0
},
"budget_checked": false,
"visual_public_review": "pending_browser_access_host_unavailable",
"visual_authenticated_review": "pending_no_access_to_browser_session"
}
@@ -0,0 +1,33 @@
{
"tested_at_utc": "2026-10-28T12:19:17+00:00",
"separate_database": true,
"transport": "Independent PHP service transactions and PostgreSQL connections",
"scenarios": [
{
"name": "over_invoice",
"passed": true,
"overlapping_lock_waits": 2,
"consumed_minor": 6000,
"committed_minor": 4000,
"validated_invoices": 1
},
{
"name": "same_validation",
"passed": true,
"overlapping_lock_waits": 2,
"consumed_minor": 6000,
"committed_minor": 4000,
"validated_invoices": 1
},
{
"name": "complementary_invoices",
"passed": true,
"overlapping_lock_waits": 2,
"consumed_minor": 10000,
"committed_minor": 0,
"validated_invoices": 2
}
],
"passed": true,
"test_database_dropped": true
}
+16
View File
@@ -0,0 +1,16 @@
{
"verified_at_utc": "2026-10-28T12:21:41+00:00",
"migration": "2026_10_28_000010_create_invoices",
"batch": 11,
"backup_created": true,
"backup_bytes": 216008,
"restore_verified": true,
"restored_tables": 39,
"restore_database_dropped": true,
"business_records_unchanged": true,
"existing_constraints_preserved": true,
"env_unchanged": true,
"invoices_count": 0,
"budget_consumptions_count": 0,
"operational_validation": false
}
@@ -0,0 +1,44 @@
{
"tested_at_utc": "2026-10-28T12:11:20+00:00",
"separate_database": true,
"transport": "Independent PHP service transactions and PostgreSQL connections",
"scenarios": [
{
"name": "over_reserve",
"passed": true,
"overlapping_lock_waits": 2,
"reserved_minor": 6000,
"committed_minor": 0
},
{
"name": "same_reserve",
"passed": true,
"overlapping_lock_waits": 2,
"reserved_minor": 6000,
"committed_minor": 0
},
{
"name": "same_commit",
"passed": true,
"overlapping_lock_waits": 2,
"reserved_minor": 0,
"committed_minor": 6000
},
{
"name": "same_release",
"passed": true,
"overlapping_lock_waits": 2,
"reserved_minor": 0,
"committed_minor": 0
},
{
"name": "over_award",
"passed": true,
"overlapping_lock_waits": 2,
"reserved_minor": 8000,
"committed_minor": 0
}
],
"passed": true,
"test_database_dropped": true
}
+16
View File
@@ -0,0 +1,16 @@
{
"verified_at_utc": "2026-10-28T12:09:22+00:00",
"migration": "2026_10_28_000009_create_budgets",
"batch": 10,
"backup_created": true,
"backup_bytes": 206615,
"restore_verified": true,
"restored_tables": 37,
"restore_database_dropped": true,
"business_records_unchanged": true,
"existing_constraints_preserved": true,
"env_unchanged": true,
"budgets_count": 0,
"budget_entries_count": 0,
"operational_validation": false
}
+42 -1
View File
@@ -1,4 +1,45 @@
# Continuidade do desenvolvimento do ProcuraFlow
# Continuidade do desenvolvimento do SGC
## Próximo incremento após facturas
Orçamento e facturas já foram implementados e migrados, incluindo conferência
com recepções e consumo. Não repetir as instruções históricas abaixo.
Prosseguir com dados bancários de fornecedores com dupla validação antes de
pagamentos; reforços e regras de investimento ficam em etapas próprias.
Preservar isolamento por empresa e valores configurados por cada cliente.
Não inventar limites de investimento ou tratar os valores fictícios da
demonstração como configuração. Revisão visual pública, autenticada e de
impressão continua pendente por indisponibilidade do navegador. Consultar
`docs/desenvolvimento.md` para resultados e limitações actuais.
## Estado actual após equipamentos e peças
Recepção, stock, saídas, transferências, contagens, ajustes, equipamentos,
peças e validação técnica já estão implementados. As instruções anteriores
abaixo são históricas e não devem originar implementação duplicada.
O relatório actual está em `docs/desenvolvimento.md`. A revisão visual pública,
autenticada e de impressão continua pendente por indisponibilidade do controlo
do navegador. Antes de avançar para orçamento e facturas, definir as regras
empresariais correspondentes. Preservar as contas e os dados existentes.
## Próximo incremento após adjudicação e ordens
O utilizador já recebeu o relatório de adjudicação e ordens (165 testes
reportados como aprovados). Não repetir essa implementação. As secções
anteriores de adjudicação abaixo ficam como histórico.
Continuar com recepção e stock segundo procurement.docx: recepções parciais e
totais, conferência de qualidade, divergências, quantidades pendentes e movimentos
auditados. Aplicar segregação do emitente, permissões e isolamento por empresa;
impedir duplicação e quantidades superiores às autorizadas. Não inventar
políticas comerciais, tolerâncias ou autorizações de excepção.
Validar concorrência PostgreSQL em ambiente de teste separado, sem recriar a
base real. Actualizar a consulta livre com exemplos fictícios dos novos ecrãs.
Preservar conta, dados, configuração e módulos concluídos. Manter explícita a
ausência de validação orçamental e a restrição a documentos de desenvolvimento.
Actualizar o relatório e o mapa de compatibilidade, que ainda apresenta ordens
como ausentes. Se este incremento já estiver iniciado, continuar sem duplicação.
## Entrada livre para revisão visual
+100
View File
@@ -0,0 +1,100 @@
# Proposta de regras financeiras do SGC
Estado: proposta para decisão empresarial, ainda sem aprovação nem implementação.
Referência funcional: entrega `75ffdb3`. O orçamento continua sem validação.
Actualização: o utilizador autorizou avançar com a abordagem. Dotações, reservas,
compromissos e conferência de facturas/consumo foram implementados e migrados.
A base de IVA é uma decisão explícita de cada empresa. As secções seguintes
conservam a proposta original; não comprovam aprovação de limites monetários,
tolerâncias ou regras de investimento. Reforços e pagamentos continuam pendentes.
Estado actual em `docs/desenvolvimento.md`.
## Abordagem recomendada
Implementar primeiro orçamento e reservas; depois compromisso de ordens e
conferência de facturas. Pagamentos ficam para um incremento posterior.
Cada etapa exige testes e auditoria antes de permitir utilização operacional.
## Orçamento
- Exercício anual, por empresa e centro de custo, em MZN. Guardar os montantes
em centavos. Datas de início/fim são explícitas; não transportar saldos
automaticamente para outro exercício.
- Proposta inicial: controlar o total com IVA, por prudência de tesouraria.
Finanças deve confirmar esta base e a política de IVA antes da implementação.
- Dotação inicial e reforços exigem preparação e aprovação por duas pessoas
distintas da empresa, com fundamento, data e histórico. Nenhuma alteração
substitui os registos anteriores ou cria saldo por omissão.
- Disponível = dotação aprovada − reservas abertas − compromissos abertos
− consumo líquido validado. As três parcelas são mutuamente exclusivas para
cada quantidade/valor: converter entre elas não duplica a despesa.
- Rascunho não reserva. Submissão reserva a estimativa integral, dentro de
transacção, com verificação do disponível. Sem dotação válida ou saldo,
impedir submissão; não criar autorização de excesso automática.
- Rejeição definitiva liberta a reserva com movimento inverso auditado.
Edição de pedido submetido exige fluxo explícito de revisão, ainda por construir.
- Adjudicação ajusta a reserva ao valor final apenas após nova verificação do
saldo; redução liberta a diferença. As aprovações do valor final mantêm-se.
- Emissão converte reserva em compromisso, sem reduzir novamente o disponível.
Falha na emissão reverte toda a operação financeira e documental.
- Não permitir transferências entre centros de custo, cancelamentos, reabertura
ou passagem de exercício enquanto os respectivos fluxos não forem aprovados.
## Facturas
- Factura ligada a fornecedor, ordem emitida e empresa; identidade e número
normalizado únicos por fornecedor/empresa. Impedir repetição da mesma operação.
- Finanças regista e outra pessoa de Finanças valida, distinta do autor.
Sem duas pessoas elegíveis, a factura permanece pendente.
- Conferir ordem, recepções aceites e factura por linha: quantidade, unidade,
preço, IVA e total. Aceitar facturação parcial até ao recebido/aceite ainda
não facturado. Serviços exigem uma aceitação registada antes da validação.
- Proposta inicial: tolerância zero para diferenças de preço, quantidade ou
imposto. Divergências suspendem a validação até existir procedimento aprovado;
não corrigir silenciosamente a ordem ou as recepções.
- Validar a factura converte a parcela correspondente do compromisso em consumo.
A parcela por facturar mantém-se comprometida; a soma não pode ultrapassar
o autorizado. O pagamento futuro liquida a dívida, sem consumir outra vez
o orçamento.
- Notas de crédito, adiantamentos, despesas sem ordem, diferenças cambiais e
facturação entre exercícios ficam bloqueados até definição dos respectivos fluxos.
- Não criar pagamentos automáticos nem enviar documentos a terceiros.
## Investimento em equipamentos
- Manter validação técnica do responsável da área e Finanças para qualquer
valor, com separação do solicitante e registo das decisões.
- Criar uma dotação de investimento identificada, distinguindo-a de despesa
corrente; a classificação exige decisão explícita, sem inferência pela descrição.
- O limite próprio de investimento deve ser configurado por empresa, com base
com/sem IVA, vigência, âmbito por aquisição/projecto e significado explícito:
tecto absoluto ou valor que exige aprovação adicional. São decisões em aberto.
- Não propor um valor monetário arbitrário. Enquanto a regra estiver ausente
ou não aprovada por duas pessoas distintas, manter adjudicação e emissão
de equipamento bloqueadas. Proibir fraccionamento para contornar o limite.
## Validação de aceitação a implementar
1. Duas submissões simultâneas disputando saldo: apenas as que cabem na dotação
podem reservar; saldo nunca negativo.
2. Repetição de submissão, adjudicação, emissão ou validação de factura não
duplica reserva, compromisso, consumo ou auditoria.
3. Falha de auditoria reverte a transacção inteira. Os lançamentos anteriores
não podem ser editados ou eliminados; correcções usam inversões explícitas.
4. Facturas parciais consomem só a parcela aceite, preservando compromisso
remanescente; excesso, duplicação e diferenças são recusados.
5. Rejeição liberta exactamente a reserva existente, uma única vez.
6. Isolamento entre empresas, centros de custo, exercícios e perfis;
ninguém aprova a própria dotação ou factura.
7. Equipamento sem regra de investimento aprovada permanece bloqueado,
incluindo nos limites e acima deles. Validar fronteiras após definição da regra.
8. Executar concorrência PostgreSQL em base isolada e revisão visual pública,
autenticada e de impressão; testes funcionais não substituem a revisão visual.
## Decisões necessárias para activar o desenvolvimento financeiro
Confirmar exercício anual, base com IVA, circuito de dupla aprovação,
reserva na submissão e tolerância zero. Definir dotação inicial por centro de
custo e os parâmetros/autoridade do investimento. Esta proposta não constitui
aprovação destas regras nem certificação para compras reais.
+111
View File
@@ -0,0 +1,111 @@
{
"tested_at_utc": "2026-10-28T10:56:15+00:00",
"database": "compras_receipts_test_84e8492cd8f3",
"separate_database": true,
"transport": "Laravel HTTP kernel in independent PHP processes; real PostgreSQL connections",
"scenarios": [
{
"name": "over_quantity",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 201,
"id": 1,
"created": true,
"error_fields": [],
"backend_pid": 4688
},
{
"status": 422,
"id": null,
"created": null,
"error_fields": ["items"],
"backend_pid": 2068
}
],
"receipts": 1,
"stock_movements": 1,
"quantity_milli": 600,
"order_state": "partial"
},
{
"name": "same_confirmation",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 201,
"id": 2,
"created": true,
"error_fields": [],
"backend_pid": 9064
},
{
"status": 200,
"id": 2,
"created": false,
"error_fields": [],
"backend_pid": 1036
}
],
"receipts": 1,
"stock_movements": 1,
"quantity_milli": 600,
"order_state": "partial"
},
{
"name": "complementary_quantities",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 201,
"id": 4,
"created": true,
"error_fields": [],
"backend_pid": 3020
},
{
"status": 201,
"id": 3,
"created": true,
"error_fields": [],
"backend_pid": 24624
}
],
"receipts": 2,
"stock_movements": 2,
"quantity_milli": 1000,
"order_state": "complete"
},
{
"name": "same_delivery_note",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 422,
"id": null,
"created": null,
"error_fields": ["delivery_note"],
"backend_pid": 22120
},
{
"status": 201,
"id": 5,
"created": true,
"error_fields": [],
"backend_pid": 4720
}
],
"receipts": 1,
"stock_movements": 1,
"quantity_milli": 600,
"order_state": "partial"
}
],
"passed": true,
"test_database_dropped": true,
"live_user_count_unchanged": true
}
+172
View File
@@ -0,0 +1,172 @@
{
"tested_at_utc": "2026-10-28T11:35:31+00:00",
"database": "compras_receipts_test_d97ad8ad1eb7",
"separate_database": true,
"transport": "Laravel HTTP kernel in independent PHP processes; real PostgreSQL connections",
"scenarios": [
{
"name": "over_issue",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 201,
"id": 1,
"created": true,
"error_fields": [],
"backend_pid": 5004
},
{
"status": 422,
"id": null,
"created": null,
"error_fields": ["quantity"],
"backend_pid": 27024
}
],
"source_milli": 400,
"destination_milli": 0
},
{
"name": "same_issue",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 201,
"id": 2,
"created": true,
"error_fields": [],
"backend_pid": 7640
},
{
"status": 200,
"id": 2,
"created": false,
"error_fields": [],
"backend_pid": 22852
}
],
"source_milli": 400,
"destination_milli": 0
},
{
"name": "same_transfer",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 201,
"id": 3,
"created": true,
"error_fields": [],
"backend_pid": 25232
},
{
"status": 200,
"id": 3,
"created": false,
"error_fields": [],
"backend_pid": 28856
}
],
"source_milli": 400,
"destination_milli": 600
},
{
"name": "opposing_transfers",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 201,
"id": 4,
"created": true,
"error_fields": [],
"backend_pid": 5268
},
{
"status": 422,
"id": null,
"created": null,
"error_fields": ["quantity"],
"backend_pid": 4288
}
],
"source_milli": 400,
"destination_milli": 600
},
{
"name": "same_adjustment",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 200,
"id": 6,
"created": false,
"error_fields": [],
"backend_pid": 13608
},
{
"status": 201,
"id": 6,
"created": true,
"error_fields": [],
"backend_pid": 2320
}
],
"source_milli": 800,
"destination_milli": 0
},
{
"name": "stale_adjustment",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 422,
"id": null,
"created": null,
"error_fields": ["count_id"],
"backend_pid": 25516
},
{
"status": 422,
"id": null,
"created": null,
"error_fields": ["count_id"],
"backend_pid": 23640
}
],
"source_milli": 900,
"destination_milli": 0
},
{
"name": "spare_part_issue",
"passed": true,
"overlapping_lock_waits": 2,
"responses": [
{
"status": 201,
"id": 9,
"created": true,
"error_fields": [],
"backend_pid": 18244
},
{
"status": 422,
"id": null,
"created": null,
"error_fields": ["quantity"],
"backend_pid": 2452
}
],
"source_milli": 400,
"destination_milli": 0
}
],
"passed": true,
"test_database_dropped": true,
"live_user_count_unchanged": true
}
+56
View File
@@ -0,0 +1,56 @@
{
"verified_at_utc": "2026-10-28T11:21:06+00:00",
"database": "compras_dev",
"migration": {
"migration": "2026_10_28_000007_create_stock_operations",
"batch": 8
},
"backup_directory": "storage\/app\/private\/backups\/stock-000007-20261028-111943-4deef2",
"backup_bytes": 169365,
"backup_sha256": "5df038437e94870e80d1fab61e7d53223043b4167ded71eb52703db1c4d47942",
"restore_verified": true,
"restored_tables": 31,
"restore_database_dropped": true,
"existing_records_unchanged": true,
"existing_constraints_preserved": true,
"env_unchanged": true,
"stock_operations_count": 0,
"stock_movements_count": 0,
"existing_table_counts": {
"approval_steps": 0,
"audit_logs": 1,
"cache": 6,
"cache_locks": 0,
"conflict_declarations": 0,
"cost_centers": 1,
"departments": 1,
"failed_jobs": 0,
"goods_receipt_items": 0,
"goods_receipts": 0,
"job_batches": 0,
"jobs": 0,
"migrations": 9,
"password_reset_tokens": 0,
"proposal_evaluations": 0,
"purchase_award_approvals": 0,
"purchase_awards": 0,
"purchase_order_items": 0,
"purchase_orders": 0,
"quotation_items": 0,
"quotations": 0,
"requisition_items": 0,
"requisitions": 0,
"sessions": 18,
"stock_items": 0,
"stock_movements": 0,
"supplier_documents": 0,
"suppliers": 0,
"tenants": 1,
"users": 1,
"warehouses": 0
},
"migration_rows_added": 1,
"budget_checked": false,
"visual_public_review": "pending_browser_access_host_unavailable",
"visual_authenticated_review": "pending_no_access_to_browser_session"
}
+2 -1
View File
@@ -6,13 +6,14 @@ import AppLayout from '@/layouts/app-layout';
import AuthLayout from '@/layouts/auth-layout';
import SettingsLayout from '@/layouts/settings/layout';
const appName = 'ProcuraFlow';
const appName = 'SGC';
void createInertiaApp({
title: (title) => (title ? `${title} - ${appName}` : appName),
layout: (name) => {
switch (true) {
case name === 'welcome':
case name === 'home':
case name.startsWith('preview/'):
return null;
case name.startsWith('auth/'):
+1 -1
View File
@@ -8,7 +8,7 @@ export default function AppLogo() {
</div>
<div className="ml-1 grid flex-1 text-left text-sm">
<span className="mb-0.5 truncate leading-tight font-semibold">
ProcuraFlow
SGC
</span>
</div>
</>
+99 -15
View File
@@ -7,6 +7,8 @@ import {
Scale,
ShieldAlert,
FileCheck2,
PackageCheck,
Warehouse,
} from 'lucide-react';
import AppLogo from '@/components/app-logo';
import { NavMain } from '@/components/nav-main';
@@ -23,42 +25,89 @@ import {
import { dashboard } from '@/routes';
import type { NavItem } from '@/types';
const mainNavItems: NavItem[] = [
const generalNavItems: NavItem[] = [
{
title: 'Visão geral',
href: dashboard(),
icon: LayoutGrid,
},
{ title: 'Requisições', href: '/requisicoes', icon: ClipboardList },
{ title: 'Conflitos de interesses', href: '/conflitos', icon: ShieldAlert },
];
export function AppSidebar() {
const { auth } = usePage().props;
const purchasingItems = [
const canReadPurchases = [
'admin',
'procurement',
'finance',
'department_head',
].includes(auth.user.purchasing_role ?? '')
? [
...mainNavItems,
{ title: 'Fornecedores', href: '/fornecedores', icon: Users },
{ title: 'Cotações', href: '/cotacoes', icon: Scale },
{ title: 'Ordens de compra', href: '/ordens', icon: FileCheck2 },
]
: mainNavItems;
const items =
].includes(auth.user.purchasing_role ?? '');
const purchasingItems: NavItem[] = [
{ title: 'Requisições', href: '/requisicoes', icon: ClipboardList },
...(canReadPurchases
? [
{ title: 'Fornecedores', href: '/fornecedores', icon: Users },
{ title: 'Cotações', href: '/cotacoes', icon: Scale },
{
title: 'Ordens de compra',
href: '/ordens',
icon: FileCheck2,
},
]
: []),
];
const inventoryItems = [
...([
'admin',
'procurement',
'finance',
'warehouse',
'department_head',
].includes(auth.user.purchasing_role ?? '')
? [{ title: 'Recepção', href: '/recepcoes', icon: PackageCheck }]
: []),
...([
'admin',
'procurement',
'finance',
'warehouse',
'department_head',
].includes(auth.user.purchasing_role ?? '')
? [
{
title: 'Equipamentos e peças',
href: '/equipamentos',
icon: Warehouse,
},
]
: []),
...(['admin', 'procurement', 'finance', 'warehouse'].includes(
auth.user.purchasing_role ?? '',
)
? [
{
title: 'Stock e movimentos',
href: '/stock',
icon: Warehouse,
},
{
title: 'Saídas e inventários',
href: '/stock/operacoes',
icon: ClipboardList,
},
]
: []),
];
const administrationItems =
auth.user.purchasing_role === 'admin'
? [
...purchasingItems,
{
title: 'Empresa e equipa',
href: '/empresa',
icon: Building2,
},
]
: purchasingItems;
: [];
return (
<Sidebar collapsible="icon" variant="inset">
<SidebarHeader>
@@ -74,10 +123,45 @@ export function AppSidebar() {
</SidebarHeader>
<SidebarContent>
<NavMain items={items} />
<NavMain title="Geral" items={generalNavItems} />
<NavMain title="Compras" items={purchasingItems} />
{['admin', 'finance'].includes(
auth.user.purchasing_role ?? '',
) && (
<NavMain
title="Finanças"
items={[
{
title: 'Orçamentos',
href: '/orcamentos',
icon: FileCheck2,
},
{
title: 'Facturas',
href: '/facturas',
icon: FileCheck2,
},
]}
/>
)}
{inventoryItems.length > 0 && (
<NavMain title="Armazém" items={inventoryItems} />
)}
{administrationItems.length > 0 && (
<NavMain
title="Administração"
items={administrationItems}
/>
)}
</SidebarContent>
<SidebarFooter>
<Link
href="/"
className="px-3 py-2 text-xs text-muted-foreground hover:text-foreground"
>
Página inicial
</Link>
<NavUser />
</SidebarFooter>
</Sidebar>
+85
View File
@@ -0,0 +1,85 @@
import { Link } from '@inertiajs/react';
import type { Page, ReceiptProgress } from '@/types/inventory';
import { quantity, receiptStates } from '@/types/inventory';
export function InventoryNotice() {
return (
<div className="rounded-xl border border-amber-200 bg-amber-50 p-4 text-sm text-amber-900 dark:border-amber-900 dark:bg-amber-950 dark:text-amber-100">
Ambiente de desenvolvimento. Não autoriza compras reais.{' '}
<strong>O orçamento ainda não é validado.</strong>
</div>
);
}
export function ReceiptProgressTable({
progress,
}: {
progress: ReceiptProgress;
}) {
return (
<>
<p className="mb-4 text-sm font-semibold">
{receiptStates[progress.state]}
{progress.has_divergences
? ' · Existem divergências de qualidade'
: ''}
</p>
<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">Autorizado</th>
<th className="pr-4">Recebido</th>
<th className="pr-4">Aceite</th>
<th className="pr-4">Rejeitado</th>
<th className="pr-4">Por entregar</th>
<th>Por aceitar</th>
</tr>
</thead>
<tbody>
{progress.lines.map((line) => (
<tr
key={line.id}
className="border-b last:border-0"
>
<td className="py-4 pr-4">
<strong>{line.description}</strong>
<p className="mt-1 text-xs text-muted-foreground">
{line.unit}
</p>
</td>
{[
line.ordered_milli,
line.received_milli,
line.accepted_milli,
line.rejected_milli,
line.delivery_pending_milli,
line.acceptance_pending_milli,
].map((value, index) => (
<td
key={index}
className="pr-4 whitespace-nowrap"
>
{quantity(value)}
</td>
))}
</tr>
))}
</tbody>
</table>
</div>
</>
);
}
export function InventoryPagination<T>({ page }: { page: Page<T> }) {
return (
<div className="mt-4 flex gap-4 text-sm text-teal-700 dark:text-teal-400">
{page.prev_page_url && (
<Link href={page.prev_page_url}>Anterior</Link>
)}
{page.next_page_url && (
<Link href={page.next_page_url}>Seguinte</Link>
)}
</div>
);
}
+20 -4
View File
@@ -7,20 +7,36 @@ import {
SidebarMenuItem,
} from '@/components/ui/sidebar';
import { useCurrentUrl } from '@/hooks/use-current-url';
import { toUrl } from '@/lib/utils';
import type { NavItem } from '@/types';
export function NavMain({ items }: { items: NavItem[] }) {
const { isCurrentUrl } = useCurrentUrl();
export function NavMain({
items,
title = 'Navegação',
}: {
items: NavItem[];
title?: string;
}) {
const { isCurrentOrParentUrl, currentUrl } = useCurrentUrl();
const receivingOrder = /^\/ordens\/\d+\/recepcoes/.test(currentUrl);
return (
<SidebarGroup className="px-2 py-0">
<SidebarGroupLabel>Platform</SidebarGroupLabel>
<SidebarGroupLabel>{title}</SidebarGroupLabel>
<SidebarMenu>
{items.map((item) => (
<SidebarMenuItem key={item.title}>
<SidebarMenuButton
asChild
isActive={isCurrentUrl(item.href)}
isActive={
(toUrl(item.href) === '/recepcoes' &&
receivingOrder) ||
(isCurrentOrParentUrl(item.href) &&
!(
toUrl(item.href) === '/ordens' &&
receivingOrder
))
}
tooltip={{ children: item.title }}
>
<Link href={item.href} prefetch>
+15
View File
@@ -0,0 +1,15 @@
export const previewPaths: Record<string, string> = {
overview: '/consulta',
requests: '/consulta/requisicoes',
suppliers: '/consulta/fornecedores',
quotes: '/consulta/cotacoes',
conflicts: '/consulta/conflitos',
orders: '/consulta/ordens',
receipts: '/consulta/recepcoes',
stock: '/consulta/stock',
operations: '/consulta/operacoes-stock',
equipment: '/consulta/equipamentos',
invoices: '/consulta/facturas',
bank: '/consulta/dados-bancarios',
appearance: '/consulta/aparencia',
};
+1 -1
View File
@@ -117,6 +117,6 @@ export default function Login({ status, canResetPassword }: Props) {
}
Login.layout = {
title: 'Entrar no ProcuraFlow',
title: 'Entrar no Sistema de Gestão de Compras',
description: 'Introduza o seu email e a palavra-passe',
};
+182
View File
@@ -0,0 +1,182 @@
import { Head, router, useForm, usePage } from '@inertiajs/react';
import {
Panel,
PageTitle,
FormErrors,
controlClass,
} from '@/components/procurement';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { money } from '@/types/procurement';
type Budget = {
id: number;
cost_center_id: number;
year: number;
amount_minor: number;
reserved_minor: number;
committed_minor: number;
consumed_minor: number;
available_minor: number;
created_by: number;
approved_by: number | null;
reason: string;
includes_tax: boolean;
};
export default function Budgets({
centers,
budgets,
}: {
centers: { id: number; code: string; name: string }[];
budgets: Budget[];
}) {
const { auth } = usePage().props;
const form = useForm({
cost_center_id: '',
year: new Date().getFullYear(),
amount: '',
reason: '',
includes_tax: '',
});
return (
<>
<Head title="Orçamentos" />
<div className="mx-auto grid w-full max-w-6xl gap-6 p-6">
<PageTitle
eyebrow="SGC · Finanças"
title="Orçamentos"
description="Dotação anual por empresa e centro de custo, em MZN. A empresa define a base de IVA."
/>
<p className="rounded-lg border border-amber-300 p-4 text-sm">
Desenvolvimento. O orçamento continua sem validação
operacional. Centros sem dotação continuam no circuito
anterior, sem controlo orçamental. Facturas validadas
convertem compromisso em consumo. Pagamentos ainda não
implementados.
</p>
<Panel
title="Preparar dotação"
description="Outra pessoa de Administração ou Finanças deve aprovar. Não existem alterações ou reforços nesta etapa."
>
<form
className="grid gap-4"
onSubmit={(e) => {
e.preventDefault();
form.transform((data) => ({
...data,
includes_tax: data.includes_tax === '1',
}));
form.post('/orcamentos');
}}
>
<FormErrors errors={form.errors} />
<label>
Base de controlo
<select
required
className={controlClass}
value={form.data.includes_tax}
onChange={(e) =>
form.setData('includes_tax', e.target.value)
}
>
<option value="">Decisão da empresa</option>
<option value="1">Com IVA</option>
<option value="0">Sem IVA</option>
</select>
</label>
<label>
Centro de custo
<select
required
className={controlClass}
value={form.data.cost_center_id}
onChange={(e) =>
form.setData(
'cost_center_id',
e.target.value,
)
}
>
<option value="">Seleccionar</option>
{centers.map((c) => (
<option key={c.id} value={c.id}>
{c.code} · {c.name}
</option>
))}
</select>
</label>
<label>
Exercício
<Input
required
type="number"
min="2026"
max="2100"
value={form.data.year}
onChange={(e) =>
form.setData('year', Number(e.target.value))
}
/>
</label>
<label>
Dotação na base seleccionada (MZN)
<Input
required
inputMode="decimal"
value={form.data.amount}
onChange={(e) =>
form.setData('amount', e.target.value)
}
/>
</label>
<label>
Fundamento
<textarea
required
className="w-full rounded border p-3"
value={form.data.reason}
onChange={(e) =>
form.setData('reason', e.target.value)
}
/>
</label>
<Button disabled={form.processing}>
Guardar para aprovação independente
</Button>
</form>
</Panel>
{budgets.map((b) => (
<Panel
key={b.id}
title={`${centers.find((c) => c.id === b.cost_center_id)?.code ?? b.cost_center_id} · ${b.year}`}
>
<p>
{b.approved_by
? 'Aprovado'
: 'Pendente de aprovação'}{' '}
· Dotação: {money(b.amount_minor)} · Base:{' '}
{b.includes_tax ? 'com IVA' : 'sem IVA'}
</p>
<p>
Reservado: {money(b.reserved_minor)} · Comprometido:{' '}
{money(b.committed_minor)} · Consumido:{' '}
{money(b.consumed_minor)} · Disponível:{' '}
{money(b.available_minor)}
</p>
<p className="my-3">{b.reason}</p>
{!b.approved_by && b.created_by !== auth.user.id && (
<Button
onClick={() =>
router.post(`/orcamentos/${b.id}/aprovar`)
}
>
Aprovar dotação
</Button>
)}
</Panel>
))}
</div>
</>
);
}
+1 -1
View File
@@ -61,7 +61,7 @@ export default function Dashboard({
<Head title="Visão geral" />
<div className="mx-auto flex w-full max-w-7xl flex-col gap-7 p-5 lg:p-8">
<PageTitle
eyebrow={company?.name ?? 'Bem-vindo ao ProcuraFlow'}
eyebrow={company?.name ?? 'Bem-vindo ao SGC'}
title="Visão geral das compras"
description="Acompanhe os pedidos, as aprovações e a actividade da sua empresa."
action={
+859
View File
@@ -0,0 +1,859 @@
import { Head, useForm, Link } 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, Page } from '@/types/inventory';
type Level = {
id: number;
code: string;
name: string;
criteria: string;
is_critical: boolean;
};
type Asset = {
id: number;
code: string;
description: string;
area: string;
serial_number: string | null;
status: string;
department_id: number;
stock_item_id: number | null;
criticality_level_id: number;
version: number;
};
type Part = {
id: number;
stock_item_id: number;
criticality_level_id: number;
minimum_milli: number;
balance_milli: number;
below_minimum: boolean;
version: number;
};
type History = {
id: number;
reference: string;
quantity_milli: number;
snapshot: {
equipment?: { code: string; description: string };
stock_item: { name: string; unit: string };
reason?: string;
};
};
type Props = {
equipment: Asset[];
parts: Part[];
levels: Level[];
links: { equipment_id: number; spare_part_id: number }[];
items: StockItem[];
departments: { id: number; name: string }[];
history: Page<History>;
canManage: boolean;
canConfigure: boolean;
demo?: boolean;
};
function Field({
label,
children,
}: {
label: string;
children: React.ReactNode;
}) {
return (
<label className="grid gap-2 text-sm">
{label}
{children}
</label>
);
}
const statuses: Record<string, string> = {
active: 'Em serviço',
stopped: 'Parado',
retired: 'Retirado',
};
export default function EquipmentPage({
equipment,
parts,
levels,
links,
items,
departments,
history,
canManage,
canConfigure,
demo = false,
}: Props) {
const [message, setMessage] = useState('');
const category = useForm({
code: '',
name: '',
criteria: '',
is_critical: '',
});
const asset = useForm({
id: '',
version: '',
code: '',
description: '',
area: '',
serial_number: '',
department_id: '',
stock_item_id: '',
criticality_level_id: '',
status: 'active',
});
const part = useForm({
id: '',
version: '',
stock_item_id: '',
criticality_level_id: '',
minimum_quantity: '',
});
const association = useForm({ equipment_id: '', spare_part_id: '' });
const stock = (id: number) => items.find((i) => i.id === id);
const criticality = (id: number) => levels.find((l) => l.id === id);
function simulate() {
setMessage(
'Simulação revista. Nenhum cadastro ou movimento real foi criado.',
);
}
return (
<>
<Head title="Equipamentos e peças" />
<div className="mx-auto flex w-full max-w-7xl flex-col gap-6 p-5 lg:p-8">
<PageTitle
eyebrow="Produção e armazém"
title="Equipamentos e peças sobressalentes"
description="Cadastro, peças compatíveis, mínimos explícitos e rastreabilidade das saídas."
/>
<InventoryNotice />
{demo && (
<p className="rounded-lg border bg-teal-50 p-4 text-sm text-teal-900">
Dados fictícios para revisão sem login. Formulários
apenas de simulação.
</p>
)}
<Panel
title="Regras e validação técnica"
description="Os critérios de criticidade e mínimos são definidos explicitamente pela empresa, sem valores predefinidos."
>
<p className="text-sm">
O responsável da área (chefe do departamento), distinto
do solicitante, valida tecnicamente a versão do pedido
de equipamento. Finanças é obrigatória para qualquer
valor. A adjudicação e emissão de equipamento permanecem
bloqueadas: o limite próprio de investimento e a sua
aplicação exigem decisão da empresa. Uma aprovação
técnica não resolve essa pendência.
</p>
<Link
className="mt-3 inline-block text-sm font-semibold text-teal-700"
href={demo ? '/consulta/requisicoes' : '/requisicoes'}
>
Consultar requisições →
</Link>
</Panel>
<Panel title="Equipamentos">
<div className="grid gap-4 lg:grid-cols-2">
{equipment.map((e) => (
<article
className="rounded-lg border p-4 text-sm"
key={e.id}
>
<strong>
{e.code} · {e.description}
</strong>
<p className="mt-2">
{e.area} ·{' '}
{
departments.find(
(d) => d.id === e.department_id,
)?.name
}{' '}
· {statuses[e.status]}
</p>
<p>
Série: {e.serial_number || 'Não indicada'} ·
Criticidade:{' '}
{criticality(e.criticality_level_id)?.name}
</p>
{e.stock_item_id && (
<p>
Artigo: {stock(e.stock_item_id)?.code}
</p>
)}
<p className="mt-2">
Peças associadas:{' '}
{links
.filter((l) => l.equipment_id === e.id)
.map(
(l) =>
stock(
parts.find(
(p) =>
p.id ===
l.spare_part_id,
)?.stock_item_id ?? 0,
)?.code,
)
.join(', ') || 'Nenhuma'}
</p>
{canManage && (
<Button
className="mt-3"
variant="outline"
onClick={() =>
asset.setData({
id: String(e.id),
version: String(e.version),
code: e.code,
description: e.description,
area: e.area,
serial_number:
e.serial_number ?? '',
department_id: String(
e.department_id,
),
stock_item_id: e.stock_item_id
? String(e.stock_item_id)
: '',
criticality_level_id: String(
e.criticality_level_id,
),
status: e.status,
})
}
>
Editar ficha
</Button>
)}
</article>
))}
</div>
{equipment.length === 0 && (
<p className="text-sm">
Sem equipamentos. Configure a criticidade antes do
cadastro.
</p>
)}
</Panel>
<Panel
title="Peças e alertas de mínimo"
description="Saldo total por artigo nos armazéns da empresa. Cada peça reutiliza um artigo existente; associá-la a várias máquinas não duplica o stock."
>
<div className="space-y-3">
{parts.map((p) => (
<article
key={p.id}
className={`rounded-lg border p-4 text-sm ${p.below_minimum ? 'border-amber-300 bg-amber-50 text-amber-950' : ''}`}
>
<strong>
{stock(p.stock_item_id)?.code} ·{' '}
{stock(p.stock_item_id)?.name}
</strong>
<p className="mt-2">
Stock: {quantity(p.balance_milli)} · Mínimo
definido: {quantity(p.minimum_milli)}{' '}
{stock(p.stock_item_id)?.unit} ·{' '}
{criticality(p.criticality_level_id)?.name}
</p>
<p className="mt-1 font-semibold">
{p.below_minimum
? 'Abaixo do mínimo — rever reposição'
: 'Mínimo assegurado'}
</p>
<p>
Critério:{' '}
{
criticality(p.criticality_level_id)
?.criteria
}
</p>
{canManage && (
<Button
className="mt-3"
variant="outline"
onClick={() =>
part.setData({
id: String(p.id),
version: String(p.version),
stock_item_id: String(
p.stock_item_id,
),
criticality_level_id: String(
p.criticality_level_id,
),
minimum_quantity: (
p.minimum_milli / 1000
).toFixed(3),
})
}
>
Editar mínimo e criticidade
</Button>
)}
</article>
))}
</div>
{parts.length === 0 && (
<p className="text-sm">Sem peças registadas.</p>
)}
</Panel>
{canManage && (
<div className="grid gap-6 lg:grid-cols-2">
<Panel
title={
asset.data.id
? 'Editar equipamento'
: 'Cadastrar equipamento'
}
>
<form
className="grid gap-4"
onSubmit={(e) => {
e.preventDefault();
if (demo) {
simulate();
return;
}
asset.post('/equipamentos/activos', {
onSuccess: () => asset.reset(),
});
}}
>
<FormErrors errors={asset.errors} />
{(
[
'code',
'description',
'area',
'serial_number',
] as const
).map((k) => (
<Field
key={k}
label={
{
code: 'Código',
description: 'Descrição',
area: 'Área / linha de produção',
serial_number:
'Número de série',
}[k]
}
>
<Input
required={k !== 'serial_number'}
value={asset.data[k]}
onChange={(e) =>
asset.setData(k, e.target.value)
}
/>
</Field>
))}
<Field label="Departamento">
<select
required
className={controlClass}
value={asset.data.department_id}
onChange={(e) =>
asset.setData(
'department_id',
e.target.value,
)
}
>
<option value="">Seleccionar</option>
{departments.map((d) => (
<option key={d.id} value={d.id}>
{d.name}
</option>
))}
</select>
</Field>
<Field label="Artigo de stock (opcional)">
<select
className={controlClass}
value={asset.data.stock_item_id}
onChange={(e) =>
asset.setData(
'stock_item_id',
e.target.value,
)
}
>
<option value="">
Sem artigo associado
</option>
{items.map((i) => (
<option key={i.id} value={i.id}>
{i.code} · {i.name}
</option>
))}
</select>
</Field>
<Field label="Criticidade definida pela empresa">
<select
required
className={controlClass}
value={asset.data.criticality_level_id}
onChange={(e) =>
asset.setData(
'criticality_level_id',
e.target.value,
)
}
>
<option value="">Seleccionar</option>
{levels.map((l) => (
<option key={l.id} value={l.id}>
{l.name}
</option>
))}
</select>
</Field>
<Field label="Estado">
<select
className={controlClass}
value={asset.data.status}
onChange={(e) =>
asset.setData(
'status',
e.target.value,
)
}
>
{Object.entries(statuses).map(
([k, v]) => (
<option key={k} value={k}>
{v}
</option>
),
)}
</select>
</Field>
<Button
disabled={
asset.processing || levels.length === 0
}
>
Guardar equipamento
</Button>
{asset.data.id && (
<Button
type="button"
variant="outline"
onClick={() => asset.reset()}
>
Novo cadastro
</Button>
)}
<p className="text-xs text-muted-foreground">
O cadastro não cria entradas nem retira
existências. Os movimentos usam o fluxo de
stock.
</p>
</form>
</Panel>
<div className="space-y-6">
<Panel
title={
part.data.id
? 'Editar peça'
: 'Cadastrar peça sobre artigo existente'
}
>
<form
className="grid gap-4"
onSubmit={(e) => {
e.preventDefault();
if (demo) {
simulate();
return;
}
part.post('/equipamentos/pecas', {
onSuccess: () => part.reset(),
});
}}
>
<FormErrors errors={part.errors} />
<Field label="Artigo / referência">
<select
required
disabled={!!part.data.id}
className={controlClass}
value={part.data.stock_item_id}
onChange={(e) =>
part.setData(
'stock_item_id',
e.target.value,
)
}
>
<option value="">
Seleccionar
</option>
{items.map((i) => (
<option key={i.id} value={i.id}>
{i.code} · {i.name} (
{i.unit})
</option>
))}
</select>
</Field>
<Field label="Criticidade">
<select
required
className={controlClass}
value={
part.data.criticality_level_id
}
onChange={(e) =>
part.setData(
'criticality_level_id',
e.target.value,
)
}
>
<option value="">
Seleccionar
</option>
{levels.map((l) => (
<option key={l.id} value={l.id}>
{l.name}
</option>
))}
</select>
</Field>
<Field label="Quantidade mínima explícita (pode ser zero)">
<Input
required
type="number"
min="0"
step="0.001"
value={part.data.minimum_quantity}
onChange={(e) =>
part.setData(
'minimum_quantity',
e.target.value,
)
}
/>
</Field>
<Button
disabled={
part.processing ||
levels.length === 0
}
>
Guardar peça
</Button>
{part.data.id && (
<Button
type="button"
variant="outline"
onClick={() => part.reset()}
>
Nova peça
</Button>
)}
</form>
</Panel>
<Panel title="Associar peça a equipamento">
<form
className="grid gap-4"
onSubmit={(e) => {
e.preventDefault();
if (demo) {
simulate();
return;
}
association.post(
'/equipamentos/associacoes',
{
onSuccess: () =>
association.reset(),
},
);
}}
>
<FormErrors errors={association.errors} />
<Field label="Equipamento">
<select
required
className={controlClass}
value={
association.data.equipment_id
}
onChange={(e) =>
association.setData(
'equipment_id',
e.target.value,
)
}
>
<option value="">
Seleccionar
</option>
{equipment.map((e) => (
<option key={e.id} value={e.id}>
{e.code} · {e.description}
</option>
))}
</select>
</Field>
<Field label="Peça">
<select
required
className={controlClass}
value={
association.data.spare_part_id
}
onChange={(e) =>
association.setData(
'spare_part_id',
e.target.value,
)
}
>
<option value="">
Seleccionar
</option>
{parts.map((p) => (
<option key={p.id} value={p.id}>
{
stock(p.stock_item_id)
?.code
}{' '}
·{' '}
{
stock(p.stock_item_id)
?.name
}
</option>
))}
</select>
</Field>
<Button disabled={association.processing}>
Associar sem duplicar stock
</Button>
</form>
</Panel>
</div>
</div>
)}
{canConfigure && (
<Panel
title="Configurar critérios de criticidade"
description="Sem categorias automáticas. Registe a decisão da empresa; os critérios guardados não são reescritos. Para novos critérios, crie uma nova categoria."
>
<form
className="grid gap-4 sm:grid-cols-2"
onSubmit={(e) => {
e.preventDefault();
if (demo) {
simulate();
return;
}
category.post('/equipamentos/categorias', {
onSuccess: () => category.reset(),
});
}}
>
<Field label="Código">
<Input
required
value={category.data.code}
onChange={(e) =>
category.setData('code', e.target.value)
}
/>
</Field>
<Field label="Nome da categoria">
<Input
required
value={category.data.name}
onChange={(e) =>
category.setData('name', e.target.value)
}
/>
</Field>
<Field label="Critério e fundamento da classificação">
<textarea
required
className={controlClass}
value={category.data.criteria}
onChange={(e) =>
category.setData(
'criteria',
e.target.value,
)
}
/>
</Field>
<Field label="É crítica para produção segundo este critério?">
<select
required
className={controlClass}
value={category.data.is_critical}
onChange={(e) =>
category.setData(
'is_critical',
e.target.value,
)
}
>
<option value="">Decisão explícita</option>
<option value="1">Sim</option>
<option value="0">Não</option>
</select>
</Field>
<FormErrors errors={category.errors} />
<Button disabled={category.processing}>
Guardar critério
</Button>
</form>
<div className="mt-4 space-y-2 text-sm">
{levels.map((l) => (
<p key={l.id}>
<strong>
{l.code} · {l.name}
</strong>
: {l.criteria} ·{' '}
{l.is_critical ? 'Crítica' : 'Não crítica'}
</p>
))}
</div>
</Panel>
)}
<p role="status" className="text-sm">
{message}
</p>
<Panel title="Saídas rastreáveis por equipamento">
<Link
href={
demo
? '/consulta/operacoes-stock'
: '/stock/operacoes'
}
className="text-sm font-semibold text-teal-700"
>
Registar saída com equipamento de destino →
</Link>
<div className="mt-4 space-y-3">
{history.data.map((h) => (
<article
key={h.id}
className="rounded-lg border p-4 text-sm"
>
<strong>
{h.reference} · {h.snapshot.equipment?.code}
</strong>
<p>
{h.snapshot.equipment?.description} ·{' '}
{h.snapshot.stock_item.name} ·{' '}
{quantity(h.quantity_milli)}{' '}
{h.snapshot.stock_item.unit}
</p>
<p>{h.snapshot.reason}</p>
</article>
))}
{history.data.length === 0 && (
<p className="text-sm">
Sem saídas associadas a equipamentos.
</p>
)}
</div>
<InventoryPagination page={history} />
</Panel>
</div>
</>
);
}
export function EquipmentDemo() {
return (
<EquipmentPage
demo
canManage
canConfigure
equipment={[
{
id: 1,
code: 'EQ-DEMO-01',
description: 'Compressor fictício',
area: 'Linha de produção fictícia A',
serial_number: 'SERIE-DEMO',
status: 'stopped',
department_id: 1,
stock_item_id: null,
criticality_level_id: 1,
version: 1,
},
]}
parts={[
{
id: 1,
stock_item_id: 1,
criticality_level_id: 1,
minimum_milli: 3000,
balance_milli: 1000,
below_minimum: true,
version: 1,
},
]}
links={[{ equipment_id: 1, spare_part_id: 1 }]}
levels={[
{
id: 1,
code: 'CRIT-DEMO',
name: 'Crítica (exemplo fictício)',
criteria:
'Exemplo apenas: falha interrompe a linha fictícia. A empresa deve definir os seus critérios.',
is_critical: true,
},
]}
items={[
{
id: 1,
code: 'ROL-DEMO',
name: 'Rolamento fictício',
unit: 'un',
},
]}
departments={[{ id: 1, name: 'Produção fictícia' }]}
history={{
data: [
{
id: 1,
reference: 'SAI-DEMO-PECA',
quantity_milli: 1000,
snapshot: {
equipment: {
code: 'EQ-DEMO-01',
description:
'Compressor fictício no momento da saída',
},
stock_item: {
name: 'Rolamento fictício',
unit: 'un',
},
reason: 'Substituição de peça numa paragem fictícia.',
},
},
],
prev_page_url: null,
next_page_url: null,
}}
/>
);
}
+267
View File
@@ -0,0 +1,267 @@
import { Head, Link } from '@inertiajs/react';
import {
ArrowRight,
ClipboardList,
FileCheck2,
PackageCheck,
ShieldCheck,
Users,
Warehouse,
} from 'lucide-react';
import { Button } from '@/components/ui/button';
const areas = [
{
title: 'Pedidos e aprovações',
description:
'Registe necessidades e acompanhe as decisões de cada departamento.',
icon: ClipboardList,
href: '/consulta/requisicoes',
label: 'Explorar requisições',
step: '01',
},
{
title: 'Fornecedores e compras',
description:
'Compare propostas, fundamente a escolha e acompanhe as ordens de compra.',
icon: Users,
href: '/consulta/fornecedores',
label: 'Explorar fornecedores',
step: '02',
},
{
title: 'Recepção e armazém',
description:
'Confira as entregas, registe a qualidade e consulte as existências aceites.',
icon: PackageCheck,
href: '/consulta/recepcoes',
label: 'Explorar recepção',
step: '03',
},
];
export default function Home() {
return (
<>
<Head title="Gestão de compras" />
<div className="min-h-screen bg-background text-foreground">
<header className="border-b">
<div className="mx-auto flex max-w-7xl flex-wrap items-center justify-between gap-4 px-6 py-5 lg:px-10">
<Link href="/" className="flex items-center gap-3">
<span className="grid size-10 place-items-center rounded-xl bg-teal-800 text-lg font-semibold text-white">
SGC
</span>
<div>
<span className="block text-lg font-semibold tracking-tight">
SGC
</span>
<span className="block text-xs text-muted-foreground">
Sistema de Gestão de Compras
</span>
</div>
</Link>
<nav
aria-label="Navegação principal"
className="flex items-center gap-5 text-sm"
>
<Link
href="/"
aria-current="page"
className="hidden font-semibold text-teal-700 sm:block dark:text-teal-400"
>
Início
</Link>
<Link
href="/consulta"
className="text-muted-foreground hover:text-foreground"
>
Demonstração
</Link>
<Button asChild>
<Link href="/login">
Entrar na aplicação{' '}
<ArrowRight className="size-4" />
</Link>
</Button>
</nav>
</div>
</header>
<main className="mx-auto max-w-7xl px-6 lg:px-10">
<section className="grid items-center gap-12 py-16 lg:grid-cols-[1.1fr_1fr] lg:py-24">
<div>
<p className="mb-5 text-xs font-semibold tracking-[0.2em] text-teal-700 uppercase dark:text-teal-400">
Cada etapa no seu lugar
</p>
<h1 className="max-w-2xl text-4xl leading-tight font-semibold tracking-tight sm:text-5xl">
Gestão de compras,
<br />
<span className="text-teal-800 dark:text-teal-400">
do pedido ao stock.
</span>
</h1>
<p className="mt-6 max-w-xl text-base leading-7 text-muted-foreground">
Um percurso organizado para a sua equipa:
necessidades, fornecedores, decisões, entregas e
armazém. Escolha a área em que quer trabalhar ou
conheça primeiro os exemplos de demonstração.
</p>
<div className="mt-8 flex flex-wrap gap-3">
<Button
asChild
size="lg"
className="bg-teal-800 text-white hover:bg-teal-900"
>
<Link href="/consulta">
Explorar a demonstração{' '}
<ArrowRight className="size-4" />
</Link>
</Button>
<Button asChild size="lg" variant="outline">
<Link href="/login">
Aceder ao espaço de trabalho
</Link>
</Button>
</div>
<p className="mt-5 flex items-center gap-2 text-xs text-muted-foreground">
<ShieldCheck className="size-4 shrink-0" />
Demonstração com dados fictícios. O espaço de
trabalho exige autenticação.
</p>
</div>
<div className="rounded-2xl border bg-muted/25 p-6 sm:p-8">
<div className="mb-7 flex items-center justify-between">
<p className="text-sm font-semibold">
O percurso da compra
</p>
<span className="rounded-full bg-teal-100 px-3 py-1 text-xs font-medium text-teal-900 dark:bg-teal-950 dark:text-teal-200">
Por etapas
</span>
</div>
<ol className="space-y-4">
{[
{
title: 'Requisitar e aprovar',
note: 'Necessidade, centro de custo e decisões',
icon: ClipboardList,
},
{
title: 'Seleccionar e emitir',
note: 'Propostas, adjudicação e ordem de compra',
icon: FileCheck2,
},
{
title: 'Receber e conferir',
note: 'Entregas parciais, qualidade e divergências',
icon: PackageCheck,
},
{
title: 'Consultar existências',
note: 'Entradas aceites e histórico por armazém',
icon: Warehouse,
},
].map((step, index) => (
<li
key={step.title}
className="flex items-center gap-4 rounded-xl border bg-background p-4"
>
<span className="grid size-10 shrink-0 place-items-center rounded-lg bg-muted text-teal-800 dark:text-teal-400">
<step.icon className="size-5" />
</span>
<div className="min-w-0 flex-1">
<p className="text-sm font-semibold">
{step.title}
</p>
<p className="mt-1 text-xs leading-5 text-muted-foreground">
{step.note}
</p>
</div>
<span className="text-xs text-muted-foreground">
0{index + 1}
</span>
</li>
))}
</ol>
</div>
</section>
<section
className="border-t py-12"
aria-labelledby="areas-title"
>
<div className="mb-7 flex flex-wrap items-end justify-between gap-3">
<div>
<p className="mb-2 text-xs font-semibold tracking-widest text-teal-700 uppercase dark:text-teal-400">
Navegação por áreas
</p>
<h2
id="areas-title"
className="text-2xl font-semibold tracking-tight"
>
Por onde quer começar?
</h2>
</div>
<Link
href="/consulta"
className="inline-flex items-center gap-2 text-sm font-medium text-teal-700 dark:text-teal-400"
>
Ver todos os módulos{' '}
<ArrowRight className="size-4" />
</Link>
</div>
<div className="grid gap-5 md:grid-cols-3">
{areas.map((area) => (
<Link
href={area.href}
key={area.title}
className="group flex flex-col rounded-xl border bg-card p-6 transition-colors hover:border-teal-600"
>
<div className="mb-8 flex items-center justify-between">
<area.icon className="size-6 text-teal-800 dark:text-teal-400" />
<span className="text-xs text-muted-foreground">
{area.step}
</span>
</div>
<h3 className="font-semibold">
{area.title}
</h3>
<p className="mt-3 flex-1 text-sm leading-6 text-muted-foreground">
{area.description}
</p>
<span className="mt-7 inline-flex items-center gap-2 text-sm font-medium text-teal-700 dark:text-teal-400">
{area.label}
<ArrowRight className="size-4 transition-transform group-hover:translate-x-1" />
</span>
</Link>
))}
</div>
</section>
<section className="mb-12 flex flex-wrap items-center justify-between gap-5 rounded-xl bg-teal-900 p-6 text-white sm:p-8">
<div>
<h2 className="text-xl font-semibold">
Já faz parte da equipa?
</h2>
<p className="mt-2 max-w-xl text-sm leading-6 text-teal-100">
Entre com a sua conta para aceder aos módulos e
dados autorizados para o seu perfil.
</p>
</div>
<Button asChild variant="secondary">
<Link href="/login">
Entrar no espaço de trabalho{' '}
<ArrowRight className="size-4" />
</Link>
</Button>
</section>
</main>
<footer className="border-t">
<div className="mx-auto flex max-w-7xl flex-wrap justify-between gap-4 px-6 py-6 text-xs leading-5 text-muted-foreground lg:px-10">
<span>SGC · Ambiente de desenvolvimento</span>
<span>
O orçamento ainda não é validado. Os documentos não
autorizam compras reais.
</span>
</div>
</footer>
</div>
</>
);
}
+330
View File
@@ -0,0 +1,330 @@
import { Head, router, useForm, usePage } from '@inertiajs/react';
import { useState } from 'react';
import {
FormErrors,
PageTitle,
Panel,
controlClass,
} from '@/components/procurement';
import { InventoryPagination } from '@/components/inventory';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { money } from '@/types/procurement';
import type { Page } from '@/types/inventory';
type Source = {
id: number;
description: string;
unit: string;
unit_price_minor: number;
tax_rate: string;
};
type Line = {
purchase_order_item_id: number;
quantity: string;
unit: string;
unit_price: string;
tax_rate: string;
};
type Invoice = {
id: number;
number: string;
issued_on: string;
status: string;
created_by: number;
subtotal_minor: number;
tax_minor: number;
total_minor: number;
snapshot: { supplier: { name: string }; order_number: string };
items: {
id: number;
quantity_milli: number;
subtotal_minor: number;
tax_minor: number;
snapshot: { description: string; unit: string };
}[];
};
export default function Invoices({
invoices,
orders,
canManage,
}: {
invoices: Page<Invoice>;
orders: { id: number; number: string; supplier: string; items: Source[] }[];
canManage: boolean;
}) {
const { auth } = usePage().props;
const [orderId, setOrderId] = useState('');
const [validationError, setValidationError] = useState('');
const [validating, setValidating] = useState<number | null>(null);
const form = useForm({
number: '',
issued_on: '',
subtotal: '',
tax: '',
total: '',
items: [] as Line[],
});
const order = orders.find((o) => String(o.id) === orderId);
return (
<>
<Head title="Facturas" />
<div className="mx-auto grid w-full max-w-6xl gap-6 p-6">
<PageTitle
eyebrow="SGC · Finanças"
title="Facturas e conferência"
description="Conferência da ordem, recepção aceite e factura. Validação por outra pessoa de Finanças."
/>
<p className="rounded-lg border border-amber-300 p-4 text-sm">
Desenvolvimento. Não autoriza pagamentos. A validação exige
compromisso orçamental aprovado. Diferenças, notas de
crédito e operações entre exercícios ficam bloqueadas.
</p>
{canManage && (
<Panel
title="Registar factura"
description="Transcreva os valores do documento do fornecedor. A conferência exige coincidência exacta; o registo não valida automaticamente a factura."
>
<form
className="grid gap-4"
onSubmit={(e) => {
e.preventDefault();
form.transform((d) => ({
...d,
items: d.items.filter(
(l) => l.quantity !== '',
),
}));
form.post(`/ordens/${orderId}/facturas`, {
onSuccess: () => {
form.reset();
setOrderId('');
},
});
}}
>
<FormErrors errors={form.errors} />
<label>
Ordem
<select
required
className={controlClass}
value={orderId}
onChange={(e) => {
setOrderId(e.target.value);
form.setData(
'items',
orders
.find(
(o) =>
String(o.id) ===
e.target.value,
)
?.items.map((l) => ({
purchase_order_item_id:
l.id,
quantity: '',
unit: l.unit,
unit_price: (
l.unit_price_minor / 100
).toFixed(2),
tax_rate: String(
l.tax_rate,
),
})) ?? [],
);
}}
>
<option value="">Seleccionar ordem</option>
{orders.map((o) => (
<option key={o.id} value={o.id}>
{o.number} · {o.supplier}
</option>
))}
</select>
</label>
<label>
Número do fornecedor
<Input
required
maxLength={100}
value={form.data.number}
onChange={(e) =>
form.setData('number', e.target.value)
}
/>
</label>
<label>
Data da factura
<Input
required
type="date"
value={form.data.issued_on}
onChange={(e) =>
form.setData(
'issued_on',
e.target.value,
)
}
/>
</label>
{form.data.items.map((line, index) => (
<fieldset
key={line.purchase_order_item_id}
className="grid gap-3 rounded border p-4 sm:grid-cols-4"
>
<legend>
{
order?.items.find(
(s) =>
s.id ===
line.purchase_order_item_id,
)?.description
}
</legend>
{(
[
'quantity',
'unit',
'unit_price',
'tax_rate',
] as const
).map((key) => (
<label key={key}>
{
{
quantity:
'Quantidade (vazio para excluir)',
unit: 'Unidade',
unit_price: 'Preço sem IVA',
tax_rate: 'IVA (%)',
}[key]
}
<Input
value={line[key]}
onChange={(e) =>
form.setData(
'items',
form.data.items.map(
(l, i) =>
i === index
? {
...l,
[key]: e
.target
.value,
}
: l,
),
)
}
/>
</label>
))}
</fieldset>
))}
<p className="text-sm">
Nas facturas parciais o arredondamento é
acumulado por linha para preservar o total da
ordem. Divergências exigem revisão, sem
alteração automática do documento.
</p>
{(['subtotal', 'tax', 'total'] as const).map(
(key) => (
<label key={key}>
{
{
subtotal:
'Subtotal sem IVA (MZN)',
tax: 'IVA (MZN)',
total: 'Total (MZN)',
}[key]
}
<Input
required
inputMode="decimal"
value={form.data[key]}
onChange={(e) =>
form.setData(
key,
e.target.value,
)
}
/>
</label>
),
)}
<Button disabled={!orderId || form.processing}>
Registar para conferência independente
</Button>
</form>
</Panel>
)}
{validationError && (
<p role="alert" className="text-red-700">
{validationError}
</p>
)}
{invoices.data.map((invoice) => (
<Panel
key={invoice.id}
title={`${invoice.number} · ${invoice.snapshot.supplier.name}`}
>
<p>
{invoice.snapshot.order_number} ·{' '}
{invoice.issued_on} ·{' '}
{invoice.status === 'validated'
? 'Validada'
: 'Pendente de validação'}
</p>
<p>
Subtotal {money(invoice.subtotal_minor)} · IVA{' '}
{money(invoice.tax_minor)} · Total{' '}
{money(invoice.total_minor)}
</p>
<ul className="my-3 space-y-2">
{invoice.items.map((l) => (
<li key={l.id}>
{l.snapshot.description} ·{' '}
{l.quantity_milli / 1000} {l.snapshot.unit}{' '}
· {money(l.subtotal_minor + l.tax_minor)}
</li>
))}
</ul>
{canManage &&
invoice.status === 'pending' &&
invoice.created_by !== auth.user.id && (
<Button
disabled={validating !== null}
onClick={() => {
setValidationError('');
setValidating(invoice.id);
router.post(
`/facturas/${invoice.id}/validar`,
{},
{
onError: (errors) =>
setValidationError(
Object.values(
errors,
).join(' '),
),
onFinish: () =>
setValidating(null),
},
);
}}
>
Conferir e validar
</Button>
)}
</Panel>
))}
{invoices.data.length === 0 && (
<p>Sem facturas registadas nesta empresa.</p>
)}
<InventoryPagination page={invoices} />
</div>
</>
);
}
+148 -24
View File
@@ -1,4 +1,4 @@
import { Head, Link } from '@inertiajs/react';
import { Head, Link, router } from '@inertiajs/react';
import { useState } from 'react';
import {
ArrowRight,
@@ -14,6 +14,8 @@ import {
Search,
ShieldCheck,
Users,
PackageCheck,
Warehouse,
} from 'lucide-react';
import { PageTitle, Panel, Status } from '@/components/procurement';
import { Button } from '@/components/ui/button';
@@ -27,6 +29,10 @@ import {
DialogTitle,
} from '@/components/ui/dialog';
import { money } from '@/types/procurement';
import { previewPaths } from '@/lib/preview-navigation';
import InventoryDemo from './inventory-demo';
import { OperationsDemo } from '../stock/operations';
import { EquipmentDemo } from '../equipment';
// Static examples only: this page never loads or submits business data.
const requests = [
@@ -108,19 +114,37 @@ const navigation = [
{ id: 'quotes', title: 'Cotações', icon: Scale },
{ id: 'conflicts', title: 'Conflitos de interesses', icon: ShieldCheck },
{ id: 'orders', title: 'Ordens de compra', icon: FileText },
{ id: 'receipts', title: 'Recepção e qualidade', icon: PackageCheck },
{ id: 'stock', title: 'Stock e movimentos', icon: Warehouse },
{ id: 'operations', title: 'Saídas e inventários', icon: Warehouse },
{ id: 'equipment', title: 'Equipamentos e peças', icon: Warehouse },
{ id: 'invoices', title: 'Facturas e conferência', icon: FileText },
{ id: 'bank', title: 'Dados bancários', icon: ShieldCheck },
{ id: 'appearance', title: 'Cores e componentes', icon: Palette },
];
type Detail = { title: string; subtitle: string; rows: [string, string][] };
export default function Preview() {
const [screen, setScreen] = useState('overview');
const navigationGroups = [
{ title: 'Geral', ids: ['overview'] },
{ title: 'Compras', ids: ['requests', 'suppliers', 'quotes', 'orders'] },
{ title: 'Armazém', ids: ['receipts', 'stock', 'operations', 'equipment'] },
{ title: 'Controlo', ids: ['conflicts'] },
{ title: 'Finanças', ids: ['invoices', 'bank'] },
{ title: 'Apresentação', ids: ['appearance'] },
];
export default function Preview({
initialScreen = 'overview',
}: {
initialScreen?: string;
}) {
const screen = initialScreen;
const [search, setSearch] = useState('');
const [menu, setMenu] = useState(false);
const [detail, setDetail] = useState<Detail | null>(null);
const title = navigation.find((n) => n.id === screen)?.title ?? 'Consulta';
function navigate(id: string) {
setScreen(id);
setSearch('');
setMenu(false);
router.get(previewPaths[id] ?? '/consulta');
}
const filteredRequests = requests.filter((r) =>
`${r.number} ${r.title} ${r.department}`
@@ -205,13 +229,13 @@ export default function Preview() {
className={`${menu ? 'flex' : 'hidden'} fixed inset-y-0 left-0 z-30 w-64 flex-col border-r bg-background p-5 lg:flex`}
>
<Link
href="/consulta"
href="/"
className="mb-8 flex items-center gap-3 text-xl font-semibold"
>
<span className="grid size-9 place-items-center rounded-xl bg-teal-700 text-sm text-white">
PF
SGC
</span>
ProcuraFlow
SGC
</Link>
<div className="mb-7 rounded-xl border bg-muted/30 p-4">
<p className="flex items-center gap-2 text-sm font-semibold">
@@ -222,20 +246,34 @@ export default function Preview() {
Consulta livre · sem autenticação
</p>
</div>
<nav className="space-y-2">
{navigation.map((n) => (
<button
type="button"
key={n.id}
onClick={() => navigate(n.id)}
aria-current={
screen === n.id ? 'page' : undefined
}
className={`flex w-full items-center gap-3 rounded-lg px-3 py-3 text-left text-sm transition-colors ${screen === n.id ? 'bg-teal-50 font-medium text-teal-800 dark:bg-teal-950 dark:text-teal-200' : 'text-muted-foreground hover:bg-muted'}`}
>
<n.icon className="size-4" />
{n.title}
</button>
<nav
aria-label="Áreas da demonstração"
className="space-y-4"
>
{navigationGroups.map((group) => (
<div key={group.title}>
<p className="mb-1 px-3 text-[10px] font-semibold tracking-widest text-muted-foreground uppercase">
{group.title}
</p>
{navigation
.filter((n) => group.ids.includes(n.id))
.map((n) => (
<Link
href={previewPaths[n.id]}
key={n.id}
onClick={() => setMenu(false)}
aria-current={
screen === n.id
? 'page'
: undefined
}
className={`flex w-full items-center gap-3 rounded-lg px-3 py-3 text-left text-sm transition-colors ${screen === n.id ? 'bg-teal-50 font-medium text-teal-800 dark:bg-teal-950 dark:text-teal-200' : 'text-muted-foreground hover:bg-muted'}`}
>
<n.icon className="size-4" />
{n.title}
</Link>
))}
</div>
))}
</nav>
<p className="mt-auto pt-8 text-xs leading-5 text-muted-foreground">
@@ -287,7 +325,7 @@ export default function Preview() {
</span>
</div>
<PageTitle
eyebrow="ProcuraFlow · Demonstração"
eyebrow="SGC · Demonstração"
title={title}
description="Explore os exemplos para verificar a organização, os ecrãs, as cores e a navegação. Os dados apresentados não pertencem à sua empresa."
/>
@@ -621,6 +659,92 @@ export default function Preview() {
</div>
</Panel>
)}
{(screen === 'receipts' || screen === 'stock') && (
<InventoryDemo key={screen} screen={screen} />
)}
{screen === 'operations' && <OperationsDemo />}
{screen === 'equipment' && <EquipmentDemo />}
{screen === 'bank' && (
<Panel
title="Dupla validação bancária · exemplo fictício"
description="Sem dados de contas, consultas ou gravações de negócio."
>
<div className="space-y-3 text-sm">
<p>
Procurement propõe uma versão com
evidência. Finanças A confere e aprova;
Finanças B confere de forma
independente.
</p>
<p>
Uma aprovação: pendente. Duas pessoas
distintas: duplamente validado. Repetir
a decisão da mesma pessoa não conta duas
vezes.
</p>
<p>
Nova versão: disponibilidade anterior
substituída e duas novas validações
obrigatórias. Rejeição, conflito ou
perda de elegibilidade bloqueiam o
estado.
</p>
<p>
Cada empresa mantém os seus fornecedores
e dados. Não autoriza transferências nem
confirma titularidade junto do banco.
</p>
</div>
</Panel>
)}
{screen === 'invoices' && (
<Panel
title="Factura parcial · exemplo fictício"
description="Sem consultas ou gravações de negócio. Os valores são apenas exemplos; cada empresa define as suas dotações e base de IVA."
>
<p className="mb-4 text-sm">
FT-DEMO-01 · Fornecedor fictício ·
OC-DEMO-01 · Validada por uma segunda pessoa
de Finanças.
</p>
<dl className="grid gap-3 text-sm sm:grid-cols-2">
<div>
<dt>Quantidade autorizada e aceite</dt>
<dd>10 unidades</dd>
</div>
<div>
<dt>Quantidade facturada</dt>
<dd>6 unidades</dd>
</div>
<div>
<dt>Valor desta factura</dt>
<dd>600,00 MZN (exemplo sem IVA)</dd>
</div>
<div>
<dt>
Compromisso antes da conferência
</dt>
<dd>1.000,00 MZN</dd>
</div>
<div>
<dt>Consumo após validação</dt>
<dd>600,00 MZN</dd>
</div>
<div>
<dt>Compromisso remanescente</dt>
<dd>400,00 MZN</dd>
</div>
</dl>
<p className="mt-4 text-sm">
O disponível não aumenta: o compromisso
converte-se em consumo. Preço, unidade, IVA
e quantidades são novamente conferidos no
servidor. Sem compromisso aprovado, a
factura permanece pendente. Não autoriza
pagamentos.
</p>
</Panel>
)}
{screen === 'appearance' && (
<>
<Panel
@@ -708,8 +832,8 @@ export default function Preview() {
</>
)}
<footer className="py-4 text-xs text-muted-foreground">
ProcuraFlow · Consulta pública de exemplos · Os
processos reais permanecem no acesso autenticado.
SGC · Consulta pública de exemplos · Os processos
reais permanecem no acesso autenticado.
</footer>
</main>
</div>
@@ -0,0 +1,344 @@
import { useState } from 'react';
import { InventoryNotice, ReceiptProgressTable } from '@/components/inventory';
import { Panel, controlClass } from '@/components/procurement';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { Label } from '@/components/ui/label';
import {
Dialog,
DialogContent,
DialogDescription,
DialogHeader,
DialogTitle,
} from '@/components/ui/dialog';
import { quantity } from '@/types/inventory';
import type { ReceiptProgress } from '@/types/inventory';
const progress: ReceiptProgress = {
state: 'partial',
has_divergences: true,
lines: [
{
id: 1,
description: 'Papel A4 de demonstração',
unit: 'cx',
purchase_type: 'consumable',
ordered_milli: 10000,
received_milli: 6000,
accepted_milli: 5000,
rejected_milli: 1000,
delivery_pending_milli: 4000,
acceptance_pending_milli: 5000,
},
{
id: 2,
description: 'Tinteiro de demonstração',
unit: 'un',
purchase_type: 'consumable',
ordered_milli: 3000,
received_milli: 3000,
accepted_milli: 3000,
rejected_milli: 0,
delivery_pending_milli: 0,
acceptance_pending_milli: 0,
},
],
};
const examples = [
{
code: 'DEMO-A4',
name: 'Papel A4 de demonstração',
unit: 'cx',
quantity_milli: 5000,
warehouse: 'Armazém de demonstração',
receipt: 'REC-DEMO-001',
note: 'Uma caixa rejeitada por danos; só cinco caixas aceites entraram em stock.',
},
{
code: 'DEMO-TINTA',
name: 'Tinteiro de demonstração',
unit: 'un',
quantity_milli: 3000,
warehouse: 'Armazém de demonstração',
receipt: 'REC-DEMO-001',
note: 'Três unidades recebidas e aceites integralmente.',
},
];
export default function InventoryDemo({
screen,
}: {
screen: 'receipts' | 'stock';
}) {
const [search, setSearch] = useState('');
const [detail, setDetail] = useState<(typeof examples)[number] | null>(
null,
);
const [quality, setQuality] = useState('reservations');
const [notice, setNotice] = useState(false);
const visible = examples.filter((example) =>
`${example.code} ${example.name}`
.toLowerCase()
.includes(search.toLowerCase()),
);
return (
<>
<InventoryNotice />
{screen === 'receipts' ? (
<>
<Panel
title="OC-DEMO-001 · Recepção parcial"
description="Exemplo fictício: seis caixas conferidas, cinco aceites e uma rejeitada. Existem quatro caixas por entregar."
>
<ReceiptProgressTable progress={progress} />
<p className="mt-4 text-sm text-muted-foreground">
Emitente: Comprador de exemplo · Recepção: Armazém
de exemplo. São pessoas distintas.
</p>
</Panel>
<Panel
title="Conferência de qualidade"
description="Experimente os campos. Este formulário é local, não é enviado e não confirma recepções reais."
>
<form
className="space-y-4"
onSubmit={(event) => {
event.preventDefault();
setNotice(true);
}}
>
<div className="grid gap-4 md:grid-cols-3">
<div className="space-y-2">
<Label htmlFor="demo-guide">
Guia fictícia
</Label>
<Input
id="demo-guide"
defaultValue="GR-DEMO-001"
/>
</div>
<div className="space-y-2">
<Label htmlFor="demo-received">
Quantidade recebida
</Label>
<Input
id="demo-received"
type="number"
min="0.001"
step="0.001"
defaultValue="6"
/>
</div>
<div className="space-y-2">
<Label htmlFor="demo-quality">
Qualidade
</Label>
<select
id="demo-quality"
className={controlClass}
value={quality}
onChange={(event) =>
setQuality(event.target.value)
}
>
<option value="compliant">
Conforme
</option>
<option value="reservations">
Conforme com reservas
</option>
<option value="nonconforming">
Não conforme
</option>
</select>
</div>
<div className="space-y-2">
<Label htmlFor="demo-accepted">
Quantidade aceite
</Label>
<Input
id="demo-accepted"
type="number"
min="0"
step="0.001"
defaultValue="5"
/>
</div>
<div className="space-y-2">
<Label htmlFor="demo-location">
Destino fictício
</Label>
<select
id="demo-location"
className={controlClass}
>
<option>Armazém de demonstração</option>
</select>
</div>
<div className="space-y-2">
<Label htmlFor="demo-article">
Artigo fictício
</Label>
<select
id="demo-article"
className={controlClass}
>
<option>
DEMO-A4 · Papel A4 de demonstração
</option>
</select>
</div>
</div>
<div className="space-y-2">
<Label htmlFor="demo-divergence">
Divergências
</Label>
<textarea
id="demo-divergence"
className={`${controlClass} h-24 py-3`}
defaultValue="Uma caixa com danos na embalagem e humidade. Rejeitada e sem entrada em stock."
/>
</div>
<Button>Pré-visualizar conferência fictícia</Button>
{notice && (
<p
role="status"
className="text-sm text-teal-700 dark:text-teal-400"
>
Demonstração local: nenhum dado foi
guardado. No módulo autenticado, o servidor
verifica quantidades, segregação e
duplicações.
</p>
)}
</form>
</Panel>
</>
) : (
<>
<Panel
title="Existências fictícias"
description="Somente quantidades aceites. Pesquise e abra os detalhes para rever a apresentação."
>
<Input
aria-label="Pesquisar artigos fictícios"
placeholder="Pesquisar código ou artigo de demonstração"
value={search}
onChange={(event) => setSearch(event.target.value)}
className="mb-5 max-w-sm"
/>
<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 className="pr-4">Em stock</th>
<th>Histórico</th>
</tr>
</thead>
<tbody>
{visible.map((example) => (
<tr
className="border-b last:border-0"
key={example.code}
>
<td className="py-4 pr-4">
<strong>{example.code}</strong>
<p className="mt-1 text-muted-foreground">
{example.name}
</p>
</td>
<td className="pr-4">
{example.warehouse}
</td>
<td className="pr-4">
{quantity(
example.quantity_milli,
)}{' '}
{example.unit}
</td>
<td>
<Button
variant="outline"
onClick={() =>
setDetail(example)
}
>
Ver movimentos
</Button>
</td>
</tr>
))}
</tbody>
</table>
</div>
{visible.length === 0 && (
<p className="py-5 text-sm text-muted-foreground">
Nenhum exemplo corresponde à pesquisa.
</p>
)}
</Panel>
<Panel title="Histórico de entradas fictícias">
<div className="space-y-3">
{visible.map((example) => (
<button
type="button"
onClick={() => setDetail(example)}
key={example.code}
className="w-full rounded-lg border p-4 text-left text-sm"
>
<strong>
+{quantity(example.quantity_milli)}{' '}
{example.unit} · {example.code}
</strong>
<p className="mt-1 text-muted-foreground">
{example.receipt} · OC-DEMO-001 · Guia
GR-DEMO-001
</p>
</button>
))}
</div>
<p className="mt-4 text-xs text-muted-foreground">
Os exemplos não correspondem a existências da
empresa. Consulte Saídas e inventários para rever os
novos exemplos fictícios.
</p>
</Panel>
</>
)}
<Dialog
open={detail !== null}
onOpenChange={(open) => {
if (!open) setDetail(null);
}}
>
<DialogContent>
<DialogHeader>
<DialogTitle>
{detail?.code} · Entrada fictícia
</DialogTitle>
<DialogDescription>
Histórico ilustrativo, sem acesso aos registos
reais.
</DialogDescription>
</DialogHeader>
{detail && (
<div className="space-y-3 text-sm">
<p>
{detail.name} · +
{quantity(detail.quantity_milli)} {detail.unit}
</p>
<p>{detail.receipt} · OC-DEMO-001 · GR-DEMO-001</p>
<p>{detail.note}</p>
<p>
Confirmado por Armazém de exemplo, distinto do
emitente.
</p>
</div>
)}
</DialogContent>
</Dialog>
</>
);
}
+6
View File
@@ -28,6 +28,12 @@ export default function OrderShow({
return (
<>
<Head title={order.number} />
<Link
href={`/ordens/${order.id}/recepcoes`}
className="mx-auto mt-4 w-full max-w-6xl px-5 text-sm font-medium text-teal-700 dark:text-teal-400"
>
Recepções, qualidade e quantidades pendentes
</Link>
<div className="mx-auto flex w-full max-w-6xl flex-col gap-7 p-5 lg:p-8">
<PageTitle
eyebrow={snapshot.company.name}
+94
View File
@@ -0,0 +1,94 @@
import { Head, Link } from '@inertiajs/react';
import { InventoryNotice, InventoryPagination } from '@/components/inventory';
import { PageTitle, Panel } from '@/components/procurement';
import { date } from '@/types/procurement';
import { receiptStates } from '@/types/inventory';
import type { Page, Receipt, ReceiptProgress } from '@/types/inventory';
type IncomingOrder = {
id: number;
number: string;
supplier_name: string;
progress: ReceiptProgress;
};
export default function Receipts({
orders,
receipts,
}: {
orders: Page<IncomingOrder>;
receipts: Page<Receipt>;
}) {
return (
<>
<Head title="Recepção de bens" />
<div className="mx-auto flex w-full max-w-7xl flex-col gap-7 p-5 lg:p-8">
<PageTitle
eyebrow="Conferência e armazém"
title="Recepção de bens e serviços"
description="Recepções parciais e totais, conferência de qualidade e quantidades pendentes por ordem emitida."
/>
<InventoryNotice />
<Panel title="Ordens para conferência">
<div className="divide-y">
{orders.data.map((order) => (
<Link
key={order.id}
href={`/ordens/${order.id}/recepcoes`}
className="flex flex-wrap items-center justify-between gap-3 py-4 text-sm"
>
<div>
<strong>{order.number}</strong>
<p className="mt-1 text-muted-foreground">
{order.supplier_name}
</p>
</div>
<span>
{receiptStates[order.progress.state]}
</span>
</Link>
))}
</div>
{orders.data.length === 0 && (
<p className="py-6 text-sm text-muted-foreground">
Ainda não existem ordens emitidas disponíveis para o
seu perfil.
</p>
)}
<InventoryPagination page={orders} />
</Panel>
<Panel title="Histórico de confirmações">
<div className="divide-y">
{receipts.data.map((receipt) => (
<Link
key={receipt.id}
href={`/recepcoes/${receipt.id}`}
className="flex flex-wrap justify-between gap-3 py-4 text-sm"
>
<div>
<strong>{receipt.number}</strong> ·{' '}
{receipt.snapshot.order.number}
<p className="mt-1 text-muted-foreground">
Guia {receipt.delivery_note} ·{' '}
{receipt.snapshot.receiver.name}
</p>
</div>
<span>
{date(receipt.received_on)} ·{' '}
{receiptStates[receipt.status]}
</span>
</Link>
))}
</div>
{receipts.data.length === 0 && (
<p className="py-6 text-sm text-muted-foreground">
As recepções confirmadas ficam preservadas neste
histórico.
</p>
)}
<InventoryPagination page={receipts} />
</Panel>
</div>
</>
);
}
Receipts.layout = { breadcrumbs: [{ title: 'Recepção', href: '/recepcoes' }] };
+562
View File
@@ -0,0 +1,562 @@
import { Head, Link, useForm } from '@inertiajs/react';
import { InventoryNotice, ReceiptProgressTable } 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 { quantity, qualityStates, receiptStates } from '@/types/inventory';
import type {
Receipt,
ReceiptProgress,
StockItem,
Warehouse,
} from '@/types/inventory';
type Line = {
include: boolean;
purchase_order_item_id: number;
received_quantity: string;
accepted_quantity: string;
quality_status: string;
notes: string;
stock_item_id: string;
};
type Props = {
order: { id: number; number: string };
supplier_name: string;
progress: ReceiptProgress;
receipts: Receipt[];
warehouses: Warehouse[];
stockItems: StockItem[];
canConfirm: boolean;
};
export default function ReceiveOrder({
order,
supplier_name,
progress,
receipts,
warehouses,
stockItems,
canConfirm,
}: Props) {
const form = useForm({
idempotency_key: crypto.randomUUID(),
delivery_note: '',
received_on: '',
warehouse_id: '',
items: progress.lines.map((line) => ({
include: false,
purchase_order_item_id: line.id,
received_quantity: '',
accepted_quantity: '',
quality_status: 'compliant',
notes: '',
stock_item_id: '',
})),
});
const change = (index: number, updates: Partial<Line>) =>
form.setData(
'items',
form.data.items.map((line, i) =>
i === index ? { ...line, ...updates } : line,
),
);
const outstanding = progress.lines.some(
(line) => line.delivery_pending_milli > 0,
);
return (
<>
<Head title={`Receber ${order.number}`} />
<div className="mx-auto flex w-full max-w-6xl flex-col gap-7 p-5 lg:p-8">
<PageTitle
eyebrow={order.number}
title="Conferir entrega"
description={supplier_name}
/>
<InventoryNotice />
<Panel title="Quantidades da ordem">
<ReceiptProgressTable progress={progress} />
<p className="mt-4 text-xs text-muted-foreground">
As quantidades rejeitadas contam como conferidas, mas
não entram em stock. Substituições ou reposições após
rejeição não são autorizadas automaticamente.
</p>
</Panel>
{canConfirm && outstanding ? (
<Panel
title="Confirmar recepção"
description="A confirmação é definitiva e auditada. O emitente da ordem não pode confirmar a recepção."
>
<form
className="space-y-5"
onSubmit={(e) => {
e.preventDefault();
form.transform((data) => ({
...data,
warehouse_id: data.warehouse_id || null,
items: data.items
.filter((line) => line.include)
.map(
({
include: _include,
...line
}) => ({
...line,
stock_item_id:
line.stock_item_id || null,
}),
),
}));
form.post(`/ordens/${order.id}/recepcoes`);
}}
>
<FormErrors errors={form.errors} />
<div className="grid gap-4 md:grid-cols-3">
<div className="space-y-2">
<Label htmlFor="receipt-note">
Guia de remessa
</Label>
<Input
id="receipt-note"
required
maxLength={100}
value={form.data.delivery_note}
onChange={(e) =>
form.setData(
'delivery_note',
e.target.value,
)
}
/>
</div>
<div className="space-y-2">
<Label htmlFor="receipt-date">
Data da recepção
</Label>
<Input
id="receipt-date"
type="date"
required
value={form.data.received_on}
onChange={(e) =>
form.setData(
'received_on',
e.target.value,
)
}
/>
</div>
<div className="space-y-2">
<Label htmlFor="receipt-warehouse">
Armazém (para bens aceites)
</Label>
<select
id="receipt-warehouse"
className={controlClass}
value={form.data.warehouse_id}
onChange={(e) =>
form.setData(
'warehouse_id',
e.target.value,
)
}
>
<option value="">Seleccione</option>
{warehouses.map((w) => (
<option key={w.id} value={w.id}>
{w.code} · {w.name}
</option>
))}
</select>
</div>
</div>
<div className="space-y-5">
{progress.lines.map(
(source, index) =>
source.delivery_pending_milli > 0 && (
<fieldset
className="rounded-xl border p-4"
key={source.id}
>
<legend className="px-2 text-sm font-semibold">
{source.description} · Por
entregar{' '}
{quantity(
source.delivery_pending_milli,
)}{' '}
{source.unit}
</legend>
<label className="mb-4 flex items-center gap-3 text-sm">
<input
type="checkbox"
checked={
form.data.items[
index
].include
}
onChange={(e) =>
change(index, {
include:
e.target
.checked,
})
}
/>
Incluir nesta recepção
</label>
{form.data.items[index]
.include && (
<div className="grid gap-4 md:grid-cols-2">
<div className="space-y-2">
<Label
htmlFor={`received-${source.id}`}
>
Quantidade
recebida
</Label>
<Input
id={`received-${source.id}`}
type="number"
required
min="0.001"
step="0.001"
max={
source.delivery_pending_milli /
1000
}
value={
form.data
.items[
index
]
.received_quantity
}
onChange={(e) =>
change(
index,
{
received_quantity:
e
.target
.value,
...(form
.data
.items[
index
]
.quality_status ===
'compliant'
? {
accepted_quantity:
e
.target
.value,
}
: {}),
},
)
}
/>
</div>
<div className="space-y-2">
<Label
htmlFor={`quality-${source.id}`}
>
Qualidade
</Label>
<select
id={`quality-${source.id}`}
className={
controlClass
}
value={
form.data
.items[
index
]
.quality_status
}
onChange={(e) =>
change(
index,
{
quality_status:
e
.target
.value,
...(e
.target
.value ===
'nonconforming'
? {
accepted_quantity:
'0',
stock_item_id:
'',
}
: e
.target
.value ===
'compliant'
? {
accepted_quantity:
form
.data
.items[
index
]
.received_quantity,
}
: {}),
},
)
}
>
{Object.entries(
qualityStates,
).map(
([
value,
label,
]) => (
<option
key={
value
}
value={
value
}
>
{
label
}
</option>
),
)}
</select>
</div>
<div className="space-y-2">
<Label
htmlFor={`accepted-${source.id}`}
>
Quantidade
aceite
</Label>
<Input
id={`accepted-${source.id}`}
type="number"
required
min="0"
step="0.001"
readOnly={
form.data
.items[
index
]
.quality_status !==
'reservations'
}
value={
form.data
.items[
index
]
.accepted_quantity
}
onChange={(e) =>
change(
index,
{
accepted_quantity:
e
.target
.value,
},
)
}
/>
</div>
{source.purchase_type !==
'service' ? (
<div className="space-y-2">
<Label
htmlFor={`stock-${source.id}`}
>
Artigo de
stock ·
unidade{' '}
{
source.unit
}
</Label>
<select
id={`stock-${source.id}`}
className={
controlClass
}
value={
form
.data
.items[
index
]
.stock_item_id
}
onChange={(
e,
) =>
change(
index,
{
stock_item_id:
e
.target
.value,
},
)
}
>
<option value="">
Seleccione
para a
quantidade
aceite
</option>
{stockItems
.filter(
(
item,
) =>
item.unit.toLowerCase() ===
source.unit.toLowerCase(),
)
.map(
(
item,
) => (
<option
key={
item.id
}
value={
item.id
}
>
{
item.code
}{' '}
·{' '}
{
item.name
}
</option>
),
)}
</select>
</div>
) : (
<p className="self-center text-sm text-muted-foreground">
Serviço: a
aceitação não
cria existências
físicas.
</p>
)}
<div className="space-y-2 md:col-span-2">
<Label
htmlFor={`notes-${source.id}`}
>
Observações e
divergências
</Label>
<textarea
id={`notes-${source.id}`}
className={`${controlClass} h-24 py-3`}
required={
form.data
.items[
index
]
.quality_status !==
'compliant'
}
maxLength={3000}
value={
form.data
.items[
index
].notes
}
onChange={(e) =>
change(
index,
{
notes: e
.target
.value,
},
)
}
/>
</div>
</div>
)}
</fieldset>
),
)}
</div>
<p className="text-xs text-muted-foreground">
Configure previamente os armazéns e artigos em
Stock. Não existem conversões automáticas de
unidade, tolerâncias de excesso ou saldo inicial
manual.
</p>
<Button disabled={form.processing}>
Confirmar recepção e entradas aceites
</Button>
</form>
</Panel>
) : (
<p className="text-sm text-muted-foreground">
{outstanding
? 'A confirmação exige o perfil Recepção / Armazém e uma pessoa distinta do emitente.'
: 'Não existem quantidades de entrega pendentes nesta ordem.'}
</p>
)}
<Panel title="Recepções anteriores">
<div className="divide-y">
{receipts.map((receipt) => (
<Link
key={receipt.id}
href={`/recepcoes/${receipt.id}`}
className="flex flex-wrap justify-between gap-3 py-3 text-sm"
>
<span>
{receipt.number} · Guia{' '}
{receipt.delivery_note}
</span>
<span>{receiptStates[receipt.status]}</span>
</Link>
))}
</div>
{receipts.length === 0 && (
<p className="text-sm text-muted-foreground">
Ainda não há recepções confirmadas.
</p>
)}
</Panel>
</div>
</>
);
}
ReceiveOrder.layout = {
breadcrumbs: [
{ title: 'Recepção', href: '/recepcoes' },
{ title: 'Conferir ordem', href: '#' },
],
};
+123
View File
@@ -0,0 +1,123 @@
import { Head, Link } from '@inertiajs/react';
import { InventoryNotice } from '@/components/inventory';
import { PageTitle, Panel } from '@/components/procurement';
import { date } from '@/types/procurement';
import { quantity, qualityStates, receiptStates } from '@/types/inventory';
import type { Receipt, StockMovement } from '@/types/inventory';
export default function ReceiptShow({
receipt,
movements,
}: {
receipt: Receipt;
movements: StockMovement[];
}) {
return (
<>
<Head title={receipt.number} />
<div className="mx-auto flex w-full max-w-6xl flex-col gap-7 p-5 lg:p-8">
<PageTitle
eyebrow={receipt.snapshot.order.number}
title={receipt.number}
description={`${receipt.snapshot.supplier.name} · ${receiptStates[receipt.status]}`}
/>
<InventoryNotice />
<Panel title="Confirmação preservada">
<dl className="grid gap-5 text-sm sm:grid-cols-3">
<div>
<dt className="text-muted-foreground">
Guia de remessa
</dt>
<dd>{receipt.delivery_note}</dd>
</div>
<div>
<dt className="text-muted-foreground">
Recebido em / por
</dt>
<dd>
{date(receipt.received_on)} ·{' '}
{receipt.snapshot.receiver.name}
</dd>
</div>
<div>
<dt className="text-muted-foreground">Armazém</dt>
<dd>
{receipt.snapshot.warehouse?.name ??
'Sem entrada física'}
</dd>
</div>
</dl>
</Panel>
<Panel title="Quantidade, qualidade e divergências">
<div className="space-y-5">
{receipt.items.map((line) => (
<div
className="rounded-lg border p-4 text-sm"
key={line.id}
>
<h3 className="font-semibold">
{line.snapshot.order_item.description} ·{' '}
{qualityStates[line.quality_status]}
</h3>
<p className="mt-2">
Recebido: {quantity(line.received_milli)} ·
Aceite: {quantity(line.accepted_milli)} ·
Rejeitado: {quantity(line.rejected_milli)}{' '}
{line.snapshot.order_item.unit}
</p>
<p className="mt-2 text-muted-foreground">
{line.snapshot.stock_item
? `${line.snapshot.stock_item.code} · ${line.snapshot.stock_item.name}`
: line.snapshot.physical
? 'Sem quantidade aceite em stock.'
: 'Serviço, sem movimento físico.'}
</p>
{line.notes && (
<p className="mt-3 whitespace-pre-wrap">
{line.notes}
</p>
)}
</div>
))}
</div>
</Panel>
<Panel title="Entradas ligadas a esta recepção">
<div className="space-y-3">
{movements.map((movement) => (
<p className="text-sm" key={movement.id}>
Movimento #{movement.id} · +
{quantity(movement.quantity_milli)}{' '}
{movement.snapshot.stock_item.unit} ·{' '}
{movement.snapshot.stock_item.code} ·{' '}
{movement.snapshot.warehouse.name}
</p>
))}
{movements.length === 0 && (
<p className="text-sm text-muted-foreground">
Não houve entradas de bens aceites nesta
confirmação.
</p>
)}
</div>
<p className="mt-4 text-xs text-muted-foreground">
A confirmação e os movimentos não podem ser editados ou
eliminados. Repetir a mesma confirmação não cria novas
entradas.
</p>
</Panel>
<Link
href={`/ordens/${receipt.purchase_order_id}/recepcoes`}
className="text-sm text-teal-700 dark:text-teal-400"
>
Consultar a ordem e as quantidades pendentes
</Link>
</div>
</>
);
}
ReceiptShow.layout = {
breadcrumbs: [
{ title: 'Recepção', href: '/recepcoes' },
{ title: 'Confirmação', href: '#' },
],
};
+180
View File
@@ -21,6 +21,10 @@ type Line = {
unit: string;
unit_price: string;
tax_rate: string;
equipment_id: string;
spare_part_id: string;
production_area: string;
downtime_started_at: string;
};
const emptyLine = (): Line => ({
key: crypto.randomUUID(),
@@ -31,6 +35,10 @@ const emptyLine = (): Line => ({
unit: 'un',
unit_price: '',
tax_rate: '0',
equipment_id: '',
spare_part_id: '',
production_area: '',
downtime_started_at: '',
});
const lineFields = [
{ key: 'description', label: 'Descrição', type: 'text', maxLength: 255 },
@@ -65,9 +73,15 @@ const lineFields = [
export default function RequisitionForm({
costCenters,
requisition,
equipment = [],
spareParts = [],
stockItems = [],
}: {
costCenters: CostCenter[];
requisition: Requisition | null;
equipment?: { id: number; code: string; description: string }[];
spareParts?: { id: number; stock_item_id: number }[];
stockItems?: { id: number; code: string; name: string; unit: string }[];
}) {
const form = useForm({
cost_center_id: requisition ? String(requisition.cost_center_id) : '',
@@ -83,6 +97,10 @@ export default function RequisitionForm({
unit: i.unit,
unit_price: (i.unit_price_minor / 100).toFixed(2),
tax_rate: String(i.tax_rate),
equipment_id: i.equipment_id ? String(i.equipment_id) : '',
spare_part_id: i.spare_part_id ? String(i.spare_part_id) : '',
production_area: i.production_area ?? '',
downtime_started_at: i.downtime_started_at?.slice(0, 16) ?? '',
})) ?? [emptyLine()],
});
const changeLine = (index: number, field: keyof Line, value: string) =>
@@ -276,6 +294,14 @@ export default function RequisitionForm({
)
}
>
<option value="equipment">
Equipamento (emissão
bloqueada até definição da
regra de investimento)
</option>
<option value="spare_part">
Peça sobressalente
</option>
<option value="consumable">
Insumos / matéria-prima
</option>
@@ -286,6 +312,160 @@ export default function RequisitionForm({
Outro
</option>
</select>
{line.purchase_type ===
'equipment' && (
<label className="mt-3 grid gap-2 text-sm">
Área / linha de produção
<Input
required
value={
line.production_area
}
onChange={(e) =>
changeLine(
index,
'production_area',
e.target.value,
)
}
/>
</label>
)}
{line.purchase_type ===
'spare_part' && (
<div className="mt-3 grid gap-3">
<label className="grid gap-2 text-sm">
Equipamento do
departamento
<select
required
className={
controlClass
}
value={
line.equipment_id
}
onChange={(e) =>
changeLine(
index,
'equipment_id',
e.target
.value,
)
}
>
<option value="">
Seleccionar
</option>
{equipment.map(
(a) => (
<option
key={
a.id
}
value={
a.id
}
>
{a.code}{' '}
·{' '}
{
a.description
}
</option>
),
)}
</select>
</label>
<label className="grid gap-2 text-sm">
Peça cadastrada
<select
required
className={
controlClass
}
value={
line.spare_part_id
}
onChange={(e) =>
changeLine(
index,
'spare_part_id',
e.target
.value,
)
}
>
<option value="">
Seleccionar
</option>
{spareParts.map(
(p) => (
<option
key={
p.id
}
value={
p.id
}
>
{
stockItems.find(
(
s,
) =>
s.id ===
p.stock_item_id,
)
?.code
}{' '}
·{' '}
{
stockItems.find(
(
s,
) =>
s.id ===
p.stock_item_id,
)
?.name
}
</option>
),
)}
</select>
</label>
<label className="grid gap-2 text-sm">
Início da paragem
(obrigatório para peça
crítica urgente; hora
UTC)
<Input
type="datetime-local"
value={
line.downtime_started_at
}
onChange={(e) =>
changeLine(
index,
'downtime_started_at',
e.target
.value,
)
}
/>
</label>
<p className="text-xs text-muted-foreground">
Use a unidade do artigo.
A associação
peça/equipamento é
revalidada no servidor.
Urgência não dispensa
três cotações ou
aprovações.
</p>
</div>
)}
</div>
</div>
<div className="mt-3 flex justify-end">
+113
View File
@@ -32,14 +32,31 @@ export default function Show({
canDecide,
conflictBlocked,
audit,
technical,
}: {
requisition: Requisition;
canEdit: boolean;
canDecide: boolean;
conflictBlocked: boolean;
audit: Audit[];
technical?: {
canReview: boolean;
basis_hash: string;
reviews: {
id: number;
decision: string;
reason: string;
basis_hash: string;
snapshot: { reviewer: { name: string } };
}[];
};
}) {
const submission = useForm({});
const review = useForm({
basis_hash: technical?.basis_hash ?? '',
decision: 'approved',
reason: '',
});
const decision = useForm<{ decision: string; comment: string }>({
decision: 'approved',
comment: '',
@@ -55,6 +72,86 @@ export default function Show({
action={<Status value={r.status} />}
/>
<FormErrors errors={submission.errors} />
{r.items.some((i) => i.purchase_type === 'equipment') && (
<Panel title="Validação técnica do equipamento">
<p className="mb-4 text-sm">
Responsável da área, distinto do solicitante.
Finanças é obrigatória para qualquer valor. A
adjudicação e a emissão permanecem bloqueadas
enquanto o limite próprio de investimento e a sua
regra de aplicação não forem definidos. O orçamento
ainda não é validado; documentos de desenvolvimento
não autorizam compras reais.
</p>
{technical?.reviews.map((t) => (
<p
key={t.id}
className="mb-3 rounded-lg border p-3 text-sm"
>
{t.decision === 'approved'
? 'Validado'
: 'Rejeitado'}{' '}
por {t.snapshot.reviewer.name} ·{' '}
{t.basis_hash === technical.basis_hash
? 'Versão actual'
: 'Versão anterior, decisão preservada'}{' '}
· {t.reason}
</p>
))}
{technical?.canReview && (
<form
className="grid gap-3"
onSubmit={(e) => {
e.preventDefault();
review.transform((d) => ({
...d,
basis_hash: technical.basis_hash,
}));
review.post(
`/requisicoes/${r.id}/validacao-tecnica`,
);
}}
>
<select
aria-label="Decisão técnica"
className={controlClass}
value={review.data.decision}
onChange={(e) =>
review.setData(
'decision',
e.target.value,
)
}
>
<option value="approved">
Validar tecnicamente
</option>
<option value="rejected">
Rejeitar tecnicamente
</option>
</select>
<label className="grid gap-2 text-sm">
Fundamento técnico
<textarea
required
className={controlClass}
value={review.data.reason}
onChange={(e) =>
review.setData(
'reason',
e.target.value,
)
}
/>
</label>
<FormErrors errors={review.errors} />
<Button disabled={review.processing}>
Registar decisão técnica
</Button>
</form>
)}
</Panel>
)}
{conflictBlocked && (
<div className="rounded-lg border border-amber-200 bg-amber-50 p-4 text-sm text-amber-900 dark:border-amber-900 dark:bg-amber-950 dark:text-amber-100">
Existe um conflito de interesses activo que impede a
@@ -161,6 +258,22 @@ export default function Show({
<p className="mt-1 text-xs text-muted-foreground">
{i.category}
</p>
{i.equipment_id && (
<p className="mt-1 text-xs">
Equipamento #
{i.equipment_id} ·
Peça #
{i.spare_part_id}
{i.downtime_started_at &&
` · Paragem: ${i.downtime_started_at} UTC`}
</p>
)}
{i.production_area && (
<p className="mt-1 text-xs">
Área de destino:{' '}
{i.production_area}
</p>
)}
</td>
<td className="pr-3 whitespace-nowrap">
{Number(i.quantity)}{' '}
+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 }}
/>
);
}
+263
View File
@@ -0,0 +1,263 @@
import { Head, Link, useForm } from '@inertiajs/react';
import {
FormErrors,
Panel,
PageTitle,
controlClass,
} from '@/components/procurement';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
type Detail = {
id: number;
revision: number;
bank_name: string;
country: string;
currency: string;
beneficiary: string;
account_identifier: string;
evidence_reference: string;
reason: string;
};
type Props = {
supplier: { id: number; name: string };
current: Detail | null;
currentId: number;
state: string;
history: {
id: number;
revision: number;
created_by: number;
created_at: string;
}[];
reviews: {
id: number;
supplier_bank_detail_id: number;
reviewed_by: number;
decision: string;
}[];
canPropose: boolean;
canReview: boolean;
};
export default function Bank({
supplier,
current,
currentId,
state,
history,
reviews,
canPropose,
canReview,
}: Props) {
const form = useForm({
previous_id: currentId,
bank_name: '',
country: '',
currency: '',
beneficiary: '',
account_identifier: '',
evidence_reference: '',
reason: '',
});
const review = useForm({
decision: 'approved',
reason: '',
independently_verified: false,
});
const labels = {
bank_name: 'Banco',
country: 'Código do país (2 letras)',
currency: 'Moeda da conta (3 letras)',
beneficiary: 'Titular / beneficiário',
account_identifier: 'Identificador da conta fornecido pelo banco',
evidence_reference:
'Referência da evidência e confirmação independente',
reason: 'Fundamento da alteração',
};
const states: Record<string, string> = {
missing: 'Sem dados',
pending: 'Pendente de duas validações',
approved: 'Duplamente validado',
rejected: 'Rejeitado',
blocked: 'Bloqueado por elegibilidade ou conflito',
};
return (
<>
<Head title="Dados bancários" />
<div className="mx-auto grid w-full max-w-5xl gap-6 p-6">
<PageTitle
eyebrow="SGC · Fornecedores"
title={`Dados bancários · ${supplier.name}`}
description="Duas pessoas distintas de Finanças validam cada versão. Não autoriza transferências ou pagamentos."
/>
<Link href={`/fornecedores/${supplier.id}`}>
← Ficha do fornecedor
</Link>
<Panel
title={states[state] ?? state}
description="A versão mais recente substitui a anterior para efeitos de disponibilidade. A aprovação não confirma a titularidade junto do banco nem valida formatos bancários nacionais."
>
{current && (
<dl className="grid gap-4 text-sm sm:grid-cols-2">
{Object.entries(labels).map(([key, label]) => (
<div key={key}>
<dt className="text-muted-foreground">
{label}
</dt>
<dd className="break-all whitespace-pre-wrap">
{current[key as keyof typeof labels]}
</dd>
</div>
))}
</dl>
)}
{!current && (
<p className="text-sm">
Os identificadores bancários são apresentados apenas
a Procurement e Finanças. Administração consulta o
estado e o histórico.
</p>
)}
</Panel>
{canReview && current && state === 'pending' && (
<Panel title="Conferência independente">
<form
className="grid gap-4"
onSubmit={(e) => {
e.preventDefault();
review.post(
`/fornecedores/${supplier.id}/dados-bancarios/${current.id}/validar`,
);
}}
>
<FormErrors errors={review.errors} />
<label>
Decisão
<select
className={controlClass}
value={review.data.decision}
onChange={(e) =>
review.setData(
'decision',
e.target.value,
)
}
>
<option value="approved">Aprovar</option>
<option value="rejected">Rejeitar</option>
</select>
</label>
<label>
Fundamento da conferência
<textarea
required
className="w-full rounded border p-3"
value={review.data.reason}
onChange={(e) =>
review.setData('reason', e.target.value)
}
/>
</label>
<label className="flex gap-3">
<input
required
type="checkbox"
checked={review.data.independently_verified}
onChange={(e) =>
review.setData(
'independently_verified',
e.target.checked,
)
}
/>
Confirmo que conferi os dados e a evidência de
forma independente.
</label>
<Button disabled={review.processing}>
Guardar decisão imutável
</Button>
</form>
</Panel>
)}
{canPropose && (
<Panel
title="Propor nova versão"
description="Preencha integralmente os dados confirmados. A nova versão exige duas validações novas; a versão anterior permanece no histórico."
>
<form
className="grid gap-4"
onSubmit={(e) => {
e.preventDefault();
form.post(
`/fornecedores/${supplier.id}/dados-bancarios`,
{
onSuccess: (page) => {
form.reset();
form.setData(
'previous_id',
Number(page.props.currentId),
);
},
},
);
}}
>
<FormErrors errors={form.errors} />
{Object.entries(labels).map(([key, label]) => (
<label key={key}>
{label}
<Input
required
autoComplete="off"
value={
form.data[
key as keyof typeof labels
]
}
onChange={(e) =>
form.setData(
key as keyof typeof labels,
e.target.value,
)
}
/>
</label>
))}
<Button disabled={form.processing}>
Enviar para dupla validação
</Button>
</form>
</Panel>
)}
<Panel title="Histórico de versões e decisões">
<div className="space-y-4 text-sm">
{history.map((h) => (
<article key={h.id} className="rounded border p-3">
<p>
Versão {h.revision} · Autor #{h.created_by}{' '}
· {h.created_at}
</p>
{reviews
.filter(
(r) =>
r.supplier_bank_detail_id === h.id,
)
.map((r) => (
<p key={r.id}>
{r.decision === 'approved'
? 'Aprovado'
: 'Rejeitado'}{' '}
· Finanças #{r.reviewed_by}
</p>
))}
</article>
))}
{history.length === 0 && (
<p>Sem versões bancárias registadas.</p>
)}
</div>
</Panel>
</div>
</>
);
}
+8
View File
@@ -69,6 +69,14 @@ export default function SupplierShow({
}
/>
<Panel title="Dados do fornecedor">
{canDocuments && (
<Link
className="mb-4 inline-block font-semibold text-teal-700"
href={`/fornecedores/${supplier.id}/dados-bancarios`}
>
Dados bancários e dupla validação →
</Link>
)}
<dl className="grid gap-5 text-sm md:grid-cols-2">
{Object.entries(supplierFields).map(([key, label]) => (
<div key={key}>
+95
View File
@@ -0,0 +1,95 @@
export type StockItem = {
id: number;
code: string;
name: string;
unit: string;
};
export type Warehouse = { id: number; code: string; name: string };
export type ReceiptLineProgress = {
id: number;
description: string;
unit: string;
purchase_type: string;
ordered_milli: number;
received_milli: number;
accepted_milli: number;
rejected_milli: number;
delivery_pending_milli: number;
acceptance_pending_milli: number;
};
export type ReceiptProgress = {
lines: ReceiptLineProgress[];
state: string;
has_divergences: boolean;
};
export type ReceiptItem = {
id: number;
received_milli: number;
accepted_milli: number;
rejected_milli: number;
quality_status: string;
notes: string | null;
snapshot: {
order_item: { description: string; unit: string };
stock_item: StockItem | null;
warehouse: Warehouse | null;
physical: boolean;
};
};
export type Receipt = {
id: number;
number: string;
purchase_order_id: number;
delivery_note: string;
received_on: string;
confirmed_at: string;
status: string;
snapshot: {
order: { id: number; number: string };
supplier: { name: string };
receiver: { name: string };
warehouse: Warehouse | null;
};
items: ReceiptItem[];
};
export type StockMovement = {
id: number;
quantity_milli: number;
moved_at: string;
moved_by: number;
stock_item_id: number;
warehouse_id: number;
movement_type: string;
stock_operation_id?: number | null;
snapshot: {
stock_item: StockItem;
warehouse: Warehouse;
order_number?: string;
delivery_note?: string;
receipt_id?: number;
reference?: string;
reason?: string;
equipment?: { id: number; code: string; description: string } | null;
};
};
export type Page<T> = {
data: T[];
prev_page_url: string | null;
next_page_url: string | null;
};
export const quantity = (milli: number) =>
new Intl.NumberFormat('pt-MZ', { maximumFractionDigits: 3 }).format(
milli / 1000,
);
export const receiptStates: Record<string, string> = {
not_received: 'Sem recepção',
partial: 'Recepção parcial',
complete: 'Recepção total aceite',
rejected: 'Recepção rejeitada',
quality_pending: 'Entrega completa com divergências',
};
export const qualityStates: Record<string, string> = {
compliant: 'Conforme',
reservations: 'Conforme com reservas',
nonconforming: 'Não conforme',
};
+4
View File
@@ -18,6 +18,10 @@ export type RequisitionItem = {
description: string;
category: string;
purchase_type: string;
equipment_id?: number | null;
spare_part_id?: number | null;
production_area?: string | null;
downtime_started_at?: string | null;
quantity: string;
unit: string;
unit_price_minor: number;
+1 -1
View File
@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{{ $order->number }} · ProcuraFlow</title>
<title>{{ $order->number }} · SGC</title>
<style>
@page { size: A4; margin: 17mm; }
* { box-sizing: border-box; }
+21 -3
View File
@@ -1,9 +1,27 @@
<?php
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;
use Inertia\Inertia;
// Public visual consultation. No business records or authenticated identities.
Route::get('consulta', fn () => Inertia::render('preview/index', [
'auth' => ['user' => null],
]))->name('preview');
Route::get('consulta', function (Request $request) {
$screen = $request->query('ecra', 'overview');
$allowed = ['overview', 'requests', 'suppliers', 'quotes', 'conflicts', 'orders', 'receipts', 'stock', 'operations', 'equipment', 'invoices', 'bank', 'appearance'];
return Inertia::render('preview/index', [
'auth' => ['user' => null],
'initialScreen' => in_array($screen, $allowed, true) ? $screen : 'overview',
]);
})->name('preview');
Route::get('consulta/{screen}', function (string $screen) {
$screens = ['requisicoes' => 'requests', 'fornecedores' => 'suppliers', 'cotacoes' => 'quotes', 'conflitos' => 'conflicts', 'ordens' => 'orders', 'recepcoes' => 'receipts', 'stock' => 'stock', 'aparencia' => 'appearance'];
$screens['operacoes-stock'] = 'operations';
$screens['equipamentos'] = 'equipment';
$screens['facturas'] = 'invoices';
$screens['dados-bancarios'] = 'bank';
abort_unless(isset($screens[$screen]), 404);
return Inertia::render('preview/index', ['auth' => ['user' => null], 'initialScreen' => $screens[$screen]]);
})->name('preview.screen');
+29 -1
View File
@@ -1,16 +1,23 @@
<?php
use App\Http\Controllers\BudgetController;
use App\Http\Controllers\CompanyController;
use App\Http\Controllers\ConflictDeclarationController;
use App\Http\Controllers\EquipmentController;
use App\Http\Controllers\GoodsReceiptController;
use App\Http\Controllers\InvoiceController;
use App\Http\Controllers\PurchaseController;
use App\Http\Controllers\QuotationController;
use App\Http\Controllers\RequisitionController;
use App\Http\Controllers\StockController;
use App\Http\Controllers\StockOperationController;
use App\Http\Controllers\SupplierBankController;
use App\Http\Controllers\SupplierController;
use App\Http\Controllers\SupplierDocumentController;
use App\Http\Middleware\EnsureCompanyIsConfigured;
use Illuminate\Support\Facades\Route;
Route::redirect('/', '/consulta')->name('home');
Route::inertia('/', 'home', ['auth' => ['user' => null]])->name('home');
require __DIR__.'/preview.php';
Route::middleware(['auth', 'verified'])->group(function () {
@@ -19,6 +26,27 @@ Route::middleware(['auth', 'verified'])->group(function () {
Route::post('empresa/iniciar', [CompanyController::class, 'store'])->name('company.store');
Route::middleware(EnsureCompanyIsConfigured::class)->group(function () {
Route::get('fornecedores/{supplier}/dados-bancarios', [SupplierBankController::class, 'show'])->name('suppliers.bank');
Route::post('fornecedores/{supplier}/dados-bancarios', [SupplierBankController::class, 'store'])->name('suppliers.bank.store');
Route::post('fornecedores/{supplier}/dados-bancarios/{detail}/validar', [SupplierBankController::class, 'review'])->name('suppliers.bank.review');
Route::get('facturas', [InvoiceController::class, 'index'])->name('invoices.index');
Route::post('ordens/{order}/facturas', [InvoiceController::class, 'store'])->name('invoices.store');
Route::post('facturas/{invoice}/validar', [InvoiceController::class, 'validateInvoice'])->name('invoices.validate');
Route::get('orcamentos', [BudgetController::class, 'index'])->name('budgets.index');
Route::post('orcamentos', [BudgetController::class, 'store'])->name('budgets.store');
Route::post('orcamentos/{budget}/aprovar', [BudgetController::class, 'approve'])->name('budgets.approve');
Route::get('equipamentos', [EquipmentController::class, 'index'])->name('equipment.index');
Route::post('equipamentos/{kind}', [EquipmentController::class, 'store'])->name('equipment.store');
Route::post('requisicoes/{requisition}/validacao-tecnica', [RequisitionController::class, 'technical'])->name('requisitions.technical');
Route::get('recepcoes', [GoodsReceiptController::class, 'index'])->name('receipts.index');
Route::get('ordens/{order}/recepcoes', [GoodsReceiptController::class, 'order'])->name('receipts.order');
Route::post('ordens/{order}/recepcoes', [GoodsReceiptController::class, 'store'])->name('receipts.store');
Route::get('recepcoes/{receipt}', [GoodsReceiptController::class, 'show'])->name('receipts.show');
Route::get('stock', [StockController::class, 'index'])->name('stock.index');
Route::get('stock/operacoes', [StockOperationController::class, 'index'])->name('stock.operations');
Route::post('stock/operacoes', [StockOperationController::class, 'store'])->name('stock.operations.store');
Route::post('stock/artigos', [StockController::class, 'item'])->name('stock.items');
Route::post('stock/armazens', [StockController::class, 'warehouse'])->name('stock.warehouses');
Route::get('requisicoes/{requisition}/adjudicacao', [PurchaseController::class, 'award'])->name('purchases.award');
Route::post('requisicoes/{requisition}/adjudicacao', [PurchaseController::class, 'select'])->name('purchases.select');
Route::post('adjudicacoes/{award}/decidir', [PurchaseController::class, 'decide'])->name('purchases.decide');
+36
View File
@@ -0,0 +1,36 @@
<?php
use App\Models\Supplier;
use App\Models\SupplierBankDetail;
use App\Models\User;
use App\Services\SupplierBankWorkflow;
use Illuminate\Contracts\Console\Kernel;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException;
require __DIR__.'/../../vendor/autoload.php';
$database = $argv[1] ?? '';
if (! preg_match('/^compras_receipts_test_[a-f0-9]{12}$/', $database)) {
throw new LogicException('Base de teste inválida.');
}
$app = require __DIR__.'/../../bootstrap/app.php';
$app->make(Kernel::class)->bootstrap();
if (! $app->environment('testing') || DB::connection()->getDatabaseName() !== $database) {
throw new LogicException('Worker não isolado.');
}
DB::select('select set_config(?, ?, false)', ['application_name', 'sgc_bank_'.$argv[4]]);
$pid = DB::selectOne('select pg_backend_pid() as pid')->pid;
$user = User::query()->findOrFail($argv[2]);
auth()->guard()->setUser($user);
$payload = json_decode(stream_get_contents(STDIN), true, 512, JSON_THROW_ON_ERROR);
try {
if ($payload['action'] === 'propose') {
app(SupplierBankWorkflow::class)->propose($user, Supplier::query()->findOrFail($argv[3]), $payload['data']);
} else {
app(SupplierBankWorkflow::class)->review($user, SupplierBankDetail::query()->findOrFail($argv[3]), 'approved', 'Conferência isolada de teste');
}
$status = 200;
} catch (ValidationException) {
$status = 422;
}
echo json_encode(['status' => $status, 'backend_pid' => $pid], JSON_THROW_ON_ERROR);
+36
View File
@@ -0,0 +1,36 @@
<?php
use App\Models\Requisition;
use App\Models\User;
use App\Services\BudgetWorkflow;
use App\Services\ConflictGuard;
use Illuminate\Contracts\Console\Kernel;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException;
require __DIR__.'/../../vendor/autoload.php';
$database = $argv[1] ?? '';
if (! preg_match('/^compras_receipts_test_[a-f0-9]{12}$/', $database)) {
throw new LogicException('Base de teste inválida.');
}
$app = require __DIR__.'/../../bootstrap/app.php';
$app->make(Kernel::class)->bootstrap();
if (! $app->environment('testing') || DB::connection()->getDatabaseName() !== $database) {
throw new LogicException('Worker não isolado.');
}
DB::select('select set_config(?, ?, false)', ['application_name', 'sgc_budget_'.$argv[4]]);
$pid = DB::selectOne('select pg_backend_pid() as pid')->pid;
$user = User::query()->findOrFail($argv[2]);
auth()->guard()->setUser($user);
$payload = json_decode(stream_get_contents(STDIN), true, 512, JSON_THROW_ON_ERROR);
try {
DB::transaction(function () use ($user, $argv, $payload) {
app(ConflictGuard::class)->lockCompany($user);
$requisition = Requisition::query()->lockForUpdate()->findOrFail($argv[3]);
app(BudgetWorkflow::class)->record($user, $requisition, $payload['kind'], $payload['amount'], $payload['amount']);
});
$status = 200;
} catch (ValidationException) {
$status = 422;
}
echo json_encode(['status' => $status, 'backend_pid' => $pid], JSON_THROW_ON_ERROR);
+30
View File
@@ -0,0 +1,30 @@
<?php
use App\Models\Invoice;
use App\Models\User;
use App\Services\InvoiceWorkflow;
use Illuminate\Contracts\Console\Kernel;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException;
require __DIR__.'/../../vendor/autoload.php';
$database = $argv[1] ?? '';
if (! preg_match('/^compras_receipts_test_[a-f0-9]{12}$/', $database)) {
throw new LogicException('Base de teste inválida.');
}
$app = require __DIR__.'/../../bootstrap/app.php';
$app->make(Kernel::class)->bootstrap();
if (! $app->environment('testing') || DB::connection()->getDatabaseName() !== $database) {
throw new LogicException('Worker não isolado.');
}
DB::select('select set_config(?, ?, false)', ['application_name', 'sgc_invoice_'.$argv[4]]);
$pid = DB::selectOne('select pg_backend_pid() as pid')->pid;
$user = User::query()->findOrFail($argv[2]);
auth()->guard()->setUser($user);
try {
app(InvoiceWorkflow::class)->validate($user, Invoice::query()->findOrFail($argv[3]));
$status = 200;
} catch (ValidationException) {
$status = 422;
}
echo json_encode(['status' => $status, 'backend_pid' => $pid], JSON_THROW_ON_ERROR);
+38
View File
@@ -0,0 +1,38 @@
<?php
use App\Models\User;
use Illuminate\Contracts\Console\Kernel as ConsoleKernel;
use Illuminate\Contracts\Http\Kernel as HttpKernel;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
require __DIR__.'/../../vendor/autoload.php';
$database = $argv[1] ?? '';
if (! preg_match('/^compras_receipts_test_[a-f0-9]{12}$/', $database)) {
fwrite(STDERR, 'Base de testes inválida.');
exit(2);
}
$app = require __DIR__.'/../../bootstrap/app.php';
$app->make(ConsoleKernel::class)->bootstrap();
if (! $app->environment('testing')) {
throw new LogicException('O worker só pode executar em APP_ENV=testing.');
}
$config = config('database.connections.pgsql');
$config['database'] = $database;
$config['url'] = null;
config(['database.default' => 'pgsql', 'database.connections.pgsql' => $config]);
DB::purge('pgsql');
if (DB::selectOne('select current_database() as name')->name !== $database) {
throw new LogicException('A ligação não corresponde à base de testes.');
}
DB::select('select set_config(?, ?, false)', ['application_name', 'procura_receipt_'.$argv[4]]);
$pid = DB::selectOne('select pg_backend_pid() as pid')->pid;
auth()->guard()->setUser(User::query()->findOrFail($argv[2]));
$payload = json_decode(stream_get_contents(STDIN), true, 512, JSON_THROW_ON_ERROR);
$request = Request::create('/ordens/'.$argv[3].'/recepcoes', 'POST', $payload, server: ['HTTP_ACCEPT' => 'application/json']);
$kernel = $app->make(HttpKernel::class);
$response = $kernel->handle($request);
$body = json_decode($response->getContent(), true);
$kernel->terminate($request, $response);
echo json_encode(['status' => $response->getStatusCode(), 'id' => $body['id'] ?? null, 'created' => $body['created'] ?? null, 'error_fields' => array_keys($body['errors'] ?? []), 'backend_pid' => $pid], JSON_THROW_ON_ERROR);
+130
View File
@@ -0,0 +1,130 @@
<?php
use App\Enums\PurchasingRole;
use App\Models\Supplier;
use App\Models\SupplierBankDetail;
use App\Models\SupplierBankReview;
use App\Models\User;
use App\Services\SupplierBankWorkflow;
use Illuminate\Contracts\Console\Kernel;
use Illuminate\Support\Facades\Artisan;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Schema;
use Symfony\Component\Process\Process;
require __DIR__.'/../../vendor/autoload.php';
foreach (['APP_ENV' => 'testing', 'CACHE_STORE' => 'array', 'SESSION_DRIVER' => 'array', 'QUEUE_CONNECTION' => 'sync', 'MAIL_MAILER' => 'array'] as $key => $value) {
putenv($key.'='.$value);
$_ENV[$key] = $_SERVER[$key] = $value;
}
$app = require __DIR__.'/../../bootstrap/app.php';
$app->make(Kernel::class)->bootstrap();
require __DIR__.'/../Support/ReceiptFixture.php';
$original = DB::connection();
if ($original->getDriverName() !== 'pgsql') {
throw new LogicException('Exige PostgreSQL.');
}
$config = $original->getConfig();
$admin = $original->getPdo();
$database = 'compras_receipts_test_'.bin2hex(random_bytes(6));
$created = false;
$processes = [];
$report = ['tested_at_utc' => gmdate('c'), 'separate_database' => true, 'transport' => 'Independent PHP service transactions and PostgreSQL connections', 'scenarios' => []];
try {
$admin->exec('CREATE DATABASE "'.$database.'"');
$created = true;
config(['database.connections.pgsql' => [...$config, 'database' => $database, 'url' => null]]);
DB::purge('pgsql');
DB::setDefaultConnection('pgsql');
Schema::clearResolvedInstance('db.schema');
app()->forgetInstance('db.schema');
if (DB::connection()->getDatabaseName() !== $database || Schema::getConnection()->getDatabaseName() !== $database) {
throw new LogicException('Migração fora do isolamento recusada.');
}
Artisan::call('migrate', ['--database' => 'pgsql', '--force' => true]);
$workerEnv = ['APP_ENV' => 'testing', 'DB_CONNECTION' => 'pgsql', 'DB_URL' => '', 'DB_DATABASE' => $database, 'DB_HOST' => $config['host'], 'DB_PORT' => (string) $config['port'], 'DB_USERNAME' => $config['username'], 'DB_PASSWORD' => $config['password'], 'CACHE_STORE' => 'array', 'SESSION_DRIVER' => 'array'];
foreach (['distinct_approvals', 'same_approval', 'competing_revisions'] as $scenario) {
$f = receiptFixture();
$supplier = Supplier::query()->findOrFail($f['order']->supplier_id);
$author = $f['issuer'];
auth()->guard()->setUser($author);
$first = User::factory()->create(['tenant_id' => $author->tenant_id, 'purchasing_role' => PurchasingRole::Finance]);
$second = User::factory()->create(['tenant_id' => $author->tenant_id, 'purchasing_role' => PurchasingRole::Finance]);
$data = ['previous_id' => 0, 'bank_name' => 'Banco fictício', 'country' => 'MZ', 'currency' => 'MZN', 'beneficiary' => 'Titular fictício', 'account_identifier' => 'TEST-PG-0001', 'evidence_reference' => 'Apenas teste', 'reason' => 'Apenas teste'];
$detail = app(SupplierBankWorkflow::class)->propose($author, $supplier, $data);
$payload = ['action' => 'review'];
$target = $detail->id;
if ($scenario === 'same_approval') {
$second = $first;
} elseif ($scenario === 'competing_revisions') {
$first = $second = $author;
$target = $supplier->id;
$payload = ['action' => 'propose', 'data' => [...$data, 'previous_id' => $detail->id]];
}
$connection = DB::connection();
$connection->beginTransaction();
$connection->table('tenants')->where('id', $author->tenant_id)->lockForUpdate()->first();
$processes = [];
foreach ([$first, $second] as $index => $user) {
$process = new Process([PHP_BINARY, __DIR__.'/bank-worker.php', $database, (string) $user->id, (string) $target, $index === 0 ? 'A' : 'B'], base_path(), $workerEnv);
$process->setInput(json_encode($payload, JSON_THROW_ON_ERROR));
$process->setTimeout(40);
$process->start();
$processes[] = $process;
}
$statement = $admin->prepare("SELECT count(*) FROM pg_stat_activity WHERE datname = ? AND application_name IN ('sgc_bank_A','sgc_bank_B') AND wait_event_type = 'Lock'");
$deadline = microtime(true) + 20;
do {
$statement->execute([$database]);
$waits = (int) $statement->fetchColumn();
if ($waits === 2) {
break;
}
foreach ($processes as $process) {
if (! $process->isRunning()) {
throw new RuntimeException('Worker terminou antes do bloqueio: '.$process->getErrorOutput());
}
}
usleep(20000);
} while (microtime(true) < $deadline);
$connection->commit();
if ($waits !== 2) {
throw new RuntimeException('Sem sobreposição de bloqueios.');
}
$results = [];
foreach ($processes as $process) {
$process->wait();
if (! $process->isSuccessful()) {
throw new RuntimeException('Falha do worker: '.$process->getErrorOutput());
}
$results[] = json_decode($process->getOutput(), true, 512, JSON_THROW_ON_ERROR);
}
$statuses = array_column($results, 'status');
sort($statuses);
$state = app(SupplierBankWorkflow::class)->state($supplier);
$count = SupplierBankReview::query()->count();
if ($statuses !== ($scenario === 'competing_revisions' ? [200, 422] : [200, 200]) || $state !== ($scenario === 'distinct_approvals' ? 'approved' : 'pending') || $count !== match ($scenario) {
'distinct_approvals' => 2, 'same_approval' => 1, default => 0
} || SupplierBankDetail::query()->count() !== ($scenario === 'competing_revisions' ? 2 : 1) || count(array_unique(array_column($results, 'backend_pid'))) !== 2) {
throw new RuntimeException('Resultado concorrente inesperado.');
}
$report['scenarios'][] = ['name' => $scenario, 'passed' => true, 'overlapping_lock_waits' => $waits, 'state' => $state, 'review_count' => $count];
}
$report['passed'] = true;
} finally {
foreach ($processes as $process) {
if ($process->isRunning()) {
$process->stop();
}
}
if (isset($connection) && $connection->transactionLevel() > 0) {
$connection->rollBack();
}
DB::disconnect('pgsql');
if ($created && $database !== $original->getDatabaseName() && preg_match('/^compras_receipts_test_[a-f0-9]{12}$/', $database)) {
$admin->exec('DROP DATABASE "'.$database.'"');
$report['test_database_dropped'] = true;
}
}
file_put_contents(base_path('docs/bancos-concorrencia-postgresql.json'), json_encode($report, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR).PHP_EOL);
echo json_encode($report, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR).PHP_EOL;
+135
View File
@@ -0,0 +1,135 @@
<?php
use App\Models\Budget;
use App\Models\BudgetEntry;
use App\Services\BudgetWorkflow;
use App\Services\ConflictGuard;
use Illuminate\Contracts\Console\Kernel;
use Illuminate\Support\Facades\Artisan;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Schema;
use Symfony\Component\Process\Process;
require __DIR__.'/../../vendor/autoload.php';
foreach (['APP_ENV' => 'testing', 'CACHE_STORE' => 'array', 'SESSION_DRIVER' => 'array', 'QUEUE_CONNECTION' => 'sync', 'MAIL_MAILER' => 'array'] as $key => $value) {
putenv($key.'='.$value);
$_ENV[$key] = $_SERVER[$key] = $value;
}
$app = require __DIR__.'/../../bootstrap/app.php';
$app->make(Kernel::class)->bootstrap();
require __DIR__.'/../Support/ReceiptFixture.php';
$original = DB::connection();
if ($original->getDriverName() !== 'pgsql') {
throw new LogicException('Exige PostgreSQL.');
}
$config = $original->getConfig();
$admin = $original->getPdo();
$database = 'compras_receipts_test_'.bin2hex(random_bytes(6));
$created = false;
$processes = [];
$report = ['tested_at_utc' => gmdate('c'), 'separate_database' => true, 'transport' => 'Independent PHP service transactions and PostgreSQL connections', 'scenarios' => []];
try {
$admin->exec('CREATE DATABASE "'.$database.'"');
$created = true;
$isolated = [...$config, 'database' => $database, 'url' => null];
config(['database.connections.pgsql' => $isolated]);
DB::purge('pgsql');
DB::setDefaultConnection('pgsql');
Schema::clearResolvedInstance('db.schema');
app()->forgetInstance('db.schema');
if (DB::connection()->getDatabaseName() !== $database || Schema::getConnection()->getDatabaseName() !== $database) {
throw new LogicException('Migração fora do isolamento recusada.');
}
Artisan::call('migrate', ['--database' => 'pgsql', '--force' => true]);
$workerEnv = ['APP_ENV' => 'testing', 'DB_CONNECTION' => 'pgsql', 'DB_URL' => '', 'DB_DATABASE' => $database, 'DB_HOST' => $config['host'], 'DB_PORT' => (string) $config['port'], 'DB_USERNAME' => $config['username'], 'DB_PASSWORD' => $config['password'], 'CACHE_STORE' => 'array', 'SESSION_DRIVER' => 'array'];
foreach (['over_reserve', 'same_reserve', 'same_commit', 'same_release', 'over_award'] as $scenario) {
$f = receiptFixture();
$user = $f['issuer'];
auth()->guard()->setUser($user);
$budget = Budget::query()->create(['tenant_id' => $user->tenant_id, 'cost_center_id' => $f['r']->cost_center_id, 'year' => now()->year, 'amount_minor' => 10000, 'includes_tax' => true, 'created_by' => $user->id, 'approved_by' => $f['receiver']->id, 'reason' => 'Fixture isolada']);
$first = $f['r'];
$second = $first;
if (in_array($scenario, ['over_reserve', 'over_award'])) {
$second = $first->replicate();
$second->number = 'REQ-TEST-'.bin2hex(random_bytes(5));
$second->save();
}
if (in_array($scenario, ['same_commit', 'same_release', 'over_award'])) {
foreach ($scenario === 'over_award' ? [$first, $second] : [$first] as $request) {
DB::transaction(function () use ($user, $request) {
app(ConflictGuard::class)->lockCompany($user);
app(BudgetWorkflow::class)->record($user, $request, 'reserve', 2000, 2000);
});
}
}
$kind = match ($scenario) {
'same_commit' => 'commit', 'same_release' => 'release', 'over_award' => 'award', default => 'reserve'
};
$connection = DB::connection();
$connection->beginTransaction();
$connection->table('tenants')->where('id', $user->tenant_id)->lockForUpdate()->first();
$processes = [];
foreach ([$first, $second] as $index => $request) {
$process = new Process([PHP_BINARY, __DIR__.'/budget-worker.php', $database, (string) $user->id, (string) $request->id, $index === 0 ? 'A' : 'B'], base_path(), $workerEnv);
$process->setInput(json_encode(['kind' => $kind, 'amount' => 6000], JSON_THROW_ON_ERROR));
$process->setTimeout(40);
$process->start();
$processes[] = $process;
}
$statement = $admin->prepare("SELECT count(*) FROM pg_stat_activity WHERE datname = ? AND application_name IN ('sgc_budget_A','sgc_budget_B') AND wait_event_type = 'Lock'");
$deadline = microtime(true) + 20;
do {
$statement->execute([$database]);
$waits = (int) $statement->fetchColumn();
if ($waits === 2) {
break;
}
foreach ($processes as $process) {
if (! $process->isRunning()) {
throw new RuntimeException('Worker terminou antes do bloqueio: '.$process->getErrorOutput());
}
}
usleep(20000);
} while (microtime(true) < $deadline);
$connection->commit();
if ($waits !== 2) {
throw new RuntimeException('Sem sobreposição de bloqueios.');
}
$results = [];
foreach ($processes as $process) {
$process->wait();
if (! $process->isSuccessful()) {
throw new RuntimeException('Falha do worker: '.$process->getErrorOutput());
}
$results[] = json_decode($process->getOutput(), true, 512, JSON_THROW_ON_ERROR);
}
$statuses = array_column($results, 'status');
sort($statuses);
$reserved = (int) BudgetEntry::query()->sum('reserved_minor');
$committed = (int) BudgetEntry::query()->sum('committed_minor');
[$expectedReserve, $expectedCommit] = match ($scenario) {
'same_commit' => [0, 6000], 'same_release' => [0, 0], 'over_award' => [8000, 0], default => [6000, 0]
};
if ($statuses !== (in_array($scenario, ['over_reserve', 'over_award']) ? [200, 422] : [200, 200]) || $reserved !== $expectedReserve || $committed !== $expectedCommit || count(array_unique(array_column($results, 'backend_pid'))) !== 2) {
throw new RuntimeException('Resultado inesperado: '.json_encode([$statuses, $reserved, $committed]));
}
$report['scenarios'][] = ['name' => $scenario, 'passed' => true, 'overlapping_lock_waits' => $waits, 'reserved_minor' => $reserved, 'committed_minor' => $committed];
}
$report['passed'] = true;
} finally {
foreach ($processes as $process) {
if ($process->isRunning()) {
$process->stop();
}
}
if (isset($connection) && $connection->transactionLevel() > 0) {
$connection->rollBack();
}
DB::disconnect('pgsql');
if ($created && $database !== $original->getDatabaseName() && preg_match('/^compras_receipts_test_[a-f0-9]{12}$/', $database)) {
$admin->exec('DROP DATABASE "'.$database.'"');
$report['test_database_dropped'] = true;
}
}
file_put_contents(base_path('docs/orcamento-concorrencia-postgresql.json'), json_encode($report, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR).PHP_EOL);
echo json_encode($report, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR).PHP_EOL;
+121
View File
@@ -0,0 +1,121 @@
<?php
use App\Models\BudgetConsumption;
use App\Models\BudgetEntry;
use App\Models\Invoice;
use App\Services\InvoiceWorkflow;
use Illuminate\Contracts\Console\Kernel;
use Illuminate\Support\Facades\Artisan;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Schema;
use Symfony\Component\Process\Process;
require __DIR__.'/../../vendor/autoload.php';
foreach (['APP_ENV' => 'testing', 'CACHE_STORE' => 'array', 'SESSION_DRIVER' => 'array', 'QUEUE_CONNECTION' => 'sync', 'MAIL_MAILER' => 'array'] as $key => $value) {
putenv($key.'='.$value);
$_ENV[$key] = $_SERVER[$key] = $value;
}
$app = require __DIR__.'/../../bootstrap/app.php';
$app->make(Kernel::class)->bootstrap();
require __DIR__.'/../Support/InvoiceFixture.php';
$original = DB::connection();
if ($original->getDriverName() !== 'pgsql') {
throw new LogicException('Exige PostgreSQL.');
}
$config = $original->getConfig();
$admin = $original->getPdo();
$database = 'compras_receipts_test_'.bin2hex(random_bytes(6));
$created = false;
$processes = [];
$report = ['tested_at_utc' => gmdate('c'), 'separate_database' => true, 'transport' => 'Independent PHP service transactions and PostgreSQL connections', 'scenarios' => []];
try {
$admin->exec('CREATE DATABASE "'.$database.'"');
$created = true;
config(['database.connections.pgsql' => [...$config, 'database' => $database, 'url' => null]]);
DB::purge('pgsql');
DB::setDefaultConnection('pgsql');
Schema::clearResolvedInstance('db.schema');
app()->forgetInstance('db.schema');
if (DB::connection()->getDatabaseName() !== $database || Schema::getConnection()->getDatabaseName() !== $database) {
throw new LogicException('Migração fora do isolamento recusada.');
}
Artisan::call('migrate', ['--database' => 'pgsql', '--force' => true]);
$workerEnv = ['APP_ENV' => 'testing', 'DB_CONNECTION' => 'pgsql', 'DB_URL' => '', 'DB_DATABASE' => $database, 'DB_HOST' => $config['host'], 'DB_PORT' => (string) $config['port'], 'DB_USERNAME' => $config['username'], 'DB_PASSWORD' => $config['password'], 'CACHE_STORE' => 'array', 'SESSION_DRIVER' => 'array'];
foreach (['over_invoice', 'same_validation', 'complementary_invoices'] as $scenario) {
$f = invoiceFixture();
$second = $f['invoice'];
if ($scenario !== 'same_validation') {
$data = $f['data'];
$data['number'] = 'FT-PG-2';
if ($scenario === 'complementary_invoices') {
$data['items'][0]['quantity'] = '0.400';
$data['subtotal'] = $data['total'] = '40.00';
}
$second = app(InvoiceWorkflow::class)->register($f['author'], $f['order'], $data);
}
$connection = DB::connection();
$connection->beginTransaction();
$connection->table('tenants')->where('id', $f['tenant']->id)->lockForUpdate()->first();
$processes = [];
foreach ([$f['invoice'], $second] as $index => $invoice) {
$process = new Process([PHP_BINARY, __DIR__.'/invoice-worker.php', $database, (string) $f['validator']->id, (string) $invoice->id, $index === 0 ? 'A' : 'B'], base_path(), $workerEnv);
$process->setTimeout(40);
$process->start();
$processes[] = $process;
}
$statement = $admin->prepare("SELECT count(*) FROM pg_stat_activity WHERE datname = ? AND application_name IN ('sgc_invoice_A','sgc_invoice_B') AND wait_event_type = 'Lock'");
$deadline = microtime(true) + 20;
do {
$statement->execute([$database]);
$waits = (int) $statement->fetchColumn();
if ($waits === 2) {
break;
}
foreach ($processes as $process) {
if (! $process->isRunning()) {
throw new RuntimeException('Worker terminou antes do bloqueio: '.$process->getErrorOutput());
}
}
usleep(20000);
} while (microtime(true) < $deadline);
$connection->commit();
if ($waits !== 2) {
throw new RuntimeException('Sem sobreposição de bloqueios.');
}
$results = [];
foreach ($processes as $process) {
$process->wait();
if (! $process->isSuccessful()) {
throw new RuntimeException('Falha do worker: '.$process->getErrorOutput());
}
$results[] = json_decode($process->getOutput(), true, 512, JSON_THROW_ON_ERROR);
}
$statuses = array_column($results, 'status');
sort($statuses);
$consumed = (int) BudgetConsumption::query()->sum('amount_minor');
$committed = (int) BudgetEntry::query()->sum('committed_minor');
$expectedConsumption = $scenario === 'complementary_invoices' ? 10000 : 6000;
$count = $scenario === 'complementary_invoices' ? 2 : 1;
if ($statuses !== ($scenario === 'over_invoice' ? [200, 422] : [200, 200]) || $consumed !== $expectedConsumption || $committed !== 10000 - $expectedConsumption || BudgetConsumption::query()->count() !== $count || Invoice::query()->where('status', 'validated')->count() !== $count || count(array_unique(array_column($results, 'backend_pid'))) !== 2) {
throw new RuntimeException('Resultado inesperado: '.json_encode([$statuses, $consumed, $committed]));
}
$report['scenarios'][] = ['name' => $scenario, 'passed' => true, 'overlapping_lock_waits' => $waits, 'consumed_minor' => $consumed, 'committed_minor' => $committed, 'validated_invoices' => $count];
}
$report['passed'] = true;
} finally {
foreach ($processes as $process) {
if ($process->isRunning()) {
$process->stop();
}
}
if (isset($connection) && $connection->transactionLevel() > 0) {
$connection->rollBack();
}
DB::disconnect('pgsql');
if ($created && $database !== $original->getDatabaseName() && preg_match('/^compras_receipts_test_[a-f0-9]{12}$/', $database)) {
$admin->exec('DROP DATABASE "'.$database.'"');
$report['test_database_dropped'] = true;
}
}
file_put_contents(base_path('docs/facturas-concorrencia-postgresql.json'), json_encode($report, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR).PHP_EOL);
echo json_encode($report, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR).PHP_EOL;

Some files were not shown because too many files have changed in this diff Show More