Exercício Abrangente da Fase 2—CRUD Backend do ShopMetrics

O Exercício Abrangente da Fase 2 foca em "Entregar Funcionalidades Centrais"—reunindo todo o conhecimento das Aulas 8-13 para construir um sistema backend totalmente funcional.

1. O Que Você Vai Aprender

Conjunto de dados de migração completo: 10+ tabelas, incluindo chaves estrangeiras e índices
Camada de Modelo Eloquent: Associações + Scopes + Accessors/Mutators
CRUD do Controller Resource: Listar/Criar/Editar/Excluir com validação
População de dados: 100+ tenants/usuários/pedidos simulados
Detecção e Otimização de N+1: Debugbar + Análise de Queries

2. História de Aceitação da Fase 2 de Bob

(1) Problema: Funcionalidades de backend estão espalhadas em vários cursos, impossibilitando a formação de um produto completo

Alice completou todas as aulas da Fase 2, mas migração está na Aula 8, o modelo está na Aula 9 e validação está na Aula 12—cada aula funciona bem por si só, mas quando combinadas, surgem problemas: restrições de chave estrangeira não correspondem, associações de modelo estão faltando e regras de validação não se alinham com os tipos de coluna do banco de dados.

(2) Soluções dos Exercícios Abrangentes

Esta aula orienta você passo a passo desde o design do banco de dados até as páginas CRUD, entrelaçando todo o conhecimento em um sistema completo—com cada passo construindo sobre a saída do anterior para garantir uma progressão contínua.

BASH

# Entregável da Fase 2: Um sistema CRUD administrativo completo
php artisan migrate:fresh --seed
# → 10+ tabelas, 100+ registros, todo o CRUD funcionando

(3) Resultado

Após completar o exercício abrangente, Alice agora possui um sistema CRUD backend do ShopMetrics totalmente funcional—desde criar tabelas até inserir, atualizar, excluir e consultar dados, tudo de uma vez.

3. Design do Banco de Dados

(1) Diagrama ER Multitenant do ShopMetrics

erDiagram
    Tenant ||--o{ User : "possui muitos"
    Tenant ||--o| Subscription : "possui um"
    Tenant ||--o{ Shop : "possui muitos"
    Plan ||--o{ Subscription : "possui muitos"
    Shop ||--o{ Product : "possui muitos"
    Shop ||--o{ Order : "possui muitos"
    User ||--o{ Order : "realiza"
    Product }o--o{ Category : "pertence a muitos"
    Order ||--o{ OrderItem : "contém"
    Product ||--o{ OrderItem : "incluído em"

(2) Checklist de Migração

#	Arquivo de Migração	Nome da Tabela	Campos Principais
1	create_plans_table	plans	name, slug, price, shop_limit, features(json)
2	create_tenants_table	tenants	name, slug, domain, plan_id (FK), status
3	create_subscriptions_table	subscriptions	tenant_id (FK), plan_id (FK), stripe_id, status
4	create_users_table	users	tenant_id (FK), name, email, password, role
5	create_shops_table	shops	tenant_id (FK), name, slug, status, revenue
6	create_categories_table	categories	name, slug
7	create_products_table	products	shop_id (FK), name, sku, price, stock, is_active
8	create_category_product_table	category_product	category_id (FK), product_id (FK)
9	create_orders_table	orders	tenant_id (FK), shop_id (FK), user_id (FK), total, status
10	create_order_items_table	order_items	order_id (FK), product_id (FK), qty, price

(1) ▶ Exemplo: Arquivo de Migração Principal

PHP

// database/migrations/2024_01_01_000001_create_plans_table.php
Schema::create('plans', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('slug')->unique();
    $table->decimal('price', 8, 2);
    $table->integer('shop_limit')->default(5);
    $table->json('features')->nullable();
    $table->boolean('is_active')->default(true);
    $table->timestamps();
});

// database/migrations/2024_01_01_000005_create_shops_table.php
Schema::create('shops', function (Blueprint $table) {
    $table->id();
    $table->foreignId('tenant_id')->constrained()->cascadeOnDelete();
    $table->string('name');
    $table->string('slug');
    $table->text('description')->nullable();
    $table->enum('status', ['active', 'suspended', 'closed'])->default('active');
    $table->decimal('revenue', 12, 2)->default(0);
    $table->timestamps();
    $table->softDeletes();
    $table->unique(['tenant_id', 'slug']);
    $table->index(['tenant_id', 'status']);
});

Saída:

TEXT

// Execução bem-sucedida

4. Camada de Modelo Eloquent

(1) Lista de Modelos e Associações

Modelo	Associação	Scope	Accessor/Mutator
Tenant	shops(), users(), subscription()	active()	domain_url
Shop	products(), orders(), tenant()	active()	revenue_formatted
Product	categories(), shop()	active(), inStock()	price_formatted
Order	items(), shop(), user()	completed(), thisMonth()	status_badge
OrderItem	product(), order()	—	subtotal

(1) ▶ Exemplo: Modelo Principal do ShopMetrics

PHP

// app/Models/Tenant.php
class Tenant extends Model
{
    protected $fillable = ['name', 'slug', 'domain', 'plan_id', 'status'];
    protected $casts = ['status' => 'string'];

    public function shops(): HasMany
    {
        return $this->hasMany(Shop::class);
    }

    public function users(): HasMany
    {
        return $this->hasMany(User::class);
    }

    public function subscription(): HasOne
    {
        return $this->hasOne(Subscription::class)->where('status', 'active');
    }

    public function scopeActive(Builder $query): Builder
    {
        return $query->where('status', 'active');
    }

    public function getDomainUrlAttribute(): string
    {
        return 'https://' . $this->domain;
    }
}

// app/Models/Shop.php
class Shop extends Model
{
    use SoftDeletes;

    protected $fillable = ['tenant_id', 'name', 'slug', 'description', 'status', 'revenue'];
    protected $casts = ['revenue' => 'decimal:2', 'deleted_at' => 'datetime'];

    public function tenant(): BelongsTo
    {
        return $this->belongsTo(Tenant::class);
    }

    public function products(): HasMany
    {
        return $this->hasMany(Product::class);
    }

    public function orders(): HasMany
    {
        return $this->hasMany(Order::class);
    }

    public function scopeActive(Builder $query): Builder
    {
        return $query->where('status', 'active');
    }

    public function getRevenueFormattedAttribute(): string
    {
        return '$' . number_format($this->revenue, 2);
    }
}

// app/Models/Product.php
class Product extends Model
{
    protected $fillable = ['shop_id', 'name', 'sku', 'price', 'stock', 'is_active'];
    protected $casts = ['price' => 'decimal:2', 'is_active' => 'boolean'];

    public function shop(): BelongsTo
    {
        return $this->belongsTo(Shop::class);
    }

    public function categories(): BelongsToMany
    {
        return $this->belongsToMany(Category::class)->withTimestamps();
    }

    public function scopeActive(Builder $query): Builder
    {
        return $query->where('is_active', true);
    }

    public function scopeInStock(Builder $query): Builder
    {
        return $query->where('stock', '>', 0);
    }

    public function getPriceFormattedAttribute(): string
    {
        return '$' . number_format($this->price, 2);
    }
}

Saída:

TEXT

// Execução bem-sucedida

5. CRUD do Controller Resource

(1) Lista de Controllers e Classes de Validação

Controller	Método	Form Request
ShopController	index/create/store/show/edit/update/destroy	StoreShopRequest/UpdateShopRequest
ProductController	index/create/store/show/edit/update/destroy	StoreProductRequest/UpdateProductRequest
OrderController	index/show/update	UpdateOrderRequest

(1) ▶ Exemplo: CRUD Completo do ShopController

PHP

// app/Http/Controllers/ShopController.php
class ShopController extends Controller
{
    public function __construct()
    {
        $this->middleware('auth');
        $this->middleware('tenant.resolve');
    }

    public function index(Request $request): View
    {
        $shops = Shop::where('tenant_id', tenant()->id)
            ->withCount(['products', 'orders as recent_orders' => fn ($q) => $q->where('created_at', '>=', now()->subDays(30))])
            ->when($request->search, fn ($q, $s) => $q->where('name', 'like', "%{$s}%"))
            ->when($request->status, fn ($q, $s) => $q->where('status', $s))
            ->orderBy($request->sort ?? 'created_at', $request->direction ?? 'desc')
            ->paginate(15);

        return view('shops.index', compact('shops'));
    }

    public function create(): View
    {
        return view('shops.create');
    }

    public function store(StoreShopRequest $request): RedirectResponse
    {
        $shop = Shop::create(array_merge(
            $request->validated(),
            ['tenant_id' => tenant()->id],
        ));

        return redirect()->route('shops.show', $shop)
            ->with('success', 'Shop created successfully.');
    }

    public function show(Shop $shop): View
    {
        $shop->load(['products' => fn ($q) => $q->active()->latest()->take(10),
                      'orders' => fn ($q) => $q->with('user')->latest()->take(10)]);

        $stats = [
            'total_revenue' => $shop->orders()->completed()->sum('total'),
            'total_orders' => $shop->orders()->count(),
            'total_products' => $shop->products()->active()->count(),
        ];

        return view('shops.show', compact('shop', 'stats'));
    }

    public function edit(Shop $shop): View
    {
        return view('shops.edit', compact('shop'));
    }

    public function update(UpdateShopRequest $request, Shop $shop): RedirectResponse
    {
        $shop->update($request->validated());
        return redirect()->route('shops.show', $shop)
            ->with('success', 'Shop updated.');
    }

    public function destroy(Shop $shop): RedirectResponse
    {
        $shop->delete();
        return redirect()->route('shops.index')
            ->with('success', 'Shop deleted.');
    }
}

Saída:

TEXT

// Execução bem-sucedida

6. Implementando a Classe de Verificação

(1) ▶ Exemplo: Classe Form Request do ShopMetrics

PHP

// app/Http/Requests/StoreShopRequest.php
class StoreShopRequest extends FormRequest
{
    public function authorize(): bool
    {
        return auth()->user()->role === 'tenant_owner';
    }

    public function rules(): array
    {
        return [
            'name' => 'required|string|max:255',
            'slug' => 'required|alpha_dash|unique:shops,slug,NULL,id,tenant_id,' . tenant()->id,
            'description' => 'nullable|string|max:5000',
            'status' => 'sometimes|in:active,suspended',
        ];
    }

    protected function prepareForValidation(): void
    {
        $this->merge(['slug' => Str::slug($this->slug ?? $this->name)]);
    }
}

// app/Http/Requests/StoreProductRequest.php
class StoreProductRequest extends FormRequest
{
    public function rules(): array
    {
        return [
            'name' => 'required|string|max:255',
            'sku' => 'required|string|unique:products,sku',
            'price' => 'required|numeric|min:0.01|max:999999.99',
            'stock' => 'required|integer|min:0',
            'description' => 'nullable|string|max:5000',
            'is_active' => 'boolean',
            'categories' => 'sometimes|array',
            'categories.*' => 'exists:categories,id',
            'image' => 'sometimes|image|max:2048',
        ];
    }
}

Saída:

TEXT

// Execução bem-sucedida

7. População de Dados

(1) ▶ Exemplo: Seeder Completo do ShopMetrics

PHP

// database/seeders/ShopMetricsSeeder.php
class ShopMetricsSeeder extends Seeder
{
    public function run(): void
    {
        $starter = Plan::create(['name' => 'Starter', 'slug' => 'starter', 'price' => 29, 'shop_limit' => 5, 'features' => ['basic_analytics']]);
        $pro = Plan::create(['name' => 'Pro', 'slug' => 'pro', 'price' => 79, 'shop_limit' => 25, 'features' => ['advanced_analytics', 'api']]);
        $enterprise = Plan::create(['name' => 'Enterprise', 'slug' => 'enterprise', 'price' => 199, 'shop_limit' => null, 'features' => ['all']]);

        User::factory()->create(['email' => 'admin@shopmetrics.io', 'role' => 'super_admin']);

        Category::factory()->count(10)->create();

        Tenant::factory()->count(20)->create()->each(function ($tenant) use ($starter, $pro, $enterprise) {
            $plan = fake()->randomElement([$starter, $pro, $enterprise]);
            Subscription::create(['tenant_id' => $tenant->id, 'plan_id' => $plan->id, 'status' => 'active']);
            $owner = User::factory()->for($tenant)->create(['role' => 'tenant_owner']);
            $analysts = User::factory()->count(3)->for($tenant)->create(['role' => 'analyst']);

            $shopCount = min(fake()->numberBetween(2, 5), $plan->shop_limit ?? 99);
            Shop::factory()->count($shopCount)->for($tenant)->create()->each(function ($shop) use ($tenant, $owner, $analysts) {
                $products = Product::factory()->count(fake()->numberBetween(10, 30))->for($shop)->create();
                $products->each(fn ($p) => $p->categories()->attach(Category::inRandomOrder()->take(rand(1, 3))->pluck('id')));

                Order::factory()->count(fake()->numberBetween(20, 60))->for($tenant)->for($shop)->for(fake()->randomElement(array_merge([$owner], $analysts->all())))->create()->each(function ($order) use ($products) {
                    $items = $products->random(rand(1, 5));
                    foreach ($items as $product) {
                        $qty = rand(1, 3);
                        $order->items()->create(['product_id' => $product->id, 'quantity' => $qty, 'price' => $product->price]);
                    }
                    $order->update(['total' => $order->items->sum(fn ($i) => $i->price * $i->quantity)]);
                });
            });
        });
    }
}

Saída:

TEXT

// Execução bem-sucedida

8. Detecção e Otimização de N+1

(1) Instalar o Debugbar

BASH

composer require barryvdh/laravel-debugbar --dev

(2) Cenários Comuns de N+1 e Soluções

Cenário	Problema N+1	Solução
Lista de Lojas	`$shop->products->count()`	`withCount('products')`
Lista de Pedidos	`$order->user->name`	`with('user')`
Detalhes do Produto	`$product->categories`	`with('categories')`
Dashboard	Acesso Simultâneo a Múltiplas Contas Vinculadas	`with(['user', 'shop.items'])`

(1) ▶ Exemplo: Análise de Queries com Debugbar

PHP

// Em desenvolvimento, o Debugbar mostra a contagem de queries em cada página
// Otimize o N+1 passo a passo:

// Passo 1: Identificar — Debugbar mostra "41 queries" em shops.index
// Passo 2: Adicionar eager loading
$shops = Shop::with(['products', 'tenant', 'orders'])->get(); // 4 queries
// Passo 3: Usar withCount em vez de carregar relações completas
$shops = Shop::withCount('products', 'orders')->with('tenant')->get(); // 3 queries
// Passo 4: Verificar — Debugbar mostra "3 queries"

Saída:

TEXT

// Execução bem-sucedida

9. Exemplo Abrangente: Sistema CRUD Backend do ShopMetrics

PHP

// ============================================
// Abrangente: Configuração CRUD Admin do ShopMetrics
// Abrange: migrations, models, controllers, requests, seeders
// ============================================

// Comandos de configuração (execute em ordem)
// 1. php artisan migrate:fresh --seed
// 2. php artisan storage:link
// 3. php artisan serve

// routes/web.php — Rotas administrativas completas
Route::middleware('auth')->prefix('dashboard')->name('dashboard.')->group(function () {
    Route::get('/', [DashboardController::class, 'index'])->name('index');

    // Shops CRUD
    Route::resource('shops', ShopController::class);
    Route::post('/shops/{shop}/logo', [ShopLogoController::class, 'update'])->name('shops.logo');

    // Products CRUD (aninhado sob shop)
    Route::resource('shops.products', ProductController::class)->shallow();

    // Orders (somente leitura + atualização de status)
    Route::resource('orders', OrderController::class)->only(['index', 'show', 'update']);
    Route::post('/orders/{order}/export', ExportOrdersController::class)->name('orders.export');

    // Categories (CRUD simples)
    Route::resource('categories', CategoryController::class)->except('show');

    // Analytics
    Route::get('/analytics', [AnalyticsController::class, 'index'])->name('analytics');
});

// DashboardController com queries otimizadas
class DashboardController extends Controller
{
    public function index(): View
    {
        $tenant = tenant();
        $stats = Cache::remember("dashboard.{$tenant->id}", 300, function () use ($tenant) {
            return [
                'total_revenue' => $tenant->shops()->sum('revenue'),
                'active_shops' => $tenant->shops()->active()->count(),
                'monthly_orders' => $tenant->orders()->whereBetween('created_at', [now()->startOfMonth(), now()->endOfMonth()])->count(),
                'total_products' => Product::whereHas('shop', fn ($q) => $q->where('tenant_id', $tenant->id))->active()->count(),
            ];
        });

        $recentOrders = Order::where('tenant_id', $tenant->id)
            ->with(['shop', 'user'])
            ->latest()
            ->take(5)
            ->get();

        return view('dashboard.index', compact('stats', 'recentOrders'));
    }
}

❓ Perguntas Frequentes

P Quanto tempo leva o exercício da Fase 2?

R Cerca de 4-6 horas. Design do banco de dados: 1 hora; modelos e relacionamentos: 1,5 horas; controllers CRUD: 1,5 horas; população de dados e depuração: 1 hora. Não pule nenhuma etapa; verifique cada passo antes de prosseguir para o próximo.

P Como posso garantir que a ordem de migração está correta?

R Tabelas com dependências de chave estrangeira devem ser criadas primeiro. Os timestamps nos nomes dos arquivos de migração determinam a ordem de execução—tabelas que são referenciadas são criadas primeiro, seguidas pelas tabelas que as referenciam. Alternativamente, use php artisan migrate:status para verificar a ordem.

P Há muito código duplicado nas páginas CRUD. Como posso reduzi-lo?

R Use componentes Blade para encapsular campos de formulário (<x-input>, <x-select>), e use artisan make:controller --resource para gerar código boilerplate. Duplicação é normal; certifique-se de que a funcionalidade funciona corretamente antes de considerar abstração.

P O Debugbar deve ser desabilitado em ambiente de produção?

R Deve ser desabilitado. O Debugbar expõe informações sensíveis (queries SQL, uso de memória, valores de configuração). Ele é habilitado apenas quando APP_DEBUG=true; em ambiente de produção, onde APP_DEBUG=false, ele é automaticamente desabilitado.

P Qual é a diferença entre dados de Seeder e dados de teste?

R Dados de Seeder geram os dados básicos para o ambiente de desenvolvimento (contas de administrador, planos), que são armazenados persistentemente no banco de dados; dados de teste são gerados usando Factory no PHPUnit e são automaticamente revertidos após cada teste.

P Como posso verificar se o N+1 foi totalmente otimizado?

R O número de queries exibido no Debugbar deve ser igual a 1 (a query principal) mais o número de junções pré-carregadas. Por exemplo, with(['user', 'shop']) deve ter 3 queries. Se houver mais do que o esperado, verifique se há carregamentos preguiçosos (lazy loads) perdidos.

📖 Resumo

Ao projetar um banco de dados, comece desenhando um diagrama ER, depois escreva as migrações para garantir que as dependências de chave estrangeira estejam na ordem correta.
Modelos Eloquent definem três níveis de funcionalidade: associações, scopes e accessors/mutators
Form Request encapsula validação e autorização, mantendo o controller enxuto
Os dados são populados na seguinte ordem: Plan → Tenant → User → Shop → Product → Order
Otimize queries N+1 usando with() e withCount(); use o Debugbar para monitorar o número de queries
O sistema CRUD começa com um controller resource e gradualmente adiciona filtragem, busca e paginação

📝 Exercícios

Tarefa Básica (⭐): Complete a migração das 10 tabelas no painel administrativo do ShopMetrics e defina os modelos. Execute migrate:fresh --seed para verificar se todos os dados são gerados corretamente e se não há erros de chave estrangeira.
Exercício Avançado (⭐⭐): Implemente a funcionalidade CRUD completa para Shop e Product (incluindo validação de form request, filtragem de busca e paginação), garantindo que o Debugbar exiba no máximo 5 queries por página.
Desafio (⭐⭐⭐): Implemente agregação de dados com otimização de cache para o Dashboard—armazene em cache as queries estatísticas por 5 minutos e limpe automaticamente o cache via eventos de modelo quando um novo pedido for recebido, para garantir um equilíbrio entre a atualidade dos dados e o desempenho geral do sistema.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós

404 Not Found

Exercício Abrangente da Fase 2—CRUD Backend do ShopMetrics

1. O Que Você Vai Aprender

2. História de Aceitação da Fase 2 de Bob

(1) Problema: Funcionalidades de backend estão espalhadas em vários cursos, impossibilitando a formação de um produto completo

(2) Soluções dos Exercícios Abrangentes

(3) Resultado

3. Design do Banco de Dados

(1) Diagrama ER Multitenant do ShopMetrics

(2) Checklist de Migração

(1) ▶ Exemplo: Arquivo de Migração Principal

4. Camada de Modelo Eloquent

(1) Lista de Modelos e Associações

(1) ▶ Exemplo: Modelo Principal do ShopMetrics

5. CRUD do Controller Resource

(1) Lista de Controllers e Classes de Validação

(1) ▶ Exemplo: CRUD Completo do ShopController

6. Implementando a Classe de Verificação

(1) ▶ Exemplo: Classe Form Request do ShopMetrics

7. População de Dados

(1) ▶ Exemplo: Seeder Completo do ShopMetrics

8. Detecção e Otimização de N+1

(1) Instalar o Debugbar

(2) Cenários Comuns de N+1 e Soluções

(1) ▶ Exemplo: Análise de Queries com Debugbar

9. Exemplo Abrangente: Sistema CRUD Backend do ShopMetrics

❓ Perguntas Frequentes

📖 Resumo

📝 Exercícios