feat(accommodation): implement AccommodationController, AccommodationService, and UpsertAccommodationVariantsRequest for managing accommodations

This commit is contained in:
2026-08-07 14:43:06 -03:00
parent 11776f0734
commit feed3205eb
6 changed files with 563 additions and 0 deletions

View File

@@ -0,0 +1,27 @@
<?php
namespace App\Domains\FiestaFutbolInfantil\Controllers;
use App\Domains\FiestaFutbolInfantil\Requests\UpsertAccommodationVariantsRequest;
use App\Domains\FiestaFutbolInfantil\Resources\AccommodationResource;
use App\Domains\FiestaFutbolInfantil\Services\AccommodationService;
use App\Http\Controllers\Controller;
class AccommodationController extends Controller
{
public function __construct(private readonly AccommodationService $accommodationService) {}
public function store(UpsertAccommodationVariantsRequest $request): AccommodationResource
{
$tenant = $request->user()->tenant()->firstOrFail();
abort_unless($tenant->codigo === 'fiesta_futbol_infantil', 404);
return AccommodationResource::make(
$this->accommodationService->upsertMany(
$tenant,
$request->validated('variants'),
)
);
}
}

View File

@@ -0,0 +1,27 @@
<?php
namespace App\Domains\FiestaFutbolInfantil\Requests;
use Illuminate\Foundation\Http\FormRequest;
class UpsertAccommodationVariantsRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
/** @return array<string, mixed> */
public function rules(): array
{
return [
'variants' => ['required', 'array', 'min:1', 'max:500'],
'variants.*' => ['required', 'array:id,title,description,stock,price'],
'variants.*.id' => ['sometimes', 'nullable', 'integer', 'distinct'],
'variants.*.title' => ['required', 'string', 'max:255'],
'variants.*.description' => ['sometimes', 'nullable', 'string'],
'variants.*.stock' => ['required', 'integer', 'min:0'],
'variants.*.price' => ['required', 'numeric', 'min:0', 'max:99999999.99'],
];
}
}

View File

@@ -0,0 +1,38 @@
<?php
namespace App\Domains\FiestaFutbolInfantil\Resources;
use App\Domains\Catalog\Models\CatalogItem;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
/** @mixin CatalogItem */
class AccommodationResource extends JsonResource
{
/** @return array<string, mixed> */
public function toArray(Request $request): array
{
$typeAttribute = $this->itemAttributes
->first(fn ($itemAttribute) => $itemAttribute->attribute?->codigo === 'tipo_alojamiento');
$options = $typeAttribute?->attribute?->options?->keyBy('value') ?? collect();
return [
'id' => $this->id,
'name' => $this->nombre,
'variants' => $this->variants->map(function ($variant) use ($typeAttribute, $options): array {
$value = $variant->definitions
->firstWhere('item_attribute_id', $typeAttribute?->id)
?->value;
return [
'id' => $variant->id,
'title' => $options->get($value)?->label ?? $value,
'value' => $value,
'description' => $variant->descripcion,
'stock' => $variant->inventory->real_stock,
'price' => number_format($variant->getPrice(), 2, '.', ''),
];
})->values(),
];
}
}

View File

@@ -0,0 +1,269 @@
<?php
namespace App\Domains\FiestaFutbolInfantil\Services;
use App\Domains\Catalog\Enums\EventProductType;
use App\Domains\Catalog\Enums\InventoryPolicy;
use App\Domains\Catalog\Models\Attribute;
use App\Domains\Catalog\Models\AttributeOption;
use App\Domains\Catalog\Models\CatalogItem;
use App\Domains\Catalog\Models\Category;
use App\Domains\Catalog\Models\Inventory;
use App\Domains\Catalog\Models\ItemAttribute;
use App\Domains\Catalog\Models\Variant;
use App\Domains\Tenant\Models\Tenant;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException;
class AccommodationService
{
private const ATTRIBUTE_CODE = 'tipo_alojamiento';
/**
* @param array<int, array<string, mixed>> $variants
*/
public function upsertMany(Tenant $tenant, array $variants): CatalogItem
{
return DB::transaction(function () use ($tenant, $variants): CatalogItem {
$attribute = $this->attribute($tenant);
$accommodation = $this->accommodation($tenant, $variants);
$itemAttribute = $accommodation->itemAttributes()->firstOrCreate(
['attribute_id' => $attribute->id],
['allow_multi_select' => false],
);
$existingVariants = $accommodation->variants()
->with(['inventory', 'definitions'])
->lockForUpdate()
->get();
$resolvedVariants = $this->resolveVariants($variants);
$this->validateValues($resolvedVariants, $existingVariants, $itemAttribute);
foreach ($resolvedVariants as $index => $data) {
$variant = isset($data['id'])
? $existingVariants->firstWhere('id', (int) $data['id'])
: null;
if (isset($data['id']) && $variant === null) {
throw ValidationException::withMessages([
"variants.{$index}.id" => ['La variante no pertenece al producto Alojamiento.'],
]);
}
if ($variant === null) {
$this->createVariant($attribute, $accommodation, $itemAttribute, $data);
} else {
$this->updateVariant($attribute, $variant, $itemAttribute, $data, $index);
}
}
$minimumPrice = $accommodation->variants()->min('precio');
if ($minimumPrice !== null) {
$accommodation->update(['precio' => $minimumPrice]);
}
return $accommodation->fresh()->load([
'itemAttributes.attribute.options',
'variants.catalogItem',
'variants.inventory',
'variants.definitions',
]);
});
}
private function attribute(Tenant $tenant): Attribute
{
$attribute = Attribute::query()
->where('tenant_codigo', $tenant->codigo)
->where('codigo', self::ATTRIBUTE_CODE)
->with('options')
->lockForUpdate()
->first();
if ($attribute === null) {
throw ValidationException::withMessages([
'variants' => ['Falta el atributo requerido tipo_alojamiento.'],
]);
}
return $attribute;
}
/** @param array<int, array<string, mixed>> $variants */
private function accommodation(Tenant $tenant, array $variants): CatalogItem
{
$category = Category::query()->firstOrCreate([
'tenant_code' => $tenant->codigo,
'nombre' => 'Alojamientos',
]);
$accommodation = CatalogItem::query()
->where('tenant_code', $tenant->codigo)
->where('slug', 'alojamiento')
->lockForUpdate()
->first();
if ($accommodation !== null) {
$accommodation->update([
'category_id' => $category->id,
'event_product_type' => EventProductType::Product->value,
'inventory_policy' => InventoryPolicy::Tracked->value,
'has_tickets' => false,
]);
return $accommodation;
}
return CatalogItem::query()->create([
'tenant_code' => $tenant->codigo,
'slug' => 'alojamiento',
'nombre' => 'Alojamiento',
'descripcion' => 'Alojamiento',
'category_id' => $category->id,
'precio' => collect($variants)->min('price') ?? 0,
'event_product_type' => EventProductType::Product->value,
'inventory_policy' => InventoryPolicy::Tracked->value,
'has_tickets' => false,
'inventory_id' => null,
]);
}
/**
* @param array<int, array<string, mixed>> $variants
* @return array<int, array<string, mixed>>
*/
private function resolveVariants(array $variants): array
{
return collect($variants)->map(fn (array $variant): array => [
...$variant,
'title' => trim($variant['title']),
'value' => $this->valueCode($variant['title']),
'description' => $variant['description'] ?? null,
'stock' => (int) $variant['stock'],
])->all();
}
/**
* @param array<int, array<string, mixed>> $incoming
* @param Collection<int, Variant> $existing
*/
private function validateValues(array $incoming, Collection $existing, ItemAttribute $itemAttribute): void
{
$incomingIds = collect($incoming)->pluck('id')->filter()->map(fn ($id): int => (int) $id);
$seen = [];
foreach ($existing->whereNotIn('id', $incomingIds) as $variant) {
$value = $variant->definitions->firstWhere('item_attribute_id', $itemAttribute->id)?->value;
if ($value !== null) {
$seen[mb_strtolower(trim($value))] = true;
}
}
foreach ($incoming as $index => $variant) {
$value = $variant['value'];
if (isset($seen[$value])) {
throw ValidationException::withMessages([
"variants.{$index}.title" => ['Ya existe un tipo de alojamiento con ese título.'],
]);
}
$seen[$value] = true;
}
}
/** @param array<string, mixed> $data */
private function createVariant(
Attribute $attribute,
CatalogItem $accommodation,
ItemAttribute $itemAttribute,
array $data,
): void {
$this->createOption($attribute, $data['value'], $data['title']);
$inventory = Inventory::query()->create(['real_stock' => $data['stock']]);
$variant = $accommodation->variants()->create([
'inventory_id' => $inventory->id,
'descripcion' => $data['description'],
'precio' => $data['price'],
]);
$variant->definitions()->create([
'item_attribute_id' => $itemAttribute->id,
'value' => $data['value'],
]);
}
/** @param array<string, mixed> $data */
private function updateVariant(
Attribute $attribute,
Variant $variant,
ItemAttribute $itemAttribute,
array $data,
int $index,
): void {
$inventory = Inventory::query()
->whereKey($variant->inventory_id)
->lockForUpdate()
->firstOrFail();
if ($data['stock'] < $inventory->reserved_stock) {
throw ValidationException::withMessages([
"variants.{$index}.stock" => [
'El stock no puede ser menor que la cantidad actualmente reservada.',
],
]);
}
$definition = $variant->definitions
->firstWhere('item_attribute_id', $itemAttribute->id);
$option = $definition === null
? null
: $attribute->options->firstWhere('value', $definition->value);
if ($option === null) {
$this->createOption($attribute, $data['value'], $data['title']);
} else {
$option->update([
'value' => $data['value'],
'label' => $data['title'],
]);
}
$variant->update([
'descripcion' => $data['description'],
'precio' => $data['price'],
]);
$inventory->update(['real_stock' => $data['stock']]);
$variant->definitions()->updateOrCreate(
['item_attribute_id' => $itemAttribute->id],
['value' => $data['value']],
);
}
private function createOption(Attribute $attribute, string $value, string $label): AttributeOption
{
$existing = $attribute->options->first(
fn (AttributeOption $option): bool => mb_strtolower($option->value) === $value
);
if ($existing !== null) {
$existing->update(['label' => $label]);
return $existing;
}
$option = $attribute->options()->create([
'value' => $value,
'label' => $label,
'sort_order' => ((int) $attribute->options->max('sort_order')) + 1,
]);
$attribute->options->push($option);
return $option;
}
private function valueCode(string $title): string
{
return mb_strtolower((string) preg_replace('/\s+/u', '_', trim($title)));
}
}

View File

@@ -1,5 +1,6 @@
<?php
use App\Domains\FiestaFutbolInfantil\Controllers\AccommodationController;
use App\Domains\FiestaFutbolInfantil\Controllers\EntryController;
use App\Domains\FiestaFutbolInfantil\Controllers\FoodController;
use Illuminate\Support\Facades\Route;
@@ -11,4 +12,6 @@ Route::prefix('v1/adminapp/tenant')
->name('adminapp.fiesta-futbol-infantil.entries.store');
Route::post('foods', [FoodController::class, 'store'])
->name('adminapp.fiesta-futbol-infantil.foods.store');
Route::post('accommodations', [AccommodationController::class, 'store'])
->name('adminapp.fiesta-futbol-infantil.accommodations.store');
});

View File

@@ -0,0 +1,199 @@
<?php
namespace Tests\Feature\FiestaFutbolInfantil;
use App\Domains\Attachable\Enums\AttachmentType;
use App\Domains\Attachable\Models\Attachment;
use App\Domains\Auth\Models\User;
use App\Domains\Authorization\Enums\RoleCode;
use App\Domains\Catalog\Models\Attribute;
use App\Domains\Shared\Enums\FieldType;
use App\Domains\Tenant\Models\Tenant;
use App\Domains\Tenant\Models\WebsiteType;
use Database\Seeders\AuthorizationSeeder;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Laravel\Sanctum\Sanctum;
use Tests\TestCase;
class AccommodationControllerTest extends TestCase
{
use RefreshDatabase;
protected function setUp(): void
{
parent::setUp();
$this->seed(AuthorizationSeeder::class);
WebsiteType::query()->create([
'codigo' => 'onticket',
'nombre' => 'OnTicket',
]);
}
public function test_authentication_is_required(): void
{
$this->postJson('/api/v1/adminapp/tenant/accommodations', ['variants' => []])
->assertUnauthorized();
}
public function test_it_creates_accommodation_variants_and_adds_type_options(): void
{
[$tenant, $attribute] = $this->configuredTenant();
Sanctum::actingAs($this->createAdminAppUser($tenant));
$this->postJson('/api/v1/adminapp/tenant/accommodations', [
'variants' => [
$this->variantPayload('Casa Rodante Familiar', 'Parcela grande', 25, 45000),
$this->variantPayload('Carpa', null, 100, 35000),
],
])
->assertOk()
->assertJsonPath('data.name', 'Alojamiento')
->assertJsonCount(2, 'data.variants')
->assertJsonPath('data.variants.0.title', 'Casa Rodante Familiar')
->assertJsonPath('data.variants.0.value', 'casa_rodante_familiar')
->assertJsonPath('data.variants.0.description', 'Parcela grande')
->assertJsonPath('data.variants.0.stock', 25)
->assertJsonPath('data.variants.0.price', '45000.00');
$this->assertDatabaseHas('attribute_options', [
'attribute_id' => $attribute->id,
'value' => 'casa_rodante_familiar',
'label' => 'Casa Rodante Familiar',
]);
$this->assertDatabaseHas('attribute_options', [
'attribute_id' => $attribute->id,
'value' => 'carpa',
'label' => 'Carpa',
]);
$this->assertDatabaseCount('catalog_items', 1);
$this->assertDatabaseCount('variantes', 2);
$this->assertDatabaseCount('inventories', 2);
$this->assertDatabaseCount('variant_values', 2);
}
public function test_it_updates_variants_with_an_id_and_creates_variants_without_one(): void
{
[$tenant, $attribute] = $this->configuredTenant();
Sanctum::actingAs($this->createAdminAppUser($tenant));
$created = $this->postJson('/api/v1/adminapp/tenant/accommodations', [
'variants' => [
$this->variantPayload('Casa Rodante', 'Descripción inicial', 20, 40000),
],
])->assertOk();
$variantId = $created->json('data.variants.0.id');
$updated = $this->variantPayload('Casa Rodante Premium', 'Con electricidad', 15, 50000);
$updated['id'] = $variantId;
$this->postJson('/api/v1/adminapp/tenant/accommodations', [
'variants' => [
$updated,
$this->variantPayload('Motor Home', null, 10, 60000),
],
])
->assertOk()
->assertJsonCount(2, 'data.variants')
->assertJsonPath('data.variants.0.id', $variantId)
->assertJsonPath('data.variants.0.title', 'Casa Rodante Premium')
->assertJsonPath('data.variants.0.value', 'casa_rodante_premium')
->assertJsonPath('data.variants.0.stock', 15)
->assertJsonPath('data.variants.1.value', 'motor_home');
$this->assertDatabaseMissing('attribute_options', [
'attribute_id' => $attribute->id,
'value' => 'casa_rodante',
]);
$this->assertDatabaseHas('attribute_options', [
'attribute_id' => $attribute->id,
'value' => 'casa_rodante_premium',
'label' => 'Casa Rodante Premium',
]);
$this->assertDatabaseHas('variant_values', [
'variant_id' => $variantId,
'value' => 'casa_rodante_premium',
]);
$this->assertDatabaseCount('variantes', 2);
}
public function test_it_rejects_duplicate_normalized_titles(): void
{
[$tenant] = $this->configuredTenant();
Sanctum::actingAs($this->createAdminAppUser($tenant));
$this->postJson('/api/v1/adminapp/tenant/accommodations', [
'variants' => [
$this->variantPayload('Casa Rodante', null, 10, 40000),
$this->variantPayload(' CASA RODANTE ', null, 10, 40000),
],
])
->assertUnprocessable()
->assertJsonValidationErrors('variants.1.title');
$this->assertDatabaseCount('catalog_items', 0);
$this->assertDatabaseCount('attribute_options', 0);
}
/** @return array{Tenant, Attribute} */
private function configuredTenant(): array
{
$headerLogo = Attachment::query()->create([
'path' => 'test/header.png',
'filename' => 'header.png',
'type' => AttachmentType::Image,
'mime_type' => 'image/png',
]);
$footerLogo = Attachment::query()->create([
'path' => 'test/footer.png',
'filename' => 'footer.png',
'type' => AttachmentType::Image,
'mime_type' => 'image/png',
]);
$tenant = Tenant::query()->create([
'codigo' => 'fiesta_futbol_infantil',
'nombre' => 'Fiesta Fútbol Infantil',
'dominio' => 'fiesta.test',
'primary_color' => '#112233',
'secondary_color' => '#445566',
'danger_color' => '#cc0000',
'header_bg_color' => '#ffffff',
'footer_bg_color' => '#111111',
'header_logo_id' => $headerLogo->id,
'footer_logo_id' => $footerLogo->id,
'website_type_code' => 'onticket',
]);
$attribute = Attribute::query()->create([
'tenant_codigo' => $tenant->codigo,
'codigo' => 'tipo_alojamiento',
'nombre' => 'TipoAlojamiento',
'type' => FieldType::Select,
'is_required' => true,
]);
return [$tenant, $attribute];
}
/** @return array<string, mixed> */
private function variantPayload(
string $title,
?string $description,
int $stock,
float $price,
): array {
return [
'title' => $title,
'description' => $description,
'stock' => $stock,
'price' => $price,
];
}
private function createAdminAppUser(Tenant $tenant): User
{
return User::factory()->create([
'rol_codigo' => RoleCode::AdminApp->value,
'tenant_codigo' => $tenant->codigo,
]);
}
}