Micro-serviço web para mostrar imagens de perfil a partir do idUFFS de um usuário da Universidade Federal da Fronteira Sul. A ideia é ter o mínimo de atrito (e esforço) para mostrar uma imagem de avatar de um usuário que possua um idUFFS, ao estilo do serviço Gravatar.
Se você está construindo um serviço web para a UFFS e gostaria de mostrar o avatar de um usuário que tenha um idUFFS, basta criar uma imagem da seguinte forma:
<img src="https://cc.uffs.edu.br/avatar/iduffs/{iduffs}" title="Avatar" />onde {iduffs} deve ser substituído pelo idUFFS do usuário em questão. Por exemplo, para o usuário cujo idUFFS é fernando.bevilacqua, a URL do avatar é:
<img src="https://cc.uffs.edu.br/avatar/iduffs/fernando.bevilacqua" title="avatar" />DICA: se estiver usando Tailwind, use o seguinte:
<img class="h-12 w-12 object-cover rounded-full" src="https://cc.uffs.edu.br/avatar/iduffs/{iduffs}" title="avatar" />.
Usuários do seu serviço podem acessar cc.uffs.edu.br/avatar para conferir sua imagem de perfil ativa.
Se você planeja trabalhar para evoluir essa ferramenta, siga as intruções abaixo. Você precisará do seguinte já instalado:
git clone https://github.com/ccuffs/id-uffs-avatar && cd id-uffs-avatar
Crie um arquivo chamado .env utilizando .env.example como template:
cp .env.example .env
Se você seguir os passos aqui descritos e a aplicação não rodar como esperado, deixe o campo
APP_URLvazio no.env.
O valor do campo DB_CONNECTION já estará configurado para sqlite, o que fará a aplicação utiliar um banco local SQLite no caminho /database/database.sqlite.
Agora, instale as dependências do PHP:
composer install
Após, uma chave da aplicação deve ser gerada:
php artisan key:generate
Por fim, rode as migrações, para carregar as relações no banco:
php artisan migrate
Se houver seeders para o banco de dados, rode:
php artisan db:seed
Para o front-end, basta instalar as dependências com o npm:
npm install
Inicie o servidor Laravel
php artisan serve
E compile o front-end:
npm run dev
Sua ajuda é muito bem-vinda, independente da forma! Confira o arquivo CONTRIBUTING.md para conhecer todas as formas de contribuir com o projeto. Por exemplo, sugerir uma nova funcionalidade, reportar um problema/bug, enviar um pull request, ou simplemente utilizar o projeto e comentar sua experiência.
Veja o arquivo ROADMAP.md para ter uma ideia de como o projeto deve evoluir.
Esse projeto é licenciado nos termos da licença open-source MIT e está disponível de graça.
Veja todas as alterações desse projeto no arquivo CHANGELOG.md.
Abaixo está uma lista de links interessantes e projetos similares: