10 Módulo de Categorías y Depreciación Contable CRUD Laravel y Adminator - Sistema de Activos Fijos

Duración: 27 min
Módulo: Colaboradores, Custodios y Catálogos Contables Lección 2 de 2

¡Contenido Exclusivo!

Adquiere este curso para tener acceso inmediato a esta y a **todas las lecciones Premium**.

Inscribirse Ahora por $10.00 Acceso instantáneo de por vida y código fuente incluido.

Descripció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ónComando Artisan / Sintaxis de RutaArchivo / ControladorPropósito Técnico
Estructura Categoríasphp artisan make:model categoria -mcrTerminal / ArtisanCrear modelo Categoria, archivo de migración y CategoriaController
Migración de Esquemaphp artisan migratedatabase/migrations/..._create_categorias_table.phpDesplegar la tabla categorias con campos fiscales y código de color
Listado y MétricasGET /admin/categoriasCategoriaController@indexVisualizar tabla de rubros con tarjetas KPI (depreciables y exentos)
Formulario de RegistroGET /admin/categorias/createCategoriaController@createCargar interfaz con selector de color, años de vida útil y coeficientes
Guardar Rubro ContablePOST /admin/categoriasCategoriaController@storeValidar campos, persistir categoría y notificar vía SweetAlert2
Detalle de CategoríaGET /admin/categorias/{id}CategoriaController@showConsultar la ficha técnica, régimen contable y coeficientes aplicados
Formulario de EdiciónGET /admin/categorias/{id}/editCategoriaController@editAbrir formulario para modificar vidas útiles, cuentas o códigos
Actualizar CategoríaPUT /admin/categorias/{id}CategoriaController@updatePersistir modificaciones en la base de datos de manera atómica
Baja de RegistroDELETE /admin/categorias/{id}CategoriaController@destroySuprimir 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.