Notas de Lanzamiento para v1.1.3 – Implementación de Notas de Crédito

Introducción

La versión v1.1.3 de boilerplateSells introduce la funcionalidad de notas de crédito, una adición clave que permite gestionar ajustes de ventas, devoluciones y correcciones, cumpliendo con los estándares de facturación electrónica CFDI 4.0 requeridos en México. Esta actualización amplía las capacidades del sistema para generar documentos fiscales en formatos PDF y XML, mejorando la experiencia para usuarios que necesitan herramientas robustas para la gestión de ventas.

Cambios Realizados

Los cambios principales se centran en la adición de nuevas rutas en el archivo src/Config/Routes.php y actualizaciones en controladores, modelos, vistas y la base de datos para soportar la funcionalidad de notas de crédito. A continuación, se detallan los cambios específicos basados en el commit 84b72249259196bc228e99a95be3599fdacd3023:

Nuevas Rutas para Notas de Crédito

Se añadieron las siguientes rutas en src/Config/Routes.php para gestionar notas de crédito:

• Recurso Principal
• notascredito
  • Métodos: GET, POST, PUT, DELETE
  • Descripción: Maneja la lista, creación, edición y eliminación de notas de crédito. Incluye un filtro de permiso permission:listaNotaCredito-permission (excepto para el método show).
  • Ejemplo de uso: Listar todas las notas de crédito o crear una nueva.
• Filtro de Notas de Crédito
• GET notasCredito/(:any)/(:any)/(:any)/(:any)/(:any)/(:any)
  • Descripción: Permite filtrar notas de crédito con múltiples parámetros, útil para búsquedas avanzadas.
  • Ejemplo de uso: Filtrar notas de crédito por fecha, cliente u otros criterios.
• Edición de Nota de Crédito
• GET editNotaCredito/(:any)
  • Descripción: Muestra el formulario para editar una nota de crédito específica.
  • Ejemplo de uso: Modificar los detalles de una nota de crédito existente.
• Eliminación de Pagos
• DELETE pagos/delete/(:any)
  • Descripción: Permite eliminar pagos asociados a una nota de crédito.
  • Ejemplo de uso: Cancelar un pago relacionado con una devolución.
• Timbrado de Nota de Crédito
• GET timbrarNotaCredito/(:any)
  • Descripción: Timbra (certifica) una nota de crédito para cumplir con requisitos fiscales del SAT.
  • Ejemplo de uso: Generar un comprobante fiscal válido para una nota de crédito.
• Generación de PDF
• GET xml/generarPDFDesdeNotaCredito/(:any)
  • Descripción: Genera un PDF a partir de una nota de crédito utilizando datos XML.
  • Ejemplo de uso: Crear un documento PDF para enviar al cliente.
• GET xml/generarPDFNotaCredito/(:any)
  • Descripción: Genera un PDF directamente para una nota de crédito.
  • Ejemplo de uso: Visualizar o descargar el PDF de una nota de crédito.
• GET xml/generarPDFDesdeRemNotaCredito/(:any)
  • Descripción: Genera un PDF a partir de una remisión vinculada a una nota de crédito.
  • Ejemplo de uso: Crear un PDF para una nota de crédito relacionada con una remisión.
• Creación de Nueva Nota de Crédito
• GET newNotaCredito
  • Descripción: Muestra el formulario para crear una nueva nota de crédito.
  • Ejemplo de uso: Iniciar el proceso de emisión de una nota de crédito.
• Guardado de Nota de Crédito
• POST notasCredito/save
  • Descripción: Guarda una nueva nota de crédito o actualiza una existente.
  • Ejemplo de uso: Confirmar los datos de una nota de crédito.
• Obtención de XML Enlazados
• GET xmlenlace/getXMLEnlazadosNotaCredito/(:any)
  • Descripción: Obtiene los archivos XML vinculados a una nota de crédito, útil para auditorías fiscales.
  • Ejemplo de uso: Descargar XML para cumplir con requisitos del SAT.

Otros Cambios

• Controladores, Modelos y Vistas:
• Se actualizaron o crearon nuevos controladores (por ejemplo, NotasCreditoController, FacturaElectronicaController, XmlController) para manejar la lógica de las notas de crédito.
• Los modelos se modificaron para incluir consultas relacionadas con la gestión de notas de crédito.
• Se añadieron o actualizaron vistas en app/Views/ para soportar los formularios y la generación de documentos PDF.
• Base de Datos:
• Se incluyeron migraciones en app/Database/Migrations/ para agregar tablas o campos necesarios para almacenar datos de notas de crédito, como una posible tabla credit_notes o campos adicionales en tablas existentes.
• Cumplimiento con CFDI 4.0:
• La funcionalidad se diseñó para cumplir con los requisitos de facturación electrónica del SAT en México, incluyendo el timbrado y la generación de XML.

Impacto

Esta actualización mejora significativamente boilerplateSells, permitiendo a los usuarios:

• Gestionar notas de crédito de manera integral (crear, editar, eliminar, filtrar).
• Generar documentos fiscales en PDF y XML, compatibles con CFDI 4.0.
• Cumplir con normativas fiscales mexicanas, ampliando la utilidad del sistema para negocios que manejan devoluciones o ajustes.

Imágenes

A continuación, se incluyen marcadores de posición para capturas de pantalla que ilustran las nuevas funcionalidades. Reemplaza las rutas con las imágenes reales generadas desde el sistema.

1. Lista de Notas de Crédito
   Descripción: Captura de pantalla de la interfaz que muestra el listado de notas de crédito.
2. Formulario de Creación de Nota de Crédito
   Descripción: Formulario para ingresar los detalles de una nueva nota de crédito.
3. Formulario de Edición de Nota de Crédito
   
   Descripción: Interfaz para modificar una nota de crédito existente.
4. PDF Generado de Nota de Crédito

Descripción: Ejemplo de un documento PDF generado para una nota de crédito.

Conclusión

La versión v1.1.3 de boilerplateSells introduce una funcionalidad robusta para la gestión de notas de crédito, alineada con los requisitos de CFDI 4.0. Esta adición mejora la capacidad del sistema para manejar transacciones complejas, como devoluciones y ajustes, y refuerza su valor para negocios que requieren cumplimiento fiscal en México. Los usuarios ahora pueden generar documentos fiscales válidos en formatos PDF y XML, con una interfaz optimizada para la gestión de notas de crédito.

Referencia al Commit: 84b72249259196bc228e99a95be3599fdacd3023

Full Changelog: https://github.com/julio101290/boilerplateSells/compare/v1.1.2…v1.1.3

Información General

Cambios Principales

1. URLs Dinámicas en CodeIgniter

• Descripción: Implementación de URLs dinámicas para facilitar la configuración en diferentes entornos (desarrollo, pruebas, producción).
• Beneficios:
  • Mayor portabilidad entre servidores sin ajustes manuales.
  • Simplificación de la configuración para usuarios finales.
  • Adaptabilidad a dominios variables sin modificar el código.
• Implementación Técnica:
  • Configuración probable en app/Config/App.php para definir baseURL dinámicamente:phppublic $baseURL = env('app.baseURL', 'http://localhost/');
  • Uso de variables de entorno en .env para establecer la URL base.
  • Uso de funciones como base_url() o site_url() para generar rutas adaptables.

2. Manejo de Errores sin Salir del Sistema

• Descripción: Mejora en el manejo de errores, incluyendo errores 404, para mostrar mensajes claros al usuario sin interrumpir el flujo de la aplicación, manteniendo los menús y otras funcionalidades activas.
• Beneficios:
  • Experiencia de usuario mejorada con mensajes de error integrados en la interfaz del sistema.
  • Mantiene la navegación (menús, barras laterales, etc.) visible y funcional.
  • Mayor estabilidad al evitar cierres inesperados.
  • Facilita la depuración para desarrolladores.
• Implementación Técnica:
  • Función error404():phppublic function error404() { $titulos["title"] = "Error 404"; $titulos["subtitle"] = "Ruta no encontrada"; return view('error404', $titulos); }
    • Ubicación: Probablemente en un controlador personalizado (e.g., ErrorController en app/Controllers) o en el controlador base para manejar errores 404.
    • Propósito: Renderiza una vista personalizada (error404.php) cuando se accede a una ruta inexistente, pasando un array $titulos con el título y subtítulo de la página para mantener consistencia con el diseño de la aplicación.
    • Impacto:
      • Al usar return view(‘error404’, $titulos), la vista de error se integra en el sistema, mostrando los menús, barras de navegación y otras funcionalidades definidas en el layout principal (e.g., un template con header, footer y sidebar).
      • Evita que el sistema muestre el error 404 predeterminado de CodeIgniter o PHP, que podría interrumpir la experiencia del usuario.
      • Permite al usuario seguir navegando sin salir del sistema, ya que la vista error404 se carga dentro del contexto de la aplicación.
    • Detalles de la Vista:
      • La vista error404.php (en app/Views/error404.php) probablemente utiliza el layout principal de la aplicación, incluyendo menús y elementos de la interfaz.
      • Ejemplo hipotético de error404.php:php<?= $this->extend('layouts/main') ?> <?= $this->section('content') ?> <div class="container"> <h1><?= esc($title) ?></h1> <p><?= esc($subtitle) ?></p> <p>La página que buscas no existe. Por favor, verifica la URL o regresa al <a href="<?= base_url() ?>">inicio</a>.</p> </div> <?= $this->endSection() ?>
      • Esto asegura que la página de error 404 mantenga el diseño consistente (menús, estilos, etc.) y permita al usuario continuar interactuando con el sistema.
  • Configuración Adicional:
    • Posible ajuste en app/Config/Exceptions.php para redirigir errores 404 a esta función:phppublic $errorViewPrefix = 'errors/';
    • Validaciones mejoradas en controladores para prevenir errores críticos antes de que se desencadenen.

Análisis de Cambios en el Código

Archivos Modificados (Inferidos)

• app/Config/App.php: Ajuste de baseURL para URLs dinámicas.
• app/Config/Exceptions.php: Configuración para personalizar el manejo de errores, incluyendo la redirección a error404().
• Controladores:
  • Controlador con la función error404() (e.g., app/Controllers/ErrorController.php).
  • Lógica para capturar errores 404 y renderizar la vista correspondiente.
• Vistas:
  • app/Views/error404.php: Vista personalizada para errores 404, integrada con el layout principal para mostrar menús y otras funcionalidades.
• Archivo .env: Configuración de app.baseURL para URLs dinámicas.
• Rutas (app/Config/Routes.php):
  • Posible definición de una ruta personalizada para errores 404:php$routes->set404Override('App\Controllers\ErrorController::error404');

Estructura de Cambios

• URLs Dinámicas:
  • Lógica para detectar automáticamente el dominio o usar variables de entorno.
  • Simplificación de la configuración de rutas.
• Manejo de Errores:
  • Implementación de error404() para manejar rutas no encontradas de manera elegante.
  • Uso de vistas personalizadas que extienden el layout principal, asegurando que los menús y funcionalidades permanezcan accesibles.
  • Captura de excepciones mediante try-catch o configuraciones globales.

Beneficios y Mejoras

Detalles de la Función error404()

• Código:phppublic function error404() { $titulos["title"] = "Error 404"; $titulos["subtitle"] = "Ruta no encontrada"; return view('error404', $titulos); }
• Análisis:
  • Parámetros: No recibe parámetros, ya que es una función estática para manejar errores 404.
  • Datos Enviados: Pasa un array $titulos con title y subtitle a la vista error404.php.
  • Vista: La vista error404 probablemente usa el layout principal de la aplicación (mediante extend en CodeIgniter) para mantener la consistencia visual y funcional.
  • Integración: Al renderizar una vista personalizada, el sistema muestra el error dentro del contexto de la aplicación, preservando menús, barras laterales y otras funcionalidades.
• Beneficio Específico:
  • Evita el comportamiento predeterminado de CodeIgniter (mostrar un error genérico o página en blanco).
  • Permite al usuario regresar al inicio o navegar a otras secciones sin salir del sistema.
  • Mejora la experiencia del usuario al presentar errores de manera profesional y coherente con el diseño.

Notas Técnicas

• Dependencias: Sin cambios reportados; compatible con PHP 7.4+ y dependencias estándar de CodeIgniter 4.
• Compatibilidad: No se esperan rompimientos, pero se recomienda probar la vista error404 y las URLs dinámicas en entornos de desarrollo.
• Recomendaciones:
  • Configurar app.baseURL en .env para URLs dinámicas.
  • Personalizar error404.php para alinear el diseño con la aplicación (colores, estilos, menús).
  • Verificar que $routes->set404Override esté configurado en Routes.php para redirigir errores 404 a error404().
  • Probar la navegación desde la página de error para asegurar que los menús y funciones sean accesibles.

Limitaciones del Análisis

• Falta de Changelog Detallado: El enlace no proporciona un changelog específico ni commits detallados.
• Suposiciones: La implementación de error404() se infiere basada en el código proporcionado y prácticas de CodeIgniter 4.
• Sugerencia: Revisar los commits entre versiones 1.0.3 y 1.0.4 para confirmar los cambios exactos.

Conclusión

La versión 1.0.4 de ci4jcposv2 introduce mejoras clave en URLs dinámicas y manejo de errores, destacando la función error404() que renderiza una vista personalizada para errores 404, manteniendo menús y funcionalidades activas. Esto asegura una experiencia de usuario fluida y una aplicación más estable y profesional. Los desarrolladores deben verificar la configuración de rutas y personalizar la vista error404.php para maximizar los beneficios.

¿Necesitas más ayuda? Si deseas un análisis detallado de otros controladores, ajustes en la vista error404.php, o soporte con la implementación, comparte más detalles o solicita ejemplos específicos.

Esta ficha actualizada incorpora la función error404() con un enfoque claro en su rol para mantener la interfaz y funcionalidades del sistema. Si necesitas ajustes adicionales (e.g., formato HTML, ejemplos de vistas, o más detalles técnicos), házmelo saber.

🛠️ ¿Qué trae este commit?
¡Una mejora poderosa en la gestión de usuarios! Ahora puedes clonar un usuario existente incluyendo sus roles y permisos, ahorrando tiempo y evitando errores en la configuración manual.

📌 Cambios destacados:

✅ Nueva ruta:

phpCopiarEditaruser/manage/{id}/clone → UserController::clone

✅ Nuevo método clone($id) en UserController:

• Carga los datos del usuario original
• Preselecciona sus roles y permisos
• Reutiliza la vista de creación para facilitar el registro

✅ Vistas y controladores adaptados para soportar esta funcionalidad de manera limpia y eficiente.

📁 Archivos modificados:

• Config/Routes.php
• Controllers/UserController.php
• Views/users/form.php (si aplica)
• Otras optimizaciones menores en rutas y estructuras

🎯 Beneficios:

• 🔄 Reutilización rápida de perfiles
• 🔐 Mejor gestión de permisos
• ⏱️ Ahorro de tiempo para administradores

💡 ¿Tienes muchos usuarios con permisos similares?
¡Ahora puedes clonarlos en segundos y mantener todo bajo control! ⚙️👥

🧠 Commit por: @julio101290
📁 Repositorio: Boilerplate

Cómo instalar LAMP (Linux, Apache, MariaDB, PHP) en Ubuntu Server 24.04 y configurarlo para CodeIgniter 4.5

Esta guía te explica cómo preparar un servidor Ubuntu 24.04 con el stack LAMP y CodeIgniter 4.5, incluyendo Composer para manejar dependencias PHP.

1. Actualiza el sistema

sudo apt update && sudo apt upgrade -y

2. Instala Apache

sudo apt install apache2 -y
sudo systemctl status apache2

3. Instala MariaDB

sudo apt install mariadb-server mariadb-client -y
sudo systemctl start mariadb
sudo systemctl enable mariadb
sudo mysql_secure_installation

4. Instala PHP y extensiones necesarias

sudo apt install php php-mysql php-intl php-curl php-xml php-mbstring php-cli unzip -y
php -v

5. Activa mod_rewrite

sudo a2enmod rewrite
sudo systemctl restart apache2
sudo nano /etc/apache2/sites-available/000-default.conf

Añade esto dentro del bloque <VirtualHost *:80>:

<Directory /var/www/html>
    AllowOverride All
</Directory>

sudo systemctl restart apache2

6. Instala Composer

sudo apt install curl php-cli php-mbstring git unzip -y
cd ~
curl -sS https://getcomposer.org/installer -o composer-setup.php
HASH="$(curl -sS https://composer.github.io/installer.sig)"
php -r "if (hash_file('sha384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm composer-setup.php
composer --version

7. Descargar CodeIgniter 4.5

cd /var/www/html
sudo rm index.html
sudo composer create-project codeigniter4/appstarter ci4
sudo chown -R www-data:www-data ci4
sudo chmod -R 755 ci4

8. Configura Apache para CodeIgniter

sudo nano /etc/apache2/sites-available/ci4.conf

Pega lo siguiente:

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/html/ci4/public
    ServerName localhost

    <Directory /var/www/html/ci4/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/ci4_error.log
    CustomLog ${APACHE_LOG_DIR}/ci4_access.log combined
</VirtualHost>

sudo a2ensite ci4.conf
sudo a2dissite 000-default.conf
sudo systemctl reload apache2

9. Crear base de datos y usuario en MariaDB

sudo mariadb

CREATE DATABASE ci4db;
CREATE USER 'ci4user'@'localhost' IDENTIFIED BY 'tu_password_segura';
GRANT ALL PRIVILEGES ON ci4db.* TO 'ci4user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

10. Configurar la base de datos en CodeIgniter

sudo nano /var/www/html/ci4/app/Config/Database.php

public $default = [
    'DSN'      => '',
    'hostname' => 'localhost',
    'username' => 'ci4user',
    'password' => 'tu_password_segura',
    'database' => 'ci4db',
    'DBDriver' => 'MySQLi',
    // resto de configuraciones...
];

11. Verifica en el navegador

Abre tu navegador y visita:

http://TU_IP_O_DOMINIO/

Deberías ver la página de bienvenida de CodeIgniter 4.5.

✅ ¡Entorno LAMP + CodeIgniter 4.5 listo!

Ahora puedes comenzar a desarrollar tus proyectos PHP modernos con CodeIgniter y MariaDB.