• ARQUITETURA

  • MVC

  • DDD

  • SERVIÇOS VS ACTIONS

O que pretendemos

Dica de leitura

Arquitetura

* Arquitetura Orientada à Eventos,
* Microserviços e
* Monolitos

Dica de leitura

MVC (Model, views e controllers)

* Model
* Views
* Controllers

Dica de leitura

DDD (Model, views e controllers)

* Domínio e Modelagem do Domínio
* Linguagem Ubíqua
* Entidades, Value Objects e Aggregates
* Repositórios e Serviços
* Contextos Delimitados

Dica de leitura

Services vs Actions

* DRY - Don't Repeat Yourself (Não Se Repita)
* KISS - Keep It Simple, Stupid (Mantenha Simples, Estúpido)
* YAGNI - You Aren't Gonna Need It (Você Não Vai Precisar Disso)
* TDA - Tell, Don't Ask (Diga, Não Pergunte)

KISS

〞

O acrônimo "Keep It Simple, Stupid" foi posteriormente adotado pela Marinha dos EUA em 1960. O conceito rapidamente transcendeu o contexto militar e encontrou aplicação em diversas áreas, incluindo o desenvolvimento de software.

– DEV.TO

 importância do KISS no desenvolvimento de software é multifacetada:

 

  • Manutenibilidade: Código simples é mais fácil de entender e modificar.
  • Depuração: Soluções simples apresentam menor superfície para bugs potenciais.
  • Integração de novos desenvolvedores: Profissionais recém-chegados ao projeto conseguem compreender e contribuir para o código mais rapidamente.
  • Desempenho: Soluções simples frequentemente apresentam melhor desempenho que alternativas complexas.
  • Adaptabilidade: Sistemas simples geralmente respondem melhor a novos requisitos.

Por que é importante?

  •  Subjetividade da simplicidade: O que é "simples" para um desenvolvedor pode ser complexo para outro. Essa subjetividade dificulta a aplicação consistente do princípio.
  • Simplificação excessiva: Em sistemas intrinsecamente complexos, soluções excessivamente simplificadas podem não abordar adequadamente a complexidade inerente do domínio.
  • Compromisso com desempenho: Soluções mais simples podem não oferecer o desempenho ideal. Em sistemas com requisitos rigorosos de performance, o KISS pode conduzir a soluções subótimas.

Críticas ao KISS

Estes quatro princípios (DRY, KISS, YAGNI e TDA) não existem isoladamente - eles se complementam e, quando aplicados com discernimento, criam uma abordagem holística para o desenvolvimento de software de qualidade.

 

  1. DRY + KISS: A eliminação de duplicação (DRY) frequentemente resulta em soluções mais simples (KISS).
  2. KISS + YAGNI: Manter a simplicidade (KISS) muitas vezes envolve evitar adicionar funcionalidades desnecessárias (YAGNI).

Integrando os Princípios em seu Desenvolvimento

〞

Comece com KISS: Ao iniciar qualquer componente, busque a solução mais simples e direta possível.

– DICA MAROTA

  • Prado, L. P. (2017). O princípio Tell, Don't Ask. [Blog]. Disponível em: https://luizpauloprado.com.br/2017/01/04/o-principio-tell-dont-ask/

  • Fonseca Chaves, G. (2020). Conceito Tell, Don't Ask. LinkedIn. Disponível em: https://pt.linkedin.com/pulse/conceito-tell-dont-ask-guilherme-fonseca-chaves

  • Silva, R. (2019). Princípio Tell, Don't Ask. [Blog]. Disponível em: https://ramonsilva.net/post/princípio-tell-don-t-ask

  • Castilho, R. (2014). Tell, don't ask. [Blog]. Disponível em: https://robsoncastilho.com.br/2014/05/11/conceitos-tell-dont-ask/

  • Souza, U. (2022). KISS, YAGNI, DRY – três princípios que todo desenvolvedor deveria conhecer! DEV Community. Disponível em: https://dev.to/urielsouza29/kiss-yagni-dry-tres-principios-que-todo-desenvolvedor-deveria-conhecer-47gg

  • Thiagomr. (2020). Desvendando o mundo mágico dos acrônimos: SOLID, KISS, YAGNI, DRY, DDD, TDD. DEV Community. Disponível em: https://dev.to/thiagomr/desvendando-o-mundo-magico-dos-acronimos-solid-kiss-yagni-dry-ddd-tdd-2onp

BIOGRAFIA

exemplode kiss

kiss

ACTIONS VS/E SERVICES

Classe com um único método público (ex: CreateUser), ideal para comandos específicos.

ACTIONS






// app/Actions/CreateUser.php
class CreateUser {
    public function execute(array $data) {
        return User::create($data);
    }
}




// No Controller
public function store(Request $request, CreateUser $createUser) {
    $user = $createUser->execute($request->validated());
    return response()->json($user);
}

Classe com múltiplos métodos relacionados (ex: UserService com create, update, delete).

SERVICES

namespace App\Services;

use App\Models\User;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Str;

class UserService
{
    // Método para criar um usuário com regras específicas
    public function createUser(array $data): User
    {
        return User::create([
            'name' => $data['name'],
            'email' => $data['email'],
            'password' => Hash::make($data['password']),
            'api_token' => Str::random(60),
        ]);
    }

    // Método para atualizar perfil
    public function updateProfile(User $user, array $data): bool
    {
        // Lógica de negócio: validar se o e-mail já existe, etc.
        return $user->update($data);
    }
}

〞

Uso: 

Actions são ótimas para tarefas complexas e orquestração.

Services são melhores para agrupar lógica de um domínio.

– Google IA

  • Testabilidade: Facilita o teste unitário de regras de negócio.
  • Limpeza: Controllers ficam finos (thin controllers).
  • Reutilização: Actions/Services podem ser chamados em Jobs, Controllers ou Artisan Commands.

benefícios

vamos aplicar na prática.

 

Aplicamos o princípio Keep It Simple, Stupid (KISS) combinando duas abordagens modernas de arquitetura Laravel — Actions (operações únicas e focadas) e Services (orquestração de regras de negócio) — dentro de um mesmo módulo. Essa estratégia híbrida permite granularidade onde necessário (Actions) e abstração onde conveniente (Services), resultando em código mais limpo, testável e adaptável às necessidades do domínio.

Primeiros passos

Criar o projeto laravel

migrations

configurar o MVC

Criar os Actions/Services

Erros

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

* Resultado do programa

Porque um código tão simplório?

o que  está acontecendo

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

main

stack (pilha)

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

main

stack (pilha)

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

main

funcao1

stack (pilha)

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

main

funcao1

stack (pilha)

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

main

funcao1

funcao2

stack (pilha)

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

main

funcao1

funcao2

$i

stack (pilha)

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

main

funcao1

funcao2

$i

stack (pilha)

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

main

funcao1

stack (pilha)

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

main

stack (pilha)

“Quote or citation”

<?php


function funcao1() {
    echo "Entrando na função 1" . PHP_EOL;
    funcao2();
    echo "Saindo da função 1" . PHP_EOL;
}

function funcao2() {
    echo "Entrando na função 2" . PHP_EOL;
    for($i = 0; $i < 5; $i++) {
        echo $i . PHP_EOL;
    }
    echo "Saindo da função 2" . PHP_EOL;
}

echo "Iniciando o programa" . PHP_EOL;
funcao1();
echo "Finalizando o programa" . PHP_EOL;

stack (pilha)

pra que aprender pilha?

nós entendemos o que é e como funciona a pilha de execução do PHP.

Fonte: Alura

Laravel

By Luiz Lins

Laravel

  • 16

More from Luiz Lins