Feature/challenge

[ArquitetoMovel]

Esta solicitação pull conclui uma refatoração importante da API de comércio eletrônico Python/Flask code-smells-project, migrando-a para uma arquitetura MVC limpa com uma camada de serviço. Ele introduz nova documentação e arquivos de configuração, atualiza a estrutura da base de código e remove antipadrões legados. As mudanças mais importantes estão resumidas abaixo.

Refator de arquitetura e estrutura do projeto

• A aplicação foi totalmente refatorada para seguir o padrão MVC, agora dividida em src/views, src/controllers, src/services e src/models, com módulos de configuração e banco de dados. O ponto de entrada (app.py) é simplificado para usar uma fábrica de aplicativos e configurações baseadas no ambiente. [1] [2] [3]
• Todo o código monolítico herdado, incluindo classes god, endpoints SQL diretos e estado global, foi removido. A nova estrutura garante separação de preocupações e maior facilidade de manutenção. [1] [2]

Documentação e orientação do desenvolvedor

• O README.md e o novo AGENTS.md foram atualizados para descrever a nova arquitetura, pilha, padrões de codificação e como executar ou testar o projeto. Eles também especificam questões fixas e acordos de trabalho para futuros contribuidores. [1] [2]
• Nova documentação de habilidades para o processo de refatoração foi adicionada em .claude/skills/refactor-arch/, detalhando cada fase, níveis de gravidade para problemas e exemplos de relatórios para análise, code cheiros e resultados de refatoração. [1] [2] [3] [4] [5]

Melhorias na qualidade e segurança do código

• O SQL parametrizado é totalmente aplicado e os endpoints de execução direta do SQL são removidos para evitar vulnerabilidades de injeção. As senhas agora são criptografadas e nunca expostas nas respostas.
• A nova estrutura e documentação impõem o uso de variáveis ​​de ambiente para segredos e configuração, e os padrões de registro são esclarecidos. [1] [2]

Arquivos e relatórios de suporte

• Todos os resultados e relatórios de habilidades de refatoração são organizados em docs/ para rastreabilidade e auditoria. [1] [2] [3] [4]

Diversos

• Os arquivos de configuração .cursor e .claude foram adicionados para suportar o novo desenvolvimento e fluxo de trabalho do agente de IA.

---

Alterações mais importantes

1. Refatorador de Arquitetura

• Migrei o projeto para uma estrutura modular MVC com clara separação de visualizações, controladores, serviços e modelos; o código monolítico legado é removido e substituído por um padrão de fábrica de aplicativos em app.py. [1] [2]

2. Documentação e Padrões

• Atualizado README.md e adicionado um AGENTS.md abrangente com diagramas de arquitetura, padrões de codificação e instruções de execução; esclareceu questões corrigidas e diretrizes de segurança. [1] [2]

3. Segurança e qualidade de código

• Aplicação de SQL parametrizado, remoção de endpoints SQL arbitrários e garantia de senhas com hash e segredos baseados no ambiente.

4. Habilidade de refatoração e relatórios

• Adicionado .claude/skills/refactor-arch/ com documentação detalhada de habilidades, referências de gravidade e modelos para análise, problemas e relatórios de refatoração. [[1]](diffhunk://#diff-8a4d87385fddf7b58d04b97806f272ae5b0b7b3a49429f7a189ab2590cbc0eb8R1-R44