18 Sistema de SUSCRIPCIONES VENCIDAS CON RENOVACIÓN y Bloqueo de Tiendas en Laravel SaaS MultiTenant
Duración: 10 minDescripción
🎓 Lección 18: Vistas, CRUD y Asignación de Planes y Suscripciones en SaaS Multi-Tenant
Objetivo General: Diseñar e implementar el conjunto completo de vistas administrativas (listado, creación, edición y detalle) para la gestión CRUD de planes de suscripción desde el panel central, permitiendo la asignación dinámica de límites e intervalos de cobro a cada inquilino (tenant).
🚀 Pasos Clave con Timestamps
- 📂 Creación de la Estructura de Vistas Blade: Construcción de la carpeta resources/views/admin/planes/ con las plantillas index.blade.php, create.blade.php y edit.blade.php integradas al layout del panel administrativo central.⏱️ 01:20
- 🎨 Maquetación del Listado y Tarjetas Visuales de Planes: Diseño de la vista principal con tarjetas comparativas organizadas por colores (badges), destacando precios, intervalos (mensual/anual) e indicadores visuales de popularidad.⏱️ 03:40
- 📝 Formulario de Creación con Validación de Límites: Configuración de los campos de entrada para el nombre, precio, límites de productos, límites de categorías, soporte por WhatsApp, personalización de dominio y color distintivo del plan.⏱️ 06:15
- ⚡ Implementación de las Acciones store() y update(): Programación de la lógica en PlanController para persistir los cambios en la base de datos central, incluyendo la generación automatizada del slug amigable.⏱️ 09:30
- 🔗 Asignación Manual de Plan a Inquilinos (Tenants): Integración en el formulario de gestión de tiendas para seleccionar el plan contratado, calcular la fecha de vencimiento y establecer el estado de la suscripción (activo, prueba, vencido).⏱️ 12:45
- 🗑️ Eliminación Segura y Control de Soft-Delete: Implementación de la acción destroy() con verificaciones de integridad referencial para evitar la eliminación accidental de planes asignados a tiendas activas.⏱️ 15:10
🛠️ Comandos y Rutas Principales
| Tipo | Comando / Ruta | Descripción |
|---|---|---|
| 💻 Artisan | php artisan make:request PlanRequest | Genera la clase Form Request para validar las reglas del formulario de planes. |
| 🌐 Ruta HTTP | GET /admin/planes | Muestra el listado de todos los planes de suscripción (PlanController@index). |
| 🌐 Ruta HTTP | GET /admin/planes/create | Renderiza el formulario para registrar un nuevo plan (PlanController@create). |
| 🌐 Ruta HTTP | POST /admin/planes | Guarda la información del plan en la base de datos central (PlanController@store). |
| 🌐 Ruta HTTP | PUT /admin/planes/{id} | Actualiza las propiedades y límites del plan seleccionado (PlanController@update). |
| 🌐 Ruta HTTP | POST /admin/tenants/{id}/asignar-plan | Asigna o renueva el plan de suscripción de un inquilino específico. |
🔒 Buenas Prácticas y Seguridad
- 🛡️ Validación Estricta con Form Requests: Centraliza la lógica de validación (PlanRequest) asegurando que los montos de precios sean numéricos y no negativos, y que los límites de productos y categorías se registren como enteros mayores a cero.
- 🚫 Protección en Eliminación de Planes Activos: Antes de procesar la eliminación ($plan->delete()), verifica que el recuento de inquilinos vinculados ($plan->tenants()->count()) sea igual a cero para prevenir inconsistencias de clave foránea.
- 📆 Calculo Automatizado de Fechas de Vencimiento: Al asociar un plan a una tienda, calcula la fecha límite de suscripción en el servidor utilizando Carbon (now()->addMonth() o now()->addYear()) en lugar de depender de inputs manuales del usuario.
- 🎨 UX Limpia con Indicadores Visuales Claros: Utiliza códigos de color e iconos descriptivos para distinguir la jerarquía entre planes (básico, pro, empresarial) y reflejar el estado en tiempo real de cada suscripción.