Gerador Automático de Certificados
Grupo 8
Conteúdo
📝 Sobre o projeto
Certifik8 é um gerador de certificados automático criado em Python. O projeto busca facilitar a geração massiva de documentos a serem emitidos após algum evento.
💻 Tecnologias
Tecnologias utilizadas neste projeto:
🤖 Funcionalidade
O Certifik8 precisa apenas que o usuário escolha uma tabela excel .xlsx em algum de seus arquivos para em seguida escolher o local na qual a pasta com os certificados, de modelo já definido, ficarão salvos. Após essa escolha, a geração dos certificados em formato PDF acontece de forma que cada tabela escolhida possua uma pasta homônima no destino escolhido e cada pasta apresente subpastas que vão filtrar os participantes do evento de acordo com suas funções.
❗ Requisitos
O Certifik8 só funciona em sistemas operacionais Linux.
Testado no: - Linux Mint 21 - Ubuntu 22.04.01
Para conseguir executá-lo, o usuário precisa instalar:
- Python3 e Pip
sudo apt install python3 && sudo apt install python3-pip
🛞 Como executar/rodar
- 👩🦰 Usuário
- Abra seu terminal e digite o comando para instalar o Certifik8 do Pypi:
pip install certifik8
- Comando para instalar as dependências não presentes no Pypi
certifik8 --install
- Comando para acessar tutorial da aplicação
certifik8 --h
-
As tabelas dos cursos devem seguir uma padronização, caso contrário elas não irão gerar certificados:
-
Estrutura da tabela Excel (Exemplo):
1 | Nome | CPF | Função | Frequência | Informações |
---|---|---|---|---|---|
2 | Samuel Barbosa Alves | 729.334.326-41 | PARTICIPANTE | 100 | Nome do Curso |
3 | Melissa Ribeiro Araujo | 201.544.482-30 | MONITOR | 97 | Carga Horaria |
4 | Gabrielly Rodrigues Castro | 451.016.912-40 | PARTICIPANTE | 80 | Nome do Professor |
5 | ... | ... | ... | ... | Nome do Departamento |
6 | ... | ... | ... | ... | Data Inicial |
7 | ... | ... | ... | ... | Data Final |
8 | ... | ... | ... | ... | Nome Decano(a) |
... | ... | ... | ... | ... |
*Obs.: As tabelas devem possuir essas cinco colunas com os mesmos nomes e em qualquer ordem. A coluna informações deve possuir seis linhas, e seus dados devem seguir a ordem da tabela de exemplo abaixo
Demonstração de funcionalidade.
- Comando para rodar a aplicação
certifik8
- Selecione as tabelas que possuem as informações do certificado:
- Selecione a pasta onde deseja guardar os certificados:
- 🧙🏼♀️ Desenvolvimento local
- Clone o repositório
git clone https://github.com/fga-eps-mds/2022-2-Certifik8.git
- Para instalar as dependências não advindas do Pypi, abra o repositório em seu computador e rode o comando:
cd Certifik8/installer
./dependencies.sh
- Para instalar as dependências no ambiente virtual, rode o comando no diretório raiz:
poetry install
3 Para acessar tutorial da aplicação, rode o comando no diretório raiz:
poetry run certifik8 --h
4 Para rodar a aplicação no diretório raiz:
poetry run certifik8
👨💻 Desenvolvedores
Pedro Sampaio |
Pedro Henrique |
Victório Lazaro |
Daniel Sousa |
Leandro Silva |
Geovane Freitas |