Dashboard tecnico

Guia visual del sistema modular del CRM

Esta mini web resume como debe funcionar el CRM a nivel tecnico: DbContext por modulo, migraciones, hooks, despliegue de DLLs, ModulosCompilados, seeds, menu y relaciones entre modulos.

Ver flujo completo Ver ModulosCompilados
Rutas recomendadas
Si vas a crear un modulo Empieza por Crear modulo nuevo, luego Migraciones y despues Flujo completo.
Si vas a desplegar DLLs Revisa primero ModulosCompilados y despues Ciclo de un modulo.
Si vas a integrar modulos Mira Datos entre modulos, Hooks y Entidades y relaciones.

Resumen rapido

Modelo
1
Cada modulo debe tener una responsabilidad funcional clara.
DbContext
1
Cada modulo con tablas propias debe tener su propio DbContext.
Migraciones
EF
Los cambios de esquema deben pasar por migraciones, no por SQL disperso.
Despliegue
DLL
La DLL va a ModulosCompilados y la activacion completa llega tras reinicio.

Paginas clave

Arquitectura Que va en ApplicationDbContext, que va en ENTIDADES, PROVEEDORES y demas modulos. Ciclo de un modulo Como nace, se registra, carga servicios, aplica esquema, ejecuta seeds y expone hooks o menu. Migraciones Como deben hacerse las migraciones por modulo, como se modelan tablas y relaciones y como escribir la configuracion EF. Hooks y extensiones Cuando usar hooks de tabs, acciones o eventos y cuando no usarlos. Datos entre modulos Como guardar datos relacionados sin duplicar maestros ni mezclar responsabilidades. Entidades y relaciones Ejemplos reales de tablas, claves foraneas, maestro comun y relaciones recomendadas. Crear modulo nuevo Checklist tecnico para crear un modulo correctamente desde el inicio. Errores y malas practicas Permisos inconsistentes, menus mal filtrados, seeds usados como migracion y duplicidad de maestros. Limites y opciones Ejemplos concretos de limites, opciones y configuracion de modulo para PRODUCTOS, FACTURACION, PROVEEDORES y COMPRAS. Flujo completo Desde crear el modulo hasta que queda cargado, migrado, sembrado y visible dentro del CRM. ModulosCompilados Como funciona el sistema nuevo de DLLs compiladas, despliegue, reinicio y activacion completa del modulo.

Rutas de consulta rapida

Quiero crear un modulo nuevo Empieza por la estructura, ModuleDescriptor, ModuleInitializer, DbContext y migracion inicial. Quiero anadir una tabla o un campo Revisa la parte de configuracion EF, relaciones e historico de migraciones del modulo. Quiero extender otra pantalla Usa hooks para tabs, acciones o eventos, sin meter logica de negocio dentro del hook. Quiero desplegar una DLL La DLL se copia a ModulosCompilados y el reinicio completa DI, MVC, migraciones y seeds.

Uso rapido

  1. Abre este index.html en navegador.
  2. Usa el menu lateral para navegar por cada tema.
  3. Si quieres montarlo aparte, copia la carpeta completa modulos-crm-web.
  4. Si la despliegas con Docker o Portainer, usa los archivos de la misma carpeta.
Esta documentacion ya esta pensada como guia tecnica viva. Puedes seguir ampliandola sin tocar el CRM principal.