10 Módulo de Categorías y Depreciación Contable CRUD Laravel y Adminator - Sistema de Activos Fijos
Duración: 27 minDescripción
🎓 Lección 10: Módulo de Categorías y Parámetros de Depreciación Contable en Laravel 13
Esta lección aborda la construcción del módulo de categorías como núcleo contable del sistema de activos fijos, parametrizando las vidas útiles, coeficientes de depreciación anual y cuentas contables para la automatización financiera del inventario. Asimismo, se robustece la seguridad de la aplicación deshabilitando el registro público de Laravel Breeze y rediseñando el entorno de autenticación con la interfaz de Adminator.
🚀 Pasos Clave con Timestamps
- 👥 Verificación de Datos Sembrados y Roles de Empleados (⏱️ 00:00): Comprobación de la base de datos tras la siembra masiva de 117 empleados (105 activos, 12 dados de baja y 30 con cuentas de usuario y roles específicos asignados para operar el sistema).
- 🏛️ Fundamentación Contable del Módulo de Categorías (⏱️ 01:15): Definición de las categorías como el motor de depreciación del sistema, estableciendo que distintos rubros de activos (vehículos, equipos de computación, edificaciones o terrenos) poseen diferentes vidas útiles contables y tasas de depreciación.
- 🏗️ Generación de Modelo, Migración y Controlador RESTful (⏱️ 02:00): Creación unificada del modelo categoria, su migración de estructura y el controlador de recursos mediante el comando Artisan php artisan make:model categoria -mcr.
- 📐 Esquematización en DBML de la Tabla categorias (⏱️ 02:40): Documentación en diagrama.dbml de los atributos esenciales: id, codigo nemotécnico, nombre, descripcion, vida_util (en años), coeficiente de depreciación anual, aplica_depreciacion (booleano), cuenta_contable, color hexadecimal y estado.
- 🗄️ Migración de la Tabla de Rubros a MySQL (⏱️ 03:50): Ejecución de php artisan migrate para incorporar la tabla número 19 (categorias) dentro de la base de datos control_activos_fijos.
- 🔒 Bloqueo Perimetral del Registro Público en Laravel Breeze (⏱️ 04:45): Deshabilitación total de la ruta y vista /register en el frontend y backend para impedir el autorregistro externo, forzando a que las cuentas solo sean gestionadas internamente por administradores.
- 🎨 Rediseño Profesional del Login y Recuperación de Contraseña (⏱️ 05:35): Adaptación de las pantallas de inicio de sesión y restablecimiento de credenciales a la identidad visual corporativa de Adminator, reemplazando el diseño por defecto de Breeze.
- 📐 Corrección del Layout: Footer Fijo y Tarjeta de Usuario en Dashboard (⏱️ 06:20): Ajuste de hojas de estilo para fijar el pie de página (footer) en la parte inferior de todas las vistas y creación de una tarjeta en el dashboard principal con los datos y rol del usuario autenticado.
- 🛣️ Enrutamiento Web y Enlace en el Menú Lateral (sidebar) (⏱️ 07:15): Registro de las rutas web del CRUD en routes/web.php e incorporación del acceso directo al módulo de categorías con su icono correspondiente en la barra lateral.
- 📊 Métricas KPI y Sembrado con Activos No Depreciables (⏱️ 08:10): Generación automática de 12 categorías base mediante Seeder, integrando tarjetas KPI en la vista principal para discriminar rubros depreciables de rubros exentos (como terrenos, predios u obras de arte).
- 🌐 Desacoplamiento Normativo y Universalización del Formulario (⏱️ 09:20): Eliminación de plantillas basadas en decretos o leyes de un país específico para permitir la parametrización libre de vidas útiles, códigos contables y coeficientes adaptables a cualquier legislación internacional.
- 🧪 Validación Funcional del CRUD y Alertas con SweetAlert2 (⏱️ 11:00): Pruebas de persistencia, selector interactivo de color hexadecimal, conmutador de depreciación (0% para bienes no depreciables), edición de códigos y eliminación protegida por modales de confirmación.
🛠️ Comandos y Rutas Principales
| Componente / Acción | Comando Artisan / Sintaxis de Ruta | Archivo / Controlador | Propósito Técnico |
|---|---|---|---|
| Estructura Categorías | php artisan make:model categoria -mcr | Terminal / Artisan | Crear modelo Categoria, archivo de migración y CategoriaController |
| Migración de Esquema | php artisan migrate | database/migrations/..._create_categorias_table.php | Desplegar la tabla categorias con campos fiscales y código de color |
| Listado y Métricas | GET /admin/categorias | CategoriaController@index | Visualizar tabla de rubros con tarjetas KPI (depreciables y exentos) |
| Formulario de Registro | GET /admin/categorias/create | CategoriaController@create | Cargar interfaz con selector de color, años de vida útil y coeficientes |
| Guardar Rubro Contable | POST /admin/categorias | CategoriaController@store | Validar campos, persistir categoría y notificar vía SweetAlert2 |
| Detalle de Categoría | GET /admin/categorias/{id} | CategoriaController@show | Consultar la ficha técnica, régimen contable y coeficientes aplicados |
| Formulario de Edición | GET /admin/categorias/{id}/edit | CategoriaController@edit | Abrir formulario para modificar vidas útiles, cuentas o códigos |
| Actualizar Categoría | PUT /admin/categorias/{id} | CategoriaController@update | Persistir modificaciones en la base de datos de manera atómica |
| Baja de Registro | DELETE /admin/categorias/{id} | CategoriaController@destroy | Suprimir la categoría contable bajo diálogo de confirmación |
🔒 Buenas Prácticas y Seguridad
- 🚫 Desactivación de Endpoints Públicos de Registro en ERPs: En plataformas empresariales y de gestión interna de activos, elimina o inhabilita las rutas register de Laravel Breeze tanto a nivel de controladores como en las vistas Blade. Ningún usuario externo debe tener la capacidad de darse de alta por cuenta propia.
- 🌎 Parametrización Flexible vs. Reglas Duras en Código (Hardcoding): Evita restringir los formularios a leyes impositivas o decretos locales específicos. Proveer campos abiertos para vida útil contable, porcentaje de depreciación y código de cuenta permite que el software opere limpiamente bajo regulaciones tributarias de diversos países.
- 📉 Manejo Estricto de Activos Exentos de Depreciación: El uso del campo booleano aplica_depreciacion (1 o 0) evita errores contables en el motor financiero, asegurando que activos que no sufren desgaste temporal o que ganan plusvalía (como terrenos y obras de arte) queden excluidos de las rutinas de cálculo automático.
- 🎨 Consistencia Visual mediante Códigos Cromáticos: Asignar un color hexadecimal a cada categoría facilita el etiquetado y reconocimiento visual rápido de los bienes en listas tabulares, paneles ejecutivos y futuros reportes analíticos.