Este projeto Ć© um sistema de gerenciamento de pedidos desenvolvido em TypeScript, focado na implementaĆ§Ć£o da Arquitetura Hexagonal (Ports and Adapters). O objetivo principal Ć© demonstrar uma aplicaĆ§Ć£o robusta, escalĆ”vel e de fĆ”cil manutenĆ§Ć£o, desacoplando a lĆ³gica de negĆ³cio das tecnologias de infraestrutura e interfaces externas.
Principais Tecnologias
- TypeScript (linguagem principal)
- Node.js (ambiente de execuĆ§Ć£o)
- Express.js (framework web para a camada de interface HTTP)
- Prisma ORM (para persistĆŖncia de dados)
- RabbitMQ (para mensageria e eventos assĆncronos)
- Vitest (framework de testes)
- ESLint (para padronizaĆ§Ć£o de cĆ³digo)
Funcionalidades
- CriaĆ§Ć£o de Pedidos: Permite a criaĆ§Ć£o de novos pedidos.
- AdiĆ§Ć£o de Itens: Funcionalidade para adicionar itens a um pedido existente.
- CĆ”lculo de Total: CĆ”lculo automĆ”tico do valor total do pedido, incluindo lĆ³gica de desconto.
- AtualizaĆ§Ć£o de Status: Gerenciamento do ciclo de vida do pedido atravĆ©s de atualizaƧƵes de status.
- Gerenciamento de Eventos de DomĆnio: UtilizaĆ§Ć£o de eventos para comunicaĆ§Ć£o entre contextos e integraĆ§Ć£o com serviƧos externos (ex: estoque, notificaĆ§Ć£o).
- IntegraĆ§Ć£o com ServiƧos Externos: AdaptaĆ§Ć£o para serviƧos de estoque, notificaĆ§Ć£o e cĆ”lculo de desconto.
Objetivo
O projeto serve como um estudo de caso e demonstraĆ§Ć£o prĆ”tica dos princĆpios da Arquitetura Hexagonal, promovendo:
- Desacoplamento: SeparaĆ§Ć£o clara entre o domĆnio e as camadas de infraestrutura/interface.
- Testabilidade: Facilita a escrita de testes unitĆ”rios e de integraĆ§Ć£o.
- Manutenibilidade: Torna o sistema mais fƔcil de evoluir e adaptar a novas tecnologias.
- Escalabilidade: Prepara a aplicaĆ§Ć£o para crescer e lidar com maior complexidade.