LabSIS KIT

Sobre o labSIS KIT

Este repositório é um Kit de Iniciação (Starter Kit) para o desenvolvimento de aplicações SaaS (Software as a Service) utilizando a stack TALL (Tailwind, Alpine.js, Laravel, Livewire) e Filament.

O objetivo deste projeto é fornecer uma base sólida e rica em recursos para acelerar o desenvolvimento de novas aplicações, seguindo as melhores práticas e convenções do ecossistema Laravel.

Confira também o nosso Roadmap de Desenvolvimento para ver o que planejado para o futuro do kit.

Documentação do Kit

Esta documentação foi criada para facilitar o entendimento de como as funcionalidades do kit foram implementadas, descrevendo os padrões adotados, decisões técnicas e exemplos práticos.

Toda a documentação sobre como utilizar os recursos, padrões e arquitetura deste kit está disponível na pasta /docs. Recomendamos a leitura para todos os desenvolvedores que pretendem utilizar este projeto.

Manual HTML (navegável no browser): versão estática com visual LabSIS em docs/manual/index.html. Para regenerar após editar os .md: python3 scripts/build-docs-manual.py (veja docs/manual/README.md).

Além disso, este repositório foi indexado nas plataformas de IA DeepWiki e Context7, que auxiliam o leitor a explorar o código e compreender as implementações por meio de buscas contextuais e respostas explicativas.

Autenticação e Segurança

• Autenticação de Dois Fatores (2FA) no Filament
• Checklist de Segurança
• Content Security Policy (CSP)
• Fluxo de Registro de Novos Usuários
• Fortalecimento de Senha
• Login Unificado
• Prevenção Contra IDOR
• Roles/Permissions
• Suspensão de Usuários
• Gestão de Tenants
• Customização de E-mails e Reset de Senha

UI e Customização

• Customização de Cores e CSS Modular
• Customização da Aparência do Painel
• Customização de Logotipo
• Widgets no Filament

Backend e Arquitetura

• Entendendo o AppServiceProvider
• Arquitetura do Model User
• Integração MongoDB - Auditoria e Logs
• Estratégia de Backup
• Scripts do Composer e Inicialização
• Regras de Negócio
• Gestão de mídias
• Notificações
• Utilizando Enumerações (Enums) com Filament
• Padronização de Data e Hora

Stack Tecnológica

• Stack Tecnológica (Versões)

Otimizações

• Otimização com #[Computed]
• Performance no Filament
• Cache e Redis
• Otimização de Cache de Página com Cloudflare
• Laravel Pulse

Qualidade de Código

• Larastan
• Rector
• Filacheck Pro
• IDE Helper

Testes Automatizados

• Introdução aos Testes Automatizados
• Testes de Autenticação
• Testes de Acesso aos Painéis

Inteligência Artificial

• Laravel Boost - MCP para Laravel
• Protocolo de Execução de Skills
• Padrão de Nomenclatura de Skills
• Guia de Workflows do Agente

Pré-requisitos

Antes de começar, certifique-se de ter instalado em sua máquina:

• Docker - Download
  • O Docker é essencial para este projeto pois possibilita criar um ambiente de desenvolvimento mais próximo do ambiente de produção, garantindo consistência entre diferentes máquinas e facilitando a implantação.
• Git - Download
• Composer - Download
• Node.js (versão 18 ou superior) - Download

Como realizar a instalação

• Instalação via Laravel Installer
• Instalação manual (clonando o repositório)

Primeiro acesso

Após rodar as migrations e seeders, os seguintes usuários são criados pelo UserSeeder:

• Admin (escopo global):

  • Email: admin@labsis.dev.br
  • Senha: mudar123
  • Acesso ao painel: /admin
  • Observação: Possui a role Admin em escopo global.

• Usuários de exemplo (escopo por tenant):

  • Sicrano
    • Email: sicrano@labsis.dev.br
    • Senha: mudar123
    • Tenants: Tenant A (Owner), Tenant B (User)
    • Acesso ao painel: /user
  • Beltrano
    • Email: beltrano@labsis.dev.br
    • Senha: mudar123
    • Tenants: Tenant A (User), Tenant B (Owner)
    • Acesso ao painel: /user

Agradecimentos

Gostaríamos de expressar nossa sincera gratidão a todas as pessoas e equipes cujo trabalho tornou este projeto possível. Suas contribuições para a comunidade de código aberto são uma fonte constante de inspiração e um pilar fundamental para o nosso desenvolvimento.

Em especial, agradecemos a:

• Equipe Laravel: Pela criação e manutenção de um framework robusto, elegante e inovador, disponível em laravel/laravel.
• Equipe Filament: Pelo incrível trabalho no Filament, que nos permite construir painéis administrativos complexos com uma velocidade e simplicidade impressionantes.
• Equipe Spatie (spatie.be): Pelo desenvolvimento dos pacotes laravel-permission e laravel-medialibrary, amplamente utilizados no ecossistema Laravel.
• Comunidade Beer and Code (beerandcode.com.br): Pela excelente metodologia de ensino em Laravel, que tem colaborador com a formação de desenvolvedores PHP, fornecendo conhecimento prático e focado em soluções reais.
• Leandro Costa (@leandrocfe): Por suas valiosas contribuições e por compartilhar conhecimento de alta qualidade sobre Filament em seu canal Filament Brasil no YouTube, que foi fundamental para a implementação de diversas features neste projeto.
• Nanderson Castro (@NandoKstroNet): Pelo excelente trabalho no canal Code Experts, que tem sido uma fonte valiosa de conhecimento técnico e boas práticas de desenvolvimento.
• João Paulo Leite Nascimento (@joaopaulolndev): Pelo desenvolvimento do pacote filament-edit-profile, que revolucionou a experiência de edição de perfil de usuários no Filament. Este pacote oferece uma solução completa e elegante para gerenciamento de perfis de usuário.
• Jeferson Gonçalves (@jeffersongoncalves): Pelo desenvolvimento de diversos pacotes, que agregam grande valor a comunidade filament + laravel.

O trabalho de vocês contribui significativamente para o avanço e a qualidade deste projeto.

🚀 Recursos Atuais

O Kit oferece uma base sólida com os seguintes recursos já implementados:

• Gestão de Tenants: Sistema multi-tenant completo com isolamento de dados por organização. Inclui criação e gerenciamento de tenants, controle de acesso baseado em roles (Admin, Owner, User), e interface administrativa para configuração de permissões por tenant.

• Gestão de Roles e Permissões: Sistema hierárquico de autorização com três níveis (Admin global, Owner por tenant, User por tenant). CRUD completo para roles e permissões com isolamento por tenant, policies centralizadas e interface de gerenciamento intuitiva.

• Gestão de Mídias: CRUD completo para mídias, com Preview de Conteúdo, Organização por Tipo e Tamanho Humanizado.

• Gestão de Usuários: CRUD completo para usuários (Criação, Leitura, Atualização e Exclusão). Sistema de Suspensão de Usuários, Organização em Abas com informações detalhadas (Informações Pessoais, Datas, Suspensão).

• Customização de Logotipo: Logotipo customizado para o painel de autenticação e para o rodapé do painel.

• Login Unificado para diferentes painéis: Login com Email e Senha, recuperação de senha e autenticação de dois fatores (2FA).

• Exibição de Widgets: Widgets personalizados para exibição de métricas e informações relevantes.

• Website / Landing Page: Página Inicial, Seções Pré-definidas (Hero e Sobre).

• Registro Histórico de Autenticações: Monitoramento completo de acessos de usuários com armazenamento em MongoDB, incluindo registros de login, logout, endereços IP e dispositivos.

• Gestão de Templates de E-mail: Funcionalidade para visualizar e testar templates de e-mail diretamente pelo painel administrativo, com suporte a templates customizados e dados reais de preview.

🧩 Plugins Utilizados

Este projeto integra plugins e pacotes robustos para expandir suas funcionalidades. Abaixo, destacamos os componente