Exemplo de CRUD Completo

v1.1.0

Este guia demonstra o ciclo completo de um domínio gerado, desde o comando Artisan até uma API REST pronta para produção.

Este é o melhor ponto de partida para entender a estrutura gerada pela biblioteca.

---

O que será gerado

Um único comando cria:

• Model
• Migration
• Controller
• Form Requests
• DTO
• Service
• Repository
• Resource
• Rotas

---

Gerando o domínio

php artisan make:domain User

---

Estrutura criada

app/
├── Domain/
│   └── User/
│       ├── DTO/
│       ├── Repositories/
│       └── Service/
├── Http/
│   ├── Controllers/
│   ├── Requests/
│   └── Resources/
└── Models/

Cada camada possui uma única responsabilidade.

---

Fluxo interno

O fluxo permanece igual em todos os domínios gerados.

---

Criando um usuário

POST /api/users

{
  "nome": "João",
  "email": "joao@email.com",
  "password": "12345678"
}

Resposta:

{
  "type": "success",
  "status": 201,
  "data": {
    "public_id": "01JXYZABCDEF123456789"
  }
}

---

Listando usuários

GET /api/users

A paginação já vem pronta.

---

Atualizando

PUT /api/users/{public_id}

Utiliza automaticamente UpdateRequest e UpdateDTO.

---

Removendo

DELETE /api/users/{public_id}

Quando SoftDeletes estiver ativo, a remoção será lógica.

O CRUD gerado já segue integralmente DDD e Clean Architecture.