Persistência de objetos com valores de tipos de dados PHP utilizando Doctrine DBAL - Laravel com configuração automática e sem necessidade de configuração adicional.

php-datatypes-laravel-doctrine

Este pacote permite que um objeto do tipo hradigital/php-datatypes seja declarado como o tipo de um atributo de uma entidade Doctrine. O Doctrine persiste apenas os tipos com os quais é fornecido, pelo que um objeto do tipo EmailAddress , Money ou Address teria de ser declarado como primitivo e convertido manualmente a cada leitura e escrita. Fornece um tipo DBAL do Doctrine por objeto Datatypes, além de um fornecedor de serviços do Laravel que os regista, de modo a que a entidade mantenha o objeto de valor enquanto a base de dados ainda mantém um valor simples, indexável e legível por humanos.

• Tipos DBAL do Doctrine - um por objeto Datatypes: StrType , EmailAddressType , UrlType , SlugType , DatetimeType , CurrencyType , MoneyType , AddressType e os restantes.
• Tipos nativos do PHP - NativeDateTimeType , NativeDateTimeImmutableType , NativeDateIntervalType e NativeDateTimeZoneType , portanto, uma entidade contendo \DateTime mapas simples sob a mesma convenção de nomenclatura.
• Fornecedor de serviços Laravel - descoberto automaticamente, registando cada tipo antes de qualquer EntityManager resolver um mapeamento. Nada para publicar, nada para configurar.
• Uma regra de nomenclatura : o nome de um tipo do Doctrine é sempre o nome abreviado da própria classe Type.
• Validação na entrada - uma falha de validação de um Objecto de Valor manifesta-se como um DBAL ConversionException , pelo que um valor inválido é rejeitado em vez de corromper a coluna.
• Framework opcional - os tipos são tipos DBAL simples, sem dependência de framework; o prestador de serviços é uma conveniência.

O que este pacote não é

• Não é um fork nem um substituto para hradigital/php-datatypes Depende dele e acrescenta persistência, nada mais. O comportamento, a validação e a API dos Objetos de Valor são inteiramente próprios.
• Não é um ORM, nem um conjunto de entidades. Contribui com tipos de coluna. As suas entidades, mapeamentos e repositórios permanecem seus.
• Não é exclusivo do Laravel. Ver Usar fora do Laravel .

Plataforma full-stack desenvolvida para uma empresa de construção civil e engenharia em Portugal, reunindo o seu website público, portfólio de projetos, recrutamento, notícias e testemunhos de clientes numa única aplicação Laravel coesa.

Concebida em torno de contextos delimitados que abrangem os domínios do mundo real da empresa (informações da empresa, projetos, recrutamento, notícias, testemunhos, notificações e muito mais), seguindo o Event Oriented Design e Clean Architecture, com um pipeline dedicado baseado em filas de espera que desacopla os efeitos colaterais da lógica principal do domínio.

Totalmente testado em toda a pirâmide — Unidade, Integração, Funcionalidade, Recurso, Sistema e E2E (ponta a ponta).

Wrapper do Laravel para a biblioteca PHP-Exception, que integra o tratamento de erros do Laravel e fornece um componente Rendered para estas exceções.

php-exceções-laravel

Configuração do Laravel e renderizadores JSON/web para a árvore de exceções de domínio hradigital/php-exceptions .

A biblioteca base fornece exceções independentes de plataforma - AbstractBaseException e as árvores Client/ e Server/ , alinhadas com a semântica HTTP 4xx/5xx - e não sabe nada sobre o transporte, deixando para cada aplicação a decisão de como uma exceção de domínio lançada se torna uma resposta.

Este pacote decide isso uma única vez. Os pedidos à API recebem um corpo JSON uniforme; os pedidos web que devolvem um código 422 são redirecionados para o formulário original com erros e os dados introduzidos anteriormente; todas as outras exceções do pacote são tratadas na web com o estado HTTP declarado. Uma exceção que não estende o código AbstractBaseException é encaminhada para o gestor de exceções do Laravel, sem ser alterada.

• ExceptionRenderer - o despachante de estratégia JSON, que resolve uma exceção para a primeira estratégia que a suporta, com uma alternativa sempre correspondente.
• WebRenderer - o web strategy despachante, que resolve uma exceção para a primeira estratégia que a suporta, com uma alternativa sempre correspondente.
• ExceptionsServiceProvider - Descoberto automaticamente, ligando ambos os dispatchers como singletons e registando dois hooks renderable() no gestor de exceções do Laravel.
• Detecção de API - uma regra comum a ambos os hooks: o cabeçalho Accept , um corpo JSON, um caminho api/* ou um nome de rota api.* .
• Estratégias agrupadas - DefaultRenderer e InputFailureRenderer para JSON, InputFailureWebRenderer , UnprocessableEntityWebRenderer e DefaultWebRenderer para a web.
• Estratégias personalizadas - resolva o problema singleton e adicione a sua própria estratégia; o último registo é o que prevalece.

Exceções de domínio semânticas e alinhadas com o HTTP para aplicações DDD em PHP 8.1+ — independentes de frameworks e sem dependências de tempo de execução.

Gestor de formulários do lado do cliente com reconhecimento de estado para formulários HTML estáticos. Monitoriza o estado de cada campo (novo, inalterado, alterado, inválido, vazio) e alterna as ações da barra de ferramentas em conformidade.

@hradigital/formulários inteligentes

Gestor de formulários do lado do cliente com reconhecimento de estado para formulários HTML estáticos. Adiciona comportamento reativo ao HTML já gerado por uma aplicação renderizada no servidor, controlado inteiramente por atributos — marque um <form> com a classe smartform e ele assume o controlo. Os campos, botões da barra de ferramentas e acções HTTP passam a seguir o estado do formulário, sem React ou Vue e sem reescrever a marcação já enviada pelo servidor.

• Estado a campo - acompanha new , unchanged , changed , invalid e empty , aplicando uma classe CSS correspondente para estilização.
• Dois layouts - uma lista de registos ( smartformlist ) ou um único registo ( smartformrecord ).
• A configuração da barra de ferramentas permite ativar e desativar os botões de criar, atualizar, eliminar e cancelar no estado geral do formulário.
• Tarefas HTTP - associa uma ação da barra de ferramentas a um verbo e a um ponto final, declarados na marcação.
• formStateChange eventos - uma transição de CustomEvent por estado, para tudo o que a biblioteca não cubra.
• Sem framework, sem passo de compilação - ESM, CJS e uma compilação UMD carregáveis diretamente de uma etiqueta <script> .

Instalação

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

Ou carregue a versão UMD diretamente no browser:

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

hradigital.com é o meu portfólio pessoal de engenharia, criado como uma extensão funcional do meu currículo e perfil do LinkedIn, e não como uma página estática. É uma aplicação Laravel em seis línguas (EN/PT/FR/ES/DE/NL), arquitetada com os mesmos princípios de Design Orientado a Eventos e Domínio (DDD) e Arquitetura Limpa que aplico em sistemas de produção fintech — clara separação entre as camadas de Aplicação, Domínio, Framework e Infraestrutura, seguindo os princípios SOLID.

O site procura e exibe conteúdo dinâmico ao vivo de forma ativa, em vez de o codificar diretamente, tudo integrado através de APIs REST. É totalmente testado em toda a pirâmide de testes — unitário, de integração, de funcionalidade, funcional, de sistema e de ponta a ponta — e reflete a mesma disciplina de engenharia que aplico em projetos para clientes: contextos delimitados, eventos de domínio e infraestrutura que não interfere no domínio.

Auxiliar na manutenção da solução Fintech atual e na transição de partes do sistema para uma arquitetura de micro-serviços.

• Baseado em LAMP (Laravel e Symfony).
• Separação nítida entre as camadas de Aplicação e Domínio (bem como entre Framework e Infraestrutura).
• Design orientado para o domínio e desenvolvimento orientado para testes.
• Aplicar as melhores práticas da indústria (Design Standards/Design Principles).

Desenvolvimento de um projeto de plataforma de negociação para transações de ativos financeiros.

Design de microsserviços orientado a eventos, como parte de uma solução SaaS Fintech maior, envolvendo tokens blockchain e gestão de carteiras eletrónicas. Baseado em LAMP (Laravel).

• Desenvolvimento utilizando arquitetura de micro-serviços e orientada a eventos.
• Separação nítida entre as camadas de Aplicação e de Domínio.
• Design orientado para o domínio e desenvolvimento orientado para testes.
• Aplicar as melhores práticas da indústria (Design Standards/Design Principles).

Blocos de construção DDD para PHP: um Trait testado por atributo, além de objetos de valor imutáveis do tipo Str/int/float, Slug, Url, EmailAddress, Money e datetime. Sem necessidade de frameworks ou dependências de terceiros.

Tipos de dados PHP

O PHP Datatypes constrói os seus objetos de valor, entidades e agregados a partir de características predefinidas e testadas - uma para cada atributo - deixando a definição da classe livre para a lógica de negócio a ela associada.

Os getters devolvem objetos de valor em vez de tipos primitivos sempre que possível, de modo que um valor transporta a sua própria validação e normalização, em vez de cada chamador ter de o decorar. Não existe qualquer dependência de terceiros para além do próprio PHP, pelo que estes valores funcionam sem uma framework, um pedido HTTP ou um mecanismo de templates.

• AbstractValueObject - a base que um Objecto de Valor, Entidade ou Agregado estende, permitindo a sua construção a partir de um array, serialização completa e toArray() out-of-the-box.
• Características da Entidade - uma característica por atributo ( HasPositiveIntegerIDTrait , HasActiveTrait , HasNameTrait , ...), cada uma contendo as dicas de tipo e a normalização para esse atributo.
• Tipos de dados escalares - wrappers imutáveis Str números inteiros e pontos flutuantes, com uma API fluente que devolve uma nova instância em cada operação, em vez de modificar o valor no local.
• Tipos de dados Web - Slug , Url e EmailAddress , cada um validando-se e normalizando-se.
• Tipos de dados datetime - valores de data e hora, sem necessidade de utilizar uma biblioteca datetime.
• Vocabulário de exceção - uma exceção tipada por tipo de dados em Exceptions\Datatypes\* , de modo que um valor rejeitado indica o que foi rejeitado e porquê.

Âmbito

Este pacote contém tipos de dados: valores que se validam e normalizam automaticamente, e que qualquer aplicação PHP pode utilizar sem uma framework, um pedido HTTP ou um mecanismo de templates. A regra " Sem dependências de terceiros " é tanto uma regra de âmbito como uma regra de dependência.

O comportamento que renderiza, analisa documentos ou existe para servir uma página web não é um tipo de dados e reside em hradigital/php-markup . O php-markup depende deste pacote - nunca o contrário.

O projeto é baseado em LAMP no back-end, utilizando a framework Laravel. O projeto está dividido em diferentes pacotes, que são utilizados em mais do que um projeto/distribuição, sendo o do LRTT um deles. No front-end, utilizamos HTML5 com Bootstrap e React.

A minha primeira tarefa no projeto foi adaptar a funcionalidade a mais perfis de utilizador, adaptar o sistema para registo e autenticação de utilizadores com múltiplos perfis, criar uma área dedicada para novos perfis e desenvolver a funcionalidade da API para o front-end.

Na interface, para além de criar uma nova área dedicada às funções de utilizador, foi necessário desenvolver uma aplicação React que gerisse a informação do programa Fellowship para um professor voluntário registado.

Durante o desenvolvimento deste projeto, uma das minhas tarefas foi migrar o código para a sintaxe do PHP7 e documentar o código novo e existente utilizando o PHPDocs.

Reestruturação do layout e da base de dados. Reformulação e redesenvolvimento dos sites da empresa, com base em tabelas, novas funcionalidades, adotando a mesma identidade visual e recursos partilhados.

Desenvolvimento de formulários web em .NET 1.1. Design e desenvolvimento multimédia em ActionScript e Flash.