checkHost();$facts=$this->facts($lineId,false); return ['source_hash'=>$this->hash($facts),'receipt_item_id'=>$lineId,'accepted_milli'=>(string)$facts['accepted_milli'], 'stock_item_id'=>(int)$facts['stock_item_id'],'warehouse_id'=>(int)$facts['warehouse_id']]; } public function write(int $lineId, string $expectedHash): array { $this->checkHost();$facts=$this->facts($lineId,true);$hash=$this->hash($facts); abort_unless(hash_equals($hash,$expectedHash),409,'A origem da recepção mudou. Faça nova conferência.'); $existing=$this->db->table($this->schema.'.stock_movements')->where(['tenant_id'=>$this->tenant,'goods_receipt_item_id'=>$lineId])->first(); $stockQuantity=$this->stockQuantity($facts); if($existing){ $snapshot=json_decode($existing->snapshot,true,512,JSON_THROW_ON_ERROR); abort_unless(($snapshot['inventory_source_hash']??null)===$hash && (string)$existing->quantity_milli===$stockQuantity && (int)$existing->stock_item_id===(int)$facts['stock_item_id'] && (int)$existing->warehouse_id===(int)$facts['warehouse_id'],409,'A origem já tem movimento incompatível ou histórico não reconciliado.'); return ['movement_id'=>(int)$existing->id,'source_hash'=>$hash,'replayed'=>true]; } $lineSnapshot=json_decode($facts['line_snapshot'],true,512,JSON_THROW_ON_ERROR); $receiptSnapshot=json_decode($facts['receipt_snapshot'],true,512,JSON_THROW_ON_ERROR); $snapshot=[...$lineSnapshot,'receipt_id'=>(int)$facts['receipt_id'],'order_number'=>$receiptSnapshot['order']['number']??null, 'delivery_note'=>$facts['delivery_note'],'reference'=>$facts['delivery_note'],'inventory_source_hash'=>$hash]; $id=$this->db->table($this->schema.'.stock_movements')->insertGetId([ 'tenant_id'=>$this->tenant,'goods_receipt_item_id'=>$lineId,'stock_item_id'=>$facts['stock_item_id'],'warehouse_id'=>$facts['warehouse_id'], 'moved_by'=>$this->actor,'quantity_milli'=>$stockQuantity,'movement_type'=>'receipt_in','moved_at'=>now(), 'equipment_id'=>$lineSnapshot['equipment_id']??null,'spare_part_id'=>$lineSnapshot['spare_part_id']??null, 'snapshot'=>json_encode($snapshot,JSON_THROW_ON_ERROR), ]); return ['movement_id'=>(int)$id,'source_hash'=>$hash,'replayed'=>false]; } /** Legacy facts/hash are unchanged. Converted facts carry their entire frozen basis in line_snapshot. */ private function stockQuantity(array $facts): string { $snapshot=json_decode($facts['line_snapshot'],true,512,JSON_THROW_ON_ERROR); if(!array_key_exists('quantity_conversion',$snapshot))return (string)$facts['accepted_milli']; $basis=$snapshot['quantity_conversion']; abort_unless(is_array($basis) && ($basis['schema']??null)==='inventory.quantity.v1' && ($basis['stock_item_id']??null)===(int)$facts['stock_item_id'] && ($basis['document_unit']??null)===($snapshot['order_item']['unit']??null) && ($basis['stock_unit']??null)===($snapshot['stock_item']['unit']??null) && is_string($basis['numerator']??null) && is_string($basis['denominator']??null) && is_string($basis['source']??null) && trim($basis['source'])!=='' && is_string($basis['version']??null) && trim($basis['version'])!=='',409,'Base de conversão incompleta ou incompatível.'); $converted=QuantityConversion::toBase((string)$facts['accepted_milli'],$basis['numerator'],$basis['denominator']); abort_unless(($basis['accepted_document_milli']??null)===(string)$facts['accepted_milli'] && ($basis['accepted_stock_milli']??null)===$converted,409,'Quantidade física divergente da conversão congelada.'); return $converted; } private function checkHost(): void { if($this->db->transactionLevel()<1)throw new \LogicException('Receipt movement requires the host atomic transaction'); ($this->authorize)(); } private function facts(int $lineId,bool $lock): array { $q=$this->db->table($this->schema.'.goods_receipt_items AS l') ->join($this->schema.'.goods_receipts AS r',fn($j)=>$j->on('r.id','=','l.goods_receipt_id')->on('r.tenant_id','=','l.tenant_id')) ->where('l.tenant_id',$this->tenant)->where('l.id',$lineId) ->select(['l.id','l.tenant_id','l.stock_item_id','l.received_milli','l.accepted_milli','l.rejected_milli','l.quality_status','l.notes', 'l.snapshot AS line_snapshot','r.id AS receipt_id','r.purchase_order_id','r.received_by','r.warehouse_id','r.delivery_note','r.received_on','r.confirmed_at','r.snapshot AS receipt_snapshot']); if($lock)$q->lockForUpdate(); $row=$q->first();abort_unless($row,403,'Origem fora do âmbito autorizado.');$facts=(array)$row; $snapshot=json_decode($facts['line_snapshot'],true,512,JSON_THROW_ON_ERROR); abort_unless((int)$facts['received_by']===$this->actor,403,'A origem não pertence ao recebedor desta confirmação.'); abort_unless($facts['confirmed_at']!==null && ($snapshot['physical']??false)===true && (int)$facts['accepted_milli']>0 && $facts['stock_item_id']!==null && $facts['warehouse_id']!==null,409,'A origem não comprova quantidade física aceite.'); return $facts; } private function hash(array $facts): string { // Parent status/number are intentionally absent: finalisation occurs later in the same transaction. return hash('sha256',json_encode($facts,JSON_THROW_ON_ERROR)); } }