Скачать или смотреть Porter: Controle de Acesso Leve e Poderoso para Laravel | SEM BLOAT, APENAS LÓGICA DE NEGÓCIO!

🚪 Bem-vindo ao Porter – O Porteiro Confiável da Sua Aplicação Laravel! 🚀
Cansado de pacotes de controle de acesso inchados e complexos em Laravel? Conheça o Porter, o pacote de controle de acesso leve e extremamente rápido, criado por Hassan Ibrahim, que revoluciona a forma como você gerencia permissões!

O que é o Porter? O Porter trata os papéis como lógica de negócio de domínio, e não como abstrações de banco de dados genéricas.
Ele foi construído para desenvolvedores que valorizam a simplicidade, performance e uma arquitetura limpa em suas aplicações Laravel.
Esqueça as "ginásticas de banco de dados" e os pacotes super-engenheirados – o Porter foca em atribuições de negócio com contexto.

💡 Conceito Central do Porter
✅ Qualquer modelo pode ser Atribuível (Assignable): usuários, equipes, departamentos.
✅ Qualquer modelo pode ser Papelável (Roleable): projetos, organizações, documentos.
✅ O Elenco (Roster) define o relacionamento de controle de acesso entre eles.

Essa flexibilidade permite modelar cenários de negócio complexos com código simples e expressivo.

✨ Principais Recursos e Benefícios
✅ Design Focado em Atribuições: Trata os papéis como atribuições de negócio com lógica contextual.
✅ Classes de Papel Individuais: Cada papel é uma classe dedicada que estende BaseRole.
✅ Arquitetura Ultra-Minimalista: Apenas 3 componentes principais para gerenciamento de atribuições.
✅ Performance Incrível: Otimizado para velocidade com mínima interação com o banco de dados e caching integrado.
  ✅ 50-200x mais rápido que sistemas RBAC tradicionais.
  ✅ Apenas uma tabela para todo o sistema de papéis (roster).
✅ Segurança Aprimorada: Chaves de atribuição criptografadas com a criptografia integrada do Laravel.
✅ Automatic RoleCast: Conversão perfeita entre chaves de banco de dados e instâncias RoleContract fortemente tipadas.
✅ Integração Perfeita com Laravel: Diretivas Blade personalizadas, middleware, além de Gates e Policies.
✅ Suporte Cross-Database (Pronto para Empresas): Gerencia automaticamente cenários onde seus modelos, dados RBAC e lógica de negócio abrangem múltiplas conexões de banco de dados.

🌍 Casos de Uso no Mundo Real
✅ Plataformas de Colaboração em Equipe: Equipes com papéis em projetos.
✅ Consumo de Recursos SaaS: Organizações com acesso a recursos em assinaturas.
✅ Sistemas de Gerenciamento de Documentos: Usuários/departamentos com papéis em documentos/pastas.
✅ Sistemas de Gerenciamento de Projetos: Diferentes tipos de atribuições para estruturas de projeto complexas.
✅ Aplicações Multi-Tenant: Usuários com papéis em tenants/workspaces.
✅ Gerenciamento de Hierarquia Empresarial: Departamentos com papéis em divisões/subsidiárias.
✅ Microsserviços e Sistemas Distribuídos: Onde os papéis podem abranger múltiplas fontes de dados.

🚀 Como Começar com o Porter
✅ Instalação
✅ Configuração Inicial
✅ O comando install publica o arquivo de configuração, executa as migrações e cria o diretório Porter.
✅ Crie suas Classes de Papel (Roles): Use o comando Artisan interativo para criar papéis e gerenciar hierarquias de forma inteligente.
✅ Você pode definir lógica de negócio personalizada dentro de cada classe de papel.
✅ Atribua Papéis
✅ Integre aos Seus Modelos: Adicione as traits CanBeAssignedToEntity e ReceivesRoleAssignments aos seus modelos.

⚡ Recursos Avançados
✅ Hierarquia de Papéis Inteligente: Compare papéis por nível (ex: isHigherThan(), isAtLeastOn()).
✅ Cross-Database Otimizado: O Porter detecta automaticamente conexões de banco de dados diferentes e otimiza as consultas com whereIn para melhor performance.
✅ Comando porter:doctor: Valida sua configuração e detecta potenciais problemas.

🛠️ Requisitos
✅ PHP 8.2+
✅ Laravel 11.0+ | 12.0+
✅ Banco de dados com suporte a JSON (MySQL 5.7+, PostgreSQL 9.5+, SQLite 3.1+)

🌐 Comunidade e Contribuição
✅ Quer ser um Co-Mantenedor? O Porter está procurando alguém para criar demos e tutoriais em vídeo. Entre em contato: [email protected]

✅ Compartilhe Seu Feedback: Use as GitHub Discussions, Project Wiki ou GitHub Issues.
✅ Seja um Contribuidor: Relate bugs, melhore a documentação, escreva testes, sugira novos recursos ou vote nos recursos do roadmap. Contribuidores são reconhecidos!

🔗 Links Úteis:
• Repositório GitHub do Porter: https://github.com/hdaklue/porter
• Leia a Documentação Completa: https://github.com/hdaklue/porter#tab...