SaaSModule · Modelo core

Propósito

SaaSModule es el registro de módulos de aplicación que pueden habilitarse o deshabilitarse por organización. Cada instancia representa una funcionalidad discreta (racks, network-maps, digital-signage, etc.) identificada por un slug único. El middleware ModuleGatingMiddleware consulta este modelo en cada request para decidir si una URL está accesible. Los módulos con is_core=True están siempre activos sin importar el plan.

Contrato

Campos:

Meta: ordering = ["sort_order", "name"], verbose_name = "Module". Sin manager personalizado.

Nota: ModulePermission NO tiene FK directo a SaaSModule. Almacena permisos granulares en un JSONField libre ({"scope": "level"}), sin relación de BD.

Dependencias entrantes

Dependencias salientes

• Plan.modules — M2M inversa (related_name="plans"). Un módulo puede estar en cero, uno o varios planes.
• Organization.extra_modules — M2M inversa (related_name="extra_organizations") para módulos à la carte o core pre-asignados en signup.
• core.module_registry.URL_TO_MODULE — diccionario estático prefijo→slug con longest-prefix-match vía resolve_module(path).

Ejemplos

# Flujo gating en ModuleGatingMiddleware (core/middleware/module_gating.py:62-79)
active = org.get_active_modules()
request._active_modules = active

required_module = resolve_module(path)
if required_module and required_module not in active:
    if path.startswith("/api/"):
        return JsonResponse({"error": f"Module '{required_module}' is not available"}, status=403)
    return render(request, "errors/module_disabled.html", {"module_slug": required_module}, status=403)

# Construcción del set activo (core/models.py:110-112)
active = set(SaaSModule.objects.filter(is_core=True).values_list("slug", flat=True))
active.update(self.extra_modules.values_list("slug", flat=True))
return active

Related

• entity--core--model--plan — contiene la M2M Plan.modules → SaaSModule.
• entity--core--model--organization — consume vía extra_modules y get_active_modules().
• concept--saas--module-gating — patrón arquitectónico implementado por middleware + registry.

Véase también

• [[entity—core—model—plan]]
• [[entity—core—model—organization]]
• [[concept—saas—module-gating]]