Carman Parts + Cozza Parts - Caso multi-marca

La solucion desacopla una SPA en Vue 3 + TypeScript, una API REST en Node.js + Express, la persistencia en MySQL/MariaDB y la integración backend con Mercado Libre API. Cada marca conserva su dominio, identidad, textos, imágenes, configuración y cuenta, sobre una arquitectura funcional común.

frontend/
|- src/
|  |- components/
|  |- views/
|  |- router/
|  |- services/
|  `- types/
`- public/

backend/
|- src/
|  |- config/
|  |- controllers/
|  |- middlewares/
|  |- repositories/
|  |- routes/
|  |- services/
|  `- validators/
|- migrations/
`- scripts/

Catálogo e integración con Mercado Libre

El pipeline obtiene de forma controlada las publicaciones activas, normaliza los datos y los guarda temporalmente. Una etapa independiente valida integridad y completitud antes de realizar el reemplazo transaccional del catálogo publicado. Luego se reconstruyen y persisten tipos de producto y marcas para que la API pública de solo lectura resuelva búsqueda, filtros, paginación y detalle sin consultar Mercado Libre en tiempo real. Automatizaciones externas programadas coordinan estas operaciones protegidas para mantener actualizado el catálogo en producción.

Seguridad y confiabilidad

• OAuth 2.0 encapsulado en backend, secretos fuera del repositorio y datos sensibles cifrados.
• Operaciones administrativas autorizadas y separadas de las rutas públicas y de salud.
• CORS restringido, cabeceras de seguridad, validación y sanitización de entradas.
• Honeypot y limites de solicitudes para el formulario de contacto.
• Timeouts, reintentos acotados, limites de respuesta y validación defensiva de servicios externos.
• Transacciones con rollback, publicación idempotente y conservación del catálogo anterior ante fallas.
• Bloqueos de concurrencia para impedir operaciones incompatibles sobre el pipeline.
• Controles de salud separados para aplicación y base de datos, con logs sin credenciales.

Front 2.0: SPA en Vue 3 + Vite con componentes reutilizables para cabecera, filtros, grilla y detalle de producto, y router para home, catálogo y contacto. Back 2.0: API en Node.js + Express que actúa como capa única entre el front y Mercado Libre, con endpoints para catálogo, detalle y jobs de sincronización.

backend/
|- src/
|  |- routes/
|  |- controllers/
|  |- services/
|  |- jobs/
|  `- config/
`- .env (tokens y claves fuera del codigo)

frontend/
|- src/
|  |- views/
|  |- components/
|  |- composables/
|  `- router/
`- .env.* (variables por entorno y marca)

Front: HTML5, CSS y JS vanilla. Back: PHP 8 + MySQL. Integración: SDK/REST Mercado Libre (OAuth2, refresh tokens). Automatizaciones: scripts PHP ejecutados por cPanel/CLI.

Seguridad: separacion public_html vs carpeta privada; .htaccess para bloquear secretos/archivos sensibles; manejo de tokens en archivos protegidos.

• Sincronizar un catálogo amplio sin depender de la API externa en cada visita -> procesamiento backend y exposición pública desde datos persistidos.
• Evitar publicar datos incompletos -> etapas separadas de lectura, normalización y validación antes de publicar.
• Conservar disponible el catálogo ante una falla -> reemplazo completo dentro de una transaccion con rollback al estado anterior.
• Evitar carreras entre etapas incompatibles -> bloqueos de concurrencia y transiciones de estado controladas.
• Resolver filtros sin clasificar títulos en cada consulta pública -> reconstrucción idempotente y persistida de tipos de producto y marcas.
• Reutilizar la solucion para dos marcas -> arquitectura común con configuración, identidad, dominio y datos independientes.
• Proteger integraciones y operaciones sensibles -> OAuth 2.0, autorización administrativa, cifrado, minimo privilegio y secretos fuera del código.
• Controlar respuestas ambiguas y limites externos -> validaciones defensivas, timeouts, reintentos acotados y errores públicos genericos.

• Unificar dos sitios en una sola SPA -> diseño de componentes neutrales y branding inyectado por configuración.
• Mantener filtros y paginación real -> normalización de la respuesta de Mercado Libre en la API Node para que el front consuma siempre el mismo formato.
• Multi-marca sin duplicar lógica -> variables de entorno por dominio (Carman/Cozza) y mapping de categorías/URLs por marca.
• Rendimiento -> build con Vite, splitting de bundles, cache de respuestas frecuentes y optimizacion de imágenes.
• Migracion gradual -> convivio con la versión PHP mientras se probaba la nueva arquitectura sin cortar servicio.

• Paginación real sin perder filtros -> control de offset/limit y estados en URL.
• Tokens seguros -> refresh programado y almacenamiento fuera de public_html.
• Multi-marca con un solo código -> variables de entorno por sitio y layout con branding dinamico.
• Rendimiento -> imágenes optimizadas y consultas paginadas/indexadas.
• Hardening -> reglas .htaccess para bloquear JSON/INI/SQL y rutas internas.

• Dos sitios productivos para Carman Parts y Cozza Parts sobre una arquitectura funcional común y configuración propia por marca.
• Catálogo real conectado a publicaciones activas de Mercado Libre y servido desde persistencia propia.
• Experiencia pública completa con búsqueda, filtros sobre facetas persistidas, orden, paginación y detalle con imágenes reales.
• Sincronización productiva coordinada por automatizaciones externas y un pipeline separado de lectura, validación, publicación y reconstrucción de facetas.
• Publicación confiable mediante reemplazo transaccional, rollback y controles que evitan dejar el catálogo en un estado parcial.
• Backend productivo y mantenible con separacion por capas, controles de salud, seguridad defensiva y contacto comercial mediante Nodemailer.

• Un mismo front y una misma API mantienen 2 marcas funcionando con branding y datos separados.
• Catálogo rápido con SPA Vue + Vite, filtros combinables y paginación real contra la API Node.
• Arquitectura multi-marca con configuración y datos diferenciados para cada marca.
• Automatizaciones centralizadas (jobs Node) para publicar/actualizar en Mercado Libre por empresa.

• Un mismo código mantiene 2 marcas sin duplicar trabajo.
• Catálogo rápido con filtros combinables + paginación real.
• Publicaciones ML sincronizadas por empresa con tokens separados.
• Operativa segura (tokens fuera de public_html, reglas .htaccess).