Skill: Arquitetura do Projeto (Laravel + Vue + Inertia)
Esta skill define as regras obrigatórias para geração de código neste projeto. Sempre que for solicitado criar ou refatorar código, aplique estas diretrizes.
1. Fonte da Verdade (Banco de Dados)
- •Regra de Ouro: Antes de escrever qualquer código que envolva Models ou Migrations, você DEVE ler o arquivo
database/schema/mysql-schema.sqlusando a ferramenta de leitura de arquivos. - •Nunca alucine nomes de colunas. Use apenas o que está no schema.
- •Se uma coluna não existe, sugira criar uma migration para ela.
2. Backend (Laravel 11/12)
- •Controllers: Devem ser magros. Use
FormRequestspara validação. - •Retorno: Use sempre
Inertia::render('NomeComponente', [props]). - •API: Não crie APIs REST (json) a menos que explicitamente pedido. O foco é Monólito Modular com Inertia.
- •Automação: Lembre-se que o comando
php artisan migratejá atualiza o dump do banco automaticamente (via AppServiceProvider). Não peça para rodarschema:dumpmanualmente.
3. Frontend (Vue 3 + Composition API)
- •Sintaxe: Use estritamente
<script setup lang="ts">(ou js, conforme o projeto). - •Proibido: Não use Options API (
export default { ... }). - •Formulários: Utilize o helper
useFormdo Inertia (@inertiajs/vue3) para gerenciar estado, envio e erros de validação. - •UI/CSS: Use classes utilitárias do Tailwind CSS. Evite CSS customizado em tags
<style>.
4. Fluxo de Trabalho
- •Ao criar uma nova funcionalidade, siga a ordem:
- •Verifique o Schema (
mysql-schema.sql). - •Crie/Ajuste a Migration (se necessário).
- •Crie o Model e Controller.
- •Crie a View (Vue/Inertia).
- •Registre a Rota (
web.php).
- •Verifique o Schema (