Skip to content

Commit

Permalink
♻️ refactor: Update navigation links in mkdocs.yml and remove unused …
Browse files Browse the repository at this point in the history
…execution.md file
  • Loading branch information
thaleseuflauzino committed Aug 13, 2024
1 parent 3106f16 commit e3cdc7a
Show file tree
Hide file tree
Showing 3 changed files with 81 additions and 24 deletions.
95 changes: 75 additions & 20 deletions docs/StepByStep/execution.md → docs/Executar/execution.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
---
hide:
- navigation
- toc
---
## Como Executar o Projeto

### Pré-requisitos

Expand All @@ -12,7 +10,7 @@ hide:

Clone o repositório do projeto:

```bash
```
git clone https://github.com/unb-mds/LicitaBSB-24.1.git
```

Expand All @@ -23,26 +21,26 @@ git clone https://github.com/unb-mds/LicitaBSB-24.1.git
1. Navegue até o diretório `backend/` e crie um ambiente virtual:

**Linux**
```bash
```
python -m venv venv
source venv/bin/activate
```
**Windows**
```bash
```
python -m venv venv
venv\Scripts\activate
```
2. Instale as dependências:
```bash
```
pip install -r requirements.txt
```
3. Para rodar o projeto, navegue até o diretório `backend/server` e execute:
```bash
```
python manage.py runserver
```
Expand All @@ -56,6 +54,27 @@ Os endpoints da API REST se encontram no link https://bit.ly/licitabsb_api ou no
Este bot publica automaticamente as licitações do Diário Oficial do Distrito Federal (DODF) e do Diário Oficial da União (DOU) referentes a Brasília na conta [@LicitaBSB](https://x.com/LicitaBSB).
###### Testes do bot
Para testar o bot, utilizamos a biblioteca `unittest` do Python (ela é nativa, portanto, não é necessário nenhum pip). Siga o passo a passo abaixo para executar os testes:
1. **Navegue até o diretório raiz do projeto:**
```
cd LicitaBSB-24.1
```
2. **Execute o script de teste:**
```
python -m unittest /backend/twitter/test.py
```
Isso irá executar todos os testes presentes no diretório `tests` que começam com o prefixo `test_`.
3. **Verifique os resultados dos testes:**
Após a execução dos testes, você verá os resultados no terminal. Os testes irão verificar se as funcionalidades do bot estão funcionando corretamente e se os dados estão sendo formatados e publicados adequadamente.
Certifique-se de que todas as asserções nos testes passaram sem erros. Caso algum teste falhe, verifique o motivo do erro e faça as correções necessárias no código.
##### Funcionalidades
- Autenticação automática na API do Twitter.
Expand All @@ -64,54 +83,90 @@ Este bot publica automaticamente as licitações do Diário Oficial do Distrito
- Publicação automática das licitações.
- Testes com dados simulados.
##### Configuração
1. Clone o repositório:
```bash
```
git clone https://github.com/unb-mds/LicitaBSB-24.1.git
cd LicitaBSB-24.1
```
2. Instale as dependências:
```bash
```
pip install -r backend/requirements.txt
```
3. Configure as variáveis de ambiente criando um arquivo `.env` na raiz do projeto com as chaves da API do Twitter:
```env
TWITTER_API_KEY=seu_api_key
TWITTER_API_KEY_SECRET=seu_api_key_secret
TWITTER_ACCESS_TOKEN=seu_access_token
TWITTER_ACCESS_TOKEN_SECRET=seu_access_token_secret
TWITTER_BEARER_TOKEN=seu_bearer_token
```
```TWITTER_API_KEY=seu_api_key ```
```TWITTER_API_KEY_SECRET=seu_api_key_secret ```
```TWITTER_ACCESS_TOKEN=seu_access_token ```
```TWITTER_ACCESS_TOKEN_SECRET=seu_access_token_secret ```
```TWITTER_BEARER_TOKEN=seu_bearer_token```
4. Atualize o sistema de coleta de dados para garantir que a database esteja atualizada.
##### Uso
1. Execute o script principal:
```bash
```
python backend/twitter_bot/auto.py
```
2. O bot publicará as licitações no Twitter. Se não houver licitações no dia, o bot publicará uma mensagem informando.
#### Testes
1. Testes Automatizados com Django
O Django oferece um framework robusto para criação e execução de testes automatizados. Abaixo estão as instruções de como rodar os testes.
2. Configuração Inicial
Certifique-se de que os pacotes de teste estão instalados. Se estiver utilizando um ambiente virtual, ative-o antes de instalar as dependências:
> Clone o repositório
```
git clone https://github.com/unb-mds/LicitaBSB-24.1.git
cd LicitaBSB-24.1
```
> Instale as dependências
```
python -m venv venv # Criação do ambiente virtual
source venv/bin/activate # Ativação no Linux/MacOS
venv\Scripts\activate # Ativação no Windows
pip install -r requirements.txt # Instalação das dependências
```
3. Estrutura dos Testes
Por convenção, os testes em Django são colocados em um arquivo tests.py dentro de cada aplicação, ou em uma pasta tests/ contendo múltiplos arquivos de teste.
4. Executando os Testes
Para rodar os testes, navegue até `backend/server` e utilize o comando:
```
python manage.py test
```
### Frontend
1. Navegue até o diretório `web` e instale as dependências:
1. Navegue até o diretório `frontend` e instale as dependências:
```bash
```
npm install
```
2. Para rodar o projeto, execute:
```bash
```
npm run build
npm run dev
```
Expand Down
2 changes: 1 addition & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ hide:

## Sobre

O [Licita BSB](link) é um projeto em desenvolvimento da matéria **Métodos de Desenvolvimento de Software da Universidade de Brasília**, no qual tem o objetivo de criar um feed online para analisar e destacar as Dispensas de Licitações nos diários oficiais de Brasília visando aumentar a transparência e a fiscalização dos gastos governamentais.
O [Licita BSB](https://licitabsb.netlify.app/) é um projeto em desenvolvimento da matéria **Métodos de Desenvolvimento de Software da Universidade de Brasília**, no qual tem o objetivo de criar um feed online para analisar e destacar as Dispensas de Licitações nos diários oficiais de Brasília visando aumentar a transparência e a fiscalização dos gastos governamentais.

## Desenvolvedores

Expand Down
8 changes: 5 additions & 3 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ extra_css:
- stylesheets/style.css
nav:
- Home: index.md
- Tutorial - Como Inicializar o Ambiente Virtual: StepByStep/execution.md
- Como executar o projeto : Executar/execution.md
- Arquitetura: Arquitetura/arquitetura.md
- Jornada de produção: storymap/storymap.md

Expand Down Expand Up @@ -71,5 +71,7 @@ theme:
toggle:
icon: material/weather-sunny
name: Trocar para modo claro
icon:
repo: fontawesome/brands/git-alt
icon:
repo: fontawesome/brands/git-alt
include:
- README.md

0 comments on commit e3cdc7a

Please sign in to comment.