olhoneles / politicos

API com todos os candidatos Brasileiros!

Olho Neles

Tool to monitor Brazilian legislators expenses while in the exercise of their mandates.

Install

1. Clone the repository:

   git clone https://github.com/olhoneles/olhoneles.git
   

2. Create a virtualenv:

   cd olhoneles
   mkvirtualenv olhoneles
   

3. Install dependencies:

   make setup
   

4. Create your database:

   make data
   

5. Run it:

   make run
   

6. Change default configs:

   If you would like to override some settings.py variables, like SECRET_KEY, DATABASES, ALLOWED_HOSTS, please create the olhoneles/local.config file.

Collecting the data

After setting up, you can collect one of the supported legislative houses (cmbh, almg, cmsp, senado) by using the collect command like this:

./manage.py collect <house>

You can add --debug after the name of the house to get a more verbose output. Note that the collection process happens in a transaction and that the expenses are not added to the main Expense table while the collection is running, so you will not see partial data in the site while collecting.

API

Yes, we have an API. The Olho Neles API lets you build tools using all data we have collected from legislative houses. All endpoints, parameters and error messages available to the Olho Neles API are docummented.

Contribute

Join us at the dev-mailing list and at #olhoneles on Freenode.

Fork the repository and send your pull-requests.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

politicos's Issues

Criar rotas de pesquisa

Os filtros de pesquisa padrão do tastypie não fazem buscas complexas. Como por exemplo, pesquisar 'dilma rousseff' retorna vazio uma vez que o nome cadastrado é 'dilma vana rousseff'. A ideia é criar uma rota 'search' e usar o operador 'Q' do django.

Models que precisam desse filtro:

• Politician
• City
• Occupation

Verificar se todas as foreign keys estão relacionadas com os resources

Adicionar badges

• landscape.io
• gemnasium.com

Site do projeto no ghpages

Opa, o que acha de colocar o site do projeto no github pages? Poderia criar um novo repositório com o nome "politicos-site" para isso e colocar a API para funcionar em um subdomínio, algo como: http://api.politicos.olhoneles.org/api/v0/political-parties/

Dessa forma, acredito, fica mais fácil de alguém poder contribuir para o projeto.

Melhorar a Home do Website

Explicar porque o projeto foi criado, suas vantagens, etc.

Criar rota de Estados

Uma vez que 'Estado' não é um model, é preciso criar o resource dele

Docs: http://django-tastypie.readthedocs.org/en/latest/non_orm_data_sources.html

Criar exemplos de consulta

Por hora só existe uma exemplo em cURL. Era bom ter em várias linguagens.

Corrigir estilo do Swagger (rotas da API)

O estilo padrão do django-tastypie-swagger esta sobrescrevendo o estilo do bootstrap.

Refatorar o _base.py

Identificar e mover alguns métodos que tratam da criação de objetos para o modes.py

Sistema com internacionalização (i18n)

• README
• Website
  • Desenvolvedores
  • Exemplos
  • Demonstração
  • Rotas da API

Linkar os zips no website

Listar os anos com link para baixar os arquivos zipados com os dados 'crus'. Assim qualquer pessoa pode validar nossos dados.

Corrigir rodapé

• Links quebrados
• Remover ou colocar algo melhorar no lugar da seção 'Conteúdo'

Diretório de logs dos coletores

O log dos coletores esta ativo por padrão, então é preciso existir o /tmp para que seja criado o error.log. Acredito que não precisa deixar essa opção ativa por padrão.

Relacionar cidades com dados do IBGE e Wikipedia

Melhorar desempenho dos coletores

Eleições com prefeitos e vereadores estão demorando horas, mesmo usando multithreading. Pensar em uma nova estratégia, como fazer inserção em lots.

Página para Desenvolvedores

Explicar melhor como um desenvolvedores poderá criar seu projeto usando a API

Escrever testes

• Integrar com o travis
• Adicionar badge:
  • Travis
  • coveralls.io

Fotos com URLs quebradas

Verificar se a rota mudou; Talvez fazer um request para cada foto antes de armazenar a rota, caso a rota retorne status >= 400 colocar uma foto padrão? Ou é melhor o próprio sistema armazenar as fotos para não ter que ficar verificando?

Enviar os dados dos políticos para o EveryPolitician.org

O objetivo do http://everypolitician.org/ é formar um banco de dados com todos os políticos do mundo. No Brasil, eles só têm os debutados da 55a legislatura (2015-2019) http://everypolitician.org/brazil/. Eles possuem um tutorial sobre como contribuir dados em http://everypolitician.org/contribute.html

Tendo esses dados em um lugar único, podemos fazer diversos cruzamentos interessantes, por exemplo comparando o perfil dos políticos brasileiros com os do restante da América Latina.