[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-70653":3},{"id":4,"name":5,"fullName":6,"owner":5,"repo":5,"description":7,"homepage":8,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},70653,"BrasilAPI","BrasilAPI\u002FBrasilAPI","Vamos transformar o Brasil em uma API?","https:\u002F\u002Fbrasilapi.com.br",null,"JavaScript",10700,731,239,138,0,14,34,108,42,115.59,"MIT License",false,"main",true,[],"2026-06-12 04:00:56","# Arquivos de Instruções e Automação\n\nEste diretório contém arquivos de configuração e instruções para auxiliar no desenvolvimento e revisão de código do BrasilAPI.\n\n## 📚 Arquivos de Instrução\n\n### 🤖 Para GitHub Copilot e Desenvolvedores\n\n#### [`copilot-instructions.md`](copilot-instructions.md)\n**Propósito:** Instruções gerais para desenvolvimento assistido por IA\n\n**Uso:**\n- Referenciado automaticamente pelo GitHub Copilot durante desenvolvimento\n- Guia para desenvolvedores entenderem padrões do projeto\n- Define princípios fundamentais: compatibilidade, documentação, custos, qualidade\n\n**Conteúdo:**\n- Visão geral e missão do projeto\n- Arquitetura e padrões de código\n- Workflow para criar endpoints\n- Exemplos de código e testes\n- FAQ e comandos úteis\n\n#### [`copilot-review-instructions.md`](copilot-review-instructions.md)\n**Propósito:** Instruções específicas para revisão automática de PRs pelo GitHub Copilot\n\n**Uso:**\n- Treina o Copilot para revisar PRs seguindo nossos padrões\n- Define critérios objetivos de aprovação\u002Frejeição\n- Automatiza parte do processo de code review\n\n**Conteúdo:**\n- Regras não-negociáveis (breaking changes, documentação, testes, segurança)\n- Checklist obrigatória de revisão em 7 categorias\n- Templates de feedback específico para cada tipo de problema\n- Priorização: crítico vs importante vs sugestão\n- Casos especiais (doc-only, dependabot, refatoração)\n\n**Como funciona:**\n1. Desenvolvedor abre PR\n2. GitHub Copilot lê este arquivo\n3. Copilot analisa mudanças seguindo checklist\n4. Copilot comenta problemas encontrados com soluções específicas\n5. Copilot sugere aprovação ou solicita mudanças\n\n### 👥 Para Revisores Humanos\n\n#### [`CODE_REVIEW_GUIDELINES.md`](CODE_REVIEW_GUIDELINES.md)\n**Propósito:** Guia completo para revisores humanos\n\n**Uso:**\n- Consulta durante revisão manual de PRs\n- Treinamento de novos revisores\n- Referência para critérios de qualidade\n\n**Conteúdo:**\n- Checklist detalhada de revisão\n- Como verificar compatibilidade de API\n- Como validar documentação e testes\n- Como avaliar performance e custos\n- Como identificar vulnerabilidades\n- Como dar feedback efetivo\n- Red flags para rejeição imediata\n\n### 📝 Para Contribuidores\n\n#### [`PULL_REQUEST_TEMPLATE.md`](PULL_REQUEST_TEMPLATE.md)\n**Propósito:** Template automático para todos os PRs\n\n**Uso:**\n- Aplicado automaticamente ao abrir novo PR\n- Guia contribuidor no checklist antes de submeter\n- Garante que informações essenciais sejam fornecidas\n\n**Conteúdo:**\n- Checklists de compatibilidade, documentação, testes, código\n- Seção para descrever como testar\n- Instruções para revisores\n- Lembretes sobre impacto em produção\n\n## 🔄 Workflow de Contribuição\n\n```mermaid\ngraph TD\n    A[Desenvolvedor inicia mudança] --> B[Consulta copilot-instructions.md]\n    B --> C[Implementa seguindo padrões]\n    C --> D[Executa testes localmente]\n    D --> E[Abre PR usando template]\n    E --> F{Copilot Review Automático}\n    F -->|Problemas| G[Desenvolvedor corrige]\n    G --> F\n    F -->|OK| H{Revisão Humana}\n    H -->|Segue CODE_REVIEW_GUIDELINES| I[Aprovação]\n    H -->|Problemas| J[Feedback detalhado]\n    J --> G\n    I --> K[Merge]\n```\n\n## 🎯 Diferença entre os Arquivos\n\n| Arquivo | Audiência | Momento | Foco |\n|---------|-----------|---------|------|\n| `copilot-instructions.md` | Copilot + Devs | Durante desenvolvimento | Como escrever código |\n| `copilot-review-instructions.md` | Copilot | Durante review automático | Como revisar código |\n| `CODE_REVIEW_GUIDELINES.md` | Revisores humanos | Durante review manual | Como revisar profundamente |\n| `PULL_REQUEST_TEMPLATE.md` | Contribuidor | Ao abrir PR | O que incluir no PR |\n\n## 🤖 Quais Arquivos São Usados Automaticamente?\n\n### ✅ Arquivos Automáticos (Nenhuma Configuração Necessária)\n\n#### 1. `PULL_REQUEST_TEMPLATE.md`\n- ✅ **Uso 100% automático**\n- Aplicado automaticamente quando qualquer pessoa abre um PR\n- Não requer nenhuma configuração\n- Funciona imediatamente após o merge\n\n#### 2. `copilot-instructions.md`\n- ✅ **Uso automático pelo GitHub Copilot**\n- GitHub Copilot no VS Code\u002FIDE detecta e usa automaticamente\n- Aplicado durante desenvolvimento quando Copilot está ativo\n- Não requer configuração adicional no repositório\n- **Requisito**: Desenvolvedor precisa ter GitHub Copilot instalado no IDE\n\n### ⚙️ Arquivos que Requerem Ação Manual\n\n#### 3. `copilot-review-instructions.md`\n- ⚙️ **Uso via comando ou configuração**\n- **Opção A - Uso manual por mantenedores**: Comente no PR:\n  ```text\n  @copilot review\n  ```\n  Ou mencione o arquivo específico:\n  ```text\n  @copilot review following .github\u002Fcopilot-review-instructions.md\n  ```\n- **Opção B - Configuração automática** (se disponível no plano):\n  - GitHub Copilot Enterprise pode ter configuração para revisão automática\n  - Verificar em Settings → Copilot do repositório\n- **Uso alternativo**: Mantenedores podem usar como checklist manual\n\n#### 4. `CODE_REVIEW_GUIDELINES.md`\n- 📖 **Documento de referência - uso manual**\n- Revisores humanos consultam durante review\n- Não é usado automaticamente por ferramentas\n- Serve como guia e treinamento\n\n#### 5. `README.md` (este arquivo)\n- 📖 **Documentação - uso manual**\n- Explicação sobre todos os outros arquivos\n- Consultado quando necessário\n\n## 🚀 Resumo: Configuração Necessária\n\n| Arquivo | Automático? | Ação Necessária |\n|---------|-------------|-----------------|\n| `PULL_REQUEST_TEMPLATE.md` | ✅ Sim | Nenhuma - já funciona |\n| `copilot-instructions.md` | ✅ Sim (com Copilot no IDE) | Nenhuma - desenvolvedores precisam ter Copilot |\n| `copilot-review-instructions.md` | ⚙️ Parcial | Mantenedores devem usar `@copilot review` nos PRs |\n| `CODE_REVIEW_GUIDELINES.md` | ❌ Não | Revisores consultam manualmente |\n| `README.md` | ❌ Não | Documentação de referência |\n\n## 💡 Recomendações de Uso\n\n### Para Começar Agora (Zero Configuração)\n1. **Template de PR**: Já funciona! Próximo PR terá o template automaticamente\n2. **Instruções de desenvolvimento**: Desenvolvedores com Copilot já recebem as instruções automaticamente\n\n### Para Aproveitar Revisão Automática\n**Mantenedores devem**, em cada PR importante:\n```text\n# Comentar no PR para pedir revisão do Copilot\n@copilot review\n```\n\nIsso fará o Copilot analisar o PR seguindo as regras em `copilot-review-instructions.md`\n\n### Para Revisão Manual\nRevisores humanos devem consultar `CODE_REVIEW_GUIDELINES.md` como guia detalhado\n\n## 🔧 Configuração Avançada (Opcional)\n\nSe sua organização tem **GitHub Copilot Enterprise**, você pode:\n1. Ir em **Settings** → **Copilot** (no nível da organização ou repositório)\n2. Procurar por opções de \"Code Review\" ou \"PR Review\"\n3. Configurar revisão automática para todos os PRs\n4. O Copilot usará `copilot-review-instructions.md` automaticamente\n\n> **Nota**: Esta funcionalidade pode não estar disponível em todos os planos. Consulte a [documentação do GitHub Copilot](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fcopilot) para detalhes.\n\n## 📖 Mantendo as Instruções\n\n### Quando Atualizar\n\n**`copilot-instructions.md`:**\n- Novos padrões de código são adotados\n- Mudanças em arquitetura\n- Novos comandos ou ferramentas\n- Lições aprendidas de erros comuns\n\n**`copilot-review-instructions.md`:**\n- Novos tipos de problemas frequentes em PRs\n- Mudanças em critérios de aprovação\n- Novos checks automatizados necessários\n- Feedback que deve ser padronizado\n\n**`CODE_REVIEW_GUIDELINES.md`:**\n- Processos de revisão evoluem\n- Novos requisitos de qualidade\n- Melhores práticas são descobertas\n\n**`PULL_REQUEST_TEMPLATE.md`:**\n- Informações faltando frequentemente em PRs\n- Novos checks necessários antes do merge\n\n### Como Atualizar\n\n1. Abra PR com mudanças nas instruções\n2. Explique motivo da mudança\n3. Se possível, referencie PRs que motivaram a mudança\n4. Peça feedback de outros mantenedores\n5. Merge após aprovação\n\n## 🎓 Filosofia do Projeto\n\nTodos esses arquivos refletem os princípios fundamentais do BrasilAPI:\n\n1. **🔒 Compatibilidade é sagrada**: Nunca quebre aplicações existentes\n2. **📝 Documentação é obrigatória**: Código sem doc não existe\n3. **💰 Custos devem ser zero**: Projeto deve ser sustentável sem financiamento\n4. **🔐 Segurança em primeiro lugar**: Proteção de dados e validação sempre\n5. **✅ Qualidade é mandatória**: Testes, linting, padrões são obrigatórios\n6. **🌍 Open-source e comunidade**: Decisões transparentes e colaborativas\n\n## 📞 Dúvidas?\n\n- Para dúvidas sobre desenvolvimento: Ver `copilot-instructions.md`\n- Para dúvidas sobre revisão: Ver `CODE_REVIEW_GUIDELINES.md`\n- Para dúvidas sobre contribuição: Ver `\u002FCONTRIBUTING.md`\n- Para issues: [github.com\u002FBrasilAPI\u002FBrasilAPI\u002Fissues](https:\u002F\u002Fgithub.com\u002FBrasilAPI\u002FBrasilAPI\u002Fissues)\n\n---\n\n**Mantido pela comunidade BrasilAPI** 🇧🇷\n","BrasilAPI 是一个旨在将巴西的各种数据和服务通过 API 的形式提供的项目。该项目使用 JavaScript 开发，提供了一系列的 API 接口来访问如银行、税务、地址等信息，极大地方便了开发者在应用中集成这些功能。其技术特点包括详细的开发指南和自动化代码审查流程，确保了代码质量和一致性。此外，项目还利用 GitHub Copilot 来辅助代码编写与审查，提高了开发效率。BrasilAPI 适用于需要快速获取或验证巴西相关数据的应用场景，比如金融应用、电商网站或者是任何需要处理巴西用户信息的服务。",2,"2026-06-11 03:33:13","high_star"]