oportunidades 6
tests / ci (push) Canceled after 0s

This commit is contained in:
2026-10-10 21:17:46 +02:00
parent 01405cbf8a
commit 20971d523f
126 changed files with 44362 additions and 3496 deletions
+1 -1
View File
@@ -254,7 +254,7 @@ class ImportDocumentBatch extends Command
throw new RuntimeException('File size is outside the 1 byte to 10 MiB import limit.');
}
$mime = (new \finfo(FILEINFO_MIME_TYPE))->file($path);
$allowed = ['application/pdf', 'text/plain', 'text/csv', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
$allowed = ['application/pdf', 'application/json', 'text/plain', 'text/csv', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 'image/png', 'image/jpeg', 'image/webp'];
if (! is_string($mime) || ! in_array($mime, $allowed, true)) {
throw new RuntimeException('Detected media type is not supported by the document library.');
@@ -3,9 +3,11 @@
namespace App\Http\Controllers;
use App\Services\InvestorPath;
use App\Services\LegacyContent;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Inertia\Inertia;
use Inertia\Response;
@@ -21,7 +23,20 @@ class InvestorPathController extends Controller
public function create(Request $request, InvestorPath $path): JsonResponse|RedirectResponse
{
$id = $path->create($request->user(), $request->all());
$source = $request->input('content_resource_id');
if ($source !== null) {
abort_unless(filter_var($source, FILTER_VALIDATE_INT), 422);
app(LegacyContent::class)->articleForResource((int) $source);
}
$id = DB::transaction(function () use ($path, $request, $source): string {
$id = $path->create($request->user(), $request->all());
if ($source !== null) {
$case = $path->view($request->user(), $id)['case'];
app(LegacyContent::class)->attach($request->user(), $id, ['version' => $case['version'], 'resource_id' => (int) $source]);
}
return $id;
});
return $request->expectsJson() ? response()->json(['id' => $id], 201) : redirect('/investimentos/'.$id)->with('success', 'Investimento guardado no seu dossier.');
}
@@ -0,0 +1,70 @@
<?php
namespace App\Http\Controllers;
use App\Services\InvestorPath;
use App\Services\LegacyContent;
use App\Services\VirtualDesk;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Inertia\Inertia;
use Inertia\Response;
use Symfony\Component\HttpKernel\Exception\HttpException;
class LegacyContentController extends Controller
{
public function landing(Request $request, LegacyContent $legacy, string $sectorSlug = 'agronegocio'): Response
{
$filters = $request->validate(['q' => 'nullable|string|max:120']);
$articles = $legacy->articlesForGroup($sectorSlug);
$root = config('legacy_content.groups.'.$sectorSlug.'.root');
$article = $legacy->article($root);
$q = $filters['q'] ?? '';
$articles = array_values(array_filter($articles, fn ($item) => $q === ''
|| str_contains(mb_strtolower(strip_tags($item['html'].' '.$item['title'])), mb_strtolower($q))));
$match = $articles !== [];
return Inertia::render('portal/legacy', ['article' => $article, 'articles' => $articles, 'view' => 'landing', 'query' => $q, 'match' => $match]);
}
public function article(Request $request, LegacyContent $legacy, string $legacySlug = 'agronegocio'): Response
{
return Inertia::render('portal/legacy', ['article' => $legacy->article($legacySlug), 'view' => 'article', 'contentContext' => $this->context($request)]);
}
public function start(Request $request, LegacyContent $legacy, InvestorPath $path, string $legacySlug = 'agronegocio'): Response
{
abort_unless($path->available(), 404);
$article = $legacy->article($legacySlug);
return Inertia::render('investor-path/index', ['contexts' => $path->contexts($request->user()), 'contentSource' => $article]);
}
public function attach(Request $request, string $id, LegacyContent $legacy): JsonResponse|RedirectResponse
{
$legacy->attach($request->user(), $id, $request->all());
return $request->expectsJson() ? response()->json(['saved' => true]) : redirect('/investimentos/'.$id)->with('success', 'Referência guardada no dossier.');
}
/** @return array{id: string, title: string}|null */
private function context(Request $request): ?array
{
$data = $request->validate(['context' => 'nullable|uuid']);
if (! $request->user() || empty($data['context'])) {
return null;
}
try {
$case = app(VirtualDesk::class)->case($request->user(), $data['context'], true);
return $case->closed_at ? null : ['id' => $case->id, 'title' => $case->title];
} catch (HttpException $error) {
if (! in_array($error->getStatusCode(), [403, 404], true)) {
throw $error;
}
return null; // Consultation stays public; an unauthorized private context is never returned.
}
}
}
@@ -7,6 +7,7 @@ use App\Models\Opportunity;
use App\Models\Sector;
use App\Services\InvestmentGeography;
use App\Services\OpportunityCanonicalContract;
use App\Services\OpportunityCanonicalResponse;
use App\Services\OpportunityManagement;
use App\Services\OpportunityManagementInstallation;
use App\Services\OpportunityMaturity;
@@ -126,6 +127,7 @@ class OpportunityManagementController extends Controller
'canonicalOptions' => ($record?->owner_user_id !== null || str_starts_with($request->path(), 'minhas-oportunidades')) ? app(OpportunityCanonicalContract::class)->options($request->user(), $record) : null,
'workflowState' => $record ? $access->state($record) : null,
'publicationState' => $record?->publicationPresentation(),
'canonicalResponse' => $record?->owner_user_id !== null ? app(OpportunityCanonicalResponse::class)->read($request->user(), $record) : null,
'canEditDraft' => $record ? $access->canEdit($request->user(), $record) : false,
'workflowParticipants' => $record && $record->owner_user_id !== null ? app(OpportunityProfileWorkflow::class)->participants($request->user(), $record) : ['validators' => [], 'publishers' => []],
'workflowTasks' => $record && $record->owner_user_id !== null ? app(OpportunityWorkflowTasks::class)->listing($record) : [],
@@ -151,6 +153,12 @@ class OpportunityManagementController extends Controller
return response()->json(['id' => $record->id, 'etag' => $service->etag($record), 'message' => 'Rascunho guardado no servidor. Não foi submetido, aprovado ou publicado.'], $id ? 200 : 201)->header('ETag', '"'.$service->etag($record).'"');
}
public function canonicalResponse(Request $request, int $id, OpportunityCanonicalResponse $response): JsonResponse
{
return response()->json($response->read($request->user(), Opportunity::withTrashed()->findOrFail($id)))
->header('Cache-Control', 'private, no-store');
}
public function lifecycle(Request $request, int $id, OpportunityManagement $service): JsonResponse
{
abort_unless($service->installed(), 503);
@@ -138,13 +138,20 @@ class OpportunityResourceController extends Controller
$districts = [];
foreach ($locations as $location) {
$p = $location->payload;
if (empty($p['province_id']) || empty($p['district_id']) || empty($p['role'])) {
$issues[] = 'Uma localização tem província, distrito ou papel pendente.';
$mozambican = empty($p['country_code']) || $p['country_code'] === 'MZ';
if ($mozambican && (empty($p['province_id']) || empty($p['district_id']))) {
$issues[] = 'Uma localização em Moçambique tem província ou distrito pendente.';
}
if (! empty($p['district_id'])) {
if (! $mozambican && array_filter(array_intersect_key($p, array_flip(['province_id', 'district_id', 'admin_post_id', 'locality_id'])))) {
$issues[] = 'Uma localização noutro país conserva uma seleção territorial de Moçambique incompatível; corrigir explicitamente sem converter o histórico.';
}
if (empty($p['role'])) {
$issues[] = 'Uma localização tem papel pendente.';
}
if ($mozambican && ! empty($p['district_id'])) {
$districts[$p['district_id']] = true;
}
if (! empty($p['province_id'])) {
if ($mozambican && ! empty($p['province_id'])) {
$provinces[$p['province_id']] = true;
}
if (($p['role'] ?? null) === 'other' && empty($p['role_description'])) {
@@ -164,7 +171,7 @@ class OpportunityResourceController extends Controller
$issues[] = 'Multidistrito/interprovincial exige fundamento operacional de 50–1000 caracteres.';
}
if ($locations) {
$issues[] = 'Modo preparado: '.(count($locations) > 1 ? 'multiple' : 'single').'; âmbito derivado: '.(count($provinces) > 1 ? 'interprovincial' : (count($districts) > 1 ? 'multi_district' : 'district')).'. Sem conversão de contexto em implantação.';
$issues[] = 'Modo preparado: '.(count($locations) > 1 ? 'multiple' : 'single').'; âmbito administrativo moçambicano derivado: '.(count($provinces) > 1 ? 'interprovincial' : (count($districts) > 1 ? 'multi_district' : ($districts ? 'district' : 'sem seleção moçambicana'))).'. Sem conversão de contexto em implantação.';
}
foreach (['images', 'documents'] as $kind) {
foreach ($resources[$kind] as $r) {
@@ -8,6 +8,7 @@ use App\Models\Sector;
use App\Services\CountryCatalogue;
use App\Services\IdempotencyConflict;
use App\Services\InterestSubmission;
use App\Services\LegacyContent;
use App\Services\Malware\MalwareScanner;
use App\Services\VerifiedDocumentBinary;
use App\Services\VirtualDesk;
@@ -366,7 +367,7 @@ class PortalServicesController extends Controller
public function upload(Request $request): RedirectResponse
{
$this->validateManagement($request, ['file' => ['required', 'file', 'mimetypes:application/pdf,text/plain,text/csv,image/jpeg,image/png,image/webp,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.oasis.opendocument.text', 'max:10240'],
$this->validateManagement($request, ['file' => ['required', 'file', 'mimetypes:application/pdf,text/plain,text/csv,image/jpeg,image/png,image/webp,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.oasis.opendocument.text'.(app(LegacyContent::class)->available() ? ',application/json' : ''), 'max:10240'],
'original_source' => ['nullable', 'url:https', 'max:2000'], 'issuer' => ['nullable', 'string', 'max:180']]);
$file = $request->file('file');
$checksum = hash_file('sha256', $file->getRealPath());
@@ -635,7 +636,9 @@ class PortalServicesController extends Controller
$data = $this->validateManagement($request, [
'document_id' => ['required', 'uuid'], 'title' => ['required', 'string', 'max:200'],
'description' => ['nullable', 'string', 'max:4000'], 'category' => ['required', 'string', 'max:80'],
'topic' => ['required', 'string', 'max:80'], 'document_type' => ['required', 'in:legislation,procedure,official_form,digital_adaptation,guidance_template,guide,study,reference_data,unknown'],
// QA legacy originals may have no theme (e.g. a shared image). Do not invent a sector to disclose an authorized original.
'topic' => [app(\App\Services\LegacyContent::class)->available() ? 'nullable' : 'required', 'string', 'max:80'],
'document_type' => ['required', 'in:legislation,procedure,official_form,digital_adaptation,guidance_template,guide,study,reference_data,unknown'],
'issuer' => ['nullable', 'string', 'max:180'], 'document_number' => ['nullable', 'string', 'max:120'],
'document_date' => ['nullable', 'date_format:Y-m-d'], 'source_url' => ['nullable', 'url:https', 'max:2000'],
'applicable_from' => ['nullable', 'date_format:Y-m-d'],
@@ -656,6 +659,7 @@ class PortalServicesController extends Controller
'associations.*.applicability' => ['required', 'in:required,conditional,support,optional_template,evidence'],
'associations.*.condition_text' => ['nullable', 'string', 'max:2000'], 'associations.*.basis_reference' => ['nullable', 'string', 'max:2000'],
]);
$data['topic'] = $data['topic'] ?? '';
if (! empty($data['applicable_from']) && ! empty($data['applicable_until']) && $data['applicable_until'] < $data['applicable_from']) {
throw $this->managementValidationException(['applicable_until' => 'A data final deve ser igual ou posterior à data inicial.']);
}
@@ -144,7 +144,7 @@ class VirtualDeskController extends Controller
}
}
$this->auditRead($request, 'desk_requests', $id);
$data = ['countries' => app(CountryCatalogue::class)->all(), 'request' => [...(array) $row, 'payload' => $payload, 'submitted_snapshot' => $desk->decode($row->submitted_snapshot), 'editable_fields' => json_decode($row->editable_fields ?? '[]', true)],
$data = ['countries' => app(CountryCatalogue::class)->all(), 'toolPrefill' => $desk->requestToolPrefill($request->user(), $row), 'request' => [...(array) $row, 'payload' => $payload, 'submitted_snapshot' => $desk->decode($row->submitted_snapshot), 'editable_fields' => json_decode($row->editable_fields ?? '[]', true)],
'case' => ['id' => $case->id, 'title' => $case->title], 'caseVersion' => $case->version, 'definition' => $definition, 'territoryPaths' => $territoryPaths,
'serviceSource' => json_decode(DB::table('desk_service_versions')->where('id', $row->service_version_id)->value('source'), true),
'owner' => $desk->owns($request->user(), $case), 'manager' => $request->user()->can('manage-portal'), 'analyst' => (int) $row->analyst_id === $request->user()->id,
@@ -3,6 +3,7 @@
namespace App\Http\Middleware;
use App\Services\InvestorPath;
use App\Services\LegacyContent;
use App\Services\OpportunityManagement;
use App\Services\PortalProfileAccess;
use Illuminate\Http\Request;
@@ -51,6 +52,7 @@ class HandleInertiaRequests extends Middleware
'name' => config('app.name'),
'profileAccess' => app(PortalProfileAccess::class)->navigation($request->user()),
'portalOperator' => config('portal.operator_name'),
'legacyContentEnabled' => app(LegacyContent::class)->available(),
'educationEnabled' => (bool) config('education.enabled', false),
'aiEnabled' => (bool) config('investmoz_ai.enabled', false),
'existingBusinessEnabled' => (bool) config('existing-business.enabled', false),
+1
View File
@@ -131,6 +131,7 @@ 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['code']] : null,
'results' => $results, 'requests' => $requests, 'documents' => $documents,
'content_sources' => ($owner || $manager) ? ($path['content_sources'] ?? []) : [],
'tasks' => DB::table('tasks')->where('desk_case_id', $id)
->whereNull('deleted_at')
->when(! $owner && ! $manager, fn ($q) => $q->where('assignee_user_id', $actor->id))
+246
View File
@@ -0,0 +1,246 @@
<?php
namespace App\Services;
use App\Models\Opportunity;
use App\Models\Sector;
use App\Models\User;
use DOMDocument;
use DOMElement;
use DOMNode;
use Illuminate\Database\Query\Builder;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Validator;
use Symfony\Component\HttpFoundation\BinaryFileResponse;
/** A reading adapter over the existing library, never a second content/opportunity register. */
final class LegacyContent
{
public function available(): bool
{
if (! config('portal.legacy_content_qa_enabled') || ! app()->environment('testing')
|| config('database.connections.pgsql.host') !== '127.0.0.1'
|| config('database.connections.pgsql.url') || (int) config('database.connections.pgsql.port') !== 55441) {
return false;
}
$actual = DB::selectOne('SELECT current_database() AS database, inet_server_port() AS port');
return $actual && str_ends_with($actual->database, '_test') && (int) $actual->port === 55441
&& $actual->database === config('database.connections.pgsql.database');
}
/** @return array<string, mixed> */
public function article(string $slug = 'agronegocio'): array
{
abort_unless($this->available(), 404);
$identity = config('legacy_content.articles.'.$slug);
abort_unless(is_array($identity) && ($identity['publishable'] ?? false), 404);
$row = $this->publicResources()->where('d.external_id', $identity['external_id'])->first();
abort_unless($row !== null, 404);
$binary = app(VerifiedDocumentBinary::class)->respond($row);
$bytes = $binary instanceof BinaryFileResponse ? file_get_contents($binary->getFile()->getPathname()) : $binary->getContent();
abort_unless(is_string($bytes) && strlen($bytes) <= 10485760 && hash_equals(trim($row->sha256), hash('sha256', $bytes)), 404);
try {
$source = json_decode($bytes, true, 64, JSON_THROW_ON_ERROR);
} catch (\JsonException) {
abort(404);
}
abort_unless(is_array($source) && ($source['format'] ?? '') === 'investmoz-legacy-article-v1'
&& ($source['source_url'] ?? '') === $row->source_url && $row->source_url === $identity['source_url']
&& is_string($source['content_html'] ?? null) && trim(strip_tags($source['content_html'])) !== '', 404);
foreach (['title', 'author', 'legacy_category', 'published_at', 'modified_at'] as $key) {
abort_unless(is_string($source[$key] ?? null), 404);
}
abort_unless(is_int($source['legacy_id'] ?? null), 404);
$image = $this->publicResources()->where('d.sha256', $source['image_sha256'] ?? '')->where('d.media_type', 'image/png')->first();
$sector = Sector::where('slug', $identity['sector_slug'])->where('is_active', true)->first();
// These are independently published records in the same sector, not claims of article/project linkage.
$opportunities = $sector ? Opportunity::published()->where('sector_id', $sector->id)->latest('published_at')
->limit(12)->get(['title', 'slug', 'province', 'summary']) : [];
return ['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'],
'href' => '/'.$slug, 'html' => $this->localLinks($this->sanitize($source['content_html'])),
'landing_href' => '/explorar/'.$identity['group'], 'start_href' => '/investimentos/a-partir-de/'.$slug,
'group' => config('legacy_content.groups.'.$identity['group']),
'related_articles' => $this->related($identity['group'], $slug),
'image' => $image ? ['href' => '/documentos/'.$image->resource_id.'/view', 'sha256' => trim($image->sha256),
'alt' => $slug === 'agronegocio' ? 'Campo agrícola ao pôr do sol; fotografia ilustrativa do artigo Agronegocio'
: 'Imagem ilustrativa original do artigo '.$source['title'], 'source_url' => $image->source_url] : null,
'sector' => $sector?->only(['id', 'name', 'slug']), 'opportunities' => $opportunities,
'territorial_references' => array_values(array_filter($slug === 'agronegocio' ? ['Pemba–Lichinga', 'Nacala', 'Vale do Zambeze', 'Beira', 'Limpopo', 'Maputo'] : [],
fn ($name) => str_contains(strip_tags($source['content_html']), $name))),
'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];
}
/** Resolve a library identity, preserving the already stored source URLs and versions. */
public function articleForResource(int $resourceId): array
{
abort_unless($this->available(), 404);
$externalId = $this->publicResources()->where('r.id', $resourceId)->first()?->external_id;
foreach (config('legacy_content.articles', []) as $slug => $identity) {
if ($identity['external_id'] === $externalId && $identity['publishable']) {
return $this->article($slug);
}
}
abort(422, 'Escolha um artigo disponível para consulta; a referência não foi guardada.');
}
/** @return list<array<string,mixed>> */
public function articlesForGroup(string $group): array
{
abort_unless($this->available() && is_array(config('legacy_content.groups.'.$group)), 404);
$articles = [];
foreach ($this->related($group) as $item) {
$articles[] = $this->article($item['slug']);
}
abort_unless($articles !== [], 404);
return $articles;
}
/** @return list<array<string,mixed>> */
private function related(string $group, ?string $except = null): array
{
$identities = array_filter(config('legacy_content.articles', []), fn ($identity, $slug) =>
$identity['group'] === $group && $identity['publishable'] && $slug !== $except, ARRAY_FILTER_USE_BOTH);
$resources = $this->publicResources()->whereIn('d.external_id', array_column($identities, 'external_id'))->get()->keyBy('external_id');
$result = [];
foreach ($identities as $slug => $identity) {
$row = $resources->get($identity['external_id']);
if ($row && $row->source_url === $identity['source_url']) {
$result[] = ['slug' => $slug, 'id' => (int) $row->resource_id, 'title' => $row->title, 'href' => '/'.$slug];
}
}
return $result;
}
private function localLinks(string $html): string
{
$public = $this->publicResources()->whereIn('d.external_id', array_column(config('legacy_content.articles', []), 'external_id'))
->get()->keyBy('external_id');
$links = [];
foreach (config('legacy_content.articles', []) as $slug => $identity) {
if ($identity['publishable'] && $public->get($identity['external_id'])?->source_url === $identity['source_url']) {
$links[rtrim($identity['source_url'], '/')] = '/'.$slug;
}
}
$doc = new DOMDocument;
$old = libxml_use_internal_errors(true);
try {
$doc->loadHTML('<?xml encoding="UTF-8"><html><body>'.$html.'</body></html>', LIBXML_NONET);
foreach ($doc->getElementsByTagName('a') as $anchor) {
$href = $anchor->getAttribute('href');
if (isset($links[rtrim($href, '/')])) { $anchor->setAttribute('href', $links[rtrim($href, '/')]); }
}
$body = $doc->getElementsByTagName('body')->item(0);
return $body ? implode('', array_map(fn ($child) => $doc->saveHTML($child), iterator_to_array($body->childNodes))) : '';
} finally { libxml_clear_errors(); libxml_use_internal_errors($old); }
}
/** @param array<string, mixed> $input */
public function attach(User $actor, string $caseId, array $input): void
{
$data = Validator::make($input, ['version' => 'required|integer|min:1', 'resource_id' => 'required|integer|min:1'])->validate();
$article = $this->articleForResource((int) $data['resource_id']);
abort_unless(app(InvestorPath::class)->available(), 404);
DB::transaction(function () use ($actor, $caseId, $data, $article): void {
$desk = app(VirtualDesk::class);
$case = $desk->case($actor, $caseId, true, true);
abort_if($case->closed_at, 409);
abort_unless(DB::table('investor_journeys')->where('id', $case->journey_id)->whereNotNull('path_definition_id')->whereNull('deleted_at')->exists(),
409, 'Este dossier conserva outro roteiro; não foi convertido automaticamente.');
$payload = $desk->decode($case->payload);
foreach ($payload['investor_path']['content_sources'] ?? [] as $existing) {
if ($existing['resource_id'] === $article['id'] && $existing['sha256'] === $article['sha256']) {
return; // Same source/version replay: neither another reference nor another event.
}
}
abort_unless((int) $case->version === $data['version'], 409, 'O dossier foi alterado; recupere a versão atual.');
$payload['investor_path']['content_sources'][] = ['resource_id' => $article['id'], 'document_id' => $article['document_id'],
'sha256' => $article['sha256'], 'metadata_version' => $article['version'], 'title' => $article['title'],
'source_url' => $article['source_url'], 'return_href' => $article['href'], 'actor_id' => $actor->id,
'saved_at' => now()->toIso8601String()];
DB::table('desk_cases')->where('id', $caseId)->update(['payload' => $desk->encode($payload), 'version' => $case->version + 1, 'updated_at' => now()]);
$desk->event($desk->case($actor, $caseId), $actor, 'legacy_content_referenced', ['resource_id' => $article['id'], 'sha256' => $article['sha256']]);
});
}
private function publicResources(): Builder
{
return DB::table('portal_resources as r')->join('documents as d', 'd.id', '=', 'r.document_id')
->where('r.published', true)->where('r.rights_status', 'authorized')->where('d.rights_status', 'authorized')
->where('d.status', 'active')->where('d.data_classification', 'public')->whereNull('d.deleted_at')
->where('d.malware_scan_status', 'clean')->whereColumn('d.malware_scanned_sha256', 'd.sha256')
->select(['d.*', 'r.id as resource_id', 'r.metadata_version', 'r.source_url', 'r.title']);
}
/** Allow presentation markup only. No scripts, styles, events, embeds or remote image execution. */
public function sanitize(string $html): string
{
$doc = new DOMDocument;
$old = libxml_use_internal_errors(true);
try {
$doc->loadHTML('<?xml encoding="UTF-8"><html><body>'.$html.'</body></html>', LIBXML_NONET);
$body = $doc->getElementsByTagName('body')->item(0);
// Preserve the source text and relative sections, but start the displayed
// article below the page h1. Originals and their hashes remain untouched.
$sourceLevels = [];
foreach (['h1', 'h2', 'h3', 'h4'] as $heading) {
if ($doc->getElementsByTagName($heading)->length > 0) {
$sourceLevels[] = (int) substr($heading, 1);
}
}
$headingOffset = 2 - (empty($sourceLevels) ? 2 : min($sourceLevels));
$previousHeading = 1;
$clean = function (DOMNode $node) use (&$clean, $doc, $headingOffset, &$previousHeading): void {
foreach (iterator_to_array($node->childNodes) as $child) {
if (! $child instanceof DOMElement) {
continue;
}
if (preg_match('/^h([1-4])$/i', $child->tagName, $level)) {
$displayLevel = max(2, min(6, (int) $level[1] + $headingOffset, $previousHeading + 1));
$previousHeading = $displayLevel;
$section = $doc->createElement('h'.$displayLevel);
while ($child->firstChild !== null) {
$section->appendChild($child->firstChild);
}
$node->replaceChild($section, $child);
$child = $section;
}
if (! in_array(strtolower($child->tagName), ['p', 'strong', 'b', 'em', 'i', 'ul', 'ol', 'li', 'br', 'h2', 'h3', 'h4', 'h5', 'h6', 'blockquote', 'a'], true)) {
$node->removeChild($child);
continue;
}
$href = $child->tagName === 'a' ? $child->getAttribute('href') : '';
foreach (iterator_to_array($child->attributes) as $attribute) {
$child->removeAttribute($attribute->nodeName);
}
if ($href !== '') {
if (str_starts_with($href, '/') && ! str_starts_with($href, '//')) {
$href = 'https://investemoz.tempo.co.mz'.$href;
}
if (filter_var($href, FILTER_VALIDATE_URL) && strtolower((string) parse_url($href, PHP_URL_SCHEME)) === 'https') {
$child->setAttribute('href', $href);
$child->setAttribute('rel', 'noopener noreferrer');
}
}
$clean($child);
}
};
if (! $body) {
return '';
}
$clean($body);
return implode('', array_map(fn ($child) => $doc->saveHTML($child), iterator_to_array($body->childNodes)));
} finally {
libxml_clear_errors();
libxml_use_internal_errors($old);
}
}
}
+27 -6
View File
@@ -6,6 +6,7 @@ use App\Models\Opportunity;
use App\Models\User;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Validator;
use Illuminate\Support\Str;
use Illuminate\Validation\ValidationException;
use Opis\JsonSchema\CompliantValidator;
use Opis\JsonSchema\Errors\ErrorFormatter;
@@ -29,6 +30,7 @@ class OpportunityCanonicalContract
$schema['$defs'][$name.'Create']['allOf'] = $schema['$defs'][$name]['allOf'] ?? [];
}
$schema = app(OpportunityCategoryFields::class)->enrich($schema);
$schema = app(OpportunityModularProfiles::class)->extend($schema);
$schema = $this->writeSchema($schema, $draft);
$properties = &$schema['$defs']['opportunityCreate']['properties'];
unset($properties['mutation_context']); // Actor, audit reason and revision are server-owned.
@@ -240,6 +242,14 @@ class OpportunityCanonicalContract
ksort($payload);
$snapshot = ['adapter_version' => self::VERSION, 'schema_sha256' => hash_file('sha256', resource_path('data/investmoz-opportunity-modular.schema.json')),
'payload' => $payload, 'resources' => $resources];
if (isset(OpportunityModularProfiles::PROFILES[$record->opportunity_category]) || ($payload['module_profile_version'] ?? '') === OpportunityModularProfiles::HISTORY_VERSION) {
$snapshot['qa_extension'] = ['version' => OpportunityModularProfiles::VERSION, 'profile_version' => $payload['module_profile_version'],
'functional_decision' => 'User recommendations accepted for QA, 10/10/2026; no active approval or security-holder nomination',
'gates' => $this->gates($record)];
if ($record->opportunity_category === 'other') {
$snapshot['qa_extension']['subtype'] = config('portal.opportunity_other_qa_subtypes.'.($payload['module_details']['subtype'] ?? ''), []);
}
}
$snapshot['hash'] = hash('sha256', json_encode($snapshot, JSON_THROW_ON_ERROR));
return $snapshot;
@@ -253,9 +263,7 @@ class OpportunityCanonicalContract
private function categoryRules(array $p, Opportunity $record, array $resources, array &$errors): void
{
$category = $p['opportunity_category'];
if (in_array($category, ['concession', 'financing', 'supply', 'other'], true)) {
$errors['canonical.module_profile_version'] = '§25.4: não existe perfil modular aprovado/configurado. O rascunho permanece disponível; não inventar regras.';
}
app(OpportunityModularProfiles::class)->validate($p, $resources, $errors);
foreach (['real_estate', 'land_rights', 'business_transaction'] as $module) {
$applicable = match ($module) {
'real_estate' => ['real_estate'], 'land_rights' => ['land_rights'], default => ['business_sale', 'business_partnership', 'franchise']
@@ -346,6 +354,7 @@ class OpportunityCanonicalContract
$p = $snapshot['payload'];
$errors = [];
app(OpportunityCategoryFields::class)->publication($p, $errors);
app(OpportunityModularProfiles::class)->publication($p, $errors);
foreach ($snapshot['resources']['documents'] ?? [] as $id => $document) {
if (! empty($document['payload']['valid_until']) && $document['payload']['valid_until'] < today()->toDateString()) {
$errors['documents.'.$id] = 'Documento incluído expirou; preserve o original e reveja a versão.';
@@ -400,7 +409,7 @@ class OpportunityCanonicalContract
'business_sale' => ['corporate_screening', 'financial_review', 'legal_tax_due_diligence', 'confidentiality_clearance'],
'business_partnership' => ['corporate_screening', 'financial_review', 'partnership_governance_review', 'legal_tax_due_diligence'],
'franchise' => ['brand_license_review', 'financial_review', 'franchise_legal_review', 'confidentiality_clearance'],
default => [],
default => app(OpportunityModularProfiles::class)->gates($record),
};
}
@@ -411,7 +420,17 @@ class OpportunityCanonicalContract
{
$business = isset($payload['business_transaction']) && ($payload['visibility'] ?? '') === 'public';
return ['title' => (string) ($payload['official_title'] ?? ''), 'summary' => (string) ($business ? ($payload['business_transaction']['teaser'] ?? '') : ($payload['executive_summary'] ?? '')),
$label = match ($payload['module_details']['mode'] ?? '') {
'intention_call' => 'Intenção/chamada em preparação — não é direito atribuído. ',
'awarded_right' => 'Concessão com ato competente documentado. ',
'seeking_funding' => 'Procura de financiamento. ', 'funding_offer' => 'Oferta de financiamento — sujeita a análise do beneficiário. ',
'purchase_request' => 'Pedido de compra. ', 'supply_offer' => 'Oferta de fornecimento. ', default => '',
};
if (($payload['module_details']['conditions_status'] ?? '') === 'proposed') {
$label .= 'Valores e condições propostos, sem compromisso assumido. ';
}
return ['title' => (string) ($payload['official_title'] ?? ''), 'summary' => Str::limit($label.(string) ($business ? ($payload['business_transaction']['teaser'] ?? '') : ($payload['executive_summary'] ?? '')), 499, '…'),
'description' => (string) ($business ? ($payload['business_transaction']['teaser'] ?? '') : ($payload['demand_statement'] ?? ''))];
}
@@ -427,7 +446,9 @@ class OpportunityCanonicalContract
->orWhereExists(fn ($i) => $i->selectRaw('1')->from('investor_contacts as ic')->join('investors as inv', 'inv.id', '=', 'ic.investor_id')->whereColumn('ic.contact_id', 'contacts.id')->whereIn('inv.organization_id', $orgs)->whereNull('inv.deleted_at'));
})->get(['id', 'full_name']);
return ['version' => self::VERSION, 'schema' => $this->schema(true)['$defs']['opportunityCreate'],
return ['version' => self::VERSION, 'modularProfiles' => app(OpportunityModularProfiles::class)->enabled() ? OpportunityModularProfiles::PROFILES : [],
'historyVersion' => app(OpportunityModularProfiles::class)->enabled() ? OpportunityModularProfiles::HISTORY_VERSION : null,
'schema' => $this->schema(true)['$defs']['opportunityCreate'],
'definitions' => $this->schema(true)['$defs'],
'activities' => DB::table('economic_activities')->where('status', 'published')->get(['id', 'parent_id', 'sector_id', 'label_pt_mz', 'catalog_version_id']),
'contacts' => $contacts, 'countries' => app(CountryCatalogue::class)->all(),
@@ -0,0 +1,70 @@
<?php
namespace App\Services;
use App\Models\Opportunity;
use App\Models\User;
/** Read adapter only: preserve persisted identifiers and make unresolved metadata explicit. */
class OpportunityCanonicalResponse
{
public const VERSION = 'opportunity-response-existing-ids-20261010-1';
/** @return array<string,mixed> */
public function read(User $actor, Opportunity $record): array
{
$access = app(PortalProfileAccess::class);
$access->authorize($actor, 'view', $record);
$payload = app(OpportunityManagement::class)->values($record)['canonical'] ?? [];
$context = $record->workflow_context ?? [];
$data = [...$payload, 'id' => $record->id, 'opportunity_code' => $record->reference,
'opportunity_category' => $record->opportunity_category, 'status' => $access->state($record),
'version' => (int) $record->management_version, 'is_deleted' => $record->trashed(),
'deleted_at' => $record->deleted_at?->toIso8601String()];
foreach (['submitted' => 'submission', 'approved' => 'approval', 'published' => 'publication'] as $prefix => $key) {
$data[$prefix.'_by'] = $context[$key]['actor_id'] ?? null;
$data[$prefix.'_at'] = $context[$key]['at'] ?? null;
}
$references = [];
foreach (OpportunityResources::KINDS as $kind) {
$references[$kind] = $payload[$kind] ?? [];
$rows = [];
if (app(OpportunityResources::class)->installed()) {
foreach (app(OpportunityResources::class)->listing($record->id, $kind) as $row) {
$rows[$row->id] = $row;
}
}
$data[$kind] = array_map(function (string $id) use ($rows, $kind): array {
$row = $rows[$id] ?? null;
if ($row === null) {
return ['id' => $id, 'availability' => 'unavailable'];
}
$value = [...$row->payload, 'id' => $row->id, 'version' => (int) $row->version,
'is_deleted' => $row->deleted_at !== null, 'deleted_at' => $row->deleted_at,
'created_by' => $row->created_by, 'created_at' => $row->created_at, 'updated_at' => $row->updated_at];
if ($kind !== 'locations') {
$value['original_name'] = $row->file?->file_name;
$value['mime_type'] = $row->file?->media_type;
$value['sha256'] = $row->file?->sha256;
$value['scan_recorded_status'] = $row->file?->malware_scan_status;
}
return $value;
}, $references[$kind]);
}
return ['adapter_version' => self::VERSION,
'source_schema_sha256' => hash_file('sha256', resource_path('data/investmoz-opportunity-modular.schema.json')),
'data' => $data, 'resource_references' => $references,
'validation_result' => ['scope' => 'recorded_submission_only', 'submission_hash' => $context['submission']['hash'] ?? null,
'submitted_content_revision' => $context['submission']['content_revision'] ?? null,
'current_content_revision' => $context['content_revision'] ?? 1,
'revalidated_on_read' => false, 'external_decision' => 'not_inferred'],
'publication' => $record->publicationPresentation(),
'compatibility' => ['normative_response_complete' => false, 'opportunity_actor_sector_ids' => 'existing bigint, not converted to UUID',
'opportunity_code' => 'existing reference preserved; no INV-MZ code invented',
'states' => 'existing workflow values preserved; no implicit stage equivalence',
'inline_modules' => 'management_draft canonical JSON with audited revisions; no parallel specialized tables',
'metadata_gaps' => ['completion_percentage algorithm', 'inline item IDs and mutation metadata', 'resource updated_by/deleted_by recovery']]];
}
}
+20 -1
View File
@@ -194,6 +194,15 @@ class OpportunityCategoryFields
}
if (isset($p['land_rights'])) {
$lr = $p['land_rights'];
// §27: UNIQUE (opportunity_id, cadastral_number); absent numbers remain unknown.
$cadastralNumbers = [];
foreach ($lr['parcels'] ?? [] as $i => $parcel) {
$number = $parcel['cadastral_number'] ?? null;
if ($number !== null && $number !== '') {
$fail(! in_array($number, $cadastralNumbers, true), "land_rights.parcels.$i.cadastral_number", 'Número cadastral repetido nesta oportunidade; recupere e reconcilie a parcela existente.');
$cadastralNumbers[] = $number;
}
}
if (in_array($lr['duat_status'], ['provisional', 'definitive'], true)) {
$fail(! empty($lr['issuing_authority_id']), 'land_rights.issuing_authority_id', 'DUAT provisório/definitivo exige entidade emissora.');
if (! empty($lr['duat_number']) && ! empty($lr['issuing_authority_id'])) {
@@ -220,10 +229,20 @@ class OpportunityCategoryFields
$bt = $p['business_transaction'];
$type = $bt['transaction_type'];
$allowed = match ($p['opportunity_category']) {
'business_sale' => ['full_sale', 'partial_sale'],'business_partnership' => ['partnership', 'joint_venture'],'franchise' => ['franchise'],default => []
'business_sale' => ['full_sale', 'partial_sale', 'succession'],'business_partnership' => ['partnership', 'joint_venture'],'franchise' => ['franchise'],default => []
};
$fail(in_array($type, $allowed, true), 'business_transaction.transaction_type', 'Modalidade incompatível com esta categoria.');
$years = array_column($bt['financial_periods'], 'year');
if (($bt['history_status'] ?? '') === 'no_completed_years') {
$fail(app(OpportunityModularProfiles::class)->enabled() && ($p['module_profile_version'] ?? '') === OpportunityModularProfiles::HISTORY_VERSION,
'module_profile_version', 'Ausência de histórico requer a extensão QA v2 explícita; preserve o contrato original.');
$fail($bt['available_financial_years'] === 0 && $bt['financial_periods'] === [], 'business_transaction.financial_periods', 'Não misture projeções com exercícios financeiros realizados.');
foreach (['history_declaration', 'history_declaration_document_id', 'projections'] as $field) {
$fail(! empty($bt[$field]), 'business_transaction.'.$field, 'Entidade sem exercícios completos requer declaração e projeções identificadas.');
}
} else {
$fail($bt['available_financial_years'] >= 1 && $bt['financial_periods'] !== [], 'business_transaction.financial_periods', 'Use os exercícios existentes ou a declaração versionada de ausência de histórico.');
}
$fail(count($years) >= min(3, $bt['available_financial_years']) && count($years) === count(array_unique($years)), 'business_transaction.financial_periods', 'Inclua pelo menos três exercícios quando existentes, sem repetir anos.');
foreach ($years as $i => $year) {
$fail($year <= (int) today()->format('Y'), "business_transaction.financial_periods.$i.year", 'Não apresente um exercício futuro como demonstração realizada.');
+247
View File
@@ -0,0 +1,247 @@
<?php
namespace App\Services;
use App\Models\Opportunity;
use Illuminate\Support\Facades\DB;
/** Explicit QA-only extension of the accepted contract; existing draft/resources are the storage. */
class OpportunityModularProfiles
{
public const VERSION = 'modular-qa-20261010-v1';
public const HISTORY_VERSION = 'business-history-qa-20261010-v2';
public const PROFILES = [
'concession' => 'concession-qa-20261010-v1',
'financing' => 'financing-qa-20261010-v1',
'supply' => 'supply-qa-20261010-v1',
'other' => 'other-qa-20261010-v1',
];
public function enabled(): bool
{
if (! config('portal.opportunity_modular_profiles_qa_enabled') || ! app()->environment('testing')) {
return false;
}
$connection = DB::connection();
if ($connection->getDriverName() !== 'pgsql' || (string) $connection->getConfig('port') !== '55441'
|| ! in_array($connection->getConfig('host'), ['127.0.0.1', 'localhost'], true)
|| $connection->getConfig('url') || ! str_ends_with($connection->getDatabaseName(), '_test')) {
return false;
}
$actual = $connection->selectOne('SELECT current_database() AS database, inet_server_port() AS port');
return $actual->database === $connection->getDatabaseName() && (int) $actual->port === 55441;
}
/** @param array<string,mixed> $schema
* @return array<string,mixed> */
public function extend(array $schema): array
{
if (! $this->enabled()) {
return $schema;
}
$text = ['type' => 'string', 'minLength' => 1, 'maxLength' => 2000];
$doc = ['type' => 'string', 'format' => 'uuid'];
$positive = ['type' => 'number', 'exclusiveMinimum' => 0];
$date = ['type' => 'string', 'format' => 'date'];
$properties = [
'mode' => ['enum' => ['intention_call', 'awarded_right', 'seeking_funding', 'funding_offer', 'purchase_request', 'supply_offer', 'classified_other']],
'conditions_status' => ['enum' => ['proposed', 'binding']],
'object' => $text, 'representation_document_id' => $doc, 'object_document_id' => $doc,
'terms' => $text, 'source' => $text, 'scenario' => $text, 'terms_date' => $date,
'commitment_document_id' => $doc, 'disclosure_authorization_document_id' => $doc,
'granting_entity' => $text, 'procedure_regime' => $text, 'scope' => $text,
'term_value' => $positive, 'term_unit' => ['enum' => ['days', 'months', 'years']],
'remuneration_obligations' => $text, 'participation_conditions' => $text,
'external_decision_document_id' => $doc, 'territorial_right_document_id' => $doc,
'land_required' => ['type' => 'boolean'], 'construction_required' => ['type' => 'boolean'],
'applicable_authorizations' => $text, 'construction_license_document_id' => $doc,
'start_date' => $date, 'end_date' => $date,
'instrument' => ['enum' => ['debt', 'equity', 'guarantee']],
'use_of_funds' => $text, 'disbursement_calendar' => $text, 'repayment_periodicity' => $text,
'financial_plan_document_id' => $doc, 'secured_evidence_document_id' => $doc,
'offered_capacity' => $positive, 'eligibility_criteria' => $text, 'capacity_document_id' => $doc,
'equity_percentage' => ['type' => 'number', 'exclusiveMinimum' => 0, 'maximum' => 100],
'proposed_rights' => $text, 'quantity' => $positive, 'unit' => $text, 'destination' => $text,
'acceptance_criteria' => $text, 'quotation_method' => $text, 'unit_price' => $positive, 'total_price' => $positive,
'declared_taxes' => $text, 'advance_or_guarantee' => ['type' => 'boolean'],
'subtype' => $text, 'purpose' => $text, 'recipients' => $text, 'expected_output' => $text, 'risks' => $text,
];
$schema['$defs']['opportunityCreate']['properties']['module_details'] = [
'type' => 'object', 'properties' => $properties, 'additionalProperties' => false,
];
// Opt-in v2: a declaration/projection is not a fabricated completed financial year.
$business = &$schema['$defs']['businessTransactionCreate'];
$business['properties']['available_financial_years']['minimum'] = 0;
$business['properties']['financial_periods']['minItems'] = 0;
$business['properties'] += ['history_status' => ['enum' => ['existing_accounts', 'no_completed_years']],
'history_declaration' => $text, 'history_declaration_document_id' => $doc,
'projections' => ['type' => 'object', 'properties' => ['scenario' => $text, 'source' => $text, 'date' => $date, 'document_id' => $doc],
'required' => ['scenario', 'source', 'date', 'document_id'], 'additionalProperties' => false]];
$business['allOf'][] = ['if' => ['properties' => ['history_status' => ['const' => 'no_completed_years']], 'required' => ['history_status']],
'else' => ['properties' => ['financial_periods' => ['minItems' => 1], 'available_financial_years' => ['minimum' => 1]]]];
return $schema;
}
/** @param array<string,mixed> $p
* @param array<string,mixed> $resources
* @param array<string,string> $errors */
public function validate(array $p, array $resources, array &$errors): void
{
$category = $p['opportunity_category'] ?? '';
if (! isset(self::PROFILES[$category])) {
if (isset($p['module_details'])) {
$errors['canonical.module_details'] = 'Detalhe modular incompatível com esta categoria.';
}
return;
}
if (! $this->enabled() || ($p['module_profile_version'] ?? '') !== self::PROFILES[$category]) {
$errors['canonical.module_profile_version'] = 'Use a versão QA explicitamente aprovada; versões anteriores permanecem rascunhos recuperáveis.';
return;
}
$m = $p['module_details'] ?? [];
$fail = function (bool $ok, string $path, string $message) use (&$errors): void {
if (! $ok) {
$errors['canonical.'.$path] = $message;
}
};
$require = function (array $fields) use ($m, $fail): void {
foreach ($fields as $field) {
$fail(isset($m[$field]) && $m[$field] !== '', 'module_details.'.$field, 'Preencha este campo aplicável antes de submeter.');
}
};
$require(['mode', 'object', 'representation_document_id', 'object_document_id']);
$modes = match ($category) {
'concession' => ['intention_call', 'awarded_right'], 'financing' => ['seeking_funding', 'funding_offer'],
'supply' => ['purchase_request', 'supply_offer'], default => ['classified_other'],
};
$fail(in_array($m['mode'] ?? '', $modes, true), 'module_details.mode', 'Selecione procura/oferta ou modalidade compatível com esta categoria.');
// Only references included in the current opportunity's verified resource snapshot are usable.
foreach ($m as $key => $value) {
if (str_ends_with($key, '_document_id') && $value !== null && $value !== '') {
$fail(isset($resources['documents'][$value]), 'module_details.'.$key, 'Associe documento ativo desta oportunidade incluído no contrato.');
}
}
if (! empty($m['start_date']) && ! empty($m['end_date'])) {
$fail($m['end_date'] >= $m['start_date'], 'module_details.end_date', 'O fim não pode anteceder o início.');
}
if ($category === 'concession') {
$require(['granting_entity', 'procedure_regime', 'scope', 'term_value', 'term_unit', 'remuneration_obligations', 'participation_conditions', 'land_required', 'construction_required']);
$fail(($m['term_value'] ?? 0) > 0, 'module_details.term_value', 'Declare duração positiva.');
if (($m['mode'] ?? '') === 'awarded_right') {
$require(['external_decision_document_id']);
}
if ($m['land_required'] ?? false) {
$require(['applicable_authorizations']);
if (($m['mode'] ?? '') === 'awarded_right') {
$require(['territorial_right_document_id']);
}
}
if ($m['construction_required'] ?? false) {
$require(['applicable_authorizations']);
}
}
if (in_array($category, ['financing', 'supply'], true)) {
$require(['conditions_status', 'terms']);
$fail(! empty($p['currency']), 'currency', 'Declare moeda sem converter valores implicitamente.');
if (($m['conditions_status'] ?? '') === 'proposed') {
$require(['scenario', 'source', 'terms_date']);
$fail(empty($m['terms_date']) || $m['terms_date'] <= today()->toDateString(), 'module_details.terms_date', 'A data da fonte não pode ser futura.');
} elseif (($m['conditions_status'] ?? '') === 'binding') {
$require(['commitment_document_id']);
}
}
if ($category === 'financing') {
$require(['instrument', 'disbursement_calendar']);
if (($m['mode'] ?? '') === 'seeking_funding') {
$require(['use_of_funds', 'financial_plan_document_id']);
foreach (['total_investment', 'investment_breakdown', 'secured_financing', 'funding_sought'] as $field) {
$fail(array_key_exists($field, $p), $field, 'Complete o cenário do projeto para a procura de financiamento.');
}
$total = $p['total_investment'] ?? 0;
$secured = array_sum(array_column($p['secured_financing'] ?? [], 'amount'));
$sum = array_sum(array_column($p['investment_breakdown'] ?? [], 'amount'));
$fail($total > 0 && abs($sum - $total) <= 0.010001, 'investment_breakdown', 'Rubricas devem reconciliar com o investimento total positivo.');
$fail($secured <= $total, 'secured_financing', 'Financiamento assegurado não pode exceder o investimento.');
$sought = $p['funding_sought'] ?? 0;
$fail($sought > 0 && $sought <= $total - $secured, 'funding_sought', 'Pedido positivo não pode exceder a necessidade remanescente do projeto.');
if ($secured > 0) {
$require(['secured_evidence_document_id']);
}
foreach (['investment_breakdown', 'secured_financing'] as $field) {
foreach ($p[$field] ?? [] as $i => $row) {
$fail(($row['currency'] ?? '') === ($p['currency'] ?? ''), "$field.$i.currency", 'Moedas diferentes exigem cenário explícito; não somar automaticamente.');
}
}
} elseif (($m['mode'] ?? '') === 'funding_offer') {
$require(['offered_capacity', 'eligibility_criteria', 'capacity_document_id']);
$fail(($m['offered_capacity'] ?? 0) > 0, 'module_details.offered_capacity', 'Declare capacidade oferecida positiva e documentada, sem aprovação automática de beneficiários.');
foreach (['total_investment', 'investment_breakdown', 'secured_financing', 'funding_sought'] as $field) {
$fail(! isset($p[$field]) || $p[$field] === [], $field, 'Oferta usa capacidade e critérios do financiador; preserve o cenário do projeto num percurso de procura.');
}
}
if (($m['instrument'] ?? '') === 'debt') {
$require(['term_value', 'term_unit', 'repayment_periodicity']);
$fail(($m['term_value'] ?? 0) > 0, 'module_details.term_value', 'Dívida exige prazo positivo.');
} elseif (($m['instrument'] ?? '') === 'equity') {
$require(['equity_percentage', 'proposed_rights']);
$fail(($m['equity_percentage'] ?? 0) > 0 && ($m['equity_percentage'] ?? 0) <= 100, 'module_details.equity_percentage', 'Percentagem deve estar entre zero exclusivo e 100.');
}
}
if ($category === 'supply') {
$require(['quantity', 'unit', 'destination', 'start_date', 'end_date', 'acceptance_criteria', 'advance_or_guarantee']);
$fail(($m['quantity'] ?? 0) > 0, 'module_details.quantity', 'Declare quantidade positiva.');
$fail(! empty($m['total_price']) || ! empty($m['quotation_method']), 'module_details.quotation_method', 'Declare preço total ou método de cotação.');
if (isset($m['unit_price'], $m['total_price'], $m['quantity'])) {
$fail(abs($m['quantity'] * $m['unit_price'] - $m['total_price']) <= 0.010001, 'module_details.total_price', 'Reconcilie quantidade × preço unitário, separando impostos declarados.');
}
if (($m['mode'] ?? '') === 'supply_offer') {
$require(['capacity_document_id']);
}
}
if ($category === 'other') {
$require(['subtype', 'purpose', 'recipients', 'expected_output', 'risks']);
$subtype = config('portal.opportunity_other_qa_subtypes.'.($m['subtype'] ?? ''));
$fail(is_array($subtype) && ($subtype['approved'] ?? false) && ! empty($subtype['version'])
&& ! empty($subtype['gates']) && ! empty($subtype['decision_reference']), 'module_details.subtype', 'Subtipo ainda não aprovado: guarde e desenvolva a ideia; a submissão aguarda classificação funcional.');
}
}
/** @param array<string,mixed> $p
* @param array<string,string> $errors */
public function publication(array $p, array &$errors): void
{
$m = $p['module_details'] ?? [];
if (($p['opportunity_category'] ?? '') === 'concession') {
if (($m['mode'] ?? '') === 'intention_call' && empty($m['disclosure_authorization_document_id'])) {
$errors['module_details.disclosure_authorization_document_id'] = 'Chamada/intenção exige autorização de divulgação; não representa direito atribuído.';
}
if (($m['mode'] ?? '') === 'awarded_right' && empty($m['external_decision_document_id'])) {
$errors['module_details.external_decision_document_id'] = 'Direito atribuído exige o ato competente; aprovação interna não o substitui.';
}
if (($m['construction_required'] ?? false) && ($m['mode'] ?? '') === 'awarded_right' && empty($m['construction_license_document_id'])) {
$errors['module_details.construction_license_document_id'] = 'Construção aplicável exige licença antes da disponibilização como direito atribuído.';
}
}
}
/** @return list<string> */
public function gates(Opportunity $record): array
{
$p = app(OpportunityManagement::class)->values($record)['canonical'] ?? [];
$m = $p['module_details'] ?? [];
return match ($record->opportunity_category) {
'concession' => ['technical_review', 'legal_territorial_review'],
'financing' => ['technical_review', 'financial_review', 'legal_tax_due_diligence'],
'supply' => ['technical_review', 'legal_territorial_review', ...(($m['advance_or_guarantee'] ?? false) ? ['financial_review'] : [])],
'other' => config('portal.opportunity_other_qa_subtypes.'.($m['subtype'] ?? '').'.gates', []),
default => [],
};
}
}
+4
View File
@@ -221,6 +221,10 @@ class OpportunityResources
}
$data = Validator::make($payload, $rules)->validate();
if ($kind === 'locations') {
if (! empty($data['country_code']) && $data['country_code'] !== 'MZ'
&& array_filter(array_intersect_key($data, array_flip(['province_id', 'district_id', 'admin_post_id', 'locality_id'])))) {
throw ValidationException::withMessages(['country_code' => 'Os territórios desta hierarquia pertencem a Moçambique. Escolha Moçambique ou retire a seleção territorial para guardar uma localização noutro país.']);
}
app(InvestmentGeography::class)->selection($data, true);
if (! empty($data['geometry'])) {
$geometry = $data['geometry'];
+7 -1
View File
@@ -22,7 +22,7 @@ class PortalProfileAccess
app_path('Services/PortalProfileAdministration.php'), app_path('Services/PortalSuperusers.php'),
app_path('Services/OpportunityProfileWorkflow.php'), app_path('Http/Controllers/PortalProfileController.php'), app_path('Http/Controllers/DashboardController.php'),
app_path('Http/Controllers/OpportunityManagementController.php'),
app_path('Services/OpportunityCanonicalContract.php'), app_path('Services/OpportunityCategoryFields.php'), app_path('Services/OpportunityWorkflowTasks.php'), base_path('composer.json'), base_path('composer.lock'),
app_path('Services/OpportunityCanonicalContract.php'), app_path('Services/OpportunityCanonicalResponse.php'), app_path('Services/OpportunityCategoryFields.php'), app_path('Services/OpportunityModularProfiles.php'), app_path('Services/OpportunityWorkflowTasks.php'), base_path('composer.json'), base_path('composer.lock'),
resource_path('data/investmoz-opportunity-modular.schema.json'), resource_path('js/components/opportunity-canonical-fields.tsx'), resource_path('js/components/opportunity-parcel-geometry.tsx'),
app_path('Http/Controllers/OpportunityResourceController.php'),
app_path('Http/Controllers/InvestmentTerritoryController.php'),
@@ -32,8 +32,14 @@ class PortalProfileAccess
database_path('migrations/2026_10_10_040000_create_portal_profile_authorization.php'), base_path('bootstrap/app.php'),
resource_path('js/pages/profiles/request.tsx'), resource_path('js/pages/profiles/administration.tsx'), resource_path('js/pages/profiles/audit.tsx'),
resource_path('js/components/profile-navigation.tsx'), resource_path('js/components/opportunity-profile-actions.tsx'),
resource_path('js/components/portal-grouped-menu.tsx'), resource_path('js/components/user-menu-content.tsx'),
resource_path('js/pages/management/opportunities.tsx'), resource_path('js/pages/management/opportunity-draft.tsx'),
resource_path('js/types/profile-access.ts'), resource_path('js/lib/profile-json.ts'), resource_path('js/pages/management/shared.tsx'),
resource_path('js/pages/dashboard.tsx'), resource_path('js/pages/PortalInvestidor.tsx'),
resource_path('js/layouts/portal-navigation.tsx'), resource_path('js/components/interactive-investment-map.tsx'),
resource_path('js/components/simulation-form.tsx'), resource_path('js/lib/simulation-form.ts'), app_path('Services/LegacyContent.php'),
resource_path('js/components/ui/sidebar.tsx'), resource_path('js/components/simulation-financial-tools.tsx'), resource_path('js/components/simulation-cashflow-planner.tsx'), resource_path('js/pages/investor-path/show.tsx'), resource_path('views/app.blade.php'),
resource_path('js/pages/management/opportunity-resources.tsx'),
app_path('Services/PortalProfileInstallation.php'), app_path('Http/Controllers/PortalProfileInstallationController.php'), config_path('portal_profiles.php'), resource_path('js/pages/profiles/installation.tsx')];
}
+41 -1
View File
@@ -204,6 +204,30 @@ class VirtualDesk
});
}
/** @return array<string,mixed> */
public function requestToolPrefill(User $actor, \stdClass $request): ?array
{
$case = $this->case($actor, $request->case_id);
$payload = $this->decode($request->payload);
if (! config('investor-path.enabled') || (int) $case->user_id !== $actor->id || ! $case->simulation_id || $case->closed_at
|| ! in_array($request->status, ['draft', 'returned'], true) || trim((string) ($payload['description'] ?? '')) !== ''
|| ($request->status === 'returned' && ! in_array('description', json_decode($request->editable_fields ?? '[]', true), true))
|| ! isset($this->definition($request)['fields']['description'])) {
return null;
}
$draftRequest = Request::create('/');
$draftRequest->setUserResolver(fn () => $actor);
$draft = app(SimulationFormDrafts::class)->find($case->simulation_id, $draftRequest);
$economic = SimulationFormDraft::decryptSnapshot($draft->economic_snapshot);
$description = (string) ($economic['project_summary'] ?? '');
if (trim($description) === '') {
return null;
}
return ['description' => $description, 'draft_id' => $draft->id, 'draft_version' => $draft->version_no,
'snapshot_sha256' => $draft->snapshot_sha256];
}
/** @return array<string,mixed> */
public function definition(\stdClass $request): array
{
@@ -277,7 +301,9 @@ class VirtualDesk
/** @param array<string,mixed> $input */
public function save(User $actor, string $id, array $input, bool $submit = false): \stdClass
{
$data = Validator::make($input, ['version' => 'required|integer|min:1', 'payload' => 'required|array', 'consent' => $submit ? 'accepted' : 'nullable|boolean', 'reason' => 'nullable|string|max:3000'])->validate();
$data = Validator::make($input, ['version' => 'required|integer|min:1', 'payload' => 'required|array', 'consent' => $submit ? 'accepted' : 'nullable|boolean', 'reason' => 'nullable|string|max:3000',
'tool_prefill' => 'nullable|array:draft_id,draft_version,snapshot_sha256', 'tool_prefill.draft_id' => 'required_with:tool_prefill|uuid',
'tool_prefill.draft_version' => 'required_with:tool_prefill|integer|min:1', 'tool_prefill.snapshot_sha256' => 'required_with:tool_prefill|string|size:64'])->validate();
return DB::transaction(function () use ($actor, $id, $data, $submit) {
$request = $this->request($actor, $id, true, true);
@@ -285,6 +311,16 @@ class VirtualDesk
return $request;
}
abort_unless(in_array($request->status, ['draft', 'returned'], true) && $request->version === (int) $data['version'], 409, 'Pedido alterado ou já submetido.');
$prefill = null;
if (! empty($data['tool_prefill'])) {
$prefill = $this->requestToolPrefill($actor, $request);
$source = $data['tool_prefill'];
if ($submit || ! $prefill || $source['draft_id'] !== $prefill['draft_id'] || (int) $source['draft_version'] !== $prefill['draft_version']
|| ! hash_equals($prefill['snapshot_sha256'], $source['snapshot_sha256'])
|| ($data['payload']['description'] ?? null) !== $prefill['description']) {
throw ValidationException::withMessages(['payload.description' => 'Recupere a descrição atual deste dossier. A reutilização só preenche um campo vazio num rascunho e não submete o pedido.']);
}
}
$payload = $this->validateFields($data['payload'], $this->definition($request), $submit);
if ($request->status === 'returned') {
$editable = json_decode($request->editable_fields ?? '[]', true);
@@ -310,6 +346,10 @@ class VirtualDesk
DB::table('desk_requests')->where('id', $id)->update($updates);
$request = DB::table('desk_requests')->where('id', $id)->firstOrFail();
$this->event($case, $actor, $submit ? 'submitted' : 'draft_saved', ['reason' => $data['reason'] ?? '', 'findings' => $findings], $request);
if ($prefill) {
$this->event($case, $actor, 'request_prefill_reused', ['draft_id' => $prefill['draft_id'], 'draft_version' => $prefill['draft_version'],
'snapshot_sha256' => $prefill['snapshot_sha256'], 'fields' => ['description'], 'scope' => 'draft_preparation'], $request);
}
return $request;
});