feat: implement BankAccount management with CRUD operations and routes for tenant selection

app/Domains/BankAccount/Controllers/BankAccountController.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace App\Domains\BankAccount\Controllers;
+
+use App\Domains\BankAccount\Models\BankAccount;
+use App\Domains\Tenant\Models\Tenant;
+use App\Domains\BankAccount\Requests\StoreBankAccountRequest;
+use App\Domains\BankAccount\Requests\UpdateBankAccountRequest;
+use App\Domains\BankAccount\Resources\BankAccountResource;
+use App\Domains\Tenant\Resources\TenantResource;
+use App\Http\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Response;
+
+class BankAccountController extends Controller
+{
+    public function index(Tenant $tenant): JsonResponse
+    {
+        $accounts = $tenant->bankAccounts()->latest()->get();
+        return BankAccountResource::collection($accounts)->response();
+    }
+
+    public function store(StoreBankAccountRequest $request, Tenant $tenant): JsonResponse
+    {
+        $data = $request->validated();
+        $data['tenant_code'] = $tenant->codigo;
+
+        $account = BankAccount::query()->create($data);
+
+        return BankAccountResource::make($account)->response()->setStatusCode(201);
+    }
+
+    public function show(Tenant $tenant, BankAccount $bankAccount): BankAccountResource
+    {
+        abort_if($bankAccount->tenant_code !== $tenant->codigo, 404);
+
+        return BankAccountResource::make($bankAccount);
+    }
+
+    public function update(UpdateBankAccountRequest $request, Tenant $tenant, BankAccount $bankAccount): BankAccountResource
+    {
+        abort_if($bankAccount->tenant_code !== $tenant->codigo, 404);
+
+        $bankAccount->update($request->validated());
+
+        return BankAccountResource::make($bankAccount);
+    }
+
+    public function destroy(Tenant $tenant, BankAccount $bankAccount): Response
+    {
+        abort_if($bankAccount->tenant_code !== $tenant->codigo, 404);
+
+        $bankAccount->delete();
+
+        return response()->noContent();
+    }
+
+    public function select(Tenant $tenant, BankAccount $bankAccount): TenantResource
+    {
+        abort_if($bankAccount->tenant_code !== $tenant->codigo, 400, 'La cuenta bancaria no pertenece a este tenant.');
+
+        $tenant->selected_bank_account_id = $bankAccount->id;
+        $tenant->save();
+
+        return TenantResource::make($tenant->loadMissing(['headerLogo', 'footerLogo']));
+    }
+
+    public function selected(Tenant $tenant): JsonResponse
+    {
+        $account = $tenant->selectedBankAccount;
+
+        abort_if(!$account, 404, 'No hay ninguna cuenta bancaria seleccionada para este tenant.');
+
+        return BankAccountResource::make($account)->response();
+    }
+}

app/Domains/BankAccount/Models/BankAccount.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Domains\BankAccount\Models;
+
+use App\Domains\Tenant\Models\Tenant;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class BankAccount extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'tenant_code',
+        'titular',
+        'entidad',
+        'alias',
+        'cvu',
+    ];
+
+    /**
+     * @return BelongsTo<Tenant, $this>
+     */
+    public function tenant(): BelongsTo
+    {
+        return $this->belongsTo(Tenant::class, 'tenant_code', 'codigo');
+    }
+}

app/Domains/BankAccount/Requests/StoreBankAccountRequest.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Domains\BankAccount\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreBankAccountRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'titular' => ['required', 'string', 'max:255'],
+            'entidad' => ['required', 'string', 'max:255'],
+            'alias' => ['required', 'string', 'max:255'],
+            'cvu' => ['required', 'string', 'max:255'],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'titular.required' => 'El campo titular es obligatorio.',
+            'titular.string' => 'El campo titular debe ser una cadena de texto.',
+            'titular.max' => 'El campo titular no debe superar los 255 caracteres.',
+            'entidad.required' => 'El campo entidad es obligatorio.',
+            'entidad.string' => 'El campo entidad debe ser una cadena de texto.',
+            'entidad.max' => 'El campo entidad no debe superar los 255 caracteres.',
+            'alias.required' => 'El campo alias es obligatorio.',
+            'alias.string' => 'El campo alias debe ser una cadena de texto.',
+            'alias.max' => 'El campo alias no debe superar los 255 caracteres.',
+            'cvu.required' => 'El campo cvu es obligatorio.',
+            'cvu.string' => 'El campo cvu debe ser una cadena de texto.',
+            'cvu.max' => 'El campo cvu no debe superar los 255 caracteres.',
+        ];
+    }
+}

app/Domains/BankAccount/Requests/UpdateBankAccountRequest.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Domains\BankAccount\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateBankAccountRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'titular' => ['sometimes', 'string', 'max:255'],
+            'entidad' => ['sometimes', 'string', 'max:255'],
+            'alias' => ['sometimes', 'string', 'max:255'],
+            'cvu' => ['sometimes', 'string', 'max:255'],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'titular.string' => 'El campo titular debe ser una cadena de texto.',
+            'titular.max' => 'El campo titular no debe superar los 255 caracteres.',
+            'entidad.string' => 'El campo entidad debe ser una cadena de texto.',
+            'entidad.max' => 'El campo entidad no debe superar los 255 caracteres.',
+            'alias.string' => 'El campo alias debe ser una cadena de texto.',
+            'alias.max' => 'El campo alias no debe superar los 255 caracteres.',
+            'cvu.string' => 'El campo cvu debe ser una cadena de texto.',
+            'cvu.max' => 'El campo cvu no debe superar los 255 caracteres.',
+        ];
+    }
+}

app/Domains/BankAccount/Resources/BankAccountResource.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Domains\BankAccount\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+/**
+ * @mixin \App\Domains\BankAccount\Models\BankAccount
+ */
+class BankAccountResource extends JsonResource
+{
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'tenant_code' => $this->tenant_code,
+            'titular' => $this->titular,
+            'entidad' => $this->entidad,
+            'alias' => $this->alias,
+            'cvu' => $this->cvu,
+        ];
+    }
+}

app/Domains/BankAccount/routes/api.php

@@ -0,0 +1,13 @@
+<?php
+
+use App\Domains\BankAccount\Controllers\BankAccountController;
+use Illuminate\Support\Facades\Route;
+
+Route::prefix('tenants/{tenant:codigo}')->group(function (): void {
+    Route::middleware('auth:sanctum')->group(function (): void {
+        Route::get('bank-accounts/selected', [BankAccountController::class, 'selected']);
+        Route::post('bank-accounts/{bank_account}/select', [BankAccountController::class, 'select']);
+        Route::apiResource('bank-accounts', BankAccountController::class)
+            ->parameters(['bank-accounts' => 'bank_account']);
+    });
+});