HubEmpresarial, documento técnico inicial

Versión de arranque para alinear producto, arquitectura, datos, multi-tenancy y estructura tipo marketplace B2B.

Laravel MySQL Nginx Blade + Alpine Multi-tenant por subdominio SEO-first Communications inbox Provisioning con Claw

1. Resumen ejecutivo

HubEmpresarial se diseñará como un marketplace B2B multi-tenant orientado a SEO. El dominio principal concentrará el descubrimiento global, mientras que cada empresa tendrá un micrositio bajo su propio subdominio.

Marketplace global

Buscador central, categorías, listados, fichas públicas y captación de leads.

Micrositio por empresa

Perfil empresarial, productos, servicios y contacto directo en empresa.hubempresarial.mx.

Operación controlada

Flujo obligatorio: LOCAL -> GIT -> STAGING -> TEST -> PRODUCCIÓN.

2. Arquitectura del sistema

Presentación

Blade + Alpine para SSR, SEO y velocidad de entrega.

Aplicación

Services, actions, requests y orquestación de casos de uso.

Dominio

Empresas, catálogo, taxonomía, leads, SEO, permisos y reglas.

Infraestructura

Eloquent, MySQL, storage, cache, colas, mail, logs e integraciones.

Módulos principales

MóduloResponsabilidad
CoreUsuarios, autenticación, configuración transversal.
TenancyResolución por hostname y contexto tenant.
CompaniesPerfil, branding, contacto, estado, publicación, plantilla inicial y provisioning.
CatalogProductos, servicios, media y estados editoriales.
TaxonomyCategorías y jerarquías.
SearchBúsqueda global y filtros.
LeadsFormulario, WhatsApp y eventos de contacto.
CommunicationsConversaciones invitado a empresa, inbox, mensajes, asignación y seguimiento.
ProvisioningGeneración de subsitio inicial con Claw a partir del onboarding y plantilla seleccionada.
SEOSlugs, metadata, schema, canonical y sitemaps.
AdminModeración, dashboards y operación global.
Company PanelBackoffice de cada empresa.

3. Base de datos inicial

La recomendación para V1 es una sola base MySQL con aislamiento lógico por company_id.

TablaUso principal
usersIdentidad de usuarios del sistema.
companiesNúcleo empresarial y publicación.
company_userRelación muchos a muchos con roles por empresa.
company_profilesBranding, contacto, SEO y datos extendidos.
categoriesTaxonomía jerárquica compartida.
productsProductos empresariales.
servicesServicios empresariales.
mediaImágenes y archivos asociados.
leadsCaptación y seguimiento de intención comercial.
conversationsConversaciones entre invitados y empresas.
messagesMensajes de una conversación.
site_sectionsSecciones editables del subsitio generado.
provisioning_jobsTrazabilidad de la creación inicial del subsitio con Claw.
seo_metaMetadatos desacoplados por entidad.

4. Multi-tenancy por subdominio

La estrategia recomendada es wildcard DNS más resolución de tenant por hostname. Cada tenant podrá nacer desde onboarding con una plantilla predeterminada generada mediante Claw.

Dominio raíz

hubempresarial.mx sirve el marketplace global.

Tenant

empresa.hubempresarial.mx sirve el micrositio empresarial.

Resolución

Se extrae subdominio, se valida existencia, estado y publicación, luego se carga contexto actual.

Requisitos de infraestructura

Reservar subdominios sensibles desde el inicio: www, admin, api, staging, mail, ftp, cdn, blog.

5. Estructura tipo Alibaba adaptada

NivelObjetivo
Descubrimiento globalHomepage con buscador, destacados y bloques SEO.
Navegación por categoríaLandings indexables con empresas, productos y servicios.
Perfil de empresaPresencia fuerte bajo subdominio con branding y CTA.
Fichas de producto y servicioLong-tail SEO e indexación profunda.
Backoffice empresaAutogestión de perfil, catálogo, leads, inbox de conversaciones y edición posterior del subsitio generado.
Control centralModeración, taxonomías, operación y calidad.

6. Roles y permisos

RolCapacidad principal
SuperadminControl global, moderación, taxonomías y dashboards.
OwnerControl total de su empresa y equipo.
ManagerOperación cotidiana de perfil, catálogo, leads y conversaciones.
EditorContenido, media y apoyo de atención con permisos limitados.
VisitanteBúsqueda, navegación y contacto.

7. Flujos críticos

Registro de empresa

Cuenta, alta de empresa, selección de plantilla, captura de contenido base, provisioning con Claw, revisión y publicación.

Publicación de catálogo

Creación, categorización, revisión opcional y exposición en marketplace más subdominio.

Captación de leads

Búsqueda, visita a ficha, contacto por formulario o WhatsApp y registro del evento.

Conversación invitado-empresa

Un visitante inicia contacto, la empresa lo atiende desde su inbox y la conversación queda persistida.

Resolución de tenant

Hostname, validación de empresa, carga de contexto y render público.

8. Riesgos y decisiones

9. Diseño de onboarding y provisioning

El onboarding queda planteado como flujo multi-step con autosave, validación temprana de subdominio, elección de plantilla y provisioning desacoplado. La empresa puede registrarse, seleccionar plantilla de productos, servicios o mixto, sembrar contenido base y generar su subsitio inicial con Claw sin perder editabilidad posterior.

PasoObjetivo
1. CuentaCrear usuario y sesión de onboarding.
2. EmpresaCapturar datos base, subdominio y categoría principal.
3. PlantillaElegir subsitio de productos, servicios o mixto.
4. Identidad comercialDefinir hero, propuesta de valor y CTA principal.
5. Catálogo semillaCargar productos y servicios iniciales.
6. ContactoDefinir canales públicos y operación comercial.
7. PreviewConfirmar resumen y lanzar provisioning.
8. ProvisioningCrear subsitio inicial con Claw y registrar resultado.

Estados recomendados: onboarding, publicación y provisioning separados para no bloquear la empresa si la generación del subsitio falla.

10. Base de implementación

Ya quedó definida la base técnica para implementar sin improvisación: migraciones conceptuales, relaciones entre entidades, foreign keys sugeridas, índices, constraints de negocio y validaciones por cada step del onboarding.

11. Recomendación operativa

Con esto ya existe una base suficiente para pasar a implementación real. El siguiente bloque recomendable es traducir esta especificación a migraciones Laravel, enums, form requests, policies y contratos del módulo de provisioning con Claw.

12. México y validación SAT

La plataforma queda ajustada para empresas en México con segmentación por giros del SAT, captura de RFC y validación documental mediante constancia de situación fiscal y opinión de cumplimiento. La publicación y el sello de empresa validada deben depender de este flujo.