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 🚀

Antes de começar o desenvolvimento, é essencial entender como o usuário vai navegar e interagir com o sistema. O User Flow garante que cada passo da jornada seja pensado para ser intuitivo e funcional.

Por que começamos pelo User Flow?

Mapear o User Flow nos ajuda a entender o que realmente importa para o usuário. Para o Mini CRM Lead Tracker, o foco está em simplicidade, eficiência e visão gerencial de qualidade.

Fluxo Principal (Atualizado para MVP Profissional):

1. Login: Usuário faz login seguro com email e senha.
2. Dashboard (Analytics):
   • Big Numbers (Total de Leads, Leads Ativos, Leads Fechados).
   • Funil Visual (Quantos leads por estágio).
   • Últimos Leads Cadastrados.
3. Página Leads (Operacional):
   • Kanban View (movimentação de leads por estágio).
   • Lista View com Filtros Inteligentes (Status, Origem, Período).
   • Histórico de Movimentações do Lead (registro de mudanças de estágio).
   • Visualizar Detalhes do Lead (dados completos do lead).
   • Adicionar Novo Lead.
   • Exportar Leads (Excel/Sheets).
4. Logout: Finalizar sessão de forma segura.

Diagrama de User Flow (Atualizado)

O que esse fluxo proporciona?

• Visão gerencial clara para gestores.
• Operação simples e ágil para o time comercial.
• Escalabilidade para integrações futuras.
• Facilidade de uso com UX pensada desde o início.

“Fluxo bem desenhado hoje, menos retrabalho amanhã.”

No próximo capítulo do Diário de Bordo, vamos modelar as entidades de dados com base nesse fluxo e preparar o diagrama ER inicial. Acompanhe!

Iniciamos hoje o desenvolvimento do Mini CRM Lead Tracker, um sistema pensado para profissionais e pequenas equipes que precisam de um CRM leve, prático e objetivo.

Objetivos do Projeto

• Captura de leads via landing page integrada.
• Gerenciamento visual de leads em um Kanban (Arrastar e Soltar).
• Exportação rápida dos leads para Excel ou Google Sheets.
• Relatórios básicos para acompanhamento de vendas.

Stack Tecnológica

• Back-end: Laravel (PHP 8.x)
• Front-end: Vue.js 3 + Vite
• API REST: Documentada com Swagger (OpenAPI)
• Banco de Dados: MySQL
• Futuras Automação: Python para relatórios e follow-ups

Próximos Passos

Agora vamos avançar para a definição da arquitetura inicial e modelagem de dados, que vão sustentar a evolução do projeto.

“Cada linha de código será pensada para ser limpa, escalável e bem documentada — porque o futuro agradece.”

Quer acompanhar essa jornada? Fique de olho — novos capítulos do Diário de Bordo serão publicados toda semana!