3.4 KiB
Instruções para o GitHub Copilot Este arquivo fornece instruções específicas para o GitHub Copilot ao trabalhar neste projeto. O objetivo é garantir a geração de código de alta qualidade, evitar erros comuns e otimizar o processo de resolução de problemas.
Contexto do Projeto
Objetivo: criar um sistema de gestão de advocacia completo.
Instruções Específicas Banco de Dados:
-
NÃO RESETAR O BANCO DE DADOS EM HIPÓTESE ALGUMA.
-
Ao criar ou modificar scripts que interagem com o banco de dados, priorize a segurança e a integridade dos dados.
-
Sempre use prepared statements ou consultas parametrizadas para evitar injeção de SQL.
-
Antes de executar qualquer operação de escrita (INSERT, UPDATE, DELETE), verifique se os dados são válidos e se o usuário tem permissão para realizar a ação.
-
Ao criar novas tabelas ou colunas, defina tipos de dados apropriados e restrições de integridade (NOT NULL, UNIQUE, etc.).
-
Sempre faça backup do banco de dados antes de realizar alterações estruturais significativas. Prevenção de Erros:
-
Priorize a prevenção de erros durante a geração de código.
-
Implemente tratamento de erros robusto em todas as funções e rotas.
-
Use validação de dados para garantir que os dados de entrada estejam no formato correto.
-
Sempre verifique se as variáveis estão definidas antes de usá-las.
-
Evite o uso de "magic numbers" ou strings literais diretamente no código. Em vez disso, use constantes ou variáveis com nomes significativos.
-
Use linting e formatação de código para garantir a consistência e legibilidade do código. Resolução de Problemas:
-
Ao resolver problemas, foque unicamente na solução do problema em questão.
-
Evite criar novos problemas ou efeitos colaterais indesejados.
-
Antes de implementar uma solução, analise cuidadosamente o problema e suas possíveis causas.
-
Use debuggers e logs para identificar a causa raiz do problema.
-
Teste a solução em um ambiente de desenvolvimento antes de aplicá-la em produção.
-
Documente a solução e as lições aprendidas para evitar que o problema ocorra novamente. Segurança:
-
Sempre sanitize os dados de entrada para evitar ataques de injeção (SQL, XSS, etc.).
-
Use criptografia para proteger dados confidenciais (senhas, chaves de API, etc.).
-
Implemente autenticação e autorização adequadas para proteger as rotas e recursos da API.
-
Mantenha as dependências atualizadas para corrigir vulnerabilidades de segurança.
-
Siga as práticas recomendadas de segurança para Node.js e PostgreSQL. Exemplos Exemplo de Comentário: javascript Copiar
// Função para criar um novo usuário no banco de dados. // Certifique-se de validar os dados antes de inserir no banco. async function createUser(userData) { // ... } Exemplo de Tratamento de Erro: javascript Copiar
try { const result = await db.query('SELECT * FROM users WHERE id = $1', [userId]); return result.rows[0]; } catch (error) { console.error('Erro ao buscar usuário:', error); throw new Error('Falha ao buscar usuário.'); } Notas Adicionais Este arquivo será atualizado conforme necessário para refletir as necessidades e os desafios do projeto. Por favor, consulte este arquivo regularmente para garantir que você esteja seguindo as diretrizes mais recentes. Se você tiver alguma dúvida ou sugestão, entre em contato com [seu nome/equipe].