3.5 KiB

Raw Blame History

Scripts de Automação – Dev Sênior Front-end

Scripts para acelerar tarefas repetitivas no desenvolvimento.

Scripts Disponíveis

1. `check-reuse.js` - Análise de Reutilização

Antes de criar qualquer código, use este script para verificar o que já existe.

# Buscar componentes/hooks/services relacionados
node .agent/scripts/check-reuse.js user
node .agent/scripts/check-reuse.js card
node .agent/scripts/check-reuse.js auth

Saída: Lista todos os arquivos relacionados ao termo buscado.

2. `create-component.js` - Criar Componente

Cria estrutura completa de componente (Produção + Dev + index).

# Componente compartilhado
node .agent/scripts/create-component.js UserCard

# Componente de feature específica
node .agent/scripts/create-component.js EmployeeCard rh
node .agent/scripts/create-component.js BoletoList financeiro-v2

Gera:

[Nome].jsx - Versão produção
[Nome].dev.jsx - Versão Playground
index.js - Entry point

3. `create-hook.js` - Criar Hook

Cria hook customizado com template padrão.

# Hook global
node .agent/scripts/create-hook.js useAuth

# Hook de feature
node .agent/scripts/create-hook.js useEmployeeData rh
node .agent/scripts/create-hook.js useBoletos financeiro-v2

Template inclui: useState, useEffect, loading, error handling.

4. `create-service.js` - Criar Service

Cria service com CRUD completo.

# Service global
node .agent/scripts/create-service.js userService

# Service de feature
node .agent/scripts/create-service.js employeeService rh
node .agent/scripts/create-service.js boletoService financeiro-v2

Métodos inclusos: getList, getById, create, update, delete.

Workflow Recomendado

Criar Novo Componente

# 1. Verificar se já existe
node .agent/scripts/check-reuse.js UserCard

# 2. Se não existir, criar
node .agent/scripts/create-component.js UserCard rh

# 3. Implementar lógica
# Editar: src/features/rh/components/UserCard/UserCard.jsx

# 4. Adicionar ao Playground
# Cadastrar em: src/features/dev-tools/views/PlaygroundView.jsx

# 5. Testar no Playground antes de usar em views

Criar Nova Feature Completa

# 1. Verificar reutilização
node .agent/scripts/check-reuse.js employee

# 2. Criar service
node .agent/scripts/create-service.js employeeService rh

# 3. Criar hook
node .agent/scripts/create-hook.js useEmployee rh

# 4. Criar componentes necessários
node .agent/scripts/create-component.js EmployeeCard rh
node .agent/scripts/create-component.js EmployeeForm rh

# 5. Testar componentes no Playground

# 6. Criar view usando os componentes

Outros Scripts Úteis

Scripts Existentes

check-orchestrator.js - Validar orquestrador de agentes
docs-update.js - Atualizar documentação
git-commit-by-day.js - Commits organizados por dia

Regras de Ouro

SEMPRE rodar check-reuse.js antes de criar código novo
SEMPRE testar no Playground antes de usar em produção
SEMPRE validar build: npm run dev
Componentes < 150 linhas - extrair se maior

Atalhos Package.json (Adicionar)

{
  "scripts": {
    "new:component": "node .agent/scripts/create-component.js",
    "new:hook": "node .agent/scripts/create-hook.js",
    "new:service": "node .agent/scripts/create-service.js",
    "check:reuse": "node .agent/scripts/check-reuse.js"
  }
}

Uso após adicionar:

npm run check:reuse user
npm run new:component UserCard rh
npm run new:hook useUserData
npm run new:service userService

3.5 KiB Raw Blame History Unescape Escape