Tag: Clean Code

  • Clean Code não é perfumaria. É o seguro de vida do seu time.

    Clean Code não é perfumaria. É o seguro de vida do seu time.

    Tem gente que acha que organizar o código é perda de tempo. Que separar responsabilidades em controller, service e job é “frescura” ou “over engineering”.

    Até o sistema quebrar. O estagiário entrar. O cliente pedir algo urgente. E ninguém conseguir mexer.

    Clean code não é enfeite. É seguro de vida.

    👨‍💻 Código feio vicia a empresa em você

    Tem dev que acha que “centralizar tudo” é uma prova de competência. Quando na verdade, está sabotando o próprio time.

    O código vira um refém da cabeça de quem escreveu. E se essa pessoa sai? Ninguém mais entende. A empresa trava.

    🧠 Arquitetura não é frescura. É responsabilidade.

    Separar responsabilidades, escrever nomes claros, documentar o mínimo… tudo isso é um ato de respeito com quem vem depois. Até com o “você do futuro”.

    • Controller cuida do fluxo
    • Service cuida da regra
    • Job cuida do que pode esperar

    Simples. Elegante. Sustentável.

    🚨 Dev sênior que não compartilha, sabota.

    Se você é sênior e guarda tudo na cabeça, está atrasando a equipe. Liderar é preparar o terreno para que outros consigam andar sem você.

    Quer crescer na carreira? Comece escrevendo como se alguém que você ama fosse manter seu código amanhã.

    👇 E você? Já sofreu com sistemas que só o “criador” entendia?

    Compartilha aí nos comentários. Vamos abrir esse debate.

  • API REST com MVC de verdade no Mini CRM Lead Tracker

    API REST com MVC de verdade no Mini CRM Lead Tracker

    Hoje, no #Dia5 do Diário de Bordo, o projeto começou a ganhar uma API robusta — mas com responsabilidade. Nada de controller gigante ou regra de negócio no model. Aqui a gente aplica MVC de verdade.

    ✅ Entregas do dia

    • Controllers enxutos, só delegando a lógica
    • Services para encapsular regras de negócio
    • Models focados em persistência e relacionamento
    • FormRequest para validações desacopladas
    • Resource para padronizar as respostas da API
    • Jobs + Events para ações desacopladas e assíncronas
    • Rotas versionadas com middleware e prefix (ex: /api/v1/leads)

    🧠 Aplicando MVC com consciência

    Muita gente acha que usa MVC. Mas na prática, mistura tudo no controller ou entope o model de regra.

    Aqui, aplicamos:

    • Model → responsabilidade: banco e relações
    • View → no caso, é o Resource (output JSON padronizado)
    • Controller → apenas orquestra, sem conter lógica

    📦 GitHub com tudo implementado

    👉 Repositório completo no GitHub

    Usar Laravel é fácil. Arquitetar bem usando Laravel é outra história.

    Nos vemos no próximo capítulo do Diário de Bordo 🚀