KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

labSIS-KIT

★ 31 Open GitHub ↗

Repositorio destinado a fornecer um kit inicial para desenvolvimento de SaaS usando laravel e filament

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# LabSIS KIT

<div align="center">
  <img src="public/images/labsis_logo_bg.png" alt="LabSIS — Laboratório de Sistemas Inovadores" width="520" />
  <br>
  <a href="https://www.labsis.dev.br">www.labsis.dev.br</a><br>
  <em>Transformando desafios reais em soluções inteligentes</em>
</div>

## 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**](ROADMAP.md) 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á estruturada em HTML navegável na pasta [`/docs`](/docs/index.html).

Além disso, este repositório foi indexado nas plataformas de IA [DeepWiki](https://deepwiki.com/iurygdeoliveira/labSIS-SaaS-KIT-V4) e [Context7](https://context7.com/iurygdeoliveira/labsis-saas-kit-v4), 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**](/docs/02-autenticacao-e-seguranca/autenticacao-2fa.html)
- [**Checklist de Segurança**](/docs/02-autenticacao-e-seguranca/checklist-de-seguranca.html)
- [**Content Security Policy (CSP)**](/docs/02-autenticacao-e-seguranca/content-security-policy.html)
- [**Fluxo de Registro de Novos Usuários**](/docs/02-autenticacao-e-seguranca/fluxo-de-registro-de-novos-usuarios.html)
- [**Fortalecimento de Senha**](/docs/02-autenticacao-e-seguranca/fortalecimento-de-senha.html)
- [**Login Unificado**](/docs/02-autenticacao-e-seguranca/login-unificado.html)
- [**Prevenção Contra IDOR**](/docs/02-autenticacao-e-seguranca/prevencao-idor.html)
- [**Roles/Permissions**](/docs/02-autenticacao-e-seguranca/roles-e-permissions.html)
- [**Suspensão de Usuários**](/docs/02-autenticacao-e-seguranca/suspensao-usuarios.html)
- [**Gestão de Organizações (Multi-tenancy)**](/docs/02-autenticacao-e-seguranca/tenancy-e-teams.html)
- [**Customização de E-mails e Reset de Senha**](/docs/02-autenticacao-e-seguranca/customizacao-emails.html)

### UI e Customização

- [**Customização de Cores e CSS Modular**](/docs/03-ui-e-customizacao/customizacao-de-cores.html)
- [**Customização da Aparência do Painel**](/docs/03-ui-e-customizacao/customizando-layout.html)
- [**Customização de Logotipo**](/docs/03-ui-e-customizacao/customizando-logo.html)
- [**Widgets no Filament**](/docs/03-ui-e-customizacao/widgets-filament.html)

### Backend e Arquitetura

- [**Entendendo o AppServiceProvider**](/docs/04-backend-e-arquitetura/app-service-provider.html)
- [**Arquitetura do Model User**](/docs/04-backend-e-arquitetura/user-model.html)
- [**Integração MongoDB - Auditoria e Logs**](/docs/04-backend-e-arquitetura/mongodb-integration.html)
- [**Estratégia de Backup**](/docs/04-backend-e-arquitetura/estrategia-backup.html)
- [**Scripts do Composer e Inicialização**](/docs/04-backend-e-arquitetura/scripts-composer.html)
- [**Regras de Negócio**](/docs/04-backend-e-arquitetura/regras-de-negocio.html)
- [**Gestão de mídias**](/docs/04-backend-e-arquitetura/gestao-de-midia.html)
- [**Notificações**](/docs/04-backend-e-arquitetura/notifications-trait.html)
- [**Utilizando Enumerações (Enums) com Filament**](/docs/04-backend-e-arquitetura/enums.html)
- [**Padronização de Data e Hora**](/docs/04-backend-e-arquitetura/padrao-datetime.html)

### Stack Tecnológica

- [**Stack Tecnológica (Versões)**](/docs/04-backend-e-arquitetura/stack-tecnologica.html)

### Otimizações

- [**Otimização com #[Computed]**](/docs/05-otimizacoes/livewire-computed.html)
- [**Performance no Filament**](/docs/05-otimizacoes/filament-performance.html)
- [**Cache e Redis**](/docs/05-otimizacoes/cache-e-redis.html)
- [**Otimização de Cache de Página com Cloudflare**](/docs/05-otimizacoes/cloudflare-page-cache.html)
- [**Laravel Pulse**](/docs/05-otimizacoes/laravel-pulse.html)

### Qualidade de Código

- [**Larastan**](/docs/07-qualidade-de-codigo/01-larastan.html)
- [**Rector**](/docs/07-qualidade-de-codigo/02-rector.html)
- [**Filacheck Pro**](/docs/07-qualidade-de-codigo/04-filacheck.html)
- [**IDE Helper**](/docs/07-qualidade-de-codigo/03-ide-helper.html)

### Testes Automatizados

- [**Introdução aos Testes Automatizados**](/docs/06-testes/01-introducao.html)
- [**Testes de Autenticação**](/docs/06-testes/02-autenticacao.html)
- [**Testes de Acesso aos Painéis**](/docs/06-testes/03-acesso-paineis.html)

### Inteligência Artificial

- [**Laravel Boost - MCP para Laravel**](/docs/08-ai-agents/laravel-boost.html)
- [**Protocolo de Execução de Skills**](/docs/08-ai-agents/protocolo-operacional.html)
- [**Padrão de Nomenclatura de Skills**](/docs/08-ai-agents/padrao-de-skills.html)
- [**Guia de Workflows do Agente**](/docs/08-ai-agents/guia-workflows.html)

## Pré-requisitos

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

- **Docker** - [Download](https://docs.docker.com/engine/install/)
    - 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](https://git-scm.com/)
- **Composer** - [Download](https://getcomposer.org/)
- **Node.js** (versão 18 ou superior) - [Download](https://nodejs.org/)

## Como realizar a instalação

- [Instalação via Laravel Installer](/docs/01-instalacao-e-setup/instalacao-via-laravel-installer.html)
- [Instalação manual (clonando o repositório)](/docs/01-instalacao-e-setup/instalacao-manual.html)

## 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 organização):
    - Sicrano
        - Email: `sicrano@labsis.dev.br`
        - Senha: `mudar123`
        - Organizações: Team A (Owner), Team B (User)
        - Acesso ao painel: `/user`
    - Beltrano
        - Email: `beltrano@labsis.dev.br`
        - Senha: `mudar123`
        - Organizações: Team A (User), Team 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](https://github.com/laravel/laravel).
- **Equipe Filament**: Pelo incrível trabalho no [Filament](https://github.com/filamentphp/filament), que nos permite construir painéis administrativos complexos com uma velocidade e simplicidade impressionantes.
- **Equipe Spatie** ([spatie.be](https://spatie.be/)): Pelo desenvolvimento dos pacotes [laravel-permission](https://github.com/spatie/laravel-permission) e [laravel-medialibrary](https://github.com/spatie/laravel-medialibrary), amplamente utilizados no ecossistema Laravel.
- **Comunidade Beer and Code** ([beerandcode.com.br](https://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](https://github.com/leandrocfe)): Por suas valiosas contribuições e por compartilhar conhecimento de alta qualidade sobre Filament em seu canal [Filament Brasil no YouTube](https://www.youtube.com/@filamentbr), que foi fundamental para a implementação de diversas features neste projeto.
- **Nanderson Castro** ([@NandoKstroNet](https://github.com/NandoKstroNet)): Pelo excelente trabalho no canal [Code Experts](https://www.youtube.com/@codeexperts), que tem sido uma fonte valiosa de conhecimento técnico e boas práticas de desenvolvimento.
- **Jeferson Gonçalves** ([@jeffersongoncalves](https://github.com/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 Organizações:** Sistema multi-tenant completo com isolamento de dados por organização (`Organization`). Inclui criação e gerenciamento de organizações, membros e convites, além de controle de acesso baseado em roles (`OrganizationRole`).

- **Gestão de Roles e Permissões:** Sistema de autorização em escopo (Admin global, Owner por organização, User/Admin por organização). Gerenciamento de roles e permissões com isolamento por organização, policies centralizadas e interface 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 componentes utilizados:

- **[Filament Easy Footer](https://github.com/devonab/filament-easy-footer):** Adiciona um rodapé customizável ao painel administrativo, permitindo fácil inclusão de links e informações de copyright.
- **[Filament Spatie Media Library](https://github.com/filamentphp/spatie-laravel-media-library-plugin):** Plugin oficial para integrar a poderosa biblioteca Spatie Media Library ao Filament, facilitando o upload e gestão de arquivos.
- **[Filament Media Action](https://github.com/hugomyb/filament-media-action):** Fornece ações adicionais para manipulação de mídias dentro do Filament, melhorando a experiência de gerenciamento de arquivos.
- **[Laravel Authentication Log](https://github.com/TappNetwork/filament-authentication-log):** Pacote backend que rastreia e registra atividades de autenticação dos usuários, como logins, logouts e dispositivos utilizados.
- **[Spatie Laravel Backup](https://github.com/spatie/laravel-backup):** Solução completa para backups de banco de dados e arquivos da aplicação, com suporte a notificações e armazenamento em cloud.
- **[Spatie Laravel Query Builder](https://github.com/spatie/laravel-query-builder):** Facilita a construção de consultas Eloquent complexas a partir de parâmetros de requisição HTTP, ideal para APIs e filtragem avançada.

## 🛠️ Recomendação de Ferramentas de Desenvolvimento

Este projeto utiliza um conjunto de ferramentas para garantir a qualidade, padronização e agilidade no desenvolvimento. Abaixo estão os pacotes incluídos no ambiente de desenvolvimento (`require-dev`):

- **[barryvdh/laravel-debugbar](https://github.com/barryvdh/laravel-debugbar):** Adiciona uma barra de depuração com informações úteis sobre a aplicação.
- **[beyondcode/laravel-query-detector](https://github.com/beyondcode/laravel-query-detector):** Auxilia na identificação de consultas N+1, notificando o desenvolvedor para melhorar a performance da aplicação.
- **[fakerphp/faker](https://github.com/fakerphp/faker):** Gera dados falsos para popular o banco de dados em testes e seeders.
- **[larastan/larastan](https://github.com/larastan/larastan):** Realiza análise estática de código para encontrar bugs sem executar o código.
- **[laravel-shift/blueprint](https://blueprint.laravelshift.com/):** Gera código Laravel rapidamente a partir de um arquivo de definição.
- **[laravel/boost](https://packagist.org/packages/laravel/boost):** Servidor MCP oficial do Laravel que fornece contexto inteligente sobre a aplicação (versões, schema DB, rotas, Artisan) para agentes de IA. [Ver documentação](/docs/08-ai-agents/laravel-boost.html).
- **[laravel/pint](https://github.com/laravel/pint):** Formata o código PHP para seguir um padrão de estilo consistente (PSR-12).
- **[laravel/sail](https://github.com/laravel/sail):** Ambiente de desenvolvimento local completo baseado em Docker.
- **[laravel/tinker](https://github.com/laravel/tinker):** Console interativo (REPL) para executar código no contexto da aplicação.
- **[lucascudo/laravel-pt-br-localization](https://github.com/lucascudo/laravel-pt-br-localization):** Fornece traduções e configurações para a localização em português do Brasil.
- **[pestphp/pest](https://github.com/pestphp/pest):** Framework de testes elegante e focado no desenvolvedor para PHP.

## 📄 Licença

Este projeto está licenciado sob a [MIT License](LICENSE).

## 👥 Autor

- **Iury Oliveira** - [@iurygdeoliveira](https://github.com/iurygdeoliveira)

---

<div align="center">
  <strong>LabSIS - Transformando desafios reais em soluções inteligentes</strong>
</div>

labSIS-KIT

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README