معرفی شرکت ها
certifik8-0.2.4
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
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.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | certifik8-0.2.4 |
| نام | certifik8 |
| نسخه کتابخانه | 0.2.4 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Victorio |
| ایمیل نویسنده | victorio.lazaro15@gmail.com |
| آدرس صفحه اصلی | https://github.com/fga-eps-mds/Certifik8 |
| آدرس اینترنتی | https://pypi.org/project/certifik8/ |
| مجوز | MIT |
# 2022-2-Certifik8
<a name="readme-top"></a>
<div align="center">
[](https://github.com/fga-eps-mds/2022-2-Certifik8/graphs/contributors)
[](https://github.com/fga-eps-mds/2022-2-Certifik8/issues)
[](https://github.com/fga-eps-mds/2022-2-Certifik8/blob/main/LICENSE)
[](https://codeclimate.com/github/fga-eps-mds/2022-2-Certifik8/maintainability)
[](https://codeclimate.com/github/fga-eps-mds/2022-2-Certifik8/test_coverage)
</div>
<br />
<div align="center">
<a href="https://github.com/fga-eps-mds/2022-2-Certifik8">
<img src="https://github.com/fga-eps-mds/2022-2-Certifik8/blob/main/docs/imagens/logo.png" width="300" height="300">
</a>
<h3 align="center">Certifik8</h3>
<p align="center">
Gerador Automatico de Certificados
<br />
<a href="docs">Documentos</a>
-
<a href="https://github.com/fga-eps-mds/2022-2-Certifik8/blob/main/docs/SECURITY.md#pol%C3%ADtica-de-seguran%C3%A7a">Reportar Bug</a>
-
<a href="https://github.com/fga-eps-mds/2022-2-Certifik8/issues">Recomendar Feature</a>
</p>
</div>
<!-- TABLE OF CONTENTS -->
<details>
<summary>Conteúdo</summary>
<ol>
<li>
<a href="#-sobre-o-projeto">📝 Sobre o projeto</a>
<ul>
<li><a href="#-tecnologias">💻 Tecnologias</a></li>
</ul>
</li>
<li><a href="#-funcionalidade">🤖 Funcionalidade</a></li>
<li><a href="#-requisitos">❗ Requisitos</a></li>
<li><a href="#-como-rodar">🛞 Como executar</a>
<ul>
<li><a href="#---usuário">👩🦰 Usuário</a></li>
</ul>
<ul>
<li><a href="#--%EF%B8%8F-desenvolvimento-local">🧙🏼♀️ Desenvolvimento local</a></li>
</ul>
</li>
<li><a href="#-desenvolvedores">👨💻 Desenvolvedores</a></li>
</ol>
</details>
## 📝 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 ou curso na Semana Universitária da UnB.
## 💻 Tecnologias
#### Tecnologias utilizadas neste projeto:
<p align="center">
<a href="https://skillicons.dev">
<img src="https://skillicons.dev/icons?i=python,html,css"/>
</a>
</p>
## 🤖 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.
**Exemplo**:
<div align="center">
<a href="https://github.com/fga-eps-mds/2022-2-Certifik8/blob/main/Certifik8/examples/Melissa%20Ribeiro%20Araujo.png">
<img src="https://github.com/fga-eps-mds/2022-2-Certifik8/blob/main/Certifik8/examples/Melissa%20Ribeiro%20Araujo.png" width="413" height="291">
</a>
</div>
## ❗ Requisitos
O Certifik8 só funciona em sistemas operacionais Linux.
Testado no:
- Linux Mint 21
- Ubuntu 22.04.01
<div align="center">
</div>
**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**
1. **Abra seu terminal e digite o comando para instalar o Certifik8 do Pypi:**
```
pip install certifik8
```
2. **Comandos para instalar as dependências não presentes no Pypi**
```
sudo apt-get update -y
```
```
sudo apt-get install -y zlib1g fontconfig libxrender1 libfreetype6 libxext6 libx11-6
```
```
sudo apt install -y wkhtmltopdf
```
```
sudo apt-get install -y zenity
```
3. **Comando para acessar tutorial da aplicação**
```
certifik8 --h
```
4. **As tabelas dos cursos devem seguir uma padronização, caso contrário elas não irão gerar certificados:**
* Estrutura da tabela Excel ([Exemplo](Certifik8/examples/completa.xlsx)):
| 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
5. **Comando para rodar a aplicação**
```
certifik8
```
6. **Selecione as tabelas que possuem as informações do certificado:**
<div align="center">
<img src="https://github.com/fga-eps-mds/2022-2-Certifik8/blob/flag-help/docs/imagens/escolhe_tabela.png" width="800">
</div>
7. **Selecione a pasta onde deseja guardar os certificados:**
<div align="center">
<img src="https://github.com/fga-eps-mds/2022-2-Certifik8/blob/flag-help/docs/imagens/escolhe_pastas.png" width="800">
</div>
<div align="center">
</div>
### **- 🧙🏼♀️ Desenvolvimento local**
1. **Clone o repositório**
```
git clone https://github.com/fga-eps-mds/2022-2-Certifik8.git
```
2. **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
```
2. **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
<center>
<table style="margin-left: auto; margin-right: auto;">
<tr>
<td align="center">
<a href="https://github.com/PedroSampaioDias">
<img style="border-radius: 50%;" src="https://avatars.githubusercontent.com/u/90795603?v=4" width="150px;"/>
<h5 class="text-center">Pedro Sampaio</h5>
</a>
</td>
<td align="center">
<a href="https://github.com/phmelosilva">
<img style="border-radius: 50%;" src="https://avatars.githubusercontent.com/u/88786258?v=4" width="150px;"/>
<h5 class="text-center">Pedro Henrique</h5>
</a>
</td>
<td align="center">
<a href="https://github.com/Victor-oss">
<img style="border-radius: 50%;" src="https://avatars.githubusercontent.com/u/55855365?v=4" width="150px;"/>
<h5 class="text-center">Victório Lazaro</h5>
</a>
</td>
<td align="center">
<a href="https://github.com/daniel-de-sousa">
<img style="border-radius: 50%;" src="https://avatars.githubusercontent.com/u/95941136?v=4" width="150px;"/>
<h5 class="text-center">Daniel Sousa</h5>
</a>
</td>
<td align="center">
<a href="https://github.com/Leanddro13">
<img style="border-radius: 50%;" src="https://avatars.githubusercontent.com/u/86811628?v=4" width="150px;"/>
<h5 class="text-center">Leandro Silva</h5>
</a>
</td>
<td align="center">
<a href="https://github.com/BlimblimCFT">
<img style="border-radius: 50%;" src="https://avatars.githubusercontent.com/u/12275797?v=4" width="150px;"/>
<h5 class="text-center">Geovane Freitas</h5>
</a>
</td>
</table>
</center>
نیازمندی
| مقدار | نام |
|---|---|
| ==1.5.2 | pandas |
| ==65.6.3 | setuptools |
| ==9.3.0 | Pillow |
| ==2.11.1 | PyPDF2 |
| ==1.0.0 | pdfkit |
| >=4.11.1,<5.0.0 | beautifulsoup4 |
| >=3.0.10,<4.0.0 | openpyxl |
| >=4.64.1,<5.0.0 | tqdm |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.10,<4.0 | Python |
نحوه نصب
نصب پکیج whl certifik8-0.2.4:
pip install certifik8-0.2.4.whl
نصب پکیج tar.gz certifik8-0.2.4:
pip install certifik8-0.2.4.tar.gz