File manager

File manager - Edit - /var/www/html/homologBancodetalentos/.cursor/btrules.mdc

Back
--- alwaysApply: true --- # Arquitetura — Banco de Talentos ## Contexto ### Legado - SIATI - Banco de Talentos antigo ### Atual - Conta Angra → autenticação e identidade (SSO) - Banco de Talentos → domínio de negócio (Laravel 9) --- ## Regras Obrigatórias ### 1. Legado (uso controlado) - O código do SIATI e do sistema antigo pode ser reutilizado - O legado deve ser utilizado como referência de regras de negócio e fluxos #### Condições obrigatórias para reutilização: A reutilização de código é permitida APENAS se: - O código estiver aderente a boas práticas modernas de desenvolvimento - Seguir princípios de Clean Code - For compreensível, testável e manutenível - Não introduzir acoplamento com o sistema legado (ex: dependência direta de banco, services ou estruturas antigas) - Estiver alinhado com a nova arquitetura (desacoplada e orientada a serviços) Se reutilizado: - O código deve ser revisado criticamente - Deve ser refatorado quando necessário - Não deve ser copiado de forma cega (copy/paste sem análise) - Deve ser adaptado ao padrão do novo projeto --- ### 2. Autenticação (SSO obrigatório) - Toda autenticação deve ser feita via Conta Angra - NÃO implementar login/senha local - NÃO duplicar lógica de autenticação - Conta Angra é a única fonte de verdade de identidade --- ### 3. Integração - Comunicação entre sistemas deve ocorrer via API - NÃO acessar banco de dados de outro sistema - NÃO compartilhar models entre sistemas --- ### 4. Sincronização - Criação de usuário/empresa deve refletir entre os sistemas quando aplicável - Garantir consistência de dados de identidade - Evitar duplicidade e conflitos --- ### 5. Responsabilidades #### Conta Angra - Autenticação - Identidade (usuários/empresas) #### Banco de Talentos - Vagas - Candidaturas - Regras de negócio do domínio --- ### 6. Arquitetura - Manter desacoplamento entre sistemas - Seguir padrão orientado a serviços - Código novo deve ser independente do legado --- ### 7. Documentação (OBRIGATÓRIO) Toda implementação deve ser documentada. #### Formas aceitas: - Documentação centralizada de desenvolvimento OU - Documentação por módulo #### Requisitos mínimos: - Descrição da funcionalidade - Fluxo implementado - Integrações envolvidas (ex: Conta Angra) - Decisões técnicas relevantes (quando aplicável) Código sem documentação é considerado incompleto. --- ## Anti-patterns (PROIBIDO) - Copiar código legado sem revisão/refatoração - Criar autenticação própria - Acessar banco de outro sistema - Acoplamento direto entre sistemas - Duplicar fonte de verdade de identidade --- ## Regra de validação Qualquer implementação deve: - Usar Conta Angra para autenticação - Não depender diretamente do legado - Respeitar separação de responsabilidades - Manter integração via API - Estar devidamente documentada

| ver. 1.4 | Github | . | PHP 8.3.28 | Generation time: 0.02 | proxy | phpinfo | Settings