| Este projeto está em execução em link Usuario:user
Senha:user4567 |
O Proagro Fácil é um sistema da Softfocus que facilita o gerenciamento de Proagro (Programa de Garantia da Atividade Agropecuária). O Proagro é um programa administrado pelo Banco Central do Brasil, que visa exonerar o produtor rural de obrigações financeiras relativas a operações de crédito, em casos de ocorrência de perdas nas lavouras. Estas perdas podem ser ocasionadas por fenômenos naturais, como chuva excessiva, geada, granizo, etc.
No Proagro Fácil, uma das principais etapas para a solicitação de Proagro é o cadastro da comunicação da perda ocorrida, onde o analista de Proagro irá informar os dados sobre o produtor rural, sobre a lavoura e sobre o evento que provocou a perda. É muito importante que essas informações sejam preenchidas corretamente para que o produtor tenha o benefício aprovado.
Neste desafio, você irá criar uma versão simplificada da comunicação de perda.
-
✔️ A solução deve ser desenvolvida em Python (utilize o framework de sua preferência);
-
✔️ A solução deve possibilitar o cadastro, visualização, atualização e exclusão de uma comunicação de perda;
-
✔️ Crie a interface Web com o framework que desejar;
-
✔️ Os dados devem ser salvos em um dos banco de dados: Postgres, MySQL, MongoDB ou Firebase;
-
✔️ A comunicação de perda deve ter os seguintes campos:
a. Nome do produtor rural;
b. E-mail do produtor rural;
c. CPF do produtor rural;
d. Localização da lavoura (latitude e longitude);
e. Tipo da lavoura (milho, soja, trigo, feijão, etc);
f. Data da colheita;
g. Evento ocorrido, sendo os eventos possíveis:
-
i. CHUVA EXCESSIVA
-
ii. GEADA
-
iii. GRANIZO
-
iv. SECA
-
v. VENDAVAL
-
vi. RAIO
-
-
✔️ Quando o analista estiver cadastrando uma nova comunicação de perda, queremos garantir a veracidade do evento informado. Por isso, caso já exista um cadastro no banco de dados, com mesma data, cuja localização esteja em um raio de 10km da localização da nova comunicação de perda e for um evento divergente do que já consta no banco de dados, o analista deverá ser informado;
-
✔️ O projeto deverá conter validações para que o CPF e e-mail informados sejam válidos (feito em Javascript);
-
✔️ Deve ser possível realizar a busca de uma comunicação de perda pelo CPF do produtor (front-end);
-
✔️ O projeto deverá ser disponibilizado em repositório online, como Github, Gitlab, etc;
-
✔️ O repositório deve conter um arquivo README explicando como utilizar o projeto.
-
✔️ Implementar testes automatizados;
- ✔️ Utilizar um framework front-end (Angular, React, Vue, Ember JS, etc);
- ✔️ Deixar a comunicação de perda intuitiva e com uma interface agradável também será um diferencial ( utilização de CSS);
- ✔️ Fazer deploy do projeto (ex.: Heroku, Surge.sh, Pythonanywhere, AWS, etc) e disponibilizar a URL para acesso;
- ✔️ Disponibilizar a aplicação em forma de API para consulta e manipulação das comunicações de perda;
- ✔️ Disponibilizar a documentação da API (Swagger, Apiary, Document360, etc);
- ✔️ Qualquer funcionalidade extra será bem-vinda.
- Postgres com extensão Postgis docs imagem docker
- GeoDjango requisitos
sudo apt-get install binutils libproj-dev gdal-bin - Django REST framework link
Opcional (para execução com docker)
git clone git@github.com:julioriffel/Desafio-Softfocus-Proagro-Facil.git
cd Desafio-Softfocus-Proagro-Facil
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt -UAs variáveis de ambiente para o projeto, como debug e configurações de banco de dados dever ser ajustadas nos
arquivos.env .env.prod¹ .env.prod.db¹
¹=Exclusivo para Docker
cp .env.example .env
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver*Requer banco de dados Postgis
Disponivel em: http://localhost:8000
Para executar django em produção é necessário rodar com Gunicorn e usar Nginx como proxy reverso para dar mais segurança ao aplicativo.
Fluxo:O navegador da Web faz uma solicitação que vai primeiro para o Nginx (servidor proxy), o Nginx atua como um proxy e envia essa solicitação para o Gunicorn (servidor Http python). O Gunicorn recebe isso e se comunica com o aplicativo da web por meio de uma interface chamada interface de gateway do servidor da web (WSGI).
Requer docker + docker-compose e a porta 80 disponível
cp .env.prod.example .env.prod
cp .env.prod.db.example .env.prod.db
docker-compose up -d [--build]
docker-compose exec web python manage.py migrate
docker-compose exec web python manage.py createsuperuser
docker-compose exec web python manage.py loaddata fixtures/proagro.jsonDisponivel em: http://localhost
Requer SDK do GCP
cp app.yaml.example app.yaml
#Ajustar configuraçoes de DB no app.yaml
gcloud app deployEste projeto não é compativel com Google App Engine Standard pois o GeoDjango requer os pacotes da
plataforma libgdale
gdal-devel não instaladas neste ambiente. Como alternativa é possivel realizar o deploy
no Google App Engine Flex
A documentação da API foi gerada no formato OpenAPI, com a biblioteca drf-yasg. A qual provê interfaces (swagger e redoc) para visualizar a documentação e interagir com os endpoints.
Exemplo da documentação dos endpoints API, acessível em swagger/.
❗ Api Publica (autenticação pendênte) ❗
python manage.py testCobertura de Teste com coverage
pip install coverage
coverage run manage.py test
coverage report #Exibir no Terminal
coverage html #Gerar Detalhes em Html
google-chrome htmlcov/index.html #Abrir relatório no Google chromeName Stmts Miss Cover
-------------------------------------------------------------------
api/__init__.py 0 0 100%
api/api_docs.py 8 0 100%
api/apps.py 4 0 100%
api/migrations/__init__.py 0 0 100%
api/serializers.py 25 0 100%
api/tests/__init__.py 0 0 100%
api/tests/test_comunicado.py 100 0 100%
api/tests/test_cultura.py 61 0 100%
api/tests/test_serializer.py 18 0 100%
api/urls.py 7 0 100%
api/views.py 14 0 100%
conta/__init__.py 0 0 100%
conta/admin.py 1 0 100%
conta/apps.py 4 0 100%
conta/forms.py 11 0 100%
conta/migrations/__init__.py 0 0 100%
conta/models.py 1 0 100%
conta/tests/__init__.py 0 0 100%
conta/tests/tests_view.py 27 0 100%
conta/urls.py 3 0 100%
conta/views.py 23 0 100%
core/__init__.py 0 0 100%
core/settings.py 31 0 100%
core/urls.py 7 0 100%
proagro/__init__.py 0 0 100%
proagro/admin.py 3 0 100%
proagro/apps.py 4 0 100%
proagro/forms.py 8 0 100%
proagro/migrations/0001_initial.py 9 0 100%
proagro/migrations/0002_alter_cultura_nome.py 4 0 100%
proagro/migrations/__init__.py 0 0 100%
proagro/models.py 49 0 100%
proagro/templatetags/__init__.py 0 0 100%
proagro/templatetags/urlparams.py 11 0 100%
proagro/tests/__init__.py 0 0 100%
proagro/tests/test_form.py 66 0 100%
proagro/tests/test_model.py 51 0 100%
proagro/tests/test_view.py 104 0 100%
proagro/urls.py 4 0 100%
proagro/util_proagro.py 15 0 100%
proagro/views.py 58 0 100%
-------------------------------------------------------------------
TOTAL 731 0 100%