@the-bearded-bear/claude-craft 8.8.1 → 8.8.2

package/Dev/i18n/pt/Laravel/commands/check-compliance.md

@@ -1,145 +1,253 @@
 ---
-description: Check Laravel project compliance with coding standards
+description: Verificar Conformidade Completa do Laravel
+argument-hint: [arguments]
 ---
 
-# Laravel Compliance Check
+# Verificar Conformidade Completa do Laravel
 
-You are a Laravel expert auditor. Your mission is to verify that the project follows Laravel best practices and coding standards.
+## Argumentos
 
-## Audit Process
+$ARGUMENTS (opcional: caminho para o projeto a analisar)
 
-### 1. Project Structure Analysis
+## Modo de Planejamento
 
-Check if the project follows the recommended architecture:
+> O modo de planejamento é ativado automaticamente quando o escopo abrange múltiplos módulos ou requer investigação transversal.
 
-```
-app/
-├── Domain/           # Business logic (if using Clean Architecture)
-├── Application/      # Use cases, Actions, DTOs
-├── Infrastructure/   # External services, Repositories
-├── Http/
-│   ├── Controllers/  # Thin controllers
-│   ├── Requests/     # Form Requests for validation
-│   ├── Resources/    # API Resources
-│   └── Middleware/
-├── Models/           # Eloquent models
-├── Services/         # Business services
-├── Jobs/             # Queue jobs
-├── Events/           # Domain events
-├── Listeners/        # Event listeners
-├── Policies/         # Authorization policies
-└── Providers/        # Service providers
-```
+## MISSÃO
+
+Realizar uma auditoria de conformidade completa do projeto Laravel orquestrando as 4 verificações principais: Arquitetura, Qualidade de Código, Testes e Segurança. Produzir um relatório consolidado com uma pontuação geral de 100 pontos.
+
+### Etapa 1: Preparação da Auditoria
+
+Preparar o ambiente de auditoria:
+- [ ] Identificar o caminho do projeto a auditar
+- [ ] Verificar a presença de arquivos de configuração (composer.json com laravel/*, .env.example)
+- [ ] Listar os diretórios principais (app/, tests/, config/, routes/, etc.)
+- [ ] Identificar a estrutura do projeto e a versão do Laravel
+
+**Nota**: Se $ARGUMENTS for fornecido, utilizá-lo como caminho do projeto; caso contrário, usar o diretório atual.
+
+### Etapa 2: Auditoria de Arquitetura (25 pontos)
+
+Executar a verificação completa de arquitetura:
+
+**Comando**: Usar o slash command `/laravel:check-architecture` ou seguir manualmente os passos em `check-architecture.md`
+
+**Critérios Avaliados**:
+- Separação de camadas em Clean Architecture (6 pts)
+- Estrutura Domain/Application/Infrastructure (6 pts)
+- Padrão de Actions e controllers enxutos (4 pts)
+- Bindings de Service Providers (4 pts)
+- Padrão Repository e interfaces (3 pts)
+- Regras de dependência (2 pts)
+
+**Referência**: `check-architecture.md`
 
-### 2. Code Standards Verification
+### Etapa 3: Auditoria de Qualidade de Código (25 pontos)
 
-#### Naming Conventions
-- [ ] Controllers: Singular, PascalCase (`OrderController`)
-- [ ] Models: Singular, PascalCase (`Order`, `OrderItem`)
-- [ ] Tables: Plural, snake_case (`orders`, `order_items`)
-- [ ] Columns: snake_case (`created_at`, `customer_id`)
-- [ ] Methods: camelCase (`getUserOrders()`)
-- [ ] Variables: camelCase (`$orderTotal`)
+Executar a verificação de qualidade de código:
 
-#### Modern PHP Features (8.3+)
-- [ ] Constructor property promotion used
-- [ ] Readonly properties/classes where appropriate
-- [ ] Enums for status/type fields
-- [ ] Match expressions instead of switch
-- [ ] Named arguments for clarity
-- [ ] Type declarations on all methods
-- [ ] Return types specified
+**Comando**: Usar o slash command `/laravel:check-code-quality` ou seguir manualmente os passos em `check-code-quality.md`
 
-#### Laravel Conventions
-- [ ] Form Requests for validation (not validation in controllers)
-- [ ] API Resources for response transformation
-- [ ] Policies for authorization
-- [ ] Eloquent casts for type conversion
-- [ ] Scopes for reusable queries
-- [ ] Events for cross-cutting concerns
+**Critérios Avaliados**:
+- Conformidade com PSR-12 e Laravel Pint (5 pts)
+- Análise estática com PHPStan (5 pts)
+- Funcionalidades modernas do PHP (enums, readonly, typed properties) (4 pts)
+- Princípios KISS/DRY/YAGNI (4 pts)
+- Convenções de nomenclatura (padrões Laravel) (4 pts)
+- Tratamento de erros e logging (3 pts)
 
-### 3. Architecture Compliance
+**Referência**: `check-code-quality.md`
 
-#### Layer Dependencies
-- Domain layer has NO external dependencies
-- Application layer only depends on Domain
-- Infrastructure implements Domain interfaces
-- Controllers are thin (delegate to Actions/Services)
+### Etapa 4: Auditoria de Testes (25 pontos)
 
-#### Repository Pattern (if applicable)
-- [ ] Interfaces defined in Domain/Contracts
-- [ ] Implementations in Infrastructure
-- [ ] Bindings in Service Providers
+Executar a verificação de testes:
 
-### 4. Configuration Check
+**Comando**: Usar o slash command `/laravel:check-testing` ou seguir manualmente os passos em `check-testing.md`
 
-- [ ] No hardcoded values (use config files)
-- [ ] Environment variables via config(), not env()
-- [ ] Sensitive data in .env (not committed)
-- [ ] Config caching compatible
+**Critérios Avaliados**:
+- Cobertura de código (7 pts)
+- Testes unitários para lógica de Domínio (6 pts)
+- Testes de funcionalidade para endpoints HTTP (4 pts)
+- Uso do Pest PHP e qualidade dos testes (3 pts)
+- Factories e seeders de banco de dados (3 pts)
+- Isolamento de testes e mocking (2 pts)
 
-### 5. Generate Report
+**Referência**: `check-testing.md`
 
-After analysis, provide:
+### Etapa 5: Auditoria de Segurança (25 pontos)
 
-1. **Compliance Score**: X/100
-2. **Critical Issues**: Must-fix problems
-3. **Warnings**: Recommended improvements
-4. **Good Practices**: What's done well
-5. **Action Items**: Prioritized list of fixes
+Executar a verificação de segurança:
 
-## Modo Plano
+**Comando**: Usar o slash command `/laravel:check-security` ou seguir manualmente os passos em `check-security.md`
 
-> O modo plano é ativado automaticamente quando o escopo abrange vários módulos ou requer investigação transversal.
+**Critérios Avaliados**:
+- Proteções OWASP Top 10 (6 pts)
+- Gestão de segredos e credenciais (5 pts)
+- Validação com Form Request (4 pts)
+- Vulnerabilidades de dependências (composer audit) (4 pts)
+- Autenticação e Autorização (Policies) (3 pts)
+- CSRF e configuração de middlewares (2 pts)
+- Prevenção de injeção SQL (1 pt)
 
-## Commands to Run
+**Referência**: `check-security.md`
 
-```bash
-# Check code style
-./vendor/bin/pint --test
+### Etapa 6: Consolidação e Pontuação Global
 
-# Static analysis
-./vendor/bin/phpstan analyse
+Calcular a pontuação geral e produzir o relatório consolidado:
+- [ ] Somar as 4 pontuações (máximo de 100 pontos)
+- [ ] Identificar categorias críticas (<50%)
+- [ ] Listar todos os problemas transversais críticos
+- [ ] Priorizar ações por impacto/esforço
+- [ ] Produzir o relatório consolidado final
 
-# Run tests
-php artisan test
+**Escala de Avaliação**:
+- 90-100: Excelente — Projeto de referência
+- 75-89: Muito Bom — Algumas melhorias menores
+- 60-74: Aceitável — Requer melhorias
+- 40-59: Insuficiente — Refatoração significativa necessária
+- 0-39: Crítico — Revisão completa necessária
+
+### Etapa 7: Recomendações e Plano de Ação
+
+Produzir as recomendações finais:
+- [ ] Identificar as 3 ações prioritárias em todas as categorias
+- [ ] Estimar o esforço (Baixo/Médio/Alto) para cada ação
+- [ ] Estimar o impacto (Baixo/Médio/Alto) para cada ação
+- [ ] Propor a ordem de implementação
+- [ ] Sugerir ganhos rápidos (alta relação impacto/esforço)
+
+## FORMATO DE SAÍDA
 
-# Check for security vulnerabilities
-composer audit
 ```
+AUDITORIA DE CONFORMIDADE LARAVEL - RELATÓRIO COMPLETO
+=======================================================
+
+PONTUAÇÃO GERAL: XX/100
+
+NÍVEL DE CONFORMIDADE: [Excelente/Muito Bom/Aceitável/Insuficiente/Crítico]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+PONTUAÇÕES POR CATEGORIA:
+
+ARQUITETURA        : XX/25  [██████████░░░░░░░░░░] XX%
+QUALIDADE DE CÓDIGO: XX/25  [██████████░░░░░░░░░░] XX%
+TESTES             : XX/25  [██████████░░░░░░░░░░] XX%
+SEGURANÇA          : XX/25  [██████████░░░░░░░░░░] XX%
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+PONTOS FORTES GERAIS:
+1. [Ponto forte identificado em múltiplas categorias]
+2. [Outro ponto forte principal]
+3. [Terceiro ponto forte]
 
-## Output Format
+MELHORIAS GERAIS:
+1. [Melhoria transversal menor]
+2. [Outra melhoria recomendada]
+3. [Terceira melhoria]
 
-```markdown
-# Laravel Compliance Report
+PROBLEMAS CRÍTICOS:
+1. [Problema crítico nº 1 - categoria afetada]
+2. [Problema crítico nº 2 - categoria afetada]
+3. [Problema crítico nº 3 - categoria afetada]
 
-## Summary
-- **Score**: 85/100
-- **Critical Issues**: 2
-- **Warnings**: 5
-- **Files Analyzed**: 150
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-## Critical Issues
+DETALHES POR CATEGORIA:
 
-### 1. Missing Form Request Validation
-**File**: `app/Http/Controllers/OrderController.php:45`
-**Issue**: Validation done in controller instead of Form Request
-**Fix**: Create `StoreOrderRequest` and move validation rules
+┌─────────────────────────────────────────────┐
+│ ARQUITETURA (XX/25)                         │
+└─────────────────────────────────────────────┘
 
-### 2. [Issue description]
+Sub-pontuações:
+  • Camadas de Clean Architecture : XX/6
+  • Estrutura Domain/App/Infra    : XX/6
+  • Actions e controllers enxutos : XX/4
+  • Bindings de Service Provider  : XX/4
+  • Padrão Repository             : XX/3
+  • Regras de dependência         : XX/2
 
-## Warnings
+Pontos Fortes:
+- [Pontos fortes de arquitetura]
 
-### 1. [Warning description]
+Problemas:
+- [Problemas de arquitetura]
 
-## Recommendations
+[Seções semelhantes para Qualidade de Código, Testes e Segurança...]
 
-1. [Recommendation 1]
-2. [Recommendation 2]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-## Good Practices Observed
+TOP 3 AÇÕES PRIORITÁRIAS (TODAS AS CATEGORIAS):
 
-- Using Eloquent casts for type conversion
-- Proper use of API Resources
-- Events for decoupling
+1. CRÍTICO - [Ação nº 1]
+   Categoria : [Arquitetura/Qualidade/Testes/Segurança]
+   Impacto   : [Alto/Médio/Baixo]
+   Esforço   : [Alto/Médio/Baixo]
+   Prioridade: IMEDIATA
+
+   Descrição detalhada:
+   [Explicação do problema e solução proposta]
+
+   Arquivos afetados:
+   - [arquivo:linha]
+
+   Exemplo de correção:
+   [Código ou comando de correção]
+
+2. IMPORTANTE - [Ação nº 2]
+   [Mesmo formato...]
+
+3. RECOMENDADO - [Ação nº 3]
+   [Mesmo formato...]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+GANHOS RÁPIDOS (Alto Impacto / Baixo Esforço):
+
+- [Ganho rápido nº 1] - Categoria: [X] - Impacto: [X] - Esforço: [X]
+- [Ganho rápido nº 2] - Categoria: [X] - Impacto: [X] - Esforço: [X]
+- [Ganho rápido nº 3] - Categoria: [X] - Impacto: [X] - Esforço: [X]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+PLANO DE AÇÃO RECOMENDADO:
+
+SEMANA 1 (Imediato):
+- [ ] [Ação crítica nº 1]
+- [ ] [Ganho rápido prioritário]
+
+SEMANAS 2-4 (Curto prazo):
+- [ ] [Ação importante nº 2]
+- [ ] [Outros ganhos rápidos]
+
+MESES 2-3 (Médio prazo):
+- [ ] [Ação recomendada nº 3]
+- [ ] [Melhorias progressivas]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+RESUMO EXECUTIVO:
+
+[Parágrafo de síntese sobre o estado geral do projeto, principais pontos
+fortes, principais pontos fracos e a trajetória recomendada para melhorar
+a conformidade. Indicar se o projeto está pronto para produção,
+requer correções ou necessita de refatoração.]
+
+Recomendação Geral: [Pronto para produção / Correções menores /
+Refatoração significativa / Revisão completa necessária]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
+
+## NOTAS IMPORTANTES
+
+- Este comando orquestra as 4 auditorias especializadas
+- Usar Docker para todas as ferramentas de análise
+- Fornecer exemplos concretos com arquivo:linha para cada problema
+- Priorizar ações com base na matriz Impacto/Esforço
+- Problemas de segurança são SEMPRE a prioridade máxima
+- Propor correções automatizáveis (scripts, hooks de pré-commit)
+- O relatório deve ser acionável, não apenas descritivo
+- Adaptar as recomendações ao contexto de negócio do projeto

package/Dev/i18n/pt/React/commands/accessibility-check.md

@@ -4,28 +4,28 @@ description: Auditoria de Acessibilidade
 
 # Auditoria de Acessibilidade
 
-Realizar uma auditoria completa de acessibilidade (a11y) da aplicacao React.
+Realize uma auditoria completa de acessibilidade (a11y) da aplicação React.
 
 ## O Que Este Comando Faz
 
-1. **Analise de Acessibilidade**
-   - Escanear componentes em busca de problemas de a11y
-   - Verificar rotulos ARIA
-   - Verificar HTML semantico
-   - Testar navegacao por teclado
+1. **Análise de Acessibilidade**
+   - Verificar componentes em busca de problemas de a11y
+   - Checar rótulos ARIA
+   - Verificar HTML semântico
+   - Testar navegação por teclado
    - Verificar contrastes de cores
 
-2. **Ferramentas Usadas**
+2. **Ferramentas Utilizadas**
    - eslint-plugin-jsx-a11y
    - axe-core
    - Lighthouse
    - React DevTools
 
-3. **Relatorio Gerado**
-   - Lista de violacoes de a11y
-   - Nivel de severidade (critico, serio, moderado, menor)
-   - Recomendacoes acionaveis
-   - Exemplos de codigo para correcoes
+3. **Relatório Gerado**
+   - Lista de violações de a11y
+   - Nível de severidade (crítico, sério, moderado, menor)
+   - Recomendações acionáveis
+   - Exemplos de código para correções
 
 ## Como Usar
 
@@ -37,29 +37,29 @@ npm run a11y:check
 pnpm a11y:check
 ```
 
-## Modo Plano
+## Modo de Planejamento
 
-> O modo plano é ativado automaticamente quando o escopo abrange vários módulos ou requer investigação transversal.
+> O modo de planejamento é ativado automaticamente quando o escopo abrange múltiplos módulos ou requer investigação transversal.
 
 ## O Que Verificar
 
-### 1. HTML Semantico
+### 1. HTML Semântico
 
 ```typescript
-// ❌ Ruim - Nao-semantico
-<div onClick={handleClick}>Clique em mim</div>
+// ❌ Ruim - Não semântico
+<div onClick={handleClick}>Clique aqui</div>
 
-// ✅ Bom - Semantico
-<button onClick={handleClick}>Clique em mim</button>
+// ✅ Bom - Semântico
+<button onClick={handleClick}>Clique aqui</button>
 ```
 
-### 2. Rotulos ARIA
+### 2. Rótulos ARIA
 
 ```typescript
-// ❌ Ruim - Faltando rotulo
+// ❌ Ruim - Sem rótulo
 <input type="text" />
 
-// ✅ Bom - Com rotulo
+// ✅ Bom - Com label
 <label htmlFor="name">Nome</label>
 <input id="name" type="text" />
 
@@ -69,13 +69,13 @@ pnpm a11y:check
 </button>
 ```
 
-### 3. Navegacao por Teclado
+### 3. Navegação por Teclado
 
 ```typescript
-// ✅ Bom - Navegacao por Tab funciona
-<button onClick={handleClick}>Acao</button>
+// ✅ Bom - Navegação por Tab funciona
+<button onClick={handleClick}>Ação</button>
 
-// ✅ Bom - Manipulacao de teclado personalizada
+// ✅ Bom - Tratamento de teclado personalizado
 <div
   role="button"
   tabIndex={0}
@@ -86,38 +86,147 @@ pnpm a11y:check
     }
   }}
 >
-  Botao Personalizado
+  Botão Personalizado
 </div>
 ```
 
 ### 4. Contraste de Cores
 
-- Texto deve ter razao de contraste suficiente
-- WCAG AA: 4.5:1 para texto normal
+- O texto deve ter uma taxa de contraste suficiente
+- WCAG AA: 4,5:1 para texto normal
 - WCAG AAA: 7:1 para texto normal
-- Usar ferramentas para verificar contrastes
+- Use ferramentas para verificar os contrastes
 
 ### 5. Texto Alternativo para Imagens
 
 ```typescript
-// ❌ Ruim - Faltando alt
-<img src="foto.jpg" />
+// ❌ Ruim - Alt ausente
+<img src="photo.jpg" />
 
 // ✅ Bom - Alt descritivo
-<img src="foto.jpg" alt="Equipe da empresa na conferencia anual" />
+<img src="photo.jpg" alt="Equipe da empresa na conferência anual" />
 
 // ✅ Bom - Imagem decorativa
-<img src="decoracao.jpg" alt="" role="presentation" />
+<img src="decoration.jpg" alt="" role="presentation" />
 ```
 
-## Melhores Praticas
+## Configuração
+
+### ESLint (eslint-plugin-jsx-a11y)
+
+```json
+// .eslintrc.json
+{
+  "extends": [
+    "plugin:jsx-a11y/recommended"
+  ],
+  "rules": {
+    "jsx-a11y/alt-text": "error",
+    "jsx-a11y/anchor-is-valid": "error",
+    "jsx-a11y/aria-props": "error",
+    "jsx-a11y/aria-role": "error",
+    "jsx-a11y/click-events-have-key-events": "error",
+    "jsx-a11y/label-has-associated-control": "error",
+    "jsx-a11y/no-noninteractive-element-interactions": "error"
+  }
+}
+```
+
+### Testes Automatizados com axe-core
+
+```typescript
+// test/a11y.test.tsx
+import { render } from '@testing-library/react';
+import { axe, toHaveNoViolations } from 'jest-axe';
+import { MyComponent } from './MyComponent';
+
+expect.extend(toHaveNoViolations);
+
+describe('Acessibilidade', () => {
+  it('não deve ter violações de a11y', async () => {
+    const { container } = render(<MyComponent />);
+    const results = await axe(container);
+    expect(results).toHaveNoViolations();
+  });
+});
+```
+
+## Problemas Comuns e Correções
+
+### Problema 1: Rótulos de Formulário Ausentes
+
+```typescript
+// ❌ Problema
+<input type="email" placeholder="Email" />
+
+// ✅ Solução
+<label htmlFor="email">Email</label>
+<input id="email" type="email" placeholder="seu@email.com" />
+```
+
+### Problema 2: Elementos Não Interativos com Manipuladores de Clique
+
+```typescript
+// ❌ Problema
+<div onClick={handleClick}>Clique aqui</div>
+
+// ✅ Solução 1: Usar button
+<button onClick={handleClick}>Clique aqui</button>
+
+// ✅ Solução 2: Adicionar role adequado e suporte a teclado
+<div
+  role="button"
+  tabIndex={0}
+  onClick={handleClick}
+  onKeyDown={(e) => e.key === 'Enter' && handleClick()}
+>
+  Clique aqui
+</div>
+```
+
+### Problema 3: Texto Alternativo Ausente
+
+```typescript
+// ❌ Problema
+<img src="logo.png" />
+
+// ✅ Solução
+<img src="logo.png" alt="Logo da Empresa" />
+```
+
+### Problema 4: Informação Transmitida Apenas por Cor
+
+```typescript
+// ❌ Problema
+<span style={{ color: 'red' }}>Erro</span>
+
+// ✅ Solução
+<span style={{ color: 'red' }} aria-label="Erro">
+  <ErrorIcon aria-hidden="true" /> Erro
+</span>
+```
+
+## Testes com Lighthouse
+
+```bash
+# Instalar Lighthouse
+npm install -g lighthouse
+
+# Executar auditoria
+lighthouse http://localhost:3000 --view
+
+# Salvar relatório
+lighthouse http://localhost:3000 --output html --output-path ./report.html
+```
+
+## Boas Práticas
 
-1. **Usar HTML semantico** (button, nav, main, header, footer)
-2. **Adicionar rotulos ARIA** quando necessario
-3. **Testar navegacao por teclado** (Tab, Enter, Escape)
-4. **Verificar contrastes de cores** (minimo WCAG AA)
-5. **Fornecer texto alternativo** para imagens
-6. **Suportar leitores de tela**
+1. **Use HTML semântico** (button, nav, main, header, footer)
+2. **Adicione rótulos ARIA** onde necessário
+3. **Teste a navegação por teclado** (Tab, Enter, Escape)
+4. **Verifique contrastes de cores** (mínimo WCAG AA)
+5. **Forneça texto alternativo** para imagens
+6. **Suporte a leitores de tela**
 7. **Testes automatizados** com axe-core
 8. **Testes manuais** com leitores de tela (NVDA, JAWS, VoiceOver)
 
@@ -125,5 +234,5 @@ pnpm a11y:check
 
 - [Diretrizes WCAG](https://www.w3.org/WAI/WCAG21/quickref/)
 - [MDN Acessibilidade](https://developer.mozilla.org/pt-BR/docs/Web/Accessibility)
-- [React Acessibilidade](https://pt-br.react.dev/learn/accessibility)
+- [React Acessibilidade](https://react.dev/learn/accessibility)
 - [axe DevTools](https://www.deque.com/axe/devtools/)