Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jonasaacampos/produtor-django
Sistema de cadastro e monitoramento de fazendas | Docker, Django, Python, AWS, PostgreSql
https://github.com/jonasaacampos/produtor-django
aws django docker postgresql python3
Last synced: 23 days ago
JSON representation
Sistema de cadastro e monitoramento de fazendas | Docker, Django, Python, AWS, PostgreSql
- Host: GitHub
- URL: https://github.com/jonasaacampos/produtor-django
- Owner: jonasaacampos
- Created: 2024-10-18T12:05:07.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2024-10-21T18:59:00.000Z (24 days ago)
- Last Synced: 2024-10-21T23:54:42.300Z (24 days ago)
- Topics: aws, django, docker, postgresql, python3
- Language: Python
- Homepage: http://34.207.220.87:8000/
- Size: 22.4 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
Brain Farms
Fazendas inteligentes
> Cadastro de produtores rurais, com dashboards e listagem de cadastros gerados em tempo real.
>
> O projeto foi desenvolvido em python ([prova de conceito](https://github.com/jonasaacampos/cadastro-produtor-rural)) e django foi utilizado como framework web para produção.
>
> Foram escritos testes unitários, e criado configurações de infraestrutura para a execução em containers **docker**. Os containeres foram disponbilizado publicamente no dockerhub ([aplicação](https://hub.docker.com/repository/docker/jaacampos/produtor-django-web/general)) e ([banco de dados PostgreSql](https://hub.docker.com/repository/docker/jaacampos/produtor-django-web-psql/general)).
>
> Foi criado um repositório privado na AWS (Elastic Container Register), e criado um script de automação para criação e upload dos contâineres
>
> O **deploy** foi realizado em uma instância EC2 da AWS, sendo executado em imagens docker.
-------------
Índice
- [Obtendo o projeto](#obtendo-o-projeto)
- [Popular Banco de dados](#popular-banco-de-dados)
- [Demo](#demo)
- [Visão Geral](#visão-geral)
- [Mobile view admin](#mobile-view-admin)
- [Filtros e listagens](#filtros-e-listagens)
- [Checklist de Implementação](#checklist-de-implementação)
- [Cadastro de Produtor Rural](#cadastro-de-produtor-rural)
- [Requisitos de Negócio](#requisitos-de-negócio)
- [Dashboard](#dashboard)
- [Requisitos Técnicos](#requisitos-técnicos)
- [Front-end](#front-end)
- [Back-end](#back-end)
- [Desejável](#desejável)
- [Contato](#contato)
## Obtendo o projeto
Baixe este reposiório `https://github.com/jonasaacampos/produtor-django`
**Execução Local (branch dev)**
- [ ] Crie um ambiente virtual python (No vs code, [faça isso](https://gist.github.com/jonasaacampos/b53a591b67321c1896d684178ca5fc2c))
- [ ] Instale as dependências `pip install -r requirements.txt`
- [ ] Inicie o banco de dados `python manage.py migrate`
- [ ] Crie o superusuário `python manage.py createsuperuser`
**Execução em container (branch main)**
- [ ] Gere as imagens e execute o container `docker-compose up -d`
- [ ] Acesse o container `docker-compose exec web bash` (IDE WEB) ou `docker-compose exec bash`
- [ ] Inicie o banco de dados `python manage.py migrate`
- [ ] Crie o superusuário `python manage.py createsuperuser`
- [ ] Saia do container `exit`
**testes**
- Execute os testes com o comando `python manage.py test `
### Popular Banco de dados
Para preencher a aplicação com dados aleatórios, execute o script `fake_data_gen.py` na raiz do projeto.
Por padrão são geradas 10 inserções de usuário e 10 Inserções de Fazenda.
-----
## Demo
Veja ao vivo clicando **[aqui](http://34.207.220.87:8000)**
| Usuário | Senha |
|---------------|-----------|
| brainfarmer | teste1234 |
### Visão Geral
Demonstração tela inicial (clique para expandir)
### Mobile view admin
Demonstração celular | cadastros (clique para expandir)
### Filtros e listagens
Demonstração filtro de cadstro | Listagem (clique para expandir)
----------------
## Checklist de Implementação
Requisitos
### Cadastro de Produtor Rural
- [x] Implementar cadastro de produtor rural com os seguintes campos:
- [x] CPF ou CNPJ
- [x] Nome do produtor
- [x] Nome da Fazenda
- [x] Cidade
- [x] Estado
- [x] Área total em hectares da fazenda
- [x] Área agricultável em hectares
- [x] Área de vegetação em hectares
- [x] Culturas plantadas (Soja, Milho, Algodão, Café, Cana de Açucar)
### Requisitos de Negócio
- [x] Possibilidade de cadastrar produtores rurais
- [x] Possibilidade de editar produtores rurais
- [x] Possibilidade de excluir produtores rurais
- [x] Validação de CPF e CNPJ digitados incorretamente
- [x] Validação para garantir que a soma de área agricultável e vegetação não seja maior que a área total da fazenda
- [x] Permitir que cada produtor plante mais de uma cultura em sua fazenda
### Dashboard
- [x] Exibir total de fazendas em quantidade
- [x] Exibir total de fazendas em hectares (área total)
- [x] Gráfico de pizza por estado
- [x] Gráfico de pizza por cultura
- [x] Gráfico de pizza por uso de solo (Área agricultável e vegetação)
## Requisitos Técnicos
### Front-end
- [x] Utilizar Python
- [x] Criar pelo menos um teste unitário por componente (Opcional)
- [x] Criação das estruturas de dados "mockados"
### Back-end
- [x] Salvar os dados em um banco de dados Postgres
- [ ] Implementar endpoints para:
- [ ] Cadastrar produtores rurais
- [ ] Editar produtores rurais
- [ ] Excluir produtores rurais
- [x] Retornar os totais para o dashboard
- [x] Criação das estruturas de dados "mockados"
## Desejável
- [x] Aplicar conceitos como SOLID, KISS, Clean Code, API Contracts, Tests, Layered Architecture
Funcionalidades Futuras
- [ ] Endpoints para interação com a aplicação
- [ ] Configuração de repositório para `Continous Integraion - CI`
- [ ] Inserção de gráficos dinâmicos dentro para o dashboard
- [x] Atualização de relatórios estáticos de forma assíncrona
-----
## Contato
**Author:** Jonas Araujo de Avila Campos
-----