@JoaquimCassano - Perguntas gerais

[bolodissenoura]

          @JoaquimCassano

Agora sobre o refactor das estruturas dos componentes e etc, você pediu para que abrisse uma PR mas também levantou preocupação com a estrutura "demasiadamente complexa". Queria entender melhor sobre isso antes de uma abrir uma nova PR sobre a ótica de alguns pilares.

• Como você pensa em modularização da SDK? O que você sugere? Que arquitetura de software foi pensada aqui?
• Como você vai lidar quando a AbacatePay incluir novos endpoints, features, e funcionalidades que são dependentes uma das outras? Como isso entra aqui pensando em escala de sei lá...15 anos?
• Como você avalia a garantia de Git Workflow quando o projeto escalar e muitos desenvolvedores passarem a usar essa SDK e contribuir com ela? Ou seja, com componentes "demasiadamente simples" porém extensos demais, eu tendo a pensar que isso pode virar um problema sério no futuro. O que você acha?

Originally posted by @IvanildoBarauna in #8 (comment)

[JoaquimCassano]

Primeiramente, perdão a demora para responder, tive que resolver outras coisas pessoais.

As perguntas são boas e, honestamente, não havia pensado em algumas coisas aqui citadas.
Quanto à questão da modularização, o plano futuro é transformar _models.py em uma pasta, para evitar o problema de componentes grandes demais. Além disso, planejo mover a parte de costumers pra fora do arquivo init.py e tentar refatorar ele pra um modelo em que ele não cresça demais conforme novos endpoints e recursos são adicionados.

Além disso, gostaria de explicar melhor minha opinião sobre o modelo de estrutura de pastas usado no seu PR (Domain-Driven Design, se não me engano) é um modelo bom e escalável, porém, no meu ponto de vista, é um modelo que pode parecer um pouco confuso para iniciantes que desejem usar e contribuir com a SDK.

Novamente, perdão pela demora, e estou aberto para sugestões!
Abraços!

cc @IvanildoBarauna

[JoaquimCassano]

Fiz um refactor na estrutura de pastas, que se encontra na branch folder-refactor.

Se possível, olhem a branch e deem suas sugestões!
Obrigado.

[IvanildoBarauna]

Opa @JoaquimCassano, bom dia!

Perfeito, que bom que você entende que esse é um ponto importante e que merece o refactor.

Vale um esclarecimento, a estrutura usada na minha PR nada tem haver com DDD (Domain Driven Design) na verdade, DDD nem resolve problemas de arquitetura de software, no máximo vai te ajudar a implementar um pattern de ACL (Anti Corruption Layer) mas nada muito além disso.
Se fosse classificar minha proposta, a que mais se aproximaria seria Arquitetura Hexagonal talvez por uma segregação nítida entre core da aplicação ou seja, Entidades de domínio, useCases VS Infrastructure.

Outro ponto importante, mais facilidade do lado de quem embarca sua aplicação é naturalmente mais complexidade do lado de quem desenvolve. Pra quem usa é por ex:

from abacatePay import Client

client = Client(api_key="x")

data = client.get_data()

Pra chegar nesse resultado e pra ser modular a tal ponto, uma boa e definida arquitetura de software é extremamente importante, fora questões ligadas a resiliência e mais uma série de temas que deixaria meu comentário maior do que já está.

[JoaquimCassano]

É, quanto à parte do DDD, eu me confundi legal. Vc tá certo. Sono hehe

Enfim, o que você acha sobre o refactor na branch?

[IvanildoBarauna]

Opa, olhei aqui e parece que já foi mergeado.

Pelo que vi, aparenta ser um bom início.
Evolua com o tempo.

Abraço.

[JoaquimCassano]

Boa