O que é o Projeto Energy Awareness?

Energy Awareness (EA) em português "Consciencialização para a Energia 💡" é um projecto open-source que visa ajudar as famílias 👨‍👩‍👧‍👦 a fazerem o uso adequado da energia elétrica economizando nas despesas e garantir uma redução no orçamento mensal. Os usuários vão puder calcular de maneira fácil e rápida o custo de cada equipamento ligado a corrente elétrica, bem como receber dicas e sugestões sobre os melhores momentos para usar cada equipamento bem como eventuais alterações das taxas e tarifas adicionais aplicadas pelas companhias de energia. Portanto, os usuarios vão puder fazer simulações e previsão dos custos com a energia antes mesma da factura ou boleto chegar. 💸

Este projeto visa demonstrar o uso de boas patricas de desenvolvimento de software

Dê uma estrela ⭐ e acompanha o crescimento 👀

Se você gostou do projecto EA ou ajudou-te, deixa uma estrela e faça a sua contribuição.

Como usar este projeto?

• Precisa ter instalado o Visual Studio 2022 ou posterior, compativel com o SDK .NET 8.
• Clonar este projecto para o seu computador
• Executar a restauração dos pacotes Nuget ou dependências dos projectos

Também pode ser executado usando o Visual Studio Code (Windows, Linux ou MacOS).

Arquitetura

• Arquitetura Limpa e boas práticas

Abordagem

• DDD (Domain Drive Designer)

Princípios

• Código Limpo
• SOLID
• KISS - Manter o máximo de simplicidade e descartar a complexidade.
• DRY - Evite ao maximo replicação, optando por abstração de coisas comum.
• YAGNI - Manter somente as funcionalidades necessárias, deixando as funcionalidades futuras para o futuro.
• SoC - Manter a separação de responsabilidade ou comportamento.

Padrões

• CQRS
• Unit Of Work
• Repository
• Singleton, Scoped e Transient.
• Domain Model
• Domain Events
• Domain Validation
• Domain Notifications
• Dependency Injection

Tecnologias

• .NET 8
  • ASP.NET Core Web API
  • Identity
  • Native DI
• Docker
• Swagger com JWT
• Fluent Validation
• EntityFramework Core
• Serilog + Seq

Tecnologias usadas nos Testes

• xUnit
• FluentAssertions
• NetArchTest

Pull-request

Caso queira contribuir entre sempre em contacto para alinharmos os próximos passos.

Estamos Online

O projeto esta disponível online em Energy Awareness

Sobre

O projeto Energy Awareness foi desenvolvido por Martinho Sebastião