Group Management System

Bem-vindo ao Group Management System, um sistema de gerenciamento de grupos econômicos desenvolvido com Laravel + Livewire e TailwindCSS.

⚙️ Pré-requisitos

Antes de começar, certifique-se de ter os seguintes requisitos instalados:

• Git
• Node.js (versão 16 ou superior)
• PHP 8.2
• Composer
• MySQL

🚀 Instalação e Configuração

Siga os passos abaixo para configurar e rodar o projeto corretamente em sua máquina.

1️⃣ Clone o repositório

git clone /~https://github.com/DaviTorelli/group-management-system.git
cd group-management-system

2️⃣ Configure o ambiente

Duplique o arquivo .env.example para .env:

cp .env.example .env

Atualize as configurações do banco de dados no arquivo .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1 (altere se for o seu caso)
DB_PORT=3306 (altere se for o seu caso)
DB_DATABASE=nome_da_base_de_dados
DB_USERNAME=seu_username
DB_PASSWORD=sua_senha

3️⃣ Instale as dependências do front-end

npm install

E em seguida, execute:

npm run dev

4️⃣ Instale as dependências do back-end

Abra outro terminal na mesma pasta e rode:

composer install

5️⃣ Configure o banco de dados

Com o .env configurado, execute:

php artisan migrate --seed

Caso não queira dados fictícios, no .env altere o APP_DEBUG para false:

APP_DEBUG=false

6️⃣ Gere a chave da aplicação

php artisan key:generate

7️⃣ Inicie o servidor do Laravel

php artisan serve

Seu projeto deve estar rodando perfeitamente!

Acesse no navegador: http://127.0.0.1:8000

🧪 Testes

• Para acessar o sistema, use as seguintes credenciais:
  • e-mail: "michael.jackson@email.com",
  • senha: "password"
• Ao cadastrar uma unidade, use esse Gerador de CNPJ:
• Ao cadastrar um colaborador, use esse Gerador de CPF:

📖 Tecnologias e Bibliotecas

• Laravel
• Livewire
• TailwindCSS
• Sanctum: Autenticação
• Flux: Biblioteca de Componentes
• Livewire-Charts: Gráficos
• pt-br-validator: Validações específicas (CPF e CNPJ)

Diagrama de Classes