Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b60c231ddc | ||
|
|
c8957ecb9d | ||
|
|
e0b18413ac | ||
|
|
d306705027 | ||
|
|
b4ebca049e | ||
|
|
6d97ca77d0 | ||
|
|
6e7dfdabd0 | ||
|
|
fb23931feb | ||
|
|
44c3436b19 | ||
|
|
ae3d05305c | ||
|
|
7625a138e7 | ||
|
|
afa02559a1 | ||
|
|
25d18f51bb | ||
|
|
c4aa3ac548 | ||
|
|
bd000d04d2 | ||
|
|
fb076c174f | ||
|
|
1349789226 | ||
|
|
9cbd7fb97d | ||
|
|
2afbc5c9c7 | ||
|
|
3558647e8d | ||
|
|
d954c83b78 | ||
|
|
9a01426864 | ||
|
|
ed2fd86f6b | ||
|
|
528a2597ed | ||
|
|
e431de8b42 | ||
|
|
7691cab3bc | ||
|
|
91c1857368 | ||
|
|
6e302db62e | ||
|
|
1f2990e4da | ||
|
|
e8408c27d9 | ||
|
|
96f510965f | ||
|
|
88f18d0b7e | ||
|
|
dd20e74703 | ||
|
|
203c8f9193 | ||
|
|
73e1d7b964 | ||
|
|
ce8b744d1f | ||
|
|
a4541298c0 | ||
|
|
f40924f1be | ||
|
|
d5c960b62f | ||
|
|
fa69884ab0 | ||
|
|
e473542494 | ||
|
|
b3d4b7abe6 | ||
|
|
d3eeb70370 | ||
|
|
3c4c2599f7 | ||
|
|
078f770dea | ||
|
|
e9278ee446 | ||
|
|
2459d0ca37 | ||
|
|
95b33275aa | ||
|
|
a045162773 | ||
|
|
d2c72f5e13 | ||
|
|
f059c226d2 | ||
|
|
1218734eca | ||
|
|
d9f088587b | ||
|
|
b3849d850e | ||
|
|
2bad72c042 | ||
|
|
39bddad091 | ||
|
|
42b9324acb | ||
|
|
7e7bd4fde3 | ||
|
|
1263b4f6b7 | ||
|
|
2f1ef2fdfc | ||
|
|
61b4d9f1f9 | ||
|
|
1d52c3d8f4 | ||
|
|
0f79d0d54c | ||
|
|
d325b72fad | ||
|
|
8854b2928c | ||
|
|
f53a308327 | ||
|
|
723ce2a0a4 | ||
|
|
07182c7c73 | ||
|
|
bb6824d75d | ||
|
|
095280e29d | ||
|
|
e92519dd75 | ||
|
|
4988ca89dc | ||
|
|
258c8bd28b | ||
|
|
df543a4414 | ||
|
|
291a1c420f | ||
|
|
b20068d04b | ||
|
|
880e12890c |
@@ -0,0 +1,37 @@
|
||||
<?php
|
||||
|
||||
namespace App\Console\Commands;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Services\OfferAvailability;
|
||||
use App\Services\PrivateOfferOperations;
|
||||
use Illuminate\Console\Command;
|
||||
|
||||
final class ExpirePrivateOffers extends Command
|
||||
{
|
||||
protected $signature = 'investmoz:offers-expire {--confirm : Persist the already effective expiry}';
|
||||
|
||||
protected $description = 'Conferir expiração de Ofertas sem publicar conteúdos ou alterar o NDA';
|
||||
|
||||
public function handle(): int
|
||||
{
|
||||
$count = 0;
|
||||
Opportunity::query()->whereNotNull('workflow_context->private_offer_preparation')->orderBy('id')->chunkById(100, function ($records) use (&$count) {
|
||||
foreach ($records as $record) {
|
||||
if (app(OfferAvailability::class)->record($record)['state'] !== 'expired') {
|
||||
continue;
|
||||
}
|
||||
if ($this->option('confirm')) {
|
||||
if (app(PrivateOfferOperations::class)->expire($record->id)) {
|
||||
$count++;
|
||||
}
|
||||
} else {
|
||||
$count++;
|
||||
}
|
||||
}
|
||||
});
|
||||
$this->info(($this->option('confirm') ? 'Expirações registadas: ' : 'Expiradas, sem escrita: ').$count);
|
||||
|
||||
return self::SUCCESS;
|
||||
}
|
||||
}
|
||||
@@ -19,7 +19,7 @@ final class ClusterCompetitivenessController extends Controller
|
||||
$data = $request->validate(['expected_version' => 'required|integer|min:0',
|
||||
'draft' => $action === 'saved' ? 'required|array:version,clusterId,sector,region,forces' : 'prohibited',
|
||||
'revision' => $action === 'restored' ? 'required|integer|min:1' : 'prohibited',
|
||||
'reason' => in_array($action, ['approved', 'withdrawn'], true) ? 'required|string|min:10|max:3000' : 'nullable|string|max:3000']);
|
||||
'reason' => in_array($action, ['saved', 'restored'], true) ? 'nullable|string|max:3000' : 'required|string|min:10|max:3000']);
|
||||
|
||||
return response()->json($service->change($cluster, $request->user()->id, (int) $data['expected_version'], $action, $data))
|
||||
->header('Cache-Control', 'private, no-store');
|
||||
|
||||
@@ -7,6 +7,8 @@ use App\Models\InvestmentGap;
|
||||
use App\Models\ValueChain;
|
||||
use App\Models\ValueChainLink;
|
||||
use App\Services\PortalAudit;
|
||||
use App\Services\PortalEditorialSubjects;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use Illuminate\Http\RedirectResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
@@ -21,6 +23,17 @@ class ClusterValueChainController extends Controller
|
||||
'to_value_chain_id' => ['required', 'uuid', 'different:from_value_chain_id', Rule::exists('value_chains', 'id')->where('cluster_id', $cluster->id)->whereNull('deleted_at')],
|
||||
'link_type' => ['required', Rule::in(['supplies', 'processes', 'distributes', 'supports'])],
|
||||
]);
|
||||
if (app(PortalEditorialSubjects::class)->available()) {
|
||||
$edition = DB::transaction(function () use ($cluster, $data, $request) {
|
||||
EconomicCluster::whereKey($cluster->id)->lockForUpdate()->firstOrFail();
|
||||
$link = ValueChainLink::where($data)->first();
|
||||
abort_if($link !== null, 409, 'Ligação existente. Abra a edição desse registo para alterar.');
|
||||
|
||||
return app(PortalEditorialSubjects::class)->stageModel($request->user(), 'value-chain-links', new ValueChainLink, $data, 0);
|
||||
});
|
||||
|
||||
return redirect('/management/editorial/subjects/value-chain-links/'.$edition->subject_key)->with('success', 'Ligação guardada numa proposta privada.');
|
||||
}
|
||||
DB::transaction(function () use ($cluster, $data, $request) {
|
||||
EconomicCluster::whereKey($cluster->id)->lockForUpdate()->firstOrFail();
|
||||
$link = ValueChainLink::where($data)->first() ?? new ValueChainLink;
|
||||
@@ -32,6 +45,13 @@ class ClusterValueChainController extends Controller
|
||||
|
||||
public function removeLink(Request $request, EconomicCluster $cluster, ValueChainLink $link): RedirectResponse
|
||||
{
|
||||
if (app(PortalEditorialSubjects::class)->writes('value-chain-links', $link->id)) {
|
||||
abort_unless(ValueChain::where('cluster_id', $cluster->id)->whereIn('id', [$link->from_value_chain_id, $link->to_value_chain_id])->count() === 2, 404);
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
$workflow->saveSubject($request->user(), 'value-chain-links', $link->id, $workflow->subjectVersion('value-chain-links', $link->id), [], false, true);
|
||||
|
||||
return redirect('/management/editorial/subjects/value-chain-links/'.$link->id)->with('success', 'Retirada proposta. A ligação actual mantém-se até à publicação da decisão.');
|
||||
}
|
||||
DB::transaction(function () use ($cluster, $link, $request) {
|
||||
EconomicCluster::whereKey($cluster->id)->lockForUpdate()->firstOrFail();
|
||||
abort_unless(ValueChain::where('cluster_id', $cluster->id)->whereIn('id', [$link->from_value_chain_id, $link->to_value_chain_id])->count() === 2, 404);
|
||||
@@ -44,6 +64,7 @@ class ClusterValueChainController extends Controller
|
||||
public function gap(Request $request, EconomicCluster $cluster, ?InvestmentGap $gap = null): RedirectResponse
|
||||
{
|
||||
abort_if($gap && $gap->cluster_id !== $cluster->id, 404);
|
||||
$editorial = $gap ? app(PortalEditorialSubjects::class)->writes('investment-gaps', $gap->id) : app(PortalEditorialSubjects::class)->available();
|
||||
$data = $request->validate([
|
||||
'value_chain_id' => ['required', 'uuid', Rule::exists('value_chains', 'id')->where('cluster_id', $cluster->id)->whereNull('deleted_at')],
|
||||
'title' => ['required', 'string', 'max:200'],
|
||||
@@ -52,7 +73,13 @@ class ClusterValueChainController extends Controller
|
||||
'rationale' => ['required', 'string', 'min:10', 'max:5000'],
|
||||
'status' => ['required', Rule::in(['identified', 'in_review', 'resolved', 'withdrawn'])],
|
||||
'call_to_action' => ['required', 'string', 'max:2000'],
|
||||
...($editorial && $gap ? ['editorial_version' => ['required', 'integer', 'min:1']] : []),
|
||||
]);
|
||||
if ($editorial) {
|
||||
$edition = app(PortalEditorialSubjects::class)->stageModel($request->user(), 'investment-gaps', $gap ?? new InvestmentGap, [...array_diff_key($data, ['editorial_version' => true]), 'cluster_id' => $cluster->id], $gap ? (int) $data['editorial_version'] : 0);
|
||||
|
||||
return redirect('/management/editorial/subjects/investment-gaps/'.$edition->subject_key)->with('success', 'Lacuna guardada numa proposta privada.');
|
||||
}
|
||||
PortalAudit::save($gap ?? new InvestmentGap, [...$data, 'cluster_id' => $cluster->id], $request->user()->id);
|
||||
|
||||
return back()->with('success', 'Lacuna de investimento guardada.');
|
||||
|
||||
@@ -7,6 +7,7 @@ use App\Models\Opportunity;
|
||||
use App\Models\Sector;
|
||||
use App\Services\DashboardWorkQueue;
|
||||
use App\Services\InvestorPath;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use App\Services\PortalProfileAccess;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
@@ -28,7 +29,7 @@ class DashboardController extends Controller
|
||||
$contexts = $path->contexts($request->user());
|
||||
$current = $contexts ? $path->view($request->user(), $contexts[0]['id']) : null;
|
||||
|
||||
return Inertia::render('dashboard', ['summary' => null, 'workQueue' => $workQueue, 'investorPath' => $path->available() ? [
|
||||
return Inertia::render('dashboard', ['editorialQueue' => app(PortalEditorialWorkflow::class)->dashboard($request->user()), 'summary' => null, 'workQueue' => $workQueue, 'investorPath' => $path->available() ? [
|
||||
'contexts' => $contexts,
|
||||
'current' => $current ? ['id' => $current['case']['id'], 'next' => $current['next'],
|
||||
'pending' => count(array_filter($current['steps'], fn ($step) => ! in_array($step['state'], ['completed', 'approved', 'dispensed'], true))),
|
||||
@@ -43,7 +44,7 @@ class DashboardController extends Controller
|
||||
$drafts = app(PortalProfileAccess::class)->scope($drafts, $request->user());
|
||||
}
|
||||
|
||||
return Inertia::render('dashboard', ['workQueue' => $workQueue, 'summary' => [
|
||||
return Inertia::render('dashboard', ['editorialQueue' => app(PortalEditorialWorkflow::class)->dashboard($request->user()), 'workQueue' => $workQueue, 'summary' => [
|
||||
'canCreateOpportunity' => app(PortalProfileAccess::class)->legacyWriteAllowed($request->user()),
|
||||
'requestsByStatus' => collect(['received', 'in_review', 'contacted', 'closed'])
|
||||
->mapWithKeys(fn ($status) => [$status => (int) ($counts[$status] ?? 0)]),
|
||||
|
||||
@@ -0,0 +1,87 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Services\DemographicEvidence;
|
||||
use App\Services\DemographicImport;
|
||||
use App\Services\DemographicInstallation;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use App\Services\SectorContentAnalysis;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\RedirectResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Inertia\Inertia;
|
||||
use Inertia\Response;
|
||||
|
||||
final class DemographyController extends Controller
|
||||
{
|
||||
public function index(Request $request, DemographicEvidence $service): Response|JsonResponse
|
||||
{
|
||||
$data = $request->validate(['territories' => 'nullable|array|max:4', 'territories.*' => 'required|uuid|distinct',
|
||||
'start_year' => 'nullable|integer|between:1900,2100', 'end_year' => 'nullable|integer|between:1900,2100|gte:start_year',
|
||||
'sector' => 'nullable|in:'.implode(',', array_keys(DemographicEvidence::sectors())), 'edition' => 'nullable|uuid', 'investment_context' => 'nullable|boolean']);
|
||||
$start = (int) ($data['start_year'] ?? date('Y'));
|
||||
$end = (int) ($data['end_year'] ?? $start);
|
||||
abort_unless($end >= $start && $end - $start <= 50, 422, 'Escolha um horizonte até 50 anos.');
|
||||
$evidence = $service->analyse($data['territories'] ?? [], $start, $end, $data['sector'] ?? 'general', $data['edition'] ?? null);
|
||||
if (! empty($data['investment_context']) && count($data['territories'] ?? []) === 1) {
|
||||
$evidence = $service->investmentContext($data['territories'][0], $start, $end, $data['sector'] ?? 'general', $data['edition'] ?? null);
|
||||
}
|
||||
if ($request->expectsJson()) {
|
||||
return response()->json($evidence);
|
||||
}
|
||||
$territories = $service->territories()->orderBy('name')->get(['id', 'name', 'parent_id', 'location_type']);
|
||||
|
||||
return Inertia::render('investment/demography', ['sectorReadings' => app(SectorContentAnalysis::class)->forTerritories($data['territories'] ?? []), 'evidence' => $evidence, 'filters' => $data, 'territories' => $territories, 'sectors' => DemographicEvidence::sectors()]);
|
||||
}
|
||||
|
||||
public function management(Request $request, DemographicImport $service): Response|RedirectResponse
|
||||
{
|
||||
if (! Schema::hasTable('demographic_imports')) {
|
||||
return redirect('/management/demography/install');
|
||||
}
|
||||
$service->authorize($request->user());
|
||||
$data = $request->validate(['batch' => 'nullable|uuid']);
|
||||
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
$editorial = $workflow->demographyAvailable();
|
||||
|
||||
return Inertia::render('management/demography', ['editorialEnabled' => $editorial, 'editorialRevision' => $editorial && isset($data['batch']) ? (int) ($workflow->latestDemography($data['batch'])->revision_no ?? 0) : 0, 'qa' => ! app(DemographicInstallation::class)->activeTarget(), 'batches' => DB::table('demographic_imports')->orderByDesc('created_at')->get(['id', 'file_name', 'publication_version', 'status', 'created_at']),
|
||||
'preview' => isset($data['batch']) ? $service->preview($request->user(), $data['batch']) : null]);
|
||||
}
|
||||
|
||||
public function installation(Request $request, DemographicInstallation $service): Response
|
||||
{
|
||||
return Inertia::render('management/demography-install', ['plan' => $service->preview($request->user())]);
|
||||
}
|
||||
|
||||
public function install(Request $request, DemographicInstallation $service): JsonResponse
|
||||
{
|
||||
return response()->json($service->apply($request->user(), $request->all()));
|
||||
}
|
||||
|
||||
public function prepare(Request $request, DemographicImport $service): JsonResponse
|
||||
{
|
||||
$data = $request->validate(['file' => 'required|file|mimes:xlsx|max:19531', 'publication_version' => 'required|string|max:255', 'baseline_year' => 'nullable|integer|between:1900,2100']);
|
||||
$file = $request->file('file');
|
||||
|
||||
return response()->json($service->prepare($request->user(), $file->getRealPath(), $file->getClientOriginalName(), $data['publication_version'], isset($data['baseline_year']) ? (int) $data['baseline_year'] : null));
|
||||
}
|
||||
|
||||
public function confirm(Request $request, string $id, DemographicImport $service): JsonResponse
|
||||
{
|
||||
$data = $request->validate(['sha256' => 'required|string|size:64', 'mapping' => 'present|array', 'mapping.*' => 'required|uuid', 'reason' => 'required|string|min:10|max:2000']);
|
||||
|
||||
return response()->json($service->confirm($request->user(), $id, $data['sha256'], $data['mapping'], $data['reason']));
|
||||
}
|
||||
|
||||
public function transition(Request $request, string $id, DemographicImport $service): JsonResponse
|
||||
{
|
||||
$data = $request->validate(['action' => 'required|in:approved,disabled', 'reason' => 'required|string|min:10|max:2000']);
|
||||
$service->transition($request->user(), $id, $data['action'], $data['reason']);
|
||||
|
||||
return response()->json(['id' => $id, 'status' => $data['action']]);
|
||||
}
|
||||
}
|
||||
@@ -5,6 +5,7 @@ namespace App\Http\Controllers;
|
||||
use App\Services\DocumentManagementAccess;
|
||||
use App\Services\EditorialInstallation;
|
||||
use App\Services\EditorialReading;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use App\Services\PortalProfileAccess;
|
||||
use Illuminate\Contracts\Encryption\DecryptException;
|
||||
use Illuminate\Database\Query\Builder;
|
||||
@@ -97,11 +98,17 @@ class EditorialArticleController extends Controller
|
||||
app(DocumentManagementAccess::class)->assertEditableResource(request()->user(), $id);
|
||||
$r = DB::table('portal_resources')->where('id', $id)->first();
|
||||
abort_unless($r instanceof \stdClass, 404);
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
if ($workflow->enabled()) {
|
||||
$workflow->authorize(request()->user(), $id);
|
||||
$r = $workflow->workingResource($r);
|
||||
}
|
||||
$reading = app(EditorialReading::class);
|
||||
$original = $reading->original($r);
|
||||
$content = $reading->content($r, $original);
|
||||
|
||||
return tap(Inertia::render('portal/article-editor', ['resource' => ['id' => $r->id, 'title' => $r->title, 'metadata_version' => $r->metadata_version, 'published' => (bool) $r->published],
|
||||
'workflowEnabled' => $workflow->enabled(), 'workflow' => $workflow->latest($id),
|
||||
'content' => $content, 'source' => $original ? array_intersect_key($original, array_flip(['source_url', 'published_at', 'modified_at', 'legacy_id', 'image_source_url'])) : null, 'images' => $this->publicResources()->whereIn('d.media_type', ['image/png', 'image/jpeg', 'image/webp'])->get(['r.id', 'r.title']),
|
||||
'revisions' => DB::table('portal_resource_revisions')->where('resource_id', $id)->orderByDesc('revision_no')->get(['revision_no', 'change_type', 'created_at'])])->toResponse(request()), static fn (Response $response) => $response->headers->set('Cache-Control', 'private, no-store'));
|
||||
}
|
||||
@@ -114,7 +121,9 @@ class EditorialArticleController extends Controller
|
||||
$r = DB::table('portal_resources')->where('id', $id)->lockForUpdate()->first();
|
||||
abort_unless($r !== null, 404);
|
||||
app(DocumentManagementAccess::class)->assertEditableResource($request->user(), $id);
|
||||
abort_unless((int) $r->metadata_version === (int) $data['metadata_version'], 409, 'O artigo foi alterado noutra sessão. Recarregue antes de editar.');
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
$current = $workflow->enabled() ? $workflow->workingResource($r) : $r;
|
||||
abort_unless((int) $current->metadata_version === (int) $data['metadata_version'], 409, 'O artigo foi alterado noutra sessão. Recarregue antes de editar.');
|
||||
if (! empty($data['image_resource_id'])) {
|
||||
abort_unless($this->publicResources()->where('r.id', $data['image_resource_id'])->whereIn('d.media_type', ['image/png', 'image/jpeg', 'image/webp'])->exists(), 422, 'Escolha uma imagem pública disponível na biblioteca.');
|
||||
}
|
||||
@@ -122,7 +131,13 @@ class EditorialArticleController extends Controller
|
||||
if ($body === '') {
|
||||
throw ValidationException::withMessages(['body' => 'Escreva o corpo do artigo.']);
|
||||
}
|
||||
$content = $this->edition($r, $data);
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
$content = $this->edition($workflow->enabled() ? $workflow->workingResource($r) : $r, $data);
|
||||
if ($workflow->enabled()) {
|
||||
$workflow->save($request->user(), $id, (int) $data['metadata_version'], ['editorial_content' => json_encode($content, JSON_THROW_ON_ERROR)]);
|
||||
|
||||
return;
|
||||
}
|
||||
$revision = (int) $r->metadata_version + 1;
|
||||
DB::table('portal_resources')->where('id', $id)->update(['editorial_content' => json_encode($content, JSON_THROW_ON_ERROR), 'published' => false, 'approved_by' => null, 'metadata_version' => $revision, 'last_reviewed_by' => $request->user()->id, 'last_reviewed_at' => now(), 'updated_at' => now()]);
|
||||
$resource = DB::table('portal_resources')->where('id', $id)->first();
|
||||
@@ -165,6 +180,11 @@ class EditorialArticleController extends Controller
|
||||
app(DocumentManagementAccess::class)->assertEditableResource($request->user(), $id);
|
||||
$resource = DB::table('portal_resources')->where('id', $id)->first();
|
||||
abort_unless($resource instanceof \stdClass, 404);
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
if ($workflow->enabled()) {
|
||||
$workflow->authorize(request()->user(), $id);
|
||||
$resource = $workflow->workingResource($resource);
|
||||
}
|
||||
|
||||
return tap(Inertia::render('portal/article', ['article' => app(EditorialReading::class)->reading($resource, null, true)])
|
||||
->toResponse($request), static function (Response $response): void {
|
||||
@@ -179,6 +199,11 @@ class EditorialArticleController extends Controller
|
||||
app(DocumentManagementAccess::class)->assertEditableResource($request->user(), $id);
|
||||
$resource = DB::table('portal_resources')->where('id', $id)->first();
|
||||
abort_unless($resource instanceof \stdClass, 404);
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
if ($workflow->enabled()) {
|
||||
$workflow->authorize($request->user(), $id);
|
||||
$resource = $workflow->workingResource($resource);
|
||||
}
|
||||
$data = $this->validateContent($request);
|
||||
abort_unless((int) $resource->metadata_version === (int) $data['metadata_version'], 409, 'A revisão mudou; recupere antes de rever a prévia.');
|
||||
|
||||
|
||||
@@ -150,31 +150,41 @@ final class FundingProgrammeController extends Controller
|
||||
'category' => ['nullable', Rule::in(array_keys(FundingInstitutionClassification::CATEGORIES))], 'institution_type' => ['nullable', Rule::in(array_keys(FundingInstitutionClassification::TYPES))], 'location_mode' => 'nullable|in:physical,coverage', 'include_historical' => 'nullable|boolean',
|
||||
'need' => ['nullable', Rule::in(array_keys(FundingInstitutionDetails::NEEDS))],
|
||||
'context' => 'nullable|uuid', 'opportunity' => 'nullable|string|max:150',
|
||||
'province_id' => 'nullable|uuid', 'district_id' => 'nullable|uuid', 'admin_post_id' => 'nullable|uuid', 'locality_id' => 'nullable|uuid',
|
||||
'territory' => ['nullable', 'uuid', Rule::in(app(InvestmentGeography::class)->publicReferences()->pluck('id')->all())],
|
||||
'sector' => ['nullable', 'integer', Rule::in(Sector::choices()->whereNotNull('published_at')->pluck('id')->all())],
|
||||
'certainty' => 'nullable|in:include_unknown,documented', 'state' => 'nullable|in:open,closed,upcoming,unknown']);
|
||||
$filters = array_filter($filters, fn ($value) => $value !== null && $value !== '');
|
||||
// A local search excludes unlocated records unless explicitly requested.
|
||||
if (($filters['location_mode'] ?? '') === 'physical' && ! isset($filters['certainty'])) {
|
||||
$filters['certainty'] = 'documented';
|
||||
}
|
||||
$dossier = $request->user() && ! empty($filters['context']) ? app(FundingDossierPreparation::class)->context($request->user(), $filters['context'], $filters['opportunity'] ?? null) : null;
|
||||
if ($dossier && empty($filters['territory']) && $dossier['territory']) {
|
||||
$explicitLocation = $request->hasAny(['territory', 'province_id', 'district_id', 'admin_post_id', 'locality_id']);
|
||||
if ($dossier && ! $explicitLocation && empty($filters['territory']) && $dossier['territory']) {
|
||||
$filters['territory'] = $dossier['territory'];
|
||||
}
|
||||
$query = $service->catalogueQuery($filters);
|
||||
if (! empty($filters['q'])) {
|
||||
$term = '%'.str_replace(['\\', '%', '_'], ['\\\\', '\\%', '\\_'], $filters['q']).'%';
|
||||
$query->where(fn ($q) => $q->whereRaw("v.payload->>'title' ilike ?", [$term])->orWhereRaw("v.payload->>'summary' ilike ?", [$term])->orWhereRaw("(v.payload->'aliases')::text ilike ?", [$term])->orWhereRaw("EXISTS (SELECT 1 FROM jsonb_array_elements(COALESCE(v.payload->'locations','[]'::jsonb)) l WHERE l->>'label' ilike ? OR l->>'address' ilike ? OR l->>'location_text' ilike ?)", [$term, $term, $term]));
|
||||
$geography = app(InvestmentGeography::class);
|
||||
$criteriaErrors = [];
|
||||
$territorySelection = [];
|
||||
try {
|
||||
$filters = $geography->interestSelection($filters);
|
||||
$territorySelection = ! empty($filters['territory']) ? $geography->path($filters['territory']) : [];
|
||||
$query = $service->catalogueQuery($filters);
|
||||
$items = $query->orderByDesc('v.published_at')->orderBy('p.id')->paginate(20, ['p.id', 'p.code', 'v.id as version_id', 'v.version', 'v.payload', 'v.published_at'])->withQueryString();
|
||||
} catch (\Illuminate\Validation\ValidationException $error) {
|
||||
if ($request->expectsJson()) throw $error;
|
||||
$criteriaErrors = $error->errors();
|
||||
$items = new \Illuminate\Pagination\LengthAwarePaginator([], 0, 20, 1, ['path' => '/fundos', 'query' => $request->query()]);
|
||||
}
|
||||
if (! empty($filters['kind'])) {
|
||||
$query->whereRaw("v.payload->>'kind' = ?", [$filters['kind']]);
|
||||
}
|
||||
$items = $query->orderByDesc('v.published_at')->orderBy('p.id')->paginate(20, ['p.id', 'p.code', 'v.id as version_id', 'v.version', 'v.payload', 'v.published_at'])->withQueryString();
|
||||
$items->through(function ($row) use ($service, $filters) {
|
||||
$record = $service->present($row);
|
||||
|
||||
return [...$record, 'filter_explanation' => $service->filterExplanation($record, $filters)];
|
||||
});
|
||||
|
||||
return tap(Inertia::render('funding/index', ['items' => $items, 'filters' => $filters, 'categories' => FundingInstitutionClassification::CATEGORIES, 'institutionTypes' => FundingInstitutionClassification::TYPES, 'kinds' => FundingProgrammes::KINDS, 'needs' => FundingInstitutionDetails::NEEDS, 'dossier' => $dossier,
|
||||
'options' => ['territories' => app(InvestmentGeography::class)->publicReferences()->orderBy('name')->get(['id', 'name']),
|
||||
return tap(Inertia::render('funding/index', ['criteriaErrors' => $criteriaErrors, 'territorySelection' => $territorySelection, 'categoryTypes' => FundingInstitutionClassification::CATEGORY_TYPES, 'items' => $items, 'filters' => $filters, 'categories' => FundingInstitutionClassification::CATEGORIES, 'institutionTypes' => FundingInstitutionClassification::TYPES, 'kinds' => FundingProgrammes::KINDS, 'needs' => FundingInstitutionDetails::NEEDS, 'dossier' => $dossier,
|
||||
'options' => ['territories' => $territorySelection,
|
||||
'sectors' => Sector::choices()->whereNotNull('published_at')->orderBy('name')->get(['id', 'name'])], 'management' => $service->access($request->user())])
|
||||
->toResponse($request), static fn (\Symfony\Component\HttpFoundation\Response $response) => $response->headers->set('Cache-Control', 'private, no-store'));
|
||||
}
|
||||
@@ -183,7 +193,7 @@ final class FundingProgrammeController extends Controller
|
||||
{
|
||||
$request->validate(['context' => 'nullable|uuid', 'opportunity' => 'nullable|string|max:150', 'need' => ['nullable', Rule::in(array_keys(FundingInstitutionDetails::NEEDS))], 'territory' => 'nullable|uuid', 'category' => 'nullable|string|max:80', 'institution_type' => 'nullable|string|max:80', 'location_mode' => 'nullable|in:physical,coverage']);
|
||||
$dossier = $request->user() && $request->filled('context') ? app(FundingDossierPreparation::class)->context($request->user(), $request->string('context')->toString(), $request->query('opportunity')) : null;
|
||||
if ($dossier && ! $request->filled('territory') && $dossier['territory']) {
|
||||
if ($dossier && ! $request->has('territory') && $dossier['territory']) {
|
||||
$request->merge(['territory' => $dossier['territory']]);
|
||||
}
|
||||
$record = $service->published($id);
|
||||
@@ -204,7 +214,7 @@ final class FundingProgrammeController extends Controller
|
||||
$saved = $request->user() ? DB::table('funding_programme_interests as i')->join('funding_programme_versions as v', 'v.id', '=', 'i.version_id')
|
||||
->where('i.programme_id', $id)->where('i.user_id', $request->user()->id)->whereNull('i.removed_at')->first(['v.version', 'i.saved_at']) : null;
|
||||
|
||||
return tap(Inertia::render('funding/show', ['record' => $record, 'saved' => $saved, 'authenticated' => $request->user() !== null, 'dossier' => $dossier, 'selection' => [...$request->only(['need', 'territory', 'context', 'opportunity', 'category', 'institution_type', 'location_mode']), 'territory_label' => app(InvestmentGeography::class)->publicReferences()->where('id', $request->query('territory'))->value('name') ?? 'Local por seleccionar'], 'needs' => FundingInstitutionDetails::NEEDS, 'destinations' => $destinations])
|
||||
return tap(Inertia::render('funding/show', ['record' => $record, 'saved' => $saved, 'authenticated' => $request->user() !== null, 'dossier' => $dossier, 'selection' => [...$request->only(['q', 'kind', 'sector', 'certainty', 'state', 'include_historical', 'province_id', 'district_id', 'admin_post_id', 'locality_id', 'page', 'need', 'territory', 'context', 'opportunity', 'category', 'institution_type', 'location_mode']), 'territory_label' => app(InvestmentGeography::class)->publicReferences()->where('id', $request->query('territory'))->value('name') ?? 'Local por seleccionar'], 'needs' => FundingInstitutionDetails::NEEDS, 'destinations' => $destinations])
|
||||
->toResponse($request), static fn (\Symfony\Component\HttpFoundation\Response $response) => $response->headers->set('Cache-Control', 'private, no-store'));
|
||||
}
|
||||
|
||||
|
||||
@@ -3,31 +3,105 @@
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Models\ExistingBusiness;
|
||||
use App\Models\Opportunity;
|
||||
use App\Models\Sector;
|
||||
use App\Services\CorridorAgribusinessOpportunities;
|
||||
use App\Services\EditorialReading;
|
||||
use App\Services\FederatedSearch;
|
||||
use App\Services\FundingInstitutionDetails;
|
||||
use App\Services\FundingProgrammes;
|
||||
use App\Services\InvestmentCatalogue;
|
||||
use App\Services\InvestmentGeography;
|
||||
use App\Services\InvestmentZones;
|
||||
use App\Services\LegacyContent;
|
||||
use App\Services\SearchTerms;
|
||||
use App\Services\SectorOrganization;
|
||||
use App\Services\SectorResourceReferences;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Illuminate\Support\Str;
|
||||
use Inertia\Inertia;
|
||||
use Inertia\Response;
|
||||
use Symfony\Component\HttpKernel\Exception\HttpException;
|
||||
|
||||
class GlobalSearchController extends Controller
|
||||
{
|
||||
public function __invoke(Request $request, InvestmentCatalogue $catalogue, SearchTerms $search, FederatedSearch $federated): Response
|
||||
{
|
||||
$input = $request->validate(['q' => ['nullable', 'string', 'max:120'], 'page' => ['nullable', 'integer', 'min:1']]);
|
||||
$term = trim($input['q'] ?? '');
|
||||
$input = $request->validate(['q' => ['nullable', 'string', 'max:120'], 'page' => ['nullable', 'integer', 'min:1'], 'category' => ['nullable', 'in:all,physical,financial']]);
|
||||
$original = trim($input['q'] ?? '');
|
||||
$intent = $search->requestIntent($original);
|
||||
if (isset($input['category']) && ($intent === null || $intent['type'] === 'products')) {
|
||||
$intent = ['type' => 'products', 'label' => 'Produtos e localização', 'kind' => null,
|
||||
'filter' => $intent['filter'] ?? $original,
|
||||
'category' => match ($input['category']) {
|
||||
'physical' => 'Produtos e localizações', 'financial' => 'Produtos financeiros', default => null,
|
||||
}];
|
||||
}
|
||||
$term = $intent['filter'] ?? $original;
|
||||
$tokens = $search->tokens($term);
|
||||
$results = ['data' => [], 'total' => 0, 'current_page' => 1, 'last_page' => 1, 'per_page' => 5, 'unavailable' => []];
|
||||
if ($tokens !== []) {
|
||||
if ($tokens !== [] || $intent !== null) {
|
||||
$factories = [
|
||||
'Produtos e localizações' => function () use ($search, $tokens, $term) {
|
||||
try {
|
||||
return $this->productReferences($search, $tokens, $term);
|
||||
} catch (\RuntimeException $exception) {
|
||||
throw new HttpException(503, 'Referências de produtos temporariamente indisponíveis.', $exception);
|
||||
}
|
||||
},
|
||||
'Produtos financeiros' => function () use ($search, $tokens, $term) {
|
||||
$service = app(FundingProgrammes::class);
|
||||
if (! $service->installed()) {
|
||||
return ['count' => 0, 'fetch' => fn ($offset, $limit) => []];
|
||||
}
|
||||
$query = $service->catalogueQuery([])->select('p.id', 'v.payload')->selectRaw("v.payload->>'title' AS title");
|
||||
foreach ($tokens as $token) {
|
||||
$query->where(function ($match) use ($search, $token) {
|
||||
$search->orFields($match, ["(v.payload->>'title')",
|
||||
"(SELECT string_agg(product->>'title', ' ') FROM jsonb_array_elements(COALESCE(v.payload->'products','[]'::jsonb)) product)",
|
||||
"(SELECT string_agg(place->>'location_text', ' ') FROM jsonb_array_elements(COALESCE(v.payload->'locations','[]'::jsonb)) place)",
|
||||
"(SELECT string_agg(node->>'name', ' ') FROM jsonb_path_query(v.payload,'$.locations[*].territory_path[*]') node)",
|
||||
"(SELECT string_agg(node->>'name', ' ') FROM jsonb_path_query(v.payload,'$.products[*].territory_paths[*][*]') node)"], $token);
|
||||
foreach (FundingInstitutionDetails::NEEDS as $code => $label) {
|
||||
$text = in_array($code, ['investment', 'working_capital'], true) ? 'Financiamento '.$label : $label;
|
||||
if ($search->matches($text, [$token])) {
|
||||
$match->orWhereJsonContains('v.payload->institution_services', $code)->orWhereJsonContains('v.payload->funding_needs', $code)
|
||||
->orWhereRaw("EXISTS (SELECT 1 FROM jsonb_array_elements(COALESCE(v.payload->'products','[]'::jsonb)) product WHERE product->'needs' @> ?::jsonb)", [json_encode([$code], JSON_THROW_ON_ERROR)]);
|
||||
}
|
||||
}
|
||||
foreach (FundingInstitutionDetails::NATURES as $code => $label) {
|
||||
if ($search->matches($label, [$token])) {
|
||||
$match->orWhere('v.payload->institution_nature', $code);
|
||||
}
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
return $this->source($query, $search, $term, $tokens, "(v.payload->>'title')", 'p.id', function ($row) {
|
||||
$p = json_decode($row->payload, true, 512, JSON_THROW_ON_ERROR);
|
||||
$products = array_values(array_unique(array_filter(array_column($p['products'] ?? [], 'title'))));
|
||||
$services = array_values(array_intersect_key(FundingInstitutionDetails::NEEDS, array_flip($p['institution_services'] ?? [])));
|
||||
$places = [];
|
||||
foreach ($p['locations'] ?? [] as $location) {
|
||||
if (! empty($location['location_text'])) {
|
||||
$places[] = $location['location_text'];
|
||||
}
|
||||
foreach ($location['territory_path'] ?? [] as $node) {
|
||||
if ($node['type'] !== 'country') {
|
||||
$places[] = $node['name'];
|
||||
}
|
||||
}
|
||||
}
|
||||
$national = array_any($p['products'] ?? [], fn ($product) => ($product['coverage'] ?? '') === 'national');
|
||||
|
||||
return ['title' => $row->title, 'description' => implode(' · ', $products ?: $services) ?: 'Instituição financeira.',
|
||||
'location' => $places === [] ? null : 'Presença física: '.implode(' · ', array_unique($places)),
|
||||
'coverage' => $national ? 'Existe produto com cobertura nacional indicada; consulte as condições.' : 'Cobertura financeira: consultar cada produto.',
|
||||
'url' => '/fundos/'.$row->id];
|
||||
});
|
||||
},
|
||||
'Páginas e serviços' => function () use ($search, $tokens, $term) {
|
||||
$pages = array_values(array_filter($this->pages(), fn ($page) => $search->matches(implode(' ', $page), $tokens)));
|
||||
usort($pages, fn ($a, $b) => $search->score($b['title'], $term, $tokens) <=> $search->score($a['title'], $term, $tokens)
|
||||
@@ -63,9 +137,15 @@ class GlobalSearchController extends Controller
|
||||
return $this->source($query, $search, $term, $tokens, 'public_title', 'existing_businesses.id',
|
||||
fn ($r) => ['title' => $r->public_title, 'description' => $r->objective, 'url' => '/negocios/'.rawurlencode($r->public_slug)]);
|
||||
},
|
||||
'Carteira: projectos, clusters e corredores' => function () use ($search, $tokens, $term) {
|
||||
'Carteira: projectos, clusters e corredores' => function () use ($search, $tokens, $term, $intent) {
|
||||
$query = InvestmentPortfolioController::visible();
|
||||
$search->constrain($query, ['investment_dossiers.title', 'investment_dossiers.content'], $tokens);
|
||||
if ($intent !== null && $intent['kind'] !== null) {
|
||||
[$column, $table] = ['corridor' => ['corridor_id', 'development_corridors'], 'cluster' => ['cluster_id', 'economic_clusters'], 'project' => ['project_id', 'projects']][$intent['kind']];
|
||||
$query->whereNotNull($column)->whereExists(fn ($entity) => $entity->selectRaw('1')->from($table)
|
||||
->whereColumn($table.'.id', 'investment_dossiers.'.$column)->whereNull($table.'.deleted_at'));
|
||||
// The existing unique entity key already prevents duplicate dossiers.
|
||||
}
|
||||
|
||||
return $this->source($query, $search, $term, $tokens, 'investment_dossiers.title', 'investment_dossiers.id',
|
||||
fn ($r) => ['title' => $r->title, 'description' => $r->corridor_id ? 'Corredor' : ($r->cluster_id ? 'Cluster' : 'Projecto âncora'), 'url' => '/carteira/'.$r->id]);
|
||||
@@ -126,13 +206,75 @@ class GlobalSearchController extends Controller
|
||||
fn ($r) => ['title' => $r->title, 'description' => implode(' · ', array_filter([$r->sector, $r->province])), 'url' => '/parcerias/'.$r->id]);
|
||||
},
|
||||
];
|
||||
if ($intent !== null) {
|
||||
$categories = $intent['category'] === null ? ['Produtos e localizações', 'Produtos financeiros'] : [$intent['category']];
|
||||
$factories = array_intersect_key($factories, array_flip($categories));
|
||||
}
|
||||
$results = $federated->page($factories, (int) ($input['page'] ?? 1), 5,
|
||||
fn ($item) => $search->score($item['title'], $term, $tokens));
|
||||
}
|
||||
|
||||
return Inertia::render('portal/search', ['query' => $term, 'results' => $results]);
|
||||
$answer = $intent === null ? null : ['type' => $intent['type'], 'label' => $intent['label'], 'filter' => $term,
|
||||
'count' => $results['unavailable'] === [] ? $results['total'] : null];
|
||||
|
||||
if ($answer !== null && $intent['type'] === 'products') {
|
||||
$answer['category'] = match ($intent['category']) {
|
||||
'Produtos e localizações' => 'physical', 'Produtos financeiros' => 'financial', default => 'all',
|
||||
};
|
||||
}
|
||||
|
||||
return Inertia::render('portal/search', ['query' => $original, 'results' => $results, 'answer' => $answer]);
|
||||
}
|
||||
|
||||
/** @param list<string> $tokens
|
||||
* @return array{count:int,fetch:callable(int,int):iterable<array<string,mixed>>}
|
||||
*/
|
||||
private function productReferences(SearchTerms $search, array $tokens, string $term): array
|
||||
{
|
||||
$rows = [];
|
||||
foreach (['mineracao', 'energia-especifica'] as $sector) {
|
||||
if (! Sector::where('slug', $sector)->where('is_active', true)->whereNotNull('published_at')->exists()) {
|
||||
continue;
|
||||
}
|
||||
$data = app(SectorResourceReferences::class)->view($sector);
|
||||
foreach ($data['groups'] as $group) {
|
||||
$locations = array_values(array_filter($group['location_labels'], fn ($name) => $search->matches($term, $search->tokens($name))));
|
||||
$rows[] = ['title' => $group['name'], 'description' => $sector === 'mineracao' ? 'Referência mineral; não identifica uma concessão ou produção disponível.' : 'Segmento energético e cadeia de valor.',
|
||||
'location' => $group['locations_text'], 'url' => '/sectores/'.$sector.'?'.http_build_query(['resource_group' => $group['id'],
|
||||
...(count($locations) === 1 ? ['resource_location' => $locations[0]] : [])])];
|
||||
}
|
||||
}
|
||||
if (app(LegacyContent::class)->available() && Sector::where('slug', 'agronegocio')->where('is_active', true)->whereNotNull('published_at')->exists()) {
|
||||
try {
|
||||
app(LegacyContent::class)->article('agronegocio', false);
|
||||
$entries = app(CorridorAgribusinessOpportunities::class)->entries();
|
||||
$published = Opportunity::published()->whereIn('management_creation_key', array_column($entries, 'key'))->pluck('slug', 'management_creation_key');
|
||||
foreach ($entries as $entry) {
|
||||
if (! isset($published[$entry['key']])) {
|
||||
continue;
|
||||
}
|
||||
$rows[] = ['title' => $entry['chain'], 'description' => 'Cadeia agrícola: '.$entry['summary'], 'location' => 'Enquadramento territorial: '.$entry['corridor'],
|
||||
'url' => '/oportunidades/'.rawurlencode($published[$entry['key']])];
|
||||
}
|
||||
} catch (HttpException $exception) {
|
||||
if ($exception->getStatusCode() !== 404) {
|
||||
throw $exception;
|
||||
}
|
||||
}
|
||||
}
|
||||
$rows = array_values(array_filter($rows, fn ($row) => $search->matches(implode(' ', $row), $tokens)));
|
||||
usort($rows, fn ($a, $b) => $search->score($b['title'], $term, $tokens) <=> $search->score($a['title'], $term, $tokens) ?: strcmp($a['title'], $b['title']));
|
||||
|
||||
return ['count' => count($rows), 'fetch' => fn ($offset, $limit) => array_slice($rows, $offset, $limit)];
|
||||
}
|
||||
|
||||
/** @param \Illuminate\Database\Eloquent\Builder<*>|\Illuminate\Database\Query\Builder $query
|
||||
* @param list<string> $tokens
|
||||
* @param callable(mixed):array<string,mixed> $present
|
||||
* @param literal-string $title
|
||||
* @param literal-string $id
|
||||
* @return array{count:int,fetch:callable(int,int):iterable<array<string,mixed>>}
|
||||
*/
|
||||
private function source($query, SearchTerms $search, string $term, array $tokens, string $title, string $id, callable $present): array
|
||||
{
|
||||
$count = (clone $query)->reorder()->count();
|
||||
@@ -142,10 +284,14 @@ class GlobalSearchController extends Controller
|
||||
return ['count' => $count, 'fetch' => fn ($offset, $limit) => (clone $query)->offset($offset)->limit($limit)->get()->map($present)->all()];
|
||||
}
|
||||
|
||||
/** Public service entry points and terms used to find them. */
|
||||
/** Public service entry points and terms used to find them.
|
||||
* @return list<array{title:string,description:string,url:string}>
|
||||
*/
|
||||
private function pages(): array
|
||||
{
|
||||
return [
|
||||
['title' => 'Licenciamento da empresa', 'description' => 'Roteiro de constituição e licenciamento conforme a actividade e localização.', 'url' => '/como-investir#planeamento'],
|
||||
['title' => 'Preparar licenciamento no dossier', 'description' => 'Continuar a preparação na etapa de licenciamento prévio.', 'url' => '/investimentos/iniciar?step=S08'],
|
||||
['title' => 'Como investir em Moçambique', 'description' => 'Procedimentos e etapas para investir', 'url' => '/como-investir'],
|
||||
['title' => 'Iniciar ou continuar investimento', 'description' => 'Preparar uma ideia e dossier de investimento', 'url' => '/investimentos/iniciar'],
|
||||
['title' => 'Oportunidades de investimento', 'description' => 'Pesquisar por sector, localização e maturidade', 'url' => '/oportunidades'],
|
||||
|
||||
@@ -13,6 +13,7 @@ use App\Services\InvestmentGeography;
|
||||
use App\Services\InvestmentRelations;
|
||||
use App\Services\InvestmentZones;
|
||||
use App\Services\PortalAudit;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use App\Services\PublicSearchMetrics;
|
||||
use Illuminate\Database\Eloquent\Builder;
|
||||
use Illuminate\Database\Query\Builder as QueryBuilder;
|
||||
@@ -99,6 +100,10 @@ class InvestmentPortfolioController extends Controller
|
||||
{
|
||||
$management = $request->routeIs('management.portfolio*');
|
||||
$record = ($management ? InvestmentDossier::query() : self::visible())->findOrFail($id);
|
||||
$editorial = $management && app(PortalEditorialWorkflow::class)->portfolioEnabled();
|
||||
if ($editorial) {
|
||||
$record = app(PortalEditorialWorkflow::class)->workingPortfolio($record);
|
||||
}
|
||||
$relatedIds = [];
|
||||
foreach ([['corridor_projects', 'corridor_id', 'project_id'], ['corridor_clusters', 'corridor_id', 'cluster_id'], ['cluster_projects', 'cluster_id', 'project_id']] as [$table, $left, $right]) {
|
||||
foreach ([[$left, $right], [$right, $left]] as [$origin, $destination]) {
|
||||
@@ -147,7 +152,7 @@ class InvestmentPortfolioController extends Controller
|
||||
->orderByDesc('updated_at')->limit(10)->get(['id', 'version', 'updated_at'])
|
||||
: collect();
|
||||
|
||||
return Inertia::render('portfolio/show', ['complements' => $management ? [] : app(InvestmentComplements::class)->options('portfolio:'.$record->id), 'record' => $record, 'related' => $related, 'management' => $management, 'zones' => $zones,
|
||||
return Inertia::render('portfolio/show', ['editorialEnabled' => $editorial, 'complements' => $management ? [] : app(InvestmentComplements::class)->options('portfolio:'.$record->id), 'record' => $record, 'related' => $related, 'management' => $management, 'zones' => $zones,
|
||||
'anchorProject' => $anchorProject, 'existingSubmissions' => $existingSubmissions,
|
||||
'competitiveness' => $record->cluster_id ? app(ClusterCompetitiveness::class)->publicData($record->cluster_id) : null,
|
||||
'geography' => app(InvestmentRelations::class)->dossier($record, $management),
|
||||
@@ -167,6 +172,11 @@ class InvestmentPortfolioController extends Controller
|
||||
$data = $request->validate(['version_no' => ['required', 'integer', 'min:1'], 'title' => ['required', 'string', 'max:255'], 'source' => ['required', 'string', 'max:2000'],
|
||||
'content' => ['required', 'array:name,description,location,region,sector,promotion,facts,partners,cta,anchors,gaps,priority,clusters,focus,notice,code'],
|
||||
'content.*' => ['nullable', 'string', 'max:15000']]);
|
||||
if (app(PortalEditorialWorkflow::class)->portfolioWrites($dossier->id)) {
|
||||
app(PortalEditorialWorkflow::class)->savePortfolio($request->user(), $dossier, (int) $data['version_no'], $data);
|
||||
|
||||
return back()->with('success', 'Edição privada guardada. A publicação anterior permanece disponível; continue no circuito editorial.');
|
||||
}
|
||||
DB::transaction(function () use ($request, $dossier, $data) {
|
||||
$dossier = InvestmentDossier::whereKey($dossier->id)->lockForUpdate()->firstOrFail();
|
||||
abort_if($dossier->version_no !== (int) $data['version_no'], 409, 'A ficha foi alterada. Recarregue a página e reveja a versão actual antes de guardar.');
|
||||
@@ -179,6 +189,7 @@ class InvestmentPortfolioController extends Controller
|
||||
|
||||
public function publish(Request $request, InvestmentDossier $dossier): RedirectResponse
|
||||
{
|
||||
abort_if(app(PortalEditorialWorkflow::class)->portfolioWrites($dossier->id), 409, 'Use a aprovação e publicação separadas da edição no circuito editorial.');
|
||||
$data = $request->validate(['version_no' => ['required', 'integer', 'min:1'], 'approval_evidence' => ['required', 'string', 'min:15', 'max:3000']]);
|
||||
DB::transaction(function () use ($request, $dossier, $data) {
|
||||
$dossier = InvestmentDossier::whereKey($dossier->id)->lockForUpdate()->firstOrFail();
|
||||
|
||||
@@ -11,6 +11,8 @@ use App\Models\ValueChain;
|
||||
use App\Services\ClusterCompetitiveness;
|
||||
use App\Services\InvestmentGeography;
|
||||
use App\Services\PortalAudit;
|
||||
use App\Services\PortalEditorialSubjects;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use Illuminate\Http\RedirectResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
@@ -31,19 +33,35 @@ class InvestmentStructureController extends Controller
|
||||
});
|
||||
}
|
||||
|
||||
return Inertia::render('structures/index', ['structure' => $structure, 'filters' => $filters,
|
||||
'records' => $query->orderBy('name')->orderBy('id')->paginate(20)->withQueryString()]);
|
||||
$records = $query->orderBy('name')->orderBy('id')->paginate(20)->withQueryString();
|
||||
if ($structure === 'clusters' && app(ClusterCompetitiveness::class)->editorialEnabled()) {
|
||||
$records->through(function ($record) {
|
||||
$analysis = app(ClusterCompetitiveness::class)->current($record->id);
|
||||
$record->setAttribute('editorial_state', $analysis['workflow']['state'] ?? ($analysis['approved'] ? 'legacy_published' : 'not_started'));
|
||||
|
||||
return $record;
|
||||
});
|
||||
}
|
||||
|
||||
return Inertia::render('structures/index', ['structure' => $structure, 'filters' => $filters, 'records' => $records]);
|
||||
}
|
||||
|
||||
public function edit(Request $request, string $structure, ?string $id = null): Response
|
||||
{
|
||||
$model = $this->model($structure);
|
||||
$record = $id ? $model::findOrFail($id) : null;
|
||||
$editorialDossier = $id ? app(PortalEditorialWorkflow::class)->structureDossier($structure, $id) : null;
|
||||
if ($record && $editorialDossier) {
|
||||
$record = app(PortalEditorialWorkflow::class)->workingStructure($record, $editorialDossier);
|
||||
} elseif ($record && app(PortalEditorialSubjects::class)->available()) {
|
||||
$record = clone $record;
|
||||
$record->forceFill(get_object_vars(app(PortalEditorialSubjects::class)->working($structure, (object) $record->getAttributes())));
|
||||
}
|
||||
|
||||
return Inertia::render('structures/editor', ['structure' => $structure, 'record' => $record,
|
||||
return Inertia::render('structures/editor', ['editorialDossier' => $editorialDossier?->id, 'editorialSubject' => ! $editorialDossier && $record && app(PortalEditorialSubjects::class)->available() ? '/management/editorial/subjects/'.$structure.'/'.$id : null, 'structuralEditorial' => app(PortalEditorialSubjects::class)->available(), 'structure' => $structure, 'record' => $record,
|
||||
'projects' => $structure === 'clusters' && $id ? Project::orderBy('name')->get(['id', 'name', 'code']) : [],
|
||||
'chains' => $structure === 'clusters' && $id ? ValueChain::where('cluster_id', $id)->orderBy('code')->get() : [],
|
||||
'gaps' => $structure === 'clusters' && $id ? InvestmentGap::where('cluster_id', $id)->orderBy('created_at')->get() : [],
|
||||
'chains' => $structure === 'clusters' && $id ? ValueChain::where('cluster_id', $id)->orderBy('code')->get()->map(fn ($row) => app(PortalEditorialSubjects::class)->available() ? app(PortalEditorialSubjects::class)->working('value-chains', (object) $row->getAttributes()) : $row) : [],
|
||||
'gaps' => $structure === 'clusters' && $id ? InvestmentGap::where('cluster_id', $id)->orderBy('created_at')->get()->map(fn ($row) => app(PortalEditorialSubjects::class)->available() ? app(PortalEditorialSubjects::class)->working('investment-gaps', (object) $row->getAttributes()) : $row) : [],
|
||||
'chainLinks' => $structure === 'clusters' && $id ? DB::table('value_chain_links')
|
||||
->join('value_chains as origins', 'origins.id', '=', 'value_chain_links.from_value_chain_id')
|
||||
->join('value_chains as destinations', 'destinations.id', '=', 'value_chain_links.to_value_chain_id')
|
||||
@@ -56,7 +74,7 @@ class InvestmentStructureController extends Controller
|
||||
'memberships' => $structure === 'clusters' && $id ? DB::table('cluster_projects')
|
||||
->join('projects', 'projects.id', '=', 'cluster_projects.project_id')
|
||||
->where('cluster_id', $id)->whereNull('cluster_projects.deleted_at')->whereNull('projects.deleted_at')
|
||||
->orderBy('projects.name')->get(['cluster_projects.id', 'cluster_projects.project_id', 'cluster_projects.role', 'cluster_projects.association_type', 'cluster_projects.source_reference', 'cluster_projects.evidence_reference', 'cluster_projects.valid_from', 'cluster_projects.valid_until', 'cluster_projects.validation_status', 'cluster_projects.version_no', 'cluster_projects.editor_id', 'projects.name']) : [],
|
||||
->orderBy('projects.name')->get(['cluster_projects.id', 'cluster_projects.project_id', 'cluster_projects.role', 'cluster_projects.association_type', 'cluster_projects.source_reference', 'cluster_projects.evidence_reference', 'cluster_projects.valid_from', 'cluster_projects.valid_until', 'cluster_projects.validation_status', 'cluster_projects.version_no', 'cluster_projects.editor_id', 'projects.name'])->map(fn ($row) => app(PortalEditorialSubjects::class)->working('cluster-project', $row)) : [],
|
||||
]);
|
||||
}
|
||||
|
||||
@@ -67,11 +85,16 @@ class InvestmentStructureController extends Controller
|
||||
$isCorridor = $structure === 'corridors';
|
||||
$model = $this->model($structure);
|
||||
$record = $id ? $model::findOrFail($id) : new $model;
|
||||
$editorialDossier = $id ? app(PortalEditorialWorkflow::class)->structureDossier($structure, $id, true) : null;
|
||||
$subjectWrites = ! $editorialDossier && ($id ? app(PortalEditorialSubjects::class)->writes($structure, $id) : app(PortalEditorialSubjects::class)->available());
|
||||
$rules = [
|
||||
'code' => ['required', 'string', 'max:100', Rule::unique($record->getTable(), 'code')->whereNull('deleted_at')->ignore($record->getKey())],
|
||||
'name' => ['required', 'string', 'max:200'],
|
||||
'status' => ['required', Rule::in($isProject ? ['draft', 'planned', 'active', 'suspended', 'completed', 'cancelled'] : ($isCluster ? ['planned', 'active', 'inactive'] : ['proposed', 'active', 'closed']))],
|
||||
];
|
||||
if ($editorialDossier || ($subjectWrites && $id)) {
|
||||
$rules['editorial_version'] = ['required', 'integer', 'min:1'];
|
||||
}
|
||||
if ($isProject || $isCorridor) {
|
||||
$rules['description'] = ['nullable', 'string', 'max:10000'];
|
||||
}
|
||||
@@ -96,6 +119,22 @@ class InvestmentStructureController extends Controller
|
||||
$data['primary_territory_id'] = $path === [] ? null : $path[array_key_last($path)]->id;
|
||||
$data['territory_version'] = $path === [] ? 0 : 1;
|
||||
}
|
||||
if ($editorialDossier) {
|
||||
app(PortalEditorialWorkflow::class)->saveStructure($request->user(), $record, $editorialDossier, (int) $data['editorial_version'], $data);
|
||||
|
||||
return redirect('/management/'.$structure.'/'.$record->getKey().'/edit')->with('success', 'Dados-base guardados numa edição privada da carteira. A publicação anterior está preservada.');
|
||||
}
|
||||
if ($subjectWrites) {
|
||||
DB::transaction(function () use ($request, $record, $structure, $id, $data): void {
|
||||
$fields = array_diff_key($data, ['editorial_version' => true]);
|
||||
if (! $id) {
|
||||
PortalAudit::save($record, $fields, $request->user()->id);
|
||||
}
|
||||
app(PortalEditorialWorkflow::class)->saveSubject($request->user(), $structure, (string) $record->getKey(), $id ? (int) $data['editorial_version'] : 0, $fields, ! $id);
|
||||
});
|
||||
|
||||
return redirect('/management/'.$structure.'/'.$record->getKey().'/edit')->with('success', 'Proposta privada guardada. Reveja a edição antes de publicar as alterações.');
|
||||
}
|
||||
PortalAudit::save($record, $data, $request->user()->id);
|
||||
|
||||
return redirect('/management/'.$structure.'/'.$record->getKey().'/edit')->with('success', 'Registo guardado.');
|
||||
@@ -114,6 +153,7 @@ class InvestmentStructureController extends Controller
|
||||
|
||||
public function linkProject(Request $request, EconomicCluster $cluster): RedirectResponse
|
||||
{
|
||||
$editorial = app(PortalEditorialSubjects::class)->available();
|
||||
$data = $request->validate(['project_id' => ['required', 'uuid', Rule::exists('projects', 'id')->whereNull('deleted_at')],
|
||||
'version_no' => ['required', 'integer', 'min:0'],
|
||||
'role' => ['required', Rule::in(['anchor', 'complementary', 'supporting'])],
|
||||
@@ -121,10 +161,21 @@ class InvestmentStructureController extends Controller
|
||||
'source_reference' => ['required', 'string', 'min:10', 'max:2000'],
|
||||
'evidence_reference' => ['required', 'string', 'min:3', 'max:2000'],
|
||||
'valid_from' => ['required', 'date_format:Y-m-d'],
|
||||
'valid_until' => ['nullable', 'date_format:Y-m-d', 'after_or_equal:valid_from']]);
|
||||
DB::transaction(function () use ($cluster, $data, $request) {
|
||||
'valid_until' => ['nullable', 'date_format:Y-m-d', 'after_or_equal:valid_from'],
|
||||
...($editorial ? ['editorial_version' => ['required', 'integer', 'min:0']] : [])]);
|
||||
DB::transaction(function () use ($cluster, $data, $request, $editorial) {
|
||||
EconomicCluster::whereKey($cluster->id)->lockForUpdate()->firstOrFail();
|
||||
$link = ClusterProject::where('cluster_id', $cluster->id)->where('project_id', $data['project_id'])->whereNull('deleted_at')->lockForUpdate()->first();
|
||||
if ($editorial || ($link && app(PortalEditorialSubjects::class)->writes('cluster-project', $link->id))) {
|
||||
abort_unless((int) $data['version_no'] === ($link ? (int) $link->version_no : 0), 409, 'A associação foi alterada. Confira a versão actual.');
|
||||
$fields = [...array_diff_key($data, ['version_no' => true, 'editorial_version' => true]), 'cluster_id' => $cluster->id];
|
||||
if (! $link) {
|
||||
$fields += ['validation_status' => 'pending', 'editor_id' => $request->user()->id, 'validator_id' => null, 'version_no' => 1];
|
||||
}
|
||||
app(PortalEditorialSubjects::class)->stageModel($request->user(), 'cluster-project', $link ?? new ClusterProject, $fields, (int) $data['editorial_version']);
|
||||
|
||||
return;
|
||||
}
|
||||
if ($link) {
|
||||
abort_if((int) $link->version_no !== (int) $data['version_no'], 409, 'Versao da associacao alterada.');
|
||||
$changed = false;
|
||||
@@ -155,10 +206,17 @@ class InvestmentStructureController extends Controller
|
||||
public function saveChain(Request $request, EconomicCluster $cluster, ?ValueChain $chain = null): RedirectResponse
|
||||
{
|
||||
abort_if($chain && $chain->cluster_id !== $cluster->id, 404);
|
||||
$editorial = $chain ? app(PortalEditorialSubjects::class)->writes('value-chains', $chain->id) : app(PortalEditorialSubjects::class)->available();
|
||||
$data = $request->validate(['code' => ['required', 'string', 'max:100',
|
||||
Rule::unique('value_chains', 'code')->where('cluster_id', $cluster->id)->whereNull('deleted_at')->ignore($chain?->id)],
|
||||
'name' => ['required', 'string', 'max:200'],
|
||||
'stage' => ['required', Rule::in(['input', 'production', 'processing', 'logistics', 'market'])]]);
|
||||
'stage' => ['required', Rule::in(['input', 'production', 'processing', 'logistics', 'market'])],
|
||||
...($editorial && $chain ? ['editorial_version' => ['required', 'integer', 'min:1']] : [])]);
|
||||
if ($editorial) {
|
||||
$edition = app(PortalEditorialSubjects::class)->stageModel($request->user(), 'value-chains', $chain ?? new ValueChain, [...array_diff_key($data, ['editorial_version' => true]), 'cluster_id' => $cluster->id], $chain ? (int) $data['editorial_version'] : 0);
|
||||
|
||||
return redirect('/management/editorial/subjects/value-chains/'.$edition->subject_key)->with('success', 'Etapa guardada numa proposta privada.');
|
||||
}
|
||||
PortalAudit::save($chain ?? new ValueChain, [...$data, 'cluster_id' => $cluster->id], $request->user()->id);
|
||||
|
||||
return back()->with('success', 'Etapa da cadeia de valor guardada.');
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Services\PortalEditorialSubjects;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use Illuminate\Http\RedirectResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
@@ -30,7 +32,8 @@ class InvestmentStructureRelationController extends Controller
|
||||
...($kind === 'cluster-project' ? ['role' => ['required', Rule::in(['anchor', 'complementary', 'supporting'])]] : []),
|
||||
]);
|
||||
|
||||
DB::transaction(function () use ($data, $table, $left, $right, $leftTable, $request): void {
|
||||
$proposal = null;
|
||||
DB::transaction(function () use ($data, $table, $left, $right, $leftTable, $request, $kind, &$proposal): void {
|
||||
DB::table($leftTable)->where('id', $data[$left])->lockForUpdate()->firstOrFail();
|
||||
$existing = DB::table($table)->where($left, $data[$left])->where($right, $data[$right])->whereNull('deleted_at')->lockForUpdate()->first();
|
||||
abort_if($existing !== null, 409, 'Associacao ja registada.');
|
||||
@@ -40,8 +43,15 @@ class InvestmentStructureRelationController extends Controller
|
||||
$id = (string) Str::uuid();
|
||||
DB::table($table)->insert([...$values, 'id' => $id, 'source_system' => 'portal-management']);
|
||||
$this->audit($request, $table, $id, 'submitted', 1);
|
||||
if (app(PortalEditorialSubjects::class)->available()) {
|
||||
$proposal = app(PortalEditorialWorkflow::class)->saveSubject($request->user(), $kind, $id, 0, $data, true);
|
||||
}
|
||||
});
|
||||
|
||||
if ($proposal) {
|
||||
return redirect('/management/editorial/subjects/'.$kind.'/'.$proposal->subject_key)->with('success', 'Associação guardada numa proposta privada.');
|
||||
}
|
||||
|
||||
return back()->with('success', 'Associacao submetida para revisao independente.');
|
||||
}
|
||||
|
||||
@@ -50,6 +60,12 @@ class InvestmentStructureRelationController extends Controller
|
||||
abort_unless(in_array($action, ['validate', 'revoke'], true), 404);
|
||||
[$table] = $this->definition($kind);
|
||||
$data = $request->validate(['version_no' => ['required', 'integer', 'min:1']]);
|
||||
if (app(PortalEditorialSubjects::class)->writes($kind, $id)) {
|
||||
app(PortalEditorialSubjects::class)->authorize($request->user(), $kind, $id, true);
|
||||
abort_if($request->expectsJson(), 409, 'Continue em /management/editorial/subjects/'.$kind.'/'.$id.' para rever a edição e publicar a decisão separadamente.');
|
||||
|
||||
return redirect('/management/editorial/subjects/'.$kind.'/'.$id)->with('success', 'Prepare ou confira a edição antes de decidir. Para retirar, marque a proposta de retirada.');
|
||||
}
|
||||
|
||||
DB::transaction(function () use ($request, $table, $id, $action, $data): void {
|
||||
$relation = DB::table($table)->where('id', $id)->lockForUpdate()->first();
|
||||
|
||||
@@ -2,8 +2,16 @@
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Models\DevelopmentCorridor;
|
||||
use App\Models\EconomicCluster;
|
||||
use App\Models\InvestmentDossier;
|
||||
use App\Models\InvestmentZone;
|
||||
use App\Models\Opportunity;
|
||||
use App\Models\Project;
|
||||
use App\Services\InvestmentZoneOperationalProfile;
|
||||
use App\Services\InvestmentZones;
|
||||
use App\Services\PortalEditorialSubjects;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use App\Services\PortalProfileAccess;
|
||||
use App\Services\TerritoryGeometry;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
@@ -82,6 +90,18 @@ class InvestmentTerritoryController extends Controller
|
||||
$table = self::TABLES[$kind] ?? abort(404);
|
||||
$record = DB::table($table)->where('id', $id)->whereNull('deleted_at')->first();
|
||||
abort_unless($record !== null, 404);
|
||||
if ($dossier = app(PortalEditorialWorkflow::class)->structureDossier($kind, $id)) {
|
||||
$model = ['projects' => Project::class, 'clusters' => EconomicCluster::class, 'corridors' => DevelopmentCorridor::class][$kind] ?? abort(404);
|
||||
$working = app(PortalEditorialWorkflow::class)->workingStructure($model::findOrFail($id), $dossier);
|
||||
$record->primary_territory_id = $working->getAttribute('primary_territory_id');
|
||||
$record->territory_version = $working->getAttribute('territory_version');
|
||||
} elseif (in_array($kind, ['projects', 'clusters', 'corridors'], true) && app(PortalEditorialSubjects::class)->available()) {
|
||||
$record = app(PortalEditorialSubjects::class)->working($kind, $record);
|
||||
} elseif ($kind === 'zones' && app(InvestmentZoneOperationalProfile::class)->installed()) {
|
||||
$working = app(InvestmentZoneOperationalProfile::class)->management(InvestmentZone::findOrFail($id));
|
||||
$record->primary_territory_id = $working['primary_territory_id'];
|
||||
$record->territory_version = $working['territory_version'];
|
||||
}
|
||||
$path = [];
|
||||
$current = $record->primary_territory_id;
|
||||
for ($i = 0; $current && $i < 5; $i++) {
|
||||
@@ -93,7 +113,7 @@ class InvestmentTerritoryController extends Controller
|
||||
$current = $location->parent_id;
|
||||
}
|
||||
|
||||
return response()->json(['version' => $record->territory_version, 'path' => $path]);
|
||||
return response()->json(['version' => $record->territory_version, 'path' => $path])->header('Cache-Control', 'private, no-store');
|
||||
}
|
||||
|
||||
public function save(Request $request, string $kind, string $id): JsonResponse
|
||||
@@ -103,11 +123,29 @@ class InvestmentTerritoryController extends Controller
|
||||
abort_unless($request->user()->two_factor_confirmed_at && $request->user()->two_factor_secret, 403);
|
||||
}
|
||||
$data = $request->validate(['version' => ['required', 'integer', 'min:0'], 'path' => ['present', 'array', 'max:4'], 'path.*' => ['required', 'uuid', 'distinct']]);
|
||||
$version = DB::transaction(function () use ($request, $table, $id, $data) {
|
||||
$dossier = app(PortalEditorialWorkflow::class)->structureDossier($kind, $id, true);
|
||||
$structural = ! $dossier && in_array($kind, ['projects', 'clusters', 'corridors'], true) && app(PortalEditorialSubjects::class)->writes($kind, $id);
|
||||
$version = DB::transaction(function () use ($request, $table, $id, $data, $dossier, $kind, $structural) {
|
||||
if ($dossier) {
|
||||
$dossier = InvestmentDossier::whereKey($dossier->id)->lockForUpdate()->firstOrFail();
|
||||
}
|
||||
DB::select('SELECT pg_advisory_xact_lock(280926, 150000)');
|
||||
if ($structural) {
|
||||
app(PortalEditorialSubjects::class)->lock($kind, $id, ['primary_territory_id' => $data['path'] === [] ? null : $data['path'][array_key_last($data['path'])]]);
|
||||
}
|
||||
$record = DB::table($table)->where('id', $id)->whereNull('deleted_at')->lockForUpdate()->first();
|
||||
abort_unless($record !== null, 404);
|
||||
abort_unless((int) $record->territory_version === $data['version'], 409, 'Localização alterada. Recarregue a ficha.');
|
||||
$effectiveVersion = (int) $record->territory_version;
|
||||
if ($dossier) {
|
||||
$model = ['projects' => Project::class, 'clusters' => EconomicCluster::class, 'corridors' => DevelopmentCorridor::class][$kind] ?? abort(404);
|
||||
$effectiveVersion = (int) app(PortalEditorialWorkflow::class)->workingStructure($model::findOrFail($id), $dossier)->getAttribute('territory_version');
|
||||
} elseif ($structural) {
|
||||
$effectiveVersion = (int) app(PortalEditorialSubjects::class)->working($kind, $record)->territory_version;
|
||||
} elseif ($kind === 'zones' && app(InvestmentZoneOperationalProfile::class)->installed()) {
|
||||
$working = app(InvestmentZoneOperationalProfile::class)->management(InvestmentZone::findOrFail($id));
|
||||
$effectiveVersion = (int) $working['territory_version'];
|
||||
}
|
||||
abort_unless($effectiveVersion === $data['version'], 409, 'Localização alterada. Recarregue a ficha.');
|
||||
$parent = null;
|
||||
$names = [];
|
||||
foreach (array_values($data['path']) as $index => $locationId) {
|
||||
@@ -119,13 +157,26 @@ class InvestmentTerritoryController extends Controller
|
||||
$names[] = $location->name;
|
||||
}
|
||||
$version = $data['version'] + 1;
|
||||
if ($dossier) {
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
$workflow->saveStructure($request->user(), $model::findOrFail($id), $dossier, (int) $workflow->workingPortfolio($dossier)->getAttribute('version_no'), ['primary_territory_id' => $parent, 'territory_version' => $version]);
|
||||
|
||||
return $version;
|
||||
}
|
||||
if ($structural) {
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
$workflow->saveSubject($request->user(), $kind, $id, $workflow->subjectVersion($kind, $id), ['primary_territory_id' => $parent, 'territory_version' => $version]);
|
||||
|
||||
return $version;
|
||||
}
|
||||
$changes = ['primary_territory_id' => $parent, 'territory_version' => $version, 'updated_at' => now()];
|
||||
if (in_array($table, ['opportunities', 'investment_zones'], true)) {
|
||||
$changes['province'] = $names[0] ?? null;
|
||||
$changes['district'] = $names[1] ?? null;
|
||||
}
|
||||
if ($table === 'investment_zones') {
|
||||
app(InvestmentZones::class)->save($id, [...$changes, 'version_no' => $record->version_no], $request->user()->id);
|
||||
$workingVersion = app(InvestmentZoneOperationalProfile::class)->workingVersion(InvestmentZone::findOrFail($id));
|
||||
app(InvestmentZones::class)->save($id, [...$changes, 'version_no' => $workingVersion], $request->user()->id);
|
||||
} else {
|
||||
DB::table($table)->where('id', $id)->update($changes);
|
||||
}
|
||||
@@ -136,6 +187,8 @@ class InvestmentTerritoryController extends Controller
|
||||
return $version;
|
||||
});
|
||||
|
||||
return response()->json(['version' => $version]);
|
||||
$zoneDraft = $kind === 'zones' && (app(InvestmentZoneOperationalProfile::class)->editorialEnabled() || DB::table('investment_zones')->where('id', $id)->value('category') === 'industrial_park');
|
||||
|
||||
return response()->json(['version' => $version, 'pending_publication' => $dossier !== null || $structural || $zoneDraft]);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -12,6 +12,7 @@ use App\Services\InvestmentGeography;
|
||||
use App\Services\InvestmentOpportunityAlerts;
|
||||
use App\Services\InvestmentProfileCommands;
|
||||
use App\Services\InvestmentWorkspace;
|
||||
use App\Services\VirtualDesk;
|
||||
use App\Services\OpportunityManagement;
|
||||
use App\Services\OrganizationCountry;
|
||||
use App\Services\Procurement;
|
||||
@@ -28,6 +29,8 @@ class InvestmentWorkspaceController extends Controller
|
||||
{
|
||||
public function profile(Request $request, InvestmentWorkspace $workspace): \Symfony\Component\HttpFoundation\Response
|
||||
{
|
||||
$entry = $request->validate(['dossier' => 'nullable|uuid']);
|
||||
$continuation = ! empty($entry['dossier']) ? app(VirtualDesk::class)->case($request->user(), $entry['dossier']) : null;
|
||||
$data = ['actorId' => $request->user()->id, 'organizationCountryAvailable' => app(OrganizationCountry::class)->available(), 'organizations' => app(OrganizationCountry::class)->represented($request->user()), 'countries' => app(CountryCatalogue::class)->all(), 'account' => $workspace->account($request->user()->id), 'companies' => DB::table('investment_company_declarations')
|
||||
->where('user_id', $request->user()->id)->orderByDesc('created_at')->get(['id', 'version', 'payload'])->map(function ($company) {
|
||||
$company->payload = json_decode(Crypt::decryptString($company->payload), true, 512, JSON_THROW_ON_ERROR);
|
||||
@@ -36,6 +39,13 @@ class InvestmentWorkspaceController extends Controller
|
||||
return $company;
|
||||
})];
|
||||
|
||||
$data['continuation'] = $continuation ? ['id' => $continuation->id, 'title' => $continuation->title, 'href' => '/investimentos/'.$continuation->id.'#entidade-promotora'] : null;
|
||||
$forms = config('company-comparison.forms');
|
||||
abort_unless(is_array($forms), 503, 'As formas jurídicas estão temporariamente indisponíveis.');
|
||||
$data['legalForms'] = [];
|
||||
foreach ($forms as $code => $form) {
|
||||
$data['legalForms'][] = ['value' => $code, 'label' => $form['title']];
|
||||
}
|
||||
Inertia::encryptHistory();
|
||||
|
||||
$response = $request->expectsJson() ? response()->json($data) : Inertia::render('investment/profile', $data)->toResponse($request);
|
||||
@@ -77,7 +87,8 @@ class InvestmentWorkspaceController extends Controller
|
||||
public function company(Request $request, ?string $id = null): RedirectResponse|JsonResponse
|
||||
{
|
||||
$data = $request->validate(['version' => ['required', 'integer', 'min:0'], 'operation_key' => ['sometimes', 'required', 'uuid'],
|
||||
'payload' => ['required', 'array:name,country,incorporation_country_code,registration,sector,role,description'],
|
||||
'payload' => ['required', 'array:name,country,incorporation_country_code,registration,legal_form,sector,role,description'],
|
||||
'payload.legal_form' => ['nullable', \Illuminate\Validation\Rule::in(array_keys(config('company-comparison.forms')))],
|
||||
'payload.incorporation_country_code' => ['nullable', 'string', app(CountryCatalogue::class)->rule()],
|
||||
'payload.name' => ['required', 'string', 'min:2', 'max:200'], 'payload.country' => ['required_without:payload.incorporation_country_code', 'nullable', 'string', 'max:100'],
|
||||
'payload.registration' => ['nullable', 'string', 'max:100'], 'payload.sector' => ['nullable', 'string', 'max:150'],
|
||||
|
||||
@@ -19,6 +19,8 @@ use App\Services\InvestmentZones;
|
||||
use App\Services\PublicSearchMetrics;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\Crypt;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Illuminate\Validation\Rule;
|
||||
@@ -291,6 +293,13 @@ class InvestmentZoneController extends Controller
|
||||
return response()->json(app(InvestmentZoneOperationalProfile::class)->management($saved));
|
||||
}
|
||||
|
||||
public function editorialReview(Request $request, string $id, string $action): JsonResponse
|
||||
{
|
||||
$data = $request->validate(['version_no' => 'required|integer|min:1', 'reason' => 'required|string|min:10|max:3000']);
|
||||
|
||||
return response()->json(app(InvestmentZoneOperationalProfile::class)->review($id, $request->user(), (int) $data['version_no'], $action, $data['reason']));
|
||||
}
|
||||
|
||||
public function revisions(string $id): JsonResponse
|
||||
{
|
||||
InvestmentZone::findOrFail($id);
|
||||
@@ -298,6 +307,30 @@ class InvestmentZoneController extends Controller
|
||||
return response()->json(DB::table('investment_zone_revisions')->where('zone_id', $id)->orderByDesc('version_no')->paginate(20, ['id', 'version_no', 'actor_id', 'action', 'sha256', 'created_at']));
|
||||
}
|
||||
|
||||
public function revision(Request $request, string $id, int $version): JsonResponse
|
||||
{
|
||||
abort_unless(app(InvestmentZoneOperationalProfile::class)->reviewAccess($request->user()), 403);
|
||||
InvestmentZone::findOrFail($id);
|
||||
$revision = DB::table('investment_zone_revisions')->where('zone_id', $id)->where('version_no', $version)->first();
|
||||
abort_unless($revision !== null, 404);
|
||||
try {
|
||||
$json = Crypt::decryptString($revision->snapshot);
|
||||
abort_unless(hash_equals($revision->sha256, hash('sha256', $json)), 409);
|
||||
$snapshot = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
|
||||
$fields = $snapshot['draft']['fields'] ?? $snapshot['public'] ?? $snapshot;
|
||||
$details = $fields['operational_details'] ?? [];
|
||||
if (isset($details['private_ciphertext'])) {
|
||||
$details = json_decode(Crypt::decryptString($details['private_ciphertext']), true, 512, JSON_THROW_ON_ERROR);
|
||||
}
|
||||
} catch (\Throwable $e) {
|
||||
abort(409, 'Não foi possível conferir esta versão. O histórico foi preservado.');
|
||||
}
|
||||
|
||||
return response()->json(['version_no' => $revision->version_no, 'action' => $revision->action,
|
||||
'fields' => Arr::only($fields, ['name', 'description']),
|
||||
'observations' => array_map(fn ($row) => Arr::only($row, ['label', 'value', 'unit', 'scope', 'period_start', 'period_end', 'source_reference']), $details['integral']['observations'] ?? [])]);
|
||||
}
|
||||
|
||||
public function validateLocation(Request $request, InvestmentZones $zones, string $id): JsonResponse
|
||||
{
|
||||
InvestmentZoneAccess::requireRole($request->user(), 'territory_reviewers');
|
||||
|
||||
@@ -3,6 +3,8 @@
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Models\InvestmentZone;
|
||||
use App\Services\PortalEditorialSubjects;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
@@ -36,14 +38,28 @@ class InvestmentZoneRelationController extends Controller
|
||||
DB::table('investment_zone_relations')->insert([...$data, 'id' => $relation, 'zone_id' => $id,
|
||||
'editor_id' => $request->user()->id, 'created_at' => now(), 'updated_at' => now()]);
|
||||
$this->audit($relation, $request->user()->id, 'created', 1);
|
||||
if (app(PortalEditorialSubjects::class)->available()) {
|
||||
app(PortalEditorialWorkflow::class)->saveSubject($request->user(), 'zone-relations', $relation, 0, [...$data, 'zone_id' => $id], true);
|
||||
}
|
||||
|
||||
return response()->json(DB::table('investment_zone_relations')->where('id', $relation)->first(), 201);
|
||||
$record = DB::table('investment_zone_relations')->where('id', $relation)->first();
|
||||
if (app(PortalEditorialSubjects::class)->available()) {
|
||||
$record->editorial_url = '/management/editorial/subjects/zone-relations/'.$relation;
|
||||
$record->pending_publication = true;
|
||||
}
|
||||
|
||||
return response()->json($record, 201);
|
||||
});
|
||||
}
|
||||
|
||||
public function review(Request $request, string $id, string $action): JsonResponse
|
||||
{
|
||||
$data = $request->validate(['version_no' => ['required', 'integer', 'min:1']]);
|
||||
if (app(PortalEditorialSubjects::class)->writes('zone-relations', $id)) {
|
||||
app(PortalEditorialSubjects::class)->authorize($request->user(), 'zone-relations', $id, true);
|
||||
|
||||
return response()->json(['pending_publication' => true, 'editorial_url' => '/management/editorial/subjects/zone-relations/'.$id]);
|
||||
}
|
||||
|
||||
return DB::transaction(function () use ($request, $id, $action, $data) {
|
||||
$relation = DB::table('investment_zone_relations')->where('id', $id)->lockForUpdate()->first();
|
||||
|
||||
@@ -3,6 +3,7 @@
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Models\InvestmentSubmission;
|
||||
use App\Models\Sector;
|
||||
use App\Services\InvestmentComplements;
|
||||
use App\Services\InvestmentCorridorContext;
|
||||
use App\Services\InvestmentGeography;
|
||||
@@ -19,6 +20,27 @@ use Inertia\Response;
|
||||
|
||||
final class InvestorContextController extends Controller
|
||||
{
|
||||
/** Explicit choices only; a title never assigns an activity or amount.
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
private function ideaEntry(Request $request): array
|
||||
{
|
||||
$entry = $request->validate([
|
||||
'project_title' => 'nullable|string|max:200',
|
||||
'sector_id' => 'nullable|integer|exists:sectors,id',
|
||||
'sector' => 'nullable|string|max:100|exists:sectors,slug',
|
||||
'investment_budget_min' => 'nullable|numeric|min:0',
|
||||
'investment_budget_max' => ['nullable', 'numeric', 'min:0', Rule::when($request->filled('investment_budget_min'), 'gte:investment_budget_min')],
|
||||
'currency' => 'nullable|regex:/^[A-Z]{3}$/D',
|
||||
]);
|
||||
if (empty($entry['sector_id']) && ! empty($entry['sector'])) {
|
||||
$entry['sector_id'] = (string) Sector::where('slug', $entry['sector'])->value('id');
|
||||
}
|
||||
unset($entry['sector']);
|
||||
|
||||
return $entry;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<array-key, mixed>
|
||||
*/
|
||||
@@ -82,17 +104,21 @@ final class InvestorContextController extends Controller
|
||||
|
||||
public function options(Request $r, InvestorContext $context): JsonResponse
|
||||
{
|
||||
$d = $r->validate(['q' => 'nullable|string|max:120']);
|
||||
$d = $r->validate(['q' => 'nullable|string|max:120', 'sector_id' => 'nullable|integer|exists:sectors,id', 'province_id' => 'nullable|uuid', 'district_id' => 'nullable|uuid', 'admin_post_id' => 'nullable|uuid', 'locality_id' => 'nullable|uuid']);
|
||||
$filters = array_intersect_key($d, array_flip(['province_id', 'district_id', 'admin_post_id', 'locality_id']));
|
||||
if (! empty($d['sector_id'])) {
|
||||
$filters['sector'] = Sector::whereKey($d['sector_id'])->firstOrFail()->slug;
|
||||
}
|
||||
|
||||
return response()->json($context->options($d['q'] ?? ''));
|
||||
return response()->json($context->options($d['q'] ?? '', $filters));
|
||||
}
|
||||
|
||||
public function corridorOptions(Request $r): JsonResponse
|
||||
{
|
||||
$data = $r->validate(['corridor' => ['nullable', Rule::in(array_keys(config('investment_corridors')))], 'territory' => 'nullable|uuid']);
|
||||
$data = $r->validate(['corridor' => ['nullable', Rule::in(array_keys(config('investment_corridors')))], 'territory' => 'nullable|uuid', 'include_corridors' => 'nullable|boolean']);
|
||||
$service = app(InvestmentCorridorContext::class);
|
||||
|
||||
return response()->json(['corridors' => collect(Config::array('investment_corridors'))->map(fn ($entry, $key) => ['key' => $key, 'name' => $entry['name'], 'provinces' => $service->provinces($key)])->values(),
|
||||
return response()->json(['corridors' => ($data['include_corridors'] ?? true) ? collect(Config::array('investment_corridors'))->map(fn ($entry, $key) => ['key' => $key, 'name' => $entry['name'], 'provinces' => $service->provinces($key)])->values() : [],
|
||||
'parks' => $service->parks($data['corridor'] ?? null, $data['territory'] ?? null)]);
|
||||
}
|
||||
|
||||
@@ -101,6 +127,16 @@ final class InvestorContextController extends Controller
|
||||
return response()->json($context->saveDraft($r->user(), $id, $r->all()));
|
||||
}
|
||||
|
||||
public function supplyAggregate(Request $r, string $id, InvestorContext $context): JsonResponse
|
||||
{
|
||||
return response()->json($context->saveSupplyAggregate($r->user(), $id, $r->all()))->header('Cache-Control', 'private, no-store');
|
||||
}
|
||||
|
||||
public function promoter(Request $r, string $id, InvestorContext $context): JsonResponse
|
||||
{
|
||||
return response()->json($r->isMethod('GET') ? $context->promoter($r->user(), $id) : $context->setPromoter($r->user(), $id, $r->all()))->header('Cache-Control', 'private, no-store');
|
||||
}
|
||||
|
||||
public function edit(Request $r, string $id, InvestorContext $context): Response
|
||||
{
|
||||
$data = $context->view($r->user(), $id);
|
||||
@@ -133,8 +169,8 @@ final class InvestorContextController extends Controller
|
||||
}
|
||||
}
|
||||
$complements = isset($draft['complements']) ? app(InvestmentComplements::class)->resolve($draft['complements'], $data['context']['complements'] ?? []) : ($data['context']['complements'] ?? []);
|
||||
$entryTerritory = null;
|
||||
if (($source['kind'] ?? null) === 'portfolio') {
|
||||
$entryTerritory = ($source['kind'] ?? '') === 'territory' ? $source : null;
|
||||
if ($r->hasAny(['province_id', 'district_id', 'admin_post_id', 'locality_id'])) {
|
||||
$path = app(InvestmentGeography::class)->selection($r->validate(['province_id' => 'nullable|uuid', 'district_id' => 'nullable|uuid', 'admin_post_id' => 'nullable|uuid', 'locality_id' => 'nullable|uuid']));
|
||||
if ($path) {
|
||||
$entryTerritory = $context->reference('territory:'.$path[array_key_last($path)]->id);
|
||||
@@ -148,7 +184,7 @@ final class InvestorContextController extends Controller
|
||||
}
|
||||
}
|
||||
|
||||
return Inertia::render('investor-path/context', ['entryTerritory' => $entryTerritory, 'entryComplements' => $complements, 'entryLocationDifferences' => $differences, 'entrySources' => $entrySources, 'draft' => $draft, 'requestedChoices' => $choices, 'initial' => $data, 'options' => $context->options(), 'source' => $source, 'territorySelection' => isset($data['context']['selection']['territory']) ? app(InvestmentGeography::class)->path($data['context']['selection']['territory']['id']) : ($entryTerritory ? app(InvestmentGeography::class)->path($entryTerritory['id']) : [])]);
|
||||
return Inertia::render('investor-path/context', ['entryIdea' => $this->ideaEntry($r), 'entryTerritory' => $entryTerritory, 'entryComplements' => $complements, 'entryLocationDifferences' => $differences, 'entrySources' => $entrySources, 'draft' => $draft, 'requestedChoices' => $choices, 'initial' => $data, 'options' => $context->options(), 'source' => $source, 'territorySelection' => isset($data['context']['selection']['territory']) ? app(InvestmentGeography::class)->path($data['context']['selection']['territory']['id']) : ($entryTerritory ? app(InvestmentGeography::class)->path($entryTerritory['id']) : [])]);
|
||||
}
|
||||
|
||||
public function preview(Request $r, string $id, InvestorContext $context): JsonResponse
|
||||
@@ -175,7 +211,7 @@ final class InvestorContextController extends Controller
|
||||
|
||||
$choices = $this->entryChoices($r, $context);
|
||||
|
||||
return Inertia::render('investor-path/context-start', ['entrySubmission' => $entrySubmission, 'entryComplements' => $this->entryComplements($r), 'entryQuery' => $r->only(['complement_origin', 'complement_code', 'complement_target', 'complement_territory', 'from_dossier', 'province_id', 'district_id', 'admin_post_id', 'locality_id']), 'opportunityChoices' => $choices, 'contexts' => $path->contexts($r->user()), 'source' => $ref, 'step' => $d['step'] ?? null]);
|
||||
return Inertia::render('investor-path/context-start', ['entrySubmission' => $entrySubmission, 'entryComplements' => $this->entryComplements($r), 'entryQuery' => [...$this->ideaEntry($r), ...$r->only(['complement_origin', 'complement_code', 'complement_target', 'complement_territory', 'from_dossier', 'province_id', 'district_id', 'admin_post_id', 'locality_id'])], 'opportunityChoices' => $choices, 'contexts' => $path->contexts($r->user()), 'source' => $ref, 'step' => $d['step'] ?? null]);
|
||||
}
|
||||
|
||||
public function installation(Request $r, InvestorContextInstallation $install): JsonResponse|Response
|
||||
|
||||
@@ -8,6 +8,7 @@ use App\Services\InvestmentGuides;
|
||||
use App\Services\InvestmentZonePathContext;
|
||||
use App\Services\InvestorPath;
|
||||
use App\Services\LegacyContent;
|
||||
use App\Services\SectorContentAnalysis;
|
||||
use App\Services\SectorResourceReferences;
|
||||
use App\Services\SectorInvestment;
|
||||
use App\Services\VirtualDesk;
|
||||
@@ -20,6 +21,16 @@ use Inertia\Response;
|
||||
|
||||
class InvestorPathController extends Controller
|
||||
{
|
||||
public function fiscalReport(Request $request, string $id, string $reportId, \App\Services\SimulationFormDrafts $drafts): JsonResponse
|
||||
{
|
||||
abort_unless(app(InvestorPath::class)->available(), 404);
|
||||
$request->validate(['opportunity' => 'nullable|string|max:150']);
|
||||
$data = $drafts->dossierReport($request->user(), $id, $reportId, $request->query('opportunity'));
|
||||
|
||||
return response()->json($data)->header('Content-Disposition', 'attachment; filename="relatorio-fiscal-'.$reportId.'.json"')
|
||||
->header('X-Content-Type-Options', 'nosniff');
|
||||
}
|
||||
|
||||
public function index(Request $request, InvestorPath $path): JsonResponse|Response
|
||||
{
|
||||
abort_unless($path->available(), 404);
|
||||
@@ -89,6 +100,8 @@ class InvestorPathController extends Controller
|
||||
abort_unless(is_int($resourceId) && $resourceId !== 0, 422);
|
||||
app(LegacyContent::class)->articleForResource($resourceId);
|
||||
}
|
||||
$analysis = $source !== null ? app(SectorContentAnalysis::class)->selection(app(LegacyContent::class)->articleForResource((int) $source), $request->all()) : null;
|
||||
abort_if($request->filled('evidence') && $source === null, 422);
|
||||
$id = DB::transaction(function () use ($path, $request, $source, $sector, $zone, $reference): string {
|
||||
if ($reference !== null) {
|
||||
DB::table('users')->where('id', $request->user()->id)->lockForUpdate()->first();
|
||||
@@ -102,7 +115,7 @@ class InvestorPathController extends Controller
|
||||
}
|
||||
if ($source !== null) {
|
||||
$case = $path->view($request->user(), $id)['case'];
|
||||
app(LegacyContent::class)->attach($request->user(), $id, ['version' => $case['version'], 'resource_id' => (int) $source]);
|
||||
app(SectorContentAnalysis::class)->attach($request->user(), $id, ['version' => $case['version'], 'resource_id' => (int) $source, ...$request->only(['evidence', 'source_sha256', 'source_version', 'idea'])]);
|
||||
}
|
||||
|
||||
if ($sector !== null) {
|
||||
@@ -118,7 +131,7 @@ class InvestorPathController extends Controller
|
||||
return $id;
|
||||
});
|
||||
|
||||
$href = $comparison === null ? '/investimentos/'.$id : '/investimentos/'.$id.'/forma-juridica?'.http_build_query(['answers' => $comparison]);
|
||||
$href = $comparison === null ? ($analysis ? app(SectorContentAnalysis::class)->continuation($id, $analysis) : '/investimentos/'.$id) : '/investimentos/'.$id.'/forma-juridica?'.http_build_query(['answers' => $comparison]);
|
||||
if ($guide !== null) {
|
||||
$href = '/investimentos/'.$id.'/guias/'.$guide['slug'].'?'.http_build_query(['current' => 1, 'selection' => 1, 'sha256' => $guide['sha256'], 'instruments' => $guide['instruments']]);
|
||||
}
|
||||
|
||||
@@ -5,6 +5,7 @@ namespace App\Http\Controllers;
|
||||
use App\Services\InvestorPath;
|
||||
use App\Services\LegacyContent;
|
||||
use App\Services\PublicSearchMetrics;
|
||||
use App\Services\SectorContentAnalysis;
|
||||
use App\Services\VirtualDesk;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\RedirectResponse;
|
||||
@@ -40,12 +41,19 @@ class LegacyContentController extends Controller
|
||||
abort_unless($path->available(), 404);
|
||||
$article = $legacy->article($legacySlug);
|
||||
|
||||
return Inertia::render('investor-path/index', ['contexts' => $path->contexts($request->user()), 'contentSource' => $article]);
|
||||
$analysis = app(SectorContentAnalysis::class)->selection($article, $request->all());
|
||||
|
||||
return Inertia::render('investor-path/index', ['contexts' => $path->contexts($request->user()), 'contentSource' => $article, 'sectorIdea' => $analysis, 'analysisAction' => $request->query('analysis_action') === 'compare' ? 'compare' : 'prepare']);
|
||||
}
|
||||
|
||||
public function attach(Request $request, string $id, LegacyContent $legacy): JsonResponse|RedirectResponse
|
||||
{
|
||||
$legacy->attach($request->user(), $id, $request->all());
|
||||
$analysis = app(SectorContentAnalysis::class)->attach($request->user(), $id, $request->all());
|
||||
if ($analysis) {
|
||||
$href = app(SectorContentAnalysis::class)->continuation($id, $analysis);
|
||||
|
||||
return $request->expectsJson() ? response()->json(['saved' => true, 'continue' => $href]) : redirect($href);
|
||||
}
|
||||
|
||||
return $request->expectsJson() ? response()->json(['saved' => true]) : redirect('/investimentos/'.$id)->with('success', 'Referência guardada no dossier.');
|
||||
}
|
||||
|
||||
@@ -0,0 +1,72 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Services\InvestmentGeography;
|
||||
use App\Services\OfferPublicCatalogue;
|
||||
use App\Services\OpportunityManagement;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Inertia\Inertia;
|
||||
use Symfony\Component\HttpFoundation\Response;
|
||||
use Symfony\Component\HttpFoundation\StreamedResponse;
|
||||
|
||||
final class OfferPublicCatalogueController extends Controller
|
||||
{
|
||||
public function index(Request $request, OfferPublicCatalogue $catalogue): Response
|
||||
{
|
||||
$filters = $catalogue->filters($request);
|
||||
|
||||
return $this->uncached(Inertia::render('offers/catalogue', [...$catalogue->page($request, $filters), 'filters' => $filters,
|
||||
'mapData' => in_array($filters['view'] ?? '', ['map', 'combined'], true) ? $catalogue->map($filters) : null,
|
||||
'territorySelection' => app(InvestmentGeography::class)->selection($filters),
|
||||
'references' => ['categories' => OpportunityManagement::CATEGORIES, 'options' => [], 'clusters' => [], 'corridors' => [], 'projects' => [], 'locations' => [], 'sectors' => []]])->toResponse($request));
|
||||
}
|
||||
|
||||
public function show(Request $request, int $id, OfferPublicCatalogue $catalogue): Response
|
||||
{
|
||||
return $this->uncached(Inertia::render('offers/public-detail', ['offer' => $catalogue->detail($id)])->toResponse($request));
|
||||
}
|
||||
|
||||
public function search(Request $request, OfferPublicCatalogue $catalogue): JsonResponse
|
||||
{
|
||||
return response()->json($catalogue->page($request, $catalogue->filters($request)))->header('Cache-Control', 'private, no-store');
|
||||
}
|
||||
|
||||
public function detail(int $id, OfferPublicCatalogue $catalogue): JsonResponse
|
||||
{
|
||||
return response()->json(['data' => $catalogue->detail($id)])->header('Cache-Control', 'private, no-store');
|
||||
}
|
||||
|
||||
public function map(Request $request, OfferPublicCatalogue $catalogue): JsonResponse
|
||||
{
|
||||
return response()->json($catalogue->map($catalogue->filters($request)))->header('Cache-Control', 'private, no-store');
|
||||
}
|
||||
|
||||
public function export(Request $request, OfferPublicCatalogue $catalogue): StreamedResponse
|
||||
{
|
||||
$result = $catalogue->records($catalogue->filters($request));
|
||||
|
||||
return response()->streamDownload(function () use ($result) {
|
||||
$stream = fopen('php://output', 'w');
|
||||
if ($stream === false) {
|
||||
return;
|
||||
}
|
||||
fwrite($stream, "\xEF\xBB\xBF");
|
||||
fputcsv($stream, ['Título', 'Categoria', 'Localização', 'Preço', 'Moeda', 'Publicação', 'URL'], ';', '"', '');
|
||||
foreach ($result['records'] as $record) {
|
||||
$fields = [$record['title'], $record['category'], implode(' / ', array_column($record['location'], 'name')),
|
||||
$record['price']['mode'] === 'negotiable' ? 'A negociar' : $record['price']['amount'], $record['price']['currency'], $record['published_at'], url($record['url'])];
|
||||
fputcsv($stream, array_map(fn ($value) => preg_match('/^[\s]*[=+@-]/u', (string) $value) ? "'".$value : $value, $fields), ';', '"', '');
|
||||
}
|
||||
fclose($stream);
|
||||
}, 'ofertas.csv', ['Content-Type' => 'text/csv; charset=UTF-8', 'Cache-Control' => 'private, no-store', 'X-Export-Limit' => '1000', 'X-Results-Truncated' => $result['truncated'] ? 'true' : 'false']);
|
||||
}
|
||||
|
||||
private function uncached(Response $response): Response
|
||||
{
|
||||
$response->headers->set('Cache-Control', 'private, no-store');
|
||||
|
||||
return $response;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,265 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Models\User;
|
||||
use App\Services\ContentManagement;
|
||||
use App\Services\DocumentManagementAccess;
|
||||
use App\Services\PortalEditorialNativeNotices;
|
||||
use App\Services\PortalEditorialSubjects;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use App\Services\PortalProfileAccess;
|
||||
use App\Services\TerritorialRegistry;
|
||||
use App\Services\VerifiedDocumentBinary;
|
||||
use App\Support\CheckedFile;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
use Inertia\Inertia;
|
||||
use Symfony\Component\HttpFoundation\Response;
|
||||
|
||||
final class PortalEditorialWorkflowController extends Controller
|
||||
{
|
||||
public function subjects(Request $request, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$adapter = app(PortalEditorialSubjects::class);
|
||||
abort_unless($adapter->available() && $request->user()->can('manage-portal') && ! app(PortalProfileAccess::class)->has($request->user(), 'auditor'), 403);
|
||||
$items = $workflow->subjectQueue()->orderByDesc('e.updated_at')->paginate(25, ['e.id', 'e.subject_kind', 'e.subject_key', 'e.revision_no', 'e.state', DB::raw("e.payload->'resource'->>'title' AS title")]);
|
||||
|
||||
return $this->screen($request, 'management/editorial-subjects', ['items' => $items]);
|
||||
}
|
||||
|
||||
public function subject(Request $request, string $kind, string $id, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$adapter = app(PortalEditorialSubjects::class);
|
||||
$adapter->authorize($request->user(), $kind, $id);
|
||||
$record = $adapter->query($kind, $id)->firstOrFail();
|
||||
$selected = $request->validate(['edition' => 'nullable|uuid'])['edition'] ?? null;
|
||||
$latest = $workflow->latestSubject($kind, $id);
|
||||
$editions = DB::table('portal_editorial_editions')->where('subject_kind', $kind)->where('subject_key', $id);
|
||||
$edition = $selected ? (clone $editions)->where('id', $selected)->first() : $latest;
|
||||
abort_if($selected && ! $edition, 404);
|
||||
$payload = $edition ? $workflow->payload($edition) : null;
|
||||
$independent = $edition ? $workflow->requiresIndependent($edition) : $adapter->independent($kind);
|
||||
$canApprove = ! $independent || ! in_array($request->user()->id, $payload['contributors'] ?? [], true);
|
||||
|
||||
return $this->screen($request, 'management/editorial-edition', ['subject' => 'structural', 'subjectKind' => $kind, 'editUrl' => $adapter->editUrl($kind, $record), 'subjectFields' => $adapter->form($kind), 'subjectInitial' => Arr::only(get_object_vars($record), $adapter->definition($kind)['fields']),
|
||||
'resource' => ['id' => $id, 'title' => $record->name ?? $record->title ?? $kind, 'published' => ($record->deleted_at ?? null) === null && ($record->validation_status ?? null) !== 'revoked' && (clone $editions)->where('state', 'published')->exists(), 'public_edition_no' => (clone $editions)->where('state', 'published')->max('revision_no')],
|
||||
'edition' => $edition ? [...get_object_vars($edition), 'payload' => $payload, 'fresh' => $edition->state === 'published' || $workflow->fresh($edition)] : null,
|
||||
'current' => $edition && $edition->id === $latest?->id, 'independentRequired' => $independent, 'canApprove' => $canApprove, 'manager' => true, 'legalReviewer' => false,
|
||||
'reviewers' => User::whereIn('email', config('portal.managers', []))->whereNotNull('email_verified_at')->get(['id', 'name']),
|
||||
'history' => DB::table('audit_events')->where('source_system', 'document-access-v1')->where('action', 'like', 'editorial_%')->where('after_data->subject_kind', $kind)->where('after_data->subject_key', $id)->orderByDesc('id')->get(['id', 'action', 'actor_user_id', 'after_data', 'occurred_at']),
|
||||
'editions' => $editions->orderByDesc('revision_no')->get(['id', 'revision_no', 'state', 'content_hash', 'author_id', 'created_at'])]);
|
||||
}
|
||||
|
||||
public function subjectTransition(Request $request, string $kind, string $id, string $edition, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$result = $workflow->transition($request->user(), $id, $edition, $request->all(), false, false, $kind);
|
||||
|
||||
return $request->expectsJson() ? response()->json(['edition' => $result])->header('Cache-Control', 'private, no-store') : back()->with('success', 'Operação editorial registada.');
|
||||
}
|
||||
|
||||
public function subjectSave(Request $request, string $kind, string $id, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$adapter = app(PortalEditorialSubjects::class);
|
||||
$adapter->authorize($request->user(), $kind, $id, true);
|
||||
$data = $request->validate(['expected_revision' => 'required|integer|min:1', 'fields' => 'required|array', 'withdraw' => 'sometimes|boolean']);
|
||||
$edition = $workflow->saveSubject($request->user(), $kind, $id, (int) $data['expected_revision'], $adapter->validate($kind, $data['fields']), false, $data['withdraw'] ?? null);
|
||||
|
||||
return $request->expectsJson() ? response()->json(['edition' => $edition], 201)->header('Cache-Control', 'private, no-store') : redirect('/management/editorial/subjects/'.$kind.'/'.$id)->with('success', 'Proposta privada guardada.');
|
||||
}
|
||||
|
||||
public function subjectChoices(Request $request, string $kind, string $id): Response
|
||||
{
|
||||
$adapter = app(PortalEditorialSubjects::class);
|
||||
$adapter->authorize($request->user(), $kind, $id);
|
||||
$data = $request->validate(['field' => 'required|string|max:80', 'q' => 'nullable|string|max:100']);
|
||||
|
||||
return response()->json(['data' => $adapter->choices($kind, $data['field'], $data['q'] ?? null), 'limit' => 100])->header('Cache-Control', 'private, no-store');
|
||||
}
|
||||
|
||||
private const KIND = "CASE WHEN e.payload->'resource'->>'legislation' = 'true' OR e.payload->'resource'->>'document_type' = 'legislation' THEN 'legislation' WHEN e.payload->'resource'->>'editorial_content' IS NOT NULL THEN 'article' ELSE 'document' END";
|
||||
|
||||
/** @param array<string,mixed> $data */
|
||||
private function screen(Request $request, string $component, array $data): Response
|
||||
{
|
||||
$response = $request->expectsJson() ? response()->json($data) : Inertia::render($component, $data)->toResponse($request);
|
||||
$response->headers->set('Cache-Control', 'private, no-store');
|
||||
|
||||
return $response;
|
||||
}
|
||||
|
||||
public function index(Request $request, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
abort_unless($workflow->enabled(), 503);
|
||||
$actor = $request->user();
|
||||
$access = app(DocumentManagementAccess::class);
|
||||
$query = $workflow->queue($actor);
|
||||
$filters = array_filter($request->validate(['state' => 'nullable|in:draft,submitted,in_review,approved,published,returned,rejected,archived', 'kind' => 'nullable|in:article,legislation,document']), fn ($value) => $value !== null && $value !== '');
|
||||
if (isset($filters['state'])) {
|
||||
$query->where('e.state', $filters['state']);
|
||||
}
|
||||
if (isset($filters['kind'])) {
|
||||
$query->whereRaw(self::KIND.' = ?', [$filters['kind']]);
|
||||
}
|
||||
$items = $query->orderByDesc('e.updated_at')->paginate(25, ['r.id', DB::raw("e.payload->'resource'->>'title' AS title"), 'r.document_type', 'r.published', 'e.id as edition_id', 'e.revision_no', 'e.state', 'e.legal_required', 'u.name as responsible'])->withQueryString();
|
||||
$destinations = app(ContentManagement::class)->access($actor);
|
||||
$data = ['items' => $items, 'filters' => $filters, 'notices' => $workflow->notices($actor), 'resourceAccess' => $access->full($actor) || $access->editorial($actor), 'opportunitiesUrl' => $destinations['opportunities']['index'] ?? null,
|
||||
'offersUrl' => isset($destinations['opportunities']['index']) && app(PortalProfileAccess::class)->available() ? '/minhas-oportunidades/ofertas' : null,
|
||||
'offerOperationsUrl' => ! app(PortalProfileAccess::class)->has($actor, 'auditor') && (app(PortalProfileAccess::class)->has($actor, 'validator') || app(PortalProfileAccess::class)->has($actor, 'publisher')) ? '/minhas-oportunidades/ofertas?operational=1' : null,
|
||||
'opportunityPending' => $workflow->opportunityPending($actor), 'clustersUrl' => $destinations['clusters']['index'] ?? null,
|
||||
'portfolioUrl' => $destinations['portfolio']['index'] ?? null, 'portfolioPending' => $workflow->portfolioPending($actor), 'demographyUrl' => $destinations['demography']['index'] ?? null, 'demographyPending' => $workflow->demographyPending($actor),
|
||||
'territorialUrl' => app(TerritorialRegistry::class)->editorialAvailable() && $actor->can('manage-portal') ? '/management/territorial/editorial' : null,
|
||||
'nativePending' => app(PortalEditorialNativeNotices::class)->pending($actor), 'zonesUrl' => app(PortalEditorialNativeNotices::class)->access($actor, 'investment-zones') ? '/management/investment/zones' : null,
|
||||
'subjectsUrl' => app(PortalEditorialSubjects::class)->available() && $actor->can('manage-portal') ? '/management/editorial/subjects' : null, 'subjectsPending' => $workflow->subjectPending($actor)];
|
||||
|
||||
return $this->screen($request, 'management/editorial-workflow', $data);
|
||||
}
|
||||
|
||||
public function show(Request $request, int $id, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$workflow->authorize($request->user(), $id);
|
||||
$resource = DB::table('portal_resources')->where('id', $id)->first();
|
||||
abort_unless($resource !== null, 404);
|
||||
$selected = $request->validate(['edition' => 'nullable|uuid'])['edition'] ?? null;
|
||||
$latest = $workflow->latest($id);
|
||||
$e = $selected ? DB::table('portal_editorial_editions')->where('resource_id', $id)->where('id', $selected)->first() : $latest;
|
||||
abort_if($selected && ! $e, 404);
|
||||
$payload = $e ? $workflow->payload($e) : null;
|
||||
$independent = ! $e || ! $workflow->requiresIndependent($e) || ! in_array($request->user()->id, $payload['contributors'], true);
|
||||
$data = ['resource' => ['id' => $id, 'title' => $resource->title, 'published' => (bool) $resource->published, 'public_edition_no' => $resource->published ? DB::table('portal_editorial_editions')->where('resource_id', $id)->where('state', 'published')->max('revision_no') : null], 'edition' => $e ? [...(array) $e, 'payload' => $payload, 'fresh' => $e->state === 'published' || $workflow->fresh($e)] : null,
|
||||
'current' => $e && $e->id === $latest?->id,
|
||||
'independentRequired' => $e ? $workflow->requiresIndependent($e) : false,
|
||||
'canApprove' => $independent && app(DocumentManagementAccess::class)->full($request->user()),
|
||||
'manager' => app(DocumentManagementAccess::class)->full($request->user()),
|
||||
'reviewers' => User::whereIn('email', config('portal.managers', []))->whereNotNull('email_verified_at')->get(['id', 'name']),
|
||||
'legalReviewer' => $workflow->legalReviewer($request->user()),
|
||||
'history' => DB::table('audit_events')->where('source_system', 'document-access-v1')->where('action', 'like', 'editorial_%')->where('after_data->resource_id', $id)->orderByDesc('id')->get(['id', 'action', 'actor_user_id', 'after_data', 'occurred_at']),
|
||||
'editions' => DB::table('portal_editorial_editions')->where('resource_id', $id)->orderByDesc('revision_no')->get(['id', 'revision_no', 'state', 'content_hash', 'author_id', 'created_at'])];
|
||||
|
||||
return $this->screen($request, 'management/editorial-edition', $data);
|
||||
}
|
||||
|
||||
public function transition(Request $request, int $id, string $edition, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$result = $workflow->transition($request->user(), $id, $edition, $request->all());
|
||||
|
||||
return $request->expectsJson() ? response()->json(['edition' => $result])->header('Cache-Control', 'private, no-store') : back()->with('success', 'Operação editorial registada.');
|
||||
}
|
||||
|
||||
public function portfolio(Request $request, string $id, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$workflow->authorizePortfolio($request->user(), $id);
|
||||
$record = DB::table('investment_dossiers')->where('id', $id)->first();
|
||||
abort_unless($record !== null, 404);
|
||||
$selected = $request->validate(['edition' => 'nullable|uuid'])['edition'] ?? null;
|
||||
$latest = $workflow->latestPortfolio($id);
|
||||
$edition = $selected ? DB::table('portal_editorial_editions')->where('dossier_id', $id)->where('id', $selected)->first() : $latest;
|
||||
abort_if($selected && ! $edition, 404);
|
||||
$payload = $edition ? $workflow->payload($edition) : null;
|
||||
$independent = ! $edition || ! in_array($request->user()->id, $payload['contributors'], true);
|
||||
|
||||
return $this->screen($request, 'management/editorial-edition', ['subject' => 'portfolio',
|
||||
'resource' => ['id' => $id, 'title' => $record->title, 'published' => $record->publication_status === 'published', 'public_edition_no' => $record->publication_status === 'published' ? DB::table('portal_editorial_editions')->where('dossier_id', $id)->where('state', 'published')->max('revision_no') : null],
|
||||
'edition' => $edition ? [...get_object_vars($edition), 'payload' => $payload, 'fresh' => $edition->state === 'published' || $workflow->fresh($edition)] : null,
|
||||
'current' => $edition && $edition->id === $latest?->id, 'independentRequired' => true, 'canApprove' => $independent, 'manager' => true, 'legalReviewer' => false,
|
||||
'reviewers' => User::whereIn('email', config('portal.managers', []))->whereNotNull('email_verified_at')->get(['id', 'name']),
|
||||
'history' => DB::table('audit_events')->where('source_system', 'document-access-v1')->where('action', 'like', 'editorial_%')->where('after_data->dossier_id', $id)->orderByDesc('id')->get(['id', 'action', 'actor_user_id', 'after_data', 'occurred_at']),
|
||||
'editions' => DB::table('portal_editorial_editions')->where('dossier_id', $id)->orderByDesc('revision_no')->get(['id', 'revision_no', 'state', 'content_hash', 'author_id', 'created_at'])]);
|
||||
}
|
||||
|
||||
public function portfolioTransition(Request $request, string $id, string $edition, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$result = $workflow->transition($request->user(), $id, $edition, $request->all(), true);
|
||||
|
||||
return $request->expectsJson() ? response()->json(['edition' => $result])->header('Cache-Control', 'private, no-store') : back()->with('success', 'Operação editorial da carteira registada.');
|
||||
}
|
||||
|
||||
public function demography(Request $request, string $id, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$workflow->authorizeDemography($request->user(), $id);
|
||||
$batch = DB::table('demographic_imports')->where('id', $id)->first();
|
||||
abort_unless($batch !== null, 404);
|
||||
$selected = $request->validate(['edition' => 'nullable|uuid'])['edition'] ?? null;
|
||||
$latest = $workflow->latestDemography($id);
|
||||
$edition = $selected ? DB::table('portal_editorial_editions')->where('demographic_import_id', $id)->where('id', $selected)->first() : $latest;
|
||||
abort_if($selected && ! $edition, 404);
|
||||
$payload = $edition ? $workflow->payload($edition) : null;
|
||||
$independent = ! $edition || ! $workflow->requiresIndependent($edition) || ! in_array($request->user()->id, $payload['contributors'], true);
|
||||
|
||||
return $this->screen($request, 'management/editorial-edition', ['subject' => 'demography',
|
||||
'resource' => ['id' => $id, 'title' => $batch->file_name, 'published' => $batch->status === 'approved', 'public_edition_no' => $batch->status === 'approved' ? DB::table('portal_editorial_editions')->where('demographic_import_id', $id)->where('state', 'published')->max('revision_no') : null],
|
||||
'edition' => $edition ? [...get_object_vars($edition), 'payload' => $payload, 'fresh' => $edition->state === 'published' || $workflow->fresh($edition)] : null,
|
||||
'current' => $edition && $edition->id === $latest?->id, 'independentRequired' => $edition ? $workflow->requiresIndependent($edition) : false, 'canApprove' => $independent, 'manager' => true, 'legalReviewer' => false,
|
||||
'reviewers' => User::whereIn('email', config('portal.managers', []))->whereNotNull('email_verified_at')->get(['id', 'name']),
|
||||
'history' => DB::table('audit_events')->where('source_system', 'document-access-v1')->where('action', 'like', 'editorial_%')->where('after_data->demographic_import_id', $id)->orderByDesc('id')->get(['id', 'action', 'actor_user_id', 'after_data', 'occurred_at']),
|
||||
'editions' => DB::table('portal_editorial_editions')->where('demographic_import_id', $id)->orderByDesc('revision_no')->get(['id', 'revision_no', 'state', 'content_hash', 'author_id', 'created_at'])]);
|
||||
}
|
||||
|
||||
public function demographyDraft(Request $request, string $id, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$data = $request->validate(['expected_revision' => 'required|integer|min:0']);
|
||||
$edition = $workflow->saveDemography($request->user(), $id, (int) $data['expected_revision']);
|
||||
|
||||
return $request->expectsJson() ? response()->json(['edition' => $edition], 201)->header('Cache-Control', 'private, no-store') : redirect('/management/editorial/demography/'.$id);
|
||||
}
|
||||
|
||||
public function demographyTransition(Request $request, string $id, string $edition, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$result = $workflow->transition($request->user(), $id, $edition, $request->all(), false, true);
|
||||
|
||||
return $request->expectsJson() ? response()->json(['edition' => $result])->header('Cache-Control', 'private, no-store') : back()->with('success', 'Operação editorial do lote registada.');
|
||||
}
|
||||
|
||||
public function demographyOriginal(Request $request, string $id, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$workflow->authorizeDemography($request->user(), $id);
|
||||
$batch = DB::table('demographic_imports')->where('id', $id)->first();
|
||||
abort_unless($batch !== null, 404);
|
||||
$path = Storage::disk('local')->path('demography/'.$id.'/original.xlsx');
|
||||
abort_unless(CheckedFile::matches($path, trim($batch->sha256)), 409, 'Original indisponível ou alterado.');
|
||||
|
||||
return response()->download($path, basename($batch->file_name), ['Cache-Control' => 'private, no-store', 'X-Robots-Tag' => 'noindex, nofollow']);
|
||||
}
|
||||
|
||||
public function file(Request $request, int $id, string $edition, string $document, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
$workflow->authorize($request->user(), $id);
|
||||
$e = DB::table('portal_editorial_editions')->where('id', $edition)->where('resource_id', $id)->first();
|
||||
abort_unless($e !== null, 404);
|
||||
$file = null;
|
||||
foreach ($workflow->payload($e)['files'] as $entry) {
|
||||
if ($entry['id'] === $document) {
|
||||
$file = $entry;
|
||||
break;
|
||||
}
|
||||
}
|
||||
abort_unless($file !== null, 404);
|
||||
abort_unless($workflow->canReadFile($request->user(), $document), 403);
|
||||
$record = DB::table('documents')->where('id', $document)->first();
|
||||
abort_unless($record && hash_equals(trim($file['sha256']), trim($record->sha256)) && (int) $file['version_no'] === (int) $record->version_no, 409, 'O anexo mudou; esta edição conserva a referência anterior.');
|
||||
|
||||
return $this->binary($record);
|
||||
}
|
||||
|
||||
private function binary(\stdClass $record): Response
|
||||
{
|
||||
$response = app(VerifiedDocumentBinary::class)->respond($record);
|
||||
$response->headers->set('Cache-Control', 'private, no-store');
|
||||
$response->headers->set('X-Robots-Tag', 'noindex, nofollow');
|
||||
|
||||
return $response;
|
||||
}
|
||||
|
||||
public function markRead(Request $request, int $notice, PortalEditorialWorkflow $workflow): Response
|
||||
{
|
||||
abort_unless($workflow->enabled(), 503);
|
||||
$n = DB::table('portal_editorial_notifications')->where('id', $notice)->where('user_id', $request->user()->id)->first();
|
||||
abort_unless($n !== null, 404);
|
||||
abort_unless($workflow->visibleNotice($request->user(), $n), 404);
|
||||
DB::table('portal_editorial_notifications')->where('id', $notice)->where('user_id', $request->user()->id)->whereNull('read_at')->update(['read_at' => now()]);
|
||||
|
||||
return $request->expectsJson() ? response()->json(['read' => true]) : back();
|
||||
}
|
||||
}
|
||||
@@ -15,6 +15,7 @@ use App\Services\InterestSubmission;
|
||||
use App\Services\InvestmentGeography;
|
||||
use App\Services\LegacyContent;
|
||||
use App\Services\Malware\MalwareScanner;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use App\Services\PortalProfileAccess;
|
||||
use App\Services\PublicDocumentPresentation;
|
||||
use App\Services\PublicSearchMetrics;
|
||||
@@ -320,6 +321,9 @@ class PortalServicesController extends Controller
|
||||
$editorial = $access->editorial($request->user());
|
||||
$resources = $editorial ? $this->filterManagedResources($access->editorialResources($request->user()), $managementFilters)->orderByDesc('r.updated_at')
|
||||
->get(['r.*', 'd.file_name', 'd.media_type', 'd.size_bytes', 'd.issuer', 'd.status as file_status', 'd.data_classification', 'd.version_no as file_version', 'd.rights_status as file_rights_status', 'd.malware_scan_status', 'd.malware_failure_reason']) : collect();
|
||||
if (app(PortalEditorialWorkflow::class)->enabled()) {
|
||||
$resources = $resources->map(fn ($r) => app(PortalEditorialWorkflow::class)->workingResource($r));
|
||||
}
|
||||
$links = DB::table('portal_resource_links')->whereIn('resource_id', $resources->pluck('id'))->orderBy('id')->get()->groupBy('resource_id');
|
||||
$revisions = DB::table('portal_resource_revisions')->whereIn('resource_id', $resources->pluck('id'))->orderByDesc('revision_no')->get(['resource_id', 'revision_no', 'change_type', 'actor_user_id', 'created_at'])->groupBy('resource_id');
|
||||
$resources->each(function ($resource) use ($links, $revisions) {
|
||||
@@ -328,7 +332,7 @@ class PortalServicesController extends Controller
|
||||
});
|
||||
|
||||
return Inertia::render('portal/manage', [
|
||||
'managementFilters' => $managementFilters, 'associationOptions' => $this->contentAssociations($request),
|
||||
'editorialWorkflowEnabled' => app(PortalEditorialWorkflow::class)->enabled(), 'managementFilters' => $managementFilters, 'associationOptions' => $this->contentAssociations($request),
|
||||
'documentAccessOnly' => ! $editorial, 'editorialScopeOnly' => $editorial, 'resources' => $resources, 'partnerships' => [], 'territories' => [],
|
||||
'requirementCatalogue' => [], 'requirementAssociationsEnabled' => false,
|
||||
'disclosureAuthorization' => null, 'incompleteCount' => $resources->filter(fn ($r) => ! $r->description || ! $r->issuer || ! $r->source_url || $r->source_confirmation === 'unconfirmed' || $r->legal_status === 'unknown' || $r->rights_status === 'unconfirmed')->count(), 'possibleDuplicates' => $resources->whereNotNull('duplicate_of_resource_id')->count(),
|
||||
@@ -353,12 +357,15 @@ class PortalServicesController extends Controller
|
||||
$resources->each(fn ($resource) => $resource->links = $links->get($resource->id, collect())->values());
|
||||
$revisions = DB::table('portal_resource_revisions')->whereIn('resource_id', $resources->pluck('id'))->orderByDesc('revision_no')->get(['resource_id', 'revision_no', 'change_type', 'actor_user_id', 'created_at'])->groupBy('resource_id');
|
||||
$resources->each(fn ($resource) => $resource->revisions = $revisions->get($resource->id, collect())->values());
|
||||
if (app(PortalEditorialWorkflow::class)->enabled()) {
|
||||
$resources = $resources->map(fn ($r) => app(PortalEditorialWorkflow::class)->workingResource($r));
|
||||
}
|
||||
|
||||
$malwareHealth = $scanner->health();
|
||||
$malwareHealth['signatures_at'] = $malwareHealth['signatures_at']?->format(DATE_ATOM);
|
||||
|
||||
return Inertia::render('portal/manage', ['resources' => $resources,
|
||||
'managementFilters' => $managementFilters, 'associationOptions' => $this->contentAssociations($request),
|
||||
'editorialWorkflowEnabled' => app(PortalEditorialWorkflow::class)->enabled(), 'managementFilters' => $managementFilters, 'associationOptions' => $this->contentAssociations($request),
|
||||
'requirementCatalogue' => $this->requirementEvidenceEnabled()
|
||||
? collect(is_array($catalogue = config('document-requirements.catalogue', [])) ? $catalogue : [])->map(fn ($item, $key) => ['key' => $key, ...$item])->values()
|
||||
: collect(),
|
||||
@@ -474,9 +481,15 @@ class PortalServicesController extends Controller
|
||||
$duplicate = $identity ? DB::table('portal_resources')->where('document_identity_key', $identity)->value('id') : null;
|
||||
$fields = $this->resourceFields($data, $request->user()->id, $identity, $duplicate, true);
|
||||
$this->assertPublicClassificationEligible($data, $document);
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
$id = DB::table('portal_resources')->insertGetId([...$fields, 'approved_by' => null, 'published' => false, 'created_at' => now(), 'updated_at' => now()]);
|
||||
$this->syncResourceLinks($id, $data['associations'] ?? []);
|
||||
$this->recordResourceRevision($id, 'created', $request->user()->id, 1);
|
||||
if ($workflow->enabled()) {
|
||||
$workflow->save($request->user(), $id, 1, ['_document' => ['issuer' => ($data['issuer'] ?? null) ?: $document->issuer, 'issued_on' => ($data['document_date'] ?? null) ?: $document->issued_on, 'rights_status' => $data['rights_status'], 'data_classification' => $data['data_classification'] ?? $document->data_classification]]);
|
||||
|
||||
return $id;
|
||||
}
|
||||
DB::table('documents')->where('id', $document->id)->update(['issuer' => ($data['issuer'] ?? null) ?: $document->issuer,
|
||||
'issued_on' => ($data['document_date'] ?? null) ?: $document->issued_on, 'rights_status' => $data['rights_status'],
|
||||
'data_classification' => $data['data_classification'] ?? $document->data_classification, 'updated_at' => now()]);
|
||||
@@ -496,7 +509,9 @@ class PortalServicesController extends Controller
|
||||
$resource = DB::table('portal_resources')->where('id', $id)->lockForUpdate()->first();
|
||||
abort_unless($resource !== null, 404);
|
||||
app(DocumentManagementAccess::class)->assertEditableResource($request->user(), $id);
|
||||
abort_if((int) $resource->metadata_version !== $expectedVersion, 409, 'O documento foi alterado por outra sessão. Recarregue a revisão antes de editar.');
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
$current = $workflow->enabled() ? $workflow->workingResource($resource) : $resource;
|
||||
abort_if((int) $current->metadata_version !== $expectedVersion, 409, 'O documento foi alterado por outra sessão. Recarregue a revisão antes de editar.');
|
||||
$document = DB::table('documents')->where('id', $data['document_id'])->where('status', '!=', 'deleted')->whereNull('deleted_at')->lockForUpdate()->first();
|
||||
abort_unless($document !== null, 422, 'Seleccione um documento existente e não eliminado.');
|
||||
abort_unless(app(DocumentManagementAccess::class)->documents($request->user())->where('id', $document->id)->exists(), 403);
|
||||
@@ -507,6 +522,12 @@ class PortalServicesController extends Controller
|
||||
$duplicate = $identity ? DB::table('portal_resources')->where('document_identity_key', $identity)->where('id', '!=', $id)->value('id') : null;
|
||||
$fields = $this->resourceFields($data, $request->user()->id, $identity, $duplicate, false);
|
||||
$this->assertPublicClassificationEligible($data, $document);
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
if ($workflow->enabled()) {
|
||||
$workflow->save($request->user(), $id, $expectedVersion, [...$fields, '_document' => ['issuer' => ($data['issuer'] ?? null) ?: $document->issuer, 'issued_on' => ($data['document_date'] ?? null) ?: $document->issued_on, 'rights_status' => $data['rights_status'], 'data_classification' => $data['data_classification'] ?? $document->data_classification]], $data['associations'] ?? []);
|
||||
|
||||
return;
|
||||
}
|
||||
$retainPublication = (bool) $resource->published && $data['rights_status'] === 'authorized'
|
||||
&& $data['source_confirmation'] !== 'unconfirmed' && ! empty($data['source_url'])
|
||||
&& (! ($data['legislation'] || $data['document_type'] === 'legislation') || $data['source_confirmation'] === 'official_confirmed')
|
||||
@@ -523,7 +544,7 @@ class PortalServicesController extends Controller
|
||||
$this->audit($request, 'resource_metadata_updated', 'portal_resources', $id);
|
||||
});
|
||||
|
||||
return to_route('services.manage')->with('success', 'Metadados e relações actualizados; o estado de publicação foi preservado.');
|
||||
return to_route('services.manage')->with('success', 'Edição guardada; confira o circuito editorial quando estiver activo. A versão pública é preservada nesse circuito.');
|
||||
}
|
||||
|
||||
public function moderate(Request $request, string $type, int $id): RedirectResponse
|
||||
@@ -537,6 +558,12 @@ class PortalServicesController extends Controller
|
||||
return redirect('/parcerias/'.$id)->with('success', 'Reveja a proposta e registe uma decisão fundamentada na ficha da Bolsa.');
|
||||
}
|
||||
$data = $this->validateManagement($request, ['published' => ['required', 'boolean']]);
|
||||
if ($type === 'resources' && app(PortalEditorialWorkflow::class)->enabled()) {
|
||||
app(PortalEditorialWorkflow::class)->authorize($request->user(), $id, true);
|
||||
}
|
||||
if ($type === 'resources' && $data['published'] && app(PortalEditorialWorkflow::class)->enabled()) {
|
||||
abort(409, 'Use a aprovação e publicação explícitas da edição no circuito editorial.');
|
||||
}
|
||||
$table = $type === 'resources' ? 'portal_resources' : 'portal_partnerships';
|
||||
DB::transaction(function () use ($request, $data, $table, $type, $id) {
|
||||
abort_unless(DB::table($table)->where('id', $id)->lockForUpdate()->first() !== null, 404);
|
||||
@@ -582,6 +609,7 @@ class PortalServicesController extends Controller
|
||||
|
||||
public function applyDocumentDisclosureAuthorization(Request $request): RedirectResponse
|
||||
{
|
||||
abort_if(app(PortalEditorialWorkflow::class)->enabled(), 409, 'A divulgação de novas edições requer aprovação e publicação no circuito editorial.');
|
||||
$event = DB::table('audit_events')->where('source_system', 'user-instruction')
|
||||
->where('external_id', 'document-repository-disclosure-authorization-2026-10-06-v1')
|
||||
->where('action', 'public_disclosure_authorized')->first();
|
||||
|
||||
@@ -0,0 +1,51 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Services\PrivateOfferOperations;
|
||||
use Illuminate\Http\Request;
|
||||
use Inertia\Inertia;
|
||||
use Symfony\Component\HttpFoundation\Response;
|
||||
|
||||
final class PrivateOfferOperationsController extends Controller
|
||||
{
|
||||
public function show(Request $request, int $id, PrivateOfferOperations $operations): Response
|
||||
{
|
||||
return response()->json($operations->presentation($request->user(), $id));
|
||||
}
|
||||
|
||||
public function owner(Request $request, int $id, PrivateOfferOperations $operations): Response
|
||||
{
|
||||
$operations->ownerAction($request->user(), $id, $request->all());
|
||||
|
||||
return response()->json($operations->presentation($request->user(), $id));
|
||||
}
|
||||
|
||||
public function reportPage(Request $request, int $id, PrivateOfferOperations $operations): Response
|
||||
{
|
||||
$record = Opportunity::findOrFail($id);
|
||||
abort_unless($record->isPrivateOfferPreparation() && $operations->canReport($request->user(), $record), 404);
|
||||
|
||||
return Inertia::render('offers/report', ['offerId' => $id])->toResponse($request);
|
||||
}
|
||||
|
||||
public function report(Request $request, int $id, PrivateOfferOperations $operations): Response
|
||||
{
|
||||
return response()->json($operations->report($request->user(), $id, $request->all()), 201);
|
||||
}
|
||||
|
||||
public function handleReport(Request $request, int $id, string $reportId, PrivateOfferOperations $operations): Response
|
||||
{
|
||||
$operations->handleReport($request->user(), $id, $reportId, $request->all());
|
||||
|
||||
return response()->json($operations->presentation($request->user(), $id));
|
||||
}
|
||||
|
||||
public function highlight(Request $request, int $id, PrivateOfferOperations $operations): Response
|
||||
{
|
||||
$operations->highlight($request->user(), $id, $request->all());
|
||||
|
||||
return response()->json($operations->presentation($request->user(), $id));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,153 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Services\OfferAvailability;
|
||||
use App\Services\OpportunityCanonicalContract;
|
||||
use App\Services\OpportunityManagement;
|
||||
use App\Services\OpportunityProfileWorkflow;
|
||||
use App\Services\OpportunityResources;
|
||||
use App\Services\PortalProfileAccess;
|
||||
use App\Services\PrivateOfferConfidentiality;
|
||||
use App\Services\PrivateOfferOperations;
|
||||
use App\Services\PrivateOfferPreparation;
|
||||
use App\Services\VerifiedDocumentBinary;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Inertia\Inertia;
|
||||
use Inertia\Response;
|
||||
use Symfony\Component\HttpKernel\Exception\HttpExceptionInterface;
|
||||
|
||||
final class PrivateOfferPreparationController extends Controller
|
||||
{
|
||||
public function resources(Request $request, PrivateOfferPreparation $service, int $id): JsonResponse
|
||||
{
|
||||
$record = $service->record($request->user(), $id);
|
||||
$resources = [];
|
||||
foreach (['images', 'documents'] as $kind) {
|
||||
$resources[$kind] = array_map(fn ($row) => ['id' => $row->id, 'version' => $row->version, 'deleted' => $row->deleted_at !== null,
|
||||
'caption' => $row->payload['caption'] ?? null, 'digitally_edited' => $row->payload['digitally_edited'] ?? null,
|
||||
'edit_description' => $row->payload['edit_description'] ?? null,
|
||||
'scan' => $row->file->malware_scan_status ?? 'pending'], app(OpportunityResources::class)->listing($id, $kind));
|
||||
}
|
||||
|
||||
return response()->json(['resources' => $resources, 'etag' => app(OpportunityManagement::class)->etag($record),
|
||||
'internalProofAccess' => app(PrivateOfferConfidentiality::class)->internal($request->user(), $record)]);
|
||||
}
|
||||
|
||||
public function attachment(Request $request, PrivateOfferPreparation $service, int $id, string $kind, string $resourceId): \Symfony\Component\HttpFoundation\Response
|
||||
{
|
||||
$record = $service->record($request->user(), $id);
|
||||
abort_unless(in_array($kind, ['documents', 'images'], true), 404);
|
||||
$link = DB::table('opportunity_'.$kind)->where('opportunity_id', $id)->where('id', $resourceId)->whereNull('deleted_at')->first();
|
||||
abort_unless($link !== null, 404);
|
||||
$document = DB::table('documents')->where('id', $link->document_id)->whereNull('deleted_at')->first();
|
||||
abort_unless($document !== null, 404);
|
||||
|
||||
return app(VerifiedDocumentBinary::class)->respond($document);
|
||||
}
|
||||
|
||||
public function confidentiality(Request $request, PrivateOfferConfidentiality $privacy, int $id): JsonResponse|Response
|
||||
{
|
||||
$overview = $privacy->overview($request->user(), $id);
|
||||
|
||||
return $request->expectsJson() ? response()->json($overview) : Inertia::render('offers/confidentiality', ['offerId' => $id]);
|
||||
}
|
||||
|
||||
public function confidentialityAction(Request $request, PrivateOfferConfidentiality $privacy, int $id): JsonResponse
|
||||
{
|
||||
return response()->json($privacy->act($request->user(), $id, $request->all()));
|
||||
}
|
||||
|
||||
public function confidentialRead(Request $request, PrivateOfferConfidentiality $privacy, int $id): JsonResponse
|
||||
{
|
||||
try {
|
||||
$result = $privacy->read($request->user(), $id);
|
||||
} catch (HttpExceptionInterface $error) {
|
||||
app(PortalProfileAccess::class)->audit($request->user(), 'offer_confidential_denied', ['record_id' => $id, 'http_status' => $error->getStatusCode()]);
|
||||
throw $error;
|
||||
}
|
||||
abort_if(isset($result['denied']), 403, 'É necessária aceitação do NDA e autorização expressa do vendedor para esta versão.');
|
||||
|
||||
return response()->json($result);
|
||||
}
|
||||
|
||||
public function nda(Request $request, PrivateOfferConfidentiality $privacy, int $id): \Symfony\Component\HttpFoundation\Response
|
||||
{
|
||||
$overview = $privacy->overview($request->user(), $id);
|
||||
abort_unless($overview['nda'], 409, 'O NDA aprovado ainda não foi disponibilizado.');
|
||||
app(PortalProfileAccess::class)->audit($request->user(), 'offer_nda_access', ['record_id' => $id, 'version_hash' => $overview['version_hash'], 'nda' => $overview['nda']]);
|
||||
|
||||
$document = DB::table('documents')->where('id', $overview['nda']['document_id'])->firstOrFail();
|
||||
abort_unless((int) $document->version_no === $overview['nda']['version'] && hash_equals(trim($document->sha256), $overview['nda']['sha256']), 409, 'O exemplar do NDA mudou; actualize antes de continuar.');
|
||||
|
||||
return app(VerifiedDocumentBinary::class)->respond($document);
|
||||
}
|
||||
|
||||
public function index(Request $request, PortalProfileAccess $access): Response
|
||||
{
|
||||
$filters = $request->validate(['state' => 'nullable|in:draft,submitted,in_review,needs_information,rejected,approved', 'operational' => 'nullable|boolean', 'pending_reports' => 'nullable|boolean']);
|
||||
$query = ($filters['operational'] ?? false) ? app(PrivateOfferOperations::class)->staffQuery($request->user()) : $access->scope(Opportunity::query(), $request->user());
|
||||
if ($filters['pending_reports'] ?? false) {
|
||||
$query = app(PrivateOfferOperations::class)->staffQuery($request->user());
|
||||
$query->whereRaw("jsonb_path_exists(COALESCE(workflow_context->'offer_reports','{}'::jsonb), '$.* ? (@.status == \"open\" || @.status == \"in_review\")')");
|
||||
}
|
||||
$records = $query->whereNotNull('workflow_context->private_offer_preparation')
|
||||
->when($filters['state'] ?? null, fn ($q, $state) => $q->where('workflow_context->private_offer_preparation->state', $state))
|
||||
->orderByDesc('id')->paginate(20)->withQueryString();
|
||||
|
||||
return Inertia::render('offers/preparation-index', ['records' => $records->through(fn ($r) => [
|
||||
'id' => $r->id, 'title' => app(OpportunityManagement::class)->values($r)['title'] ?? null, 'reference' => $r->reference,
|
||||
'state' => $access->state($r),
|
||||
'availability' => app(OfferAvailability::class)->record($r)['state'],
|
||||
]), 'filters' => $filters, 'canCreate' => count($access->navigation($request->user())['contexts']) > 0]);
|
||||
}
|
||||
|
||||
public function edit(Request $request, PrivateOfferPreparation $service, ?int $id = null): Response|JsonResponse
|
||||
{
|
||||
$record = $id ? $service->record($request->user(), $id) : null;
|
||||
$contexts = app(PortalProfileAccess::class)->navigation($request->user())['contexts'];
|
||||
abort_unless($record || count($contexts) > 0, 403, 'É necessária uma atribuição de promotor no âmbito da oferta.');
|
||||
$presentation = $record ? $service->presentation($request->user(), $record) : null;
|
||||
if ($request->expectsJson() && ! $request->header('X-Inertia')) {
|
||||
return response()->json(['record' => $presentation]);
|
||||
}
|
||||
$options = app(OpportunityCanonicalContract::class)->options($request->user(), $record);
|
||||
|
||||
return Inertia::render('offers/preparation', ['record' => $presentation, 'contexts' => $contexts,
|
||||
'contacts' => $options['contacts'], 'contactInvestors' => $options['contactInvestors'],
|
||||
'sectors' => DB::table('sectors')->where('is_active', true)->orderBy('name')->get(['id', 'name']),
|
||||
'propertyTypes' => array_values(array_filter($options['definitions']['realEstatePatch']['properties']['property_type']['enum'], fn ($type) => is_string($type)))]);
|
||||
}
|
||||
|
||||
public function save(Request $request, PrivateOfferPreparation $service, ?int $id = null): JsonResponse
|
||||
{
|
||||
if ($id) {
|
||||
$service->record($request->user(), $id, true);
|
||||
}
|
||||
$record = $service->save($request->user(), $request->all(), $id);
|
||||
|
||||
return response()->json(['record' => $service->presentation($request->user(), $record)], $id ? 200 : 201);
|
||||
}
|
||||
|
||||
public function submit(Request $request, PrivateOfferPreparation $service, int $id): JsonResponse
|
||||
{
|
||||
$record = $service->submit($request->user(), $id, $request->all());
|
||||
|
||||
return response()->json(['record' => $service->presentation($request->user(), $record),
|
||||
'message' => 'Submissão privada registada. A oferta não foi publicada.']);
|
||||
}
|
||||
|
||||
public function transition(Request $request, PrivateOfferPreparation $service, OpportunityProfileWorkflow $workflow, int $id): JsonResponse
|
||||
{
|
||||
$service->record($request->user(), $id);
|
||||
$data = $request->validate(['etag' => 'required|string|size:64', 'action' => 'required|in:start_review,assign_review,request_correction,reject,approve,request_revision',
|
||||
'assignee_user_id' => 'required_if:action,assign_review|integer|min:1',
|
||||
'reason' => 'required|string|min:20|max:1000', 'correction_items' => 'sometimes|array', 'correction_items.*' => 'string']);
|
||||
$record = $workflow->transition($request->user(), $id, $data);
|
||||
|
||||
return response()->json(['record' => $service->presentation($request->user(), $record), 'message' => 'Decisão privada registada. A oferta não foi publicada.']);
|
||||
}
|
||||
}
|
||||
@@ -5,11 +5,32 @@ namespace App\Http\Controllers;
|
||||
use App\Services\TerritorialRegistry;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Pagination\CursorPaginator;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Str;
|
||||
use Inertia\Inertia;
|
||||
use Symfony\Component\HttpFoundation\Response;
|
||||
|
||||
class TerritorialRegistryController extends Controller
|
||||
{
|
||||
public function editor(Request $request, TerritorialRegistry $registry): Response
|
||||
{
|
||||
abort_unless($registry->editorialAvailable(), 404);
|
||||
$actor = $request->user();
|
||||
$roles = array_values(array_filter(['editors', 'reviewers', 'publishers'], fn ($role) => in_array(strtolower($actor->email), config('territorial.'.$role, []), true)));
|
||||
|
||||
$context = $request->validate(['territory' => 'nullable|uuid', 'notice_version' => 'nullable|integer|min:1']);
|
||||
|
||||
return Inertia::render('management/territorial-editorial', ['roles' => $roles, 'actorId' => $actor->id, 'initialTerritory' => $context['territory'] ?? null, 'noticeVersion' => $context['notice_version'] ?? null])->toResponse($request);
|
||||
}
|
||||
|
||||
public function preview(Request $request, TerritorialRegistry $registry, string $id): JsonResponse
|
||||
{
|
||||
abort_unless($registry->editorialAvailable(), 404);
|
||||
|
||||
return response()->json($registry->preview($id));
|
||||
}
|
||||
|
||||
public function sources(Request $request): JsonResponse
|
||||
{
|
||||
$data = $request->validate(['limit' => ['nullable', 'integer', 'between:1,100'], 'cursor' => ['nullable', 'string', 'max:512']]);
|
||||
@@ -17,13 +38,25 @@ class TerritorialRegistryController extends Controller
|
||||
return response()->json(DB::table('geo_sources')->orderBy('id')->cursorPaginate($data['limit'] ?? 20)->withQueryString());
|
||||
}
|
||||
|
||||
public function drafts(Request $request): JsonResponse
|
||||
public function drafts(Request $request, TerritorialRegistry $registry): JsonResponse
|
||||
{
|
||||
$data = $request->validate(['limit' => ['nullable', 'integer', 'between:1,100'], 'cursor' => ['nullable', 'string', 'max:512']]);
|
||||
|
||||
return response()->json(DB::table('geo_locations as g')->join('geo_territory_profiles as p', 'p.geo_location_id', '=', 'g.id')->whereNull('g.deleted_at')
|
||||
$page = DB::table('geo_locations as g')->join('geo_territory_profiles as p', 'p.geo_location_id', '=', 'g.id')->whereNull('g.deleted_at')
|
||||
->select(['g.id', 'g.name', 'g.code', 'g.location_type', 'g.parent_id', 'g.version_no', 'p.source_id', 'p.status', 'p.valid_from', 'p.valid_to', 'p.editor_id', 'p.reviewer_id', 'p.publisher_id'])
|
||||
->orderBy('g.id')->cursorPaginate($data['limit'] ?? 20)->withQueryString());
|
||||
->orderBy('g.id')->cursorPaginate($data['limit'] ?? 20)->withQueryString();
|
||||
if ($registry->editorialAvailable()) {
|
||||
abort_unless($page instanceof CursorPaginator, 503, 'Paginação territorial indisponível.');
|
||||
$page->through(function ($row) use ($registry) {
|
||||
$state = $registry->working($row->id);
|
||||
|
||||
return [...$state['location'], ...$state['profile'], 'id' => $row->id,
|
||||
'public_version_no' => $state['public_version_no'], 'fresh' => $state['fresh'],
|
||||
'private_revision' => $state['_editorial']['private'] ?? false];
|
||||
});
|
||||
}
|
||||
|
||||
return response()->json($page);
|
||||
}
|
||||
|
||||
public function index(Request $request, TerritorialRegistry $registry, ?string $collection = null): JsonResponse
|
||||
@@ -74,7 +107,8 @@ class TerritorialRegistryController extends Controller
|
||||
{
|
||||
$id = $registry->save($request->user(), $request->all(), $id);
|
||||
|
||||
return response()->json(['id' => $id, 'status' => 'draft', 'version_no' => DB::table('geo_locations')->where('id', $id)->value('version_no')]);
|
||||
return response()->json(['id' => $id, 'status' => 'draft', 'version_no' => $registry->editorialAvailable()
|
||||
? $registry->working($id)['location']['version_no'] : DB::table('geo_locations')->where('id', $id)->value('version_no')]);
|
||||
}
|
||||
|
||||
public function source(Request $request): JsonResponse
|
||||
@@ -95,9 +129,15 @@ class TerritorialRegistryController extends Controller
|
||||
|
||||
public function transition(Request $request, TerritorialRegistry $registry, string $id): JsonResponse
|
||||
{
|
||||
$data = $request->validate(['action' => ['required', 'in:pending_review,approved,published,rejected,archived'],
|
||||
$data = $request->validate(['action' => ['required', 'in:pending_review,in_review,approved,published,rejected,archived,withdrawn'],
|
||||
'version_no' => ['required', 'integer', 'min:1'], 'reason' => ['required', 'string', 'min:10', 'max:1000']]);
|
||||
|
||||
$registry->ensureWriteMode($id);
|
||||
if ($registry->editorialAvailable() && $registry->hasEditorialHistory($id)) {
|
||||
return response()->json($registry->transitionEditorial($request->user(), $id, $data));
|
||||
}
|
||||
abort_if(in_array($data['action'], ['in_review', 'withdrawn'], true), 422);
|
||||
|
||||
return DB::transaction(function () use ($request, $registry, $id, $data) {
|
||||
DB::select('SELECT pg_advisory_xact_lock(280926, 150000)');
|
||||
$location = DB::table('geo_locations')->where('id', $id)->whereNull('deleted_at')->lockForUpdate()->first();
|
||||
|
||||
@@ -57,6 +57,8 @@ class HandleInertiaRequests extends Middleware
|
||||
return [
|
||||
...parent::share($request),
|
||||
'name' => config('app.name'),
|
||||
'administrationNavigation' => app(ContentManagement::class)->administrationNavigation($request->user(), $contentManagementAccess),
|
||||
'dashboardNavigation' => app(ContentManagement::class)->dashboardNavigation($request->user(), $contentManagementAccess),
|
||||
'procurementEnabled' => app(Procurement::class)->available(),
|
||||
'fundingEnabled' => app(FundingProgrammes::class)->installed(),
|
||||
'homologationReserved' => (bool) config('portal.homologation_only', false),
|
||||
|
||||
@@ -23,6 +23,14 @@ class ProtectProfileOpportunity
|
||||
}
|
||||
if ($request->user() && $id !== null && Schema::hasColumn('opportunities', 'owner_user_id')) {
|
||||
$record = Opportunity::withTrashed()->find($id);
|
||||
if ($record?->isPrivateOfferPreparation()) {
|
||||
app(PortalProfileAccess::class)->authorize($request->user(), $request->isMethod('GET') ? 'view' : 'edit', $record);
|
||||
if ($request->isMethod('GET') && $request->is('minhas-oportunidades/*/edit', 'minhas-oportunidades/*/view', 'management/opportunities/*/edit', 'management/opportunities/*/view')) {
|
||||
return redirect('/minhas-oportunidades/ofertas/'.$record->id)->header('Cache-Control', 'private, no-store');
|
||||
}
|
||||
// Contact registration reuses the CRM master and its fresh-MFA gate.
|
||||
abort_unless($request->isMethod('POST') && $request->is('minhas-oportunidades/*/contacts'), 403, 'Use a preparação privada da oferta.');
|
||||
}
|
||||
if ($record && $record->owner_user_id === null && ! $request->isMethod('GET')) {
|
||||
abort_unless(app(PortalProfileAccess::class)->legacyWriteAllowed($request->user()), 403, 'O papel v1 não contorna os controlos através de um registo legado.');
|
||||
}
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
namespace App\Http\Middleware;
|
||||
|
||||
use App\Services\PortalProfileAccess;
|
||||
use App\Services\TerritorialRegistry;
|
||||
use Closure;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\Crypt;
|
||||
@@ -24,9 +26,16 @@ class TerritorialRequest
|
||||
} else {
|
||||
abort_unless($request->user()->can('manage-portal') && $request->user()->two_factor_confirmed_at && $request->user()->two_factor_secret, 403);
|
||||
$role = $request->is('*/transitions') ? match ($request->input('action')) {
|
||||
'approved', 'rejected' => 'reviewers', 'published', 'archived', 'revoked' => 'publishers', default => 'editors',
|
||||
'in_review', 'approved', 'rejected' => 'reviewers', 'published', 'archived', 'withdrawn', 'revoked' => 'publishers', default => 'editors',
|
||||
} : 'editors';
|
||||
abort_unless(in_array(strtolower($request->user()->email), config('territorial.'.$role, []), true), 403, 'Função editorial não atribuída.');
|
||||
if ($request->is('api/v1/geo/territories*')) {
|
||||
app(TerritorialRegistry::class)->ensureWriteMode($request->route('id'));
|
||||
if (config('editorial_workflow.territorial_versions')) {
|
||||
abort_unless(app(PortalProfileAccess::class)->mfa($request->user())
|
||||
&& ! app(PortalProfileAccess::class)->has($request->user(), 'auditor'), 403, 'MFA válido necessário.');
|
||||
}
|
||||
}
|
||||
$key = $request->header('Idempotency-Key', '');
|
||||
abort_unless(Str::isUuid($key), 422, 'Idempotency-Key UUID obrigatório.');
|
||||
$scope = $request->method().':'.$request->path();
|
||||
|
||||
@@ -37,13 +37,14 @@ class StoreSimulationFormDraftRequest extends FormRequest
|
||||
'contact_province', 'contact_district', 'preferred_channel',
|
||||
];
|
||||
$economic = [
|
||||
'preparation_step', 'planning_assumptions_snapshot', 'initial_budget_snapshot', 'fiscal_tools_selection', 'planned_funding', 'requested_funding', 'approved_funding', 'planning_loan',
|
||||
'context_opportunity', 'context_applicability_snapshot', 'investment_regime', 'context_reuse', 'compatible_fields_snapshot', 'published_iva_base', 'published_iva_currency', 'published_iva_date', 'published_iva_scope', 'monthly_iva_settings', 'monthly_iva_snapshot', 'modelo_a_snapshot', 'journey_type', 'detail_level', 'business_plan_snapshot', 'financial_tools_snapshot', 'cashflow_snapshot', 'project_team_snapshot', 'project_execution_snapshot', 'purpose', 'manifestation_type', 'preferred_language', 'project_title', 'project_summary', 'project_problem', 'target_customers', 'value_proposition', 'market_assumption', 'market_source', 'project_milestones', 'selection_labels', 'project_type',
|
||||
'competitor_assumption', 'sales_channel_assumption', 'marketing_approach', 'location_rationale', 'project_risk_responses_snapshot', 'project_questionnaire_version',
|
||||
'customer_validation_status', 'cost_estimate_status', 'location_assessment_status', 'funding_status', 'receivables_timing_status',
|
||||
'project_type_other', 'sector_id', 'activity_id', 'products_services', 'maturity_stage', 'expected_start_date',
|
||||
'project_duration_years', 'existing_project_id', 'province_id', 'district_id', 'admin_post_id', 'locality_id',
|
||||
'site_known', 'latitude', 'longitude', 'area_required', 'area_unit', 'special_zone_id', 'land_status',
|
||||
'infrastructure_needs', 'currency', 'total_investment', 'own_capital', 'domestic_debt', 'foreign_debt',
|
||||
'infrastructure_needs', 'investment_budget_min', 'investment_budget_max', 'currency', 'total_investment', 'own_capital', 'domestic_debt', 'foreign_debt',
|
||||
'grants', 'secured_amount', 'sought_amount', 'annual_revenue', 'annual_operating_costs', 'expected_profit',
|
||||
'financing_term_months', 'funds_origin_countries', 'direct_jobs', 'indirect_jobs', 'national_jobs',
|
||||
'foreign_jobs', 'skills_needed', 'local_content_percentage', 'exports_value', 'import_substitution_value',
|
||||
@@ -69,6 +70,15 @@ class StoreSimulationFormDraftRequest extends FormRequest
|
||||
'economic_snapshot.purpose' => ['required', 'in:simulate_only,own_investment,seek_investor,seek_partner,present_opportunity,request_facilitation'],
|
||||
'economic_snapshot.journey_type' => ['nullable', 'in:personal,small_business,company,investor'],
|
||||
'economic_snapshot.detail_level' => ['nullable', 'in:simple,advanced'],
|
||||
'economic_snapshot.preparation_step' => ['nullable', 'in:purpose,market,investment,financial,operating,cashflow,tax,review,promoter,identity,project,location,impact,opportunity,documents,team,scenarios,procedures'],
|
||||
'economic_snapshot.initial_budget_snapshot' => ['nullable', 'string', 'max:12000'],
|
||||
'economic_snapshot.planning_assumptions_snapshot' => ['nullable', 'string', 'max:12000'],
|
||||
'economic_snapshot.fiscal_tools_selection' => ['nullable', 'array', 'max:80'],
|
||||
'economic_snapshot.fiscal_tools_selection.*' => ['string', 'max:100', 'regex:/^(tax|iva|irpc):[a-z_]+$/'],
|
||||
'economic_snapshot.planned_funding' => ['nullable', 'numeric', 'min:0'],
|
||||
'economic_snapshot.requested_funding' => ['nullable', 'numeric', 'min:0'],
|
||||
'economic_snapshot.approved_funding' => ['nullable', 'numeric', 'min:0'],
|
||||
'economic_snapshot.planning_loan' => ['nullable', 'in:yes,no,unknown'],
|
||||
'economic_snapshot.business_plan_snapshot' => ['nullable', 'string', 'max:60000'],
|
||||
'economic_snapshot.financial_tools_snapshot' => ['nullable', 'string', 'max:30000'],
|
||||
'economic_snapshot.cashflow_snapshot' => ['nullable', 'string', 'max:20000'],
|
||||
@@ -126,6 +136,8 @@ class StoreSimulationFormDraftRequest extends FormRequest
|
||||
'economic_snapshot.publication_authorisation' => ['nullable', 'in:yes,no'],
|
||||
'economic_snapshot.public_fields_confirmation' => ['nullable', 'in:yes,no'],
|
||||
'economic_snapshot.validation_acknowledged' => ['nullable', 'in:yes,no'],
|
||||
'economic_snapshot.investment_budget_min' => ['nullable', 'numeric', 'min:0'],
|
||||
'economic_snapshot.investment_budget_max' => ['nullable', 'numeric', 'min:0', \Illuminate\Validation\Rule::when($this->filled('economic_snapshot.investment_budget_min'), 'gte:economic_snapshot.investment_budget_min')],
|
||||
'economic_snapshot.currency' => ['nullable', 'string', 'regex:/^[A-Z]{3}$/'],
|
||||
'economic_snapshot.opportunity_currency' => ['nullable', 'string', 'regex:/^[A-Z]{3}$/'],
|
||||
'economic_snapshot.rate' => ['nullable', 'numeric', 'between:0,100'],
|
||||
@@ -288,6 +300,7 @@ class StoreSimulationFormDraftRequest extends FormRequest
|
||||
|
||||
$allowedLabels = [
|
||||
'economic_snapshot.selection_labels' => ['journey_type', 'detail_level', 'purpose', 'manifestation_type', 'preferred_language', 'project_type', 'maturity_stage', 'sector_id', 'activity_id',
|
||||
'customer_validation_status', 'location_assessment_status', 'cost_estimate_status', 'receivables_timing_status', 'funding_status', 'planning_loan',
|
||||
'province_id', 'district_id', 'admin_post_id', 'locality_id', 'site_known', 'land_status', 'infrastructure_needs',
|
||||
'area_unit', 'required_documents', 'opportunity_currency',
|
||||
'currency', 'funds_origin_countries', 'environmental_category', 'tax_calculation', 'fiscal_scenario_mode', 'offer_or_demand',
|
||||
@@ -303,7 +316,7 @@ class StoreSimulationFormDraftRequest extends FormRequest
|
||||
$labels = is_array($label) ? $label : [$label];
|
||||
if (! is_string($field) || ! in_array($field, $allowedFields, true) || count($labels) > 100
|
||||
|| collect($labels)->contains(fn ($value) => ! is_string($value) || mb_strlen($value) > 255)) {
|
||||
$validator->errors()->add($path, 'Os rótulos de selecção não são válidos.');
|
||||
$validator->errors()->add($path.'.'.(is_string($field) ? $field : 'draft'), 'Não foi possível guardar a opção apresentada neste campo. Volte a seleccioná-la; os outros dados do rascunho foram preservados.');
|
||||
break 2;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,46 @@
|
||||
<?php
|
||||
|
||||
namespace App\Jobs;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Models\User;
|
||||
use App\Services\PortalEditorialWorkflow;
|
||||
use Illuminate\Contracts\Queue\ShouldQueue;
|
||||
use Illuminate\Foundation\Queue\Queueable;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Mail;
|
||||
|
||||
/** Existing email transport and operational allowlist; no confidential payload. */
|
||||
final class NotifyPrivateOfferDecision implements ShouldQueue
|
||||
{
|
||||
use Queueable;
|
||||
|
||||
public int $tries = 3;
|
||||
|
||||
public int $timeout = 30;
|
||||
|
||||
public function __construct(public string $noticeId) {}
|
||||
|
||||
/** @return list<int> */
|
||||
public function backoff(): array
|
||||
{
|
||||
return [60, 300, 900];
|
||||
}
|
||||
|
||||
public function handle(): void
|
||||
{
|
||||
if (! config('portal.notifications_enabled')) {
|
||||
return;
|
||||
}
|
||||
$notice = DB::table('portal_editorial_notifications')->where('id', $this->noticeId)->first();
|
||||
$user = $notice ? User::query()->whereKey($notice->user_id)->first() : null;
|
||||
$record = $notice ? Opportunity::query()->whereKey($notice->opportunity_id)->first() : null;
|
||||
if (! $notice || ! $user || ! $record?->isPrivateOfferPreparation()
|
||||
|| ! in_array($user->email, config('portal.notification_recipients', []), true)
|
||||
|| ! app(PortalEditorialWorkflow::class)->visibleNotice($user, $notice)) {
|
||||
return;
|
||||
}
|
||||
$body = 'Existe uma actualização na revisão privada da oferta '.$record->reference.'. Consulte a decisão e a versão na área protegida: '.url('/minhas-oportunidades/ofertas/'.$record->id);
|
||||
Mail::raw($body, fn ($message) => $message->to($user->email)->subject('Actualização da oferta — '.$record->reference));
|
||||
}
|
||||
}
|
||||
@@ -30,6 +30,23 @@ class Opportunity extends Model
|
||||
{
|
||||
use SoftDeletes;
|
||||
|
||||
public function isPrivateOfferPreparation(): bool
|
||||
{
|
||||
return isset($this->workflow_context['private_offer_preparation']);
|
||||
}
|
||||
|
||||
protected static function booted(): void
|
||||
{
|
||||
static::saving(function (self $record) {
|
||||
$original = $record->getRawOriginal('workflow_context');
|
||||
$wasPrivate = is_string($original) && isset(json_decode($original, true)['private_offer_preparation']);
|
||||
abort_if($wasPrivate && ! $record->isPrivateOfferPreparation(), 403, 'A preparação privada não pode ser convertida neste percurso.');
|
||||
if ($record->isPrivateOfferPreparation()) {
|
||||
abort_unless($record->status === 'draft' && $record->published_at === null, 403, 'A publicação de Ofertas não está disponível nesta fase.');
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
protected $hidden = ['management_draft', 'management_creation_key', 'management_version', 'first_submitted_at', 'management_closed_once', 'owner_user_id', 'organization_id', 'workflow_context'];
|
||||
|
||||
protected $appends = ['maturity_catalogue_version'];
|
||||
@@ -115,6 +132,7 @@ class Opportunity extends Model
|
||||
public function scopePublished(Builder $query): Builder
|
||||
{
|
||||
if (Schema::hasColumn('opportunities', 'workflow_context')) {
|
||||
$query->whereNull('workflow_context->private_offer_preparation');
|
||||
$query->where(fn ($q) => $q->whereNull('owner_user_id')->orWhere('workflow_context->publication->visibility', 'public'));
|
||||
}
|
||||
|
||||
|
||||
@@ -3,10 +3,13 @@
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\EconomicCluster;
|
||||
use App\Models\User;
|
||||
use Illuminate\Database\Query\Builder;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\Crypt;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
use Illuminate\Support\Str;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
|
||||
final class ClusterCompetitiveness
|
||||
@@ -46,6 +49,12 @@ final class ClusterCompetitiveness
|
||||
public function management(string $cluster): array
|
||||
{
|
||||
$state = $this->current($cluster);
|
||||
$state['editorial_enabled'] = $this->editorialEnabled();
|
||||
if (isset($state['workflow'])) {
|
||||
$record = EconomicCluster::findOrFail($cluster);
|
||||
$state['workflow']['fresh'] = hash_equals($state['workflow']['hash'], $this->editionHash($record, $state['draft']));
|
||||
$state['workflow']['independent_required'] = $this->independentRequired($state['workflow']);
|
||||
}
|
||||
$state['history'] = $this->events($cluster)->orderByRaw("(after_data->>'version')::integer DESC")->limit(50)->get()
|
||||
->map(fn ($event) => ['version' => json_decode($event->after_data, true)['version'],
|
||||
'action' => $event->action, 'at' => $event->occurred_at, 'actor' => $event->actor_user_id])->all();
|
||||
@@ -106,12 +115,17 @@ final class ClusterCompetitiveness
|
||||
*/
|
||||
public function change(EconomicCluster $cluster, int $actor, int $expected, string $action, array $input = []): array
|
||||
{
|
||||
abort_if(! in_array($action, ['saved', 'restored', 'approved', 'withdrawn'], true) && ! $this->editorialEnabled(), 503, 'Circuito editorial dos clusters ainda não activado.');
|
||||
|
||||
return DB::transaction(function () use ($cluster, $actor, $expected, $action, $input) {
|
||||
EconomicCluster::whereKey($cluster->id)->lockForUpdate()->firstOrFail();
|
||||
$cluster = EconomicCluster::whereKey($cluster->id)->lockForUpdate()->firstOrFail();
|
||||
$before = $this->current($cluster->id);
|
||||
abort_if($before['version'] !== $expected, 409, 'A análise foi alterada. Conserve os campos actuais e compare a versão do servidor antes de voltar a guardar.');
|
||||
$state = $before;
|
||||
if ($action === 'saved') {
|
||||
if ($this->editorialEnabled() || isset($before['workflow'])) {
|
||||
abort_unless($this->editorialEnabled(), 503, 'Reactive o circuito editorial para continuar esta análise; o histórico e a publicação foram conservados.');
|
||||
$state = $this->editorialChange($cluster, $actor, $action, $input, $before);
|
||||
} elseif ($action === 'saved') {
|
||||
$state['draft'] = $this->validateDraft($input['draft'], $cluster->id);
|
||||
} elseif ($action === 'restored') {
|
||||
$event = $this->events($cluster->id)->where('after_data->version', $input['revision'])->first();
|
||||
@@ -127,13 +141,18 @@ final class ClusterCompetitiveness
|
||||
throw new \LogicException('Unsupported competitiveness action');
|
||||
}
|
||||
$state['version']++;
|
||||
DB::table('audit_events')->insert(['source_system' => self::SOURCE, 'entity_type' => 'economic_clusters',
|
||||
$eventId = (string) Str::uuid();
|
||||
DB::table('audit_events')->insert(['id' => $eventId, 'source_system' => self::SOURCE, 'entity_type' => 'economic_clusters',
|
||||
'entity_id' => $cluster->id, 'external_id' => $cluster->id.':'.$state['version'], 'actor_user_id' => $actor,
|
||||
'action' => $action, 'data_classification' => 'restricted',
|
||||
'before_data' => json_encode(['version' => $before['version']], JSON_THROW_ON_ERROR),
|
||||
'after_data' => json_encode(['version' => $state['version'], 'restored_from' => $input['revision'] ?? null,
|
||||
'after_data' => json_encode(['version' => $state['version'], 'editorial_state' => $state['workflow']['state'] ?? null, 'restored_from' => $input['revision'] ?? null,
|
||||
'reason' => Crypt::encryptString($input['reason'] ?? ''),
|
||||
'snapshot' => Crypt::encryptString(json_encode($state, JSON_THROW_ON_ERROR))], JSON_THROW_ON_ERROR)]);
|
||||
if ($this->editorialEnabled()) {
|
||||
$user = User::findOrFail($actor);
|
||||
app(PortalEditorialNativeNotices::class)->emit($user, $eventId, $state['workflow']['contributors']);
|
||||
}
|
||||
|
||||
return $this->management($cluster->id);
|
||||
});
|
||||
@@ -144,9 +163,101 @@ final class ClusterCompetitiveness
|
||||
*/
|
||||
public function publicData(string $cluster): ?array
|
||||
{
|
||||
$approved = $this->current($cluster)['approved'];
|
||||
$state = $this->current($cluster);
|
||||
$approved = isset($state['workflow']) ? $state['published'] : $state['approved'];
|
||||
|
||||
// Explicit projection: never return editor identity, approval evidence, history or the unapproved draft.
|
||||
return $approved ? ['draft' => $approved['draft'], 'version' => $approved['version'], 'at' => $approved['at']] : null;
|
||||
}
|
||||
|
||||
public function editorialEnabled(): bool
|
||||
{
|
||||
return (bool) config('editorial_workflow.cluster_competitiveness');
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed>|null $draft */
|
||||
private function editionHash(EconomicCluster $cluster, ?array $draft): string
|
||||
{
|
||||
$context = Arr::only($cluster->getAttributes(), ['id', 'code', 'name', 'sector', 'status', 'primary_territory_id', 'territory_version']);
|
||||
|
||||
return hash('sha256', json_encode(Arr::sortRecursive(['context' => $context, 'draft' => $draft]), JSON_THROW_ON_ERROR));
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed> $input
|
||||
* @param array<array-key,mixed> $state
|
||||
* @return array<array-key,mixed>
|
||||
*/
|
||||
private function editorialChange(EconomicCluster $cluster, int $actorId, string $action, array $input, array $state): array
|
||||
{
|
||||
$actor = User::whereKey($actorId)->firstOrFail();
|
||||
abort_unless($actor->can('manage-portal') && ! app(PortalProfileAccess::class)->has($actor, 'auditor'), 403);
|
||||
abort_unless(app(PortalProfileAccess::class)->mfa($actor), 403, 'Confirme o MFA na sessão existente.');
|
||||
if (! isset($state['workflow'])) {
|
||||
abort_unless(in_array($action, ['saved', 'restored', 'withdrawn'], true), 409, 'Guarde uma edição privada antes de iniciar o novo circuito.');
|
||||
// An accepted legacy publication remains public; no retrospective approval is invented.
|
||||
$state['published'] = $state['approved'];
|
||||
$state['approved'] = null;
|
||||
$state['workflow'] = ['state' => 'draft', 'edition' => $state['version'], 'contributors' => [], 'approval' => null,
|
||||
'hash' => $this->editionHash($cluster, $state['draft']), 'independent_required' => false];
|
||||
}
|
||||
$workflow = $state['workflow'];
|
||||
if (in_array($action, ['saved', 'restored'], true)) {
|
||||
if ($action === 'saved') {
|
||||
$state['draft'] = $this->validateDraft($input['draft'], $cluster->id);
|
||||
$restoredContributors = [];
|
||||
} else {
|
||||
$event = $this->events($cluster->id)->where('after_data->version', $input['revision'])->first();
|
||||
abort_unless($event !== null, 404);
|
||||
$restored = $this->decode($event);
|
||||
$state['draft'] = $restored['draft'];
|
||||
$restoredContributors = $restored['workflow']['contributors'] ?? [$event->actor_user_id];
|
||||
}
|
||||
$state['approved'] = null;
|
||||
$state['workflow'] = ['state' => 'draft', 'edition' => $state['version'] + 1,
|
||||
'contributors' => array_values(array_unique([...($workflow['state'] === 'published' ? [] : $workflow['contributors']), ...$restoredContributors, $actorId])),
|
||||
'hash' => $this->editionHash($cluster, $state['draft']), 'approval' => null,
|
||||
'independent_required' => $this->independentRequired($workflow)];
|
||||
|
||||
return $state;
|
||||
}
|
||||
validator($input, ['reason' => 'required|string|min:10|max:3000'])->validate();
|
||||
$allowed = ['submitted' => ['draft', 'returned'], 'review_started' => ['submitted'], 'returned' => ['in_review'], 'rejected' => ['in_review'],
|
||||
'approved' => ['in_review'], 'published' => ['approved'], 'archived' => ['draft', 'submitted', 'in_review', 'returned', 'rejected', 'approved', 'published'], 'withdrawn' => ['draft', 'submitted', 'in_review', 'returned', 'rejected', 'approved', 'published', 'archived']];
|
||||
abort_unless(isset($allowed[$action]) && in_array($workflow['state'], $allowed[$action], true), 409, 'Transição incompatível com o estado da edição.');
|
||||
if (in_array($action, ['submitted', 'approved', 'published'], true)) {
|
||||
abort_unless(hash_equals($workflow['hash'], $this->editionHash($cluster, $state['draft'])), 409, 'O contexto do cluster mudou. Guarde nova edição e volte a conferir.');
|
||||
}
|
||||
if ($action === 'submitted' || $action === 'approved') {
|
||||
$this->assertComplete($state['draft']);
|
||||
}
|
||||
if ($action === 'approved') {
|
||||
abort_if($this->independentRequired($workflow) && in_array($actorId, $workflow['contributors'], true), 403, 'Aprovação independente necessária para esta edição.');
|
||||
$workflow['approval'] = ['actor' => $actorId, 'edition' => $workflow['edition'], 'hash' => $workflow['hash'], 'at' => now()->toISOString(), 'reason' => $input['reason']];
|
||||
$state['approved'] = ['draft' => $state['draft'], 'at' => now()->toISOString(), 'actor' => $actorId, 'version' => $state['version'] + 1, 'evidence' => $input['reason']];
|
||||
}
|
||||
if ($action === 'published') {
|
||||
$decision = $workflow['approval'];
|
||||
abort_unless($decision && $decision['edition'] === $workflow['edition'] && hash_equals($decision['hash'], $workflow['hash']), 422, 'Aprovação desta edição necessária.');
|
||||
$reviewer = User::whereKey($decision['actor'])->first();
|
||||
abort_unless($reviewer && $reviewer->can('manage-portal') && ! app(PortalProfileAccess::class)->has($reviewer, 'auditor'), 403, 'Autoridade da aprovação revogada.');
|
||||
abort_if($this->independentRequired($workflow) && in_array($reviewer->id, $workflow['contributors'], true), 403, 'Aprovação independente necessária.');
|
||||
$state['published'] = [...$state['approved'], 'at' => now()->toISOString(), 'version' => $state['version'] + 1];
|
||||
}
|
||||
if ($action === 'withdrawn' || ($action === 'archived' && $workflow['state'] === 'published')) {
|
||||
$state['published'] = null;
|
||||
}
|
||||
$workflow['state'] = match ($action) {
|
||||
'submitted' => 'submitted', 'review_started' => 'in_review', 'returned' => 'returned', 'rejected' => 'rejected',
|
||||
'approved' => 'approved', 'published' => 'published', 'archived' => 'archived', 'withdrawn' => $workflow['state'] === 'published' ? 'archived' : $workflow['state'],
|
||||
};
|
||||
$state['workflow'] = $workflow;
|
||||
|
||||
return $state;
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed> $workflow */
|
||||
private function independentRequired(array $workflow): bool
|
||||
{
|
||||
return ($workflow['independent_required'] ?? false) || in_array('cluster_competitiveness', config('editorial_workflow.independent_approval.kinds', []), true);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -139,7 +139,8 @@ final class CompanyComparison
|
||||
public function view(User $actor, string $id, array $input): array
|
||||
{
|
||||
$case = $this->desk->case($actor, $id);
|
||||
$saved = $this->desk->decode($case->payload)['company_comparison'] ?? null;
|
||||
$payload = $this->desk->decode($case->payload);
|
||||
$saved = $payload['company_comparison'] ?? null;
|
||||
$v = Validator::make($input, ['revision' => 'nullable|uuid', 'history_before' => 'nullable|integer|min:1'])->validate();
|
||||
if (! empty($v['revision'])) {
|
||||
if (array_key_exists('answers', $input)) {
|
||||
@@ -160,7 +161,7 @@ final class CompanyComparison
|
||||
return ['id' => $row->id, 'revision' => $snapshot['revision'], 'at' => $snapshot['at'], 'engine_version' => $snapshot['result']['engine_version']];
|
||||
})->all();
|
||||
|
||||
return ['case' => ['id' => $id, 'title' => $case->title, 'version' => (int) $case->version],
|
||||
return ['entity_kind' => $payload['investor_path']['context']['promoter_entity']['kind'] ?? ($case->company_id ? 'company' : 'undetermined'), 'case' => ['id' => $id, 'title' => $case->title, 'version' => (int) $case->version],
|
||||
'canWrite' => ! $case->closed_at && $this->desk->owns($actor, $case), 'answers' => $answers, 'result' => $result,
|
||||
'saved' => $saved, 'history' => $history, 'historyNext' => $events->count() > 25 ? $events[24]->event_order : null,
|
||||
'historical' => ! empty($v['revision']), 'workingCopy' => array_key_exists('answers', $input)];
|
||||
@@ -171,7 +172,7 @@ final class CompanyComparison
|
||||
public function save(User $actor, string $id, array $input): array
|
||||
{
|
||||
$this->desk->case($actor, $id, true);
|
||||
$v = Validator::make($input, ['version' => 'required|integer|min:1', 'operation_key' => 'required|uuid'])->validate();
|
||||
$v = Validator::make($input, ['version' => 'required|integer|min:1', 'operation_key' => 'required|uuid', 'continue_preparation' => 'nullable|boolean'])->validate();
|
||||
$v['version'] = (int) $v['version'];
|
||||
|
||||
return DB::transaction(function () use ($actor, $id, $v, $input) {
|
||||
@@ -180,19 +181,23 @@ final class CompanyComparison
|
||||
$data = $this->desk->decode($event->payload);
|
||||
if ($data['operation_key'] === $v['operation_key']) {
|
||||
$answers = $this->normalize($input, $data['snapshot']['result']['questions']);
|
||||
$hash = hash('sha256', json_encode([$v['version'], $answers], JSON_THROW_ON_ERROR));
|
||||
$hash = hash('sha256', json_encode(! empty($v['continue_preparation']) ? [$v['version'], $answers, 'continue_preparation'] : [$v['version'], $answers], JSON_THROW_ON_ERROR));
|
||||
abort_unless(hash_equals($data['request_hash'], $hash), 409, 'Esta operação já guardou respostas diferentes. Reabra a comparação.');
|
||||
|
||||
return ['saved' => true, 'replayed' => true, 'revision' => $data['snapshot']['revision']];
|
||||
}
|
||||
}
|
||||
$answers = $this->answers($input);
|
||||
$hash = hash('sha256', json_encode([$v['version'], $answers], JSON_THROW_ON_ERROR));
|
||||
$hash = hash('sha256', json_encode(! empty($v['continue_preparation']) ? [$v['version'], $answers, 'continue_preparation'] : [$v['version'], $answers], JSON_THROW_ON_ERROR));
|
||||
abort_if($case->closed_at || (int) $case->version !== (int) $v['version'], 409, 'O dossier mudou ou foi fechado. Conserve as respostas e recupere a versão actual antes de guardar.');
|
||||
$payload = $this->desk->decode($case->payload);
|
||||
if (! empty($v['continue_preparation'])) {
|
||||
abort_if(in_array($payload['investor_path']['context']['promoter_entity']['kind'] ?? '', ['company', 'organization'], true), 422, 'A entidade existente pode continuar a viabilidade sem preparar nova constituição.');
|
||||
abort_if(($answers['preferred'] ?? 'unknown') === 'unknown', 422, 'Escolha a alternativa que pretende preparar.');
|
||||
}
|
||||
$result = $this->evaluate($answers);
|
||||
$previous = $payload['company_comparison'] ?? null;
|
||||
if ($previous !== null && $previous['answers'] === $answers && $previous['result'] === $result) {
|
||||
if (empty($v['continue_preparation']) && $previous !== null && $previous['answers'] === $answers && $previous['result'] === $result) {
|
||||
return ['saved' => true, 'replayed' => false, 'unchanged' => true, 'revision' => $previous['revision']];
|
||||
}
|
||||
$snapshot = ['revision' => (int) ($payload['company_comparison']['revision'] ?? 0) + 1, 'answers' => $answers,
|
||||
@@ -201,6 +206,9 @@ final class CompanyComparison
|
||||
$case->version++;
|
||||
DB::table('desk_cases')->where('id', $id)->update(['payload' => $this->desk->encode($payload), 'version' => $case->version, 'updated_at' => now()]);
|
||||
$this->desk->event($case, $actor, self::EVENT, ['operation_key' => $v['operation_key'], 'request_hash' => $hash, 'snapshot' => $snapshot]);
|
||||
if (! empty($v['continue_preparation'])) {
|
||||
app(InvestorContext::class)->setPromoter($actor, $id, ['version' => $case->version, 'operation_key' => (string) \Illuminate\Support\Str::uuid(), 'kind' => 'being_formed']);
|
||||
}
|
||||
|
||||
return ['saved' => true, 'replayed' => false, 'revision' => $snapshot['revision']];
|
||||
});
|
||||
|
||||
@@ -23,7 +23,7 @@ final class CompanyPreparation
|
||||
return ['version' => self::VERSION, 'forms' => config('company-comparison.forms'),
|
||||
'roles' => ['subscriber' => 'Titular, sócio ou accionista', 'administrator' => 'Administrador ou gerente', 'representative' => 'Representante', 'beneficial_owner' => 'Beneficiário efectivo declarado'],
|
||||
'source' => config('company-comparison.source'),
|
||||
'template_status' => 'source_pending', 'template_notice' => 'Os sete exemplares referidos no complemento ainda não foram fornecidos. Esta ficha prepara dados para revisão; não é uma minuta contratual, assinatura, registo ou licença.'];
|
||||
'template_status' => 'source_pending', 'template_notice' => 'Os modelos contratuais não estão disponíveis nesta preparação. Prepare os dados para revisão; esta preparação não é uma minuta contratual, assinatura, registo ou licença.'];
|
||||
}
|
||||
|
||||
/** Reuse only the already-authorized, frozen dossier values, never a fresh master lookup.
|
||||
@@ -36,8 +36,8 @@ final class CompanyPreparation
|
||||
$sources['case_proponent'] = ['name' => $payload['name'], 'kind' => 'person', 'reference' => $case->id,
|
||||
'version' => $payload['reuse_consent']['date'] ?? 'creation', 'origin' => 'Proponente conservado na criação do dossier'];
|
||||
}
|
||||
if ($case->company_id && ! empty($payload['company']['name'])) {
|
||||
$sources['case_company'] = ['name' => $payload['company']['name'], 'kind' => 'entity', 'reference' => $case->company_id,
|
||||
if (($case->company_id || ! empty($payload['investor_path']['context']['promoter_entity']['id'])) && ! empty($payload['company']['name'])) {
|
||||
$sources['case_company'] = ['name' => $payload['company']['name'], 'kind' => 'entity', 'reference' => $case->company_id ?? $payload['investor_path']['context']['promoter_entity']['id'],
|
||||
'version' => $payload['company_version'] ?? null, 'origin' => 'Declaração de empresa conservada no dossier'];
|
||||
}
|
||||
|
||||
@@ -220,7 +220,7 @@ final class CompanyPreparation
|
||||
{
|
||||
$case = $this->desk->case($actor, $id);
|
||||
$payload = $this->desk->decode($case->payload);
|
||||
$v = Validator::make($input, ['revision' => 'nullable|uuid', 'history_before' => 'nullable|integer|min:1'])->validate();
|
||||
$v = Validator::make($input, ['revision' => 'nullable|uuid', 'history_before' => 'nullable|integer|min:1', 'form' => ['nullable', Rule::in(array_keys(config('company-comparison.forms')))]])->validate();
|
||||
$saved = $payload['company_preparation'] ?? null;
|
||||
if (! empty($v['revision'])) {
|
||||
$event = DB::table('desk_events')->where('case_id', $id)->where('action', self::EVENT)->where('id', $v['revision'])->first();
|
||||
@@ -228,11 +228,22 @@ final class CompanyPreparation
|
||||
$saved = $this->desk->decode($event->payload)['snapshot'];
|
||||
}
|
||||
$facts = $saved['facts'] ?? $this->facts(['facts' => []]);
|
||||
$entity = $payload['investor_path']['context']['promoter_entity'] ?? null;
|
||||
$context = app(InvestorContext::class)->state($case)['fields'];
|
||||
$existingEntity = in_array($entity['kind'] ?? '', ['company', 'organization'], true);
|
||||
if (! $saved && empty($v['revision'])) {
|
||||
foreach (['currency' => 'currency', 'activities' => 'products_services', 'seat' => 'location'] as $target => $source) {
|
||||
if (empty($facts[$target]) && ! empty($context[$source])) $facts[$target] = $context[$source];
|
||||
}
|
||||
$facts['proposed_name'] = $entity['snapshot']['name'] ?? $facts['proposed_name'];
|
||||
$knownForm = $entity['snapshot']['legal_form'] ?? null;
|
||||
$facts['form'] = $existingEntity ? $knownForm : ($v['form'] ?? $facts['form']);
|
||||
}
|
||||
$events = DB::table('desk_events')->where('case_id', $id)->where('action', self::EVENT)
|
||||
->when(! empty($v['history_before']), fn ($q) => $q->where('event_order', '<', $v['history_before']))
|
||||
->orderByDesc('event_order')->limit(26)->get(['id', 'payload', 'event_order']);
|
||||
|
||||
return ['case' => ['id' => $id, 'title' => $case->title, 'version' => (int) $case->version],
|
||||
return ['entity' => $entity, 'proposedForm' => ! $existingEntity ? ($v['form'] ?? null) : null, 'case' => ['id' => $id, 'title' => $case->title, 'version' => (int) $case->version],
|
||||
'canWrite' => ! $case->closed_at && $this->desk->owns($actor, $case), 'historical' => ! empty($v['revision']),
|
||||
'definition' => $saved['definition'] ?? $this->definition(), 'facts' => $facts, 'review' => $saved['review'] ?? $this->review($facts), 'saved' => $saved,
|
||||
'sources' => $this->sources($case), 'history' => $events->take(25)->map(function ($e) {
|
||||
@@ -265,6 +276,11 @@ final class CompanyPreparation
|
||||
$hash = hash('sha256', json_encode([(int) $v['version'], $facts], JSON_THROW_ON_ERROR));
|
||||
abort_if($case->closed_at || (int) $case->version !== (int) $v['version'], 409, 'O dossier mudou ou foi fechado. Os dados continuam no formulário; recupere a versão antes de guardar.');
|
||||
$payload = $this->desk->decode($case->payload);
|
||||
$entity = $payload['investor_path']['context']['promoter_entity'] ?? null;
|
||||
$registeredForm = $entity['snapshot']['legal_form'] ?? null;
|
||||
if (in_array($entity['kind'] ?? '', ['company', 'organization'], true) && $registeredForm) {
|
||||
abort_unless($facts['form'] === $registeredForm, 422, 'A forma jurídica da entidade existente não é alterada nesta preparação. Use o percurso próprio de alteração do cadastro.');
|
||||
}
|
||||
$previous = $payload['company_preparation'] ?? null;
|
||||
$resolved = $this->resolve($facts, $this->sources($case), $previous);
|
||||
$definition = $this->definition();
|
||||
|
||||
@@ -24,6 +24,15 @@ final class ContentManagement
|
||||
$editor = $documents->full($actor) || $documents->editorial($actor);
|
||||
$upload = $editor || $documents->limited($actor);
|
||||
$result = [];
|
||||
if (app(PortalEditorialWorkflow::class)->demographyAccess($actor)) {
|
||||
$result['demography'] = ['index' => '/management/demography'];
|
||||
}
|
||||
if (app(PortalEditorialWorkflow::class)->portfolioAvailable() && $actor->can('manage-portal') && ! $profiles->has($actor, 'auditor')) {
|
||||
$result['portfolio'] = ['index' => '/management/portfolio'];
|
||||
}
|
||||
if (app(ClusterCompetitiveness::class)->editorialEnabled() && $actor->can('manage-portal') && ! $profiles->has($actor, 'auditor')) {
|
||||
$result['clusters'] = ['index' => '/management/clusters'];
|
||||
}
|
||||
if (app(Procurement::class)->available() && app(Procurement::class)->access($actor)) {
|
||||
$result['procurement'] = ['index' => '/management/concursos', 'create' => '/management/concursos/novo'];
|
||||
}
|
||||
@@ -35,9 +44,74 @@ final class ContentManagement
|
||||
$result['documents'] = ['index' => '/management/portal-services', 'edit' => $editor];
|
||||
}
|
||||
|
||||
if (($editor || isset($result['opportunities'])) && ! $profiles->has($actor, 'auditor') && app(PortalEditorialWorkflow::class)->available()) {
|
||||
$result['editorial'] = ['index' => '/management/editorial'];
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed> $access
|
||||
* @return list<array{label:string,href:string}>
|
||||
*/
|
||||
public function administrationNavigation(?User $actor, array $access): array
|
||||
{
|
||||
if (! $actor || ! $actor->hasVerifiedEmail()) {
|
||||
return [];
|
||||
}
|
||||
$items = [];
|
||||
foreach (['documents' => 'Biblioteca e documentos', 'opportunities' => 'Oportunidades', 'clusters' => 'Competitividade', 'portfolio' => 'Carteira', 'demography' => 'Demografia', 'procurement' => 'Concursos e anúncios'] as $key => $label) {
|
||||
if (isset($access[$key]['index'])) {
|
||||
$items[] = ['label' => $label, 'href' => $access[$key]['index']];
|
||||
}
|
||||
}
|
||||
if (app(PortalEditorialSubjects::class)->available() && $actor->can('manage-portal') && ! app(PortalProfileAccess::class)->has($actor, 'auditor')) {
|
||||
$items[] = ['label' => 'Estruturas e relações', 'href' => '/management/editorial/subjects'];
|
||||
}
|
||||
$native = app(PortalEditorialNativeNotices::class);
|
||||
if ($native->access($actor, 'territorial-editorial-v1')) {
|
||||
$items[] = ['label' => 'Conteúdos territoriais', 'href' => '/management/territorial/editorial'];
|
||||
}
|
||||
if ($native->access($actor, 'investment-zones')) {
|
||||
$items[] = ['label' => 'Zonas e indicadores', 'href' => '/management/investment/zones'];
|
||||
}
|
||||
|
||||
return $items;
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed> $access
|
||||
* @return list<array{label:string,href:string}>
|
||||
*/
|
||||
public function dashboardNavigation(?User $actor, array $access): array
|
||||
{
|
||||
if (! $actor || ! $actor->hasVerifiedEmail() || (! $actor->can('manage-portal') && $access === [] && ! app(ScopedPortalAdministration::class)->administrative($actor))) {
|
||||
return [];
|
||||
}
|
||||
$items = [['label' => 'Visão geral', 'href' => '/dashboard'], ['label' => 'O meu trabalho', 'href' => '/dashboard#meu-trabalho']];
|
||||
if ($actor->can('manage-portal') && ! app(PortalProfileAccess::class)->has($actor, 'auditor')) {
|
||||
foreach (['manifestacoes' => 'Manifestações de interesse', 'indicadores-oportunidades' => 'Indicadores de oportunidades', 'pedidos-recentes' => 'Pedidos recentes', 'accoes-rapidas' => 'Acções rápidas'] as $anchor => $label) {
|
||||
$items[] = ['label' => $label, 'href' => '/dashboard#'.$anchor];
|
||||
}
|
||||
$items[] = ['label' => 'Indicadores de utilização', 'href' => '/management/product-usage'];
|
||||
}
|
||||
if (! $actor->can('manage-portal') && app(InvestorPath::class)->available()) {
|
||||
$items[] = ['label' => 'Os meus investimentos', 'href' => '/dashboard#meus-investimentos'];
|
||||
}
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
if ($workflow->available() && $workflow->canEnter($actor)) {
|
||||
$items[] = ['label' => 'Circuito editorial', 'href' => '/management/editorial'];
|
||||
$documents = app(DocumentManagementAccess::class);
|
||||
if ($documents->full($actor) || $documents->editorial($actor)) {
|
||||
foreach (['article' => 'Revisão de artigos', 'legislation' => 'Revisão de legislação', 'document' => 'Revisão de documentos'] as $kind => $label) {
|
||||
$items[] = ['label' => $label, 'href' => '/management/editorial?kind='.$kind];
|
||||
}
|
||||
}
|
||||
$items[] = ['label' => 'Notificações editoriais', 'href' => '/management/editorial#notificacoes'];
|
||||
}
|
||||
|
||||
return $items;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<array-key, mixed>
|
||||
*/
|
||||
|
||||
@@ -0,0 +1,156 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use Illuminate\Database\Query\Builder;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
final class DemographicEvidence
|
||||
{
|
||||
public function territories(): Builder
|
||||
{
|
||||
$public = app(InvestmentGeography::class)->publicReferences();
|
||||
|
||||
return DB::table('geo_locations')->whereNull('deleted_at')->whereIn('location_type', ['province', 'district'])
|
||||
->where(function ($q) use ($public) {
|
||||
$q->whereIn('id', (clone $public)->select('id'));
|
||||
if ($this->installed() && str_ends_with(DB::connection()->getDatabaseName(), '_test')) {
|
||||
// Macate/Vanduzi: expressly authorised QA references, never active registry changes.
|
||||
$q->orWhere(fn ($qa) => $qa->where('source_system', 'ine-demography-qa')->where('data_classification', 'public')->whereIn('parent_id', (clone $public)->select('id')));
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
public function installed(): bool
|
||||
{
|
||||
return (bool) config('demography.enabled', app()->environment('local', 'testing'))
|
||||
&& Schema::hasTable('demographic_imports') && Schema::hasTable('demographic_observations');
|
||||
}
|
||||
|
||||
/** @return array<string,string> */
|
||||
public static function sectors(): array
|
||||
{
|
||||
return ['commerce' => 'Comércio e serviços', 'industry' => 'Indústria', 'agriculture' => 'Agricultura e agro-indústria', 'education' => 'Educação', 'health' => 'Saúde', 'general' => 'Contexto geral'];
|
||||
}
|
||||
|
||||
/** Broader administrative evidence stays labelled as context, never local data.
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function investmentContext(string $territory, int $start, int $end, string $sector = 'general', ?string $edition = null): array
|
||||
{
|
||||
$path = app(InvestmentGeography::class)->path($territory);
|
||||
$requested = collect($path)->last();
|
||||
$result = $this->analyse([], $start, $end, $sector, $edition);
|
||||
foreach (array_reverse($path) as $node) {
|
||||
if (! in_array($node->location_type, ['district', 'province'], true)) {
|
||||
continue;
|
||||
}
|
||||
$result = $this->analyse([$node->id], $start, $end, $sector, $edition);
|
||||
if ($result['state'] === 'available') {
|
||||
break;
|
||||
}
|
||||
}
|
||||
$result['requested_territory'] = $requested ? ['id' => $requested->id, 'name' => $requested->name, 'level' => $requested->location_type] : null;
|
||||
$result['broader_context'] = $requested && count($result['territories']) && $requested->id !== $result['territories'][0]['id'];
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/** @param list<string> $territories
|
||||
* @return array<string,mixed> */
|
||||
public function analyse(array $territories, int $start, int $end, string $sector = 'general', ?string $edition = null): array
|
||||
{
|
||||
$result = ['state' => 'unavailable', 'start_year' => $start, 'end_year' => $end, 'sector' => $sector, 'territories' => [], 'differences' => [], 'comparisons' => [],
|
||||
'limitations' => ['População residente não mede procura efectiva ou poder de compra.', 'Idade activa não demonstra disponibilidade ou qualificação de mão-de-obra.',
|
||||
'Sem extrapolação: anos sem série oficial permanecem sem dados.', 'A demografia não altera impostos, incentivos ou probabilidades de sucesso.']];
|
||||
if (! $this->installed() || $territories === []) {
|
||||
return $result;
|
||||
}
|
||||
$locations = $this->territories()->whereIn('id', $territories)->get(['id', 'name', 'location_type']);
|
||||
$records = DB::table('demographic_observations as o')->join('demographic_imports as b', 'b.id', '=', 'o.import_id')
|
||||
->where('b.status', 'approved')->whereIn('o.geo_location_id', $locations->pluck('id'))->whereBetween('o.year', [$start, $end])
|
||||
->where('o.sex', 'all')->when($edition, fn ($q) => $q->where('b.id', $edition))
|
||||
->orderBy('o.year')->orderBy('o.import_id')->orderBy('o.id')
|
||||
->get(['o.*', 'b.source', 'b.publication_version', 'b.sha256', 'b.file_name']);
|
||||
$issuesByImport = DB::table('demographic_imports')->whereIn('id', $records->pluck('import_id')->unique()->all())
|
||||
->get(['id', DB::raw("report->'issue_counts' AS issue_counts")])->keyBy('id');
|
||||
foreach ($locations as $location) {
|
||||
$series = [];
|
||||
foreach ($records->where('geo_location_id', $location->id)->groupBy('import_id') as $importId => $rows) {
|
||||
$first = $rows->first();
|
||||
$issueCounts = json_decode($issuesByImport->get($importId)->issue_counts ?? '{}', true, 512, JSON_THROW_ON_ERROR);
|
||||
$values = $rows->filter(function ($r) use ($sector) {
|
||||
if ($r->indicator !== 'population') {
|
||||
return in_array($sector, ['health', 'general'], true);
|
||||
}
|
||||
|
||||
return $r->age_group === 'all' || in_array($sector, ['education', 'health', 'industry', 'agriculture', 'general'], true);
|
||||
})->map(fn ($r) => ['year' => $r->year, 'indicator' => $r->indicator, 'age_group' => $r->age_group, 'residence' => $r->residence,
|
||||
'value' => $r->numeric_value, 'original_value' => $r->original_value, 'unit' => $r->unit, 'data_kind' => $r->data_kind,
|
||||
'sheet' => $r->sheet, 'cell' => $r->cell, 'validation_status' => $r->validation_status])->values()->all();
|
||||
$years = array_values(array_unique(array_column($values, 'year')));
|
||||
$series[] = ['import_id' => $importId, 'source' => $first->source, 'version' => $first->publication_version, 'sha256' => $first->sha256, 'file_name' => $first->file_name,
|
||||
'values' => $values, 'missing_years' => array_values(array_diff(range($start, $end), $years)), 'issue_counts' => $issueCounts];
|
||||
}
|
||||
$result['territories'][] = ['id' => $location->id, 'name' => $location->name, 'level' => $location->location_type, 'series' => $series,
|
||||
'factors_to_assess' => match ($sector) {
|
||||
'industry' => ['Estrutura etária e evolução da população; verificar qualificações, mobilidade e emprego.'],
|
||||
'agriculture' => ['População rural e mercados locais; relacionar com os clusters documentados.'],
|
||||
'education' => ['Grupos etários da população-alvo; verificar cobertura e capacidade dos serviços.'],
|
||||
'health' => ['Estrutura etária e estatísticas vitais com unidades conhecidas; verificar cobertura dos serviços.'],
|
||||
default => ['Dimensão e evolução da população; confrontar com rendimento, acesso e condições sectoriais.'],
|
||||
}];
|
||||
}
|
||||
// Identify concurrent values without summing editions or choosing a supposedly newer one.
|
||||
foreach ($result['territories'] as $territory) {
|
||||
$byDimension = [];
|
||||
foreach ($territory['series'] as $series) {
|
||||
foreach ($series['values'] as $row) {
|
||||
$key = implode('|', [$row['year'], $row['indicator'], $row['age_group'], $row['residence'], $row['unit']]);
|
||||
$byDimension[$key][] = ['import_id' => $series['import_id'], 'value' => $row['value'], 'data_kind' => $row['data_kind']];
|
||||
}
|
||||
}
|
||||
foreach ($byDimension as $key => $values) {
|
||||
if (count($values) > 1) {
|
||||
$result['differences'][] = ['territory_id' => $territory['id'], 'dimension' => $key, 'state' => count(array_unique(array_column($values, 'value'))) === 1 ? 'matching_values' : 'divergent_values', 'values' => $values];
|
||||
}
|
||||
}
|
||||
}
|
||||
$result['state'] = $records->isEmpty() ? 'no_data' : 'available';
|
||||
foreach ($result['territories'] as $i => $left) {
|
||||
foreach (array_slice($result['territories'], $i + 1) as $right) {
|
||||
foreach ($left['series'] as $a) {
|
||||
foreach ($right['series'] as $b) {
|
||||
foreach (array_unique([$start, $end]) as $year) {
|
||||
$isTotal = fn ($r) => $r['year'] === $year && $r['indicator'] === 'population' && $r['age_group'] === 'all' && $r['residence'] === 'all';
|
||||
$x = array_values(array_filter($a['values'], $isTotal))[0] ?? null;
|
||||
$y = array_values(array_filter($b['values'], $isTotal))[0] ?? null;
|
||||
if (! $x || ! $y) {
|
||||
continue;
|
||||
}
|
||||
$comparable = $left['level'] === $right['level'] && $x['unit'] === $y['unit'] && $x['data_kind'] === $y['data_kind'] && $a['version'] === $b['version'];
|
||||
$delta = $comparable ? DB::selectOne('SELECT (?::numeric - ?::numeric)::text AS value', [$x['value'], $y['value']])->value : null;
|
||||
$result['comparisons'][] = ['year' => $year, 'left' => $left['name'], 'right' => $right['name'], 'left_value' => $x['value'], 'right_value' => $y['value'],
|
||||
'left_import' => $a['import_id'], 'right_import' => $b['import_id'], 'difference' => $delta,
|
||||
'explanation' => $comparable ? 'Diferença dos totais de população no mesmo ano, nível, tipo de dado, unidade e identificação de edição. Não mede procura efectiva.' : 'Âmbitos ou metadados distintos; não se calculou uma diferença como se fossem equivalentes.'];
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $context
|
||||
* @return array<string,mixed> */
|
||||
public function forContext(array $context): array
|
||||
{
|
||||
$fields = $context['fields'] ?? [];
|
||||
$id = ($fields['district_id'] ?? null) ?: ($fields['province_id'] ?? null);
|
||||
|
||||
// No inference from an influence area to a project's implantation territory.
|
||||
return $this->analyse($id ? [$id] : [], (int) date('Y'), (int) date('Y'), 'general');
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,283 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\User;
|
||||
use App\Services\Malware\MalwareScanner;
|
||||
use App\Support\CheckedFile;
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
use Illuminate\Support\Str;
|
||||
use Symfony\Component\Process\Process;
|
||||
|
||||
final class DemographicImport
|
||||
{
|
||||
/**
|
||||
* CLI preparation is read-only input, never an import or approval.
|
||||
*
|
||||
* @return array{preview:string,records:string,receipt:array<string,mixed>}|null
|
||||
*/
|
||||
public function preparedSource(string $sha, ?int $baselineYear, bool $verifyRecords = true): ?array
|
||||
{
|
||||
$root = config('demography.prepared_directory');
|
||||
if (! is_string($root) || $root === '') {
|
||||
return null;
|
||||
}
|
||||
abort_unless(preg_match('/^[a-f0-9]{64}$/', $sha) === 1, 422);
|
||||
$directory = $root.'/'.$sha;
|
||||
if (! is_file($directory.'/preparation.json')) {
|
||||
return null;
|
||||
}
|
||||
abort_unless(is_readable($directory.'/preparation.json'), 409, 'Recibo CLI indisponível.');
|
||||
try {
|
||||
$receipt = json_decode(CheckedFile::read($directory.'/preparation.json'), true, 512, JSON_THROW_ON_ERROR);
|
||||
} catch (\JsonException) {
|
||||
abort(409, 'Recibo CLI inválido.');
|
||||
}
|
||||
abort_unless(is_array($receipt), 409, 'Recibo CLI inválido.');
|
||||
$preview = $directory.'/preview.json';
|
||||
$records = $directory.'/records.ndjson';
|
||||
abort_unless(($receipt['sha256'] ?? '') === $sha && array_key_exists('baseline_year', $receipt) && $receipt['baseline_year'] === $baselineYear
|
||||
&& ($receipt['parser_sha256'] ?? '') === CheckedFile::sha256(base_path('tools/demography_workbook.py'))
|
||||
&& is_file($preview) && CheckedFile::matches($preview, $receipt['preview_sha256'] ?? '') && is_file($records), 409, 'A preparação CLI mudou; conservar o original e preparar novamente fora do servidor web.');
|
||||
try {
|
||||
$report = json_decode(CheckedFile::read($preview), true, 512, JSON_THROW_ON_ERROR);
|
||||
} catch (\JsonException) {
|
||||
abort(409, 'Prévia CLI inválida.');
|
||||
}
|
||||
abort_unless(is_array($report), 409, 'Prévia CLI inválida.');
|
||||
abort_unless(($report['sha256'] ?? '') === $sha && ($report['record_count'] ?? null) === ($receipt['record_count'] ?? null)
|
||||
&& ($report['records_file_sha256'] ?? '') === ($receipt['records_sha256'] ?? '')
|
||||
&& (! $verifyRecords || CheckedFile::matches($records, $receipt['records_sha256'] ?? '')), 409, 'Resultados da preparação CLI alterados.');
|
||||
|
||||
return ['preview' => $preview, 'records' => $records, 'receipt' => $receipt];
|
||||
}
|
||||
|
||||
/** @param array<string,array<string,mixed>> $files */
|
||||
public function preparedSourcesReady(array $files): bool
|
||||
{
|
||||
try {
|
||||
foreach ($files as $name => $expected) {
|
||||
$source = $this->preparedSource($expected['sha256'], $name === 'Dados demograficos.xlsx' ? 2017 : null, false);
|
||||
if ($source === null || $source['receipt']['record_count'] !== $expected['records']) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
return $files !== [];
|
||||
} catch (\Throwable) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
public function authorize(User $actor): void
|
||||
{
|
||||
$access = app(PortalProfileAccess::class);
|
||||
abort_unless(($actor->can('manage-portal') || $access->superuser($actor)) && ! $access->has($actor, 'auditor'), 403);
|
||||
abort_unless($actor->two_factor_confirmed_at && $actor->two_factor_secret, 403, 'Confirme MFA para gerir dados demográficos.');
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges()) {
|
||||
abort_unless(app(DemographicInstallation::class)->activeTarget() && app(DemographicEvidence::class)->installed(), 403, 'Destino demográfico não instalado ou não autorizado.');
|
||||
abort_unless(app(PortalProfileAccess::class)->mfa($actor), 403, 'Conclua MFA nesta sessão para gerir dados demográficos.');
|
||||
}
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function prepare(User $actor, string $file, string $name, string $version, ?int $baselineYear): array
|
||||
{
|
||||
$this->authorize($actor);
|
||||
abort_unless(is_file($file) && filesize($file) <= 20_000_000 && strtolower(pathinfo($name, PATHINFO_EXTENSION)) === 'xlsx', 422);
|
||||
$sha = CheckedFile::sha256($file);
|
||||
$existing = DB::table('demographic_imports')->where('sha256', $sha)->first();
|
||||
if ($existing) {
|
||||
return $this->preview($actor, $existing->id);
|
||||
}
|
||||
$id = (string) Str::uuid();
|
||||
$directory = 'demography/'.$id;
|
||||
$disk = Storage::disk('local');
|
||||
$disk->makeDirectory($directory);
|
||||
$path = $disk->path($directory.'/original.xlsx');
|
||||
abort_unless(copy($file, $path) && CheckedFile::matches($path, $sha), 409);
|
||||
$scan = app(MalwareScanner::class)->scan($path, (int) filesize($path), $disk->path($directory));
|
||||
abort_unless($scan['result'] === 'clean', 423, 'Análise antimalware pendente ou não limpa; original privado conservado.');
|
||||
$output = $disk->path($directory.'/preview.json');
|
||||
$prepared = $this->preparedSource($sha, $baselineYear);
|
||||
if ($prepared !== null) {
|
||||
abort_unless(copy($prepared['preview'], $output) && CheckedFile::matches($output, $prepared['receipt']['preview_sha256'])
|
||||
&& copy($prepared['records'], $disk->path($directory.'/records.ndjson'))
|
||||
&& CheckedFile::matches($disk->path($directory.'/records.ndjson'), $prepared['receipt']['records_sha256']), 409, 'Preparação CLI alterada durante a cópia.');
|
||||
} else {
|
||||
abort_unless(function_exists('proc_open'), 503, 'Este servidor web não executa o preparador. Prepare este original pelo importador CLI e confira o respectivo recibo antes de continuar.');
|
||||
$command = [config('demography.python', 'python'), base_path('tools/demography_workbook.py'), $path, '--output', $output, '--records-output', $disk->path($directory.'/records.ndjson')];
|
||||
if ($baselineYear !== null) {
|
||||
array_push($command, '--baseline-year', (string) $baselineYear);
|
||||
}
|
||||
$process = new Process($command, base_path(), timeout: 120);
|
||||
$process->run();
|
||||
abort_unless($process->isSuccessful(), 422, 'Não foi possível reconhecer o Excel; confira a estrutura e o ano de referência.');
|
||||
}
|
||||
$report = json_decode(CheckedFile::read($output), true, 512, JSON_THROW_ON_ERROR);
|
||||
abort_unless(hash_equals($sha, $report['sha256']) && CheckedFile::matches($path, $sha), 409);
|
||||
$summary = array_diff_key($report, ['records' => true]);
|
||||
$summary['scan'] = ['result' => $scan['result'], 'engine' => $scan['engine'], 'engine_version' => $scan['engine_version'], 'sha256' => $sha];
|
||||
// The supplied publication label is provenance metadata, never an invented edition/date.
|
||||
DB::table('demographic_imports')->insert(['id' => $id, 'sha256' => $sha, 'file_name' => basename($name),
|
||||
'source' => $report['source'], 'publication_version' => $version, 'status' => 'prepared',
|
||||
'report' => json_encode($summary, JSON_THROW_ON_ERROR), 'preview_sha256' => CheckedFile::sha256($output),
|
||||
'prepared_by' => $actor->id, 'created_at' => now(), 'updated_at' => now()]);
|
||||
$this->event($id, $actor, 'prepared', 'Pré-visualização do original; sem aprovação de utilização.', ['sha256' => $sha]);
|
||||
|
||||
return $this->preview($actor, $id);
|
||||
}
|
||||
|
||||
public static function key(string $province, string $territory, string $level): string
|
||||
{
|
||||
return $province.'|'.$territory.'|'.$level;
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function preview(User $actor, string $id): array
|
||||
{
|
||||
$this->authorize($actor);
|
||||
$batch = DB::table('demographic_imports')->where('id', $id)->first();
|
||||
abort_unless($batch !== null, 404);
|
||||
$report = json_decode($batch->report, true, 512, JSON_THROW_ON_ERROR);
|
||||
$locations = DB::table('geo_locations')->whereIn('location_type', ['province', 'district'])->whereNull('deleted_at')->get(['id', 'name', 'parent_id', 'location_type']);
|
||||
$matches = [];
|
||||
foreach ($report['territories'] as [$province, $territory, $level]) {
|
||||
$provinces = $locations->filter(fn ($g) => $g->location_type === 'province' && $this->normalize($g->name) === $this->normalize($province));
|
||||
$candidates = $level === 'province' ? $provinces : $locations->filter(fn ($g) => $g->location_type === 'district' && $provinces->contains('id', $g->parent_id) && $this->normalize($g->name) === $this->normalize($territory));
|
||||
$key = self::key($province, $territory, $level);
|
||||
if ($level === 'district') {
|
||||
$headers = $report['territory_headers'][$key] ?? [];
|
||||
if ($headers !== [] && $candidates->count() > 1 && array_all($headers, fn ($h) => preg_match('/^Distrito de /i', $h) === 1)) {
|
||||
$candidates = $candidates->filter(fn ($g) => ! preg_match('/^CIDADE /i', $g->name));
|
||||
}
|
||||
if ($headers !== [] && $candidates->count() > 1 && array_all($headers, fn ($h) => preg_match('/^Cidade (de|da) /i', $h) === 1)) {
|
||||
$candidates = $candidates->filter(fn ($g) => preg_match('/^CIDADE /i', $g->name) === 1);
|
||||
}
|
||||
$manifest = DemographicInstallation::remainingManifest();
|
||||
$hashes = array_column($manifest['files'], 'sha256');
|
||||
$alias = in_array($batch->sha256, $hashes, true) ? ($manifest['aliases'][$key] ?? null) : null;
|
||||
if ($alias !== null) {
|
||||
$candidates = $locations->filter(fn ($g) => $g->location_type === 'district' && $provinces->contains('id', $g->parent_id) && $this->literal($g->name) === $this->literal($alias));
|
||||
}
|
||||
}
|
||||
$matches[] = ['key' => self::key($province, $territory, $level), 'province' => $province, 'territory' => $territory, 'level' => $level,
|
||||
'geo_location_id' => $candidates->count() === 1 ? $candidates->first()->id : null, 'state' => $candidates->count() === 1 ? 'matched' : ($candidates->isEmpty() ? 'missing' : 'ambiguous')];
|
||||
}
|
||||
|
||||
return ['id' => $id, 'file_name' => $batch->file_name, 'sha256' => $batch->sha256, 'publication_version' => $batch->publication_version,
|
||||
'status' => $batch->status, 'report' => $report, 'matches' => $matches,
|
||||
'territory_options' => $locations->values()->all(), 'events' => DB::table('demographic_events')->where('import_id', $id)->orderBy('id')->get()];
|
||||
}
|
||||
|
||||
private function normalize(string $name): string
|
||||
{
|
||||
return preg_replace('/^(cidade|distrito) (de|da) /', '', $this->literal($name));
|
||||
}
|
||||
|
||||
private function literal(string $name): string
|
||||
{
|
||||
$name = str_replace(['`', '’', '‘', '´'], "'", Str::ascii($name));
|
||||
|
||||
return preg_replace('/\s+/', ' ', trim(strtolower(str_replace(['-', '–'], ' ', $name))));
|
||||
}
|
||||
|
||||
/** @param array<string,string> $mapping
|
||||
* @return array<string,mixed> */
|
||||
public function confirm(User $actor, string $id, string $sha, array $mapping, string $reason): array
|
||||
{
|
||||
$this->authorize($actor);
|
||||
|
||||
return DB::transaction(function () use ($actor, $id, $sha, $mapping, $reason) {
|
||||
$batch = DB::table('demographic_imports')->where('id', $id)->lockForUpdate()->first();
|
||||
abort_unless($batch && hash_equals($batch->sha256, $sha), 409);
|
||||
if ($batch->status !== 'prepared') {
|
||||
return ['id' => $id, 'status' => $batch->status, 'records' => DB::table('demographic_observations')->where('import_id', $id)->count(), 'repeated' => true];
|
||||
}
|
||||
$disk = Storage::disk('local');
|
||||
$file = $disk->path('demography/'.$id.'/preview.json');
|
||||
abort_unless(is_file($file) && CheckedFile::matches($file, $batch->preview_sha256) && CheckedFile::matches($disk->path('demography/'.$id.'/original.xlsx'), $sha), 409, 'Prévia ou original alterados.');
|
||||
$report = json_decode(CheckedFile::read($file), true, 512, JSON_THROW_ON_ERROR);
|
||||
$blocking = array_intersect(array_keys($report['issue_counts']), ['conflicting_value', 'duplicate_value', 'unsupported_sheet', 'unsupported_population_headers', 'reference_year_required', 'title_year_mismatch', 'invalid_numeric_or_formula']);
|
||||
abort_if($blocking !== [], 422, 'Corrija os erros estruturais antes de confirmar: '.implode(', ', $blocking));
|
||||
$plan = $this->preview($actor, $id);
|
||||
$resolved = [];
|
||||
foreach ($plan['matches'] as $match) {
|
||||
$locationId = $mapping[$match['key']] ?? $match['geo_location_id'];
|
||||
$location = DB::table('geo_locations')->where('id', $locationId)->whereNull('deleted_at')->first();
|
||||
abort_unless($location && $location->location_type === $match['level'], 422, 'Correspondência territorial por resolver.');
|
||||
if ($match['level'] === 'district') {
|
||||
$provinceKey = self::key($match['province'], $match['province'], 'province');
|
||||
$provinceMatch = array_values(array_filter($plan['matches'], fn ($m) => $m['key'] === $provinceKey))[0] ?? null;
|
||||
abort_unless($location->parent_id === ($mapping[$provinceKey] ?? $provinceMatch['geo_location_id'] ?? null), 422, 'Distrito fora da província indicada.');
|
||||
}
|
||||
abort_if(in_array($locationId, $resolved, true), 422, 'Duas designações não podem ser fundidas na mesma localização.');
|
||||
$resolved[$match['key']] = $locationId;
|
||||
}
|
||||
$chunk = [];
|
||||
$recordCount = 0;
|
||||
foreach ($this->recordRows($report, $disk->path('demography/'.$id.'/records.ndjson')) as $row) {
|
||||
$recordCount++;
|
||||
$chunk[] = ['import_id' => $id, 'geo_location_id' => $resolved[self::key($row['province'], $row['territory'], $row['level'])],
|
||||
...array_intersect_key($row, array_flip(['year', 'indicator', 'sex', 'residence', 'age_group', 'unit', 'data_kind', 'original_value', 'numeric_value', 'sheet', 'cell'])),
|
||||
'validation_status' => $report['issues'] === [] ? 'valid' : 'warning'];
|
||||
if (count($chunk) === 500) {
|
||||
DB::table('demographic_observations')->insert($chunk);
|
||||
$chunk = [];
|
||||
}
|
||||
}
|
||||
if ($chunk !== []) {
|
||||
DB::table('demographic_observations')->insert($chunk);
|
||||
}
|
||||
abort_unless($recordCount === $report['record_count'], 409, 'O número de observações difere da prévia.');
|
||||
DB::table('demographic_imports')->where('id', $id)->update(['status' => 'imported', 'updated_at' => now()]);
|
||||
$this->event($id, $actor, 'imported', $reason, ['mapping' => $resolved, 'records' => $recordCount, 'sha256' => $sha]);
|
||||
|
||||
return ['id' => $id, 'status' => 'imported', 'records' => $recordCount, 'repeated' => false];
|
||||
});
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $report
|
||||
* @return iterable<array<string,mixed>> */
|
||||
private function recordRows(array $report, string $path): iterable
|
||||
{
|
||||
if (! isset($report['records_file_sha256'])) {
|
||||
yield from $report['records'];
|
||||
|
||||
return;
|
||||
}
|
||||
abort_unless(is_file($path) && CheckedFile::matches($path, $report['records_file_sha256']), 409, 'As observações diferem da prévia conferida.');
|
||||
$stream = new \SplFileObject($path, 'r');
|
||||
while (! $stream->eof()) {
|
||||
$line = $stream->fgets();
|
||||
if (trim($line) === '') {
|
||||
continue;
|
||||
}
|
||||
yield json_decode($line, true, 512, JSON_THROW_ON_ERROR);
|
||||
}
|
||||
}
|
||||
|
||||
public function transition(User $actor, string $id, string $action, string $reason): void
|
||||
{
|
||||
$this->authorize($actor);
|
||||
DB::transaction(function () use ($actor, $id, $action, $reason) {
|
||||
$batch = DB::table('demographic_imports')->where('id', $id)->lockForUpdate()->first();
|
||||
abort_unless($batch !== null, 404);
|
||||
abort_unless(in_array($action, ['approved', 'disabled'], true) && $batch->status !== 'prepared', 422);
|
||||
abort_if($action === 'approved' && $batch->status !== 'approved' && app(PortalEditorialWorkflow::class)->demographyWrites($id), 409, 'Use a aprovação e publicação separadas do lote no circuito editorial.');
|
||||
abort_if($action === 'disabled' && Schema::hasColumn('portal_editorial_editions', 'demographic_import_id') && DB::table('portal_editorial_editions')->where('demographic_import_id', $id)->exists(), 409, 'Arquive a edição no circuito editorial para retirar a sua publicação.');
|
||||
// No deletes, replacement of other editions, or automatic publication in production.
|
||||
DB::table('demographic_imports')->where('id', $id)->update(['status' => $action, 'updated_at' => now()]);
|
||||
$this->event($id, $actor, $action, $reason, ['previous_status' => $batch->status]);
|
||||
});
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $details */
|
||||
private function event(string $id, User $actor, string $action, string $reason, array $details): void
|
||||
{
|
||||
DB::table('demographic_events')->insert(['import_id' => $id, 'actor_id' => $actor->id, 'action' => $action, 'reason' => $reason, 'details' => json_encode($details, JSON_THROW_ON_ERROR), 'created_at' => now()]);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,307 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\User;
|
||||
use App\Support\CheckedFile;
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Support\Facades\Artisan;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
use Illuminate\Support\Str;
|
||||
use Symfony\Component\Process\Exception\ExceptionInterface;
|
||||
use Symfony\Component\Process\Process;
|
||||
|
||||
/** Owner-authorised release; schema and data still require existing session MFA. */
|
||||
final class DemographicInstallation
|
||||
{
|
||||
public const MIGRATION = '2026_11_13_100000_create_demographic_series';
|
||||
|
||||
public const MANICA_SHA256 = '0c6d8feaefaed797fa57d61f923af5a86f37ac4b16f12d7d72ae1be8087ea698';
|
||||
|
||||
public const FILES = [
|
||||
'Manica.xlsx' => ['sha256' => self::MANICA_SHA256, 'records' => 71604],
|
||||
'Inhambane.xlsx' => ['sha256' => '51a9b91dfb6e32e5b49def115cb007f21faa97b3d0584b16ef911b22b89bd818', 'records' => 82620],
|
||||
'Dados demograficos.xlsx' => ['sha256' => '4763aaa7476f3ae24564e9750ac2ac8babb07dfbba67473a180fb9b1f47eb335', 'records' => 482],
|
||||
];
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public static function remainingManifest(): array
|
||||
{
|
||||
return json_decode(CheckedFile::read(database_path('data/demography-remaining-20261113.json')), true, 512, JSON_THROW_ON_ERROR);
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public static function zambeziaManifest(): array
|
||||
{
|
||||
return json_decode(CheckedFile::read(database_path('data/demography-zambezia-20261113.json')), true, 512, JSON_THROW_ON_ERROR);
|
||||
}
|
||||
|
||||
/** @return list<string> */
|
||||
public static function publicDistrictRefs(): array
|
||||
{
|
||||
$refs = [self::MANICA_SHA256.':Macate', self::MANICA_SHA256.':Vanduzi'];
|
||||
foreach ([self::remainingManifest(), self::zambeziaManifest()] as $manifest) {
|
||||
foreach ($manifest['new_districts'] as $province => $names) {
|
||||
$source = array_values(array_filter($manifest['files'], fn ($f) => $f['province'] === $province))[0]['sha256'];
|
||||
foreach ($names as $name) { $refs[] = $source.':'.$name; }
|
||||
}
|
||||
}
|
||||
return $refs;
|
||||
}
|
||||
|
||||
/** @return list<string> */
|
||||
public function files(): array
|
||||
{
|
||||
return ['database/data/demography-zambezia-20261113.json', 'database/data/demography-remaining-20261113.json', 'app/Services/DemographicInstallation.php', 'app/Services/DemographicImport.php', 'app/Services/DemographicEvidence.php',
|
||||
'app/Services/InvestmentGeography.php', 'app/Services/InvestmentPreparationWorkspace.php', 'app/Http/Controllers/DemographyController.php',
|
||||
'database/migrations/'.self::MIGRATION.'.php', 'config/demography.php', 'routes/demography.php', 'routes/web.php', 'tools/demography_workbook.py',
|
||||
'resources/js/components/demographic-context.tsx', 'resources/js/components/demographic-evidence.tsx', 'resources/js/components/simulation-form.tsx',
|
||||
'resources/js/components/structure-geography.tsx', 'resources/js/pages/investment/demography.tsx', 'resources/js/pages/investment/catalogue.tsx',
|
||||
'resources/js/pages/investment/detail.tsx', 'resources/js/pages/management/demography.tsx', 'resources/js/pages/management/demography-install.tsx',
|
||||
'resources/js/pages/management/shared.tsx'];
|
||||
}
|
||||
|
||||
public function fingerprint(): string
|
||||
{
|
||||
$files = [];
|
||||
foreach ($this->files() as $path) {
|
||||
$files[$path] = CheckedFile::sha256(base_path($path));
|
||||
}
|
||||
|
||||
return hash('sha256', json_encode($files, JSON_THROW_ON_ERROR));
|
||||
}
|
||||
|
||||
public function activeTarget(): bool
|
||||
{
|
||||
$c = config('database.connections.pgsql');
|
||||
$homologation = config('app.url') === 'https://teste-investidor.tempo.co.mz'
|
||||
&& config('demography.enabled', false) && $c['database'] === 'teste_investidor';
|
||||
if (app()->environment('testing') || config('database.default') !== 'pgsql' || ! empty($c['url'])
|
||||
|| ! in_array($c['host'], ['127.0.0.1', 'localhost'], true) || (int) $c['port'] !== 5432
|
||||
|| ($c['database'] !== 'investemoz' && ! $homologation)) {
|
||||
return false;
|
||||
}
|
||||
$target = DB::selectOne('SELECT current_database() AS database,inet_server_port() AS port');
|
||||
|
||||
return $target->database === $c['database'] && (int) $target->port === 5432;
|
||||
}
|
||||
|
||||
public function schemaAllowed(): bool
|
||||
{
|
||||
if (IsolatedQaDatabase::allowsSchemaChanges()) {
|
||||
return true;
|
||||
}
|
||||
$actor = auth()->user();
|
||||
if (! config('demography.authenticated_installation', false) || ! $actor || ! $this->activeTarget()) {
|
||||
return false;
|
||||
}
|
||||
app(PortalProfileInstallation::class)->authorize($actor, true);
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
private function authorize(User $actor, bool $write): void
|
||||
{
|
||||
app(PortalProfileInstallation::class)->authorize($actor, $write);
|
||||
abort_unless($this->activeTarget() || IsolatedQaDatabase::allowsSchemaChanges(), 403, 'Destino não autorizado para esta entrega.');
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function preview(User $actor): array
|
||||
{
|
||||
$this->authorize($actor, false);
|
||||
$proofFile = storage_path('app/private/demography-deployment/readiness.json');
|
||||
$proof = is_file($proofFile) ? json_decode(CheckedFile::read($proofFile), true, 512, JSON_THROW_ON_ERROR) : [];
|
||||
$code = $this->fingerprint();
|
||||
$target = (array) DB::selectOne('SELECT current_database() AS database,inet_server_port() AS port');
|
||||
$qa = IsolatedQaDatabase::allowsSchemaChanges();
|
||||
$ready = $qa || (($proof['code_sha256'] ?? '') === $code && ($proof['qa_passed'] ?? false) && ($proof['compatibility_verified'] ?? false)
|
||||
&& ($proof['restore_verified'] ?? false) && ($proof['files_verified'] ?? false) && ($proof['target']['database'] ?? '') === $target['database']
|
||||
&& (int) ($proof['target']['port'] ?? 0) === (int) $target['port'] && ($proof['decision'] ?? '') !== ''
|
||||
&& strtotime($proof['verified_at'] ?? '') >= time() - 86400 && strtotime($proof['verified_at'] ?? '') <= time());
|
||||
if (! $qa) {
|
||||
foreach (['dump', 'files'] as $kind) {
|
||||
$file = $proof[$kind.'_path'] ?? '';
|
||||
$ready = $ready && is_file($file) && CheckedFile::matches($file, $proof[$kind.'_sha256'] ?? '');
|
||||
}
|
||||
$ready = $ready && CheckedFile::matches(base_path('.env'), $proof['environment_sha256'] ?? '')
|
||||
&& is_file(public_path('build/manifest.json')) && CheckedFile::matches(public_path('build/manifest.json'), $proof['release_manifest_sha256'] ?? '');
|
||||
foreach ($proof['release_files'] ?? [] as $relative => $sha) {
|
||||
$file = public_path('build/'.$relative);
|
||||
$ready = $ready && ! str_contains($relative, '..') && ! str_contains($relative, ':') && is_file($file) && CheckedFile::matches($file, $sha);
|
||||
}
|
||||
}
|
||||
$tables = array_map(fn ($t) => Schema::hasTable($t), ['demographic_imports', 'demographic_observations', 'demographic_events']);
|
||||
$ledger = DB::table('migrations')->where('migration', self::MIGRATION)->exists();
|
||||
$consistent = ($ledger && ! in_array(false, $tables, true)) || (! $ledger && ! in_array(true, $tables, true));
|
||||
$preparedFiles = self::FILES + self::remainingManifest()['files'] + self::zambeziaManifest()['files'];
|
||||
$runtimeReady = app(DemographicImport::class)->preparedSourcesReady($preparedFiles);
|
||||
try {
|
||||
if (! $runtimeReady && function_exists('proc_open')) {
|
||||
$runtime = new Process([config('demography.python', 'python'), '-c', 'import sys; assert sys.version_info >= (3, 9)'], base_path(), timeout: 15);
|
||||
$runtime->run();
|
||||
$runtimeReady = $runtime->isSuccessful();
|
||||
}
|
||||
} catch (ExceptionInterface) {
|
||||
$runtimeReady = false;
|
||||
}
|
||||
$mode = $ledger ? 'remaining' : 'initial';
|
||||
$manifest = self::remainingManifest();
|
||||
if ($ledger && DB::table('demographic_imports')->whereIn('sha256', array_column($manifest['files'], 'sha256'))->where('status', 'approved')->count() === count($manifest['files'])) { $mode = 'zambezia'; $manifest = self::zambeziaManifest(); }
|
||||
$files = $mode !== 'initial' ? $manifest['files'] : self::FILES;
|
||||
$already = $ledger ? DB::table('demographic_imports')->whereIn('sha256', array_column($files, 'sha256'))->where('status', 'approved')->pluck('sha256')->all() : [];
|
||||
$pending = array_filter($files, fn ($f) => ! in_array($f['sha256'], $already, true));
|
||||
$state = ['mode' => $mode, 'pending_count' => count($pending), 'aliases' => $mode !== 'initial' ? $manifest['aliases'] : [], 'alias_sources' => $mode !== 'initial' ? $manifest['sources'] : [], 'missing_province_source' => $manifest['missing_province_source'], 'target' => (array) DB::selectOne('SELECT current_database() AS database,inet_server_port() AS port'),
|
||||
'migration' => self::MIGRATION, 'code_sha256' => $code, 'backup_verified' => $ready, 'consistent' => $consistent,
|
||||
'ready' => $ready && $consistent && $runtimeReady && count($pending) > 0, 'runtime_ready' => $runtimeReady, 'installed' => $ledger, 'files' => $files, 'new_districts' => $mode !== 'initial' ? array_merge(...array_values($manifest['new_districts'])) : ['Macate', 'Vanduzi'],
|
||||
'mfa_confirmed' => app(PortalProfileAccess::class)->mfa($actor),
|
||||
'notice' => ($runtimeReady ? '' : 'O interpretador do importador está indisponível; a execução permanece bloqueada. ').'Preservar seis advertências de Manica/2031, unidades ausentes e versões estatísticas. A instalação não corrige os originais nem concede permissões.'];
|
||||
|
||||
return [...$state, 'hash' => hash_hmac('sha256', json_encode([$actor->id, session()->getId(), $state], JSON_THROW_ON_ERROR), config('app.key'))];
|
||||
}
|
||||
|
||||
/** @param list<string> $preservedHashes
|
||||
* @return array<string,array{count:int,sha256:string}> */
|
||||
private function protectedState(array $preservedHashes = []): array
|
||||
{
|
||||
$state = [];
|
||||
foreach (['desk_cases', 'simulation_form_drafts', 'funding_programmes', 'funding_programme_versions', 'funding_programme_interests',
|
||||
'labour_demands', 'training_capacities', 'opportunities', 'investment_dossiers', 'projects', 'economic_clusters'] as $table) {
|
||||
if (Schema::hasTable($table)) {
|
||||
$rows = DB::select('SELECT row_to_json(t)::text AS row FROM "'.$table.'" t ORDER BY row_to_json(t)::text');
|
||||
$state[$table] = ['count' => count($rows), 'sha256' => hash('sha256', implode("\n", array_map(fn ($r) => $r->row, $rows)))];
|
||||
}
|
||||
}
|
||||
|
||||
if (Schema::hasTable('demographic_imports')) {
|
||||
$ids = DB::table('demographic_imports')->whereIn('sha256', $preservedHashes ?: array_column(self::FILES, 'sha256'))->pluck('id');
|
||||
foreach (['demographic_imports' => 'id', 'demographic_observations' => 'import_id', 'demographic_events' => 'import_id'] as $table => $key) {
|
||||
$digest = hash_init('sha256');
|
||||
$count = 0;
|
||||
DB::table($table)->whereIn($key, $ids)->chunkById(500, function ($rows) use ($digest, &$count) {
|
||||
foreach ($rows as $row) {
|
||||
if ($count > 0) { hash_update($digest, "\n"); }
|
||||
hash_update($digest, json_encode($row, JSON_THROW_ON_ERROR));
|
||||
$count++;
|
||||
}
|
||||
});
|
||||
$state['accepted_'.$table] = ['count' => $count, 'sha256' => hash_final($digest)];
|
||||
}
|
||||
}
|
||||
return $state;
|
||||
}
|
||||
|
||||
private function territories(User $actor): void
|
||||
{
|
||||
$province = app(InvestmentGeography::class)->publicReferences()->where('location_type', 'province')->whereRaw('lower(name)=?', ['manica'])->get(['id']);
|
||||
abort_unless($province->count() === 1, 422, 'Província de Manica ambígua ou indisponível.');
|
||||
foreach (['Macate', 'Vanduzi'] as $name) {
|
||||
$matches = DB::table('geo_locations')->where('parent_id', $province->first()->id)->where('location_type', 'district')->whereRaw('lower(trim(name))=?', [strtolower($name)])->get();
|
||||
if ($matches->isNotEmpty()) {
|
||||
abort_unless($matches->count() === 1 && $matches->first()->deleted_at === null, 409, 'Cadastro territorial divergente; não restaurar nem fundir automaticamente.');
|
||||
|
||||
continue;
|
||||
}
|
||||
$id = (string) Str::uuid();
|
||||
DB::table('geo_locations')->insert(['id' => $id, 'parent_id' => $province->first()->id, 'name' => $name, 'location_type' => 'district',
|
||||
'code' => 'INE-DEMOGRAPHY-'.strtoupper($name), 'source_system' => 'ine-demography', 'external_id' => self::MANICA_SHA256.':'.$name,
|
||||
'data_classification' => 'public', 'version_no' => 1, 'created_at' => now(), 'updated_at' => now()]);
|
||||
app(PortalProfileAccess::class)->audit($actor, 'demography_territory_created', ['territory_id' => $id, 'name' => $name,
|
||||
'source_sha256' => self::MANICA_SHA256, 'decision' => 'Autorização expressa do proprietário em 13/11/2026; destino conferido pelo instalador.',
|
||||
'scope' => 'Identificação territorial da série INE; sem limites geográficos ou direitos territoriais presumidos.']);
|
||||
}
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $manifest */
|
||||
private function remainingTerritories(User $actor, array $manifest): void
|
||||
{
|
||||
foreach ($manifest['new_districts'] as $province => $names) {
|
||||
$parents = app(InvestmentGeography::class)->publicReferences()->where('location_type', 'province')->whereRaw('lower(name)=?', [mb_strtolower($province)])->pluck('id');
|
||||
abort_unless($parents->count() === 1, 409);
|
||||
$source = array_values(array_filter($manifest['files'], fn ($f) => $f['province'] === $province))[0]['sha256'];
|
||||
foreach ($names as $name) {
|
||||
$existing = DB::table('geo_locations')->where('parent_id', $parents[0])->where('location_type', 'district')->whereRaw('lower(trim(name))=?', [mb_strtolower($name)])->get();
|
||||
if ($existing->isNotEmpty()) { abort_unless($existing->count() === 1 && $existing[0]->deleted_at === null, 409); continue; }
|
||||
$id = (string) Str::uuid();
|
||||
DB::table('geo_locations')->insert(['id' => $id, 'parent_id' => $parents[0], 'name' => $name, 'location_type' => 'district', 'code' => 'INE-DEMOGRAPHY-'.strtoupper($name), 'source_system' => 'ine-demography', 'external_id' => $source.':'.$name, 'data_classification' => 'public', 'version_no' => 1]);
|
||||
app(PortalProfileAccess::class)->audit($actor, 'demography_territory_created', ['territory_id' => $id, 'name' => $name, 'source_sha256' => $source, 'basis' => $manifest['authority']]);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input
|
||||
* @return array<string,mixed> */
|
||||
public function apply(User $actor, array $input): array
|
||||
{
|
||||
$this->authorize($actor, true);
|
||||
$data = Validator::make($input, ['hash' => 'required|string|size:64', 'operation_key' => 'required|uuid',
|
||||
'mode' => 'nullable|in:initial,remaining,zambezia', 'confirm' => 'required|accepted', 'reason' => 'required|string|min:20|max:1000'])->validate();
|
||||
$mode = $data['mode'] ?? 'initial';
|
||||
$files = $mode === 'initial' ? self::FILES : ($mode === 'zambezia' ? self::zambeziaManifest()['files'] : self::remainingManifest()['files']);
|
||||
$preservedHashes = $mode === 'zambezia' ? array_column([...self::FILES, ...self::remainingManifest()['files']], 'sha256') : array_column(self::FILES, 'sha256');
|
||||
$action = $mode === 'zambezia' ? 'extend_zambezia' : ($mode === 'remaining' ? 'extend_provinces' : 'install_and_import');
|
||||
$payload = hash('sha256', json_encode($mode === 'initial' ? [$actor->id, $data['reason']] : [$actor->id, $data['reason'], $mode, $files], JSON_THROW_ON_ERROR));
|
||||
$existing = DB::table('audit_events')->where('source_system', 'demography-installation')->where('action', $action)->where('correlation_id', $data['operation_key'])->first();
|
||||
if ($existing) {
|
||||
$event = json_decode($existing->after_data, true, 512, JSON_THROW_ON_ERROR);
|
||||
abort_unless((int) $existing->actor_user_id === $actor->id && hash_equals($event['payload_sha256'], $payload), 409);
|
||||
|
||||
return [...$event['result'], 'repeated' => true];
|
||||
}
|
||||
$plan = $this->preview($actor);
|
||||
abort_unless($plan['ready'] && $plan['mode'] === $mode && hash_equals($plan['hash'], $data['hash']), 409, 'Consulte a prévia actual; código, destino ou provas mudaram.');
|
||||
set_time_limit(300);
|
||||
|
||||
return DB::transaction(function () use ($actor, $data, $payload, $mode, $files, $action, $preservedHashes) {
|
||||
DB::select('SELECT pg_advisory_xact_lock(131126, 100000)');
|
||||
// Recheck after the lock as another request may have completed while we waited.
|
||||
$existing = DB::table('audit_events')->where('source_system', 'demography-installation')->where('action', $action)->where('correlation_id', $data['operation_key'])->first();
|
||||
if ($existing) {
|
||||
$event = json_decode($existing->after_data, true, 512, JSON_THROW_ON_ERROR);
|
||||
abort_unless((int) $existing->actor_user_id === $actor->id && hash_equals($event['payload_sha256'], $payload), 409);
|
||||
|
||||
return [...$event['result'], 'repeated' => true];
|
||||
}
|
||||
$before = $this->protectedState($preservedHashes);
|
||||
$previous = config('demography.authenticated_installation');
|
||||
config(['demography.authenticated_installation' => true]);
|
||||
try {
|
||||
if ($mode === 'initial') {
|
||||
abort_unless(Artisan::call('migrate', ['--path' => 'database/migrations/'.self::MIGRATION.'.php', '--force' => true]) === 0, 500, 'Falha ao instalar a estrutura demográfica.');
|
||||
} else { abort_unless(Schema::hasTable('demographic_observations'), 409); }
|
||||
} finally {
|
||||
config(['demography.authenticated_installation' => $previous]);
|
||||
}
|
||||
if ($mode === 'initial') { $this->territories($actor); } else { $this->remainingTerritories($actor, $mode === 'zambezia' ? self::zambeziaManifest() : self::remainingManifest()); }
|
||||
$receipts = [];
|
||||
$directory = config('demography.source_directory', 'C:/Mac/Home/Documents/TEMPO/Portal Tempo/Servicos Tempo/portal do investidor/demografia/Provincias');
|
||||
$service = app(DemographicImport::class);
|
||||
foreach ($files as $name => $expected) {
|
||||
$old = DB::table('demographic_imports')->where('sha256', $expected['sha256'])->first();
|
||||
if ($old && $old->status === 'approved') {
|
||||
$count = DB::table('demographic_observations')->where('import_id', $old->id)->count();
|
||||
abort_unless($count === $expected['records'], 409);
|
||||
$receipts[] = ['file' => $name, 'sha256' => $expected['sha256'], 'id' => $old->id, 'records' => $count, 'preserved' => true];
|
||||
continue;
|
||||
}
|
||||
$file = $directory.'/'.$name;
|
||||
abort_unless(is_file($file) && CheckedFile::matches($file, $expected['sha256']), 409, 'O exemplar aprovado mudou: '.$name);
|
||||
$plan = $service->prepare($actor, $file, $name, 'Exemplar INE fornecido pela Tempo; edição não indicada; SHA256 identifica a versão', $name === 'Dados demograficos.xlsx' ? 2017 : null);
|
||||
$receipt = $service->confirm($actor, $plan['id'], $expected['sha256'], [], $data['reason']);
|
||||
abort_unless($receipt['records'] === $expected['records'], 409, 'Contagem divergente da homologação: '.$name);
|
||||
$service->transition($actor, $plan['id'], 'approved', $data['reason']);
|
||||
$receipts[] = ['file' => $name, 'sha256' => $expected['sha256'], 'id' => $plan['id'], 'records' => $receipt['records']];
|
||||
}
|
||||
abort_unless($before === ($mode === 'initial' ? array_filter($this->protectedState($preservedHashes), fn ($key) => ! str_starts_with($key, 'accepted_'), ARRAY_FILTER_USE_KEY) : $this->protectedState($preservedHashes)), 409, 'Estado protegido alterado; instalação revertida.');
|
||||
$result = ['installed' => true, 'target' => (array) DB::selectOne('SELECT current_database() AS database,inet_server_port() AS port'),
|
||||
'imports' => $receipts, 'protected_state' => $before, 'record_count' => array_sum(array_column($receipts, 'records')), 'at' => now()->toIso8601String()];
|
||||
DB::table('audit_events')->insert(['source_system' => 'demography-installation', 'entity_type' => 'demographic_series',
|
||||
'actor_user_id' => $actor->id, 'action' => $action, 'correlation_id' => $data['operation_key'], 'data_classification' => 'restricted',
|
||||
'after_data' => json_encode(['payload_sha256' => $payload, 'reason' => $data['reason'], 'result' => $result], JSON_THROW_ON_ERROR)]);
|
||||
|
||||
return $result;
|
||||
});
|
||||
}
|
||||
}
|
||||
@@ -11,6 +11,28 @@ use Illuminate\Support\Facades\Schema;
|
||||
/** Shared read contract. It deliberately has no dependency on the installation controller/service. */
|
||||
class EconomicReferenceCatalog
|
||||
{
|
||||
/** Accepted source hierarchy for the private aggregate adapter; no catalogue publication or writes.
|
||||
* @return array{source_sha256:string,nodes:list<array{id:string,code:string,label:string,group:string,group_code:string,group_label:string}>}
|
||||
*/
|
||||
public function supplyClassification(): array
|
||||
{
|
||||
$data = json_decode(CheckedFile::read(database_path('data/proactive-supply-classification.json')), true, 512, JSON_THROW_ON_ERROR);
|
||||
abort_unless(($data['format'] ?? null) === 'accepted-source-classification-v1'
|
||||
&& ($data['source_sha256'] ?? null) === '83b4f1200988e99834c2ae3915346fbf237d128308554b67b5a080d4956bf506', 503);
|
||||
|
||||
$nodes = [];
|
||||
foreach ($data['nodes'] ?? [] as $node) {
|
||||
if (! is_array($node) || ! is_string($node['id'] ?? null) || ! is_string($node['code'] ?? null)
|
||||
|| ! is_string($node['label'] ?? null) || ! is_string($node['group'] ?? null)
|
||||
|| ! is_string($node['group_code'] ?? null) || ! is_string($node['group_label'] ?? null)) {
|
||||
abort(503, 'Referência de classificação indisponível.');
|
||||
}
|
||||
$nodes[] = ['id' => $node['id'], 'code' => $node['code'], 'label' => $node['label'], 'group' => $node['group'], 'group_code' => $node['group_code'], 'group_label' => $node['group_label']];
|
||||
}
|
||||
|
||||
return ['source_sha256' => '83b4f1200988e99834c2ae3915346fbf237d128308554b67b5a080d4956bf506', 'nodes' => $nodes];
|
||||
}
|
||||
|
||||
public const LOT = 'lot-01';
|
||||
|
||||
public const SOURCE = 'economic-reference-lot-01';
|
||||
|
||||
@@ -3,11 +3,14 @@
|
||||
namespace App\Services;
|
||||
|
||||
use Illuminate\Database\QueryException;
|
||||
use Symfony\Component\HttpKernel\Exception\HttpException;
|
||||
|
||||
/** Combines independent, already-authorised sources without loading complete catalogues. */
|
||||
final class FederatedSearch
|
||||
{
|
||||
/** @param array<string, callable(): array{count:int, fetch:callable(int,int): iterable}> $factories */
|
||||
/** @param array<string, callable(): array{count:int, fetch:callable(int,int): iterable<array<string,mixed>>}> $factories
|
||||
* @return array{data:list<array<string,mixed>>,total:int,current_page:int,last_page:int,per_page:int,unavailable:list<string>}
|
||||
*/
|
||||
public function page(array $factories, int $requestedPage, int $size = 5, ?callable $score = null): array
|
||||
{
|
||||
$sources = [];
|
||||
@@ -15,7 +18,10 @@ final class FederatedSearch
|
||||
foreach ($factories as $label => $factory) {
|
||||
try {
|
||||
$sources[$label] = $factory();
|
||||
} catch (QueryException $exception) {
|
||||
} catch (QueryException|HttpException $exception) {
|
||||
if ($exception instanceof HttpException && ! in_array($exception->getStatusCode(), [404, 503], true)) {
|
||||
throw $exception;
|
||||
}
|
||||
report($exception);
|
||||
$unavailable[] = $label;
|
||||
}
|
||||
@@ -45,7 +51,10 @@ final class FederatedSearch
|
||||
if ($batch === []) {
|
||||
$positions[$label] = $source['count'];
|
||||
}
|
||||
} catch (QueryException $exception) {
|
||||
} catch (QueryException|HttpException $exception) {
|
||||
if ($exception instanceof HttpException && ! in_array($exception->getStatusCode(), [404, 503], true)) {
|
||||
throw $exception;
|
||||
}
|
||||
report($exception);
|
||||
$unavailable[] = $label;
|
||||
unset($sources[$label]);
|
||||
|
||||
@@ -13,6 +13,29 @@ final class FundingInstitutionClassification
|
||||
|
||||
public const TYPES = ['commercial_bank' => 'Banco comercial', 'investment_bank' => 'Banco de investimento', 'bank' => 'Banco (tipo não especificado)', 'microbank' => 'Microbanco', 'cooperative' => 'Cooperativa de crédito', 'savings' => 'Organização de poupança e empréstimo', 'investment_manager' => 'Gestora de fundos de investimento', 'investment_company' => 'Sociedade de investimento', 'pension_manager' => 'Gestora de fundos de pensões', 'insurer' => 'Seguradora', 'reinsurer' => 'Resseguradora', 'microinsurer' => 'Micro-seguradora', 'broker' => 'Corretora de seguros', 'agent' => 'Agente de seguros', 'reinsurance_broker' => 'Corretor de resseguro', 'exchange_house' => 'Casa de câmbio', 'electronic_money' => 'Instituição de moeda electrónica', 'interbank' => 'Serviços interbancários', 'supervisor' => 'Supervisor', 'other' => 'Outro tipo documentado'];
|
||||
|
||||
// Category/type semantics in the supplied, accepted institutional reference.
|
||||
public const CATEGORY_TYPES = ['banking' => ['commercial_bank', 'investment_bank', 'bank'], 'credit' => ['microbank', 'cooperative', 'savings'],
|
||||
'investment' => ['investment_manager', 'investment_company'], 'pensions' => ['pension_manager', 'insurer'], 'insurance' => ['insurer', 'reinsurer', 'microinsurer', 'pension_manager'],
|
||||
'intermediation' => ['broker', 'agent', 'reinsurance_broker'], 'exchange' => ['exchange_house'], 'payments' => ['electronic_money', 'interbank'], 'supervision' => ['supervisor'], 'other' => ['other']];
|
||||
|
||||
/** Structural validity is independent of whether matching records exist.
|
||||
* @param array<string,mixed> $filters
|
||||
*/
|
||||
public function validateFilters(array $filters): void
|
||||
{
|
||||
$v = Validator::make($filters, ['category' => ['nullable', Rule::in(array_keys(self::CATEGORIES))], 'institution_type' => ['nullable', Rule::in(array_keys(self::TYPES))],
|
||||
'kind' => ['nullable', Rule::in(array_keys(FundingProgrammes::KINDS))], 'location_mode' => 'nullable|in:physical,coverage'])->validate();
|
||||
$errors = [];
|
||||
if (! empty($v['category']) && $v['category'] !== 'other' && ! empty($v['institution_type']) && $v['institution_type'] !== 'other' && ! in_array($v['institution_type'], self::CATEGORY_TYPES[$v['category']], true)) {
|
||||
$errors['institution_type'] = 'O tipo de instituição não pertence à categoria escolhida. Reveja esse critério; isto não é uma pesquisa sem resultados.';
|
||||
}
|
||||
if (! empty($v['kind']) && $v['kind'] !== 'institution') {
|
||||
if (! empty($v['category']) || ! empty($v['institution_type'])) $errors['kind'] = 'Categoria e tipo de instituição aplicam-se à consulta de instituições. Um fundo ou programa é um registo distinto.';
|
||||
if (($v['location_mode'] ?? '') === 'physical') $errors['location_mode'] = 'Sede e balcões aplicam-se a instituições. Para fundos e programas, escolha a cobertura do financiamento.';
|
||||
}
|
||||
if ($errors) throw \Illuminate\Validation\ValidationException::withMessages($errors);
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input
|
||||
* @return array<string,mixed> */
|
||||
public function normalize(array $input): array
|
||||
@@ -31,6 +54,7 @@ final class FundingInstitutionClassification
|
||||
/** @param array<string,mixed> $filters */
|
||||
public function filter(Builder $query, array $filters): void
|
||||
{
|
||||
$this->validateFilters($filters);
|
||||
foreach (['category' => 'institution_categories', 'institution_type' => 'institution_types'] as $key => $field) {
|
||||
if (! empty($filters[$key])) {
|
||||
$query->whereRaw('v.payload->? @> ?::jsonb', [$field, json_encode([$filters[$key]], JSON_THROW_ON_ERROR)]);
|
||||
|
||||
@@ -113,7 +113,7 @@ final class FundingInstitutionDetails
|
||||
public function match(array $product, array $filters): bool
|
||||
{
|
||||
$unknown = ($filters['certainty'] ?? 'include_unknown') === 'include_unknown';
|
||||
if ($product['availability'] === 'closed') {
|
||||
if ($product['availability'] === 'closed' && ($filters['state'] ?? '') !== 'closed') {
|
||||
return false;
|
||||
}
|
||||
if (! $unknown && $product['availability'] === 'unknown') {
|
||||
@@ -122,7 +122,7 @@ final class FundingInstitutionDetails
|
||||
if (! empty($filters['need']) && ! in_array($filters['need'], $product['needs'], true) && ! ($unknown && $product['needs'] === [])) {
|
||||
return false;
|
||||
}
|
||||
if (empty($filters['territory'])) {
|
||||
if (empty($filters['territory']) || ($filters['location_mode'] ?? '') === 'physical') {
|
||||
return true;
|
||||
}
|
||||
if ($product['coverage'] === 'national') {
|
||||
@@ -150,7 +150,7 @@ final class FundingInstitutionDetails
|
||||
return;
|
||||
}
|
||||
$unknown = ($filters['certainty'] ?? 'include_unknown') === 'include_unknown';
|
||||
$conditions = ["p->>'availability' <> 'closed'"];
|
||||
$conditions = [($filters['state'] ?? '') === 'closed' ? "p->>'availability' IN ('documented','closed','unknown')" : "p->>'availability' <> 'closed'"];
|
||||
$bindings = [];
|
||||
if (! $unknown) {
|
||||
$conditions[] = "p->>'availability' <> 'unknown'";
|
||||
|
||||
@@ -68,7 +68,17 @@ final class FundingProgrammes
|
||||
/** @param array<string,mixed> $filters */
|
||||
public function catalogueQuery(array $filters): Builder
|
||||
{
|
||||
Validator::make($filters, ['q' => 'nullable|string|max:150', 'state' => 'nullable|in:open,closed,upcoming,unknown', 'certainty' => 'nullable|in:include_unknown,documented',
|
||||
'sector' => ['nullable', 'integer', Rule::in(Sector::choices()->whereNotNull('published_at')->pluck('id')->all())], 'need' => ['nullable', Rule::in(array_keys(FundingInstitutionDetails::NEEDS))], 'include_historical' => 'nullable|boolean'])->validate();
|
||||
$filters = app(InvestmentGeography::class)->interestSelection($filters);
|
||||
$query = $this->publicQuery();
|
||||
if (! empty($filters['q'])) {
|
||||
$term = '%'.str_replace(['\\', '%', '_'], ['\\\\', '\\%', '\\_'], $filters['q']).'%';
|
||||
$query->where(fn ($q) => $q->whereRaw("v.payload->>'title' ilike ?", [$term])->orWhereRaw("v.payload->>'summary' ilike ?", [$term])->orWhereRaw("(v.payload->'aliases')::text ilike ?", [$term])->orWhereRaw("EXISTS (SELECT 1 FROM jsonb_array_elements(COALESCE(v.payload->'locations','[]'::jsonb)) l WHERE l->>'label' ilike ? OR l->>'address' ilike ? OR l->>'location_text' ilike ?)", [$term, $term, $term]));
|
||||
}
|
||||
if (! empty($filters['kind'])) {
|
||||
$query->whereRaw("v.payload->>'kind' = ?", [$filters['kind']]);
|
||||
}
|
||||
app(FundingInstitutionDetails::class)->applyFilters($query, $filters);
|
||||
$includeUnknown = ($filters['certainty'] ?? 'include_unknown') === 'include_unknown';
|
||||
if (! empty($filters['sector'])) {
|
||||
@@ -94,22 +104,43 @@ final class FundingProgrammes
|
||||
});
|
||||
}
|
||||
if (! empty($filters['state'])) {
|
||||
$today = today()->toDateString();
|
||||
$state = $filters['state'];
|
||||
if ($state === 'unknown') {
|
||||
$query->whereRaw("(jsonb_array_length(v.payload->'windows') = 0 OR EXISTS (SELECT 1 FROM jsonb_array_elements(v.payload->'windows') w WHERE w->>'mode' = 'unknown'))");
|
||||
} elseif ($state === 'closed') {
|
||||
$query->whereRaw("EXISTS (SELECT 1 FROM jsonb_array_elements(v.payload->'windows') w WHERE w->>'mode' = 'closed' OR (w->>'mode' = 'dated' AND w->>'end_on' < ?))", [$today]);
|
||||
} elseif ($state === 'upcoming') {
|
||||
$query->whereRaw("EXISTS (SELECT 1 FROM jsonb_array_elements(v.payload->'windows') w WHERE w->>'mode' = 'dated' AND w->>'start_on' > ?)", [$today]);
|
||||
} else {
|
||||
$query->whereRaw("EXISTS (SELECT 1 FROM jsonb_array_elements(v.payload->'windows') w WHERE w->>'mode' IN ('dated','rolling') AND COALESCE(NULLIF(w->>'start_on',''),?) <= ? AND COALESCE(NULLIF(w->>'end_on',''),?) >= ?)", [$today, $today, $today, $today]);
|
||||
}
|
||||
[$windowSql, $windowBindings] = $this->windowFilter($filters);
|
||||
$query->whereRaw("EXISTS (SELECT 1 FROM jsonb_array_elements(COALESCE(v.payload->'windows','[]'::jsonb)) w WHERE ".$windowSql.')', $windowBindings);
|
||||
}
|
||||
|
||||
return $query;
|
||||
}
|
||||
|
||||
/** Window dates and geographical scope concern the same documented window.
|
||||
* @param array<string,mixed> $filters
|
||||
* @return array{literal-string,list<mixed>}
|
||||
*/
|
||||
private function windowFilter(array $filters): array
|
||||
{
|
||||
$today = today()->toDateString();
|
||||
$state = $filters['state'];
|
||||
$bindings = [];
|
||||
if ($state === 'unknown') $sql = "w->>'mode' = 'unknown'";
|
||||
elseif ($state === 'closed') { $sql = "(w->>'mode' = 'closed' OR (w->>'mode' = 'dated' AND w->>'end_on' < ?))"; $bindings = [$today]; }
|
||||
elseif ($state === 'upcoming') { $sql = "w->>'mode' = 'dated' AND w->>'start_on' > ?"; $bindings = [$today]; }
|
||||
else { $sql = "w->>'mode' IN ('dated','rolling') AND COALESCE(NULLIF(w->>'start_on',''),?) <= ? AND COALESCE(NULLIF(w->>'end_on',''),?) >= ?"; $bindings = [$today, $today, $today, $today]; }
|
||||
if (! empty($filters['territory']) && ($filters['location_mode'] ?? '') !== 'physical') {
|
||||
$path = array_column(app(InvestmentGeography::class)->path($filters['territory']), 'id');
|
||||
$window = ["EXISTS (SELECT 1 FROM jsonb_array_elements(COALESCE(w->'territory_paths','[]'::jsonb)) t WHERE t @> ?::jsonb)"];
|
||||
$scopeBindings = [json_encode([['id' => $filters['territory']]], JSON_THROW_ON_ERROR)];
|
||||
foreach ($path as $id) { $window[] = "w->'territory_ids' @> ?::jsonb"; $scopeBindings[] = json_encode([$id], JSON_THROW_ON_ERROR); }
|
||||
$parent = ["v.payload->>'coverage'='national'", "v.payload->'territory_ancestor_ids' @> ?::jsonb"];
|
||||
$scopeBindings[] = json_encode([$filters['territory']], JSON_THROW_ON_ERROR);
|
||||
foreach ($path as $id) { $parent[] = "v.payload->'territory_ids' @> ?::jsonb"; $scopeBindings[] = json_encode([$id], JSON_THROW_ON_ERROR); }
|
||||
if (($filters['certainty'] ?? 'include_unknown') === 'include_unknown') $parent[] = "v.payload->>'coverage'='unknown'";
|
||||
$scope = "(w->>'coverage'='national' OR (w->>'coverage'='territorial' AND (".implode(' OR ', $window).")) OR (w->>'coverage'='programme' AND (".implode(' OR ', $parent).')))';
|
||||
if (($filters['certainty'] ?? 'include_unknown') === 'include_unknown') $scope = '('.$scope." OR w->>'coverage'='unknown')";
|
||||
$sql = '('.$sql.') AND '.$scope;
|
||||
$bindings = [...$bindings, ...$scopeBindings];
|
||||
}
|
||||
return [$sql, $bindings];
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $record
|
||||
* @param array<string,mixed> $filters
|
||||
* @return array<string,string> */
|
||||
|
||||
@@ -21,7 +21,7 @@ class InvestmentCatalogue
|
||||
'projects' => ['project_id', 'projects'], 'locations' => ['geo_location_id', 'geo_locations']];
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function filters(Request $request): array
|
||||
public function filters(Request $request, bool $offerPrices = false): array
|
||||
{
|
||||
$filters = $request->validate(['perspective' => ['nullable', 'in:exists,needs,ideas,opportunities'], 'q' => ['nullable', 'string', 'max:120'], 'sector' => ['nullable', 'string', 'max:80'],
|
||||
'preparation' => ['nullable', Rule::in(array_column(OpportunityMaturity::searchOptions(), 'value'))],
|
||||
@@ -34,9 +34,9 @@ class InvestmentCatalogue
|
||||
'zee_id' => ['nullable', 'uuid'], 'zfi_id' => ['nullable', 'uuid'], 'park_id' => ['nullable', 'uuid'],
|
||||
'dimension' => ['nullable', 'in:cluster,corridor,zee,zfi'], 'view' => ['nullable', 'in:grid,list,map,combined,corridors'],
|
||||
'maturity_level' => ['nullable', 'integer', 'between:1,8'], 'facets' => ['nullable', 'array', 'max:20'], 'facets.*' => ['integer', 'min:1'],
|
||||
'min_amount' => ['nullable', 'numeric', 'min:0', 'max:999999999999'],
|
||||
'max_amount' => ['nullable', 'numeric', 'min:0', 'max:999999999999', ...($request->filled('min_amount') ? ['gte:min_amount'] : [])],
|
||||
'currency' => ['nullable', 'required_with:min_amount,max_amount', 'in:MZN,USD,EUR,ZAR'],
|
||||
'min_amount' => $offerPrices ? ['nullable', 'string', 'regex:/^\d{1,16}(\.\d{1,2})?$/'] : ['nullable', 'numeric', 'min:0', 'max:999999999999'],
|
||||
'max_amount' => $offerPrices ? ['nullable', 'string', 'regex:/^\d{1,16}(\.\d{1,2})?$/'] : ['nullable', 'numeric', 'min:0', 'max:999999999999', ...($request->filled('min_amount') ? ['gte:min_amount'] : [])],
|
||||
'currency' => ['nullable', 'required_with:min_amount,max_amount', $offerPrices ? 'in:MZN,USD' : 'in:MZN,USD,EUR,ZAR'],
|
||||
'before' => ['nullable', 'date_format:Y-m-d'], 'sort' => ['nullable', 'in:recent,title,amount_asc,amount_desc'],
|
||||
'association_type' => ['nullable', 'in:'.implode(',', array_keys(OpportunityClassification::TARGETS))],
|
||||
'association_target' => ['nullable', 'string', 'max:80'],
|
||||
|
||||
@@ -66,11 +66,16 @@ final class InvestmentCorridorContext
|
||||
*/
|
||||
public function parks(?string $key, ?string $territory): array
|
||||
{
|
||||
if (! $key || ! $territory) {
|
||||
if (! $territory) {
|
||||
return [];
|
||||
}
|
||||
abort_unless($this->compatible($key, $territory), 422, 'A localização não pertence ao corredor escolhido.');
|
||||
if ($key) {
|
||||
abort_unless($this->compatible($key, $territory), 422, 'A localização não pertence ao corredor escolhido.');
|
||||
}
|
||||
$selectedPath = array_column(app(InvestmentGeography::class)->path($territory), 'id');
|
||||
if ($selectedPath === []) {
|
||||
return [];
|
||||
}
|
||||
$candidates = app(InvestmentZones::class)->visible()->whereIn('category', ['industrial_park', 'zee', 'zfi'])->orderBy('name')->get();
|
||||
$result = [];
|
||||
foreach ($candidates as $zone) {
|
||||
@@ -83,7 +88,7 @@ final class InvestmentCorridorContext
|
||||
}
|
||||
foreach ($ids as $link) {
|
||||
$id = $link->geo_location_id;
|
||||
if (! $this->compatible($key, $id)) {
|
||||
if ($key && ! $this->compatible($key, $id)) {
|
||||
continue;
|
||||
}
|
||||
$path = array_column(app(InvestmentGeography::class)->path($id), 'id');
|
||||
|
||||
@@ -138,6 +138,10 @@ final class InvestmentGeography
|
||||
$query->where(function ($workbook) {
|
||||
$workbook->where('source_system', 'cartografia-workbook')
|
||||
->where('external_id', 'like', '964a187ad32ea553b9e112cd159caa90b900050c42b7329594a75bcd798a96ff:%');
|
||||
})->orWhere(function ($demography) {
|
||||
// Owner, 13/11/2026: only these source-backed additions are authorised.
|
||||
$demography->where('source_system', 'ine-demography')->where('location_type', 'district')
|
||||
->whereIn('external_id', DemographicInstallation::publicDistrictRefs());
|
||||
})->orWhereIn('id', app(TerritorialRegistry::class)->published()->select('g.id'));
|
||||
});
|
||||
}
|
||||
@@ -241,6 +245,30 @@ final class InvestmentGeography
|
||||
return $path;
|
||||
}
|
||||
|
||||
/** Canonical selection for a place-of-interest filter, including legacy links.
|
||||
* @param array<string,mixed> $filters
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function interestSelection(array $filters): array
|
||||
{
|
||||
$location = \Illuminate\Support\Facades\Validator::make($filters, ['territory' => 'nullable|uuid', 'province_id' => 'nullable|uuid', 'district_id' => 'nullable|uuid', 'admin_post_id' => 'nullable|uuid', 'locality_id' => 'nullable|uuid'])->validate();
|
||||
if (array_intersect(array_keys(self::FIELDS), array_keys($location))) {
|
||||
$path = $this->selection($location);
|
||||
$territory = $path ? $path[array_key_last($path)]->id : null;
|
||||
if (! empty($location['territory']) && $location['territory'] !== $territory) {
|
||||
throw ValidationException::withMessages(['territory' => 'O local de interesse não corresponde à hierarquia seleccionada.']);
|
||||
}
|
||||
if ($territory) $filters['territory'] = $territory;
|
||||
else unset($filters['territory']);
|
||||
}
|
||||
if (! empty($filters['territory'])) {
|
||||
$path = $this->path($filters['territory']);
|
||||
if (! $path) throw ValidationException::withMessages(['territory' => 'Seleccione um local disponível no cadastro.']);
|
||||
foreach ($path as $node) $filters[$node->location_type.'_id'] = $node->id;
|
||||
}
|
||||
return $filters;
|
||||
}
|
||||
|
||||
/** @return list<string> */
|
||||
public function descendants(string $id, bool $includeNonPublic = false): array
|
||||
{
|
||||
|
||||
@@ -58,6 +58,7 @@ final class InvestmentMapIndicators
|
||||
'zone_id' => $zone->id, 'zone_name' => $zone->name, 'zone_version' => (int) $zone->version_no, 'url' => '/zonas/'.$zone->id,
|
||||
'theme' => $row['indicator'] === 'employment' ? 'workforce' : 'economic_potential',
|
||||
'value' => $value, 'knowledge' => $knowledge, 'missing_metadata' => $missing,
|
||||
'measure_kind' => in_array($row['measure_kind'] ?? null, ['observed', 'planned', 'projected'], true) ? $row['measure_kind'] : 'unknown',
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
@@ -74,7 +74,7 @@ final class InvestmentOpportunityChoices
|
||||
$old = collect($previous)->first(fn ($row) => $row['opportunity']['key'] === $ref['key']);
|
||||
$origins = $this->portfolioOrigins($choice['portfolio_origins'] ?? array_column($old['portfolio_origins'] ?? [], 'id'), (int) $record->id);
|
||||
$corridors = app(InvestmentCorridorContext::class);
|
||||
$corridor = $choice['corridor_key'] ?? $old['corridor_key'] ?? $corridors->key($record);
|
||||
$corridor = array_key_exists('corridor_key', $choice) ? $choice['corridor_key'] : ($old['corridor_key'] ?? $corridors->key($record));
|
||||
$provinces = $corridor ? $corridors->provinces($corridor) : [];
|
||||
$documented = $record->primary_territory_id;
|
||||
$territory = array_key_exists('territory', $choice) ? $choice['territory'] : ($documented ? 'territory:'.$documented : null);
|
||||
|
||||
@@ -127,6 +127,11 @@ final class InvestmentPreparationWorkspace
|
||||
{
|
||||
$objects = [['key' => 'investment:'.$case->id, 'label' => $case->title, 'kind' => 'investment']];
|
||||
$evidence = [];
|
||||
$demography = app(DemographicEvidence::class)->forContext($context);
|
||||
if ($demography['state'] === 'available') {
|
||||
$evidence['demography'] = ['key' => 'demography', 'label' => 'Contexto demográfico INE', 'current' => $demography,
|
||||
'notice' => 'Evidência para análise SWOT; não produz conclusões automáticas. Consulte ano, edição e limitações.'];
|
||||
}
|
||||
foreach ($context['sector_references'] ?? [] as $reference) {
|
||||
$current = hash_equals((SectorResourceReferences::SOURCES[$reference['sector_slug']] ?? ''), $reference['source_sha256'] ?? '') ? $reference : ['unavailable' => true, 'source_sha256' => (SectorResourceReferences::SOURCES[$reference['sector_slug']] ?? '')];
|
||||
$evidence['sector-resource:'.$reference['key']] = ['key' => 'sector-resource:'.$reference['key'], 'label' => $reference['title'], 'consulted' => $reference, 'current' => $current, 'notice' => 'Referência sectorial e de cadeia de valor; não certifica direitos, licenças nem disponibilidade de projecto.'];
|
||||
@@ -275,6 +280,24 @@ final class InvestmentPreparationWorkspace
|
||||
return collect($this->rows($this->current($id, $scope)['swot']['actions']))->firstWhere('id', $actionId);
|
||||
}
|
||||
|
||||
/** Reuses the authorised workspace and its preserved exports; never creates an export or a review.
|
||||
* @return array<string,mixed> */
|
||||
public function reportSummary(User $actor, string $id, ?string $opportunity): array
|
||||
{
|
||||
$view = $this->view($actor, $id, $opportunity);
|
||||
$query = $view['opportunity'] ? '?opportunity='.urlencode($view['opportunity']) : '';
|
||||
$base = '/investimentos/'.$id.'/preparacao';
|
||||
|
||||
return ['case_id' => $id, 'opportunity' => $view['opportunity'], 'version' => $view['version'],
|
||||
'context_revision' => $view['context']['revision'], 'href' => $base.$query, 'api_state' => $view['api_state'],
|
||||
'api_issues' => $view['api_issues'], 'external' => $view['apiex']['external'],
|
||||
'exports' => array_map(fn ($export) => ['id' => $export['id'], 'at' => $export['at'],
|
||||
'context_revision' => $export['context_revision'], 'fingerprint' => $export['fingerprint'],
|
||||
'historical' => $export['fingerprint'] !== $view['api_fingerprint'],
|
||||
'href' => $base.'/exportar/'.$export['id'].$query], $this->rows($view['apiex']['exports'])),
|
||||
'swot' => $view['swot'], 'swot_review_required' => $view['swot_review_required']];
|
||||
}
|
||||
|
||||
/** @return list<string> */
|
||||
public function taskKeys(User $actor, string $id, string $opportunity): array
|
||||
{
|
||||
|
||||
@@ -18,7 +18,7 @@ class InvestmentZoneIntegralDetails
|
||||
'phases' => ['code', 'status', 'starts_at', 'ends_at', 'expansion'],
|
||||
'plots' => ['code', 'phase_id', 'area', 'area_unit', 'status', 'geometry_id'],
|
||||
'occupants' => ['organization_id', 'documentary_name', 'phase_id', 'plot_id', 'status', 'valid_from', 'valid_until'],
|
||||
'observations' => ['indicator', 'value', 'unit', 'period_start', 'period_end', 'population', 'methodology', 'phase_id', 'plot_id'],
|
||||
'observations' => ['indicator', 'measure_kind', 'value', 'unit', 'period_start', 'period_end', 'population', 'methodology', 'phase_id', 'plot_id'],
|
||||
'chains' => ['kind', 'organization_id', 'documentary_name', 'zone_link_id', 'phase_id', 'plot_id'],
|
||||
];
|
||||
|
||||
@@ -59,6 +59,7 @@ class InvestmentZoneIntegralDetails
|
||||
$rules['titles.*.kind'] = 'nullable|in:creation,land_use,licence,special_regime,other';
|
||||
$rules['chains.*.kind'] = 'nullable|in:anchor,supplier,unmet_need,other';
|
||||
$rules['observations.*.indicator'] = 'required|in:employment,investment,production,exports,local_procurement,resource_use,waste,emissions,other';
|
||||
$rules['observations.*.measure_kind'] = 'nullable|in:unknown,observed,planned,projected';
|
||||
$data = Validator::make($input, $rules)->validate();
|
||||
$result = $before;
|
||||
foreach (self::GROUPS as $group) {
|
||||
@@ -148,7 +149,7 @@ class InvestmentZoneIntegralDetails
|
||||
foreach ($result['observations'] as $item) {
|
||||
if (! isset($item['period_start'],$item['period_end'])) {
|
||||
continue;
|
||||
}$key = implode('|', [$item['indicator'], $item['period_start'], $item['period_end'], $item['scope'] ?? '', $item['population'] ?? '', $item['unit'] ?? '', $item['methodology'] ?? '', $item['source_reference'] ?? '', $item['source_date'] ?? '', $item['phase_id'] ?? '', $item['plot_id'] ?? '']);
|
||||
}$key = implode('|', [$item['indicator'], $item['measure_kind'] ?? 'unknown', $item['period_start'], $item['period_end'], $item['scope'] ?? '', $item['population'] ?? '', $item['unit'] ?? '', $item['methodology'] ?? '', $item['source_reference'] ?? '', $item['source_date'] ?? '', $item['phase_id'] ?? '', $item['plot_id'] ?? '']);
|
||||
abort_if(in_array($key, $keys, true), 422, 'A mesma observação/fonte já está registada; altere o detalhe existente para criar a sua nova revisão.');
|
||||
$keys[] = $key;
|
||||
}
|
||||
|
||||
@@ -3,11 +3,14 @@
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\InvestmentZone;
|
||||
use App\Models\User;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\Crypt;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Illuminate\Support\Str;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
use Symfony\Component\HttpKernel\Exception\HttpException;
|
||||
|
||||
/** Editorial preparation in the existing master. No operational/land entitlement is inferred. */
|
||||
class InvestmentZoneOperationalProfile
|
||||
@@ -16,7 +19,7 @@ class InvestmentZoneOperationalProfile
|
||||
|
||||
public const FIELDS = ['code', 'category', 'name', 'name_en', 'description', 'description_en', 'province', 'district', 'operator_id', 'legal_source_id',
|
||||
'physical_category', 'legal_regime', 'operational_status', 'development_status', 'availability_status', 'area_components', 'source_evidence',
|
||||
'area_value', 'area_unit', 'aliases', 'activities', 'resources', 'data_as_of', 'sources_consulted_at', 'parent_zone_id', 'historical_territory'];
|
||||
'area_value', 'area_unit', 'aliases', 'activities', 'resources', 'data_as_of', 'sources_consulted_at', 'parent_zone_id', 'historical_territory', 'primary_territory_id', 'territory_version'];
|
||||
|
||||
public const DETAIL_PUBLIC = ['id', 'name', 'status', 'source_reference', 'source_date', 'kind', 'scope', 'capacity_type', 'capacity_value', 'capacity_unit', 'focus', 'economic_activity_id'];
|
||||
|
||||
@@ -25,6 +28,159 @@ class InvestmentZoneOperationalProfile
|
||||
return Schema::hasColumn('investment_zones', 'editorial_draft');
|
||||
}
|
||||
|
||||
public function editorialEnabled(): bool
|
||||
{
|
||||
return (bool) config('editorial_workflow.zone_review') && $this->installed();
|
||||
}
|
||||
|
||||
public function ensureWriteMode(InvestmentZone $zone): void
|
||||
{
|
||||
if (config('editorial_workflow.zone_review')) {
|
||||
abort_unless($this->editorialEnabled(), 503, 'A preparação privada das zonas ainda não está instalada.');
|
||||
} elseif ($zone->exists) {
|
||||
abort_if(DB::table('audit_events')->where('source_system', 'investment-zones')->where('entity_id', $zone->id)->where('after_data->editorial_workflow', true)->exists(), 503, 'Reactive a revisão das zonas para preservar o histórico.');
|
||||
}
|
||||
}
|
||||
|
||||
public function reviewAccess(User $actor): bool
|
||||
{
|
||||
$access = app(PortalProfileAccess::class);
|
||||
|
||||
return $actor->hasVerifiedEmail() && $actor->two_factor_confirmed_at && $actor->two_factor_secret && ! $access->has($actor, 'auditor')
|
||||
&& ($actor->can('manage-portal') || $access->superuser($actor) || $access->legacyWriteAllowed($actor));
|
||||
}
|
||||
|
||||
private function reviewActor(User $actor): void
|
||||
{
|
||||
abort_unless($this->reviewAccess($actor) && app(PortalProfileAccess::class)->mfa($actor), 403, 'Âmbito administrativo e MFA válido necessários.');
|
||||
}
|
||||
|
||||
public function authorizeWrite(int $actor): void
|
||||
{
|
||||
$this->reviewActor(User::findOrFail($actor));
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed> $draft */
|
||||
private function reviewHash(InvestmentZone $zone, array $draft): string
|
||||
{
|
||||
$context = ['public_fields' => Arr::only($zone->getRawOriginal(), [...self::FIELDS, 'primary_territory_id', 'territory_version', 'operational_details']), 'locations' => [], 'documents' => []];
|
||||
foreach (['legal_source_id' => 'investment_legal_sources', 'operator_id' => 'organizations', 'primary_territory_id' => 'geo_locations'] as $field => $table) {
|
||||
$id = $draft['fields'][$field] ?? $zone->getAttribute($field);
|
||||
if ($id) {
|
||||
$row = DB::table($table)->where('id', $id)->first();
|
||||
abort_unless($row !== null, 422, 'Fonte ou contexto da zona indisponível.');
|
||||
$context[$field] = Arr::except(get_object_vars($row), ['created_at', 'updated_at']);
|
||||
}
|
||||
}
|
||||
$context['locations'] = DB::table('investment_zone_locations')->where('zone_id', $zone->id)->orderBy('id')->get()->map(fn ($row) => Arr::except(get_object_vars($row), ['created_at', 'updated_at']))->all();
|
||||
$geography = [];
|
||||
$locations = array_filter([$draft['fields']['primary_territory_id'] ?? $zone->getAttribute('primary_territory_id'), ...array_column($context['locations'], 'geo_location_id')]);
|
||||
foreach (array_unique($locations) as $location) {
|
||||
$seen = [];
|
||||
while ($location) {
|
||||
abort_if(in_array($location, $seen, true) || count($seen) >= 5, 422, 'Hierarquia territorial incoerente.');
|
||||
$seen[] = $location;
|
||||
$node = DB::table('geo_locations')->where('id', $location)->whereNull('deleted_at')->first();
|
||||
abort_unless($node !== null, 422, 'Contexto territorial indisponível.');
|
||||
$geography[$node->id] = Arr::only(get_object_vars($node), ['id', 'name', 'parent_id', 'location_type', 'version_no', 'data_classification', 'source_system', 'source_code']);
|
||||
$location = $node->parent_id;
|
||||
}
|
||||
}
|
||||
ksort($geography);
|
||||
$context['geography'] = $geography;
|
||||
foreach (DB::table('investment_zone_attachments')->where('zone_id', $zone->id)->orderBy('id')->get() as $attachment) {
|
||||
$document = DB::table('documents')->where('id', $attachment->document_id)->first();
|
||||
abort_unless($document !== null, 422, 'Anexo indisponível.');
|
||||
if ($document->status === 'active' && $document->malware_scan_status === 'clean' && $document->deleted_at === null) {
|
||||
app(VerifiedDocumentBinary::class)->respond($document);
|
||||
}
|
||||
$context['documents'][] = ['attachment' => Arr::except(get_object_vars($attachment), ['created_at', 'updated_at']), 'document' => Arr::only(get_object_vars($document), ['id', 'sha256', 'version_no', 'status', 'deleted_at', 'rights_status', 'malware_scan_status', 'malware_scanned_sha256'])];
|
||||
}
|
||||
|
||||
return hash('sha256', json_encode(Arr::sortRecursive(['fields' => $draft['fields'], 'context' => $context, 'contributors' => $draft['editorial']['contributors'] ?? []]), JSON_THROW_ON_ERROR));
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed> $draft */
|
||||
private function freshReview(InvestmentZone $zone, array $draft): bool
|
||||
{
|
||||
try {
|
||||
return (int) $draft['base_public_version'] === (int) $zone->version_no && hash_equals($draft['editorial']['hash'], $this->reviewHash($zone, $draft));
|
||||
} catch (HttpException $exception) {
|
||||
if (in_array($exception->getStatusCode(), [404, 409, 422], true)) {
|
||||
return false;
|
||||
}
|
||||
throw $exception;
|
||||
}
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed> $workflow */
|
||||
private function independent(array $workflow): bool
|
||||
{
|
||||
return ($workflow['independent_required'] ?? false) || in_array('zone_statistics', config('editorial_workflow.independent_approval.kinds', []), true);
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed> $draft
|
||||
* @param array<array-key,mixed>|null $previous
|
||||
* @return array<array-key,mixed>
|
||||
*/
|
||||
private function newReview(InvestmentZone $zone, array $draft, int $actor, ?array $previous): array
|
||||
{
|
||||
$draft['editorial'] = ['state' => 'draft', 'content_version' => $draft['working_version'], 'contributors' => array_values(array_unique([...($previous['editorial']['contributors'] ?? []), $actor])),
|
||||
'independent_required' => ($previous['editorial']['independent_required'] ?? false) || in_array('zone_statistics', config('editorial_workflow.independent_approval.kinds', []), true), 'approval' => null];
|
||||
$draft['editorial']['hash'] = $this->reviewHash($zone, $draft);
|
||||
|
||||
return $draft;
|
||||
}
|
||||
|
||||
/** @return array<array-key,mixed> */
|
||||
public function review(string $id, User $actor, int $expected, string $action, string $reason): array
|
||||
{
|
||||
$this->reviewActor($actor);
|
||||
validator(['reason' => $reason], ['reason' => 'required|string|min:10|max:3000'])->validate();
|
||||
abort_unless($this->editorialEnabled(), 503);
|
||||
|
||||
return DB::transaction(function () use ($id, $actor, $expected, $action, $reason) {
|
||||
$zone = InvestmentZone::whereKey($id)->lockForUpdate()->firstOrFail();
|
||||
$draft = $this->draft($zone);
|
||||
abort_unless($expected === $this->workingVersion($zone), 409, 'A preparação mudou. Conserve os campos e confira a versão actual.');
|
||||
if (! $draft || ! isset($draft['editorial'])) {
|
||||
abort_unless($action === 'submit', 409, 'Prepare a revisão antes de decidir.');
|
||||
$zone = $this->prepare($zone, ['version_no' => $expected], $actor->id);
|
||||
$draft = $this->draft($zone);
|
||||
}
|
||||
abort_unless($draft !== null && isset($draft['editorial']), 409);
|
||||
$workflow = $draft['editorial'];
|
||||
$allowed = ['submit' => ['draft', 'returned'], 'start_review' => ['submitted'], 'approve' => ['in_review'], 'return' => ['in_review'], 'reject' => ['in_review'], 'archive' => ['draft', 'submitted', 'in_review', 'approved', 'returned', 'rejected']];
|
||||
abort_unless(isset($allowed[$action]) && in_array($workflow['state'], $allowed[$action], true), 409);
|
||||
if (in_array($action, ['submit', 'approve'], true)) {
|
||||
abort_unless($this->freshReview($zone, $draft), 409, 'Conteúdo, fonte ou anexos alterados. Guarde nova edição e volte a conferir.');
|
||||
}
|
||||
if ($action === 'approve') {
|
||||
abort_if($this->independent($workflow) && in_array($actor->id, $workflow['contributors'], true), 403, 'Esta edição exige aprovação independente.');
|
||||
$workflow['approval'] = ['actor_id' => $actor->id, 'content_version' => $workflow['content_version'], 'hash' => $workflow['hash'], 'reason' => $reason, 'at' => now()->toISOString()];
|
||||
}
|
||||
$workflow['state'] = ['submit' => 'submitted', 'start_review' => 'in_review', 'approve' => 'approved', 'return' => 'returned', 'reject' => 'rejected', 'archive' => 'archived'][$action];
|
||||
$draft['editorial'] = $workflow;
|
||||
$draft['working_version'] = $this->nextVersion($zone);
|
||||
DB::table('investment_zones')->where('id', $id)->update(['editorial_draft' => Crypt::encryptString(json_encode($draft, JSON_THROW_ON_ERROR))]);
|
||||
$this->snapshot($zone, $draft['working_version'], $actor->id, 'zone_editorial_'.$action, ['draft' => $draft, 'reason' => $reason]);
|
||||
|
||||
return $this->management($zone->fresh());
|
||||
});
|
||||
}
|
||||
|
||||
public function suspensionPreservesReview(InvestmentZone $zone, int $actor): void
|
||||
{
|
||||
$draft = $this->draft($zone);
|
||||
if (! $this->editorialEnabled() || ! $draft) {
|
||||
return;
|
||||
}
|
||||
$draft['base_public_version'] = (int) $zone->version_no;
|
||||
$draft['working_version'] = $this->nextVersion($zone);
|
||||
DB::table('investment_zones')->where('id', $zone->id)->update(['editorial_draft' => Crypt::encryptString(json_encode($draft, JSON_THROW_ON_ERROR))]);
|
||||
$this->snapshot($zone, $draft['working_version'], $actor, 'zone_editorial_suspension_rebased', ['draft' => $draft]);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<array-key, mixed>|null
|
||||
*/
|
||||
@@ -60,8 +216,15 @@ class InvestmentZoneOperationalProfile
|
||||
public function management(InvestmentZone $zone): array
|
||||
{
|
||||
$draft = $this->draft($zone);
|
||||
$workflow = $draft['editorial'] ?? null;
|
||||
if ($workflow && $draft) {
|
||||
$workflow['fresh'] = $this->freshReview($zone, $draft);
|
||||
$workflow['independent_required'] = $this->independent($workflow);
|
||||
$viewer = auth()->user();
|
||||
$workflow['can_approve'] = ! $workflow['independent_required'] || ($viewer instanceof User && ! in_array($viewer->id, $workflow['contributors'], true));
|
||||
}
|
||||
|
||||
return [...$zone->toArray(), ...($draft['fields'] ?? []), 'version_no' => $draft['working_version'] ?? $zone->version_no,
|
||||
return [...$zone->toArray(), ...($draft['fields'] ?? []), 'version_no' => $draft['working_version'] ?? $zone->version_no, 'editorial_enabled' => $this->editorialEnabled(), 'editorial_workflow' => $workflow,
|
||||
'public_version_no' => $zone->version_no, 'base_public_version' => $draft['base_public_version'] ?? $zone->version_no,
|
||||
'has_private_draft' => $draft !== null, 'profile_available' => $this->installed(),
|
||||
'operational_details' => ($draft['fields']['operational_details'] ?? app(InvestmentZoneOperationalDetails::class)->recover($zone)),
|
||||
@@ -118,6 +281,10 @@ class InvestmentZoneOperationalProfile
|
||||
*/
|
||||
public function prepare(InvestmentZone $zone, array $data, int $actor): InvestmentZone
|
||||
{
|
||||
$this->ensureWriteMode($zone);
|
||||
if ($this->editorialEnabled()) {
|
||||
$this->reviewActor(User::findOrFail($actor));
|
||||
}
|
||||
abort_unless($this->installed(), 503, 'A preparação privada requer a instalação nominal da ficha de parques. A publicação anterior foi preservada.');
|
||||
abort_unless((int) $data['version_no'] === $this->workingVersion($zone), 409, 'A preparação mudou; recupere a versão atual antes de guardar.');
|
||||
$previous = $this->draft($zone);
|
||||
@@ -142,19 +309,38 @@ class InvestmentZoneOperationalProfile
|
||||
}
|
||||
$draft = ['schema_version' => 1, 'base_public_version' => $previous['base_public_version'] ?? (int) $zone->version_no,
|
||||
'working_version' => $this->nextVersion($zone), 'fields' => $fields, 'actor_id' => $actor, 'prepared_at' => now()->toIso8601String()];
|
||||
if ($this->editorialEnabled()) {
|
||||
$draft = $this->newReview($zone, $draft, $actor, $previous);
|
||||
}
|
||||
DB::table('investment_zones')->where('id', $zone->id)->update(['editorial_draft' => Crypt::encryptString(json_encode($draft, JSON_THROW_ON_ERROR))]);
|
||||
$this->snapshot($zone, $draft['working_version'], $actor, 'profile_prepared', ['public' => [...$zone->toArray(), 'operational_details' => $details->stored($zone)], 'draft' => $draft]);
|
||||
|
||||
return $zone->fresh();
|
||||
}
|
||||
|
||||
/** Apply only inside the publication transaction; a failed validation rolls everything back. */
|
||||
public function promote(InvestmentZone $zone, int $version): void
|
||||
/** Apply only inside the publication transaction; a failed validation rolls everything back.
|
||||
* @return array<array-key,mixed>|null
|
||||
*/
|
||||
public function promote(InvestmentZone $zone, int $version, ?int $actor = null): ?array
|
||||
{
|
||||
$draft = $this->draft($zone);
|
||||
abort_unless($version === $this->workingVersion($zone), 409, 'A preparação mudou; recupere a versão atual antes de publicar.');
|
||||
if (! $draft) {
|
||||
return;
|
||||
abort_if($this->editorialEnabled(), 409, 'Prepare e aprove a revisão antes de publicar.');
|
||||
|
||||
return null;
|
||||
}
|
||||
if ($this->editorialEnabled()) {
|
||||
$this->lockReviewContext($zone, $draft);
|
||||
$publisher = User::where('id', $actor)->firstOrFail();
|
||||
$this->reviewActor($publisher);
|
||||
$review = $draft['editorial'] ?? null;
|
||||
abort_unless($review && $review['state'] === 'approved' && $this->freshReview($zone, $draft), 409, 'Aprovação desta edição necessária.');
|
||||
$approval = $review['approval'];
|
||||
abort_unless($approval && $approval['content_version'] === $review['content_version'] && hash_equals($approval['hash'], $review['hash']), 409, 'A aprovação não corresponde à edição.');
|
||||
$reviewer = User::where('id', $approval['actor_id'])->first();
|
||||
abort_unless($reviewer && $this->reviewAccess($reviewer), 403, 'Autoridade da decisão revogada.');
|
||||
abort_if($this->independent($review) && (in_array($reviewer->id, $review['contributors'], true) || in_array($publisher->id, $review['contributors'], true)), 403, 'Esta edição exige aprovação/publicação independente.');
|
||||
}
|
||||
abort_unless((int) $draft['base_public_version'] === (int) $zone->version_no, 409, 'A publicação base mudou. Reconcilie a preparação antes de publicar; ambos os estados foram preservados.');
|
||||
$zone->fill(array_intersect_key($draft['fields'], array_flip(self::FIELDS)));
|
||||
@@ -166,10 +352,39 @@ class InvestmentZoneOperationalProfile
|
||||
$zone->setAttribute($key, $this->publicDetails([$key => $zone->$key ?? []])[$key]);
|
||||
}
|
||||
$zone->setAttribute('editorial_draft', null);
|
||||
|
||||
return $draft['editorial'] ?? null;
|
||||
}
|
||||
|
||||
/** @param array<array-key,mixed> $draft */
|
||||
private function lockReviewContext(InvestmentZone $zone, array $draft): void
|
||||
{
|
||||
foreach (['legal_source_id' => 'investment_legal_sources', 'operator_id' => 'organizations'] as $field => $table) {
|
||||
$id = $draft['fields'][$field] ?? $zone->getAttribute($field);
|
||||
if ($id) {
|
||||
DB::table($table)->where('id', $id)->lockForUpdate()->first();
|
||||
}
|
||||
}
|
||||
$locations = DB::table('investment_zone_locations')->where('zone_id', $zone->id)->orderBy('id')->lockForUpdate()->pluck('geo_location_id')->all();
|
||||
$locations[] = $draft['fields']['primary_territory_id'] ?? $zone->getAttribute('primary_territory_id');
|
||||
$all = [];
|
||||
foreach (array_filter($locations) as $location) {
|
||||
for ($i = 0; $location && $i < 5; $i++) {
|
||||
$all[] = $location;
|
||||
$location = DB::table('geo_locations')->where('id', $location)->value('parent_id');
|
||||
}
|
||||
}
|
||||
DB::table('geo_locations')->whereIn('id', array_unique($all))->orderBy('id')->lockForUpdate()->get();
|
||||
$documents = DB::table('investment_zone_attachments')->where('zone_id', $zone->id)->orderBy('id')->lockForUpdate()->pluck('document_id')->all();
|
||||
DB::table('documents')->whereIn('id', $documents)->orderBy('id')->lockForUpdate()->get();
|
||||
}
|
||||
|
||||
public function reconcile(InvestmentZone $zone, int $working, int $public, int $actor): InvestmentZone
|
||||
{
|
||||
$this->ensureWriteMode($zone);
|
||||
if ($this->editorialEnabled()) {
|
||||
$this->reviewActor(User::findOrFail($actor));
|
||||
}
|
||||
$draft = $this->draft($zone);
|
||||
abort_unless($draft && $working === (int) $draft['working_version'] && $public === (int) $zone->version_no, 409, 'Versões alteradas; recupere a ficha pública e a preparação antes de reconciliar.');
|
||||
abort_if((int) $draft['base_public_version'] === $public, 422, 'A preparação já corresponde à versão pública atual.');
|
||||
@@ -177,6 +392,9 @@ class InvestmentZoneOperationalProfile
|
||||
$draft['working_version'] = $this->nextVersion($zone);
|
||||
$draft['actor_id'] = $actor;
|
||||
$draft['prepared_at'] = now()->toIso8601String();
|
||||
if ($this->editorialEnabled()) {
|
||||
$draft = $this->newReview($zone, $draft, $actor, $draft);
|
||||
}
|
||||
DB::table('investment_zones')->where('id', $zone->id)->update(['editorial_draft' => Crypt::encryptString(json_encode($draft, JSON_THROW_ON_ERROR))]);
|
||||
$this->snapshot($zone, $draft['working_version'], $actor, 'profile_reconciled', ['public' => [...$zone->toArray(), 'operational_details' => app(InvestmentZoneOperationalDetails::class)->stored($zone)], 'draft' => $draft]);
|
||||
|
||||
@@ -192,7 +410,15 @@ class InvestmentZoneOperationalProfile
|
||||
$hash = hash('sha256', $json);
|
||||
DB::table('investment_zone_revisions')->insert(['id' => (string) Str::uuid(), 'zone_id' => $zone->id, 'version_no' => $version,
|
||||
'actor_id' => $actor, 'action' => $action, 'snapshot' => Crypt::encryptString($json), 'sha256' => $hash]);
|
||||
DB::table('audit_events')->insert(['source_system' => 'investment-zones', 'entity_type' => 'investment_zones', 'entity_id' => $zone->id,
|
||||
'actor_user_id' => $actor, 'action' => $action, 'after_data' => json_encode(['version_no' => $version, 'sha256' => $hash], JSON_THROW_ON_ERROR)]);
|
||||
$eventId = (string) Str::uuid();
|
||||
$metadata = ['version_no' => $version, 'sha256' => $hash];
|
||||
if ($this->editorialEnabled()) {
|
||||
$metadata += ['editorial_workflow' => true, 'editorial_state' => $data['draft']['editorial']['state'] ?? ($action === 'published' ? 'published' : null)];
|
||||
}
|
||||
DB::table('audit_events')->insert(['id' => $eventId, 'source_system' => 'investment-zones', 'entity_type' => 'investment_zones', 'entity_id' => $zone->id,
|
||||
'actor_user_id' => $actor, 'action' => $action, 'after_data' => json_encode($metadata, JSON_THROW_ON_ERROR)]);
|
||||
if ($this->editorialEnabled()) {
|
||||
app(PortalEditorialNativeNotices::class)->emit(User::findOrFail($actor), $eventId, $data['draft']['editorial']['contributors'] ?? $data['decision']['contributors'] ?? []);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -96,9 +96,14 @@ class InvestmentZones
|
||||
{
|
||||
return DB::transaction(function () use ($id, $data, $actor) {
|
||||
$zone = $id ? InvestmentZone::whereKey($id)->lockForUpdate()->firstOrFail() : new InvestmentZone;
|
||||
if ($id && $zone->category === 'industrial_park') {
|
||||
$prepared = app(InvestmentZoneOperationalProfile::class)->prepare($zone, $data, $actor);
|
||||
$profile = app(InvestmentZoneOperationalProfile::class);
|
||||
$profile->ensureWriteMode($zone);
|
||||
if ($profile->editorialEnabled()) {
|
||||
$profile->authorizeWrite($actor);
|
||||
}
|
||||
if ($id && ($zone->category === 'industrial_park' || $profile->editorialEnabled())) {
|
||||
$this->storePendingLocations($zone, $data['locations'] ?? [], $actor);
|
||||
$prepared = app(InvestmentZoneOperationalProfile::class)->prepare($zone, $data, $actor);
|
||||
|
||||
return $prepared;
|
||||
}
|
||||
@@ -128,8 +133,10 @@ class InvestmentZones
|
||||
return DB::transaction(function () use ($id, $version, $actor) {
|
||||
$zone = InvestmentZone::whereKey($id)->lockForUpdate()->firstOrFail();
|
||||
$profile = app(InvestmentZoneOperationalProfile::class);
|
||||
if ($zone->category === 'industrial_park') {
|
||||
$profile->promote($zone, $version);
|
||||
$profile->ensureWriteMode($zone);
|
||||
$proof = null;
|
||||
if ($zone->category === 'industrial_park' || $profile->editorialEnabled()) {
|
||||
$proof = $profile->promote($zone, $version, $actor);
|
||||
} else {
|
||||
abort_if((int) $zone->version_no !== $version, 409, 'Versão alterada. Recarregue antes de aprovar.');
|
||||
}
|
||||
@@ -158,9 +165,9 @@ class InvestmentZones
|
||||
->where('zl.zone_id', $id)->where('zl.validation_status', 'validated')->where('g.data_classification', 'public')->whereNull('g.deleted_at')
|
||||
->whereIn('g.id', app(InvestmentGeography::class)->publicReferences()->select('id'))->exists();
|
||||
abort_unless($publicLocation, 422, 'Seleccione uma província ou distrito existente e público.');
|
||||
$zone->fill(['version_no' => $zone->category === 'industrial_park' ? $profile->nextVersion($zone) : $version + 1, 'reviewer_id' => $actor, 'publication_status' => 'published',
|
||||
$zone->fill(['version_no' => $zone->category === 'industrial_park' || $profile->editorialEnabled() ? $profile->nextVersion($zone) : $version + 1, 'reviewer_id' => $actor, 'publication_status' => 'published',
|
||||
'validation_status' => 'validated', 'published_at' => now()])->save();
|
||||
$this->snapshot($zone, $actor, 'published');
|
||||
$this->snapshot($zone, $actor, 'published', $proof);
|
||||
|
||||
return $zone;
|
||||
});
|
||||
@@ -171,11 +178,16 @@ class InvestmentZones
|
||||
return DB::transaction(function () use ($id, $version, $actor) {
|
||||
$zone = InvestmentZone::whereKey($id)->lockForUpdate()->firstOrFail();
|
||||
$profile = app(InvestmentZoneOperationalProfile::class);
|
||||
abort_if(($zone->category === 'industrial_park' ? $profile->workingVersion($zone) : (int) $zone->version_no) !== $version, 409, 'Versão alterada.');
|
||||
$zone->fill(['version_no' => $zone->category === 'industrial_park' ? $profile->nextVersion($zone) : $version + 1, 'publication_status' => 'suspended'])->save();
|
||||
$profile->ensureWriteMode($zone);
|
||||
if ($profile->editorialEnabled()) {
|
||||
$profile->authorizeWrite($actor);
|
||||
}
|
||||
abort_if(($zone->category === 'industrial_park' || $profile->editorialEnabled() ? $profile->workingVersion($zone) : (int) $zone->version_no) !== $version, 409, 'Versão alterada.');
|
||||
$zone->fill(['version_no' => $zone->category === 'industrial_park' || $profile->editorialEnabled() ? $profile->nextVersion($zone) : $version + 1, 'publication_status' => 'suspended'])->save();
|
||||
$this->snapshot($zone, $actor, 'suspended');
|
||||
$profile->suspensionPreservesReview($zone, $actor);
|
||||
|
||||
return $zone;
|
||||
return $profile->editorialEnabled() ? $zone->fresh() : $zone;
|
||||
});
|
||||
}
|
||||
|
||||
@@ -203,8 +215,14 @@ class InvestmentZones
|
||||
});
|
||||
}
|
||||
|
||||
private function snapshot(InvestmentZone $zone, int $actor, string $action): void
|
||||
/** @param array<array-key,mixed>|null $decision */
|
||||
private function snapshot(InvestmentZone $zone, int $actor, string $action, ?array $decision = null): void
|
||||
{
|
||||
if (app(InvestmentZoneOperationalProfile::class)->editorialEnabled()) {
|
||||
app(InvestmentZoneOperationalProfile::class)->snapshot($zone, (int) $zone->version_no, $actor, $action, ['public' => [...$zone->toArray(), 'operational_details' => app(InvestmentZoneOperationalDetails::class)->stored($zone)], 'decision' => $decision]);
|
||||
|
||||
return;
|
||||
}
|
||||
$json = json_encode([...$zone->toArray(), 'operational_details' => app(InvestmentZoneOperationalDetails::class)->stored($zone)], JSON_THROW_ON_ERROR);
|
||||
DB::table('investment_zone_revisions')->insert(['id' => (string) Str::uuid(), 'zone_id' => $zone->id,
|
||||
'version_no' => $zone->version_no, 'actor_id' => $actor, 'action' => $action,
|
||||
|
||||
@@ -24,7 +24,7 @@ final class InvestorContext
|
||||
|
||||
public const SOURCE = 'investor-context';
|
||||
|
||||
public const FIELDS = ['project_title', 'project_summary', 'sector_id', 'sector', 'province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location', 'currency', 'expected_start_date', 'fiscal_period', 'fiscal_periodicity', 'fiscal_month', 'investor_origin', 'person_type', 'entity_stage', 'tax_residency_country', 'fiscal_residency_country', 'activity_id', 'project_type', 'maturity_stage', 'special_zone_id', 'investment_regime', ...PrivateInvestmentPreparation::FIELDS];
|
||||
public const FIELDS = ['promoter_entity_key', 'legal_name', 'legal_form', 'registration_number', 'products_services', 'investment_budget_min', 'investment_budget_max', 'project_title', 'project_summary', 'sector_id', 'sector', 'province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location', 'currency', 'expected_start_date', 'fiscal_period', 'fiscal_periodicity', 'fiscal_month', 'investor_origin', 'person_type', 'entity_stage', 'tax_residency_country', 'fiscal_residency_country', 'activity_id', 'project_type', 'maturity_stage', 'special_zone_id', 'investment_regime', ...PrivateInvestmentPreparation::FIELDS];
|
||||
|
||||
public function __construct(private readonly VirtualDesk $desk) {}
|
||||
|
||||
@@ -51,7 +51,7 @@ final class InvestorContext
|
||||
$entrySources = Validator::make($input, ['entry_sources' => 'sometimes|array|max:200', 'entry_sources.*' => 'string|max:100'])->validate()['entry_sources'] ?? [];
|
||||
unset($input['draft_sequence'],$input['entry_sources']);
|
||||
abort_unless($sequence > 0, 422);
|
||||
$data = $this->input($input);
|
||||
$data = $this->input($input, true);
|
||||
if (isset($data['complements'])) {
|
||||
app(InvestmentComplements::class)->resolve($data['complements'], $this->state($case)['complements'] ?? []);
|
||||
}
|
||||
@@ -69,7 +69,7 @@ final class InvestorContext
|
||||
abort_unless($ref['kind'] === 'opportunity', 422);
|
||||
$record = Opportunity::whereKey($ref['id'])->firstOrFail();
|
||||
app(InvestmentOpportunityChoices::class)->portfolioOrigins($choice['portfolio_origins'] ?? [], (int) $record->id);
|
||||
$key = $choice['corridor_key'] ?? app(InvestmentCorridorContext::class)->key($record);
|
||||
$key = array_key_exists('corridor_key', $choice) ? $choice['corridor_key'] : app(InvestmentCorridorContext::class)->key($record);
|
||||
if (! empty($choice['territory'])) {
|
||||
$location = $this->reference($choice['territory']);
|
||||
abort_unless($location['kind'] === 'territory', 422);
|
||||
@@ -114,6 +114,123 @@ final class InvestorContext
|
||||
return Schema::hasTable('investor_navigation_preferences');
|
||||
}
|
||||
|
||||
/** Existing identity records only; these choices never change dossier ownership.
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function promoter(User $actor, string $id): array
|
||||
{
|
||||
$case = $this->desk->case($actor, $id);
|
||||
abort_unless((int) $case->user_id === $actor->id, 403);
|
||||
$payload = $this->desk->decode($case->payload);
|
||||
$companies = DB::table('investment_company_declarations')->where('user_id', $actor->id)->orderByDesc('created_at')->get(['id', 'version', 'payload'])->map(function ($row) {
|
||||
$f = $this->desk->decode($row->payload);
|
||||
return ['id' => $row->id, 'version' => $row->version, 'name' => $f['name'] ?? 'Empresa declarada', 'legal_form' => $f['legal_form'] ?? null];
|
||||
})->all();
|
||||
return ['version' => $case->version, 'selected' => $payload['investor_path']['context']['promoter_entity'] ?? ($case->company_id ? ['kind' => 'company', 'id' => $case->company_id, 'snapshot' => $payload['company'] ?? []] : ['kind' => 'undetermined']),
|
||||
'companies' => $companies, 'organizations' => $this->desk->representedOrganizations($actor), 'can_write' => $case->organization_id === null && ! $case->closed_at];
|
||||
}
|
||||
|
||||
/** Attach an authorised identity snapshot while retaining the case owner and ACL.
|
||||
* @param array<string,mixed> $input
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function setPromoter(User $actor, string $id, array $input): array
|
||||
{
|
||||
$v = Validator::make($input, ['version' => 'required|integer|min:1', 'operation_key' => 'required|uuid', 'kind' => 'required|in:company,organization,being_formed,undetermined', 'id' => 'nullable|uuid', 'source_version' => 'nullable|integer|min:1'])->validate();
|
||||
return DB::transaction(function () use ($actor, $id, $v): array {
|
||||
$case = $this->desk->case($actor, $id, true, true);
|
||||
abort_unless((int) $case->user_id === $actor->id && $case->organization_id === null, 403);
|
||||
$this->desk->assertOpen($case);
|
||||
$payload = $this->desk->decode($case->payload);
|
||||
$hash = hash('sha256', json_encode($v, JSON_THROW_ON_ERROR));
|
||||
foreach ($payload['investor_path']['promoter_history'] ?? [] as $entry) {
|
||||
if (($entry['operation_key'] ?? null) === $v['operation_key']) {
|
||||
abort_unless(hash_equals($entry['request_hash'], $hash), 409);
|
||||
return ['saved' => true, 'replayed' => true, 'continue' => '/investimentos/'.$id];
|
||||
}
|
||||
}
|
||||
abort_unless((int) $case->version === (int) $v['version'], 409, 'O dossier mudou; recupere os dados antes de alterar a entidade.');
|
||||
$snapshot = [];
|
||||
$sourceVersion = null;
|
||||
if ($v['kind'] === 'company') {
|
||||
$company = DB::table('investment_company_declarations')->where('id', $v['id'] ?? null)->where('user_id', $actor->id)->lockForUpdate()->first();
|
||||
abort_unless($company !== null, 404);
|
||||
$snapshot = $this->desk->decode($company->payload);
|
||||
$sourceVersion = $company->version;
|
||||
} elseif ($v['kind'] === 'organization') {
|
||||
DB::table('memberships')->where('organization_id', $v['id'] ?? null)->where('user_id', $actor->id)->whereNull('deleted_at')->lockForUpdate()->get();
|
||||
abort_unless($this->desk->represents($actor, $v['id'] ?? '', false), 403);
|
||||
$organization = collect($this->desk->representedOrganizations($actor))->firstWhere('id', $v['id']);
|
||||
abort_unless($organization !== null, 403);
|
||||
$snapshot = ['name' => $organization['name'], 'incorporation_country_code' => $organization['country']];
|
||||
$sourceVersion = $organization['version'];
|
||||
}
|
||||
abort_if(isset($v['source_version']) && (int) $v['source_version'] !== (int) $sourceVersion, 409, 'O cadastro da entidade mudou. Recupere a associação antes de continuar.');
|
||||
$entity = ['kind' => $v['kind'], 'id' => in_array($v['kind'], ['company', 'organization'], true) ? $v['id'] : null, 'source_version' => $sourceVersion, 'snapshot' => $snapshot, 'recorded_at' => now()->toIso8601String()];
|
||||
$stage = in_array($v['kind'], ['company', 'organization'], true) ? 'existing' : ($v['kind'] === 'being_formed' ? 'being_formed' : '');
|
||||
$declarations = ['entity_stage' => $stage, 'promoter_entity_key' => $v['kind'].':'.($entity['id'] ?? '').'@'.($sourceVersion ?? '')];
|
||||
$existingFields = $this->state($case)['fields'];
|
||||
foreach (['legal_name' => 'name', 'legal_form' => 'legal_form', 'registration_number' => 'registration'] as $field => $key) {
|
||||
if (empty($existingFields[$field]) && ! empty($snapshot[$key])) $declarations[$field] = $snapshot[$key];
|
||||
}
|
||||
$body = ['version' => $case->version, 'selection' => [], 'declarations' => $declarations];
|
||||
$plan = $this->preview($actor, $id, $body);
|
||||
$this->commit($actor, $id, [...$body, 'preview_hash' => $plan['preview_hash'], 'confirm' => true, 'operation_key' => $v['operation_key']]);
|
||||
$current = $this->desk->case($actor, $id, true, true);
|
||||
$next = $this->desk->decode($current->payload);
|
||||
$previous = $payload['investor_path']['context']['promoter_entity'] ?? ($case->company_id ? ['kind' => 'company', 'id' => $case->company_id, 'snapshot' => $payload['company'] ?? []] : ['kind' => 'undetermined']);
|
||||
$next['investor_path']['context']['promoter_entity'] = $entity;
|
||||
$next['investor_path']['promoter_history'][] = ['before' => $previous, 'after' => $entity, 'operation_key' => $v['operation_key'], 'request_hash' => $hash];
|
||||
$next['company'] = $snapshot;
|
||||
$next['company_version'] = $sourceVersion;
|
||||
DB::table('desk_cases')->where('id', $id)->update(['company_id' => $v['kind'] === 'company' ? $v['id'] : null, 'payload' => $this->desk->encode($next)]);
|
||||
$this->desk->event($current, $actor, 'investment_promoter_associated', ['before' => $previous, 'after' => $entity, 'ownership_unchanged' => true]);
|
||||
return ['saved' => true, 'replayed' => false, 'continue' => $v['kind'] === 'being_formed' ? '/investimentos/'.$id.'/preparar-empresa' : '/investimentos/'.$id];
|
||||
});
|
||||
}
|
||||
|
||||
/** Explicit consultation saved in the existing encrypted dossier, with optimistic locking.
|
||||
* @param array<string,mixed> $input
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function saveSupplyAggregate(User $actor, string $id, array $input): array
|
||||
{
|
||||
abort_unless(app(ProactiveSupply::class)->aggregateAvailable(), 404);
|
||||
$protected = (bool) config('investor-path.protected_supply_enabled');
|
||||
abort_if($protected && array_diff(array_keys($input), ['version', 'operation_key', 'activity_id', 'classification_key']), 422, 'O território e o sector são recuperados do contexto guardado. Altere o contexto do dossier antes de consultar.');
|
||||
$control = Validator::make($input, ['version' => 'required|integer|min:1', 'operation_key' => 'required|uuid', 'activity_id' => 'nullable|uuid', 'classification_key' => ['nullable', 'string', 'max:80', 'regex:/^ebau:[0-9]+$/D']])->validate();
|
||||
abort_if(! empty($control['activity_id']) && ! empty($control['classification_key']), 422, 'Seleccione uma única classificação para a comparação.');
|
||||
$signature = hash('sha256', json_encode(\Illuminate\Support\Arr::except($control, ['version', 'operation_key']), JSON_THROW_ON_ERROR));
|
||||
return DB::transaction(function () use ($actor, $id, $control, $protected, $signature): array {
|
||||
$case = $this->desk->case($actor, $id, true, true);
|
||||
abort_unless((int) $case->user_id === $actor->id, 403);
|
||||
$this->desk->assertOpen($case);
|
||||
$payload = $this->desk->decode($case->payload);
|
||||
$history = $payload['investor_path']['supply_aggregates'] ?? [];
|
||||
foreach ($history as $saved) {
|
||||
if ($saved['operation_key'] === $control['operation_key']) {
|
||||
abort_if($protected && app(ProactiveSupply::class)->protectedHistory([$saved]) === [], 409, 'Esta consulta antiga não cumpre a protecção actual. Prepare uma nova consulta.');
|
||||
abort_if($protected && ($saved['request_signature'] ?? null) !== $signature, 409, 'A mesma chave de consulta não pode ser usada com outra actividade. Prepare uma nova consulta.');
|
||||
return ['version' => $case->version, 'analysis' => $protected ? app(ProactiveSupply::class)->protectedHistory([$saved])[0] : $saved, 'replayed' => true];
|
||||
}
|
||||
}
|
||||
abort_unless((int) $case->version === (int) $control['version'], 409, 'O dossier mudou. Recupere-o antes de consultar.');
|
||||
$context = $this->state($case);
|
||||
abort_if(count($context['opportunity_choices'] ?? []) > 1, 422, 'Esta análise utiliza um único contexto de investimento. Escolha o investimento a analisar, preservando as restantes associações.');
|
||||
$f = $context['fields'];
|
||||
if ($protected && array_key_exists('activity_id', $control)) $f['activity_id'] = $control['activity_id'];
|
||||
if ($protected && ! empty($control['classification_key'])) $f['supply_classification_key'] = $control['classification_key'];
|
||||
$territory = $f['locality_id'] ?? $f['admin_post_id'] ?? $f['district_id'] ?? $f['province_id'] ?? null;
|
||||
abort_unless($territory, 422, 'Guarde primeiro a localização conhecida no dossier.');
|
||||
$data = $protected ? app(ProactiveSupply::class)->protectedAggregate($actor, $id, $territory, $f) : app(ProactiveSupply::class)->aggregate($actor, $territory);
|
||||
$analysis = [...$data, 'context_revision' => $context['revision'], 'recorded_at' => now()->toIso8601String(), 'operation_key' => $control['operation_key'], ...($protected ? ['request_signature' => $signature] : [])];
|
||||
$payload['investor_path']['supply_aggregates'] = [...$history, $analysis];
|
||||
DB::table('desk_cases')->where('id', $id)->update(['payload' => $this->desk->encode($payload), 'version' => $case->version + 1, 'updated_at' => now()]);
|
||||
$this->desk->event($this->desk->case($actor, $id), $actor, 'investment_supply_aggregate_saved', ['context_revision' => $context['revision'], 'territory_id' => $territory, 'aggregate_only' => true]);
|
||||
return ['version' => $case->version + 1, 'analysis' => $protected ? app(ProactiveSupply::class)->protectedHistory([$analysis])[0] : $analysis, 'replayed' => false];
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<array-key, mixed>
|
||||
*/
|
||||
@@ -193,6 +310,17 @@ final class InvestorContext
|
||||
$href = $published ? '/oportunidades/'.$o->slug : '/minhas-oportunidades/'.$o->id.'/view';
|
||||
$version = $o->management_version;
|
||||
$fields = ['project_title' => $title, 'project_summary' => $draft['canonical']['executive_summary'] ?? $o->summary];
|
||||
if ($o->isPrivateOfferPreparation()) {
|
||||
// Offers reuse Opportunity, but their preparation writes description,
|
||||
// not the canonical executive summary. Keep this authorised private
|
||||
// projection explicit: never copy private_offer (price/finances/contact).
|
||||
$title = $draft['title'] ?? $o->title;
|
||||
$summary = $fields['project_summary'];
|
||||
$fields['project_title'] = $title;
|
||||
$fields['project_summary'] = is_string($summary) && trim($summary) !== ''
|
||||
? $summary : ($draft['description'] ?? null);
|
||||
$href = '/minhas-oportunidades/ofertas/'.$o->id;
|
||||
}
|
||||
if ($o->sector) {
|
||||
$fields['sector_id'] = (string) $o->sector_id;
|
||||
$fields['sector'] = $o->sector->name;
|
||||
@@ -316,17 +444,18 @@ final class InvestorContext
|
||||
return $fields;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<array-key, mixed>
|
||||
/** @param array<string,mixed> $filters
|
||||
* @return array<array-key,mixed>
|
||||
*/
|
||||
public function options(string $query = ''): array
|
||||
public function options(string $query = '', array $filters = []): array
|
||||
{
|
||||
$query = mb_substr(trim($query), 0, 120);
|
||||
$items = [];
|
||||
foreach (Opportunity::published()->when($query, fn ($q) => $q->where('title', 'ilike', '%'.$query.'%'))->orderBy('title')->limit(51)->get(['id', 'title']) as $o) {
|
||||
$items[] = ['key' => 'opportunity:'.$o->id, 'title' => $o->title, 'kind' => 'opportunity'];
|
||||
$public = $filters ? app(InvestmentCatalogue::class)->query([...$filters, 'q' => $query]) : Opportunity::published()->when($query, fn ($q) => $q->where('title', 'ilike', '%'.$query.'%'));
|
||||
foreach ($public->orderBy('title')->limit(51)->get(['opportunities.id', 'opportunities.title']) as $o) {
|
||||
$items[] = ['key' => 'opportunity:'.$o->id, 'title' => $o->title, 'kind' => 'opportunity', 'relevance' => $filters ? 'Corresponde aos critérios explicitamente seleccionados.' : 'Correspondência com a pesquisa; confirme a pertinência antes de associar.'];
|
||||
}
|
||||
if (request()->user()) {
|
||||
if (request()->user() && (! $filters || $query !== '')) {
|
||||
$private = app(PortalProfileAccess::class)->scope(Opportunity::query(), request()->user())->where('status', '!=', 'published')->where('status', '!=', 'archived')->when($query, fn ($q) => $q->where('title', 'ilike', '%'.$query.'%'))->orderBy('title')->limit(51)->get();
|
||||
foreach ($private as $o) {
|
||||
if (app(PortalProfileAccess::class)->canView(request()->user(), $o)) {
|
||||
@@ -334,13 +463,13 @@ final class InvestorContext
|
||||
}
|
||||
}
|
||||
}
|
||||
if (config('existing-business.enabled')) {
|
||||
if (config('existing-business.enabled') && (! $filters || $query !== '')) {
|
||||
foreach (ExistingBusiness::published()->when($query, fn ($q) => $q->where('public_title', 'ilike', '%'.$query.'%'))->orderBy('public_title')->limit(51)->get(['id', 'public_title']) as $o) {
|
||||
$items[] = ['key' => 'business:'.$o->id, 'title' => $o->public_title, 'kind' => 'business'];
|
||||
}
|
||||
}
|
||||
|
||||
return ['opportunities' => $items, 'search_limited' => count($items) > 50, 'sectors' => Sector::choices()->orderBy('name')->get(['id', 'name', 'slug']),
|
||||
return ['opportunities' => $items, 'countries' => app(CountryCatalogue::class)->all(), 'search_limited' => count($items) > 50, 'sectors' => Sector::choices()->orderBy('name')->get(['id', 'name', 'slug']),
|
||||
'parks' => app(InvestmentZones::class)->visible()->whereIn('category', ['industrial_park', 'zee', 'zfi'])->orderBy('name')->get(['id', 'name', 'category', 'version_no'])];
|
||||
}
|
||||
|
||||
@@ -403,7 +532,7 @@ final class InvestorContext
|
||||
* @param array<array-key, mixed> $input
|
||||
* @return array<array-key, mixed>
|
||||
*/
|
||||
private function input(array $input): array
|
||||
private function input(array $input, bool $draft = false): array
|
||||
{
|
||||
abort_if(array_diff(array_keys($input), ['complements', 'opportunity_choices', 'version', 'selection', 'declarations', 'replace_fields', 'preview_hash', 'operation_key', 'confirm', 'document_links', '_token']) !== [], 422, 'Campo de controlo desconhecido.');
|
||||
|
||||
@@ -429,8 +558,10 @@ final class InvestorContext
|
||||
'opportunity_choices.*.source' => 'required|string|distinct|max:100', 'opportunity_choices.*.territory' => 'nullable|string|max:100',
|
||||
'opportunity_choices.*.location_reason' => 'nullable|string|max:2000', 'opportunity_choices.*.confirm_location_change' => 'sometimes|boolean',
|
||||
'version' => 'required|integer|min:1', 'selection' => 'present|array:portfolio,opportunity,sector,territory,park',
|
||||
'selection.*' => 'nullable|string|max:100', 'declarations' => 'nullable|array:project_title,project_summary,currency,expected_start_date,investor_origin,person_type,entity_stage,tax_residency_country,fiscal_residency_country,project_type,maturity_stage,'.implode(',', PrivateInvestmentPreparation::FIELDS), 'declarations.project_title' => 'nullable|string|max:200', 'declarations.project_summary' => 'nullable|string|max:5000',
|
||||
'declarations.currency' => 'nullable|regex:/^[A-Z]{3}$/', 'declarations.expected_start_date' => 'nullable|date_format:Y-m-d', 'declarations.investor_origin' => 'nullable|in:national,foreign,mixed', 'declarations.person_type' => 'nullable|in:singular,collective,sole_trader,consortium', 'declarations.entity_stage' => 'nullable|in:existing,being_formed', 'declarations.tax_residency_country' => ['nullable', 'string', app(CountryCatalogue::class)->rule()], 'declarations.fiscal_residency_country' => ['nullable', 'string', app(CountryCatalogue::class)->rule()], 'declarations.project_type' => 'nullable|string|max:100', 'declarations.maturity_stage' => 'nullable|string|max:100',
|
||||
'selection.*' => 'nullable|string|max:100', 'declarations' => 'nullable|array:promoter_entity_key,legal_name,legal_form,registration_number,products_services,investment_budget_min,investment_budget_max,project_title,project_summary,currency,expected_start_date,investor_origin,person_type,entity_stage,tax_residency_country,fiscal_residency_country,project_type,maturity_stage,'.implode(',', PrivateInvestmentPreparation::FIELDS), 'declarations.promoter_entity_key' => 'nullable|string|max:160', 'declarations.legal_name' => 'nullable|string|max:250', 'declarations.legal_form' => 'nullable|string|max:100', 'declarations.registration_number' => 'nullable|string|max:100',
|
||||
'declarations.products_services' => 'nullable|string|max:2000', 'declarations.project_title' => 'nullable|string|max:200', 'declarations.project_summary' => 'nullable|string|max:5000',
|
||||
'declarations.investment_budget_min' => 'nullable|numeric|min:0', 'declarations.investment_budget_max' => ['nullable', 'numeric', 'min:0', ...(! empty($input['declarations']['investment_budget_min']) ? ['gte:declarations.investment_budget_min'] : [])],
|
||||
'declarations.currency' => $draft ? 'nullable|regex:/^[A-Za-z]{0,3}$/D' : 'nullable|regex:/^[A-Z]{3}$/D', 'declarations.expected_start_date' => 'nullable|date_format:Y-m-d', 'declarations.investor_origin' => 'nullable|in:national,foreign,mixed', 'declarations.person_type' => 'nullable|in:singular,collective,sole_trader,consortium', 'declarations.entity_stage' => 'nullable|in:existing,being_formed', 'declarations.tax_residency_country' => ['nullable', 'string', app(CountryCatalogue::class)->rule()], 'declarations.fiscal_residency_country' => ['nullable', 'string', app(CountryCatalogue::class)->rule()], 'declarations.project_type' => 'nullable|string|max:100', 'declarations.maturity_stage' => 'nullable|string|max:100',
|
||||
'replace_fields' => 'nullable|array', 'replace_fields.*' => 'string|in:'.implode(',', self::FIELDS)])->validate();
|
||||
}
|
||||
|
||||
@@ -469,7 +600,9 @@ final class InvestorContext
|
||||
$choices = app(InvestmentOpportunityChoices::class)->resolve($data['opportunity_choices'], $choices);
|
||||
$data['selection']['opportunity'] = $choices[0]['opportunity']['key'] ?? null;
|
||||
// Shared fields concern the first identified opportunity; other sites remain separate.
|
||||
if ($choices !== []) {
|
||||
$data['selection']['territory'] = $choices[0]['territory']['key'] ?? null;
|
||||
}
|
||||
if (array_key_exists('park', $data['opportunity_choices'][0] ?? [])) {
|
||||
$data['selection']['park'] = $choices[0]['park']['key'] ?? null;
|
||||
}
|
||||
@@ -500,7 +633,7 @@ final class InvestorContext
|
||||
}
|
||||
$selection[$slot] = $ref;
|
||||
}
|
||||
$corridor = $choices[0]['corridor_key'] ?? (isset($selection['opportunity']) && $selection['opportunity']['kind'] === 'opportunity'
|
||||
$corridor = array_key_exists('corridor_key', $choices[0] ?? []) ? $choices[0]['corridor_key'] : (isset($selection['opportunity']) && $selection['opportunity']['kind'] === 'opportunity'
|
||||
? app(InvestmentCorridorContext::class)->key(Opportunity::whereKey($selection['opportunity']['id'])->firstOrFail()) : null);
|
||||
if ($corridor && isset($selection['territory'])) {
|
||||
abort_unless(app(InvestmentCorridorContext::class)->compatible($corridor, $selection['territory']['id']), 422, 'A localização não pertence ao corredor escolhido.');
|
||||
@@ -568,9 +701,12 @@ final class InvestorContext
|
||||
$fields['special_zone_id'] = $selection['park']['id'] ?? '';
|
||||
$fields['investment_regime'] = $selection['park']['fields']['investment_regime'] ?? 'general';
|
||||
}
|
||||
if (isset($fields['investment_budget_min'], $fields['investment_budget_max']) && $fields['investment_budget_min'] !== '' && $fields['investment_budget_max'] !== '') {
|
||||
Validator::make(['declarations' => $fields], ['declarations.investment_budget_max' => 'numeric|gte:declarations.investment_budget_min'])->validate();
|
||||
}
|
||||
$replaced = [];
|
||||
foreach (array_unique([...array_keys($old['fields']), ...array_keys($fields)]) as $key) {
|
||||
if (($old['fields'][$key] ?? null) !== ($fields[$key] ?? null)) {
|
||||
if (($old['fields'][$key] ?? '') !== ($fields[$key] ?? '')) {
|
||||
$replaced[] = ['field' => $key, 'before' => $old['fields'][$key] ?? null, 'after' => $fields[$key] ?? null];
|
||||
}
|
||||
}
|
||||
@@ -753,7 +889,7 @@ final class InvestorContext
|
||||
$original = $ctx;
|
||||
$ctx = app(InvestmentConsumerScope::class)->context($ctx, $opportunity);
|
||||
$f = $ctx['fields'];
|
||||
$sim = Arr::except(Arr::only($f, self::FIELDS), ['sector', 'province', 'district', 'location', ...array_diff(PrivateInvestmentPreparation::FIELDS, ['total_investment', 'area_required', 'area_unit'])]);
|
||||
$sim = Arr::except(Arr::only($f, self::FIELDS), ['promoter_entity_key', 'sector', 'province', 'district', 'location', ...array_diff(PrivateInvestmentPreparation::FIELDS, ['total_investment', 'area_required', 'area_unit'])]);
|
||||
// Entering this tool from an investment dossier selects the existing investment-analysis route.
|
||||
// The reconciliation preserves any purpose deliberately chosen in an existing simulator draft.
|
||||
$sim += ['journey_type' => 'investor', 'journey_type_label' => 'Avaliar o meu investimento', 'purpose' => 'simulate_only', 'purpose_label' => 'Apenas simular'];
|
||||
@@ -779,6 +915,7 @@ final class InvestorContext
|
||||
'version' => 1, 'context_revision' => $ctx['revision'],
|
||||
'consumer_opportunity' => $ctx['consumer_opportunity']['opportunity']['key'] ?? null,
|
||||
'portfolio_origin' => $ctx['selection']['portfolio'] ?? null,
|
||||
'promoter_entity' => $ctx['promoter_entity'] ?? null,
|
||||
'zone' => $zone ? Arr::only($zone, ['id', 'title', 'href', 'version', 'sha256', 'fields', 'analysis']) : null,
|
||||
'provenance' => $ctx['provenance'],
|
||||
// Retain dossier options as provenance when no consumer is selected; scoped fields remain empty.
|
||||
|
||||
@@ -8,6 +8,7 @@ use App\Models\SimulationFormDraft;
|
||||
use App\Models\User;
|
||||
use App\Support\StructuredData;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Carbon;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
@@ -161,6 +162,7 @@ final class InvestorPath
|
||||
}
|
||||
|
||||
$preparationTaskKeys = $opportunity !== null && ($owner || $manager) && app(PrivateInvestmentPreparation::class)->available() ? app(InvestmentPreparationWorkspace::class)->taskKeys($actor, $id, $opportunity) : null;
|
||||
$supplyEnabled = (int) $case->user_id === $actor->id && app(ProactiveSupply::class)->aggregateAvailable();
|
||||
|
||||
return ['funding_selections' => ($owner || $manager) ? array_values(array_filter($path['funding_selections'] ?? [], fn ($row) => ($row['opportunity'] ?? null) === $opportunity)) : [], 'preparation_action' => ($owner || $manager) && app(PrivateInvestmentPreparation::class)->available() ? app(InvestmentPreparationWorkspace::class)->continuation($actor, $id, $opportunity, request()->query('swot_action')) : null, 'private_investment' => $preparation, 'case' => ['id' => $id, 'title' => $case->title, 'version' => $case->version, 'closed' => $case->closed_at !== null],
|
||||
'journey_id' => $journey->id, 'definition_id' => $version->id, 'definition_version' => $version->version_no, 'source_sha256' => $definition['source_sha256'],
|
||||
@@ -170,11 +172,26 @@ final class InvestorPath
|
||||
'canWrite' => $owner && ! $case->closed_at, 'canReview' => $manager && (int) $case->user_id !== $actor->id && ! $case->closed_at,
|
||||
'next' => $next ? ['code' => $next['code'], 'title' => $next['title'], 'action' => 'Preparar', 'href' => $next['href'] ?? '#'.$next['code']] : null,
|
||||
'investment_context' => ($owner || $manager) ? [...$context, 'opportunity_choices' => $opportunity ? $context['opportunity_choices'] : $allChoices] : null,
|
||||
'can_set_promoter' => (int) $case->user_id === $actor->id && $case->organization_id === null && ! $case->closed_at,
|
||||
'results' => $results, 'requests' => $requests, 'documents' => $documents,
|
||||
'supply_aggregate_enabled' => $supplyEnabled, 'supply_aggregate_protected' => $supplyEnabled && (bool) config('investor-path.protected_supply_enabled'),
|
||||
'supply_activity_options' => $supplyEnabled && config('investor-path.protected_supply_enabled') ? app(ProactiveSupply::class)->aggregateActivityOptions(isset($context['fields']['sector_id']) ? (int) $context['fields']['sector_id'] : null) : [],
|
||||
'supply_aggregates' => $supplyEnabled ? (config('investor-path.protected_supply_enabled') ? app(ProactiveSupply::class)->protectedHistory($path['supply_aggregates'] ?? []) : ($path['supply_aggregates'] ?? [])) : [],
|
||||
'fiscal_reports' => (int) $case->user_id === $actor->id && (count($allChoices) < 2 || $opportunity !== null)
|
||||
? app(SimulationFormDrafts::class)->dossierReportSources($actor, $id, $opportunity) : [],
|
||||
'land_report' => $landCase ? ['id' => $landCase->id, 'version' => $landCase->version, 'updated_at' => $landCase->updated_at?->toIso8601String(),
|
||||
'href' => '/investidor/terra-duat/'.$landCase->id.'/imprimir'] : null,
|
||||
'preparation_report' => ($owner || $manager) && app(PrivateInvestmentPreparation::class)->available() && (count($allChoices) < 2 || $opportunity !== null)
|
||||
? app(InvestmentPreparationWorkspace::class)->reportSummary($actor, $id, $opportunity) : null,
|
||||
'company_reports' => ($owner || $manager) ? array_filter([
|
||||
'comparison' => isset($payload['company_comparison']) ? Arr::only($payload['company_comparison'], ['revision', 'at']) : null,
|
||||
'preparation' => isset($payload['company_preparation']) ? Arr::only($payload['company_preparation'], ['revision', 'at']) : null,
|
||||
'guides' => array_map(fn ($guide) => ['revision' => $guide['revision'], 'at' => $guide['at'], 'slug' => $guide['guide']['slug'], 'title' => $guide['guide']['title'] ?? $guide['guide']['slug']], $payload['investment_guides'] ?? []),
|
||||
]) : [],
|
||||
'zone_contexts' => ($owner || $manager) ? ($path['zone_contexts'] ?? []) : [],
|
||||
'sector_contexts' => ($owner || $manager) ? ($path['sector_contexts'] ?? []) : [],
|
||||
'sector_references' => ($owner || $manager) ? ($path['sector_references'] ?? []) : [],
|
||||
'content_sources' => ($owner || $manager) ? ($path['content_sources'] ?? []) : [],
|
||||
'content_sources' => ($owner || $manager) ? app(SectorContentAnalysis::class)->savedSources($path['content_sources'] ?? []) : [],
|
||||
'tasks' => DB::table('tasks')->where('desk_case_id', $id)
|
||||
->whereNull('deleted_at')
|
||||
->when($preparationTaskKeys !== null, fn ($q) => $q->where(fn ($p) => $p->whereNull('guidance_key')->orWhere('guidance_key', 'not like', 'swot:%')->orWhereIn('guidance_key', $preparationTaskKeys ?? [])))
|
||||
@@ -312,6 +329,7 @@ final class InvestorPath
|
||||
'snapshot_sha256' => $draft->snapshot_sha256, 'financial_snapshot' => $snapshot,
|
||||
'context_opportunity' => $opportunity,
|
||||
'currency' => $economic['currency'] ?? null, 'engine' => 'financial-calculators:v1',
|
||||
'preparation_snapshot' => Arr::only($economic, ['total_investment', 'secured_amount', 'planned_funding', 'requested_funding', 'approved_funding', 'planning_loan', 'annual_revenue', 'annual_operating_costs', 'investment_budget_min', 'investment_budget_max', 'initial_budget_snapshot', 'planning_assumptions_snapshot']),
|
||||
'kind' => 'local_calculation_inputs', 'context_state' => 'current', 'context_revision' => $context['revision'], 'context_dependency_hash' => $context['dependency_hash'] ?? app(InvestorContext::class)->dependencyHash([]), 'recorded_at' => now()->toIso8601String()];
|
||||
$payload['investor_path']['results'][] = $result;
|
||||
abort_unless(count($payload['investor_path']['results']) <= 100, 422, 'Limite de evidências financeiras deste dossier atingido.');
|
||||
|
||||
@@ -104,7 +104,7 @@ final class LegacyContent
|
||||
}
|
||||
}
|
||||
|
||||
return ['id' => (int) $row->resource_id, 'document_id' => $row->id, 'version' => (int) $row->metadata_version,
|
||||
$article = ['id' => (int) $row->resource_id, 'document_id' => $row->id, 'version' => (int) $row->metadata_version,
|
||||
'sha256' => trim($row->sha256), 'title' => $source['title'], 'author' => $source['author'],
|
||||
'legacy_id' => $source['legacy_id'], 'legacy_category' => $source['legacy_category'],
|
||||
'published_at' => $source['published_at'], 'modified_at' => $source['modified_at'], 'source_url' => $source['source_url'],
|
||||
@@ -124,6 +124,9 @@ final class LegacyContent
|
||||
'territorial_status' => 'Menções territoriais preservadas no artigo. Limites administrativos, parcelas e geometrias não associados automaticamente.',
|
||||
'library_href' => '/documentos/'.$row->resource_id,
|
||||
'consultation_state' => 'public', 'legal_state' => 'not_applicable', 'calculation_use' => false];
|
||||
$article['sector_analysis'] = app(SectorContentAnalysis::class)->describe($article);
|
||||
|
||||
return $article;
|
||||
}
|
||||
|
||||
/** An excerpt of the displayed edition, never a claim about returns or availability. */
|
||||
|
||||
@@ -0,0 +1,80 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use Carbon\CarbonImmutable;
|
||||
|
||||
/** Read-time exclusion never depends on the scheduler or the NDA. */
|
||||
final class OfferAvailability
|
||||
{
|
||||
/** @return array{state:string,expires_at:?string,policy_pending:bool} */
|
||||
public function view(mixed $operation, mixed $publication): array
|
||||
{
|
||||
// Legacy public snapshots without an editorial hash retain their first frozen policy.
|
||||
$key = is_array($publication) ? ($publication['editorial_hash'] ?? '') : null;
|
||||
$key ??= is_array($operation) ? ($operation['last_approval_hash'] ?? '') : '';
|
||||
if (! is_string($key)) {
|
||||
return ['state' => 'unavailable', 'expires_at' => null, 'policy_pending' => true];
|
||||
}
|
||||
$policy = is_array($operation) ? ($operation['validity_policies'][$key] ?? $operation['validity'] ?? null) : null;
|
||||
$pending = ! is_array($policy) || ($policy['days'] ?? null) === null;
|
||||
$result = ['state' => 'available', 'expires_at' => null, 'policy_pending' => $pending];
|
||||
if ($operation !== null && ! is_array($operation)) {
|
||||
return [...$result, 'state' => 'unavailable'];
|
||||
}
|
||||
$state = $operation['status'] ?? 'available';
|
||||
if (! is_int($operation['cycle'] ?? 0) || ($operation['cycle'] ?? 0) < 0) {
|
||||
return [...$result, 'state' => 'unavailable'];
|
||||
}
|
||||
if (! in_array($state, ['available', 'withdrawn', 'expired', 'revalidation'], true)) {
|
||||
return [...$result, 'state' => 'unavailable'];
|
||||
}
|
||||
if ($state !== 'available') {
|
||||
return [...$result, 'state' => $state];
|
||||
}
|
||||
$days = $policy['days'] ?? null;
|
||||
if (($operation['cycle'] ?? 0) > 0 && ($publication['offer_cycle'] ?? null) !== $operation['cycle']) {
|
||||
return $result;
|
||||
}
|
||||
if ($days === null || ! is_array($publication) || ($publication['publication']['state'] ?? null) !== 'published') {
|
||||
return $result;
|
||||
}
|
||||
if (! is_int($days) || $days < 1 || $days > 36500) {
|
||||
return [...$result, 'state' => 'unavailable'];
|
||||
}
|
||||
try {
|
||||
$at = $publication['publication']['at'] ?? null;
|
||||
if (! is_string($at) || ! preg_match('/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,6})?(?:Z|[+-]\d{2}:\d{2})$/D', $at)) {
|
||||
return [...$result, 'state' => 'unavailable'];
|
||||
}
|
||||
$start = CarbonImmutable::parse($at);
|
||||
$end = $start->addDays($days)->utc();
|
||||
} catch (\Throwable) {
|
||||
return [...$result, 'state' => 'unavailable'];
|
||||
}
|
||||
|
||||
return [...$result, 'expires_at' => $end->toIso8601String(), 'state' => $end->lte(CarbonImmutable::now()) ? 'expired' : 'available'];
|
||||
}
|
||||
|
||||
/** @return array{state:string,expires_at:?string,policy_pending:bool} */
|
||||
public function record(Opportunity $record): array
|
||||
{
|
||||
return $this->view($record->workflow_context['offer_operation'] ?? null, $record->workflow_context['offer_publication'] ?? null);
|
||||
}
|
||||
|
||||
public function publicAllowed(mixed $operation, mixed $publication): bool
|
||||
{
|
||||
if ($this->view($operation, $publication)['state'] !== 'available') {
|
||||
return false;
|
||||
}
|
||||
$cycle = $operation['cycle'] ?? 0;
|
||||
if (! is_int($cycle) || $cycle < 0) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// A new validation must never resurrect the previous public snapshot.
|
||||
return $cycle === 0 || (is_array($publication) && ($publication['offer_cycle'] ?? null) === $cycle
|
||||
&& is_string($operation['activated_hash'] ?? null) && ($publication['editorial_hash'] ?? null) === $operation['activated_hash']);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,250 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Carbon\CarbonImmutable;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Pagination\LengthAwarePaginator;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
use Illuminate\Validation\Rule;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
|
||||
/** Read-only consumer. Effective publication remains unavailable until confidentiality is delivered.
|
||||
* The injected fixture mode is never configurable by HTTP, environment flags or stored content. */
|
||||
final class OfferPublicCatalogue
|
||||
{
|
||||
public const CONTRACT = 'offer-public-projection-v1';
|
||||
|
||||
public function __construct(private bool $syntheticFixtureMode = false) {}
|
||||
|
||||
private function fixtureReadAllowed(): bool
|
||||
{
|
||||
return $this->syntheticFixtureMode && IsolatedQaDatabase::allowsSchemaChanges();
|
||||
}
|
||||
|
||||
/** Exact ordering of decimal strings, without currency conversion or floating point.
|
||||
* @param string $a @param string $b */
|
||||
public static function comparePrice(string $a, string $b): int
|
||||
{
|
||||
$parts = static function (string $value): array {
|
||||
[$whole, $fraction] = [...explode('.', $value), ''];
|
||||
|
||||
return [ltrim($whole, '0') ?: '0', str_pad($fraction, 2, '0')];
|
||||
};
|
||||
[$aw, $af] = $parts($a);
|
||||
[$bw, $bf] = $parts($b);
|
||||
|
||||
return (strlen($aw) <=> strlen($bw)) ?: (strcmp($aw, $bw) <=> 0) ?: (strcmp($af, $bf) <=> 0);
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function filters(Request $request): array
|
||||
{
|
||||
$filters = array_intersect_key(app(InvestmentCatalogue::class)->filters($request, true), array_flip([
|
||||
'q', 'category', 'province_id', 'district_id', 'currency', 'min_amount', 'max_amount', 'sort', 'view', 'page', 'per_page',
|
||||
]));
|
||||
$extra = $request->validate(['price_mode' => 'nullable|in:amount,negotiable']);
|
||||
$filters = [...$filters, ...$extra];
|
||||
if (isset($filters['min_amount'], $filters['max_amount']) && self::comparePrice($filters['min_amount'], $filters['max_amount']) > 0) {
|
||||
throw ValidationException::withMessages(['max_amount' => 'O preço máximo deve ser igual ou superior ao mínimo.']);
|
||||
}
|
||||
if (in_array($filters['sort'] ?? '', ['amount_asc', 'amount_desc'], true) && empty($filters['currency'])) {
|
||||
throw ValidationException::withMessages(['currency' => 'Seleccione uma moeda para ordenar por preço.']);
|
||||
}
|
||||
if (($filters['price_mode'] ?? '') === 'negotiable' && (isset($filters['min_amount']) || isset($filters['max_amount']))) {
|
||||
throw ValidationException::withMessages(['price_mode' => 'Retire o intervalo de montantes para procurar preços a negociar.']);
|
||||
}
|
||||
if (($filters['price_mode'] ?? '') === 'negotiable' && ! empty($filters['currency'])) {
|
||||
throw ValidationException::withMessages(['currency' => 'A moeda de um preço a negociar não foi indicada. Retire este filtro.']);
|
||||
}
|
||||
|
||||
return $filters;
|
||||
}
|
||||
|
||||
/** The explicit public snapshot, never a projection of current private columns.
|
||||
* @return array<string,mixed>|null */
|
||||
private function project(int $id, mixed $publication): ?array
|
||||
{
|
||||
if (! is_array($publication) || ($publication['contract'] ?? null) !== self::CONTRACT || ($publication['qa_fixture'] ?? false) !== true) {
|
||||
return null;
|
||||
}
|
||||
$v = Validator::make($publication, [
|
||||
'payload' => 'required|array:title,summary,category,province_id,district_id,price_mode,amount,currency',
|
||||
'payload.title' => 'required|string|max:150', 'payload.summary' => 'required|string|max:1500',
|
||||
'payload.category' => ['required', Rule::in(OpportunityManagement::CATEGORIES)],
|
||||
'payload.province_id' => 'nullable|uuid', 'payload.district_id' => 'nullable|uuid',
|
||||
'payload.price_mode' => 'required|in:amount,negotiable',
|
||||
'payload.amount' => ['nullable', 'string', 'required_if:payload.price_mode,amount', 'prohibited_unless:payload.price_mode,amount', 'regex:/^\d{1,16}(\.\d{1,2})?$/'],
|
||||
'payload.currency' => 'nullable|required_if:payload.price_mode,amount|prohibited_unless:payload.price_mode,amount|in:MZN,USD',
|
||||
'approval.state' => 'required|in:approved', 'approval.hash' => 'required|string|size:64', 'approval.actor_id' => 'required|integer|min:1',
|
||||
'approval.at' => 'required|date', 'publication.state' => 'required|in:published', 'publication.hash' => 'required|string|size:64',
|
||||
'publication.actor_id' => 'required|integer|min:1|different:approval.actor_id', 'publication.at' => 'required|date|after_or_equal:approval.at|before_or_equal:now',
|
||||
'revision' => 'required|integer|min:1',
|
||||
]);
|
||||
if ($v->fails()) {
|
||||
return null;
|
||||
}
|
||||
$p = $v->validated()['payload'];
|
||||
$hash = self::projectionHash($p);
|
||||
if (! hash_equals($hash, $publication['approval']['hash']) || ! hash_equals($hash, $publication['publication']['hash'])) {
|
||||
return null;
|
||||
}
|
||||
try {
|
||||
$path = app(InvestmentGeography::class)->selection(['province_id' => $p['province_id'] ?? null, 'district_id' => $p['district_id'] ?? null]);
|
||||
} catch (ValidationException $error) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return ['id' => $id, 'title' => $p['title'], 'summary' => $p['summary'], 'category' => $p['category'],
|
||||
'location' => array_map(fn ($node) => ['id' => $node->id, 'name' => $node->name, 'level' => $node->location_type], $path),
|
||||
'price' => ['mode' => $p['price_mode'], 'amount' => $p['amount'] ?? null, 'currency' => $p['currency'] ?? null],
|
||||
'status' => 'published', 'published_at' => CarbonImmutable::parse($publication['publication']['at'])->utc()->toIso8601String(), 'revision' => $publication['revision'], 'url' => '/ofertas/'.$id];
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $payload */
|
||||
public static function projectionHash(array $payload): string
|
||||
{
|
||||
ksort($payload);
|
||||
|
||||
return hash('sha256', json_encode(['contract' => self::CONTRACT, 'payload' => $payload], JSON_THROW_ON_ERROR));
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $filters
|
||||
* @return array{records:list<array<string,mixed>>,truncated:bool} */
|
||||
public function records(array $filters = []): array
|
||||
{
|
||||
if (! $this->fixtureReadAllowed()) {
|
||||
return ['records' => [], 'truncated' => false];
|
||||
}
|
||||
$rows = Opportunity::query()->whereNotNull('workflow_context->private_offer_preparation')->whereNotNull('workflow_context->offer_publication')
|
||||
->orderBy('id')->limit(1001)->get(['id', DB::raw("workflow_context->'offer_publication' AS public_snapshot"), DB::raw("workflow_context->'offer_operation' AS operation_state")]);
|
||||
$records = [];
|
||||
foreach ($rows->take(1000) as $row) {
|
||||
if (! is_string($row->getAttribute('public_snapshot'))) {
|
||||
continue;
|
||||
}
|
||||
try {
|
||||
$publication = json_decode($row->getAttribute('public_snapshot'), true, 512, JSON_THROW_ON_ERROR);
|
||||
$operation = json_decode($row->getAttribute('operation_state') ?? 'null', true, 512, JSON_THROW_ON_ERROR);
|
||||
} catch (\JsonException $error) {
|
||||
continue;
|
||||
}
|
||||
if (! app(OfferAvailability::class)->publicAllowed($operation, $publication)) {
|
||||
continue;
|
||||
}
|
||||
$p = $this->project($row->id, $publication);
|
||||
if (! $p) {
|
||||
continue;
|
||||
}
|
||||
$expires = app(OfferAvailability::class)->view($operation, $publication)['expires_at'];
|
||||
if ($expires !== null) {
|
||||
$p['expires_at'] = $expires;
|
||||
}
|
||||
if (! empty($filters['q']) && ! str_contains(mb_strtolower($p['title'].' '.$p['summary']), mb_strtolower($filters['q']))) {
|
||||
continue;
|
||||
}
|
||||
if (! empty($filters['category']) && $p['category'] !== $filters['category']) {
|
||||
continue;
|
||||
}
|
||||
if (! empty($filters['province_id']) && ($p['location'][0]['id'] ?? null) !== $filters['province_id']) {
|
||||
continue;
|
||||
}
|
||||
if (! empty($filters['district_id']) && ($p['location'][1]['id'] ?? null) !== $filters['district_id']) {
|
||||
continue;
|
||||
}
|
||||
if (! empty($filters['price_mode']) && $p['price']['mode'] !== $filters['price_mode']) {
|
||||
continue;
|
||||
}
|
||||
if (! empty($filters['currency']) && $p['price']['currency'] !== $filters['currency']) {
|
||||
continue;
|
||||
}
|
||||
if (isset($filters['min_amount']) && ($p['price']['amount'] === null || self::comparePrice($p['price']['amount'], $filters['min_amount']) < 0)) {
|
||||
continue;
|
||||
}
|
||||
if (isset($filters['max_amount']) && ($p['price']['amount'] === null || self::comparePrice($p['price']['amount'], $filters['max_amount']) > 0)) {
|
||||
continue;
|
||||
}
|
||||
$records[] = $p;
|
||||
}
|
||||
$sort = $filters['sort'] ?? 'recent';
|
||||
usort($records, static function ($a, $b) use ($sort): int {
|
||||
if ($sort === 'title') {
|
||||
return strnatcasecmp($a['title'], $b['title']) ?: ($a['id'] <=> $b['id']);
|
||||
}
|
||||
if (in_array($sort, ['amount_asc', 'amount_desc'], true)) {
|
||||
if ($a['price']['amount'] === null || $b['price']['amount'] === null) {
|
||||
return ($a['price']['amount'] === null) <=> ($b['price']['amount'] === null);
|
||||
}
|
||||
|
||||
return self::comparePrice($a['price']['amount'], $b['price']['amount']) * ($sort === 'amount_desc' ? -1 : 1) ?: ($a['id'] <=> $b['id']);
|
||||
}
|
||||
|
||||
return strcmp($b['published_at'], $a['published_at']) ?: ($b['id'] <=> $a['id']);
|
||||
});
|
||||
|
||||
return ['records' => $records, 'truncated' => $rows->count() > 1000];
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function detail(int $id): array
|
||||
{
|
||||
abort_unless($this->fixtureReadAllowed(), 404);
|
||||
$row = Opportunity::query()->whereKey($id)->whereNotNull('workflow_context->private_offer_preparation')->first(['id', DB::raw("workflow_context->'offer_publication' AS public_snapshot"), DB::raw("workflow_context->'offer_operation' AS operation_state")]);
|
||||
if (! $row || ! is_string($row->getAttribute('public_snapshot'))) {
|
||||
abort(404);
|
||||
}
|
||||
try {
|
||||
$publication = json_decode($row->getAttribute('public_snapshot'), true, 512, JSON_THROW_ON_ERROR);
|
||||
$operation = json_decode($row->getAttribute('operation_state') ?? 'null', true, 512, JSON_THROW_ON_ERROR);
|
||||
} catch (\JsonException $error) {
|
||||
abort(404);
|
||||
}
|
||||
abort_unless(app(OfferAvailability::class)->publicAllowed($operation, $publication), 404);
|
||||
$record = $this->project($id, $publication);
|
||||
abort_unless($record !== null, 404);
|
||||
$expires = app(OfferAvailability::class)->view($operation, $publication)['expires_at'];
|
||||
if ($expires !== null) {
|
||||
$record['expires_at'] = $expires;
|
||||
}
|
||||
|
||||
return $record;
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $filters
|
||||
* @return array{results:LengthAwarePaginator<int,array<string,mixed>>,truncated:bool} */
|
||||
public function page(Request $request, array $filters): array
|
||||
{
|
||||
$result = $this->records($filters);
|
||||
$size = (int) ($filters['per_page'] ?? 12);
|
||||
$page = (int) ($filters['page'] ?? 1);
|
||||
|
||||
return ['results' => new LengthAwarePaginator(array_slice($result['records'], ($page - 1) * $size, $size), count($result['records']), $size, $page,
|
||||
['path' => $request->url(), 'query' => $filters]), 'truncated' => $result['truncated']];
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $filters
|
||||
* @return array<string,mixed> */
|
||||
public function map(array $filters): array
|
||||
{
|
||||
$result = $this->records($filters);
|
||||
$areas = [];
|
||||
$seen = [];
|
||||
foreach ($result['records'] as $record) {
|
||||
$id = $record['location'][array_key_last($record['location'])]['id'] ?? null;
|
||||
if (! $id || isset($seen[$id])) {
|
||||
continue;
|
||||
}
|
||||
$seen[$id] = true;
|
||||
$areas = [...$areas, ...app(TerritoryGeometry::class)->context($id)['areas']];
|
||||
if (count($seen) >= 30) {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return ['features' => [], 'areas' => $areas, 'matched_count' => count($result['records']), 'exact_locations_disclosed' => false,
|
||||
'truncated' => $result['truncated'] || count($seen) >= 30];
|
||||
}
|
||||
}
|
||||
@@ -279,14 +279,7 @@ class OpportunityCanonicalContract
|
||||
'economic_activity_id', 'Sector, subsector e atividade devem corresponder à hierarquia/versão publicada; os cinco níveis originais são conservados.');
|
||||
foreach (['internal_contact_id', 'public_contact_id'] as $field) {
|
||||
if (! empty($payload[$field])) {
|
||||
$contacts = DB::table('contacts')->where('contacts.id', $payload[$field])->whereNull('contacts.deleted_at');
|
||||
if ($record->organization_id) {
|
||||
$contacts->whereExists(fn ($q) => $q->selectRaw('1')->from('investor_contacts as ic')->join('investors as i', 'i.id', '=', 'ic.investor_id')
|
||||
->whereColumn('ic.contact_id', 'contacts.id')->where('i.organization_id', $record->organization_id)->whereNull('i.deleted_at'));
|
||||
} else {
|
||||
$contacts->where('source_system', 'portal-user-contact')->where('external_id', 'user:'.$record->owner_user_id);
|
||||
}
|
||||
$check($contacts->exists(), $field, 'Contacto inexistente ou sem relação com o Promotor.');
|
||||
$check(app(OpportunityContacts::class)->related($record, $payload[$field]), $field, 'Contacto inexistente ou sem relação com o Promotor.');
|
||||
}
|
||||
}
|
||||
$resources = [];
|
||||
@@ -308,6 +301,9 @@ class OpportunityCanonicalContract
|
||||
app(OpportunityLibrarySupport::class)->assertAvailable($row, $file);
|
||||
app(VerifiedDocumentBinary::class)->respond($file);
|
||||
$row->sha256 = trim($file->sha256);
|
||||
if (data_get($record->workflow_context, 'editorial_version_binding') === 'phase1-exact-v1') {
|
||||
$row->file_version_no = (int) $file->version_no;
|
||||
}
|
||||
}
|
||||
} else {
|
||||
$location = $row->payload;
|
||||
|
||||
@@ -14,6 +14,19 @@ use Illuminate\Validation\ValidationException;
|
||||
/** Reuse the CRM master without manufacturing an interest, lead or consent. */
|
||||
class OpportunityContacts
|
||||
{
|
||||
public function related(Opportunity $record, string $id): bool
|
||||
{
|
||||
$contacts = DB::table('contacts')->where('contacts.id', $id)->whereNull('contacts.deleted_at');
|
||||
if ($record->organization_id) {
|
||||
$contacts->whereExists(fn ($q) => $q->selectRaw('1')->from('investor_contacts as ic')->join('investors as i', 'i.id', '=', 'ic.investor_id')
|
||||
->whereColumn('ic.contact_id', 'contacts.id')->where('i.organization_id', $record->organization_id)->whereNull('i.deleted_at'));
|
||||
} else {
|
||||
$contacts->where('source_system', 'portal-user-contact')->where('external_id', 'user:'.$record->owner_user_id);
|
||||
}
|
||||
|
||||
return $contacts->exists();
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<array-key, mixed> $input
|
||||
* @return array<array-key, mixed>
|
||||
|
||||
@@ -45,6 +45,7 @@ class OpportunityLibrarySupport
|
||||
*/
|
||||
public function attach(User $actor, Opportunity $opportunity, array $input): \stdClass
|
||||
{
|
||||
abort_if($opportunity->isPrivateOfferPreparation(), 422, 'Os comprovativos de Ofertas usam originais reservados à validação interna.');
|
||||
app(PortalProfileAccess::class)->authorize($actor, 'edit', $opportunity);
|
||||
$data = Validator::make($input, ['resource_id' => 'required|integer|min:1', 'creation_key' => 'required|uuid', 'etag' => 'required|string|size:64', 'reason' => 'required|string|min:20|max:1000', 'section' => 'nullable|string|max:255', 'supported_statement' => 'nullable|string|max:2000'])->validate();
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ class OpportunityManagement
|
||||
|
||||
public const MATURITY_FIELDS = ['maturity_level', 'maturity_label', 'maturity_stage', 'maturity_catalogue_version'];
|
||||
|
||||
public const PRIVATE_DRAFT_FIELDS = [...self::MATURITY_FIELDS, 'real_estate', 'canonical', 'proactive'];
|
||||
public const PRIVATE_DRAFT_FIELDS = [...self::MATURITY_FIELDS, 'real_estate', 'canonical', 'proactive', 'private_offer'];
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function values(Opportunity $record): array
|
||||
@@ -51,12 +51,13 @@ class OpportunityManagement
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input */
|
||||
public function save(User $actor, array $input, ?int $id = null): Opportunity
|
||||
public function save(User $actor, array $input, ?int $id = null, bool $privateOffer = false): Opportunity
|
||||
{
|
||||
$access = app(PortalProfileAccess::class);
|
||||
$profileCreation = $id === null && str_starts_with(request()->path(), 'minhas-oportunidades');
|
||||
if ($id !== null) {
|
||||
$existingRecord = Opportunity::withTrashed()->findOrFail($id);
|
||||
abort_if($existingRecord->isPrivateOfferPreparation() && ! $privateOffer, 403, 'Use a preparação privada da oferta.');
|
||||
$access->authorize($actor, 'edit', $existingRecord);
|
||||
if ($existingRecord->owner_user_id !== null) {
|
||||
abort_unless($access->canEdit($actor, $existingRecord, $input['opportunity_category'] ?? null), 403);
|
||||
@@ -100,6 +101,9 @@ class OpportunityManagement
|
||||
'owner_user_id' => 'prohibited', 'workflow_context' => 'prohibited', 'status' => 'prohibited', 'first_submitted_at' => 'prohibited',
|
||||
'province_id' => ['nullable', 'uuid'], 'district_id' => ['nullable', 'uuid'], 'admin_post_id' => ['nullable', 'uuid'], 'locality_id' => ['nullable', 'uuid'],
|
||||
])->validate();
|
||||
if ($privateOffer && ($id === null || array_key_exists('private_offer', $input))) {
|
||||
$data['private_offer'] = app(PrivateOfferPreparation::class)->validate($input['private_offer'] ?? []);
|
||||
}
|
||||
$data = app(OpportunityMaturity::class)->normalize($data);
|
||||
if (array_key_exists('real_estate', $data)) {
|
||||
$data['real_estate'] = app(OpportunityRealEstateDraft::class)->validate($data['real_estate']);
|
||||
@@ -108,10 +112,11 @@ class OpportunityManagement
|
||||
$data['canonical'] = app(OpportunityCanonicalContract::class)->draft($data['canonical']);
|
||||
}
|
||||
|
||||
return DB::transaction(function () use ($actor, $data, $id, $profileCreation, $access) {
|
||||
return DB::transaction(function () use ($actor, $data, $id, $profileCreation, $access, $privateOffer) {
|
||||
DB::select('SELECT pg_advisory_xact_lock(91026, 100000)');
|
||||
if (! $id && ($existing = Opportunity::withTrashed()->where('management_creation_key', $data['creation_key'])->first())) {
|
||||
$access->authorize($actor, 'view', $existing);
|
||||
abort_unless($existing->isPrivateOfferPreparation() === $privateOffer, 409);
|
||||
abort_unless($profileCreation === ($existing->owner_user_id !== null) && (! $profileCreation || $existing->organization_id === ($data['organization_id'] ?? null)), 409);
|
||||
$snapshot = $this->values($existing);
|
||||
foreach (array_intersect_key($data, array_flip([...self::FIELDS, ...self::PRIVATE_DRAFT_FIELDS])) as $key => $value) {
|
||||
@@ -124,6 +129,7 @@ class OpportunityManagement
|
||||
}
|
||||
$record = $id ? Opportunity::withTrashed()->whereKey($id)->lockForUpdate()->firstOrFail() : new Opportunity;
|
||||
if ($id) {
|
||||
abort_unless($record->isPrivateOfferPreparation() === $privateOffer, 409);
|
||||
$access->authorize($actor, 'edit', $record);
|
||||
$this->check($record, $data['etag']);
|
||||
abort_if($record->trashed() || $record->status === 'archived', 409, 'Restaure antes de editar.');
|
||||
@@ -189,14 +195,20 @@ class OpportunityManagement
|
||||
$record->management_closed_once = true;
|
||||
$previous = $record->management_draft ? json_decode($record->management_draft, true) : $record->only(self::FIELDS);
|
||||
$record->management_draft = json_encode([...$previous, ...$changes], JSON_THROW_ON_ERROR);
|
||||
if ($privateOffer) {
|
||||
// All columns of an Offer remain private; keep scope/category and location current.
|
||||
foreach (array_intersect_key($changes, array_flip(self::FIELDS)) as $field => $value) {
|
||||
$record->{$field} = $value;
|
||||
}
|
||||
}
|
||||
} else {
|
||||
foreach ($changes as $key => $value) {
|
||||
if (in_array($key, ['real_estate', 'canonical', 'proactive', 'maturity_stage', 'maturity_catalogue_version'], true) || (($changes['maturity_catalogue_version'] ?? null) === OpportunityMaturity::VERSION && in_array($key, ['maturity_level', 'maturity_label'], true))) {
|
||||
if (in_array($key, ['real_estate', 'canonical', 'proactive', 'private_offer', 'maturity_stage', 'maturity_catalogue_version'], true) || (($changes['maturity_catalogue_version'] ?? null) === OpportunityMaturity::VERSION && in_array($key, ['maturity_level', 'maturity_label'], true))) {
|
||||
continue;
|
||||
}
|
||||
$record->{$key} = $value;
|
||||
}
|
||||
if (isset($changes['maturity_catalogue_version']) || array_key_exists('real_estate', $changes) || array_key_exists('canonical', $changes) || array_key_exists('proactive', $changes)) {
|
||||
if (isset($changes['maturity_catalogue_version']) || array_key_exists('real_estate', $changes) || array_key_exists('canonical', $changes) || array_key_exists('proactive', $changes) || array_key_exists('private_offer', $changes)) {
|
||||
// The existing draft JSON holds the versioned catalogue; legacy columns stay intact.
|
||||
$previous = $record->management_draft ? json_decode($record->management_draft, true, 512, JSON_THROW_ON_ERROR) : [];
|
||||
$record->management_draft = json_encode([...$previous, ...array_intersect_key($changes, array_flip(self::PRIVATE_DRAFT_FIELDS))], JSON_THROW_ON_ERROR);
|
||||
@@ -204,6 +216,9 @@ class OpportunityManagement
|
||||
}
|
||||
if ($record->owner_user_id !== null) {
|
||||
$context = $record->workflow_context ?? [];
|
||||
if ($privateOffer) {
|
||||
$context['private_offer_preparation'] ??= ['version' => 1, 'state' => 'draft'];
|
||||
}
|
||||
unset($context['approval']);
|
||||
$context['content_revision'] = ($context['content_revision'] ?? 0) + 1;
|
||||
$context['contributors'] = array_values(array_unique([...($context['contributors'] ?? []), $actor->id]));
|
||||
|
||||
@@ -4,6 +4,7 @@ namespace App\Services;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Models\User;
|
||||
use Illuminate\Support\Facades\Crypt;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
use Illuminate\Support\Str;
|
||||
@@ -27,6 +28,9 @@ class OpportunityProfileWorkflow
|
||||
if ($record->owner_user_id === null || ! $this->access->canView($actor, $record)) {
|
||||
return [];
|
||||
}
|
||||
if ($record->isPrivateOfferPreparation()) {
|
||||
return $this->offerActions($actor, $record);
|
||||
}
|
||||
$actions = [];
|
||||
$state = $this->access->state($record);
|
||||
if ($this->access->promoterRecordScope($actor, $record)
|
||||
@@ -99,6 +103,44 @@ class OpportunityProfileWorkflow
|
||||
return $actions;
|
||||
}
|
||||
|
||||
/** Existing roles and transition engine, bounded to the private offer contract.
|
||||
* @return list<string> */
|
||||
private function offerActions(User $actor, Opportunity $record): array
|
||||
{
|
||||
if (! app(PortalEditorialWorkflow::class)->available()) {
|
||||
return [];
|
||||
}
|
||||
$state = $this->access->state($record);
|
||||
$actions = [];
|
||||
if ($this->access->promoterRecordScope($actor, $record) && $this->access->operational($actor, 'edit', $record->id)) {
|
||||
if (in_array($state, ['draft', 'needs_information'], true)) {
|
||||
$actions[] = 'submit';
|
||||
}
|
||||
if (in_array($state, ['rejected', 'approved'], true) || (isset($record->workflow_context['submission']) && ($record->workflow_context['offer_operation']['status'] ?? null) === 'revalidation'
|
||||
&& ($record->workflow_context['offer_operation']['requested_by'] ?? null) === $actor->id && (int) $record->owner_user_id === $actor->id
|
||||
&& in_array($state, ['draft', 'needs_information', 'submitted', 'in_review', 'information_pending'], true))) {
|
||||
$actions[] = 'request_revision';
|
||||
}
|
||||
}
|
||||
if ($this->access->scoped($actor, 'validator', $record->organization_id, $record->opportunity_category)
|
||||
&& $this->access->operational($actor, 'validate', $record->id) && ! $this->access->conflict($actor, $record)) {
|
||||
if (in_array($state, ['submitted', 'in_review'], true) && $this->responsibility($actor, $record, 'validation_coordinator')) {
|
||||
$actions[] = 'assign_review';
|
||||
}
|
||||
$assigned = data_get($record->workflow_context, 'assignment.assignee_user_id');
|
||||
if ($assigned === null || (int) $assigned === $actor->id) {
|
||||
if ($state === 'submitted') {
|
||||
$actions[] = 'start_review';
|
||||
}
|
||||
if ($state === 'in_review') {
|
||||
array_push($actions, 'request_correction', 'reject', 'approve');
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return $actions;
|
||||
}
|
||||
|
||||
public function reauthenticationRequired(User $actor, Opportunity $record): bool
|
||||
{
|
||||
return ! $this->access->mfa($actor)
|
||||
@@ -178,6 +220,12 @@ class OpportunityProfileWorkflow
|
||||
abort_unless(hash_equals($this->management->etag($record), $data['etag']), 409, 'Versão alterada.');
|
||||
$this->authorizeAction($actor, $record, $action);
|
||||
$context = $record->workflow_context ?? [];
|
||||
$offer = $record->isPrivateOfferPreparation();
|
||||
if ($action === 'submit' && app(PortalEditorialWorkflow::class)->available()) {
|
||||
$context['editorial_version_binding'] = 'phase1-exact-v1';
|
||||
$record->workflow_context = $context;
|
||||
}
|
||||
$strictEditorial = ($context['editorial_version_binding'] ?? null) === 'phase1-exact-v1';
|
||||
$state = $this->access->state($record);
|
||||
$before = ['status' => $state, 'publication_status' => $record->status, 'version' => $record->management_version];
|
||||
$from = match ($action) {
|
||||
@@ -186,7 +234,8 @@ class OpportunityProfileWorkflow
|
||||
'review_gate' => ['submitted', 'in_review', 'information_pending', 'approved'],
|
||||
'publish' => ['approved'], 'suspend' => [$state],
|
||||
'assign_publication' => ['approved'],
|
||||
'request_revision' => ['approved', 'published', 'suspended'],
|
||||
'request_revision' => $offer ? (($context['offer_operation']['status'] ?? null) === 'revalidation'
|
||||
? ['draft', 'needs_information', 'submitted', 'in_review', 'information_pending', 'approved', 'rejected'] : ['approved', 'rejected']) : ['approved', 'published', 'suspended'],
|
||||
'archive' => ['draft', 'submitted', 'in_review', 'information_pending', 'needs_information', 'approved', 'rejected', 'published', 'suspended'],
|
||||
'request_archive' => ['draft', 'submitted', 'in_review', 'information_pending', 'needs_information', 'approved', 'published', 'suspended'],
|
||||
'appeal', 'appeal_uphold', 'appeal_reopen' => ['rejected'],
|
||||
@@ -200,11 +249,35 @@ class OpportunityProfileWorkflow
|
||||
}
|
||||
$next = $state;
|
||||
$snapshot = [];
|
||||
if ($action === 'submit' && $record->opportunity_category === 'land_rights') {
|
||||
if ($offer) {
|
||||
$snapshot = in_array($action, ['request_revision', 'request_correction'], true)
|
||||
? ($context['submission'] ?? []) : app(PrivateOfferPreparation::class)->snapshot($record);
|
||||
// Explicit first review of an immutable phase-1 submission; no writes on read.
|
||||
if (in_array($action, ['start_review', 'assign_review'], true) && empty($context['submission'])) {
|
||||
abort_unless(($context['private_offer_preparation']['version'] ?? null) === 1
|
||||
&& $record->management_version === (int) ($context['private_offer_preparation']['submitted_revision'] ?? -2) + 1, 409, 'Reconcilie a submissão privada anterior.');
|
||||
$snapshot['record_version'] = $context['private_offer_preparation']['submitted_revision'];
|
||||
$context['submission'] = [...$snapshot, 'actor_id' => $context['private_offer_preparation']['submitted_by'], 'at' => $context['private_offer_preparation']['submitted_at']];
|
||||
$context['phase1_binding'] = ['bound_at' => $decision['at'], 'bound_by' => $actor->id, 'hash' => $snapshot['hash'], 'original_reference_fingerprint' => 'not_recorded'];
|
||||
$context['review_cycle'] = 1;
|
||||
$decision['review_cycle'] = 1;
|
||||
$context['phase1_submission'] = $context['private_offer_preparation'];
|
||||
$record->first_submitted_at ??= $context['private_offer_preparation']['submitted_at'];
|
||||
$record->management_closed_once = true;
|
||||
}
|
||||
if ($action !== 'submit') {
|
||||
abort_unless(hash_equals($context['submission']['hash'] ?? '', $snapshot['hash']), 409, 'A oferta ou as referências mudaram; prepare nova revisão antes da decisão.');
|
||||
}
|
||||
$decision['hash'] = $snapshot['hash'];
|
||||
$decision['opportunity_version'] = $record->management_version;
|
||||
$decision['submitted_revision'] = $action === 'submit' ? $snapshot['record_version'] : ($context['submission']['record_version'] ?? $record->management_version);
|
||||
$record->workflow_context = $context;
|
||||
}
|
||||
if (! $offer && $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)) {
|
||||
if (! $offer && in_array($action, ['submit', 'review_gate', 'pending_opinion', 'respond_opinion', 'approve', 'publish'], true)) {
|
||||
$blockers = $this->contract->deliveryBlockers($this->management->values($record)['canonical'] ?? []);
|
||||
try {
|
||||
$snapshot = $this->contract->validateSubmission($record);
|
||||
@@ -223,6 +296,12 @@ class OpportunityProfileWorkflow
|
||||
}
|
||||
}
|
||||
if ($action === 'submit') {
|
||||
if ($offer && isset($context['submission'])) {
|
||||
$context['submission_history'][] = ['submission' => $context['submission'], 'approval' => $context['approval'] ?? null, 'rejection' => $context['rejection'] ?? null];
|
||||
}
|
||||
if ($offer) {
|
||||
unset($context['rejection'], $context['correction_items']);
|
||||
}
|
||||
// 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;
|
||||
@@ -234,7 +313,7 @@ class OpportunityProfileWorkflow
|
||||
}
|
||||
}
|
||||
$baseline = $context['review_baseline'] ?? $context['submission'] ?? [];
|
||||
$materiality = app(OpportunityReviewMateriality::class)->reconcile($baseline, $snapshot, $context['reviews'] ?? [], $this->contract->gates($record), ! empty($context['force_review']));
|
||||
$materiality = app(OpportunityReviewMateriality::class)->reconcile($baseline, $snapshot, $context['reviews'] ?? [], $offer ? [] : $this->contract->gates($record), ! empty($context['force_review']), $strictEditorial);
|
||||
$context['materiality'] = array_diff_key($materiality, ['reviews' => true]);
|
||||
$context['reviews'] = $materiality['reviews'];
|
||||
app(OpportunityReviewConditions::class)->reconcile($context, $snapshot, $materiality['reopened']);
|
||||
@@ -265,6 +344,11 @@ class OpportunityProfileWorkflow
|
||||
}
|
||||
$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);
|
||||
if ($offer) {
|
||||
$decision['previous_assignee_user_id'] = $context['assignment']['assignee_user_id'] ?? null;
|
||||
$decision['assignee_user_id'] = $subject->id;
|
||||
$context['assignment_history'][] = $decision;
|
||||
}
|
||||
$context['assignment'] = [...$decision, 'assignee_user_id' => $subject->id];
|
||||
$next = 'in_review';
|
||||
} elseif ($action === 'review_gate') {
|
||||
@@ -287,19 +371,24 @@ class OpportunityProfileWorkflow
|
||||
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) {
|
||||
foreach ($offer ? [] : $this->contract->gates($record) as $gate) {
|
||||
$review = $context['reviews'][$gate] ?? [];
|
||||
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.');
|
||||
abort_unless(app(OpportunityReviewMateriality::class)->matches($snapshot, $gate, $review, $strictEditorial), 409, 'Âmbito ou versão 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)
|
||||
&& $this->responsibility($reviewer, $record, preg_match('/legal|registry|authority|confidentiality|license/', $gate) === 1 ? 'legal_reviewer' : 'technical_reviewer'), 403, 'Revisor revogado, sem responsabilidade ou com conflito.');
|
||||
}
|
||||
$context['approval'] = [...$decision, 'hash' => $snapshot['hash'], 'gates' => $context['reviews'] ?? []];
|
||||
if ($offer) {
|
||||
$context['offer_operation'] = app(PrivateOfferOperations::class)->afterApproval($context);
|
||||
}
|
||||
$this->tasks->complete($context['review_task_id'] ?? null, $data['reason']);
|
||||
$record->workflow_context = $context;
|
||||
$context['publication_task_id'] = $this->tasks->ensure($record, 'opportunity_publication', 'Preparação editorial '.$record->reference);
|
||||
if (! $offer) {
|
||||
$context['publication_task_id'] = $this->tasks->ensure($record, 'opportunity_publication', 'Preparação editorial '.$record->reference);
|
||||
}
|
||||
$next = 'approved';
|
||||
} elseif ($action === 'assign_publication') {
|
||||
$subject = User::whereKey($data['assignee_user_id'] ?? 0)->firstOrFail();
|
||||
@@ -316,6 +405,7 @@ class OpportunityProfileWorkflow
|
||||
foreach ($this->contract->gates($record) as $gate) {
|
||||
$review = $context['approval']['gates'][$gate] ?? [];
|
||||
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.');
|
||||
abort_unless(app(OpportunityReviewMateriality::class)->matches($snapshot, $gate, $review, $strictEditorial), 409, 'Âmbito ou versão jurídica alterados após a aprovação.');
|
||||
$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)
|
||||
@@ -408,6 +498,9 @@ class OpportunityProfileWorkflow
|
||||
$next = count(array_filter($context['opinions'], fn ($o) => ($o['hash'] ?? '') === $snapshot['hash'] && ($o['status'] ?? '') === 'pending')) > 0 ? 'information_pending' : 'in_review';
|
||||
} elseif ($action === 'request_correction') {
|
||||
abort_unless($data['correction_items'] ?? [], 422, 'Indique campos e documentos a corrigir.');
|
||||
if ($offer) {
|
||||
abort_if(array_diff($data['correction_items'], ['title', 'description', 'opportunity_category', 'private_offer', 'contact', 'location']) !== [], 422, 'Seleccione campos desta oferta.');
|
||||
}
|
||||
$this->tasks->complete($context['review_task_id'] ?? null, $data['reason']);
|
||||
$context['correction_items'] = $data['correction_items'];
|
||||
$context['correction_cycles'] = ($context['correction_cycles'] ?? 0) + 1;
|
||||
@@ -417,7 +510,7 @@ class OpportunityProfileWorkflow
|
||||
} elseif ($action === 'request_revision' || $action === 'appeal_reopen') {
|
||||
$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];
|
||||
$context['decision_history'][] = ['approval' => $context['approval'] ?? null, 'reviews' => $context['reviews'] ?? null, 'submission' => $context['submission'] ?? null, ...($offer ? ['rejection' => $context['rejection'] ?? null] : [])];
|
||||
$context['review_baseline'] = $context['submission'] ?? [];
|
||||
$context['force_review'] = $action === 'appeal_reopen' || $state === 'suspended';
|
||||
unset($context['approval']);
|
||||
@@ -470,14 +563,27 @@ class OpportunityProfileWorkflow
|
||||
$context['working_state'] = $next;
|
||||
$context['last_decision'] = $decision;
|
||||
$context['events'][] = [...$decision, 'from' => $state, 'to' => $next];
|
||||
if ($record->status !== 'published' || in_array($action, ['suspend', 'archive'], true)) {
|
||||
if ($offer) {
|
||||
$context['private_offer_preparation'] = [...$context['private_offer_preparation'], 'version' => 2, 'state' => $next];
|
||||
if ($action === 'submit') {
|
||||
$context['private_offer_preparation'] = [...$context['private_offer_preparation'], 'submitted_by' => $actor->id,
|
||||
'submitted_at' => $decision['at'], 'submitted_revision' => $snapshot['record_version']];
|
||||
}
|
||||
}
|
||||
if (! $offer && ($record->status !== 'published' || in_array($action, ['suspend', 'archive'], true))) {
|
||||
$record->status = $next;
|
||||
}
|
||||
$record->management_version++;
|
||||
$record->workflow_context = $context;
|
||||
$record->save();
|
||||
app(PortalEditorialWorkflow::class)->notifyOpportunity($actor, $record, $action);
|
||||
$this->access->audit($actor, 'workflow_'.$action, ['record_id' => $record->id, 'before' => $before,
|
||||
'after' => ['status' => $next, 'publication_status' => $record->status, 'version' => $record->management_version], 'reason' => $data['reason']]);
|
||||
'after' => ['status' => $next, 'publication_status' => $record->status, 'version' => $record->management_version], 'reason' => $data['reason'],
|
||||
...($offer ? ['decision' => $decision, 'submission_hash' => $context['submission']['hash'] ?? null,
|
||||
'snapshot' => Crypt::encryptString(json_encode($snapshot, JSON_THROW_ON_ERROR))] : [])]);
|
||||
if ($offer && $action === 'submit') {
|
||||
$this->access->audit($actor, 'private_offer_submitted', ['record_id' => $record->id, 'version' => $record->management_version, 'public' => false]);
|
||||
}
|
||||
|
||||
return $record;
|
||||
});
|
||||
@@ -513,6 +619,9 @@ class OpportunityProfileWorkflow
|
||||
|
||||
private function authorizeAction(User $actor, Opportunity $record, string $action): void
|
||||
{
|
||||
if ($record->isPrivateOfferPreparation()) {
|
||||
abort_unless(in_array($action, $this->actions($actor, $record), true), 403, 'Operação editorial não autorizada para esta oferta privada.');
|
||||
}
|
||||
$this->access->authorize($actor, 'view', $record);
|
||||
$promoter = $this->access->promoterRecordScope($actor, $record)
|
||||
&& ($record->organization_id !== null || (int) $record->owner_user_id === $actor->id);
|
||||
|
||||
@@ -22,7 +22,7 @@ final class OpportunityPromotion
|
||||
public function allowed(User $actor, Opportunity $record): bool
|
||||
{
|
||||
$access = app(PortalProfileAccess::class);
|
||||
if ($record->trashed() || $record->owner_user_id === null || ! $access->canView($actor, $record)
|
||||
if ($record->isPrivateOfferPreparation() || $record->trashed() || $record->owner_user_id === null || ! $access->canView($actor, $record)
|
||||
|| $access->has($actor, 'auditor') || in_array($record->status, ['archived', 'rejected'], true)) {
|
||||
return false;
|
||||
}
|
||||
|
||||
@@ -92,7 +92,7 @@ class OpportunityResources
|
||||
}
|
||||
abort_if(! $id && DB::table($table)->where('id', $resourceId)->exists(), 409, 'Esta criação já foi registada; recupere o recurso existente.');
|
||||
$active = DB::table($table)->where('opportunity_id', $opportunityId)->whereNull('deleted_at');
|
||||
abort_if(! $id && $active->count() >= ($kind === 'locations' ? 50 : ($kind === 'images' ? 20 : 100)), 422, 'Limite de recursos atingido.');
|
||||
abort_if(! $id && $active->count() >= $this->limit($opportunity, $kind), 422, 'Limite de recursos atingido.');
|
||||
if ($kind === 'locations') {
|
||||
$others = (clone $active)->when($id, fn ($q) => $q->where('id', '!=', $id))->get();
|
||||
foreach ($others as $other) {
|
||||
@@ -172,7 +172,7 @@ class OpportunityResources
|
||||
abort_if(($data['action'] === 'delete') === ($record->deleted_at !== null), 409, 'Estado já alterado.');
|
||||
$payload = json_decode($record->payload, true);
|
||||
if ($data['action'] === 'restore') {
|
||||
abort_if(DB::table($table)->where('opportunity_id', $opportunityId)->whereNull('deleted_at')->count() >= ($kind === 'locations' ? 50 : ($kind === 'images' ? 20 : 100)), 422, 'Limite de recursos ativos atingido; reconcilie antes de restaurar.');
|
||||
abort_if(DB::table($table)->where('opportunity_id', $opportunityId)->whereNull('deleted_at')->count() >= $this->limit($opportunity, $kind), 422, 'Limite de recursos ativos atingido; reconcilie antes de restaurar.');
|
||||
$this->validatePayload($kind, $payload, $opportunityId);
|
||||
// Restoration never silently reclaims a primary/cover/order occupied by another resource.
|
||||
if ($kind === 'images') {
|
||||
@@ -221,12 +221,22 @@ class OpportunityResources
|
||||
*/
|
||||
private function validatePayload(string $kind, array $payload, int $opportunityId): array
|
||||
{
|
||||
$offer = Opportunity::findOrFail($opportunityId);
|
||||
if ($offer->isPrivateOfferPreparation()) {
|
||||
Validator::make($payload, ['visibility' => 'required|in:internal',
|
||||
...($kind === 'images' ? ['digitally_edited' => 'required|boolean', 'edit_description' => 'nullable|required_if:digitally_edited,true|string|max:1000'] : []),
|
||||
...($kind === 'documents' ? ['category' => 'required|in:real_estate_proof', 'classification' => 'required|in:restricted'] : [])])->validate();
|
||||
abort_if($kind === 'documents' && $offer->opportunity_category !== 'real_estate', 422, 'Este percurso aceita comprovativos imobiliários.');
|
||||
}
|
||||
$rules = ['title' => 'nullable|string|max:120', 'source_reference' => 'nullable|string|max:2000', 'source_date' => 'nullable|date_format:Y-m-d', 'visibility' => 'nullable|in:internal,authenticated,public'];
|
||||
if ($kind === 'locations') {
|
||||
$rules += ['country_code' => ['nullable', app(CountryCatalogue::class)->rule()]];
|
||||
$rules += ['province_id' => 'nullable|uuid', 'district_id' => 'nullable|uuid', 'admin_post_id' => 'nullable|uuid', 'locality_id' => 'nullable|uuid', 'role' => 'nullable|in:headquarters,production,raw_material,storage,logistics,market,support,other', 'role_description' => 'nullable|string|max:1000', 'operational_unit' => 'nullable|string|max:120', 'is_primary' => 'nullable|boolean', 'address' => 'nullable|string|max:300', 'geometry' => 'nullable|array', 'area_value' => 'nullable|numeric|gt:0', 'area_unit' => ['nullable', Rule::in(self::AREA_UNITS)], 'allocation_percentage' => 'nullable|numeric|between:0,100', 'territorial_purpose' => 'nullable|in:implementation,context,impact,coverage', 'multi_district_rationale' => 'nullable|string|max:1000'];
|
||||
} elseif ($kind === 'images') {
|
||||
$rules += ['role' => 'nullable|in:cover,gallery,location,asset,product,plan,rendering,evidence,other', 'role_description' => 'nullable|string|max:1000', 'is_cover' => 'nullable|boolean', 'caption' => 'nullable|string|max:300', 'alt_text' => 'nullable|string|max:250', 'location_id' => ['nullable', 'uuid', Rule::exists('opportunity_location_drafts', 'id')->where('opportunity_id', $opportunityId)->whereNull('deleted_at')], 'captured_at' => 'nullable|date_format:Y-m-d|before_or_equal:today', 'author_source' => 'nullable|string|max:150', 'rights_status' => 'nullable|in:owned,licensed,authorized,public_domain', 'rights_document_id' => ['nullable', 'uuid', Rule::exists('opportunity_documents', 'id')->where('opportunity_id', $opportunityId)->whereNull('deleted_at')], 'rights_valid_until' => 'nullable|date_format:Y-m-d', 'sort_order' => 'nullable|integer|min:0'];
|
||||
if ($offer->isPrivateOfferPreparation()) {
|
||||
$rules += ['digitally_edited' => 'boolean', 'edit_description' => 'nullable|string|max:1000'];
|
||||
}
|
||||
} else {
|
||||
$rules += ['category' => 'nullable|string|max:100', 'issuer' => 'nullable|string|max:255', 'edition' => 'nullable|string|max:120', 'valid_until' => 'nullable|date_format:Y-m-d', 'classification' => 'nullable|in:public,internal,confidential,restricted', 'section' => 'nullable|string|max:255', 'supported_statement' => 'nullable|string|max:2000'];
|
||||
}
|
||||
@@ -257,6 +267,11 @@ class OpportunityResources
|
||||
return $data;
|
||||
}
|
||||
|
||||
private function limit(Opportunity $record, string $kind): int
|
||||
{
|
||||
return $kind === 'locations' ? 50 : ($kind === 'images' ? ($record->isPrivateOfferPreparation() ? 6 : 20) : 100);
|
||||
}
|
||||
|
||||
/** @return array{string,string} */
|
||||
private function store(string $kind, UploadedFile $file): array
|
||||
{
|
||||
|
||||
@@ -134,8 +134,12 @@ class OpportunityReviewMateriality
|
||||
|
||||
/** @param array<string,mixed> $snapshot
|
||||
* @param array<string,mixed> $review */
|
||||
public function matches(array $snapshot, string $gate, array $review): bool
|
||||
public function matches(array $snapshot, string $gate, array $review, bool $exactLegalVersion = false): bool
|
||||
{
|
||||
if ($exactLegalVersion && preg_match('/legal|registry|authority|confidentiality|license/', $gate) === 1
|
||||
&& ($review['hash'] ?? null) !== ($snapshot['hash'] ?? null)) {
|
||||
return false;
|
||||
}
|
||||
if (! isset($review['scope_hash'])) {
|
||||
return true; // Caller must independently verify the original signed submission hash.
|
||||
}
|
||||
@@ -151,7 +155,7 @@ class OpportunityReviewMateriality
|
||||
* @param array<string,mixed> $reviews
|
||||
* @param list<string> $gates
|
||||
* @return array<string,mixed> */
|
||||
public function reconcile(array $before, array $after, array $reviews, array $gates, bool $force = false): array
|
||||
public function reconcile(array $before, array $after, array $reviews, array $gates, bool $force = false, bool $exactLegalVersion = false): array
|
||||
{
|
||||
$kept = [];
|
||||
$reopened = [];
|
||||
@@ -161,7 +165,8 @@ class OpportunityReviewMateriality
|
||||
// separately validate old scope signatures under their original rule.
|
||||
$priorHash = $this->hash($before, $gate, $review);
|
||||
$currentHash = $this->hash($after, $gate, $review);
|
||||
if (! $force && $before !== [] && ($review['decision'] ?? '') === 'approved' && $this->matches($before, $gate, $review) && hash_equals($priorHash, $currentHash)) {
|
||||
$changedLegalVersion = $exactLegalVersion && preg_match('/legal|registry|authority|confidentiality|license/', $gate) === 1 && ($review['hash'] ?? null) !== ($after['hash'] ?? null);
|
||||
if (! $force && ! $changedLegalVersion && $before !== [] && ($review['decision'] ?? '') === 'approved' && $this->matches($before, $gate, $review) && hash_equals($priorHash, $currentHash)) {
|
||||
$kept[$gate] = [...$review, 'scope_hash' => $priorHash, 'scope_rule' => self::VERSION, 'accepted_submission_hash' => $after['hash'],
|
||||
'carried_forward' => ['rule' => self::VERSION, 'from_scope_hash' => $review['scope_hash'] ?? null, 'from_scope_rule' => $review['scope_rule'] ?? 'legacy_unspecified', 'from_submission_hash' => $before['hash'] ?? null, 'at' => now()->toIso8601String()]];
|
||||
} else {
|
||||
|
||||
@@ -0,0 +1,146 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\User;
|
||||
use Illuminate\Support\Facades\Crypt;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
/** Adapts existing immutable native revisions to the common inbox; never changes a workflow. */
|
||||
final class PortalEditorialNativeNotices
|
||||
{
|
||||
public function available(): bool
|
||||
{
|
||||
return app(PortalEditorialWorkflow::class)->available() && Schema::hasColumn('portal_editorial_notifications', 'native_event_id');
|
||||
}
|
||||
|
||||
public function access(User $actor, string $source): bool
|
||||
{
|
||||
if (! $actor->hasVerifiedEmail() || ! $actor->two_factor_confirmed_at || ! $actor->two_factor_secret
|
||||
|| app(PortalProfileAccess::class)->has($actor, 'auditor')) {
|
||||
return false;
|
||||
}
|
||||
if ($source === 'investment-zones') {
|
||||
return app(InvestmentZoneOperationalProfile::class)->editorialEnabled() && app(InvestmentZoneOperationalProfile::class)->reviewAccess($actor);
|
||||
}
|
||||
if (! $actor->can('manage-portal')) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return match ($source) {
|
||||
'cluster-competitiveness' => app(ClusterCompetitiveness::class)->editorialEnabled(),
|
||||
'territorial-editorial-v1' => app(TerritorialRegistry::class)->editorialAvailable(),
|
||||
default => false,
|
||||
};
|
||||
}
|
||||
|
||||
/** @return array{clusters:int,territories:int,zones:int} */
|
||||
public function pending(User $actor): array
|
||||
{
|
||||
$counts = ['clusters' => 0, 'territories' => 0, 'zones' => 0];
|
||||
if (! $this->available()) {
|
||||
return $counts;
|
||||
}
|
||||
if ($this->access($actor, 'cluster-competitiveness')) {
|
||||
$events = DB::table('audit_events as a')->join('economic_clusters as c', 'c.id', '=', 'a.entity_id')
|
||||
->where('a.source_system', 'cluster-competitiveness')->whereNull('c.deleted_at')
|
||||
->whereNotExists(fn ($q) => $q->selectRaw('1')->from('audit_events as newer')->whereColumn('newer.entity_id', 'a.entity_id')
|
||||
->where('newer.source_system', 'cluster-competitiveness')->whereRaw("(newer.after_data->>'version')::integer > (a.after_data->>'version')::integer"))
|
||||
->select(['a.id', 'a.after_data'])->orderBy('a.id')->cursor();
|
||||
foreach ($events as $event) {
|
||||
$payload = json_decode($event->after_data, true, 512, JSON_THROW_ON_ERROR);
|
||||
$stage = $payload['editorial_state'] ?? null;
|
||||
if ($stage === null) {
|
||||
$state = json_decode(Crypt::decryptString($payload['snapshot']), true, 512, JSON_THROW_ON_ERROR);
|
||||
$stage = $state['workflow']['state'] ?? null;
|
||||
}
|
||||
if ($stage !== null && ! in_array($stage, ['published', 'archived'], true)) {
|
||||
$counts['clusters']++;
|
||||
}
|
||||
}
|
||||
}
|
||||
if ($this->access($actor, 'territorial-editorial-v1')) {
|
||||
$latest = DB::table('audit_events')->where('source_system', 'territorial-editorial-v1')
|
||||
->selectRaw("DISTINCT ON (entity_id) entity_id,after_data->>'state' AS editorial_state")
|
||||
->orderBy('entity_id')->orderByRaw("(after_data->>'version_no')::integer DESC");
|
||||
$counts['territories'] = DB::table('geo_territory_profiles as p')->join('geo_locations as g', 'g.id', '=', 'p.geo_location_id')
|
||||
->leftJoinSub($latest, 'a', 'a.entity_id', '=', 'g.id')->whereNull('g.deleted_at')
|
||||
->whereNotIn(DB::raw('COALESCE(a.editorial_state,p.status)'), ['published', 'archived'])->count();
|
||||
}
|
||||
|
||||
if ($this->access($actor, 'investment-zones')) {
|
||||
$latest = DB::table('audit_events')->where('source_system', 'investment-zones')->where('entity_type', 'investment_zones')->where('after_data->editorial_workflow', true)
|
||||
->selectRaw("DISTINCT ON (entity_id) entity_id,after_data->>'editorial_state' AS editorial_state")
|
||||
->orderBy('entity_id')->orderByRaw("(after_data->>'version_no')::integer DESC");
|
||||
$counts['zones'] = DB::query()->fromSub($latest, 'a')->join('investment_zones as z', 'z.id', '=', 'a.entity_id')->whereNull('z.deleted_at')
|
||||
->whereIn('a.editorial_state', ['draft', 'submitted', 'in_review', 'returned', 'rejected', 'approved'])->count();
|
||||
}
|
||||
|
||||
return $counts;
|
||||
}
|
||||
|
||||
/** @param list<int> $participants */
|
||||
public function emit(User $actor, string $eventId, array $participants): void
|
||||
{
|
||||
if (! $this->available()) {
|
||||
return;
|
||||
}
|
||||
$event = DB::table('audit_events')->where('id', $eventId)->first();
|
||||
abort_unless($event !== null, 409);
|
||||
if (in_array($event->action, ['saved', 'restored', 'draft_saved', 'profile_prepared', 'profile_reconciled', 'zone_editorial_suspension_rebased'], true)) {
|
||||
return;
|
||||
}
|
||||
$emails = $event->source_system === 'territorial-editorial-v1'
|
||||
? [...config('territorial.editors', []), ...config('territorial.reviewers', []), ...config('territorial.publishers', [])]
|
||||
: config('portal.managers', []);
|
||||
$recipients = User::query()->where(fn ($q) => $q->whereIn('id', $participants)->orWhereIn(DB::raw('lower(email)'), array_map('strtolower', $emails)))->get();
|
||||
foreach ($recipients as $recipient) {
|
||||
if ($recipient->id === $actor->id || ! $this->access($recipient, $event->source_system)) {
|
||||
continue;
|
||||
}
|
||||
DB::table('portal_editorial_notifications')->insertOrIgnore(['user_id' => $recipient->id, 'native_event_id' => $eventId,
|
||||
'edition_id' => null, 'opportunity_id' => null, 'action' => $event->action, 'content_hash' => $this->eventHash($event), 'created_at' => now()]);
|
||||
}
|
||||
}
|
||||
|
||||
public function visible(User $actor, \stdClass $notice): bool
|
||||
{
|
||||
if (! $this->available() || (int) $notice->user_id !== $actor->id) {
|
||||
return false;
|
||||
}
|
||||
$event = DB::table('audit_events')->where('id', $notice->native_event_id)->first();
|
||||
if (! $event || ! $this->access($actor, $event->source_system) || ! is_string($notice->content_hash)
|
||||
|| ! hash_equals(trim($notice->content_hash), $this->eventHash($event))) {
|
||||
return false;
|
||||
}
|
||||
$table = match ($event->source_system) {
|
||||
'cluster-competitiveness' => 'economic_clusters', 'investment-zones' => 'investment_zones', default => 'geo_locations'
|
||||
};
|
||||
|
||||
return DB::table($table)->where('id', $event->entity_id)->whereNull('deleted_at')->exists();
|
||||
}
|
||||
|
||||
private function eventHash(\stdClass $event): string
|
||||
{
|
||||
return hash('sha256', json_encode([$event->id, $event->source_system, $event->entity_type, $event->entity_id, $event->action, $event->after_data], JSON_THROW_ON_ERROR));
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function present(\stdClass $notice): array
|
||||
{
|
||||
$event = DB::table('audit_events')->where('id', $notice->native_event_id)->first();
|
||||
abort_unless($event !== null, 404);
|
||||
$data = json_decode($event->after_data, true, 512, JSON_THROW_ON_ERROR);
|
||||
$cluster = $event->source_system === 'cluster-competitiveness';
|
||||
$version = $data[$cluster ? 'version' : 'version_no'];
|
||||
if ($event->source_system === 'investment-zones') {
|
||||
return ['id' => $notice->id, 'action' => str_replace('zone_editorial_', '', $notice->action), 'read_at' => $notice->read_at,
|
||||
'href' => '/management/investment/zones/'.$event->entity_id.'?notice_version='.$version, 'reference' => 'Zona e indicadores — versão '.$version];
|
||||
}
|
||||
|
||||
return ['id' => $notice->id, 'action' => $notice->action, 'read_at' => $notice->read_at,
|
||||
'href' => $cluster ? '/management/clusters/'.$event->entity_id.'/edit?notice_version='.$version : '/management/territorial/editorial?territory='.$event->entity_id.'¬ice_version='.$version,
|
||||
'reference' => ($cluster ? 'Competitividade — versão ' : 'Território — versão ').$version];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,394 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\User;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Database\Query\Builder;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Illuminate\Validation\Rule;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
|
||||
/** Subject mapping and publication effects for the existing common editorial engine. */
|
||||
final class PortalEditorialSubjects
|
||||
{
|
||||
public const SUBJECTS = [
|
||||
'projects' => ['table' => 'projects', 'fields' => ['code', 'name', 'status', 'description', 'budget_amount', 'budget_currency', 'start_date', 'end_date', 'primary_territory_id', 'territory_version']],
|
||||
'clusters' => ['table' => 'economic_clusters', 'fields' => ['code', 'name', 'status', 'sector', 'primary_territory_id', 'territory_version']],
|
||||
'corridors' => ['table' => 'development_corridors', 'fields' => ['code', 'name', 'status', 'description', 'primary_territory_id', 'territory_version']],
|
||||
'cluster-project' => ['table' => 'cluster_projects', 'fields' => ['cluster_id', 'project_id', 'role', 'association_type', 'source_reference', 'evidence_reference', 'valid_from', 'valid_until']],
|
||||
'corridor-project' => ['table' => 'corridor_projects', 'fields' => ['corridor_id', 'project_id', 'association_type', 'source_reference', 'evidence_reference', 'valid_from', 'valid_until']],
|
||||
'corridor-cluster' => ['table' => 'corridor_clusters', 'fields' => ['corridor_id', 'cluster_id', 'association_type', 'source_reference', 'evidence_reference', 'valid_from', 'valid_until']],
|
||||
'value-chains' => ['table' => 'value_chains', 'fields' => ['cluster_id', 'code', 'name', 'stage']],
|
||||
'value-chain-links' => ['table' => 'value_chain_links', 'fields' => ['from_value_chain_id', 'to_value_chain_id', 'link_type']],
|
||||
'investment-gaps' => ['table' => 'investment_gaps', 'fields' => ['cluster_id', 'value_chain_id', 'title', 'location', 'required_capacity', 'rationale', 'status', 'call_to_action']],
|
||||
'zone-relations' => ['table' => 'investment_zone_relations', 'fields' => ['zone_id', 'cluster_id', 'corridor_id', 'project_id', 'association_type', 'role', 'source_reference', 'justification', 'legal_source_id', 'valid_from', 'valid_until', 'priority', 'is_primary']],
|
||||
];
|
||||
|
||||
private const PARENTS = ['cluster_id' => 'economic_clusters', 'project_id' => 'projects', 'corridor_id' => 'development_corridors', 'zone_id' => 'investment_zones',
|
||||
'value_chain_id' => 'value_chains', 'from_value_chain_id' => 'value_chains', 'to_value_chain_id' => 'value_chains', 'primary_territory_id' => 'geo_locations'];
|
||||
|
||||
/** @return array{table:string,fields:list<string>} */
|
||||
public function definition(string $kind): array
|
||||
{
|
||||
abort_unless(isset(self::SUBJECTS[$kind]), 404);
|
||||
|
||||
return self::SUBJECTS[$kind];
|
||||
}
|
||||
|
||||
public function available(): bool
|
||||
{
|
||||
return (bool) config('editorial_workflow.structural_subjects') && app(PortalEditorialWorkflow::class)->available() && Schema::hasColumn('portal_editorial_editions', 'subject_kind');
|
||||
}
|
||||
|
||||
public function writes(string $kind, string $key): bool
|
||||
{
|
||||
$this->definition($kind);
|
||||
if (config('editorial_workflow.structural_subjects')) {
|
||||
abort_unless($this->available(), 503, 'Estrutura editorial dos registos ainda não instalada.');
|
||||
|
||||
return true;
|
||||
}
|
||||
abort_if(Schema::hasColumn('portal_editorial_editions', 'subject_kind') && DB::table('portal_editorial_editions')->where('subject_kind', $kind)->where('subject_key', $key)->exists(), 503, 'Reactive o circuito para conservar as versões deste registo.');
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
public function query(string $kind, string $key): Builder
|
||||
{
|
||||
return DB::table($this->definition($kind)['table'])->where('id', $key);
|
||||
}
|
||||
|
||||
public function editUrl(string $kind, \stdClass $record): string
|
||||
{
|
||||
return match ($kind) {
|
||||
'projects', 'clusters', 'corridors' => '/management/'.$kind.'/'.$record->id.'/edit',
|
||||
'value-chains', 'investment-gaps', 'cluster-project' => '/management/clusters/'.$record->cluster_id.'/edit',
|
||||
'value-chain-links' => '/management/clusters/'.DB::table('value_chains')->where('id', $record->from_value_chain_id)->value('cluster_id').'/edit',
|
||||
'corridor-project', 'corridor-cluster' => '/management/corridors/'.$record->corridor_id.'/edit',
|
||||
'zone-relations' => '/management/investment/zones/'.$record->zone_id,
|
||||
default => abort(404),
|
||||
};
|
||||
}
|
||||
|
||||
public function working(string $kind, \stdClass $record): \stdClass
|
||||
{
|
||||
if (! $this->available()) {
|
||||
return $record;
|
||||
}
|
||||
$workflow = app(PortalEditorialWorkflow::class);
|
||||
$edition = $workflow->latestSubject($kind, $record->id);
|
||||
$copy = clone $record;
|
||||
if ($edition && $edition->published_at === null && $edition->state !== 'archived') {
|
||||
foreach ($workflow->payload($edition)['resource']['_subject']['fields'] as $field => $value) {
|
||||
$copy->{$field} = $value;
|
||||
}
|
||||
}
|
||||
$copy->editorial_version = (int) ($edition->revision_no ?? 1);
|
||||
$copy->editorial_url = '/management/editorial/subjects/'.$kind.'/'.$record->id;
|
||||
|
||||
return $copy;
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $fields */
|
||||
public function stageModel(User $actor, string $kind, Model $record, array $fields, int $expected): \stdClass
|
||||
{
|
||||
return DB::transaction(function () use ($actor, $kind, $record, $fields, $expected) {
|
||||
$new = ! $record->exists;
|
||||
if ($new) {
|
||||
$private = in_array($kind, ['value-chains', 'value-chain-links', 'investment-gaps'], true) ? ['deleted_at' => now()] : [];
|
||||
PortalAudit::save($record, [...$fields, ...$private], $actor->id);
|
||||
}
|
||||
$allowed = $this->definition($kind)['fields'];
|
||||
|
||||
return app(PortalEditorialWorkflow::class)->saveSubject($actor, $kind, (string) $record->getKey(), $expected, Arr::only($fields, $allowed), $new);
|
||||
});
|
||||
}
|
||||
|
||||
/** @return array<string,string> */
|
||||
public function labels(): array
|
||||
{
|
||||
return ['code' => 'Código', 'name' => 'Designação', 'status' => 'Estado', 'description' => 'Descrição', 'sector' => 'Sector', 'budget_amount' => 'Orçamento', 'budget_currency' => 'Moeda', 'start_date' => 'Data de início', 'end_date' => 'Data de conclusão',
|
||||
'primary_territory_id' => 'Localização principal', 'cluster_id' => 'Cluster', 'project_id' => 'Projecto', 'corridor_id' => 'Corredor', 'zone_id' => 'Zona', 'value_chain_id' => 'Etapa da cadeia', 'from_value_chain_id' => 'Etapa de origem', 'to_value_chain_id' => 'Etapa de destino',
|
||||
'role' => 'Papel', 'association_type' => 'Tipo de associação', 'source_reference' => 'Fonte', 'evidence_reference' => 'Evidência', 'valid_from' => 'Válido desde', 'valid_until' => 'Válido até', 'stage' => 'Fase da cadeia', 'link_type' => 'Tipo de ligação',
|
||||
'title' => 'Título', 'location' => 'Localização', 'required_capacity' => 'Capacidade necessária', 'rationale' => 'Fundamento', 'call_to_action' => 'Acção proposta', 'justification' => 'Justificação', 'legal_source_id' => 'Fonte jurídica', 'priority' => 'Prioridade', 'is_primary' => 'Relação principal'];
|
||||
}
|
||||
|
||||
/** @return array<string,list<string>> */
|
||||
private function enums(string $kind): array
|
||||
{
|
||||
return ['status' => match ($kind) {
|
||||
'projects' => ['draft', 'planned', 'active', 'suspended', 'completed', 'cancelled'], 'clusters' => ['planned', 'active', 'inactive'], 'corridors' => ['proposed', 'active', 'closed'], 'investment-gaps' => ['identified', 'in_review', 'resolved', 'withdrawn'], default => []
|
||||
},
|
||||
'stage' => ['input', 'production', 'processing', 'logistics', 'market'], 'link_type' => ['supplies', 'processes', 'distributes', 'supports'],
|
||||
'association_type' => ['official', 'influence', 'proximity', 'potential', 'historical'], 'role' => $kind === 'zone-relations' ? ['primary', 'beneficiary', 'served', 'enabled', 'dependent', 'related', 'potential', 'historical'] : ['anchor', 'complementary', 'supporting']];
|
||||
}
|
||||
|
||||
/** @return list<array<string,mixed>> */
|
||||
public function form(string $kind): array
|
||||
{
|
||||
$labels = $this->labels();
|
||||
$enums = $this->enums($kind);
|
||||
$result = [];
|
||||
foreach ($this->definition($kind)['fields'] as $field) {
|
||||
if ($field === 'territory_version') {
|
||||
continue;
|
||||
}
|
||||
$type = isset(self::PARENTS[$field]) || $field === 'legal_source_id' ? 'reference' : (isset($enums[$field]) ? 'enum' : (in_array($field, ['valid_from', 'valid_until', 'start_date', 'end_date'], true) ? 'date' : ($field === 'is_primary' ? 'boolean' : 'text')));
|
||||
$result[] = ['name' => $field, 'label' => $labels[$field] ?? $field, 'type' => $type, 'options' => $enums[$field] ?? []];
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function validate(string $kind, array $input): array
|
||||
{
|
||||
$allowed = array_values(array_diff($this->definition($kind)['fields'], ['territory_version']));
|
||||
abort_unless(array_diff(array_keys($input), $allowed) === [], 422, 'Campos fora do âmbito da proposta.');
|
||||
$enums = $this->enums($kind);
|
||||
$rules = [];
|
||||
foreach ($allowed as $field) {
|
||||
$rules[$field] = ['sometimes', 'nullable', 'string', 'max:10000'];
|
||||
if (isset(self::PARENTS[$field]) || $field === 'legal_source_id') {
|
||||
$table = self::PARENTS[$field] ?? 'investment_legal_sources';
|
||||
$rules[$field] = ['sometimes', 'nullable', 'uuid', 'exists:'.$table.',id'];
|
||||
} elseif (isset($enums[$field])) {
|
||||
$rules[$field] = ['sometimes', 'required', Rule::in($enums[$field])];
|
||||
} elseif (in_array($field, ['valid_from', 'valid_until', 'start_date', 'end_date'], true)) {
|
||||
$rules[$field] = ['sometimes', 'nullable', 'date_format:Y-m-d'];
|
||||
}
|
||||
}
|
||||
foreach (['name', 'code', 'title', 'sector'] as $field) {
|
||||
if (in_array($field, $allowed, true)) {
|
||||
$rules[$field] = ['sometimes', 'required', 'string', 'max:'.($field === 'code' ? '100' : '200')];
|
||||
}
|
||||
}
|
||||
foreach (['source_reference' => 2000, 'evidence_reference' => 2000, 'justification' => 3000, 'location' => 1000, 'required_capacity' => 2000, 'rationale' => 5000, 'call_to_action' => 2000] as $field => $limit) {
|
||||
if (in_array($field, $allowed, true)) {
|
||||
$rules[$field] = ['sometimes', 'nullable', 'string', 'max:'.$limit];
|
||||
}
|
||||
}
|
||||
$requiredReferences = match ($kind) {
|
||||
'cluster-project' => ['cluster_id', 'project_id'], 'corridor-project' => ['corridor_id', 'project_id'], 'corridor-cluster' => ['corridor_id', 'cluster_id'],
|
||||
'value-chains' => ['cluster_id'], 'value-chain-links' => ['from_value_chain_id', 'to_value_chain_id'], 'investment-gaps' => ['cluster_id', 'value_chain_id'], 'zone-relations' => ['zone_id'], default => [],
|
||||
};
|
||||
foreach ($requiredReferences as $field) {
|
||||
$rules[$field] = ['sometimes', 'required', 'uuid', 'exists:'.self::PARENTS[$field].',id'];
|
||||
}
|
||||
if (! empty($input['valid_until']) && ! empty($input['valid_from'])) {
|
||||
$rules['valid_until'][] = 'after_or_equal:valid_from';
|
||||
}
|
||||
if (! empty($input['end_date']) && ! empty($input['start_date'])) {
|
||||
$rules['end_date'][] = 'after_or_equal:start_date';
|
||||
}
|
||||
if (in_array('budget_amount', $allowed, true)) {
|
||||
$rules['budget_amount'] = ['sometimes', 'nullable', 'required_with:budget_currency', 'regex:/^\d{1,18}(\.\d{1,2})?$/'];
|
||||
$rules['budget_currency'] = ['sometimes', 'nullable', 'required_with:budget_amount', 'regex:/^[A-Z]{3}$/'];
|
||||
}
|
||||
if (in_array('priority', $allowed, true)) {
|
||||
$rules['priority'] = ['sometimes', 'integer', 'between:0,100'];
|
||||
$rules['is_primary'] = ['sometimes', 'boolean'];
|
||||
}
|
||||
if ($kind === 'zone-relations' && count(array_filter(Arr::only($input, ['cluster_id', 'corridor_id', 'project_id']))) > 1) {
|
||||
throw ValidationException::withMessages(['project_id' => 'Seleccione apenas um projecto, cluster ou corredor para a relação.']);
|
||||
}
|
||||
|
||||
return validator($input, $rules)->validate();
|
||||
}
|
||||
|
||||
/** @return list<array{id:string,name:string}> */
|
||||
public function choices(string $kind, string $field, ?string $query = null): array
|
||||
{
|
||||
abort_unless(in_array($field, $this->definition($kind)['fields'], true), 404);
|
||||
$table = self::PARENTS[$field] ?? ($field === 'legal_source_id' ? 'investment_legal_sources' : abort(404));
|
||||
$label = $table === 'investment_legal_sources' ? 'title' : 'name';
|
||||
$builder = DB::table($table);
|
||||
if ($table === 'geo_locations') {
|
||||
$builder->whereIn('location_type', ['province', 'district', 'admin_post', 'locality'])->whereIn('data_classification', ['public', 'internal']);
|
||||
}
|
||||
if (Schema::hasColumn($table, 'deleted_at')) {
|
||||
$builder->whereNull('deleted_at');
|
||||
}
|
||||
if ($query) {
|
||||
$builder->where($label, 'ilike', '%'.addcslashes($query, '%_\\').'%');
|
||||
}
|
||||
|
||||
return array_values($builder->orderBy($label)->orderBy('id')->limit(100)->get(['id', $label.' as name'])->map(fn ($row) => ['id' => (string) $row->id, 'name' => (string) $row->name])->all());
|
||||
}
|
||||
|
||||
public function authorize(User $actor, string $kind, string $key, bool $write = false): void
|
||||
{
|
||||
abort_unless($this->available(), 503);
|
||||
abort_unless($actor->hasVerifiedEmail() && $actor->can('manage-portal') && ! app(PortalProfileAccess::class)->has($actor, 'auditor'), 403);
|
||||
abort_unless($this->query($kind, $key)->exists(), 404);
|
||||
if ($write) {
|
||||
abort_unless(app(PortalProfileAccess::class)->mfa($actor), 403, 'Confirme o MFA na sessão existente.');
|
||||
}
|
||||
}
|
||||
|
||||
public function independent(string $kind): bool
|
||||
{
|
||||
return in_array($kind, ['cluster-project', 'corridor-project', 'corridor-cluster', 'zone-relations'], true)
|
||||
|| in_array($kind, config('editorial_workflow.independent_approval.kinds', []), true);
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $fields
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function snapshot(string $kind, string $key, array $fields): array
|
||||
{
|
||||
$definition = $this->definition($kind);
|
||||
$record = $this->query($kind, $key)->first();
|
||||
abort_unless($record !== null, 404);
|
||||
abort_unless(array_diff(array_keys($fields), $definition['fields']) === [], 422, 'Campos fora do âmbito do registo.');
|
||||
$context = ['record' => Arr::except(get_object_vars($record), ['created_at', 'updated_at']), 'parents' => []];
|
||||
if (! empty($fields['primary_territory_id'])) {
|
||||
$path = app(InvestmentGeography::class)->path($fields['primary_territory_id'], true);
|
||||
abort_unless($path !== [] && count($path) <= 4 && $path[0]->location_type === 'province', 422, 'Seleccione uma localização na hierarquia existente.');
|
||||
}
|
||||
foreach (self::PARENTS as $field => $table) {
|
||||
$id = $fields[$field] ?? $record->{$field} ?? null;
|
||||
if (! $id) {
|
||||
continue;
|
||||
}
|
||||
$parent = DB::table($table)->where('id', $id)->whereNull('deleted_at')->first();
|
||||
abort_unless($parent !== null, 422, 'Contexto relacionado indisponível.');
|
||||
$context['parents'][$field] = Arr::except(get_object_vars($parent), ['created_at', 'updated_at']);
|
||||
}
|
||||
if (in_array($kind, ['projects', 'clusters', 'corridors'], true)) {
|
||||
$foreign = ['projects' => 'project_id', 'clusters' => 'cluster_id', 'corridors' => 'corridor_id'][$kind];
|
||||
$context['portfolio'] = DB::table('investment_dossiers')->where($foreign, $key)->pluck('id')->all();
|
||||
abort_unless($context['portfolio'] === [], 409, 'Este registo tem ficha associada. Continue na revisão da carteira.');
|
||||
}
|
||||
if ($source = $fields['legal_source_id'] ?? $record->legal_source_id ?? null) {
|
||||
$sourceRecord = DB::table('investment_legal_sources')->where('id', $source)->first();
|
||||
abort_unless($sourceRecord !== null, 422, 'Fonte jurídica indisponível.');
|
||||
$context['legal_source'] = get_object_vars($sourceRecord);
|
||||
}
|
||||
|
||||
return ['fields' => $fields, 'context' => $context];
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $fields */
|
||||
public function lock(string $kind, string $key, array $fields = []): \stdClass
|
||||
{
|
||||
$record = $this->query($kind, $key)->first();
|
||||
abort_unless($record !== null, 404);
|
||||
$parents = [];
|
||||
foreach (self::PARENTS as $field => $table) {
|
||||
$id = $fields[$field] ?? $record->{$field} ?? null;
|
||||
if ($id) {
|
||||
$parents[$table][] = $id;
|
||||
}
|
||||
}
|
||||
ksort($parents);
|
||||
foreach ($parents as $table => $ids) {
|
||||
DB::table($table)->whereIn('id', array_unique($ids))->orderBy('id')->lockForUpdate()->get();
|
||||
}
|
||||
|
||||
return $this->query($kind, $key)->lockForUpdate()->firstOrFail();
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $payload */
|
||||
public function publish(User $actor, \stdClass $record, \stdClass $edition, array $payload): void
|
||||
{
|
||||
$subject = $payload['resource']['_subject'];
|
||||
$kind = $edition->subject_kind;
|
||||
$fields = $subject['fields'];
|
||||
$this->lock($kind, $edition->subject_key, $fields);
|
||||
if ($subject['withdraw'] ?? false) {
|
||||
$this->archive($actor, $record, $edition);
|
||||
|
||||
return;
|
||||
}
|
||||
$pair = match ($kind) {
|
||||
'cluster-project' => ['cluster_id', 'project_id'], 'corridor-project' => ['corridor_id', 'project_id'], 'corridor-cluster' => ['corridor_id', 'cluster_id'],
|
||||
'value-chain-links' => ['from_value_chain_id', 'to_value_chain_id', 'link_type'],
|
||||
'zone-relations' => ['zone_id', 'cluster_id', 'corridor_id', 'project_id'], default => [],
|
||||
};
|
||||
if ($pair !== []) {
|
||||
abort_if($kind === 'zone-relations' && count(array_filter(Arr::only($fields, ['cluster_id', 'corridor_id', 'project_id']))) !== 1, 422, 'A relação exige um projecto, cluster ou corredor.');
|
||||
$duplicates = DB::table($this->definition($kind)['table'])->where('id', '<>', $record->id);
|
||||
foreach ($pair as $field) {
|
||||
$duplicates->where($field, $fields[$field] ?? null);
|
||||
}
|
||||
if (property_exists($record, 'deleted_at')) {
|
||||
$duplicates->whereNull('deleted_at');
|
||||
}
|
||||
abort_if($duplicates->exists(), 409, 'Esta relação já existe. Reveja a proposta sem duplicar o registo.');
|
||||
}
|
||||
if (in_array($kind, ['projects', 'clusters', 'corridors', 'value-chains'], true) && isset($fields['code'])) {
|
||||
$query = DB::table($this->definition($kind)['table'])->where('code', $fields['code'])->where('id', '<>', $record->id)->whereNull('deleted_at');
|
||||
if ($kind === 'value-chains') {
|
||||
$query->where('cluster_id', $fields['cluster_id'] ?? $record->cluster_id);
|
||||
}
|
||||
abort_if($query->exists(), 409, 'Código entretanto utilizado. Reveja a proposta.');
|
||||
}
|
||||
if (in_array($kind, ['cluster-project', 'corridor-project', 'corridor-cluster', 'zone-relations'], true)) {
|
||||
foreach (['source_reference', 'valid_from'] as $required) {
|
||||
abort_unless(! empty($fields[$required]), 422, 'Fonte e vigência são necessárias.');
|
||||
}
|
||||
abort_if($kind === 'zone-relations' && ($fields['association_type'] ?? '') === 'official' && empty($fields['legal_source_id']), 422, 'A associação oficial exige a fonte jurídica prevista.');
|
||||
if (! empty($fields['legal_source_id'])) {
|
||||
$source = DB::table('investment_legal_sources')->where('id', $fields['legal_source_id'])->lockForUpdate()->first();
|
||||
abort_unless($source && $source->validation_status === 'validated' && $source->valid_from <= today()->toDateString()
|
||||
&& (! $source->valid_until || $source->valid_until >= today()->toDateString()), 422, 'Fonte jurídica fora de vigência.');
|
||||
}
|
||||
$decision = json_decode($edition->approval, true, 512, JSON_THROW_ON_ERROR);
|
||||
$fields += ['validation_status' => 'validated', 'validator_id' => $decision['actor_id'], 'editor_id' => $edition->author_id];
|
||||
if (property_exists($record, 'data_classification')) {
|
||||
$fields['data_classification'] = 'public';
|
||||
}
|
||||
}
|
||||
if ($kind === 'value-chain-links') {
|
||||
$chains = DB::table('value_chains')->whereIn('id', [$fields['from_value_chain_id'], $fields['to_value_chain_id']])->whereNull('deleted_at')->get(['id', 'cluster_id']);
|
||||
abort_unless($chains->count() === 2 && $chains->pluck('cluster_id')->unique()->count() === 1, 422, 'As etapas devem ser distintas e pertencer ao mesmo cluster.');
|
||||
}
|
||||
if ($kind === 'investment-gaps') {
|
||||
abort_unless(DB::table('value_chains')->where('id', $fields['value_chain_id'])->where('cluster_id', $fields['cluster_id'])->whereNull('deleted_at')->exists(), 422, 'Etapa fora do cluster da lacuna.');
|
||||
}
|
||||
if ($subject['new_record'] ?? false) {
|
||||
$fields['deleted_at'] = null;
|
||||
}
|
||||
if (property_exists($record, 'data_classification')) {
|
||||
$fields['data_classification'] = 'public';
|
||||
}
|
||||
if (property_exists($record, 'version_no')) {
|
||||
$fields['version_no'] = (int) $record->version_no + 1;
|
||||
}
|
||||
$fields['updated_at'] = now();
|
||||
$this->query($kind, $record->id)->update($fields);
|
||||
$this->audit($actor, $edition, 'published', $record);
|
||||
}
|
||||
|
||||
public function archive(User $actor, \stdClass $record, \stdClass $edition): void
|
||||
{
|
||||
$fields = property_exists($record, 'validation_status') ? ['validation_status' => 'revoked']
|
||||
: (in_array($edition->subject_kind, ['projects', 'clusters', 'corridors'], true) ? ['data_classification' => 'internal'] : ['deleted_at' => now()]);
|
||||
if (property_exists($record, 'version_no')) {
|
||||
$fields['version_no'] = (int) $record->version_no + 1;
|
||||
}
|
||||
$this->query($edition->subject_kind, $record->id)->update([...$fields, 'updated_at' => now()]);
|
||||
$this->audit($actor, $edition, 'archived', $record);
|
||||
}
|
||||
|
||||
private function audit(User $actor, \stdClass $edition, string $action, \stdClass $before): void
|
||||
{
|
||||
$after = $this->query($edition->subject_kind, $edition->subject_key)->firstOrFail();
|
||||
$changed = [];
|
||||
foreach (get_object_vars($after) as $field => $value) {
|
||||
if (($before->{$field} ?? null) !== $value) {
|
||||
$changed[] = $field;
|
||||
}
|
||||
}
|
||||
DB::table('audit_events')->insert(['source_system' => 'editorial-structural-subjects', 'entity_type' => $this->definition($edition->subject_kind)['table'],
|
||||
'entity_id' => $edition->subject_key, 'actor_user_id' => $actor->id, 'action' => $action, 'data_classification' => 'restricted',
|
||||
'before_data' => json_encode(Arr::only(get_object_vars($before), ['id', 'version_no', 'validation_status', 'deleted_at', 'data_classification']), JSON_THROW_ON_ERROR),
|
||||
'after_data' => json_encode(['edition_id' => $edition->id, 'hash' => $edition->content_hash, 'record_id' => $edition->subject_key, 'changed_fields' => $changed], JSON_THROW_ON_ERROR)]);
|
||||
}
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
@@ -241,6 +241,9 @@ class PortalProfileAccess
|
||||
|
||||
public function canEdit(User $actor, Opportunity $record, ?string $newType = null): bool
|
||||
{
|
||||
if ($record->isPrivateOfferPreparation() && ! in_array($this->state($record), ['draft', 'needs_information'], true)) {
|
||||
return false;
|
||||
}
|
||||
if ($record->owner_user_id === null) {
|
||||
return $this->legacyWriteAllowed($actor);
|
||||
}
|
||||
@@ -264,6 +267,10 @@ class PortalProfileAccess
|
||||
|
||||
public function state(Opportunity $record): string
|
||||
{
|
||||
if ($record->isPrivateOfferPreparation()) {
|
||||
return data_get($record->workflow_context, 'private_offer_preparation.state', 'draft');
|
||||
}
|
||||
|
||||
return $record->workflow_context['working_state'] ?? $record->status;
|
||||
}
|
||||
|
||||
|
||||
@@ -0,0 +1,217 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Models\User;
|
||||
use Illuminate\Support\Facades\Crypt;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Str;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
use Symfony\Component\HttpKernel\Exception\HttpExceptionInterface;
|
||||
|
||||
/** The same opportunity owns consent, grants and history. No automatic publication. */
|
||||
final class PrivateOfferConfidentiality
|
||||
{
|
||||
public function internal(User $actor, Opportunity $record): bool
|
||||
{
|
||||
$access = app(PortalProfileAccess::class);
|
||||
|
||||
return $access->canView($actor, $record) && $access->mfa($actor) && ! $access->has($actor, 'auditor') && ! $access->conflict($actor, $record)
|
||||
&& $access->scoped($actor, 'validator', $record->organization_id, $record->opportunity_category);
|
||||
}
|
||||
|
||||
public function seller(User $actor, Opportunity $record): bool
|
||||
{
|
||||
$access = app(PortalProfileAccess::class);
|
||||
|
||||
return (int) $record->owner_user_id === $actor->id && $access->promoterRecordScope($actor, $record)
|
||||
&& $access->canCreate($actor, $record->organization_id, $record->opportunity_category) && $access->operational($actor, 'edit', $record->id);
|
||||
}
|
||||
|
||||
/** @return array<string,mixed>|null */
|
||||
public function nda(): ?array
|
||||
{
|
||||
$definition = config('private_offers.nda');
|
||||
if (! is_array($definition) || empty($definition['approval_reference']) || empty($definition['document_id']) || empty($definition['version']) || empty($definition['sha256'])) {
|
||||
return null;
|
||||
}
|
||||
$doc = DB::table('documents')->where('id', $definition['document_id'])->whereNull('deleted_at')->first();
|
||||
if (! $doc || $doc->status !== 'active' || $doc->malware_scan_status !== 'clean' || (int) $doc->version_no !== (int) $definition['version']
|
||||
|| ! hash_equals(trim($doc->sha256), $definition['sha256']) || ! hash_equals(trim($doc->sha256), trim((string) $doc->malware_scanned_sha256))) {
|
||||
return null;
|
||||
}
|
||||
try {
|
||||
app(VerifiedDocumentBinary::class)->respond($doc);
|
||||
} catch (HttpExceptionInterface $error) {
|
||||
return null;
|
||||
}
|
||||
$result = ['document_id' => $doc->id, 'version' => (int) $doc->version_no, 'sha256' => trim($doc->sha256), 'approval_reference' => $definition['approval_reference']];
|
||||
|
||||
return [...$result, 'fingerprint' => hash('sha256', json_encode($result, JSON_THROW_ON_ERROR))];
|
||||
}
|
||||
|
||||
private function company(int $id, bool $lock = false): Opportunity
|
||||
{
|
||||
$record = Opportunity::query()->when($lock, fn ($q) => $q->lockForUpdate())->findOrFail($id);
|
||||
abort_unless($record->isPrivateOfferPreparation() && $record->opportunity_category === 'business_sale', 404);
|
||||
|
||||
return $record;
|
||||
}
|
||||
|
||||
private function approvedHash(Opportunity $record): string
|
||||
{
|
||||
abort_unless(app(OfferAvailability::class)->record($record)['state'] === 'available', 409, 'A oferta não está disponível.');
|
||||
$hash = $record->workflow_context['approval']['hash'] ?? null;
|
||||
abort_unless(is_string($hash) && app(PortalProfileAccess::class)->state($record) === 'approved', 409, 'Esta versão não tem aprovação editorial actual.');
|
||||
try {
|
||||
$snapshot = app(PrivateOfferPreparation::class)->snapshot($record);
|
||||
} catch (ValidationException $error) {
|
||||
abort(409, 'A versão ou os suportes exigem reconferência editorial.');
|
||||
}
|
||||
abort_unless(hash_equals($hash, $snapshot['hash']), 409, 'A versão mudou; é necessária reconferência editorial.');
|
||||
|
||||
return $hash;
|
||||
}
|
||||
|
||||
/** PostgreSQL jsonb reorders object keys; identity is the version and checksum, not array order.
|
||||
* @param array<string,mixed> $nda */
|
||||
private function sameNda(mixed $accepted, array $nda): bool
|
||||
{
|
||||
if (! is_array($accepted)) {
|
||||
return false;
|
||||
}
|
||||
foreach (['document_id', 'version', 'sha256', 'approval_reference', 'fingerprint'] as $key) {
|
||||
if (($accepted[$key] ?? null) !== $nda[$key]) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function overview(User $actor, int $id): array
|
||||
{
|
||||
$record = $this->company($id);
|
||||
// An interested party learns no private title, contacts, documents or financial values.
|
||||
$seller = $this->seller($actor, $record);
|
||||
$nda = $this->nda();
|
||||
$context = $record->workflow_context['offer_confidentiality'] ?? [];
|
||||
$currentHash = null;
|
||||
try {
|
||||
$currentHash = $this->approvedHash($record);
|
||||
} catch (HttpExceptionInterface $error) {
|
||||
// A previous acceptance remains withdrawable even if the offer was revised.
|
||||
abort_unless($seller || isset($context['acceptances'][(string) $actor->id]), 404);
|
||||
}
|
||||
$history = array_values(array_filter($context['events'] ?? [], fn ($event) => $seller || $event['interested_user_id'] === $actor->id));
|
||||
|
||||
return ['offer_id' => $id, 'nda' => $nda, 'nda_pending' => $nda === null, 'version_hash' => $record->workflow_context['approval']['hash'] ?? null,
|
||||
'etag' => $seller ? app(OpportunityManagement::class)->etag($record) : null,
|
||||
'can_accept' => ! $seller && $nda !== null && $currentHash !== null && ! app(PortalProfileAccess::class)->conflict($actor, $record),
|
||||
'can_authorize' => $seller && $nda !== null && $currentHash !== null,
|
||||
'seller' => $seller, 'requests' => $seller ? array_values($context['acceptances'] ?? []) : [],
|
||||
'grants' => $seller ? array_values($context['grants'] ?? []) : [],
|
||||
'history' => array_map(fn ($event) => array_intersect_key($event, array_flip(['id', 'action', 'actor_id', 'at', 'version_hash', 'nda'])), $history),
|
||||
'acceptance' => $context['acceptances'][(string) $actor->id] ?? null];
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input
|
||||
* @return array<string,mixed> */
|
||||
public function act(User $actor, int $id, array $input): array
|
||||
{
|
||||
$data = validator($input, ['action' => 'required|in:accept,authorize,revoke,withdraw', 'version_hash' => 'required|string|size:64',
|
||||
'nda_sha256' => 'required_unless:action,revoke,withdraw|string|size:64', 'acceptance_id' => 'required_if:action,authorize|uuid',
|
||||
'nda_fingerprint' => 'required_if:action,accept,authorize|string|size:64',
|
||||
'interested_user_id' => 'required_if:action,authorize,revoke|integer|min:1', 'confirm' => 'required|accepted',
|
||||
'reason' => ['nullable', 'required_if:action,authorize,revoke', 'string', 'max:1000', ...(in_array($input['action'] ?? null, ['authorize', 'revoke'], true) ? ['min:20'] : [])]])->validate();
|
||||
|
||||
return DB::transaction(function () use ($actor, $id, $data) {
|
||||
$record = $this->company($id, true);
|
||||
$context = $record->workflow_context;
|
||||
$privacy = $context['offer_confidentiality'] ?? ['acceptances' => [], 'grants' => [], 'events' => []];
|
||||
$action = $data['action'];
|
||||
$target = in_array($action, ['authorize', 'revoke'], true) ? (string) $data['interested_user_id'] : (string) $actor->id;
|
||||
$before = ['acceptance' => $privacy['acceptances'][$target] ?? null, 'grant' => $privacy['grants'][$target] ?? null];
|
||||
if (in_array($action, ['authorize', 'revoke'], true)) {
|
||||
abort_unless($this->seller($actor, $record), 403);
|
||||
} elseif ($action === 'accept') {
|
||||
abort_if($this->seller($actor, $record) || app(PortalProfileAccess::class)->conflict($actor, $record), 403);
|
||||
}
|
||||
if (in_array($action, ['accept', 'authorize'], true)) {
|
||||
$nda = $this->nda();
|
||||
abort_unless($nda !== null, 409, 'O exemplar aprovado do NDA ainda não foi disponibilizado.');
|
||||
abort_unless(hash_equals($this->approvedHash($record), $data['version_hash']) && hash_equals($nda['sha256'], $data['nda_sha256'])
|
||||
&& hash_equals($nda['fingerprint'], $data['nda_fingerprint']), 409);
|
||||
$subject = User::findOrFail((int) $target);
|
||||
abort_unless($subject->hasVerifiedEmail() && ! app(PortalProfileAccess::class)->conflict($subject, $record), 403);
|
||||
if ($action === 'accept') {
|
||||
$privacy['acceptances'][$target] = ['id' => (string) Str::uuid(), 'actor_id' => $actor->id, 'at' => now()->toIso8601String(),
|
||||
'version_hash' => $data['version_hash'], 'nda' => $nda, 'access_revision' => (int) $subject->portal_access_revision];
|
||||
unset($privacy['grants'][$target]); // A fresh acceptance never reuses a previous seller decision.
|
||||
} else {
|
||||
$acceptance = $privacy['acceptances'][$target] ?? null;
|
||||
abort_unless($acceptance && $acceptance['id'] === $data['acceptance_id'] && $acceptance['version_hash'] === $data['version_hash']
|
||||
&& $this->sameNda($acceptance['nda'], $nda) && $acceptance['access_revision'] === (int) $subject->portal_access_revision, 409);
|
||||
$privacy['grants'][$target] = ['interested_user_id' => (int) $target, 'seller_id' => $actor->id, 'at' => now()->toIso8601String(),
|
||||
'version_hash' => $data['version_hash'], 'acceptance_id' => $acceptance['id'], 'nda' => $nda];
|
||||
}
|
||||
} else {
|
||||
$previous = $privacy[$action === 'withdraw' ? 'acceptances' : 'grants'][$target] ?? null;
|
||||
abort_unless($previous && $previous['version_hash'] === $data['version_hash'], 409);
|
||||
unset($privacy['grants'][$target]);
|
||||
if ($action === 'withdraw') {
|
||||
unset($privacy['acceptances'][$target]);
|
||||
}
|
||||
}
|
||||
$event = ['id' => (string) Str::uuid(), 'action' => $action, 'actor_id' => $actor->id, 'interested_user_id' => (int) $target,
|
||||
'version_hash' => $data['version_hash'], 'at' => now()->toIso8601String(), 'nda_sha256' => $data['nda_sha256'] ?? null,
|
||||
'nda' => $nda ?? ($before['acceptance']['nda'] ?? $before['grant']['nda'] ?? null)];
|
||||
$privacy['events'][] = [...$event, 'reason' => Crypt::encryptString($data['reason'] ?? ''), 'before' => $before,
|
||||
'after' => ['acceptance' => $privacy['acceptances'][$target] ?? null, 'grant' => $privacy['grants'][$target] ?? null]];
|
||||
$context['offer_confidentiality'] = $privacy;
|
||||
$record->workflow_context = $context;
|
||||
$record->management_version++;
|
||||
$record->save();
|
||||
app(PortalProfileAccess::class)->audit($actor, 'offer_confidentiality_'.$action, ['record_id' => $id, ...$event]);
|
||||
|
||||
return ['recorded' => true, 'event_id' => $event['id']];
|
||||
});
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function read(User $actor, int $id): array
|
||||
{
|
||||
return DB::transaction(function () use ($actor, $id) {
|
||||
$record = $this->company($id, true);
|
||||
$nda = $this->nda();
|
||||
$privacy = $record->workflow_context['offer_confidentiality'] ?? [];
|
||||
$accept = $privacy['acceptances'][(string) $actor->id] ?? null;
|
||||
$grant = $privacy['grants'][(string) $actor->id] ?? null;
|
||||
$hash = $this->approvedHash($record);
|
||||
$seller = User::find($record->owner_user_id);
|
||||
$subject = User::find($actor->id);
|
||||
$allowed = $nda && $accept && $grant && $seller && $subject && $this->seller($seller, $record) && $subject->hasVerifiedEmail()
|
||||
&& $accept['access_revision'] === (int) $subject->portal_access_revision && $grant['seller_id'] === $seller->id
|
||||
&& $grant['acceptance_id'] === $accept['id'] && $grant['version_hash'] === $hash && $accept['version_hash'] === $hash
|
||||
&& $this->sameNda($grant['nda'], $nda) && $this->sameNda($accept['nda'], $nda) && ! app(PortalProfileAccess::class)->conflict($actor, $record);
|
||||
app(PortalProfileAccess::class)->audit($actor, $allowed ? 'offer_confidential_access' : 'offer_confidential_denied', ['record_id' => $id, 'version_hash' => $hash,
|
||||
'nda' => $nda, 'acceptance_id' => $accept['id'] ?? null]);
|
||||
// Return the refusal after transaction commit so the denied-access audit survives.
|
||||
if (! $allowed) {
|
||||
return ['denied' => true];
|
||||
}
|
||||
|
||||
$business = $record->workflow_context['submission']['payload']['private_offer']['business'] ?? [];
|
||||
foreach (['sector_id' => 'sector', 'secondary_sector_id' => 'secondary_sector'] as $field => $label) {
|
||||
if (isset($business[$field])) {
|
||||
$business[$label] = DB::table('sectors')->where('id', $business[$field])->value('name');
|
||||
}
|
||||
unset($business[$field]);
|
||||
}
|
||||
|
||||
return ['offer_id' => $id, 'version_hash' => $hash, 'business' => $business];
|
||||
});
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,83 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
use Illuminate\Validation\Rule;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
|
||||
/** Optional commercial fields confirmed by Tempo for phase four; no title certification. */
|
||||
final class PrivateOfferDetails
|
||||
{
|
||||
/** @param array<string,mixed> $input
|
||||
* @return array<string,mixed> */
|
||||
public function validate(array $input): array
|
||||
{
|
||||
$bytes = file_get_contents(resource_path('data/investmoz-opportunity-modular.schema.json'));
|
||||
if ($bytes === false) {
|
||||
throw new \RuntimeException('Opportunity schema unavailable.');
|
||||
}
|
||||
$schema = json_decode($bytes, true, 512, JSON_THROW_ON_ERROR);
|
||||
$property = $schema['$defs']['realEstatePatch']['properties'];
|
||||
|
||||
return Validator::make($input, [
|
||||
'business' => 'sometimes|nullable|array:sector_id,secondary_sector_id,revenue,cash_flow,currency,reason,availability',
|
||||
'business.sector_id' => ['nullable', 'integer', Rule::exists('sectors', 'id')->where('is_active', true)],
|
||||
'business.secondary_sector_id' => ['nullable', 'integer', Rule::exists('sectors', 'id')->where('is_active', true)],
|
||||
'business.revenue' => ['nullable', 'string', 'regex:/^\d{1,16}(\.\d{1,2})?$/'],
|
||||
'business.cash_flow' => ['nullable', 'string', 'regex:/^-?\d{1,16}(\.\d{1,2})?$/'],
|
||||
'business.currency' => 'nullable|required_with:business.revenue,business.cash_flow|in:MZN,USD',
|
||||
'business.reason' => 'nullable|string|max:1000', 'business.availability' => 'nullable|in:available,sold',
|
||||
'property' => 'sometimes|nullable|array:transaction_type,property_type,land_area,built_area,area_unit,bedrooms,bathrooms,amenities,availability',
|
||||
'property.transaction_type' => 'nullable|in:sale,lease',
|
||||
'property.property_type' => ['nullable', Rule::in($property['property_type']['enum'])],
|
||||
'property.land_area' => 'nullable|numeric|gt:0', 'property.built_area' => 'nullable|numeric|gt:0',
|
||||
'property.area_unit' => ['nullable', Rule::in(OpportunityResources::AREA_UNITS)],
|
||||
'property.bedrooms' => 'nullable|integer|min:0|max:10000', 'property.bathrooms' => 'nullable|integer|min:0|max:10000',
|
||||
'property.amenities' => 'nullable|array|max:100', 'property.amenities.*' => 'string|max:250',
|
||||
'property.availability' => 'nullable|in:available,sold,leased',
|
||||
])->validate();
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $offer */
|
||||
public function assertCategory(array $offer, string $category): void
|
||||
{
|
||||
Validator::make($offer, [
|
||||
'business' => $category === 'business_sale' ? 'nullable|array' : 'prohibited',
|
||||
'property' => $category === 'real_estate' ? 'nullable|array' : 'prohibited',
|
||||
])->validate();
|
||||
}
|
||||
|
||||
/** Snapshot all active linked originals and metadata in the existing editorial version.
|
||||
* @return array<string,array<string,mixed>> */
|
||||
public function resources(Opportunity $record): array
|
||||
{
|
||||
$result = ['documents' => [], 'images' => [], 'locations' => []];
|
||||
foreach (array_keys($result) as $kind) {
|
||||
foreach (app(OpportunityResources::class)->listing($record->id, $kind) as $row) {
|
||||
if ($row->deleted_at !== null) {
|
||||
continue;
|
||||
}
|
||||
if ($kind !== 'locations') {
|
||||
$file = $row->file;
|
||||
$doc = DB::table('documents')->where('id', $row->document_id)->first();
|
||||
if (! $doc || $doc->deleted_at !== null || $doc->status !== 'active' || $doc->malware_scan_status !== 'clean'
|
||||
|| ! hash_equals(trim($doc->sha256), trim((string) $doc->malware_scanned_sha256))) {
|
||||
throw ValidationException::withMessages(['attachments' => 'Aguarde uma análise de segurança válida dos anexos.']);
|
||||
}
|
||||
$result[$kind][$row->id] = ['version' => $row->version, 'document_id' => $row->document_id, 'payload' => $row->payload, 'file' => $file];
|
||||
} else {
|
||||
$result[$kind][$row->id] = ['version' => $row->version, 'payload' => $row->payload];
|
||||
}
|
||||
}
|
||||
ksort($result[$kind]);
|
||||
}
|
||||
if (count($result['images']) > 6) {
|
||||
throw ValidationException::withMessages(['images' => 'A oferta admite no máximo seis fotografias.']);
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,296 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Models\User;
|
||||
use Illuminate\Database\Eloquent\Builder;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\Crypt;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Str;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
use Symfony\Component\HttpKernel\Exception\HttpExceptionInterface;
|
||||
|
||||
/** Availability, reports and administrative plans in the existing opportunity and CRM tasks. */
|
||||
final class PrivateOfferOperations
|
||||
{
|
||||
/** @param array<string,mixed> $context
|
||||
* @return array<string,mixed> */
|
||||
public function afterApproval(array $context): array
|
||||
{
|
||||
$days = config('private_offers.validity_days');
|
||||
$reference = config('private_offers.validity_policy_reference');
|
||||
if ($days !== null && (! is_int($days) || $days < 1 || $days > 36500 || ! is_string($reference) || trim($reference) === '')) {
|
||||
throw ValidationException::withMessages(['validity' => 'Configuração de validade incompleta. Não foi aplicado um prazo presumido.']);
|
||||
}
|
||||
$operation = $context['offer_operation'] ?? ['status' => 'available', 'cycle' => 0];
|
||||
$hash = $context['approval']['hash'];
|
||||
$policy = ['days' => $days, 'policy_reference' => $reference, 'approval_hash' => $hash];
|
||||
$operation['validity_policies'][$hash] ??= $policy;
|
||||
$operation['validity'] ??= $operation['validity_policies'][$hash];
|
||||
$operation['last_approval_hash'] = $hash;
|
||||
|
||||
return $operation;
|
||||
}
|
||||
|
||||
private function offer(int $id, bool $lock = false): Opportunity
|
||||
{
|
||||
$record = Opportunity::query()->when($lock, fn ($q) => $q->lockForUpdate())->findOrFail($id);
|
||||
abort_unless($record->isPrivateOfferPreparation(), 404);
|
||||
|
||||
return $record;
|
||||
}
|
||||
|
||||
public function publisher(User $actor, Opportunity $record): bool
|
||||
{
|
||||
$access = app(PortalProfileAccess::class);
|
||||
|
||||
return $access->canView($actor, $record) && $access->mfa($actor) && ! $access->has($actor, 'auditor') && ! $access->conflict($actor, $record)
|
||||
&& $access->scoped($actor, 'publisher', $record->organization_id, $record->opportunity_category) && $access->operational($actor, 'publish', $record->id);
|
||||
}
|
||||
|
||||
/** @return Builder<Opportunity> */
|
||||
public function staffQuery(User $actor): Builder
|
||||
{
|
||||
$access = app(PortalProfileAccess::class);
|
||||
abort_unless($access->mfa($actor) && ! $access->has($actor, 'auditor'), 403);
|
||||
$grants = [...$access->grants($actor, 'validator'), ...$access->grants($actor, 'publisher')];
|
||||
abort_unless($grants !== [], 403);
|
||||
|
||||
return $access->scope(Opportunity::query(), $actor)->whereNotNull('workflow_context->private_offer_preparation')
|
||||
->where('owner_user_id', '!=', $actor->id)->whereRaw("NOT COALESCE(workflow_context->'contributors','[]'::jsonb) @> ?::jsonb", [json_encode([$actor->id])])
|
||||
->where(fn ($q) => $q->whereNull('organization_id')->orWhereNotIn('organization_id', DB::table('memberships')->where('user_id', $actor->id)->whereNull('deleted_at')->select('organization_id')))
|
||||
->where(function ($q) use ($grants) {
|
||||
foreach ($grants as $grant) {
|
||||
$q->orWhere(function ($scope) use ($grant) {
|
||||
$scope->whereIn('opportunity_category', json_decode($grant->opportunity_types, true, 512, JSON_THROW_ON_ERROR));
|
||||
if ($grant->organization_id !== null) {
|
||||
$scope->where('organization_id', $grant->organization_id);
|
||||
}
|
||||
});
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function presentation(User $actor, int $id): array
|
||||
{
|
||||
$record = app(PrivateOfferPreparation::class)->record($actor, $id);
|
||||
$reviewer = app(PrivateOfferConfidentiality::class)->internal($actor, $record);
|
||||
$publisher = $this->publisher($actor, $record);
|
||||
$reports = [];
|
||||
if ($reviewer) {
|
||||
foreach ($record->workflow_context['offer_reports'] ?? [] as $report) {
|
||||
$reports[] = [...$report, 'reason' => Crypt::decryptString($report['reason']), 'resolution_reason' => isset($report['resolution_reason']) ? Crypt::decryptString($report['resolution_reason']) : null,
|
||||
'source_snapshot' => isset($report['source_snapshot']) ? json_decode(Crypt::decryptString($report['source_snapshot']), true, 512, JSON_THROW_ON_ERROR) : null];
|
||||
}
|
||||
}
|
||||
$highlight = $record->workflow_context['offer_highlight'] ?? null;
|
||||
|
||||
return ['id' => $id, 'etag' => app(OpportunityManagement::class)->etag($record),
|
||||
'availability' => app(OfferAvailability::class)->record($record), 'cycle' => $record->workflow_context['offer_operation']['cycle'] ?? 0,
|
||||
'owner' => app(PrivateOfferConfidentiality::class)->seller($actor, $record), 'reviewer' => $reviewer, 'publisher' => $publisher,
|
||||
'editorial_state' => app(PortalProfileAccess::class)->state($record), 'reports' => $reports,
|
||||
'highlight' => $publisher && $highlight ? [...$highlight, 'note' => Crypt::decryptString($highlight['note'])] : null,
|
||||
'commercial_activation' => false,
|
||||
'history' => array_map(fn ($event) => array_intersect_key($event, array_flip(['id', 'action', 'actor_id', 'at', 'cycle'])), $record->workflow_context['offer_operation_history'] ?? [])];
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $context
|
||||
* @param array<string,mixed> $metadata */
|
||||
private function save(Opportunity $record, ?User $actor, array $context, string $action, array $metadata = []): void
|
||||
{
|
||||
$event = ['id' => (string) Str::uuid(), 'action' => $action, 'actor_id' => $actor?->id, 'at' => now()->toIso8601String(),
|
||||
'cycle' => $context['offer_operation']['cycle'] ?? 0, ...$metadata];
|
||||
$context['offer_operation_history'][] = $event;
|
||||
$record->workflow_context = $context;
|
||||
$record->management_version++;
|
||||
$record->save();
|
||||
DB::table('audit_events')->insert(['source_system' => 'private-offers', 'entity_type' => 'opportunity', 'actor_user_id' => $actor?->id,
|
||||
'action' => $action, 'data_classification' => 'restricted', 'correlation_id' => (string) Str::uuid(),
|
||||
'after_data' => json_encode(['record_id' => $record->id, 'record_version' => $record->management_version, ...$event], JSON_THROW_ON_ERROR)]);
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $context
|
||||
* @return array<string,mixed> */
|
||||
private function withdraw(array $context, string $origin): array
|
||||
{
|
||||
$context['offer_operation'] = [...($context['offer_operation'] ?? ['cycle' => 0]), 'status' => 'withdrawn', 'withdrawn_at' => now()->toIso8601String(), 'origin' => $origin];
|
||||
|
||||
return $context;
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input */
|
||||
public function ownerAction(User $actor, int $id, array $input): Opportunity
|
||||
{
|
||||
$data = validator($input, ['action' => 'required|in:withdraw,request_reactivation,reactivate', 'confirm' => 'required|accepted',
|
||||
'etag' => 'required_unless:action,withdraw|string|size:64', 'reason' => 'nullable|string|max:1000'])->validate();
|
||||
|
||||
return DB::transaction(function () use ($actor, $id, $data) {
|
||||
$record = $this->offer($id, true);
|
||||
abort_unless(app(PrivateOfferConfidentiality::class)->seller($actor, $record), 403);
|
||||
$context = $record->workflow_context;
|
||||
$state = app(OfferAvailability::class)->record($record)['state'];
|
||||
if ($data['action'] === 'withdraw') {
|
||||
if (($context['offer_operation']['status'] ?? null) === 'withdrawn') {
|
||||
return $record;
|
||||
}
|
||||
$this->save($record, $actor, $this->withdraw($context, 'owner'), 'offer_withdrawn', ['reason' => Crypt::encryptString($data['reason'] ?? '')]);
|
||||
|
||||
return $record;
|
||||
}
|
||||
abort_unless(hash_equals(app(OpportunityManagement::class)->etag($record), $data['etag']), 409);
|
||||
if ($data['action'] === 'request_reactivation') {
|
||||
abort_unless(in_array($state, ['withdrawn', 'expired'], true), 409, 'A oferta não está retirada ou expirada.');
|
||||
$editorialState = app(PortalProfileAccess::class)->state($record);
|
||||
abort_unless(isset($context['submission']) || in_array($editorialState, ['draft', 'needs_information'], true), 409,
|
||||
'A preparação anterior ainda precisa da vinculação editorial existente antes de abrir nova revisão.');
|
||||
$context['offer_operation'] = [...($context['offer_operation'] ?? []), 'status' => 'revalidation', 'cycle' => ($context['offer_operation']['cycle'] ?? 0) + 1,
|
||||
'requested_by' => $actor->id, 'requested_at' => now()->toIso8601String()];
|
||||
// Reopen the same editorial engine, retaining old submissions and decisions.
|
||||
$record->workflow_context = $context;
|
||||
$record->save();
|
||||
if (isset($context['submission'])) {
|
||||
$record = app(OpportunityProfileWorkflow::class)->transition($actor, $id, ['etag' => app(OpportunityManagement::class)->etag($record),
|
||||
'action' => 'request_revision', 'reason' => 'Pedido explícito de nova validação para reactivar a oferta. '.($data['reason'] ?? '')]);
|
||||
}
|
||||
$this->save($record, $actor, $record->workflow_context, 'offer_reactivation_requested');
|
||||
|
||||
return $record;
|
||||
}
|
||||
abort_unless($state === 'revalidation' && app(PortalProfileAccess::class)->state($record) === 'approved', 409, 'É necessária nova validação editorial.');
|
||||
$snapshot = app(PrivateOfferPreparation::class)->snapshot($record);
|
||||
abort_unless(($snapshot['payload']['operational_cycle'] ?? null) === $context['offer_operation']['cycle']
|
||||
&& hash_equals($context['approval']['hash'] ?? '', $snapshot['hash'])
|
||||
&& ($context['submission']['payload']['operational_cycle'] ?? null) === $context['offer_operation']['cycle'], 409);
|
||||
$context['offer_operation']['status'] = 'available';
|
||||
$context['offer_operation']['activated_hash'] = $snapshot['hash'];
|
||||
$this->save($record, $actor, $context, 'offer_reactivated_privately');
|
||||
|
||||
return $record;
|
||||
});
|
||||
}
|
||||
|
||||
public function expire(int $id): bool
|
||||
{
|
||||
return DB::transaction(function () use ($id) {
|
||||
$record = $this->offer($id, true);
|
||||
$availability = app(OfferAvailability::class)->record($record);
|
||||
if ($availability['state'] !== 'expired' || ($record->workflow_context['offer_operation']['status'] ?? null) === 'expired') {
|
||||
return false;
|
||||
}
|
||||
$context = $record->workflow_context;
|
||||
$context['offer_operation'] = [...($context['offer_operation'] ?? []), 'status' => 'expired', 'expired_at' => $availability['expires_at']];
|
||||
$this->save($record, null, $context, 'offer_expired', ['expires_at' => $availability['expires_at']]);
|
||||
|
||||
return true;
|
||||
});
|
||||
}
|
||||
|
||||
public function canReport(User $actor, Opportunity $record): bool
|
||||
{
|
||||
if (app(PortalProfileAccess::class)->canView($actor, $record)) {
|
||||
return true;
|
||||
}
|
||||
try {
|
||||
app(OfferPublicCatalogue::class)->detail($record->id);
|
||||
|
||||
return true;
|
||||
} catch (HttpExceptionInterface $error) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input
|
||||
* @return array<string,mixed> */
|
||||
public function report(User $actor, int $id, array $input): array
|
||||
{
|
||||
$data = validator($input, ['client_key' => 'required|uuid', 'reason' => 'required|string|min:20|max:2000', 'confirm' => 'required|accepted'])->validate();
|
||||
|
||||
return DB::transaction(function () use ($actor, $id, $data) {
|
||||
$record = $this->offer($id, true);
|
||||
$context = $record->workflow_context;
|
||||
$key = $data['client_key'];
|
||||
$hash = hash('sha256', $data['reason']);
|
||||
if (isset($context['offer_reports'][$key])) {
|
||||
$previous = $context['offer_reports'][$key];
|
||||
abort_unless($previous['reporter_id'] === $actor->id, 404);
|
||||
abort_unless($previous['command_hash'] === $hash, 409);
|
||||
|
||||
return ['id' => $key, 'replayed' => true];
|
||||
}
|
||||
abort_unless($this->canReport($actor, $record), 404);
|
||||
try {
|
||||
$source = app(OfferPublicCatalogue::class)->detail($id);
|
||||
} catch (HttpExceptionInterface $error) {
|
||||
$source = Arr::only(app(OpportunityManagement::class)->values($record), ['title', 'description', 'opportunity_category', 'private_offer']);
|
||||
}
|
||||
$task = app(OpportunityWorkflowTasks::class)->ensure($record, 'offer_report_'.$key, 'Denúncia da Oferta '.$record->reference);
|
||||
$context['offer_reports'][$key] = ['id' => $key, 'reporter_id' => $actor->id, 'at' => now()->toIso8601String(), 'command_hash' => $hash,
|
||||
'reason' => Crypt::encryptString($data['reason']), 'version' => 1, 'status' => 'open', 'task_id' => $task,
|
||||
'source_snapshot' => Crypt::encryptString(json_encode($source, JSON_THROW_ON_ERROR)),
|
||||
'source_record_version' => $record->management_version, 'source_approval_hash' => $context['approval']['hash'] ?? null,
|
||||
'source_public_hash' => $context['offer_publication']['publication']['hash'] ?? null];
|
||||
$this->save($record, $actor, $context, 'offer_reported', ['report_id' => $key]);
|
||||
|
||||
return ['id' => $key, 'replayed' => false];
|
||||
});
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input */
|
||||
public function handleReport(User $actor, int $id, string $reportId, array $input): void
|
||||
{
|
||||
$data = validator($input, ['etag' => 'required|string|size:64', 'version' => 'required|integer|min:1', 'action' => 'required|in:start_review,resolve_no_withdrawal,resolve_withdrawal',
|
||||
'reason' => 'required|string|min:20|max:2000', 'confirm' => 'required|accepted'])->validate();
|
||||
DB::transaction(function () use ($actor, $id, $reportId, $data) {
|
||||
$record = $this->offer($id, true);
|
||||
abort_unless(app(PrivateOfferConfidentiality::class)->internal($actor, $record), 403);
|
||||
abort_unless(hash_equals(app(OpportunityManagement::class)->etag($record), $data['etag']), 409);
|
||||
$context = $record->workflow_context;
|
||||
$report = $context['offer_reports'][$reportId] ?? null;
|
||||
abort_unless($report !== null, 404);
|
||||
abort_unless($report['version'] === (int) $data['version'] && in_array($report['status'], ['open', 'in_review'], true), 409);
|
||||
if ($data['action'] === 'start_review') {
|
||||
abort_unless($report['status'] === 'open', 409);
|
||||
app(OpportunityWorkflowTasks::class)->assign($record, $report['task_id'], $actor);
|
||||
$report['status'] = 'in_review';
|
||||
} else {
|
||||
abort_unless($report['status'] === 'in_review' && $report['reviewer_id'] === $actor->id, 409, 'A denúncia deve ser tratada pelo revisor que a iniciou.');
|
||||
app(OpportunityWorkflowTasks::class)->complete($report['task_id'], 'Denúncia tratada; decisão no histórico privado.');
|
||||
$report['status'] = 'resolved';
|
||||
$report['resolution'] = $data['action'];
|
||||
if ($data['action'] === 'resolve_withdrawal') {
|
||||
$context = $this->withdraw($context, 'moderation');
|
||||
}
|
||||
}
|
||||
$report['reviewer_id'] = $actor->id;
|
||||
$report['version']++;
|
||||
$report['updated_at'] = now()->toIso8601String();
|
||||
$report['resolution_reason'] = Crypt::encryptString($data['reason']);
|
||||
$report['history'][] = ['action' => $data['action'], 'actor_id' => $actor->id, 'at' => now()->toIso8601String(), 'reason' => Crypt::encryptString($data['reason'])];
|
||||
$context['offer_reports'][$reportId] = $report;
|
||||
$this->save($record, $actor, $context, 'offer_report_'.$data['action'], ['report_id' => $reportId]);
|
||||
});
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input */
|
||||
public function highlight(User $actor, int $id, array $input): void
|
||||
{
|
||||
$data = validator($input, ['etag' => 'required|string|size:64', 'version' => 'required|integer|min:0', 'status' => 'required|in:draft,archived',
|
||||
'label' => 'required|string|max:150', 'starts_at' => 'nullable|date', 'ends_at' => 'nullable|required_with:starts_at|date|after:starts_at',
|
||||
'note' => 'required|string|min:20|max:1000', 'confirm' => 'required|accepted'])->validate();
|
||||
DB::transaction(function () use ($actor, $id, $data) {
|
||||
$record = $this->offer($id, true);
|
||||
abort_unless($this->publisher($actor, $record), 403);
|
||||
$context = $record->workflow_context;
|
||||
$before = $context['offer_highlight'] ?? null;
|
||||
abort_unless(hash_equals(app(OpportunityManagement::class)->etag($record), $data['etag']) && (int) $data['version'] === ($before['version'] ?? 0), 409);
|
||||
$plan = ['version' => (int) $data['version'] + 1, 'status' => $data['status'], 'label' => $data['label'], 'starts_at' => $data['starts_at'] ?? null,
|
||||
'ends_at' => $data['ends_at'] ?? null, 'note' => Crypt::encryptString($data['note']), 'actor_id' => $actor->id, 'at' => now()->toIso8601String()];
|
||||
$context['offer_highlight_history'][] = $before;
|
||||
$context['offer_highlight'] = $plan;
|
||||
$this->save($record, $actor, $context, 'offer_highlight_prepared', ['plan_version' => $plan['version'], 'status' => $plan['status']]);
|
||||
});
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,230 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Models\User;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
use Illuminate\Validation\Rule;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
|
||||
/** Private commercial adapter: the existing opportunity owns identity, workflow and audit. */
|
||||
final class PrivateOfferPreparation
|
||||
{
|
||||
/** @return array<string,mixed> */
|
||||
public function validate(mixed $input, bool $complete = false): array
|
||||
{
|
||||
$validated = Validator::make(['private_offer' => $input], [
|
||||
'private_offer' => 'present|array:price_mode,amount,currency,contact_id,business,property',
|
||||
'private_offer.price_mode' => 'nullable|in:amount,negotiable',
|
||||
'private_offer.amount' => ['nullable', 'string', ...($complete ? ['required_if:private_offer.price_mode,amount'] : []), 'prohibited_unless:private_offer.price_mode,amount', 'regex:/^\d{1,16}(\.\d{1,2})?$/'],
|
||||
'private_offer.currency' => ['nullable', ...($complete ? ['required_if:private_offer.price_mode,amount'] : []), 'prohibited_unless:private_offer.price_mode,amount', 'in:MZN,USD'],
|
||||
'private_offer.contact_id' => 'nullable|uuid',
|
||||
'private_offer.business' => 'sometimes|nullable|array',
|
||||
'private_offer.property' => 'sometimes|nullable|array',
|
||||
])->validate()['private_offer'];
|
||||
|
||||
return array_replace($validated, app(PrivateOfferDetails::class)->validate(array_intersect_key($validated, array_flip(['business', 'property']))));
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $input */
|
||||
public function save(User $actor, array $input, ?int $id = null): Opportunity
|
||||
{
|
||||
foreach (['title', 'description'] as $field) {
|
||||
if (is_string($input[$field] ?? null)) {
|
||||
$input[$field] = trim($input[$field]);
|
||||
}
|
||||
}
|
||||
$allowed = ['creation_key', 'etag', 'reason', 'title', 'description', 'opportunity_category', 'organization_id', 'private_offer', ...array_keys(InvestmentGeography::FIELDS)];
|
||||
if (array_diff(array_keys($input), $allowed)) {
|
||||
throw ValidationException::withMessages(['offer' => 'O pedido contém campos fora da preparação privada.']);
|
||||
}
|
||||
Validator::make($input, ['opportunity_category' => ['sometimes', 'required', Rule::in(OpportunityManagement::CATEGORIES)]])->validate();
|
||||
|
||||
return DB::transaction(function () use ($actor, $input, $id) {
|
||||
$record = app(OpportunityManagement::class)->save($actor, $input, $id, true);
|
||||
$values = app(OpportunityManagement::class)->values($record);
|
||||
app(PrivateOfferDetails::class)->assertCategory($values['private_offer'] ?? [], $values['opportunity_category']);
|
||||
$contactId = app(OpportunityManagement::class)->values($record)['private_offer']['contact_id'] ?? null;
|
||||
if ($contactId && ! app(OpportunityContacts::class)->related($record, $contactId)) {
|
||||
throw ValidationException::withMessages(['private_offer.contact_id' => 'Seleccione um contacto autorizado do promotor.']);
|
||||
}
|
||||
|
||||
return $record;
|
||||
});
|
||||
}
|
||||
|
||||
public function record(User $actor, int $id, bool $edit = false): Opportunity
|
||||
{
|
||||
$record = Opportunity::findOrFail($id);
|
||||
abort_unless($record->isPrivateOfferPreparation(), 404);
|
||||
app(PortalProfileAccess::class)->authorize($actor, $edit ? 'edit' : 'view', $record);
|
||||
|
||||
return $record;
|
||||
}
|
||||
|
||||
/** Register submission through the existing editorial engine when available.
|
||||
* @param array<string,mixed> $input */
|
||||
public function submit(User $actor, int $id, array $input): Opportunity
|
||||
{
|
||||
$data = Validator::make($input, ['etag' => 'required|string|size:64', 'confirm' => 'required|accepted'])->validate();
|
||||
if (app(PortalEditorialWorkflow::class)->available()) {
|
||||
$record = $this->record($actor, $id);
|
||||
$access = app(PortalProfileAccess::class);
|
||||
if ($access->state($record) === 'submitted') {
|
||||
abort_unless($access->promoterRecordScope($actor, $record) && $access->canCreate($actor, $record->organization_id, $record->opportunity_category)
|
||||
&& $access->operational($actor, 'edit', $id), 403);
|
||||
abort_unless(hash_equals(app(OpportunityManagement::class)->etag($record), $data['etag']), 409);
|
||||
|
||||
return $record;
|
||||
}
|
||||
|
||||
return app(OpportunityProfileWorkflow::class)->transition($actor, $id, [...$data, 'action' => 'submit', 'reason' => 'Submissão privada da oferta conferida pelo promotor.']);
|
||||
}
|
||||
|
||||
return DB::transaction(function () use ($actor, $id, $data) {
|
||||
$record = Opportunity::whereKey($id)->lockForUpdate()->firstOrFail();
|
||||
abort_unless($record->isPrivateOfferPreparation(), 404);
|
||||
$access = app(PortalProfileAccess::class);
|
||||
$access->authorize($actor, 'view', $record);
|
||||
abort_if(($record->workflow_context['private_offer_preparation']['version'] ?? 1) >= 2, 503, 'O circuito editorial está indisponível. A versão e o histórico foram preservados; não é permitida a retoma pelo percurso anterior.');
|
||||
abort_unless($access->promoterRecordScope($actor, $record)
|
||||
&& $access->canCreate($actor, $record->organization_id, $record->opportunity_category)
|
||||
&& $access->operational($actor, 'edit', $record->id), 403);
|
||||
$management = app(OpportunityManagement::class);
|
||||
abort_unless(hash_equals($management->etag($record), $data['etag']), 409, 'A oferta mudou. Recupere a versão actual antes de submeter.');
|
||||
if (data_get($record->workflow_context, 'private_offer_preparation.state') === 'submitted') {
|
||||
return $record;
|
||||
}
|
||||
$access->authorize($actor, 'edit', $record);
|
||||
$values = $management->values($record);
|
||||
Validator::make($values, ['title' => 'required|string|max:150', 'description' => 'required|string|max:50000',
|
||||
'opportunity_category' => 'required', 'private_offer.price_mode' => 'required|in:amount,negotiable', 'private_offer.contact_id' => 'required|uuid'])->validate();
|
||||
$this->validate($values['private_offer'], true);
|
||||
if (! app(OpportunityContacts::class)->related($record, $values['private_offer']['contact_id'])) {
|
||||
throw ValidationException::withMessages(['private_offer.contact_id' => 'O contacto já não está disponível neste âmbito.']);
|
||||
}
|
||||
// Recheck revoked grants and representation inside the same transaction.
|
||||
abort_unless($access->canCreate($actor, $record->organization_id, $record->opportunity_category), 403);
|
||||
$path = app(InvestmentGeography::class)->path($record->primary_territory_id, true);
|
||||
if ($record->primary_territory_id && $path === []) {
|
||||
throw ValidationException::withMessages(['province_id' => 'Reconcilie a localização antes de submeter.']);
|
||||
}
|
||||
if ($path !== []) {
|
||||
app(InvestmentGeography::class)->selection(array_combine(array_slice(array_keys(InvestmentGeography::FIELDS), 0, count($path)), array_column($path, 'id')), true);
|
||||
}
|
||||
$context = $record->workflow_context;
|
||||
$context['private_offer_preparation'] = ['version' => 1, 'state' => 'submitted', 'submitted_by' => $actor->id,
|
||||
'submitted_at' => now()->toIso8601String(), 'submitted_revision' => $record->management_version];
|
||||
$record->workflow_context = $context;
|
||||
$record->management_version++;
|
||||
$record->save();
|
||||
$access->audit($actor, 'private_offer_submitted', ['record_id' => $record->id, 'version' => $record->management_version, 'public' => false]);
|
||||
|
||||
return $record;
|
||||
});
|
||||
}
|
||||
|
||||
/** Adapter of the five common fields; never relaxes the full canonical contract.
|
||||
* @return array<string,mixed> */
|
||||
public function snapshot(Opportunity $record): array
|
||||
{
|
||||
$values = app(OpportunityManagement::class)->values($record);
|
||||
Validator::make($values, ['title' => 'required|string|max:150', 'description' => 'required|string|max:50000',
|
||||
'opportunity_category' => 'required', 'private_offer.price_mode' => 'required|in:amount,negotiable', 'private_offer.contact_id' => 'required|uuid'])->validate();
|
||||
$offer = $this->validate($values['private_offer'], true);
|
||||
app(PrivateOfferDetails::class)->assertCategory($offer, $values['opportunity_category']);
|
||||
$resources = app(PrivateOfferDetails::class)->resources($record);
|
||||
if (! app(OpportunityContacts::class)->related($record, $offer['contact_id'])) {
|
||||
throw ValidationException::withMessages(['private_offer.contact_id' => 'O contacto já não está disponível neste âmbito.']);
|
||||
}
|
||||
$contact = DB::table('contacts')->where('id', $offer['contact_id'])->first();
|
||||
$path = app(InvestmentGeography::class)->path($values['primary_territory_id'] ?? null, true);
|
||||
if (! empty($values['primary_territory_id']) && $path === []) {
|
||||
throw ValidationException::withMessages(['province_id' => 'Reconcilie a localização antes da decisão.']);
|
||||
}
|
||||
if ($path !== []) {
|
||||
app(InvestmentGeography::class)->selection(array_combine(array_slice(array_keys(InvestmentGeography::FIELDS), 0, count($path)), array_column($path, 'id')), true);
|
||||
}
|
||||
$payload = ['title' => $values['title'], 'description' => $values['description'], 'opportunity_category' => $values['opportunity_category'],
|
||||
'owner_user_id' => $record->owner_user_id, 'organization_id' => $record->organization_id, 'private_offer' => $offer,
|
||||
'contact_fingerprint' => hash('sha256', json_encode($contact, JSON_THROW_ON_ERROR)), 'territory' => $path];
|
||||
$extended = isset($offer['business']) || isset($offer['property']) || array_filter($resources) !== [];
|
||||
if ($extended) {
|
||||
$payload['resources'] = $resources;
|
||||
}
|
||||
$cycle = $record->workflow_context['offer_operation']['cycle'] ?? 0;
|
||||
if ($cycle > 0) {
|
||||
$payload['operational_cycle'] = $cycle;
|
||||
}
|
||||
$normalize = function (mixed $value) use (&$normalize): mixed {
|
||||
if (is_object($value)) {
|
||||
$value = get_object_vars($value);
|
||||
}
|
||||
if (! is_array($value)) {
|
||||
return $value;
|
||||
}
|
||||
if (! array_is_list($value)) {
|
||||
ksort($value);
|
||||
}
|
||||
|
||||
return array_map($normalize, $value);
|
||||
};
|
||||
$payload = $normalize($payload);
|
||||
|
||||
$contract = $cycle > 0 ? 'private-offer-editorial-v4' : ($extended ? 'private-offer-editorial-v3' : 'private-offer-editorial-v2');
|
||||
|
||||
return ['payload' => $payload, 'hash' => hash('sha256', json_encode(['contract' => $contract, 'payload' => $payload], JSON_THROW_ON_ERROR)),
|
||||
'record_version' => $record->management_version, 'contract_version' => $contract, 'resources' => $resources];
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function presentation(User $actor, Opportunity $record): array
|
||||
{
|
||||
app(PortalProfileAccess::class)->authorize($actor, 'view', $record);
|
||||
$values = app(OpportunityManagement::class)->values($record);
|
||||
$fresh = null;
|
||||
$contactId = $values['private_offer']['contact_id'] ?? null;
|
||||
$contactLabel = $contactId && app(OpportunityContacts::class)->related($record, $contactId)
|
||||
? DB::table('contacts')->where('id', $contactId)->value('full_name') : null;
|
||||
if (isset($record->workflow_context['approval'])) {
|
||||
try {
|
||||
$fresh = hash_equals($record->workflow_context['approval']['hash'], $this->snapshot($record)['hash']);
|
||||
} catch (ValidationException $error) {
|
||||
$fresh = false;
|
||||
}
|
||||
}
|
||||
$history = $record->workflow_context['events'] ?? [];
|
||||
$names = User::whereIn('id', array_filter([...array_column($history, 'actor_id'), ...array_column($history, 'assignee_user_id')]))->pluck('name', 'id');
|
||||
$history = array_map(fn ($event) => [...$event, 'actor_name' => $names[$event['actor_id']] ?? 'Interveniente indisponível',
|
||||
'assignee_name' => isset($event['assignee_user_id']) ? ($names[$event['assignee_user_id']] ?? 'Interveniente indisponível') : null], $history);
|
||||
$versions = [...($record->workflow_context['decision_history'] ?? []), ...($record->workflow_context['submission_history'] ?? [])];
|
||||
if (isset($record->workflow_context['submission'])) {
|
||||
$versions[] = ['submission' => $record->workflow_context['submission'], 'approval' => $record->workflow_context['approval'] ?? null,
|
||||
'rejection' => $record->workflow_context['rejection'] ?? null];
|
||||
}
|
||||
$uniqueVersions = [];
|
||||
foreach ($versions as $version) {
|
||||
if (! isset($version['submission']['payload']['private_offer'])) {
|
||||
continue;
|
||||
}
|
||||
$key = $version['submission']['record_version'].':'.$version['submission']['hash'].':'.($version['submission']['review_cycle'] ?? 0);
|
||||
$previous = $uniqueVersions[$key] ?? [];
|
||||
$uniqueVersions[$key] = ['submission' => $version['submission'], 'approval' => $version['approval'] ?? $previous['approval'] ?? null,
|
||||
'rejection' => $version['rejection'] ?? $previous['rejection'] ?? null];
|
||||
}
|
||||
$workflow = app(OpportunityProfileWorkflow::class);
|
||||
$actions = $workflow->actions($actor, $record);
|
||||
|
||||
return ['id' => $record->id, 'reference' => $record->reference, 'values' => $values,
|
||||
'etag' => app(OpportunityManagement::class)->etag($record), 'state' => app(PortalProfileAccess::class)->state($record),
|
||||
'canEdit' => app(PortalProfileAccess::class)->canEdit($actor, $record), 'organization_id' => $record->organization_id,
|
||||
'actions' => $actions,
|
||||
'reviewers' => in_array('assign_review', $actions, true) ? $workflow->participants($actor, $record)['validators'] : [],
|
||||
'reauthenticationRequired' => app(OpportunityProfileWorkflow::class)->reauthenticationRequired($actor, $record),
|
||||
'history' => $history, 'submittedVersions' => array_values($uniqueVersions), 'correctionItems' => $record->workflow_context['correction_items'] ?? [],
|
||||
'approval' => $record->workflow_context['approval'] ?? null, 'approvalFresh' => $fresh, 'contactLabel' => $contactLabel, 'tasks' => app(OpportunityWorkflowTasks::class)->listing($record),
|
||||
'territory' => app(InvestmentGeography::class)->path($values['primary_territory_id'] ?? null, true)];
|
||||
}
|
||||
}
|
||||
@@ -4,7 +4,10 @@ namespace App\Services;
|
||||
|
||||
use App\Models\Opportunity;
|
||||
use App\Models\User;
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Database\Query\Builder;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Collection;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
@@ -36,6 +39,298 @@ final class ProactiveSupply
|
||||
});
|
||||
}
|
||||
|
||||
/** Aggregate access never confers the existing internal row/source permission. */
|
||||
public function aggregateAvailable(): bool
|
||||
{
|
||||
return (bool) config('investor-path.protected_supply_enabled')
|
||||
|| (config('investor-path.aggregate_supply_qa_enabled') && IsolatedQaDatabase::allowsSchemaChanges());
|
||||
}
|
||||
|
||||
/** Fixed district/division cells; filters select released cells, never recalculate intersections.
|
||||
* @param array<string,mixed> $fields
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function protectedAggregate(User $actor, string $caseId, string $territory, array $fields): array
|
||||
{
|
||||
abort_unless(config('investor-path.protected_supply_enabled'), 404);
|
||||
$case = app(VirtualDesk::class)->case($actor, $caseId, true, true);
|
||||
abort_unless((int) $case->user_id === (int) $actor->id, 403);
|
||||
app(VirtualDesk::class)->assertOpen($case);
|
||||
$geo = app(InvestmentGeography::class);
|
||||
$path = collect($geo->path($territory));
|
||||
$province = $path->firstWhere('location_type', 'province');
|
||||
abort_unless($province !== null, 422, 'Guarde uma localização com província conhecida no dossier.');
|
||||
$scope = $path->firstWhere('location_type', 'district') ?? $province;
|
||||
$nodes = $geo->publicReferences()->whereIn('id', $geo->descendants($province->id))->get(['id', 'parent_id', 'name', 'location_type'])->keyBy('id');
|
||||
$mapping = [];
|
||||
$scopes = [$province->id => $province];
|
||||
foreach ($nodes as $node) {
|
||||
$current = $node;
|
||||
for ($depth = 0; $current && $depth < 5; $depth++) {
|
||||
if ($current->location_type === 'district' || $current->location_type === 'province') {
|
||||
break;
|
||||
}
|
||||
$current = $nodes->get($current->parent_id);
|
||||
}
|
||||
if ($current && in_array($current->location_type, ['district', 'province'], true)) {
|
||||
$mapping[$node->id] = $current->id;
|
||||
$scopes[$current->id] = $current;
|
||||
}
|
||||
}
|
||||
$activities = $this->publicAggregateActivities();
|
||||
$divisions = $activities->filter(fn ($a) => preg_match('/^[0-9]{2}$/D', $a->code) === 1)->groupBy('code');
|
||||
$sector = isset($fields['sector_id']) ? (int) $fields['sector_id'] : null;
|
||||
$sourcePlan = ! empty($fields['supply_classification_key']) ? $this->sourceClassificationPlan($fields['supply_classification_key']) : null;
|
||||
abort_unless($sourcePlan || $divisions->contains(fn ($references) => $references->contains(fn ($a) => ! $sector || (int) $a->effective_sector_id === $sector)), 422,
|
||||
'Escolha a actividade a comparar na classificação das fontes. O sector do dossier mantém-se guardado; não se presume uma equivalência. Esta limitação não significa ausência de empresas.');
|
||||
$activity = ! $sourcePlan && ! empty($fields['activity_id']) ? $activities->firstWhere('id', $fields['activity_id']) : null;
|
||||
abort_if(! $sourcePlan && ! empty($fields['activity_id']) && ! $activity, 422, 'A actividade guardada não está disponível nesta classificação. Reveja o contexto.');
|
||||
abort_if($activity && $sector && (int) $activity->effective_sector_id !== $sector, 422, 'A actividade não corresponde ao sector guardado. Reveja o contexto.');
|
||||
$rawActivityCode = $activity?->code;
|
||||
abort_if($activity && ! is_string($rawActivityCode), 422, 'A referência de actividade não tem um código válido.');
|
||||
$activityCode = is_string($rawActivityCode) ? str_replace('.', '', $rawActivityCode) : null;
|
||||
abort_if($activityCode && ! preg_match('/^[0-9]{2,5}$/D', $activityCode), 422, 'Seleccione uma actividade com código CAE disponível.');
|
||||
$division = $activityCode ? substr($activityCode, 0, 2) : null;
|
||||
$previous = DB::selectOne("select current_setting('app.actor_user_id',true) as actor,current_setting('app.proactive_supply_read',true) as scope");
|
||||
|
||||
return $this->read($actor, function () use ($mapping, $scopes, $province, $scope, $territory, $path, $divisions, $sector, $division, $activity, $previous, $sourcePlan): array {
|
||||
try {
|
||||
$parts = [];
|
||||
$bindings = [];
|
||||
foreach ($mapping as $id => $parent) {
|
||||
$parts[] = 'WHEN ? THEN ?';
|
||||
$bindings[] = $id;
|
||||
$bindings[] = $parent;
|
||||
}
|
||||
$scopeSql = 'CASE o.territory_id::text '.implode(' ', $parts).' ELSE NULL END';
|
||||
$codeSql = "CASE WHEN replace(o.cae,'.','') ~ '^[0-9]{2,5}$' THEN substring(replace(o.cae,'.','') from 1 for 2) ELSE NULL END";
|
||||
$query = DB::table('proactive_supply_observations as o')->join('proactive_supply_sources as s', 's.sha256', '=', 'o.source_hash');
|
||||
if ($sourcePlan) {
|
||||
$this->joinSourceClassification($query, $sourcePlan);
|
||||
$codeSql = $this->sourceClassificationExpression();
|
||||
}
|
||||
$rows = $query->whereIn('o.territory_id', array_keys($mapping))
|
||||
->whereRaw("s.receipt->>'candidate' = ? AND s.receipt->>'access' = 'internal'", ['a022ed9848b41ba342b4209414c2bbf2ebd0a7a3'])
|
||||
->whereNull('o.duplicate_of')->where('o.identity_conflict', false)->whereRaw("trim(o.name) <> ''")
|
||||
// The accepted importer uses an observation-specific key when NUIT is unresolved.
|
||||
// Those keys must never masquerade as distinct documentary entities in the cohort.
|
||||
->whereRaw("o.entity_key <> encode(sha256(convert_to('unresolved:' || o.source_hash || '|' || o.sheet || '|' || o.row_number::text,'UTF8')),'hex')")
|
||||
->selectRaw($scopeSql.' as scope_id,'.$codeSql.' as code,count(DISTINCT o.entity_key) as entities,count(*) as observations', $bindings)
|
||||
->groupByRaw('1,2')->orderByRaw('1,2')->get();
|
||||
$groups = [];
|
||||
foreach ($rows as $row) {
|
||||
// Suppressed and absent cells have the same public representation. No marginal totals.
|
||||
if ((int) $row->entities < 5 || ! $row->code || (! $sourcePlan && ! $divisions->has($row->code))) {
|
||||
continue;
|
||||
}
|
||||
$references = $divisions->get($row->code, collect());
|
||||
if (! $sourcePlan && $sector && ! $references->contains(fn ($a) => (int) $a->effective_sector_id === $sector)) {
|
||||
continue;
|
||||
}
|
||||
if (($sourcePlan && $row->code !== $sourcePlan['selected']['group']) || (! $sourcePlan && $division && $row->code !== $division)) {
|
||||
continue;
|
||||
}
|
||||
if ($scope->id !== $province->id && ! in_array($row->scope_id, [$scope->id, $province->id], true)) {
|
||||
continue;
|
||||
}
|
||||
$labels = $references->pluck('label_pt_mz')->unique();
|
||||
$cellScope = $scopes[$row->scope_id];
|
||||
$groups[] = ['code' => $sourcePlan ? $sourcePlan['selected']['group_code'] : $row->code, 'label' => $sourcePlan ? $sourcePlan['selected']['group_label'] : ($labels->count() === 1 ? $labels->first() : 'Grupo CAE '.$row->code),
|
||||
...($sourcePlan ? ['classification_key' => $row->code] : []),
|
||||
'total' => null, 'entities_band' => $this->countBand((int) $row->entities), 'observations_band' => $this->countBand((int) $row->observations),
|
||||
'scope' => ['id' => $cellScope->id, 'name' => $cellScope->name, 'level' => $cellScope->location_type], 'first_year' => null, 'last_year' => null];
|
||||
}
|
||||
$years = [];
|
||||
$unknownPeriod = false;
|
||||
foreach (DB::table('proactive_supply_sources')->whereRaw("receipt->>'candidate' = ? AND receipt->>'access' = 'internal'", ['a022ed9848b41ba342b4209414c2bbf2ebd0a7a3'])->pluck('period') as $period) {
|
||||
preg_match_all('/\b(?:19|20)[0-9]{2}\b/', $period, $matches);
|
||||
if (! $matches[0]) {
|
||||
$unknownPeriod = true;
|
||||
}
|
||||
$years = [...$years, ...$matches[0]];
|
||||
}
|
||||
sort($years);
|
||||
$period = $years ? $years[0].($years[0] !== $years[array_key_last($years)] ? '–'.$years[array_key_last($years)] : '') : 'Por confirmar';
|
||||
|
||||
return ['privacy_version' => 1, 'privacy_policy' => 'fixed_district_cae_division_v1',
|
||||
'requested_territory' => ['id' => $territory, 'name' => $path->last()->name],
|
||||
'scope' => ['id' => $scope->id, 'name' => $scope->name, 'level' => $scope->location_type],
|
||||
'broader_context' => $scope->id !== $territory, 'entities' => null, 'repeated' => null, 'uncertain' => null,
|
||||
'groups' => $groups, 'truncated' => false, 'coverage_unknown' => true,
|
||||
'filters' => ['sector_id' => $sector, 'activity_id' => $activity?->id, 'activity_label' => $activity?->label_pt_mz, 'division_code' => $sourcePlan ? $sourcePlan['selected']['group_code'] : $division,
|
||||
...($sourcePlan ? ['classification_key' => $sourcePlan['selected']['id'], 'classification_label' => $sourcePlan['selected']['label'], 'classification_basis' => 'Hierarquia e designações do exemplar eBAU já utilizado nas fontes; correspondência por código ou designação exacta, sem equivalência presumida ao sector do dossier.'] : [])],
|
||||
'source_summary' => ['label' => 'Base administrativa empresarial histórica incorporada no portal', 'period' => $period, 'incomplete_periods' => $unknownPeriod],
|
||||
'limitations' => self::LIMITATIONS,
|
||||
'interpretation' => 'Intervalos de cinco identidades documentais, nunca empresas únicas confirmadas. Observações consolidadas e identidades são medidas distintas. Uma identidade pode constar em várias actividades; não some grupos. Grupos com menos de cinco identidades, conflitos e dados sem classificação publicada não são divulgados; nenhum resultado pode significar ausência de registos ou protecção de informação.',
|
||||
'privacy_notice' => 'A precisão mínima é distrital e a actividade é apresentada por divisão CAE. Não há totais marginais, contagens exactas, filtros livres ou datas por grupo. Dados apenas provinciais são contexto provincial, não implantação no distrito. Estes controlos reduzem a identificação indirecta; não constituem garantia matemática contra conhecimento externo.'];
|
||||
} finally {
|
||||
DB::select("select set_config('app.actor_user_id',?,true),set_config('app.proactive_supply_read',?,true)", [$previous->actor ?? '', $previous->scope ?? '']);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
private function countBand(int $count): string
|
||||
{
|
||||
$lower = intdiv($count, 5) * 5;
|
||||
|
||||
return $lower.'–'.($lower + 4);
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
private function sourceClassificationPlan(string $key): array
|
||||
{
|
||||
$nodes = collect(app(EconomicReferenceCatalog::class)->supplyClassification()['nodes']);
|
||||
$selected = $nodes->firstWhere('id', $key);
|
||||
abort_unless($selected !== null, 422, 'A classificação seleccionada não consta do exemplar disponível.');
|
||||
$codes = $labels = [];
|
||||
foreach ($nodes->groupBy(fn ($n) => mb_strtoupper(str_replace('.', '', trim($n['code'])))) as $code => $items) {
|
||||
if ($items->pluck('group')->unique()->count() === 1) {
|
||||
$codes[] = [(string) $code, $items->first()['group']];
|
||||
}
|
||||
}
|
||||
foreach ($nodes->groupBy(fn ($n) => mb_strtolower(trim($n['label']))) as $label => $items) {
|
||||
if ($items->pluck('group')->unique()->count() === 1) {
|
||||
$labels[] = [(string) $label, $items->first()['group']];
|
||||
}
|
||||
}
|
||||
|
||||
return ['selected' => $selected, 'codes' => $codes, 'labels' => $labels];
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $plan */
|
||||
private function joinSourceClassification(Builder $query, array $plan): void
|
||||
{
|
||||
foreach (['codes' => ['class_code', 'upper(replace(btrim(o.cae),\'.\',\'\'))'], 'labels' => ['class_label', "translate(lower(btrim(o.activity)),'ÁÀÂÃÉÊÍÓÔÕÚÜÇ','áàâãéêíóôõúüç')"]] as $kind => [$alias, $expression]) {
|
||||
$rows = $plan[$kind];
|
||||
$values = implode(',', array_fill(0, count($rows), '(?::text,?::text)'));
|
||||
$query->leftJoin(DB::raw('(VALUES '.$values.') AS '.$alias.'(value,group_id)'), function ($join) use ($alias, $expression) {
|
||||
$join->on(DB::raw($expression), '=', $alias.'.value');
|
||||
})->addBinding(array_merge(...$rows), 'join');
|
||||
}
|
||||
}
|
||||
|
||||
/** @return literal-string */
|
||||
private function sourceClassificationExpression(): string
|
||||
{
|
||||
// Already accepted tourism import: documentary scope is accommodation, not a certified hotel subtype.
|
||||
return "CASE WHEN o.source_hash='f02e086ed4973ef17234aa6cc54b98fbb7a6952ffb16ec4dc4f7d0c72af6400c' AND btrim(o.cae)='' AND o.activity='Alojamento (âmbito do exemplar; categoria por conferir)' THEN 'ebau:158'
|
||||
WHEN class_code.group_id IS NOT NULL THEN CASE WHEN btrim(o.activity)='' OR class_label.group_id=class_code.group_id THEN class_code.group_id ELSE NULL END ELSE class_label.group_id END";
|
||||
}
|
||||
|
||||
/** @return Collection<int,\stdClass> */
|
||||
private function publicAggregateActivities(): Collection
|
||||
{
|
||||
$rows = app(EconomicReferenceCatalog::class)->activities()->keyBy('id');
|
||||
|
||||
return $rows->map(function ($row) use ($rows) {
|
||||
$result = clone $row;
|
||||
$current = $row;
|
||||
$result->effective_sector_id = null;
|
||||
for ($i = 0; $current && $i < 10; $i++) {
|
||||
if ($current->sector_id !== null) {
|
||||
$result->effective_sector_id = (int) $current->sector_id;
|
||||
break;
|
||||
}
|
||||
$current = $current->parent_id ? $rows->get($current->parent_id) : null;
|
||||
}
|
||||
|
||||
return $result;
|
||||
})->values();
|
||||
}
|
||||
|
||||
/** @return list<array{id:string,code:string,label:string}> */
|
||||
public function aggregateActivityOptions(?int $sector): array
|
||||
{
|
||||
$rows = $this->publicAggregateActivities();
|
||||
$divisions = $rows->filter(fn ($a) => preg_match('/^[0-9]{2}$/D', $a->code) === 1)->pluck('code')->all();
|
||||
$result = [];
|
||||
foreach ($rows as $a) {
|
||||
if (! is_string($a->id) || ! is_string($a->code) || ! is_string($a->label_pt_mz)) {
|
||||
continue;
|
||||
}
|
||||
if (($sector && $a->effective_sector_id !== $sector) || ! preg_match('/^[0-9]{2,5}$/D', str_replace('.', '', $a->code))
|
||||
|| ! in_array(substr(str_replace('.', '', $a->code), 0, 2), $divisions, true)) {
|
||||
continue;
|
||||
}
|
||||
$result[] = ['id' => $a->id, 'code' => $a->code, 'label' => $a->label_pt_mz];
|
||||
}
|
||||
|
||||
foreach (app(EconomicReferenceCatalog::class)->supplyClassification()['nodes'] as $node) {
|
||||
$result[] = ['id' => $node['id'], 'code' => $node['code'], 'label' => $node['label']];
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/** Old exact QA snapshots stay stored, but are not exposed by the protected capability.
|
||||
* @param list<array<string,mixed>> $history
|
||||
* @return list<array<string,mixed>>
|
||||
*/
|
||||
public function protectedHistory(array $history): array
|
||||
{
|
||||
$result = [];
|
||||
foreach ($history as $row) {
|
||||
if (($row['privacy_version'] ?? null) !== 1 || ($row['privacy_policy'] ?? null) !== 'fixed_district_cae_division_v1') {
|
||||
continue;
|
||||
}
|
||||
$safe = Arr::only($row, ['privacy_version', 'privacy_policy', 'requested_territory', 'scope', 'broader_context', 'truncated', 'coverage_unknown', 'limitations', 'interpretation', 'privacy_notice', 'context_revision', 'recorded_at', 'operation_key']);
|
||||
$safe['entities'] = $safe['repeated'] = $safe['uncertain'] = null;
|
||||
$safe['groups'] = [];
|
||||
foreach ($row['groups'] ?? [] as $group) {
|
||||
if (! preg_match('/^[0-9]{2}$/D', $group['code'] ?? '') || ! $this->validBand($group['entities_band'] ?? '') || ! $this->validBand($group['observations_band'] ?? '')) {
|
||||
continue;
|
||||
}
|
||||
$safe['groups'][] = [...Arr::only($group, ['code', 'label', 'entities_band', 'observations_band', 'scope', 'classification_key']), 'total' => null, 'first_year' => null, 'last_year' => null];
|
||||
}
|
||||
$safe['filters'] = Arr::only($row['filters'] ?? [], ['sector_id', 'activity_id', 'activity_label', 'division_code', 'classification_key', 'classification_label', 'classification_basis']);
|
||||
$safe['source_summary'] = Arr::only($row['source_summary'] ?? [], ['label', 'period', 'incomplete_periods']);
|
||||
$result[] = $safe;
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
private function validBand(string $band): bool
|
||||
{
|
||||
return preg_match('/^([0-9]{1,12})–([0-9]{1,12})$/uD', $band, $m) === 1
|
||||
&& (int) $m[1] >= 5 && (int) $m[1] % 5 === 0 && (int) $m[2] - (int) $m[1] === 4;
|
||||
}
|
||||
|
||||
/** No names, contacts, row identifiers or free-text activity descriptions leave this boundary.
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function aggregate(User $actor, string $territory): array
|
||||
{
|
||||
abort_unless(config('investor-path.aggregate_supply_qa_enabled') && IsolatedQaDatabase::allowsSchemaChanges(), 404);
|
||||
$path = app(InvestmentGeography::class)->path($territory);
|
||||
abort_if($path === [], 422, 'Confirme primeiro a localização do dossier.');
|
||||
|
||||
return $this->read($actor, function () use ($path, $territory): array {
|
||||
$labels = app(EconomicReferenceCatalog::class)->activities()->groupBy('code')->map(fn ($rows) => $rows->pluck('label_pt_mz')->unique()->count() === 1 ? $rows->first()->label_pt_mz : null);
|
||||
$scope = collect($path)->last();
|
||||
$query = function (string $id): Builder {
|
||||
return DB::table('proactive_supply_observations as o')->whereIn('o.territory_id', app(InvestmentGeography::class)->descendants($id));
|
||||
};
|
||||
$base = $query($territory);
|
||||
if (! (clone $base)->exists() && in_array($scope->location_type, ['locality', 'admin_post'], true)) {
|
||||
$district = collect($path)->firstWhere('location_type', 'district');
|
||||
if ($district && $query($district->id)->exists()) {
|
||||
$scope = $district;
|
||||
$base = $query($district->id);
|
||||
}
|
||||
}
|
||||
$counts = (clone $base)->selectRaw('count(DISTINCT entity_key) FILTER (WHERE duplicate_of IS NULL AND NOT identity_conflict) AS entities, count(*) FILTER (WHERE duplicate_of IS NOT NULL) AS repeated, count(*) FILTER (WHERE identity_conflict) AS uncertain')->first();
|
||||
$code = "CASE WHEN cae ~ '^[0-9.]{1,10}$' THEN cae ELSE '' END";
|
||||
$groups = (clone $base)->whereNull('duplicate_of')->where('identity_conflict', false)->selectRaw($code." AS code, count(DISTINCT entity_key) AS total, min(substring(source_date from '(19[0-9]{2}|20[0-9]{2})')) AS first_year, max(substring(source_date from '(19[0-9]{2}|20[0-9]{2})')) AS last_year")
|
||||
->groupByRaw($code)->orderByRaw($code)->limit(101)->get()->map(fn ($row) => ['code' => $row->code, 'label' => $row->code ? ($labels->get($row->code) ?? 'CAE '.$row->code.' — descrição por confirmar') : 'Actividade por classificar', 'total' => (int) $row->total, 'first_year' => $row->first_year, 'last_year' => $row->last_year])->all();
|
||||
|
||||
return ['requested_territory' => ['id' => $territory, 'name' => collect($path)->last()->name], 'scope' => ['id' => $scope->id, 'name' => $scope->name, 'level' => $scope->location_type],
|
||||
'broader_context' => $scope->id !== $territory, 'entities' => (int) $counts->entities, 'repeated' => (int) $counts->repeated, 'uncertain' => (int) $counts->uncertain,
|
||||
'groups' => array_slice($groups, 0, 100), 'truncated' => count($groups) > 100, 'coverage_unknown' => true, 'limitations' => self::LIMITATIONS,
|
||||
'interpretation' => 'Os grupos ajudam a investigar actividades similares e complementares. A relação deve ser fundamentada; não demonstra concorrência efectiva, clientes, capacidade ou receitas. Uma entidade pode constar em vários grupos; não some os grupos.'];
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<array-key, mixed> $input
|
||||
* @return array<array-key, mixed>
|
||||
|
||||
@@ -7,6 +7,64 @@ use Illuminate\Support\Str;
|
||||
/** Text matching shared by the database and the built-in page catalogue. */
|
||||
final class SearchTerms
|
||||
{
|
||||
/** @return array{type:string,category:?string,label:string,kind:?string,filter:string}|null */
|
||||
public function requestIntent(string $query): ?array
|
||||
{
|
||||
if ($count = $this->countIntent($query)) {
|
||||
return ['type' => 'count', ...$count];
|
||||
}
|
||||
$normalized = trim(mb_strtolower(Str::ascii($query)), " \t\n\r\0\x0B?!.");
|
||||
if (preg_match('/^(?:como|onde|quero|preciso de)\s+(?:(?:posso|faco para|devo)\s+)?licenciar(?:$|\s+(?:(?:uma|a|minha|o|um|meu)\s+)?(?:empresa|negocio|actividade|atividade|investimento)\b)/', $normalized)) {
|
||||
return ['type' => 'guide', 'category' => 'Páginas e serviços', 'label' => 'Licenciamento da empresa', 'kind' => null, 'filter' => 'licenciamento'];
|
||||
}
|
||||
$product = null;
|
||||
if (preg_match('/^(?:(?:tipos?|lista|catalogo) de |quais (?:sao )?(?:os )?)?produtos?\b(.*)$/', $normalized, $match)) {
|
||||
$product = $match[1];
|
||||
} elseif (preg_match('/^onde (?:encontrar|produzir|se produz|existem|ha)\s+(.+)$/', $normalized, $match)) {
|
||||
$product = $match[1];
|
||||
}
|
||||
if ($product !== null) {
|
||||
$category = preg_match('/\bfinanceiros?\b/', $product) ? 'Produtos financeiros' : (preg_match('/\bfisicos?\b/', $product) ? 'Produtos e localizações' : null);
|
||||
$product = preg_replace('/\b(?:e (?:a )?(?:sua )?localizacao|e (?:as )?(?:suas )?localizacoes|financeiros?|fisicos?|existem|disponiveis|no portal)\b/', ' ', $product);
|
||||
|
||||
return ['type' => 'products', 'category' => $category, 'label' => 'Produtos e localização', 'kind' => null, 'filter' => trim(preg_replace('/\s+/', ' ', $product))];
|
||||
}
|
||||
if (preg_match('/^(?:listar|mostrar|mostre|ver|quais (?:sao )?(?:os|as))\s+(.+)$/', $normalized, $match)
|
||||
&& ($list = $this->countIntent('quantos '.$match[1]))) {
|
||||
return ['type' => 'list', ...$list];
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/** @return array{category:string,label:string,kind:?string,filter:string}|null */
|
||||
public function countIntent(string $query): ?array
|
||||
{
|
||||
$query = trim(mb_strtolower(Str::ascii($query)), " \t\n\r\0\x0B?!.");
|
||||
$types = [
|
||||
'corredor|corredores' => ['Carteira: projectos, clusters e corredores', 'corredores', 'corridor'],
|
||||
'cluster|clusters' => ['Carteira: projectos, clusters e corredores', 'clusters', 'cluster'],
|
||||
'projectos? ancora|projetos? ancora' => ['Carteira: projectos, clusters e corredores', 'projectos âncora', 'project'],
|
||||
'oportunidade|oportunidades' => ['Oportunidades', 'oportunidades', null],
|
||||
'negocio|negocios' => ['Negócios', 'negócios', null],
|
||||
'documento|documentos' => ['Documentos e legislação', 'documentos', null],
|
||||
'artigo|artigos' => ['Artigos', 'artigos', null],
|
||||
'sector|sectores|setor|setores' => ['Sectores', 'sectores', null],
|
||||
'localizacao|localizacoes' => ['Localizações', 'localizações', null],
|
||||
'zonas? de investimento|zona|zonas' => ['Zonas de investimento', 'zonas de investimento', null],
|
||||
'parceria|parcerias' => ['Parcerias', 'parcerias', null],
|
||||
];
|
||||
foreach ($types as $pattern => [$category, $label, $kind]) {
|
||||
if (preg_match('/^(?:quantos|quantas|numero de|quantidade de|total de|qual (?:e )?o numero de)\s+(?:'.$pattern.')\b(.*)$/u', $query, $match)) {
|
||||
$filter = preg_replace('/\b(?:no portal|no investemoz|em mocambique|de investimento|existem|existe|existentes|existente|ha|temos|estao|sao|disponiveis|disponivel|publicados|publicadas|registados|registadas|cadastrados|cadastradas)\b/u', ' ', $match[1]);
|
||||
|
||||
return ['category' => $category, 'label' => $label, 'kind' => $kind, 'filter' => trim(preg_replace('/\s+/', ' ', $filter))];
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/** @return list<string> */
|
||||
public function tokens(string $query): array
|
||||
{
|
||||
@@ -24,13 +82,16 @@ final class SearchTerms
|
||||
return $tokens;
|
||||
}
|
||||
|
||||
/** Known Portuguese spelling and number variants; do not infer semantic equivalence. */
|
||||
/** Known Portuguese spelling and number variants; do not infer semantic equivalence.
|
||||
* @return list<string>
|
||||
*/
|
||||
public function variants(string $token): array
|
||||
{
|
||||
foreach ([['sector', 'sectores', 'setor', 'setores'], ['projecto', 'projectos', 'projeto', 'projetos'],
|
||||
['investir', 'investimento', 'investimentos'], ['investidor', 'investidores'], ['oportunidade', 'oportunidades'], ['documento', 'documentos'],
|
||||
['empresa', 'empresas'], ['parceria', 'parcerias'], ['zona', 'zonas'], ['formulario', 'formularios'],
|
||||
['provincia', 'provincias'], ['corredor', 'corredores'], ['cluster', 'clusters'], ['imposto', 'impostos'], ['licenca', 'licencas']] as $group) {
|
||||
['provincia', 'provincias'], ['corredor', 'corredores'], ['cluster', 'clusters'], ['imposto', 'impostos'], ['licenca', 'licencas'],
|
||||
['banco', 'bancos'], ['seguro', 'seguros'], ['produto', 'produtos'], ['agricola', 'agricolas']] as $group) {
|
||||
if (in_array($token, $group, true)) {
|
||||
return $group;
|
||||
}
|
||||
@@ -44,7 +105,10 @@ final class SearchTerms
|
||||
return '%'.str_replace(['!', '%', '_'], ['!!', '!%', '!_'], $token).'%';
|
||||
}
|
||||
|
||||
/** Columns are trusted application constants, never user input. */
|
||||
/** Columns are trusted application constants, never user input.
|
||||
* @param \Illuminate\Database\Eloquent\Builder<*>|\Illuminate\Database\Query\Builder $query
|
||||
* @param list<literal-string> $columns
|
||||
*/
|
||||
public function orFields($query, array $columns, string $token): void
|
||||
{
|
||||
foreach ($columns as $column) {
|
||||
@@ -54,6 +118,10 @@ final class SearchTerms
|
||||
}
|
||||
}
|
||||
|
||||
/** @param \Illuminate\Database\Eloquent\Builder<*>|\Illuminate\Database\Query\Builder $query
|
||||
* @param list<literal-string> $columns
|
||||
* @param list<string> $tokens
|
||||
*/
|
||||
public function constrain($query, array $columns, array $tokens): void
|
||||
{
|
||||
foreach ($tokens as $token) {
|
||||
@@ -61,6 +129,7 @@ final class SearchTerms
|
||||
}
|
||||
}
|
||||
|
||||
/** @param list<string> $tokens */
|
||||
public function matches(string $text, array $tokens): bool
|
||||
{
|
||||
$text = mb_strtolower(Str::ascii($text));
|
||||
@@ -73,11 +142,15 @@ final class SearchTerms
|
||||
return true;
|
||||
}
|
||||
|
||||
/** @param literal-string $column
|
||||
* @return literal-string
|
||||
*/
|
||||
private function normalizedColumn(string $column): string
|
||||
{
|
||||
return "translate(lower(coalesce({$column}::text, '')), 'áàâãäéèêëíìîïóòôõöúùûüçñ', 'aaaaaeeeeiiiiooooouuuucn')";
|
||||
}
|
||||
|
||||
/** @param list<string> $tokens */
|
||||
public function score(string $title, string $phrase, array $tokens): int
|
||||
{
|
||||
$title = mb_strtolower(Str::ascii($title));
|
||||
@@ -92,7 +165,12 @@ final class SearchTerms
|
||||
return $score;
|
||||
}
|
||||
|
||||
/** The same title score used for in-memory pages, with bound search terms. */
|
||||
/** The same title score used for in-memory pages, with bound search terms.
|
||||
* @param \Illuminate\Database\Eloquent\Builder<*>|\Illuminate\Database\Query\Builder $query
|
||||
* @param list<string> $tokens
|
||||
* @param literal-string $titleColumn
|
||||
* @param literal-string $tieColumn
|
||||
*/
|
||||
public function orderByRelevance($query, string $titleColumn, string $phrase, array $tokens, string $tieColumn): void
|
||||
{
|
||||
$column = $this->normalizedColumn($titleColumn);
|
||||
@@ -107,6 +185,12 @@ final class SearchTerms
|
||||
}
|
||||
$sql .= ' + CASE WHEN ('.implode(' OR ', $conditions).') THEN 1 ELSE 0 END';
|
||||
}
|
||||
$query->orderByRaw('('.$sql.') DESC', $bindings)->orderBy($titleColumn)->orderBy($tieColumn);
|
||||
$query->orderByRaw('('.$sql.') DESC', $bindings);
|
||||
if (str_contains($titleColumn, '(')) {
|
||||
$query->orderByRaw($titleColumn);
|
||||
} else {
|
||||
$query->orderBy($titleColumn);
|
||||
}
|
||||
$query->orderBy($tieColumn);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,236 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\User;
|
||||
use DOMDocument;
|
||||
use DOMXPath;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
use Illuminate\Support\Str;
|
||||
use Symfony\Component\HttpKernel\Exception\HttpException;
|
||||
|
||||
/** An adapter over published, versioned articles; never another opportunity register. */
|
||||
final class SectorContentAnalysis
|
||||
{
|
||||
public const REGIONS = [172263 => 'Zambézia', 172256 => 'Sofala', 172261 => 'Tete',
|
||||
172258 => 'Manica', 172253 => 'Inhambane', 172240 => 'Maputo Cidade',
|
||||
172237 => 'Maputo Província', 172233 => 'Gaza', 172230 => 'Nampula',
|
||||
172223 => 'Cabo Delgado', 172219 => 'Niassa'];
|
||||
|
||||
private const ACTIVITIES = [
|
||||
'turismo' => ['Hotelaria e alojamento' => '/hotel|alojamento|lodge|resort/iu', 'Turismo de natureza' => '/ecoturismo|eco.turismo|conservação/iu', 'Cultura e experiências' => '/turismo cultural|gastronomia|turismo gastronómico/iu'],
|
||||
'agronegocio' => ['Produção agrícola' => '/produção agrícola/iu', 'Processamento agro-industrial' => '/processamento|transformação agro/iu', 'Armazenagem e logística' => '/armazenagem|logística/iu'],
|
||||
'infraestruturas' => ['Água e saneamento' => '/água|saneamento/iu', 'Transportes e logística' => '/transportes|logística/iu', 'Construção e modernização' => '/construção|modernização/iu'],
|
||||
'mineracao' => ['Processamento mineral' => '/processamento|beneficiamento/iu', 'Serviços à mineração' => '/serviços especializados|manutenção/iu', 'Logística mineira' => '/logística|transporte/iu'],
|
||||
'energia-especifica' => ['Geração de energia' => '/geração|electricidade|el[eé]ctrica/iu', 'Distribuição e fornecimento' => '/distribuição|fornecimento/iu', 'Transformação industrial' => '/transformação industrial|fertilizantes|downstream/iu'],
|
||||
];
|
||||
|
||||
/** Read every paragraph/list item in the consulted edition; headings are citation context.
|
||||
* @param array<string,mixed> $article
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function describe(array $article): array
|
||||
{
|
||||
$sector = $article['sector']['slug'] ?? '';
|
||||
if (! isset(self::ACTIVITIES[$sector])) {
|
||||
return ['ideas' => [], 'blocks' => []];
|
||||
}
|
||||
$doc = new DOMDocument;
|
||||
$previous = libxml_use_internal_errors(true);
|
||||
try {
|
||||
$doc->loadHTML('<?xml encoding="UTF-8"><html><body>'.$article['html'].'</body></html>', LIBXML_NONET);
|
||||
$nodes = (new DOMXPath($doc))->query('//h2|//h3|//h4|//p[not(ancestor::li)]|//li[not(descendant::li)]');
|
||||
$blocks = [];
|
||||
$section = '';
|
||||
$occurrences = [];
|
||||
if ($nodes === false) {
|
||||
throw new \RuntimeException('Não foi possível analisar o conteúdo sectorial.');
|
||||
}
|
||||
foreach ($nodes as $node) {
|
||||
if (! $node instanceof \DOMElement) {
|
||||
continue;
|
||||
}
|
||||
$text = trim(preg_replace('/\s+/u', ' ', $node->textContent));
|
||||
if ($text === '') {
|
||||
continue;
|
||||
}
|
||||
if (str_starts_with($node->nodeName, 'h')) {
|
||||
$section = $text;
|
||||
|
||||
continue;
|
||||
}
|
||||
$hash = hash('sha256', $section."\n".$text);
|
||||
$occurrences[$hash] = ($occurrences[$hash] ?? 0) + 1;
|
||||
$blocks[] = ['key' => $hash.':'.$occurrences[$hash], 'section' => $section, 'quote' => $text];
|
||||
}
|
||||
} finally {
|
||||
libxml_clear_errors();
|
||||
libxml_use_internal_errors($previous);
|
||||
}
|
||||
$region = self::REGIONS[$article['legacy_id']] ?? null;
|
||||
$ideas = [];
|
||||
foreach (self::ACTIVITIES[$sector] as $label => $pattern) {
|
||||
// Exact supporting passage, never a conclusion about demand or return.
|
||||
$block = array_find($blocks, fn ($b) => preg_match($pattern, $b['quote']) === 1);
|
||||
if (! $block) {
|
||||
continue;
|
||||
}
|
||||
$ideas[] = ['title' => $label, 'classification' => 'hypothesis', 'evidence' => $block,
|
||||
'location_label' => $region, 'location_precision' => $region ? 'province' : 'source_scope',
|
||||
'start_href' => $article['start_href'].'?'.http_build_query(['evidence' => $block['key'], 'source_sha256' => $article['sha256'], 'source_version' => $article['version'], 'idea' => $label])];
|
||||
}
|
||||
|
||||
return ['ideas' => $ideas, 'blocks' => $blocks, 'region' => $region, 'sector_slug' => $sector,
|
||||
'source_date' => $article['modified_at'], 'source_version' => $article['version'],
|
||||
'notice' => 'Possibilidades para estudar, não anúncios abertos. A fonte descreve o contexto; procura, concorrência, preços, direitos e rentabilidade exigem análise própria.'];
|
||||
}
|
||||
|
||||
/** Resolve identifiers against the current published bytes, not a client-supplied quotation.
|
||||
* @param array<string,mixed> $article
|
||||
* @param array<string,mixed> $input
|
||||
* @return array<string,mixed>|null
|
||||
*/
|
||||
public function selection(array $article, array $input): ?array
|
||||
{
|
||||
if (empty($input['evidence'])) {
|
||||
return null;
|
||||
}
|
||||
$v = Validator::make($input, ['evidence' => ['required', 'regex:/^[a-f0-9]{64}:\d+$/D'],
|
||||
'source_sha256' => 'required|string|size:64', 'source_version' => 'required|integer|min:1', 'idea' => 'required|string|max:200'])->validate();
|
||||
abort_unless(hash_equals($article['sha256'], $v['source_sha256']) && (int) $v['source_version'] === (int) $article['version'], 409, 'O conteúdo mudou. Consulte a edição actual antes de continuar.');
|
||||
$analysis = $this->describe($article);
|
||||
$idea = array_find($analysis['ideas'], fn ($i) => $i['title'] === $v['idea'] && $i['evidence']['key'] === $v['evidence']);
|
||||
abort_unless($idea, 422, 'Escolha uma possibilidade sustentada pelo conteúdo consultado.');
|
||||
|
||||
return ['key' => hash('sha256', $article['id'].':'.$article['version'].$article['sha256'].$v['evidence'].$v['idea']),
|
||||
'title' => $v['idea'], 'evidence_key' => $v['evidence'], 'classification' => 'hypothesis', 'evidence_classification' => 'documented_source_statement',
|
||||
'quote' => $idea['evidence']['quote'], 'section' => $idea['evidence']['section'],
|
||||
'source_sha256' => $article['sha256'], 'source_version' => $article['version'], 'source_date' => $article['modified_at'],
|
||||
'content_sha256' => hash('sha256', $article['html']),
|
||||
'resource_id' => $article['id'], 'sector' => $article['sector'], 'location_label' => $analysis['region'],
|
||||
'location_precision' => $analysis['region'] ? 'province' : 'source_scope',
|
||||
'href' => $article['href'], 'open_participation' => false];
|
||||
}
|
||||
|
||||
/** Save the immutable passage inside the existing dossier source; do not overwrite declarations.
|
||||
* @param array<string,mixed> $input
|
||||
* @return array<string,mixed>|null
|
||||
*/
|
||||
public function attach(User $actor, string $id, array $input): ?array
|
||||
{
|
||||
$article = app(LegacyContent::class)->articleForResource((int) ($input['resource_id'] ?? 0));
|
||||
$selection = $this->selection($article, $input);
|
||||
if (! $selection) {
|
||||
app(LegacyContent::class)->attach($actor, $id, $input);
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
return DB::transaction(function () use ($actor, $id, $input, $selection) {
|
||||
$desk = app(VirtualDesk::class);
|
||||
$case = $desk->case($actor, $id, true, true);
|
||||
abort_unless((int) $case->version === (int) ($input['version'] ?? 0), 409, 'O dossier mudou. Recupere-o antes de continuar.');
|
||||
app(LegacyContent::class)->attach($actor, $id, $input);
|
||||
$case = $desk->case($actor, $id, true, true);
|
||||
$payload = $desk->decode($case->payload);
|
||||
foreach ($payload['investor_path']['content_sources'] as &$source) {
|
||||
if ($source['resource_id'] !== $selection['resource_id'] || $source['sha256'] !== $selection['source_sha256']) {
|
||||
continue;
|
||||
}
|
||||
if (array_any($source['analyses'] ?? [], fn ($a) => $a['key'] === $selection['key'])) {
|
||||
return $selection;
|
||||
}
|
||||
$source['analyses'][] = [...$selection, 'actor_id' => $actor->id, 'saved_at' => now()->toIso8601String()];
|
||||
}
|
||||
unset($source);
|
||||
DB::table('desk_cases')->where('id', $id)->update(['payload' => $desk->encode($payload), 'version' => $case->version + 1, 'updated_at' => now()]);
|
||||
$desk->event($desk->case($actor, $id), $actor, 'sector_analysis_referenced', ['key' => $selection['key'], 'resource_id' => $selection['resource_id']]);
|
||||
|
||||
return $selection;
|
||||
});
|
||||
}
|
||||
|
||||
/** Propose only the expressly identified province; district and exact position stay unset.
|
||||
* @param array<string,mixed> $selection
|
||||
*/
|
||||
public function continuation(string $id, array $selection): string
|
||||
{
|
||||
$query = ['sector_id' => $selection['sector']['id']];
|
||||
if ($selection['location_label']) {
|
||||
$matches = app(InvestmentGeography::class)->publicReferences()->where('location_type', 'province')->get(['id', 'name'])
|
||||
->filter(fn ($p) => Str::lower(Str::ascii($p->name)) === Str::lower(Str::ascii($selection['location_label'])));
|
||||
if ($matches->count() === 1) {
|
||||
$query['province_id'] = $matches->first()->id;
|
||||
}
|
||||
}
|
||||
|
||||
return '/investimentos/'.$id.'/contexto/editar?'.http_build_query($query);
|
||||
}
|
||||
|
||||
/** The saved quotation survives source changes/withdrawal; never replace it silently.
|
||||
* @param list<array<string,mixed>> $sources
|
||||
* @return list<array<string,mixed>>
|
||||
*/
|
||||
public function savedSources(array $sources): array
|
||||
{
|
||||
foreach ($sources as &$source) {
|
||||
if (empty($source['analyses'])) {
|
||||
continue;
|
||||
}
|
||||
try {
|
||||
$current = app(LegacyContent::class)->articleForResource($source['resource_id']);
|
||||
$source['analysis_review_required'] = array_any($source['analyses'], fn ($a) => $a['source_version'] !== $current['version'] || ! hash_equals($a['source_sha256'], $current['sha256'])
|
||||
|| ! hash_equals($a['content_sha256'], hash('sha256', $current['html'])));
|
||||
} catch (HttpException $error) {
|
||||
if (! in_array($error->getStatusCode(), [404, 409, 422], true)) {
|
||||
throw $error;
|
||||
}
|
||||
$source['analysis_review_required'] = true;
|
||||
}
|
||||
}
|
||||
unset($source);
|
||||
|
||||
return $sources;
|
||||
}
|
||||
|
||||
/** Provincial reading remains provincial when consulted from a district/locality.
|
||||
* @param list<string> $ids
|
||||
* @return list<array<string,mixed>>
|
||||
*/
|
||||
public function forTerritories(array $ids): array
|
||||
{
|
||||
if (! app(LegacyContent::class)->available() || $ids === []) {
|
||||
return [];
|
||||
}
|
||||
$provinces = [];
|
||||
foreach ($ids as $id) {
|
||||
foreach (app(InvestmentGeography::class)->path($id) as $node) {
|
||||
if ($node->location_type === 'province') {
|
||||
$provinces[] = Str::lower(Str::ascii($node->name));
|
||||
}
|
||||
}
|
||||
}
|
||||
$result = [];
|
||||
foreach (config('legacy_content.articles', []) as $slug => $identity) {
|
||||
if ($identity['group'] !== 'turismo') {
|
||||
continue;
|
||||
}
|
||||
preg_match('/post-(\d+)-/', $identity['external_id'], $match);
|
||||
$region = self::REGIONS[(int) ($match[1] ?? 0)] ?? null;
|
||||
if (! $region || ! in_array(Str::lower(Str::ascii($region)), $provinces, true)) {
|
||||
continue;
|
||||
}
|
||||
try {
|
||||
$a = app(LegacyContent::class)->article($slug, false);
|
||||
$result[] = ['title' => $a['title'], 'href' => $a['href'], 'analysis' => $a['sector_analysis']];
|
||||
} catch (HttpException $error) {
|
||||
if ($error->getStatusCode() !== 404) {
|
||||
throw $error;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
@@ -97,7 +97,7 @@ final class SectorInvestment
|
||||
foreach (self::CONTENT[$sector->slug] ?? [] as $slug) {
|
||||
try {
|
||||
$a = app(LegacyContent::class)->article($slug, false);
|
||||
$articles[] = Arr::only($a, ['title', 'href', 'image', 'sha256', 'summary', 'author', 'opportunities_href', 'opportunities_label', 'has_opportunities']);
|
||||
$articles[] = Arr::only($a, ['title', 'href', 'image', 'sha256', 'summary', 'author', 'sector_analysis', 'opportunities_href', 'opportunities_label', 'has_opportunities']);
|
||||
} catch (HttpException $e) {
|
||||
if ($e->getStatusCode() !== 404) {
|
||||
throw $e;
|
||||
|
||||
@@ -146,6 +146,9 @@ final class SimulationFormDrafts
|
||||
}
|
||||
|
||||
$this->requireMatch($request, $draft);
|
||||
$associatedContext = json_decode($economic['context_applicability_snapshot'] ?? '', true);
|
||||
$sourceSnapshot['association_opportunity'] = $economic['context_opportunity'] ?? $associatedContext['consumer_opportunity'] ?? null;
|
||||
$sourceSnapshot['association_context_revision'] = $associatedContext['context_revision'] ?? null;
|
||||
$sources[] = $sourceSnapshot;
|
||||
$economic['simulation_sources'] = $sources;
|
||||
$economic['reuse_simulation'] = 'yes';
|
||||
@@ -223,6 +226,61 @@ final class SimulationFormDrafts
|
||||
});
|
||||
}
|
||||
|
||||
/** Metadata only, from the draft owned by this dossier's titular; no broader dossier ACL grants financial access.
|
||||
* @return list<array<string,mixed>> */
|
||||
public function dossierReportSources(User $actor, string $caseId, ?string $opportunity): array
|
||||
{
|
||||
$case = app(VirtualDesk::class)->case($actor, $caseId);
|
||||
if ((int) $case->user_id !== $actor->id || ! $case->simulation_id) { return []; }
|
||||
$opportunity = app(InvestmentConsumerScope::class)->key(app(InvestorContext::class)->state($case), $opportunity, true);
|
||||
|
||||
return DB::transaction(function () use ($actor, $case, $opportunity): array {
|
||||
$this->setContext($actor->id, null);
|
||||
$draft = $this->ownedQuery($actor->id, null)->whereKey($case->simulation_id)->first();
|
||||
if (! $draft) { return []; }
|
||||
$economic = SimulationFormDraft::decryptSnapshot($draft->economic_snapshot);
|
||||
$sources = [];
|
||||
$records = $economic['simulation_sources'] ?? [];
|
||||
abort_unless(is_array($records), 409, 'Referências de relatórios incompatíveis; original preservado.');
|
||||
foreach ($records as $source) {
|
||||
if (! is_array($source) || ! Str::isUuid($source['simulation_id'] ?? '') || ! Str::isUuid($source['report_id'] ?? '')) { continue; }
|
||||
if (isset($source['association_opportunity']) && $source['association_opportunity'] !== $opportunity) { continue; }
|
||||
$sources[] = [...array_intersect_key($source, array_flip(['simulation_id', 'report_id', 'report_version_no', 'report_sha256', 'source_updated_at', 'consented_at'])),
|
||||
'opportunity' => $source['association_opportunity'] ?? null, 'scope_state' => ! array_key_exists('association_opportunity', $source) ? 'unconfirmed' : ($source['association_opportunity'] === null ? 'common' : 'identified'),
|
||||
'href' => '/investimentos/'.$case->id.'/relatorios/fiscais/'.$source['report_id'].($opportunity ? '?opportunity='.urlencode($opportunity) : '')];
|
||||
}
|
||||
|
||||
return $sources;
|
||||
});
|
||||
}
|
||||
|
||||
/** Reads the already preserved copy, including a source originally calculated anonymously.
|
||||
* @return array<string,mixed> */
|
||||
public function dossierReport(User $actor, string $caseId, string $reportId, ?string $opportunity): array
|
||||
{
|
||||
$case = app(VirtualDesk::class)->case($actor, $caseId);
|
||||
abort_unless((int) $case->user_id === $actor->id && $case->simulation_id, 403);
|
||||
$opportunity = app(InvestmentConsumerScope::class)->key(app(InvestorContext::class)->state($case), $opportunity, true);
|
||||
|
||||
return DB::transaction(function () use ($actor, $case, $reportId, $opportunity): array {
|
||||
$this->setContext($actor->id, null);
|
||||
$draft = $this->ownedQuery($actor->id, null)->whereKey($case->simulation_id)->firstOrFail();
|
||||
$economic = SimulationFormDraft::decryptSnapshot($draft->economic_snapshot);
|
||||
$records = $economic['simulation_sources'] ?? [];
|
||||
abort_unless(is_array($records), 409, 'Referências de relatórios incompatíveis; original preservado.');
|
||||
$source = null;
|
||||
foreach ($records as $item) {
|
||||
if (is_array($item) && ($item['report_id'] ?? null) === $reportId) { $source = $item; break; }
|
||||
}
|
||||
abort_unless(is_array($source) && is_array($source['report_snapshot'] ?? null), 404, 'Cópia preservada indisponível; original não substituído.');
|
||||
abort_if(isset($source['association_opportunity']) && $source['association_opportunity'] !== $opportunity, 404);
|
||||
|
||||
return ['case_id' => $case->id, 'opportunity' => $source['association_opportunity'] ?? null,
|
||||
'scope_state' => ! array_key_exists('association_opportunity', $source) ? 'unconfirmed' : ($source['association_opportunity'] === null ? 'common' : 'identified'), 'draft_id' => $draft->id, 'draft_version' => $draft->version_no,
|
||||
...array_intersect_key($source, array_flip(['simulation_id', 'report_id', 'report_version_no', 'report_sha256', 'report_snapshot', 'consented_at']))];
|
||||
});
|
||||
}
|
||||
|
||||
/** @return array{id:string,title:string,updated_at:string|null,expires_at:string|null,version_no:int}|null */
|
||||
public function claimPreview(Request $request): ?array
|
||||
{
|
||||
|
||||
@@ -3,9 +3,12 @@
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\User;
|
||||
use Illuminate\Contracts\Encryption\DecryptException;
|
||||
use Illuminate\Database\Query\Builder;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\Crypt;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Illuminate\Support\Facades\Validator;
|
||||
use Illuminate\Support\Str;
|
||||
|
||||
@@ -36,8 +39,12 @@ final class TerritorialRegistry
|
||||
'location_type' => ['required', 'in:'.implode(',', array_keys(self::PARENTS))],
|
||||
'parent_id' => ['nullable', 'uuid', 'exists:geo_locations,id'], 'source_id' => ['required', 'uuid', 'exists:geo_sources,id'],
|
||||
'valid_from' => ['required', 'date_format:Y-m-d'], 'valid_to' => ['nullable', 'date_format:Y-m-d', 'after_or_equal:valid_from'],
|
||||
'version_no' => [$id ? 'required' : 'prohibited', 'integer', 'min:1'], 'reason' => ['required', 'string', 'min:10', 'max:1000'],
|
||||
'version_no' => [$id ? 'required' : 'prohibited', 'integer', 'min:1'], 'reason' => ['required', 'string', 'min:10', 'max:1000'], 'confirm_baseline_change' => ['sometimes', 'boolean'],
|
||||
])->validate();
|
||||
$this->ensureWriteMode($id);
|
||||
if ($this->editorialAvailable()) {
|
||||
return $this->saveEditorial($actor, $data, $id);
|
||||
}
|
||||
|
||||
return DB::transaction(function () use ($actor, $data, $id) {
|
||||
// Serialise hierarchy changes to prevent concurrent parent cycles and duplicate paths.
|
||||
@@ -68,12 +75,303 @@ final class TerritorialRegistry
|
||||
});
|
||||
}
|
||||
|
||||
public function snapshot(string $id, int $version, User $actor, string $reason): void
|
||||
/** @param array<string,mixed>|null $proposal */
|
||||
public function snapshot(string $id, int $version, User $actor, string $reason, ?array $proposal = null): string
|
||||
{
|
||||
$snapshot = json_encode(['location' => DB::table('geo_locations')->find($id),
|
||||
$snapshot = json_encode($proposal ?? ['location' => DB::table('geo_locations')->find($id),
|
||||
'profile' => DB::table('geo_territory_profiles')->where('geo_location_id', $id)->first()], JSON_THROW_ON_ERROR);
|
||||
DB::table('geo_territory_revisions')->insert(['id' => (string) Str::uuid(), 'geo_location_id' => $id,
|
||||
$revision = (string) Str::uuid();
|
||||
DB::table('geo_territory_revisions')->insert(['id' => $revision, 'geo_location_id' => $id,
|
||||
'version_no' => $version, 'actor_id' => $actor->id, 'reason' => Crypt::encryptString($reason),
|
||||
'snapshot' => Crypt::encryptString($snapshot), 'checksum' => hash('sha256', $snapshot)]);
|
||||
|
||||
return $revision;
|
||||
}
|
||||
|
||||
private const EDITORIAL_SOURCE = 'territorial-editorial-v1';
|
||||
|
||||
public function editorialAvailable(): bool
|
||||
{
|
||||
return (bool) config('editorial_workflow.territorial_versions') && (bool) config('territorial.enabled') && Schema::hasTable('geo_territory_revisions') && Schema::hasTable('audit_events');
|
||||
}
|
||||
|
||||
public function ensureWriteMode(?string $id): void
|
||||
{
|
||||
if (config('editorial_workflow.territorial_versions')) {
|
||||
abort_unless($this->editorialAvailable(), 503, 'Circuito territorial ainda não disponível.');
|
||||
} elseif ($id) {
|
||||
abort_if(DB::table('audit_events')->where('source_system', self::EDITORIAL_SOURCE)->where('entity_id', $id)->exists(), 503, 'Reactive o circuito para conservar a revisão territorial privada.');
|
||||
}
|
||||
}
|
||||
|
||||
public function hasEditorialHistory(string $id): bool
|
||||
{
|
||||
return DB::table('audit_events')->where('source_system', self::EDITORIAL_SOURCE)->where('entity_id', $id)->exists();
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function preview(string $id): array
|
||||
{
|
||||
$state = $this->working($id);
|
||||
$history = DB::table('geo_territory_revisions')->where('geo_location_id', $id)->orderByDesc('version_no')->limit(100)->get()
|
||||
->map(function ($revision) {
|
||||
try {
|
||||
$json = Crypt::decryptString($revision->snapshot);
|
||||
$reason = Crypt::decryptString($revision->reason);
|
||||
} catch (DecryptException) {
|
||||
abort(409, 'Histórico territorial indisponível; preserve o original.');
|
||||
}
|
||||
abort_unless(hash_equals(trim($revision->checksum), hash('sha256', $json)), 409, 'Histórico territorial alterado.');
|
||||
|
||||
return ['id' => $revision->id, 'version_no' => $revision->version_no, 'actor_id' => $revision->actor_id,
|
||||
'reason' => $reason, 'snapshot' => json_decode($json, true, 512, JSON_THROW_ON_ERROR)];
|
||||
});
|
||||
|
||||
return ['working' => $state, 'public' => $this->live($id), 'history' => $history];
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
private function live(string $id): array
|
||||
{
|
||||
$location = DB::table('geo_locations')->where('id', $id)->whereNull('deleted_at')->first();
|
||||
$profile = DB::table('geo_territory_profiles')->where('geo_location_id', $id)->first();
|
||||
abort_unless($location && $profile, 404);
|
||||
|
||||
return ['location' => get_object_vars($location), 'profile' => get_object_vars($profile)];
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $value */
|
||||
private function digest(array $value): string
|
||||
{
|
||||
return hash('sha256', json_encode(Arr::sortRecursive($value), JSON_THROW_ON_ERROR));
|
||||
}
|
||||
|
||||
/** @return array<string,mixed> */
|
||||
public function working(string $id): array
|
||||
{
|
||||
$live = $this->live($id);
|
||||
$event = DB::table('audit_events')->where('source_system', self::EDITORIAL_SOURCE)->where('entity_id', $id)->orderByRaw("(after_data->>'version_no')::integer DESC")->first();
|
||||
if ($event) {
|
||||
$details = json_decode($event->after_data, true, 512, JSON_THROW_ON_ERROR);
|
||||
$revision = DB::table('geo_territory_revisions')->where('id', $details['revision_id'])->where('geo_location_id', $id)->first();
|
||||
abort_unless($revision && hash_equals(trim($revision->checksum), $details['checksum']), 409, 'Referência de revisão territorial alterada.');
|
||||
try {
|
||||
$json = Crypt::decryptString($revision->snapshot);
|
||||
} catch (DecryptException) {
|
||||
abort(409, 'Revisão territorial indisponível; conserve o histórico.');
|
||||
}
|
||||
abort_unless(hash_equals(trim($revision->checksum), hash('sha256', $json)), 409, 'Conteúdo da revisão territorial alterado.');
|
||||
$state = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
|
||||
abort_unless($state['location']['id'] === $id && $state['location']['version_no'] === (int) $revision->version_no, 409);
|
||||
if ($state['_editorial']['private']) {
|
||||
$state['public_version_no'] = $live['profile']['status'] === 'published' ? $live['location']['version_no'] : null;
|
||||
$state['baseline_changed'] = ! hash_equals($state['_editorial']['baseline_hash'], $this->digest($live));
|
||||
$state['fresh'] = ! $state['baseline_changed'] && hash_equals($state['_editorial']['content_hash'], $this->contentHash($state));
|
||||
|
||||
return $state;
|
||||
}
|
||||
$live['_editorial'] = $state['_editorial'];
|
||||
}
|
||||
$live['public_version_no'] = $live['profile']['status'] === 'published' ? $live['location']['version_no'] : null;
|
||||
$live['location']['version_no'] = max((int) $live['location']['version_no'], (int) DB::table('geo_territory_revisions')->where('geo_location_id', $id)->max('version_no'));
|
||||
$live['baseline_changed'] = false;
|
||||
$live['fresh'] = true;
|
||||
|
||||
return $live;
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $state
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
private function evidence(array $state): array
|
||||
{
|
||||
$source = DB::table('geo_sources')->where('id', $state['profile']['source_id'])->first();
|
||||
abort_unless($source !== null, 422, 'Fonte indisponível.');
|
||||
$parents = [];
|
||||
$parent = $state['location']['parent_id'];
|
||||
$seen = [$state['location']['id']];
|
||||
while ($parent) {
|
||||
abort_if(in_array($parent, $seen, true) || count($seen) > 5, 422, 'Hierarquia territorial incoerente.');
|
||||
$seen[] = $parent;
|
||||
$row = DB::table('geo_locations')->where('id', $parent)->whereNull('deleted_at')->first(['id', 'name', 'code', 'parent_id', 'location_type', 'version_no']);
|
||||
abort_unless($row !== null, 422, 'Ascendente indisponível.');
|
||||
$parents[] = get_object_vars($row);
|
||||
$parent = $row->parent_id;
|
||||
}
|
||||
|
||||
return ['source' => Arr::only(get_object_vars($source), ['id', 'name', 'responsible_entity', 'reference', 'license', 'checksum', 'source_version', 'collected_at', 'original_crs']), 'parents' => $parents];
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $state */
|
||||
private function contentHash(array $state): string
|
||||
{
|
||||
return $this->digest(['location' => Arr::only($state['location'], ['id', 'name', 'code', 'location_type', 'parent_id']),
|
||||
'profile' => Arr::only($state['profile'], ['source_id', 'valid_from', 'valid_to']),
|
||||
'contributors' => $state['_editorial']['contributors'], 'evidence' => $this->evidence($state)]);
|
||||
}
|
||||
|
||||
private function editorialActor(User $actor, string $role): void
|
||||
{
|
||||
abort_unless($actor->can('manage-portal') && $actor->two_factor_confirmed_at && $actor->two_factor_secret && ! app(PortalProfileAccess::class)->has($actor, 'auditor')
|
||||
&& in_array(strtolower($actor->email), config('territorial.'.$role, []), true) && app(PortalProfileAccess::class)->mfa($actor), 403, 'Função territorial e MFA válido necessários.');
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $data */
|
||||
private function shape(array $data, ?string $id): void
|
||||
{
|
||||
$parentType = self::PARENTS[$data['location_type']];
|
||||
$parent = empty($data['parent_id']) ? null : DB::table('geo_locations')->where('id', $data['parent_id'])->whereNull('deleted_at')->first();
|
||||
abort_unless($parentType ? $parent && $parent->location_type === $parentType : ! $parent, 422, 'Hierarquia territorial incoerente.');
|
||||
$duplicate = DB::table('geo_locations')->where('location_type', $data['location_type'])->whereNull('deleted_at')->when($id, fn ($q) => $q->where('id', '<>', $id))
|
||||
->where(fn ($q) => $q->where('code', $data['code'])->orWhere(fn ($q) => $q->where('parent_id', $data['parent_id'] ?? null)->whereRaw('lower(trim(name))=lower(trim(?))', [$data['name']])))->exists();
|
||||
abort_if($duplicate, 422, 'Código ou nome no mesmo pai já existente.');
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $state */
|
||||
private function appendEditorial(User $actor, string $id, array $state, string $reason, string $action): void
|
||||
{
|
||||
unset($state['fresh'], $state['baseline_changed'], $state['public_version_no']);
|
||||
$version = (int) $state['location']['version_no'];
|
||||
$revision = $this->snapshot($id, $version, $actor, $reason, $state);
|
||||
$checksum = DB::table('geo_territory_revisions')->where('id', $revision)->value('checksum');
|
||||
$eventId = (string) Str::uuid();
|
||||
DB::table('audit_events')->insert(['id' => $eventId, 'source_system' => self::EDITORIAL_SOURCE, 'entity_type' => 'geo_locations', 'entity_id' => $id, 'actor_user_id' => $actor->id,
|
||||
'action' => $action, 'data_classification' => 'restricted', 'after_data' => json_encode(['version_no' => $version, 'revision_id' => $revision, 'checksum' => trim($checksum), 'state' => $state['profile']['status']], JSON_THROW_ON_ERROR)]);
|
||||
app(PortalEditorialNativeNotices::class)->emit($actor, $eventId, $state['_editorial']['contributors'] ?? []);
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $data */
|
||||
private function saveEditorial(User $actor, array $data, ?string $id): string
|
||||
{
|
||||
$this->editorialActor($actor, 'editors');
|
||||
|
||||
return DB::transaction(function () use ($actor, $data, $id) {
|
||||
DB::select('SELECT pg_advisory_xact_lock(280926, 150000)');
|
||||
$this->shape($data, $id);
|
||||
if (! $id) {
|
||||
$id = (string) Str::uuid();
|
||||
DB::table('geo_locations')->insert(['id' => $id, 'name' => $data['name'], 'code' => $data['code'], 'location_type' => $data['location_type'], 'parent_id' => $data['parent_id'] ?? null,
|
||||
'version_no' => 1, 'data_classification' => 'internal', 'updated_at' => now()]);
|
||||
DB::table('geo_territory_profiles')->insert(['geo_location_id' => $id, 'source_id' => $data['source_id'], 'valid_from' => $data['valid_from'], 'valid_to' => $data['valid_to'] ?? null, 'status' => 'draft', 'editor_id' => $actor->id]);
|
||||
$state = $this->live($id);
|
||||
} else {
|
||||
DB::table('geo_locations')->where('id', $id)->lockForUpdate()->first();
|
||||
$state = $this->working($id);
|
||||
abort_unless((int) $state['location']['version_no'] === (int) $data['version_no'], 409, 'Versão territorial alterada.');
|
||||
abort_unless($state['location']['location_type'] === $data['location_type'], 422, 'O tipo territorial é imutável.');
|
||||
abort_if(($state['baseline_changed'] ?? false) && ! ($data['confirm_baseline_change'] ?? false), 409, 'Compare a publicação actual e confirme a reconciliação antes de guardar.');
|
||||
if (! $this->hasEditorialHistory($id) && ! DB::table('geo_territory_revisions')->where('geo_location_id', $id)->where('version_no', $state['location']['version_no'])->exists()) {
|
||||
$this->snapshot($id, $state['location']['version_no'], $actor, 'Conservação do estado anterior ao circuito editorial; não constitui nova aprovação.');
|
||||
}
|
||||
$state['location']['version_no']++;
|
||||
}
|
||||
$private = $state['_editorial']['private'] ?? false;
|
||||
$contributors = array_values(array_unique([...($private ? $state['_editorial']['contributors'] : []), $actor->id]));
|
||||
$state['location'] = array_replace($state['location'], Arr::only($data, ['name', 'code', 'location_type', 'parent_id']), ['data_classification' => 'internal']);
|
||||
$state['profile'] = array_replace($state['profile'], Arr::only($data, ['source_id', 'valid_from', 'valid_to']), ['status' => 'draft', 'editor_id' => $actor->id, 'reviewer_id' => null, 'publisher_id' => null]);
|
||||
$state['_editorial'] = ['private' => true, 'edition_no' => $state['location']['version_no'], 'contributors' => $contributors, 'approval' => null, 'baseline_hash' => $this->digest($this->live($id)), 'evidence' => $this->evidence($state)];
|
||||
$state['_editorial']['content_hash'] = $this->contentHash($state);
|
||||
$this->appendEditorial($actor, $id, $state, $data['reason'], 'draft_saved');
|
||||
|
||||
return $id;
|
||||
});
|
||||
}
|
||||
|
||||
/** @param array<string,mixed> $data
|
||||
* @return array<string,mixed>
|
||||
*/
|
||||
public function transitionEditorial(User $actor, string $id, array $data): array
|
||||
{
|
||||
$this->ensureWriteMode($id);
|
||||
abort_unless($this->editorialAvailable(), 503);
|
||||
$action = $data['action'];
|
||||
$role = match ($action) {
|
||||
'in_review', 'approved', 'rejected' => 'reviewers',
|
||||
'published', 'archived', 'withdrawn' => 'publishers',
|
||||
default => 'editors',
|
||||
};
|
||||
$this->editorialActor($actor, $role);
|
||||
|
||||
return DB::transaction(function () use ($actor, $id, $data, $action) {
|
||||
DB::select('SELECT pg_advisory_xact_lock(280926, 150000)');
|
||||
DB::table('geo_locations')->where('id', $id)->lockForUpdate()->first();
|
||||
DB::table('geo_territory_profiles')->where('geo_location_id', $id)->lockForUpdate()->first();
|
||||
$state = $this->working($id);
|
||||
abort_unless((int) $state['location']['version_no'] === (int) $data['version_no'], 409, 'Versão territorial alterada.');
|
||||
if ($action === 'published') {
|
||||
$evidence = $this->evidence($state);
|
||||
$parentIds = array_column($evidence['parents'], 'id');
|
||||
DB::table('geo_locations')->whereIn('id', $parentIds)->orderBy('id')->lockForUpdate()->get();
|
||||
DB::table('geo_territory_profiles')->whereIn('geo_location_id', $parentIds)->orderBy('geo_location_id')->lockForUpdate()->get();
|
||||
$sourceIds = DB::table('geo_territory_profiles')->whereIn('geo_location_id', $parentIds)->pluck('source_id')->all();
|
||||
$sourceIds[] = $state['profile']['source_id'];
|
||||
DB::table('geo_sources')->whereIn('id', $sourceIds)->orderBy('id')->lockForUpdate()->get();
|
||||
$state = $this->working($id);
|
||||
}
|
||||
$private = $state['_editorial']['private'] ?? false;
|
||||
$live = $this->live($id);
|
||||
if ($action === 'withdrawn' || ($action === 'archived' && ! $private)) {
|
||||
abort_unless($live['profile']['status'] === 'published', 409);
|
||||
$version = $state['location']['version_no'] + 1;
|
||||
DB::table('geo_territory_profiles')->where('geo_location_id', $id)->update(['status' => 'archived', 'updated_at' => now()]);
|
||||
DB::table('geo_locations')->where('id', $id)->update(['data_classification' => 'internal', 'version_no' => $version, 'updated_at' => now()]);
|
||||
if ($private) {
|
||||
$state['_editorial']['baseline_hash'] = $this->digest($this->live($id));
|
||||
} else {
|
||||
$state = $this->live($id);
|
||||
$state['_editorial'] = ['private' => false];
|
||||
}
|
||||
$state['location']['version_no'] = $version;
|
||||
$this->appendEditorial($actor, $id, $state, $data['reason'], 'publication_withdrawn');
|
||||
|
||||
return ['id' => $id, 'status' => $state['profile']['status'], 'version_no' => $version];
|
||||
}
|
||||
abort_unless($private, 409, 'Guarde uma versão privada antes de iniciar o novo circuito.');
|
||||
$from = ['pending_review' => ['draft', 'rejected'], 'in_review' => ['pending_review'], 'approved' => ['in_review'],
|
||||
'rejected' => ['pending_review', 'in_review'], 'published' => ['approved'], 'archived' => ['draft', 'pending_review', 'in_review', 'approved', 'rejected']];
|
||||
abort_unless(isset($from[$action]) && in_array($state['profile']['status'], $from[$action], true), 409);
|
||||
if (in_array($action, ['pending_review', 'approved', 'published'], true)) {
|
||||
abort_unless($state['fresh'], 409, 'A publicação, fonte ou hierarquia mudou; reveja a versão.');
|
||||
}
|
||||
if ($action === 'pending_review') {
|
||||
abort_unless($state['profile']['editor_id'] === $actor->id, 403);
|
||||
}
|
||||
if (in_array($action, ['in_review', 'approved', 'rejected'], true)) {
|
||||
abort_if(in_array($actor->id, $state['_editorial']['contributors'], true), 403, 'Revisão independente obrigatória.');
|
||||
$state['profile']['reviewer_id'] = $actor->id;
|
||||
}
|
||||
if ($action === 'approved') {
|
||||
$state['_editorial']['approval'] = ['reviewer_id' => $actor->id, 'edition_no' => $state['_editorial']['edition_no'],
|
||||
'content_hash' => $state['_editorial']['content_hash'], 'reason' => $data['reason'], 'at' => now()->toIso8601String()];
|
||||
}
|
||||
if ($action === 'published') {
|
||||
$approval = $state['_editorial']['approval'];
|
||||
abort_unless(is_array($approval) && $approval['edition_no'] === $state['_editorial']['edition_no']
|
||||
&& hash_equals($approval['content_hash'], $this->contentHash($state)), 409, 'Aprovação não corresponde a esta versão.');
|
||||
abort_if(in_array($actor->id, [...$state['_editorial']['contributors'], $approval['reviewer_id']], true), 403, 'Publicação exige terceiro interveniente.');
|
||||
$reviewer = User::where('id', $approval['reviewer_id'])->first();
|
||||
abort_unless($reviewer && $reviewer->can('manage-portal') && $reviewer->two_factor_confirmed_at && $reviewer->two_factor_secret
|
||||
&& ! app(PortalProfileAccess::class)->has($reviewer, 'auditor') && in_array(strtolower($reviewer->email), config('territorial.reviewers', []), true), 409, 'Revisor deixou de ter autoridade.');
|
||||
abort_unless(DB::table('geo_sources')->where('id', $state['profile']['source_id'])->where('status', 'approved')->exists(), 422, 'Fonte não aprovada.');
|
||||
abort_if($state['profile']['valid_from'] > today()->toDateString() || ($state['profile']['valid_to'] && $state['profile']['valid_to'] < today()->toDateString()), 422, 'Vigência inválida.');
|
||||
abort_if($state['location']['parent_id'] && ! $this->published()->where('g.id', $state['location']['parent_id'])->exists(), 422, 'Ascendente não publicado.');
|
||||
$this->shape($state['location'], $id);
|
||||
$state['profile']['publisher_id'] = $actor->id;
|
||||
}
|
||||
$state['location']['version_no']++;
|
||||
$state['profile']['status'] = $action;
|
||||
if ($action === 'published') {
|
||||
DB::table('geo_locations')->where('id', $id)->update([...Arr::only($state['location'], ['name', 'code', 'location_type', 'parent_id', 'version_no']), 'data_classification' => 'public', 'updated_at' => now()]);
|
||||
DB::table('geo_territory_profiles')->where('geo_location_id', $id)->update([...Arr::only($state['profile'], ['source_id', 'valid_from', 'valid_to', 'status', 'editor_id', 'reviewer_id', 'publisher_id']), 'updated_at' => now()]);
|
||||
$state['_editorial']['private'] = false;
|
||||
}
|
||||
if ($action === 'archived') {
|
||||
// Archiving a proposal never withdraws the existing public version.
|
||||
$state['_editorial']['private'] = false;
|
||||
}
|
||||
$this->appendEditorial($actor, $id, $state, $data['reason'], $action);
|
||||
|
||||
return ['id' => $id, 'status' => $action, 'version_no' => $state['location']['version_no']];
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
@@ -61,7 +61,11 @@ class VerifiedDocumentBinary
|
||||
if ($table === 'opportunity_images') {
|
||||
$query->orWhereRaw("payload->'derivatives' @> ?::jsonb", [json_encode([['document_id' => $document->id]], JSON_THROW_ON_ERROR)]);
|
||||
}
|
||||
$links = $links->concat($query->get(['opportunity_id', 'deleted_at', 'payload']));
|
||||
$rows = $query->get(['opportunity_id', 'deleted_at', 'payload']);
|
||||
foreach ($rows as $link) {
|
||||
$link->resource_kind = $table;
|
||||
}
|
||||
$links = $links->concat($rows);
|
||||
}
|
||||
$privateOrigin = in_array($document->source_system ?? null, ['opportunity-resources', 'opportunity-image-derivatives'], true);
|
||||
if (! $privateOrigin) {
|
||||
@@ -72,6 +76,15 @@ class VerifiedDocumentBinary
|
||||
}
|
||||
$actor = request()->user();
|
||||
abort_unless($actor instanceof User, 403, 'Anexo privado: é necessário acesso autorizado à oportunidade.');
|
||||
foreach ($links as $link) {
|
||||
$offer = Opportunity::withTrashed()->whereKey($link->opportunity_id)->first();
|
||||
if ($offer?->isPrivateOfferPreparation() && $link->resource_kind === 'opportunity_documents') {
|
||||
$allowed = $link->deleted_at === null && ! $offer->trashed() && app(PrivateOfferConfidentiality::class)->internal($actor, $offer);
|
||||
app(PortalProfileAccess::class)->audit($actor, $allowed ? 'offer_proof_access_authorized' : 'offer_proof_access_denied',
|
||||
['record_id' => $offer->id, 'document_id' => $document->id, 'record_version' => $offer->management_version, 'sha256' => trim($document->sha256)]);
|
||||
abort_unless($allowed, 403, 'Comprovativo reservado à validação interna autorizada.');
|
||||
}
|
||||
}
|
||||
foreach ($links as $link) {
|
||||
$opportunity = Opportunity::whereKey($link->opportunity_id)->first();
|
||||
if ($link->deleted_at === null && $opportunity && $opportunity->status !== 'archived'
|
||||
|
||||
@@ -47,6 +47,16 @@ class VirtualDesk
|
||||
return $case->organization_id ? $this->represents($actor, $case->organization_id, $write) : (int) $case->user_id === $actor->id;
|
||||
}
|
||||
|
||||
/** The same effective membership used by dossier access; identity does not depend on country configuration.
|
||||
* @return list<array<string,mixed>>
|
||||
*/
|
||||
public function representedOrganizations(User $actor): array
|
||||
{
|
||||
return array_values(DB::table('memberships as m')->join('organizations as o', 'o.id', '=', 'm.organization_id')->where('m.user_id', $actor->id)
|
||||
->whereNull('m.deleted_at')->whereNull('o.deleted_at')->get(['o.id', 'o.name', 'o.version_no', ...(Schema::hasColumn('organizations', 'incorporation_country_code') ? ['o.incorporation_country_code'] : [])])
|
||||
->unique('id')->map(fn ($row) => ['id' => $row->id, 'name' => $row->name, 'version' => $row->version_no, 'country' => $row->incorporation_country_code ?? null])->values()->all());
|
||||
}
|
||||
|
||||
public function case(User $actor, string $id, bool $write = false, bool $lock = false): \stdClass
|
||||
{
|
||||
$case = DB::table('desk_cases')->where('id', $id)->when($lock, fn ($q) => $q->lockForUpdate())->first();
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
<?php
|
||||
|
||||
return [
|
||||
// Remote activation is explicit; local/QA behaviour remains unchanged.
|
||||
'enabled' => env('DEMOGRAPHY_ENABLED', env('APP_URL') !== 'https://teste-investidor.tempo.co.mz'
|
||||
&& in_array(env('APP_ENV', 'production'), ['local', 'testing'], true)),
|
||||
'source_directory' => env('DEMOGRAPHY_SOURCE_DIRECTORY', 'C:/Mac/Home/Documents/TEMPO/Portal Tempo/Servicos Tempo/portal do investidor/demografia/Provincias'),
|
||||
'prepared_directory' => env('DEMOGRAPHY_PREPARED_DIRECTORY'),
|
||||
// An explicit interpreter avoids Windows Store execution aliases in web workers.
|
||||
'python' => env('DEMOGRAPHY_PYTHON', 'python'),
|
||||
];
|
||||
@@ -0,0 +1,19 @@
|
||||
<?php
|
||||
|
||||
$legalReviewerEmails = env('PORTAL_EDITORIAL_LEGAL_REVIEWERS', '');
|
||||
|
||||
return [
|
||||
// Development/QA opt-in. Installation and activation in an operational target are separate decisions.
|
||||
'enabled' => env('PORTAL_EDITORIAL_WORKFLOW_ENABLED', false),
|
||||
'cluster_competitiveness' => env('PORTAL_EDITORIAL_CLUSTER_WORKFLOW_ENABLED', false),
|
||||
'portfolio' => env('PORTAL_EDITORIAL_PORTFOLIO_ENABLED', false),
|
||||
'demography' => env('PORTAL_EDITORIAL_DEMOGRAPHY_ENABLED', false),
|
||||
'territorial_versions' => env('PORTAL_EDITORIAL_TERRITORIAL_ENABLED', false),
|
||||
'structural_subjects' => env('PORTAL_EDITORIAL_STRUCTURES_ENABLED', false),
|
||||
'zone_review' => env('PORTAL_EDITORIAL_ZONE_REVIEW_ENABLED', false),
|
||||
// Legal designation is explicit; management authority alone is not a legal designation.
|
||||
'legal_reviewers' => [],
|
||||
'legal_reviewer_emails' => is_string($legalReviewerEmails) ? array_values(array_filter(array_map(static fn (string $email): string => strtolower(trim($email)), explode(',', $legalReviewerEmails)))) : [],
|
||||
// Required separation is a policy, distinct from the legacy fact "independent_review".
|
||||
'independent_approval' => ['resources' => [], 'kinds' => []],
|
||||
];
|
||||
@@ -4,5 +4,9 @@ return [
|
||||
// Explicit opt-in after authenticated installation; never infer activation from schema/ready.
|
||||
'private_preparation' => env('PRIVATE_INVESTMENT_PREPARATION_ENABLED', false),
|
||||
'enabled' => env('INVESTOR_PATH_ENABLED', false),
|
||||
// Owner-authorised aggregate experiment: isolated testing database only.
|
||||
'aggregate_supply_qa_enabled' => env('INVESTOR_AGGREGATE_SUPPLY_QA_ENABLED', false),
|
||||
// Explicitly authorised, protected statistics in the owner's existing dossier.
|
||||
'protected_supply_enabled' => env('INVESTOR_PROTECTED_SUPPLY_ENABLED', false),
|
||||
'definition_id' => '61000919-0000-4000-8000-000000000001',
|
||||
];
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
<?php
|
||||
|
||||
return [
|
||||
// No legal text or operational NDA is supplied/approved. Never infer it from an upload.
|
||||
'nda' => null,
|
||||
// No definitive publication lifetime was decided. Freeze an explicit policy on approval.
|
||||
'validity_days' => null,
|
||||
'validity_policy_reference' => null,
|
||||
'expiry_scheduler_enabled' => false,
|
||||
];
|
||||
@@ -0,0 +1,120 @@
|
||||
{
|
||||
"files": {
|
||||
"Cabo Delgado.xlsx": {
|
||||
"sha256": "419ebf09f26055a2d46dac7027143835ee2e2dc8a91e3b1f498c5b459566ce16",
|
||||
"records": 92808,
|
||||
"province": "Cabo Delgado",
|
||||
"issues": {
|
||||
"missing_value": 6336
|
||||
}
|
||||
},
|
||||
"Gaza.xlsx": {
|
||||
"sha256": "b66ccde3478a74a854e8e2c4d51209401d844a15a701b16267e005fa44b70dc4",
|
||||
"records": 82618,
|
||||
"province": "Gaza",
|
||||
"issues": {
|
||||
"age_total_mismatch": 4,
|
||||
"missing_value": 2,
|
||||
"residence_total_mismatch": 4,
|
||||
"sex_total_mismatch": 1
|
||||
}
|
||||
},
|
||||
"Maputo Provincia.xlsx": {
|
||||
"sha256": "1bf2921ef43d18817878a6d05e487ce5b107c14aa149ad17bedae6f1c652430e",
|
||||
"records": 49504,
|
||||
"province": "Maputo Província",
|
||||
"issues": {
|
||||
"cached_formula_value": 42972,
|
||||
"missing_value": 68
|
||||
}
|
||||
},
|
||||
"Maputo Cidade.xlsx": {
|
||||
"sha256": "ba72c0b64200e5bdb4b1dda60a0a974bc7ce7c6d28d37a490735437261f1e513",
|
||||
"records": 44064,
|
||||
"province": "Maputo Cidade",
|
||||
"issues": {}
|
||||
},
|
||||
"Nampula.xlsx": {
|
||||
"sha256": "cc960b06d7dfd0cb3f9a16edd94ff8db0451e8f3e24f3ad8442d03f7a053ac3b",
|
||||
"records": 131400,
|
||||
"province": "Nampula",
|
||||
"issues": {
|
||||
"missing_value": 792
|
||||
}
|
||||
},
|
||||
"Niassa.xlsx": {
|
||||
"sha256": "3116278d32de729058c7133ccc8204b42f14a0f8ba2b8d0aa8be46c9ff08d160",
|
||||
"records": 93632,
|
||||
"province": "Niassa",
|
||||
"issues": {
|
||||
"age_total_mismatch": 3,
|
||||
"cached_formula_value": 12,
|
||||
"district_total_mismatch": 2,
|
||||
"missing_value": 4,
|
||||
"residence_total_mismatch": 1
|
||||
}
|
||||
},
|
||||
"Sofala.xlsx": {
|
||||
"sha256": "4eaf5ef5e332ed50d5739330e14d78e2ead2551f407de7e31e0d1a96a76c956e",
|
||||
"records": 77108,
|
||||
"province": "Sofala",
|
||||
"issues": {
|
||||
"age_total_mismatch": 6,
|
||||
"missing_value": 4,
|
||||
"residence_total_mismatch": 6
|
||||
}
|
||||
},
|
||||
"Tete.xlsx": {
|
||||
"sha256": "4bbd7856107c4a3716b533caf7968a691deab4662e42689a7c529b58b80e2d58",
|
||||
"records": 67932,
|
||||
"province": "Tete",
|
||||
"issues": {
|
||||
"missing_value": 20196
|
||||
}
|
||||
}
|
||||
},
|
||||
"new_districts": {
|
||||
"Gaza": [
|
||||
"Chongoene",
|
||||
"Limpopo",
|
||||
"Mapai"
|
||||
],
|
||||
"Nampula": [
|
||||
"Larde",
|
||||
"Liupo"
|
||||
],
|
||||
"Niassa": [
|
||||
"Chimbonila"
|
||||
],
|
||||
"Tete": [
|
||||
"Doa",
|
||||
"Marara"
|
||||
]
|
||||
},
|
||||
"aliases": {
|
||||
"Cabo Delgado|Metuge|district": "PEMBA - METUGE",
|
||||
"Gaza|Mandlakaze|district": "MANDLACAZE",
|
||||
"Nampula|Erati|district": "NAMAPA-ERATI",
|
||||
"Nampula|Ilha de Mocambique|district": "CIDADE ILHA DE MOCAMBIQUE",
|
||||
"Nampula|Nacala-a-Velha|district": "NACALA-VELHA",
|
||||
"Nampula|Rapale|district": "NAMPULA",
|
||||
"Maputo Cidade|KaMphumu|district": "DISTRITO URBANO 1",
|
||||
"Maputo Cidade|Nlhamankulu|district": "DISTRITO URBANO 2",
|
||||
"Maputo Cidade|KaMaxakeni|district": "DISTRITO URBANO 3",
|
||||
"Maputo Cidade|KaMavota|district": "DISTRITO URBANO 4",
|
||||
"Maputo Cidade|KaMubukwana|district": "DISTRITO URBANO 5",
|
||||
"Maputo Cidade|KaTembe|district": "DISTRITO DE CATEMBE",
|
||||
"Maputo Cidade|KaNyaka|district": "DISTRITO DE INHACA",
|
||||
"Nampula|Nampula|district": "CIDADE DE NAMPULA",
|
||||
"Niassa|Lichinga|district": "CIDADE DE LICHINGA",
|
||||
"Gaza|Xai-Xai|district": "CIDADE DE XAI-XAI"
|
||||
},
|
||||
"authority": "Pedido de instalar restantes províncias e autorização expressa de oito distritos,13/11/2026. Correspondências históricas apresentadas na prévia autenticada,sem renomear nem fundir IDs.",
|
||||
"sources": [
|
||||
"https://archive.gazettes.africa/archive/mz/2013/mz-government-gazette-series-i-dated-2013-12-18-no-101.pdf",
|
||||
"https://international.ipums.org/international-action/variables/MZ2017A_0436",
|
||||
"https://archive.gazettes.africa/archive/mz/2020/mz-government-gazette-series-i-dated-2020-05-04-no-83.pdf"
|
||||
],
|
||||
"missing_province_source": "Zambézia",
|
||||
"city_mapping_decision": "Proprietário confirmou expressamente em13/11/2026 a ligação destes três rótulos às respectivas cidades,preservando Rapale,Chimbonila,Limpopo separados."
|
||||
}
|
||||
@@ -0,0 +1,23 @@
|
||||
{
|
||||
"files": {
|
||||
"Zambezia.xlsx": {
|
||||
"sha256": "8d502e25e1e1fec0cc381ba0aa47b35cfa1eea586de53cb69ffa201d3b5ffeb7",
|
||||
"records": 126684,
|
||||
"province": "Zambezia",
|
||||
"issues": {}
|
||||
}
|
||||
},
|
||||
"new_districts": {
|
||||
"Zambezia": [
|
||||
"Derre",
|
||||
"Luabo",
|
||||
"Mocubela",
|
||||
"Molumbo",
|
||||
"Mulevala"
|
||||
]
|
||||
},
|
||||
"aliases": {},
|
||||
"sources": [],
|
||||
"authority": "Proprietário autorizou expressamente Derre,Luabo,Mocubela,Molumbo e Mulevala e a incorporação de Zambezia.xlsx em13/11/2026,sem códigos oficiais ou geometria inferidos.",
|
||||
"missing_province_source": null
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,70 @@
|
||||
<?php
|
||||
|
||||
use App\Services\DemographicInstallation;
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
return new class extends Migration
|
||||
{
|
||||
public function up(): void
|
||||
{
|
||||
if (! app(DemographicInstallation::class)->schemaAllowed()) {
|
||||
throw new RuntimeException('Demografia: instalação exige QA isolado ou a acção autenticada autorizada.');
|
||||
}
|
||||
Schema::create('demographic_imports', function (Blueprint $t) {
|
||||
$t->uuid('id')->primary();
|
||||
$t->char('sha256', 64)->unique();
|
||||
$t->string('file_name');
|
||||
$t->string('source');
|
||||
$t->string('publication_version');
|
||||
$t->string('status')->default('prepared');
|
||||
$t->jsonb('report');
|
||||
$t->char('preview_sha256', 64);
|
||||
$t->foreignId('prepared_by')->constrained('users')->restrictOnDelete();
|
||||
$t->timestampsTz();
|
||||
});
|
||||
Schema::create('demographic_observations', function (Blueprint $t) {
|
||||
$t->bigIncrements('id');
|
||||
$t->foreignUuid('import_id')->constrained('demographic_imports')->restrictOnDelete();
|
||||
$t->foreignUuid('geo_location_id')->constrained('geo_locations')->restrictOnDelete();
|
||||
$t->unsignedSmallInteger('year');
|
||||
$t->string('indicator', 80);
|
||||
$t->string('sex', 10);
|
||||
$t->string('residence', 10);
|
||||
$t->string('age_group', 30);
|
||||
$t->string('unit', 80);
|
||||
$t->string('data_kind', 20);
|
||||
$t->string('original_value', 100);
|
||||
$t->text('numeric_value'); // Exact decimal text, including Excel storage precision.
|
||||
$t->string('sheet');
|
||||
$t->string('cell', 20);
|
||||
$t->string('validation_status', 20);
|
||||
$t->unique(['import_id', 'geo_location_id', 'year', 'indicator', 'sex', 'residence', 'age_group'], 'demography_dimension_unique');
|
||||
$t->index(['geo_location_id', 'year', 'indicator']);
|
||||
});
|
||||
Schema::create('demographic_events', function (Blueprint $t) {
|
||||
$t->bigIncrements('id');
|
||||
$t->foreignUuid('import_id')->constrained('demographic_imports')->restrictOnDelete();
|
||||
$t->foreignId('actor_id')->constrained('users')->restrictOnDelete();
|
||||
$t->string('action', 30);
|
||||
$t->text('reason');
|
||||
$t->jsonb('details');
|
||||
$t->timestampTz('created_at')->useCurrent();
|
||||
});
|
||||
DB::statement("ALTER TABLE demographic_imports ADD CONSTRAINT demographic_import_state CHECK (status IN ('prepared','imported','approved','disabled'))");
|
||||
DB::statement("ALTER TABLE demographic_observations ADD CONSTRAINT demographic_observation_state CHECK (validation_status IN ('valid','warning'))");
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges() || DB::table('demographic_imports')->exists()) {
|
||||
throw new RuntimeException('Preserve originais e histórico demográfico antes de reverter.');
|
||||
}
|
||||
Schema::dropIfExists('demographic_events');
|
||||
Schema::dropIfExists('demographic_observations');
|
||||
Schema::dropIfExists('demographic_imports');
|
||||
}
|
||||
};
|
||||
@@ -0,0 +1,54 @@
|
||||
<?php
|
||||
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
return new class extends Migration
|
||||
{
|
||||
public function up(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges()) {
|
||||
throw new RuntimeException('This first-stage migration is authorised only in isolated QA.');
|
||||
}
|
||||
Schema::create('portal_editorial_editions', function (Blueprint $t): void {
|
||||
$t->uuid('id')->primary();
|
||||
$t->foreignId('resource_id')->constrained('portal_resources')->restrictOnDelete();
|
||||
$t->unsignedInteger('revision_no');
|
||||
$t->unsignedInteger('version')->default(1);
|
||||
$t->string('state', 24)->default('draft');
|
||||
$t->jsonb('payload');
|
||||
$t->char('content_hash', 64);
|
||||
$t->foreignId('author_id')->constrained('users')->restrictOnDelete();
|
||||
$t->foreignId('assigned_to')->nullable()->constrained('users')->restrictOnDelete();
|
||||
$t->boolean('legal_required')->default(false);
|
||||
$t->jsonb('approval')->nullable();
|
||||
$t->jsonb('legal_validation')->nullable();
|
||||
$t->timestampTz('published_at')->nullable();
|
||||
$t->timestampsTz();
|
||||
$t->unique(['resource_id', 'revision_no']);
|
||||
$t->index(['state', 'assigned_to']);
|
||||
});
|
||||
Schema::create('portal_editorial_notifications', function (Blueprint $t): void {
|
||||
$t->id();
|
||||
$t->uuid('edition_id');
|
||||
$t->foreign('edition_id')->references('id')->on('portal_editorial_editions')->restrictOnDelete();
|
||||
$t->foreignId('user_id')->constrained('users')->restrictOnDelete();
|
||||
$t->string('action', 40);
|
||||
$t->timestampTz('read_at')->nullable();
|
||||
$t->timestampTz('created_at');
|
||||
$t->index(['user_id', 'read_at']);
|
||||
});
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges() || DB::table('portal_editorial_editions')->exists() || DB::table('portal_editorial_notifications')->exists()) {
|
||||
throw new RuntimeException('Preserve editions, decisions and history.');
|
||||
}
|
||||
Schema::dropIfExists('portal_editorial_notifications');
|
||||
Schema::dropIfExists('portal_editorial_editions');
|
||||
}
|
||||
};
|
||||
+39
@@ -0,0 +1,39 @@
|
||||
<?php
|
||||
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
return new class extends Migration
|
||||
{
|
||||
public function up(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges()) {
|
||||
throw new RuntimeException('Only isolated QA is authorised.');
|
||||
}
|
||||
Schema::table('portal_editorial_notifications', function (Blueprint $t): void {
|
||||
$t->uuid('edition_id')->nullable()->change();
|
||||
$t->foreignId('opportunity_id')->nullable()->constrained('opportunities')->restrictOnDelete();
|
||||
$t->unsignedInteger('opportunity_version')->nullable();
|
||||
$t->char('content_hash', 64)->nullable();
|
||||
$t->unique(['user_id', 'opportunity_id', 'opportunity_version', 'action'], 'portal_editorial_op_notice_uq');
|
||||
});
|
||||
DB::statement('ALTER TABLE portal_editorial_notifications ADD CONSTRAINT portal_editorial_notice_subject CHECK ((edition_id IS NOT NULL AND opportunity_id IS NULL) OR (edition_id IS NULL AND opportunity_id IS NOT NULL AND opportunity_version IS NOT NULL))');
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges() || DB::table('portal_editorial_notifications')->whereNotNull('opportunity_id')->exists()) {
|
||||
throw new RuntimeException('Preserve opportunity notification history.');
|
||||
}
|
||||
DB::statement('ALTER TABLE portal_editorial_notifications DROP CONSTRAINT portal_editorial_notice_subject');
|
||||
Schema::table('portal_editorial_notifications', function (Blueprint $t): void {
|
||||
$t->dropUnique('portal_editorial_op_notice_uq');
|
||||
$t->dropForeign(['opportunity_id']);
|
||||
$t->dropColumn(['opportunity_id', 'opportunity_version', 'content_hash']);
|
||||
$t->uuid('edition_id')->nullable(false)->change();
|
||||
});
|
||||
}
|
||||
};
|
||||
@@ -0,0 +1,37 @@
|
||||
<?php
|
||||
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
return new class extends Migration
|
||||
{
|
||||
public function up(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges()) {
|
||||
throw new RuntimeException('Only isolated QA is authorised.');
|
||||
}
|
||||
Schema::table('portal_editorial_editions', function (Blueprint $t): void {
|
||||
$t->unsignedBigInteger('resource_id')->nullable()->change();
|
||||
$t->foreignUuid('dossier_id')->nullable()->constrained('investment_dossiers')->restrictOnDelete();
|
||||
$t->unique(['dossier_id', 'revision_no']);
|
||||
});
|
||||
DB::statement('ALTER TABLE portal_editorial_editions ADD CONSTRAINT portal_editorial_edition_subject CHECK (num_nonnulls(resource_id,dossier_id)=1)');
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges() || DB::table('portal_editorial_editions')->whereNotNull('dossier_id')->exists()) {
|
||||
throw new RuntimeException('Preserve portfolio editorial history.');
|
||||
}
|
||||
DB::statement('ALTER TABLE portal_editorial_editions DROP CONSTRAINT portal_editorial_edition_subject');
|
||||
Schema::table('portal_editorial_editions', function (Blueprint $t): void {
|
||||
$t->dropUnique(['dossier_id', 'revision_no']);
|
||||
$t->dropForeign(['dossier_id']);
|
||||
$t->dropColumn('dossier_id');
|
||||
$t->unsignedBigInteger('resource_id')->nullable(false)->change();
|
||||
});
|
||||
}
|
||||
};
|
||||
@@ -0,0 +1,35 @@
|
||||
<?php
|
||||
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
return new class extends Migration
|
||||
{
|
||||
public function up(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges()) {
|
||||
throw new RuntimeException('Only isolated QA is authorised.');
|
||||
}
|
||||
Schema::table('portal_editorial_editions', function (Blueprint $table): void {
|
||||
$table->foreignUuid('demographic_import_id')->nullable()->constrained('demographic_imports')->restrictOnDelete();
|
||||
$table->unique(['demographic_import_id', 'revision_no'], 'editorial_demographic_revision_unique');
|
||||
});
|
||||
DB::statement('ALTER TABLE portal_editorial_editions DROP CONSTRAINT portal_editorial_edition_subject, ADD CONSTRAINT portal_editorial_edition_subject CHECK (num_nonnulls(resource_id,dossier_id,demographic_import_id)=1)');
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges() || DB::table('portal_editorial_editions')->whereNotNull('demographic_import_id')->exists()) {
|
||||
throw new RuntimeException('Preserve demographic editorial history.');
|
||||
}
|
||||
DB::statement('ALTER TABLE portal_editorial_editions DROP CONSTRAINT portal_editorial_edition_subject, ADD CONSTRAINT portal_editorial_edition_subject CHECK (num_nonnulls(resource_id,dossier_id)=1)');
|
||||
Schema::table('portal_editorial_editions', function (Blueprint $table): void {
|
||||
$table->dropUnique('editorial_demographic_revision_unique');
|
||||
$table->dropForeign(['demographic_import_id']);
|
||||
$table->dropColumn('demographic_import_id');
|
||||
});
|
||||
}
|
||||
};
|
||||
+35
@@ -0,0 +1,35 @@
|
||||
<?php
|
||||
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
return new class extends Migration
|
||||
{
|
||||
public function up(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges()) {
|
||||
throw new RuntimeException('Only isolated QA is authorised.');
|
||||
}
|
||||
Schema::table('portal_editorial_notifications', function (Blueprint $table): void {
|
||||
$table->foreignUuid('native_event_id')->nullable()->constrained('audit_events')->restrictOnDelete();
|
||||
$table->unique(['user_id', 'native_event_id', 'action'], 'editorial_native_notice_unique');
|
||||
});
|
||||
DB::statement('ALTER TABLE portal_editorial_notifications DROP CONSTRAINT portal_editorial_notice_subject, ADD CONSTRAINT portal_editorial_notice_subject CHECK (num_nonnulls(edition_id,opportunity_id,native_event_id)=1 AND (opportunity_id IS NULL OR opportunity_version IS NOT NULL))');
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges() || DB::table('portal_editorial_notifications')->whereNotNull('native_event_id')->exists()) {
|
||||
throw new RuntimeException('Preserve native editorial notifications and history.');
|
||||
}
|
||||
DB::statement('ALTER TABLE portal_editorial_notifications DROP CONSTRAINT portal_editorial_notice_subject, ADD CONSTRAINT portal_editorial_notice_subject CHECK ((edition_id IS NOT NULL AND opportunity_id IS NULL) OR (edition_id IS NULL AND opportunity_id IS NOT NULL AND opportunity_version IS NOT NULL))');
|
||||
Schema::table('portal_editorial_notifications', function (Blueprint $table): void {
|
||||
$table->dropUnique('editorial_native_notice_unique');
|
||||
$table->dropForeign(['native_event_id']);
|
||||
$table->dropColumn('native_event_id');
|
||||
});
|
||||
}
|
||||
};
|
||||
+35
@@ -0,0 +1,35 @@
|
||||
<?php
|
||||
|
||||
use App\Support\IsolatedQaDatabase;
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
return new class extends Migration
|
||||
{
|
||||
public function up(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges()) {
|
||||
throw new RuntimeException('Only isolated QA is authorised.');
|
||||
}
|
||||
Schema::table('portal_editorial_editions', function (Blueprint $table): void {
|
||||
$table->string('subject_kind', 40)->nullable();
|
||||
$table->uuid('subject_key')->nullable();
|
||||
$table->unique(['subject_kind', 'subject_key', 'revision_no'], 'editorial_subject_revision_unique');
|
||||
});
|
||||
DB::statement("ALTER TABLE portal_editorial_editions DROP CONSTRAINT portal_editorial_edition_subject, ADD CONSTRAINT portal_editorial_edition_subject CHECK (num_nonnulls(resource_id,dossier_id,demographic_import_id,subject_key)=1 AND ((subject_kind IS NULL)=(subject_key IS NULL)) AND (subject_kind IS NULL OR subject_kind IN ('projects','clusters','corridors','cluster-project','corridor-project','corridor-cluster','value-chains','value-chain-links','investment-gaps','zone-relations')))");
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
if (! IsolatedQaDatabase::allowsSchemaChanges() || DB::table('portal_editorial_editions')->whereNotNull('subject_kind')->exists()) {
|
||||
throw new RuntimeException('Preserve structural editions and decisions.');
|
||||
}
|
||||
DB::statement('ALTER TABLE portal_editorial_editions DROP CONSTRAINT portal_editorial_edition_subject, ADD CONSTRAINT portal_editorial_edition_subject CHECK (num_nonnulls(resource_id,dossier_id,demographic_import_id)=1)');
|
||||
Schema::table('portal_editorial_editions', function (Blueprint $table): void {
|
||||
$table->dropUnique('editorial_subject_revision_unique');
|
||||
$table->dropColumn(['subject_kind', 'subject_key']);
|
||||
});
|
||||
}
|
||||
};
|
||||
@@ -1,3 +1,326 @@
|
||||
## Entrega concluida na homologacao - 15/11/2026
|
||||
|
||||
**Revisao instalada e servida: `bd000d04d23402be26a1e6d309c39ef9239ab79d`.** Endereco: https://teste-investidor.tempo.co.mz. Executor Git encerrado em `verified_complete`, sem pedidos pendentes, watcher restabelecido e nginx/PHP/queue activos. Dashboard existente preservado; instaladas apenas as correccoes transversais compativeis.
|
||||
|
||||
O delta novo de **Ofertas foi excluido**: mantidos os 28 ficheiros protegidos e a configuracao da versao anteriormente instalada, comprovados no destino. Publicacao publica, NDA operacional e activacoes comerciais continuam bloqueados. Esta entrega nao aceita funcionalmente Ofertas.
|
||||
|
||||
Verificacao do destino: estrutura 1/3106; unitarios 132/611; interface 1966/1966 sem falhas; Wayfinder, tipos e compilacao aprovados; 35 verificacoes HTTP/recursos com resultados esperados. Revisao remota, executor e revisao servida coincidem. Filtros financeiros contraditorios recusados com 422; leitor publico/API/mapa/CSV sem Ofertas expostas. Reutilizadas as 15 provas autenticadas QA, incluindo emulacao movel; nao se presume nova conferencia visual autenticada em homologacao ou dispositivo fisico.
|
||||
|
||||
Backup actualizado e restauro isolado verificados. Reconciliadas 219 tabelas e 417 ficheiros persistentes: dados de negocio e ficheiros inalterados. Diferencas apenas em cache/reinicio/limites, sessoes e contadores agregados de pesquisa; nenhuma sessao anterior nao expirada foi removida. Nao executadas migracoes, alteracoes de permissoes, notificacoes externas ou pagamentos. Nao foi necessaria reversao.
|
||||
|
||||
Incidente resolvido: a primeira candidata `fb076c17` parou na regressao antes da promocao; pedido reconciliado e arquivado. Corrigidos os testes antigos sem retirar assercoes de seguranca e o bloqueio dos controlos de orcamento durante confirmacao/modo de leitura. Recibo sanitizado: `outputs/transversal-install-20261115/installation-verified.json`.
|
||||
|
||||
Pendente: avaliacao de negocio/experiencia da entrega e revisao funcional do delta Ofertas excluido. A consulta empresarial agregada permanece exclusivamente QA; nao se alargou o acesso operacional a dados internos.
|
||||
|
||||
Os registos seguintes sao historicos e conservam o estado observado em cada passagem.
|
||||
|
||||
---
|
||||
|
||||
## 15/11/2026 — entrega delimitada em preparação
|
||||
|
||||
Dashboard existente e correcções transversais: autorizados para homologação. Delta Ofertas: excluído por conferência visual/móvel e interface editorial ainda pendentes. Preservar o módulo instalado em 13497892, sem novas entradas, fotografias L1 ou formulário imobiliário da Etapa B. A entrega é derivada directamente da revisão servida; 142 testes de interface, Wayfinder, build e tipos passaram. As 15 provas transversais aceites são reutilizadas. Backup/restauro actualizado conferiu 219 tabelas e 417 ficheiros. Integração e instalação continuam por executar; ver o mesmo relatório de apresentação/contexto para a delimitação e os recibos posteriores.
|
||||
|
||||
## 14/11/2026 — hierarquia Administração/Dashboard corrigida e instalada em 96f51096
|
||||
|
||||
Revisão servida **`96f510965f70581a4b41dd94463f598b77dd7cf5`**, instalada pelo executor Git como correcção da organização expressamente pedida pela Tempo. **Administração** reúne os grupos Dashboard, Conteúdos e oportunidades, Cadastros e investimento, Pedidos e acompanhamento e Acessos e configuração. Os grupos sem destinos autorizados são omitidos. **Dashboard** contém as funções dos painéis, com `/dashboard` como visão geral; os cadastros administrativos permanecem nos outros grupos. O circuito editorial conserva nome e URL próprios. Operações administrativas foram retiradas de Mais/Área de trabalho sem perder destinos; funções pessoais mantêm o seu âmbito.
|
||||
|
||||
Verificação: hierarquia/cabeçalho/sidebar25 testes, apresentação/secções4, acesso4/35, HTML autenticado QA com build real1/11, tipos/análise estática/build aprovados. Executor: estrutura1/3106, unitários132/611, **1914 testes de interface**. No servidor, HTML completo dos dois painéis com conteúdo sintético e manifesto real passou200, assetHTTPS200 e destinos administrativos separados dos destinos de dashboard. A correcção do erro500 foi preservada. Conferência visual da sessão continua pendente pelo conector indisponível.
|
||||
|
||||
Novo backup/restauro195 tabelas conferido. Preservação final:192 tabelas e416 uploads inalterados; cache/reinício de workers/limites de pedidos,11 sessões novas (as65 anteriores preservadas) e1 resposta de pesquisa contabilizada foram reconciliados com a fonte anterior. Mantêm-se270 instituições,12 lotes e920.456 observações. Configuração protegida, designação jurídica e permissões anteriores preservadas; sem migrações ou publicação automática. Recibos em `outputs/administration-dashboard-hierarchy-20261114/destination-installation-verified.json`, `destination-html-verified.json`, `destination-navigation-summary.json`, `destination-runtime-reconciled.json`, `destination-ci-summary.json` e backup/restauro na mesma pasta.
|
||||
|
||||
Instalação concluída; não é necessária nova preparação. Conferir visualmente a navegação normal, incluindo janela estreita, sem reabrir as provas técnicas aceites.
|
||||
|
||||
## 14/11/2026 — correcção da hierarquia Administração → Dashboard
|
||||
|
||||
Clarificação expressa da Tempo: agrupar **todas as operações administrativas em Administração** e reservar **Dashboard** às funções dos painéis. A apresentação anterior misturava os cadastros do circuito editorial com o dashboard principal e conservava atalhos administrativos dentro de Mais. Esta correcção não acrescenta funcionalidades ou permissões.
|
||||
|
||||
Hierarquia comum ao cabeçalho e à navegação lateral, com grupos omitidos quando não têm destinos autorizados:
|
||||
|
||||
- **Administração → Dashboard:** Visão geral do painel `/dashboard`; O meu trabalho; manifestações, indicadores, pedidos recentes e acções rápidas quando o painel administrativo já os permite; circuito editorial, filas de revisão e notificações segundo os âmbitos existentes. Os investimentos próprios mantêm o contexto do painel aplicável. Os filtros e âncoras seleccionam a função actual.
|
||||
- **Administração → Conteúdos e oportunidades:** gestão de conteúdos, documentos, oportunidades, preparação de análises e concursos autorizados.
|
||||
- **Administração → Cadastros e investimento:** sectores, projectos, clusters, carteira, estruturas/relações, demografia, território, zonas, referências e educação, conforme a capacidade existente.
|
||||
- **Administração → Pedidos e acompanhamento:** interesses, CRM e atribuições autorizadas.
|
||||
- **Administração → Acessos e configuração:** gestão/auditoria de perfis e configurações já autorizadas.
|
||||
|
||||
Os cadastros deixam de figurar dentro de Dashboard; atalhos administrativos deixam de estar dispersos em Mais. Os destinos anteriores são preservados uma vez, incluindo funções de perfis antes em Área de trabalho. Funções pessoais e acessos públicos conservam a sua área. O painel `/dashboard` é a visão geral; `/management/editorial` volta a identificar-se como **Circuito editorial** e mantém os cartões/revisões existentes. Não se importam estados a partir de componentes de página; a correcção do manifesto permanece intacta.
|
||||
|
||||
QA: navegação/cabeçalho/sidebar **25 testes**, apresentação/secções **4**, acesso/inbox **4/35**, abertura HTML autenticada dos dois painéis com build real **1/11**, análise estática, tipos e compilação aprovados. Provas em `outputs/administration-dashboard-hierarchy-20261114`. Testa-se a hierarquia exacta, ausência de cadastros dentro de Dashboard, remoção das operações administrativas de Mais, preservação de destinos e âncoras reais. Instalação correctiva pelo processo Git existente com backup/restauro em curso; não declarar concluída até conferir a revisão servida. A conferência visual continua pendente pelo conector indisponível.
|
||||
|
||||
## 14/11/2026 — erro 500 corrigido e correcção instalada em dd20e747
|
||||
|
||||
A revisão `dd20e747036d45892faf3273a44e385132668ee4` foi promovida pelo executor Git para reparar a entrega do menu/dashboard. O manifesto servido volta a conter `resources/js/pages/management/editorial-workflow.tsx`. A geração do HTML completo no servidor com o template/manifesto reais e conteúdo exclusivamente sintético passou (200); o respectivo ficheiro compilado respondeu 200 por HTTPS. Não se simularam credenciais ou sessões privadas no destino. A abertura HTTP autenticada com o build real passou em QA (1/8), além dos 12 testes frontend focados. O executor aprovou **1911 testes de interface**, incluindo o novo controlo do manifesto, 132 unitários/611 asserções, estrutura 1/3106, tipos e compilação.
|
||||
|
||||
Novo backup/restauro: 195 tabelas, contagens/checksums coincidentes. Conferência posterior: **193 tabelas e 416 uploads inalterados**; diferenças apenas de cache e novas sessões, reconciliadas. Todas as 48 sessões anteriores preservadas, mais 11 novas; nenhuma sessão válida removida. Configuração protegida, permissões e designação jurídica anteriores mantidas. Mantêm-se 270 instituições, 12 lotes e 920.456 observações. Sem migrações ou publicações de conteúdo. Serviços activos e limites de autenticação conservados.
|
||||
|
||||
Recibos em `outputs/editorial-dashboard-500-20261114/destination-html-verified.json`, `destination-installation-verified.json`, `destination-runtime-reconciled.json`, `destination-ci-summary.json`, `destination-backup-summary.json`, `destination-restore-summary.json`, `http-build-test.log` e `reproduced-failure.log`. A anterior prova 302 sem sessão não fica apresentada como abertura HTML autenticada. **Erro do manifesto corrigido; instalação concluída.** A conferência visual da sessão do utilizador mantém-se distinta e pendente pelo conector indisponível. Não é necessária nova instalação para esta correcção.
|
||||
|
||||
## 14/11/2026 — correcção do erro 500 na abertura HTML do dashboard
|
||||
|
||||
Erro confirmado no registo de 14/11 às 10:00 UTC da revisão `73e1d7b9`: `Unable to locate file in Vite manifest: resources/js/pages/management/editorial-workflow.tsx`. O componente de página era também importado estaticamente por outras páginas para reutilizar os estados editoriais. O compilador gerou um chunk partilhado sem a chave de página exigida pelo `@vite` da resposta HTML. O login/302 e os dados JSON podiam funcionar; essas provas não demonstravam a abertura HTML autenticada.
|
||||
|
||||
Correcção delimitada: os mesmos estados passam para `resources/js/lib/editorial-states.ts`; as cinco páginas reutilizam esse módulo, sem importar estaticamente o dashboard. Sem mudança de rotas, permissões, configurações ou dados. Não se alterou o template global nem a segurança para contornar o erro.
|
||||
|
||||
Regressão reproduzida com o manifesto anterior. Com o build corrigido, o teste `EditorialDashboardBuildTest` usa o manifesto real e abre as duas páginas HTML autenticadas (visão geral e legislação), sem `withoutVite`: **1/8**. Os testes frontend afectados e o novo controlo de manifesto passaram (**12 casos**), com tipos/build aprovados. O controlo `editorial-dashboard-manifest.test.mjs` corre depois da compilação na bateria frontend obrigatória e impede promover uma candidata sem a entrada de página. Provas em `outputs/editorial-dashboard-500-20261114`.
|
||||
|
||||
Estado desta passagem: correcção em QA para reparar a entrega autorizada; instalação e conferência do build servido em curso pelo executor Git existente, com novo backup/restauro. Não declarar o 500 resolvido antes de conferir o manifesto e a geração HTML da revisão instalada. Conferência visual continua separada e pendente pelo conector indisponível.
|
||||
|
||||
## 14/11/2026 — menu Administração/Dashboard e apresentação instalados em 73e1d7b9
|
||||
|
||||
**Entrega autorizada concluída:** `73e1d7b96419873c6924e04e94f2a7374c18eb87`, confirmada em `https://teste-investidor.tempo.co.mz/build/revision.json`. Administração fica no menu principal para contas com destinos administrativos autorizados; Dashboard abre o submenu das actividades. A página `/management/editorial` apresenta os três grupos de cartões descritos abaixo, com fila e notificações preservadas. O painel operacional anterior, quando autorizado, fica também dentro de Dashboard. Visitantes mantêm os acessos públicos; não houve concessão de permissões.
|
||||
|
||||
Backup/restauro actualizado: **195 tabelas**, contagens e checksums coincidentes no restauro isolado; 417 entradas de ficheiros/configuração conferidas. O executor Git aprovou estrutura 1/3106, unitários 132/611, **1910 testes de interface**, tipos e compilação. A nova revisão foi promovida sem migrações ou alterações de configuração protegida.
|
||||
|
||||
Conferência final: **192 tabelas inalteradas** e **416 uploads com os mesmos bytes**. As três diferenças foram delimitadas: cache de apresentação/reinício de workers/limites de pedidos; mais uma resposta agregada de pesquisa, conservando as 21 linhas anteriores e os contadores monotónicos; limpeza de 16 sessões expiradas segundo a configuração existente de 120 minutos, sem remover sessões válidas, mais 12 novas sessões. Não se repuseram sessões expiradas nem se alterou a política de segurança. Mantêm-se **270 instituições**, **12 lotes**, **920.456 observações** e a designação jurídica anterior. Os endereços públicos responderam 200, a gestão conservou login e a API privada devolveu 401 sem sessão; serviços activos.
|
||||
|
||||
Recibos em `outputs/dashboard-navigation-20261114/destination-installation-verified.json`, `destination-runtime-reconciled.json`, `destination-navigation-summary.json`, `destination-ci-summary.json`, `destination-backup-summary.json`, `destination-restore-summary.json` e `installation-manifesto.json`. O pacote QA anterior mantém o hash; `outputs/recibo-menu-dashboard-73e1d7b9-20261114.zip` contém apenas os comprovativos sanitizados da instalação.
|
||||
|
||||
**Saldo:** instalação concluída. Resta a conferência visual autenticada, incluindo janela estreita, já identificada como pendente pela indisponibilidade do conector. Não é necessária nova preparação, reinstalação ou publicação de conteúdos. Os testes de renderização/compilação e a verificação dos destinos autorizados não substituem a conferência visual.
|
||||
|
||||
## 14/11/2026 — Administração principal e apresentação agrupada do dashboard em QA
|
||||
|
||||
Pedido expresso da Tempo: Administração fica no menu principal e Dashboard reúne as actividades num dropdown interno. Esta alteração posterior substitui, apenas para contas com destinos administrativos autorizados, a anterior opção de manter Administração dentro de Mais. Visitantes e contas sem esses destinos conservam os seis acessos públicos; não se apresenta um menu administrativo vazio.
|
||||
|
||||
O catálogo de navegação comum é reutilizado no cabeçalho e na navegação lateral. Administração contém Dashboard → Visão geral, Artigos, Legislação, Documentos, Oportunidades, Competitividade, Carteira, Demografia, Estruturas e relações, Conteúdos territoriais, Zonas e indicadores e Notificações, apenas conforme as autorizações e componentes existentes. O painel operacional anterior também passa para Dashboard quando a conta já tem esse destino autorizado. As restantes operações administrativas mantêm os seus destinos, sem duplicar ligações. O grupo activo acompanha a página actual. Em ecrãs pequenos os subgrupos expandem por toque/teclado, sem exigir abertura por hover.
|
||||
|
||||
A página `/management/editorial` passa a apresentar três grupos consistentes: **Conteúdos e oportunidades**, **Investimentos e competitividade**, **Território e dados**. Os acessos, contadores e estados existentes ficam alinhados em cartões, com adaptação de uma a três colunas, fila de conteúdos e notificações identificadas. Retiraram-se as ligações dispersas e o segundo bloco repetido de oportunidades. Guardas, filtros, decisões e histórico não mudam.
|
||||
|
||||
Provas em `outputs/dashboard-navigation-20261114`: 26 testes de navegação/apresentação, integração de avisos/acesso 4/32, análise estática, tipos e compilação aprovados. Testam-se ausência de administração para visitantes/contas sem âmbito, preservação de destinos, deduplicação, localização do grupo activo, dropdown desktop, expansão móvel, grupos/counters e omissão de áreas indisponíveis. Sem migrações, dados ou permissões alteradas. A conferência visual permanece pendente pelo bloqueio do conector já documentado; os testes de renderização não são apresentados como conferência visual.
|
||||
|
||||
**Estado:** implementado/verificado em QA, ainda sem instalação desta nova apresentação. A homologação mantém `a4541298`. Preparar uma única entrega pelo processo Git existente, com backup/restauro e autorização concreta; não reinstalar o complemento anterior nem republicar conteúdos.
|
||||
|
||||
## 14/11/2026 — complemento do dashboard instalado e activo em a4541298
|
||||
|
||||
**Instalação conjunta concluída**, após autorização expressa da Tempo. A revisão `a4541298c0a386ab8bfd8e3e531e12d432ec671b` está confirmada em `https://teste-investidor.tempo.co.mz/build/revision.json`. Utilização: `/management/editorial`, com login/MFA e os âmbitos existentes. Estruturas/relações/cadeias, revisão das zonas e indicadores documentais e notificações nativas estão activos. A designação jurídica nominal recebida foi aplicada à configuração protegida; a conta existe e tem correio verificado. Não se alteraram permissões gerais nem se publicaram conteúdos automaticamente.
|
||||
|
||||
Backup actualizado com **195 tabelas**, restauro isolado com contagens e checksums coincidentes, 417 entradas de ficheiros/configuração conferidas. As duas alterações aditivas e o contrato nominal foram instalados antes da entrega Git. O executor aprovou o ciclo de estrutura 1/3106, 132 testes unitários/611 asserções, **1906 testes de interface**, tipos, compilação e verificações de plataforma/implantação. O ramo `main` foi promovido pelo executor existente; não houve edição manual da pasta servida.
|
||||
|
||||
**Preservação final:** 192 tabelas com conteúdo inalterado, incluindo o conteúdo anterior das tabelas editoriais, e duas entradas nominais acrescentadas ao registo de migrações. As diferenças nas duas tabelas de funcionamento foram reconciliadas com o backup: cache apenas por reinício dos workers e limites de pedidos; os 33 identificadores de sessão anteriores preservados, sem alterar o seu conteúdo, e 11 novas sessões. Todos os **416 uploads** mantêm os bytes. Permanecem **270 instituições**, **12 lotes aprovados** e **920.456 observações**. Endereços públicos responderam 200; gestão conservou o redireccionamento de autenticação e a API privada devolveu 401 sem sessão. Nginx, PHP-FPM e fila de implantação activos.
|
||||
|
||||
Recibos: `outputs/editorial-completion-20261114/destination-installation-verified.json`, `destination-backup-summary.json`, `destination-restore-summary.json`, `destination-schema-summary.json`, `destination-framework-reconciled.json`, `destination-activation-summary.json`, `destination-ci-summary.json` e `installation-manifesto.json`. O pacote QA selado permanece intacto; `outputs/recibo-entrega-dashboard-a4541298-20261114.zip` acrescenta apenas os comprovativos sanitizados da instalação.
|
||||
|
||||
**Saldo deste complemento:** instalação e configuração jurídica deixam de ser pendências. Resta a conferência visual autenticada dos percursos e da janela estreita; o conector continua identificado como indisponível, sem reinícios repetidos ou alterações de segurança. Os testes de interface não substituem essa conferência. Não é necessária nova preparação ou reinstalação. O restante saldo funcional do portal mantém-se na mesma matriz, fora deste complemento do dashboard.
|
||||
|
||||
## 14/11/2026 — complemento único do Dashboard Colaborativo em QA
|
||||
|
||||
**Estado:** a homologação mantém a entrega confirmada `d5c960b6`. Este complemento está implementado e verificado em QA, sem instalação. A nomeação do validador jurídico foi recebida da Tempo; não permanece como decisão organizacional em falta. A configuração nominal será aplicada apenas na entrega conjunta, conservando os restantes âmbitos da conta.
|
||||
|
||||
- **Fila e notificações:** Competitividade, perfis territoriais e revisão de zonas reutilizam a caixa editorial comum. As notificações identificam o registo e a versão, não concedem acesso; a leitura volta a conferir o âmbito actual. Contadores excluem publicações/arquivos e não adoptam automaticamente fontes ou zonas antigas.
|
||||
- **Estruturas e cadeias:** projectos, clusters e corredores sem ficha, relações entre eles e com zonas, etapas, ligações e lacunas usam as mesmas edições, decisões e auditoria. Não se cria outro dossier. Alterar conserva a publicação anterior; novos elementos de cadeia permanecem privados. Retirar exige proposta e publicação expressas. Conflitos de versão, relações repetidas, contexto territorial alterado, datas ou montantes incompatíveis não sobrescrevem os registos.
|
||||
- **Outras estatísticas existentes:** observações e indicadores documentais das zonas reutilizam o rascunho encriptado, revisões e projecção pública nativos. Conservar valor decimal, unidade, período, âmbito e fonte; revisão → aprovação → publicação são operações distintas. Alterações no conteúdo, contexto, anexos ou autoridade invalidam a decisão. Consultar uma revisão recupera a descrição e observações exactas sem alterar a edição actual. Agregados privados de origem/análise proactiva continuam derivados dos dados autorizados; não se inventa um conjunto editorial público nem totais em falta.
|
||||
- **Legislação:** `PORTAL_EDITORIAL_LEGAL_REVIEWERS` permite a designação nominal recebida, com correio verificado e âmbito documental/MFA existentes. Não concede gestão geral, não aprova versões anteriores e não atribui autoridade jurídica sobre zonas ou cálculos.
|
||||
|
||||
**Utilização após instalação:** abrir `/management/editorial`; as filas existentes continuam disponíveis. Aceder a **Estruturas e relações** em `/management/editorial/subjects`, escolher o registo e usar **Alterar proposta**; guardar → submeter → iniciar revisão → aprovar → publicar. O editor nativo continua a ser a entrada para criar os registos. Nas zonas, abrir `/management/investment/zones/{id}`, guardar a preparação, usar **Revisão da zona e dos indicadores** e publicar separadamente. **Histórico editorial → Conferir versão** é consulta privada, sem restauração automática. Todos os endpoints, escolhas de catálogo, pré-visualizações e decisões conferem permissões no servidor.
|
||||
|
||||
**Verificação do delta:** `outputs/editorial-completion-20261114` contém os recibos. Testes focados finais 28/361, regressão nativa afectada 35/540, frontend 13, tipos e compilação aprovados. A análise estática dos ficheiros alterados passou após correcções localizadas. Duas migrações QA adicionam três colunas e respectivas restrições/índices, sem backfill de conteúdos ou permissões. SQL nominal ensaiado numa cópia isolada no cluster 55441, comparado com o QA original; repetição recusada sem alterações. Operações no destino activo: zero neste complemento.
|
||||
|
||||
**Entrega única e recuperação:** preservar os pacotes anteriores. Instalar apenas a candidata conjunta após autorização concreta, pelo executor Git existente, com backup/restauro conferido, contrato nominal das duas migrações e activação de `PORTAL_EDITORIAL_STRUCTURES_ENABLED` e `PORTAL_EDITORIAL_ZONE_REVIEW_ENABLED`. Configurar o validador nominal protegido na mesma passagem. Não executar migrações indiscriminadamente, republicar fontes ou alterar permissões gerais. Após escritas nas novas versões, conservar colunas e histórico; usar reparação compatível em vez de remover as migrações. Restauro integral apenas antes de novas operações, com conferência de dados.
|
||||
|
||||
**Conferência visual:** em 14/11/2026 a enumeração identificou Edge/Firefox como aplicações, mas devolveu `Browsers: Error: The browser access host is unavailable`, sem abas nem URL verificáveis. Não se repetiram reinícios nem se alteraram portas, permissões ou segurança. Permanece por conferir, na candidata QA autenticada, fila → proposta → decisão → publicação, notificações/histórico e janela estreita. Não declarar esta conferência aprovada nem a instalação deste complemento concluída. O fecho deste dashboard não declara concluídas as restantes funcionalidades do portal.
|
||||
|
||||
## 14/11/2026 — pacote editorial instalado e activo na homologação
|
||||
|
||||
Instalação conjunta expressamente autorizada pelo proprietário, incluindo as quatro alterações aditivas de estrutura. Revisão efectivamente servida e conferida em `https://teste-investidor.tempo.co.mz/build/revision.json`: **d5c960b62f97f04fb41acf71197ad2e7abbdf099**. Integra a candidata editorial `b3d4b7ab` e preserva as alterações fiscais/mapa aceites até `e4735424`, mediante duas integrações sem conflitos de código editorial. O Git/webhook/executor existentes fizeram a compilação e a substituição atómica; nenhuma edição manual da release servida.
|
||||
|
||||
Os cinco componentes estão activos: circuito comum de artigos/legislação/documentos e ligação às oportunidades nativas; Competitividade; carteira/dados-base/localização vinculados; novos lotes demográficos; perfis territoriais nativos. Entrada da equipa: `/management/editorial`; território: `/management/territorial/editorial`. Mantêm os perfis, âmbito, autenticação e MFA existentes. Não foram atribuídas contas, funções ou permissões nem publicados conteúdos automaticamente. **A validação jurídica de novas versões que a exijam continua dependente de designação nominal explícita; a lista de validadores permanece vazia.** Isto não retira conteúdos já publicados nem bloqueia os restantes percursos.
|
||||
|
||||
Backup consistente de 193 tabelas e 417 entradas de ficheiros/configuração em `/var/backups/investmoz-editorial-20261114/backup`, com hashes conferidos. Restauro isolado integral comparado por contagens e checksums, seguido do ensaio do SQL exacto; 416 ficheiros carregados preservados. O SQL aditivo e o contrato nominal foram instalados separadamente do executor Git, conforme a autorização; as quatro migrations no código continuam com guarda QA. Contas, concessões e conteúdos não foram alterados. Após existirem edições, não efectuar downgrade para código que ignore o histórico nem eliminar as estruturas: pausar o circuito preservando código compatível e decisões.
|
||||
|
||||
Preservação confirmada: 270 instituições publicadas, 12 lotes demográficos aprovados e 920 456 observações; os hashes das tabelas de negócio, territórios e autorizações conferidas mantêm-se. A diferença inicial nos rascunhos de simulação resultava de leitura sem actor sob RLS. Repetida a comparação com a identidade do backup, os 12 registos e o checksum coincidem; nenhuma alteração de permissões ou dados foi necessária.
|
||||
|
||||
O executor aprovou compilação, tipos, requisitos de plataforma, diagnóstico C132, teste de ciclo de schema (3 106 asserções), 132 testes unitários/611 asserções e 1 902 testes frontend. Consulta pública, login, instituições, demografia, Mineração e Energia responderam 200; gestão manteve redirecção para login e API privada recusou consulta anónima (401). A conferência usa o cliente identificado do executor existente; não foram desactivadas verificações de segurança. Estes controlos não substituem a conferência visual autenticada.
|
||||
|
||||
Recibos finais locais em `outputs/editorial-agrupado-20261114/destination-installation-verified.json`, `destination-ci-summary.json`, `destination-draft-identity-summary.json` e recibos de backup/restauro/schema/activação na mesma pasta. O pacote QA de 13/11 e o pacote autorizado de 14/11 permanecem intactos. **Instalação deixa de ser pendência destes recortes.** Saldo: conferência visual, designação jurídica nominal, outras estatísticas, estruturas sem ficha, relações/cadeias e notificações próprias de Competitividade/território. A instalação não encerra o portal integral nem esses resíduos.
|
||||
|
||||
## 14/11/2026 — revisão territorial privada e preservação da publicação
|
||||
|
||||
O registo territorial existente guarda agora as alterações numa revisão privada encriptada, sem mudar `geo_locations` nem o perfil publicado. Reutiliza as revisões e os recibos idempotentes nativos, sem nova tabela ou motor. O percurso é guardar proposta → submeter → iniciar revisão → aprovar → publicar. Aprovar não publica. O editor não pode rever nenhum conteúdo para o qual contribuiu; o publicador é distinto dos contribuidores e do revisor, conservando a separação nativa. Fontes oficiais já aceites não recebem nova exigência de autenticação.
|
||||
|
||||
A publicação confere a versão, o conteúdo, a fonte e a hierarquia, bloqueia as linhas de contexto e aplica a alteração numa transacção. Alterações posteriores exigem nova revisão; conflitos não sobrescrevem a proposta. Arquivar uma proposta conserva a publicação anterior. Retirar expressamente a publicação mantém a proposta e a revisão pendentes. O estado anterior fica no histórico, sem fabricar aprovação. Fontes e referências sem perfil territorial nativo não são adoptadas nem modificadas por este recorte.
|
||||
|
||||
Gestão: `/management/territorial/editorial`, ligada ao circuito editorial, com lista paginada, proposta, comparação com o nome/estado público, fonte, validade, fundamento e histórico. As APIs e pré-visualizações mantêm autenticação, gestão, MFA, resposta privada e permissões no servidor. As escritas exigem MFA fresco antes de repetir um recibo; desligar o circuito não permite contornar versões privadas existentes. O formulário conserva edições durante erros e impede mudar de registo ou decidir enquanto há alterações por guardar. As fontes disponíveis vêm do catálogo existente; a selecção mostra até 100 fontes, com aviso no limite. Criação de fontes e alterações de hierarquia continuam nas APIs nativas; o ecrã novo edita os conteúdos dos perfis existentes.
|
||||
|
||||
Provas em `outputs/editorial-territorial-20261114/`: cinco percursos novos/67 asserções, cinco testes nativos/44 asserções, dois testes de apresentação do novo ecrã; testes frontend afectados, PHPStan, tipos e compilação registados na mesma pasta. Dados sintéticos, transacções revertidas e bases QA isoladas em 55441. Conferência visual humana pendente; nenhuma instalação ou alteração operacional.
|
||||
|
||||
Saldo do pacote conjunto: Fase 1, Competitividade, fichas e dados-base/localização vinculados à carteira, novos lotes demográficos e perfis territoriais nativos implementados em QA. Permanecem outras estatísticas, estruturas sem ficha, relações/cadeias e notificações próprias de Competitividade/território. Estes resíduos não são encerrados pelo pacote. A instalação conjunta exige contrato operacional das quatro alterações aditivas de schema, backup/restauro e autorização concreta; as migrações actuais continuam limitadas ao QA. Não executar `migrate` indiscriminadamente nem enviar este ramo a `main` antes dessa preparação.
|
||||
|
||||
## 14/11/2026 — publicação editorial dos novos lotes demográficos
|
||||
|
||||
O circuito comum integra agora os novos lotes demográficos já importados para consulta privada: preparar revisão → submeter → iniciar revisão → aprovar → publicar. Aprovar a edição não altera o estado nativo `imported`; só a publicação explícita disponibiliza a série às análises existentes. As séries anteriormente `approved` conservam o estado e as observações, sem nova aprovação. Uma fonte nova continua a ser um lote próprio; não é substituída a série anterior. Arquivar uma publicação desactiva esse lote, conservando valores, originais e eventos.
|
||||
|
||||
As decisões vinculam o SHA256 do original e da prévia, a proveniência, advertências, correspondências territoriais e a integridade de todas as observações. A impressão digital usa SHA256 dos registos em agregados particionados no PostgreSQL; o bloqueio de publicação percorre os registos em blocos, sem carregar a série inteira na memória PHP. Uma alteração nos originais, observações ou proveniência é recusada, inclusive ao tentar legitimá-la como nova revisão. Uma alteração do contexto territorial sinaliza revisão e permite nova edição sem alterar os números. Não foi criada outra tabela de observações, nem reexecutado o preparador dos exemplares aceites.
|
||||
|
||||
A gestão nativa liga à revisão comum e ao download protegido do original. O painel/fila mostra pendências e notificações apenas aos operadores com a autoridade existente. A aprovação independente é configurável por `demography`, sem inventar novas designações; as provas usam actores sintéticos separados. Escritas exigem MFA válido na sessão. A operação antiga de disponibilização não contorna o circuito, mesmo após desactivá-lo. Publicações versionadas são retiradas pelo arquivo explícito da edição. A resposta vazia de uma operação é tratada sem expor `JSON.parse` nem confirmar um resultado desconhecido.
|
||||
|
||||
Migração `2026_11_13_233000_extend_editorial_editions_to_demography` instalada apenas na base própria QA 55441: acrescenta a associação do lote à edição comum e mantém a exclusividade do sujeito. Recibo `outputs/editorial-demography-20261114/qa-installation.json`: contagens das 177 tabelas anteriores preservadas, excepto o livro de migrações, sem preenchimento retroactivo ou alteração de contas/permissões. Reversão recusa remover histórico.
|
||||
|
||||
Provas no mesmo directório: seis casos iniciais aprovados, incluindo o ensaio de **131400 observações com limite PHP de 256 MB** (`integration.log`); cinco casos funcionais reforçados aprovados/66 asserções (`integration-final.log`); regressão demográfica anterior 14/52; regressão Fase 1 11/223, carteira 5/199 e dados-base 6/178. Frontend 24 testes, PHPStan, tipos e compilação aprovados. As observações do ensaio grande são sintéticas, não dados INE reais; todos os dados de prova são revertidos por transacção.
|
||||
|
||||
Saldo: novos lotes têm circuito de publicação separado demonstrado em QA e integram a candidata agrupada. Sem instalação operacional, publicação real ou alterações aos doze lotes anteriormente disponibilizados. A entrega passa a incluir quatro migrações QA do circuito comum; o contrato/schema operacional, a autorização concreta e a instalação conjunta continuam pendentes. Conferência visual pendente. Outras estatísticas, registo territorial, estruturas sem ficha, relações/cadeias e notificações próprias de Competitividade não são encerrados por este recorte.
|
||||
|
||||
## 13/11/2026 — dados-base e localização ligados à mesma edição da carteira
|
||||
|
||||
O recorte de carteira inclui agora os dados-base de projectos, clusters e corredores com ficha existente. Nome, código, estado operacional, descrição/sector, orçamento e datas são guardados como alterações propostas na mesma edição privada. A localização reutiliza a selecção/hierarquia territorial existente e fica igualmente proposta, com contador próprio e contexto territorial por hash. A gestão recupera os campos deliberados; a consulta pública continua a ler os valores anteriores. Publicar a edição aprovada aplica ficha, dados-base e localização numa única transacção, reutilizando as auditorias de gestão e território.
|
||||
|
||||
Conflitos de edição ou de código não sobrescrevem dados. Um código ocupado depois da aprovação devolve 409 e reverte ficha/dados-base em conjunto. Alterações da referência territorial invalidam a decisão; a publicação bloqueia as linhas de contexto durante a reconferência. Todos os contributos privados continuam sujeitos à independência da carteira. Desactivar o circuito ou arquivar a ficha não permite contornar a revisão. Ao iniciar outro ciclo depois de publicar/arquivar, alterações propostas antigas não são reaplicadas silenciosamente. Cadastros internos sem ficha associada conservam o comportamento anterior: este recorte não encerra o versionamento de todas as estruturas nem das suas relações/cadeias de valor.
|
||||
|
||||
Provas em `outputs/editorial-structures-20261113/`: 6 testes novos/178 asserções; carteira 5/199; regressão de estruturas/território 19/289; Fase 1 11/223; frontend 21 testes. PHPStan, tipos e compilação aprovados. Nenhuma nova migração deste recorte, nenhuma alteração de contas/permissões ou instalação operacional. Alterações integradas na candidata agrupada; estatística, indicadores demográficos e conteúdos territoriais continuam no saldo da Fase 2, assim como as notificações próprias de Competitividade e as estruturas sem ficha. Conferência visual pendente.
|
||||
|
||||
## 13/11/2026 — fichas da carteira integradas no mesmo circuito e pacote editorial
|
||||
|
||||
**Lacuna corrigida em QA:** guardar uma ficha de projecto âncora, cluster ou corredor deixava de a disponibilizar ao público. Com `PORTAL_EDITORIAL_PORTFOLIO_ENABLED` activo, o editor existente guarda uma edição privada e conserva integralmente o registo público, incluindo título, conteúdo, fonte, versão e datas. A confirmação independente continua obrigatória; aprovar e publicar são operações distintas. A publicação anterior só é substituída pela publicação explícita da edição aprovada. Arquivar uma edição privada preserva-a; arquivar a edição pública actual retira-a da consulta, sem apagar dados ou históricos.
|
||||
|
||||
**Reutilização:** mesmas tabelas, decisões, transições, auditoria, responsáveis, notificações e ecrã do circuito Fase 1. A migração aditiva `2026_11_13_230000_extend_editorial_editions_to_portfolio` permite que uma edição pertença a um recurso documental OU a uma ficha da carteira, com chaves estrangeiras, unicidade da revisão e exclusividade do sujeito. Não foi criado outro motor nem um segundo dossier. A estrutura foi instalada exclusivamente em `editorial_phase1_20261113_test:55441`; recibo em `outputs/editorial-portfolio-20261113/qa-installation.json`, com as contagens das 177 tabelas anteriores preservadas, excepto o incremento do livro de migrações. A reversão recusa remover histórico da carteira existente.
|
||||
|
||||
**Percurso:** Gestão de conteúdos → Carteira → abrir ficha → guardar alteração → «Conferir versões, submeter, aprovar e publicar no circuito editorial». O ecrã mostra a edição exacta, a fonte e o contexto identificado, conteúdo, versões, decisão e histórico. Submeter com responsável, iniciar revisão, aprovar e publicar separadamente. O painel indica as fichas pendentes; as notificações ligam à edição concreta. Os gestores usam as autorizações existentes; todas as escritas exigem MFA válido. API/JSON e prévias verificam a autoridade no servidor. Leitura privada usa `private, no-store`; a gestão da carteira reutiliza também o histórico Inertia cifrado.
|
||||
|
||||
**Integridade:** o hash liga a edição ao seu conteúdo e contexto de projecto/cluster/corredor, incluindo dados relevantes da entidade. Alterações do contexto ou da edição exigem nova aprovação. Todos os colaboradores privados são excluídos da aprovação e publicação dessa edição, preservando a independência já exigida na carteira. A publicação reconfere a autoridade do aprovador. Tentativas pela antiga operação combinada são recusadas. Desactivar o módulo não permite contornar o circuito para editar fichas com histórico novo. Um contexto desactualizado impede aprovar/publicar, mas permite devolver/rejeitar para correcção, sem prender a revisão. Versões anteriores, razões e dados deliberados ficam conservados.
|
||||
|
||||
**Provas:** 5 testes novos/199 asserções; regressão Fase 1 11/223; carteira anterior 8/201; notificações nativas de oportunidades 1/20; frontend 20 testes. PHPStan focado, tipos e compilação aprovados. Provas em `outputs/editorial-portfolio-20261113/`, incluindo `integration-final.log`, `phase1-regression-final.log`, `native-regression.log`, `opportunity-notices-regression.log`, `frontend-final.log`, `analysis-final.log`, `types-final.log` e `build.log`. Os testes de carteira anteriores usam a base nativa própria e descartável; os novos usam transacções revertidas. Não foram submetidos processos reais, alteradas permissões ou publicados conteúdos reais.
|
||||
|
||||
**Entrega e saldo:** este avanço integra a candidata agrupada, preservando os pacotes anteriores. A instalação operacional continua por executar e inclui agora três migrações da Fase 1/carteira; as migrações só autorizam QA e o executor Git não executa SQL no destino. É necessário preparar/autorizar a aplicação nominal do schema e contrato, backup/restauro e instalação conjunta pelo processo existente. A conferência visual permanece pendente, sem invalidar as provas aceites. Este recorte versiona as fichas públicas da carteira; a edição dos dados-base de projectos/clusters, relações, estatística, indicadores demográficos e conteúdos territoriais ainda não fica encerrada, nem as notificações próprias de Competitividade. Nenhuma instalação ou activação em homologação/produção foi efectuada.
|
||||
|
||||
## 13/11/2026 — pacote agrupado do Dashboard Colaborativo e revisão de Competitividade
|
||||
|
||||
**Decisão do proprietário:** agrupar melhorias e funcionalidades relacionadas para uma instalação conjunta quando o conjunto estiver pronto. O pacote desta passagem reúne a Fase 1 e o primeiro recorte editorial da Fase 2: análise de Competitividade dos clusters. Não representa o fecho de toda a Fase 2 nem autorização para publicar conteúdos.
|
||||
|
||||
**Disponível em desenvolvimento/QA:** o editor existente dos clusters permite guardar → submeter → iniciar revisão → aprovar → publicar, com devolução, rejeição, arquivo e recuperação do histórico. A aprovação deixa de publicar quando `PORTAL_EDITORIAL_CLUSTER_WORKFLOW_ENABLED` estiver activo. Uma análise anteriormente pública continua disponível ao activar o novo circuito, guardar, rever, recuperar ou arquivar um rascunho. Publicar substitui-a explicitamente; retirar a publicação não cancela uma revisão privada em curso. Estados editoriais e estado operacional do cluster aparecem separados na lista existente, acessível pela Gestão de conteúdos/Circuito editorial.
|
||||
|
||||
**Versões e autoridade:** o hash vincula o conteúdo das cinco forças e o contexto identificado do cluster (nome, código, sector, estado e território). Alterações posteriores exigem guardar nova edição e obter nova aprovação. Conflitos devolvem 409 sem sobrescrever texto. A política independente já configurável aceita o tipo `cluster_competitiveness` e impede aprovação por qualquer colaborador da edição quando exigida. O publicador reconfere a autoridade actual do aprovador. As escritas verificam gestão existente, exclusão de auditor e MFA da sessão no servidor. O histórico continua no mecanismo cifrado e aditivo existente; não há migração nem novo motor de Competitividade. A exposição pública conserva apenas análise publicada, versão e data, sem decisões privadas/identidades. Desactivar o circuito conserva a publicação e impede retomar por uma operação legada que contorne as decisões.
|
||||
|
||||
**Provas aceites:** 14 testes de integração de clusters/252 asserções, incluindo os sete testes anteriores; regressão Fase 1 11/223; frontend 18 testes. PHPStan focado, tipos e compilação aprovados. Provas em `outputs/editorial-clusters-20261113/`. As provas anteriores de oportunidades e anexos são reutilizadas, sem repetição. Dados sintéticos em transacções revertidas na base própria de QA 55441; sem alteração operacional, novas concessões ou publicação real.
|
||||
|
||||
**Pacote/instalação:** bundle Git conjunto a partir da base `2f1ef2fd`, manifesto com hashes e provas, preservando o bundle anterior. O executor continua a ser `deploy/homologacao/pipeline.py`; não foi alterado. Antes de instalar: confirmar revisão/base e delta, backup recuperável e ensaio de restauro isolado; tratar expressamente as duas migrações aditivas da Fase 1 e o contrato nominal de schema do destino. O executor Git não executa SQL no destino e as migrações actuais só autorizam QA: não basta enviar este pacote a `main`. Após instalação autorizada, conferir a revisão efectivamente servida, acessos e os percursos afectados, sem republicar conteúdo. Reversão pelo executor existente preserva dados; não usar rollback destrutivo de tabelas com histórico. Não foi obtido novo backup remoto nem executada instalação nesta passagem.
|
||||
|
||||
**Saldo concreto:** Competitividade tem agora aprovação/publicação separadas demonstradas em QA. Conferência visual, preparação operacional do schema/contrato, configuração explícita de designações e instalação conjunta continuam pendentes. Versionamento editorial dos dados-base de projectos âncora/clusters, estatísticas, indicadores demográficos e conteúdos territoriais continua por implementar; notificações editoriais dos clusters não são encerradas por este recorte. A Fase 1 continua identificada separadamente no mesmo saldo. Sem alterações a dados demográficos, instituições ou restantes entregas aceites.
|
||||
|
||||
## 13/11/2026 — Dashboard Colaborativo, Fase 1 implementada em desenvolvimento/QA
|
||||
|
||||
**Âmbito:** artigos, legislação, documentos e integração do circuito existente de oportunidades. A versão pública de um artigo permanece integralmente inalterada ao guardar ou rever uma nova edição privada, incluindo metadados, identificador e contador públicos. Não houve intervenção na homologação ou produção nesta passagem.
|
||||
|
||||
**Utilização em QA:** depois de instalar as duas migrações aditivas em base isolada e activar `PORTAL_EDITORIAL_WORKFLOW_ENABLED`, entrar pelo Painel/Gestão de conteúdos → Circuito editorial (`/management/editorial`). Alterar no editor existente, guardar a edição, conferir conteúdo/anexos e submeter com fundamento e responsável. O revisor inicia a revisão, valida juridicamente quando exigido e aprova. Publicar é uma segunda operação explícita. Devolução, rejeição e arquivo exigem fundamento. Arquivar um rascunho preserva a publicação anterior; arquivar a edição pública actual retira-a explicitamente. A fila permite filtrar tipo/estado e consultar versões, responsáveis e histórico. As notificações internas ligam à edição concreta ou à oportunidade no circuito nativo e podem ser marcadas como lidas.
|
||||
|
||||
**Autorizações e versões:** verificações no servidor para HTML, JSON, prévias e anexos; MFA existente nas escritas; escopos e permissões existentes, incluindo revogação de acesso. Aprovação e validação jurídica vinculadas à edição, conteúdo e versões/hashes dos anexos. Alterações ou bytes diferentes impedem reaproveitar a decisão. Conflitos de edição devolvem 409. Auto-aprovação bloqueada quando a política independente a exige, abrangendo todos os colaboradores da edição. A configuração `editorial_workflow.independent_approval` distingue a obrigação de independência do campo legado que apenas regista a revisão efectuada. A designação jurídica em `legal_reviewers` é explícita; não foram criadas contas, perfis ou concessões. A fonte oficial já aceite não é novamente auditada por este circuito.
|
||||
|
||||
**Oportunidades:** reutilizam filas, atribuições, revisões, publicador independente, prévias e histórico existentes. Novas submissões com a Fase 1 activa vinculam a validação jurídica à versão exacta e à versão dos anexos. Submissões já aprovadas mantêm o contrato/hash anterior. Notificações próprias e resumo de pendências entram no painel sem conceder acesso a outra organização ou conteúdo. Não existe um segundo motor de oportunidades.
|
||||
|
||||
**Verificação:** testes de integração do novo circuito, 11 aprovados/223 asserções; regressão e aceitação nativa de oportunidades, 6 aprovados/116 asserções, mais o caso reforçado de notificações isolado, 1 aprovado/20 asserções; unidade jurídica, 1 aprovado/6 asserções; frontend, 12 aprovados. PHPStan focado e tipos/compilação aprovados. A tentativa inicial nativa sem activos de compilação e com armazenamento de fixtures partilhado foi descartada; as provas aceites usam activos e armazenamento QA separados. Provas locais: `outputs/editorial-phase1-20261113/` (`integration-final.log`, `opportunity-acceptance.log`, `opportunity-notices.log`, `legal-unit.log`, `frontend-final.log`, `analysis-final.log`, `types-final.log`, `build-delivery.log`).
|
||||
|
||||
**Estrutura e preservação:** base própria `editorial_phase1_20261113_test`, PostgreSQL de QA 55441. Primeira migração criou duas tabelas vazias; segunda acrescentou o vínculo de notificações às oportunidades. Recibos `qa-installation.json` e `qa-notification-installation.json`: contagens das 175/177 tabelas preexistentes preservadas em cada etapa, excepto incremento documentado do livro de migrações. Sem preenchimento retroactivo, publicação automática, alteração de contas/permissões, nem escrita em bases operacionais. Reversão das migrações recusa apagar histórico existente; desactivar o novo módulo preserva dados e exige planear qualquer retoma de edição legada.
|
||||
|
||||
**Saldo:** implementado e demonstrado por testes em QA; conferência visual no navegador pendente. Activação operacional, designações jurídicas/independência efectivas e instalação fora do QA não executadas, dependem de decisão concreta. As migrações desta fase recusam destinos operacionais. Fase 2 (projectos âncora, clusters, estatística, demografia e conteúdos territoriais) continua delimitada para trabalho posterior; não é encerrada por esta entrega. Preservadas as entregas anteriores e o trabalho paralelo na pasta original.
|
||||
|
||||
## 13/11/2026 — pesquisa rápida: intenções e categorias, implementada em QA
|
||||
|
||||
A pesquisa reconhece contagens do catálogo publicado (por exemplo, «quantos corredores existem»), sem misturar projectos ou oportunidades apenas por mencionarem corredores. Zero registos e indisponibilidade de uma fonte têm apresentação distinta. «Como licenciar uma empresa» conduz ao roteiro existente e à preparação de S08 no dossier, sem inventar requisitos oficiais.
|
||||
|
||||
Produtos físicos e financeiros aparecem em categorias separadas, com opções Todos / Produtos físicos / Produtos financeiros e preservação do filtro e paginação. Exemplos: «tipo de produtos e sua localização», «onde encontrar grafite em Cabo Delgado» e «produtos financeiros em Nampula». Reutiliza as referências aceites de Mineração/Energia, oportunidades agrícolas publicadas e versões publicadas das instituições. A ligação mineral conserva grupo/local seleccionado; a ligação financeira abre a instituição existente. Presença física e cobertura financeira aparecem separadas. Rascunhos e publicações futuras não são divulgados.
|
||||
|
||||
Limites: localização nestes exemplos é correspondência textual aos dados documentados; não representa geocodificação, elegibilidade ou garantia de oferta/financiamento. Só entram conteúdos publicados das fontes efectivamente disponíveis. Não é uma resposta aberta por IA. Erros 404/503 de fontes são identificados sem ocultar os outros resultados; 403 continua recusado.
|
||||
|
||||
Verificação focada em QA isolado 55441: integração 4 testes/118 asserções; regressão federada 3 aprovados e 1 ignorado por guarda de ambiente; unidade 8 testes/39 asserções; frontend 7 testes. Tipos TypeScript, PHPStan e compilação aprovados. Provas em `outputs/quick-search-20261113/`. Sem migrações, alterações de dados ou permissões. Conferência visual no navegador e instalação desta candidata ainda pendentes. Preservar as entregas e os doze lotes demográficos já aceites.
|
||||
|
||||
## 13/11/2026 — erro 500 corrigido e verificado no PHP web, revisão 4988ca89
|
||||
|
||||
A recusa de acesso anterior estava corrigida, mas a abertura do instalador revelou outra incompatibilidade: o PHP-FPM bloqueia `proc_open`; a criação de `Symfony Process` na pré-visualização provocava 500. Os registos de 13:49:58 e 13:50:10 identificaram esta causa. Conferência de leitura confirmou que não existiam tabelas demográficas nem recibos de importação no destino.
|
||||
|
||||
A revisão `4988ca89dc6dddbde4efdada24546767ffcdd411` permite consumir preparações CLI privadas, vinculadas ao SHA256 do original, ano de referência, versão do preparador, prévia e fluxo NDJSON. Conserva a cópia do original, análise antimalware actual, correspondência territorial, confirmação com MFA, gravação por blocos, verificação de contagens e histórico. O CLI existente ganhou a emissão do recibo; não recalcula fórmulas nem altera estatísticas. Sem preparação válida e sem suporte a processos, a interface informa o impedimento, em vez de provocar 500. Não foi alterada a configuração de segurança do PHP.
|
||||
|
||||
Doze originais foram preparados fora do servidor web e conferidos: 920456 observações esperadas, ainda privadas e não importadas. Passaram dois testes/20 asserções com `proc_open` desactivado, 14 testes/52 asserções dos consumidores, oito testes do preparador e análise PHP. Delta e reversão foram conferidos; pacote `outputs/entrega-demografia-cli-20261113.zip`, SHA256 `4b3be263f34d6b9675b77f1ad25534f25da927d4046f57798644dce9fde24244`, preservando os pacotes anteriores.
|
||||
|
||||
**Instalado e verificado:** revisão confirmada por HTTPS às 14:06:11 Africa/Johannesburg. A verificação privada pelo socket PHP-FPM existente confirmou às 14:05:27: SAPI `fpm-fcgi`, processos continuam bloqueados, preparações disponíveis, antimalware disponível e hashes de código/configuração correctos. Não criou actor/sessão, endpoint HTTP público, permissões, migrações ou importações. Provas `outputs/demography-20261113/homologacao/cli-installation-verified.json` e `fpm-runtime-verified.json`; prova anterior conservada antes da renovação.
|
||||
|
||||
**Pendente:** o proprietário abrir `/management/demography/install` e confirmar os lotes na sua sessão com MFA recente; depois conferir 12 lotes/920456 observações na homologação. A verificação final ainda encontrou esquema ausente e zero recibos autenticados, pelo que não se declara esta incorporação concluída. A conferência visual na sessão do proprietário mantém-se distinta da verificação técnica. Novos exemplares num PHP web sem processos requerem a preparação CLI correspondente, com o mesmo recibo e controlos, antes da confirmação no editor.
|
||||
|
||||
## 13/11/2026 — recusa de acesso demográfico corrigida em df543a44
|
||||
|
||||
A conta tinha o estatuto de superutilizador designado, email verificado e MFA configurado, mas não passava no gate legado `manage-portal`. Os registos confirmaram autenticação concluída seguida de403 em `/management/demography/install` às13:42:56(Africa/Johannesburg). A rota antiga aplicava o filtro de catálogo antes da autorização própria do instalador. A correcção `df543a4414d1641422a45262837435429ddae9d6` remove apenas esse filtro redundante das rotas demográficas e reconhece os superutilizadores existentes no importador; mantêm-se autenticação, email verificado, precedência das restrições do Auditor, autorização por acção e MFA de sessão para escrita. Não foram atribuídos papéis nem alteradas contas/permissões.
|
||||
|
||||
Revisão confirmada porHTTPS no servidor às13:48:56. Três testes focados/17asserções aprovados;pipeline Git concluída. Conferência de leitura confirmou ambos os titulares designados autorizados, destino correcto e hashes actuais do código/configuração. A prova anterior de instalação foi conservada e a prova actual renovada para esta revisão, evitando um bloqueio de botão por código desactualizado. Recibo `outputs/demography-20261113/homologacao/access-correction-verified.json`.
|
||||
|
||||
**Estado:** correcção instalada; resta verificar a abertura na sessão real do proprietário e executar as confirmações autenticadas dos lotes. O esquema demográfico remoto ainda não estava instalado nesta verificação; não se declaram os12lotes/920456observações disponibilizados na homologação. A operação local continua preservada. Não repetir preparação, atribuir permissões ou reinstalar os recortes anteriores.
|
||||
|
||||
## 13/11/2026 — revisão b20068d0 instalada em teste-investidor; dados por confirmação autenticada
|
||||
|
||||
Instalação Git concluída às **13:34:06 Africa/Johannesburg (11:34:06 UTC)** em `https://teste-investidor.tempo.co.mz`, revisão `b20068d04bc70e8fa94b90692e07afc60b406910`. `/build/revision.json`, `/localizacoes/demografia` e `/api/v1/investment/demography` responderam HTTP200, com TLS verificado. O código e a configuração estão disponíveis; **isto não equivale a ter os 12 lotes importados neste destino**.
|
||||
|
||||
Backup/restauro conferiu 190 tabelas e 369 ficheiros. Comparação posterior confirmou as onze tabelas de negócio protegidas sem alterações, incluindo instituições, versões e interesses, dossiers, oportunidades e projectos. Conferência territorial: 168 correspondências existentes, 15 acréscimos expressamente autorizados, nenhuma correspondência por resolver; 12 originais privados por SHA256, total esperado 920456 observações. Apenas três parâmetros próprios de demografia diferem da configuração anterior: activação, pasta privada de originais e interpretador Python. Nenhuma permissão, conta ou segredo foi substituído.
|
||||
|
||||
O instalador conserva MFA/autorização e confirmações por coorte. Falta o proprietário executar em `/management/demography/install`: «Instalar e disponibilizar» (três exemplares), regressar ao mesmo endereço para «Disponibilizar restantes províncias» (oito) e, finalmente, «Disponibilizar Zambézia». Conferir depois recibos autenticados, 12 lotes/920456 observações, consulta por localização e preservação dos dados. Não repetir etapas concluídas nem substituir o cadastro ou a base remota pela base local.
|
||||
|
||||
Recibo `outputs/demography-20261113/homologacao/installation-verified.json`; pacote imutável `outputs/entrega-demografia-homologacao-20261113.zip`, SHA256 `fa6ce1fc141cfec90d149c00946cea17330c09fd6bc5d8bbb1cb2abfa97f9520`, criado antes da instalação. Delta e reversão conferidos em índice temporário; índice original preservado. A conferência visual administrativa permanece separada. As menções históricas abaixo a instalação remota pendente estão substituídas por este recibo; a incorporação remota dos dados continua por confirmar.
|
||||
|
||||
## 13/11/2026 — Zambézia instalada; doze lotes demográficos verificados
|
||||
|
||||
A operação autenticada daZambézia terminou às **11:33:38Africa/Johannesburg (09:33:38UTC)**. Verificação posterior exclusivamente de leitura confirmou `Zambezia.xlsx`,SHA256 `8d502e25e1e1fec0cc381ba0aa47b35cfa1eea586de53cb69ffa201d3b5ffeb7`,lote `9c8f1c48-a29d-4ca7-9ae5-23bd8ca2d05b`,estado `approved` e126684observações de2017–2050. Recibo autenticado confirmado;nenhuma repetição da importação pelo agente.
|
||||
|
||||
**Disponível no portal operacional local `investemoz:5432`:12lotes aprovados,total920456observações.** Todos os ficheiros provinciais fornecidos foram incorporados,além do exemplar nacional. A consulta provincial daZambézia devolve dados e os cinco distritos autorizados(Dérre,Luabo,Mocubela,Molumbo,Mulevala) estão consultáveis. Onze lotes anteriores preservados por contagens/SHA de metadados,observações e eventos,assim como as oito tabelas de negócio protegidas. Não há pendência de importação desta província.
|
||||
|
||||
Provas `outputs/demography-20261113/zambezia/installation-status.json`,`verification.json` e `outputs/demography-20261113/operational-status.json`. As advertências/unidades ausentes dos exemplares anteriores continuam preservadas;nenhuma correcção de estatísticas,recálculo de fórmulas ou preenchimento de lacunas. O novo original não apresentou advertências detectadas. Permanecem separados a conferência visual administrativa,indicadores sem valores no acervo e a instalação em ambientes diferentes deste portal local. Não se declara o portal inteiro concluído.
|
||||
|
||||
Este registo substitui as pendências históricas de ficheiro em falta ou operação autenticada daZambézia descritas abaixo,sem apagar o histórico.
|
||||
|
||||
## 13/11/2026 — oito províncias concluídas; Zambézia fornecida e preparada separadamente
|
||||
|
||||
A extensão anterior foi executada comMFA às11:18:05Africa/Johannesburg (09:18:05UTC) e verificada em leitura:11lotes aprovados/793772observações,recibo autenticado único,oito séries provinciais2017–2050 disponíveis,oito distritos novos consultáveis e preservação integral das oito tabelas de negócio e dos três lotes originais(importações/observações/eventos). Não foi repetida a importação. Recibo `outputs/demography-20261113/remaining-provinces/installation-status.json`;essa extensão deixa de ser pendência.
|
||||
|
||||
O proprietário forneceu depois `Zambezia.xlsx`,SHA256 `8d502e25e1e1fec0cc381ba0aa47b35cfa1eea586de53cb69ffa201d3b5ffeb7`:126684observações de2017–2050,sem advertências detectadas. Autorizou expressamente Dérre,Luabo,Mocubela,Molumbo,Mulevala;referências sem códigos oficiais ou geometrias inferidos. Restantes correspondências únicas no cadastro existente,sem nova fusão ou renomeação.
|
||||
|
||||
Coorte separada `zambezia` no mesmo instalador:uma entrada,sem reimportar os onze lotes ou invalidar a recuperação dos recibos das coortes anteriores. O estado protegido abrange agora as793772observações anteriores,metadados e eventos,conferidos em páginas500. O backup/restauro mantém comparação exacta dos bytes com cursores de250linhas e ordenaçãoC,sem materializar tabelas inteiras emPHP. Novo backup/restauro299tabelas/1268ficheiros. Dois testes focados/32asserções com limite256MiB confirmaram acréscimo126684,total920456/12lotes,repetição sem duplicação,preservação dos onze lotes,MFA e os cinco distritos consultáveis;tipos,análisePHP e build aprovados. Provas anteriores de importação e integridade NDJSON reutilizadas,não reexecutadas globalmente.
|
||||
|
||||
**Estado:** código/interface e readiness disponibilizados. Falta a operação autenticada do proprietário no botão **Disponibilizar Zambézia**,em `/management/demography/install`,e conferir o recibo. Os onze lotes anteriores permanecem disponíveis. A indicação histórica de ficheiro daZambézia em falta está ultrapassada pela recepção deste original;não confundir preparação com importação concluída. Recibos `outputs/demography-20261113/zambezia/verification.json`, `release-readiness.json` e posterior `installation-status.json`. Conferência visual administrativa e ressalvas das séries anteriores permanecem separadas.
|
||||
|
||||
## 13/11/2026 — restantes províncias preparadas; correcção de memória verificada
|
||||
|
||||
Pedido expresso de instalar os oito ficheiros disponíveis:Cabo Delgado92808,Gaza82618,Maputo Província49504,Maputo Cidade44064,Nampula131400,Niassa93632,Sofala77108,Tete67932. Acréscimo previsto639066observações,total793772com os três lotes iniciais. Zambézia não tem ficheiro provincial no acervo fornecido;os dados nacionais2017 não são declarados cobertura anual dessa província. O proprietário autorizou explicitamente Chongoene/Limpopo/Mapai(Gaza),Larde/Liupo(Nampula),Chimbonila(Niassa),Doa/Marara(Tete),sem códigos oficiais ou geometria inferidos. Confirmou que os rótulos Nampula/Lichinga/Xai-Xai se ligam às cidades,preservando Rapale/Chimbonila/Limpopo separados. Correspondências históricas são apresentadas antes da confirmação autenticada;cadastro existente não é renomeado ou fundido.
|
||||
|
||||
Leitor adaptado aos títulos “Cidade da”/“Distrito Municipal”,conservando cabeçalhos e valores originais. Células com fórmulas usam somente a cache numérica do original,com advertência e fórmula conservada;nenhuma fórmula é executada/recalculada e cache ausente continua bloqueante. Valores em falta e divergências não são substituídos. Três lotes aprovados permanecem intactos e protegidos pela extensão,que não reexecuta a migração nem cria permissões.
|
||||
|
||||
A tentativa operacional às11:07foi revertida por esgotar256MiB na conferência de preservação. Corrigidas leitura/hash em páginas500 e importação porNDJSON vinculado à prévia porSHA256,com confirmação transaccional de contagens e compatibilidade com préviasJSON antigas. Relatórios completos permanecem guardados;consulta pública carrega contagens de advertências uma vez por lote. A interface passa a distinguir resposta sem reciboJSON e orienta conferência antes de repetir.
|
||||
|
||||
**Verificação:** oito testes do leitor;seis testes de instalação/50asserções incluindo639066novas observações,11lotes/793772total,preservação e replay com o mesmo limite256MiB do servidor;12testes de integração/42asserções,incluindo adulteração e contagemNDJSON;tipos,análisePHP focada,lint e build aprovados. Novo backup/restauro299tabelas/1157ficheiros. Código/interface e readiness actualizados;nenhum dado adicional aplicado pelo agente. Resta a operação autenticada no botão **Disponibilizar restantes províncias** em `/management/demography/install` e a conferência do recibo. Os três lotes originais continuam disponíveis. Provas `outputs/demography-20261113/remaining-provinces/verification.json`,`release-readiness.json` e`installation-status.json`.
|
||||
|
||||
## 13/11/2026 — instalação demográfica concluída e verificada no portal operacional local
|
||||
|
||||
A operação autenticada foi concluída em **13/11/2026 às10:39:19 Africa/Johannesburg (08:39:19UTC)** no destino confirmado `investemoz:5432`. Verificação posterior exclusivamente de leitura confirmou os três identificadores apresentados pelo operador,estado `approved`,hashes exactos dos originais e **154706observações**:Manica71604,Inhambane82620,nacional482. Recibo autenticado único,sem repetição da instalação/importação. A prova anterior desactualizada após a correcção do interpretador foi reconciliada com a versão actual;cinco testes focados das guardas/12asserções passaram emQA,sem alterar MFA ou dispensar conferências.
|
||||
|
||||
**Utilizável:** `https://portal-investidor.test/localizacoes/demografia`. GONDOLA eGURO,sectorIndústria,2017–2050 devolveram estado disponível,uma série e1836valores por distrito;Macate eVanduzi constam dos territórios consultáveis. As oito tabelas protegidas constantes do recibo mantêm contagens eSHA idênticos:projectos,dossiers/oportunidades,necessidades de competências,clusters,preparação e simulações. As seis advertências deManica,24valores ausentes e sete cabeçalhos sem unidade continuam preservados;nenhuma correcção estatística presumida.
|
||||
|
||||
**Estado actual:** instalação/importação e conferência técnica deste recorte concluídas. Restam conferência visual administrativa e ressalvas estatísticas já identificadas;outras províncias/indicadores e instalação noutros ambientes não estão concluídos por esta operação. A API sem selecção territorial devolve indisponível por ausência de contexto;a consulta comGONDOLA/GURO foi confirmada disponível. Não confundir esse estado inicial com falha da instalação.
|
||||
|
||||
Recibos `outputs/demography-20261113/installation-verified.json` e `operational-status.json`;este registo substitui as pendências históricas de execução abaixo,sem apagar as provas anteriores.
|
||||
|
||||
## 13/11/2026 — homologação demográfica e instalação operacional preparadas
|
||||
|
||||
Proprietário confirmou `investemoz:5432` no portal operacional local, incluindo três ficheiros e Macate/Vanduzi. Backup/restauro conferidos: 296 tabelas/872 ficheiros; cinco testes de instalação na cópia restaurada (21 asserções) e 11 regressões de integração (36 asserções) aprovados. Palavra-passe, TOTP e prévia administrativa QA passaram após corrigir apenas o formato do envelope da conta sintética. Controlos e credenciais operacionais preservados.
|
||||
|
||||
Frontend/instalador publicados, `.env` intacto. **Dados activos ainda não instalados**: abrir `https://portal-investidor.test/management/demography/install`, autenticar-se como gestor de instalação habitual com MFA de sessão, conferir destino/ficheiros/advertências e executar **Instalar e disponibilizar**. É o controlo autenticado existente, não uma nova autorização organizacional. A ferramenta de navegador está indisponível; não foi contornada a autenticação. Clientes CLI apresentaram impedimentos na conferência TLS da cadeia local, sem alterações de certificados ou redução da validação.
|
||||
|
||||
A acção instala apenas a migração demográfica, acrescenta quando ausentes os dois distritos autorizados e importa/aprova os três exemplares exactos com histórico, hashes, scans e contagens homologadas. Confere preservação de dossiers, simulações, instituições financeiras, oportunidades, competências e projectos/clusters. Repetição conserva contagens. Após executar: verificar três lotes/154 706 observações e comparação territorial no portal; manter as seis advertências de Manica/2031 e as unidades/edições ausentes identificadas.
|
||||
|
||||
Recibos `outputs/demography-20261113/release-readiness.json`, `installation-tests.log`, `qa-http-homologation.json`, `operational-status.json`. Relatório e reversão na adenda de `docs/investmoz/v2/demografia-ine-homologacao-2026-11-13.md`. Não declarar disponibilização dos dados concluída antes de existir o recibo autenticado.
|
||||
|
||||
## 13/11/2026 — demografia INE em desenvolvimento/QA
|
||||
|
||||
Entrega implementada na base nova `investmoz_demography_test:55441`, sem migração, importação, permissões ou publicação no activo. Inventário consultado: cadastro/caminhos territoriais, mapa, comparação, simulador, percurso e fontes SWOT existentes; provas e aceitações anteriores conservadas. O delta acrescenta consulta demográfica aos consumidores existentes, sem substituir cálculos, contexto, projectos ou fontes. Não foi feita uma nova aceitação global do portal nem declarada reposição de funcionalidade desaparecida.
|
||||
|
||||
**Utilização:** em `http://127.0.0.1:18813/localizacoes/demografia`, escolher até quatro províncias/distritos, sector e anos. GONDOLA/GURO permitem comparar a evolução 2017–2050, consultar originais por folha/célula e distinguir edições. Na oportunidade, comparação, simulador e localização documentada de projecto/cluster, abrir “Demografia na análise de viabilidade”; o acesso leva também à selecção temporal. Na preparação/SWOT do dossier, a fonte “Contexto demográfico INE” conserva a revisão e as conclusões manuais existentes. Não equiparar população a procura ou mão-de-obra efectiva.
|
||||
|
||||
**Administração QA:** `/management/demography`, usando a permissão de gestão e MFA existentes. Preparar → conferir correspondências/advertências → confirmar → aprovar utilização em QA. Desactivar retira a série das análises e conserva observações/eventos. Edições e hashes coexistem. Manica: 71 604 observações; Inhambane: 82 620; nacional: 482; total 154 706. Macate/Vanduzi existem apenas no cadastro QA por resposta expressa do proprietário. Seis advertências de Manica/2031, 24 valores urbanos/rurais ausentes e sete cabeçalhos vitais sem unidade permanecem visíveis; não foram preenchidos ou corrigidos por inferência.
|
||||
|
||||
**Verificação e saldo:** leitor (6 testes), integração (11 testes), regressão frontend de mapa/preparação/simulador (38 testes), TypeScript, análise PHP focada e build QA aprovados. Consulta pública conferida em Chromium a 1440 e 390 px, com dois distritos, filtros conservados e sem overflow da página. Conferência visual administrativa pendente: duas tentativas de navegação após desafio TOTP da conta sintética não avançaram; paragem dessa frente, sem contornar MFA. Permissões/MFA/importação continuam cobertas pelos testes HTTP. PHPStan global tem 19 erros em três ficheiros de pesquisa intactos e a formatação global tem falhas preexistentes; não declarar CI integral aprovado.
|
||||
|
||||
Relatório e procedimento de homologação: `docs/investmoz/v2/demografia-ine-homologacao-2026-11-13.md`. Recibos, hashes, reconciliação de 72 dimensões entre exemplares, screenshots e diagnóstico de navegação em `outputs/demography-20261113/`. Implementação QA disponível; homologação com ressalvas estatísticas e conferência visual administrativa pendentes. Incorporar outras províncias ou instalar no activo continua fora desta execução.
|
||||
|
||||
## 11/11/2026 — Mineração e Energia instaladas em f2767818
|
||||
|
||||
Entrega autorizada de542ac2ff instalada na revisão `f27678187669d18ec063a01473dc8788c713448d`. A revisão inclui a correcção técnica dos hashes e dos geradores para usar os mesmos bytesJSON emWindows eGit/Linux,detectada antes de alterar a instalação;conteúdo,interface e âmbito preservados. Os sete casos nativos/166asserções voltaram a passar sobre os bytes canónicos. Pacote original preservado;pacote canónico com aplicação/reversão exactas. Recibo `outputs/sector-resource-20261111/installation.json`,conferido em2026-11-11T12:19:59.901666+00:00.
|
||||
|
||||
**Disponível:** `/sectores/mineracao` —11grupos/10áreas de cadeia de valor/6projectos de referência; `/sectores/energia-especifica` —7segmentos/11áreas/10projectos/24fontes ligadas. Localização e grupo/segmento → área → dossier novo ou existente → gravação/recuperação → evidência paraSWOT. As duas referências coexistem no mesmo dossier sem substituir escolhas. Estados,períodos,divergências e locais por definir preservados;sem criar direitos,coordenadas,ofertas ou projectos reais.
|
||||
|
||||
**Instalação conferida:** backup consistente e restauro isolado190tabelas;369ficheiros restaurados e conferidos porhash;22ficheiros da entrega idênticos aoGit;revisão e nove entradasHTTP200,incluindo as duas páginas sectoriais. Configuração intacta,zero migrações/importações. Nove tabelas protegidas com totais/checksums idênticos ao backup,incluindo instituições/versões/interesses,dossiers,simulações,educação,oportunidades e sectores;270instituições publicadas preservadas.
|
||||
|
||||
**Saldo:** implementação e instalação deste recorte encerradas;conferência visual permanece pendente. Ofertas concretas,implantação mais precisa e dados adicionais dependem do respectivo investimento,não se presumem das referências. Restantes módulos e resíduos fiscaisL1–L7,L8,L9–L16 mantêm o saldo anterior;portal integralmente concluído não declarado.
|
||||
|
||||
## Energia — consulta e preparação no mesmo dossier (QA,11/11/2026)
|
||||
|
||||
1. Abra **Sectores de investimento → Energia** (`/sectores/energia-especifica`). Seleccione localização e segmento energético,ou pesquise uma actividade.
|
||||
@@ -9646,3 +9969,354 @@ S08 permanece por concluir, separada da revis?o visual; a especifica??o da janel
|
||||
### 10/11/2026 ? S08: melhoria do percurso existente de licenciamento pr?vio
|
||||
|
||||
?mbito esclarecido pela Tempo; substitui o anterior saldo ?por identificar?. Implementa??o e sete provas frontend dirigidas em `67344418`: estado sem repeti??o, registo/ac??o principal vis?veis, redu??o dos blocos expans?veis e abertura/foco da etapa por `#S08`, preservando campos/contexto/vers?o/grava??o e guardas existentes. TypeScript, lint dirigido e build QA aprovados. Sem altera??o de backend/hist?rico/dados ou repeti??o das provas aceites n?o afectadas. Detalhes e limites em `docs/investmoz/v2/auditoria-portal/ajustes-por-ambito-2026-11-10.md`. Revis?o visual e instala??o mant?m-se pendentes e separadas. Pacote contador/aliases preservado; sem push e cluster 55441 mantido ligado.
|
||||
|
||||
|
||||
## 13/11/2026 — relatórios agrupados no dossier: implementação em QA
|
||||
|
||||
Pedido do proprietário: verificar e resolver a dispersão das saídas produzidas pelas etapas do investimento. No percurso existente `/investimentos/{id}#relatorios`, o índice reúne resultados financeiros, versões fiscais preservadas, comparação/preparação da empresa, guias guardados, análise SWOT, exportações APIEX, preparação de acesso à terra e documentos das etapas. Cada referência conserva dossier, oportunidade ou contexto comum/por confirmar, revisão, data quando registada e estado; etapas sem resultado associado são explicitadas. A mesma versão documental ligada a mais de um pedido aparece uma vez, sem fundir originais diferentes.
|
||||
|
||||
Exportação consolidada Word e HTML para impressão/PDF reutiliza os geradores existentes e os cálculos de viabilidade já aceites. Inclui contexto do investimento, etapas e pendências, financiamento/orçamento/empréstimo/ponto de equilíbrio recuperados das entradas guardadas, conclusões SWOT com fonte/data/classificação, preparação APIEX e referências aos documentos. Exportações APIEX históricas mantêm o original, sem acrescentar SWOT privada ao pacote destinado à entidade externa. O índice dá acesso aos originais pelas autorizações existentes; o relatório não envia mensagens, submete processos, concede crédito, executa pagamentos ou publica conteúdo.
|
||||
|
||||
A cópia fiscal preservada no rascunho é recuperável pelo titular em `/investimentos/{id}/relatorios/fiscais/{reportId}`, incluindo quando a simulação original era anónima ou deixou de existir. A posse de acesso administrativo ao dossier não concede acesso financeiro. Fontes fiscais novas conservam a oportunidade/revisão no momento da associação; versões antigas sem essa identificação permanecem disponíveis como âmbito por confirmar, sem serem atribuídas silenciosamente à oportunidade actual. Preparação de terra não é apresentada como título DUAT. Seleccionar oportunidade é necessário antes de consolidar um dossier com várias escolhas.
|
||||
|
||||
Provas: `outputs/dossier-reports-20261113/`. Vinte e um testes frontend aprovados; prova final do servidor com 44 asserções, em dados sintéticos e transacção revertida, além da regressão focada anterior de quatro testes/151 asserções. Sem migrações ou novas permissões. Estado: implementado em QA; instalação desta alteração e conferência visual no uso normal ainda pendentes. O saldo dos restantes módulos e resíduos fiscais permanece inalterado.
|
||||
|
||||
|
||||
Relatórios do dossier — conferência final de 13/11/2026: regressão focada do servidor 4 testes/168 asserções; caso final de recuperação, descargas privadas, âmbito, repetição e bloqueio com módulo desactivado 45 asserções. Os 21 testes frontend passaram; tipos, análise PHP, lint e compilação QA aprovados. Delta próprio de relatórios preparado, sem instalação remota e sem interferir na incorporação demográfica em curso.
|
||||
|
||||
|
||||
## 13/11/2026 — relatórios do dossier instalados na homologação em 07182c7c
|
||||
|
||||
Entrega autorizada pelo proprietário e instalada pelo executor Git em `https://teste-investidor.tempo.co.mz`. A revisão servida é `07182c7c735efa88d850551da71b671c3dadfa9d`. Entrada: `/investimentos`, abrir o dossier autorizado e a secção `#relatorios`. Índice por etapa e exportação consolidada Word/HTML disponíveis; cópias fiscais preservadas são recuperadas pelo titular a partir do próprio dossier. Continua sem envio ou publicação automática.
|
||||
|
||||
Backup/restauro fresco:193 tabelas e381ficheiros. Conferência pós-entrega:12ficheiros de fonte por SHA256,HTTPS e controlos de entrada privada,12tabelas de negócio/geometria sem alteração,mais os três lotes demográficos presentes no backup conservados por contagens/checksum de metadados,observações e eventos. Durante a entrega foram concluídas,por operações autenticadas independentes,as restantes incorporações demográficas:a verificação final encontrou12lotes aprovados/920456observações. Esta entrega de relatórios não fez importações ou migrações;actualizou o vínculo da readiness à nova revisão,preservando as preparações CLI aceites.
|
||||
|
||||
Prova final `outputs/dossier-reports-20261113/homologation-installed.json`;estado agregado `verification.json`. QA funcional,privacidade,recuperação,exportações,tipos,lint,análise PHP e compilação aprovados. A conferência visual no uso normal permanece pendente,sem reabrir a instalação nem as provas aceites. Este estado substitui a indicação histórica de QA sem instalação acima e não declara concluídos outros módulos ou relatórios ainda por implementar.
|
||||
|
||||
|
||||
## 13/11/2026 — consulta e descarga de resumos das 19 etapas, correcção em QA
|
||||
|
||||
Conferência com conta sintética e MFA normal em `http://127.0.0.1:18814/investimentos/5245f06c-bdbd-4caf-bc37-900f10bf582c`, base isolada `investmoz_demography_test:55441`. Novo dossier, versão 21: os serviços existentes guardaram fundamentos sintéticos em S01–S19. Não foram alterados dossiers anteriores nem simuladas decisões/licenças externas. Na homologação foi criado apenas o dossier separado de ensaio `db85f087-0737-4164-892a-4fa4fe1313df`, com fundamento sintético S01; os três dossiers anteriores foram preservados.
|
||||
|
||||
Lacuna corrigida: o componente existente passa a permitir seleccionar a etapa, consultar o resumo dos registos recuperados e preparar Word ou HTML. A ligação de descarga permanece visível com indicação de ficheiro pronto; o conteúdo e as pendências não são confundidos com documentos oficiais em falta. As limitações do modelo passam a integrar ambos os formatos. Mudar de dossier, versão ou oportunidade reinicializa a selecção/ligação local para não reutilizar uma exportação de outro contexto.
|
||||
|
||||
Prova integrada: consulta das 19 etapas e 38 descargas reais pelo Edge (19 Word/19 HTML), conferidas em disco por identidade, etapa, versão, fundamento, limitações e ausência de registos de outra etapa. Actualizar a página recuperou os 19 registos e a versão 21. Evidência em `outputs/dossier-reports-20261113/stage-authenticated-browser-checks.json`, `stage-authenticated-download-verification.json`, `stage-recovery.json` e `visual/04-dossier-qa-S19-descarga.jpg`. Os ensaios isolados do componente estão identificados separadamente, sem os apresentar como prova de persistência.
|
||||
|
||||
Validação nova, limitada ao delta: dois testes frontend (incluem exportação das 19 etapas e escape das limitações), tipos, lint dos três ficheiros de produto afectados e compilação QA. Não foram repetidas as provas aceites de APIEX/SWOT, cálculo fiscal, permissões ou instalação. O perfil antigo de QA referia contas que já não existem no cluster actualmente ligado; foi localizado e usado o perfil documentado da demografia, sem criar permissões ou reiniciar o cluster. A serialização da chave MFA da conta recém-criada foi corrigida apenas nessa conta sintética.
|
||||
|
||||
Estado: correcção implementada e conferida em QA, ainda sem instalação. A homologação mantém `07182c7c` para o recorte de relatórios anteriormente instalado. A prova demonstra resumos de preparação por etapa; não declara produzidos estudos financeiros, licenças, decisões, pacotes APIEX ou documentos que não existam nos respectivos percursos. A instalação deste novo delta é a pendência de entrega; os saldos próprios dos outros módulos mantêm-se.
|
||||
|
||||
|
||||
## 13/11/2026 — resumos por etapa instalados na homologação em 8854b292
|
||||
|
||||
Autorização expressa do proprietário recebida e executada. Revisão servida `8854b2928c6907b6742a1eb622ae70e6b6a9e998`, construída em 2026-11-13T13:16:06Z; troca concluída em 13:16:09Z. Entrada habitual: `https://teste-investidor.tempo.co.mz/investimentos`, abrir o dossier e a secção de relatórios, seleccionar a etapa, consultar o resumo, preparar Word ou HTML e descarregar o ficheiro pronto. O relatório consolidado permanece disponível.
|
||||
|
||||
Backup/restauro fresco: 193 tabelas/409 ficheiros, conferidos por contagens e hashes. Verificação pós-entrega: quatro ficheiros por SHA256; 18 tabelas protegidas inalteradas, incluindo instituições, dossiers, rascunhos, documentos, jornadas, etapas e as três tabelas demográficas. Mantidos 12 lotes aprovados/920456 observações. Sem migrações, importações, publicação ou alterações de permissões. Preparação demográfica e os controlos autenticados foram preservados e a readiness foi vinculada à revisão instalada, mantendo o exemplar anterior arquivado.
|
||||
|
||||
O executor Git existente e os seus controlos obrigatórios de CI foram reutilizados sem alteração de fonte ou da configuração partilhada. A entrega ficou fixada na branch aprovada `entrega/relatorios-etapas-20261113`, pois a main já continha alterações alheias de pesquisa/suporte com integração falhada. Essas alterações e a main não foram substituídas nem instaladas por esta autorização.
|
||||
|
||||
Prova pós-instalação no Edge, na sessão autorizada já existente: dossier sintético `db85f087-0737-4164-892a-4fa4fe1313df`, resumo S01 e fundamento guardado recuperados; Word e HTML efectivamente descarregados e conferidos. Nenhum dossier foi alterado nesta conferência. Não se repetiram as 19 consultas/38 descargas aceites em QA; o CI obrigatório do executor correu normalmente. Recibo: `outputs/dossier-reports-20261113/stage-homologation-installed.json`; captura `visual/06-homologacao-S01-descarga.jpg` no mesmo directório.
|
||||
|
||||
Estado deste delta: instalado e conferido. Substitui a pendência de instalação do registo anterior, preservando os seus limites: são resumos de preparação dos registos disponíveis; não se declaram produzidas licenças, decisões, estudos ou outros originais ainda em falta nos respectivos percursos. O pacote QA selado `outputs/entrega-relatorios-etapas-20261113.zip` permanece inalterado; o recibo posterior comprova a instalação.
|
||||
|
||||
|
||||
## 13/11/2026 — ACT-02: confronto de observações quantitativas, QA
|
||||
|
||||
Primeiro recorte executável da continuidade documentada de ACT-20261029-02: a comparação das observações públicas já recebidas no mapa. Reutiliza `InvestmentMapIndicators` e os filtros existentes; não acrescenta API, cadastro, publicação, fonte externa ou acesso a dados privados. Duas selecções progressivas mostram território, descrição/natureza da grandeza, indicador, valor textual exacto, unidade, período, âmbito, população/base, metodologia, situação, fonte/data e versão.
|
||||
|
||||
A conferência assinala diferenças de território/indicador/unidade/âmbito/base/metodologia, campos em falta (incluindo descrição/natureza), datas inválidas, escolha repetida e informação desconhecida/em divergência. Metadados alinhados não são certificação de comparabilidade. Duração, sobreposição dos períodos e natureza prevista/efectiva exigem leitura da fonte. Não soma, calcula evolução, converte grandezas, cria pontuação ou índice regional. Zero, precisão decimal e fontes originais são preservados.
|
||||
|
||||
Selecções identificadas por território, observação e versão. Fora dos filtros deixam de entrar na comparação; mudar a versão exige nova selecção. Conferência no Edge com três observações inteiramente sintéticas, sem API/escritas na base, exercitando o componente real compilado. Capturas e recibo em `outputs/map-comparison-20261113/`. Três testes novos dirigidos ao delta, tipos, lint e compilação QA aprovados; os testes aceites dos filtros anteriores não foram repetidos.
|
||||
|
||||
Estado: implementado e conferido em QA, sem instalação. V2-07/V2-10 e ACT-02 permanecem parciais: cobertura factual nacional/regional, séries estatisticamente comparáveis, oferta laboral, natureza estruturada das grandezas e metodologia de potencial económico continuam com o seu saldo próprio. Este incremento encerra apenas a ferramenta de confronto das observações recebidas. Não altera dossiers, relatórios de 8854b292, pesquisa ou suporte aceites. A candidata incorpora também o recibo documental de 8854b292, sem repetir a instalação ou as provas dessa entrega.
|
||||
|
||||
|
||||
## 13/11/2026 — ACT-02: comparação de observações instalada em 1263b4f6
|
||||
|
||||
Instalação expressamente autorizada e concluída pelo executor Git existente na main, em `https://teste-investidor.tempo.co.mz`. A revisão servida é `1263b4f6b7609c3d4d293c2b9f8a68abb9d3e3c4`. No mapa das oportunidades, o bloco de indicadores apresenta «Comparar duas observações» quando há pelo menos duas observações públicas nos filtros actuais. A comparação mantém valores, descrições, unidades, períodos, âmbito, base, metodologia, situação, fontes e versões; não infere evolução, conversão, elegibilidade ou potencial regional.
|
||||
|
||||
Backup/restauro fresco de 193 tabelas/410 ficheiros, com contagens e hashes conferidos; verificação pós-entrega de 21 tabelas protegidas sem diferenças, incluindo dados territoriais, instituições, dossiers, jornadas, etapas, documentos, permissões e demografia. Mantidos 12 lotes aprovados/920456 observações. Fontes entregues verificadas por SHA256; configuração/fonte do executor preservadas. Sem migrações, importações, publicação de conteúdo ou novas permissões. A readiness demográfica foi vinculada à revisão, com o exemplar anterior arquivado.
|
||||
|
||||
Reutilizadas as provas aceites: três testes novos e a conferência visual sintética do componente; o CI obrigatório do executor correu normalmente, sem nova ronda manual dos percursos aceites. HTTPS do mapa, instituições, demografia e entrada privada conferido. Os originais e a pesquisa, suporte e relatórios de 8854b292 foram preservados. Não foram criadas observações sintéticas na homologação para fazer aparecer a comparação. Recibo: `outputs/map-comparison-20261113/homologation-installed.json`; pacote QA selado inalterado.
|
||||
|
||||
Estado do incremento: instalado. ACT-02/V2-07/V2-10 permanecem parciais quanto à cobertura factual, séries estatisticamente comparáveis, oferta laboral, natureza estruturada das grandezas e metodologia económica. Esta entrega fecha a ferramenta de confronto das observações recebidas, não esses requisitos amplos.
|
||||
|
||||
|
||||
## 13/11/2026 — ACT-02: natureza estruturada das observações, QA
|
||||
|
||||
Continuidade do confronto instalado em 1263b4f6. O editor existente permite declarar segundo a fonte se o valor é observado/efectivo, planeado/meta, projectado/estimado ou por confirmar. A classificação segue o envelope privado, a recuperação e o fluxo editorial existentes; preparar uma alteração não modifica a versão pública. Omissão por clientes anteriores preserva uma escolha deliberada. Sem indicação anterior, a consulta apresenta por confirmar; não infere natureza pela descrição nem reescreve registos. Fonte, valor textual exacto, zero, identidade, versão, confidencialidade e histórico mantidos. Não há migrações, novas permissões, publicação automática ou importação.
|
||||
|
||||
A consulta e a comparação mostram a natureza separada da situação documental; naturezas diferentes ou desconhecidas exigem conferência. Metadados alinhados não provam comparabilidade estatística. QA: três testes backend/21 asserções, cinco testes frontend afectados, análise PHP, Pint, tipos, lint e compilação aprovados. Edge: componentes reais compilados com dados sintéticos; selector e edição preservados, observado/projectado distintos, legado por confirmar, zero/precisão mantidos. Provas em outputs/observation-nature-20261113/. Reutilizadas as provas aceites dos restantes percursos.
|
||||
|
||||
Estado: implementado em QA, instalação pendente de autorização concreta; homologação mantém 1263b4f6. Encerra a capacidade estruturada de declarar a natureza, não a classificação factual de todo o acervo. ACT-02/V2-07/V2-10 continuam parciais: cobertura factual nacional/regional, séries estatisticamente comparáveis, oferta laboral, conferência documental dos valores antigos e metodologia de potencial económico. Relatórios, pesquisa, suporte e entregas aceites preservados.
|
||||
|
||||
|
||||
## 13/11/2026 — ACT-02: natureza das observações instalada em 42b9324a
|
||||
|
||||
Instalação expressamente autorizada e concluída pelo executor Git existente na main, em `https://teste-investidor.tempo.co.mz`. A revisão servida é `42b9324acbf0a15418424e8a539a0740932b2377`. O editor existente permite declarar observado/efectivo, planeado/meta, projectado/estimado ou por confirmar; a escolha segue a preparação privada e o fluxo editorial existente. Consulta e comparação distinguem natureza e situação documental, sem inferir a classificação dos registos antigos ou reescrever o acervo.
|
||||
|
||||
Backup/restauro fresco de 193 tabelas/411 ficheiros, com contagens e hashes conferidos; verificação pós-entrega de 21 tabelas protegidas sem diferenças, incluindo dados territoriais, instituições, dossiers, jornadas, etapas, documentos, permissões e demografia. Mantidos 12 lotes aprovados/920456 observações. Fontes entregues verificadas por SHA256; configuração/fonte do executor preservadas. Sem migrações, importações, publicação de conteúdo ou novas permissões. A readiness demográfica foi vinculada à revisão, com o exemplar anterior arquivado.
|
||||
|
||||
Reutilizadas as provas aceites: três testes backend/21 asserções, cinco frontend afectados, análise/tipos/lint/build e conferência visual sintética do componente; o CI obrigatório do executor correu normalmente, sem nova ronda manual dos percursos aceites. HTTPS do mapa, instituições, demografia e entrada privada conferido. Os originais e a pesquisa, suporte e relatórios de 8854b292 foram preservados. Não foram criadas observações sintéticas na homologação para fazer aparecer a comparação. Recibo: `outputs/observation-nature-20261113/homologation-installed.json`; pacote QA selado inalterado.
|
||||
|
||||
Estado do incremento: instalado. ACT-02/V2-07/V2-10 permanecem parciais quanto à cobertura factual, séries estatisticamente comparáveis, oferta laboral, classificação factual do legado e metodologia económica. Esta entrega fecha a capacidade de declarar/recuperar/consultar a natureza das observações, não esses requisitos amplos.
|
||||
|
||||
|
||||
## 13/11/2026 — ACT-02: conferência temporal da comparação, QA
|
||||
|
||||
Continuidade após a natureza das observações instalada em 42b9324a. A comparação existente mostra a duração dos períodos de referência em dias de calendário, com ambos os limites incluídos. Durações diferentes exigem conferência; períodos distintos com sobreposição, incluindo um único dia comum, mostram aviso próprio. Datas incompletas, inválidas ou invertidas continuam por confirmar, sem duração inferida da data da fonte. Não anualiza, calcula taxas/evolução, soma observações ou declara comparabilidade estatística. Valores textuais, zeros, fontes, versões, filtros e âmbito territorial preservados.
|
||||
|
||||
QA: dois testes novos de duração/ano bissexto/sobreposição/limites e datas inválidas; sete testes afectados passaram. Tipos, lint e compilação aprovados. Edge com componente real compilado e dados sintéticos: duração inclusiva de 366/365 dias e aviso de sobreposição de um dia conferidos. Sem API, base de dados, migração, importação ou publicação. Provas: outputs/observation-period-20261113/. Provas aceites dos restantes percursos reutilizadas.
|
||||
|
||||
Estado: implementado em QA, sem instalação. ACT-02 permanece parcial: cobertura factual, classificação documental do legado, séries estatisticamente comparáveis, oferta laboral e metodologia económica conservam o saldo próprio. Esta entrega encerra a conferência automática de duração e sobreposição das datas recebidas, não a comparabilidade factual das séries.
|
||||
|
||||
|
||||
## 13/11/2026 — ACT-02: comparação temporal instalada em 2bad72c0
|
||||
|
||||
Instalação autorizada e concluída na homologação https://teste-investidor.tempo.co.mz pelo executor Git existente. Revisão servida `2bad72c042f1a779849bfacc8a73ccd842b27fe7`. A comparação de observações mostra duração em dias com limites incluídos e assinala durações diferentes e sobreposição; não infere taxas, evolução ou comparabilidade estatística.
|
||||
|
||||
Backup/restauro fresco de193tabelas/412ficheiros;15fontes verificadas por hash;21tabelas protegidas sem diferenças. Mantidos12lotes/920456observações demográficas, instituições, dossiers, relatórios, pesquisa, suporte e permissões. Sem migrações/importações ou publicação de dados. Readiness demográfica vinculada à revisão com original arquivado. Configuração e fonte do executor inalteradas. HTTPS e entrada privada conferidos. CI obrigatório executado normalmente; provas anteriores reutilizadas sem nova ronda manual. Recibo: outputs/observation-period-20261113/homologation-installed.json; pacote QA selado preservado.
|
||||
|
||||
Este delta deixa de ser pendência de instalação; ACT-02 continua parcial quanto à cobertura factual, classificação do legado, oferta laboral, séries estatisticamente comparáveis e metodologia económica. A ferramenta não cria séries factuais por si.
|
||||
|
||||
|
||||
## 13/11/2026 — lote PEC ordinário: último montante e PPC acima da base, QA
|
||||
|
||||
Conforme a directiva de agrupar melhorias relacionadas, este lote reúne dois resíduos do percurso de viabilidade fiscal, sem instalação por cada correcção. Reutiliza a preparação PEC, livro anual, rascunho privado, histórico e relatório do mesmo dossier; não cria um motor ou módulo paralelo. Recorte:2026, residente geral comercial/industrial/agrícola, ano civil, MZN. Homologação mantém2bad72c0.
|
||||
|
||||
1. Sem volume anterior, permite indicar o último montante PEC já determinado com NUIT, exercício, valor, fonte/fundamento e confirmação de que é o último aplicável ao caso. A hipótese documental29(5) conserva esse montante; não o confunde com volume de negócios ou pagamentos somados, não aplica de novo0,5%/limites nem deduz PPC pela segunda vez. Ausência, incompatibilidade, exercício futuro/anterior ao início ou falta de conferência mantêm a estimativa indeterminada. A referência fica conservada quando deixa de ser usada; alterações exigem reconferência. Uma rectificação documental para volume zero usa a mesma referência. Isto implementa a hipótese documentada, não uma inferência automática da qualificação fiscal ou do último montante a partir de dados inexistentes.
|
||||
|
||||
2. No cálculo ordinário29(2), PPC documentados acima da base limitada produzem estimativa PEC zero e diferença documental explícita. Não criam valor negativo, reembolso, crédito, transporte ou dedução anual. Esta regra tem marcador de versão na chave do livro apenas quando afecta o caso; obriga a recalcular resultados antigos dependentes, preservando histórico e casos ordinários anteriores. Fonte reutilizada:BR16/I16-04-2008,p122/PDF24,original SHA256fc373ff5637edf75ec6a9595dec8763a8503d4ee786e3b7d8f1c742eae9d80ee.
|
||||
|
||||
Os campos têm rótulos e controlos separados de largura completa; referências vazias aparecem por confirmar. Consulta do suporte e apresentação dos efeitos são parte do mesmo formulário. Não executa pagamentos ou declarações. Fonte, escolhas, original e histórico conservados no rascunho e no relatório.
|
||||
|
||||
QA:21testes frontend afectados, incluindo seis novos; uma prova nativa/42asserções de POST/PUT/GET em transacção com rollback na base isolada investmoz_demography_test:55441. Quatro cenários:último montante42500,25, fonte ausente, volume positivo com referência conservada e PPC60000/base50000/estimativa0/diferença10000. Recuperação e relatório financeiro do dossier conferidos; saldo anual138MZN e histórico anterior inalterados. Tipos, lint focado, sintaxe PHP, Pint e build QA aprovados. Edge:componentes reais compilados com dados sintéticos, ambos os efeitos, confirmação retirada após edição e apresentação final conferidos; sem API/escrita na base pela prévia. A primeira prévia importava um auxiliar Node com filesystem; foi substituído por JSON sintético gerado, sem alterar o produto para contornar o erro. Provas em outputs/irpc-pec-last-amount-20261113/. Não repetidas as provas aceites dos percursos não afectados.
|
||||
|
||||
Estado:implementado e verificado em QA; pacote agrupado, ainda sem instalação e dependente de autorização concreta. Não encerra L8 nem o portal. Restam períodos/regimes especiais, qualificação documental de casos fora deste recorte e os demais resíduos L1–L7/restanteL8/L9–L16 e módulos. Execução de pagamentos não é requisito do portal. A instalação deverá usar o executor Git, com backup/restauro fresco e reversão de release; preservar snapshots/históricos produzidos após a entrega, sem restaurar uma base antiga sobre edições posteriores.
|
||||
|
||||
|
||||
## 13/11/2026 — lote PEC ordinário instalado em f059c226
|
||||
|
||||
Entrega expressamente autorizada e instalada pelo executor Git existente na main em https://teste-investidor.tempo.co.mz. Revisão servida f059c226d26ce0e9f5fec30ecfed44a65d61d6e3. Inclui referência ao último montante PEC documentado, reconciliação de PPC acima da base e apresentação do formulário/relatório. São hipóteses para viabilidade; não há execução de pagamentos, declarações, reembolso ou dedução criada pelo portal.
|
||||
|
||||
Backup/restauro fresco de193tabelas/413ficheiros e conferência pós-instalação de21tabelas protegidas sem diferenças. Mantidos instituições, dossiers, documentos, simulações, histórico, Educação, mapa, relatórios, pesquisa, suporte, permissões e12lotes/920456observações demográficas.23fontes conferidas por hash; revisão pública e HTTPS verificados. Executor/configuração inalterados, zero migrações/importações; readiness demográfica vinculada à revisão com original arquivado. CI obrigatório executado normalmente; provas anteriores reutilizadas sem nova ronda manual. Recibo: outputs/irpc-pec-last-amount-20261113/homologation-installed.json. Pacote agrupado v2 selado preservado; a versão anterior do ZIP conserva-se como histórico de normalização de finais de linha, sem alteração do produto.
|
||||
|
||||
Este lote deixa de ser pendência de instalação. L8 continua parcial para períodos/regimes especiais e casos fora do recorte; os resíduos L1–L7/restanteL8/L9–L16 e restantes módulos mantêm o saldo próprio. Próximo lote compatível: projecção conjunta PPC/PEC no ecrã e relatório, separada dos comprovativos pagos e do fecho anual.
|
||||
|
||||
|
||||
## 13/11/2026 — lote integrado de projecção mensal PPC/PEC, QA
|
||||
|
||||
Continuidade do saldo de integração e relatórios AUD-SIM-INT02/INT06, após f059c226 instalado. Antes deste delta, as estimativas PPC e a hipótese PEC eram apresentadas separadamente; faltava a vista mensal conjunta. O lote reúne a apresentação no ecrã L8, a mesma projecção no relatório do dossier e a separação entre estimativas e comprovativos documentados como pagos. Reutiliza os calculadores aceites, o livro, o rascunho, a recuperação e os exportadores existentes. Não acrescenta um motor fiscal, formulário de pagamento, API, tabela ou permissão.
|
||||
|
||||
A vista agrega cada componente uma única vez por mês, com fracções exactas. A opção PEC concentrada conserva o mês escolhido; a repartida conserva os três montantes explícitos. Uma componente desconhecida ou uma distribuição por reconciliar produz total por determinar e subtotais conhecidos identificados; não vira zero. Zero documentado é distinguido da falta de dados. São previsões PPC/PEC do recorte ordinário2026, não o saldo a executar ou todos os impostos do negócio. Valores pagos, deduções, saldo anual, fluxo financeiro e métricas do investimento não são acrescidos ou substituídos.
|
||||
|
||||
O relatório usa as opções guardadas na versão calculada, preservando as escolhas posteriores ainda por recalcular. Fontes e explicação aparecem no resumo da projecção; as linhas mensais conservam os montantes sem repetir extensamente as mesmas citações. A identificação de dossier/oportunidade e os exportadores existentes mantêm-se. Legados sem estas preparações não recebem uma projecção presumida.
|
||||
|
||||
QA:42testes frontend afectados, incluindo sete novos de agregação exacta, sobreposição, ausência, distribuição decimal, zero, recuperação, relatório e apresentação. Os sete testes do delta foram reconferidos após o ajuste de apresentação; o ensaio da vista L8 confirma os grupos separados, além da tabela. Prova nativa de POST/PUT/GET/recuperação em quatro cenários com42asserções e rollback na base isolada investmoz_demography_test:55441. Cenários:112000MZN totais com64000emMaio, distribuição por seis meses, PEC por completar sem total presumido, e zero explícito sem saída. Saldo anual sintético138MZN e histórico anterior preservados; relatório financeiro do mesmo dossier conferido. Tipos, lint focado sem reformatação dos ficheiros legados, Pint/sintaxe e build QA aprovados. Edge:componente real compilado e relatório, estados completo/parcial/zero e apresentação final sem explicações repetidas. Prévia sintética sem API/BD; provas aceites dos restantes percursos reutilizadas. Provas:outputs/irpc-cashflow-group-20261113/.
|
||||
|
||||
Estado:implementado e verificado em QA, ainda sem instalação. Homologação mantém f059c226. Pacote único compatível; instalação depende de autorização concreta, com backup/restauro fresco e reversão de release preservando snapshots e edições posteriores. Este lote encerra a integração visual e documental destas previsões mensais; não encerra L8 nem o portal. Períodos/regimes especiais, anualização PPC28(3), outros casos documentais e resíduos L1–L7/restanteL8/L9–L16 e módulos conservam o saldo próprio. Execução de pagamentos não é requisito do portal.
|
||||
|
||||
|
||||
## 13/11/2026 — projecção fiscal agrupada instalada em 95b33275
|
||||
|
||||
Instalação expressamente autorizada, concluída pelo executor Git existente na homologação https://teste-investidor.tempo.co.mz. Revisão servida95b33275aae48a6209c67002788c177b3dd80fcb. Inclui vista mensal conjunta PPC/PEC, distinção completo/parcial/zero, separação de estimativas e comprovativos e o mesmo conteúdo no relatório do dossier, com fontes concentradas no resumo. Sem alteração dos totais do negócio, pagamentos, deduções ou histórico.
|
||||
|
||||
Backup/restauro fresco de193tabelas/414ficheiros,29fontes conferidas por hash e21tabelas protegidas sem diferenças. Mantidos instituições, dossiers, documentos, simulações, Educação, mapa, relatórios, pesquisa, suporte, permissões e12lotes/920456observações demográficas. Zero migrações/importações; executor e configuração intactos. Readiness demográfica vinculada à revisão com original arquivado. HTTPS e revisão pública conferidos; CI obrigatório executado normalmente. Provas aceites reutilizadas sem nova ronda manual de percursos. Recibo:outputs/irpc-cashflow-group-20261113/homologation-installed.json. Pacote agrupado selado inalterado.
|
||||
|
||||
Este lote deixa de ser pendência de instalação. Não encerra o simulador ou o portal: períodos/regimes especiais, anualização28(3), casos documentais e resíduos L1–L7/restanteL8/L9–L16 e módulos mantêm o saldo próprio. Próximo lote compatível: coerência do período L6 nas estimativas, projecção e relatórios, preservando a preparação e o fecho anual independente.
|
||||
|
||||
|
||||
## 14/11/2026 — lote de coerência do período L6 em PPC/PEC, QA
|
||||
|
||||
Continuidade do saldo AUD-SIM-INT02/INT06 após95b33275 instalado. Conferência delimitada do código: PPC/PEC ordinários e a projecção recebiam titular/exercício/tipo, sem confrontar as datas L6 conhecidas. Podiam apresentar meses civis num dossier com período curto ou não civil. O lote liga o contexto já existente aos dois estimadores, à vista mensal e ao relatório da mesma versão, sem duplicar o motor fiscal, criar API, tabela ou permissão.
|
||||
|
||||
As datas preparadas em L6 prevalecem para a conferência da preparação, mesmo quando ainda diferem do último cálculo L6; não são substituídas silenciosamente pelo resultado anterior. O período usado fica conservado no modelo da versão anual calculada. O relatório lê esse exemplar, preservando edições posteriores ainda por recalcular. Uma divergência face ao recorte civil2026 mantém as estimativas dependentes por reconciliar, sem calendário ou total presumidos. As entradas e as hipóteses de caixa ficam guardadas, sem alterar o cálculo anual independente.
|
||||
|
||||
A dispensa PEC do ano de início documentado mantém zero nos períodos válidos contidos em2026, incluindo o período curto de início; datas inválidas, outro exercício ou período não civil fora deste recorte não recebem dispensa presumida. Os avisos identificam só a componente afectada; se PPC e PEC estiverem ambos por reconciliar, o resumo reúne a causa comum. A chave de cálculo recebe um marcador apenas para os casos afectados pela nova conferência, sem invalidar globalmente os livros ordinários aceites. Livros e históricos antigos conservados. A preparação independente antiga, sem metadados L6 disponíveis, mantém o seu âmbito documental explícito.
|
||||
|
||||
QA iniciada em13/11 e fechada em14/11:61testes frontend afectados, incluindo oito novos de período/edição/recuperação/consumidores. Prova nativa POST/PUT/GET com42asserções, quatro cenários e rollback na base isolada investmoz_demography_test:55441. Civil completo mantém112000MZN de projecção; não civil e curto ficam por reconciliar; início preserva PECzero e PPC separado. Nos quatro cenários, o resultado anual independente coincide com o exemplar anterior sem as preparações e o histórico mantém-se. Originais L6 e datas são produzidos pelo percurso normal existente, sem fabricar um calendário oficial. Relatório financeiro do mesmo dossier conferido. Tipos, lint/formatação focados, Pint/sintaxe PHP e build QA aprovados. Edge:componentes reais compilados, quatro contextos, dispensa e aviso específico PPC, ecrã/relatório concordantes. Prévia sintética sem API ou base de dados. Provas aceites dos percursos não afectados reutilizadas; dependências financeiras e exportadores conferidos idênticos a95b33275. Provas:outputs/irpc-period-consistency-20261113/.
|
||||
|
||||
Estado:implementado e verificado em QA, sem instalação. Homologação mantém95b33275. Lote único para estimadores, projecção, recuperação e relatório. Encerra a lacuna de coerência do período conhecido; não implementa ainda os cálculos/calendários dos períodos ou regimes especiais nem a anualização PPC28(3). L8 e portal permanecem parciais; resíduos L1–L7/restanteL8/L9–L16 e módulos mantidos. Sem pagamentos, novas deduções, migrações, importações ou permissões. Instalação exige autorização concreta e o executor Git existente, com backup/restauro fresco e reversão de release preservando snapshots/edições posteriores.
|
||||
|
||||
|
||||
## 14/11/2026 — coerência dos períodos fiscais instalada em 078f770d
|
||||
|
||||
Instalação expressamente autorizada, concluída pelo executor Git existente na homologação https://teste-investidor.tempo.co.mz. Revisão servida078f770dea3d901624e2d9d8566a2d0f30f5acfe. Inclui coerência entre o período preparado em L6, estimativas PPC/PEC, projecção e relatório; contextos fora do recorte civil ficam por reconciliar, com a dispensa PEC inicial preservada. Sem alteração dos totais do negócio, pagamentos, deduções ou histórico.
|
||||
|
||||
Backup/restauro fresco de193tabelas/415ficheiros,37fontes conferidas por hash e21tabelas protegidas sem diferenças. Mantidos instituições, dossiers, documentos, simulações, Educação, mapa, relatórios, pesquisa, suporte, permissões e12lotes/920456observações demográficas. Zero migrações/importações; executor e configuração intactos. Readiness demográfica vinculada à revisão com original arquivado. HTTPS e revisão pública conferidos; CI obrigatório executado normalmente. Provas aceites reutilizadas sem nova ronda manual de percursos. Recibo:outputs/irpc-period-consistency-20261113/homologation-installed.json. Pacote agrupado selado inalterado.
|
||||
|
||||
Este lote deixa de ser pendência de instalação. Não encerra o simulador ou o portal: períodos/regimes especiais, anualização28(3), casos documentais e resíduos L1–L7/restanteL8/L9–L16 e módulos mantêm o saldo próprio. Próximo lote compatível: períodos anuais completos não civis documentados, preservando a preparação e o cálculo anual independente.
|
||||
|
||||
|
||||
## 14/11/2026 — PPC/PEC em períodos anuais não civis documentados, QA
|
||||
|
||||
Continuidade executável de AUD-SIM-INT02/INT06 após078f770d instalado. Reutiliza L6, os calculadores PPC/PEC, o livro privado, o histórico, a projecção conjunta e os relatórios existentes. Acrescenta uma correspondência documental no mesmo livro anual: titular, exercício, datas e fundamento do período corrente, datas e fonte do período anterior e confirmação explícita dos montantes/fontes. As datas anteriores sugeridas não equivalem a comprovação. Nenhuma autorização fiscal é produzida pelo portal.
|
||||
|
||||
Recorte: residente geral/MZN, actividade comercial/industrial/agrícola, período corrente não civil com doze meses civis completos e termo2026, anterior igualmente completo, contíguo e com termo2025. Fonte aceite CIRPC7(2),Lei34/2007,BR52,original SHA256cdbef875ad7ccc1517b12faf5de0e893a70ed2ed81e33913cd6dc4a674474e6e; meses RIRPC27(1)(a)/29(1),BR16/I16-04-2008,original SHA256fc373ff5637edf75ec6a9595dec8763a8503d4ee786e3b7d8f1c742eae9d80ee. PPC nos5.º/7.º/9.ºmeses; PEC nos6.º/8.º/10.ºmeses. Fórmulas e aritmética racional reutilizadas, sem segundo motor ou novos parâmetros oficiais.
|
||||
|
||||
O PEC exige actividade documentada anterior ao início do período anterior neste recorte. Início não civil, volume anterior zero com histórico29(5), períodos curtos, meses incompletos, outros regimes e anualização PPC28(3) mantêm-se separados e pendentes. A opção de mês único só aceita um mês dentro do período documentado, como hipótese de tesouraria e sem certificar prazo legal.
|
||||
|
||||
Mudanças de datas/fontes não substituem conclusões ou valores. A correspondência financeira tem marcas independentes PPC/PEC: alterar PPC mantém PEC conhecido e vice-versa; o total fica parcial até à reconferência explícita. A distribuição PEC antiga é conservada sem deslocamento automático para meses não civis; exige vinculação expressa às novas datas, preservando montantes, opção e referência. O período usado e a declaração ficam congelados no resultado guardado, sem mudar o cálculo anual independente ou o histórico. Sem alteração global dos livros civis aceites.
|
||||
|
||||
QA:70testes frontend afectados distintos, incluindo nove novos de domínio/UI; sucesso, falta de fonte, divergência de titular/datas, período anterior curto/não contíguo, reconferência independente, preservação da distribuição, mês único e histórico. API nativa POST/PUT/GET:quatro cenários sintéticos,46asserções, rollback em investmoz_demography_test:55441, identidade PDO conferida. Cálculo→gravação→recuperação→relatório financeiro do mesmo dossier demonstrados. Tipos, lint focado, Pint e compilação aprovados. Edge com componentes reais compilados:112000MZN nos meses relativos correctos, concentração emJaneiro2026, total indeterminado sem fonte, PEC preservado quando PPC muda e193000MZN apenas após reconferência. Corrigido aviso contraditório de ano civil no caso documental incompleto; regressão acrescentada. Provas:outputs/irpc-noncivil-20261114/. Provas aceites não afectadas reutilizadas.
|
||||
|
||||
Estado:implementado e verificado em QA, ainda sem instalação. Homologação mantém078f770d. Este lote encerra apenas as estimativas PPC/PEC e a projecção deste recorte anual não civil documentado; não encerra L6/L8, a liquidação final não civil, o simulador ou o portal. Resíduos L1–L7/restanteL8/L9–L16 e outros módulos preservados na matriz. Sem migrações, permissões, rotas, importações, pagamentos, declarações submetidas ou novas deduções. Instalação agrupada depende de autorização concreta, executor Git, backup/restauro fresco e reversão de release preservando edições posteriores.
|
||||
|
||||
## 14/11/2026 — Ofertas, Fase 1: preparação privada em QA
|
||||
|
||||
Autorização condicionada expressa da Tempo nesta sessão: exclusivamente desenvolvimento da Fase 1. Oportunidades é o cadastro principal das novas Ofertas; negócios e restantes percursos mantêm os seus identificadores, contratos e dados. Sem mudanças no menu, esquema mne, dados operacionais ou instalação. As migrações existentes foram usadas apenas para preparar uma base sintética nova, offers_phase1_20261114_test:55441, preservando as outras bases QA.
|
||||
|
||||
Entrada privada em desenvolvimento: /minhas-oportunidades/ofertas. Requer autenticação, email verificado, perfis disponíveis e âmbito de Promotor já atribuído para criar/editar/submeter; não concede papéis. Criar → guardar → recuperar → editar → conferir → submeter em privado. Rascunhos incompletos são recuperáveis. A submissão exige título, descrição, categoria, contacto autorizado e preço MZN/USD ou «A negociar»; não converte moedas nem confunde preço pedido com investimento estimado. Localização usa os identificadores e a hierarquia existentes. Contactos usam o CRM e o seu controlo de MFA, sem novo cadastro ou publicação dos contactos.
|
||||
|
||||
Gravação usa OpportunityManagement, chave de criação, etag, versões, management_draft e auditoria existentes. Campos inesperados são recusados; permissões, representação e contacto são reconferidos no servidor. Conflitos não sobrescrevem a versão guardada. A submissão regista autor, instante UTC e revisão nos metadados privados, sem criar revisão editorial, notificações, aprovação ou publicação da Fase 2. A oferta submetida fica recuperável e sem edição nesta fase. A marca privada bloqueia conversão/publicação pelo modelo, workflow e divulgação existentes; o catálogo público exclui-a mesmo perante um estado incoerente introduzido por outro escritor.
|
||||
|
||||
Verificação: 14 testes novos. Bateria de regressão de Oportunidades/perfis/editorial: 35 testes e 548 asserções aprovados. Passagem final focada, após as últimas alterações, com 16 testes e 172 asserções aprovados; os grupos sobrepõem-se e não devem ser somados. Inclui criação idempotente, recuperação, conflito, contacto de outro titular/eliminado, perda de representação/permissão, preço incompleto/inválido, campos forjados, submissão confirmada, bloqueios de publicação e ausência nas consultas públicas. Duas páginas verificadas por HTML completo com entradas Vite reais. Pint, PHPStan, tipos, lint/formatação focados, build QA e revisão do delta aprovados. Recibo: outputs/offers-private-phase1-20261114/qa-result.json.
|
||||
|
||||
Limitações: conferência visual manual não efectuada. npm run check global acusa formatação preexistente em 61 ficheiros alheios ao delta; esses ficheiros não foram alterados e a falha não foi dispensada. A bateria canónica extensa foi interrompida, não contabilizada como aprovada e substituída pela verificação do cenário afectado. Uma prova antiga de divulgação exige outra base pelo seu próprio controlo de segurança; esse controlo foi preservado, sem tocar nessa base, e a compatibilidade do âmbito nativo foi testada na nova preparação sintética.
|
||||
|
||||
Saldo de RF-MN-003: Fase 1 de Ofertas implementada e verificada tecnicamente em QA, sem instalação. Não encerra o requisito integral nem Procuras. Fase 2 e seguintes permanecem por autorizar; NDA, comprovativos, fotografias, validade, moderação e publicação não são simulados nesta entrega. A autorização anterior de validador jurídico para legislação não é estendida a Ofertas. Instalação em homologação ou produção exige verificação e autorização expressa separada.
|
||||
## 14/11/2026 — Ofertas Fase 2, circuito editorial privado em QA
|
||||
|
||||
Autorização expressa da Tempo, após encerramento técnico da F1 com ressalva visual. Implementação limitada ao plano 6e302db6, mantendo Oportunidades como cadastro principal. Dashboard existente → Ofertas/revisão privada → validador inicia ou coordenação atribui → pede correcção/rejeita com fundamento → promotor corrige/reenvia no mesmo identificador → aprovação interna independente. Preserva versões, rejeições, aprovação histórica e tarefas. Reatribuição guarda quem alterou, anterior e novo responsável, sem conceder papéis.
|
||||
|
||||
Snapshots/hash, revisão e ciclo vinculam cada decisão aos campos e referências conferidos. Mudança no contacto/localização bloqueia decisão ou assinala reconferência; não substitui a conclusão. Primeira revisão explícita de submissão F1 preserva autor/data/revisão e regista a vinculação actual sem inventar fingerprints históricos do CRM. Estados editoriais privados não tornam a oferta pública; status de publicação mantém-se privado, marca/exclusão pública e percursos alternativos bloqueados. Os percursos nativos conservam a versão pública anterior durante alterações pendentes. Desactivar o circuito não permite submeter v2 pelo fallback v1 nem apagar histórico.
|
||||
|
||||
Reutiliza perfis/MFA/independência, workflow, tarefas, auditoria e caixa de notificações. Email pelo transporte existente, depois do commit e com revalidação, activação/lista operacional nativas; em QA apenas memória, sem mensagens reais ou SMS. Configurações de entrega e designações operacionais não são inventadas. Sem migrações/tabelas novas, mudanças em mne, dados operacionais, menu principal ou instalação.
|
||||
|
||||
QA sintética offers_phase1_20261114_test:55441: regressão 35/499, final F2 11/160, complemento de contribuidores 1/14 e HTML final 1/10 aprovados; grupos sobrepostos, não somar. Pint, PHPStan, tipos, lint/formatação focados e build QA aprovados. Testa autoria/contribuidores/âmbito/MFA/revogação, snapshots, rejeição/correcção/reenvio, reatribuição, fila sem duplicação, rollback, notificações idempotentes, fonte alterada, recuperação e recusa de publicação. Conferência visual mantém a ressalva da ferramenta; formatação global continua nos 61 ficheiros preexistentes exteriores ao delta, sem dispensa. Entregabilidade real não demonstrada. Relatório: docs/investmoz/v2/auditoria-portal/ofertas-fase2-entrega-qa-20261114.md. Recibo: outputs/offers-private-phase2-20261114/qa-result.json.
|
||||
|
||||
Saldo RF-MN-003: F1/F2 implementadas e verificadas tecnicamente em QA, não instaladas; requisito integral/Procuras permanecem parciais. Fase 3 e instalação em homologação/produção dependem de autorização expressa própria. Não foram iniciados catálogo público, NDA, comprovativos, fotografias ou validade. Próximo passo é rever esta entrega e conferir visualmente quando o ambiente permitir, sem reabrir provas técnicas aceites.
|
||||
# 14/11/2026 — Ofertas, Fase 3 em QA (RF-MN-003)
|
||||
|
||||
Base F2 `91c18573`, F1 `1f2990e4` e plano `6e302db6` preservados. Consulta `/ofertas`, detalhe, API e CSV reutilizam filtros, paginação, mapa e layout público existentes. Categoria, província/distrito e preço são aplicados à projecção pública aprovada/publicada, separada da edição privada; intervalos e ordenação exigem moeda, sem câmbio. Mapas apresentam limites administrativos, sem pontos dos negócios. Contactos, documentos e dados financeiros privados não são seleccionados pelo consumidor. Sem reorganização do menu, novas tabelas, alterações em `mne`, instalações ou dados operacionais.
|
||||
|
||||
A publicação efectiva permanece bloqueada, incluindo rotas alternativas. O catálogo normal fica vazio/detalhe 404. Apenas injecção interna de teste, com a guarda de ambiente testing/base isolada em 55441, permite demonstrar projecções sintéticas; parâmetros HTTP e JSON armazenado não abrem a barreira. Não se declarou uma publicação real nem se implementaram as Fases 4/5. Uma revisão privada pendente/rejeitada não substitui o snapshot público anterior.
|
||||
|
||||
QA final: 10 testes/133 asserções aprovados; inclui acessos directos, estados inválidos, isolamento, preservação, hierarquia, decimais/moedas, mapa sem localização exacta, CSV, HTML compilado e regressão nativa autocontida. Passagem anterior: 36/41 aprovados; cinco casos nativos impedidos por referência Inhambane ausente na base sintética. Tipos, lint focado, Pint, PHPStan e build aprovados. Formatação global: os mesmos 61 ficheiros exteriores ao delta. Conferência visual/móvel pendente: `The browser access host is unavailable`; não substituída por aprovação técnica. Email real F2 mantém pendência.
|
||||
|
||||
Estado: implementado em QA com barreira fechada, não instalado; módulo integral e Procuras parciais. Limites representados: 1.000 candidatos e contexto de 30 territórios, assinalados quando truncados. Relatório: `docs/investmoz/v2/auditoria-portal/ofertas-fase3-entrega-qa-20261114.md`. Recibo: `outputs/offers-public-phase3-20261114/qa-result.json`. Próximo passo: conferência desktop/móvel e apreciação da entrega QA; sem instalação ou avanço de fase por inferência.
|
||||
|
||||
## 14/11/2026 — Ofertas Fase 4, particularidades e confidencialidade em QA
|
||||
|
||||
Base F3 7691cab3 preservada, tal como F1/F2 e plano aceite. A Tempo confirmou os campos propostos como opcionais na preparação; confirmou que o NDA real continua pendente. Empresas: sectores do cadastro existente, receita/fluxo de caixa, moeda, motivo e disponibilidade declarada. Imóveis: modalidade, tipo existente, áreas/unidade, divisões, comodidades e disponibilidade. Reutiliza localização, rascunho, versões, submissão e revisão existentes.
|
||||
|
||||
Fotografias: máximo de seis activas, envio/alteração/retirada/restauro sob autorização e bloqueio do registo. Originais cifrados no disco privado; MIME, conteúdo, tamanho e quarentena no serviço existente. Declaração de edição digital conservada. Comprovativos imobiliários só podem ser lidos por validador interno com âmbito, MFA e sem conflito; dono/interessado/auditor/outro âmbito recusados. O controlo comum de binários impede atalhos; o envio não certifica titularidade.
|
||||
|
||||
Controlo empresarial exige aceitação do exemplar exacto do NDA e autorização expressa do vendedor para a mesma versão aprovada. Cada consulta revalida ambas, direitos e revisão de acesso. Retirada/revogação e alteração de versão fecham a consulta seguinte; nova aceitação exige nova autorização. História e auditoria preservam actores, instantes, hashes, versões e antes/depois; fundamentos cifrados. A leitura autorizada só entrega os campos empresariais conferidos, sem contactos, morada exacta ou comprovativos. NDA configurado nulo, sem texto inventado ou publicação. Fotografias originais continuam privadas.
|
||||
|
||||
Os cinco testes territoriais foram investigados: dependiam de Inhambane/turismo previamente importados numa base vazia. O fixture cria apenas os mínimos sintéticos quando faltam, com guarda testing/loopback/*_test:55441 e transacção de rollback. Os seis casos passaram; nenhum cadastro operacional foi alterado. Os snapshots F4 vinculam particularidades/recursos ao contrato v3; Ofertas comuns anteriores conservam v2.
|
||||
|
||||
Estado: implementado em QA, sem instalação, publicação efectiva, pagamentos, destaque comercial, migrações ou alterações em mne. Fase 5 não iniciada; módulo integral/Procuras parciais. Pendências: exemplar/versão/aprovação do NDA, identificação jurídica dos comprovativos admitidos, visual desktop/móvel e email real anteriores. GD ausente: derivadas do processador nativo continuam bloqueadas, sem simular processamento. Formatação global mantém 61 ficheiros exteriores ao delta. Relatório: docs/investmoz/v2/auditoria-portal/ofertas-fase4-entrega-qa-20261114.md. Recibo: outputs/offers-private-phase4-20261114/qa-result.json; contém resultados e hashes finais, sem somar execuções sobrepostas. Próximo passo: apreciação QA e disponibilização do NDA aprovado, mantendo o bloqueio de publicação.
|
||||
|
||||
## 14/11/2026 — Ofertas Fase 5, fecho operacional em QA
|
||||
|
||||
Base aceite com ressalvas e431de8b preservada, tal como 7691cab3, 91c18573, 1f2990e4 e plano6e302db6. F5 autorizada exclusivamente em QA. O dono pode retirar disponibilidade imediatamente, sem aprovação editorial ou bloqueio por etag antigo. Retirada/expiração excluem leituras públicas e fecham dados protegidos por NDA. Conteúdos, identificadores, originais e decisões não são apagados.
|
||||
|
||||
Reactivar exige pedido no mesmo cadastro, novo ciclo operacional e nova submissão/revisão/aprovação no motor existente; só depois o dono repõe disponibilidade privada. O snapshot v4 inclui o ciclo, preservando v2/v3 anteriores. Uma publicação antiga não reaparece e grants NDA antigos não reabrem por causa dessa reactivação. A reposição de disponibilidade não publica.
|
||||
|
||||
Validade independente do NDA: validity_days e validity_policy_reference inicialmente nulos, sem prazo definitivo presumido. Política congelada por hash; início na publicação da versão; configuração ou aprovação privada posterior não prolongam o exemplar público anterior. Expiração verificada em cada leitura, sem depender do agendador. API/cartão apresentam data apenas quando conhecida; CSV conserva o formato anterior e a mesma exclusão. Comando investmoz:offers-expire confere sem escrita; --confirm materializa com auditoria/idempotência. Agendamento permanece desligado.
|
||||
|
||||
Denúncias fundamentadas ficam cifradas com origem, actor e versão, ligadas a tarefas CRM e ao Dashboard Colaborativo existentes. A entrada Ofertas — acompanhamento usa a mesma listagem privada e filtro de denúncias pendentes. Validador no âmbito, com MFA e sem conflito, analisa e conclui com fundamento, com ou sem retirada. Etags e versão da denúncia protegem a decisão; o proprietário não recebe os dados originais do denunciante. Retomas devolvem o recibo sem outra tarefa. Planos administrativos de destaque têm versão/histórico e só rascunho/arquivo, sob Publicador autorizado; não alteram is_featured, cobram ou executam pagamentos.
|
||||
|
||||
Verificação: percurso novo inicialmente com 12 testes/151 asserções aprovados; regressão integrada final com 59 testes/780 asserções aprovados, com resultados no recibo outputs/offers-private-phase5-20261114/qa-result.json. Grupos sobrepostos não devem ser somados. Relatório técnico e matriz de aceitação das cinco fases: docs/investmoz/v2/auditoria-portal/ofertas-fase5-fecho-qa-20261114.md. A matriz RF-MN-003 existente foi actualizada, sem novo inventário geral.
|
||||
|
||||
Estado: cinco fases preparadas em QA; F1-F4 aceites tecnicamente com ressalvas, F5 para apreciação; nenhuma instalação ou publicação efectiva. Mantêm-se pendências NDA/exemplar/versão/aprovação, tipos jurídicos de comprovativos, prazo final, avisos jurídicos, visual desktop/móvel, GD/WebP e email real F2. Formatação global mantém61ficheiros preexistentes fora do delta. NDA mantém configuração nula; sem migrações, alterações em mne, dados operacionais, pagamentos ou promoção comercial. Procuras/restante portal não encerrados por este lote. Próximo passo: apreciação QA e decisões documentais; instalação/activação/publicação aguardam autorização expressa.
|
||||
# Auditoria de aceitação Ofertas — 14/11/2026, antes de instalar
|
||||
|
||||
Referência: `../v2/auditoria-portal/ofertas-aceitacao-final-20261114.md`. Candidata `528a2597`; commits e hashes F1–F5 conferidos, JUnit aceite 59 testes/780 asserções confirmado sem o apresentar como nova execução. Nova regressão dos componentes nativos: 14/227 aprovada. Novo teste de integração: 2/11, um aprovado e uma falha na reutilização da descrição da Oferta pelo contexto de investimento; recuperação financeira privada e isolamento passaram. A aceitação integral permanece bloqueada: falta demonstrar Oferta → dossier → viabilidade em função da localização → relatório → recuperação. Publicação efectiva não implementada/activada; NDA real, visual/móvel, imagens e entrega real de email mantêm os estados específicos do relatório. Plano de instalação preparado, zero novas migrações no delta, schema do destino e reversão compatível por conferir. Nenhuma instalação ou alteração funcional efectuada nesta auditoria. RF-MN-003 actualizado sem alterar os restantes requisitos.
|
||||
# Correcção Ofertas → contexto de investimento — QA, 14/11/2026
|
||||
|
||||
Após `ed2fd86f`, foi autorizada exclusivamente a correcção da continuidade. `InvestorContext` passa a recuperar a descrição da Oferta quando não existe resumo, mantendo a mesma Opportunity, os identificadores e a autorização privada. Resumo existente e edições deliberadas no dossier prevalecem. Não se copiam dados empresariais confidenciais, contactos ou preço privado; NDA/autorização do vendedor não concedem acesso ao contexto privado. A prova sintética percorre criação, submissão, revisão/aprovação, projecção pública isolada de teste, contexto/dossier, localização, pressupostos financeiros declarados, gravação/recuperação e relatórios HTML/Word. Não representa publicação real nem rentabilidade garantida. Recibo e resultados em `../v2/auditoria-portal/ofertas-correcao-contexto-qa-20261114.md` e `outputs/offers-investment-continuity-20261114/qa-result.json`; RF-MN-003 e matriz final actualizados. Mantêm-se pendências jurídicas, visuais, de imagens e email real. Sem instalação, activação pública, migrações ou alteração de dados operacionais; aguarda nova autorização para instalar.
|
||||
# Preparação final de homologação privada das Ofertas — 14/11/2026
|
||||
|
||||
A Tempo aceitou tecnicamente `9a014268` e autorizou apenas preparação. Parecer em `../v2/auditoria-portal/ofertas-prontidao-homologacao-20261114.md`: integração privada em QA demonstrada, 48 hashes dos recibos F5/correcção conferidos e bundle Git local da candidata verificado. Sem diferenças de migrações/locks face ao recibo histórico `96f51096`; destino actual ainda por conferir. Homologação privada recomendável com publicação fechada, condicionada a revisão/schema/runtime reais, backup/restauro actual, delta e reversão compatível, e nova autorização expressa. GD/WebP ausente no PHP QA bloqueia derivadas, preservando originais; visual/móvel, email real e decisões jurídicas mantêm pendências próprias. Ensaio de correio preparado com dados sintéticos e caixa de teste a designar, sem fila/destinatários operacionais. Nenhuma instalação, migração, alteração operacional, envio de email ou activação pública nesta preparação. RF-MN-003 e matriz final distinguem aprovação técnica, instalação e publicação.
|
||||
# Menus das Ofertas uniformizados na prévia QA — 14/11/2026
|
||||
|
||||
Por pedido expresso da Tempo durante a conferência, a navegação privada das Ofertas reutiliza o padrão horizontal com dropdown do portal. Área de trabalho → Ofertas agrupa consulta/preparação conforme os acessos existentes; o módulo agrupa Ofertas, estados e acompanhamento em dropdowns responsivos. Mudar de estado conserva os filtros de acompanhamento/denúncias. Todas as páginas Ofertas usam o mesmo enquadramento PortalNavigation. Não foram alteradas permissões, rotas, publicação ou dados. Passaram 29 testes de navegação, tipos, lint focado e build QA; um aviso de lint preexistente fora do delta foi preservado. A lista e os dois exemplos já existentes responderam HTTP 200 com os novos assets, mantendo a sessão e os dados da prévia. Conferência visual pelo utilizador pendente; sem instalação em homologação. Recibo: `outputs/offers-menu-qa-20261114/qa-result.json`. O bundle anterior `9a014268` permanece preservado e não inclui este novo delta visual.
|
||||
# Verificação real pré-instalação das Ofertas — 14/11/2026
|
||||
|
||||
Por autorização específica, destino `teste-investidor.tempo.co.mz` confirmado em `96f51096`, sem instalar Ofertas ou alterar configuração/permissões/dados operacionais. Estruturas verificadas compatíveis; GD/WebP presente em CLI/FPM e codec em memória aprovado. Backup actual privado e restauro isolado passaram: 219 tabelas, 417 ficheiros, dois conjuntos de MFA; zero originais Laravel cifrados na fonte para ensaiar. Release anterior arquivada e 9.873 ficheiros reconferidos. Após a cópia, apenas uma sessão nova, com as 51 anteriores intactas; nenhuma outra tabela divergente. Parecer APTO COM CONDIÇÕES: autorização futura com SHA expresso (base `9a014268` ou candidata com menus `3558647e`), reconferência da salvaguarda e janela sem integrações concorrentes; o executor segue o último `main`. Publicação/NDA/agendamento/correio de Ofertas mantidos fechados; visual, galeria completa, email real e decisões jurídicas permanecem separados. Relatório: `../v2/auditoria-portal/ofertas-verificacao-preinstalacao-20261114.md`; recibos sanitizados em `outputs/offers-preinstall-verification-20261114`. Não houve instalação, migração operacional, alteração de `mne` ou envio real de email.
|
||||
# Instalação autorizada das Ofertas — paragem de entrada, 14/11/2026
|
||||
|
||||
A Tempo autorizou expressamente `3558647e`, incluindo menus, mantendo fecho público. A verificação de entrada encontrou `main` e homologação em `96f51096`; o executor segue esse ramo. Em cumprimento da condição 4, a operação foi interrompida antes de qualquer push/pedido/instalação. Executor inactivo, zero pedidos; nenhuma migração, alteração operacional ou reversão. A instalação já está autorizada, mas a integração exacta e controlada de `3558647e` em `main` exige decisão após esta paragem; o fast-forward é possível sem força e pode accionar a instalação. Não reiniciar preparação/testes aceites para resolver esta diferença de ramo. Recibo: `outputs/offers-authorised-install-20261114/entry-blocked.json`.
|
||||
# Instalação exacta das Ofertas — falha antes da promoção e correcção QA, 14/11/2026
|
||||
|
||||
O fast-forward autorizado `96f51096 → 3558647e` foi efectuado sem força ou commits posteriores. Janela com path automático pausado, lock exclusivo e chamada única ao executor existente, recusando qualquer outro SHA. Novo backup/restauro isolado 219 tabelas/417 ficheiros aprovado. O executor passou schema isolado 1/3106 e build, mas parou em tipos: colisão Wayfinder entre a acção GET `reportForm` e o formulário gerado para POST `report`. Sem promoção, migrações, alteração operacional ou reversão; homologação servida permanece `96f51096`, 219 tabelas/417 ficheiros reconferidos intactos. Lock libertado, path original restaurado, fila vazia. Correcção mínima em QA: acção GET `reportPage`, mesmo URL e corpo, com geração real/produção/tipos/PHPStan/Pint e 28 testes/403 asserções aprovados, numa base isolada separada da prévia. Nenhum novo push ou instalação. Relatório: `../v2/auditoria-portal/ofertas-instalacao-privada-incidente-wayfinder-20261114.md`; recibo `outputs/offers-exact-install-20261114/qa-result.json`. Nova revisão correctiva exige autorização expressa antes de integrar/instalar; publicação, correio, pagamentos e decisões jurídicas continuam nos limites anteriores.
|
||||
|
||||
|
||||
### 2026-11-15 — pesquisa local de instituições
|
||||
AUD-FUND-01: diagnóstico e delta sobre bd000d04 registados em `../v2/auditoria-portal/apresentacao-contexto-qa-20261115.md`. Filtros existentes; corrigidas em código a predefinição física e a apresentação das moradas/incerteza. 10 testes frontend aprovados; API, tipos globais/build e visual da candidata por concluir. Sem instalação ou alteração de dados.
|
||||
|
||||
|
||||
## 15/11/2026 - AUD-FUND-01: bundle afa02559 verificado em QA
|
||||
|
||||
Bundle integro, base bd000d04 e delta de produto preservado sem recriacao. Ramo isolado qa/funding-location-bundle-20261115; recibos e matriz posteriores preservados por integracao dos commits documentais c4aa3ac5/25d18f51. O trabalho sectorial permanece noutro ramo QA, sem entrar nesta candidata.
|
||||
|
||||
Provas executadas: 10 testes frontend aprovados; suite HTTP FundingCriteriaCoherenceTest com 5 testes/138 assercoes aprovados, incluindo a predefinicao documentada; geracao Wayfinder normal, tipos e compilacao aprovados. Navegador real em computador 1440px e emulacao movel 390px: pesquisa por provincia com 2 correspondencias, distrito com 1; morada do balcao local no cartao, sem apresentar sede de outra provincia como presenca local; detalhe conserva ambas as moradas; regresso recupera todos os criterios escolhidos (campos vazios podem ser omitidos); desconhecidos apenas por escolha explicita e identificados; cobertura nacional de produto distingue-se da presenca fisica. Confirmada ausencia de extravasamento horizontal e captura final apos carregamento dos selectores. Dados exclusivamente sinteticos, sem alterar instituicoes activas.
|
||||
|
||||
Recibo: outputs/funding-location-20261115/qa-verified.json. Instalacao autorizada pela Tempo depois destas verificacoes; backup fresco iniciado em janela reservada, restauro isolado em curso. Nao presume instalacao, novo cadastro, permissao, publicacao Ofertas ou alteracao em producao.
|
||||
|
||||
|
||||
## 15/11/2026 - AUD-FUND-01 instalado em 44c3436b
|
||||
|
||||
Revisao instalada e servida: **44c3436b19af630e4f0ff3aa04161d63b3ccab22**, em https://teste-investidor.tempo.co.mz/fundos. Contem exactamente o delta de produto do bundle afa02559, mais reconciliacao documental; preserva recibos posteriores e exclui o desenvolvimento sectorial ainda em QA. Ofertas e dashboard preservados. Main avancou por fast-forward, sem force push. Executor verified_complete; watcher restabelecido, sem pedidos pendentes e servicos activos.
|
||||
|
||||
Backup/restauro fresco: 219 tabelas com contagens/checksums iguais e 417 ficheiros restaurados/conferidos; 12 229 ficheiros de codigo anterior arquivados para reversao. Conferencia posterior: dados de negocio e ficheiros inalterados; apenas cache, sessoes e contadores tecnicos reconciliados. Nenhuma sessao anterior removida. Sem migracoes operacionais, alteracao de permissoes, envio de notificacoes, activacao publica Ofertas ou producao. Sem necessidade de reversao. A expiracao SSH foi resolvida por autenticacao normal e reconciliacao do pedido, sem repetir instalacao.
|
||||
|
||||
Executor: estrutura 1/3106, unitarios 132/611, frontend **1969/1969**, tipos/Wayfinder/build aprovados. 35 verificacoes HTTP comuns aprovadas. Verificacao adicional no destino, por presenca fisica em Tete: **8 resultados documentados**; os 8 tinham pontos correspondentes ao territorio. A escolha explicita de desconhecidos devolveu **140**, sem os converter em presenca confirmada. O distrito consultado sem presenca documentada devolveu zero; nao se presumiram balcoes. O detalhe preservou os criterios territoriais. Os percursos positivos de provincia/distrito, moradas, desconhecidos e retorno foram demonstrados com dados sinteticos em computador e emulacao movel.
|
||||
|
||||
Recibos: outputs/funding-location-20261115/installation-verified.json e qa-verified.json. Conteudo das instituicoes, fontes e cobertura existentes nao foram modificados. Disponibilidade ou condicoes reais permanecem as que constam das respectivas fontes. Este fecho cobre AUD-FUND-01; nao encerra o portal, Ofertas ou a candidata proactiva dos cinco sectores.
|
||||
|
||||
|
||||
### Contexto sectorial → preparação no mesmo dossier — candidata QA 15/11/2026
|
||||
|
||||
Nas páginas de Turismo, Agronegócio, Infra-estruturas, Mineração e Energia e nos artigos regionais, use «Do contexto à sua ideia». Escolha a possibilidade e consulte «Fundamento e origem». «Preparar investimento a partir deste contexto» ou «Comparar com a oferta existente» permitem criar ou reutilizar um dossier autorizado. Confirme apenas actividade, localização conhecida e dados em falta; anúncio, corredor, parque ou zona não são obrigatórios.
|
||||
|
||||
Depois de rever e guardar o contexto, consulte a análise agregada no dossier e continue no simulador existente. O intervalo do orçamento não é transformado automaticamente num montante: introduza e confirme o cenário financeiro. Guarde o rascunho, retome e use «Guardar pressupostos financeiros e voltar ao dossier». O relatório privado conserva os trechos seleccionados, edição e âmbito territorial, juntamente com a análise de Mercado/SWOT. Uma fonte alterada assinala revisão, preservando o fundamento anterior.
|
||||
|
||||
Provas em português: cinco percursos em computador e viewport móvel, 8 testes HTTP/422 asserções e 24 frontend; tipos, análise estática e build aprovados. A consulta de idiomas devolve 503 por indisponibilidade do tradutor externo QA; esse probe ficou registado como falhado e a tradução não foi validada nem alterada. Ver `outputs/sector-context-20261115/qa-verified.json` e a actualização da mesma matriz (AUD-LEG-03/05/06 e INE-DEMO-01). Esta extensão está em QA, não instalada; a entrega financeira na homologação mantém `44c3436b`. Não há novas publicações, migrações, permissões, notificações externas ou activação de Ofertas.
|
||||
|
||||
|
||||
### Cinco sectores disponibilizados na homologação — d3067050, 15/11/2026
|
||||
|
||||
A extensão anterior está instalada em `https://teste-investidor.tempo.co.mz`: `/turismo`, `/agronegocio`, `/infraestruturas`, `/sectores/mineracao` e `/sectores/energia-especifica`. As onze leituras regionais de Turismo também conservam os fundamentos e a continuação no mesmo dossier. A consulta é pública; a autenticação normal é necessária para criar ou recuperar a preparação privada.
|
||||
|
||||
Use «Do contexto à sua ideia» → escolha a hipótese e consulte a origem → prepare ou reutilize um dossier → confirme os dados em falta → compare a oferta e continue o cenário financeiro → guarde, exporte e retome. Anúncio, corredor, parque ou zona não são obrigatórios. Fonte provincial não se torna informação distrital; desconhecido não equivale a ausência de oferta.
|
||||
|
||||
Instalação confirmada em `d3067050`, com backup/restauro e preservação de219 tabelas/417 ficheiros. Correcção financeira, Ofertas e dashboard preservados. Ver `outputs/sector-context-20261115/installation-verified.json` e a mesma matriz (AUD-LEG-03/05/06, INE-DEMO-01 e AUD-FUND-01). Os estados anteriores de QA permanecem como histórico. Tradução e cobertura multilingue continuam pendentes; não houve activação pública de Ofertas, novas permissões, pagamentos ou produção.
|
||||
|
||||
|
||||
**Limite no destino:** a consulta agregada de empresas da base interna continua exclusiva do QA isolado, conforme a autorização original. Não foi activada nesta instalação e não se alargaram permissões. A consulta pública e a preparação do investimento estão disponíveis; usar os agregados internos na homologação exige decisão específica de acesso e uma alteração compatível. A demonstração completa dessa consulta permanece circunscrita ao QA, separada da pendência de tradução.
|
||||
|
||||
|
||||
## Consulta empresarial protegida no dossier próprio — 15/11/2026
|
||||
|
||||
Implementada e verificada em QA, ainda sem instalação deste delta. A decisão expressa «Autorizar apenas agregados protegidos no dossier próprio» permite esta capacidade; não atribui papéis internos nem acesso às listas. A homologação de referência continua em `d3067050` até existir recibo de instalação posterior.
|
||||
|
||||
O proprietário encontra «Actividades existentes na localização» no dossier aberto. Recupera território, sector e intenção, pode comparar uma actividade publicada e guardar a análise no mesmo dossier. A escolha de comparação não altera a actividade do investimento. O histórico e o filtro são recuperados após recarregar; os dados de orçamento mantêm-se. O acesso a outro dossier e às linhas/documentos da base interna continua recusado.
|
||||
|
||||
Protecção: células fixas distrito/divisão CAE publicada, calculadas antes dos filtros; localidades recebem apenas contexto distrital. Grupos com menos de cinco identidades documentais resolvidas, conflitos, duplicações e identificadores por observação não são divulgados. Os resultados são intervalos de cinco, sem totais marginais ou datas por célula; não se recalculam intersecções arbitrárias. Dados apenas provinciais conservam esse âmbito. Não são empresas únicas certificadas; não se somam grupos. Resultados ausentes e protegidos têm a mesma representação. Fontes, períodos e cobertura desconhecida são explícitos; nomes, contactos, ficheiros e linhas originais não integram a resposta. Os controlos reduzem identificação indirecta e consultas por diferença, sem prometer anonimato matemático perante conhecimento externo ou alterações futuras das fontes.
|
||||
|
||||
Provas: 6 testes HTTP/218 asserções, 3 testes frontend, regressão sectorial 5/183, PHPStan dirigido sem erros, tipos, lint e compilação normal/Wayfinder aprovados. Dez execuções autenticadas, cinco sectores × computador/viewport móvel, demonstram consulta → gravação → recuperação no mesmo dossier, filtro e orçamento preservados, histórico e ausência de listas privadas. Emulação não equivale a dispositivo físico. A conferência detectou uma chave React repetida entre secções irmãs; a chave do agregado foi distinguida e os dez casos repetidos no código final, sem duplicação. Os primeiros erros de sincronização/locators do ensaio ficam nos artefactos locais, não são apresentados como provas aprovadas.
|
||||
|
||||
Recibo: `outputs/aggregate-supply-20261115/qa-verified.json`; capturas em `outputs/aggregate-supply-20261115/visual/`. Não há migrações, alterações RLS, novos papéis ou permissões, acesso individual/exportação, publicação de Ofertas, notificações externas ou pagamentos. A capacidade é desactivada por defeito e requer apenas a flag específica autorizada no destino; a guarda da base QA permanece inalterada. Reversão: desactivar a flag e regressar à revisão anterior, preservando os snapshots e históricos. Tradução mantém a pendência externa separada. Esta entrega não encerra requisitos globais do portal nem Ofertas.
|
||||
|
||||
|
||||
**Bloqueante confirmado no destino:** a leitura técnica autenticada encontrou apenas cinco códigos gerais publicados (`agronegocio`, `economia-azul`, `infraestruturas`, `mercado-financeiro`, `turismo`) e nenhuma divisão CAE numérica publicada. Os quatro exemplares internos têm o contrato reconhecido e existem grupos documentados não singulares, mas a classificação não é compatível com o adaptador. As dez provas usam referências publicadas sintéticas em QA; não demonstram disponibilidade da classificação no destino. O recorte original CAE A/01/011/0112/01120 está preparado em lote existente e não cobre os cinco sectores. Não se publicou esse lote nem se presumiram correspondências CAE → sectores. O servidor devolve 422 com explicação compreensível quando falta a classificação, sem gravar um resultado falso ou alterar o dossier. O teste adicional passou sem desactivar a guarda de imutabilidade das referências. Instalação suspensa, homologação/main em d3067050, sem reserva, migração, alteração de configuração ou escrita de dados. É necessário reconciliar as referências originais CAE e as correspondências sectoriais no catálogo existente e obter a respectiva validação/publicação editorial, antes de habilitar o delta. A autorização de consulta agregada não publica automaticamente outro lote de referências (AGENTS.md: «Nunca publicar automaticamente um lote»). Isto não exige nem autoriza acesso a empresas individuais. Não existe neste momento um pacote apto para instalação útil nos cinco sectores.
|
||||
|
||||
|
||||
## Reconciliação real e remoção do bloqueio de classificação — 15/11/2026
|
||||
|
||||
A instrução seguinte autorizou continuar `c8957ecb` e confirmou que divisões CAE numéricas publicadas não são um requisito universal. O bloqueio descrito acima era uma escolha de implementação, agora corrigida. O adaptador privado reutiliza o contrato existente `EconomicReferenceCatalog`, o exemplar CAE eBAU já aceite (SHA256 `83b4f120…506`) e a hierarquia SELF_ID/PARENT_ID: 1 339 nós com grupo amplo identificado, 88 grupos. Não cria outro cadastro, não insere/publica referências gerais e não altera os cinco códigos gerais publicados. Código demonstrado ou designação exacta são utilizáveis; diferenças de maiúsculas com acentos são tratadas de forma determinística, incluindo PostgreSQL com locale C.
|
||||
|
||||
Não se inventam equivalências CAE → doze sectores do portal. O sector, intenção, território e orçamento mantêm-se no dossier; o utilizador escolhe a classificação da comparação. Correspondências publicadas já utilizáveis continuam disponíveis. «HOTÉIS COM RESTAURANTE» conserva o grupo amplo Alojamento; Restaurantes conserva Restauração e similares. O resultado explicita o agrupamento amplo, sem o apresentar como contagem exclusiva do subtipo seleccionado. O enquadramento amplo de alojamento do exemplar turístico, aceite anteriormente, é reutilizado apenas para essa fonte e sem inventar subtipo. Os seus registos sem identidade resolvida continuam excluídos dos limiares de divulgação. Não se tornam empresas únicas por terem uma actividade identificada.
|
||||
|
||||
A reconciliação das observações reais separou correspondências por código, enquadramento documental amplo e ausência de classificação. Não encontrou pares concretos código/designação contraditórios na fotografia aceite; o teste de conflitos garante a sua exclusão quando existam. A ausência de classificação e as situações ambíguas não são convertidas em equivalências nem em ausência de actividade. A edição normativa do exemplar e os tipos específicos do recorte turístico continuam indeterminados. Não surgiu uma decisão editorial bloqueante para as correspondências demonstradas; não se publicou automaticamente nenhum lote.
|
||||
|
||||
Prova real: leitura técnica autenticada SSH/PostgreSQL em transacção READ ONLY, usando o compilador de classificação da candidata, geografia pública canónica e as mesmas protecções de identidade, duplicados, grupo mínimo e intervalos. Retornaram-se apenas oito células agregadas de exemplo: em Cidade de Nampula, 25–29 identidades documentais em Alojamento e 290–294 em Restauração. São intervalos documentais históricos, não empresas únicas certificadas, clientes, procura ou cobertura nacional integral. Não se devolveram linhas, nomes, contactos, documentos ou identificadores individuais. Esta leitura técnica não é apresentada como login de um investidor operacional; as permissões e a interface de proprietário foram verificadas separadamente em QA, com contas sintéticas.
|
||||
|
||||
Delta verificado: 3 testes HTTP/49 asserções e 1 teste/12 asserções para o enquadramento turístico; três testes frontend afectados, PHPStan, tipos, lint, Pint e compilação normal/Wayfinder aprovados. Quatro novas execuções autenticadas (hotéis/restaurantes × computador/390 px) demonstraram escolha por designação, gravação, recuperação, manutenção do sector e apenas intervalos protegidos. Emulação móvel, sem alegar telefone físico. Reutilizadas as provas aceites de `c8957ecb`, sem outra ronda geral. Recibos `outputs/aggregate-supply-20261115/source-reconciliation-qa.json`, `source-classification-reconciliation.json` e `real-protected-aggregates.json`.
|
||||
|
||||
Utilização: no próprio dossier aberto, «Actividades existentes na localização» → pesquisar a actividade pelos primeiros três caracteres ou código → «Consultar e guardar análise agregada». A análise, classificação e histórico são privados e recuperáveis. A escolha não substitui a actividade do investimento. Sem correspondência previamente demonstrada, pede-se a escolha da classificação em vez de presumir equivalência entre taxonomias. Grupos pequenos, conflitos e falta de identidade/classificação conservam a explicação de cobertura insuficiente, nunca «não existem empresas».
|
||||
|
||||
Estado desta passagem: candidato verificado, instalação já autorizada e ainda não executada neste registo. Prosseguir pelo executor Git com capacidade, backup/restauro frescos, pin da revisão, activação apenas de `INVESTOR_PROTECTED_SUPPLY_ENABLED` e conferência do delta. Sem migrações, novos papéis, exposição individual ou produção. Ofertas, dashboard, correcção financeira e d3067050 preservados. Tradução permanece separada.
|
||||
|
||||
@@ -0,0 +1,361 @@
|
||||
## Entrega concluida na homologacao - 15/11/2026
|
||||
|
||||
**Revisao instalada e servida: `bd000d04d23402be26a1e6d309c39ef9239ab79d`.** Endereco: https://teste-investidor.tempo.co.mz. Executor Git encerrado em `verified_complete`, sem pedidos pendentes, watcher restabelecido e nginx/PHP/queue activos. Dashboard existente preservado; instaladas apenas as correccoes transversais compativeis.
|
||||
|
||||
O delta novo de **Ofertas foi excluido**: mantidos os 28 ficheiros protegidos e a configuracao da versao anteriormente instalada, comprovados no destino. Publicacao publica, NDA operacional e activacoes comerciais continuam bloqueados. Esta entrega nao aceita funcionalmente Ofertas.
|
||||
|
||||
Verificacao do destino: estrutura 1/3106; unitarios 132/611; interface 1966/1966 sem falhas; Wayfinder, tipos e compilacao aprovados; 35 verificacoes HTTP/recursos com resultados esperados. Revisao remota, executor e revisao servida coincidem. Filtros financeiros contraditorios recusados com 422; leitor publico/API/mapa/CSV sem Ofertas expostas. Reutilizadas as 15 provas autenticadas QA, incluindo emulacao movel; nao se presume nova conferencia visual autenticada em homologacao ou dispositivo fisico.
|
||||
|
||||
Backup actualizado e restauro isolado verificados. Reconciliadas 219 tabelas e 417 ficheiros persistentes: dados de negocio e ficheiros inalterados. Diferencas apenas em cache/reinicio/limites, sessoes e contadores agregados de pesquisa; nenhuma sessao anterior nao expirada foi removida. Nao executadas migracoes, alteracoes de permissoes, notificacoes externas ou pagamentos. Nao foi necessaria reversao.
|
||||
|
||||
Incidente resolvido: a primeira candidata `fb076c17` parou na regressao antes da promocao; pedido reconciliado e arquivado. Corrigidos os testes antigos sem retirar assercoes de seguranca e o bloqueio dos controlos de orcamento durante confirmacao/modo de leitura. Recibo sanitizado: `outputs/transversal-install-20261115/installation-verified.json`.
|
||||
|
||||
Pendente: avaliacao de negocio/experiencia da entrega e revisao funcional do delta Ofertas excluido. A consulta empresarial agregada permanece exclusivamente QA; nao se alargou o acesso operacional a dados internos.
|
||||
|
||||
Os registos seguintes sao historicos e conservam o estado observado em cada passagem.
|
||||
|
||||
---
|
||||
|
||||
## Regressao da entrega delimitada - 15/11/2026
|
||||
|
||||
O executor interrompeu `fb076c17` antes da promocao, com 13 falhas em testes antigos de interface. A revisao servida permaneceu `13497892`; nao houve migracoes ou alteracoes de dados. Corrigidos os leitores de componentes reais, o acesso ao editor com identidade por dossier, as seleccoes de moeda/orcamento e as fixtures que dependiam de exemplos iniciais. Mantidas as assercoes de conflitos, isolamento, sequencias de gravacao e moeda de origem. Detectada e corrigida a ausencia de bloqueio dos controlos de orcamento durante a confirmacao e em modo de leitura.
|
||||
|
||||
Prova local do delta corrigido: 49 testes afectados e 1 966 testes completos aprovados, sem falhas; tipos, Wayfinder e compilacao normal aprovados. Os 28 ficheiros protegidos de Ofertas continuam identicos. A instalacao continua por concluir; backup/restauro e integridade do codigo servido reconferidos antes da retoma reservada. Nao se repete a preparacao nem as 15 provas autenticadas aceites.
|
||||
|
||||
## Entrega delimitada autorizada — 15/11/2026
|
||||
|
||||
**Estado: preparação concluída; integração/instalação ainda não executadas neste registo.** A autorização permite instalar dashboard e correcções transversais; Ofertas só poderia entrar com demonstração integral. Conferidos os recibos existentes: critérios 5/6 da Etapa B têm prova HTTP, mas a interface editorial e o critério 7 visual/móvel continuam não verificados. Por isso, **o delta de Ofertas foi excluído**, sem transformar quatro critérios anteriormente aceites em aceitação integral.
|
||||
|
||||
Preparada a entrega no ramo `delivery/dashboard-transversal-20261115`, directamente sobre a revisão servida `13497892`, por selecção do conteúdo compatível de `8806312f`, `8c6ed625` e `7810ffc8`; não por integração integral dos seus antecessores de Ofertas. Preservados os ficheiros próprios de Ofertas, recursos/fotografias, contratos, rotas, mapas privados e navegação na versão instalada. O formulário canónico partilhado com esse módulo também fica preservado. O dashboard existente é mantido; não se presume outro incremento de dashboard ausente do delta.
|
||||
|
||||
As dependências partilhadas foram conferidas separadamente. `TerritoryFields` mantém quatro níveis e mapa por defeito; só os consumidores financeiros usam as opções adicionais. Os rótulos de modalidade usados por Ofertas mantêm-se. Fontes/demografia/contexto recebem a correcção comum, sem alterar as permissões ou o contrato privado de Ofertas. O manifesto `outputs/transversal-install-20261115/scope-separation.json` regista as exclusões e os hashes dos ficheiros protegidos, a comparar no destino.
|
||||
|
||||
Provas da separação: **142 testes de interface, zero falhas; geração Wayfinder real, compilação normal e tipos aprovados**. O leitor de testes demográficos foi adaptado para resolver o componente partilhado real, sem simular a sua saída. Reutilizadas as 15 provas autenticadas dos percursos transversais cujo código foi preservado. A consulta empresarial agregada mantém a guarda exclusivamente QA e não alarga acesso a dados internos na homologação.
|
||||
|
||||
Backup actualizado concluído: 219 tabelas e 417 ficheiros. Restauro isolado conferido: contagens/checksums iguais, rede `none`, base separada na porta 55441, ficheiros e chaves/envelopes MFA recuperáveis. Zero migrações previstas; nenhuma alteração de dados, permissões, publicação ou notificações externas. Janela de instalação reservada pelo lock existente; `main` só pode avançar por fast-forward para a revisão separada, após reconferência.
|
||||
|
||||
O histórico QA abaixo conserva o seu âmbito; não demonstra instalação de Ofertas nem autoriza publicação pública.
|
||||
|
||||
---
|
||||
|
||||
# Apresentação e continuidade das consultas — candidata QA, 15/11/2026
|
||||
|
||||
Estado: **candidata QA com execução autenticada do saldo V01–V15; resultados por ecrã/largura abaixo, sujeitos à aceitação da experiência pelo responsável**. Base original `42fba8ba`, ramo `qa/public-context-20261115`. Sem instalação, publicação, alterações de permissões ou escrita em dados operacionais. Os testes posteriores usam exclusivamente a nova base sintética isolada `investor_intent_20261115_test`, em `127.0.0.1:55441`, incluindo a sua estrutura de teste. O trabalho concorrente da pasta principal e a conferência de Ofertas permanecem separados.
|
||||
|
||||
## Condição de entrega — conferência dos consumidores afectados
|
||||
|
||||
Decisão expressa do responsável: a instalação depende de cobertura consolidada dos ecrãs e percursos afectados. Um componente aprovado não aprova automaticamente os seus consumidores. A autorização existente continua limitada a implementação e validação em QA.
|
||||
|
||||
Na mesma matriz, cada consumidor deve conservar o seu estado **alinhado, corrigido, divergente ou não verificado**, com versão, ambiente, evidência e limite da prova. «Corrigido» identifica uma alteração demonstrada; não substitui a aceitação integral do percurso. Sem prova individual suficiente, o estado é «não verificado».
|
||||
|
||||
Conferir intenção; etapas e ajuda; próxima acção; reutilização de entidade/localização/moeda/orçamento; selectores e filtros no cliente e servidor; pertinência dos resultados; coerência dos valores; gravação/recuperação/regresso/recarregamento/retoma autenticada; isolamento de contas/separadores/oportunidades; computador e telemóvel; preservação de dados, funcionalidades, permissões e históricos.
|
||||
|
||||
As tabelas históricas abaixo descrevem provas dirigidas, não uma declaração de alinhamento de todos os ecrãs. A candidata não pode ser disponibilizada como correcção transversal enquanto existirem divergências ou verificações pendentes deste âmbito. Decisões jurídicas, dependências externas e funcionalidades futuras ficam separadas e não ampliam esta conferência.
|
||||
|
||||
Quando a conferência visual autenticada estiver impedida, registar o erro e disponibilizar uma prévia QA à equipa, com os percursos e operações a executar. Renderização sintética, testes automáticos e capturas de componentes não substituem essa prova. Não instalar para obter a conferência sem autorização expressa.
|
||||
|
||||
### Conferência dirigida dos quatro percursos — 15/11/2026
|
||||
|
||||
Esta passagem actualiza as linhas existentes MASTER-600240dd-0001/0018, MASTER-e1169a77-0026 e INE-DEMO-01; não cria outro inventário. «Corrigido» abaixo refere-se apenas ao comportamento e à evidência indicados. As colunas visuais não herdam a aprovação do componente nem da API.
|
||||
|
||||
Tabela de partida, anterior às conferências autenticadas registadas abaixo. **Não usar os seus «não verificado» como pedido para repetir provas entretanto obtidas. O saldo actual é a tabela «Execução do saldo V01–V15»**, que substitui as pendências genéricas desta tabela, sem eliminar o histórico.
|
||||
|
||||
| Percurso / ecrã | Estado funcional no recorte | Evidência disponível | Computador autenticado | Telemóvel autenticado / retoma |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| Hotel — entrada e editor de contexto (`/investimentos/iniciar`, `/{id}/contexto/editar`) | Corrigido: ideia própria com sector confirmado, orçamento em intervalo e localização independente de anúncios/corredores | `InvestorIntentContinuityTest`, `preparation-intent.test.mjs`, renderização do editor em `public-information.test.mjs` | Não verificado; prévia sintética anterior em 1280 px | Não verificado; prévia sintética anterior em 360 px, sem gravação |
|
||||
| Hotel — entidade existente no dossier (`/investimentos/{id}#entidade-promotora`) | Corrigido: associação autorizada, versão da fonte, dados recuperados; sem duplicar empresa, alterar dono ou membros | `InvestorPromoterContinuityTest`, incluindo isolamento, fonte alterada e organização com representação revogada | Não verificado | Não verificado |
|
||||
| Hotel — comparação opcional (`/{id}/forma-juridica`) | Corrigido: guardar alternativa e continuar na preparação da mesma entidade; distinção entre entidade existente e por constituir recuperada do payload | `InvestorPromoterContinuityTest`; PHPStan detectou variável não inicializada, corrigida nesta passagem | Não verificado | Não verificado |
|
||||
| Hotel — preparar empresa (`/{id}/preparar-empresa`) | Corrigido no servidor: recupera dados, preserva notas e forma deliberada; não altera a forma da empresa constituída | `InvestorPromoterContinuityTest`; regressões `company-preparation` e `company-comparison` | Não verificado | Não verificado |
|
||||
| Hotel — simulador, percurso assistido | Divergente: a estrutura financeira ainda reúne ferramentas e tratamentos; sete ecrãs assistidos, ajuda por actividade e retoma da etapa ainda não demonstrados | Leitura delimitada de `simulation-form.tsx`: ferramentas e oito blocos fiscais partilham condições `financial`/`tax`. Não classificar essa etapa como alinhada | Não verificado | Não verificado |
|
||||
| Hotel — calculadora e origem do financiamento | Corrigido no recorte: detecta divergências sem arredondar valores nem assumir desconhecido como zero; escolha explícita de origem; CSV e retorno impedidos com divergência; valores demonstrativos retirados dos novos rascunhos | `planning-finance-context.test.mjs`; tipos; histórico guardado conservado | Não verificado | Não verificado |
|
||||
| Hotel — guardar e recuperar cenário / devolver ao dossier | Corrigido no recorte API: cenário explicitamente declarado, intervalo separado, mesma evidência recuperada e retorno repetível sem duplicação | `InvestorIntentContinuityTest`: snapshot financeiro exacto, resultado único, moeda e isolamento da leitura do rascunho | Não verificado; não equivale a clicar em guardar/retomar | Não verificado, incluindo retoma após autenticação |
|
||||
| Hotel — relatório | Não verificado integralmente; testes do gerador preservam intervalo e resultados; não demonstram o relatório completo da sessão autenticada | `investor-dossier-report.test.mjs`; saldos da preparação assistida e períodos fiscais continuam abertos | Não verificado | Não verificado |
|
||||
| Agronegócio — Matola Rio–Sede / Boane / Maputo Província | Corrigido no recorte API: hierarquia sintética identificada, 1–5 milhões MZN, sem oportunidade, corredor ou total inferido | `InvestorIntentContinuityTest`, dois sectores; todos os dados do ensaio são sintéticos | Não verificado | Não verificado |
|
||||
| Agronegócio — consulta empresarial agregada no dossier | Corrigido no recorte QA: totais por actividade/localização, âmbito distrital identificado, repetidos e incertos separados; nomes/contactos/origem reservados não transferidos | `InvestorIntentContinuityTest`; flag privada desactivada por defeito e guarda da base QA; histórico por dossier | Não verificado | Não verificado |
|
||||
| Agronegócio — simulação e retoma | Corrigido no recorte API: valores declarados e snapshot recuperados, resultado devolvido ao mesmo dossier sem duplicação. Percurso assistido completo continua divergente como em Hotel | `InvestorIntentContinuityTest`; teste não substitui utilização do simulador no navegador | Não verificado | Não verificado |
|
||||
| Instituições — lista (`/fundos`) | Corrigido no recorte: Banca/Banco comercial, incompatibilidade estrutural, vazio válido, desconhecido/documentado, presença/cobertura e janela | `FundingCriteriaCoherenceTest`; consulta partilhada e resposta HTML/API testadas | Não verificado | Não verificado |
|
||||
| Instituições — filtros de categoria/tipo e alteração de critérios | Corrigido: opções dependentes; preservação dos critérios válidos; resultados anteriores separados até nova pesquisa; incompatibilidade corrigida só por escolha explícita | `funding-journey-coherence.test.mjs`, executa handlers da página real com transporte simulado | Não verificado | Não verificado |
|
||||
| Instituições — locais de interesse | Corrigido no recorte: distrito sem província não abre consulta nacional; consumidor usa hierarquia comum; servidor rejeita hierarquia contraditória | `FundingCriteriaCoherenceTest`; `territory-search-select.test.mjs`; componente usado no consumidor confirmado, sem presumir prova visual | Não verificado | Não verificado |
|
||||
| Instituições — detalhe e regresso (`/fundos/{id}`) | Corrigido nesta passagem: retorno preserva pesquisa, sector, estado, certeza, tipo, hierarquia e página; limpeza territorial explícita não herda o dossier | `FundingCriteriaCoherenceTest`: selecção recebida pelo detalhe comparada com todos os critérios enviados | Não verificado | Não verificado |
|
||||
| Instituições — guardar interesse / continuar dossier | Não verificado neste delta; testes dos filtros não demonstram esta operação | Reutilizar provas anteriores compatíveis; executar selecção e retoma da candidata antes do fecho | Não verificado | Não verificado |
|
||||
| Demografia — síntese e série (`/localizacoes/demografia`) | Corrigido no recorte: fonte/edição/período separados; originais preservados; grupos incompletos e anos ausentes sem valores inventados | Provas de reconciliação `21ac7eb`, `public-information.test.mjs`; prévia de componentes anterior em computador/360/390 px | Não verificado na página autenticada da candidata | Não verificado integralmente |
|
||||
| Demografia — contexto do editor/dossier/simulador | Corrigido no recorte API: ausência local recupera distrito com âmbito explícito, sem converter população distrital em local; respostas tardias isoladas | `InvestorIntentContinuityTest` e testes dirigidos do componente | Não verificado individualmente nos três consumidores | Não verificado individualmente nos três consumidores |
|
||||
| Demografia — continuar para ideia e recuperar | Corrigido na construção do URL; intenção territorial transportada sem filtros comerciais. Utilização completa não verificada | `public-information.test.mjs`, `preparation-intent.test.mjs`; gravação da ideia testada separadamente, não como prova de clique ponta a ponta | Não verificado | Não verificado |
|
||||
|
||||
**Recibos desta passagem:** `outputs/investor-intent-20261115/backend.log` — 12 testes / 412 asserções; `frontend.log` — 137 testes; `phpstan.log` — aprovado, zero erros. Os testes de API usam transacções revertidas na base sintética identificada acima. As provas são específicas dos comportamentos descritos, não 149 percursos completos.
|
||||
|
||||
**Impedimento visual observado:** inventário do conector devolveu `Browsers: Error: The browser access host is unavailable`. O controlo nativo do Edge funciona e leu o URL da janela separada: `file:///C:/laragon/www/portal-investidor-public-context-qa-20261115/outputs/investor-intent-20261115/editor-preview.html`. Essa prévia declara que não tem autenticação, gravação, consultas nem cartografia real. A sessão do portal com alterações por guardar foi preservada. Não se atribui o impedimento ao portal ou ao navegador; não se repetiram reinícios nem alterações de configuração.
|
||||
|
||||
**Saldo que impede a entrega transversal:** concluir a divergência da preparação financeira assistida e o contrato de retoma da etapa; conferir ajuda e pressupostos por actividade, período/cobertura fiscal e relatório no mesmo percurso; executar os ecrãs acima numa sessão QA da candidata em computador e telemóvel, incluindo regresso, recarregamento e nova autenticação. Os testes de isolamento no servidor não demonstram, por si só, isolamento entre separadores na interface. Nenhuma instalação ou aceitação funcional integral resulta desta passagem.
|
||||
|
||||
## Execução do saldo V01–V15 — resultados na mesma candidata
|
||||
|
||||
Actualização após a interrupção final do controlo Windows. **Instalação suspensa.** Não houve nova tentativa de navegador nesta actualização documental. O erro observado foi: `Computer Use has been stopped for this turn because it could not determine the current browser URL on Windows with enough confidence to enforce policy.` O controlo interrompeu o clique em «Voltar aos fundos e programas»; não foi observada a página de destino. Isto não demonstra erro do portal, perda de filtros ou falha de MFA.
|
||||
|
||||
Candidata local: `C:/laragon/www/portal-investidor-public-context-qa-20261115`, base Git `8c6ed625` **mais o delta QA ainda não consolidado em novo commit**; URL `http://127.0.0.3:18715`. Build servido: `build-qa-opportunities/assisted-mobile`, entrada `assets/app-f0MgDyAw.js`; SHA256 do manifesto `709989dd62b65b72eefb4b0394f776adbf0a1e340a7487a2d013170fe4e6cf03`. O SHA base, sozinho, não identifica esta candidata. Conferir esta identidade antes da execução manual; não instalar nem substituir pela homologação. Usar a conta sintética habitual, sem registar credenciais.
|
||||
|
||||
**Provas preservadas, fora da repetição:** Hotel com empresa existente, orçamento 2 milhões, mobilizado 1 milhão, diferença 1 milhão, receita anual 7,5 milhões, custo anual 2 milhões, gravação/recarga/retorno e HTML descarregado; escolha explícita de modelo/estimativas; bloqueio de cobertura 2027/2026; edição e continuação móvel de Receitas → Tesouraria. Agronegócio com entidade por constituir, actividade/localização/intervalo recuperados, modelo agrícola e recarga/retorno. Banca/Banco comercial com um resultado compatível, referência/produto/versão conservados no mesmo dossier. Demografia distrital identificada no dossier, incluindo leitura móvel, sem atribuição à localidade. A largura dos selectores financeiros foi corrigida e reconferida a 390 × 844. Limpar província desactivou os níveis inferiores e separou resultados anteriores dos critérios por aplicar. Estas provas não encerram as acções diferentes abaixo.
|
||||
|
||||
Cada linha refere-se a requisitos já existentes; **V01–V15 são identificadores de passos de verificação, não novos requisitos ou outra auditoria**. Executar só o saldo, em computador e em 390 × 844 quando a linha indicar ambos. «NÃO VERIFICADO» não equivale a «FALHOU».
|
||||
|
||||
| Passo / requisito existente | Ecrã | Acção verificada | Critério esperado | Resultado executado e evidência |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| V01 · MASTER-e1169a77-0026 | `/fundos` → `/fundos/{id}` → «Voltar aos fundos e programas» | Na pesquisa A, escolher explicitamente critérios válidos (categoria/tipo, tipo de registo, presença/cobertura, território, sector, necessidade, certeza, janela, históricos, palavra-chave e página quando existirem). Abrir o resultado e clicar no retorno da própria página. Repetir o retorno em largura móvel. | Recuperar exactamente os critérios efectivamente escolhidos e a página aplicável; resultado corresponde à pesquisa A. Nenhum critério novo herdado do dossier ou de outra pesquisa. Critérios sem resultados não são alargados silenciosamente. | Critérios e resultado bancário recuperados no retorno real do detalhe. 1440 px: **APROVADO**, 2026-11-15T15:41:27.944Z, evidência `V01-1440-1794757287944`; 390 px: **APROVADO**, 2026-11-15T15:41:54.875Z, evidência `V01-390-1794757314875` |
|
||||
| V02 · MASTER-e1169a77-0026 / MASTER-600240dd-0018 | Duas abas de `/fundos`, detalhe e regresso | Manter A no contexto agrícola e abrir B com categoria/localização diferentes, escolhidas explicitamente. Voltar ao detalhe/lista de A e recarregar A; conferir também B. | Cada URL e formulário conserva os seus critérios; não entram tipos, distritos, sector, janela ou contexto de B em A. A selecção guardada no dossier não altera a pesquisa alheia. | Pesquisas A/B conservaram critérios e contextos separados após retorno e recarga. 1440 px: **APROVADO**, 2026-11-15T16:28:25.029Z, evidência `V02-1440-1794760105052`; 390 px: **APROVADO**, 2026-11-15T16:29:13.443Z, evidência `V02-390-1794760153468` |
|
||||
| V03 · MASTER-e1169a77-0026 | `/fundos`, computador e móvel | Pela interface, tentar uma combinação estruturalmente contraditória e uma combinação válida sem registos; alterar categoria e conferir resolução do tipo incompatível. | Mensagens distintas para combinação inválida e zero resultados válido. Sem banco apresentado como fundo por inferência, sem corretoras como correspondência, sem perda de critérios independentes. | Combinação contraditória distinta do vazio válido; mudança de categoria resolveu apenas o tipo dependente. 1440 px: **APROVADO**, 2026-11-15T15:41:50.001Z, evidência `V03-1440-1794757310001`; 390 px: **APROVADO**, 2026-11-15T15:43:11.560Z, evidência `V03-390-1794757391560` |
|
||||
| V04 · MASTER-600240dd-0018 | `/simulador-fiscal?context={dossier}` e dossier Hotel/Agronegócio | Guardar a etapa de cada dossier; sair e autenticar normalmente a mesma conta sintética; reabrir cada dossier e continuar. | Recuperar etapa, valores, modelo, ordem das escolhas e contexto próprios; sem exemplos, nova pergunta sobre dados já válidos ou duplicação de resultados. | Logout/login normal recuperou Hotel 7,5 milhões e Agronegócio 2 milhões, respectivos modelos e etapa. 1440 px: **APROVADO**, 2026-11-15T15:45:04.572Z, evidência `V04-1440-1794757504572`; 390 px: **APROVADO**, 2026-11-15T16:15:11.676Z, evidência `V04-390-1794759311711` |
|
||||
| V05 · MASTER-600240dd-0018 | Hotel e Agronegócio em duas abas; acesso de segunda conta QA autorizada | Editar um pressuposto sintético de A, manter B aberto, regressar/recarregar; usar uma segunda conta QA já autorizada para tentar os URLs privados directos de A. Não criar permissões. | Sem mistura entre dossiers/abas; divergência de versão tratada sem sobrescrever edição deliberada; segunda conta sem acesso a rascunho, relatório ou documento privado alheio. | Edição concorrente recusada com 412 e entrada local conservada; dossiers separados; segunda conta sem acesso ao dossier ou rascunho privados. 1440 px: **APROVADO**, 2026-11-15T16:24:03.041Z, evidência `V05-1440-1794759843064` |
|
||||
| V06 · MASTER-600240dd-0001 / MASTER-600240dd-0018 | Dossier Hotel sintético adicional → entidade por constituir → `/preparar-empresa` → simulador → relatório | Verificar a variante Hotel com entidade por constituir, usando nova preparação sintética e preservando o Hotel existente com empresa associada. Guardar e retomar dados propostos e continuar até relatório. | Sem cadastro legal fictício, repetição da comparação obrigatória ou transferência do dono; forma escolhida e dados recuperados no mesmo novo dossier; valores do Hotel existente preservados. | Hotel por constituir guardou entidade, pressupostos, recuperação e relatório no mesmo dossier. 1440 px: **APROVADO**, 2026-11-15T16:03:54.766Z, evidência `V06-1440-1794758634766` |
|
||||
| V07 · MASTER-600240dd-0018 | Agronegócio → Receitas/Tesouraria/Revisão → relatórios do mesmo dossier | Em móvel, recuperar o modelo agrícola e os pressupostos já guardados; concluir revisão e gerar/consultar o relatório agrícola. Não redigitar nem adoptar números novos por rotina. | Modelo agrícola, receita 2 milhões e intervalo 1–5 milhões MZN recuperados; total e financiamento desconhecidos não se tornam zero ou valor único. Relatório pertence ao dossier agrícola, sem pressupostos do Hotel. | Relatório agrícola descarregado com receita 2 milhões, intervalo 1–5 milhões e custos desconhecidos preservados. 1440 px: **APROVADO**, 2026-11-15T15:45:15.049Z, evidência `V07-1440-1794757515049`; 390 px: **APROVADO**, 2026-11-15T15:45:59.234Z, evidência `V07-390-1794757559234` |
|
||||
| V08 · MASTER-600240dd-0001 | Associação de entidade, comparação jurídica opcional e preparação de empresa | Conferir estes controlos em móvel. Na comparação, recuperar escolha anterior e usar «continuar preparação»; em empresa existente, não alterar a forma jurídica do cadastro. | Controlos utilizáveis, comparação opcional, dados e edições deliberadas preservados; regresso ao dossier/viabilidade executável. | Comparação opcional e entidade utilizáveis em móvel; forma/nome recuperados; cadastro da empresa existente não substituído. 390 px: **APROVADO**, 2026-11-15T16:00:27.433Z, evidência `V08-390-1794758427433` |
|
||||
| V09 · MASTER-600240dd-0018 | Novo rascunho QA → acção de retorno antes de Financiamento | Verificar a orientação acrescentada «Conferir financiamento», seguir a acção, deixar montantes desconhecidos e guardar/voltar. | Próxima acção executável na etapa correcta, sem exigir inventar montantes; contrato de gravação e versão continua aplicado. | Orientação abriu Financiamento; gravação e retorno concluídos sem inventar montantes desconhecidos. 1440 px: **APROVADO**, 2026-11-15T16:04:46.409Z, evidência `V09-1440-1794758686409` |
|
||||
| V10 · MASTER-600240dd-0001 | `/investimentos/{id}/preparar-empresa` | Reabrir a preparação guardada e conferir a mensagem sobre modelos, em computador/móvel, sem alterar os dados. | Sem referência interna aos «sete exemplares/complemento»; indisponibilidade de modelos e distinção entre preparação e registo continuam claras; dados anteriores conservados. | Aviso histórico apresentado sem referência aos sete exemplares; nome e sede anteriores preservados. 1440 px: **APROVADO**, 2026-11-15T16:05:10.181Z, evidência `V10-1440-1794758710181`; 390 px: **APROVADO**, 2026-11-15T16:06:43.704Z, evidência `V10-390-1794758803704` |
|
||||
| V11 · MASTER-600240dd-0018 | Simulador → Enquadramento fiscal → Revisão | Conferir em móvel pesquisa, adição/retirada de uma operação e preservação dos dados. Na revisão, conferir síntese, diferenças reais e próxima acção. Se demonstrar cálculo, escolher explicitamente período coberto e valores sintéticos; não substituir o cenário 2027 guardado. | Só operações escolhidas montadas; restantes pesquisáveis; dados retirados da análise mantidos no histórico; sem códigos internos, exemplos automáticos ou comparação vazio→vazio. Separar rascunho de cálculo guardado e manter coerência com relatório. | Operação fiscal pesquisada, retirada e reposta sem perder entradas; 2027 recuperado; referência técnica fechada no detalhe da versão. 390 px: **APROVADO**, 2026-11-15T16:24:32.637Z, evidência `V11-390-1794759872659` |
|
||||
| V12 · MASTER-600240dd-0018 | Dossier agrícola → «Consultar e guardar análise agregada» | Abrir/guardar a análise com a localização existente, recarregar e recuperar a mesma evidência; conferir em móvel. | Totais/actividades e âmbito conhecidos ou cobertura desconhecida explícitos; duplicados separados; nenhum nome, contacto ou lista interna exposto; ausência de registos não significa ausência de oferta. | Análise agregada guardada e recuperada com cobertura desconhecida explícita, sem nomes/contactos internos. 1440 px: **APROVADO**, 2026-11-15T15:45:22.425Z, evidência `V12-1440-1794757522425`; 390 px: **APROVADO**, 2026-11-15T15:46:06.294Z, evidência `V12-390-1794757566294` |
|
||||
| V13 · INE-DEMO-01 | `/localizacoes/demografia` e detalhe de originais; consulta no editor e simulador | Na consulta completa, seleccionar explicitamente Boane QA e 2026–2027; abrir evolução e originais. Conferir os consumidores editor/simulador, em computador e móvel, sem repetir a síntese do dossier. | 12.345→12.600, diferença de período 255 (não taxa anual); fonte/edição/unidade/projecção explícitas, originais preservados. Localidade sem observações não recebe população distrital sem aviso. Anos/parcelas ausentes continuam sem dados. | 12.345→12.600 e diferença de período 255; originais conservados; contexto distrital identificado no editor e simulador; rótulos e selector dependente reconferidos. 1440 px: **APROVADO**, 2026-11-15T16:18:31.360Z, evidência `V13-1440-1794759511387`; 390 px: **APROVADO**, 2026-11-15T16:20:49.768Z, evidência `V13-390-1794759649790`; rótulos: V13-labels-1440-1794759923605, V13-labels-390-1794759934158 |
|
||||
| V14 · INE-DEMO-01 / MASTER-600240dd-0001 | Demografia → preparar ideia → contexto/dossier → simulador | Usar a acção territorial da consulta, confirmar sector/intenção e guardar/retomar a preparação sintética nos dois tamanhos. No percurso, conferir os selectores de país/moeda/localização efectivamente usados (lista directa, prefixo de três caracteres, acentos e código curto MZ). | Território explícito transportado sem filtros financeiros/comerciais alheios; sector proposto confirmado, anúncio/zona opcionais; hierarquia pode parar no nível conhecido, códigos canónicos e edições mantidos. Continuação no dossier sem perguntas repetidas. | Origem Boane transportada até ao simulador; país por MZ, moeda por prefixo e nível distrital guardados e recuperados. 1440 px: **APROVADO**, 2026-11-15T16:19:56.796Z, evidência `V14-1440-1794759596823`; 390 px: **APROVADO**, 2026-11-15T16:22:14.914Z, evidência `V14-390-1794759734939` |
|
||||
| V15 · MASTER-600240dd-0001 / MASTER-600240dd-0018 | Página inicial → «Criar investimento» → `/investimentos/iniciar` → editor de contexto | Nos dois tamanhos, entrar pela intenção de criar, escolher sector/localização/intervalo/moeda e guardar uma preparação sintética nova; distinguir da acção «Procurar oportunidades». Conferir regresso e edição do contexto. | Abre preparação da ideia, nunca exige procurar/associar anúncio ou escolher corredor/zona; reutiliza apenas escolhas explícitas e conserva o intervalo. Contexto alterável sem apagar valores deliberados. | Entrada Criar investimento abriu preparação própria sem anúncio ou zona, preservando localização e intervalo orçamental. 1440 px: **APROVADO**, 2026-11-15T15:49:14.009Z, evidência `V15-1440-1794757754009`; 390 px: **APROVADO**, 2026-11-15T15:55:37.546Z, evidência `V15-390-1794758137546` |
|
||||
|
||||
### Registo da execução técnica
|
||||
|
||||
O Codex executa estas linhas através de Playwright local autorizado, sem depender da recuperação do conector. Para cada V01–V15, os recibos conservam **executante, data/hora, identidade da candidata/build, ecrã/largura, acção efectivamente realizada, resultado observado e evidência**, passando a APROVADO, FALHOU ou mantendo NÃO VERIFICADO com impedimento concreto. A equipa mantém a avaliação de negócio e a aceitação da experiência. Uma captura de um componente não encerra os outros consumidores da linha. Não colocar credenciais, códigos MFA ou dados reais no registo.
|
||||
|
||||
Fecho condicionado: não iniciar outra auditoria, refazer provas acima preservadas ou instalar para obter a conferência. Uma falha nova deve indicar causa delimitada e correcção indispensável; verificar apenas os efeitos afectados. **A instalação permanece suspensa até encerrar as divergências de orientação/mensagem e todas as verificações deste saldo**, com aceitação do responsável. Dependências jurídicas ou funcionalidades futuras permanecem fora deste saldo de apresentação/continuidade.
|
||||
|
||||
<!-- EXECUCAO-NAVEGADOR-QA-20261115 -->
|
||||
### Execução técnica do saldo — Playwright local
|
||||
|
||||
Executante: Codex, autenticação normal com contas sintéticas, exclusivamente em `http://127.0.0.3:18715` e na base `investor_intent_20261115_test`. Chromium local, controlador Playwright 1.65.1; contextos novos, sem perfil operacional, permissões novas ou controlos de segurança desactivados. Computador 1440 × 1000; móvel **emulado** 390 × 844, sem ensaio em dispositivo físico.
|
||||
|
||||
A tabela V01–V15 acima contém o resultado executado por largura. Recibos e capturas: `outputs/investor-intent-20261115/browser-acceptance/*-results.json` e respectivos PNG/TXT. As tentativas anteriores permanecem nos recibos; o estado apresentado usa a última execução de cada passo/largura. Não confundir erros de sincronização do ensaio com defeitos comprovados do produto.
|
||||
|
||||
Candidata: ramo `qa/public-context-20261115`, base Git `8c6ed625`. O delta QA e este relatório identificam a revisão preparada para apreciação. Provas iniciais no build `assisted-mobile`; correcções de mensagem em `acceptance-corrections`; build actualmente servido `build-qa-opportunities/acceptance-labels`, manifesto SHA256 `c0c8eb36c0b531613367d4c1c154aa59ab154289b0e459ef57393a3cd3ed8790`. Os recibos posteriores também identificam os assets usados. Nenhuma instalação no activo.
|
||||
|
||||
Correcções delimitadas: apresentação de aviso histórico da preparação da empresa sem modificar a definição guardada; erro de leitura do rascunho distingue limite de pedidos/sessão/servidor de edição concorrente, preservando o bloqueio de escrita; comparação demográfica usa o selector pesquisável existente com distrito dependente da província, preservando quatro locais; origem territorial da demografia recupera a hierarquia no editor sem substituir localização guardada; referência técnica do questionário conservada num detalhe fechado do resumo. Regressão territorial dirigida: 1 teste/33 asserções; selector: 1 teste; aviso empresarial: 7 testes. Tipos, lint, PHPStan dirigido e compilação passaram. As provas técnicas aceites anteriores não foram repetidas por rotina.
|
||||
|
||||
Saldo executado: 15/15 passos aprovados nas larguras previstas. O ensaio adicional de falha de leitura `V04-recovery-error` comprovou mensagem específica, ausência de gravações durante a falha e recuperação dos valores originais. Os testes exercitam a interface real autenticada; a apreciação de negócio e a autorização de instalação continuam separadas.
|
||||
|
||||
**Saldo técnico V01–V15 encerrado nas condições indicadas; instalação não autorizada e continua suspensa.** A avaliação de negócio e a aceitação da experiência cabem ao responsável. Não equivale a aceitação integral do portal nem a teste num dispositivo móvel físico. Limitações jurídicas e futuras funcionalidades continuam fora deste saldo.
|
||||
<!-- /EXECUCAO-NAVEGADOR-QA-20261115 -->
|
||||
|
||||
## Causas e correcções
|
||||
|
||||
### Incremento da preparação assistida — evidência do anexo de 15/11/2026
|
||||
|
||||
O anexo `7a2b72ba-ccbb-4aad-a55b-3f30739e78c7/Pasted text.txt`, identificado pelo responsável como «Texto colado(7).txt», fica associado à divergência já aberta. SHA256 `489473c1e3fdc69ff7cc786dcedb33184ddd74b4a6c9fb97d99f130ae0a2e943`. O texto mostra oito etapas anteriores, empréstimo demonstrativo, tratamentos indiscriminados e códigos internos. Não se atribui esse ecrã a uma revisão exacta sem evidência da origem.
|
||||
|
||||
**Implementação desta passagem, apenas QA:** o percurso simples de investimento passa a oito ecrãs: intenção/entidade/localização; mercado; investimento inicial; financiamento; receitas/custos; tesouraria/cenários; enquadramento fiscal; resultados/próximos passos. Investimento inicial e financiamento ficam separados conforme a sequência do novo anexo; os dois primeiros ecrãs conservam a preparação contextual anterior. O modo avançado e os restantes tipos de percurso conservam as capacidades existentes, sem se presumir a sua aceitação visual por esta alteração.
|
||||
|
||||
- `simulationFieldsForSection` serve a apresentação, validação e revisão do percurso simples. Factos financeiros desconhecidos não impedem continuar uma preparação privada; cálculos continuam sujeitos às suas condições. `preparation_step` é gravado no contrato existente e recuperado com o rascunho. Mudança deliberada de percurso reinicia a navegação, conservando os valores.
|
||||
- O orçamento inicial reutiliza a aritmética decimal existente para instalações, equipamento, preparação e fundo de maneio, sem valores demonstrativos. A soma só substitui o total do cenário por escolha explícita; o intervalo original fica separado. Financiamento previsto, solicitado, aprovado e mobilizado têm campos distintos; os três primeiros não são somados ao montante mobilizado.
|
||||
- A ajuda de receitas/custos exige escolher o modelo. Hotel usa quartos, preço/noite, ocupação e dias anuais; Agronegócio usa unidades vendáveis, preço e ciclos anuais. São pressupostos editáveis, guardados e adoptados apenas pela acção «Usar». Custos incompletos não se tornam zero. A simulação de empréstimo no percurso simples depende da pergunta «Pretende estudar um empréstimo neste cenário?».
|
||||
- A etapa de financiamento deixa de montar os componentes fiscais. O percurso simples apresenta as operações fiscais por escolha explícita; o componente de IVA preserva 32 tratamentos e o de IRPC nove operações complementares através do selector pesquisável comum «Adicionar outra operação». Retirar uma operação da análise não elimina os respectivos dados e históricos. Não se deduz aplicabilidade pelo título ou sector.
|
||||
- O IVA mensal recusa divergência entre ano fiscal e primeiro mês da projecção; mantém a cobertura documentada de 2026. IRPC normal e ISPC trimestral sinalizam divergência entre o ano do enquadramento e o da preparação; a correspondência exige escolha explícita e os validadores de cobertura mantêm-se. A estimativa anual de IRPC não oferece o recorte de 2026 para outro ano. Nenhum ano é alterado automaticamente.
|
||||
- O histórico distingue rascunho guardado de simulação calculada e guardada. O retorno ao dossier identifica «pressupostos financeiros», em consonância com o tipo de evidência existente. O resultado preserva uma selecção dos pressupostos económicos autorizados, orçamento discriminado e modelo de receitas/custos para o relatório privado, sem copiar identidade ou outros campos pessoais para essa selecção. Filtragem por dossier/oportunidade e exportadores Word/impressão existentes são conservados.
|
||||
- Códigos do desenvolvimento retirados dos títulos afectados de importações, apuramento de aquisições e estimativa anual; fontes detalhadas de importação ficam no componente comum de evidência. Não se declara revisto todo o texto de todas as operações avançadas.
|
||||
|
||||
**Estado de aceitação:** implementado e com provas dirigidas; **não verificado integralmente na interface**. Os testes dos controlos reais de orçamento, ajuda de receitas e selector fiscal usam estado/eventos React e transporte simulado; não equivalem a uma sessão de navegador. Os testes de relatório conferem pressupostos, valores desconhecidos, histórico e exclusão de dados de outra oportunidade.
|
||||
|
||||
**Retoma posterior à interrupção por Esc:** provas técnicas preservadas, sem nova execução. A prévia local foi ligada ao build assistido já compilado em `public/build-qa-opportunities/assisted-current`, conservando os assets anteriores; não houve alteração do produto nem instalação no activo nesta retoma. O controlo nativo leu `http://127.0.0.3:18715/login`; a abertura directa do dossier sintético Hotel regressou a esse login. Não foi observada a sessão autenticada que o responsável indicou ter aberto. A enumeração mantém as duas janelas Edge existentes; o Firefox está minimizado e a leitura devolveu `window is minimized; call activate_window, refresh with get_window, then retry get_window_state`. Não foram invocadas APIs não documentadas nem alteradas portas/configurações dos navegadores.
|
||||
|
||||
As tentativas de repor a vista normal não permitiram demonstrar as operações do investidor; essa frente foi interrompida sem reinícios adicionais. Foi pedido apenas o URL do painel aberto para identificar a sessão correcta, sem palavras-passe ou códigos. Não se atribui a causa ao portal, ao navegador ou ao MFA. Hotel, Agronegócio, retorno de filtros financeiros e continuidade demográfica mantêm a conferência autenticada/móvel **NÃO VERIFICADA**; a interrupção não reabre nem invalida as provas técnicas aceites.
|
||||
|
||||
**Retoma seguinte — acesso recuperado e primeiras operações reais:** foi observado o dossier sintético Hotel autenticado em `http://127.0.0.3:18715/investimentos/6bdc2ac6-2a40-497c-831d-31c9c08372ed`. Pela interface foi pesquisada a «Empresa hoteleira sintética QA», seleccionada e guardada a associação; o resumo do dossier passou a mostrar essa empresa. A acção «Continuar a viabilidade» abriu o simulador do mesmo dossier. Foram observados título, actividade, sector, hierarquia Matola Rio–Sede/Boane/Maputo Província e intervalo de 1–5 milhões MZN recuperados, sem anúncio associado. Foram preenchidos uma descrição sintética e o idioma e utilizada a acção Continuar para chegar a Mercado. As capturas nativas disponíveis na conversa demonstram este recorte em computador, não o percurso integral ou a utilização móvel.
|
||||
|
||||
A conferência identificou duas divergências concretas antes do fecho: a navegação focava o cabeçalho geral, afastando as perguntas da etapa; orçamento, parcerias/apoio, contexto e histórico acumulavam-se antes delas. Aplicada correcção localizada em `simulation-form.tsx`: foco no título da etapa com margem para o menu fixo; apresentação progressiva dos blocos acessórios, mantendo os componentes montados, as ligações e os erros de contexto visíveis; ajuda aberta quando uma resposta da etapa é «Não sei». Tipos e lint dirigidos aprovados; reconferência visual desta alteração permanece por executar até observação efectiva. As baterias fiscais e de persistência já aceites não foram repetidas por esta correcção de apresentação.
|
||||
|
||||
**Conferência posterior no mesmo QA — Hotel, computador e emulação móvel:** o acesso autenticado foi recuperado sem alterar a segurança. A navegação passou a focar a etapa efectiva; o recarregamento recuperou Mercado, Financiamento e Receitas e custos. «Por determinar» abriu a ajuda da etapa. Pela interface foram introduzidas instalações 1.000.000, equipamentos 500.000, preparação 200.000 e fundo de maneio 300.000 MZN; a soma de 2.000.000 MZN só foi adoptada por botão explícito. O intervalo original de 1–5 milhões permaneceu separado.
|
||||
|
||||
Foram encontrados e corrigidos três defeitos demonstráveis: (1) a calculadora conservava um campo mobilizado vazio apesar de o investimento indicar 1.000.000, e mostrava erros de ferramentas não utilizadas; agora acompanha a origem comum quando não há edição conhecida divergente, preservando conflitos reais para escolha explícita; (2) receitas/custos anuais estavam ocultos pela regra de campos avançados; agora são editáveis na etapa pertinente; (3) o retorno ao dossier confundia ausência de oportunidade em campo vazio com `null` normalizado pelo servidor. A comparação canónica passou a tratar esses vazios como equivalentes, sem equiparar desconhecido a zero nem aceitar alterações reais de montante ou oportunidade. A pesquisa fiscal inicialmente vazia passou a explicar que é necessário escolher a componente, em vez de aparentar ausência de operações.
|
||||
|
||||
Nova conferência real: investimento 2.000.000, mobilizado 1.000.000 e diferença 1.000.000 MZN coerentes após recarregar; sem erros dos grupos ocultos ou empréstimo demonstrativo. Hotel escolhido explicitamente; 10 quartos × 300 dias × 50% × 5.000 MZN gerou 7.500.000 MZN anuais, adoptados por escolha explícita. Recarregar recuperou os quatro pressupostos, fundamento e total anual. Em emulação Edge **390 × 844**, a interface autenticada apresentou uma coluna; foi editado o custo anual para 2.000.000 e usado Continuar até Tesouraria. Não é prova num aparelho físico nem aprovação móvel de todos os ecrãs. Em 2027, seleccionar IVA à taxa geral apresentou o limite de cobertura de 2026, sem mudar o ano ou calcular silenciosamente.
|
||||
|
||||
O botão de retorno, após a correcção do vazio, guardou os pressupostos no **mesmo dossier Hotel**, agora versão 6. A interface preparou e descarregou o HTML consolidado; o ficheiro efectivamente descarregado conserva descrição, empresa/contexto, intervalo, orçamento inicial, receita 7.500.000, custo 2.000.000, mobilizado 1.000.000, diferença 1.000.000 MZN e pressupostos/fundamento. Evidência local: `outputs/investor-intent-20261115/hotel-browser-report.html`. Não foi apresentado imposto calculado fora da cobertura nem aprovada a viabilidade comercial. Recibos dirigidos adicionais: `financial-source-ui.log` (5/5), `visual-followup-tests.log` (8/8), `return-fingerprint-tests.log` (8/8, baterias sobrepostas), tipos e builds incrementais. Capturas nativas disponíveis na conversa; não inventar caminhos de screenshots.
|
||||
|
||||
**Saldo desta conferência:** Hotel tem prova autenticada de associação de empresa existente, preparação/estimativa explícita, gravação, recuperação, retorno e geração do relatório, com o recorte móvel descrito. Permanecem NÃO VERIFICADOS o percurso integral com entidade por constituir, Agronegócio na interface, retorno dos filtros financeiros, continuidade demográfica autenticada e retoma após nova autenticação/isolamento entre separadores. Os restantes consumidores da tabela não ficam aprovados por partilharem componentes. A candidata e as correcções continuam exclusivamente em QA, sem instalação autorizada.
|
||||
|
||||
**Agronegócio e consultas — continuação da mesma conferência:** no dossier `bd830c95-a3bc-4342-84e2-df8e1dccb614`, seleccionada entidade por constituir; a preparação recuperou sede e actividade e guardou uma denominação sintética, continuando para o simulador. Mantiveram-se sector, hierarquia e intervalo de 1–5 milhões MZN, sem anúncio/zona obrigatórios. O modelo agrícola, escolhido explicitamente, conservou 20.000 unidades × 50 MZN × 2 ciclos = 2.000.000 anuais após recarregar, sem os valores do Hotel. Foram guardados pressupostos no mesmo dossier após conferir Financiamento, deixando total/mobilizado desconhecidos: o intervalo não foi convertido num montante único. A tentativa de retorno antes de percorrer Financiamento expôs a mensagem pouco orientadora «Guarde primeiro as entradas da ferramenta financeira»; permanece divergência de orientação, não uma perda de dados ou autorização para dispensar o contrato do servidor.
|
||||
|
||||
Para provas positivas de consulta, acrescentados apenas à base isolada três registos financeiros e duas observações distritais **claramente sintéticos**, com recibo `outputs/investor-intent-20261115/consultation-fixtures.json`; nenhuma conta recebeu permissões persistentes, nenhuma instituição operacional foi publicada ou alterada. A consulta autenticada Banca → Banco comercial, presença física Boane e âmbito documentado apresentou apenas o banco, excluindo corretora/microsseguradora sintéticas. A ligação ao detalhe conserva os filtros na URL de retorno. Pela interface foram escolhidos necessidade Investimento/equipamento e produto, confirmada a conservação privada e aberto o mesmo dossier: instituição, versão consultada 1, produto, categoria e tipo recuperados. O clique efectivo de retorno à lista, combinações vazias/inválidas e a conferência móvel financeira ainda não ficam aprovados por esta prova.
|
||||
|
||||
No dossier agrícola foi aberta «Demografia na análise de viabilidade» → «Consultar indicadores do ano actual». Apresentados 12.345 habitantes sintéticos, fonte/2026/projecção e **Boane QA — Distrito**, com aviso explícito de contexto administrativo mais amplo, que não representa a população da localidade. Estrutura etária/rural ausente continuou «Sem dados»; não foram inventados clientes ou rentabilidade. A consulta completa, evolução temporal, continuidade por nova ideia e versão móvel autenticada continuam abertas. Também foi identificada linguagem interna sobre «sete exemplares/complemento» na preparação da empresa, ainda por corrigir no âmbito de apresentação. Estas constatações não encerram a cobertura transversal.
|
||||
|
||||
**Prévia autenticada preparada:** servidor de desenvolvimento local em `http://127.0.0.3:18715`, exclusivamente com a base `investor_intent_20261115_test`, guarda de identidade da base e conta/dossiers sintéticos sem novas permissões. O host e cookie próprios separam a sessão das outras prévias locais. Não é instalação na homologação. Não desactivar autenticação, MFA ou avisos do navegador para continuar.
|
||||
|
||||
Para a conferência pendente, usar os dossiers sintéticos do Hotel e Agronegócio preparados nessa base: associar empresa existente ou preparar entidade por constituir; confirmar contexto; preencher só pressupostos conhecidos; adoptar orçamento e estimativa; guardar na etapa de receitas; recarregar e retomar a mesma etapa; escolher operações fiscais e testar 2027 sem substituição por 2026; guardar pressupostos no dossier e gerar relatório; repetir em largura móvel. Conferir também lista/detalhe/retorno de fundos e demografia/âmbito/continuar ideia. As quatro linhas da matriz mantêm a aceitação integral aberta até essas provas, sem apagar as provas anteriores ou transformar a prévia em instalação autorizada.
|
||||
|
||||
- Proveniência apresentada como conteúdo principal: componente partilhado `EvidenceDetails` para consulta progressiva, mantendo referências, exemplares e hashes no detalhe. Limitações de utilização e períodos aplicáveis permanecem junto do conteúdo afectado.
|
||||
- Retorno ao catálogo aceitava qualquer parâmetro e podia transportar critérios de outra família: lista explícita por destino, preservação da página válida, múltiplas facetas e alterações deliberadas no destino. Mudar/limpar um nível territorial não recupera descendentes incompatíveis. Não usa armazenamento global nem transfere contexto privado em `catalogue_query`. Menus de consulta não transportam o identificador de dossier para biblioteca, legislação ou outras famílias sem aplicação.
|
||||
- A reutilização do componente de interesse podia escrever o formulário anterior na chave de outra oportunidade: estado associado à chave do recurso, preservando os formatos anteriores, as edições deliberadas, a autenticação normal e o funcionamento com armazenamento bloqueado.
|
||||
- O resumo de dossier podia adoptar a escolha efectuada noutro separador: pista por conta em `sessionStorage`, sempre confrontada com a lista autorizada recebida do servidor. Um URL explícito prevalece. Um novo separador sem escolha continua a usar a preferência existente. Uma mudança deliberada recupera a versão actual do servidor antes da escrita normal com controlo de concorrência. Não altera a autoridade do servidor nem os dados do dossier.
|
||||
- A consulta demográfica podia mostrar a localização anterior e aceitar uma resposta tardia: estado isolado pela localização, cancelamento da consulta e rejeição da resposta após desmontagem. A página de comparação identifica a consulta pelos filtros recebidos do servidor.
|
||||
|
||||
## Cobertura demonstrada e limites por família
|
||||
|
||||
| Família / consumidores | Alteração verificável | Evidência / excepções |
|
||||
| --- | --- | --- |
|
||||
| Catálogo, pesquisa, carteira e zonas | Retorno por família; filtros explícitos, página, facetas, contexto territorial; explicação do estado sem anúncios | Testes de URLs e navegação. Estado vazio distingue anúncios de empresas, recursos e potencial. Não altera o motor de pesquisa nem incorpora os deltas concorrentes de `FederatedSearch` da pasta principal. |
|
||||
| Localização e demografia, incluindo consulta no catálogo/dossier | Síntese dos totais mais recentes **dentro do período consultado e de cada fonte**; ano, unidade e tipo junto do valor; dimensões, original, ficheiro e hash recuperáveis no detalhe | Renderização real dos componentes e teste de resposta tardia. Não soma faixas etárias, não combina fontes ou tipos estatísticos, não preenche anos ausentes nem infere procura. A síntese conserva advertências e unidades ausentes. **Comparação com `21ac7eb` pendente**, pois o objecto e o bundle não estão disponíveis localmente; não houve cherry-pick dessa candidata. |
|
||||
| Sectores, Mineração/Energia, âncoras e clusters | Estado sem anúncios explicado; fontes territoriais em detalhe; campos vazios da análise de competitividade omitidos da apresentação | Renderização e testes de filtros de recursos, localização e continuidade no dossier, incluindo Energia e Mineração. Não reescreve descrições editoriais existentes nem altera geometrias, contratos ou relações. |
|
||||
| Biblioteca e legislação | Identificação/fonte em detalhe; sem bloco de entidade desconhecida; período de aplicação e aviso de utilização visíveis; acções documentais conservadas | Renderização do consumidor comum e regressão dos filtros de biblioteca/legislação. Não altera decisões jurídicas, disponibilização ou acesso aos ficheiros. |
|
||||
| Dossier, manifestações de interesse e simulador | Escolha por separador/conta, rascunho por oportunidade; fonte técnica do Modelo A em detalhe; cálculos e reutilização preservados | Integração do provider real com transporte simulado, testes de recuperação e autenticação, herança e regressões de Modelo A. Não representa conferência autenticada integral num navegador nem entrega real de email. |
|
||||
|
||||
Estas provas cobrem componentes e consumidores identificados, não todos os ecrãs ou todas as combinações de módulos. A distinção entre oferta publicada, empresas existentes, indicadores e hipóteses é preservada; não se utiliza ausência de anúncios como prova de ausência de oferta empresarial ou viabilidade.
|
||||
|
||||
## Verificação
|
||||
|
||||
Recibos em `outputs/public-context-20261115/`:
|
||||
|
||||
- `frontend.xml`: 82 testes, zero falhas, erros ou omissões; inclui componentes renderizados, pesquisa/navegação, biblioteca, recursos sectoriais, interesses, contexto e Modelo A.
|
||||
- `navigation-context.xml`: 1 teste de integração do provider, com contexto por separador, recarregamento, URL explícito e versão concorrente do servidor. Dados exclusivamente sintéticos; transporte simulado.
|
||||
- `types.log`: `tsc --noEmit`, aprovado.
|
||||
- `lint.log`: lint dirigido a todos os ficheiros de produto/teste alterados, aprovado sem avisos.
|
||||
- `build.log`: compilação QA aprovada. Aviso do plugin de fontes sobre a dependência opcional `fontaine`, com configuração já existente; não foi instalada nem alterada qualquer dependência para o eliminar.
|
||||
|
||||
A skill de controlo Windows foi tentada sem reiniciar aplicações. A enumeração devolveu **`Computer Use native pipe is unavailable: failed to connect native pipe: O sistema não conseguiu localizar o ficheiro especificado. (os error 2)`**. Não existem screenshots aceites. Apresentação móvel, foco real, ausência de sobreposição e utilização autenticada destes deltas estão **NÃO VERIFICADOS**. Classes responsivas e testes de renderização não substituem essa conferência.
|
||||
|
||||
Conferência manual quando houver prévia da candidata: catálogo → detalhe → voltar, incluindo alteração explícita de província; demografia com duas localizações/períodos e retorno; sector/âncora/cluster com e sem anúncios; biblioteca/legislação com aviso/período; dois dossiers em separadores distintos e recuperação de um interesse. Repetir em computador e janela de 390 × 844, verificando teclado, detalhes, tabelas e botões. Não utilizar a prévia das Ofertas como prova desta candidata: conserva o seu código anterior.
|
||||
|
||||
## Compatibilidade e entrega
|
||||
|
||||
Pacote Git com delta exclusivo sobre `42fba8ba`, testes e documentação. O manifesto indica SHA, pré-requisito e intersecção de caminhos com as alterações concorrentes detectadas na pasta principal. **Não aplicar uma substituição de pastas nem fazer push para `main`**. Integrar o delta revisto, preservando o trabalho concorrente e as actualizações da matriz/manual. O pacote não inclui credenciais, sessões, dados operacionais, dependências ou uma nova importação demográfica.
|
||||
|
||||
As linhas existentes RF-MN-010, RF-GEO-009, INE-DEMO-01, MASTER-471012ab-0017 e M2-d0c06a75-0055 conservam o estado e o saldo anteriores; acrescenta-se apenas esta cobertura verificada. A candidata `21ac7eb`, os deltas concorrentes da pesquisa e a aceitação visual não são declarados integrados ou concluídos.
|
||||
|
||||
O saldo acima corresponde à entrega `8806312f`. A actualização abaixo regista a reconciliação posterior; os recibos anteriores conservam-se como histórico. Nenhuma instalação está autorizada por esta entrega.
|
||||
|
||||
## Reconciliação do bundle `21ac7eb` com `8806312f`
|
||||
|
||||
O exemplar `\\Mac\Home\Downloads\demografia-leitura-21ac7eb.bundle` foi efectivamente recebido e verificado pelo Git. Contém `21ac7eb4fb9c0fd7dfbbf2db7ff8d6ab56249238`, com pré-requisito `13497892`. Não se efectuou cherry-pick integral. O hash do transporte e os recibos desta passagem ficam em `outputs/demography-reconciliation-20261115/`.
|
||||
|
||||
| Parte da candidata recebida | Decisão e resultado |
|
||||
| --- | --- |
|
||||
| Síntese demográfica | A apresentação progressiva e os indicadores originais de `8806312f` foram preservados. Acrescentou-se uma síntese de população por fonte/edição, sem repetir o total nos cartões dos restantes indicadores. |
|
||||
| Evolução temporal | Incorporado o helper de apresentação: extremos exactos do período escolhido, mesma unidade e tipo estatístico; diferença absoluta e percentual **do período**, nunca taxa anual. Anos intermédios ausentes permanecem «Sem dados». |
|
||||
| Distribuição etária e rural | Incorporados os grupos indicados apenas quando existem todas as parcelas únicas e compatíveis. Percentagens rural/urbana exigem reconciliação com o total. Unidades desconhecidas, duplicações, tipos diferentes e parcelas ausentes não geram percentagens inventadas. São derivações para leitura, sem escrita sobre os valores originais ou cálculos fiscais. |
|
||||
| Interpretação | Incorporadas orientações ligadas aos valores apresentados: verificar acessos/custos/serviços, capacidade instalada e rendimento; a população em idade activa não demonstra disponibilidade de trabalhadores. Não se deduz procura, rentabilidade ou lacuna de mercado. |
|
||||
| Fontes, decimais e versões | Conservado o componente comum `EvidenceDetails`, tabela dos originais, hash, unidades, advertências e múltiplas fontes separadas. Não foram alterados lotes, dados, documentos ou geometrias. |
|
||||
| Catálogo | Aproveitada a separação explícita entre estudo territorial e filtros comerciais, com os destinos existentes. Não se duplicou o aviso de ausência de anúncios já tratado pela solução comum. |
|
||||
| Continuidade da análise | Incorporada a acção de preparar ideia a partir de cada território, transportando apenas `source=territory:ID`; sem importar filtros comerciais. Conservado o isolamento por URL e separador de `8806312f`. |
|
||||
| Documentação e testes | Não se substituíram o manual nem as matrizes pelos exemplares antigos do bundle. Acrescenta-se esta actualização às referências existentes. Reutilizaram-se os testes dirigidos recebidos, adaptando apenas os imports aos componentes comuns e o carregamento ao mecanismo `compileFunction` já usado no projecto. |
|
||||
|
||||
### Prova dirigida adicional e conferência visual
|
||||
|
||||
Os testes adicionais verificam conservação dos decimais, grupos incompletos, zero, dimensões duplicadas, unidades/tipos incompatíveis, distribuições incoerentes, anos ausentes, extremos seleccionados, separação de edições, interpretação e ligação territorial. O exemplar de Báruè do bundle confirma os resultados de apresentação sem modificar os originais. Não se repetiram importações ou as baterias técnicas globais aceites.
|
||||
|
||||
A captura nativa do Edge recuperou nesta passagem; o conector de abas continua a indicar `The browser access host is unavailable`. A janela existente no portal activo, com alterações por guardar, foi preservada. Abriu-se uma janela separada para `visual-components.html`: componentes reais renderizados com CSS compilado da candidata e dados explicitamente sintéticos, sem autenticação, API operacional ou publicação.
|
||||
|
||||
Foram observados em computador e em emulação móvel (390 px e 360 × 844): cartões em uma coluna, leitura da variação temporal, abertura da série anual, ano ausente como «Sem dados» e recuperação do detalhe de fontes/originais. A primeira captura móvel detectou palavras comprimidas na tabela original; foi aplicada largura mínima com deslocamento interno, seguida de nova conferência. As capturas são evidência da **prévia de componentes**, não de aceitação autenticada integral ou de utilização num telefone físico.
|
||||
|
||||
Continuam pendentes a conferência autenticada dos percursos completos e a aceitação do responsável. Sem instalação no activo, sem alteração do esquema ou de permissões e sem envio externo. A pendência de obter/comparar o bundle fica encerrada por esta reconciliação selectiva.
|
||||
|
||||
|
||||
## 2026-11-15 — localização nas instituições financeiras (AUD-FUND-01)
|
||||
|
||||
Base conferida: bd000d04. Na homologação, os selectores de província/distrito/posto/localidade existem. A pesquisa por presença física em Tete com inclusão de desconhecidos devolveu 140 resultados; os primeiros cartões não mostravam moradas nem assinalavam presença por confirmar. Ao seleccionar apenas âmbito documentado, o resultado mudou para instituições com presença cadastrada, incluindo Access Bank, Socremo e seguradoras. Esta observação não certifica que todos os balcões reais estejam cadastrados ou actualizados.
|
||||
|
||||
Delta preparado em ramo isolado: modo e território juntos; pesquisa depois dos critérios; modo físico começa com âmbito documentado, mantendo a escolha explícita de desconhecidos e URLs anteriores; o controlador aplica a mesma predefinição quando omitida. Cartões mostram a morada no território escolhido, sem mostrar a sede de outra província como presença local. Desconhecidos incluídos voluntariamente recebem indicação específica. O detalhe conserva todas as moradas existentes e o retorno conserva critérios. Nenhum registo, fonte ou permissão foi alterado. Cobertura de financiamento permanece distinta de presença física.
|
||||
|
||||
Verificação: 10 testes frontend aprovados (3 novos), incluindo renderização dos componentes reais, critérios dependentes, retorno explícito de desconhecidos e preservação do detalhe; lint dirigido e git diff --check aprovados. Teste HTTP acrescentado a FundingCriteriaCoherenceTest, não executado neste ambiente sem PHP/PostgreSQL. TypeScript global executado mas bloqueado pela ausência de módulos routes/actions gerados; sem diagnósticos nos ficheiros funding alterados. Não foi executado build global nem conferência visual da candidata. A observação visual refere-se apenas ao activo anterior.
|
||||
|
||||
Entrega: patch e bundle a produzir a partir de bd000d04; sem push autenticado ou instalação nesta sessão. Antes de instalar, executar o teste HTTP na base QA isolada já definida no teste, gerar routes/actions, concluir tipos/build e conferir a candidata em computador e móvel. Não repetir testes fiscais ou importar dados para esta correcção.
|
||||
|
||||
|
||||
## 15/11/2026 - AUD-FUND-01: bundle afa02559 verificado em QA
|
||||
|
||||
Bundle integro, base bd000d04 e delta de produto preservado sem recriacao. Ramo isolado qa/funding-location-bundle-20261115; recibos e matriz posteriores preservados por integracao dos commits documentais c4aa3ac5/25d18f51. O trabalho sectorial permanece noutro ramo QA, sem entrar nesta candidata.
|
||||
|
||||
Provas executadas: 10 testes frontend aprovados; suite HTTP FundingCriteriaCoherenceTest com 5 testes/138 assercoes aprovados, incluindo a predefinicao documentada; geracao Wayfinder normal, tipos e compilacao aprovados. Navegador real em computador 1440px e emulacao movel 390px: pesquisa por provincia com 2 correspondencias, distrito com 1; morada do balcao local no cartao, sem apresentar sede de outra provincia como presenca local; detalhe conserva ambas as moradas; regresso recupera todos os criterios escolhidos (campos vazios podem ser omitidos); desconhecidos apenas por escolha explicita e identificados; cobertura nacional de produto distingue-se da presenca fisica. Confirmada ausencia de extravasamento horizontal e captura final apos carregamento dos selectores. Dados exclusivamente sinteticos, sem alterar instituicoes activas.
|
||||
|
||||
Recibo: outputs/funding-location-20261115/qa-verified.json. Instalacao autorizada pela Tempo depois destas verificacoes; backup fresco iniciado em janela reservada, restauro isolado em curso. Nao presume instalacao, novo cadastro, permissao, publicacao Ofertas ou alteracao em producao.
|
||||
|
||||
|
||||
## 15/11/2026 - AUD-FUND-01 instalado em 44c3436b
|
||||
|
||||
Revisao instalada e servida: **44c3436b19af630e4f0ff3aa04161d63b3ccab22**, em https://teste-investidor.tempo.co.mz/fundos. Contem exactamente o delta de produto do bundle afa02559, mais reconciliacao documental; preserva recibos posteriores e exclui o desenvolvimento sectorial ainda em QA. Ofertas e dashboard preservados. Main avancou por fast-forward, sem force push. Executor verified_complete; watcher restabelecido, sem pedidos pendentes e servicos activos.
|
||||
|
||||
Backup/restauro fresco: 219 tabelas com contagens/checksums iguais e 417 ficheiros restaurados/conferidos; 12 229 ficheiros de codigo anterior arquivados para reversao. Conferencia posterior: dados de negocio e ficheiros inalterados; apenas cache, sessoes e contadores tecnicos reconciliados. Nenhuma sessao anterior removida. Sem migracoes operacionais, alteracao de permissoes, envio de notificacoes, activacao publica Ofertas ou producao. Sem necessidade de reversao. A expiracao SSH foi resolvida por autenticacao normal e reconciliacao do pedido, sem repetir instalacao.
|
||||
|
||||
Executor: estrutura 1/3106, unitarios 132/611, frontend **1969/1969**, tipos/Wayfinder/build aprovados. 35 verificacoes HTTP comuns aprovadas. Verificacao adicional no destino, por presenca fisica em Tete: **8 resultados documentados**; os 8 tinham pontos correspondentes ao territorio. A escolha explicita de desconhecidos devolveu **140**, sem os converter em presenca confirmada. O distrito consultado sem presenca documentada devolveu zero; nao se presumiram balcoes. O detalhe preservou os criterios territoriais. Os percursos positivos de provincia/distrito, moradas, desconhecidos e retorno foram demonstrados com dados sinteticos em computador e emulacao movel.
|
||||
|
||||
Recibos: outputs/funding-location-20261115/installation-verified.json e qa-verified.json. Conteudo das instituicoes, fontes e cobertura existentes nao foram modificados. Disponibilidade ou condicoes reais permanecem as que constam das respectivas fontes. Este fecho cobre AUD-FUND-01; nao encerra o portal, Ofertas ou a candidata proactiva dos cinco sectores.
|
||||
|
||||
|
||||
## Extensão sectorial conjunta — QA, 15/11/2026
|
||||
|
||||
Os conteúdos completos de Turismo, Agronegócio, Infra-estruturas, Mineração e Energia passam a sustentar hipóteses no dossier existente. Foram lidos 16 artigos, incluindo os onze regionais de Turismo e 793 parágrafos/itens; os originais, identificadores e documentos associados permanecem nos serviços existentes. Cada hipótese aponta para um trecho exacto e edição. Informação provincial não é atribuída a um distrito; um projecto citado não é apresentado como participação aberta. Não se criam anúncios nem catálogos paralelos.
|
||||
|
||||
| Percurso | Computador 1440 px | Janela móvel 390 px | Resultado observado |
|
||||
| --- | --- | --- | --- |
|
||||
| Turismo | Aprovado | Aprovado | Contexto → hipótese → dossier → análise agregada → cenário financeiro → relatório → recuperação |
|
||||
| Agronegócio | Aprovado | Aprovado | Mesmo percurso, sem anúncio obrigatório e com intervalo 1–5 milhões MZN preservado |
|
||||
| Infra-estruturas | Aprovado | Aprovado | Mesmo percurso, com localização escolhida e fonte mantida |
|
||||
| Mineração | Aprovado | Aprovado | Mesmo percurso; referências minerais e cadeias existentes preservadas |
|
||||
| Energia | Aprovado | Aprovado | Mesmo percurso; referências energéticas existentes preservadas |
|
||||
|
||||
As provas usam autenticação normal e dados sintéticos. As dez execuções verificaram gravação, recarregamento, regresso ao mesmo dossier, diferença de financiamento calculada sobre valores explicitamente introduzidos e presença do trecho seleccionado no relatório privado. A ausência de registos surge com cobertura desconhecida; não prova ausência de concorrência. Não se deduzem clientes ou receitas da população. A consulta distrital conserva o âmbito provincial da leitura regional. A alteração ou retirada de uma fonte sinaliza revisão e mantém a conclusão anterior, sem substituir edições deliberadas.
|
||||
|
||||
Foi corrigida a integração do fundamento no relatório: os trechos sectoriais passam a integrar a secção existente de Mercado/SWOT, sem criar uma segunda secção nem suprimir SWOT. O título escolhido pelo utilizador não é substituído pela hipótese proposta. A retoma preserva a fonte, a versão, a localização e os pressupostos financeiros; decisões de empresa e associações continuam nos mecanismos existentes.
|
||||
|
||||
Verificação final: 8 testes HTTP/422 asserções, 24 testes frontend, PHPStan dirigido (zero erros), tipos, lint, formatação dos novos ficheiros PHP e frontend alterado, Wayfinder e compilação normal aprovados. O primeiro ensaio de contagem do catálogo coincidiu com a criação de outro dossier sintético pelo navegador (7 → 8); o mesmo teste passou na janela exclusiva, sem alteração ou enfraquecimento. Não se executaram testes com RefreshDatabase sobre a base utilizada pela prévia.
|
||||
|
||||
Os registos e capturas estão em `outputs/sector-context-20261115/`; `qa-verified.json` conserva resultados, revisão de código e hashes. A captura posterior à compilação verifica os cinco consumidores, alternativas do selector e fontes privadas. Emulação de viewport móvel não equivale a um telefone físico. Os ensaios demonstram o cenário financeiro declarado e a continuidade para a etapa fiscal; não certificam a viabilidade de um negócio nem reaprovam todos os tratamentos fiscais anteriormente aceites. A falta de dados para determinar um imposto continua explícita.
|
||||
|
||||
O controlo suplementar de todas as respostas HTTP terminou com falha: a consulta de idiomas devolveu 503. A causa é o tradutor externo local de QA indisponível (porta 5000 sem serviço), com controlador e configuração iguais à base instalada. As dez capturas e as duas fontes privadas foram recolhidas antes dessa asserção; os percursos em português passaram. O recibo conserva o código de saída 1 e as respostas 503, sem apresentar o probe como aprovado. Tradução permanece NÃO VERIFICADA nesta prévia; não foi alterada nem contornada.
|
||||
|
||||
Estado: extensão implementada e demonstrada em QA em português, com a ressalva externa de tradução e sem instalação desta extensão. A homologação permanece em `44c3436b`, com a correcção financeira já entregue. Ofertas, dashboard, permissões, geometrias, dados operacionais, estrutura e publicações não foram modificados por este delta. A aceitação do responsável e os restantes requisitos do legado conservam o seu estado próprio.
|
||||
|
||||
|
||||
## Instalação autorizada dos cinco sectores — d3067050, 15/11/2026
|
||||
|
||||
Estado actual: **instalado e verificado na homologação** `https://teste-investidor.tempo.co.mz`, revisão exacta `d3067050278f176e3bdc6c6bb59205c71330744d`. Esta instalação supera apenas o estado anterior «QA, sem instalação» da extensão sectorial. A correcção financeira entregue em `44c3436b` mantém-se integralmente no conjunto. Não fecha as restantes pendências do portal ou a aceitação funcional de Ofertas.
|
||||
|
||||
A autorização do responsável abrangeu esta entrega. Antes de integrar, confirmou-se a ancestralidade, ausência de concorrência, capacidade, disponibilidade dos 16 artigos existentes (edição4), backup actualizado e restauro em PostgreSQL isolado, sem rede. As 219 tabelas e os 417 ficheiros coincidiram; chaves e envelopes MFA recuperáveis. Arquivaram-se também os 12 231 ficheiros de código anteriores. A janela exclusiva e o executor recusaram qualquer revisão diferente. `main` avançou por fast-forward de `44c3436b` para `d3067050`, sem force push.
|
||||
|
||||
O executor terminou `verified_complete`: compilação, Wayfinder, tipos, plataforma, 132 testes unitários/611 asserções e 1 970 testes frontend sem falhas. Reutilizaram-se os oito testes HTTP/422 asserções e os dez percursos autenticados QA de computador/viewport móvel; não se repetiram esses percursos com contas ou dados operacionais.
|
||||
|
||||
No destino foram conferidas 35 respostas HTTP gerais, as cinco páginas sectoriais, dois assets adicionais e todos os 16 fundamentos, incluindo os onze regionais. As hipóteses apontam ao trecho da edição actual; não atribuem implantação distrital nem participação aberta. As fontes financeiras e o ficheiro do Dashboard Colaborativo coincidem com a versão anterior; os 28 ficheiros protegidos de Ofertas e a sua configuração mantêm-se. API pública, mapa e CSV de Ofertas continuam sem exposição. Em Tete, a presença física documentada mantém oito correspondências; desconhecidas entram apenas por escolha explícita. O retorno dos filtros foi preservado.
|
||||
|
||||
A comparação final confirmou todas as tabelas de negócio e os 417 ficheiros persistentes. Só mudaram cache e sessões técnicas esperadas; nenhuma sessão anterior foi removida. O observador automático foi reposto, não ficaram pedidos pendentes e nginx, PHP-FPM e fila estão activos. Sem migrações operacionais, permissões novas, envio externo, pagamentos ou instalação em produção. Não foi necessária reversão.
|
||||
|
||||
Ocorrências auxiliares: uma saída Unicode do cliente SSH foi corrigida localmente, lendo a resposta já guardada; uma consulta estática com o cliente Python padrão recebeu403, enquanto o pedido HTTP normal de navegador devolveu200. Não se repetiu a instalação nem se alteraram verificações ou configurações de segurança.
|
||||
|
||||
**Tradução continua pendente.** O503 observado no QA permanece identificado; esta entrega não aprova cobertura multilingue nem intervém no tradutor. A aceitação do responsável sobre a experiência de negócio mantém-se distinta da instalação e destas verificações técnicas.
|
||||
|
||||
Recibo final: `outputs/sector-context-20261115/installation-verified.json`. Conclusão às21:49 de15/11/2026, Africa/Johannesburg (19:49UTC). Os recibos QA e o bundle anteriores conservam-se como histórico.
|
||||
|
||||
|
||||
**Limitação preexistente de acesso que o resumo QA não explicitava:** a consulta agregada da base interna de empresas permanece exclusiva de QA. `InvestorContext::saveSupplyAggregate` exige a flag QA e `IsolatedQaDatabase::allowsSchemaChanges()`; esta última exige ambiente de testes, base `_test` e porta55441. O destino é `teste_investidor:5432`, pelo que essa consulta não foi activada. A guarda, a configuração e as permissões são iguais às de `44c3436b`. A autorização original alargou a consulta apenas em QA; a instalação actual preserva esse limite e não substitui uma decisão de acesso no destino. Os dez percursos demonstrados em QA não constituem prova de consulta agregada real na homologação. As fontes, preparação e restantes ferramentas foram instaladas; o acesso aos agregados internos permanece pendente de decisão expressa e de delta compatível. Isto é distinto da consulta pública de anúncios e da tradução. Não se declara o percurso integral da base interna concluído no activo.
|
||||
|
||||
|
||||
## Consulta empresarial protegida no dossier próprio — 15/11/2026
|
||||
|
||||
Implementada e verificada em QA, ainda sem instalação deste delta. A decisão expressa «Autorizar apenas agregados protegidos no dossier próprio» permite esta capacidade; não atribui papéis internos nem acesso às listas. A homologação de referência continua em `d3067050` até existir recibo de instalação posterior.
|
||||
|
||||
O proprietário encontra «Actividades existentes na localização» no dossier aberto. Recupera território, sector e intenção, pode comparar uma actividade publicada e guardar a análise no mesmo dossier. A escolha de comparação não altera a actividade do investimento. O histórico e o filtro são recuperados após recarregar; os dados de orçamento mantêm-se. O acesso a outro dossier e às linhas/documentos da base interna continua recusado.
|
||||
|
||||
Protecção: células fixas distrito/divisão CAE publicada, calculadas antes dos filtros; localidades recebem apenas contexto distrital. Grupos com menos de cinco identidades documentais resolvidas, conflitos, duplicações e identificadores por observação não são divulgados. Os resultados são intervalos de cinco, sem totais marginais ou datas por célula; não se recalculam intersecções arbitrárias. Dados apenas provinciais conservam esse âmbito. Não são empresas únicas certificadas; não se somam grupos. Resultados ausentes e protegidos têm a mesma representação. Fontes, períodos e cobertura desconhecida são explícitos; nomes, contactos, ficheiros e linhas originais não integram a resposta. Os controlos reduzem identificação indirecta e consultas por diferença, sem prometer anonimato matemático perante conhecimento externo ou alterações futuras das fontes.
|
||||
|
||||
Provas: 6 testes HTTP/218 asserções, 3 testes frontend, regressão sectorial 5/183, PHPStan dirigido sem erros, tipos, lint e compilação normal/Wayfinder aprovados. Dez execuções autenticadas, cinco sectores × computador/viewport móvel, demonstram consulta → gravação → recuperação no mesmo dossier, filtro e orçamento preservados, histórico e ausência de listas privadas. Emulação não equivale a dispositivo físico. A conferência detectou uma chave React repetida entre secções irmãs; a chave do agregado foi distinguida e os dez casos repetidos no código final, sem duplicação. Os primeiros erros de sincronização/locators do ensaio ficam nos artefactos locais, não são apresentados como provas aprovadas.
|
||||
|
||||
Recibo: `outputs/aggregate-supply-20261115/qa-verified.json`; capturas em `outputs/aggregate-supply-20261115/visual/`. Não há migrações, alterações RLS, novos papéis ou permissões, acesso individual/exportação, publicação de Ofertas, notificações externas ou pagamentos. A capacidade é desactivada por defeito e requer apenas a flag específica autorizada no destino; a guarda da base QA permanece inalterada. Reversão: desactivar a flag e regressar à revisão anterior, preservando os snapshots e históricos. Tradução mantém a pendência externa separada. Esta entrega não encerra requisitos globais do portal nem Ofertas.
|
||||
|
||||
|
||||
**Bloqueante confirmado no destino:** a leitura técnica autenticada encontrou apenas cinco códigos gerais publicados (`agronegocio`, `economia-azul`, `infraestruturas`, `mercado-financeiro`, `turismo`) e nenhuma divisão CAE numérica publicada. Os quatro exemplares internos têm o contrato reconhecido e existem grupos documentados não singulares, mas a classificação não é compatível com o adaptador. As dez provas usam referências publicadas sintéticas em QA; não demonstram disponibilidade da classificação no destino. O recorte original CAE A/01/011/0112/01120 está preparado em lote existente e não cobre os cinco sectores. Não se publicou esse lote nem se presumiram correspondências CAE → sectores. O servidor devolve 422 com explicação compreensível quando falta a classificação, sem gravar um resultado falso ou alterar o dossier. O teste adicional passou sem desactivar a guarda de imutabilidade das referências. Instalação suspensa, homologação/main em d3067050, sem reserva, migração, alteração de configuração ou escrita de dados. É necessário reconciliar as referências originais CAE e as correspondências sectoriais no catálogo existente e obter a respectiva validação/publicação editorial, antes de habilitar o delta. A autorização de consulta agregada não publica automaticamente outro lote de referências (AGENTS.md: «Nunca publicar automaticamente um lote»). Isto não exige nem autoriza acesso a empresas individuais. Não existe neste momento um pacote apto para instalação útil nos cinco sectores.
|
||||
|
||||
|
||||
## Reconciliação real e remoção do bloqueio de classificação — 15/11/2026
|
||||
|
||||
A instrução seguinte autorizou continuar `c8957ecb` e confirmou que divisões CAE numéricas publicadas não são um requisito universal. O bloqueio descrito acima era uma escolha de implementação, agora corrigida. O adaptador privado reutiliza o contrato existente `EconomicReferenceCatalog`, o exemplar CAE eBAU já aceite (SHA256 `83b4f120…506`) e a hierarquia SELF_ID/PARENT_ID: 1 339 nós com grupo amplo identificado, 88 grupos. Não cria outro cadastro, não insere/publica referências gerais e não altera os cinco códigos gerais publicados. Código demonstrado ou designação exacta são utilizáveis; diferenças de maiúsculas com acentos são tratadas de forma determinística, incluindo PostgreSQL com locale C.
|
||||
|
||||
Não se inventam equivalências CAE → doze sectores do portal. O sector, intenção, território e orçamento mantêm-se no dossier; o utilizador escolhe a classificação da comparação. Correspondências publicadas já utilizáveis continuam disponíveis. «HOTÉIS COM RESTAURANTE» conserva o grupo amplo Alojamento; Restaurantes conserva Restauração e similares. O resultado explicita o agrupamento amplo, sem o apresentar como contagem exclusiva do subtipo seleccionado. O enquadramento amplo de alojamento do exemplar turístico, aceite anteriormente, é reutilizado apenas para essa fonte e sem inventar subtipo. Os seus registos sem identidade resolvida continuam excluídos dos limiares de divulgação. Não se tornam empresas únicas por terem uma actividade identificada.
|
||||
|
||||
A reconciliação das observações reais separou correspondências por código, enquadramento documental amplo e ausência de classificação. Não encontrou pares concretos código/designação contraditórios na fotografia aceite; o teste de conflitos garante a sua exclusão quando existam. A ausência de classificação e as situações ambíguas não são convertidas em equivalências nem em ausência de actividade. A edição normativa do exemplar e os tipos específicos do recorte turístico continuam indeterminados. Não surgiu uma decisão editorial bloqueante para as correspondências demonstradas; não se publicou automaticamente nenhum lote.
|
||||
|
||||
Prova real: leitura técnica autenticada SSH/PostgreSQL em transacção READ ONLY, usando o compilador de classificação da candidata, geografia pública canónica e as mesmas protecções de identidade, duplicados, grupo mínimo e intervalos. Retornaram-se apenas oito células agregadas de exemplo: em Cidade de Nampula, 25–29 identidades documentais em Alojamento e 290–294 em Restauração. São intervalos documentais históricos, não empresas únicas certificadas, clientes, procura ou cobertura nacional integral. Não se devolveram linhas, nomes, contactos, documentos ou identificadores individuais. Esta leitura técnica não é apresentada como login de um investidor operacional; as permissões e a interface de proprietário foram verificadas separadamente em QA, com contas sintéticas.
|
||||
|
||||
Delta verificado: 3 testes HTTP/49 asserções e 1 teste/12 asserções para o enquadramento turístico; três testes frontend afectados, PHPStan, tipos, lint, Pint e compilação normal/Wayfinder aprovados. Quatro novas execuções autenticadas (hotéis/restaurantes × computador/390 px) demonstraram escolha por designação, gravação, recuperação, manutenção do sector e apenas intervalos protegidos. Emulação móvel, sem alegar telefone físico. Reutilizadas as provas aceites de `c8957ecb`, sem outra ronda geral. Recibos `outputs/aggregate-supply-20261115/source-reconciliation-qa.json`, `source-classification-reconciliation.json` e `real-protected-aggregates.json`.
|
||||
|
||||
Utilização: no próprio dossier aberto, «Actividades existentes na localização» → pesquisar a actividade pelos primeiros três caracteres ou código → «Consultar e guardar análise agregada». A análise, classificação e histórico são privados e recuperáveis. A escolha não substitui a actividade do investimento. Sem correspondência previamente demonstrada, pede-se a escolha da classificação em vez de presumir equivalência entre taxonomias. Grupos pequenos, conflitos e falta de identidade/classificação conservam a explicação de cobertura insuficiente, nunca «não existem empresas».
|
||||
|
||||
Estado desta passagem: candidato verificado, instalação já autorizada e ainda não executada neste registo. Prosseguir pelo executor Git com capacidade, backup/restauro frescos, pin da revisão, activação apenas de `INVESTOR_PROTECTED_SUPPLY_ENABLED` e conferência do delta. Sem migrações, novos papéis, exposição individual ou produção. Ofertas, dashboard, correcção financeira e d3067050 preservados. Tradução permanece separada.
|
||||
@@ -1,3 +1,13 @@
|
||||
## 11/11/2026 — Mineração e Energia instaladas em f2767818
|
||||
|
||||
Entrega autorizada de542ac2ff instalada na revisão `f27678187669d18ec063a01473dc8788c713448d`. A revisão inclui a correcção técnica dos hashes e dos geradores para usar os mesmos bytesJSON emWindows eGit/Linux,detectada antes de alterar a instalação;conteúdo,interface e âmbito preservados. Os sete casos nativos/166asserções voltaram a passar sobre os bytes canónicos. Pacote original preservado;pacote canónico com aplicação/reversão exactas. Recibo `outputs/sector-resource-20261111/installation.json`,conferido em2026-11-11T12:19:59.901666+00:00.
|
||||
|
||||
**Disponível:** `/sectores/mineracao` —11grupos/10áreas de cadeia de valor/6projectos de referência; `/sectores/energia-especifica` —7segmentos/11áreas/10projectos/24fontes ligadas. Localização e grupo/segmento → área → dossier novo ou existente → gravação/recuperação → evidência paraSWOT. As duas referências coexistem no mesmo dossier sem substituir escolhas. Estados,períodos,divergências e locais por definir preservados;sem criar direitos,coordenadas,ofertas ou projectos reais.
|
||||
|
||||
**Instalação conferida:** backup consistente e restauro isolado190tabelas;369ficheiros restaurados e conferidos porhash;22ficheiros da entrega idênticos aoGit;revisão e nove entradasHTTP200,incluindo as duas páginas sectoriais. Configuração intacta,zero migrações/importações. Nove tabelas protegidas com totais/checksums idênticos ao backup,incluindo instituições/versões/interesses,dossiers,simulações,educação,oportunidades e sectores;270instituições publicadas preservadas.
|
||||
|
||||
**Saldo:** implementação e instalação deste recorte encerradas;conferência visual permanece pendente. Ofertas concretas,implantação mais precisa e dados adicionais dependem do respectivo investimento,não se presumem das referências. Restantes módulos e resíduos fiscaisL1–L7,L8,L9–L16 mantêm o saldo anterior;portal integralmente concluído não declarado.
|
||||
|
||||
## 11/11/2026 — Energia incorporada pelo mesmo percurso de Mineração, em QA
|
||||
|
||||
**Implementação:** o sector existente `/sectores/energia-especifica` passa a apresentar o documento fornecido com7segmentos,11áreas de cadeia de valor,10projectos de referência,4riscos e24fontes com as ligações originais. Gás/upstream/construção/midstream/industrialização/mercado final,redes/hídrica,solar/baterias/eólica,hidrogénio,biocombustíveis e parques verdes mantêm o seu contexto. As três centrais solares aparecem uma vez cada,com capacidade,promotores,financiamento e estado referidos. Metoro conserva56milhõesUSD e47,3milhõesEUR,atribuídos às fontes,sem conversão ou escolha silenciosa. Previsão,operação,desenvolvimento,estudo e proposta não são tratados como estados equivalentes.
|
||||
|
||||
File diff suppressed because one or more lines are too long
@@ -0,0 +1,70 @@
|
||||
# Ofertas — auditoria final antes da instalação
|
||||
|
||||
14/11/2026. Candidata auditada: `528a2597`. Auditoria exclusiva em QA, por instrução da Tempo. Nenhuma instalação, activação pública, migração operacional ou alteração funcional realizada nesta passagem.
|
||||
|
||||
**Decisão: aprovação técnica parcial com ressalvas; aceitação integral bloqueada.** As provas das cinco fases são válidas para os comportamentos que demonstram. Não demonstram uma publicação operacional nem a continuidade completa Oferta → dossier → viabilidade territorial. Foi reproduzida uma perda de reutilização da descrição nessa fronteira.
|
||||
|
||||
**Actualização posterior à auditoria `ed2fd86f`:** a correcção autorizada em QA está documentada em [Ofertas → Investimento](ofertas-correcao-contexto-qa-20261114.md). O saldo actualizado nas linhas abaixo substitui apenas o estado desses critérios; conserva-se a prova original da falha. O percurso controlado com hipóteses de localização e relatório foi demonstrado; publicação operacional e restantes dependências não foram activadas.
|
||||
|
||||
**Preparação final após aceitação técnica expressa de `9a014268`:** [parecer de homologação privada](ofertas-prontidao-homologacao-20261114.md). Integridade das fases/correcção reconfirmada por 48 hashes; bundle local verificado. Aprovação técnica em QA aceite; instalação ainda não autorizada/executada, condicionada à conferência real do destino e backup/restauro actual. Publicação operacional permanece bloqueada. Visual, GD/derivadas e email real são critérios de avaliação pendentes, sem invalidar a prova integrada privada aceite.
|
||||
|
||||
**Destino e salvaguarda posteriormente verificados por autorização específica:** [verificação pré-instalação](ofertas-verificacao-preinstalacao-20261114.md), **APTO COM CONDIÇÕES**. Schema/runtime compatíveis, GD/WebP do destino disponível, restauro isolado de 219 tabelas/417 ficheiros aprovado. Instalação e publicação continuam não autorizadas; a instalação exige SHA expresso e janela sem integrações concorrentes porque o executor segue o último `main`. Menus `3558647e` constituem delta QA posterior à candidata `9a014268`.
|
||||
|
||||
## Evidência e limites
|
||||
|
||||
- Confirmada a ancestralidade dos commits F1 `1f2990e4`, plano `6e302db6`, F2 `91c18573`, F3 `7691cab3`, F4 `e431de8b` e F5 `528a2597`.
|
||||
- Conferidos todos os hashes de código e provas do recibo F5, antes das alterações documentais desta auditoria: todos correspondem. O JUnit original confirma **59 testes, 780 asserções, zero erros/falhas**. Não se apresenta esta conferência como nova execução dos 59 testes.
|
||||
- Nova execução de `OpportunityManagementTest`, `OpportunitySearchTest` e `OpportunityResourcesTest`: **14 testes / 227 asserções aprovados**, na candidata, para compatibilidade com cadastro nativo, versões públicas, pesquisa/lista/mapa/exportação, geografia e recursos.
|
||||
- Novo `OfferInvestmentAcceptanceAuditTest`: **2 testes / 11 asserções; 1 aprovado e 1 falhado**. Recuperação financeira privada e isolamento na selecção de contexto passaram; reutilização da descrição falhou. A primeira execução revelou a chave ausente; a segunda tornou a observação numa asserção explícita, sem alterar o produto.
|
||||
- Base exclusiva `offers_phase1_20261114_test`, loopback:55441, utilizador de testes existente e dados sintéticos; guardas do repositório preservadas. Não se executaram suites fixadas noutra base nem se enfraqueceram as respectivas guardas.
|
||||
- Recibo: `outputs/offers-final-acceptance-20261114/receipt-verification.json`; execuções adicionais: `native-integration.xml/log` e `investment-acceptance.xml/log`, na mesma pasta. Não somar as asserções das várias passagens como medida de conclusão funcional.
|
||||
- A compilação, PHPStan, tipos e lint focado aceites são reutilizados: não se alterou código funcional. Os 61 ficheiros com formatação preexistente foram novamente comparados por caminho e conteúdo Git: todos permanecem inalterados e fora do delta das cinco fases. Prova adicional em `matrix-and-format-verification.json`; isto não constitui aprovação de formatação global. O novo teste passou na verificação sintáctica PHP e no Pint; `git diff --check` passou.
|
||||
|
||||
## Matriz final consolidada
|
||||
|
||||
| Percurso / requisito | Estado | Evidência e limite concreto |
|
||||
| --- | --- | --- |
|
||||
| F1: criação, gravação, recuperação, edição e submissão privada no cadastro existente | aprovado com ressalvas | Suite F1, 14/146; mesma identidade e etags. Conferência visual pendente. |
|
||||
| F2: submissão, revisão, rejeição fundamentada, correcção, reenvio e aprovação independente | aprovado com ressalvas | Suite F2, 11/161; decisões por snapshot, conflitos, tarefas, auditoria, autor/contribuidor sem auto-aprovação. Email real e visual pendentes. |
|
||||
| Separação aprovação/publicação e bloqueios dos percursos alternativos | aprovado | Testes F2 e barreira do modelo/consumidores; aprovação privada não publica. |
|
||||
| F3: filtros, listagem, detalhe, API, mapa e CSV | aprovado com ressalvas | Suite F3, 10/133, projecções exclusivamente sintéticas; moeda sem conversão, coordenadas administrativas. Limites 1.000 candidatos/30 territórios e visual por conferir. |
|
||||
| Publicação controlada operacional | bloqueado | Não existe publicador efectivo das Ofertas. `OfferPublicCatalogue` só aceita projecções de teste por injecção interna em base isolada. Não é uma configuração pública pronta a ligar. |
|
||||
| F4: campos de empresas/imóveis, recuperação e vínculo à versão | aprovado com ressalvas | Suite F4, 11/160; campos opcionais confirmados. Não certifica titularidade nem demonstra cálculo de rentabilidade. |
|
||||
| Seis fotografias, ficheiros, quarentena e comprovativos internos | aprovado com ressalvas | Upload/limites/autorização/scan/cifra testados; processamento e galeria com derivadas não demonstrados por ausência de GD/WebP no QA. |
|
||||
| NDA + autorização do vendedor + revogação + mudança de versão | aprovado com ressalvas | Mecanismo técnico testado com documentos sintéticos e revalidação em cada leitura. NDA aprovado real ausente; configuração nula mantém fechado. |
|
||||
| F5: retirada imediata, expiração, revalidação e reactivações | aprovado com ressalvas | Suite F5, 13/180; fronteira temporal, idempotência, ciclo novo e grants antigos recusados. Prazo definitivo ainda por decidir; não se inventou duração. |
|
||||
| Denúncias e tratamento no Dashboard, auditoria e destaques administrativos | aprovado com ressalvas | F5 cobre isolamento, fundamento cifrado, tarefas existentes, versões e responsável. Destaque só rascunho/arquivo, sem promoção/pagamentos. Visual pendente. |
|
||||
| Isolamento de utilizadores, páginas, APIs, anexos, mapas e CSV | aprovado com ressalvas | Suites F1–F5 e regressão nativa; leitura pública limitada à projecção, comprovativos internos, sem originais externos. Não equivale a teste de intrusão independente nem validação visual. |
|
||||
| Preservação da versão pública durante edição | aprovado com ressalvas | Contrato sintético de Ofertas e nova regressão nativa aprovados; não existe ainda versão pública operacional de Ofertas para demonstrar o percurso real. |
|
||||
| Escrever uma vez: recuperar a descrição no contexto de investimento | aprovado | Correcção QA específica da transformação; descrição recuperada, resumo existente e alterações deliberadas preservados, sem truncar a origem nem duplicar registos. Prova e recibo no relatório de correcção. |
|
||||
| Contexto territorial e hipóteses económicas autorizadas até à viabilidade | aprovado com ressalvas | Localização persistida até ao rascunho, custos de renda/transporte declarados pelo investidor, cálculo e comparação sensível aos custos. Valores empresariais confidenciais não são transferidos; não constitui conclusão automática sobre rentabilidade nem valida todos os cenários fiscais. |
|
||||
| Percurso controlado QA Oferta → mesmo dossier → simulação → relatório → recuperação | aprovado com ressalvas | Criação/submissão/revisão/aprovação reais no teste, projecção pública sintética isolada, referência privada autorizada, rascunho/resultados no dossier e exportadores HTML/Word existentes. Abertura pública operacional continua bloqueada e visual pendente. |
|
||||
| Restantes oportunidades, pesquisa e recursos afectados | aprovado com ressalvas | Nova regressão 14/227 passou. Não constitui declaração de ausência de defeitos em todo o portal ou em serviços externos não ensaiados. |
|
||||
| Desktop/móvel e acessibilidade funcional | não verificado | Última evidência do conector: `The browser access host is unavailable`; não foi repetido o ciclo de reinícios. HTML compilado não substitui conferência visual. |
|
||||
| Entrega real de notificações por email | não verificado | Serviço existente e permissões foram testados com transporte de teste; SMTP/fila/recepção real não ensaiados. Não foram enviados emails operacionais. |
|
||||
|
||||
## Bloqueantes e ressalvas para decisão
|
||||
|
||||
1. **Integração funcional — corrigida em QA na passagem autorizada posterior:** o teste da descrição e a prova controlada contexto/dossier/viabilidade/relatório/recuperação passaram. A projecção limita-se a campos comuns autorizados; dados económicos confidenciais não são transferidos. Moeda e custos do investimento são hipóteses explícitas, sem confundir preço de aquisição com investimento total ou dados históricos com previsão. Qualquer novo contrato de transferência confidencial continua fora desta correcção.
|
||||
2. **Publicação:** implementar e testar um publicador controlado, se autorizado em nova instrução. A aceitação do consumidor sintético não autoriza remover as barreiras existentes. Instalação privada de avaliação e abertura pública são decisões separadas.
|
||||
3. **Jurídico:** faltam exemplar/versão/referência de aprovação do NDA, tipos admissíveis de comprovativo imobiliário, política final de validade e condições/avisos aplicáveis à divulgação. Não são motivos para invalidar as provas técnicas já aceites; bloqueiam os comportamentos dependentes.
|
||||
4. **Imagens:** comprovar processamento seguro e derivadas numa instalação compatível, incluindo scan, metadados, acesso e limite de seis. Não instalar extensões nem declarar galeria pronta nesta auditoria.
|
||||
5. **Visual e correio:** realizar conferência real desktop/móvel e entrega de email autorizada em ambiente de teste. Permanecem não verificados, sem solicitar que o utilizador repita autenticações nesta passagem.
|
||||
6. **Reversão:** um retorno cego à F4 é inseguro como plano: a versão F4 de `PrivateOfferConfidentiality::approvedHash` não verifica `OfferAvailability`, enquanto a F5 o faz. Uma retirada de ciclo zero pode conservar o mesmo hash editorial. A reversão deve preservar a recusa de leitura de ofertas retiradas/expiradas e os históricos; não assumir que repor código antigo mantém as novas protecções.
|
||||
|
||||
Na auditoria original não foram corrigidas lacunas por estar autorizada exclusivamente a auditoria. A falha histórica foi conservada; a autorização posterior permitiu a correcção delimitada agora comprovada, sem alterar os restantes bloqueios.
|
||||
|
||||
## Plano de instalação controlada — não executado
|
||||
|
||||
1. **Antes de executar:** a Tempo aceitou tecnicamente a correcção `9a014268`. Para avaliação estritamente privada, existe parecer favorável condicionado e bundle local verificado; conservar NDA nulo, publicação indisponível, prazo pendente e agendamento desactivado. Conferir o destino, delta, backup/restauro e compatibilidade da reversão; obter autorização expressa para instalar. Não repetir provas aceites sem diferença que o justifique. Isto não constitui aceitação de publicação integral.
|
||||
2. **Destino e processo:** confirmar `teste-investidor.tempo.co.mz`, revisão efectivamente instalada, ramo, árvore limpa, recibo do executor Git existente e diferença exacta desde o activo. Não usar o destino antigo do guia genérico como evidência do destino actual. Não inventar comandos/identidade de executor nem retomar uma sessão SSH histórica. Esta auditoria não consultou o servidor.
|
||||
3. **Estrutura:** o delta completo `1f2990e4^..528a2597` contém **zero ficheiros de migração**. As fases reutilizam Opportunity/JSON, recursos/documentos, perfis, editorial, tarefas e auditoria. Antes de instalar, comparar em leitura o schema e o registo de migrações do destino com estas dependências. Ausência de nova migração no pacote não prova que o destino já possui todas as estruturas; qualquer falta exige plano aditivo concreto e autorização. Não executar `migrate:fresh`, seeders ou alterações a `mne`.
|
||||
4. **Cópia e ensaio:** backup consistente da base, ficheiros privados, configuração e chaves existentes sob protecção; registar revisão e manifestos sem segredos. Ensaiar restauro isolado, integridade de anexos cifrados e leitura de histórico, comparando contagens/hash e identificadores com o backup. Preservar integralmente instituições, demografia, dossiers e integrações; não presumir contagens actuais a partir de recibos antigos.
|
||||
5. **Instalação após autorização expressa:** executar apenas o manifesto revisto pelo processo Git existente; compilar com versões fixadas, preservar segredos/configuração, rever caches/workers segundo o executor aceite. Sem publicação automática, concessões de perfis, pagamento, destaque comercial ou activação do agendamento. Não copiar exemplares NDA sintéticos para configuração operacional.
|
||||
6. **Verificações posteriores:** conferir SHA/schema/delta, prontidão e logs sem segredos; acessos válidos e inválidos, recuperação de oferta e versões, ausência no catálogo nativo/público, ficheiros reservados, denúncias e tarefas, regressão dos destinos afectados. Testes de escrita apenas em contexto sintético autorizado e identificado; não submeter processos reais. Conferência desktop/móvel e, se autorizado, email de teste com destinatário controlado. Registar quem verificou, versão e resultado.
|
||||
7. **Reversão:** guardar revisão anterior e artefactos, mas condicionar reversão de código à compatibilidade com v2/v3/v4 e novas decisões operacionais. Usar uma revisão de recuperação que conserve as guardas F5; se indisponível, não abrir os percursos afectados. Não remover JSON, tarefas, denúncias, decisões ou grants para acomodar código antigo. Não restaurar indiscriminadamente a base sobre novos registos; reconciliação/restauro de dados exige decisão própria e preservação do histórico.
|
||||
8. **Aprovação separada:** apresentar resultado e recibo pós-instalação. Qualquer futura publicação efectiva requer desenvolvimento/provas e autorização próprios. Este plano não é autorização para instalar nem para activar.
|
||||
|
||||
## Resultado e próxima acção
|
||||
|
||||
Auditoria original concluída com achados; a continuidade Oferta → contexto/dossier e a prova controlada de viabilidade/relatório foram corrigidas em QA por autorização posterior. **O módulo mantém ressalvas e bloqueios de publicação operacional, jurídicos e verificações pendentes.** Próxima acção: apreciar o recibo de correcção e as dependências restantes antes de qualquer autorização de homologação. Nenhuma instalação efectuada.
|
||||
@@ -0,0 +1,72 @@
|
||||
# Ofertas → Investimento — correcção da continuidade em QA
|
||||
|
||||
14/11/2026. Base: auditoria `ed2fd86f`, preservando F1–F5 até `528a2597`. Autorização exclusiva para investigar/corrigir a continuidade e demonstrá-la em QA. Sem instalação, publicação efectiva, alterações operacionais, migrações ou intervenção em `mne`.
|
||||
|
||||
## Causa e correcção
|
||||
|
||||
A reprodução antes da alteração confirmou o resultado anterior: dois testes, um aprovado e um falhado; o contexto não tinha `project_summary`. A descrição estava correctamente persistida em `Opportunity.description`, no mesmo identificador. A autorização já permitia ao dono consultar a Oferta. A perda ocorria na **transformação/recuperação**: `InvestorContext::reference('opportunity:…')` só projectava `canonical.executive_summary` ou `summary`, enquanto a preparação privada das Ofertas escreve `description`.
|
||||
|
||||
O adaptador existente passa a usar a descrição guardada como alternativa para `project_summary`, **apenas para Ofertas privadas já autorizadas**, conservando qualquer resumo existente não vazio. O título vem dos valores correntes da mesma preparação e a referência aponta para a rota específica da Oferta. Não se criam registos, fontes, relações ou contratos paralelos. Não se trunca a descrição, não se grava uma cópia na Oportunidade e não se altera a origem ao confirmar dados no dossier.
|
||||
|
||||
O reconciliador existente continua a apresentar prévia e confirmação, com versões, hash, proveniência e preservação de edições deliberadas. O teste integrado confirma que um resumo deliberadamente alterado no dossier não é substituído numa nova prévia da mesma Oferta.
|
||||
|
||||
## Campos e confidencialidade
|
||||
|
||||
| Informação | Continuidade autorizada |
|
||||
| --- | --- |
|
||||
| Identificador/chave da Oportunidade, versão, hash, título e referência | Contrato existente `opportunity:<id>`; mesmo cadastro e dossier, sem duplicação. |
|
||||
| Descrição | Alternativa para resumo apenas no contexto privado autorizado; resumo existente prevalece. Descrição longa preservada. Não é uma autorização de divulgação pública. |
|
||||
| Referências administrativas e sector comum já cadastrado | Contratos existentes preservados; a localização do ensaio mantém o mesmo identificador até ao contexto e ao rascunho financeiro. Não se deduz cobertura, disponibilidade ou benefício fiscal. |
|
||||
| Moeda, custos e pressupostos do investimento | Declarações explícitas do investidor no percurso existente. A moeda/preço da Oferta não se convertem automaticamente em moeda/investimento total do projecto. |
|
||||
| `private_offer.business`, receitas, fluxo de caixa, preço privado, contacto, razões e comprovativos | Não são copiados pelo adaptador para o contexto, relatórios ou exportações. Os campos de sector guardados dentro da informação empresarial confidencial também não são promovidos ao sector comum por inferência. |
|
||||
| Informação pública sintética | Apenas projecção pública separada e expressamente construída no teste. A descrição privada e os valores empresariais não passam para essa projecção. |
|
||||
| Leitura por NDA e autorização do vendedor | Mantém o âmbito próprio: não concede acesso à referência privada do contexto. Novo teste confirma recusa 404 mesmo depois das duas condições satisfeitas; revogação e demais testes F4 permanecem válidos. |
|
||||
|
||||
Não se introduziu um novo percurso de transferência de dados confidenciais. Qualquer futura reutilização desses dados precisa de autorização e contrato próprios; esta correcção não alarga direitos de consulta ou exportação.
|
||||
|
||||
## Prova integrada reproduzível
|
||||
|
||||
`OfferInvestmentAcceptanceAuditTest` usa exclusivamente `offers_phase1_20261114_test`, loopback:55441, com guardas e rollback existentes. Cria Oferta de empresa e referência provincial sintéticas, grava/recupera, associa contacto autorizado, submete, efectua revisão/aprovação por outra conta e conserva `status=draft`/`published_at=null`.
|
||||
|
||||
O mesmo teste comprova catálogo normal vazio e injecta `OfferPublicCatalogue(true)` exclusivamente no contentor do teste, sujeito à guarda real da base isolada. A projecção aprovada/publicada sintética tem resumo público próprio; não se altera qualquer interruptor de publicação operacional. A referência privada continua sujeita a `PortalProfileAccess`.
|
||||
|
||||
O dono selecciona a mesma Oportunidade num dossier, confere a prévia e confirma. Descrição e referência provincial chegam ao prefill existente do simulador. O investidor declara moeda e pressupostos de renda/transporte para esse local; guarda o rascunho financeiro, recupera-o e devolve os resultados com confirmação da revisão do contexto. Uma nova autenticação da mesma conta recupera o mesmo dossier e rascunho; outra conta é recusada. O teste confirma uma Oportunidade e um dossier, sem duplicações.
|
||||
|
||||
O teste frontend consome o JSON produzido pela prova PHP, recupera o snapshot e executa os calculadores existentes: receita mensal sintética 10.000, renda 2.000 e transporte 1.000 produzem saldo operacional estimado de 7.000 MZN; custos alternativos expressamente declarados de 5.000 e 3.000 produzem 2.000 MZN. Custos fixos 3.000, preço unitário 100 e custo variável 50 dão ponto de equilíbrio de 60 unidades. Estas hipóteses demonstram sensibilidade aos custos do local; **não atribuem uma tarifa provincial, uma margem real da empresa ou rentabilidade garantida**. Receita histórica confidencial da Oferta não é usada como previsão.
|
||||
|
||||
O mesmo teste gera o relatório privado HTML e Word pelo exportador existente, reabre o Word e verifica descrição/localização, recuperação do snapshot e ausência dos valores confidenciais e contacto. Os artefactos são sintéticos, não documentos de negócio nem uma aceitação visual.
|
||||
|
||||
Durante a preparação da prova, a referência provincial inicial não tinha a proveniência exigida pelo catálogo público; foi corrigida apenas a fixture isolada, reutilizando o contrato de `OpportunitySearchFixture`. O pedido do simulador foi ajustado à lista de campos já aceite e à confirmação da revisão de contexto. Nenhuma guarda foi desactivada para passar o ensaio.
|
||||
|
||||
## Ficheiros e verificação
|
||||
|
||||
- Produto: `app/Services/InvestorContext.php`, projecção delimitada de descrição/título/referência.
|
||||
- Testes PHP: `OfferInvestmentAcceptanceAuditTest.php`, persistência, resumo existente, descrição longa, dossier/rascunho/resultados e isolamento; `PrivateOfferConfidentialityTest.php`, acesso por NDA sem concessão de acesso ao contexto privado.
|
||||
- Teste frontend: `tests/frontend/offer-investment-continuity.test.mjs`, cálculo com pressupostos territoriais declarados e relatório real com reabertura do Word.
|
||||
- Documentação: matriz RF-MN-003, manual e matriz final de aceitação existentes; este recibo explica a correcção sem apagar a prova histórica da falha.
|
||||
|
||||
Resultados e comandos finais: `outputs/offers-investment-continuity-20261114/qa-result.json`. Não somar passagens sobrepostas nem apresentar os 59/780 históricos como executados novamente nesta correcção.
|
||||
|
||||
| Verificação final | Resultado |
|
||||
| --- | --- |
|
||||
| Continuidade Oferta/contexto e percurso integrado | 4 testes / 62 asserções aprovados |
|
||||
| Confidencialidade, incluindo NDA sem acesso ao contexto privado | 11 / 161 aprovados |
|
||||
| Percursos existentes de investimento/dossiers | 4 / 192 aprovados |
|
||||
| Gestão nativa de Oportunidades e versão pública | 3 / 46 aprovados |
|
||||
| **Passagem PHP integrada** | **22 testes / 461 asserções; zero erros/falhas** |
|
||||
| Regressão frontend de plano financeiro e relatórios | 41 testes aprovados |
|
||||
| Prova frontend ligada ao JSON da passagem PHP final | 1 teste aprovado; HTML e Word gerados/reabertos |
|
||||
| PHPStan completo, TypeScript e Pint | Aprovados; zero erros PHPStan |
|
||||
| Lint/formatação do novo teste frontend; diferenças Git | Aprovados |
|
||||
|
||||
Comando PHP final: `php vendor/bin/phpunit tests/Feature/OfferInvestmentAcceptanceAuditTest.php tests/Feature/PrivateOfferConfidentialityTest.php tests/Feature/InvestorPathTest.php tests/Feature/OpportunityManagementTest.php --log-junit outputs/offers-investment-continuity-20261114/regression.xml`, com a configuração sintética/guardada acima. Frontend: `node --test tests/frontend/investor-dossier-report.test.mjs tests/frontend/business-financial-plan.test.mjs`, seguido de `node --test tests/frontend/offer-investment-continuity.test.mjs`. Análise: `php vendor/bin/phpstan analyse --no-progress --memory-limit=1G`, `npm.cmd run types:check`, Pint nos três ficheiros PHP e `vp fmt --check`/`vp lint` no novo teste. A compilação QA anterior é reutilizada porque não mudou código frontend do produto; os testes PHP preservaram os assets existentes.
|
||||
|
||||
## Saldo para aceitação
|
||||
|
||||
**Corrigido em QA:** descrição na fronteira Oferta/contexto, preservação de resumo e edições deliberadas, recuperação no mesmo dossier, ensaio de localização/pressupostos → cálculo → relatórios HTML/Word → recuperação, sem passagem de dados financeiros confidenciais.
|
||||
|
||||
**Mantém-se bloqueado:** publicação efectiva operacional; NDA real enquanto faltar o exemplar aprovado; decisões jurídicas/prazo definitivos identificados na auditoria. A injecção de projecção sintética não substitui esse fecho.
|
||||
|
||||
**Por verificar:** conferência visual desktop/móvel, processamento de derivadas de imagens/galeria no ambiente compatível e entrega real de email. A simulação demonstrada é uma análise controlada com hipóteses declaradas, não uma prova de todos os cenários fiscais e factores de rentabilidade do portal.
|
||||
|
||||
Nenhuma instalação efectuada ou autorizada por este recibo. A eventual instalação aguarda nova autorização expressa, com o plano de cópia/restauro e reversão compatível já documentado.
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user