Compare commits

...
6 Commits
63 changed files with 1912 additions and 10 deletions
+20
View File
@@ -1,5 +1,25 @@
# SGF Tempo — instruções locais
- Autorização específica posterior de 28/10/2026 executada: apenas `120000` aplicada em `sgf_tempo_dev`, por caminho exclusivo com `sgf_dev_owner`, e seis concessões auditadas no tenant #1 / Tempo Lda #1 / SEGI #1: conta #1 `workshop_billing.view/prepare/generate`; conta #2 `workshop_billing.view/review` e `workshop.view`. Ver actualização de `docs/WORKSHOP_BILLING_DELIVERY.md`. Preservadas 74 tabelas anteriores e acessos; sete tabelas novas vazias. Aplicação mantém `sgf_dev_app`; conversão/oficinas/custos/recebimentos/emissão reais bloqueados e guardas SQL verificadas. `110000` e sete concessões do orçamento permanecem pendentes; não aplicar por arrasto. Consulta de oficina da conta #2 não concede apontamento/verificação/supervisão. Indicações anteriores de `120000`/seis concessões por aplicar são históricas; sem utilização real ou publicação.
- Aceitação específica de 28/10/2026: utilizador aceitou `WORKSHOP-BILLING-DRAFT-SIM-v1` com limitação de capturas e autorizou checkpoint exclusivamente local, sem credenciais/dados privados. Ver `docs/WORKSHOP_BILLING_ACCEPTANCE.md`. Não transformar provas pendentes em realizadas; Edge não recuperado e capturas não recebidas permanecem limites. Substitui apenas a pendência de aceitação/encerramento deste ensaio. `120000`, seis concessões e utilização real continuam por autorizar; `110000` e sete concessões também pendentes. Sem aplicação, activação operacional ou publicação.
- Autorização técnica de 28/10/2026: implementar `WORKSHOP-BILLING-DRAFT-SIM-v1` conforme `docs/WORKSHOP_BILLING_DRAFT_SCOPE.md`, exclusivamente sintético em `sgf_tempo_test`. Ver `docs/WORKSHOP_BILLING_DELIVERY.md`. Reutilizar origens verificadas por ID/versão, sem consumo duplicado, preços comerciais sintéticos 200 MZN/H e 75 MZN/UN (350+150=500 sem imposto), revisão comercial distinta. Não derivar preço do custo interno ou atribuir verificação técnica à revisora. Sem edição directa de rascunhos gerados ou confirmação B1 automática. `120000` e seis concessões reais só propostas, não aplicar sem autorização específica; `110000` e sete concessões continuam pendentes. Preservar `04870f0`, `090b7da` e alterações posteriores; sem utilização real, stock, emissão, lançamentos, publicação ou aceitação presumida.
- Decisões confirmadas em 28/10/2026 para oficina → rascunho: ver secções 8/8.1 de `docs/WORKSHOP_BILLING_DRAFT_SCOPE.md`. Tempo verificado e material consumido da empresa; excluir material do cliente e dupla cobrança tarefa/tempo. Osmane prepara/gera; Samira revê versão comercial por identidade distinta, sem verificação técnica implícita. Uma ordem/rascunho, origens integrais, sem repartição. Tabela apenas sintética `WORKSHOP-SALES-SYNTHETIC-v1`, MZN sem imposto: 200/H × 105/60 H = 350; 75/UN × 2 = 150; soma 500. Sem custo interno convertido em preço. Apenas especificação nesta etapa; implementação, migrações/concessões e utilização real continuam separadas. Preservar `04870f0`, `090b7da` e bloqueios.
- Preservação autorizada em 28/10/2026: registar avaliação técnica da página inicial/menu e criar checkpoint local sem credenciais/dados privados; não presumir revisão visual ou aceitação visual. Encerramento do orçamento permanece em `04870f0` com limitações explícitas. Próximo passo autorizado apenas de especificação: oficina → rascunho de facturação; definir facturabilidade, revisão, preços e duplicações antes de implementar. `110000`, sete concessões e utilização real permanecem por autorizar.
- Autorização posterior de 28/10/2026: implementar página inicial e navegação agrupada após a proposta `docs/HOME_NAVIGATION_PROPOSAL.md`. Ver `docs/HOME_NAVIGATION_DELIVERY.md`. Preservar `04870f0` e anteriores, direitos por contexto e bloqueios. Sem novos acessos, módulos financeiros, contagens/indicadores fictícios ou uso real; fontes agregadas de pendências não implementadas. Prova visual permanece separada, sem presumir aceitação ou checkpoint. `110000` e sete concessões continuam por autorizar.
- Aceitação específica de 28/10/2026: utilizador aceitou o ensaio de orçamento versus realizado com limitação das capturas documentada e autorizou checkpoint exclusivamente local, sem credenciais/dados privados. Ver `docs/INDUSTRIAL_BUDGET_ACCEPTANCE.md`. Não transformar provas pendentes em realizadas; automação Edge bloqueada e capturas não recebidas permanecem limitações. Substitui apenas a pendência de aceitação/encerramento. `110000`, sete concessões e utilização real continuam por autorizar; sem aplicação ou publicação. Próxima prioridade: página inicial e menus agrupados, preservando entregas e direitos existentes.
- Autorização de 28/10/2026: implementar o ensaio de orçamento versus realizado da secção 16 de `docs/INDUSTRIAL_COST_ACCOUNTING_SCOPE.md`, só sintético em `sgf_tempo_test`, preservando `cbdf2b4`, `4a94e8a` e alterações posteriores. Orçamento aprovado como hipótese: 900 material + 600 trabalho + 300 indirectos imputados; comparar versão validada de 1000/500/300, 10 UN, MZN, mesmo produto/lote/período, com desvios +100/−100/0 e total 0; residual 300 separado. Osmane prepara; Samira valida orçamento exacto por identidade distinta e consulta comparação. Direitos próprios, sem herança ou concessões reais. Sem taxa material: 800 conhecidos, comparação incompleta, nunca poupança. Preservar versões/origens e bloqueios SQL/aplicação. Migração `110000` e sete concessões apenas propostas, NÃO aplicar em desenvolvimento. Sem dependências novas, stock, lançamentos, facturação, publicação ou aceitação presumida; checkpoint de encerramento só após aceitação. Ver `docs/INDUSTRIAL_BUDGET_DELIVERY.md` para estado e provas.
- Autorização específica de 28/10/2026 executada: apenas `100000` aplicada em `sgf_tempo_dev`, por caminho explícito com `sgf_dev_owner`, e quatro concessões auditadas no tenant #1 / Tempo Lda #1 / SEGI #1: conta #1 `industrial_costs.view/prepare`; conta #2 `industrial_costs.view/validate`. Ver actualização de `docs/INDUSTRIAL_COST_DELIVERY.md`. Preservadas 66 tabelas anteriores e acessos; oito tabelas industriais vazias. Aplicação mantém `sgf_dev_app`; custeio industrial/directo, oficinas, recebimentos e emissão reais bloqueados, com guardas SQL verificadas. Sem utilização real ou publicação. Indicações anteriores de `100000`/concessões por autorizar são históricas; esta instalação não activa operações reais.
- Aceitação específica de 28/10/2026: o utilizador aceitou `INDUSTRIAL-COST-SIM-v1` e autorizou checkpoint Git exclusivamente local, sem credenciais ou dados reais. Ver `docs/INDUSTRIAL_COST_ACCEPTANCE.md`. Substitui apenas a pendência de aceitação/encerramento técnico do ensaio. Migração `100000`, quatro concessões e utilização real permanecem por autorizar; sem aplicação, activação operacional, publicação ou novo incremento.
- Autorização técnica de 27/10/2026: `INDUSTRIAL-COST-SIM-v1`, secções 15/15.5, só em `sgf_tempo_test`. Ver `docs/INDUSTRIAL_COST_DELIVERY.md`. Um lote/produto sintéticos, material 1000 + trabalho 500 + CIF 300 = 1800, 10 UN / 180 por UN; conjunto 600, capacidade 10 HM, uso 5 HM e residual 300 separado. Sem taxa material, 800 conhecidos, total/unitário indisponíveis. Critério é hipótese sintética, não método real aprovado. Preparação/validação industrial explícitas por identidades distintas; não herdar custo directo, transformar oficina em lote ou duplicar origens. `100000` e quatro concessões reais apenas propostas, NÃO aplicar sem confirmação específica. Preservar checkpoints/alterações/aprovações/bloqueios. Sem aceitação presumida, checkpoint de encerramento, stock, previsto/realizado, margens, lançamentos ou publicação.
- Autorização específica posterior de 27/10/2026 executada: apenas `090000` aplicada em `sgf_tempo_dev`, por caminho explícito e proprietário separado, e quatro concessões auditadas no tenant #1 / Tempo Lda #1 / SEGI #1: Osmane #1 `direct_costs.view/prepare`; Samira #2 `direct_costs.view/validate`. Ver actualização de `docs/WORKSHOP_DIRECT_COST_DELIVERY.md`. Preservadas 60 tabelas anteriores, dados/acessos e instalações `070000`/`080000`; seis tabelas de custo vazias. Aplicação mantém `sgf_dev_app`; custeio, oficinas, recebimentos e emissão reais bloqueados e guardas SQL verificadas. Sem taxas/cálculos reais, novas concessões técnicas ou publicação. As indicações anteriores de `090000`/quatro concessões pendentes são históricas; não activar uso operacional por consequência desta instalação.
+6
View File
@@ -121,4 +121,10 @@ O primeiro núcleo de cálculo de serviço e a política operacional de truncage
O menu **Classificação contabilística**, disponível após actualizar a sessão com os acessos especificamente concedidos, permite preparar e submeter versões PGC-NIRF, validar/recusar sem editar e consultar classificação por data. Categoria e excepções são empresariais; operações e respectivos históricos continuam limitados às unidades autorizadas. As tabelas reais começam vazias, sem contas de movimento ou regras aprovadas por omissão. Consultar [utilização, provas e limites da classificação](docs/CATALOGUE_ACCOUNTING_DELIVERY.md).
## Ensaio isolado de custo directo
Ligação sintética oficina → prestação/rascunho rastreável: [âmbito implementado, provas e limites](docs/WORKSHOP_BILLING_DELIVERY.md). Migração `120000` e seis concessões instaladas tecnicamente por autorização específica de 28/10/2026; conversão real continua bloqueada. `110000` e os direitos do orçamento permanecem separados e pendentes.
Página inicial e menus agrupados: [alterações, verificações e limites visuais](docs/HOME_NAVIGATION_DELIVERY.md). Os atalhos dependem dos acessos existentes; não apresentam contagens de pendências ou indicadores financeiros simulados.
O ensaio de orçamento versus realizado está descrito em [INDUSTRIAL_BUDGET_DELIVERY.md](docs/INDUSTRIAL_BUDGET_DELIVERY.md), com percurso, estado das provas e propostas separadas. Continua limitado a `sgf_tempo_test`; a instalação normal e os acessos novos não são aplicados por arrasto.
O percurso `WORKSHOP-DIRECT-COST-SIM-v1` e as instruções de prova estão em [WORKSHOP_DIRECT_COST_DELIVERY.md](docs/WORKSHOP_DIRECT_COST_DELIVERY.md). Reutiliza apontamentos verificados sem duplicar consumos; não activa custeio real. Migração `090000` e quatro concessões continuam propostas, não aplicadas.
@@ -0,0 +1,12 @@
<?php
namespace App\Modules\Industry\Http;
use App\Http\Controllers\Controller;
use App\Modules\Industry\IndustrialBudgets;
use Illuminate\Http\Request;
final class IndustrialBudgetsController extends Controller {
private function response(array $d){return response()->json($d)->header('Cache-Control','no-store, private');}
public function index(Request $r,IndustrialBudgets $c){return $this->response($c->listing($r->user()->id));}
public function propose(Request $r,int $id,IndustrialBudgets $c){return $this->response($c->propose($id,$r->user()->id,$r->all(),(string)$r->header('Idempotency-Key')));}
public function decide(Request $r,int $id,IndustrialBudgets $c){return $this->response($c->decide($id,$r->user()->id,$r->all(),(string)$r->header('Idempotency-Key')));}
public function compare(Request $r,int $id,IndustrialBudgets $c){return $this->response($c->compare($id,$r->user()->id,$r->all(),(string)$r->header('Idempotency-Key')));}
}
@@ -0,0 +1,94 @@
<?php
namespace App\Modules\Industry;
use App\Modules\Identity\Services\{Audit,Permissions};
use App\Modules\Services\ServiceCalculation;
use App\Shared\Context\CompanyContext;
use App\Shared\Costs\ExactCostMath as Exact;
use Brick\Math\BigRational as N;
use Illuminate\Support\Facades\{DB,Validator};
final class IndustrialBudgets {
public const POLICY='INDUSTRIAL-BUDGET-ACTUAL-SIM-v1';
public function __construct(private CompanyContext $context,private Permissions $permissions,private IndustrialCosts $costs){}
public static function guard(): void {IndustrialCosts::guard();}
private function json($v): string {return json_encode($v,JSON_THROW_ON_ERROR|JSON_UNESCAPED_UNICODE);}
private function canonical($v){if(!is_array($v))return $v;if(!array_is_list($v))ksort($v);return array_map(fn($x)=>$this->canonical($x),$v);}
private function fields(array $in,array $rules): array {abort_if(array_diff(array_keys($in),array_keys($rules)),422,'Campo fora do ensaio.');return Validator::make($in,$rules)->validate();}
private function scope(int $actor,string $right): array {
$s=$this->context->identifiers()+['unit_id'=>$this->context->unitId()];abort_unless($actor===$this->context->userId()&&$s['unit_id']!==null,403);
$this->context->selectFor($actor,$s['tenant_id'],$s['company_id'],$s['unit_id']);
foreach(['industrial_budgets.view','industrial_costs.view',$right] as $p)$this->permissions->require($actor,$s['tenant_id'],$s['company_id'],$p,$s['unit_id']);return $s;
}
private function lot(int $id,array $s): object {return DB::table('ic_lots')->where($s)->where('id',$id)->first()??abort(403,'Lote fora do contexto.');}
private function cmd(int $lot,int $actor,string $action,array $in,string $key,callable $write): array {
self::guard();$right=match($action){'propose'=>'industrial_budgets.prepare','decide'=>'industrial_budgets.validate','compare'=>'industrial_budget_comparisons.prepare'};
$s=$this->scope($actor,$right);if($action==='compare')$this->scope($actor,'industrial_budget_comparisons.view');$this->lot($lot,$s);
abort_unless(preg_match('/^[A-Za-z0-9_-]{8,100}$/D',$key),422,'Chave de idempotência necessária.');$hash=hash('sha256',$this->json($this->canonical($in)));
return DB::transaction(function()use($lot,$actor,$action,$in,$key,$write,$hash,$s,$right){
DB::table('companies')->where('id',$s['company_id'])->lockForUpdate()->firstOrFail();$this->scope($actor,$right);if($action==='compare')$this->scope($actor,'industrial_budget_comparisons.view');$this->lot($lot,$s);
$old=DB::table('ib_commands')->where(['lot_id'=>$lot,'actor_id'=>$actor,'action'=>$action,'command_key'=>$key])->first();
if($old){abort_unless(hash_equals($old->request_hash,$hash),409,'Chave repetida com conteúdo diferente.');return json_decode($old->result,true)+['replayed'=>true];}
$out=$write($s);$cmd=DB::table('ib_commands')->insertGetId(['lot_id'=>$lot,'actor_id'=>$actor,'action'=>$action,'command_key'=>$key,'request_hash'=>$hash,'result'=>$this->json($out),'created_at'=>now()]);
Audit::record('industrial_budgets.'.$action,$actor,$s['tenant_id'],$s['company_id'],$s['unit_id'],details:['record_id'=>$out['id'],'version'=>$out['version']]);
$event=DB::table('ib_events')->insertGetId(['command_id'=>$cmd,'payload'=>$this->json(['policy'=>self::POLICY,'scope'=>$s,'action'=>$action,'result'=>$out]),'created_at'=>now()]);
DB::table('ib_outbox')->insert(['event_id'=>$event,'state'=>'captured_no_stock_or_accounting']);return $out+['replayed'=>false];
},3);
}
private function next(string $table,int $lot,array $d): void {
$last=DB::table($table)->where('lot_id',$lot)->orderByDesc('version')->first();
abort_unless($d['version']===($last?->version??0)+1&&($d['previous_id']??null)===$last?->id,409,'Versão anterior mudou; rever explicitamente.');
}
private function row(string $table,int $lot,int $id,int $version): object {return DB::table($table)->where(['id'=>$id,'lot_id'=>$lot,'version'=>$version])->first()??abort(409,'Referência ou versão incompatível.');}
private function current(string $table,object $r): bool {return !DB::table($table)->where('previous_id',$r->id)->exists();}
public function dimensions(object $lot): array {return ['tenant_id'=>$lot->tenant_id,'company_id'=>$lot->company_id,'unit_id'=>$lot->unit_id,'product_id'=>$lot->product_id,'lot_id'=>$lot->id,'quantity'=>'10','unit'=>'UN','currency'=>$lot->currency,'period_start'=>$lot->period_start,'period_end'=>$lot->period_end,'scope'=>'material_labour_allocated'];}
public function propose(int $lot,int $actor,array $in,string $key): array {
self::guard();$d=$this->fields($in,['version'=>'required|integer|min:1','previous_id'=>'present|nullable|integer|min:1','dimensions'=>'required|array','amounts'=>'required|array','evidence'=>'required|string|min:3|max:1000']);
return $this->cmd($lot,$actor,'propose',$d,$key,function($s)use($lot,$actor,$d){
$this->next('ib_budgets',$lot,$d);$dims=$this->dimensions($this->lot($lot,$s));abort_unless($this->canonical($dims)===$this->canonical($d['dimensions']),409,'Produto, lote, quantidade, unidade, moeda, período ou âmbito incompatível.');
abort_unless(count($d['amounts'])===3&&!array_diff(array_keys($d['amounts']),['material','labour','allocated']),422);
foreach($d['amounts'] as $v)abort_unless($v===null||(is_string($v)&&preg_match('/^(?:0|[1-9][0-9]{0,15})(?:\.[0-9]{1,8})?$/D',$v)),422,'Montante exacto não negativo ou desconhecido necessário.');
$id=DB::table('ib_budgets')->insertGetId(['lot_id'=>$lot,'version'=>$d['version'],'previous_id'=>$d['previous_id'],'dimensions'=>$this->json($dims),'amounts'=>$this->json($d['amounts']),'evidence'=>$d['evidence'],'actor_id'=>$actor,'created_at'=>now()]);return ['id'=>$id,'version'=>$d['version'],'lot_id'=>$lot];
});
}
public function decide(int $lot,int $actor,array $in,string $key): array {
self::guard();$d=$this->fields($in,['id'=>'required|integer|min:1','version'=>'required|integer|min:1','decision'=>'required|in:approved,refused','reason'=>'required|string|min:3|max:1000']);
return $this->cmd($lot,$actor,'decide',$d,$key,function()use($lot,$actor,$d){
$b=$this->row('ib_budgets',$lot,$d['id'],$d['version']);abort_if($b->actor_id===$actor,403,'Validador distinto necessário.');abort_unless($this->current('ib_budgets',$b),409,'Orçamento desactualizado.');abort_if(DB::table('ib_decisions')->where('budget_id',$b->id)->exists(),409,'Decisão imutável já registada.');
$id=DB::table('ib_decisions')->insertGetId(['budget_id'=>$b->id,'version'=>$b->version,'decision'=>$d['decision'],'reason'=>$d['reason'],'actor_id'=>$actor,'created_at'=>now()]);return ['id'=>$id,'version'=>$b->version,'lot_id'=>$lot];
});
}
private function approvedBudget(int $lot,int $id,int $version): object {
$b=$this->row('ib_budgets',$lot,$id,$version);abort_unless($this->current('ib_budgets',$b)&&DB::table('ib_decisions')->where(['budget_id'=>$id,'decision'=>'approved'])->exists(),409,'Orçamento não aprovado ou desactualizado.');return $b;
}
private function result(int $actor,int $lot,int $id,int $version): array {
foreach($this->costs->listing($actor)['lots'] as $l)if($l['id']===$lot)foreach($l['results'] as $r)if($r->id===$id&&$r->version===$version){abort_unless($r->current&&$r->decision?->decision==='approved',409,'Realizado não validado ou desactualizado.');return $r->snapshot;}
abort(409,'Resultado ou versão incompatível.');
}
public static function variance(array $p,array $r): array {
$rows=[];$ps=N::of(0);$rs=N::of(0);$ds=N::of(0);$complete=true;
foreach(['material','labour','allocated'] as $k){$a=$p[$k];$b=$r[$k];$d=$a===null||$b===null?null:N::of($b)->minus($a);$pct=$d===null||N::of($a)->isZero()?null:Exact::text($d->multipliedBy(100)->dividedBy($a));
$rows[$k]=['planned'=>$a,'actual'=>$b,'delta'=>$d===null?null:Exact::text($d),'percent'=>$pct,'percent_state'=>$d===null?'unknown':(N::of($a)->isZero()?'zero_base':'available')];
if($d===null){$complete=false;continue;}$ps=$ps->plus($a);$rs=$rs->plus($b);$ds=$ds->plus($d);
}
return ['rows'=>$rows,'incomplete'=>!$complete,'paired_planned'=>Exact::text($ps),'paired_actual'=>Exact::text($rs),'paired_delta'=>Exact::text($ds),'total_delta'=>$complete?Exact::text($ds):null,'total_percent'=>$complete&&!$ps->isZero()?Exact::text($ds->multipliedBy(100)->dividedBy($ps)):null,'total_percent_state'=>!$complete?'unknown':($ps->isZero()?'zero_base':'available'),'balanced'=>$ps->plus($ds)->isEqualTo($rs)];
}
public function compare(int $lot,int $actor,array $in,string $key): array {
self::guard();$d=$this->fields($in,['version'=>'required|integer|min:1','previous_id'=>'present|nullable|integer|min:1','budget_id'=>'required|integer|min:1','budget_version'=>'required|integer|min:1','result_id'=>'required|integer|min:1','result_version'=>'required|integer|min:1']);
return $this->cmd($lot,$actor,'compare',$d,$key,function($s)use($lot,$actor,$d){
$this->next('ib_comparisons',$lot,$d);$b=$this->approvedBudget($lot,$d['budget_id'],$d['budget_version']);$r=$this->result($actor,$lot,$d['result_id'],$d['result_version']);$dims=$this->dimensions($this->lot($lot,$s));
abort_unless($this->canonical(json_decode($b->dimensions,true))===$this->canonical($dims)&&N::of($r['good_units'])->isEqualTo($dims['quantity'])&&$r['currency']===$dims['currency'],409,'Quantidade, moeda ou âmbito incompatível.');
$snapshot=self::variance(json_decode($b->amounts,true),['material'=>$r['material_exact'],'labour'=>$r['labour_exact'],'allocated'=>$r['allocated_exact']])+['policy'=>self::POLICY,'dimensions'=>$dims,'budget'=>['id'=>$b->id,'version'=>$b->version],'result'=>['id'=>$d['result_id'],'version'=>$d['result_version'],'refs'=>$r['refs']],'actual_known'=>$r['known_cost_exact'],'residual_separate'=>$r['residual_exact'],'actual_reconciliation'=>$r['reconciliation'],'retrospective_hypothesis'=>true];
$id=DB::table('ib_comparisons')->insertGetId(['lot_id'=>$lot,'version'=>$d['version'],'previous_id'=>$d['previous_id'],'budget_id'=>$b->id,'result_id'=>$d['result_id'],'snapshot'=>$this->json($snapshot),'actor_id'=>$actor,'created_at'=>now()]);return ['id'=>$id,'version'=>$d['version'],'lot_id'=>$lot];
});
}
public function listing(int $actor): array {
$s=$this->scope($actor,'industrial_budgets.view');if(!ServiceCalculation::isolated())return ['blocked'=>true,'lots'=>[]];self::guard();
return DB::transaction(function()use($actor,$s){DB::table('companies')->where('id',$s['company_id'])->lockForUpdate()->firstOrFail();$this->scope($actor,'industrial_budgets.view');$lots=$this->costs->listing($actor)['lots'];
$view=$this->permissions->has($actor,$s['tenant_id'],$s['company_id'],'industrial_budget_comparisons.view',$s['unit_id']);
foreach($lots as &$l){$l['dimensions']=$this->dimensions((object)$l);$l['budgets']=DB::table('ib_budgets')->where('lot_id',$l['id'])->orderBy('version')->get()->all();foreach($l['budgets'] as $b){$b->current=$this->current('ib_budgets',$b);$b->amounts=json_decode($b->amounts,true);$b->dimensions=json_decode($b->dimensions,true);$b->decision=DB::table('ib_decisions')->where('budget_id',$b->id)->first();}
$l['comparisons']=$view?DB::table('ib_comparisons')->where('lot_id',$l['id'])->orderBy('version')->get()->all():[];
foreach($l['comparisons'] as $c){$c->snapshot=json_decode($c->snapshot,true);try{$this->approvedBudget($l['id'],$c->budget_id,$c->snapshot['budget']['version']);$this->result($actor,$l['id'],$c->result_id,$c->snapshot['result']['version']);$c->current=$this->current('ib_comparisons',$c);}catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface){$c->current=false;}}
}return ['blocked'=>false,'lots'=>$lots,'policy'=>self::POLICY];
});
}
}
+7
View File
@@ -84,6 +84,10 @@ final class ServiceWorkflow
$old = $id ? $this->query($area, $scope)->where('id', $id)->first() : null;
if ($id) {
abort_unless($old, 403, 'Registo fora do âmbito autorizado.');
if (in_array($area, ['service_drafts','billing_drafts'], true) && \Illuminate\Support\Facades\Schema::hasTable('wb_generations')) {
$column = $area === 'service_drafts' ? 'service_draft_id' : 'billing_draft_id';
abort_if(DB::table('wb_generations')->where($column, $id)->exists(),409,'Rascunho ligado a oficina: correcção comercial própria necessária; a proposta revista não pode ser alterada por edição directa.');
}
abort_if($area === 'billing_drafts' && DB::table('b_internal_confirmations')->where('billing_draft_id', $id)->exists(), 409, 'Confirmado internamente — sem validade fiscal. O registo está bloqueado para edição.');
abort_unless((int) $old->version === (int) ($input['version'] ?? 0), 409, 'O registo mudou. Reabra-o antes de guardar.');
}
@@ -137,6 +141,9 @@ final class ServiceWorkflow
$source = null;
if ($area === 'billing_drafts') {
$sourceId = $old ? $old->source_id : $input['source_id'];
if (!$old && \Illuminate\Support\Facades\Schema::hasTable('wb_generations')) {
abort_if(DB::table('wb_generations')->where('service_draft_id', $sourceId)->exists(),409,'Prestação de oficina já convertida: não pode gerar um segundo rascunho por outro percurso.');
}
$source = DB::table('a_service_drafts')->where('tenant_id', $scope['tenant_id'])->where('company_id', $scope['company_id'])->where('unit_id', $scope['unit_id'])->where('id', $sourceId)->first();
abort_unless($source, 403, 'Prestação fora da unidade autorizada.');
$reload = ! $old || ($input['reload_source'] ?? false);
@@ -0,0 +1,11 @@
<?php
namespace App\Modules\Workshop\Http;
use App\Http\Controllers\Controller;
use App\Modules\Workshop\WorkshopBilling;
use Illuminate\Http\Request;
final class WorkshopBillingController extends Controller {
public function index(Request $r,WorkshopBilling $w){return response()->json($w->listing($r->user()->id))->header('Cache-Control','no-store, private');}
public function prepare(Request $r,int $id,WorkshopBilling $w){return response()->json($w->prepare($id,$r->user()->id,$r->all(),(string)$r->header('Idempotency-Key')));}
public function review(Request $r,int $id,WorkshopBilling $w){return response()->json($w->review($id,$r->user()->id,$r->all(),(string)$r->header('Idempotency-Key')));}
public function generate(Request $r,int $id,WorkshopBilling $w){return response()->json($w->generate($id,$r->user()->id,$r->all(),(string)$r->header('Idempotency-Key')));}
}
+85
View File
@@ -0,0 +1,85 @@
<?php
namespace App\Modules\Workshop;
use App\Modules\Identity\Services\{Audit,Permissions};
use App\Modules\Services\{ServiceWorkflow,ServiceCalculation,DraftValues};
use App\Shared\Context\CompanyContext;
use App\Shared\Costs\ExactCostMath as Exact;
use Illuminate\Support\Facades\{DB,Validator};
final class WorkshopBilling {
public const POLICY='WORKSHOP-BILLING-DRAFT-SIM-v1';
public function __construct(private CompanyContext $context,private Permissions $permissions,private ServiceWorkflow $workflow){}
public static function guard(): void {WorkshopWorkflow::guard();}
private function json($x): string{return json_encode($x,JSON_THROW_ON_ERROR|JSON_UNESCAPED_UNICODE);}
private function canonical($x){if(!is_array($x))return $x;if(!array_is_list($x))ksort($x);return array_map(fn($v)=>$this->canonical($v),$x);}
private function exact(array $in,array $rules): array{
abort_if(array_diff(array_keys($in),array_keys($rules)),422,'Campo fora do recorte.');
return Validator::make($in,$rules,[
'required'=>'Preencha :attribute.','present'=>'Falta :attribute; actualize o formulário.','integer'=>':attribute deve ser um número inteiro.',
'string'=>':attribute deve ser texto.','array'=>':attribute deve conter uma lista.','in'=>':attribute tem um valor não permitido.',
'min'=>':attribute não cumpre o mínimo permitido (:min).','max'=>':attribute excede o máximo permitido (:max).',
'lines.required'=>'Seleccione pelo menos uma origem verificada.','lines.min'=>'Seleccione pelo menos uma origem verificada.',
],['entry_id'=>'a origem','entry_version'=>'a versão da origem','service_id'=>'o serviço comercial','service_version'=>'a versão do serviço','price'=>'o preço comercial','price_source'=>'a fonte comercial e versão','lines'=>'as origens seleccionadas','evidence'=>'o fundamento da proposta','reason'=>'o fundamento da revisão','client_id'=>'o cliente','currency'=>'a moeda','version'=>'a versão','previous_id'=>'a referência anterior','decision'=>'a decisão','id'=>'a proposta'])->validate();
}
private function scope(int $actor,string $action): array {
$s=$this->context->identifiers()+['unit_id'=>$this->context->unitId()];abort_unless($this->context->userId()===$actor&&$s['unit_id']!==null,403);$this->context->selectFor($actor,$s['tenant_id'],$s['company_id'],$s['unit_id']);
foreach(['workshop_billing.view','workshop_billing.'.$action,'workshop.view'] as $right)$this->permissions->require($actor,$s['tenant_id'],$s['company_id'],$right,$s['unit_id']);
foreach(['clients.view','services.view'] as $right)$this->permissions->require($actor,$s['tenant_id'],$s['company_id'],$right);return $s;
}
private function order(int $id,array $s): object{return DB::table('wo_orders')->where($s)->where('id',$id)->first()??abort(403,'Ordem fora do contexto.');}
private function source(int $id,int $version,int $order): object {
$e=DB::table('wo_entries')->where(['id'=>$id,'version'=>$version,'order_id'=>$order])->first()??abort(409,'Origem/versão incompatível.');$e->data=json_decode($e->data,true);
abort_unless(!$e->outside_authority&&!DB::table('wo_entries')->where('previous_id',$id)->exists()&&DB::table('wo_decisions')->where(['entry_id'=>$id,'entry_version'=>$version,'decision'=>'verified'])->exists(),409,'Origem não verificada ou desactualizada.');
$task=DB::table('wo_entries')->where(['id'=>$e->task_id,'order_id'=>$order,'kind'=>'task'])->first();
abort_unless($task&&!DB::table('wo_entries')->where('previous_id',$task->id)->exists()&&DB::table('wo_decisions')->where(['entry_id'=>$task->id,'entry_version'=>$task->version,'decision'=>'verified'])->exists(),409,'Tarefa não verificada/actual.');
abort_unless(($e->kind==='time'&&$e->data['time_type']==='work')||($e->kind==='material'&&$e->data['event']==='consumed'&&$e->data['owner']==='company'),422,'Só tempo efectivo e material consumido da empresa.');return $e;
}
private function compose(int $order,array $input,array $s,bool $allowClaim=false): array {
$o=$this->order($order,$s);abort_unless($input['client_id']===$o->client_id&&$input['currency']==='MZN',409,'Cliente ou moeda incompatível.');
$client=DB::table('a_clients')->where(['id'=>$o->client_id,'tenant_id'=>$s['tenant_id'],'company_id'=>$s['company_id']])->first()??abort(409);
abort_unless(count($input['lines'])>0,422);$seen=[];$lines=[];
foreach($input['lines'] as $line){
$d=$this->exact($line,['entry_id'=>'required|integer|min:1','entry_version'=>'required|integer|min:1','service_id'=>'required|integer|min:1','service_version'=>'required|integer|min:1','price'=>'required|string','price_source'=>'required|string|min:3|max:120']);
$e=$this->source($d['entry_id'],$d['entry_version'],$order);abort_if(isset($seen[$e->origin]),409,'Origem repetida.');$seen[$e->origin]=true;
abort_if(!$allowClaim&&DB::table('wb_claims')->where(['order_id'=>$order,'origin'=>$e->origin])->exists(),409,'Origem já utilizada comercialmente.');
$service=DB::table('a_services')->where(['id'=>$d['service_id'],'version'=>$d['service_version'],'tenant_id'=>$s['tenant_id'],'company_id'=>$s['company_id']])->first()??abort(409,'Serviço/versão incompatível.');
$price=DraftValues::decimal($d['price'],'price');abort_if($price===null,422,'Preço desconhecido não permite gerar.');
$quantity=$e->kind==='time'?Exact::text(Exact::hours($e->minutes)):$e->quantity;$quantity=DraftValues::decimal($quantity,'quantity',true);
$lines[]=['entry_id'=>$e->id,'entry_version'=>$e->version,'origin'=>$e->origin,'task_id'=>$e->task_id,'source_kind'=>$e->kind,'source_quantity'=>$e->kind==='time'?(string)$e->minutes:$e->quantity,'unit'=>$e->kind==='time'?'H':$e->data['unit'],'service_id'=>$service->id,'service_version'=>$service->version,'quantity'=>$quantity,'unit_price'=>$price,'price_source'=>$d['price_source'],'description'=>"Oficina #{$order} · origem #{$e->id} v{$e->version} · ".($e->kind==='time'?'Trabalho efectivo':$e->data['resource'])];
}
$data=['currency'=>'MZN','lines'=>$lines];return ['policy'=>self::POLICY,'order_id'=>$order,'client_id'=>$o->client_id,'client_version'=>$client->version,'currency'=>'MZN','lines'=>$lines,'base_exact'=>DraftValues::base($data),'price_policy'=>'explicit_commercial_not_internal_cost','evidence'=>$input['evidence']];
}
private function command(int $order,int $actor,string $action,array $d,string $key,callable $write): array {
self::guard();$s=$this->scope($actor,$action);if($action==='generate'){$this->workflow->scope('service_drafts',$actor,'create');$this->workflow->scope('billing_drafts',$actor,'create');}$this->order($order,$s);abort_unless(preg_match('/^[A-Za-z0-9-]{8,100}$/D',$key),422);$hash=hash('sha256',$this->json($this->canonical($d)));
return DB::transaction(function()use($order,$actor,$action,$d,$key,$hash,$write,$s){DB::table('companies')->where('id',$s['company_id'])->lockForUpdate()->firstOrFail();$this->scope($actor,$action);if($action==='generate'){$this->workflow->scope('service_drafts',$actor,'create');$this->workflow->scope('billing_drafts',$actor,'create');}$this->order($order,$s);
$old=DB::table('wb_commands')->where(['order_id'=>$order,'actor_id'=>$actor,'action'=>$action,'command_key'=>$key])->first();if($old){abort_unless(hash_equals($old->request_hash,$hash),409);return json_decode($old->result,true)+['replayed'=>true];}
$out=$write($s);$cmd=DB::table('wb_commands')->insertGetId(['order_id'=>$order,'actor_id'=>$actor,'action'=>$action,'command_key'=>$key,'request_hash'=>$hash,'result'=>$this->json($out),'created_at'=>now()]);Audit::record('workshop_billing.'.$action,$actor,$s['tenant_id'],$s['company_id'],$s['unit_id'],details:['record_id'=>$out['id'],'version'=>$out['version']]);
$event=DB::table('wb_events')->insertGetId(['command_id'=>$cmd,'payload'=>$this->json(['policy'=>self::POLICY,'scope'=>$s,'action'=>$action,'result'=>$out]),'created_at'=>now()]);DB::table('wb_outbox')->insert(['event_id'=>$event,'state'=>'captured_no_stock_or_accounting']);return $out+['replayed'=>false];},3);
}
public function prepare(int $order,int $actor,array $in,string $key): array {
self::guard();$d=$this->exact($in,['version'=>'required|integer|min:1','previous_id'=>'present|nullable|integer|min:1','client_id'=>'required|integer|min:1','currency'=>'required|in:MZN','lines'=>'required|array|min:1|max:50','evidence'=>'required|string|min:3|max:1000']);
return $this->command($order,$actor,'prepare',$d,$key,function($s)use($order,$actor,$d){abort_if(DB::table('wb_generations')->where('order_id',$order)->exists(),409,'Ordem já convertida; exige correcção própria.');$last=DB::table('wb_proposals')->where('order_id',$order)->orderByDesc('version')->first();abort_unless($d['version']===($last?->version??0)+1&&$d['previous_id']===$last?->id,409,'Rever versão anterior.');$snapshot=$this->compose($order,$d,$s);$id=DB::table('wb_proposals')->insertGetId(['order_id'=>$order,'version'=>$d['version'],'previous_id'=>$last?->id,'snapshot'=>$this->json($snapshot),'actor_id'=>$actor,'created_at'=>now()]);return ['id'=>$id,'version'=>$d['version']];});
}
private function proposal(int $order,array $d): object {$p=DB::table('wb_proposals')->where(['id'=>$d['id'],'order_id'=>$order,'version'=>$d['version']])->first()??abort(409,'Proposta/versão incompatível.');abort_if(DB::table('wb_proposals')->where('previous_id',$p->id)->exists(),409,'Proposta desactualizada.');return $p;}
private function recheck(object $p,array $s,bool $allowClaim=false): array {
$snap=is_array($p->snapshot)?$p->snapshot:json_decode($p->snapshot,true);$lines=array_map(fn($l)=>['entry_id'=>$l['entry_id'],'entry_version'=>$l['entry_version'],'service_id'=>$l['service_id'],'service_version'=>$l['service_version'],'price'=>$l['unit_price'],'price_source'=>$l['price_source']],$snap['lines']);$new=$this->compose($p->order_id,['client_id'=>$snap['client_id'],'currency'=>$snap['currency'],'lines'=>$lines,'evidence'=>$snap['evidence']],$s,$allowClaim);abort_unless($this->canonical($snap)===$this->canonical($new),409,'Dados comerciais/origens mudaram; nova proposta necessária.');return $snap;
}
public function review(int $order,int $actor,array $in,string $key): array {
self::guard();$d=$this->exact($in,['id'=>'required|integer|min:1','version'=>'required|integer|min:1','decision'=>'required|in:approved,refused','reason'=>'required|string|min:3|max:1000']);
return $this->command($order,$actor,'review',$d,$key,function($s)use($order,$actor,$d){$p=$this->proposal($order,$d);abort_if($p->actor_id===$actor,403,'Revisor distinto necessário.');$this->recheck($p,$s);abort_if(DB::table('wb_decisions')->where('proposal_id',$p->id)->exists(),409);$id=DB::table('wb_decisions')->insertGetId(['proposal_id'=>$p->id,'version'=>$p->version,'decision'=>$d['decision'],'reason'=>$d['reason'],'actor_id'=>$actor,'created_at'=>now()]);return ['id'=>$id,'version'=>$p->version];});
}
public function generate(int $order,int $actor,array $in,string $key): array {
self::guard();$d=$this->exact($in,['id'=>'required|integer|min:1','version'=>'required|integer|min:1']);
return $this->command($order,$actor,'generate',$d,$key,function($s)use($order,$actor,$d,$key){$p=$this->proposal($order,$d);abort_unless(DB::table('wb_decisions')->where(['proposal_id'=>$p->id,'version'=>$p->version,'decision'=>'approved'])->exists(),409,'Revisão exacta necessária.');abort_if(DB::table('wb_generations')->where('order_id',$order)->exists(),409,'Ordem já convertida.');$snap=$this->recheck($p,$s);
$this->workflow->scope('service_drafts',$actor,'create');$this->workflow->scope('billing_drafts',$actor,'create');
$lines=array_map(fn($l)=>array_intersect_key($l,array_flip(['service_id','quantity','unit_price','description'])),$snap['lines']);$name='Oficina #'.$order.' · proposta #'.$p->id.' v'.$p->version;
$service=$this->workflow->save('service_drafts',null,$actor,['client_id'=>$snap['client_id'],'name'=>$name,'currency'=>'MZN','lines'=>$lines,'description'=>'Origem rastreável de oficina; sem validade fiscal.'],substr(hash('sha256','wb-service-'.$key),0,40));
$billing=$this->workflow->save('billing_drafts',null,$actor,['source_id'=>$service['id'],'name'=>$name],substr(hash('sha256','wb-billing-'.$key),0,40));
$id=DB::table('wb_generations')->insertGetId(['order_id'=>$order,'proposal_id'=>$p->id,'service_draft_id'=>$service['id'],'billing_draft_id'=>$billing['id'],'actor_id'=>$actor,'created_at'=>now()]);foreach($snap['lines'] as $l)DB::table('wb_claims')->insert(['generation_id'=>$id,'order_id'=>$order,'origin'=>$l['origin'],'entry_id'=>$l['entry_id'],'entry_version'=>$l['entry_version']]);return ['id'=>$id,'version'=>$p->version,'service_draft_id'=>$service['id'],'billing_draft_id'=>$billing['id'],'base_exact'=>$snap['base_exact']];});
}
public function listing(int $actor): array {
$s=$this->scope($actor,'view');if(!ServiceCalculation::isolated())return ['blocked'=>true,'orders'=>[]];self::guard();
return DB::transaction(function()use($s){DB::table('companies')->where('id',$s['company_id'])->lockForUpdate()->firstOrFail();$orders=[];foreach(DB::table('wo_orders')->where($s)->get() as $o){$entries=[];foreach(DB::table('wo_entries')->where('order_id',$o->id)->whereIn('kind',['time','material'])->get() as $e){try{$entries[]=$this->source($e->id,$e->version,$o->id);}catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface){}}
$proposals=DB::table('wb_proposals')->where('order_id',$o->id)->orderBy('version')->get()->all();foreach($proposals as $p){$p->snapshot=json_decode($p->snapshot,true);$p->decision=DB::table('wb_decisions')->where('proposal_id',$p->id)->first();$p->current=!DB::table('wb_proposals')->where('previous_id',$p->id)->exists();if($p->current){try{$this->recheck($p,$s,true);}catch(\Throwable){$p->current=false;}}}
$orders[]=(array)$o+['entries'=>$entries,'proposals'=>$proposals,'generation'=>DB::table('wb_generations')->where('order_id',$o->id)->first()];}return ['blocked'=>false,'orders'=>$orders,'services'=>DB::table('a_services')->where(['tenant_id'=>$s['tenant_id'],'company_id'=>$s['company_id']])->get()->all()];});
}
}
@@ -0,0 +1,16 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Support\Facades\DB;
return new class extends Migration {
public function up(): void {
$old=substr(DB::selectOne("SELECT pg_get_constraintdef(oid) AS d FROM pg_constraint WHERE conrelid='permission_grants'::regclass AND conname='permission_grants_scope_check'")->d,6);
DB::statement('ALTER TABLE permission_grants DROP CONSTRAINT permission_grants_scope_check');
DB::statement("ALTER TABLE permission_grants ADD CONSTRAINT permission_grants_scope_check CHECK (($old) OR (permission IN ('industrial_budgets.view','industrial_budgets.prepare','industrial_budgets.validate','industrial_budget_comparisons.view','industrial_budget_comparisons.prepare') AND unit_id IS NOT NULL))");
DB::unprepared(file_get_contents(__DIR__.'/../sql/industrial-budgets.sql'));
foreach(['ib_budgets','ib_decisions','ib_comparisons','ib_commands','ib_events','ib_outbox'] as $t){
DB::statement("CREATE TRIGGER {$t}_immutable BEFORE UPDATE OR DELETE ON {$t} FOR EACH ROW EXECUTE FUNCTION sgf_append_only_audit()");
DB::statement("CREATE TRIGGER {$t}_environment BEFORE INSERT ON {$t} FOR EACH ROW EXECUTE FUNCTION sgf_ic_test_only()");
}
}
public function down(): void {throw new RuntimeException('Budget history requires reviewed preservation.');}
};
@@ -0,0 +1,16 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Support\Facades\DB;
return new class extends Migration {
public function up(): void {
$old=substr(DB::selectOne("SELECT pg_get_constraintdef(oid) AS d FROM pg_constraint WHERE conrelid='permission_grants'::regclass AND conname='permission_grants_scope_check'")->d,6);
DB::statement('ALTER TABLE permission_grants DROP CONSTRAINT permission_grants_scope_check');
DB::statement("ALTER TABLE permission_grants ADD CONSTRAINT permission_grants_scope_check CHECK (($old) OR (permission IN ('workshop_billing.view','workshop_billing.prepare','workshop_billing.review','workshop_billing.generate') AND unit_id IS NOT NULL))");
DB::unprepared(file_get_contents(__DIR__.'/../sql/workshop-billing.sql'));
foreach(['wb_proposals','wb_decisions','wb_generations','wb_claims','wb_commands','wb_events','wb_outbox'] as $t){
DB::statement("CREATE TRIGGER {$t}_immutable BEFORE UPDATE OR DELETE ON {$t} FOR EACH ROW EXECUTE FUNCTION sgf_append_only_audit()");
DB::statement("CREATE TRIGGER {$t}_environment BEFORE INSERT ON {$t} FOR EACH ROW EXECUTE FUNCTION sgf_ic_test_only()");
}
}
public function down(): void {throw new RuntimeException('Workshop commercial history requires reviewed preservation.');}
};
+60
View File
@@ -0,0 +1,60 @@
CREATE TABLE ib_budgets (
id bigserial PRIMARY KEY, lot_id bigint NOT NULL REFERENCES ic_lots(id),
version integer NOT NULL CHECK(version>0), previous_id bigint UNIQUE REFERENCES ib_budgets(id),
dimensions jsonb NOT NULL, amounts jsonb NOT NULL, evidence text NOT NULL CHECK(length(evidence)>=3),
actor_id bigint NOT NULL REFERENCES users(id), created_at timestamptz NOT NULL, UNIQUE(lot_id,version)
);
CREATE TABLE ib_decisions (
id bigserial PRIMARY KEY, budget_id bigint UNIQUE NOT NULL REFERENCES ib_budgets(id), version integer NOT NULL,
decision text NOT NULL CHECK(decision IN ('approved','refused')), reason text NOT NULL CHECK(length(reason)>=3),
actor_id bigint NOT NULL REFERENCES users(id), created_at timestamptz NOT NULL
);
CREATE TABLE ib_comparisons (
id bigserial PRIMARY KEY, lot_id bigint NOT NULL REFERENCES ic_lots(id), version integer NOT NULL CHECK(version>0),
previous_id bigint UNIQUE REFERENCES ib_comparisons(id), budget_id bigint NOT NULL REFERENCES ib_budgets(id),
result_id bigint NOT NULL REFERENCES ic_results(id), snapshot jsonb NOT NULL,
actor_id bigint NOT NULL REFERENCES users(id), created_at timestamptz NOT NULL, UNIQUE(lot_id,version)
);
CREATE TABLE ib_commands (
id bigserial PRIMARY KEY, lot_id bigint NOT NULL REFERENCES ic_lots(id),actor_id bigint NOT NULL REFERENCES users(id),
action text NOT NULL CHECK(action IN ('propose','decide','compare')),command_key text NOT NULL,request_hash text NOT NULL,
result jsonb NOT NULL,created_at timestamptz NOT NULL,UNIQUE(lot_id,actor_id,action,command_key)
);
CREATE TABLE ib_events(id bigserial PRIMARY KEY,command_id bigint UNIQUE NOT NULL REFERENCES ib_commands(id),payload jsonb NOT NULL,created_at timestamptz NOT NULL);
CREATE TABLE ib_outbox(event_id bigint PRIMARY KEY REFERENCES ib_events(id),state text NOT NULL CHECK(state='captured_no_stock_or_accounting'));
CREATE OR REPLACE FUNCTION sgf_ib_integrity() RETURNS trigger LANGUAGE plpgsql AS $$
DECLARE lid bigint; prior bigint; n integer; b ib_budgets; r ic_results; ref jsonb;
BEGIN
PERFORM sgf_ic_environment();
IF TG_TABLE_NAME='ib_decisions' THEN
SELECT * INTO STRICT b FROM ib_budgets WHERE id=NEW.budget_id;
lid=b.lot_id;
ELSE lid=NEW.lot_id; END IF;
PERFORM 1 FROM companies WHERE id=(SELECT company_id FROM ic_lots WHERE id=lid) FOR UPDATE;
IF TG_TABLE_NAME='ib_decisions' THEN
IF b.actor_id=NEW.actor_id OR b.version<>NEW.version OR EXISTS(SELECT 1 FROM ib_budgets WHERE previous_id=b.id) THEN RAISE EXCEPTION 'SGF_IB_DECISION_VERSION_IDENTITY'; END IF;
ELSIF TG_TABLE_NAME='ib_commands' THEN RETURN NEW;
ELSE
IF TG_TABLE_NAME='ib_budgets' THEN
SELECT coalesce(max(version),0) INTO n FROM ib_budgets WHERE lot_id=lid;
IF n>0 THEN SELECT id INTO STRICT prior FROM ib_budgets WHERE lot_id=lid AND version=n; END IF;
ELSE
SELECT coalesce(max(version),0) INTO n FROM ib_comparisons WHERE lot_id=lid;
IF n>0 THEN SELECT id INTO STRICT prior FROM ib_comparisons WHERE lot_id=lid AND version=n; END IF;
SELECT * INTO STRICT b FROM ib_budgets WHERE id=NEW.budget_id AND lot_id=lid;
SELECT * INTO STRICT r FROM ic_results WHERE id=NEW.result_id AND lot_id=lid;
IF NOT EXISTS(SELECT 1 FROM ib_decisions WHERE budget_id=b.id AND decision='approved') OR EXISTS(SELECT 1 FROM ib_budgets WHERE previous_id=b.id)
OR NOT EXISTS(SELECT 1 FROM ic_decisions WHERE result_id=r.id AND decision='approved') OR EXISTS(SELECT 1 FROM ic_results WHERE previous_id=r.id)
THEN RAISE EXCEPTION 'SGF_IB_APPROVED_CURRENT_REFERENCES'; END IF;
FOR ref IN SELECT value FROM jsonb_each(r.snapshot->'refs') LOOP
IF ref<>'null'::jsonb THEN PERFORM sgf_ic_input_current((ref->>'id')::bigint,lid,(ref->>'version')::integer); END IF;
END LOOP;
END IF;
IF NEW.version<>n+1 OR (n=0 AND NEW.previous_id IS NOT NULL) OR (n>0 AND NEW.previous_id IS DISTINCT FROM prior) THEN RAISE EXCEPTION 'SGF_IB_VERSION'; END IF;
END IF;
RETURN NEW;
END; $$;
CREATE TRIGGER ib_budget_integrity BEFORE INSERT ON ib_budgets FOR EACH ROW EXECUTE FUNCTION sgf_ib_integrity();
CREATE TRIGGER ib_decision_integrity BEFORE INSERT ON ib_decisions FOR EACH ROW EXECUTE FUNCTION sgf_ib_integrity();
CREATE TRIGGER ib_comparison_integrity BEFORE INSERT ON ib_comparisons FOR EACH ROW EXECUTE FUNCTION sgf_ib_integrity();
CREATE TRIGGER ib_command_integrity BEFORE INSERT ON ib_commands FOR EACH ROW EXECUTE FUNCTION sgf_ib_integrity();
+46
View File
@@ -0,0 +1,46 @@
CREATE TABLE wb_proposals(id bigserial PRIMARY KEY,order_id bigint NOT NULL REFERENCES wo_orders(id),version integer NOT NULL CHECK(version>0),previous_id bigint UNIQUE REFERENCES wb_proposals(id),snapshot jsonb NOT NULL,actor_id bigint NOT NULL REFERENCES users(id),created_at timestamptz NOT NULL,UNIQUE(order_id,version));
CREATE TABLE wb_decisions(id bigserial PRIMARY KEY,proposal_id bigint UNIQUE NOT NULL REFERENCES wb_proposals(id),version integer NOT NULL,decision text NOT NULL CHECK(decision IN ('approved','refused')),reason text NOT NULL CHECK(length(reason)>=3),actor_id bigint NOT NULL REFERENCES users(id),created_at timestamptz NOT NULL);
CREATE TABLE wb_generations(id bigserial PRIMARY KEY,order_id bigint UNIQUE NOT NULL REFERENCES wo_orders(id),proposal_id bigint UNIQUE NOT NULL REFERENCES wb_proposals(id),service_draft_id bigint UNIQUE NOT NULL REFERENCES a_service_drafts(id),billing_draft_id bigint UNIQUE NOT NULL REFERENCES a_billing_drafts(id),actor_id bigint NOT NULL REFERENCES users(id),created_at timestamptz NOT NULL);
CREATE TABLE wb_claims(id bigserial PRIMARY KEY,generation_id bigint NOT NULL REFERENCES wb_generations(id),order_id bigint NOT NULL REFERENCES wo_orders(id),origin text NOT NULL,entry_id bigint UNIQUE NOT NULL REFERENCES wo_entries(id),entry_version integer NOT NULL,UNIQUE(order_id,origin));
CREATE TABLE wb_commands(id bigserial PRIMARY KEY,order_id bigint NOT NULL REFERENCES wo_orders(id),actor_id bigint NOT NULL REFERENCES users(id),action text NOT NULL CHECK(action IN ('prepare','review','generate')),command_key text NOT NULL,request_hash text NOT NULL,result jsonb NOT NULL,created_at timestamptz NOT NULL,UNIQUE(order_id,actor_id,action,command_key));
CREATE TABLE wb_events(id bigserial PRIMARY KEY,command_id bigint UNIQUE NOT NULL REFERENCES wb_commands(id),payload jsonb NOT NULL,created_at timestamptz NOT NULL);
CREATE TABLE wb_outbox(event_id bigint PRIMARY KEY REFERENCES wb_events(id),state text NOT NULL CHECK(state='captured_no_stock_or_accounting'));
CREATE OR REPLACE FUNCTION sgf_wb_integrity() RETURNS trigger LANGUAGE plpgsql AS $$
DECLARE p wb_proposals; n integer; prev bigint; e wo_entries;
BEGIN
PERFORM sgf_ic_environment();
IF TG_TABLE_NAME='wb_decisions' THEN
SELECT * INTO STRICT p FROM wb_proposals WHERE id=NEW.proposal_id;
IF p.version<>NEW.version OR p.actor_id=NEW.actor_id OR EXISTS(SELECT 1 FROM wb_proposals WHERE previous_id=p.id) THEN RAISE EXCEPTION 'SGF_WB_REVIEW_IDENTITY_VERSION'; END IF;
ELSIF TG_TABLE_NAME='wb_proposals' THEN
PERFORM 1 FROM companies WHERE id=(SELECT company_id FROM wo_orders WHERE id=NEW.order_id) FOR UPDATE;
SELECT coalesce(max(version),0) INTO n FROM wb_proposals WHERE order_id=NEW.order_id;
SELECT id INTO prev FROM wb_proposals WHERE order_id=NEW.order_id AND version=n;
IF NEW.version<>n+1 OR NEW.previous_id IS DISTINCT FROM prev THEN RAISE EXCEPTION 'SGF_WB_VERSION'; END IF;
ELSIF TG_TABLE_NAME='wb_generations' THEN
SELECT * INTO STRICT p FROM wb_proposals WHERE id=NEW.proposal_id AND order_id=NEW.order_id;
IF EXISTS(SELECT 1 FROM wb_proposals WHERE previous_id=p.id) OR NOT EXISTS(SELECT 1 FROM wb_decisions WHERE proposal_id=p.id AND version=p.version AND decision='approved') THEN RAISE EXCEPTION 'SGF_WB_APPROVED_CURRENT'; END IF;
ELSIF TG_TABLE_NAME='wb_claims' THEN
SELECT * INTO STRICT e FROM wo_entries WHERE id=NEW.entry_id AND order_id=NEW.order_id AND version=NEW.entry_version AND origin=NEW.origin;
IF NOT EXISTS(SELECT 1 FROM wb_generations WHERE id=NEW.generation_id AND order_id=NEW.order_id) OR e.outside_authority OR EXISTS(SELECT 1 FROM wo_entries WHERE previous_id=e.id) OR NOT EXISTS(SELECT 1 FROM wo_decisions WHERE entry_id=e.id AND entry_version=e.version AND decision='verified') THEN RAISE EXCEPTION 'SGF_WB_SOURCE'; END IF;
END IF;
RETURN NEW;
END; $$;
CREATE TRIGGER wb_proposal_integrity BEFORE INSERT ON wb_proposals FOR EACH ROW EXECUTE FUNCTION sgf_wb_integrity();
CREATE TRIGGER wb_review_integrity BEFORE INSERT ON wb_decisions FOR EACH ROW EXECUTE FUNCTION sgf_wb_integrity();
CREATE TRIGGER wb_generation_integrity BEFORE INSERT ON wb_generations FOR EACH ROW EXECUTE FUNCTION sgf_wb_integrity();
CREATE TRIGGER wb_claim_integrity BEFORE INSERT ON wb_claims FOR EACH ROW EXECUTE FUNCTION sgf_wb_integrity();
CREATE OR REPLACE FUNCTION sgf_wb_draft_locked() RETURNS trigger LANGUAGE plpgsql AS $$
BEGIN
IF (TG_TABLE_NAME='a_service_drafts' AND EXISTS(SELECT 1 FROM wb_generations WHERE service_draft_id=OLD.id)) OR (TG_TABLE_NAME='a_billing_drafts' AND EXISTS(SELECT 1 FROM wb_generations WHERE billing_draft_id=OLD.id)) THEN RAISE EXCEPTION 'SGF_WB_LINKED_DRAFT_REQUIRES_REVIEWED_CORRECTION'; END IF;
IF TG_OP='UPDATE' THEN RETURN NEW; END IF;
RETURN OLD;
END; $$;
CREATE TRIGGER wb_service_locked BEFORE UPDATE OR DELETE ON a_service_drafts FOR EACH ROW EXECUTE FUNCTION sgf_wb_draft_locked();
CREATE TRIGGER wb_billing_locked BEFORE UPDATE OR DELETE ON a_billing_drafts FOR EACH ROW EXECUTE FUNCTION sgf_wb_draft_locked();
CREATE OR REPLACE FUNCTION sgf_wb_no_second_billing() RETURNS trigger LANGUAGE plpgsql AS $$
BEGIN
IF EXISTS(SELECT 1 FROM wb_generations WHERE service_draft_id=NEW.source_id) THEN RAISE EXCEPTION 'SGF_WB_SOURCE_ALREADY_CONVERTED'; END IF;
RETURN NEW;
END; $$;
CREATE TRIGGER wb_no_second_billing BEFORE INSERT ON a_billing_drafts FOR EACH ROW EXECUTE FUNCTION sgf_wb_no_second_billing();
+35
View File
@@ -0,0 +1,35 @@
# Página inicial e menus agrupados
## Avaliação técnica e preservação local — 28/10/2026
A pedido do utilizador, preservar esta implementação num checkpoint exclusivamente local. Avaliação do agente: organização coerente com os destinos existentes, grupos filtrados por contexto, distinção entre consulta/preparação/validação, ausência de indicadores fictícios e identidade visual alinhada com as folhas públicas do InvesteMoz. Build, renderização por perfil e entrega HTTP aprovados. Esta é avaliação técnica do código e dos resultados automatizados, não aprovação visual pessoal do utilizador. Capturas e verificação visual/interactiva no Edge continuam indisponíveis; o checkpoint não as transforma em provas realizadas. Nenhum segredo ou dado privado incluído, sem push/publicação. Encerramento do ensaio de orçamento conferido em `04870f0` e `docs/INDUSTRIAL_BUDGET_ACCEPTANCE.md`, mantendo expressamente as limitações originais.
## Compatibilização visual com InvesteMoz — 28/10/2026
Por pedido posterior do utilizador, acrescentada `resources/css/tempo-theme.css`, importada depois dos estilos base do SGF. Referência conferida exclusivamente em leitura nas folhas de apresentação públicas `resources/css/app.css` e `resources/css/tempo-header.css` do portal-investidor: cabeçalho #090909, destaque #ed1c24, cinzentos neutros, superfície branca, bordas #e2e8f0 e raio de 10px. Não se acedeu a configurações privadas nem se alteraram ficheiros, dados ou serviços do InvesteMoz.
Aplicados ao SGF: navegação em carvão, marcador activo vermelho, botões principais vermelhos, cabeçalho/conteúdo claros, cartões neutros, hierarquia de títulos, campos e tabelas alinhados com a mesma linguagem visual. Grupos e destinos permanecem os autorizados, sem copiar menu público, marcas ou conteúdos do portal. Verde/âmbar/erro mantêm significado de estados, distinguindo-os da cor de marca. Instrument Sans é só preferência local, com fallback de sistema; nenhum tipo de letra ou recurso externo foi descarregado. Compilação aprovada com Vite 8.3.5 e diff sem erros. Sem nova prova visual no Edge: compatibilização fundamentada em CSS, com revisão visual manual ainda pendente.
Verificação HTTP posterior: na instância `8002`, diagnóstico confirmou `browser-testing`/`sgf_tempo_test`; página inicial, JavaScript e CSS responderam 200. O HTML referencia o ficheiro JavaScript do manifesto actual e o CSS servido contém o destaque #ed1c24. Esta prova confirma a entrega dos ficheiros compilados, sem comprovar o aspecto visual ou a interacção no navegador.
28/10/2026. Implementação autorizada após [mapa e esboço](HOME_NAVIGATION_PROPOSAL.md). Preservado o ensaio aceite em `04870f0`, checkpoints anteriores e limites financeiros. Sem migrações, concessões, novas dependências ou activação real. Sem aceitação presumida ou checkpoint desta alteração.
## Alterações
Barra lateral com oito grupos: Início, Clientes e serviços, Facturação, Recebimentos, Oficinas, Custos e orçamento, Contabilidade e fiscalidade e Administração. Só aparecem grupos com destinos permitidos. Grupo da página actual sempre aberto, opção activa destacada com marcador e `aria-current`; restantes grupos expansíveis com `aria-expanded`. Destinos reaproveitam os ecrãs existentes, sem criar módulos de equipamentos, afectações ou séries independentes. Apresentação do rascunho permanece em Facturação. Empresa/unidade continuam em contexto explícito; mudança de acessos que retire o destino devolve à página inicial quando a sessão actualizada recebe essas concessões.
Página inicial com atalhos de preparação/acompanhamento e validação conforme os direitos, nunca conforme nomes/emails. Consulta mantém atalhos de leitura. As acções abrem os percursos existentes: não criam decisões ou alteram dados no painel inicial. Não há contagens, montantes, gráficos ou listas de tarefas inventados. Consulta agregada de pendências ainda não implementada: mensagem explícita explica que os estados são consultados no respectivo percurso. Consulta não confere preparação/validação.
Cabeçalho fixo com empresa/unidade, ambiente local e aviso de operações reais bloqueadas. Os avisos específicos dos módulos permanecem. Em ecrã pequeno, botão Menu abre um diálogo nativo com fecho por botão/Escape e gestão de foco do navegador. Menu mantém conta actual e saída. Tabelas directamente contidas em painéis têm scroll próprio; contexto e atalhos adaptam-se a uma coluna. Cores base preservadas.
## Verificações e limites
- `scripts/sgf.ps1 npm run build`: aprovado, Vite 8.3.5, sem alteração de dependências.
- `scripts/sgf.ps1 npm exec --offline -c 'node scripts/home-navigation-check.mjs'`: verificações de renderização aprovadas para preparador, validador, leitor, outra unidade e ausência de permissões. Não usam base de dados ou navegador.
- `git diff --check`: aprovado.
- Não se repetiu a bateria financeira: alteração limitada à apresentação, sem mudanças no servidor, cálculos ou base. A prova manual industrial anterior permanece preservada.
- **Sem validação visual nova no Edge ou capturas:** automação continua bloqueada; não foi repetida. Renderização e build não provam comportamento visual ou interacção real do diálogo móvel. Revisão manual a efectuar no navegador.
Ficheiros: `resources/js/WorkspaceNavigation.jsx`, `resources/js/WorkspaceHome.jsx`, integração em `resources/js/app.jsx`, estilos em `resources/css/app.css`, verificação `scripts/home-navigation-check.mjs` e documentação. Não foram aplicadas `110000` ou sete concessões por consequência desta alteração.
Para rever: actualizar `http://127.0.0.1:8002/` enquanto a instância de prova SGF estiver activa, entrar pelas contas sintéticas já preparadas e abrir Início. Conferir grupos de acordo com concessões, preparação versus validação, permanência do grupo actual aberto e menu em janela estreita, Escape e retorno de foco. Não enviar credenciais em capturas. Se a instância estiver parada, seguir o procedimento de retoma de prova isolada documentado, sem executar testes destrutivos sobre a fixture manual.
+60
View File
@@ -0,0 +1,60 @@
# Página inicial e navegação agrupada — proposta
28/10/2026. Primeiro passo de desenho solicitado pelo utilizador; **sem alteração da aplicação**. Preservar o ensaio aceite no checkpoint `04870f0` e anteriores. A migração `110000`, sete concessões e utilização real continuam por autorizar. Este mapa não cria funcionalidades, direitos ou acesso operacional.
## Base actual conferida no código
`resources/js/app.jsx` apresenta uma lista lateral plana, filtrada pelas concessões do contexto, e destaca a página seleccionada. A página inicial tem saudação e dois cartões: empresa e unidade. O cabeçalho mostra o contexto, com selectores de empresa/unidade antes do conteúdo. Os módulos de ensaio apresentam avisos próprios; não há hoje uma lista agregada de tarefas pendentes na página inicial. Esta descrição é conferência de fonte, não captura visual da aplicação em execução.
Captura actual da página inicial/menu ainda não disponível. A automação do Edge permaneceu bloqueada e não deve ser repetida ou contornada. Para ajustar o desenho visual ao ecrã real, a captura manual deve mostrar a página inicial e o menu, sem credenciais; dados pessoais podem ser ocultados. O protótipo abaixo é um esboço proposto, nunca uma captura.
## Mapa proposto e correspondência com o existente
| Grupo | Destinos existentes a reaproveitar | Limites e subdivisões futuras |
| --- | --- | --- |
| Início | Área inicial | Contexto, atalhos permitidos e pendências apenas onde existam dados/consulta autorizada |
| Clientes e serviços | Clientes (`clients`), Catálogo de serviços (`services`), Prestações em rascunho (`service_drafts`) | Manter nomes que distingam rascunho de operação confirmada |
| Facturação | Preparação documental (`documents`), Rascunhos de facturação (`billing_drafts`), Facturas de teste (`service_invoices`), Apresentação do rascunho (`preview_model`) | Documentos/séries pertencem ao percurso existente de facturas de teste; não criar emissão real ou entrada independente sem suporte |
| Recebimentos | Recebimentos simulados (`service_receivables`) | Afectações/reconciliação mantêm-se dentro do percurso de teste existente; sem novas páginas vazias ou ligação bancária |
| Oficinas | Oficina de teste (`workshop`) | Ordens, tarefas e apontamentos continuam no módulo existente; equipamentos só como destino futuro se houver funcionalidade autorizada, nunca botão fictício |
| Custos e orçamento | Custos directos de teste (`direct_costs`), Custos industriais de teste (`industrial_costs`), Orçamento versus realizado (`industrial_budgets`) | Lotes pertencem ao módulo industrial; orçamento/comparação partilham o ecrã actual. Não dividir páginas sem necessidade confirmada |
| Contabilidade e fiscalidade | Classificação contabilística (`catalogue_accounting`), Perfil fiscal do serviço (`service_fiscal`) | Preservar validações e bloqueios fiscais; sem lançamentos |
| Administração | Empresa (`company`), Unidades (`units`), Acessos (`access`) | Apresentação do rascunho pode ficar aqui em vez de Facturação, mas nunca duplicada; configurações adicionais só se existentes e autorizadas |
O grupo só aparece se houver pelo menos um destino permitido. Destino e acção mantêm as verificações existentes; nome/email não atribuem perfil. As designações Osmane/Samira exemplificam distribuições já concedidas, sem associação nominativa no código. Consulta não implica preparação, validação ou administração.
## Esboço da página inicial — estrutura, sem dados inventados
```text
┌────────────────────────┬─────────────────────────────────────────────┐
│ SGF TEMPO │ Empresa seleccionada · Unidade seleccionada │
│ │ Alterar contexto │
│ ● Início ├─────────────────────────────────────────────┤
│ ▸ Clientes e serviços │ Ambiente / avisos de ensaio e bloqueios │
│ ▸ Facturação ├─────────────────────────────────────────────┤
│ ▸ Recebimentos │ Início │
│ ▸ Oficinas │ Trabalho no contexto seleccionado │
│ ▸ Custos e orçamento │ │
│ ▸ Contab. e fiscalidade│ A preparar e acompanhar | A validar │
│ ▸ Administração │ Apenas acções permitidas; estados reais │
│ │ │
│ Conta actual │ Atalhos permitidos │
│ Sair │ Clientes · Rascunhos · Consultas autorizadas │
└────────────────────────┴─────────────────────────────────────────────┘
```
Em destino interno, o grupo dessa página permanece aberto, com opção activa destacada por texto e marcador além da cor. Cabeçalhos expansíveis são botões de teclado com `aria-expanded`; destino activo usa `aria-current`. Abrir um grupo não altera o contexto nem concede acesso.
Para o preparador, dar prioridade a «A preparar e acompanhar», com atalhos para as operações que já pode iniciar e consulta do estado das suas propostas. Para a validadora, dar prioridade a «A validar», com ligações a versões exactas pendentes e acesso de consulta. Quem tiver ambos os tipos de poderes vê ambas as secções, sem poder validar a própria proposta. Não criar uma decisão directamente no cartão inicial: encaminhar para o percurso de revisão existente.
**Pendências:** ainda é necessário definir quais os módulos que fornecem consulta segura e actualizada de pendências. Não inferir contagens no cliente, consultar módulos sem autorização nem tratar erro/indisponibilidade como zero. Onde não houver fonte, mostrar apenas atalhos; não apresentar listas ou números simulados. Distinguir «Sem pendências» (consulta bem-sucedida), «Consulta indisponível» e «Escolha uma unidade». Rótulos do esboço não afirmam que haja tarefas concretas.
## Ecrãs pequenos, estados e contexto
Em ecrã pequeno, menu em painel recolhível por botão «Menu», fechado por Escape, foco devolvido ao botão e destino activo identificável. Empresa/unidade e aviso relevante permanecem visíveis no cabeçalho; selectores podem abrir por «Alterar contexto». Conteúdo em coluna única, alvos de toque confortáveis e tabelas com scroll horizontal próprio, sem esconder montantes/estados ou provocar scroll de toda a página.
Estados com rótulo textual consistente: «Rascunho», «Aguarda validação», «Validado», «Recusado», «Histórico/desactualizado», «Incompleto» e «Operação bloqueada». Verde discreto para validação concluída, âmbar para pendência/incompletude, neutro para histórico e vermelho para erro; cor nunca é a única informação. Preservar cores base do SGF; melhorar espaçamento, alinhamento de montantes e leitura de tabelas. Não introduzir indicadores financeiros, saldos, receitas, margens ou gráficos fictícios.
## Próxima revisão do desenho
Comparar este mapa/esboço com uma captura manual da página inicial e menu actuais. Confirmar onde fica «Apresentação do rascunho» e a primeira selecção de fontes reais de pendências. Só depois alterar a aplicação, preservando permissões, separação empresa/unidade e avisos. Nenhuma nova implementação ou validação visual é declarada por este documento.
+13
View File
@@ -0,0 +1,13 @@
# Aceitação isolada — orçamento versus realizado
28/10/2026, Africa/Johannesburg. O utilizador aceitou expressamente a entrega do ensaio de orçamento versus realizado com a limitação das capturas documentada e autorizou checkpoint exclusivamente local, sem credenciais ou dados privados. Confirmou que a aceitação não transforma provas pendentes em realizadas e que migração `110000`, sete concessões e utilização real permanecem por autorizar.
Âmbito: `INDUSTRIAL-BUDGET-ACTUAL-SIM-v1`, secção 16 de [INDUSTRIAL_COST_ACCOUNTING_SCOPE.md](INDUSTRIAL_COST_ACCOUNTING_SCOPE.md), entrega em [INDUSTRIAL_BUDGET_DELIVERY.md](INDUSTRIAL_BUDGET_DELIVERY.md). Preservados `cbdf2b4`, `4a94e8a` e alterações posteriores. Orçamento sintético 900/600/300, realizado 1000/500/300, desvios +100/−100/0 e total 0; residual 300 separado. Variante de 800 conhecidos mantém custo total/unitário indisponíveis e comparação incompleta, sem desvio total conclusivo.
Evidência aceite com limites: 169 testes / 3 004 asserções aprovados, seis casos concorrentes e compilação aprovada; percurso manual relatado pelo utilizador, separação funcional confirmada e fotografias/referências reconciliadas em consulta read-only. Automação do Edge permaneceu bloqueada; capturas não foram recebidas ou inspeccionadas. Não se converte esta limitação em prova visual concluída. Ver [registo manual](INDUSTRIAL_BUDGET_MANUAL_PROOF.md).
Os campos de aceitação/checkpoint negativos nos ficheiros de prova anteriores descrevem o estado à data da produção dessas provas e não são reescritos. As referências documentais anteriores a aceitação pendente são históricas, substituídas apenas por esta confirmação expressa. Não se repetiram testes por este registo documental de encerramento.
O commit que contém este registo constitui o checkpoint exclusivamente local, incluindo fontes, testes, scripts, documentação e provas sintéticas revistas. Excluídos `.env*` privados, manifesto/ficheiro de entrada, palavras-passe, ficheiros privados de execução e conteúdos de contas/dados reais. Sem push ou publicação. Migração `110000` e sete concessões não aplicadas; bloqueios operacionais/fiscais preservados, sem uso real, stock ou lançamentos.
Próxima prioridade indicada pelo utilizador: retomar a página inicial e os menus agrupados. Não integra a aceitação deste ensaio nem altera os seus direitos, cálculos ou limites.
+67
View File
@@ -0,0 +1,67 @@
# Orçamento versus realizado — ensaio isolado
**Aceitação posterior de 28/10/2026:** entrega aceite com a limitação das capturas documentada e checkpoint exclusivamente local autorizado. Ver [INDUSTRIAL_BUDGET_ACCEPTANCE.md](INDUSTRIAL_BUDGET_ACCEPTANCE.md). Referências abaixo à aceitação/checkpoint pendentes são históricas. Provas pendentes não se tornam realizadas; `110000`, sete concessões e utilização real continuam por autorizar.
28/10/2026, Africa/Johannesburg. `INDUSTRIAL-BUDGET-ACTUAL-SIM-v1`, secção 16 de [INDUSTRIAL_COST_ACCOUNTING_SCOPE.md](INDUSTRIAL_COST_ACCOUNTING_SCOPE.md). Preservados `cbdf2b4`, `4a94e8a` e alterações posteriores. **Sem aceitação presumida ou checkpoint de encerramento.** Nenhuma migração ou concessão nova em desenvolvimento.
## Comportamento e limites
Orçamento submetido imutável por lote, produto, empresa/unidade, período, MZN e 10 UN. Preparador propõe; identidade distinta aprova/recusa versão exacta sem editar. Sucessora identifica a anterior e o motivo e requer nova validação. Proposta posterior ao realizado é hipótese retrospectiva explícita, sem alegar planeamento anterior. Orçamento 900 material + 600 trabalho + 300 indirectos imputados aprovado como pressuposto do ensaio pelo utilizador; a validação da versão no sistema permanece separada.
Comparação selecciona explicitamente orçamento aprovado e resultado industrial validado, ambos actuais, por ID/versão. O resultado reutilizado conserva origens, taxas, critério e respectiva fotografia: não cria outro consumo, tempo, resultado industrial ou imputação. Desvio R − P por componente: 1 000 − 900 = +100; 500 − 600 = −100; 300 − 300 = 0; total 0. Reconciliação: 1 800 + 0 = 1 800; soma dos desvios 100 − 100 + 0 = 0. Percentagens exactas 100/9 %, −50/3 % e 0 %; total 0 %. Não se somam percentagens das componentes.
Residual **300 MZN por imputar** fora do orçamento/desvio do lote. Reconciliação realizada preservada: **2 100 = 1 800 atribuídos + 300 por imputar**. Sem taxa material: 800 conhecidos, material indisponível, pares trabalho/indirectos com desvio −100/0, comparação incompleta e desvio total/percentagem global indisponíveis. Não se apresenta −900 ou outra suposta poupança pelo material desconhecido. Previsto desconhecido também impede o desvio da componente; previsto zero conhecido permite desvio monetário mas não percentagem. 0/0 permanece indisponível.
Aritmética racional exacta com `ExactCostMath`, sem float, arredondamento silencioso ou regra fiscal. Incompatibilidades de produto/lote, empresa/unidade, quantidade, unidade, moeda, período e âmbito são recusadas, sem conversões ou ajuste por volume. Só diferenças monetárias por componente; não atribui preço, eficiência, produtividade, margem ou causas.
Fotografias e decisões imutáveis; mudança de orçamento, resultado ou dependência identifica comparações antigas como históricas/desactualizadas. Não se seleccionam sucessoras automaticamente. Repetição com mesma chave/conteúdo recupera o mesmo ID; conteúdo diferente é conflito. Bloqueio de empresa serializa revisões; comando, auditoria, evento e outbox são transaccionais, sem consumidor contabilístico. Falha de outbox desfaz a operação. SQL reforça ambiente exclusivo de testes, cadeias, referências aprovadas/actuais, identidade distinta e imutabilidade; não constitui motor independente de cálculo nem RLS contra administrador de confiança.
## Percurso de prova e arranque
Menu **Orçamento versus realizado** com direitos explícitos, sem herança de `industrial_costs.*`. Preparador submete valores e fundamento; validador entra separadamente e decide orçamento por ID/versão; preparador escolhe orçamento e resultado exactos para comparar; validador consulta sem formulário de preparação. Actualização de versões é explícita. Histórico permanece visível, com aviso de desactualização.
Com base de testes vazia e sob `TestingDatabaseGuard`, preparar pelo fluxo existente, sem apagar registos para contornar recusa de fixture:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/browser-proof.ps1 start -Port 8002
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/sgf.ps1 php scripts/industrial-budget-fixture.php --env=testing
```
Porta **8002** autorizada nesta sessão por a 8001 estar ocupada por outro projecto, cujo processo não foi alterado. `browser-proof.ps1` mantém 8001 como valor por omissão e permite porta explícita livre, verificando-a antes do arranque. Instância `browser-testing`, `sgf_tempo_test`/55432, sessão/cache isolados e CSRF activo preservados. Credenciais sintéticas aleatórias apenas no manifesto local protegido, nunca em documentação, argumentos ou relatório. Parar exclusivamente a prova SGF com `scripts/browser-proof.ps1 stop` antes de testes que recriam a base.
## Migração proposta — não aplicada em desenvolvimento
`2026_10_28_110000_create_industrial_budgets.php`, SQL `database/sql/industrial-budgets.sql`. Destino futuro proposto **sgf_tempo_dev / 127.0.0.1:55432**, por caminho exclusivo e proprietário separado `sgf_dev_owner`; aplicação permanece `sgf_dev_app`. Exige autorização específica antes da aplicação; não existe instalador de desenvolvimento deste incremento.
Cria seis tabelas `ib_budgets`, `ib_decisions`, `ib_comparisons`, `ib_commands`, `ib_events`, `ib_outbox`, índices/FKs/triggers e função própria. Amplia o CHECK com cinco nomes de direitos de unidade, preservando os anteriores; não atribui direitos, não modifica origens `ic_*` e não contém dados de demonstração. `down()` recusa destruição de história. INSERT em todas as novas tabelas exige `sgf_tempo_test`/55432 via guarda SQL já existente. Guarda da aplicação continua a exigir ambiente isolado seguro, sem opção de activar operações reais.
## Sete concessões propostas — não aplicadas
Todas no **tenant #1 / Tempo Lda #1 / SEGI #1**, contas existentes; sem gestão de acessos ou âmbito adicional:
| Conta | Direitos exactos propostos |
| --- | --- |
| Osmane #1 | `industrial_budgets.view`, `industrial_budgets.prepare`, `industrial_budget_comparisons.view`, `industrial_budget_comparisons.prepare` |
| Samira #2 | `industrial_budgets.view`, `industrial_budgets.validate`, `industrial_budget_comparisons.view` |
Consulta da comparação exige também consulta do orçamento e do realizado; os direitos industriais existentes permanecem separados. `scripts/industrial-budget-permissions-preview.php` é só consulta, sem ramo de aplicação: confirmou as sete ausentes, `110000` pendente e guarda real recusada com 403. A distribuição funcional aprovada não autoriza estas concessões em desenvolvimento.
## Ficheiros e verificações
Novos: `app/Modules/Industry/IndustrialBudgets.php`, `app/Modules/Industry/Http/IndustrialBudgetsController.php`, `resources/js/IndustrialBudgetsWorkspace.jsx`, migração/SQL acima, `tests/Feature/IndustrialBudgetsTest.php`, `tests/Support/IndustrialBudgetFixture.php`, scripts `industrial-budget-fixture.php`, `industrial-budget-worker.php`, `industrial-budget-concurrency.php`, `industrial-budget-permissions-preview.php` e relatório/provas. Integrações em `routes/web.php`, `resources/js/app.jsx` e parâmetro de porta de `scripts/browser-proof.ps1`; registos em escopo, README e AGENTS. Nenhuma alteração às fontes funcionais industriais anteriores ou dependências.
Nove testes novos: igualdade, acima/abaixo, compensação, base zero, 0/0, desconhecido e falta material, dimensões incompatíveis, quantidade realizada alterada, proposta recusada, versões históricas, mudança de origem, permissões e revogação no pedido seguinte/replay, token de contexto antigo, acesso cruzado de empresa, exactidão, rollback de outbox, recuperação de resposta, imutabilidade SQL e guarda normal. Seis cenários com dois processos sobrepostos aprovados: proposta repetida, decisão repetida, comparação repetida, sucessoras incompatíveis, decisões concorrentes e comparações concorrentes. Ver [prova concorrente](proofs/industrial-budget-concurrency.json).
Compilação `scripts/sgf.ps1 npm run build` aprovada com Vite 8.3.5; sem instalação/substituição de dependências. Regressão completa `scripts/sgf.ps1 test --log-junit=storage/app/industrial-budget-regression.xml`: **169 testes / 3 004 asserções, zero falhas/erros**. XML e saída detalhada apenas locais. Ver [resumo de provas](proofs/industrial-budget-tests.json).
**Prova no navegador pendente:** instância isolada arrancada correctamente em `http://127.0.0.1:8002` e fixture industrial preparada com resultado validado de 1 800 MZN. Antes de qualquer login ou operação visual, a ferramenta de computer-use interrompeu o acesso por não conseguir determinar o URL actual do Edge no Windows com confiança suficiente para aplicar a política. Não houve tentativa de contornar a restrição, nova sessão autenticada, orçamento ou comparação demonstrados no navegador. A instância SGF foi parada; nenhum processo do outro projecto foi alterado. A entrega não está integralmente verificada até completar essa prova. O próximo percurso é submeter orçamento 900/600/300 pelo preparador, validar pela identidade distinta, comparar as referências exactas e consultar o resultado completo; depois seleccionar uma sucessora industrial validada sem taxa material e demonstrar os 800 conhecidos/incompletude, preservando a comparação anterior como histórica. Não se declara esta sequência executada.
Recorte de uma etapa, um produto/lote, 10 UN, MZN e três componentes. Sem orçamento flexível, decomposição causal, reservas/stock, previsto de residual, compras, salários reais, facturação, lançamentos, fecho, activação real ou publicação. Aceitação e checkpoint de encerramento permanecem pendentes.
## Retoma manual preparada — 28/10/2026
**Revisão técnica posterior concluída:** `industrial-budget-manual-verify.php` reconciliou ambas as fotografias com as fórmulas exactas e as referências/decisões, histórico, completude, residual e separação de direitos; sem alterar registos ou credenciais. Prova em [industrial-budget-manual-results.json](proofs/industrial-budget-manual-results.json). Resumo de testes corrigido para separar a tentativa automática histórica do percurso manual relatado. Capturas continuam indisponíveis; sem aceitação presumida ou checkpoint. Nenhuma correcção ao cálculo foi necessária nesta revisão; não se repetiu a bateria aceite de testes. `110000` e sete concessões reconfirmadas ausentes em desenvolvimento.
**Actualização posterior:** percurso manual confirmado pelo utilizador: orçamento #10 v2 aprovado por identidade distinta, comparação completa #8 v1 com realizado #23 v1, resultado incompleto #24 v2 validado e comparação #9 v2 com 800 conhecidos. Confirmada a ausência dos formulários de preparação na conta de Samira sintética. Histórico e residual separados preservados. Ver o [registo manual](INDUSTRIAL_BUDGET_MANUAL_PROOF.md) para evidência e limites: textos enviados pelo utilizador e consulta read-only aos IDs/decisão, sem capturas recebidas ou automação recuperada. Aceitação e checkpoint continuam pendentes. A descrição seguinte corresponde à preparação anterior ao percurso.
Após segunda interrupção da automação, o utilizador pediu preparação da prova manual sem nova tentativa automática. Instância 8002 retomada sobre os dados sintéticos existentes, sem reset/migrações/concessões, com diagnóstico HTTP a confirmar a ligação efectiva. Ver [guia e estado da prova manual](INDUSTRIAL_BUDGET_MANUAL_PROOF.md) e [ambiente confirmado](proofs/industrial-budget-manual-environment.json). Credenciais apenas em ficheiro local protegido; nenhum login, resultado manual ou captura é declarado como já observado. A instância fica ligada para o utilizador executar o percurso; aceitação e checkpoint continuam pendentes.
+51
View File
@@ -0,0 +1,51 @@
# Prova manual guiada — orçamento versus realizado
**Actualização de encerramento:** em 28/10/2026, o utilizador aceitou expressamente a entrega com esta limitação de evidência e autorizou checkpoint local. Ver [aceitação](INDUSTRIAL_BUDGET_ACCEPTANCE.md). Menções anteriores a aceitação/checkpoint pendentes são históricas. Capturas continuam indisponíveis e automação bloqueada; nenhuma prova pendente é dada por realizada.
## Resultado do percurso manual confirmado pelo utilizador
Em 28/10/2026, após a preparação abaixo, o utilizador executou o percurso no navegador e enviou os textos dos painéis. Confirmou no final que, na consulta como Samira sintética, não aparecem os formulários de preparação de orçamento e de comparação. Não se atribui esta observação ao agente nem se declara recuperação da automação do Edge.
- Orçamento #9 v1 preservado como histórico sem decisão, sucedido por #10 v2 com os mesmos valores 900/600/300. Não foi determinada a causa da segunda submissão.
- Orçamento #10 v2 validado, com fundamento «Conferidos 900/600/300 MZN, 10 UN, mesmo lote e período». Consulta read-only à base de testes confirmou preparador #509 e validador distinto #510.
- Comparação #8 v1 referencia orçamento #10 v2 e realizado #23 v1: previsto/realizado 1 800/1 800, desvios +100/−100/0, total 0 e residual separado 300. O utilizador observou posteriormente o aviso de comparação histórica/desactualizada, mantendo os números anteriores.
- Resultado #24 v2 observado e validado apenas para 800 conhecidos, material pendente e total/custo unitário indisponíveis; residual 300, reconciliação parcial 1 100 = 800 + 300.
- Comparação #9 v2 referencia o mesmo orçamento #10 v2 e realizado #24 v2. Material e respectivo desvio indisponíveis; trabalho −100, indirectos 0; comparação incompleta, sem desvio total conclusivo. Pares conhecidos: 900 + (−100) = 800, sem tratar ausência como poupança. Residual 300 separado.
- Consulta read-only confirmou os IDs/versões do orçamento, decisão e referências das duas comparações. Não houve alteração de contas ou dados por essa consulta.
**Limitação da evidência:** os textos foram enviados pelo utilizador; não foram recebidas nem inspeccionadas capturas de ecrã. Os nomes de PNG sugeridos abaixo continuam a ser apenas destinos previstos. Percurso manual confirmado por relato e conferência parcial read-only, não prova visual automática. Aceitação e checkpoint permanecem pendentes; nenhuma concessão/migração em desenvolvimento ou activação real decorre desta confirmação. A instância de prova permanece ligada para eventual captura manual.
### Revisão técnica posterior solicitada pelo utilizador
Executado `scripts/sgf.ps1 php scripts/industrial-budget-manual-verify.php --env=browser-testing`, sem alterar registos ou credenciais. A conferência adicional confirmou as duas fotografias contra as fórmulas exactas, referências ID/versão, aprovações por identidade distinta, cadeia resultado/comparação v1→v2, mesmo orçamento, residual 300 e reconciliações completa/parcial, ausência de duplicação de origens de oficina/custo directo e distribuição efectiva dos direitos. Ver [resultado estruturado](proofs/industrial-budget-manual-results.json). Isto completa a reconciliação técnica das fotografias descritas pelo utilizador; não constitui inspecção de capturas ou nova prova de navegador.
Corrigido o resumo de provas para identificar os campos de navegador falhado/parado como a tentativa automática histórica, acrescentando separadamente o percurso manual posterior. Não se alteraram cálculo, resultados, decisões ou acessos. Sintaxe do novo verificador conferida e execução aprovada; a comparação normaliza apenas a ordem das chaves JSON para conferir conteúdos com tipos exactos, sem mudar os dados. Não se repetiram testes destrutivos ou build por estas alterações de verificação/documentação; preservada a fixture manual. Consulta de desenvolvimento reconfirmou `110000` e sete concessões ausentes e guarda real bloqueada. Aceitação e checkpoint continuam pendentes.
## Registo histórico da preparação
28/10/2026. Preparação verificada, percurso **ainda não executado pelo utilizador**. Sem aceitação ou checkpoint. Não repetir a automação bloqueada do Edge.
## Entrada e isolamento confirmados
Endereço: `http://127.0.0.1:8002`. Resposta HTTP de `/api/industrial-budget-proof/environment` confirmou `browser-testing`, `sgf_tempo_test`, `sgf_test_runner`, PostgreSQL 55432, sessão `file`/`sgf_browser_proof` e cache `file`. Ver [prova de ambiente](proofs/industrial-budget-manual-environment.json). Endpoint read-only, sem dados de negócio/credenciais, disponível apenas em `browser-testing` e sob as guardas existentes; 404 fora desse ambiente.
Retomada a fixture existente por `scripts/browser-proof.ps1 start -Port 8002 -ResumeIndustrialBudget`. Sem reset, migração ou concessões; lote #20, realizado #23 v1 validado, nenhuma proposta/comparação no início. O preparador não tem validação de orçamento; a validadora não tem preparação de orçamento/comparação. IDs descrevem esta execução, não constantes do módulo.
Contas sintéticas: `gestor@example.test` representa Osmane; `consulta@example.test` representa Samira. Palavras-passe distintas renovadas apenas nestas contas da base de testes porque o manifesto anterior fora removido ao parar a prova. Instruções de entrada em `C:\laragon\data\sgf-tempo\secrets\industrial-budget-manual-entry.txt`, com ACL apenas do utilizador local e SYSTEM, fora do repositório. Abrir localmente; não copiar palavras-passe para chat, capturas ou relatório. Não guardar no navegador.
## Percurso a executar no navegador pelo utilizador
1. Entrar como `gestor@example.test`, seleccionar **Empresa Horizonte — Demonstração / Unidade Central — Demonstração**, abrir **Orçamento versus realizado**, lote #20. Confirmar que existe preparação e não validação do orçamento.
2. Preparar material **900**, trabalho **600**, indirectos **300**, com fundamento «Hipótese sintética retrospectiva 900/600/300, 10 UN, mesmo lote/período, sem causas presumidas». Submeter orçamento e anotar ID/versão. Não criar outra proposta por repetir o clique.
3. Sair da aplicação. Entrar como `consulta@example.test` no mesmo contexto. Confirmar ausência de preparação de orçamento/comparação e presença da decisão. Validar a versão exacta submetida, com fundamento explícito. Anotar ID/versão e guardar captura sem campos de entrada de credenciais.
4. Sair e entrar como preparador. Seleccionar explicitamente o orçamento aprovado e o **realizado #23 v1**, comparar. Confirmar previsto/realizado **1 800/1 800 MZN**, desvios **+100/−100/0**, total **0**, reconciliação **1 800 + 0 = 1 800**, residual separado **300 por imputar**, origens **2 100 = 1 800 + 300**. Guardar captura da comparação.
5. Para a variante, no menu **Custos industriais de teste**, mesmo lote #20, usar **Seleccionar versões para cálculo**: escolher explicitamente as versões validadas de material, trabalho, conjunto, máquina, produção boa, taxa de trabalho e critério; manter **taxa material ausente**. Calcular a sucessora do resultado #23 v1. Não alterar origens, taxas, produção, critério ou orçamento. Anotar novo ID/versão.
6. Sair; entrar como validadora. No menu industrial, validar apenas essa versão incompleta, com fundamento «Só 800 MZN conhecidos; material pendente, total e custo unitário indisponíveis». Confirmar **800 conhecidos**, total/unitário indisponíveis e residual 300 separado; guardar captura.
7. Sair; entrar como preparador. Em **Orçamento versus realizado**, actualizar explicitamente, seleccionar o mesmo orçamento aprovado e o novo realizado validado incompleto, criar a comparação sucessora. Confirmar material/desvio indisponíveis, trabalho −100, indirectos 0, **sem desvio total conclusivo** ou percentagem global, realizado conhecido **800** e residual **300** separado. A comparação anterior permanece histórica/desactualizada. Guardar captura.
8. Sair; entrar como validadora. Consultar as duas comparações e confirmar que não recebe formulário para criar/editar orçamento ou preparar comparação. Guardar captura dessa separação de acessos.
Capturas sugeridas em `docs/proofs/industrial-budget-manual-approval.png`, `industrial-budget-manual-full.png`, `industrial-budget-manual-partial-result.png`, `industrial-budget-manual-partial-comparison.png` e `industrial-budget-manual-reader.png`. São nomes de destino, **não ficheiros já produzidos**. Capturar apenas os painéis de negócio, sem palavras-passe, ficheiro de entrada ou outras aplicações. Anotar os IDs/versões, o que foi observado e qualquer divergência; não declarar êxito antes da conferência. Se houver erro, conservar a mensagem e não tentar corrigir montantes ou substituir a referência aprovada para o contornar.
## Estado e validação desta preparação
Sintaxe PHP do preparador e de `routes/web.php` aprovada; arranque PowerShell e diagnóstico HTTP efectivos aprovados. Não se alterou cálculo ou interface, nem se repetiu a bateria de 169 testes já aprovada. Preparação manual não comprova login, submissão, decisão ou comparação pela interface. A instância fica ligada para o percurso; não executar testes destrutivos enquanto estiver activa. Após a prova, parar apenas a instância SGF com `scripts/browser-proof.ps1 stop`. Aceitação, eventual encerramento e checkpoint permanecem posteriores à prova.
+14
View File
@@ -0,0 +1,14 @@
# Aceitação isolada — INDUSTRIAL-COST-SIM-v1
28/10/2026, Africa/Johannesburg. O utilizador confirmou expressamente: «Aceito a entrega INDUSTRIAL-COST-SIM-v1 e autorizo o checkpoint Git exclusivamente local, sem credenciais ou dados reais. A migração 100000, as quatro concessões e a utilização real permanecem por autorizar.»
Aceitação limitada à entrega sintética descrita em [INDUSTRIAL_COST_DELIVERY.md](INDUSTRIAL_COST_DELIVERY.md), exclusivamente em `sgf_tempo_test`: 1 000 MZN de material + 500 de trabalho + 300 de indirectos = 1 800 MZN, 10 UN / 180 MZN por UN, com residual separado de 300 MZN. Sem taxa material, apenas 800 MZN conhecidos, sem total ou custo unitário definitivo. O critério continua a ser hipótese sintética, sem aprovação de método contabilístico real.
A revisão desta sessão conferiu os registos de 58 testes / 1 185 asserções sem falhas, seis provas de concorrência aprovadas, build concluído e as duas capturas do navegador. Não houve nova execução de testes ou demonstração ao vivo, nem se atribui ao utilizador uma nova verificação pessoal no navegador. Os campos `user_acceptance: false` e `closing_checkpoint_created: false` nas provas anteriores são históricos e permanecem preservados.
- Migração `2026_10_27_100000_create_industrial_cost_simulation.php` e quatro concessões industriais continuam propostas, não aplicadas e por autorizar especificamente.
- Utilização real continua por autorizar e bloqueada; sem stock, previsto/realizado, margens, lançamentos ou publicação.
- Preservados os checkpoints anteriores, fontes, provas, versões, decisões, aprovações e bloqueios das restantes entregas.
- O commit que contém este registo constitui o checkpoint exclusivamente local de encerramento. Inclui apenas esta documentação e o registo local de instruções, sem credenciais ou dados reais novos; não autoriza push ou novo incremento.
Não se repetiram testes por esta alteração exclusivamente documental.
+75
View File
@@ -318,3 +318,78 @@ Exactidão, ausência diferente de zero, origem única, histórico, isolamento e
Em 27/10/2026, após a confirmação dos números e limites, o utilizador respondeu «sim». Ficam aprovadas as duas decisões da secção 15.4: números e perímetro sintéticos da secção 15.1, com residual separado e variante incompleta; Osmane prepara e Samira valida/recusa versões do critério e do resultado, apenas com identidades sintéticas distintas nas provas e sem concessões reais.
O critério de capacidade/imputação continua hipótese de ensaio, não método contabilístico real aprovado. Previsto/realizado fica para depois. Não se reabrem estas decisões; a autorização para implementar código/testes, futuras migrações em desenvolvimento, concessões ou activação real continua separada. Este registo não executa o ensaio.
## 16. Orçamento versus custo realizado — especificação do recorte aprovado
28/10/2026. O utilizador aprovou o recorte de previsto versus realizado e autorizou nesta etapa **apenas actualizar esta documentação**. Preservar a aceitação `cbdf2b4` e o checkpoint da instalação técnica `4a94e8a`, sem reabrir as entregas. As exclusões de previsto/realizado na secção 15 descrevem o primeiro incremento; esta secção especifica a evolução seguinte, sem autorizar implementação, migrações, concessões ou utilização real. Identificador proposto: `INDUSTRIAL-BUDGET-ACTUAL-SIM-v1`.
### 16.1 Âmbito e referências exactas
Reutilizar o mesmo produto, lote sintético, empresa/unidade, centro, período de início/fim, moeda MZN e **10 UN boas** do resultado completo de `INDUSTRIAL-COST-SIM-v1`. Seleccionar explicitamente o ID e a versão validada do resultado de **1 800 MZN**, com referências às versões das suas dependências; não procurar automaticamente o resultado mais recente nem fixar IDs de uma execução anterior. Uma futura prova terá de identificar esses IDs/versões concretos e comprovar a validação e actualidade. Não se afirma que a base de testes ainda contenha os registos da demonstração anterior.
Perímetro comparável: material directo **1 000 MZN**, trabalho directo **500 MZN** e indirectos **imputados ao lote de 300 MZN**. Os **300 MZN por imputar** continuam apresentados separadamente, fora do orçamento e do desvio do lote. Preservar as reconciliações do realizado: conjunto **600 = 300 imputados + 300 por imputar** e origens **2 100 = 1 800 atribuídos + 300 por imputar**. Não comparar o orçamento do lote com 2 100, nem absorver o residual para ajustar desvios.
O orçamento declara o mesmo produto/lote, quantidade boa 10, unidade UN, MZN, período exacto e âmbito das três componentes atribuídas. Cada componente contém montante exacto não negativo ou estado explícito de desconhecido, fonte e fundamento sintéticos. Não é taxa, consumo, reserva de stock ou nova origem de custo. Referenciar o resultado realizado reutiliza a fotografia existente, sem copiar consumos, tempos, imputações ou gerar nova utilização do conjunto CIF.
### 16.2 Orçamento versionado e responsabilidades
**Osmane prepara; Samira valida/recusa por identidade distinta.** Nas futuras provas usam-se equivalentes sintéticos. Preparação, submissão e decisão conservam autor, data, versão e fundamento; Samira não edita a proposta nem fontes técnicas. Auto-validação é recusada mesmo que uma identidade venha a possuir ambos os direitos.
Uma proposta submetida e a respectiva decisão são imutáveis. Correcção cria sucessora explícita com ligação à anterior, motivo e nova validação; a aprovação anterior não se transfere. O orçamento aprovado usado como referência fica fixado pelo ID/versão. Não se substitui silenciosamente para coincidir com o realizado. Revisão posterior à disponibilidade do realizado fica assinalada como tal e nunca reescreve a referência original. Este ensaio sobre um resultado já existente é uma hipótese comparativa retrospectiva, não prova de que houve planeamento anterior à produção.
Comparação referencia explicitamente orçamento aprovado e resultado validado, com versões e composição. Nova versão de qualquer dependência sinaliza a comparação anterior como histórica/desactualizada, preservando números e decisões. Recalcular exige selecção explícita das novas versões elegíveis e gera nova revisão ligada à anterior; não acumula comparações como novos custos.
### 16.3 Valores de orçamento propostos — por confirmar
Os montantes seguintes são **proposta sintética para confirmação**, não orçamento aprovado nem decisão já tomada:
| Componente | Previsto proposto (MZN) | Realizado de referência (MZN) | Desvio: realizado − previsto (MZN) | Percentagem exacta |
| --- | ---: | ---: | ---: | ---: |
| Material | 900 | 1 000 | +100 | 100/9 % |
| Trabalho | 600 | 500 | −100 | −50/3 % |
| Indirectos imputados | 300 | 300 | 0 | 0 % |
| **Total do lote** | **1 800** | **1 800** | **0** | **0 %** |
Esta proposta demonstra diferenças compensadas sem esconder componentes: **100 − 100 + 0 = 0**. Não atribui a diferença a preço, eficiência ou volume. O residual realizado de 300 MZN é mostrado fora desta tabela de desvios, com a reconciliação própria.
### 16.4 Cálculo, completude e compatibilidade
Por componente, **D = R − P**; total apenas completo se todas as componentes previstas e realizadas forem conhecidas. Reconciliação: **ΣR − ΣP = Σ(R − P)** e **ΣP + ΣD = ΣR**. No exemplo proposto: **1 800 + 0 = 1 800**. Total percentual calcula-se sobre o previsto total, nunca somando percentagens das componentes. Desvio positivo significa custo acima do previsto; negativo significa abaixo, sem concluir eficiência, poupança efectiva ou margem.
Percentagem **100 × D/P**, apenas com previsto conhecido e estritamente positivo e realizado conhecido. Conservar aritmética racional exacta, incluindo fracções não finitas em decimal, sem float ou truncagem fiscal; não escolher arredondamento silencioso. Previsto zero conhecido permite desvio monetário, mas a percentagem é indisponível por base zero, incluindo 0/0. Previsto desconhecido impede desvio monetário e percentual dessa componente: não é zero. Realizado desconhecido também os impede e nunca representa poupança. Valores negativos de orçamento ficam fora deste recorte.
Se faltar uma componente, apresentar pares conhecidos e respectivos desvios, indicar exclusões e comparação **incompleta**; soma parcial dos desvios só sobre pares completos e expressamente identificada, sem total ou percentagem global completos. Não subtrair totais parciais que cubram componentes diferentes. Na variante sem taxa material, os 800 MZN conhecidos do realizado não se comparam ao orçamento total de 1 800: só trabalho e indirectos têm pares completos, se os previstos forem conhecidos.
Antes da comparação, exigir igualdade explícita de empresa/unidade, produto, lote, quantidade boa, unidade, moeda, período e perímetro/componentes de custo. Rejeitar dados incompatíveis com motivo específico; não converter moeda/unidade ou normalizar quantidade automaticamente. Um lote de 8 ou 12 UN não se compara neste recorte ao orçamento de 10 UN, mesmo que seja possível calcular custo por unidade. Não misturar diferenças de volume com preço/eficiência; decomposição causal, orçamento flexível e análise de produtividade ficam fora do âmbito. Diferenças por componente são observações monetárias, sem causas atribuídas sem evidência.
### 16.5 Casos e critérios de aceitação para futura implementação
Os cenários abaixo são requisitos de prova, não orçamentos aprovados. Excepto indicação contrária, manter as 10 UN e restantes dimensões compatíveis, com realizado 1 000/500/300:
| Caso | Previsto de teste: material/trabalho/indirectos (MZN) | Resultado exigido |
| --- | --- | --- |
| Igualdade integral | 1 000 / 500 / 300 | Desvios 0/0/0; total 0 e 0 % |
| Diferenças compensadas | 900 / 600 / 300, proposta da secção 16.3 | +100/−100/0, total 0; componentes visíveis |
| Acima do previsto | 900 / 450 / 270 | Total previsto 1 620; desvio +180; percentagem 100/9 % |
| Abaixo do previsto | 1 100 / 550 / 330 | Total previsto 1 980; desvio −180; percentagem −100/11 % |
| Previsto zero numa componente | 0 / 500 / 300 | Material +1 000, percentagem material indisponível; total previsto 800, desvio +1 000 e 125 % |
| Previsto todo zero | 0 / 0 / 0 | Desvio total +1 800, percentagem indisponível por base zero |
| Ambos zero numa componente | Material previsto e realizado explicitamente zero em variante sintética própria | Desvio material 0; percentagem indisponível, sem alterar o resultado validado de referência |
| Previsto material desconhecido | Desconhecido / 600 / 300 | Material sem desvio; pares trabalho/CIF somam −100; comparação incompleta, sem desvio total completo |
| Realizado material em falta | 900 / 600 / 300; seleccionar versão incompleta de 800 conhecidos | Material sem desvio; trabalho −100 e CIF 0; comparação incompleta, nunca −900 de suposta poupança |
| Versões alteradas | Sucessora de orçamento ou resultado/origem/taxa/critério | Referência antiga preservada e sinalizada; selecção/revisão explícitas, sem aprovação herdada ou substituição automática |
| Dados incompatíveis | Alterar uma dimensão de cada vez: produto, lote, quantidade, unidade, moeda, período, âmbito ou empresa/unidade | Recusar comparação; nenhum ajuste automático ou acesso cruzado |
Aceitação futura exige demonstrar as fórmulas e reconciliações exactas, residual separado, ausência distinta de zero, estados incompletos e todos os casos acima. Exige ainda separação de identidades, recusa de proposta não aprovada/resultado não validado ou desactualizado, histórico imutável, referência original recuperável, ausência de duplicação de origens e resposta a repetição/concorrência sem duplicar revisões ou efeitos. Auditoria e eventual evento de comparação não constituem consumo, imputação, stock ou lançamento. Provas futuras exclusivamente sintéticas em `sgf_tempo_test`, preservando guardas reais; nenhuma aceitação de implementação é declarada nesta especificação.
### 16.6 Acessos propostos e decisões novas pendentes
Propor, apenas para uma futura implementação, direitos explícitos de unidade `industrial_budgets.view`, `industrial_budgets.prepare`, `industrial_budgets.validate` e `industrial_budget_comparisons.view`, `industrial_budget_comparisons.prepare`. Consulta de comparação exige também consulta dos dois lados; preparar comparação exige orçamento aprovado e resultado validado, sem conceder poder de os aprovar. Não herdar estes direitos de `industrial_costs.*`, contabilidade, oficina ou gestão de acessos.
Distribuição proposta: Osmane com consulta/preparação de orçamento e consulta/preparação de comparação; Samira com consulta/validação de orçamento e consulta de comparação. Nenhuma destas concessões existe por efeito desta especificação. Nomes técnicos e distribuição são proposta para decisão, não alteração dos quatro direitos industriais já instalados. Qualquer aplicação real exigirá apresentação de contas, destino e âmbito exactos e autorização específica separada; não se solicita essa aplicação nesta etapa.
**Apenas decisões novas a confirmar:** (1) os valores de orçamento propostos em 16.3; (2) os novos direitos e a distribuição propostos acima. O recorte documental, a separação Osmane/Samira e as regras solicitadas nesta secção já estão determinados pela instrução de 28/10 e não são pedidos novamente. Autorização de implementação continua separada e ainda não concedida. Sem código, migrações, concessões, stock, lançamentos, activação real ou publicação nesta etapa.
### 16.7 Aprovação e autorização posterior de implementação — 28/10/2026
O utilizador aprovou os valores 900/600/300 e a distribuição funcional da secção 16.6, autorizando implementar e demonstrar o ensaio exclusivamente em `sgf_tempo_test`, com identidades sintéticas distintas, regressões, compilação e prova no navegador isolado. Esta autorização substitui apenas as pendências de decisão e de implementação descritas acima; não aprova antecipadamente uma versão de orçamento criada no sistema, que exige o circuito de validação distinto. Migração e concessões em desenvolvimento continuam separadas e por autorizar; sem alteração de dependências sem apresentação prévia, utilização real, stock, lançamentos, facturação ou publicação. Não presumir aceitação nem criar checkpoint de encerramento antes dela. Preservar `cbdf2b4`, `4a94e8a` e alterações posteriores.
+18
View File
@@ -1,5 +1,23 @@
# INDUSTRIAL-COST-SIM-v1 — entrega técnica isolada
## Aplicação técnica especificamente autorizada — 28/10/2026
Após apresentação do destino e das quatro concessões exactas, o utilizador autorizou apenas a migração `100000` em `sgf_tempo_dev` e essas concessões, preservando dados, acessos e bloqueios, sem utilização real ou publicação. As referências posteriores a migração/concessões não aplicadas descrevem o estado histórico de 27/10 e da aceitação anterior à autorização específica.
Executado `scripts/sgf.ps1 php scripts/industrial-cost-dev-install.php --apply-confirmed-100000-and-four-grants`. Instalador confere destino `sgf_tempo_dev`, porta 55432, proprietário `sgf_dev_owner` sem poderes de superutilizador/criação de bases/papéis/bypass RLS, e migra apenas o caminho `database/migrations/2026_10_27_100000_create_industrial_cost_simulation.php`. Aplicação permanece `sgf_dev_app`.
- Apenas uma migração acrescentada; instalações anteriores `070000`/`080000`/`090000` preservadas.
- 66 tabelas anteriores conferidas por contagem e impressão digital dos registos, sem exportar conteúdos; dados e acessos anteriores preservados. Só acrescentadas a migração, quatro concessões e quatro entradas de auditoria correspondentes.
- Tenant #1 / Tempo Lda #1 / SEGI #1: conta #1, `industrial_costs.view` e `industrial_costs.prepare`; conta #2, `industrial_costs.view` e `industrial_costs.validate`. Identidades e pertenças existentes conferidas; sem direitos de gestão ou outras concessões.
- Oito tabelas industriais vazias. Listagens das duas contas continuam bloqueadas, sem lotes.
- Guarda, abertura, dados, cálculo e decisão industriais recusam com 403; também recusam as guardas de custo directo, oficinas, recebimentos e emissão. Funções SQL de ambiente industrial/directo/recebimentos/oficinas recusam a base de desenvolvimento. Fontes funcionais e guardas não alteradas.
Prova de execução mantida localmente em `storage/app/private/industrial-cost-dev-install-proof.json`, sem conteúdos dos registos ou credenciais. Validação de sintaxe PHP aprovada; verificações de preservação e bloqueios executadas pelo instalador. Não se repetiram as provas sintéticas aceites, nem se recriou a base de testes. Sem taxas, critérios, lotes, cálculos ou operações reais; nenhuma publicação. A aceitação técnica de `cbdf2b4` permanece preservada.
Na revisão para o checkpoint local, o código do instalador foi desidentificado: nomes e emails usados na conferência inicial foram retirados, conservando IDs autorizados, existência das contas, pertenças e verificações de âmbito. Sintaxe novamente validada, sem reexecutar a instalação. Ficheiros privados, credenciais e conteúdos dos registos não integram o checkpoint.
**Actualização de 28/10/2026:** entrega aceite expressamente pelo utilizador, com autorização de checkpoint Git exclusivamente local. Ver [INDUSTRIAL_COST_ACCEPTANCE.md](INDUSTRIAL_COST_ACCEPTANCE.md). As referências abaixo a aceitação/encerramento pendentes descrevem o estado original da entrega de 27/10. Migração `100000`, quatro concessões e utilização real permanecem por autorizar.
27/10/2026, Africa/Johannesburg. Implementação delimitada pelas secções 15 e 15.5 de [INDUSTRIAL_COST_ACCOUNTING_SCOPE.md](INDUSTRIAL_COST_ACCOUNTING_SCOPE.md). **Sem aceitação presumida ou checkpoint de encerramento.** Preservados `d10ba06`, `7628645`, alterações posteriores, oficinas, recebimentos, cálculo fiscal e aprovações existentes. Não se acedeu ao InvesteMoz nem se repetiu investigação fiscal.
## O que funciona
+11
View File
@@ -0,0 +1,11 @@
# Aceitação isolada — WORKSHOP-BILLING-DRAFT-SIM-v1
28/10/2026, Africa/Johannesburg. O utilizador confirmou «sim» à aceitação expressa desta entrega com a limitação de não haver capturas e à autorização de checkpoint exclusivamente local, sem credenciais ou dados privados. A migração `120000`, seis concessões e utilização real permanecem por autorizar.
Aceitação limitada a [WORKSHOP_BILLING_DELIVERY.md](WORKSHOP_BILLING_DELIVERY.md) e [âmbito aprovado](WORKSHOP_BILLING_DRAFT_SCOPE.md), exclusivamente sintético em `sgf_tempo_test`. Percurso relatado: ordem #1 → proposta #1 v1 → prestação #8 → rascunho #4, com 2 UN × 75 e 1,75 H × 200 = 500 MZN sem imposto. Origens utilizadas uma vez, revisão comercial distinta, destino ainda rascunho, sem confirmação B1. Custos internos não determinam preços; imposto e contabilidade continuam pendentes.
Preservada a evidência com limites: regressão completa de 175 testes / 3 094 asserções antes da última guarda de duplicação; depois, 24 testes / 271 asserções afectados e 14 testes / 156 asserções de A aprovados. Cinco provas concorrentes, compilação e verificação do formulário aprovadas. Percurso manual relatado pelo utilizador e reconciliação read-only das origens, decisões e linhas; separação de acessos observada manualmente. Capturas não recebidas/inspeccionadas e automação do Edge não recuperada. A aceitação não transforma estas limitações em provas realizadas.
Os campos negativos de aceitação/checkpoint nas provas anteriores são históricos e permanecem preservados. As referências anteriores a aceitação pendente são substituídas apenas por esta confirmação. Não se repetiram testes por este registo exclusivamente documental.
O commit que contém este registo é o checkpoint local autorizado, preservando `04870f0`, `090b7da` e alterações posteriores. Inclui fontes, testes, scripts, documentação e provas sintéticas revistas, sem `.env`/configurações privadas, ficheiros de entrada, palavras-passe ou dados reais. Sem push, publicação, novas concessões ou aplicação de migração. `110000` e as sete concessões do orçamento também continuam separadas e por autorizar. Guardas operacionais/fiscais mantidas; correcção/cancelamento comercial dos destinos gerados continua fora deste recorte.
+86
View File
@@ -0,0 +1,86 @@
# Oficina → rascunho — entrega técnica em verificação
## Aplicação técnica especificamente autorizada — 28/10/2026
Após apresentação da migração, destino e seis concessões exactas, o utilizador confirmou «autorizo». Executado `scripts/sgf.ps1 php scripts/workshop-billing-dev-install.php --apply-confirmed-120000-and-six-grants`. Apenas `2026_10_28_120000_create_workshop_billing_drafts.php` aplicada em `sgf_tempo_dev`/55432 por ligação temporária `sgf_dev_owner`, sem superutilizador, criação de bases/papéis ou bypass RLS. A aplicação mantém `sgf_dev_app`. Migração e concessões verificadas na mesma transacção de instalação; ligação de proprietário removida da configuração em memória no fim.
- 74 tabelas preexistentes conferidas por contagens/impressões digitais, sem exportar conteúdos; dados, acessos e migrações anteriores preservados. Apenas uma entrada no histórico de migrações, seis concessões e seis entradas de auditoria acrescentadas.
- Tenant #1 / Tempo Lda #1 / SEGI #1: conta #1 `workshop_billing.view`, `workshop_billing.prepare`, `workshop_billing.generate`; conta #2 `workshop_billing.view`, `workshop_billing.review`, `workshop.view`. Contas/pertenças e pré-requisitos existentes conferidos, sem nomes/emails ou credenciais no instalador. Nenhum direito de verificação técnica ou supervisão atribuído.
- Sete tabelas `wb_*` novas vazias; nenhum cliente, ordem, origem, preço, proposta, decisão comercial, prestação ou rascunho criado em desenvolvimento.
- Listagens das duas contas permanecem bloqueadas, sem ordens de conversão. Guarda, preparação, revisão e geração recusam com 403; também recusam as guardas de oficinas, custo directo, custo industrial, recebimentos e emissão. Guardas SQL de ambiente industrial/oficina/custo directo/recebimentos recusam desenvolvimento, incluindo a guarda usada pelas sete tabelas novas.
- `110000` permanece não aplicada e fora do caminho executado. As sete concessões do orçamento continuam separadas, sem autorização de aplicação.
- Fontes funcionais/guardas preservadas. Sintaxe do instalador aprovada; verificações de preservação e bloqueios executadas antes do commit transaccional e repetidas com o papel da aplicação após a instalação. Sem repetir testes que recriam a fixture manual aceite.
Prova local em `storage/app/private/workshop-billing-dev-install-proof.json`, sem conteúdos de registos ou credenciais; não incluída no repositório. Aceitação `3932b94` e respectivas limitações de capturas permanecem preservadas. As referências abaixo a `120000`/seis concessões não aplicadas são históricas. Esta instalação não habilita utilização real, confirmação, emissão, stock, recebimentos, lançamentos ou publicação. Nenhum novo checkpoint é declarado por esta actualização.
**Aceitação posterior de 28/10/2026:** utilizador aceitou a entrega com a limitação de capturas e autorizou checkpoint exclusivamente local. Ver [WORKSHOP_BILLING_ACCEPTANCE.md](WORKSHOP_BILLING_ACCEPTANCE.md). As referências abaixo a aceitação/checkpoint pendentes são históricas; nenhuma prova pendente passa a realizada. `120000`, seis concessões e uso real continuam por autorizar.
## Percurso manual de geração relatado e reconciliado
**Conferência manual posterior do destino e dos acessos:** o utilizador enviou o detalhe do rascunho #4, origem prestação #8 v1, moeda MZN, linhas 2 × 75 e 1,75 × 200, base aritmética 500 e pendências fiscais/contabilísticas preservadas. Na consulta como Samira sintética, enviou também o destino sem edição/confirmação e a página específica Oficina → rascunho com proposta revista #1 v1 e geração existente, sem formulário de preparação ou botão de geração. Esta observação conclui os passos manuais pendentes descritos abaixo, segundo os textos enviados pelo utilizador; não equivale a captura inspeccionada ou automação recuperada. Não houve autorização de confirmação B1 ou emissão. Aceitação e checkpoint continuam pendentes.
Em 28/10/2026, o utilizador enviou os textos da proposta #1 v1, da revisão aprovada e da geração: ordem #1 → proposta #1 v1 → prestação #8 → rascunho de facturação #4. Material #6 v1, 2 UN × 75 = 150 MZN; trabalho #4 v1, 1,75 H × 200 = 350 MZN. Referência `WORKSHOP-SALES-SYNTHETIC-v1`, soma 500 MZN sem imposto. Relato evidencia alternância entre conta revisora sem botão de geração e preparador com botão; confirmação explícita da ausência dos formulários na revisora ainda não foi solicitada novamente como facto concluído.
Executado `scripts/sgf.ps1 php scripts/workshop-billing-manual-verify.php --env=browser-testing` em consulta read-only: confirmou geração única, duas utilizações canónicas, origens verificadas, versão exacta revista por identidade distinta, linhas do destino correspondentes à proposta, prestação/rascunho em estado draft, 500 MZN, imposto pendente, contabilidade não processada e nenhuma confirmação B1 deste rascunho. Nenhum dado ou credencial alterado. Ver [resultado estruturado](proofs/workshop-billing-manual-results.json).
Limites: textos enviados pelo utilizador e reconciliação técnica, sem capturas recebidas ou automação recuperada. Consulta visual do rascunho destino e confirmação explícita dos formulários ausentes na revisora continuam separadas; não se presumem aceitação ou checkpoint. As referências abaixo a percurso manual ainda não executado descrevem a preparação histórica.
## Correcção durante a prova manual — mensagem de validação
Na tentativa manual seguinte, o utilizador indicou ausência de resposta. Consulta read-only confirmou zero propostas/revisões/gerações: nenhuma submissão foi registada. Corrigida lacuna de feedback: a validação nativa do fundamento podia impedir a execução do handler sem mensagem da aplicação. O formulário passa a usar a validação explícita já testada; erros são trazidos para a zona visível e sucesso informa ID/versão. Falha de recarga após gravação é distinguida de falha da submissão, com instrução de não resubmeter. Substituído o placeholder que podia ser confundido com fonte já preenchida. Não se afirma qual campo concreto faltava no navegador do utilizador. Compilação aprovada; sem alteração de base ou credenciais. Novo script `workshop-billing-status.php` apenas para estado sintético read-only.
O utilizador encontrou `validation.required` ao submeter. O texto enviado não permitia identificar qual campo faltou; não se presume que a proposta tenha sido criada. Acrescentada validação local das origens seleccionadas, serviço, preço, fonte e fundamento, com mensagens por ID de origem antes de enviar. Servidor passou a fornecer mensagens portuguesas com nomes de campos, mantendo as regras. Não se preenchem preços/serviços automaticamente; zero explícito continua válido. Novo auxiliar `resources/js/workshopBillingProposal.js` e verificação `scripts/workshop-billing-form-check.mjs`, aprovada para omissões, zero e valores exactos. Compilação e sintaxe PHP aprovadas. Base, propostas e credenciais não alteradas; testes destrutivos não repetidos durante a prova manual activa. Sem aceitação/checkpoint.
**Estado final das verificações técnicas:** regressão completa 175 testes / 3 094 asserções sem falhas; após acrescentar protecção contra segundo rascunho pelo percurso normal, 24 testes / 271 asserções afectados e 14 testes / 156 asserções de A aprovados. Não somar estas execuções como casos distintos. Seis casos novos de conversão, cinco provas concorrentes e compilação aprovados. Ver [resumo exacto](proofs/workshop-billing-tests.json). Menções abaixo à regressão em execução são históricas. Prova manual no navegador ainda pendente, sem aceitação/checkpoint.
28/10/2026. `WORKSHOP-BILLING-DRAFT-SIM-v1`, [âmbito e decisões](WORKSHOP_BILLING_DRAFT_SCOPE.md), autorizado pelo utilizador após confirmar preços sintéticos. Preservados `04870f0`, `090b7da`, alterações posteriores e entregas aceites. **Sem aceitação presumida ou checkpoint de encerramento.** Nada aplicado em desenvolvimento.
## Percurso implementado
Selecção integral de apontamentos actuais de tempo efectivo e materiais consumidos da empresa, com tarefa actual verificada, origem/versionamento e decisão técnica identificados. Recusa entrega/devolução, material do cliente, origem pendente/recusada/obsoleta ou fora de autorização. Só dados da empresa/unidade seleccionadas; consulta comercial não atribui verificação técnica. Quantidades derivam da origem: 105 MIN → 1,75 H; 2 UN consumidas permanecem 2, sem descontar novamente devoluções.
Preparador liga cada origem a serviço de catálogo por ID/versão, preço comercial e fonte explícitos. Preço desconhecido impede proposta/geração, zero explícito é distinto. Moeda MZN, cliente da ordem conferido, catálogo e cliente versionados. A proposta guarda composição e fundamento/exclusões e é imutável; sucessora explícita requer nova revisão. Identidade distinta aprova/recusa versão exacta. Mudança da origem/tarefa/cadastro/cliente torna proposta desactualizada, sem escolha automática de sucessora ou aprovação herdada.
Ensaio aprovado como hipótese: `WORKSHOP-SALES-SYNTHETIC-v1`, preços sem imposto de 200 MZN/H e 75 MZN/UN. Soma exacta: 350 + 150 = **500 MZN**. Não são tarifas reais nem derivação do custo interno de 275 MZN; imposto/aplicabilidade continuam pendentes, sem chamar 500 de total fiscal ou quantia exigível. Aritmética exacta; fracção que não caiba no contrato decimal 16/8 do rascunho é recusada, sem arredondamento silencioso.
Geração reutiliza `ServiceWorkflow` e cria prestação de origem e rascunho de facturação na mesma transacção; a prestação é necessária pelo contrato existente. Não cria duas utilizações técnicas/comerciais. Vínculo único da origem canónica por ordem, geração única por ordem e referências exactas à proposta, apontamentos e versões. Chave idempotente recupera o mesmo destino; conteúdo diferente é conflito. Bloqueio de empresa serializa revisões e geração; auditoria/evento/outbox atómicos, rollback sem rascunhos ou vínculos órfãos. Nenhuma confirmação B1 automática.
Rascunhos gerados não podem ser editados/apagados directamente no SQL; aplicação responde com 409 ao tentar edição pelo fluxo existente. Correcção/cancelamento comercial não integra este recorte; uma origem utilizada não é libertada por edição ou nova versão técnica. Histórico preservado, sem reescrever fotografias B1. Propostas com origens alteradas ficam sinalizadas; os rascunhos gerados conservam a composição original e exigem circuito próprio de correcção antes de reutilização comercial.
Também bloqueada a criação de outro rascunho pelo percurso A usando a prestação já convertida: recusa 409 na aplicação e trigger de INSERT no SQL. A primeira geração ocorre atomicamente antes do registo final do vínculo; depois disso, não há caminho alternativo autorizado para reaproveitar essa prestação como segundo destino. Revogação de direitos de criação de destino é verificada também antes de recuperar um replay da geração.
## Interface e prova
Novo destino **Oficinas → Oficina → rascunho**, só com `workshop_billing.view`. Atalhos na página inicial por direitos explícitos de preparação/revisão, sem contagens fictícias. Revisor consulta proposta e toma decisão, sem formulário de preparação/geração. Preparador escolhe serviços/preços, submete, depois gera a partir da versão aprovada. Interface mostra IDs de prestação/rascunho, sem validade fiscal e fiscalidade pendente.
Regressão inicial relevante: **41 testes / 660 asserções aprovados**, incluindo quatro testes iniciais de conversão e regressões de oficinas/custo directo/B1/guardas. Acrescentados casos de sucessão, catálogo alterado e revogação de criação do destino no replay; regressão completa final em execução. Compilação aprovada, Vite 8.3.5, sem alterações de dependências. Cinco cenários concorrentes com processos sobrepostos aprovados em [workshop-billing-concurrency.json](proofs/workshop-billing-concurrency.json): proposta repetida, propostas sucessoras concorrentes, revisão repetida, geração repetida e geração com novas chaves já utilizada. Uma geração, dois vínculos canónicos.
**Navegador:** a automação do Edge já estava bloqueada, sem nova tentativa ou afirmação de recuperação. Nenhuma captura ou execução manual deste novo percurso é declarada. Preparação para prova manual, quando houver instância de teste vazia sob as guardas e nenhum teste destrutivo em execução:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/browser-proof.ps1 start -Port 8002
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/sgf.ps1 php scripts/workshop-billing-fixture.php --env=testing
```
Fixture cria ordem/recursos sintéticos com verificação por técnico/verificador distintos dos papéis comerciais. Não preenche proposta/revisão/geração. Usar contas sintéticas do manifesto protegido fora do repositório; não exibir ou copiar palavras-passe para provas. Preparador selecciona o tempo e consumo, serviços exactos, preços 200/75 e referência acima; revisor entra separadamente e aprova versão exacta; preparador gera prestação/rascunho; conferir 500 MZN, estados pendentes e rastreabilidade no destino. Não correr testes que recriam a base enquanto essa prova estiver activa; parar apenas a instância SGF por `scripts/browser-proof.ps1 stop`.
Instância manual efectivamente preparada em 8002 após os testes finais, com ambiente confirmado por HTTP em [workshop-billing-environment.json](proofs/workshop-billing-environment.json). Entrada: `gestor@example.test` (preparação/geração) e `consulta@example.test` (revisão), mesmo contexto sintético. Instruções de entrada apenas em `C:\laragon\data\sgf-tempo\secrets\workshop-billing-manual-entry.txt`, fora do repositório, ACL do utilizador local/SYSTEM. Não usar as credenciais anteriores de outro ensaio. Nenhum passo manual foi declarado realizado; a instância permanece ligada para essa prova. Seleccionar o serviço «Serviço comercial exclusivamente sintético» e a sua versão apresentada. O validador comercial não recebeu direitos de verificação técnica.
## Migração e concessões apenas propostas
Migração **`2026_10_28_120000_create_workshop_billing_drafts.php`**, SQL `database/sql/workshop-billing.sql`, destino futuro **sgf_tempo_dev / 127.0.0.1:55432**, por caminho exclusivo com `sgf_dev_owner`; aplicação mantém `sgf_dev_app`. Depende da fundação/oficinas e guarda SQL de testes já existentes. Cria sete tabelas: `wb_proposals`, `wb_decisions`, `wb_generations`, `wb_claims`, `wb_commands`, `wb_events`, `wb_outbox`; índices, FKs, triggers de ambiente/imutabilidade, cadeia/revisão, vínculo único e protecção condicional dos rascunhos ligados. Amplia CHECK com quatro nomes de direitos; não atribui concessões. `down()` recusa destruição de história. Guardas da aplicação e INSERT nas sete tabelas mantêm uso restrito a `sgf_tempo_test`/55432; sem opção de activação real. SQL não é RLS nem uma segunda implementação do motor comercial completo.
Consulta `scripts/workshop-billing-permissions-preview.php` confirmou migração ausente, conversão real recusada e as seis concessões abaixo ausentes. **Não aplicadas**, exigem autorização específica separada. Todas: **tenant #1 / Tempo Lda #1 / SEGI #1**.
| Conta existente | Direitos propostos |
| --- | --- |
| Osmane #1 | `workshop_billing.view`, `workshop_billing.prepare`, `workshop_billing.generate` |
| Samira #2 | `workshop_billing.view`, `workshop_billing.review`, `workshop.view` |
`workshop.view` para Samira é consulta técnica necessária à revisão comercial; não inclui `workshop.verify`, apontamentos, supervisão ou gestão de acessos. Os direitos de consulta empresarial de clientes/serviços das duas contas e os de consulta/criação de prestações/rascunhos da conta #1 já existem e foram conferidos; não são reaplicados ou derivados de custos. `110000` e sete concessões do orçamento permanecem separadas e pendentes.
## Ficheiros e limitações
Novos: `app/Modules/Workshop/WorkshopBilling.php`, controlador em `Http/WorkshopBillingController.php`, migração/SQL, `resources/js/WorkshopBillingWorkspace.jsx`, testes/fixture `WorkshopBillingTest.php`/`WorkshopBillingFixture.php`, scripts `workshop-billing-fixture.php`, `workshop-billing-worker.php`, `workshop-billing-concurrency.php`, `workshop-billing-permissions-preview.php`, documentação/provas. Integrações no router, navegação/página inicial e protecção de edição em `ServiceWorkflow.php`.
Uma ordem/cliente/MZN, selecção integral, um destino, cobrança por tempo efectivo e material consumido da empresa. Sem tarefa a preço fixo, repartição parcial, descontos, margens, stock, emissão, cálculos fiscais novos, recebimentos, lançamentos, publicação ou utilização real. Correcção/cancelamento de rascunhos ligados bloqueados até circuito próprio. Prova visual e aceitação continuam separadas; nenhuma pendência é promovida a prova realizada.
+98
View File
@@ -0,0 +1,98 @@
# Oficina → rascunho de facturação — especificação para decisão
**Autorização técnica posterior de 28/10/2026:** o utilizador autorizou implementar e demonstrar `WORKSHOP-BILLING-DRAFT-SIM-v1` exclusivamente em `sgf_tempo_test`, sem aplicar migrações/concessões em desenvolvimento, activar uso real ou publicar. A autorização substitui apenas as restrições anteriores de etapa documental; decisões comerciais e limites permanecem. Ver [entrega e estado das provas](WORKSHOP_BILLING_DELIVERY.md). Não presume aceitação ou checkpoint.
28/10/2026. Próximo recorte proposto: `WORKSHOP-BILLING-DRAFT-SIM-v1`. Nesta etapa **apenas documentação**: sem implementação, migrações, concessões, alteração de operações reais ou publicação. Preservar `04870f0` (orçamento aceite com limitação de capturas), `090b7da` (página inicial/menu com revisão visual pendente) e anteriores. Sem reabrir as respectivas aprovações ou transformar provas pendentes em realizadas.
## 1. Objectivo e menor incremento proposto
Numa futura prova exclusivamente sintética em `sgf_tempo_test`, seleccionar numa ordem os recursos elegíveis já verificados, preparar a sua conversão comercial, rever preços e gerar **um novo rascunho de facturação rastreável** na mesma empresa/unidade. Não voltar a digitar consumos/tempos, não transformar ordem em produção industrial e não criar um segundo acontecimento técnico para conseguir facturar.
Primeiro recorte recomendado: uma ordem, um cliente explicitamente confirmado, uma unidade, moeda de venda explícita, selecção integral de cada origem elegível, sem repartição parcial entre rascunhos. Prestações e facturação permanecem rascunhos; não confirmar internamente B1 automaticamente, emitir documentos, calcular/aprovar fiscalidade por consequência, receber ou contabilizar. Equipamentos e contratos reais não são criados como preparação deste ensaio.
## 2. Origem técnica e decisão de facturabilidade
Seleccionar IDs/versões actuais da ordem, tarefa e apontamento, autor, decisão de verificação e verificador distintos, quantidades/unidades e período de execução. Não seleccionar por descrição, último registo ou nome de técnico. Consulta da ordem exige direitos técnicos próprios; converter para rascunho exige direitos comerciais separados. Verificação técnica reconhece execução elegível; **não aprova cobrança ou preço**.
| Origem | Proposta para o primeiro recorte |
| --- | --- |
| Trabalho efectivo verificado ligado à tarefa | Elegível apenas após decisão comercial explícita: ligação a serviço de catálogo e forma de cobrança aprovada |
| Material consumido verificado, propriedade da empresa | Elegível se comercialmente facturável, com descrição e unidade de venda compatíveis |
| Material do cliente | Excluído da cobrança de material por omissão; não facturar propriedade do cliente. Serviço de aplicação, se acordado, é origem comercial distinta, sem inventar consumo |
| Material requerido/entregue/devolvido | Não equivale a consumo facturável. Não somar entrega e consumo; não descontar novamente devolução de um consumo já líquido |
| Origem pendente, recusada, obsoleta ou ocorrência fora de autorização apenas reconhecida | Não elegível. Não promover reconhecimento de auditoria a verificação válida |
| Custo directo, orçamento, resultado industrial ou residual CIF | Não são preço, quantidade facturável ou nova origem técnica |
Proposta: tarefa a preço fixo **ou** tempo facturável derivado dos apontamentos seleccionados, nunca ambos para a mesma parcela. Para não misturar bases, começar por **tempo efectivo verificado × tarifa comercial** e material consumido verificado × preço comercial por unidade; preço fixo por tarefa fica como alternativa a confirmar antes da execução. Horas humanas não se confundem com HM de máquina. Não acrescentar deslocação, mínimos, descontos, margens, IVA ou despesas sem âmbito e dados próprios.
Excluir uma origem exige motivo visível, não apagamento. A revisão mostra a lista seleccionada, as exclusões e a diferença entre recurso executado e parcela comercial. Sem cobrança automática de todos os recursos só por estarem verificados.
## 3. Preços de venda e compatibilidade
Proposta: preços de venda introduzidos/seleccionados explicitamente pelo preparador a partir de uma referência comercial identificada e versionada; revisor confirma preço, unidade, moeda, data de referência e condições. Não usar taxa interna de material/trabalho, custo industrial ou preço de outra versão/cliente por omissão. Não adoptar tabela de preços, moeda ou imposto por suposição.
Manter cadeias decimais exactas do contrato A (até 16 inteiros/8 decimais), sem float ou truncagem fiscal. MIN/H conserva conversão exacta. Se quantidade comercial ou preço necessário não for exactamente representável pelo contrato do rascunho, bloquear a conversão e pedir decisão explícita; não arredondar silenciosamente. Preço zero explícito e revisto é distinto de preço desconhecido. Enquanto preço, cliente ou ligação comercial estiverem pendentes, a proposta pode ser revista, mas **não gerar um rascunho com zero fictício ou omissão silenciosa de linhas**.
Conferir empresa/unidade, cliente, serviço seleccionado, moeda, unidade física/de venda, quantidade, período e regra de cobrança. A ordem não prova por si a identidade fiscal do cliente. A ligação de cliente/serviço é explícita; criação ou correcção de cadastro permanece no circuito existente, sem concessão implícita. Compatibilidade fiscal/aplicabilidade mantém pendências próprias; gerar rascunho não resolve exigibilidade, apuramento ou emissão.
## 4. Revisão e responsabilidades propostas — por confirmar
**Proposta funcional:** Osmane selecciona recursos, prepara ligações comerciais e preços; Samira revê/valida ou recusa a versão exacta da proposta comercial por identidade distinta. Não atribui a Samira verificação técnica, gestão de acessos ou edição dos apontamentos. A geração é feita pelo preparador a partir da proposta revista, sem alterar as parcelas aprovadas; se mudar selecção, quantidade, preço, cliente, serviço ou moeda, criar sucessora e exigir nova revisão. Provas futuras com equivalentes sintéticos, sem contas ou concessões reais novas.
Estados propostos: proposta preparada/submetida → revista ou recusada → geração do rascunho. Submissão e decisões imutáveis, com sucessora e motivo explícitos. Geração não executa uma segunda aprovação fiscal nem confirmação B1. A validação comercial desta proposta é uma decisão nova e necessita confirmação do utilizador; não decorre dos papéis aprovados para custos/orçamento.
## 5. Rastreabilidade e não duplicação
Cada linha gerada conserva ordem/tarefa/apontamento por ID/versão, decisão de verificação, quantidade/unidade seleccionada, conversão comercial, serviço/cadastro exacto, preço/fonte/versão, proposta/revisão e autor. Pode apresentar descrição legível da ficha, sem perder as referências. Uma linha pode agregar origens só se a composição exacta permanecer recuperável e não misturar unidades/preços/regras incompatíveis; para o primeiro recorte, recomendar uma linha por parcela comercial.
Registar a utilização comercial da **identidade canónica da origem**, não só do ID da sua versão. Uma correcção técnica não permite voltar a facturar a mesma parcela com novo ID. A utilização comercial não é consumo de stock ou nova imputação de custos. Não duplicar a mesma parcela em prestação e factura como se fossem duas utilizações; o vínculo acompanha a origem até ao rascunho destino único.
Proposta, revisão, vínculo à origem, linhas do rascunho, auditoria e evento/outbox são atómicos. Chave de idempotência inclui contexto, autor, acção e conteúdo; repetição recupera o mesmo rascunho, conteúdo diferente é conflito. Duas selecções concorrentes da mesma origem só permitem um destino activo; falha ou perda de resposta não deixa reserva órfã nem cria duplicados.
Primeiro recorte sem facturação parcial, repartição entre clientes ou vários destinos. Correcção após geração conserva rascunho e referências originais; assinala proposta/rascunho desactualizados e bloqueia nova geração/uso da proposta antiga. **Não libertar a origem automaticamente** por editar/apagar um rascunho. Substituição/cancelamento comercial requer operação explícita, auditada e compatível com o estado do destino; se essa operação não integrar o recorte, a origem permanece bloqueada e o caso é remetido a revisão. Fotografia B1 já confirmada nunca é reescrita; geração não contorna correcções ou bloqueios de emissão.
## 6. Critérios para futura entrega
- Demonstrar uma ordem com trabalho e material verificados, ligações comerciais explícitas e rascunho com composição recuperável, sem reintroduzir quantidades técnicas.
- Demonstrar que preço comercial pode diferir do custo interno, sem conversão automática, e que preço desconhecido impede gerar, sem virar zero. Caso zero explícito exige decisão própria.
- Recusar material do cliente, apontamento não verificado/recusado/obsoleto e ocorrência apenas reconhecida; preservar motivos e histórico.
- Recusar cobrança simultânea da tarefa fixa e dos mesmos tempos, dupla selecção, versão corrigida como nova cobrança ou dois destinos concorrentes. Entregas/devoluções não viram consumo comercial por inferência.
- Refazer proposta materialmente alterada com nova versão/revisão, sem herdar aprovação; preservar origem e rascunho anteriores. Cliente/moeda/unidade/contexto incompatíveis recusados.
- Verificar separação de identidades e permissões no servidor, contexto revisto, revogação no pedido seguinte e isolamento entre empresas/unidades; menus não são prova de autorização.
- Demonstrar idempotência, concorrência, rollback de evento/outbox e recuperação de resposta, sem vínculos/reservas órfãos.
- Regressões relevantes de oficinas, rascunhos/B1, custos e guardas; compilação e demonstração isolada com evidência e limitações explícitas. Sem emissão real, stock, recebimentos, lançamentos ou aceitação presumida.
## 7. Acessos e decisões novas antes de implementar
Propor direitos próprios de unidade para consulta/preparação/revisão/geração da conversão, além dos direitos de consulta às origens e de criação do rascunho destino. Não derivar de `workshop.verify`, `direct_costs.*`, `industrial_budgets.*` ou nomes. Nomes técnicos, contas e número de concessões só serão propostos concretamente depois de fechar o fluxo; nenhuma concessão autorizada aqui. Migração futura também separada, com destino e guardas explícitos antes de aplicação.
Decisões novas para o utilizador:
1. Confirmar facturabilidade: tempo verificado e material consumido da empresa, com material do cliente excluído, **ou** escolher tarefa a preço fixo em vez do tempo para a mesma parcela.
2. Confirmar fonte/forma de aprovação dos preços comerciais e moeda do ensaio; custo interno nunca determina preço automaticamente.
3. Confirmar Osmane como preparador/gerador e Samira como revisora comercial distinta, sem supervisão técnica implícita.
4. Confirmar primeiro recorte com selecção integral por origem, um rascunho por proposta e sem repartição parcial, mantendo casos posteriores bloqueados até correcção/cancelamento próprios.
Estas propostas não são decisões já acordadas nem autorização de implementação. A primeira geração no sistema e a activação operacional continuam fora desta etapa documental.
## 8. Confirmação posterior e proposta concreta de preços do ensaio
Em 28/10/2026, o utilizador respondeu «sim prossiga» às quatro opções apresentadas: tempo verificado e material consumido da empresa, excluindo material do cliente e dupla cobrança de tarefa/tempo; preços comerciais explícitos com fonte identificada e revisão distinta, sem derivação do custo; Osmane prepara/gera e Samira revê a versão comercial; origens integrais, uma ordem e um rascunho por proposta, sem repartição parcial. Estas decisões substituem as respectivas pendências da secção 7. Não constituem concessões reais nem autorização de utilização operacional.
A fonte concreta dos preços, os valores e a moeda não tinham sido fornecidos. Para fechar esse ponto sem usar preços reais ou inferir valores a partir do custo, fica proposta para validação a referência **`WORKSHOP-SALES-SYNTHETIC-v1`**, tabela exclusivamente sintética, moeda **MZN**, preços sem imposto:
| Parcela comercial | Quantidade de referência técnica | Preço de venda sintético proposto | Montante sem imposto |
| --- | --- | --- | ---: |
| Trabalho efectivo verificado | 105 MIN = 1,75 H | 200 MZN/H | 350 MZN |
| Material da empresa consumido e verificado | 2 UN | 75 MZN/UN | 150 MZN |
| **Soma comercial do exemplo** | Mesma ordem sintética | Sem cálculo fiscal | **500 MZN** |
Valores **ainda não aprovados**. Não são tarifas do utilizador, preços de catálogo real, margens ou substitutos das taxas internas de custo. As origens técnicas do exemplo são as do percurso de oficina, reutilizadas por ID/versão, sem copiar consumos nem usar o resultado agregado de custo como origem comercial. Em futura prova, a referência e os preços exactos entram na proposta de conversão e só podem gerar rascunho depois da revisão comercial distinta. O cliente, serviços de catálogo e descrições devem ser sintéticos e explicitamente ligados, sem criar contas ou dados reais. IVA/aplicabilidade permanecem pendências separadas; 500 MZN é apenas soma de linhas sem imposto, não total fiscal ou montante exigível.
Próxima validação necessária: confirmar ou substituir a referência sintética, **MZN**, **200 MZN/H** e **75 MZN/UN**. Nenhum código, migração ou concessão implementado por esta actualização documental.
### 8.1 Aprovação dos valores pelo utilizador
Em 28/10/2026, o utilizador confirmou «sim» à proposta concreta acima. Ficam aprovados, **exclusivamente como pressupostos sintéticos do ensaio**, a referência `WORKSHOP-SALES-SYNTHETIC-v1`, moeda MZN e preços de venda sem imposto de 200 MZN/H e 75 MZN/UN: 105 MIN = 1,75 H → 350 MZN; 2 UN → 150 MZN; soma comercial 500 MZN. A indicação de valores por aprovar na secção anterior passa a histórica. Não se adopta política comercial real, preço derivado de custo ou tratamento fiscal.
Fechadas as decisões de facturabilidade, responsabilidades, selecção integral e base comercial deste recorte. Cada futura proposta continua a exigir revisão distinta da versão exacta antes da geração; a confirmação do desenho não constitui aprovação automática de registos no sistema. Preservar todos os checkpoints e bloqueios. Nesta etapa continua apenas a especificação: sem código, migrações, concessões, emissão, stock, lançamentos, publicação ou utilização real. Uma autorização técnica de implementação deverá delimitar provas sintéticas, direitos próprios e proposta separada de qualquer instalação em desenvolvimento.
@@ -0,0 +1,14 @@
{
"policy": "INDUSTRIAL-BUDGET-ACTUAL-SIM-v1",
"database": "sgf_tempo_test",
"overlapping_processes_per_case": 2,
"checks": {
"proposal_replay_one_version": true,
"decision_replay_one_effect": true,
"comparison_replay_one_snapshot": true,
"competing_successors_one_winner": true,
"competing_decisions_one_winner": true,
"competing_comparisons_one_revision": true
},
"synthetic_only": true
}
@@ -0,0 +1,10 @@
{
"environment": "browser-testing",
"database": "sgf_tempo_test",
"role": "sgf_test_runner",
"database_port": 55432,
"session_driver": "file",
"session_cookie": "sgf_browser_proof",
"cache_store": "file",
"synthetic_only": true
}
@@ -0,0 +1,46 @@
{
"policy": "INDUSTRIAL-BUDGET-ACTUAL-SIM-v1",
"date": "2026-10-28",
"database": "sgf_tempo_test",
"method": "manual_user_report_and_read_only_database_reconciliation",
"manual_user_reported_complete_and_incomplete": true,
"manual_user_confirmed_reader_forms_absent": true,
"screenshots_received": false,
"automated_browser_recovered": false,
"comparisons": [
{
"comparison_id": 8,
"version": 1,
"budget_id": 10,
"budget_version": 2,
"result_id": 23,
"result_version": 1,
"actual_known": "1800",
"total_delta": "0",
"incomplete": false,
"residual_separate": "300",
"exact_arithmetic_verified": true,
"distinct_validation_verified": true
},
{
"comparison_id": 9,
"version": 2,
"budget_id": 10,
"budget_version": 2,
"result_id": 24,
"result_version": 2,
"actual_known": "800",
"total_delta": null,
"incomplete": true,
"residual_separate": "300",
"exact_arithmetic_verified": true,
"distinct_validation_verified": true
}
],
"role_separation_verified": true,
"duplicate_workshop_or_direct_cost_origins": false,
"test_records_changed": false,
"credentials_changed": false,
"user_acceptance": false,
"closing_checkpoint_created": false
}
+16
View File
@@ -0,0 +1,16 @@
{
"policy": "INDUSTRIAL-BUDGET-ACTUAL-SIM-v1",
"date": "2026-10-28",
"database": "sgf_tempo_test",
"regression": {"scope":"full_suite","tests":169,"assertions":3004,"errors":0,"failures":0},
"new_test_cases":9,
"overlapping_process_cases":6,
"build":{"vite":"8.3.5","passed":true,"dependencies_changed":false},
"browser":{"scope":"historical_automated_attempt_only","port":8002,"server_started":true,"synthetic_fixture_prepared":true,"login_demonstrated":false,"completed":false,"blocker":"Computer Use stopped: unable to determine current Edge URL confidently for policy enforcement.","server_stopped":true},
"manual_followup":{"user_reported_path_completed":true,"reader_forms_absent_confirmed_by_user":true,"database_reconciliation_passed":true,"screenshots_received":false,"evidence":"industrial-budget-manual-results.json","automated_browser_recovered":false},
"development_migration_110000_applied":false,
"new_real_grants_applied":false,
"real_costing_guard_refused":true,
"user_acceptance":false,
"closing_checkpoint_created":false
}
@@ -0,0 +1,13 @@
{
"policy": "WORKSHOP-BILLING-DRAFT-SIM-v1",
"database": "sgf_tempo_test",
"overlapping_processes_per_case": 2,
"checks": {
"proposal_replay_one_version": true,
"competing_proposals_one_successor": true,
"review_replay_one_decision": true,
"generation_replay_one_draft": true,
"new_keys_cannot_duplicate_generation": true
},
"one_generation_two_origin_claims": true
}
@@ -0,0 +1,10 @@
{
"environment": "browser-testing",
"database": "sgf_tempo_test",
"role": "sgf_test_runner",
"database_port": 55432,
"session_driver": "file",
"session_cookie": "sgf_browser_proof",
"cache_store": "file",
"synthetic_only": true
}
@@ -0,0 +1,27 @@
{
"policy": "WORKSHOP-BILLING-DRAFT-SIM-v1",
"date": "2026-10-28",
"database": "sgf_tempo_test",
"method": "user_reported_manual_browser_and_read_only_reconciliation",
"order_id": 1,
"proposal_id": 1,
"proposal_version": 1,
"service_draft_id": 8,
"billing_draft_id": 4,
"commercial_base_exact": "500",
"currency": "MZN",
"source_claims": 2,
"distinct_commercial_review": true,
"generated_lines_match_reviewed_proposal": true,
"internal_confirmation_created": false,
"fiscal_status": "pending",
"accounting_status": "not_processed",
"manual_user_reported_destination_lines_and_500_base": true,
"manual_user_reported_reviewer_conversion_without_prepare_or_generate_controls": true,
"manual_user_reported_reviewer_destination_read_only": true,
"screenshots_received": false,
"automated_browser_recovered": false,
"records_changed": false,
"user_acceptance": false,
"closing_checkpoint_created": false
}
+17
View File
@@ -0,0 +1,17 @@
{
"policy":"WORKSHOP-BILLING-DRAFT-SIM-v1",
"date":"2026-10-28",
"database":"sgf_tempo_test",
"full_regression_before_final_duplicate_route_guard":{"tests":175,"assertions":3094,"errors":0,"failures":0},
"final_targeted_after_guard":{"tests":24,"assertions":271,"errors":0,"failures":0},
"final_services_a_after_guard":{"tests":14,"assertions":156,"errors":0,"failures":0},
"new_workshop_billing_cases":6,
"overlapping_process_cases":5,
"build":{"vite":"8.3.5","passed":true,"dependencies_changed":false},
"manual_browser":{"port":8002,"fixture_prepared":true,"environment_checked_by_http":true,"user_path_completed":false,"screenshots_received":false,"automatic_edge_retried":false},
"development_migration_120000_applied":false,
"new_real_grants_applied":false,
"real_conversion_blocked":true,
"user_acceptance":false,
"closing_checkpoint_created":false
}
+33
View File
@@ -14,3 +14,36 @@
.invoice-test-document{margin:24px 0}.invoice-test-document>p{white-space:pre-wrap;margin:8px 0;line-height:1.6}.invoice-test-document>h3{border-top:1px solid #dce6e1;padding-top:18px;margin-top:26px;color:#176b55}.invoice-test-document form{margin-top:28px;border-top:1px solid #dce6e1;padding-top:24px}.invoice-pdf-link{display:inline-block;padding:12px 18px;background:#176b55;color:#fff;border-radius:7px;text-decoration:none;font-weight:650}
.invoice-test-workspace>.fiscal-notice{position:sticky;top:0;z-index:20}
/* Grouped workspace navigation: permissions remain owned by the existing modules. */
.grouped-sidebar{width:270px;position:sticky;top:0;height:100dvh;overflow-y:auto}
.grouped-sidebar .sidebar-label{margin-top:30px}
.navigation-group{margin:0 0 5px}
.sidebar nav .navigation-heading{display:flex;justify-content:space-between;gap:12px;width:100%;color:#f5fbf7;font-size:.86rem;padding:12px 10px}
.sidebar nav .navigation-item{display:block;width:100%;padding:11px 12px 11px 24px;font-size:.83rem;line-height:1.5;border-left:3px solid transparent;border-radius:0 7px 7px 0}
.sidebar nav .navigation-item.active{border-left-color:#bfe4cf;background:#275b4b;color:white;font-weight:750}
.sidebar button:focus-visible{outline:2px solid #cbe8dc;outline-offset:2px}
.workspace>header{position:sticky;top:0;z-index:25;flex-wrap:wrap;box-shadow:0 2px 8px #123f3508}
.workspace>header>.workspace-safety{flex-basis:100%;margin:4px 0 0}
.workspace-safety{padding:12px 16px;background:#fff6df;border:1px solid #e6d4a2;color:#6e551c;border-radius:8px;margin-bottom:20px;font-size:.85rem;line-height:1.6}
.home-work-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,300px),1fr));gap:20px}
.home-work-grid .panel{margin-bottom:20px}
.home-work-grid h2,.home-context h2{margin-top:0}
.home-shortcuts{display:flex;flex-wrap:wrap;gap:10px}
.home-shortcuts button{line-height:1.5;text-align:left}
.home-notice{background:#fff6df;color:#6e551c}
.home-context dl{display:grid;grid-template-columns:1fr 1fr;gap:20px;margin:24px 0}
.home-context dt{font-size:.8rem;color:#5d716d;margin-bottom:6px}.home-context dd{margin:0;font-weight:600}
.panel:has(>table){overflow-x:auto}.panel>table{min-width:540px}td,dd{overflow-wrap:anywhere}
.mobile-menu-toggle,.navigation-drawer{display:none}
@media(max-width:800px){
.grouped-sidebar{display:none}.shell{display:block}.workspace>header{padding:20px 18px 20px 92px;min-height:94px}
.mobile-menu-toggle{display:block;position:fixed;top:23px;left:14px;z-index:30;padding:10px}
.navigation-drawer[open]{display:block;width:min(90vw,340px);height:100dvh;max-height:100dvh;max-width:100vw;margin:0;padding:0;border:0;background:#123f35;color:#f5fbf7;overflow-y:auto}
.navigation-drawer::backdrop{background:#102c26aa}.navigation-drawer .sidebar{display:flex;width:100%;min-height:calc(100dvh - 60px);padding:20px}
.navigation-drawer .sidebar nav{display:flex;flex-direction:column;overflow:visible;white-space:normal}.navigation-drawer .sidebar-label{display:block;margin-top:24px}
.navigation-drawer .sidebar-bottom{display:block;padding-top:28px}.drawer-close{margin:12px 16px 0;background:#275b4b;color:white;border-color:#568475}
.navigation-drawer .sidebar-bottom strong,.navigation-drawer .sidebar-bottom small,.navigation-drawer .brand span{display:block}
.workspace main{padding:20px 16px}.home-context dl{grid-template-columns:1fr}.workspace header .local-badge{white-space:normal;text-align:center}
.home-shortcuts{display:grid;grid-template-columns:1fr}.context-card{grid-template-columns:1fr}.workspace header strong{overflow-wrap:anywhere}.workspace header .local-badge{display:block}
}
+50
View File
@@ -0,0 +1,50 @@
/* SGF presentation aligned with the public InvesteMoz/Tempo stylesheet.
No external fonts, assets, services or application dependencies. */
:root{
--tempo-ink:#171717;--tempo-muted:#64748b;--tempo-line:#e2e8f0;
--tempo-canvas:#f8fafc;--tempo-paper:#fff;--tempo-dark:#090909;
--tempo-accent:#ed1c24;--tempo-accent-strong:#b91c1c;--tempo-accent-soft:#fef2f2;
font-family:'Instrument Sans','Segoe UI',system-ui,sans-serif;
color:var(--tempo-ink);background:var(--tempo-canvas);
}
button{color:var(--tempo-ink);border-color:var(--tempo-line);min-height:42px;border-radius:8px;transition:background-color .15s,border-color .15s}
button:hover{background:#f1f5f9;border-color:#cbd5e1}
button.primary,.invoice-pdf-link{background:var(--tempo-accent);border-color:var(--tempo-accent);color:white}
button.primary:hover,.invoice-pdf-link:hover{background:var(--tempo-accent-strong);border-color:var(--tempo-accent-strong)}
input,select,textarea{color:var(--tempo-ink);border-color:#cbd5e1;border-radius:8px}
input[readonly]{background:#f8fafc}
input:focus,select:focus,textarea:focus,button:focus-visible,a:focus-visible{outline:3px solid #ed1c2440;outline-offset:2px}
.muted,.help,footer{color:var(--tempo-muted)}
.eyebrow{color:#64748b;letter-spacing:.12em}
.workspace :is(h1,h2,h3,h4){color:var(--tempo-ink)}
.sidebar,.navigation-drawer[open]{background:var(--tempo-dark);color:white}
.sidebar{border-right:1px solid #ffffff14}
.sidebar .brand{letter-spacing:.09em;border-left:3px solid var(--tempo-accent);padding-left:12px}
.sidebar-label{color:#94a3b8}
.sidebar nav .navigation-heading{color:#e2e8f0;font-weight:600}
.sidebar nav .navigation-heading:hover{background:#ffffff0d}
.sidebar nav .navigation-item{color:#cbd5e1}
.sidebar nav .navigation-item:hover{background:#ffffff0d;color:white}
.sidebar nav .navigation-item.active{background:#ffffff10;color:white;border-left-color:var(--tempo-accent)}
.sidebar-bottom{border-top:1px solid #ffffff1a;margin-top:24px;padding-top:22px}
.sidebar-bottom small{color:#94a3b8}.sidebar-bottom button{border-color:#ffffff30;color:#e2e8f0}
.sidebar-bottom button:hover{background:#ffffff0d}.sidebar button:focus-visible{outline-color:#fb7185}
.workspace>header{background:white;border-bottom:1px solid var(--tempo-line);box-shadow:0 2px 8px #0f172a05;gap:12px}
.workspace header .muted{color:var(--tempo-muted)}
.local-badge{color:#475569;border-color:var(--tempo-line);background:#f8fafc}
.workspace-safety,.home-notice{background:#fffbeb;border-color:#fde68a;color:#854d0e}
.context-card{background:white;border-color:var(--tempo-line);border-radius:10px;margin-bottom:28px;box-shadow:0 1px 2px #0f172a03}
.context-card p{color:var(--tempo-muted)}
.panel{background:var(--tempo-paper);border-color:var(--tempo-line);border-radius:10px;box-shadow:0 1px 3px #0f172a04}
.page-title{margin:24px 0}.page-title h1{letter-spacing:-.035em}
.home-work-grid .panel{border-top:3px solid #171717}
.home-shortcuts{gap:10px}.home-shortcuts button{background:#fff;border-color:var(--tempo-line);font-weight:500}
.home-shortcuts button:hover{background:var(--tempo-accent-soft);border-color:#fecaca;color:var(--tempo-accent-strong)}
.home-context dt{color:var(--tempo-muted)}
th{background:#f8fafc;color:#475569}th,td{border-color:var(--tempo-line);line-height:1.6}td small{color:var(--tempo-muted)}
.unit-list li{border-color:var(--tempo-line)}
.drawer-close{background:#262626;color:white;border-color:#525252}
.login-layout>aside{background:var(--tempo-dark);border-top:5px solid var(--tempo-accent)}
.login-layout>aside p{color:#cbd5e1}.login-layout>aside small{color:#94a3b8}
.login-layout>aside .brand{color:white}.login-card .eyebrow{color:var(--tempo-accent-strong)}
@media(prefers-reduced-motion:reduce){button{transition:none}}
@@ -0,0 +1,16 @@
import React,{useEffect,useRef,useState} from 'react';
const labels={material:'Material',labour:'Trabalho',allocated:'Indirectos imputados'};
const value=v=>v===null?'Indisponível':v;
export default function IndustrialBudgetsWorkspace({context,can,api,busy}){
const [data,setData]=useState(null),[lotId,setLotId]=useState(''),[error,setError]=useState(''),[working,setWorking]=useState(false);const retry=useRef(null);
const allowed=r=>can(r,context.unit?.id??null);const disabled=busy||working;
const load=async()=>setData(await api('/api/industrial-budgets'));
useEffect(()=>{setData(null);setLotId('');retry.current=null;load().catch(e=>setError(e.message));},[context.token]);
const lot=data?.lots.find(l=>String(l.id)===lotId)??data?.lots[0];
async function send(action,input){setWorking(true);setError('');const path=`/api/industrial-budgets/lots/${lot.id}/${action}`,signature=JSON.stringify([path,input]);if(retry.current?.signature!==signature)retry.current={signature,key:crypto.randomUUID()};try{await api(path,'POST',input,context.token,retry.current.key);retry.current=null;await load();}catch(e){setError(e.message);}finally{setWorking(false);}}
return <section><p className="eyebrow">INDUSTRIAL-BUDGET-ACTUAL-SIM-v1</p><h2>Orçamento versus realizado</h2><div className="alert">ENSAIO — SEM UTILIZAÇÃO OPERACIONAL. Hipótese retrospectiva sintética; diferenças monetárias não demonstram causas ou eficiência.</div>{error&&<p role="alert" className="alert error">{error}</p>}{!data?<p>A carregar…</p>:data.blocked?<p>Operações reais bloqueadas.</p>:<><button disabled={disabled} onClick={()=>load().catch(e=>setError(e.message))}>Actualizar versões explicitamente</button><label>Lote<select value={lot?.id??''} onChange={e=>setLotId(e.target.value)}>{data.lots.map(l=><option value={l.id} key={l.id}>{l.reference} · #{l.id}</option>)}</select></label>{lot?<><p>{lot.product.name} · {lot.period_start} a {lot.period_end} · 10 UN · MZN · Material, trabalho e indirectos imputados</p>
{allowed('industrial_budgets.prepare')&&<form className="panel" onSubmit={e=>{e.preventDefault();const f=new FormData(e.currentTarget),last=lot.budgets.at(-1);send('proposals',{version:(last?.version??0)+1,previous_id:last?.id??null,dimensions:lot.dimensions,amounts:Object.fromEntries(Object.keys(labels).map(k=>[k,f.get(k)===''?null:f.get(k)])),evidence:f.get('evidence')});}}><h3>Preparar orçamento versionado</h3><p>{lot.budgets.length?`Sucessora explícita de #${lot.budgets.at(-1).id} v${lot.budgets.at(-1).version}. Referência histórica preservada.`:'Primeira proposta. Não é planeamento anterior comprovado.'}</p>{Object.entries(labels).map(([k,l])=><label key={k}>{l} previsto (MZN; vazio = desconhecido)<input name={k} inputMode="decimal" placeholder="Montante exacto ou vazio"/></label>)}<label>Fundamento / motivo da versão<input name="evidence" required minLength={3}/></label><button disabled={disabled}>Submeter orçamento</button></form>}
<h3>Orçamentos e decisões</h3>{lot.budgets.map(b=><article className="panel" key={b.id}><h3>Orçamento #{b.id} · v{b.version}</h3><p>{b.current?'Última versão':'HISTÓRICO — substituído explicitamente'} · {b.decision?`${b.decision.decision==='approved'?'Validado':'Recusado'} — ${b.decision.reason}`:'Aguarda validação distinta'}</p><p>{b.evidence}</p><ul>{Object.entries(labels).map(([k,l])=><li key={k}>{l}: {value(b.amounts[k])} MZN</li>)}</ul>{allowed('industrial_budgets.validate')&&b.current&&!b.decision&&<form onSubmit={e=>{e.preventDefault();const f=new FormData(e.currentTarget);send('decisions',{id:b.id,version:b.version,decision:f.get('decision'),reason:f.get('reason')});}}><label>Decisão<select name="decision"><option value="approved">Validar versão exacta</option><option value="refused">Recusar versão exacta</option></select></label><label>Fundamento<input name="reason" required minLength={3}/></label><button disabled={disabled}>Registar decisão do orçamento</button></form>}</article>)}
{allowed('industrial_budget_comparisons.prepare')&&<form className="panel" onSubmit={e=>{e.preventDefault();const f=new FormData(e.currentTarget),b=lot.budgets.find(x=>String(x.id)===f.get('budget')),r=lot.results.find(x=>String(x.id)===f.get('result')),last=lot.comparisons.at(-1);send('comparisons',{version:(last?.version??0)+1,previous_id:last?.id??null,budget_id:b.id,budget_version:b.version,result_id:r.id,result_version:r.version});}}><h3>Comparar versões explícitas</h3><label>Orçamento aprovado<select name="budget" required defaultValue=""><option value="">Seleccionar ID e versão</option>{lot.budgets.filter(b=>b.current&&b.decision?.decision==='approved').map(b=><option key={b.id} value={b.id}>#{b.id} v{b.version}</option>)}</select></label><label>Realizado validado<select name="result" required defaultValue=""><option value="">Seleccionar ID e versão</option>{lot.results.filter(r=>r.current&&r.decision?.decision==='approved').map(r=><option key={r.id} value={r.id}>#{r.id} v{r.version} · {r.snapshot.incomplete?'800 conhecidos — incompleto':`${r.snapshot.known_cost_exact} MZN`}</option>)}</select></label><button disabled={disabled}>Comparar orçamento e realizado</button></form>}
<h3>Comparações preservadas</h3>{lot.comparisons.map(c=><article key={c.id} className="panel"><h3>Comparação #{c.id} · v{c.version}</h3><p>{c.current?'Versões actuais':'DESACTUALIZADA / HISTÓRICA — não substituída silenciosamente'}</p><p>Orçamento #{c.snapshot.budget.id} v{c.snapshot.budget.version} · Realizado #{c.snapshot.result.id} v{c.snapshot.result.version}</p><table><thead><tr><th>Componente</th><th>Previsto MZN</th><th>Realizado MZN</th><th>Desvio R − P</th><th>Percentagem</th></tr></thead><tbody>{Object.entries(labels).map(([k,l])=>{const r=c.snapshot.rows[k];return <tr key={k}><td>{l}</td><td>{value(r.planned)}</td><td>{value(r.actual)}</td><td>{value(r.delta)}</td><td>{r.percent===null?`Indisponível — ${r.percent_state==='zero_base'?'base zero':'valor desconhecido'}`:`${r.percent} %`}</td></tr>;})}</tbody></table><p><strong>{c.snapshot.incomplete?'COMPARAÇÃO INCOMPLETA — sem desvio total conclusivo':`Desvio total: ${c.snapshot.total_delta} MZN · ${c.snapshot.total_percent===null?'Percentagem indisponível — base zero':c.snapshot.total_percent+' %'}`}</strong></p><p>Realizado conhecido: {c.snapshot.actual_known} MZN</p><p>Reconciliação {c.snapshot.incomplete?'dos pares conhecidos':'total'}: {c.snapshot.paired_planned} + ({c.snapshot.paired_delta}) = {c.snapshot.paired_actual} MZN</p><p><strong>Residual separado: {c.snapshot.residual_separate} MZN por imputar — fora do desvio do lote</strong></p><p>Origens realizadas: {c.snapshot.actual_reconciliation.known_origins_exact} = {c.snapshot.actual_reconciliation.assigned_exact} atribuídos + {c.snapshot.actual_reconciliation.unassigned_exact} por imputar{c.snapshot.incomplete?' (cobertura parcial)':''}.</p></article>)}</>:<p>Sem lotes autorizados.</p>}</>}</section>;
}
+14
View File
@@ -0,0 +1,14 @@
import React,{useEffect,useRef,useState} from 'react';
import {workshopBillingProposal} from './workshopBillingProposal.js';
export default function WorkshopBillingWorkspace({context,can,api,busy}){
const [data,setData]=useState(null),[orderId,setOrderId]=useState(''),[error,setError]=useState(''),[working,setWorking]=useState(false),[notice,setNotice]=useState('');const retry=useRef(null);const feedback=useRef(null);
const allowed=r=>can(`workshop_billing.${r}`,context.unit?.id??null);const load=async()=>setData(await api('/api/workshop-billing'));
useEffect(()=>{setData(null);setOrderId('');retry.current=null;load().catch(e=>setError(e.message));},[context.token]);
const order=data?.orders.find(o=>String(o.id)===orderId)??data?.orders[0],disabled=busy||working;
useEffect(()=>{if(error||notice)feedback.current?.scrollIntoView({behavior:'auto',block:'center'});},[error,notice]);
async function send(action,input){setWorking(true);setError('');setNotice('');const path=`/api/workshop-billing/orders/${order.id}/${action}`,signature=JSON.stringify([path,input]);if(retry.current?.signature!==signature)retry.current={signature,key:crypto.randomUUID()};try{const result=await api(path,'POST',input,context.token,retry.current.key);retry.current=null;setNotice(action==='proposals'?`Proposta #${result.id} · v${result.version} registada. Aguarda revisão distinta.`:action==='reviews'?'Revisão comercial registada.':'Rascunho gerado.');try{await load();}catch{setError('O registo foi guardado, mas a lista não actualizou. Use Actualizar versões explicitamente; não volte a submeter.');}}catch(e){setError(e.message);}finally{setWorking(false);}}
return <section><p className="eyebrow">WORKSHOP-BILLING-DRAFT-SIM-v1</p><h1>Oficina → rascunho de facturação</h1><div className="alert home-notice">ENSAIO — SEM UTILIZAÇÃO OPERACIONAL. Preços comerciais explícitos; custo interno não determina preço de venda. Sem emissão ou confirmação automática.</div><div ref={feedback} aria-live="polite">{notice&&<p className="alert success">{notice}</p>}{error&&<p role="alert" className="alert error">{error}</p>}</div>{!data?<p>A carregar…</p>:data.blocked?<p>Conversão real bloqueada nesta instância.</p>:<><button onClick={()=>load().catch(e=>setError(e.message))} disabled={disabled}>Actualizar versões explicitamente</button><label>Ordem<select value={order?.id??''} onChange={e=>setOrderId(e.target.value)}>{data.orders.map(o=><option key={o.id} value={o.id}>{o.reference} · #{o.id}</option>)}</select></label>{order?<><p>Cliente #{order.client_id} · MZN explícito · Seleccionar origens integrais verificadas.</p>
{allowed('prepare')&&!order.generation&&<form className="panel" noValidate onSubmit={e=>{e.preventDefault();try{const input=workshopBillingProposal(order,data.services,new FormData(e.currentTarget));send("proposals",input);}catch(error){setError(error.message);}}}><h2>Seleccionar e preparar proposta comercial</h2>{order.entries.map(r=><fieldset key={r.id}><legend>Origem #{r.id} v{r.version} · {r.kind==='time'?`${r.minutes} MIN verificados`:`${r.quantity} ${r.data.unit} consumidos — ${r.data.resource}`}</legend><label><input type="checkbox" name={`select-${r.id}`} style={{display:'inline',width:'auto'}}/>Incluir origem integral</label><label>Serviço comercial<select name={`service-${r.id}`}><option value="">Seleccionar serviço e versão</option>{data.services.map(s=><option key={s.id} value={s.id}>{s.name} · #{s.id} v{s.version}</option>)}</select></label><label>Preço comercial MZN/{r.kind==='time'?'H':r.data.unit}<input name={`price-${r.id}`} inputMode="decimal"/></label><label>Fonte comercial e versão (preenchimento obrigatório)<input name={`source-${r.id}`} placeholder="Escreva a referência da tabela"/></label></fieldset>)}<label>Fundamento da proposta / exclusões<input name="evidence" required minLength={3}/></label><button disabled={disabled}>Submeter proposta comercial</button></form>}
{order.proposals.map(p=><article className="panel" key={p.id}><h2>Proposta #{p.id} · v{p.version}</h2><p>{p.current?'Versão actual':'HISTÓRICO / DESACTUALIZADA'} · {p.decision?`${p.decision.decision==='approved'?'Revista e aprovada':'Recusada'} — ${p.decision.reason}`:'Aguarda revisão distinta'}</p><p>{p.snapshot.evidence}</p><table><thead><tr><th>Origem exacta</th><th>Serviço / versão</th><th>Quantidade comercial</th><th>Preço MZN</th><th>Fonte</th></tr></thead><tbody>{p.snapshot.lines.map(l=><tr key={l.entry_id}><td>#{l.entry_id} v{l.entry_version}</td><td>#{l.service_id} v{l.service_version}</td><td>{l.quantity} {l.unit}</td><td>{l.unit_price}</td><td>{l.price_source}</td></tr>)}</tbody></table><p>Soma sem imposto: <strong>{p.snapshot.base_exact} MZN</strong> · Fiscalidade pendente.</p>{allowed('review')&&p.current&&!p.decision&&<form onSubmit={e=>{e.preventDefault();const f=new FormData(e.currentTarget);send('reviews',{id:p.id,version:p.version,decision:f.get('decision'),reason:f.get('reason')});}}><label>Revisão comercial<select name="decision"><option value="approved">Aprovar versão exacta</option><option value="refused">Recusar versão exacta</option></select></label><label>Fundamento<input name="reason" required minLength={3}/></label><button disabled={disabled}>Registar revisão comercial</button></form>}{allowed('generate')&&p.current&&p.decision?.decision==='approved'&&!order.generation&&<button disabled={disabled} onClick={()=>send('generations',{id:p.id,version:p.version})}>Gerar prestação e rascunho rastreáveis</button>}</article>)}
{order.generation&&<section className="panel"><h2>Rascunho gerado — sem validade fiscal</h2><p>Prestação #{order.generation.service_draft_id} · Rascunho de facturação #{order.generation.billing_draft_id} · Proposta #{order.generation.proposal_id}</p><p>Origens utilizadas uma única vez. Edição directa bloqueada; correcção exige circuito próprio, fora deste recorte.</p></section>}</>:<p>Sem ordens autorizadas neste contexto.</p>}</>}</section>;
}
+27
View File
@@ -0,0 +1,27 @@
import React from 'react';
export default function WorkspaceHome({context,can,groups,navigate}) {
const unit=context.unit?.id??null;
const available=groups.flatMap(g=>g.items);
const links=(rules)=>rules.filter(([,permission,scope])=>can(permission,scope)).map(([id,,,label])=>({id,label:label??available.find(i=>i.id===id)?.label})).filter(i=>available.some(a=>a.id===i.id));
const prepare=links([
['workshop_billing','workshop_billing.prepare',unit],
['clients','clients.create',null],['services','services.create',null],['service_drafts','service_drafts.create',unit],['billing_drafts','billing_drafts.create',unit],
['documents','issuer_documents.edit',null],['documents','client_documents.edit',null],['documents','draft_documents.edit',unit],
['catalogue_accounting','catalogue_accounting.propose',null],['service_fiscal','service_fiscal.propose',null],
['workshop','workshop.open',unit],['direct_costs','direct_costs.prepare',unit],['industrial_costs','industrial_costs.prepare',unit],['industrial_budgets','industrial_budgets.prepare',unit],
]);
const validate=links([
['workshop_billing','workshop_billing.review',unit],
['catalogue_accounting','catalogue_accounting.approve',null],['service_fiscal','service_fiscal.approve',null],['service_invoices','invoice_series.approve',null],
['service_receivables','service_receivables.confirm',unit],['service_receivables','service_receivables.correction_approve',unit],['workshop','workshop.verify',unit],['direct_costs','direct_costs.validate',unit],['industrial_costs','industrial_costs.validate',unit],['industrial_budgets','industrial_budgets.validate',unit],
]);
function actions(items){return <div className="home-shortcuts">{[...new Map(items.map(i=>[i.id,i])).values()].map(i=><button key={i.id} onClick={()=>navigate(i.id)}>{i.label}<span aria-hidden="true"> →</span></button>)}</div>;}
return <><div className="page-title"><p className="eyebrow">O SEU ESPAÇO DE TRABALHO</p><h1>Início</h1><p className="muted">Escolha o percurso no contexto seleccionado. Cada acção mantém a sua autorização própria.</p></div>
{!context.unit&&<p className="alert home-notice" role="status">Seleccione uma unidade para consultar os percursos de trabalho dessa unidade.</p>}
<div className="home-work-grid">{prepare.length>0&&<section className="panel"><h2>A preparar e acompanhar</h2><p>Abra o percurso para preparar propostas e acompanhar o estado das versões.</p>{actions(prepare)}</section>}{validate.length>0&&<section className="panel"><h2>A validar</h2><p>Consulte as versões no respectivo percurso antes de tomar uma decisão. Não é permitida a auto-validação.</p>{actions(validate)}</section>}</div>
<section className="panel"><h2>Consultas e atalhos permitidos</h2>{actions(available.filter(i=>!['home','company','units','access'].includes(i.id)))}</section>
<p className="help">Esta página não agrega nem conta tarefas pendentes. Abra cada percurso para consultar os estados actuais.</p>
<section className="panel home-context"><h2>Contexto actual</h2><dl><div><dt>Empresa</dt><dd>{context.company.name}</dd></div><div><dt>Unidade</dt><dd>{context.unit?.name??'Sem unidade seleccionada'}</dd></div></dl><div className="actions"><button onClick={()=>navigate('company')}>Consultar empresa</button><button onClick={()=>navigate('units')}>Ver unidades autorizadas</button></div></section>
</>;
}
+25
View File
@@ -0,0 +1,25 @@
import React, {useRef, useState} from 'react';
export function navigationGroups(can, unit) {
const item=(id,label,permission,scope=null)=>({id,label,visible:can(permission,scope)});
return [
{id:'start',label:'Início',items:[{id:'home',label:'Página inicial',visible:true}]},
{id:'services',label:'Clientes e serviços',items:[item('clients','Clientes','clients.view'),item('services','Catálogo de serviços','services.view'),item('service_drafts','Prestações em rascunho','service_drafts.view',unit)]},
{id:'billing',label:'Facturação',items:[{id:'documents',label:'Preparação documental',visible:can('issuer_documents.view')||can('client_documents.view')||can('draft_documents.view',unit)},item('billing_drafts','Rascunhos de facturação','billing_drafts.view',unit),item('service_invoices','Documentos e séries de teste','service_invoices.view',unit),item('preview_model','Apresentação do rascunho','issuer_documents.view')]},
{id:'receivables',label:'Recebimentos',items:[item('service_receivables','Recebimentos, afectações e reconciliação de teste','service_receivables.view',unit)]},
{id:'workshop',label:'Oficinas',items:[item('workshop','Ordens, tarefas e apontamentos de teste','workshop.view',unit),item('workshop_billing','Oficina → rascunho','workshop_billing.view',unit)]},
{id:'costs',label:'Custos e orçamento',items:[item('direct_costs','Custo directo de teste','direct_costs.view',unit),item('industrial_costs','Lotes e custos industriais de teste','industrial_costs.view',unit),item('industrial_budgets','Orçamentos e comparação','industrial_budgets.view',unit)]},
{id:'accounting',label:'Contabilidade e fiscalidade',items:[item('catalogue_accounting','Classificação contabilística','catalogue_accounting.view'),item('service_fiscal','Perfis fiscais do serviço','service_fiscal.view')]},
{id:'admin',label:'Administração',items:[item('company','Empresa','company.view'),{id:'units',label:'Unidades autorizadas',visible:can('company.view')},item('access','Acessos','access.manage')]},
].map(g=>({...g,items:g.items.filter(i=>i.visible)})).filter(g=>g.items.length);
}
export default function WorkspaceNavigation({groups,page,navigate,user,busy,logout}) {
const [expanded,setExpanded]=useState({});const drawer=useRef(null);
function choose(id){navigate(id);drawer.current?.close();}
function contents(prefix){return <><a className="brand" href="/">TEMPO<span>SGF</span></a><p className="sidebar-label">ESPAÇO DE TRABALHO</p><nav aria-label="Navegação principal">{groups.map(g=>{
const active=g.items.some(i=>i.id===page),open=active||!!expanded[g.id];
return <section className="navigation-group" key={g.id}><button className="navigation-heading" aria-expanded={open} aria-controls={`${prefix}-${g.id}`} onClick={()=>setExpanded(s=>({...s,[g.id]:!open}))}><span>{g.label}</span><span aria-hidden="true">{open?'−':'+'}</span></button><div id={`${prefix}-${g.id}`} hidden={!open}>{g.items.map(i=><button key={i.id} className={`navigation-item ${page===i.id?'active':''}`} aria-current={page===i.id?'page':undefined} onClick={()=>choose(i.id)}>{i.label}</button>)}</div></section>;
})}</nav><div className="sidebar-bottom"><strong>{user.name}</strong><small>{user.email}</small><button disabled={busy} onClick={logout}>Sair da aplicação</button></div></>;}
return <><button className="mobile-menu-toggle" onClick={()=>drawer.current.showModal()} aria-haspopup="dialog">Menu</button><aside className="sidebar grouped-sidebar">{contents('desktop-nav')}</aside><dialog className="navigation-drawer" ref={drawer} aria-label="Menu de navegação"><button className="drawer-close" onClick={()=>drawer.current.close()} autoFocus>Fechar menu</button><div className="sidebar">{contents('mobile-nav')}</div></dialog></>;
}
+13 -2
View File
@@ -1,6 +1,7 @@
import React, { useEffect, useState } from 'react';
import { createRoot } from 'react-dom/client';
import '../css/app.css';
import '../css/tempo-theme.css';
import ServicesWorkspace, { serviceAreas } from './ServicesWorkspace.jsx';
import DocumentPreparationWorkspace from './DocumentPreparationWorkspace.jsx';
import { DocumentPreviewConfiguration } from './DocumentPreview.jsx';
@@ -10,7 +11,11 @@ import ServiceInvoiceWorkspace from './ServiceInvoiceWorkspace.jsx';
import ServiceReceivablesWorkspace from './ServiceReceivablesWorkspace.jsx';
import WorkshopWorkspace from './WorkshopWorkspace.jsx';
import DirectCostsWorkspace from './DirectCostsWorkspace.jsx';
import IndustrialBudgetsWorkspace from './IndustrialBudgetsWorkspace.jsx';
import IndustrialCostsWorkspace from './IndustrialCostsWorkspace.jsx';
import WorkspaceNavigation, {navigationGroups} from './WorkspaceNavigation.jsx';
import WorkspaceHome from './WorkspaceHome.jsx';
import WorkshopBillingWorkspace from './WorkshopBillingWorkspace.jsx';
const labels = { 'catalogue_accounting.view':'Consultar classificação contabilística', 'catalogue_accounting.propose':'Preparar classificação contabilística', 'catalogue_accounting.approve':'Validar ou recusar classificação contabilística', 'company.view': 'Consultar empresa', 'company.edit': 'Editar nome da empresa', 'unit.create': 'Criar unidades', 'access.manage': 'Gerir acessos', 'unit.view': 'Consultar unidade', 'unit.edit': 'Editar nome da unidade' };
@@ -24,6 +29,10 @@ function App() {
const context = state?.context;
const can = (permission, unit = null) => !!context?.grants.some(g => g.permission === permission && g.unit_id === unit);
const groups = navigationGroups(can, context?.unit?.id ?? null);
const navigate = id => { setPage(id); setError(''); };
useEffect(() => { if (!groups.some(g => g.items.some(i => i.id === page))) setPage('home'); }, [context?.token, JSON.stringify(context?.grants), page]);
async function api(path, method = 'GET', body, token = context?.token, commandKey = null) {
const response = await fetch(path, { method, credentials: 'same-origin', headers: { Accept: 'application/json', 'Content-Type': 'application/json', 'X-CSRF-TOKEN': state?.csrf || '', 'X-SGF-Context': token || '', ...(commandKey ? { 'Idempotency-Key': commandKey } : {}) }, ...(body === undefined ? {} : { body: JSON.stringify(body) }) });
const result = await response.json().catch(() => ({}));
@@ -55,11 +64,12 @@ function App() {
if (!state) return <main className="loading"><h1>SGF TEMPO</h1><p role="status">{error || 'A carregar…'}</p></main>;
if (state.setup_pending) return <main className="setup-pending"><p className="eyebrow">SGF TEMPO · PREPARAÇÃO LOCAL</p><h1>Falta concluir a primeira conta</h1><p>A aplicação está pronta, mas ainda não existe um utilizador. O login ficará disponível depois de definires a palavra-passe no procedimento local já autorizado.</p><section className="panel"><h2>Concluir no terminal do VS Code</h2><p>Executa este comando, confere o âmbito apresentado e define a palavra-passe nos dois pedidos de entrada oculta:</p><pre>powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\laragon\data\sgf-tempo\run\complete-first-admin.ps1</pre><p className="help">Não envies a palavra-passe pelo chat. Nenhuma conta é criada por este ecrã.</p><button className="primary" disabled={busy} onClick={() => perform(async () => {}, '')}>Já concluí — actualizar estado</button>{error && <p role="alert">{error}</p>}</section></main>;
if (!state.user) return <div className="login-layout"><aside><span className="brand">TEMPO<span>SGF</span></span><h1>O seu trabalho,<br />no contexto certo.</h1><p>Uma entrada para as empresas e unidades a que tem acesso.</p><small>Ambiente local · Primeiro percurso funcional</small></aside><main className="login-card"><p className="eyebrow">BEM-VINDO AO SGF TEMPO</p><h2>Entrar na aplicação</h2><p className="muted">Use a conta preparada pelo procedimento local autorizado.</p>{error && <div className="alert error" role="alert">{error}</div>}<Login busy={busy} onSubmit={(email, password) => perform(() => api('/api/login', 'POST', { email, password }), 'Sessão iniciada. Seleccione o contexto de trabalho.')} /><p className="help">Precisa de recuperar o acesso? Solicite recuperação local assistida. Não existe recuperação por email nesta etapa.</p></main></div>;
return <div className="shell"><aside className="sidebar"><a className="brand" href="/">TEMPO<span>SGF</span></a><p className="sidebar-label">ESPAÇO DE TRABALHO</p><nav>{[['home', 'Área inicial'], ['company', 'Empresa'], ['units', 'Unidades'], ...(can('access.manage') ? [['access', 'Acessos']] : []), ...((can('issuer_documents.view') || can('client_documents.view') || can('draft_documents.view', context?.unit?.id ?? null)) ? [['documents', 'Preparação documental'], ...(can('issuer_documents.view') ? [['preview_model', 'Apresentação do rascunho']] : [])] : []), ...(can('industrial_costs.view',context?.unit?.id ?? null) ? [['industrial_costs', 'Custos industriais de teste']] : []), ...(can('direct_costs.view',context?.unit?.id ?? null) ? [['direct_costs', 'Custos directos de teste']] : []), ...(can('workshop.view',context?.unit?.id ?? null) ? [['workshop', 'Oficina de teste']] : []), ...(can('service_receivables.view',context?.unit?.id ?? null) ? [['service_receivables', 'Recebimentos simulados']] : []), ...(can('service_invoices.view',context?.unit?.id ?? null) ? [['service_invoices', 'Facturas de teste']] : []), ...(can('service_fiscal.view') ? [['service_fiscal', 'Perfil fiscal do servi\u00e7o']] : []), ...(can('catalogue_accounting.view') ? [['catalogue_accounting', 'Classificação contabilística']] : []), ...Object.entries(serviceAreas).filter(([area]) => can(`${area}.view`, area.endsWith('_drafts') ? context?.unit?.id ?? null : null))].map(([id, text]) => <button key={id} className={page === id ? 'active' : ''} onClick={() => { setPage(id); setError(''); }}>{text}</button>)}</nav><div className="sidebar-bottom"><strong>{state.user.name}</strong><small>{state.user.email}</small><button disabled={busy} onClick={() => perform(() => api('/api/logout', 'POST'), 'Sessão terminada.')}>Sair da aplicação</button></div></aside><div className="workspace"><header><div><span className="eyebrow">CONTEXTO DE TRABALHO</span><strong>{context?.company.name || 'Seleccione uma empresa'}</strong><span className="muted">{context?.unit?.name || 'Sem unidade seleccionada'}</span></div><span className="local-badge">Ambiente local</span></header><main>
return <div className="shell"><WorkspaceNavigation key={context?.token ?? "no-context"} groups={groups} page={page} navigate={navigate} user={state.user} busy={busy} logout={() => perform(() => api("/api/logout", "POST"), "Sessão terminada.")} /><div className="workspace"><header><div><span className="eyebrow">CONTEXTO DE TRABALHO</span><strong>{context?.company.name || 'Seleccione uma empresa'}</strong><span className="muted">{context?.unit?.name || 'Sem unidade seleccionada'}</span></div><span className="local-badge">Ambiente local</span><div className="workspace-safety" role="status">Ensaios e rascunhos nos percursos identificados · Operações reais de custeio, oficinas, recebimentos e emissão bloqueadas.</div></header><main>
{error && <div className="alert error" role="alert">{error}</div>}{notice && <div className="alert success" role="status">{notice}</div>}
<section className="context-card"><label>Empresa<select aria-label="Empresa activa" disabled={busy} value={context?.company.id || ''} onChange={e => select(e.target.value)}><option value="">Escolher empresa autorizada</option>{state.companies.map(c => <option value={c.id} key={c.id}>{c.name}</option>)}</select></label><label>Unidade<select aria-label="Unidade activa" disabled={busy || !context} value={context?.unit?.id || ''} onChange={e => select(context.company.id, e.target.value ? Number(e.target.value) : null)}><option value="">Sem unidade seleccionada</option>{context?.units.map(u => <option value={u.id} key={u.id}>{u.name}</option>)}</select></label><p>Apenas os contextos com acesso explícito são apresentados.</p></section>
{!state.companies.length ? <section className="panel"><h1>Sem empresas autorizadas</h1><p>A conta existe, mas ainda não tem acesso a uma empresa. Peça ao responsável uma concessão explícita.</p></section> : !context ? <section className="panel"><h1>Escolha onde vai trabalhar</h1><p>Seleccione uma empresa. A pertença a um cliente contratante não dá acesso automático às suas empresas ou unidades.</p></section> : <div key={context.token}>
{page === 'home' && <><div className="page-title"><p className="eyebrow">ÁREA INICIAL</p><h1>Bem-vindo, {state.user.name.split(' ')[0]}.</h1><p className="muted">O contexto permanece visível e cada operação é validada pelo servidor.</p></div><div className="summary-grid"><section className="panel"><span className="eyebrow">EMPRESA ACTIVA</span><h2>{context.company.name}</h2><p>Cliente contratante #{context.company.tenant_id} · Empresa #{context.company.id}</p><button onClick={() => setPage('company')}>Consultar empresa</button></section><section className="panel"><span className="eyebrow">UNIDADE ACTIVA</span><h2>{context.unit?.name || 'Ainda não seleccionada'}</h2><p>{context.units.length} unidade(s) com consulta autorizada</p><button onClick={() => setPage('units')}>Ver unidades</button></section></div></>}
{page === 'home' && <WorkspaceHome context={context} can={can} groups={groups} navigate={navigate} />}
{page === 'workshop_billing' && <WorkshopBillingWorkspace context={context} can={can} api={api} busy={busy} />}
{page === 'company' && <section className="panel"><p className="eyebrow">DADOS BÁSICOS</p><h1>Empresa</h1><NameForm key={context.company.id} label="Nome da empresa" initial={context.company.name} editable={can('company.edit')} busy={busy} onSave={name => perform(() => api(`/api/companies/${context.company.id}`, 'PATCH', { name }, context.token), 'Nome da empresa actualizado.')} />{!can('company.edit') && <p className="help">O seu acesso permite consulta. A edição exige uma concessão própria.</p>}</section>}
{page === 'units' && <><section className="panel"><p className="eyebrow">DADOS BÁSICOS</p><h1>Unidades autorizadas</h1>{!context.units.length && <p>Não tem consulta concedida a nenhuma unidade desta empresa.</p>}<ul className="unit-list">{context.units.map(u => <li key={u.id}><strong>{u.name}</strong><button disabled={busy || context.unit?.id === u.id} onClick={() => select(context.company.id, u.id)}>{context.unit?.id === u.id ? 'Seleccionada' : 'Seleccionar'}</button></li>)}</ul>{context.unit && <NameForm label="Nome da unidade" initial={context.unit.name} editable={can('unit.edit', context.unit.id)} busy={busy} onSave={name => perform(() => api(`/api/units/${context.unit.id}`, 'PATCH', { name }, context.token), 'Nome da unidade actualizado.')} />}</section>{can('unit.create') && <section className="panel"><h2>Criar unidade</h2><p className="help">A unidade será criada nesta empresa. Receberá consulta e edição explícitas apenas para a nova unidade.</p><NameForm label="Nome da nova unidade" initial="" editable busy={busy} button="Criar unidade" onSave={name => perform(() => api('/api/units', 'POST', { name }, context.token), 'Unidade criada com os seus acessos explícitos.')} /></section>}</>}
{serviceAreas[page] && <ServicesWorkspace key={page} area={page} context={context} can={can} api={api} perform={perform} busy={busy} initialId={aSelection?.area === page ? aSelection.id : null} navigate={(area,id) => { setASelection({area,id}); setPage(area); }} />}
@@ -67,6 +77,7 @@ function App() {
{page === 'documents' && <DocumentPreparationWorkspace context={context} can={can} api={api} perform={perform} busy={busy} />}
{page === 'workshop' && <WorkshopWorkspace context={context} can={can} api={api} busy={busy} />}
{page === 'direct_costs' && <DirectCostsWorkspace context={context} can={can} api={api} busy={busy} />}
{page === 'industrial_budgets' && <IndustrialBudgetsWorkspace context={context} can={can} api={api} busy={busy} />}
{page === 'industrial_costs' && <IndustrialCostsWorkspace context={context} can={can} api={api} busy={busy} />}
{page === 'service_receivables' && <ServiceReceivablesWorkspace context={context} can={can} api={api} busy={busy} />}
{page === 'service_invoices' && <ServiceInvoiceWorkspace context={context} can={can} api={api} perform={perform} busy={busy} />}
+18
View File
@@ -0,0 +1,18 @@
// Validate only the user's selected origins; do not supply prices or services by default.
export function workshopBillingProposal(order, services, form) {
const selected=order.entries.filter(r=>form.get(`select-${r.id}`)==='on');
if(!selected.length)throw new Error('Marque «Incluir origem integral» em pelo menos uma origem verificada.');
const lines=selected.map(r=>{
const service=services.find(s=>String(s.id)===form.get(`service-${r.id}`));
if(!service)throw new Error(`Origem #${r.id}: seleccione o serviço comercial na lista.`);
const price=String(form.get(`price-${r.id}`)??'').trim();
if(!price)throw new Error(`Origem #${r.id}: preencha o preço comercial.`);
const source=String(form.get(`source-${r.id}`)??'').trim();
if(source.length<3)throw new Error(`Origem #${r.id}: preencha a fonte comercial e versão (mínimo 3 caracteres).`);
return {entry_id:r.id,entry_version:r.version,service_id:service.id,service_version:service.version,price,price_source:source};
});
const evidence=String(form.get('evidence')??'').trim();
if(evidence.length<3)throw new Error('Preencha o fundamento da proposta (mínimo 3 caracteres).');
const last=order.proposals.at(-1);
return {version:(last?.version??0)+1,previous_id:last?.id??null,client_id:order.client_id,currency:'MZN',lines,evidence};
}
+16
View File
@@ -10,13 +10,29 @@ Route::get('/', function () {
});
Route::get('/api/session', [IdentityController::class, 'session']);
// Read-only diagnostic for the explicitly isolated manual proof; no business data or secrets.
Route::get('/api/industrial-budget-proof/environment', function () {
abort_unless(app()->environment('browser-testing'),404);
\App\Modules\Industry\IndustrialBudgets::guard();
$db=\Illuminate\Support\Facades\DB::selectOne('SELECT current_database() AS database,current_user AS role,inet_server_port() AS port');
abort_unless($db->database==='sgf_tempo_test'&&$db->role==='sgf_test_runner'&&(int)$db->port===55432,403);
return response()->json(['environment'=>app()->environment(),'database'=>$db->database,'role'=>$db->role,'database_port'=>(int)$db->port,'session_driver'=>config('session.driver'),'session_cookie'=>config('session.cookie'),'cache_store'=>config('cache.default'),'synthetic_only'=>true])->header('Cache-Control','no-store, private');
});
Route::post('/api/login', [IdentityController::class, 'login']);
Route::middleware(['auth', RequireValidSession::class])->group(function (): void {
Route::post('/api/logout', [IdentityController::class, 'logout']);
Route::post('/api/context', [IdentityController::class, 'select']);
Route::middleware(RequireCompanyContext::class)->group(function (): void {
Route::get('/api/workshop-billing', [\App\Modules\Workshop\Http\WorkshopBillingController::class,'index']);
Route::post('/api/workshop-billing/orders/{id}/proposals', [\App\Modules\Workshop\Http\WorkshopBillingController::class,'prepare'])->whereNumber('id');
Route::post('/api/workshop-billing/orders/{id}/reviews', [\App\Modules\Workshop\Http\WorkshopBillingController::class,'review'])->whereNumber('id');
Route::post('/api/workshop-billing/orders/{id}/generations', [\App\Modules\Workshop\Http\WorkshopBillingController::class,'generate'])->whereNumber('id');
Route::get('/api/workshop', [\App\Modules\Workshop\Http\WorkshopController::class,'index']);
Route::get('/api/direct-costs', [\App\Modules\Workshop\Http\DirectCostsController::class,'index']);
Route::get('/api/industrial-budgets', [\App\Modules\Industry\Http\IndustrialBudgetsController::class,'index']);
Route::post('/api/industrial-budgets/lots/{id}/proposals', [\App\Modules\Industry\Http\IndustrialBudgetsController::class,'propose'])->whereNumber('id');
Route::post('/api/industrial-budgets/lots/{id}/decisions', [\App\Modules\Industry\Http\IndustrialBudgetsController::class,'decide'])->whereNumber('id');
Route::post('/api/industrial-budgets/lots/{id}/comparisons', [\App\Modules\Industry\Http\IndustrialBudgetsController::class,'compare'])->whereNumber('id');
Route::get('/api/industrial-costs', [\App\Modules\Industry\Http\IndustrialCostsController::class,'index']);
Route::post('/api/industrial-costs/lots', [\App\Modules\Industry\Http\IndustrialCostsController::class,'open']);
Route::post('/api/industrial-costs/lots/{id}/inputs', [\App\Modules\Industry\Http\IndustrialCostsController::class,'input'])->whereNumber('id');
+12 -8
View File
@@ -1,4 +1,4 @@
param([ValidateSet('start','stop')][string]$Action = 'start')
param([ValidateSet('start','stop')][string]$Action = 'start', [ValidateRange(1024,65535)][int]$Port = 8001, [switch]$ResumeIndustrialBudget)
$ErrorActionPreference = 'Stop'
$sgfProject = [IO.Path]::GetFullPath((Join-Path $PSScriptRoot '..'))
if ($sgfProject -ne 'C:\laragon\www\sgf-tempo') { throw 'Unexpected project path.' }
@@ -21,13 +21,17 @@ if ($Action -eq 'stop') {
Write-Output 'Browser proof server stopped. Synthetic data remains only in sgf_tempo_test until the next test run.'
exit 0
}
if (Get-NetTCPConnection -LocalPort 8001 -State Listen -ErrorAction SilentlyContinue) { throw 'Port 8001 occupied; no process was stopped.' }
if (Get-NetTCPConnection -LocalPort $Port -State Listen -ErrorAction SilentlyContinue) { throw "Port $Port occupied; no process was stopped." }
if (Test-Path -LiteralPath $recordFile) { throw 'Browser proof record exists; stop that proof first.' }
& $sgfPhp scripts/prepare-browser-fixture.php --env=testing
if ($ResumeIndustrialBudget) {
& $sgfPhp scripts/industrial-budget-manual-prepare.php --env=testing
} else {
& $sgfPhp scripts/prepare-browser-fixture.php --env=testing
}
if ($LASTEXITCODE) { throw 'Could not prepare synthetic fixtures.' }
$utf8 = New-Object Text.UTF8Encoding $false
$lines = Get-Content -LiteralPath '.env.testing' | Where-Object { $_ -notmatch '^(APP_ENV|APP_URL|SESSION_DRIVER|SESSION_COOKIE|SESSION_FILES|CACHE_STORE|CACHE_FILE_PATH|CACHE_LOCK_PATH)=' }
$lines += @('APP_ENV=browser-testing','APP_URL=http://127.0.0.1:8001','SESSION_DRIVER=file','SESSION_COOKIE=sgf_browser_proof',
$lines += @('APP_ENV=browser-testing',"APP_URL=http://127.0.0.1:$Port",'SESSION_DRIVER=file','SESSION_COOKIE=sgf_browser_proof',
'SESSION_FILES=C:/laragon/www/sgf-tempo/storage/framework/browser-proof/sessions', 'CACHE_STORE=file',
'CACHE_FILE_PATH=C:/laragon/www/sgf-tempo/storage/framework/browser-proof/cache', 'CACHE_LOCK_PATH=C:/laragon/www/sgf-tempo/storage/framework/browser-proof/locks')
[IO.File]::WriteAllLines((Join-Path $sgfProject '.env.browser-testing'), $lines, $utf8)
@@ -36,8 +40,8 @@ $account = [Security.Principal.WindowsIdentity]::GetCurrent().Name
New-Item -ItemType Directory -Path 'storage\framework\browser-proof\sessions','storage\framework\browser-proof\cache','storage\framework\browser-proof\locks' -Force | Out-Null
$env:APP_ENV = 'browser-testing'
try {
if (Get-NetTCPConnection -LocalPort 8001 -State Listen -ErrorAction SilentlyContinue) { throw 'Port 8001 became occupied; no process stopped.' }
$process = Start-Process -FilePath $sgfPhp -ArgumentList @('-S','127.0.0.1:8001','-t','public','scripts/router.php') -WorkingDirectory $sgfProject -WindowStyle Hidden -PassThru -RedirectStandardOutput "$sgfRun\browser-proof.stdout.log" -RedirectStandardError "$sgfRun\browser-proof.stderr.log"
@{pid=$process.Id;started=$process.StartTime.ToUniversalTime().ToString('o')} | ConvertTo-Json | Set-Content -LiteralPath $recordFile -Encoding UTF8
if (Get-NetTCPConnection -LocalPort $Port -State Listen -ErrorAction SilentlyContinue) { throw "Port $Port became occupied; no process stopped." }
$process = Start-Process -FilePath $sgfPhp -ArgumentList @('-S',"127.0.0.1:$Port",'-t','public','scripts/router.php') -WorkingDirectory $sgfProject -WindowStyle Hidden -PassThru -RedirectStandardOutput "$sgfRun\browser-proof.stdout.log" -RedirectStandardError "$sgfRun\browser-proof.stderr.log"
@{pid=$process.Id;started=$process.StartTime.ToUniversalTime().ToString('o');port=$Port} | ConvertTo-Json | Set-Content -LiteralPath $recordFile -Encoding UTF8
} finally { Remove-Item Env:APP_ENV -ErrorAction SilentlyContinue }
Write-Output 'Browser proof: http://127.0.0.1:8001 — synthetic data only, isolated session/cache, CSRF enabled.'
Write-Output "Browser proof: http://127.0.0.1:$Port - synthetic data only, isolated session/cache, CSRF enabled."
+28
View File
@@ -0,0 +1,28 @@
// Render-only checks: no browser, database, credentials or additional dependencies.
import assert from 'node:assert/strict';
import React from 'react';
import {renderToStaticMarkup} from 'react-dom/server';
import {createServer} from 'vite';
const server=await createServer({server:{middlewareMode:true},appType:'custom'});
try {
const {navigationGroups}=await server.ssrLoadModule('/resources/js/WorkspaceNavigation.jsx');
const {default:Home}=await server.ssrLoadModule('/resources/js/WorkspaceHome.jsx');
const context={company:{name:'Empresa sintética'},unit:{id:7,name:'Unidade sintética'}};
const check=(grants)=>{
const can=(permission,unit=null)=>grants.some(g=>g[0]===permission&&g[1]===unit);
const groups=navigationGroups(can,7);
return {groups,html:renderToStaticMarkup(React.createElement(Home,{context,can,groups,navigate:()=>{}}))};
};
const preparer=check([['company.view',null],['industrial_budgets.view',7],['industrial_budgets.prepare',7]]);
assert(preparer.html.includes('A preparar e acompanhar'));assert(!preparer.html.includes('<h2>A validar</h2>'));
assert(!preparer.groups.some(g=>g.id==='billing'));assert(!preparer.groups.flatMap(g=>g.items).some(i=>i.id==='access'));
const reviewer=check([['company.view',null],['industrial_budgets.view',7],['industrial_budgets.validate',7]]);
assert(reviewer.html.includes('<h2>A validar</h2>'));assert(!reviewer.html.includes('<h2>A preparar e acompanhar</h2>'));
const otherUnit=check([['company.view',null],['industrial_budgets.view',99],['industrial_budgets.prepare',99]]);
assert(!otherUnit.groups.some(g=>g.id==='costs'));
const noAccess=check([]);assert.deepEqual(noAccess.groups.map(g=>g.id),['start']);
const reader=check([['company.view',null],['industrial_budgets.view',7]]);
assert(!reader.html.includes('<h2>A validar</h2>'));assert(!reader.html.includes('<h2>A preparar e acompanhar</h2>'));
assert(reader.html.includes('não agrega nem conta tarefas pendentes'));
console.log('Home/navigation render checks passed: preparer, reviewer, reader, other unit and absent permissions. No database or browser used.');
} finally {await server.close();}
+26
View File
@@ -0,0 +1,26 @@
<?php
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
use App\Modules\Industry\IndustrialBudgets;
use App\Shared\Context\CompanyContext;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;
use Symfony\Component\Process\Process;
IndustrialBudgets::guard();$f=json_decode(file_get_contents('C:/laragon/data/sgf-tempo/secrets/browser-fixture.json'),true,32,JSON_THROW_ON_ERROR);$fx=$f['budget_fixture'];$proof=[];$key=fn()=>(string)Str::uuid();
$base=['tenant'=>$f['tenant'],'company'=>$f['company'],'unit'=>$f['unit'],'lot'=>$fx['lot']];
$pair=function($one,$two)use($base){
$a=new Process([PHP_BINARY,'scripts/industrial-budget-worker.php','--env=testing'],base_path(),null,json_encode($one+$base+['pause'=>true]));$b=new Process([PHP_BINARY,'scripts/industrial-budget-worker.php','--env=testing'],base_path(),null,json_encode($two+$base));
$a->start();if(!$a->waitUntil(fn($t,$v)=>str_contains($v,'LOCK_HELD')))throw new RuntimeException('Budget concurrent lock not observed.');$b->start();$a->wait();$b->wait();$out=[];
foreach([$a,$b] as $p){if(!$p->isSuccessful())throw new RuntimeException('Budget worker failed.');$lines=array_values(array_filter(explode("\n",trim($p->getOutput())),fn($v)=>str_starts_with($v,'{')));$out[]=json_decode(end($lines),true,32,JSON_THROW_ON_ERROR);}return $out;
};
$check=function($out,bool $replay){if($out[0]['status']!==200||$out[1]['status']!==($replay?200:409)||($replay&&(!$out[1]['result']['replayed']||$out[0]['result']['id']!==$out[1]['result']['id'])))throw new RuntimeException('Unexpected concurrent budget outcome.');return $out[0]['result']['id'];};
$last=DB::table('ib_budgets')->where('lot_id',$fx['lot'])->orderByDesc('version')->first();
$p=['actor'=>$f['manager_id'],'method'=>'propose','key'=>$key(),'input'=>['version'=>($last?->version??0)+1,'previous_id'=>$last?->id,'dimensions'=>app(IndustrialBudgets::class)->dimensions(DB::table('ic_lots')->find($fx['lot'])),'amounts'=>['material'=>'900','labour'=>'600','allocated'=>'300'],'evidence'=>'Successeur synthétique explicitement révisé.']];
$id=$check($pair($p,$p),true);$proof['proposal_replay_one_version']=true;
$d=['actor'=>$f['reader_id'],'method'=>'decide','key'=>$key(),'input'=>['id'=>$id,'version'=>$p['input']['version'],'decision'=>'approved','reason'=>'Revue synthétique distincte.']];$check($pair($d,$d),true);$proof['decision_replay_one_effect']=true;
$result=DB::table('ic_results')->where('lot_id',$fx['lot'])->orderByDesc('version')->first();$lastC=DB::table('ib_comparisons')->where('lot_id',$fx['lot'])->orderByDesc('version')->first();
$c=['actor'=>$f['manager_id'],'method'=>'compare','key'=>$key(),'input'=>['version'=>($lastC?->version??0)+1,'previous_id'=>$lastC?->id,'budget_id'=>$id,'budget_version'=>$p['input']['version'],'result_id'=>$result->id,'result_version'=>$result->version]];
$cid=$check($pair($c,$c),true);$proof['comparison_replay_one_snapshot']=true;
$p['key']=$key();$p['input']['version']++;$p['input']['previous_id']=$id;$other=$p;$other['key']=$key();$other['input']['amounts']['material']='950';$new=$check($pair($p,$other),false);$proof['competing_successors_one_winner']=true;
$d['key']=$key();$d['input']['id']=$new;$d['input']['version']=$p['input']['version'];$other=$d;$other['key']=$key();$other['input']['decision']='refused';$check($pair($d,$other),false);$proof['competing_decisions_one_winner']=true;
$c['key']=$key();$c['input']['version']++;$c['input']['previous_id']=$cid;$c['input']['budget_id']=$new;$c['input']['budget_version']=$p['input']['version'];$other=$c;$other['key']=$key();$check($pair($c,$other),false);$proof['competing_comparisons_one_revision']=true;
file_put_contents(base_path('docs/proofs/industrial-budget-concurrency.json'),json_encode(['policy'=>IndustrialBudgets::POLICY,'database'=>'sgf_tempo_test','overlapping_processes_per_case'=>2,'checks'=>$proof,'synthetic_only'=>true],JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR));echo "Six overlapping budget concurrency cases passed.\n";
+7
View File
@@ -0,0 +1,7 @@
<?php
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
\App\Modules\Industry\IndustrialBudgets::guard();$file='C:/laragon/data/sgf-tempo/secrets/browser-fixture.json';$base=json_decode(file_get_contents($file),true,32,JSON_THROW_ON_ERROR);
if(\Illuminate\Support\Facades\DB::table('ic_lots')->exists())throw new RuntimeException('Fresh synthetic proof required; nothing deleted.');
$f=\Tests\Support\IndustrialBudgetFixture::create($base+['manager'=>\App\Models\User::findOrFail($base['manager_id']),'reader'=>\App\Models\User::findOrFail($base['reader_id'])]);
file_put_contents($file,json_encode($base+['budget_fixture'=>array_intersect_key($f,array_flip(['lot','refs','result']))],JSON_THROW_ON_ERROR));
echo "Synthetic industrial result validated at 1800; budget and comparisons remain for browser.\n";
@@ -0,0 +1,14 @@
<?php
// Read-only credential correspondence check; never prints or changes credentials.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
\App\Modules\Industry\IndustrialBudgets::guard();
$identity=\Illuminate\Support\Facades\DB::selectOne('SELECT current_database() AS db,current_user AS role,inet_server_port() AS port');
if($identity->db!=='sgf_tempo_test'||$identity->role!=='sgf_test_runner'||(int)$identity->port!==55432)throw new RuntimeException('Unexpected database; no accounts changed.');
$path='C:/laragon/data/sgf-tempo/secrets/industrial-budget-manual-entry.txt';
if(!is_file($path))throw new RuntimeException('Entry file missing; no credentials reset.');
$content=file_get_contents($path);
if(!str_contains($content,'http://127.0.0.1:8002')||!preg_match_all('/(?:Osmane|Samira) synthetic: ([^\r\n]+)\r?\nPassword: ([^\r\n]+)/',$content,$matches,PREG_SET_ORDER)||count($matches)!==2)throw new RuntimeException('Unexpected entry file structure; no accounts changed.');
$checks=[];
foreach($matches as $match){$email=$match[1];if(!in_array($email,['gestor@example.test','consulta@example.test'],true))throw new RuntimeException('Non-synthetic account refused.');$user=\App\Models\User::where('email',$email)->first();$checks[]=['account'=>$email,'matches_current_test_account'=>$user&&\Illuminate\Support\Facades\Hash::check($match[2],$user->password)];}
unset($content,$matches,$match);
echo json_encode(['path'=>realpath($path),'database'=>$identity->db,'role'=>$identity->role,'accounts'=>$checks,'read_only'=>true,'credentials_changed'=>false],JSON_THROW_ON_ERROR).PHP_EOL;
@@ -0,0 +1,30 @@
<?php
// Resume only the existing synthetic fixture. Never resets the database or creates grants.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
use App\Modules\Industry\IndustrialBudgets;
use App\Modules\Identity\Services\Permissions;
use App\Models\User;
use Illuminate\Support\Facades\DB;
IndustrialBudgets::guard();
$identity=DB::selectOne('SELECT current_database() AS db,current_user AS role,inet_server_port() AS port');
if($identity->db!=='sgf_tempo_test'||$identity->role!=='sgf_test_runner'||(int)$identity->port!==55432)throw new RuntimeException('Unsafe manual proof destination.');
$m=User::where('email','gestor@example.test')->firstOrFail();$r=User::where('email','consulta@example.test')->firstOrFail();
if(DB::table('ic_lots')->count()!==1)throw new RuntimeException('Exactly one existing synthetic lot required; nothing deleted.');
$lot=DB::table('ic_lots')->first();$result=DB::table('ic_results')->where(['lot_id'=>$lot->id,'version'=>1])->first();
if(!$result||!str_starts_with($lot->reference,'LOT-TEST-'))throw new RuntimeException('Expected synthetic result missing.');
$s=json_decode($result->snapshot,true,64,JSON_THROW_ON_ERROR);
foreach(['material_exact'=>'1000','labour_exact'=>'500','allocated_exact'=>'300','residual_exact'=>'300','selected_total_exact'=>'1800','good_units'=>'10','currency'=>'MZN'] as $k=>$v)if($s[$k]!==$v)throw new RuntimeException('Full fixture differs.');
if(!DB::table('ic_decisions')->where(['result_id'=>$result->id,'decision'=>'approved','actor_id'=>$r->id])->exists())throw new RuntimeException('Distinct result approval required.');
$p=app(Permissions::class);
foreach([$m->id=>['industrial_budgets.view','industrial_budgets.prepare','industrial_budget_comparisons.view','industrial_budget_comparisons.prepare'],$r->id=>['industrial_budgets.view','industrial_budgets.validate','industrial_budget_comparisons.view']] as $u=>$rights)foreach($rights as $right)$p->require($u,$lot->tenant_id,$lot->company_id,$right,$lot->unit_id);
if($p->has($m->id,$lot->tenant_id,$lot->company_id,'industrial_budgets.validate',$lot->unit_id)||$p->has($r->id,$lot->tenant_id,$lot->company_id,'industrial_budgets.prepare',$lot->unit_id)||$p->has($r->id,$lot->tenant_id,$lot->company_id,'industrial_budget_comparisons.prepare',$lot->unit_id))throw new RuntimeException('Role separation differs.');
$file='C:/laragon/data/sgf-tempo/secrets/browser-fixture.json';$entry='C:/laragon/data/sgf-tempo/secrets/industrial-budget-manual-entry.txt';
if(!file_exists($file)){
$mp=bin2hex(random_bytes(20));$rp=bin2hex(random_bytes(20));
DB::transaction(function()use($m,$r,$mp,$rp){$m->password=$mp;$m->save();$r->password=$rp;$r->save();});
$f=['tenant'=>$lot->tenant_id,'company'=>$lot->company_id,'unit'=>$lot->unit_id,'manager_id'=>$m->id,'reader_id'=>$r->id,'budget_fixture'=>['lot'=>$lot->id,'result'=>$result->id,'refs'=>$s['refs']]];
file_put_contents($file,json_encode($f,JSON_THROW_ON_ERROR));
file_put_contents($entry,"SGF synthetic manual proof only - http://127.0.0.1:8002\r\nOsmane synthetic: gestor@example.test\r\nPassword: ".$mp."\r\nSamira synthetic: consulta@example.test\r\nPassword: ".$rp."\r\nNever paste these passwords into chat or reports.\r\n");unset($mp,$rp);
}
if(!file_exists($entry))throw new RuntimeException('Protected entry instructions missing; review locally.');
echo json_encode(['database'=>$identity->db,'role'=>$identity->role,'port'=>(int)$identity->port,'synthetic_roles_separate'=>true,'lot_id'=>$lot->id,'result_id'=>$result->id,'result_version'=>1,'existing_budgets'=>DB::table('ib_budgets')->count(),'existing_comparisons'=>DB::table('ib_comparisons')->count(),'credentials'=>'protected_local_file_only','database_reset'=>false,'grants_created'=>false],JSON_THROW_ON_ERROR).PHP_EOL;
@@ -0,0 +1,11 @@
<?php
// Read-only status for guiding the isolated manual proof. No credentials or account changes.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
\App\Modules\Industry\IndustrialBudgets::guard();
use Illuminate\Support\Facades\DB;
$rows=[];
foreach(DB::table('ib_budgets')->orderBy('id')->get() as $b){
$d=DB::table('ib_decisions')->where('budget_id',$b->id)->first();
$rows[]=['id'=>$b->id,'lot_id'=>$b->lot_id,'version'=>$b->version,'previous_id'=>$b->previous_id,'current'=>!DB::table('ib_budgets')->where('previous_id',$b->id)->exists(),'amounts'=>json_decode($b->amounts,true),'decision'=>$d?->decision,'preparer_id'=>$b->actor_id,'validator_id'=>$d?->actor_id];
}
echo json_encode(['database'=>DB::selectOne('SELECT current_database() AS db')->db,'budgets'=>$rows,'comparisons'=>DB::table('ib_comparisons')->get(['id','lot_id','version','budget_id','result_id'])->all(),'read_only'=>true],JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR).PHP_EOL;
@@ -0,0 +1,49 @@
<?php
// Reconcile the preserved manual demonstration without changing test data or credentials.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
use App\Modules\Industry\IndustrialBudgets;
use App\Modules\Identity\Services\Permissions;
use Illuminate\Support\Facades\DB;
function checkManualBudget(bool $ok,string $reason): void {if(!$ok)throw new RuntimeException($reason);}
function canonicalManualBudget(mixed $v): mixed {if(!is_array($v))return $v;if(!array_is_list($v))ksort($v);return array_map('canonicalManualBudget',$v);}
IndustrialBudgets::guard();
$identity=DB::selectOne('SELECT current_database() AS db,current_user AS role,inet_server_port() AS port');
checkManualBudget($identity->db==='sgf_tempo_test'&&$identity->role==='sgf_test_runner'&&(int)$identity->port===55432,'Unexpected database or role.');
$fixture=json_decode(file_get_contents('C:/laragon/data/sgf-tempo/secrets/browser-fixture.json'),true,32,JSON_THROW_ON_ERROR);
$lot=$fixture['budget_fixture']['lot'];$manager=$fixture['manager_id'];$reader=$fixture['reader_id'];
$comparisons=DB::table('ib_comparisons')->where('lot_id',$lot)->orderBy('version')->get();
checkManualBudget($comparisons->count()===2,'Expected exactly two manual comparisons.');
$proof=[];
foreach($comparisons as $index=>$c){
$snapshot=json_decode($c->snapshot,true,64,JSON_THROW_ON_ERROR);$budget=DB::table('ib_budgets')->find($c->budget_id);$result=DB::table('ic_results')->find($c->result_id);
checkManualBudget($budget&&$result&&$budget->lot_id===$lot&&$result->lot_id===$lot,'Cross-lot reference.');
checkManualBudget($budget->actor_id===$manager&&$c->actor_id===$manager,'Unexpected preparer.');
foreach([['ib_decisions','budget_id',$budget],['ic_decisions','result_id',$result]] as [$table,$column,$target]){
$decision=DB::table($table)->where([$column=>$target->id,'version'=>$target->version,'decision'=>'approved'])->first();
checkManualBudget($decision&&$decision->actor_id===$reader&&$decision->actor_id!==$target->actor_id,'Distinct exact validation missing.');
}
$actual=json_decode($result->snapshot,true,64,JSON_THROW_ON_ERROR);$amounts=json_decode($budget->amounts,true);
checkManualBudget($amounts==['material'=>'900','labour'=>'600','allocated'=>'300'],'Budget amounts differ.');
$expected=IndustrialBudgets::variance($amounts,['material'=>$actual['material_exact'],'labour'=>$actual['labour_exact'],'allocated'=>$actual['allocated_exact']]);
foreach($expected as $field=>$value)checkManualBudget(canonicalManualBudget($snapshot[$field])===canonicalManualBudget($value),'Comparison arithmetic differs: '.$field);
checkManualBudget($snapshot['budget']===['id'=>$budget->id,'version'=>$budget->version]&&$snapshot['result']['id']===$result->id&&$snapshot['result']['version']===$result->version&&$snapshot['result']['refs']===$actual['refs'],'Exact version references differ.');
checkManualBudget($snapshot['residual_separate']==='300'&&$actual['residual_exact']==='300'&&$snapshot['actual_reconciliation']===$actual['reconciliation'],'Residual or reconciliation differs.');
checkManualBudget($actual['good_units']==='10'&&$actual['currency']==='MZN','Quantity or currency differs.');
checkManualBudget($actual['labour_exact']==='500'&&$actual['allocated_exact']==='300','Known components differ.');
if($index===0){
checkManualBudget($actual['material_exact']==='1000'&&$actual['known_cost_exact']==='1800'&&$actual['selected_total_exact']==='1800'&&$actual['unit_cost_exact']==='180'&&!$expected['incomplete']&&$expected['total_delta']==='0','Full scenario differs.');
checkManualBudget($snapshot['actual_reconciliation']['known_origins_exact']==='2100','Full origins differ.');
}else{
checkManualBudget($actual['material_exact']===null&&$actual['known_cost_exact']==='800'&&$actual['selected_total_exact']===null&&$actual['unit_cost_exact']===null&&$expected['incomplete']&&$expected['total_delta']===null&&$expected['total_percent']===null,'Incomplete scenario differs.');
checkManualBudget($expected['rows']['material']['delta']===null&&$expected['paired_delta']==='-100'&&$snapshot['actual_reconciliation']['known_origins_exact']==='1100','Missing material treated incorrectly.');
checkManualBudget($result->previous_id===$comparisons[0]->result_id&&$c->previous_id===$comparisons[0]->id&&$c->budget_id===$comparisons[0]->budget_id,'History chain differs.');
}
$proof[]=['comparison_id'=>$c->id,'version'=>$c->version,'budget_id'=>$budget->id,'budget_version'=>$budget->version,'result_id'=>$result->id,'result_version'=>$result->version,'actual_known'=>$actual['known_cost_exact'],'total_delta'=>$expected['total_delta'],'incomplete'=>$expected['incomplete'],'residual_separate'=>'300','exact_arithmetic_verified'=>true,'distinct_validation_verified'=>true];
}
$permissions=app(Permissions::class);
foreach([$manager=>['industrial_budgets.view','industrial_budgets.prepare','industrial_budget_comparisons.view','industrial_budget_comparisons.prepare'],$reader=>['industrial_budgets.view','industrial_budgets.validate','industrial_budget_comparisons.view']] as $actor=>$rights)foreach($rights as $right)$permissions->require($actor,$fixture['tenant'],$fixture['company'],$right,$fixture['unit']);
foreach([[$manager,'industrial_budgets.validate'],[$reader,'industrial_budgets.prepare'],[$reader,'industrial_budget_comparisons.prepare']] as [$actor,$right])checkManualBudget(!$permissions->has($actor,$fixture['tenant'],$fixture['company'],$right,$fixture['unit']),'Unexpected functional power.');
checkManualBudget(!DB::table('wo_entries')->exists()&&!DB::table('dc_calculations')->exists(),'Unexpected workshop/direct cost origins.');
$report=['policy'=>IndustrialBudgets::POLICY,'date'=>'2026-10-28','database'=>'sgf_tempo_test','method'=>'manual_user_report_and_read_only_database_reconciliation','manual_user_reported_complete_and_incomplete'=>true,'manual_user_confirmed_reader_forms_absent'=>true,'screenshots_received'=>false,'automated_browser_recovered'=>false,'comparisons'=>$proof,'role_separation_verified'=>true,'duplicate_workshop_or_direct_cost_origins'=>false,'test_records_changed'=>false,'credentials_changed'=>false,'user_acceptance'=>false,'closing_checkpoint_created'=>false];
file_put_contents(base_path('docs/proofs/industrial-budget-manual-results.json'),json_encode($report,JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR).PHP_EOL);
echo "Manual report reconciled: two exact comparisons, distinct validations, preserved history, residual and role separation. No database or credential changes. Screenshots remain unavailable.\n";
@@ -0,0 +1,10 @@
<?php
// Read-only; deliberately no application branch.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
use Illuminate\Support\Facades\DB;
if(!\App\Modules\Identity\Services\LocalDatabaseGuard::allows())throw new RuntimeException('Own SGF development application database required.');
$rights=[1=>['industrial_budgets.view','industrial_budgets.prepare','industrial_budget_comparisons.view','industrial_budget_comparisons.prepare'],2=>['industrial_budgets.view','industrial_budgets.validate','industrial_budget_comparisons.view']];$grants=[];
if(!DB::table('companies')->where(['id'=>1,'tenant_id'=>1,'name'=>'Tempo Lda'])->exists()||!DB::table('units')->where(['id'=>1,'tenant_id'=>1,'company_id'=>1,'name'=>'SEGI'])->exists())throw new RuntimeException('Scope differs.');
foreach($rights as $user=>$permissions){if(!DB::table('users')->where('id',$user)->exists()||!DB::table('company_memberships')->where(['user_id'=>$user,'tenant_id'=>1,'company_id'=>1])->exists())throw new RuntimeException('Existing account membership required.');foreach($permissions as $permission){$g=['user_id'=>$user,'tenant_id'=>1,'company_id'=>1,'unit_id'=>1,'permission'=>$permission];$grants[]=$g+['already_granted'=>DB::table('permission_grants')->where($g)->exists()];}}
try{\App\Modules\Industry\IndustrialBudgets::guard();throw new RuntimeException('Real costing allowed');}catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface $e){if($e->getStatusCode()!==403)throw $e;}
echo json_encode(['mode'=>'preview_only','destination'=>'sgf_tempo_dev','migration_110000_applied'=>DB::table('migrations')->where('migration','2026_10_28_110000_create_industrial_budgets')->exists(),'proposed_grants'=>$grants,'real_costing_blocked'=>true,'applied'=>false],JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR).PHP_EOL;
+7
View File
@@ -0,0 +1,7 @@
<?php
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
\App\Modules\Industry\IndustrialBudgets::guard();$in=json_decode(stream_get_contents(STDIN),true,32,JSON_THROW_ON_ERROR);
app(\App\Shared\Context\CompanyContext::class)->selectFor($in['actor'],$in['tenant'],$in['company'],$in['unit']);
if($in['pause']??false){$paused=false;\Illuminate\Support\Facades\DB::listen(function($q)use(&$paused){if(!$paused&&str_contains($q->sql,'"companies"')&&str_contains($q->sql,'for update')){$paused=true;echo "LOCK_HELD\n";flush();usleep(1200000);}});}
try{$out=app(\App\Modules\Industry\IndustrialBudgets::class)->{$in['method']}($in['lot'],$in['actor'],$in['input'],$in['key']);echo json_encode(['status'=>200,'result'=>$out],JSON_THROW_ON_ERROR).PHP_EOL;}
catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface $e){echo json_encode(['status'=>$e->getStatusCode()],JSON_THROW_ON_ERROR).PHP_EOL;}
+102
View File
@@ -0,0 +1,102 @@
<?php
// Only the specifically authorised 100000 and four unit grants; no real costing.
require __DIR__.'/../vendor/autoload.php';
$app=require __DIR__.'/../bootstrap/app.php';
$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Artisan;
use App\Modules\Identity\Services\LocalDatabaseGuard;
use App\Modules\Identity\Services\Permissions;
use App\Modules\Identity\Services\Audit;
use App\Modules\Industry\IndustrialCosts;
use App\Modules\Workshop\WorkshopWorkflow;
use App\Shared\Context\CompanyContext;
function ensureIndustrialCost(bool $ok,string $message): void { if(!$ok)throw new RuntimeException($message); }
function industrialCostFingerprint(string $table,?int $max=null): array {
ensureIndustrialCost((bool)preg_match('/^[a-z_]+$/D',$table),'Unexpected table identifier.');
$where=$max===null?'':' WHERE id <= '.$max;
$r=DB::selectOne('SELECT count(*) AS n, md5(COALESCE(string_agg(row_to_json(t)::text, E\'\\n\' ORDER BY row_to_json(t)::text),\'\')) AS h FROM (SELECT * FROM "'.$table.'"'.$where.') t');
return [(int)$r->n,$r->h]; // In memory only; no record contents exported.
}
ensureIndustrialCost(LocalDatabaseGuard::allows(),'Own SGF development application connection required.');
ensureIndustrialCost($argv===[$argv[0],'--apply-confirmed-100000-and-four-grants'],'Exact confirmed operation argument required.');
$migration='2026_10_27_100000_create_industrial_cost_simulation';
ensureIndustrialCost(DB::table('migrations')->where('migration','2026_10_27_090000_create_workshop_direct_costs')->exists(),'Expected direct cost installation missing.');
ensureIndustrialCost(!DB::table('migrations')->where('migration',$migration)->exists(),'100000 already installed; review changed state.');
ensureIndustrialCost(DB::table('migrations')->where('migration','2026_10_27_080000_create_workshop_resource_records')->exists(),'Expected workshop installation missing.');
ensureIndustrialCost(DB::table('migrations')->where('migration','2026_10_27_070000_create_simulated_receivables')->exists(),'Expected receivables installation missing.');
$newTables=['ic_products','ic_lots','ic_inputs','ic_results','ic_decisions','ic_commands','ic_events','ic_outbox'];
$tables=array_map(fn($r)=>$r->tablename,DB::select("SELECT tablename FROM pg_tables WHERE schemaname='public' ORDER BY tablename"));
ensureIndustrialCost(!array_intersect($tables,$newTables),'Industrial tables already exist; review first.');
$rights=[1=>['view','prepare'],2=>['view','validate']];
$checkScope=function(): void {
// Account IDs are the specifically authorised scope; personal details stay outside source control.
foreach([1,2] as $id){
ensureIndustrialCost(DB::table('users')->where('id',$id)->exists(),'Confirmed account missing.');
ensureIndustrialCost(DB::table('company_memberships')->where(['user_id'=>$id,'tenant_id'=>1,'company_id'=>1])->exists(),'Existing membership required.');
$p=app(Permissions::class);$p->require($id,1,1,'company.view');$p->require($id,1,1,'unit.view',1);
}
ensureIndustrialCost(DB::table('companies')->where(['id'=>1,'tenant_id'=>1,'name'=>'Tempo Lda'])->exists(),'Confirmed company differs.');
ensureIndustrialCost(DB::table('units')->where(['id'=>1,'tenant_id'=>1,'company_id'=>1,'name'=>'SEGI'])->exists(),'Confirmed unit differs.');
ensureIndustrialCost(!DB::table('permission_grants')->where('permission','like','industrial_costs.%')->exists(),'Unexpected existing industrial cost rights; review first.');
};
$checkScope();
$baseline=[];foreach($tables as $t)$baseline[$t]=industrialCostFingerprint($t);
$max=[];foreach(['permission_grants','identity_audit'] as $t)$max[$t]=(int)DB::table($t)->max('id');
$ledger=DB::table('migrations')->orderBy('id')->get()->map(fn($r)=>(array)$r)->all();
$sourceHashes=[];foreach(['app/Modules/Industry/IndustrialCosts.php','app/Modules/Workshop/DirectCosts.php','app/Modules/Services/ServiceReceivables.php','app/Modules/Services/ServiceInvoicing.php','app/Modules/Workshop/WorkshopWorkflow.php'] as $p)$sourceHashes[$p]=hash_file('sha256',base_path($p));
$secrets=json_decode(file_get_contents('C:/laragon/data/sgf-tempo/secrets/database.json'),true,32,JSON_THROW_ON_ERROR);
$owner=config('database.connections.'.config('database.default'));
$owner['username']='sgf_dev_owner';$owner['password']=$secrets['dev_owner'];$owner['url']=null;
config(['database.connections.sgf_industrial_cost_owner'=>$owner]);unset($owner,$secrets);
try {
$connection=DB::connection('sgf_industrial_cost_owner');
$identity=$connection->selectOne('SELECT current_database() AS db,current_user AS role,inet_server_port() AS port,rolsuper,rolcreatedb,rolcreaterole,rolbypassrls FROM pg_roles WHERE rolname=current_user');
ensureIndustrialCost($identity->db==='sgf_tempo_dev'&&$identity->role==='sgf_dev_owner'&&(int)$identity->port===55432&&!$identity->rolsuper&&!$identity->rolcreatedb&&!$identity->rolcreaterole&&!$identity->rolbypassrls,'Unexpected migration owner/destination.');
$connection->transaction(function()use($migration,$baseline,$newTables): void {
$applicationConnection=DB::getDefaultConnection();DB::setDefaultConnection('sgf_industrial_cost_owner');
try {
$exit=Artisan::call('migrate',['--database'=>'sgf_industrial_cost_owner','--path'=>'database/migrations/'.$migration.'.php','--force'=>true,'--no-interaction'=>true]);
ensureIndustrialCost($exit===0,'Targeted migration failed.');
foreach($baseline as $t=>$fp)if($t!=='migrations')ensureIndustrialCost(industrialCostFingerprint($t)===$fp,'Existing records changed during migration: '.$t);
foreach($newTables as $t)ensureIndustrialCost(DB::table($t)->count()===0,'New tables must be empty.');
} finally { DB::setDefaultConnection($applicationConnection); }
});
} finally { DB::purge('sgf_industrial_cost_owner');config(['database.connections.sgf_industrial_cost_owner'=>null]); }
ensureIndustrialCost(LocalDatabaseGuard::allows(),'Application must remain sgf_dev_app.');
$afterLedger=DB::table('migrations')->orderBy('id')->get()->map(fn($r)=>(array)$r)->all();
ensureIndustrialCost(count($afterLedger)===count($ledger)+1&&array_slice($afterLedger,0,count($ledger))===$ledger&&end($afterLedger)['migration']===$migration,'Unexpected migration ledger delta.');
$denials=[];
$grants=DB::transaction(function()use($rights,$checkScope,$baseline,$max,&$denials): array {
DB::table('companies')->where('id',1)->lockForUpdate()->firstOrFail();$checkScope();$grants=[];
foreach($rights as $user=>$actions)foreach($actions as $action){
$g=['user_id'=>$user,'tenant_id'=>1,'company_id'=>1,'unit_id'=>1,'permission'=>'industrial_costs.'.$action];
DB::table('permission_grants')->insert($g+['created_at'=>now(),'updated_at'=>now()]);
Audit::record('industrial_costs.initial_grant',null,1,1,1,subject:$user,details:['permission'=>$g['permission'],'reason'=>'Four unit grants specifically authorised; real operations remain blocked.']);$grants[]=$g;
}
foreach($baseline as $t=>$fp)if($t!=='migrations')ensureIndustrialCost(industrialCostFingerprint($t,$max[$t]??null)===$fp,'Prior records changed: '.$t);
ensureIndustrialCost(DB::table('permission_grants')->where('id','>',$max['permission_grants'])->count()===4,'Exactly four new grants required.');
ensureIndustrialCost(DB::table('identity_audit')->where('id','>',$max['identity_audit'])->count()===4&&DB::table('identity_audit')->where('id','>',$max['identity_audit'])->where('action','industrial_costs.initial_grant')->count()===4,'Exactly four grant audit entries required.');
$actual=DB::table('permission_grants')->where('permission','like','industrial_costs.%')->get(['user_id','tenant_id','company_id','unit_id','permission'])->map(fn($r)=>(array)$r)->all();
$sort=fn($a,$b)=>[$a['user_id'],$a['permission']]<=>[$b['user_id'],$b['permission']];usort($actual,$sort);$expected=$grants;usort($expected,$sort);ensureIndustrialCost($actual===$expected,'Granted accounts/rights/scope differ.');
foreach([1,2] as $actor){app(CompanyContext::class)->selectFor($actor,1,1,1);$listing=app(IndustrialCosts::class)->listing($actor);ensureIndustrialCost($listing['blocked']&&$listing['lots']===[],'Normal industrial cost listing must remain blocked.');}
foreach(['guard','open','input','calculate','decide','direct','workshop','receivables','issuance'] as $entry){
try {
$r=app(IndustrialCosts::class);
match($entry){'guard'=>IndustrialCosts::guard(),'open'=>$r->open(1,[],'blocked-probe'),'direct'=>\App\Modules\Workshop\DirectCosts::guard(),'input'=>$r->input(0,1,[],'blocked-probe'),'calculate'=>$r->calculate(0,1,[],'blocked-probe'),'decide'=>$r->decide(0,2,[],'blocked-probe'),'workshop'=>WorkshopWorkflow::guard(),'receivables'=>\App\Modules\Services\ServiceReceivables::guard(),'issuance'=>\App\Modules\Services\ServiceInvoicing::guard()};
throw new RuntimeException('Operational entry did not refuse.');
}catch(\Symfony\Component\HttpKernel\Exception\HttpException $e){ensureIndustrialCost($e->getStatusCode()===403,'Expected operational refusal.');$denials[$entry]=403;}
}
app(CompanyContext::class)->selectFor(1,1,1,1);$w=app(WorkshopWorkflow::class)->listing(1);ensureIndustrialCost($w['blocked']&&$w['orders']===[],'Workshop operational block must remain.');
return $grants;
});
foreach(['ic','dc','sr','wo'] as $prefix){
try {DB::select('SELECT sgf_'.$prefix.'_environment()');throw new RuntimeException('SQL environment guard did not refuse.');}
catch(\Illuminate\Database\QueryException $e){ensureIndustrialCost(str_contains($e->getMessage(),'SGF_'.strtoupper($prefix).'_TEST_DATABASE_ONLY'),'Unexpected SQL guard response.');}
}
foreach($sourceHashes as $p=>$hash)ensureIndustrialCost(hash_file('sha256',base_path($p))===$hash,'Functional source or guard changed.');
foreach($newTables as $t)ensureIndustrialCost(DB::table($t)->count()===0,'New industrial cost tables must remain empty.');
$proof=['date'=>'2026-10-28','database'=>'sgf_tempo_dev','migration_applied'=>$migration,'only_one_migration_added'=>true,'workshop_080000_preserved'=>true,'preexisting_tables_checked'=>count($baseline),'prior_records_and_accesses_preserved'=>true,'new_empty_tables'=>$newTables,'new_grants'=>$grants,'audited_new_grants'=>4,'application_role'=>'sgf_dev_app','both_normal_account_listings_blocked'=>true,'entry_denials'=>$denials,'cost_receivables_and_workshop_sql_guards_refused'=>true,'functional_and_guard_sources_unchanged'=>true,'real_operations_created'=>false];
file_put_contents(storage_path('app/private/industrial-cost-dev-install-proof.json'),json_encode($proof,JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR));
echo 'Applied only 100000 and four audited grants; '.count($baseline)." prior tables preserved, eight new tables empty, costing, workshop and operational/fiscal guards verified.\n";
+16
View File
@@ -0,0 +1,16 @@
<?php
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
use App\Modules\Workshop\WorkshopBilling;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;
use Symfony\Component\Process\Process;
WorkshopBilling::guard();$base=json_decode(file_get_contents('C:/laragon/data/sgf-tempo/secrets/browser-fixture.json'),true,32,JSON_THROW_ON_ERROR);$f=$base+$base['workshop_billing'];$scope=['tenant'=>$f['tenant'],'company'=>$f['company'],'unit'=>$f['unit'],'order'=>$f['order']];$key=fn()=>(string)Str::uuid();$checks=[];
$pair=function($one,$two)use($scope){$a=new Process([PHP_BINARY,'scripts/workshop-billing-worker.php','--env=testing'],base_path(),null,json_encode($one+$scope+['pause'=>true]));$b=new Process([PHP_BINARY,'scripts/workshop-billing-worker.php','--env=testing'],base_path(),null,json_encode($two+$scope));$a->start();if(!$a->waitUntil(fn($type,$v)=>str_contains($v,'LOCK_HELD')))throw new RuntimeException('Concurrent lock not observed.');$b->start();$a->wait();$b->wait();$out=[];foreach([$a,$b] as $p){if(!$p->isSuccessful())throw new RuntimeException('Worker failed.');$lines=array_values(array_filter(explode("\n",trim($p->getOutput())),fn($s)=>str_starts_with($s,'{')));$out[]=json_decode(end($lines),true,32,JSON_THROW_ON_ERROR);}return $out;};
$check=function($out,$replay){if($out[0]['status']!==200||$out[1]['status']!==($replay?200:409)||($replay&&(!$out[1]['result']['replayed']||$out[0]['result']['id']!==$out[1]['result']['id'])))throw new RuntimeException('Unexpected concurrent result.');return $out[0]['result']['id'];};
$p=['actor'=>$f['manager_id'],'method'=>'prepare','key'=>$key(),'input'=>\Tests\Support\WorkshopBillingFixture::proposal($f)];$id=$check($pair($p,$p),true);$checks['proposal_replay_one_version']=true;
$p['key']=$key();$p['input']['version']=2;$p['input']['previous_id']=$id;$other=$p;$other['key']=$key();$other['input']['lines'][0]['price']='210';$id=$check($pair($p,$other),false);$checks['competing_proposals_one_successor']=true;
$r=['actor'=>$f['reader_id'],'method'=>'review','key'=>$key(),'input'=>['id'=>$id,'version'=>2,'decision'=>'approved','reason'=>'Revisão comercial concorrente distinta.']];$check($pair($r,$r),true);$checks['review_replay_one_decision']=true;
$g=['actor'=>$f['manager_id'],'method'=>'generate','key'=>$key(),'input'=>['id'=>$id,'version'=>2]];$gid=$check($pair($g,$g),true);$checks['generation_replay_one_draft']=true;
$g['key']=$key();$out=$pair($g,$g);if($out[0]['status']!==409||$out[1]['status']!==409)throw new RuntimeException('Duplicate generation not blocked.');$checks['new_keys_cannot_duplicate_generation']=true;
if(DB::table('wb_generations')->where('order_id',$f['order'])->count()!==1||DB::table('wb_claims')->where('order_id',$f['order'])->count()!==2)throw new RuntimeException('Generation or origin claims duplicated.');
file_put_contents(base_path('docs/proofs/workshop-billing-concurrency.json'),json_encode(['policy'=>WorkshopBilling::POLICY,'database'=>'sgf_tempo_test','overlapping_processes_per_case'=>2,'checks'=>$checks,'one_generation_two_origin_claims'=>true],JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR));echo "Five overlapping commercial conversion cases passed; one generation and two origin claims.\n";
+83
View File
@@ -0,0 +1,83 @@
<?php
// Only the specifically authorised 120000 and six grants; no operational activation.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
use Illuminate\Support\Facades\{DB,Artisan};
use App\Modules\Identity\Services\{LocalDatabaseGuard,Permissions,Audit};
use App\Modules\Workshop\{WorkshopBilling,WorkshopWorkflow,DirectCosts};
use App\Modules\Industry\IndustrialCosts;
use App\Modules\Services\{ServiceReceivables,ServiceInvoicing};
use App\Shared\Context\CompanyContext;
function ensureWbInstall(bool $ok,string $why): void {if(!$ok)throw new RuntimeException($why);}
function wbFingerprint(string $table,?int $max=null): array {
ensureWbInstall((bool)preg_match('/^[a-z_]+$/D',$table),'Invalid table identifier.');
$where=$max===null?'':' WHERE id <= '.$max;
$row=DB::selectOne('SELECT count(*) AS n, md5(COALESCE(string_agg(row_to_json(t)::text,E\'\\n\' ORDER BY row_to_json(t)::text),\'\')) AS h FROM (SELECT * FROM "'.$table.'"'.$where.') t');
return [(int)$row->n,$row->h]; // Record contents and fingerprints are not exported.
}
ensureWbInstall(LocalDatabaseGuard::allows(),'Own SGF application connection required.');
ensureWbInstall($argv===[$argv[0],'--apply-confirmed-120000-and-six-grants'],'Exact authorised operation required.');
$migration='2026_10_28_120000_create_workshop_billing_drafts';
$excluded='2026_10_28_110000_create_industrial_budgets';
ensureWbInstall(!DB::table('migrations')->where('migration',$migration)->exists(),'120000 already installed; review instead of replaying.');
ensureWbInstall(!DB::table('migrations')->where('migration',$excluded)->exists(),'110000 state differs from reviewed proposal.');
foreach(['2026_10_27_100000_create_industrial_cost_simulation','2026_10_27_080000_create_workshop_resource_records'] as $prerequisite)ensureWbInstall(DB::table('migrations')->where('migration',$prerequisite)->exists(),'Migration prerequisite missing.');
$newTables=['wb_proposals','wb_decisions','wb_generations','wb_claims','wb_commands','wb_events','wb_outbox'];
$tables=array_map(fn($r)=>$r->tablename,DB::select("SELECT tablename FROM pg_tables WHERE schemaname='public' ORDER BY tablename"));
ensureWbInstall(!array_intersect($tables,$newTables),'Unexpected existing conversion tables.');
$rights=[1=>['workshop_billing.view','workshop_billing.prepare','workshop_billing.generate'],2=>['workshop_billing.view','workshop_billing.review','workshop.view']];
$checkScope=function()use($rights): void {
ensureWbInstall(DB::table('companies')->where(['id'=>1,'tenant_id'=>1,'name'=>'Tempo Lda'])->exists(),'Company differs.');
ensureWbInstall(DB::table('units')->where(['id'=>1,'tenant_id'=>1,'company_id'=>1,'name'=>'SEGI'])->exists(),'Unit differs.');
foreach($rights as $user=>$permissions){
ensureWbInstall(DB::table('users')->where('id',$user)->exists()&&DB::table('company_memberships')->where(['user_id'=>$user,'tenant_id'=>1,'company_id'=>1])->exists(),'Existing account/member required.');
foreach(['company.view','clients.view','services.view'] as $permission)app(Permissions::class)->require($user,1,1,$permission);
app(Permissions::class)->require($user,1,1,'unit.view',1);
foreach($permissions as $permission)ensureWbInstall(!DB::table('permission_grants')->where(['user_id'=>$user,'tenant_id'=>1,'company_id'=>1,'unit_id'=>1,'permission'=>$permission])->exists(),'Proposed grant already present; review required.');
}
foreach(['workshop.view','service_drafts.view','service_drafts.create','billing_drafts.view','billing_drafts.create'] as $permission)app(Permissions::class)->require(1,1,1,$permission,1);
ensureWbInstall(!DB::table('permission_grants')->where('permission','like','workshop_billing.%')->exists(),'Unexpected conversion rights.');
};
$checkScope();$baseline=[];foreach($tables as $t)$baseline[$t]=wbFingerprint($t);
$max=[];foreach(['permission_grants','identity_audit'] as $t)$max[$t]=(int)DB::table($t)->max('id');
$ledger=DB::table('migrations')->orderBy('id')->get()->map(fn($r)=>(array)$r)->all();
$sources=[];foreach(['app/Modules/Workshop/WorkshopBilling.php','app/Modules/Workshop/WorkshopWorkflow.php','app/Modules/Workshop/DirectCosts.php','app/Modules/Industry/IndustrialCosts.php','app/Modules/Services/ServiceInvoicing.php','app/Modules/Services/ServiceReceivables.php','app/Modules/Services/ServiceWorkflow.php'] as $path)$sources[$path]=hash_file('sha256',base_path($path));
$secrets=json_decode(file_get_contents('C:/laragon/data/sgf-tempo/secrets/database.json'),true,32,JSON_THROW_ON_ERROR);
$owner=config('database.connections.'.config('database.default'));$owner['username']='sgf_dev_owner';$owner['password']=$secrets['dev_owner'];$owner['url']=null;
config(['database.connections.sgf_wb_install_owner'=>$owner]);unset($secrets,$owner);
$application=DB::getDefaultConnection();$grants=[];$denials=[];
$checkBlocks=function()use(&$denials): void {
foreach([1,2] as $actor){app(CompanyContext::class)->selectFor($actor,1,1,1);$list=app(WorkshopBilling::class)->listing($actor);ensureWbInstall($list['blocked']&&$list['orders']===[],'Conversion listing must remain blocked.');}
foreach(['conversion','prepare','review','generate','workshop','direct_cost','industrial_cost','receivables','issuance'] as $entry){
try{match($entry){'conversion'=>WorkshopBilling::guard(),'prepare'=>app(WorkshopBilling::class)->prepare(0,1,[],'blocked-probe'),'review'=>app(WorkshopBilling::class)->review(0,2,[],'blocked-probe'),'generate'=>app(WorkshopBilling::class)->generate(0,1,[],'blocked-probe'),'workshop'=>WorkshopWorkflow::guard(),'direct_cost'=>DirectCosts::guard(),'industrial_cost'=>IndustrialCosts::guard(),'receivables'=>ServiceReceivables::guard(),'issuance'=>ServiceInvoicing::guard()};throw new RuntimeException('Operational guard did not refuse.');}
catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface $e){ensureWbInstall($e->getStatusCode()===403,'Expected 403.');$denials[$entry]=403;}
}
foreach(['ic','wo','dc','sr'] as $prefix){
try{DB::transaction(fn()=>DB::select('SELECT sgf_'.$prefix.'_environment()'));throw new RuntimeException('SQL environment guard allowed development.');}
catch(\Illuminate\Database\QueryException $e){ensureWbInstall(str_contains($e->getMessage(),'SGF_'.strtoupper($prefix).'_TEST_DATABASE_ONLY'),'Unexpected SQL guard refusal.');}
}
};
try{
$connection=DB::connection('sgf_wb_install_owner');
$id=$connection->selectOne('SELECT current_database() AS db,current_user AS role,inet_server_port() AS port,rolsuper,rolcreatedb,rolcreaterole,rolbypassrls FROM pg_roles WHERE rolname=current_user');
ensureWbInstall($id->db==='sgf_tempo_dev'&&$id->role==='sgf_dev_owner'&&(int)$id->port===55432&&!$id->rolsuper&&!$id->rolcreatedb&&!$id->rolcreaterole&&!$id->rolbypassrls,'Unexpected owner/destination.');
DB::setDefaultConnection('sgf_wb_install_owner');
$connection->transaction(function()use($migration,$excluded,$checkScope,$rights,$baseline,$max,$ledger,$newTables,$checkBlocks,&$grants){
DB::table('companies')->where('id',1)->lockForUpdate()->firstOrFail();$checkScope();
$code=Artisan::call('migrate',['--database'=>'sgf_wb_install_owner','--path'=>'database/migrations/'.$migration.'.php','--force'=>true,'--no-interaction'=>true]);ensureWbInstall($code===0,'Targeted migration failed.');
foreach($rights as $user=>$permissions)foreach($permissions as $permission){$g=['user_id'=>$user,'tenant_id'=>1,'company_id'=>1,'unit_id'=>1,'permission'=>$permission];DB::table('permission_grants')->insert($g+['created_at'=>now(),'updated_at'=>now()]);Audit::record('workshop_billing.initial_grant',null,1,1,1,subject:$user,details:['permission'=>$permission,'reason'=>'Six specifically authorised grants; operational use remains blocked.']);$grants[]=$g;}
foreach($baseline as $t=>$fp)if($t!=='migrations')ensureWbInstall(wbFingerprint($t,$max[$t]??null)===$fp,'Existing records changed: '.$t);
ensureWbInstall(DB::table('permission_grants')->where('id','>',$max['permission_grants'])->count()===6,'Exactly six new grants required.');
ensureWbInstall(DB::table('identity_audit')->where('id','>',$max['identity_audit'])->count()===6&&DB::table('identity_audit')->where('id','>',$max['identity_audit'])->where('action','workshop_billing.initial_grant')->count()===6,'Exactly six audited grants required.');
$actual=DB::table('permission_grants')->where('id','>',$max['permission_grants'])->get(['user_id','tenant_id','company_id','unit_id','permission'])->map(fn($r)=>(array)$r)->all();$sort=fn($a,$b)=>[$a['user_id'],$a['permission']]<=>[$b['user_id'],$b['permission']];usort($actual,$sort);$expected=$grants;usort($expected,$sort);ensureWbInstall($actual===$expected,'Grant scope differs.');
$after=DB::table('migrations')->orderBy('id')->get()->map(fn($r)=>(array)$r)->all();ensureWbInstall(count($after)===count($ledger)+1&&array_slice($after,0,count($ledger))===$ledger&&end($after)['migration']===$migration,'Unexpected migration delta.');
ensureWbInstall(!DB::table('migrations')->where('migration',$excluded)->exists(),'110000 must stay pending.');
foreach($newTables as $t)ensureWbInstall(DB::table($t)->count()===0,'New table not empty.');
$checkBlocks();
});
}finally{DB::setDefaultConnection($application);DB::purge('sgf_wb_install_owner');config(['database.connections.sgf_wb_install_owner'=>null]);}
ensureWbInstall(LocalDatabaseGuard::allows(),'Application must remain sgf_dev_app.');$checkBlocks();
foreach($newTables as $t)ensureWbInstall(DB::table($t)->count()===0,'New table not empty after installation.');
foreach($sources as $path=>$hash)ensureWbInstall(hash_file('sha256',base_path($path))===$hash,'Functional source changed.');
$proof=['date'=>'2026-10-28','database'=>'sgf_tempo_dev','migration_applied'=>$migration,'only_one_migration_added'=>true,'migration_110000_still_pending'=>true,'preexisting_tables_checked'=>count($baseline),'prior_records_and_accesses_preserved'=>true,'new_empty_tables'=>$newTables,'new_grants'=>$grants,'audited_new_grants'=>6,'application_role'=>'sgf_dev_app','conversion_account_listings_blocked'=>true,'entry_denials'=>$denials,'sql_environment_guards_refused'=>true,'functional_sources_unchanged'=>true,'real_operations_created'=>false];
file_put_contents(storage_path('app/private/workshop-billing-dev-install-proof.json'),json_encode($proof,JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR));
echo 'Applied only 120000 and six audited grants; '.count($baseline)." previous tables preserved, seven new tables empty, 110000 pending, operational guards verified.\n";
+13
View File
@@ -0,0 +1,13 @@
<?php
// Read-only check. Never prints credentials, attempts login, or resets accounts.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
\App\Modules\Workshop\WorkshopBilling::guard();
$identity=\Illuminate\Support\Facades\DB::selectOne('SELECT current_database() AS db,current_user AS role');
if($identity->db!=='sgf_tempo_test'||$identity->role!=='sgf_test_runner')throw new RuntimeException('Wrong database; no accounts changed.');
$path='C:/laragon/data/sgf-tempo/secrets/workshop-billing-manual-entry.txt';
if(!is_file($path))throw new RuntimeException('Entry file missing; no credentials reset.');
$content=file_get_contents($path);
if(!str_contains($content,'http://127.0.0.1:8002')||!preg_match('/Temporary synthetic password for these two accounts: ([^\r\n]+)/',$content,$match))throw new RuntimeException('Unexpected entry format; no accounts changed.');
$checks=[];foreach(['gestor@example.test','consulta@example.test'] as $email){$u=\App\Models\User::where('email',$email)->first();$checks[]=['account'=>$email,'exists'=>(bool)$u,'entry_matches'=>$u&&\Illuminate\Support\Facades\Hash::check($match[1],$u->password)];}
unset($content,$match);
echo json_encode(['path'=>realpath($path),'database'=>$identity->db,'accounts'=>$checks,'credentials_changed'=>false],JSON_THROW_ON_ERROR).PHP_EOL;
+10
View File
@@ -0,0 +1,10 @@
<?php
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
\App\Modules\Workshop\WorkshopBilling::guard();$path='C:/laragon/data/sgf-tempo/secrets/browser-fixture.json';$base=json_decode(file_get_contents($path),true,32,JSON_THROW_ON_ERROR);
if(\Illuminate\Support\Facades\DB::table('wo_orders')->exists())throw new RuntimeException('Empty workshop proof required; nothing deleted.');
$f=\Tests\Support\WorkshopBillingFixture::create($base+['manager'=>\App\Models\User::findOrFail($base['manager_id']),'reader'=>\App\Models\User::findOrFail($base['reader_id'])]);
$safe=array_intersect_key($f,array_flip(['order','task','auth','time','material','day','service','client']));
file_put_contents($path,json_encode($base+['workshop_billing'=>$safe],JSON_THROW_ON_ERROR));
file_put_contents('C:/laragon/data/sgf-tempo/secrets/workshop-billing-manual-entry.txt',"Synthetic SGF proof only - http://127.0.0.1:8002\r\nPreparer: gestor@example.test\r\nReviewer: consulta@example.test\r\nTemporary synthetic password for these two accounts: ".$base['password']."\r\nDo not paste this password into chat, screenshots or reports.\r\n");
// Existing protected manifest is kept outside Git; no credentials printed.
echo "Synthetic workshop sources verified by a technical identity, commercial roles separate. No proposal, review or generation prefilled.\n";
+18
View File
@@ -0,0 +1,18 @@
import assert from 'node:assert/strict';
import {workshopBillingProposal} from '../resources/js/workshopBillingProposal.js';
const order={client_id:16,entries:[{id:6,version:1},{id:4,version:1}],proposals:[]},services=[{id:9,version:1}];
const form=new FormData();
assert.throws(()=>workshopBillingProposal(order,services,form),/Incluir origem integral/);
form.set('select-6','on');
assert.throws(()=>workshopBillingProposal(order,services,form),/Origem #6: seleccione o serviço/);
form.set('service-6','9');
assert.throws(()=>workshopBillingProposal(order,services,form),/Origem #6: preencha o preço/);
form.set('price-6','0');
assert.throws(()=>workshopBillingProposal(order,services,form),/fonte comercial/);
form.set('source-6','WORKSHOP-SALES-SYNTHETIC-v1');
assert.throws(()=>workshopBillingProposal(order,services,form),/fundamento/);
form.set('evidence','Proposta sintética');
const zero=workshopBillingProposal(order,services,form);assert.equal(zero.lines[0].price,'0');assert.equal(zero.lines.length,1);
form.set('select-4','on');form.set('service-4','9');form.set('price-4','200');form.set('source-4','WORKSHOP-SALES-SYNTHETIC-v1');form.set('price-6','75');
const proposal=workshopBillingProposal(order,services,form);assert.deepEqual(proposal.lines.map(l=>l.price),['75','200']);assert.equal(proposal.previous_id,null);assert.equal(proposal.version,1);
console.log('Workshop form checks passed: missing selection/service/price/source/evidence; explicit zero; exact selected values. No database or browser used.');
@@ -0,0 +1,33 @@
<?php
// Reconcile the reported manual generation without altering records or credentials.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
use Illuminate\Support\Facades\DB;
use App\Modules\Workshop\WorkshopBilling;
use App\Modules\Services\DraftValues;
function requireWorkshopManual(bool $ok,string $reason): void {if(!$ok)throw new RuntimeException($reason);}
WorkshopBilling::guard();
$identity=DB::selectOne('SELECT current_database() AS db,current_user AS role');
requireWorkshopManual($identity->db==='sgf_tempo_test'&&$identity->role==='sgf_test_runner','Unexpected database.');
$generations=DB::table('wb_generations')->get();requireWorkshopManual($generations->count()===1,'Exactly one synthetic generation required.');$g=$generations->first();
$p=DB::table('wb_proposals')->find($g->proposal_id);$review=DB::table('wb_decisions')->where(['proposal_id'=>$p->id,'version'=>$p->version,'decision'=>'approved'])->first();
requireWorkshopManual($review&&$review->actor_id!==$p->actor_id&&$g->actor_id===$p->actor_id,'Separate commercial identities required.');
$snapshot=json_decode($p->snapshot,true,64,JSON_THROW_ON_ERROR);$service=DB::table('a_service_drafts')->find($g->service_draft_id);$billing=DB::table('a_billing_drafts')->find($g->billing_draft_id);
requireWorkshopManual($service&&$billing&&$billing->source_id===$service->id&&$billing->state==='draft'&&$service->state==='draft','Draft destination chain differs.');
$sd=json_decode($service->data,true);$bd=json_decode($billing->data,true);
requireWorkshopManual($sd['currency']==='MZN'&&$bd['currency']==='MZN'&&DraftValues::base($sd)==='500'&&DraftValues::base($bd)==='500'&&$snapshot['base_exact']==='500','Commercial amounts differ.');
requireWorkshopManual(count($snapshot['lines'])===2&&count($bd['lines'])===2,'Two selected lines required.');
$claims=DB::table('wb_claims')->where('generation_id',$g->id)->get();requireWorkshopManual($claims->count()===2,'Two unique source claims required.');
foreach($snapshot['lines'] as $i=>$line){
$entry=DB::table('wo_entries')->where(['id'=>$line['entry_id'],'version'=>$line['entry_version'],'order_id'=>$g->order_id,'origin'=>$line['origin']])->first();
requireWorkshopManual($entry&&!$entry->outside_authority,'Source differs.');
requireWorkshopManual(DB::table('wo_decisions')->where(['entry_id'=>$entry->id,'entry_version'=>$entry->version,'decision'=>'verified'])->exists(),'Technical verification missing.');
requireWorkshopManual($claims->contains(fn($c)=>$c->entry_id===$entry->id&&$c->entry_version===$entry->version&&$c->origin===$entry->origin),'Source claim differs.');
foreach(['service_id','quantity','unit_price','description'] as $field)requireWorkshopManual($bd['lines'][$i][$field]===$line[$field],'Generated line differs: '.$field);
requireWorkshopManual($line['price_source']==='WORKSHOP-SALES-SYNTHETIC-v1','Unexpected price reference.');
requireWorkshopManual($entry->kind==='time'?($line['quantity']==='1.75'&&$line['unit_price']==='200'):($line['quantity']==='2'&&$line['unit_price']==='75'),'Quantity/price differs.');
}
requireWorkshopManual(!DB::table('b_internal_confirmations')->where('billing_draft_id',$billing->id)->exists(),'Unexpected internal confirmation.');
requireWorkshopManual($bd['tax_status']==='pending'&&$bd['accounting_status']==='not_processed','Unexpected fiscal/accounting state.');
$proof=['policy'=>WorkshopBilling::POLICY,'date'=>'2026-10-28','database'=>'sgf_tempo_test','method'=>'user_reported_manual_browser_and_read_only_reconciliation','order_id'=>$g->order_id,'proposal_id'=>$p->id,'proposal_version'=>$p->version,'service_draft_id'=>$service->id,'billing_draft_id'=>$billing->id,'commercial_base_exact'=>'500','currency'=>'MZN','source_claims'=>2,'distinct_commercial_review'=>true,'generated_lines_match_reviewed_proposal'=>true,'internal_confirmation_created'=>false,'fiscal_status'=>'pending','accounting_status'=>'not_processed','screenshots_received'=>false,'automated_browser_recovered'=>false,'records_changed'=>false,'user_acceptance'=>false,'closing_checkpoint_created'=>false];
file_put_contents(base_path('docs/proofs/workshop-billing-manual-results.json'),json_encode($proof,JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR).PHP_EOL);
echo 'Manual generation reconciled: proposal #'.$p->id.' v'.$p->version.', service #'.$service->id.', billing draft #'.$billing->id.'; 500 MZN, two source claims, separate review, no internal confirmation. No records changed.'.PHP_EOL;
@@ -0,0 +1,10 @@
<?php
// Read-only; no apply or real activation branch.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
use Illuminate\Support\Facades\DB;
if(!\App\Modules\Identity\Services\LocalDatabaseGuard::allows())throw new RuntimeException('Own SGF development application database required.');
if(!DB::table('companies')->where(['id'=>1,'tenant_id'=>1,'name'=>'Tempo Lda'])->exists()||!DB::table('units')->where(['id'=>1,'tenant_id'=>1,'company_id'=>1,'name'=>'SEGI'])->exists())throw new RuntimeException('Scope differs.');
$proposals=[];foreach([1=>['workshop_billing.view','workshop_billing.prepare','workshop_billing.generate'],2=>['workshop_billing.view','workshop_billing.review','workshop.view']] as $user=>$rights){if(!DB::table('users')->where('id',$user)->exists()||!DB::table('company_memberships')->where(['user_id'=>$user,'tenant_id'=>1,'company_id'=>1])->exists())throw new RuntimeException('Existing account membership required.');foreach($rights as $permission){$g=['user_id'=>$user,'tenant_id'=>1,'company_id'=>1,'unit_id'=>1,'permission'=>$permission];$proposals[]=$g+['already_granted'=>DB::table('permission_grants')->where($g)->exists()];}}
$prerequisites=[];foreach([1,2] as $user){foreach(['clients.view','services.view'] as $permission)$prerequisites[]=['user_id'=>$user,'permission'=>$permission,'unit_id'=>null,'present'=>DB::table('permission_grants')->where(['user_id'=>$user,'tenant_id'=>1,'company_id'=>1,'permission'=>$permission])->whereNull('unit_id')->exists()];}foreach(['workshop.view','service_drafts.view','service_drafts.create','billing_drafts.view','billing_drafts.create'] as $permission)$prerequisites[]=['user_id'=>1,'permission'=>$permission,'unit_id'=>1,'present'=>DB::table('permission_grants')->where(['user_id'=>1,'tenant_id'=>1,'company_id'=>1,'unit_id'=>1,'permission'=>$permission])->exists()];
try{\App\Modules\Workshop\WorkshopBilling::guard();throw new RuntimeException('Real conversion allowed.');}catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface $e){if($e->getStatusCode()!==403)throw $e;}
echo json_encode(['mode'=>'preview_only','destination'=>'sgf_tempo_dev','migration_120000_applied'=>DB::table('migrations')->where('migration','2026_10_28_120000_create_workshop_billing_drafts')->exists(),'proposed_grants'=>$proposals,'existing_prerequisites'=>$prerequisites,'real_conversion_blocked'=>true,'applied'=>false],JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR).PHP_EOL;
+6
View File
@@ -0,0 +1,6 @@
<?php
// Read-only synthetic status. No credentials, form contents or account changes.
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
\App\Modules\Workshop\WorkshopBilling::guard();
$db=\Illuminate\Support\Facades\DB::class;
echo json_encode(['database'=>$db::selectOne('SELECT current_database() AS db')->db,'proposals'=>$db::table('wb_proposals')->orderBy('id')->get(['id','order_id','version','previous_id'])->all(),'reviews'=>$db::table('wb_decisions')->get(['proposal_id','version','decision'])->all(),'generations'=>$db::table('wb_generations')->get(['id','order_id','proposal_id','billing_draft_id'])->all(),'read_only'=>true],JSON_PRETTY_PRINT|JSON_THROW_ON_ERROR).PHP_EOL;
+6
View File
@@ -0,0 +1,6 @@
<?php
require __DIR__.'/../vendor/autoload.php';$app=require __DIR__.'/../bootstrap/app.php';$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
\App\Modules\Workshop\WorkshopBilling::guard();$in=json_decode(stream_get_contents(STDIN),true,32,JSON_THROW_ON_ERROR);app(\App\Shared\Context\CompanyContext::class)->selectFor($in['actor'],$in['tenant'],$in['company'],$in['unit']);
if($in['pause']??false){$paused=false;\Illuminate\Support\Facades\DB::listen(function($q)use(&$paused){if(!$paused&&str_contains($q->sql,'"companies"')&&str_contains($q->sql,'for update')){$paused=true;echo "LOCK_HELD\n";flush();usleep(1200000);}});}
try{$out=app(\App\Modules\Workshop\WorkshopBilling::class)->{$in['method']}($in['order'],$in['actor'],$in['input'],$in['key']);echo json_encode(['status'=>200,'result'=>$out],JSON_THROW_ON_ERROR).PHP_EOL;}
catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface $e){echo json_encode(['status'=>$e->getStatusCode()],JSON_THROW_ON_ERROR).PHP_EOL;}
+83
View File
@@ -0,0 +1,83 @@
<?php
namespace Tests\Feature;
use App\Modules\Industry\{IndustrialBudgets,IndustrialCosts};
use App\Shared\Context\CompanyContext;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;
use Tests\Support\{IndustrialBudgetFixture,IdentityFixture};
use Tests\TestCase;
final class IndustrialBudgetsTest extends TestCase {
use RefreshDatabase;
private array $f;private string $token;
protected function setUp(): void {parent::setUp();$this->f=IndustrialBudgetFixture::create();$this->login();}
private function login(string $who='manager'): void {$this->postJson('/api/login',['email'=>$this->f[$who]->email,'password'=>$this->f['password']])->assertOk();$this->token=$this->postJson('/api/context',['tenant_id'=>$this->f['tenant'],'company_id'=>$this->f['company'],'unit_id'=>$this->f['unit']])->assertOk()->json('context.token');}
private function send(string $action,array $in,?string $key=null,?int $lot=null){return $this->withHeaders(['X-SGF-Context'=>$this->token,'Idempotency-Key'=>$key??(string)Str::uuid()])->postJson('/api/industrial-budgets/lots/'.($lot??$this->f['lot']).'/'.$action,$in);}
private function proposal(array $extra=[]): array {return array_replace(['version'=>1,'previous_id'=>null,'dimensions'=>app(IndustrialBudgets::class)->dimensions(DB::table('ic_lots')->find($this->f['lot'])),'amounts'=>['material'=>'900','labour'=>'600','allocated'=>'300'],'evidence'=>'Hipótese retrospectiva sintética, sem causas presumidas.'],$extra);}
private function approve(int $id,int $version=1): void {$this->login('reader');$this->send('decisions',['id'=>$id,'version'=>$version,'decision'=>'approved','reason'=>'Validação exacta sintética.'])->assertOk();$this->login();}
private function comparison(int $b,array $extra=[]): array {return array_replace(['version'=>1,'previous_id'=>null,'budget_id'=>$b,'budget_version'=>1,'result_id'=>$this->f['result'],'result_version'=>1],$extra);}
private function snapshot(int $id): array {return json_decode(DB::table('ib_comparisons')->find($id)->snapshot,true);}
public function test_full_scenario_exact_reconciliation_roles_and_no_new_consumption(): void {
$before=[];foreach(['ic_inputs','ic_results','wo_entries','dc_calculations'] as $t)$before[$t]=DB::table($t)->count();
$b=$this->send('proposals',$this->proposal())->assertOk()->json('id');$this->send('comparisons',$this->comparison($b))->assertStatus(409);
IdentityFixture::grant($this->f['manager']->id,$this->f['tenant'],$this->f['company'],'industrial_budgets.validate',$this->f['unit']);$this->send('decisions',['id'=>$b,'version'=>1,'decision'=>'approved','reason'=>'Auto validação recusada.'])->assertForbidden();$this->approve($b);
$c=$this->send('comparisons',$this->comparison($b))->assertOk()->json('id');$s=$this->snapshot($c);
foreach(['material'=>'100','labour'=>'-100','allocated'=>'0'] as $k=>$v)$this->assertSame($v,$s['rows'][$k]['delta']);$this->assertSame('100/9',$s['rows']['material']['percent']);$this->assertSame('-50/3',$s['rows']['labour']['percent']);$this->assertSame('0',$s['total_delta']);$this->assertTrue($s['balanced']);$this->assertSame('300',$s['residual_separate']);$this->assertSame('2100',$s['actual_reconciliation']['known_origins_exact']);
foreach($before as $t=>$n)$this->assertSame($n,DB::table($t)->count());$this->login('reader');$this->getJson('/api/industrial-budgets')->assertOk()->assertJsonPath('lots.0.comparisons.0.current',true);$this->send('proposals',$this->proposal())->assertForbidden();$this->send('comparisons',$this->comparison($b))->assertForbidden();
}
public function test_equal_above_below_zero_unknown_and_nonfinite_percentages(): void {
$r=['material'=>'1000','labour'=>'500','allocated'=>'300'];
foreach([[['1000','500','300'],'0','0'],[['900','450','270'],'180','100/9'],[['1100','550','330'],'-180','-100/11'],[['0','500','300'],'1000','125'],[['0','0','0'],'1800',null]] as [$p,$delta,$pct]){$s=IndustrialBudgets::variance(array_combine(array_keys($r),$p),$r);$this->assertSame($delta,$s['total_delta']);$this->assertSame($pct,$s['total_percent']);$this->assertTrue($s['balanced']);}
$s=IndustrialBudgets::variance(['material'=>'0','labour'=>'0','allocated'=>'0'],['material'=>'0','labour'=>'0','allocated'=>'0']);$this->assertSame('0',$s['total_delta']);$this->assertSame('zero_base',$s['total_percent_state']);
$s=IndustrialBudgets::variance(['material'=>null,'labour'=>'600','allocated'=>'300'],$r);$this->assertNull($s['rows']['material']['delta']);$this->assertNull($s['total_delta']);$this->assertSame('-100',$s['paired_delta']);$this->assertSame('unknown',$s['total_percent_state']);
}
public function test_missing_material_is_incomplete_and_old_comparison_becomes_historical(): void {
$b=$this->send('proposals',$this->proposal())->assertOk()->json('id');$this->approve($b);$c=$this->send('comparisons',$this->comparison($b))->assertOk()->json('id');$old=DB::table('ib_comparisons')->find($c)->snapshot;
$refs=$this->f['refs'];$refs['material_rate']=null;app(CompanyContext::class)->selectFor($this->f['manager']->id,$this->f['tenant'],$this->f['company'],$this->f['unit']);$r=app(IndustrialCosts::class)->calculate($this->f['lot'],$this->f['manager']->id,['version'=>2,'previous_id'=>$this->f['result'],'currency'=>'MZN','refs'=>$refs],(string)Str::uuid())['id'];
app(CompanyContext::class)->selectFor($this->f['reader']->id,$this->f['tenant'],$this->f['company'],$this->f['unit']);app(IndustrialCosts::class)->decide($this->f['lot'],$this->f['reader']->id,['type'=>'result','id'=>$r,'version'=>2,'decision'=>'approved','reason'=>'Só perímetro conhecido.'],(string)Str::uuid());$this->login();
$this->getJson('/api/industrial-budgets')->assertOk()->assertJsonPath('lots.0.comparisons.0.current',false);$this->send('comparisons',$this->comparison($b,['version'=>2,'previous_id'=>$c]))->assertStatus(409);
$p=$this->send('comparisons',$this->comparison($b,['version'=>2,'previous_id'=>$c,'result_id'=>$r,'result_version'=>2]))->assertOk()->json('id');$s=$this->snapshot($p);$this->assertTrue($s['incomplete']);$this->assertNull($s['total_delta']);$this->assertNull($s['rows']['material']['delta']);$this->assertSame('800',$s['actual_known']);$this->assertSame('-100',$s['paired_delta']);$this->assertSame($old,DB::table('ib_comparisons')->find($c)->snapshot);
}
public function test_versions_refusal_dimensions_and_old_approval_not_transferred(): void {
$b=$this->send('proposals',$this->proposal())->assertOk()->json('id');$this->approve($b);$c=$this->send('comparisons',$this->comparison($b))->assertOk()->json('id');$old=DB::table('ib_budgets')->find($b)->amounts;
foreach(['product_id'=>999,'lot_id'=>999,'tenant_id'=>999,'company_id'=>999,'unit_id'=>999,'quantity'=>'12','unit'=>'KG','currency'=>'USD','period_start'=>'2026-09-01','period_end'=>'2026-11-01','scope'=>'all_origins'] as $k=>$v){$d=$this->proposal(['version'=>2,'previous_id'=>$b]);$d['dimensions'][$k]=$v;$this->send('proposals',$d)->assertStatus(409);}
$next=$this->send('proposals',$this->proposal(['version'=>2,'previous_id'=>$b,'amounts'=>['material'=>'1000','labour'=>'500','allocated'=>'300'],'evidence'=>'Révision après constat, original préservé.']))->assertOk()->json('id');
$this->send('comparisons',$this->comparison($next,['version'=>2,'previous_id'=>$c,'budget_version'=>2]))->assertStatus(409);$this->send('comparisons',$this->comparison($b,['version'=>2,'previous_id'=>$c]))->assertStatus(409);$this->getJson('/api/industrial-budgets')->assertOk()->assertJsonPath('lots.0.comparisons.0.current',false);$this->assertSame($old,DB::table('ib_budgets')->find($b)->amounts);
$this->login('reader');$this->send('decisions',['id'=>$next,'version'=>1,'decision'=>'approved','reason'=>'Wrong version'])->assertStatus(409);$this->send('decisions',['id'=>$next,'version'=>2,'decision'=>'refused','reason'=>'Refus explicite.'])->assertOk();$this->login();$this->send('comparisons',$this->comparison($next,['version'=>2,'previous_id'=>$c,'budget_version'=>2]))->assertStatus(409);
}
public function test_replay_content_conflict_rollback_and_recovery(): void {
$d=$this->proposal();$key=(string)Str::uuid();$id=$this->send('proposals',$d,$key)->assertOk()->json('id');$this->send('proposals',array_reverse($d,true),$key)->assertOk()->assertJsonPath('id',$id)->assertJsonPath('replayed',true);$this->send('proposals',array_replace($d,['evidence'=>'Other content']),$key)->assertStatus(409);
$this->approve($id);$input=$this->comparison($id);$key=(string)Str::uuid();DB::unprepared("CREATE OR REPLACE FUNCTION sgf_ib_fail() RETURNS trigger LANGUAGE plpgsql AS \$\$ BEGIN RAISE EXCEPTION 'IB_OUTBOX_FAIL'; END; \$\$; CREATE TRIGGER ib_fail BEFORE INSERT ON ib_outbox FOR EACH ROW EXECUTE FUNCTION sgf_ib_fail()");
$n=DB::table('identity_audit')->count();$this->send('comparisons',$input,$key)->assertStatus(500);$this->assertSame(0,DB::table('ib_comparisons')->count());$this->assertSame($n,DB::table('identity_audit')->count());DB::unprepared('DROP TRIGGER ib_fail ON ib_outbox');$c=$this->send('comparisons',$input,$key)->assertOk()->json('id');$this->send('comparisons',$input,$key)->assertOk()->assertJsonPath('id',$c)->assertJsonPath('replayed',true);$this->assertSame(1,DB::table('ib_comparisons')->count());
}
public function test_isolation_revocation_next_request_and_no_inherited_permissions(): void {
$this->send('proposals',$this->proposal(),null,999999)->assertForbidden();$b=$this->send('proposals',$this->proposal())->assertOk()->json('id');
DB::table('permission_grants')->where(['user_id'=>$this->f['manager']->id,'permission'=>'industrial_budgets.prepare'])->delete();$this->send('proposals',$this->proposal())->assertForbidden();
$this->login('reader');DB::table('permission_grants')->where(['user_id'=>$this->f['reader']->id,'permission'=>'industrial_budgets.validate'])->delete();$this->send('decisions',['id'=>$b,'version'=>1,'decision'=>'approved','reason'=>'Revoked'])->assertForbidden();
DB::table('permission_grants')->where(['user_id'=>$this->f['reader']->id,'permission'=>'industrial_budgets.view'])->delete();$this->getJson('/api/industrial-budgets')->assertForbidden();
}
public function test_sql_immutability_and_normal_environment_guard(): void {
$b=$this->send('proposals',$this->proposal())->assertOk()->json('id');foreach(['UPDATE ib_budgets SET evidence=\'changed\' WHERE id='.$b,'DELETE FROM ib_budgets WHERE id='.$b] as $sql){try{DB::transaction(fn()=>DB::unprepared($sql));$this->fail('SQL immutable guard absent');}catch(\Illuminate\Database\QueryException $e){$this->assertNotEmpty($e->getMessage());}}
$this->app->detectEnvironment(fn()=>'local');
try{IndustrialBudgets::guard();$this->fail('Real costing allowed');}catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface $e){$this->assertSame(403,$e->getStatusCode());}
app(CompanyContext::class)->selectFor($this->f['manager']->id,$this->f['tenant'],$this->f['company'],$this->f['unit']);$this->assertTrue(app(IndustrialBudgets::class)->listing($this->f['manager']->id)['blocked']);
}
public function test_source_change_wrong_quantity_and_comparison_permission_revocation(): void {
$b=$this->send('proposals',$this->proposal())->assertOk()->json('id');$this->approve($b);$key=(string)Str::uuid();$input=$this->comparison($b);$this->send('comparisons',$input,$key)->assertOk();
DB::table('permission_grants')->where(['user_id'=>$this->f['manager']->id,'permission'=>'industrial_budget_comparisons.prepare'])->delete();$this->send('comparisons',$input,$key)->assertForbidden();IdentityFixture::grant($this->f['manager']->id,$this->f['tenant'],$this->f['company'],'industrial_budget_comparisons.prepare',$this->f['unit']);
DB::table('permission_grants')->where(['user_id'=>$this->f['manager']->id,'permission'=>'industrial_budget_comparisons.view'])->delete();$this->send('comparisons',$input,$key)->assertForbidden();$this->getJson('/api/industrial-budgets')->assertOk()->assertJsonCount(0,'lots.0.comparisons');IdentityFixture::grant($this->f['manager']->id,$this->f['tenant'],$this->f['company'],'industrial_budget_comparisons.view',$this->f['unit']);
app(CompanyContext::class)->selectFor($this->f['manager']->id,$this->f['tenant'],$this->f['company'],$this->f['unit']);$cost=app(IndustrialCosts::class);$old=DB::table('ic_inputs')->find($this->f['refs']['production']['id']);$data=json_decode($old->data,true);$data['quantity']='12';$p=$cost->input($this->f['lot'],$this->f['manager']->id,['kind'=>'production','source_ref'=>$old->source_ref,'version'=>2,'previous_id'=>$old->id,'data'=>$data,'evidence'=>'Different quantity, no normalization.'],(string)Str::uuid())['id'];
$this->getJson('/api/industrial-budgets')->assertOk()->assertJsonPath('lots.0.comparisons.0.current',false);
app(CompanyContext::class)->selectFor($this->f['reader']->id,$this->f['tenant'],$this->f['company'],$this->f['unit']);$cost->decide($this->f['lot'],$this->f['reader']->id,['type'=>'input','id'=>$p,'version'=>2,'decision'=>'approved','reason'=>'Synthetic quantity revision.'],(string)Str::uuid());
app(CompanyContext::class)->selectFor($this->f['manager']->id,$this->f['tenant'],$this->f['company'],$this->f['unit']);$refs=$this->f['refs'];$refs['production']=['id'=>$p,'version'=>2];$r=$cost->calculate($this->f['lot'],$this->f['manager']->id,['version'=>2,'previous_id'=>$this->f['result'],'currency'=>'MZN','refs'=>$refs],(string)Str::uuid())['id'];
app(CompanyContext::class)->selectFor($this->f['reader']->id,$this->f['tenant'],$this->f['company'],$this->f['unit']);$cost->decide($this->f['lot'],$this->f['reader']->id,['type'=>'result','id'=>$r,'version'=>2,'decision'=>'approved','reason'=>'12 units validated only for source result.'],(string)Str::uuid());$this->login();$this->send('comparisons',$this->comparison($b,['version'=>2,'previous_id'=>DB::table('ib_comparisons')->value('id'),'result_id'=>$r,'result_version'=>2]))->assertStatus(409);
}
public function test_other_company_unit_context_and_invalid_amounts_are_refused(): void {
foreach([-1,0,'-1','1e3','1.000000001','10000000000000000'] as $v){$d=$this->proposal();$d['amounts']['material']=$v;$this->send('proposals',$d)->assertStatus(422);}
$oldToken=$this->token;$this->postJson('/api/context',['tenant_id'=>$this->f['tenant'],'company_id'=>$this->f['sibling'],'unit_id'=>$this->f['siblingUnit']])->assertOk();$this->send('proposals',$this->proposal())->assertStatus(409);$this->login();
DB::table('permission_grants')->where(['user_id'=>$this->f['manager']->id,'permission'=>'industrial_budgets.view'])->delete();$this->getJson('/api/industrial-budgets')->assertForbidden();
foreach(['industrial_costs.view','industrial_budgets.view','industrial_budgets.prepare'] as $p)IdentityFixture::grant($this->f['manager']->id,$this->f['tenant'],$this->f['sibling'],$p,$this->f['siblingUnit']);
app(CompanyContext::class)->selectFor($this->f['manager']->id,$this->f['tenant'],$this->f['sibling'],$this->f['siblingUnit']);
try{app(IndustrialBudgets::class)->propose($this->f['lot'],$this->f['manager']->id,$this->proposal(),(string)Str::uuid());$this->fail('Cross company lot allowed');}catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface $e){$this->assertSame(403,$e->getStatusCode());}
}
}
+45
View File
@@ -0,0 +1,45 @@
<?php
namespace Tests\Feature;
use App\Modules\Workshop\WorkshopBilling;
use App\Modules\Services\ServiceWorkflow;
use App\Shared\Context\CompanyContext;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Str;
use Tests\Support\{DirectCostFixture,IdentityFixture};
use Tests\TestCase;
final class WorkshopBillingTest extends TestCase {
use RefreshDatabase;
private array $f;private int $service;private string $token;
protected function setUp(): void {parent::setUp();$this->f=DirectCostFixture::create();foreach(['manager'=>['view','prepare','generate'],'reader'=>['view','review']] as $who=>$rights){foreach($rights as $r)IdentityFixture::grant($this->f[$who]->id,$this->f['tenant'],$this->f['company'],'workshop_billing.'.$r,$this->f['unit']);IdentityFixture::grant($this->f[$who]->id,$this->f['tenant'],$this->f['company'],'workshop.view',$this->f['unit']);}$this->service=app(ServiceWorkflow::class)->save('services',null,$this->f['manager']->id,['name'=>'Serviço comercial sintético'],(string)Str::uuid())['id'];$this->login();}
private function login(string $who='manager'): void {$this->postJson('/api/login',['email'=>$this->f[$who]->email,'password'=>$this->f['password']])->assertOk();$this->token=$this->postJson('/api/context',['tenant_id'=>$this->f['tenant'],'company_id'=>$this->f['company'],'unit_id'=>$this->f['unit']])->assertOk()->json('context.token');}
private function send(string $action,array $in,?string $key=null){return $this->withHeaders(['X-SGF-Context'=>$this->token,'Idempotency-Key'=>$key??(string)Str::uuid()])->postJson('/api/workshop-billing/orders/'.$this->f['order'].'/'.$action,$in);}
private function input(): array {return ['version'=>1,'previous_id'=>null,'client_id'=>$this->f['client'],'currency'=>'MZN','evidence'=>'Tarifas sintéticas revistas, não custos internos.','lines'=>array_map(fn($id,$price)=>['entry_id'=>$id,'entry_version'=>1,'service_id'=>$this->service,'service_version'=>1,'price'=>$price,'price_source'=>'WORKSHOP-SALES-SYNTHETIC-v1'],[$this->f['time'],$this->f['material']],['200','75'])];}
private function approve(int $id): void {$this->login('reader');$this->send('reviews',['id'=>$id,'version'=>1,'decision'=>'approved','reason'=>'Versão comercial exacta conferida.'])->assertOk();$this->login();}
public function test_exact_500_generation_distinct_review_history_and_replay(): void {
$count=DB::table('wo_entries')->count();$d=$this->input();$key=(string)Str::uuid();$p=$this->send('proposals',$d,$key)->assertOk()->json('id');$this->send('proposals',$d,$key)->assertOk()->assertJsonPath('id',$p)->assertJsonPath('replayed',true);
$this->send('generations',['id'=>$p,'version'=>1])->assertStatus(409);$this->approve($p);$key=(string)Str::uuid();$g=$this->send('generations',['id'=>$p,'version'=>1],$key)->assertOk()->assertJsonPath('base_exact','500');$this->send('generations',['id'=>$p,'version'=>1],$key)->assertOk()->assertJsonPath('id',$g->json('id'))->assertJsonPath('replayed',true);
$bill=DB::table('a_billing_drafts')->find($g->json('billing_draft_id'));$data=json_decode($bill->data,true);$this->assertSame('MZN',$data['currency']);$this->assertSame('1.75',$data['lines'][0]['quantity']);$this->assertSame('200',$data['lines'][0]['unit_price']);$this->assertSame('2',$data['lines'][1]['quantity']);$this->assertSame('75',$data['lines'][1]['unit_price']);$this->assertSame(2,DB::table('wb_claims')->count());$this->assertSame($count,DB::table('wo_entries')->count());$this->assertSame(0,DB::table('b_internal_confirmations')->count());$this->assertSame('draft',$bill->state);$this->getJson('/api/workshop-billing')->assertOk()->assertJsonPath('orders.0.proposals.0.current',true);
$this->send('generations',['id'=>$p,'version'=>1])->assertStatus(409);try{DB::transaction(fn()=>DB::table('a_billing_drafts')->where('id',$bill->id)->update(['name'=>'Bypass','version'=>$bill->version+1]));$this->fail('Linked draft editable');}catch(\Illuminate\Database\QueryException $e){$this->assertStringContainsString('SGF_WB_LINKED_DRAFT',$e->getMessage());}
app(CompanyContext::class)->selectFor($this->f['manager']->id,$this->f['tenant'],$this->f['company'],$this->f['unit']);
try{app(ServiceWorkflow::class)->save('billing_drafts',null,$this->f['manager']->id,['source_id'=>$g->json('service_draft_id')],(string)Str::uuid());$this->fail('Second billing through ordinary workflow');}catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface $e){$this->assertSame(409,$e->getStatusCode());}
}
public function test_identity_permissions_revocation_and_unknown_price(): void {
$d=$this->input();$d['lines'][0]['price']='';$this->send('proposals',$d)->assertStatus(422);$d=$this->input();$d['lines'][]=$d['lines'][0];$this->send('proposals',$d)->assertStatus(409);
$p=$this->send('proposals',$this->input())->assertOk()->json('id');IdentityFixture::grant($this->f['manager']->id,$this->f['tenant'],$this->f['company'],'workshop_billing.review',$this->f['unit']);$this->send('reviews',['id'=>$p,'version'=>1,'decision'=>'approved','reason'=>'Auto review'])->assertForbidden();$this->login('reader');$this->send('generations',['id'=>$p,'version'=>1])->assertForbidden();$this->send('proposals',$this->input())->assertForbidden();DB::table('permission_grants')->where(['user_id'=>$this->f['reader']->id,'permission'=>'workshop_billing.review'])->delete();$this->send('reviews',['id'=>$p,'version'=>1,'decision'=>'approved','reason'=>'Revoked review'])->assertForbidden();
}
public function test_material_delivery_wrong_client_service_and_version_refused(): void {
$d=$this->input();$d['client_id']=999;$this->send('proposals',$d)->assertStatus(409);$d=$this->input();$d['lines'][0]['service_version']=2;$this->send('proposals',$d)->assertStatus(409);$d=$this->input();$delivered=DB::table('wo_entries')->where(['order_id'=>$this->f['order'],'kind'=>'material'])->whereRaw("data->>'event'='delivered'")->first();$d['lines'][1]['entry_id']=$delivered->id;$this->send('proposals',$d)->assertStatus(422);
}
public function test_rollback_outbox_preserves_no_orphan_drafts_and_recovery(): void {
$p=$this->send('proposals',$this->input())->assertOk()->json('id');$this->approve($p);$n=DB::table('a_billing_drafts')->count();$s=DB::table('a_service_drafts')->count();DB::unprepared("CREATE OR REPLACE FUNCTION sgf_wb_fail() RETURNS trigger LANGUAGE plpgsql AS \$\$ BEGIN RAISE EXCEPTION 'WB_OUTBOX_FAIL'; END; \$\$; CREATE TRIGGER wb_fail BEFORE INSERT ON wb_outbox FOR EACH ROW EXECUTE FUNCTION sgf_wb_fail()");$key=(string)Str::uuid();$this->send('generations',['id'=>$p,'version'=>1],$key)->assertStatus(500);$this->assertSame($n,DB::table('a_billing_drafts')->count());$this->assertSame($s,DB::table('a_service_drafts')->count());$this->assertSame(0,DB::table('wb_claims')->count());DB::unprepared('DROP TRIGGER wb_fail ON wb_outbox');$this->send('generations',['id'=>$p,'version'=>1],$key)->assertOk();
}
public function test_successor_requires_fresh_review_and_changed_catalogue_invalidates(): void {
$p=$this->send('proposals',$this->input())->assertOk()->json('id');$this->approve($p);$d=$this->input();$d['version']=2;$d['previous_id']=$p;$d['lines'][0]['price']='210';$next=$this->send('proposals',$d)->assertOk()->json('id');$this->send('generations',['id'=>$p,'version'=>1])->assertStatus(409);$this->send('generations',['id'=>$next,'version'=>2])->assertStatus(409);
$this->login('reader');$this->send('reviews',['id'=>$next,'version'=>2,'decision'=>'approved','reason'=>'Nova revisão comercial.'])->assertOk();$this->login();app(CompanyContext::class)->selectFor($this->f['manager']->id,$this->f['tenant'],$this->f['company'],$this->f['unit']);app(ServiceWorkflow::class)->save('services',$this->service,$this->f['manager']->id,['version'=>1,'name'=>'Serviço corrigido'],(string)Str::uuid());$this->send('generations',['id'=>$next,'version'=>2])->assertStatus(409);$this->getJson('/api/workshop-billing')->assertOk()->assertJsonPath('orders.0.proposals.1.current',false);$this->assertSame(0,DB::table('wb_generations')->count());
}
public function test_generation_replay_rechecks_destination_creation_right_and_real_guard(): void {
$p=$this->send('proposals',$this->input())->assertOk()->json('id');$this->approve($p);$key=(string)Str::uuid();$this->send('generations',['id'=>$p,'version'=>1],$key)->assertOk();DB::table('permission_grants')->where(['user_id'=>$this->f['manager']->id,'permission'=>'billing_drafts.create'])->delete();$this->send('generations',['id'=>$p,'version'=>1],$key)->assertForbidden();
$this->app->detectEnvironment(fn()=>'local');try{WorkshopBilling::guard();$this->fail('Real conversion allowed');}catch(\Symfony\Component\HttpKernel\Exception\HttpExceptionInterface $e){$this->assertSame(403,$e->getStatusCode());}
}
}
+14
View File
@@ -0,0 +1,14 @@
<?php
namespace Tests\Support;
use App\Modules\Industry\{IndustrialCosts,IndustrialBudgets};
use App\Shared\Context\CompanyContext;
use Illuminate\Support\Str;
final class IndustrialBudgetFixture {
public static function create(?array $base=null): array {
$f=IndustrialCostFixture::create($base);
foreach(['manager'=>['industrial_budgets.view','industrial_budgets.prepare','industrial_budget_comparisons.view','industrial_budget_comparisons.prepare'],'reader'=>['industrial_budgets.view','industrial_budgets.validate','industrial_budget_comparisons.view']] as $who=>$rights)foreach($rights as $p)IdentityFixture::grant($f[$who]->id,$f['tenant'],$f['company'],$p,$f['unit']);
$c=app(IndustrialCosts::class);$result=$c->calculate($f['lot'],$f['manager']->id,['version'=>1,'previous_id'=>null,'currency'=>'MZN','refs'=>$f['refs']],(string)Str::uuid())['id'];
app(CompanyContext::class)->selectFor($f['reader']->id,$f['tenant'],$f['company'],$f['unit']);$c->decide($f['lot'],$f['reader']->id,['type'=>'result','id'=>$result,'version'=>1,'decision'=>'approved','reason'=>'Resultado sintético exacto conferido.'],(string)Str::uuid());
app(CompanyContext::class)->selectFor($f['manager']->id,$f['tenant'],$f['company'],$f['unit']);return $f+compact('result');
}
}
+13
View File
@@ -0,0 +1,13 @@
<?php
namespace Tests\Support;
use App\Modules\Workshop\WorkshopBilling;
use App\Modules\Services\ServiceWorkflow;
use Illuminate\Support\Str;
final class WorkshopBillingFixture {
public static function create(?array $base=null): array {
WorkshopBilling::guard();$f=DirectCostFixture::create($base);
foreach(['manager'=>['view','prepare','generate'],'reader'=>['view','review']] as $who=>$rights){foreach($rights as $right)IdentityFixture::grant($f[$who]->id,$f['tenant'],$f['company'],'workshop_billing.'.$right,$f['unit']);IdentityFixture::grant($f[$who]->id,$f['tenant'],$f['company'],'workshop.view',$f['unit']);}
$service=app(ServiceWorkflow::class)->save('services',null,$f['manager']->id,['name'=>'Serviço comercial exclusivamente sintético'],(string)Str::uuid())['id'];return $f+compact('service');
}
public static function proposal(array $f): array {return ['version'=>1,'previous_id'=>null,'client_id'=>$f['client'],'currency'=>'MZN','evidence'=>'WORKSHOP-SALES-SYNTHETIC-v1: 200/H e 75/UN, revisão comercial distinta.','lines'=>array_map(fn($id,$price)=>['entry_id'=>$id,'entry_version'=>1,'service_id'=>$f['service'],'service_version'=>1,'price'=>$price,'price_source'=>'WORKSHOP-SALES-SYNTHETIC-v1'],[$f['time'],$f['material']],['200','75'])];}
}