Persistencia de objetos de valor de tipos de datos PHP con Doctrine DBAL: Laravel con configuración automática y sin necesidad de configuración adicional.

php-datatypes-laravel-doctrine

Este paquete permite que un objeto hradigital/php-datatypes sea el tipo declarado de un atributo de Doctrine Entity. Doctrine solo conserva los tipos que incluye, por lo que un EmailAddress , un Money o un Address tendrían que declararse como primitivos y convertirse manualmente en cada lectura y escritura. Incluye un tipo DBAL de Doctrine por cada objeto Datatypes, además de un proveedor de servicios de Laravel que los registra todos, de modo que la entidad contiene el objeto Value mientras que la base de datos conserva un valor simple, indexable y legible.

• Tipos DBAL de Doctrine : uno por objeto Datatypes: StrType , EmailAddressType , UrlType , SlugType , DatetimeType , CurrencyType , MoneyType , AddressType y el resto.
• Tipos nativos de PHP : NativeDateTimeType , NativeDateTimeImmutableType , NativeDateIntervalType y NativeDateTimeZoneType , por lo que una entidad que contiene un simple \DateTime se asigna bajo la misma convención de nomenclatura.
• Proveedor de servicios de Laravel : se detecta automáticamente y registra cada tipo antes de que cualquier EntityManager resuelva una asignación. No hay nada que publicar ni que configurar.
• Una regla de nomenclatura : el nombre de un tipo de Doctrine siempre es el nombre corto de la propia clase Type.
• Validación en la entrada : un fallo de validación de un objeto de valor se manifiesta como un DBAL ConversionException , por lo que un valor no válido se rechaza en lugar de corromper la columna.
• Framework-optional : los tipos son tipos DBAL simples sin dependencia de framework; el proveedor de servicios es una conveniencia.

Lo que este paquete no es

• No es una bifurcación ni un reemplazo para hradigital/php-datatypes Depende de él y le añade persistencia, nada más. El comportamiento, la validación y la API de los objetos de valor son completamente suyos.
• No es un ORM ni un conjunto de entidades. Aporta tipos de columnas. Tus entidades, asignaciones y repositorios siguen siendo tuyos.
• No es exclusivo de Laravel. Consulta la sección "Usarlo fuera de Laravel" .

Plataforma full-stack desarrollada para una empresa de construcción e ingeniería civil en Portugal, que integra su sitio web público, portafolio de proyectos, reclutamiento, noticias y testimonios de clientes en una única aplicación Laravel coherente.

Diseñado en torno a contextos delimitados que abarcan los dominios del mundo real de la empresa (información de la empresa, proyectos, reclutamiento, noticias, testimonios, notificaciones y más), siguiendo el diseño orientado a dominios basado en eventos y la arquitectura limpia, con una canalización dedicada basada en colas que desacopla los efectos secundarios de la lógica central del dominio.

Probado exhaustivamente en toda la pirámide: unidad, integración, funcionalidad, características, sistema y de extremo a extremo.

Envoltorio de Laravel para la biblioteca PHP-Exception, que integra el manejo de errores de Laravel y proporciona un Rendered para estas excepciones.

excepciones-php-laravel

Cableado de Laravel y renderizadores JSON/web para el árbol de excepciones del dominio hradigital/php-exceptions .

La biblioteca base incluye excepciones independientes de la plataforma ( AbstractBaseException y los árboles Client/ y Server/ , alineados con la semántica HTTP 4xx/5xx) y no tiene conocimiento de ningún protocolo de transporte, dejando que cada aplicación decida de nuevo cómo una excepción de dominio lanzada se convierte en una respuesta.

Este paquete lo decide una sola vez. Las solicitudes a la API reciben un cuerpo JSON uniforme; las solicitudes web que devuelven un error 422 regresan al formulario de origen con errores y datos antiguos; cualquier otra excepción del paquete se responde en la web con el estado HTTP que declara. Una excepción que no se extiende AbstractBaseException se envía al manejador propio de Laravel, sin modificaciones.

• ExceptionRenderer - el despachador de estrategias JSON, que resuelve una excepción a la primera estrategia que la admite, con una alternativa que siempre coincide.
• WebRenderer - el despachador de estrategia web, que resuelve una excepción a la primera estrategia que la admite, con una alternativa que siempre coincide.
• ExceptionsServiceProvider - auto-descubierto, vinculando ambos despachadores como singletons y registrando dos renderable() hooks en el manejador de excepciones de Laravel.
• Detección de API : una regla compartida entre ambos hooks: el encabezado Accept , un cuerpo JSON, una ruta api/* o un nombre de ruta api.* .
• Estrategias agrupadas : DefaultRenderer y InputFailureRenderer para JSON, InputFailureWebRenderer , UnprocessableEntityWebRenderer y DefaultWebRenderer para la web.
• Estrategias personalizadas : resuelve el singleton y añade el tuyo propio; el último registro es el que prevalece.

Excepciones de dominio semánticas y alineadas con HTTP para aplicaciones DDD en PHP 8.1+: independientes del framework y sin dependencias en tiempo de ejecución.

Gestor de formularios del lado del cliente con reconocimiento de estado para formularios HTML estáticos. Realiza un seguimiento del estado de cada campo (nuevo, sin cambios, modificado, inválido, vacío) y activa o desactiva las acciones de la barra de herramientas en consecuencia.

@hradigital/smartforms

Gestor de formularios del lado del cliente con reconocimiento de estado para formularios HTML estáticos. Añade comportamiento reactivo al HTML que ya genera una aplicación renderizada por el servidor, basándose completamente en atributos: basta con marcar un <form> con la clase smartform para que tome el control. Los campos, los botones de la barra de herramientas y las acciones HTTP siguen el estado del formulario, sin necesidad de React ni Vue y sin reescribir el marcado que el servidor ya envía.

• Estado por campo : realiza un seguimiento new , unchanged , changed , invalid y empty , aplicando una clase CSS coincidente para el estilo.
• Dos diseños : una lista de registros ( smartformlist ) o un solo registro ( smartformrecord ).
• Configuración de la barra de herramientas : habilita y deshabilita los botones de crear, actualizar, eliminar y cancelar desde el estado general del formulario.
• Tareas HTTP : vincula una acción de la barra de herramientas a un verbo y un punto final, declarados en el marcado.
• formStateChange eventos - CustomEvent por transición de estado, para todo aquello que la biblioteca no cubra.
• Sin framework, sin pasos de compilación : ESM, CJS y una compilación UMD que se puede cargar directamente desde una etiqueta <script> .

Instalación

npm install @hradigital/smartforms
# or
yarn add @hradigital/smartforms
# or
pnpm add @hradigital/smartforms

O bien, cargue la compilación UMD directamente en el navegador:

<script src="https://unpkg.com/@hradigital/smartforms/dist/smartforms.umd.js"></script>
<script>
    SmartForms.autoInit();
</script>

hradigital.com es mi portafolio personal de ingeniería, creado como una extensión funcional de mi CV y mi perfil de LinkedIn, en lugar de una página estática. Es una aplicación Laravel con seis idiomas (EN/PT/FR/ES/DE/NL), diseñada con los mismos principios de Diseño Orientado a Dominios y Arquitectura Limpia que aplico en sistemas fintech en producción: una clara separación entre las capas de Aplicación, Dominio, Framework e Infraestructura, siguiendo los principios SOLID.

El sitio web obtiene y muestra contenido dinámico en tiempo real, en lugar de codificarlo directamente, todo ello mediante integraciones de API REST. Se ha sometido a pruebas exhaustivas en toda la pirámide (unitaria, de integración, de funcionalidades, funcional, de sistema y de extremo a extremo) y refleja la misma disciplina de ingeniería que aplico en mi trabajo con los clientes: contextos delimitados, eventos de dominio e infraestructura que no interfiere con el funcionamiento del dominio.

Acción de GitHub para calcular la próxima versión de lanzamiento en función de confirmaciones convencionales.

Ayudar a mantener la solución Fintech actual y a realizar la transición de partes del sistema a una arquitectura de microservicios.

• Basado en LAMP (Laravel y Symfony).
• Clara separación entre las capas de aplicación y dominio (y también entre el marco de trabajo y la infraestructura).
• Diseño orientado al dominio y desarrollo guiado por pruebas.
• Aplicando los mejores estándares de la industria (Patrones de diseño/Principios de diseño).

Proyecto de desarrollo de una plataforma de negociación para transacciones de activos financieros.

Proyecto de microservicios basado en eventos, integrado en una solución SaaS Fintech más amplia, que incluye tokens blockchain y gestión de monederos electrónicos. Desarrollado con LAMP (Laravel).

• Desarrollo utilizando arquitectura de microservicios y basada en eventos.
• Clara separación entre las capas de aplicación y de dominio.
• Diseño orientado al dominio y desarrollo guiado por pruebas.
• Aplicando los mejores estándares de la industria (Patrones de diseño/Principios de diseño).

Componentes básicos de DDD para PHP: un Trait probado por atributo, además de objetos de valor inmutables de tipo Str/int/float, Slug, Url, EmailAddress, Money y datetime. Sin frameworks ni dependencias de terceros.

Tipos de datos de PHP

PHP Datatypes crea sus objetos de valor, entidades y agregados a partir de rasgos predefinidos y probados (uno por atributo), dejando la definición de la clase libre para la lógica de negocio que le corresponde.

Los métodos getter devuelven objetos de valor en lugar de tipos primitivos siempre que sea posible, de modo que cada valor se valida y normaliza automáticamente, en lugar de que cada usuario tenga que recordarlo. No existe ninguna dependencia de terceros más allá de PHP, por lo que estos valores funcionan sin necesidad de un framework, una solicitud HTTP o un motor de plantillas.

• AbstractValueObject - la base de la que extiende un Value Object, Entity o Aggregate, dándole construcción a partir de un array, serialización completa y toArray() listo para usar.
• Rasgos de entidad : un rasgo por atributo ( HasPositiveIntegerIDTrait , HasActiveTrait , HasNameTrait , ...), cada uno con las sugerencias de tipo y la normalización para ese atributo.
• Tipos de datos escalares : inmutables Str , envoltorios para enteros y flotantes, con una API fluida que devuelve una nueva instancia en cada operación en lugar de modificar el valor en el lugar.
• Tipos de datos web : Slug , Url y EmailAddress , cada uno de los cuales se valida y normaliza a sí mismo.
• Tipos de datos de fecha y hora : valores de fecha y hora, sin necesidad de utilizar una biblioteca de fechas y horas.
• Vocabulario de excepciones : una excepción tipificada por tipo de dato en la sección Exceptions\Datatypes\* , de modo que un valor rechazado indica qué se rechazó y por qué.

Alcance

Este paquete contiene tipos de datos: valores que se validan y normalizan automáticamente, y que cualquier aplicación PHP puede usar sin necesidad de un framework, una solicitud HTTP o un motor de plantillas. La regla " Sin dependencia de terceros " es tanto una regla de alcance como una regla de dependencia.

El comportamiento que renderiza, analiza documentos o sirve una página web no es un tipo de dato, sino que reside en hradigital/php-markup . php-markup depende de este paquete, nunca al revés.

El proyecto se basa en LAMP en el backend, sobre el framework Laravel. Está dividido en diferentes paquetes que se utilizan en varios proyectos/distribuciones, siendo LRTT uno de ellos. En el frontend, utilizamos HTML5 con Bootstrap y React.

Mi primera tarea en el proyecto consistió en adaptar la funcionalidad para más roles de usuario, adaptar el sistema para el registro y la autenticación de usuarios con múltiples roles, crear un área dedicada a un nuevo rol y desarrollar la funcionalidad de la API para el front-end.

En la parte frontal, además de crear un área dedicada a un nuevo rol de usuario, se trataba de desarrollar una aplicación React que gestionara la información de la beca para un profesor voluntario registrado.

Durante el desarrollo de este proyecto, una de mis tareas consistió en migrar el código a la sintaxis de PHP7 y documentar el código nuevo y existente utilizando PHPDocs.

Reestructuración del diseño y la base de datos. Rediseño y desarrollo de las páginas web de la empresa, basadas en tablas, con nuevas funcionalidades, manteniendo la misma imagen corporativa y utilizando recursos compartidos.