implementa select da lista de bancos com dados automaticos e padronizados

README.md

@@ -147,8 +147,10 @@ O comando `php artisan db:seed` (inclusive via `migrate:fresh --seed`) respeita
 | Valor | Dados criados |
 |-------|---------------|
 | `none` | Nenhum (padrao) |
-| `users` | Permissoes, perfis e usuarios |
-| `all` | Todos os dados de desenvolvimento |
+| `users` | Seeders comuns, permissoes, perfis e usuarios |
+| `all` | Seeders comuns e todos os dados de desenvolvimento |
+
+Os seeders comuns sao definidos em `config/seeding.php` (`common`) e incluem o catalogo de bancos. O modo `none` nao executa esses seeders.
 
 Depois de alterar `SEED_MODE` em um ambiente com configuracao em cache, execute
 `php artisan config:clear` antes de rodar o seeder.

app/Http/Controllers/AgentController.php

@@ -38,6 +38,7 @@ public function show(Request $request, Agent $agent)
                 'notice',
                 'category',
                 'opening',
+                'opening.bank',
                 'currentStage',
                 'budgets.installments',
             ])

app/Http/Controllers/ProjectController.php

@@ -17,6 +17,7 @@
 use App\Http\Requests\Project\CreateProjectDocumentRequest;
 use App\Http\Resources\DocumentResource;
 use App\Http\Resources\ProjectResource;
+use App\Models\Bank;
 use App\Models\Notice;
 use App\Models\Project;
 use App\Models\ProjectStage;
@@ -41,13 +42,15 @@ public function index(Request $request, Notice $notice)
                 'agent.latestSnapshot',
                 'category',
                 'opening',
+                'opening.bank',
                 'opening.supervisors',
                 'opening.principalSupervisor.user',
                 'documents',
                 'documents.project.agent.latestSnapshot',
                 'documents.project.notice',
                 'documents.project.notice.budgetAllocations',
                 'documents.project.opening.principalSupervisor.user',
+                'documents.project.opening.bank',
                 'documents.project.budgets.installments.budgetAllocation',
                 'currentStage',
                 'monitoring',
@@ -131,6 +134,7 @@ public function projectDetail(Request $request, Notice $notice, Project $project
             'agent',
             'category',
             'opening',
+            'opening.bank',
             'opening.supervisors' => function ($q) {
                 $q->whereNull('removed_at')
                     ->orderByRaw("CASE type WHEN 'principal' THEN 0 WHEN 'alternate' THEN 1 ELSE 2 END");
@@ -169,6 +173,10 @@ public function projectDetail(Request $request, Notice $notice, Project $project
             'usersAvailableForFormalization' => $usersAvailableForFormalization,
             'agentStatus' => AgentStatus::options(),
             'accountType' => AccountType::options(),
+            'banks' => Bank::orderByRaw('code IS NULL')
+                ->orderBy('code')
+                ->orderBy('name')
+                ->get(['id', 'code', 'name', 'short_name']),
             'reportStatus' => ReportStatus::options(),
             'deliberation' => DeliberationType::options(),
             'cgeAtendeStatus' => CgeAtendeStatus::options(),

app/Http/Requests/Opening/OpeningStoreRequest.php

@@ -24,7 +24,7 @@ public function rules(): array
 
             'creditor_number' => ['nullable', 'string', 'max:255'],
 
-            'bank' => ['nullable', 'string', 'max:255'],
+            'bank_id' => ['nullable', 'integer', 'exists:banks,id'],
             'account_type' => ['nullable', 'string', 'max:100'],
             'branch' => ['nullable', 'string', 'max:50'],
             'account' => ['nullable', 'string', 'max:50'],

app/Http/Requests/Opening/OpeningUpdateRequest.php

@@ -63,7 +63,7 @@ public function rules(): array
             'opening.creditor_number' => ['nullable', 'string', 'max:255'],
 
             // Dados Bancários
-            'opening.bank' => ['nullable', 'string', 'max:255'],
+            'opening.bank_id' => ['nullable', 'integer', 'exists:banks,id'],
             'opening.account_type' => ['nullable', 'string', 'max:255'],
             'opening.branch' => ['nullable', 'string', 'max:255'],
             'opening.account' => ['nullable', 'string', 'max:255'],
@@ -117,7 +117,7 @@ public function attributes(): array
             'opening.agent_status' => 'status do agente cultural',
             'opening.opened_by' => 'responsável por abrir o processo',
             'opening.creditor_number' => 'número do cadastro do credor',
-            'opening.bank' => 'banco',
+            'opening.bank_id' => 'banco',
             'opening.account_type' => 'tipo de conta',
             'opening.branch' => 'agência',
             'opening.account' => 'conta',

app/Http/Resources/OpeningResource.php

@@ -28,7 +28,8 @@ public function toArray(Request $request): array
 
             'creditor_number' => $this->creditor_number,
 
-            'bank' => $this->bank,
+            'bank_id' => $this->bank_id,
+            'bank' => $this->whenLoaded('bank'),
             'account_type' => $this->account_type?->value,
             'branch' => $this->branch,
             'account' => $this->account,

app/Models/Bank.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class Bank extends Model
+{
+    public $timestamps = false;
+
+    protected $fillable = ['ispb', 'code', 'name', 'short_name'];
+
+    public function openings(): HasMany
+    {
+        return $this->hasMany(Opening::class);
+    }
+}

app/Models/Opening.php

@@ -10,6 +10,7 @@
 use App\Traits\HasFiles;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\HasOne;
 use Illuminate\Database\Eloquent\SoftDeletes;
@@ -29,7 +30,7 @@ class Opening extends Model implements Auditable
         'opened_by',
         'created_by',
         'creditor_number',
-        'bank',
+        'bank_id',
         'account_type',
         'branch',
         'account',
@@ -71,6 +72,11 @@ public function project()
         return $this->belongsTo(Project::class);
     }
 
+    public function bank(): BelongsTo
+    {
+        return $this->belongsTo(Bank::class);
+    }
+
     public function user()
     {
         return $this->belongsTo(User::class);

app/Services/BankResolver.php

@@ -0,0 +1,80 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Bank;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Str;
+
+class BankResolver
+{
+    private bool $loaded = false;
+
+    /** @var array<string, int> */
+    private array $codes = [];
+
+    /** @var array<string, array<int, int>> */
+    private array $names = [];
+
+    public function resolveBankId(string $value): ?int
+    {
+        $value = trim($value);
+        if ($value === '') {
+            return null;
+        }
+
+        $this->loadCatalog();
+
+        if (ctype_digit($value)) {
+            $id = $this->codes[str_pad($value, 3, '0', STR_PAD_LEFT)] ?? null;
+        } else {
+            $matches = array_values($this->names[$this->normalize($value)] ?? []);
+            if (count($matches) > 1) {
+                Log::warning('spreadsheet.import.bank_ambiguous', [
+                    'bank' => $value,
+                    'candidate_ids' => array_slice($matches, 0, 2),
+                ]);
+
+                return null;
+            }
+
+            $id = $matches[0] ?? null;
+        }
+
+        if ($id === null) {
+            Log::warning('spreadsheet.import.bank_not_found', ['bank' => $value]);
+        }
+
+        return $id;
+    }
+
+    private function loadCatalog(): void
+    {
+        if ($this->loaded) {
+            return;
+        }
+
+        foreach (Bank::query()->get(['id', 'code', 'name', 'short_name']) as $bank) {
+            if ($bank->code !== null) {
+                $this->codes[$bank->code] = $bank->id;
+            }
+
+            foreach ([$bank->name, $bank->short_name] as $name) {
+                // Deduplicate aliases of the same institution, not distinct banks.
+                $this->names[$this->normalize($name)][$bank->id] = $bank->id;
+            }
+        }
+
+        $this->loaded = true;
+    }
+
+    private function normalize(string $name): string
+    {
+        return (string) Str::of($name)
+            ->ascii()->lower()
+            ->replaceMatches('/[^a-z0-9]+/', ' ')
+            ->replaceMatches('/\bbco\b/', 'banco')
+            ->replaceMatches('/\s+s\s*a\s*$/', '')
+            ->trim();
+    }
+}

app/Services/Documents/DocumentPlaceholderResolver.php

@@ -20,6 +20,7 @@ class DocumentPlaceholderResolver
         'project.agent.latestSnapshot',
         'project.notice.budgetAllocations',
         'project.opening.principalSupervisor.user',
+        'project.opening.bank',
         'project.budgets.installments',
         'project.category',
         'project.budgets.installments.budgetAllocation',
@@ -76,7 +77,7 @@ public function resolve(Document $document): string
             '[allocation_code]' => $budgetAllocation?->allocation_code ?? '',
             '[allocation_number]' => $budgetAllocation?->allocation_number ?? '',
             '[notice_installment_number]' => $currentInstallment?->notice_installment_number ?? '',
-            '[bank]' => $opening?->bank ?? '',
+            '[bank]' => $opening?->bank?->name ?? '',
             '[account_type]' => $opening?->account_type?->label() ?? '',
             '[branch]' => $opening?->branch ?? '',
             '[account]' => $opening?->account ?? '',

app/Services/OpeningUpdateService.php

@@ -90,7 +90,7 @@ public function ensureCanAdvance(Project $project): void
 
         $requiredOpeningFields = [
             'creditor_number' => 'Número do cadastro do credor',
-            'bank' => 'Banco',
+            'bank_id' => 'Banco',
             'account_type' => 'Tipo de conta',
             'branch' => 'Agência',
             'account' => 'Conta',

app/Services/SpreadsheetImportService.php

@@ -30,6 +30,7 @@ public function __construct(
         private readonly CategoryService $categoryService,
         private readonly AgentService $agentService,
         private readonly UserService $userService,
+        private readonly BankResolver $bankResolver,
     ) {}
 
     /**
@@ -160,7 +161,7 @@ private function resolveOpening(array $row, int $projectId, int $userId, ?User $
             'opening_date' => $this->parseDate(trim((string) ($row['DATA ABERTURA DE PROCESSO'] ?? ''))),
             'agent_status' => $this->mapAgentStatus(trim((string) ($row['STATUS'] ?? ''))),
             'opened_by' => trim((string) ($row['RESPONSÁVEL POR ABRIR PROCESSO'] ?? '')),
-            'bank' => trim((string) ($row['BANCO'] ?? '')),
+            'bank_id' => $this->bankResolver->resolveBankId(trim((string) ($row['BANCO'] ?? ''))),
             'account_type' => $this->mapAccountType(trim((string) ($row['TIPO DE CONTA'] ?? ''))),
             'branch' => trim((string) ($row['AGÊNCIA'] ?? '')),
             'account' => trim((string) ($row['CONTA'] ?? '')),

config/seeding.php

@@ -1,5 +1,7 @@
 <?php
 
+use Database\Seeders\BankSeeder;
+
 return [
 
     /*
@@ -13,4 +15,9 @@
 
     'mode' => env('SEED_MODE', 'none'),
 
+    // Shared seeders for config tables
+    'common' => [
+        BankSeeder::class,
+    ],
+
 ];

cypress/e2e/efomento/projects/bank.cy.js

@@ -0,0 +1,49 @@
+import ProjectWorkflow from '../../../support/workflows/ProjectWorkflow.js';
+import LoginWorkflow from '../../../support/workflows/LoginWorkflow.js';
+
+describe('Opening bank selection', () => {
+    it('searches the local catalog and preserves the selected bank after saving', () => {
+        // Vuetify overlays can defer resize notifications until the next frame.
+        cy.on('uncaught:exception', (error) => {
+            if (error.message.includes('ResizeObserver loop completed with undelivered notifications.')) return false;
+        });
+
+        cy.intercept('https://brasilapi.com.br/**', { forceNetworkError: true }).as('externalBanks');
+        cy.fixture('users').then(({ fomentation }) => {
+            LoginWorkflow.goToLoginPage();
+            LoginWorkflow.loginWithTwoFactorAndTrustDevice(fomentation.email, fomentation.password);
+            cy.location('pathname').should('eq', '/editais');
+        });
+
+        cy.fixture('notices').then(({ notice }) => {
+            cy.fixture('projects').then(({ opening }) => {
+                ProjectWorkflow.accessProjectByNup({ notice, project: { projectNup: opening.nup } });
+            });
+        });
+
+        cy.get('[data-cy="bank-select"] input').clear();
+        cy.get('[data-cy="bank-select"] input').type('banco do brasil');
+        cy.contains('[role="option"]', '001 - Banco do Brasil S.A.').should('be.visible');
+
+        cy.get('[data-cy="bank-select"] input').clear();
+        cy.get('[data-cy="bank-select"] input').type('itau');
+        cy.contains('[role="option"]', '341 - ITAÚ UNIBANCO S.A.').should('be.visible');
+
+        cy.get('[data-cy="bank-select"] input').clear();
+        cy.get('[data-cy="bank-select"] input').type('banco inexistente xyz');
+        cy.contains('Nenhum banco encontrado').should('be.visible');
+
+        cy.get('[data-cy="bank-select"] input').clear();
+        cy.get('[data-cy="bank-select"] input').type('001');
+        cy.contains('[role="option"]', '001 - Banco do Brasil S.A.').click();
+
+        cy.intercept('PATCH', '**/abertura/*/atualizar').as('saveOpening');
+        cy.contains('button', 'Salvar Alterações').click();
+        cy.wait('@saveOpening').its('request.body.opening.bank_id').should('be.a', 'number');
+        cy.contains('Abertura atualizada com sucesso').should('be.visible');
+        cy.reload();
+        cy.get('[data-cy="bank-select"]').should('contain', '001 - Banco do Brasil S.A.');
+
+        cy.get('@externalBanks.all').should('have.length', 0);
+    });
+});

database/factories/OpeningFactory.php

@@ -5,6 +5,7 @@
 use App\Enums\AccountType;
 use App\Enums\AgentStatus;
 use App\Enums\OpeningStatus;
+use App\Models\Bank;
 use App\Models\Opening;
 use App\Models\Project;
 use App\Models\User;
@@ -38,14 +39,8 @@ public function definition(): array
 
             'creditor_number' => $this->faker->numerify(),
 
-            'bank' => $this->faker->randomElement([
-                '001',
-                '237',
-                '341',
-                '104',
-                '033',
-                '745',
-            ]),
+            'bank_id' => Bank::whereIn('code', ['001', '237', '341', '104', '033', '745'])
+                ->inRandomOrder()->value('id'),
 
             'account_type' => $this->faker->randomElement(AccountType::cases())->value,