juan.zapata/repuve-backend-v1
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

FEAT: implementar catálogo de estatus de tags y actualizar update y cancellation controller

Browse Source
This commit is contained in:
Juan Felipe Zapata Moreno 2025-11-22 12:14:53 -06:00
parent ef864c4753
commit 78ac5ab75e
9 changed files with 301 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
app/Http/Controllers/Repuve/CancellationController.php
View File

@ -22,7 +22,7 @@ public function cancelarConstancia(CancelConstanciaRequest $request)
DB::beginTransaction();
// Buscar el expediente con sus relaciones
$record = Record::with('vehicle.tag')->findOrFail($request->record_id);
$record = Record::with('vehicle.tag.status')->findOrFail($request->record_id);
$vehicle = $record->vehicle;
$tag = $vehicle->tag;
@ -34,9 +34,9 @@ public function cancelarConstancia(CancelConstanciaRequest $request)
}
// Validar que el tag está en estado activo
if ($tag->status !== 'assigned') {
if (!$tag->isAssigned()) {
return ApiResponse::BAD_REQUEST->response([
'message' => 'El tag ya no está activo. Status actual: ' . $tag->status
'message' => 'El tag ya no está activo. Status actual: ' . $tag->status->name
]);
}
@ -59,10 +59,7 @@ public function cancelarConstancia(CancelConstanciaRequest $request)
]);
// Actualizar estado del tag a 'cancelled' y desasignar vehículo
$tag->update([
'status' => 'cancelled',
'vehicle_id' => null,
]);
$tag->markAsCancelled();
DB::commit();
@ -78,8 +75,8 @@ public function cancelarConstancia(CancelConstanciaRequest $request)
'tag' => [
'id' => $tag->id,
'folio' => $tag->folio,
'old_status' => 'assigned',
'new_status' => 'cancelled',
'old_status' => $tag->status->name,
'new_status' => 'Cancelado',
],
'cancellation_reason' => $request->cancellation_reason,
'cancellation_observations' => $request->cancellation_observations,

5
app/Http/Controllers/Repuve/InscriptionController.php
View File

@ -279,7 +279,7 @@ public function vehicleInscription(VehicleStoreRequest $request)
'tag' => [
'id' => $record->vehicle->tag->id,
'folio' => $record->vehicle->tag->folio,
'status' => $record->vehicle->tag->status,
'status' => $record->vehicle->tag->status->name,
],
'files' => $uploadedFiles,
'total_files' => count($uploadedFiles),
@ -377,7 +377,8 @@ public function searchRecord(Request $request)
$records = Record::with([
'vehicle:id,owner_id,placa,niv,marca,linea,modelo,color',
'vehicle.owner:id,name,paternal,maternal,rfc',
'vehicle.tag:id,vehicle_id,folio,tag_number,status',
'vehicle.tag:id,vehicle_id,folio,tag_number,status_id',
'vehicle.tag.status:id,code,name',
'files:id,record_id,name_id,path,md5',
'files.catalogName:id,name',
'user:id,name,email',

69
app/Http/Controllers/Repuve/UpdateController.php
View File

@ -14,6 +14,8 @@
use App\Models\Owner;
use App\Models\Error;
use App\Models\CatalogNameImg;
use App\Models\Tag;
use App\Models\VehicleTagLog;
use App\Services\RepuveService;
use App\Services\PadronEstatalService;
use Exception;
@ -55,7 +57,7 @@ public function vehicleData(Request $request)
$record = Record::with([
'vehicle:id,owner_id,placa,niv,marca,linea,modelo,color',
'vehicle.owner:id,name,paternal,maternal,rfc',
'vehicle.tag:id,vehicle_id,folio,tag_number,status',
'vehicle.tag:id,vehicle_id,folio,tag_number,status_id',
'files:id,record_id,name_id,path,md5',
'files.catalogName:id,name',
'user:id,name,email',
@ -155,14 +157,28 @@ public function vehicleUpdate(VehicleUpdateRequest $request)
}
$vehicle = $record->vehicle;
$tag = $vehicle->tag;
$currentTag = $vehicle->tag;
$newTag = Tag::where('tag_number', $tagNumber)->first();
if (!$tag || $tag->tag_number !== $tagNumber) {
return ApiResponse::BAD_REQUEST->response([
'message' => 'El tag_number no coincide con el registrado en el expediente',
if (!$newTag) {
return ApiResponse::NOT_FOUND->response([
'message' => 'No se encontró el tag con el tag_number proporcionado',
'tag_number' => $tagNumber,
]);
}
$isTagReplacement = false;
if($currentTag && $currentTag->id !== $newTag->id) {
if(!$newTag->isAvailable()) {
return ApiResponse::BAD_REQUEST->response([
'message' => 'El tag proporcionado no está disponible para asignación',
'tag_number' => $tagNumber,
'current_status' => $newTag->status->name,
]);
}
$isTagReplacement = true;
}
if ($vehicle->niv !== $niv) {
return ApiResponse::BAD_REQUEST->response([
'message' => 'El NIV no coincide con el registrado en el expediente',
@ -240,6 +256,26 @@ public function vehicleUpdate(VehicleUpdateRequest $request)
]);
}
$tagReplacementLog = null;
if($isTagReplacement) {
$tagReplacementLog = VehicleTagLog::create([
'vehicle_id' => $vehicle->id,
'tag_id' => $currentTag->id,
'cancellation_reason' => 'Otro',
'cancellation_observations' => 'Reemplazo automático al actualizar datos del vehículo: '. $newTag->tag_number,
'cancellation_at' => now(),
'cancelled_by' => auth()->id(),
]);
$currentTag->markAsCancelled();
$newTag->markAsAssigned($vehicle->id, $folio);
$tag = $newTag;
}else{
$tag = $currentTag;
}
$uploadedFiles = [];
$replacedFiles = [];
@ -310,7 +346,7 @@ public function vehicleUpdate(VehicleUpdateRequest $request)
}
// Solo enviar a REPUVE Nacional si hay cambios
if ($hasVehicleChanges || $hasOwnerChanges || count($uploadedFiles) > 0) {
if ($hasVehicleChanges || $hasOwnerChanges || count($uploadedFiles) > 0|| $isTagReplacement) {
//Envio de datos
$apiResponse = $this->sendToRepuveNacional($niv);
$apiResponse["repuve_response"]["folio_ci"] = $record->folio;
@ -361,13 +397,15 @@ public function vehicleUpdate(VehicleUpdateRequest $request)
DB::commit();
$sentToRepuve = $hasVehicleChanges || $hasOwnerChanges || count($uploadedFiles) > 0;
$sentToRepuve = $hasVehicleChanges || $hasOwnerChanges || count($uploadedFiles) > 0 || $isTagReplacement;
$message = 'Vehículo actualizado exitosamente';
if (!$hasVehicleChanges && !$hasOwnerChanges && empty($uploadedFiles)) {
$message = 'No se detectaron cambios. Los datos ya estaban actualizados.';
} elseif (!$hasVehicleChanges && !$hasOwnerChanges) {
} elseif (!$hasVehicleChanges && !$hasOwnerChanges && !$isTagReplacement) {
$message = 'Solo se actualizaron archivos. Los datos del vehículo/propietario no cambiaron.';
} elseif ($isTagReplacement && !$hasVehicleChanges && !$hasOwnerChanges && empty($uploadedFiles)) {
$message = 'Tag reemplazado exitosamente. Los datos del vehículo/propietario no cambiaron.';
}
return ApiResponse::OK->response([
@ -378,7 +416,20 @@ public function vehicleUpdate(VehicleUpdateRequest $request)
'vehicle_updated' => $hasVehicleChanges,
'owner_updated' => $hasOwnerChanges,
'files_uploaded' => count($uploadedFiles) > 0,
'tag_replaced' => $isTagReplacement,
],
'tag_replacement' => $isTagReplacement ? [
'old_tag' => [
'id' => $currentTag->id,
'tag_number' => $currentTag->tag_number,
'status' => $currentTag->status->name,
],
'new_tag' => [
'id' => $newTag->id,
'tag_number' => $newTag->tag_number,
'status' => $newTag->status->name,
],
] : null,
'record' => [
'id' => $record->id,
'folio' => $record->folio,
@ -400,7 +451,7 @@ public function vehicleUpdate(VehicleUpdateRequest $request)
'tag' => [
'id' => $tag->id,
'tag_number' => $tag->tag_number,
'status' => $tag->status,
'status' => $tag->status->name,
],
'uploaded_files' => $uploadedFiles,
'replaced_count' => count($replacedFiles),

62
app/Models/CatalogTagStatus.php Normal file
View File

@ -0,0 +1,62 @@
<?php namespace App\Models;
/**
* @copyright (c) 2025 Notsoweb Software (https://notsoweb.com) - All Rights Reserved
*/
use Illuminate\Database\Eloquent\Model;
/**
* Catálogo de estatus de tags
*
* @author Moisés Cortés C. <moises.cortes@notsoweb.com>
*
* @version 1.0.0
*/
class CatalogTagStatus extends Model
{
// Constantes de códigos de estatus
const CODE_AVAILABLE = 'available';
const CODE_ASSIGNED = 'assigned';
const CODE_CANCELLED = 'cancelled';
protected $table = 'catalog_tag_status';
protected $fillable = [
'code',
'name',
'description',
'active',
];
protected function casts(): array
{
return [
'active' => 'boolean',
];
}
/**
* Tags que tienen este estatus
*/
public function tags()
{
return $this->hasMany(Tag::class, 'status_id');
}
/**
* Scope para obtener solo estatus activos
*/
public function scopeActive($query)
{
return $query->where('active', true);
}
/**
* Scope para buscar por código
*/
public function scopeByCode($query, string $code)
{
return $query->where('code', $code);
}
}

34
app/Models/Tag.php
View File

@ -20,7 +20,7 @@ class Tag extends Model
'tag_number',
'vehicle_id',
'package_id',
'status',
'status_id',
];
public function vehicle()
@ -33,6 +33,11 @@ public function package()
return $this->belongsTo(Package::class);
}
public function status()
{
return $this->belongsTo(CatalogTagStatus::class, 'status_id');
}
public function vehicleTagLogs()
{
return $this->hasMany(VehicleTagLog::class);
@ -48,10 +53,25 @@ public function scanHistories()
*/
public function markAsAssigned(int $vehicleId, string $folio): void
{
$statusAssigned = CatalogTagStatus::where('code', self::STATUS_ASSIGNED)->first();
$this->update([
'vehicle_id' => $vehicleId,
'folio' => $folio,
'status' => self::STATUS_ASSIGNED,
'status_id' => $statusAssigned->id,
]);
}
/**
* Marcar tag como cancelado
*/
public function markAsCancelled(): void
{
$statusCancelled = CatalogTagStatus::where('code', self::STATUS_CANCELLED)->first();
$this->update([
'status_id' => $statusCancelled->id,
'vehicle_id' => null,
]);
}
@ -60,7 +80,7 @@ public function markAsAssigned(int $vehicleId, string $folio): void
*/
public function isAvailable(): bool
{
return $this->status === self::STATUS_AVAILABLE;
return $this->status->code === self::STATUS_AVAILABLE;
}
/**
@ -68,7 +88,7 @@ public function isAvailable(): bool
*/
public function isAssigned(): bool
{
return $this->status === self::STATUS_ASSIGNED;
return $this->status->code === self::STATUS_ASSIGNED;
}
/**
@ -76,14 +96,14 @@ public function isAssigned(): bool
*/
public function isCancelled(): bool
{
return $this->status === self::STATUS_CANCELLED;
return $this->status->code === self::STATUS_CANCELLED;
}
/**
* Verificar si el tag está perdido
* Verificar si el tag está perdido (ahora es parte de cancelado)
*/
public function isLost(): bool
{
return $this->status === self::STATUS_LOST;
return $this->status->code === self::STATUS_CANCELLED;
}
}

31
database/migrations/2025_11_22_104814_create_catalog_tag_status_table.php Normal file
View File

@ -0,0 +1,31 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
/**
* Run the migrations.
*/
public function up(): void
{
Schema::create('catalog_tag_status', function (Blueprint $table) {
$table->id();
$table->string('code')->unique();
$table->string('name');
$table->text('description')->nullable();
$table->boolean('active')->default(true);
$table->timestamps();
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('catalog_tag_status');
}
};

59
database/migrations/2025_11_22_104815_modify_tags_table_change_status_to_foreign_key.php Normal file
View File

@ -0,0 +1,59 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
use Illuminate\Support\Facades\DB;
return new class extends Migration
{
/**
* Run the migrations.
*/
public function up(): void
{
Schema::table('tags', function (Blueprint $table) {
$table->unsignedBigInteger('status_id')->nullable()->after('package_id');
});
DB::table('tags')->where('status', 'available')->update(['status_id' => 1]);
DB::table('tags')->where('status', 'assigned')->update(['status_id' => 2]);
DB::table('tags')->where('status', 'cancelled')->update(['status_id' => 3]);
DB::table('tags')->where('status', 'lost')->update(['status_id' => 3]);
DB::table('tags')->whereNull('status_id')->update(['status_id' => 1]);
Schema::table('tags', function (Blueprint $table) {
$table->dropColumn('status');
});
DB::statement('ALTER TABLE tags MODIFY status_id BIGINT UNSIGNED NOT NULL DEFAULT 1');
Schema::table('tags', function (Blueprint $table) {
$table->foreign('status_id')->references('id')->on('catalog_tag_status')->onDelete('restrict');
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
// Restaurar el enum
Schema::table('tags', function (Blueprint $table) {
$table->enum('status', ['available', 'assigned', 'cancelled', 'lost'])->default('available')->after('package_id');
});
// Mapear de vuelta los IDs a enum
DB::table('tags')->where('status_id', 1)->update(['status' => 'available']);
DB::table('tags')->where('status_id', 2)->update(['status' => 'assigned']);
DB::table('tags')->where('status_id', 3)->update(['status' => 'cancelled']);
// Eliminar la foreign key y columna status_id
Schema::table('tags', function (Blueprint $table) {
$table->dropForeign(['status_id']);
$table->dropColumn('status_id');
});
}
};

52
database/seeders/CatalogTagStatusSeeder.php Normal file
View File

@ -0,0 +1,52 @@
<?php namespace Database\Seeders;
/**
* @copyright (c) 2025 Notsoweb Software (https://notsoweb.com) - All Rights Reserved
*/
use Illuminate\Database\Console\Seeds\WithoutModelEvents;
use Illuminate\Database\Seeder;
use App\Models\CatalogTagStatus;
/**
* Seeder para catálogo de estatus de tags
*
* @author Moisés Cortés C. <moises.cortes@notsoweb.com>
*
* @version 1.0.0
*/
class CatalogTagStatusSeeder extends Seeder
{
/**
* Ejecutar sembrado de base de datos
*/
public function run(): void
{
$statuses = [
[
'code' => 'available',
'name' => 'Disponible',
'description' => 'Tag disponible para ser asignado a un vehículo',
'active' => true,
],
[
'code' => 'assigned',
'name' => 'Asignado',
'description' => 'Tag asignado a un vehículo',
'active' => true,
],
[
'code' => 'cancelled',
'name' => 'Cancelado',
'description' => 'Tag cancelado (incluye perdidos, dañados o reemplazados)',
'active' => true,
],
];
foreach ($statuses as $status) {
CatalogTagStatus::updateOrCreate(
['code' => $status['code']],
$status
);
}
}
}

2
database/seeders/DevSeeder.php
View File

@ -26,6 +26,6 @@ public function run(): void
$this->call(CatalogNameImgSeeder::class);
$this->call(MunicipalitySeeder::class);
$this->call(ModuleSeeder::class);
$this->call(CatalogTagStatusSeeder::class);
}
}