https://github.com/eddyoliveiram/xyz-app
I developed a small application separating the frontend layer (VueJS) from the backend API (Laravel). This application is designed for employers to manage employee training.
https://github.com/eddyoliveiram/xyz-app
api-rest docker-compose laravel laravel-framework vuejs3
Last synced: 2 months ago
JSON representation
I developed a small application separating the frontend layer (VueJS) from the backend API (Laravel). This application is designed for employers to manage employee training.
- Host: GitHub
- URL: https://github.com/eddyoliveiram/xyz-app
- Owner: eddyoliveiram
- Created: 2024-08-04T19:46:19.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-07T18:06:13.000Z (almost 2 years ago)
- Last Synced: 2025-02-08T01:33:28.600Z (over 1 year ago)
- Topics: api-rest, docker-compose, laravel, laravel-framework, vuejs3
- Language: PHP
- Homepage:
- Size: 538 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Aplicação XYZ para Gerenciamento de Treinamentos
## Requisitos
- Docker instalado
- Composer
- Npm (ou Yarn)
## Passo a passo
### Clone o Repositório
(De preferência para um diretório dentro do Linux WSL2 otimizando a performance da API com Laravel Sail)
~~~
git clone https://github.com/eddyoliveiram/xyz-app.git
~~~
### Frontend
Abra um terminal e acesse a pasta do frontend
~~~
cd frontend
~~~
Instale os pacotes da aplicação
~~~
npm install
~~~
Inicie a aplicação
~~~
npm run serve
~~~
### Backend
Abra um terminal UBUNTU e acesse a pasta do backend-api
~~~
cd backend-api
~~~
Instale as dependências:
~~~
composer install
~~~
Copie o arquivo .env.example para .env (já deixei configurado para a conexão):
~~~
cp .env.example .env
~~~
Levante a aplicação (é necessário que o docker esteja aberto no computador):
~~~
./vendor/bin/sail up -d
~~~
Rode as migrações com seeders:
~~~
./vendor/bin/sail artisan migrate:fresh --seed
~~~
A aplicação deve estar acessível na porta 3000:
~~~
http://localhost:3000
~~~
### Usuários Criados
Se o comando --seed rodou com sucesso, foram criados 2 usuários admins e 10 usuários subordinados.
Usuários Admins:
admin
Login: admin
Senha: admin
admin2
Login: admin2
Senha: admin2
Usuários Subordinados:
joao
Login: joao
Senha: 123
Demais 9 usuários
Login: ...
Senha: 123
OBS:Você pode conferir os logins dos demais usuários na tabela users.
### Recursos Utilizados
~~~
Frontend
- Framework Vue3
Backend (API REST)
- Framework Laravel 10.x
- Laravel Sail (Docker com container MySQL)
- Laravel Breeze API e Sanctum (autenticação da API)
- Repository Pattern
Github
- Conventional Commits
~~~
### Diagrama de Entidade-Relacionamento (ERD)
### Informações Adicionais
~~~
Construí esta aplicação em pouco mais de 3 dias, devido ao prazo extremamente curto informado.
Por esse motivo, a aplicação atualmente possui poucas funcionalidades.
No entanto, acredito que seja suficiente para avaliar a qualidade do código produzido.
~~~