13 - Mapa de Páginas del Frontend

Notas Clave sobre Desviaciones de Contrato

resources/js/pages/settings/Profile.vue envía form.useForm({ name, email }) (líneas 31-34) y el Input del formulario solo enlaza form.name, mientras que ProfileUpdateRequest valida nombres y apellidos (app/Http/Requests/Settings/ProfileUpdateRequest.php:19-20). El envío del formulario de perfil en settings siempre falla la validación.
useWishlist() (resources/js/composables/useWishlist.ts:29) consume la respuesta como Array.isArray(data) ? data.map(...) : [], pero ListaDeseoController@index retorna ListaDeseoService::obtenerListaDeseos() que es un objeto JSON LengthAwarePaginator. Por lo tanto, el load() del composable siempre asigna items a [] e isInWishlist siempre retorna false.
resources/js/pages/Wishlist/Index.vue maneja el paginador correctamente a través de data?.data ?? data (línea 56), por lo que la página dedicada de wishlist funciona mientras que el composable usado por home/tarjetas de producto no.
resources/js/pages/ally/ventas/Page.vue:88 colorea el badge para un valor de EstadoVenta 'cancelada', pero el enum real (app/Enum/Facturacion/EstadoVenta.php) solo tiene RECHAZADA y ABANDONADA para estados terminales de falla. La rama es inalcanzable.
Conteo de páginas: find resources/js/pages -type f -name '*.vue' | wc -l retorna 58. Ese total incluye sub-componentes embebidos (home/*, product/Seller|Similar|Recently, user/*Modal*, ally/auth/register/steps/Step1..4, ally/empresas/components/*, ally/usuarios/components/*) que no son páginas Inertia independientes. Las rutas Inertia independientes contadas en la sección 1 son aproximadamente 41.

1. Inventario Completo de Páginas

1.1 Páginas del Marketplace (Orientadas al Cliente)

Ruta del Archivo	Nombre de Ruta	Layout	Requiere Auth	Props Recibidas
`pages/Index.vue`	`home`	MarketLayout	No	Solo compartidas (`user_stats`, `brands_allied`, `popular_categories`, `is_logged`)
`pages/ErrorPage.vue`	(fallback)	ErrorLayout	No	`status` (código HTTP)
`pages/ConsultarCupo/Index.vue`	`consultar-cupo.view`	Ninguno (standalone)	No	Ninguna (formulario standalone)
`pages/product/Detail.vue`	`productos.show`	MarketLayout	No	`product`, `preview`
`pages/product/Search/List.vue`	`productos.search`	MarketLayout	No	`initialProdcutos`, `pagination`
`pages/Simulator/Index.vue`	`simulador.view`	MarketLayout	No (auth removido vía `withoutMiddleware`)	Config `credito` compartida
`pages/Wishlist/Index.vue`	`lista-deseos.view`	MarketLayout	Sí (`auth`)	Ninguna (obtiene vía axios)
`pages/Checkout/Index.vue`	`checkout.view`	MarketLayout	Sí (`auth` + `cliente_registro_completo` + `verificar_cliente_presenta_mora`)	Compartidas `carritoData`, `clienteData`, `credito`
`pages/Compras/Index.vue`	`cliente.compras.index`	MarketLayout	Sí (`auth`)	`ordenes` (paginadas), `filtros`
`pages/Compras/Show.vue`	`cliente.compras.show`	MarketLayout	Sí (`auth`)	`orden` (con ventas, detalles, user)

1.2 Páginas de Auth del Cliente

Ruta del Archivo	Nombre de Ruta	Layout	Requiere Auth	Props Recibidas
`pages/auth/Register.vue`	`register`	MarketLayout	Solo invitado	Compartidas `links` (terms, privacy)
`pages/auth/ConfirmPassword.vue`	`password.confirm`	AuthLayout	Sí (`auth:web`)	Ninguna
`pages/auth/ResetPassword.vue`	`password.reset`	MarketLayout	Solo invitado	`token`, `email`
`pages/auth/VerifyEmail.vue`	`verification.notice`	MarketLayout	Sí (`auth:web`)	Controller: `status`, `email`. Compartidas: `resend_wait_seconds`

1.3 Páginas de Usuario del Cliente

Ruta del Archivo	Nombre de Ruta	Layout	Requiere Auth	Props Recibidas
`pages/user/Perfil.vue`	`user.perfil`	MarketLayout	Sí (`auth` + `verified`)	Controller: `userData`, `personaData`, `clienteData`
`pages/user/Completar.vue`	`user.completar-registro.render`	MarketLayout	Sí (`auth` + `verified`)	Ninguna (formulario standalone)
`pages/user/ModalValidate.vue`	(componente en Perfil)	—	—	`open`, `closable` (props del padre)
`pages/user/ChangePasswordModal.vue`	(componente en Perfil)	—	—	`open`, `closable`
`pages/user/UpdatePhoneModal.vue`	(componente en Perfil)	—	—	`open`, `closable`, `initialPhone`

1.4 Páginas de Settings del Cliente

Ruta del Archivo	Nombre de Ruta	Layout	Requiere Auth	Props Recibidas
`pages/settings/Profile.vue`	`profile.edit`	AppLayout > SettingsLayout	Sí (`auth:web`)	`mustVerifyEmail`, `status`
`pages/settings/Password.vue`	`password.edit`	AppLayout > SettingsLayout	Sí (`auth:web`)	Ninguna
`pages/settings/Appearance.vue`	`appearance`	AppLayout > SettingsLayout	Sí (`auth:web`)	Ninguna

1.5 Páginas del Portal de Aliados

Ruta del Archivo	Nombre de Ruta	Layout	Requiere Auth	Props Recibidas
`pages/ally/Dashboard.vue`	`aliado.dashboard`	AllyLayout	Sí (`auth:app`)	`sucursalId`, `sucursales`, `isGlobalRole`
`pages/ally/ventas/Page.vue`	`aliado.ventas.render`	AllyLayout	Sí (`auth:app`)	`sucursalId`, `sucursales`, `isGlobalRole`
`pages/ally/ventas/Show.vue`	`aliado.ventas.show`	AllyLayout	Sí (`auth:app`)	`venta` (con detalles, user, cuotas)
`pages/ally/ventas/create/create.vue`	`aliado.ventas.create`	AllyLayout	Sí (`auth:app`)	Controller: `sucursalId`, `sucursales`. Compartidas: `credito`, `lineas`
`pages/ally/productos/Page.vue`	`aliado.productos.render`	AllyLayout	Sí (`auth:app`)	Ninguna (obtiene vía axios)
`pages/ally/productos/Revision.vue`	`aliado.productos.revision`	AllyLayout	Sí (`auth:app`)	Ninguna (obtiene vía axios)
`pages/ally/productos/crear/AddProduct.vue`	(componente)	—	—	Props de edición de producto
`pages/ally/pedidos/Page.vue`	`aliado.pedidos.render`	AllyLayout	Sí (`auth:app`)	`sucursalId`, `sucursales`
`pages/ally/marcas/Page.vue`	`aliado.marcas.render`	AllyLayout	Sí (`auth:app`)	Ninguna (obtiene vía axios)
`pages/ally/empresas/Page.vue`	`aliado.empresas.render`	AllyLayout	Sí (`auth:app`)	Ninguna (obtiene vía axios)
`pages/ally/sucursales/Page.vue`	`aliado.sucursales.render`	AllyLayout	Sí (`auth:app`)	Ninguna (obtiene vía axios)
`pages/ally/empleados/Page.vue`	`aliado.empleados.render`	AllyLayout	Sí (`auth:app`)	Ninguna (obtiene vía axios)
`pages/ally/usuarios/Page.vue`	`aliado.usuarios.render`	AllyLayout	Sí (`auth:app`)	Ninguna (obtiene vía axios)
`pages/ally/postulaciones/Page.vue`	`aliado.postulacion.revision`	AllyLayout	Sí (`auth:app`)	Ninguna (obtiene vía axios)

1.6 Páginas de Auth del Aliado

Ruta del Archivo	Nombre de Ruta	Layout	Requiere Auth	Props Recibidas
`pages/ally/auth/Login.vue`	`login` (guard app)	Ninguno (standalone + AllyFooter)	Invitado (`guest:app`)	`errors` del servidor vía `$page.props.errors`
`pages/ally/auth/ForgotPassword.vue`	`aliado.password.request`	Ninguno (standalone + AllyFooter)	Invitado (`guest:app`)	Ninguna
`pages/ally/auth/ResetPassword.vue`	`aliado.password.reset`	Ninguno (standalone + AllyFooter)	Invitado (`guest:app`)	`token`, `email`
`pages/ally/auth/Postulacion.vue`	`aliado-postulacion.create`	Ninguno (standalone + AllyFooter)	No	Compartidas `lineas`, `links.terms`
`pages/ally/auth/register/Page.vue`	`aliado-postulacion.register`	Ninguno (standalone + AllyFooter)	Sí (`auth:app` + `signed`)	`postulacion`, compartidas `lineas`

Nota: resources/js/services/errorLogger.ts existe como un servicio central usado por ambos plugins de errores (errorHandling y errorInterceptor) pero no es un componente de página y por lo tanto no se lista en el inventario de páginas anterior.

Nota: pages/ally/auth/register/steps/Step1.vue hasta Step4.vue existen como sub-componentes del flujo de registro de aliado (pages/ally/auth/register/Page.vue) y no son páginas standalone.

1.7 Sub-componentes del Home (No son páginas standalone — embebidos en Index.vue)

Ruta del Archivo	Fuente de Datos	Composables Usados
`pages/home/Brand.vue`	`$page.props.brands_allied`	—
`pages/home/Ofertas.vue`	`$page.props.user_stats.ofertas_del_dia`	`useWishlist`
`pages/home/MasVendidos.vue`	`$page.props.user_stats.mas_vendidos`	`useWishlist`
`pages/home/Encantar.vue`	`$page.props.user_stats.encantar`	`useWishlist`
`pages/home/Intereses.vue`	`$page.props.user_stats.intereses`	`useWishlist`
`pages/home/ProductCategories.vue`	`$page.props.popular_categories`, `$page.props.user_stats`	—
`pages/home/Join.vue`	—	—
`pages/home/Info.vue`	— (actualmente comentado)	—

1.8 Sub-componentes de Producto (Embebidos en Detail.vue)

Ruta del Archivo	Fuente de Datos
`pages/product/Seller.vue`	`$page.props.user_stats.intereses` + prop `seller`
`pages/product/Similar.vue`	`$page.props.user_stats.intereses`
`pages/product/Recently.vue`	`$page.props.user_stats.intereses`

2. Jerarquía de Layouts

2.1 Inventario de Layouts

Layout	Archivo	Provee	Usado Por
MarketLayout	`layouts/MarketLayout.vue`	Navbar (header de market con búsqueda, carrito, menú de usuario, categorías) + FooterApp	Index, Register, ResetPassword, VerifyEmail, Perfil, Completar, Compras/, Checkout, Wishlist, Simulator, product/
AllyLayout	`layouts/AllyLayout.vue`	Ally Navbar (navegación de sidebar)	Todas las páginas autenticadas de `ally/*` (Dashboard, Ventas, Productos, Marcas, etc.)
AuthLayout	`layouts/AuthLayout.vue`	Envuelve `AuthSimpleLayout` — formulario centrado minimalista	ConfirmPassword
AppLayout	`layouts/AppLayout.vue`	Envuelve `AppSidebarLayout` — sidebar + breadcrumbs	páginas de settings/* (Profile, Password, Appearance)
ErrorLayout	`layouts/ErrorLayout.vue`	Header minimalista (logo + “Marketplace”) + contenido centrado + footer	ErrorPage
Ninguno (standalone)	—	Layouts standalone personalizados con AllyFooter o markup desnudo	Páginas de auth del Aliado (Login, ForgotPassword, ResetPassword, Postulacion, Register), ConsultarCupo

2.2 Sub-componentes de Layout

Sub-layout	Archivo	Padre
`AppSidebarLayout`	`layouts/app/AppSidebarLayout.vue`	Usado por AppLayout
`AppHeaderLayout`	`layouts/app/AppHeaderLayout.vue`	Layout alternativo de app (no usado actualmente)
`AuthSimpleLayout`	`layouts/auth/AuthSimpleLayout.vue`	Usado por AuthLayout
`AuthCardLayout`	`layouts/auth/AuthCardLayout.vue`	Layout alternativo de auth (no usado actualmente)
`AuthSplitLayout`	`layouts/auth/AuthSplitLayout.vue`	Layout alternativo de auth (no usado actualmente)
`SettingsLayout`	`layouts/settings/Layout.vue`	Anidado dentro de AppLayout en páginas de settings

2.3 Mapeo de Layout a Página

MarketLayout
  +-- Index.vue (home)
  +-- auth/Register.vue
  +-- auth/ResetPassword.vue
  +-- auth/VerifyEmail.vue
  +-- product/Detail.vue
  +-- product/Search/List.vue
  +-- Checkout/Index.vue
  +-- Compras/Index.vue
  +-- Compras/Show.vue
  +-- Wishlist/Index.vue
  +-- Simulator/Index.vue
  +-- user/Perfil.vue
  +-- user/Completar.vue

AllyLayout
  +-- ally/Dashboard.vue
  +-- ally/ventas/Page.vue
  +-- ally/ventas/Show.vue
  +-- ally/ventas/create/create.vue
  +-- ally/productos/Page.vue
  +-- ally/productos/Revision.vue
  +-- ally/pedidos/Page.vue
  +-- ally/marcas/Page.vue
  +-- ally/empresas/Page.vue
  +-- ally/sucursales/Page.vue
  +-- ally/empleados/Page.vue
  +-- ally/usuarios/Page.vue
  +-- ally/postulaciones/Page.vue

AppLayout > SettingsLayout
  +-- settings/Profile.vue
  +-- settings/Password.vue
  +-- settings/Appearance.vue

AuthLayout
  +-- auth/ConfirmPassword.vue

ErrorLayout
  +-- ErrorPage.vue

Standalone (sin envoltura de layout)
  +-- ConsultarCupo/Index.vue
  +-- ally/auth/Login.vue
  +-- ally/auth/ForgotPassword.vue
  +-- ally/auth/ResetPassword.vue
  +-- ally/auth/Postulacion.vue
  +-- ally/auth/register/Page.vue

3. Props Inertia Compartidas (HandleInertiaRequests)

Todas las páginas reciben estas props vía el middleware HandleInertiaRequests:

Clave de Prop	Tipo	Descripción
`name`	`string`	Nombre de la app desde `config('app.name')`
`quote`	`{message, author}`	Frase inspiracional aleatoria
`ziggy`	`object`	Definiciones de rutas Ziggy + URL actual
`is_logged`	`boolean`	Si el usuario está autenticado
`is_register_view`	`boolean`	Verdadero cuando está en la ruta de registro
`sidebarOpen`	`boolean`	Estado del sidebar desde cookie
`links.faq`	`string`	URL del FAQ
`links.about`	`string`	URL de la página About
`links.sic`	`string`	URL del SIC
`links.terms`	`string`	URL de términos y condiciones
`links.privacy`	`string`	URL de política de privacidad
`resend_wait_seconds`	`number`	Segundos a esperar antes de reenviar correo de verificación (predeterminado 60)
`max_search_results`	`number`	Máximo de resultados de búsqueda (predeterminado 10)
`credito.dias_desfase`	`number`	Días de desfase del crédito
`credito.tasa_nominal`	`number`	Tasa de interés nominal mensual (decimal)
`credito.seguro_vida`	`number`	Tasa de seguro de vida (decimal)
`credito.porcentaje_fianza`	`number`	Porcentaje de fianza
`credito.monto_estudio_credito`	`number`	Tarifa de estudio de crédito (absoluta)
`lineas`	`array`	Líneas de productos (cacheadas, vía `LineaService`)
`brands_allied`	`array`	Todas las marcas (cacheadas, `Marca::all()`)
`popular_categories`	`array`	Top 8 categorías populares (cacheadas)
`auth.user`	`User\|null`	Objeto del usuario autenticado
`auth.role`	`string\|null`	Rol del usuario vía `$user->rol()`

Props Compartidas Condicionales

Cuando el usuario tiene una empresa (aliado/admin):

Clave de Prop	Tipo	Descripción
`empresa`	`object`	Registro de Empresa con la relación `lineas` cargada

Cuando el usuario es un cliente (sin empresa):

Clave de Prop	Tipo	Descripción
`user_stats`	`object`	Estadísticas de productos: `intereses`, `ofertas_del_dia`, `mas_vendidos`, `encantar`
`auth.clienteData`	`object\|null`	Registro de Cliente (cupo_disponible, cupo_asignado, etc.)
`auth.carritoData`	`array`	Ítems del carrito de compras con información de producto/precio/línea

4. Props Específicas por Página

Página	Props del Controlador
ErrorPage	`status` (código de estado HTTP: 403, 404, 419, 500, 503)
product/Detail	`product` (producto completo con precios, imagenes), `preview` (boolean)
product/Search/List	`initialProdcutos` (array de productos), `pagination` (meta del paginador de Laravel)
Compras/Index	`ordenes` (paginadas: data, current_page, last_page, links), `filtros` (estado, search, fecha_inicio, fecha_fin)
Compras/Show	`orden` (con relaciones ventas, detalles, user, sucursal)
auth/ResetPassword	`token` (string), `email` (string)
settings/Profile	`mustVerifyEmail` (boolean), `status` (string, opcional)
ally/Dashboard	`sucursalId` (number), `sucursales` (array), `isGlobalRole` (boolean)
ally/ventas/Page	`sucursalId`, `sucursales`, `isGlobalRole`
ally/ventas/Show	`venta` (con detalles, user, persona, cuotas, sucursal)
ally/pedidos/Page	`sucursalId`, `sucursales`
ally/auth/ResetPassword	`token`, `email`
ally/auth/register/Page	`postulacion` (objeto postulacion con datos de empresa)

5. Llamadas API del Frontend

5.1 Marketplace del Cliente

Página / Componente	Método	Endpoint (Nombre de Ruta)	Propósito
Compras/Index	`GET`	`cliente.compras.index`	Obtener órdenes filtradas/paginadas
Compras/Show	—	(Inertia `router.get`)	Navegar al detalle de la orden
Checkout/Index	`PUT`	`carrito.update`	Actualizar cantidad de ítem del carrito
Checkout/Index	`POST`	`carrito.store`	Agregar ítem al carrito
Checkout/Index	`DELETE`	`carrito.destroy`	Remover ítem del carrito
Checkout/Index	`POST`	`cliente.compras.store`	Enviar orden de compra
product/Detail	`POST`	`carrito.store`	Agregar producto al carrito
Wishlist/Index	`GET`	`lista-deseos.index`	Obtener wishlist paginada
Wishlist/Index	`DELETE`	`lista-deseos.destroy`	Remover de la wishlist
ConsultarCupo/Index	`POST`	`consultar-cupo.store`	Consultar cupo de crédito por contrato
user/Perfil	`GET`	`cliente.compras.index`	Obtener compras recientes (per_page=5)
user/Perfil	`GET`	`user.aprobar-cupo.verificar-limite-intentos`	Verificar límites diarios de intentos de crédito
user/Completar	`POST`	`user.completar-registro.store`	Enviar formulario de completar registro
user/ChangePasswordModal	`PUT`	`user.password.update`	Actualizar contraseña
user/UpdatePhoneModal	`PUT`	`user.phone.update`	Actualizar número de teléfono
user/ModalValidate	`GET`	`user.aprobar-cupo.legal-check`	Paso 1: Verificación legal
user/ModalValidate	`GET`	`user.aprobar-cupo.identity-validation`	Paso 2: Validación de identidad
user/ModalValidate	`GET`	`user.aprobar-cupo.identity-validation-generate-otp`	Paso 3: Generar OTP
user/ModalValidate	`POST`	`user.aprobar-cupo.identity-validation-verify-otp`	Paso 4: Verificar OTP
user/ModalValidate	`GET`	`user.aprobar-cupo.identity-validation-generate-questions`	Paso 5: Generar preguntas de seguridad
user/ModalValidate	`POST`	`user.aprobar-cupo.identity-validation-verify-questions`	Paso 6: Verificar preguntas de seguridad
user/ModalValidate	`GET`	`user.aprobar-cupo.hdc-validation`	Paso 7: Validación HDC
user/ModalValidate	`GET`	`user.aprobar-cupo.obtener-cupo`	Paso 8: Aprobar cupo de crédito
auth/VerifyEmail	`POST`	`verification.send`	Reenviar correo de verificación (Inertia router)
auth/ConfirmPassword	`POST`	`password.confirm`	Confirmar contraseña (Inertia useForm)
auth/ResetPassword	`POST`	`password.store`	Guardar nueva contraseña (Inertia useForm)
auth/Register	`POST`	`register`	Enviar registro (Inertia router)
settings/Password	`PUT`	`password.update`	Actualizar contraseña (Inertia useForm)
settings/Profile	`PATCH`	`profile.update`	Actualizar perfil (Inertia useForm)

5.2 Llamadas API de Composables

Composable	Método	Endpoint	Propósito
`useWishlist`	`GET`	`lista-deseos.index`	Cargar ítems de la wishlist
`useWishlist`	`POST`	`lista-deseos.store`	Agregar a la wishlist
`useWishlist`	`DELETE`	`lista-deseos.destroy`	Remover de la wishlist

5.3 Portal de Aliados

Página / Componente	Método	Endpoint (Nombre de Ruta)	Propósito
ally/Dashboard	`GET`	`aliado.dashboard.resumen`	Obtener resumen del dashboard (ventas, productos, top ítems)
ally/Dashboard	`GET`	`aliado.dashboard.rendimiento`	Obtener datos de rendimiento (serie temporal)
ally/ventas/Page	`GET`	`aliado.ventas.index`	Obtener ventas paginadas
ally/ventas/Page	`GET`	`aliado.ventas.estadisticas`	Obtener estadísticas de ventas
ally/ventas/create/create	`POST`	`aliado.ventas.store`	Crear nueva venta
ally/productos/Page	`DELETE`	`aliado.productos.destroy`	Eliminar producto
ally/productos/Page	`POST`	`aliado.productos.carga-masiva`	Carga masiva de productos
ally/productos/Page	`GET`	`aliado.productos.download`	Descargar plantilla de productos
ally/productos/Page	`GET`	`aliado.marcas.download`	Descargar catálogo de marcas
ally/productos/Page	`GET`	`aliado.lineas.download`	Descargar catálogo de líneas
ally/productos/Revision	`PUT`	`aliado.productos.update`	Aprobar/rechazar producto
ally/productos/Revision	`GET`	`aliado.productos.index`	Obtener productos para revisión
ally/marcas/Page	`GET`	`marcas.index`	Obtener listado de marcas
ally/marcas/Page	`POST`	`aliado.marcas.store`	Crear marca
ally/marcas/Page	`POST`	`aliado.marcas.update`	Actualizar marca (multipart)
ally/marcas/Page	`DELETE`	`aliado.marcas.destroy`	Eliminar marca
ally/empresas/Page	`GET`	`aliado.empresas.index`	Obtener listado de empresas
ally/empresas/EditEmpresaLinesModal	`PUT`	`aliado.empresas.update`	Actualizar líneas de empresa
ally/sucursales/Page	`POST`	`aliado.sucursales.store`	Crear sucursal
ally/sucursales/Page	`PUT`	`aliado.sucursales.update`	Actualizar sucursal
ally/sucursales/Page	`DELETE`	`aliado.sucursales.destroy`	Eliminar sucursal
ally/empleados/Page	`GET`	`aliado.empleados.index`	Obtener empleados
ally/empleados/Page	`POST`	`aliado.empleados.store`	Crear empleado
ally/empleados/Page	`PUT`	`aliado.empleados.update`	Actualizar empleado
ally/empleados/Page	`DELETE`	`aliado.empleados.destroy`	Eliminar empleado
ally/usuarios/Page	`GET`	`aliado.usuarios.index`	Obtener usuarios
ally/usuarios/Page	`GET`	`aliado.usuarios.show`	Obtener detalle del usuario
ally/usuarios/Page	`PUT`	`aliado.usuarios.update`	Actualizar usuario
ally/usuarios/Page	`DELETE`	`aliado.usuarios.destroy`	Eliminar usuario
ally/usuarios/Page	`POST`	`aliado.usuarios.resend-verification`	Reenviar verificación de correo
ally/usuarios/CreateAdminModal	`POST`	`aliado.usuarios.admin.store`	Crear usuario admin
ally/postulaciones/Page	`GET`	`aliado.postulacion.index`	Obtener postulaciones
ally/postulaciones/Page	`POST`	`aliado.postulacion.action`	Aprobar/rechazar/descartar postulacion
ally/pedidos/Page	`GET`	`aliado.ventas.index`	Obtener pedidos
ally/pedidos/Page	`PUT`	`aliado.ventas.update`	Actualizar estado del pedido (entregada)
ally/auth/Postulacion	`POST`	`aliado-postulacion.store`	Enviar solicitud de aliado
ally/auth/Login	`POST`	`aliado.login`	Login (Inertia router)
ally/auth/ResetPassword	`POST`	`aliado.password.store`	Restablecer contraseña (Inertia useForm)
ally/auth/register/Page	`POST`	`aliado-postulacion.register.store`	Completar registro del aliado

6. Uso de Composables

Composable	Propósito	Páginas / Componentes que lo Usan
`useWishlist`	Gestionar wishlist (agregar/remover/toggle/verificar) vía axios a los endpoints de `lista-deseos`	`product/Detail.vue`, `home/Ofertas.vue`, `home/MasVendidos.vue`, `home/Encantar.vue`, `home/Intereses.vue`
`useAppearance`	Alternar tema oscuro/claro/sistema, persiste en localStorage + cookie	`settings/Appearance.vue` (vía componente `AppearanceTabs`)
`useInitials`	Extraer iniciales de un string de nombre completo	Usado en componentes de avatar de usuario en header/sidebar

Uso de Utilidades de Lib

Utilidad	Archivo	Propósito	Usado Por
`formatCOP`	`lib/format.ts`	Formatear números como moneda COP (con decimales)	Wishlist, Checkout, componentes home, product/*, ally/productos, ally/ventas/create
`formatCOP` (sin decimales)	`lib/formatters.ts`	Formatear COP sin decimales + `formatDateTimeISO`	Compras/Index
`calculateCredit`	`lib/credit.ts`	Cálculo de amortización francesa con seguro/fianza/tarifa de estudio	Checkout/Index, Simulator/Index, ally/ventas/create
`cn`	`lib/utils.ts`	Utilidad de merge de clases Tailwind (clsx + twMerge)	Componentes UI
`extraerPrincipalesProducto`	`lib/utils.ts`	Extraer precio/imagen principal del objeto producto	Sub-componentes Home, product/*, ally/productos, ally/ventas/create
`placeholderImage`	`lib/utils.ts`	Retornar la ruta de la imagen placeholder predeterminada del producto	Componentes relacionados con productos
`useDarkModeReactive`	`lib/utils.ts`	Ref reactiva de modo oscuro desde localStorage	`components/Footer/AllyFooter.vue`, `components/form/MultiSelect.vue`
`formatearFechaColombia`	`lib/utils.ts`	Formatear fechas en locale/timezone de Colombia	user/Perfil
`sanitizePhone`	`lib/utils.ts`	Eliminar caracteres no numéricos del teléfono (mantener +)	ally/auth/Postulacion

Plugins

Plugin	Archivo	Propósito
`errorHandling`	`plugins/errorHandling.ts`	Manejador global de errores de Vue + listeners de rechazos/errores no manejados; registra vía el servicio `errorLogger`
`errorInterceptor`	`plugins/errorInterceptor.ts`	Interceptores de request/response de axios; añade IDs de tracking; registra errores y éxitos vía `errorLogger`

7. Diagrama de Sitemap

graph TB
    subgraph "Páginas Públicas"
        HOME["/ <br/> Index.vue <br/> (MarketLayout)"]
        SEARCH["/resultados <br/> product/Search/List.vue"]
        DETAIL["/productos/{id} <br/> product/Detail.vue"]
        CUPO["/consultar-cupo <br/> ConsultarCupo/Index.vue <br/> ruta: consultar-cupo.view <br/> (Standalone)"]
        ERROR["Fallback <br/> ErrorPage.vue <br/> (ErrorLayout)"]
    end

    subgraph "Auth Cliente (Invitado)"
        REG["/registro <br/> auth/Register.vue"]
        RESET["/restablecer-contrasena <br/> auth/ResetPassword.vue"]
    end

    subgraph "Auth Cliente (Conectado)"
        VERIFY["/verificar-correo <br/> auth/VerifyEmail.vue"]
        CONFIRM["/confirmar-contrasena <br/> auth/ConfirmPassword.vue"]
    end

    subgraph "Cliente Autenticado"
        PERFIL["/usuario/perfil <br/> user/Perfil.vue"]
        COMPLETAR["/usuario/completar-registro <br/> user/Completar.vue"]
        WISHLIST["/lista-deseos/vista <br/> Wishlist/Index.vue <br/> ruta: lista-deseos.view"]
        SIMULATOR["/simulador-cuotas <br/> Simulator/Index.vue <br/> ruta: simulador.view"]
        CHECKOUT["/checkout <br/> Checkout/Index.vue <br/> ruta: checkout.view"]
        COMPRAS_I["/mis-compras <br/> Compras/Index.vue"]
        COMPRAS_S["/mis-compras/{id} <br/> Compras/Show.vue"]
    end

    subgraph "Settings Cliente"
        SET_PROFILE["/settings/profile <br/> settings/Profile.vue <br/> (AppLayout)"]
        SET_PASS["/settings/password <br/> settings/Password.vue"]
        SET_APPEAR["/settings/appearance <br/> settings/Appearance.vue"]
    end

    subgraph "Auth Aliado (Invitado)"
        ALLY_LOGIN["/aliados/ingresar <br/> ally/auth/Login.vue"]
        ALLY_FORGOT["/aliados/olvidar <br/> ally/auth/ForgotPassword.vue"]
        ALLY_RESET["/aliados/restablecer <br/> ally/auth/ResetPassword.vue"]
        ALLY_POST["/aliados/postulacion <br/> ally/auth/Postulacion.vue"]
    end

    subgraph "Portal Aliado (Autenticado)"
        ALLY_DASH["/aliados <br/> ally/Dashboard.vue <br/> (AllyLayout)"]
        ALLY_VENTAS["/aliados/ventas/listado <br/> ally/ventas/Page.vue"]
        ALLY_VENTA_S["/aliados/ventas/{id} <br/> ally/ventas/Show.vue"]
        ALLY_VENTA_C["/aliados/ventas/crear <br/> ally/ventas/create/create.vue"]
        ALLY_PROD["/aliados/productos <br/> ally/productos/Page.vue"]
        ALLY_PROD_R["/aliados/productos/revision <br/> ally/productos/Revision.vue"]
        ALLY_PED["/aliados/pedidos/listado <br/> ally/pedidos/Page.vue"]
        ALLY_MARCAS["/aliados/marcas/listado <br/> ally/marcas/Page.vue"]
        ALLY_EMP["/aliados/empresas/listado <br/> ally/empresas/Page.vue"]
        ALLY_SUC["/aliados/sucursales/listado <br/> ally/sucursales/Page.vue"]
        ALLY_EMPL["/aliados/empleados/listado <br/> ally/empleados/Page.vue"]
        ALLY_USR["/aliados/usuarios/listado <br/> ally/usuarios/Page.vue"]
        ALLY_POSTUL["/aliados/postulacion/revision <br/> ally/postulaciones/Page.vue"]
        ALLY_REG["/aliados/postulacion/{id}/registro <br/> ally/auth/register/Page.vue"]
    end

    HOME --> SEARCH
    HOME --> DETAIL
    HOME --> REG
    DETAIL --> CHECKOUT
    PERFIL --> COMPLETAR
    PERFIL --> COMPRAS_I
    COMPRAS_I --> COMPRAS_S
    CHECKOUT --> COMPRAS_I

    ALLY_LOGIN --> ALLY_DASH
    ALLY_LOGIN --> ALLY_FORGOT
    ALLY_DASH --> ALLY_VENTAS
    ALLY_DASH --> ALLY_PROD
    ALLY_DASH --> ALLY_PED
    ALLY_VENTAS --> ALLY_VENTA_S
    ALLY_VENTAS --> ALLY_VENTA_C
    ALLY_POSTUL --> ALLY_REG