feat(contact): implement contact management with endpoints for retrieving and updating contact details
This commit is contained in:
@@ -0,0 +1,22 @@
|
||||
<?php
|
||||
|
||||
namespace App\Domains\Core\Tenant\Controllers\AdminApp;
|
||||
|
||||
use App\Domains\Core\Tenant\Requests\AdminApp\UpdateContactRequest;
|
||||
use App\Domains\Core\Tenant\Resources\AdminApp\ContactResource;
|
||||
use App\Domains\Core\Tenant\Services\ContactService;
|
||||
use App\Http\Controllers\Controller;
|
||||
use Illuminate\Http\Request;
|
||||
|
||||
class ContactController extends Controller
|
||||
{
|
||||
public function show(Request $request, ContactService $service): ContactResource
|
||||
{
|
||||
return ContactResource::make($service->load($request->user()->tenant()->firstOrFail()));
|
||||
}
|
||||
|
||||
public function update(UpdateContactRequest $request, ContactService $service): ContactResource
|
||||
{
|
||||
return ContactResource::make($service->update($request->user()->tenant()->firstOrFail(), $request->validated()));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
<?php
|
||||
|
||||
namespace App\Domains\Core\Tenant\Requests\AdminApp;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class UpdateContactRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
$tenantCode = $this->user()->tenant_codigo;
|
||||
|
||||
return [
|
||||
'social_media' => ['present', 'array', 'max:30'],
|
||||
'social_media.*' => ['array:code,url'],
|
||||
'social_media.*.code' => ['required', 'string', 'distinct', Rule::exists('social_media', 'code')],
|
||||
'social_media.*.url' => ['required', 'url:http,https', 'max:255'],
|
||||
'addresses' => ['present', 'array', 'list', 'max:50'],
|
||||
'addresses.*' => ['array:id,address_text,is_main'],
|
||||
'addresses.*.id' => ['nullable', 'integer', 'distinct', Rule::exists('tenant_addresses', 'address_id')->where('tenant_codigo', $tenantCode)],
|
||||
'addresses.*.address_text' => ['required', 'string', 'max:1000'],
|
||||
'addresses.*.is_main' => ['sometimes', 'boolean'],
|
||||
'phone_numbers' => ['present', 'array', 'list', 'max:50'],
|
||||
'phone_numbers.*' => ['array:id,country_code,mobile_prefix,area_code,local_number,is_main'],
|
||||
'phone_numbers.*.id' => ['nullable', 'integer', 'distinct', Rule::exists('tenant_phone_numbers', 'phone_number_id')->where('tenant_codigo', $tenantCode)],
|
||||
'phone_numbers.*.country_code' => ['present', 'nullable', 'regex:/^\+[0-9]{1,4}$/'],
|
||||
'phone_numbers.*.mobile_prefix' => ['present', 'nullable', 'regex:/^[0-9]{1,4}$/'],
|
||||
'phone_numbers.*.area_code' => ['present', 'nullable', 'regex:/^[0-9]{1,8}$/'],
|
||||
'phone_numbers.*.local_number' => ['required', 'string', 'max:50', 'regex:/^[0-9+() .-]+$/', 'regex:/[0-9]/'],
|
||||
'phone_numbers.*.is_main' => ['sometimes', 'boolean'],
|
||||
];
|
||||
}
|
||||
|
||||
public function attributes(): array
|
||||
{
|
||||
return [
|
||||
'social_media' => 'redes sociales',
|
||||
'social_media.*.code' => 'red social',
|
||||
'social_media.*.url' => 'URL de la red social',
|
||||
'addresses' => 'direcciones',
|
||||
'addresses.*.id' => 'dirección',
|
||||
'addresses.*.address_text' => 'dirección',
|
||||
'addresses.*.is_main' => 'dirección principal',
|
||||
'phone_numbers' => 'teléfonos',
|
||||
'phone_numbers.*.id' => 'teléfono',
|
||||
'phone_numbers.*.country_code' => 'código de país',
|
||||
'phone_numbers.*.mobile_prefix' => 'prefijo móvil',
|
||||
'phone_numbers.*.area_code' => 'código de área',
|
||||
'phone_numbers.*.local_number' => 'número de teléfono',
|
||||
'phone_numbers.*.is_main' => 'teléfono principal',
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'required' => 'Completá :attribute.',
|
||||
'url' => 'La URL debe ser válida y comenzar con http:// o https://.',
|
||||
'regex' => 'El formato de :attribute no es válido.',
|
||||
'exists' => 'El valor de :attribute no está disponible para este comercio.',
|
||||
'distinct' => 'Hay un valor duplicado en :attribute.',
|
||||
'max.string' => 'El campo :attribute admite hasta :max caracteres.',
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,23 @@
|
||||
<?php
|
||||
|
||||
namespace App\Domains\Core\Tenant\Resources\AdminApp;
|
||||
|
||||
use App\Domains\Core\PhoneNumber\Resources\PhoneNumberResource;
|
||||
use App\Domains\Core\Tenant\Resources\TenantAddressResource;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Http\Resources\Json\JsonResource;
|
||||
|
||||
class ContactResource extends JsonResource
|
||||
{
|
||||
public function toArray(Request $request): array
|
||||
{
|
||||
return [
|
||||
'social_media' => $this->socialMedia->map(fn ($network) => [
|
||||
'code' => $network->code,
|
||||
'url' => $network->pivot->url,
|
||||
])->values(),
|
||||
'addresses' => TenantAddressResource::collection($this->addresses),
|
||||
'phone_numbers' => PhoneNumberResource::collection($this->phoneNumbers),
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -105,6 +105,13 @@ class TenantResource extends JsonResource
|
||||
])
|
||||
->values()
|
||||
),
|
||||
'tenant_social_media' => $this->whenLoaded('socialMedia', fn () => $this->socialMedia
|
||||
->map(fn ($socialMedia) => [
|
||||
'code' => $socialMedia->code,
|
||||
'icon' => $socialMedia->icon,
|
||||
'name' => $socialMedia->name,
|
||||
'url' => $socialMedia->pivot->url,
|
||||
])->values()),
|
||||
'menues' => $this->whenLoaded(
|
||||
'menues',
|
||||
fn () => $this->menuTree($this->menues)
|
||||
|
||||
73
app/Domains/Core/Tenant/Services/ContactService.php
Normal file
73
app/Domains/Core/Tenant/Services/ContactService.php
Normal file
@@ -0,0 +1,73 @@
|
||||
<?php
|
||||
|
||||
namespace App\Domains\Core\Tenant\Services;
|
||||
|
||||
use App\Domains\Core\Address\Models\Address;
|
||||
use App\Domains\Core\PhoneNumber\Models\PhoneNumber;
|
||||
use App\Domains\Core\Tenant\Models\Tenant;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
|
||||
class ContactService
|
||||
{
|
||||
public function load(Tenant $tenant): Tenant
|
||||
{
|
||||
return $tenant->load([
|
||||
'socialMedia',
|
||||
'addresses' => fn ($query) => $query->reorder()->orderByPivot('is_main', 'desc')->orderByPivot('id'),
|
||||
'phoneNumbers',
|
||||
]);
|
||||
}
|
||||
|
||||
public function update(Tenant $tenant, array $data): Tenant
|
||||
{
|
||||
return DB::transaction(function () use ($tenant, $data): Tenant {
|
||||
// Serialize contact writes, including changes to the principal links.
|
||||
Tenant::query()->whereKey($tenant->id)->lockForUpdate()->firstOrFail();
|
||||
$social = [];
|
||||
foreach ($data['social_media'] as $index => $item) {
|
||||
$social[$item['code']] = ['url' => $item['url'], 'orden' => $index];
|
||||
}
|
||||
$tenant->socialMedia()->sync($social);
|
||||
|
||||
foreach (['addresses', 'phone_numbers'] as $collection) {
|
||||
$relation = $collection === 'addresses' ? $tenant->addresses() : $tenant->phoneNumbers();
|
||||
$existing = $relation->get()->keyBy('id');
|
||||
$links = [];
|
||||
foreach (array_values($data[$collection]) as $index => $item) {
|
||||
$id = $item['id'] ?? null;
|
||||
if ($id !== null && ! $existing->has($id)) {
|
||||
throw ValidationException::withMessages(["{$collection}.{$index}.id" => 'El contacto no pertenece al comercio.']);
|
||||
}
|
||||
$record = $id === null
|
||||
? ($collection === 'addresses' ? new Address : new PhoneNumber)
|
||||
: $existing->get($id);
|
||||
$attributes = collect($item)->except(['id', 'is_main'])->all();
|
||||
$record->fill($attributes);
|
||||
if (! $record->exists) {
|
||||
$record->label = $collection === 'addresses' ? 'Dirección' : 'Teléfono';
|
||||
}
|
||||
if ($record->exists && $record->isDirty()) {
|
||||
$shared = $record->tenants()->where('tenants.codigo', '!=', $tenant->codigo)->exists()
|
||||
|| ($record instanceof Address && $record->events()->exists());
|
||||
if ($shared) {
|
||||
$record = $record->replicate();
|
||||
}
|
||||
// An edited street address must not retain coordinates for the old location.
|
||||
if ($record instanceof Address && $record->isDirty('address_text')) {
|
||||
$record->latitude = null;
|
||||
$record->longitude = null;
|
||||
}
|
||||
}
|
||||
$record->save();
|
||||
$links[$record->id] = ['is_main' => $index === 0];
|
||||
}
|
||||
// Clear the previous principal before sync to respect the unique index.
|
||||
$relation->newPivotStatement()->where('tenant_codigo', $tenant->codigo)->update(['is_main' => false]);
|
||||
$relation->sync($links);
|
||||
}
|
||||
|
||||
return $this->load($tenant);
|
||||
});
|
||||
}
|
||||
}
|
||||
@@ -28,9 +28,16 @@ El par `(dominio, base_path)` es único. Un mismo dominio puede alojar el tenant
|
||||
- `GET /tenants`, `GET /tenants/{codigo}` y `DELETE /tenants/{codigo}`.
|
||||
- La creación y actualización general de tenants se administran mediante seeders o base de datos; no se exponen por API.
|
||||
- Bajo `/v1/adminapp/tenant/website-extras`, con autenticación y contexto de tenant: consulta general, detalle, actualización y activación/desactivación.
|
||||
- `GET /v1/adminapp/tenant/contact` y `PUT /v1/adminapp/tenant/contact`, con `auth:sanctum` y `adminapp.tenant`: consulta y reemplazo completo del contacto del comercio autenticado.
|
||||
|
||||
El PUT de contacto recibe `social_media` (`code`, `url`), `addresses` (`id` opcional para existentes, `address_text`) y `phone_numbers` (`id` opcional, `country_code`, `mobile_prefix`, `area_code`, `local_number`). Las tres colecciones son obligatorias; un array vacío elimina sus vínculos. El primer elemento enviado en cada lista de direcciones o teléfonos es siempre el principal: el backend calcula `is_main` por posición e ignora las marcas enviadas por clientes anteriores. GET y PUT devuelven el principal primero para conservarlo en el siguiente guardado. Los IDs existentes deben estar vinculados al comercio autenticado. Todos los cambios se realizan en una transacción, serializada por tenant, y la respuesta devuelve los registros persistidos y sus IDs.
|
||||
|
||||
Se conservan etiquetas y coordenadas de direcciones sin modificar; al cambiar el texto se limpian las coordenadas para evitar mostrar el mapa de una ubicación anterior. Las ediciones de registros compartidos crean una copia para el comercio, preservando otros comercios y eventos. Las bajas desvinculan registros sin borrar datos compartidos.
|
||||
|
||||
Contacto administra exclusivamente las redes del comercio. `TenantResource.tenant_social_media` siempre expone esas redes y alimenta Contacto y el footer públicos. `social_media` mantiene la selección histórica del evento activo; `event.social_media` sigue disponible para las vistas de evento. Guardar Contacto no modifica redes del evento.
|
||||
|
||||
## Dependencias y reglas
|
||||
|
||||
Usa `Attachable` para logos y archivos. Es referenciado por casi todos los dominios para aislamiento. El `codigo` es clave de ruta y clave foránea heredada; no debe sustituirse por `id` sin una migración integral.
|
||||
|
||||
Los resources exponen `phone_numbers` (incluye `is_main`) y `main_phone_number`, con `id`, `label`, `number` y `tel_url`. Contacto muestra la colección y el footer usa el principal. La migración copia primero `tenants.phone` como principal y luego el teléfono de `help.contact`, si es distinto; si no existe teléfono del tenant, el del menú pasa a ser principal. Los duplicados por formato se comparan dentro de cada tenant sin inferir país ni código de área. Los campos anteriores se conservan como datos legacy, pero la tienda consume las relaciones nuevas. No hay endpoints de edición de teléfonos ni cambios del adminapp en esta etapa.
|
||||
Los resources exponen `phone_numbers` (incluye `is_main`) y `main_phone_number`, con `id`, `label`, `number` y `tel_url`. Contacto muestra la colección y el footer usa el principal. La migración copia primero `tenants.phone` como principal y luego el teléfono de `help.contact`, si es distinto; si no existe teléfono del tenant, el del menú pasa a ser principal. Los duplicados por formato se comparan dentro de cada tenant sin inferir país ni código de área. Los campos anteriores se conservan como datos legacy, pero la tienda consume las relaciones nuevas y el adminapp las edita mediante el endpoint de contacto.
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
<?php
|
||||
|
||||
use App\Domains\Core\Tenant\Controllers\AdminApp\BrandController;
|
||||
use App\Domains\Core\Tenant\Controllers\AdminApp\ContactController;
|
||||
use App\Domains\Core\Tenant\Controllers\AdminApp\HelpMenuController;
|
||||
use App\Domains\Core\Tenant\Controllers\AdminApp\WebsiteExtraController;
|
||||
use Illuminate\Support\Facades\Route;
|
||||
@@ -8,6 +9,8 @@ use Illuminate\Support\Facades\Route;
|
||||
Route::prefix('v1/adminapp/tenant')
|
||||
->middleware(['auth:sanctum', 'adminapp.tenant'])
|
||||
->group(function (): void {
|
||||
Route::get('contact', [ContactController::class, 'show']);
|
||||
Route::put('contact', [ContactController::class, 'update']);
|
||||
Route::get('brand', [BrandController::class, 'show']);
|
||||
Route::put('brand', [BrandController::class, 'update']);
|
||||
Route::get('help-menus', [HelpMenuController::class, 'index']);
|
||||
|
||||
Reference in New Issue
Block a user