oportunidades 7
tests / ci (push) Waiting to run

This commit is contained in:
2026-10-13 11:40:29 +02:00
parent 20971d523f
commit 287e991486
2902 changed files with 1085456 additions and 25957 deletions
+99 -11
View File
@@ -22,7 +22,7 @@ class OpportunityProfileWorkflow
}
$actions = [];
$state = $this->access->state($record);
if ($this->access->scoped($actor, 'promoter', $record->organization_id, $record->opportunity_category)
if ($this->access->promoterRecordScope($actor, $record)
&& ($record->organization_id !== null || (int) $record->owner_user_id === $actor->id)
&& $this->access->operational($actor, 'edit', $record->id)) {
if (in_array($state, ['draft', 'needs_information'], true)) {
@@ -40,6 +40,9 @@ class OpportunityProfileWorkflow
}
if ($this->access->mfa($actor) && ! $this->access->conflict($actor, $record)) {
if ($this->access->scoped($actor, 'validator', $record->organization_id, $record->opportunity_category) && $this->access->operational($actor, 'validate', $record->id)) {
if ($state === 'approved' && count(array_filter($record->workflow_context['conditions'] ?? [], fn ($condition) => $condition['status'] === 'open' && $condition['blocking_action'] === 'publish')) > 0) {
$actions[] = 'review_gate';
}
if ($state === 'submitted') {
$actions[] = 'start_review';
}
@@ -93,10 +96,14 @@ class OpportunityProfileWorkflow
{
$this->access->authorize($actor, 'view', $record);
if (! $this->access->has($actor, 'validator') && ! $this->access->has($actor, 'publisher')) {
return ['validators' => [], 'publishers' => []];
return ['validators' => [], 'publishers' => [], 'condition_responsibles' => []];
}
$result = ['validators' => [], 'publishers' => []];
$result = ['validators' => [], 'publishers' => [], 'condition_responsibles' => []];
foreach (User::whereNotNull('email_verified_at')->whereNotNull('two_factor_confirmed_at')->get() as $candidate) {
if ($this->access->canView($candidate, $record) && (($this->access->promoterRecordScope($candidate, $record) && $this->access->operational($candidate, 'edit', $record->id))
|| ($this->access->scoped($candidate, 'validator', $record->organization_id, $record->opportunity_category) && $this->access->operational($candidate, 'validate', $record->id)))) {
$result['condition_responsibles'][] = ['id' => $candidate->id, 'name' => $candidate->name];
}
if ($this->access->conflict($candidate, $record)) {
continue;
}
@@ -138,8 +145,17 @@ class OpportunityProfileWorkflow
'opinion_id' => 'sometimes|uuid', 'recipient_user_id' => 'sometimes|integer|min:1',
'evidence_document_ids' => 'sometimes|array', 'evidence_document_ids.*' => 'uuid', 'due_at' => 'prohibited',
'confirm_publication' => 'sometimes|boolean', 'preview_hash' => 'sometimes|string|size:64',
'condition' => 'sometimes|array:description,responsible_user_id,due_on,blocking_action',
'condition.description' => 'required_with:condition|string|min:10|max:1000',
'condition.responsible_user_id' => 'required_with:condition|integer|min:1',
'condition.due_on' => 'sometimes|nullable|date_format:Y-m-d',
'condition.blocking_action' => 'required_with:condition|in:approve,publish',
'resolve_condition_ids' => 'sometimes|array', 'resolve_condition_ids.*' => 'uuid|distinct',
])->validate();
$action = $data['action'];
if ($action !== 'review_gate' && (isset($data['condition']) || ! empty($data['resolve_condition_ids']))) {
throw ValidationException::withMessages(['condition' => 'Condições só podem ser verificadas numa revisão especializada autorizada.']);
}
$this->authorizeAction($actor, $record, $action);
return DB::transaction(function () use ($actor, $id, $data, $action) {
@@ -151,7 +167,8 @@ class OpportunityProfileWorkflow
$before = ['status' => $state, 'publication_status' => $record->status, 'version' => $record->management_version];
$from = match ($action) {
'submit' => ['draft', 'needs_information'], 'start_review' => ['submitted'],
'request_correction', 'pending_opinion', 'respond_opinion', 'reject', 'approve', 'review_gate', 'assign_review' => ['submitted', 'in_review', 'information_pending'],
'request_correction', 'pending_opinion', 'respond_opinion', 'reject', 'approve', 'assign_review' => ['submitted', 'in_review', 'information_pending'],
'review_gate' => ['submitted', 'in_review', 'information_pending', 'approved'],
'publish' => ['approved'], 'suspend' => [$state],
'assign_publication' => ['approved'],
'request_revision' => ['approved', 'published', 'suspended'],
@@ -163,24 +180,52 @@ class OpportunityProfileWorkflow
abort_unless(in_array($state, $from, true), 409, 'Transição incompatível com o estado atual.');
$decision = ['actor_id' => $actor->id, 'action' => $action, 'reason' => $data['reason'], 'at' => now()->toIso8601String(),
'content_revision' => $context['content_revision'] ?? 1];
if (isset($context['review_cycle'])) {
$decision['review_cycle'] = $context['review_cycle'];
}
$next = $state;
$snapshot = [];
if ($action === 'submit' && $record->opportunity_category === 'land_rights') {
// Serialize the existing JSON-backed §27 uniqueness check across records.
DB::select('SELECT pg_advisory_xact_lock(111026,270000)');
}
if (in_array($action, ['submit', 'review_gate', 'pending_opinion', 'respond_opinion', 'approve', 'publish'], true)) {
$snapshot = $this->contract->validateSubmission($record);
$blockers = $this->contract->deliveryBlockers($this->management->values($record)['canonical'] ?? []);
try {
$snapshot = $this->contract->validateSubmission($record);
} catch (ValidationException $error) {
$errors = $error->errors();
foreach ($blockers as $field => $message) {
$errors[$field][] = $message;
}
throw ValidationException::withMessages($errors);
}
if ($blockers !== []) {
throw ValidationException::withMessages($blockers);
}
if ($action !== 'submit') {
abort_unless(hash_equals($context['submission']['hash'] ?? '', $snapshot['hash']), 409, 'Conteúdo ou recursos mudaram desde a submissão. Exige nova submissão/revisão.');
}
}
if ($action === 'submit') {
// New review attempt, even when the canonical content is unchanged.
// Historical decisions/tasks and the content revision keep their IDs.
$context['review_cycle'] = max((int) ($context['review_cycle'] ?? 0), $this->submissionCount($context)) + 1;
$decision['review_cycle'] = $context['review_cycle'];
foreach ($context['opinions'] ?? [] as $opinionId => $opinion) {
if (($opinion['status'] ?? '') === 'pending') {
$context['opinions'][$opinionId]['status'] = 'superseded';
$this->tasks->complete($opinion['task_id'] ?? null, 'Nova versão submetida; parecer anterior preservado.');
}
}
$baseline = $context['review_baseline'] ?? $context['submission'] ?? [];
$materiality = app(OpportunityReviewMateriality::class)->reconcile($baseline, $snapshot, $context['reviews'] ?? [], $this->contract->gates($record), ! empty($context['force_review']));
$context['materiality'] = array_diff_key($materiality, ['reviews' => true]);
$context['reviews'] = $materiality['reviews'];
app(OpportunityReviewConditions::class)->reconcile($context, $snapshot, $materiality['reopened']);
$context['submission'] = [...$snapshot, ...$decision];
$context['sla'] = ['policy_version' => null, 'due_at' => null, 'status' => 'unconfigured'];
unset($context['approval'], $context['reviews'], $context['assignment'],$context['publication_assignment']);
unset($context['approval'], $context['assignment'], $context['publication_assignment'], $context['review_baseline'], $context['force_review']);
$record->first_submitted_at ??= now()->toIso8601String();
$record->management_closed_once = true;
$record->workflow_context = $context;
@@ -192,11 +237,25 @@ class OpportunityProfileWorkflow
abort_unless($this->access->scoped($subject, 'validator', $record->organization_id, $record->opportunity_category)
&& $this->access->operational($subject, 'validate', $record->id) && ! $this->access->conflict($subject, $record)
&& $subject->two_factor_confirmed_at !== null, 403, 'Responsável requer papel válido, MFA configurado e independência.');
if ($this->tasks->closedReviewBinding($record, $context['review_task_id'] ?? null)) {
// Recover only a completed task of this opportunity in an
// already submitted legacy attempt. Never reopen/delete it.
$oldTask = $context['review_task_id'];
$context['review_cycle'] = max(1, (int) ($context['review_cycle'] ?? 0), $this->submissionCount($context));
$record->workflow_context = $context;
$context['review_task_id'] = $this->tasks->ensure($record, 'opportunity_review', 'Validação da oportunidade '.$record->reference);
$context['review_task_binding_history'][] = ['previous_task_id' => $oldTask, 'task_id' => $context['review_task_id'],
'review_cycle' => $context['review_cycle'], 'at' => now()->toIso8601String(), 'reason' => 'Completed legacy review binding replaced for the current submission; original preserved.'];
$decision['review_cycle'] = $context['review_cycle'];
}
$context['review_task_id'] ??= $this->tasks->ensure($record, 'opportunity_review', 'Validação da oportunidade '.$record->reference);
$this->tasks->assign($record, $context['review_task_id'], $subject);
$context['assignment'] = [...$decision, 'assignee_user_id' => $subject->id];
$next = 'in_review';
} elseif ($action === 'review_gate') {
if ($state === 'approved') {
throw_unless(! empty($data['resolve_condition_ids']) && empty($data['condition']) && ($data['gate_decision'] ?? '') === 'approved', ValidationException::withMessages(['resolve_condition_ids' => 'Após aprovação, só verificar condições de publicação existentes; alterações exigem nova revisão.']));
}
$gate = $data['gate'] ?? '';
abort_unless(in_array($gate, $this->contract->gates($record), true), 422, 'Gate não aplicável.');
$legal = preg_match('/legal|registry|authority|confidentiality|license/', $gate) === 1;
@@ -204,14 +263,19 @@ class OpportunityProfileWorkflow
$documents = $data['evidence_document_ids'] ?? [];
abort_unless($documents !== [] && array_diff($documents, array_keys($snapshot['resources']['documents'] ?? [])) === [], 422, 'Selecione evidência documental desta versão.');
abort_unless(isset($data['gate_decision']), 422, 'Indique decisão fundamentada do gate.');
app(OpportunityReviewConditions::class)->review($record, $actor, $data, $snapshot, $context);
$context['reviews'][$gate] = [...$decision, 'decision' => $data['gate_decision'], 'hash' => $snapshot['hash'], 'evidence_document_ids' => $documents];
$context['reviews'][$gate]['scope_hash'] = app(OpportunityReviewMateriality::class)->hash($snapshot, $gate, $context['reviews'][$gate]);
$context['reviews'][$gate]['scope_rule'] = OpportunityReviewMateriality::VERSION;
$next = 'in_review';
} elseif ($action === 'approve') {
app(OpportunityReviewConditions::class)->authorize($context, $snapshot, 'approve');
abort_if(count(array_filter($context['opinions'] ?? [], fn ($o) => ($o['hash'] ?? '') === $snapshot['hash'] && ($o['status'] ?? '') === 'pending')) > 0, 422, 'Parecer da versão atual ainda pendente.');
abort_if(count(array_filter($context['opinions'] ?? [], fn ($o) => ($o['hash'] ?? '') === $snapshot['hash'] && ($o['response']['decision'] ?? '') === 'rejected')) > 0, 422, 'Parecer desfavorável exige correção e nova versão.');
foreach ($this->contract->gates($record) as $gate) {
$review = $context['reviews'][$gate] ?? [];
abort_unless(($review['decision'] ?? null) === 'approved' && ($review['hash'] ?? '') === $snapshot['hash'], 422, 'Gate '.$gate.' pendente, rejeitado ou de outra versão.');
abort_unless(($review['decision'] ?? null) === 'approved' && (($review['hash'] ?? '') === $snapshot['hash'] || ($review['accepted_submission_hash'] ?? '') === $snapshot['hash']), 422, 'Gate '.$gate.' pendente, rejeitado ou de outra versão.');
abort_unless(app(OpportunityReviewMateriality::class)->matches($snapshot, $gate, $review), 409, 'Âmbito da revisão alterado.');
$reviewer = User::whereKey($review['actor_id'])->firstOrFail();
abort_unless($this->access->scoped($reviewer, 'validator', $record->organization_id, $record->opportunity_category)
&& ! $this->access->conflict($reviewer, $record) && $this->access->operational($reviewer, 'validate', $record->id)
@@ -229,13 +293,14 @@ class OpportunityProfileWorkflow
$this->tasks->assign($record, $context['publication_task_id'], $subject);
$context['publication_assignment'] = [...$decision, 'assignee_user_id' => $subject->id];
} elseif ($action === 'publish') {
app(OpportunityReviewConditions::class)->authorize($context, $snapshot, 'publish');
Validator::make($data, ['confirm_publication' => 'required|accepted', 'preview_hash' => 'required|string|size:64'])->validate();
$this->contract->validatePublication($snapshot);
abort_unless(hash_equals($snapshot['hash'], $data['preview_hash']), 409, 'Pré-visualização diferente da versão aprovada.');
abort_unless(($context['approval']['hash'] ?? '') === $snapshot['hash'], 409, 'Aprovação não corresponde ao conteúdo atual.');
foreach ($this->contract->gates($record) as $gate) {
$review = $context['approval']['gates'][$gate] ?? [];
abort_unless(($review['decision'] ?? null) === 'approved' && ($review['hash'] ?? '') === $snapshot['hash'], 422, 'Revisão aprovada desta versão necessária.');
abort_unless(($review['decision'] ?? null) === 'approved' && (($review['hash'] ?? '') === $snapshot['hash'] || ($review['accepted_submission_hash'] ?? '') === $snapshot['hash']), 422, 'Revisão aprovada desta versão necessária.');
$reviewer = User::whereKey($review['actor_id'])->firstOrFail();
abort_unless($this->access->scoped($reviewer, 'validator', $record->organization_id, $record->opportunity_category)
&& ! $this->access->conflict($reviewer, $record) && $this->access->operational($reviewer, 'validate', $record->id)
@@ -312,7 +377,9 @@ class OpportunityProfileWorkflow
$this->tasks->complete($context['review_task_id'] ?? null, $data['reason']);
$this->tasks->complete($context['publication_task_id'] ?? null, $data['reason']);
$context['decision_history'][] = ['approval' => $context['approval'] ?? null, 'reviews' => $context['reviews'] ?? null, 'submission' => $context['submission'] ?? null];
unset($context['approval'], $context['reviews']);
$context['review_baseline'] = $context['submission'] ?? [];
$context['force_review'] = $action === 'appeal_reopen' || $state === 'suspended';
unset($context['approval']);
$next = 'needs_information';
} elseif ($action === 'request_archive') {
$context['request_archive'] = $decision;
@@ -330,6 +397,9 @@ class OpportunityProfileWorkflow
$context['rejection'] = $decision;
$this->tasks->complete($context['review_task_id'] ?? null, $data['reason']);
}
if ($action === 'archive') {
$context['archive'] = $decision;
}
if (in_array($action, ['suspend', 'archive'], true)) {
$record->status = $next;
foreach (['review_task_id', 'correction_task_id', 'publication_task_id', 'appeal_task_id'] as $task) {
@@ -343,7 +413,10 @@ class OpportunityProfileWorkflow
$this->tasks->complete($context['appeal_task_id'] ?? null, $data['reason']);
}
if (in_array($action, ['request_correction', 'reject'], true)) {
unset($context['approval'], $context['reviews']);
if ($action === 'reject') {
$context['force_review'] = true;
}
unset($context['approval']);
}
if (in_array($action, ['request_correction', 'reject', 'suspend', 'archive', 'request_revision', 'appeal_reopen'], true)) {
foreach ($context['opinions'] ?? [] as $opinionId => $opinion) {
@@ -369,6 +442,21 @@ class OpportunityProfileWorkflow
});
}
/** @param array<array-key, mixed> $context */
private function submissionCount(array $context): int
{
$events = $context['events'] ?? [];
abort_unless(is_array($events), 409, 'Histórico de submissões inconsistente; preservar e recuperar antes de continuar.');
$count = 0;
foreach ($events as $event) {
if (is_array($event) && ($event['action'] ?? null) === 'submit') {
$count++;
}
}
return $count;
}
private function responsibility(User $actor, Opportunity $record, string $name): bool
{
foreach ($this->access->grants($actor, $name === 'publication_coordinator' ? 'publisher' : 'validator') as $grant) {
@@ -385,7 +473,7 @@ class OpportunityProfileWorkflow
private function authorizeAction(User $actor, Opportunity $record, string $action): void
{
$this->access->authorize($actor, 'view', $record);
$promoter = $this->access->scoped($actor, 'promoter', $record->organization_id, $record->opportunity_category)
$promoter = $this->access->promoterRecordScope($actor, $record)
&& ($record->organization_id !== null || (int) $record->owner_user_id === $actor->id);
if (in_array($action, ['submit', 'request_archive', 'appeal', 'request_revision'], true)) {
abort_unless($promoter && $this->access->operational($actor, 'edit', $record->id), 403);