InfraPlus - Gestão de Infraestrutura Hídrica

[richaferreira]

Select Topic Area

Question

Feature Area

Issues

Body

💧 InfraPlus - Gestão de Infraestrutura Hídrica - Projeto Acadêmico.

📌 Sobre o Projeto
O InfraPlus é uma plataforma web desenvolvida para otimizar o reporte e a gestão de problemas relacionados à rede de água (vazamentos, falta de abastecimento, manutenção). O objetivo é conectar o cidadão aos órgãos responsáveis de forma ágil, permitindo um monitoramento eficiente da infraestrutura urbana.

Important

Diferencial Técnico: O projeto utiliza uma arquitetura baseada em Camadas e Repositórios, separando rigorosamente as responsabilidades (SOC) e facilitando a manutenção e a escalabilidade do software.

🚀 Funcionalidades Principais
✅ Reporte com Anexos: Registro de problemas com localização e múltiplos uploads de fotos.
✅ Painel Administrativo: Gestão centralizada de chamados com filtros avançados e paginação.
✅ Comentários Automáticos: Logs de interação identificando automaticamente o usuário logado.
✅ Notificações: Sistema de e-mail integrado para atualizações de status em tempo real.

📂 Estrutura do Projeto
A organização do projeto segue o padrão MVC (Model-View-Controller) aliado ao Repository Pattern:

InfraPlus_AguasSeguras/
├─ backend/app/
│ ├─ blueprints/ # Rotas divididas por contexto (Admin, Auth, Public)
│ ├─ models/ # Definição das tabelas (SQLAlchemy)
│ ├─ services/ # Lógica de negócio e notificações
│ ├─ repositories/ # Consultas ao banco, filtros e paginação
│ └─ forms/ # Validações de formulários (WTForms)
├─ frontend/
│ ├─ templates/ # Páginas HTML (Jinja2)
│ └─ static/ # CSS, JS e diretório de Uploads
└─ run.py # Ponto de entrada da aplicação
🛠️ Tecnologias Utilizadas

Linguagem: Python 3.x

Framework Web: Flask

Banco de Dados: SQLite (Desenvolvimento) / Suporte a PostgreSQL e MySQL

Segurança: Variáveis de ambiente (.env) e validação rigorosa de e-mails.

🔧 Como Rodar o Projeto

Criar ambiente virtual

python -m venv .venv

Ativar ambiente

source .venv/bin/activate # Linux/macOS
..venv\Scripts\Activate.ps1 # Windows
Instalação e Configuração
pip install -r requirements.txt
cp .env.example .env
Execução
python run.py
Acesse: http://127.0.0.1:5000/ | Admin Seed: admin@infra.plus / Senha: 123

⚙️ Configuração (.env)

Variável,Descrição
SECRET_KEY,Chave de segurança para criptografia de sessões.
DATABASE_URL,String de conexão com o banco de dados.
MAIL_SERVER,Servidor SMTP para envio de notificações.
🗺️ Roadmap de Evolução

[ ] Alembic: Implementar migrações de banco de dados.

[ ] Testes Unitários: Adicionar cobertura com pytest.

[ ] Geocodificação: Integrar API para converter endereços em coordenadas reais.

[ ] Docker: Criar ambiente de containerização para deploy.💧 InfraPlus - Gestão de Infraestrutura Hídrica - Projeto Acadêmico.

📌 Sobre o Projeto
O InfraPlus é uma plataforma web desenvolvida para otimizar o reporte e a gestão de problemas relacionados à rede de água (vazamentos, falta de abastecimento, manutenção). O objetivo é conectar o cidadão aos órgãos responsáveis de forma ágil, permitindo um monitoramento eficiente da infraestrutura urbana.

Important

Diferencial Técnico: O projeto utiliza uma arquitetura baseada em Camadas e Repositórios, separando rigorosamente as responsabilidades (SOC) e facilitando a manutenção e a escalabilidade do software.

🚀 Funcionalidades Principais
✅ Reporte com Anexos: Registro de problemas com localização e múltiplos uploads de fotos.
✅ Painel Administrativo: Gestão centralizada de chamados com filtros avançados e paginação.
✅ Comentários Automáticos: Logs de interação identificando automaticamente o usuário logado.
✅ Notificações: Sistema de e-mail integrado para atualizações de status em tempo real.

📂 Estrutura do Projeto
A organização do projeto segue o padrão MVC (Model-View-Controller) aliado ao Repository Pattern:

InfraPlus_AguasSeguras/
├─ backend/app/
│ ├─ blueprints/ # Rotas divididas por contexto (Admin, Auth, Public)
│ ├─ models/ # Definição das tabelas (SQLAlchemy)
│ ├─ services/ # Lógica de negócio e notificações
│ ├─ repositories/ # Consultas ao banco, filtros e paginação
│ └─ forms/ # Validações de formulários (WTForms)
├─ frontend/
│ ├─ templates/ # Páginas HTML (Jinja2)
│ └─ static/ # CSS, JS e diretório de Uploads
└─ run.py # Ponto de entrada da aplicação
🛠️ Tecnologias Utilizadas

Linguagem: Python 3.x

Framework Web: Flask

Banco de Dados: SQLite (Desenvolvimento) / Suporte a PostgreSQL e MySQL

Segurança: Variáveis de ambiente (.env) e validação rigorosa de e-mails.

🔧 Como Rodar o Projeto

Criar ambiente virtual

python -m venv .venv

Ativar ambiente

source .venv/bin/activate # Linux/macOS
..venv\Scripts\Activate.ps1 # Windows
Instalação e Configuração
pip install -r requirements.txt
cp .env.example .env
Execução
python run.py
Acesse: http://127.0.0.1:5000/ | Admin Seed: admin@infra.plus / Senha: 123

⚙️ Configuração (.env)

Variável,Descrição
SECRET_KEY,Chave de segurança para criptografia de sessões.
DATABASE_URL,String de conexão com o banco de dados.
MAIL_SERVER,Servidor SMTP para envio de notificações.
🗺️ Roadmap de Evolução

[ ] Alembic: Implementar migrações de banco de dados.

[ ] Testes Unitários: Adicionar cobertura com pytest.

[ ] Geocodificação: Integrar API para converter endereços em coordenadas reais.

[ ] Docker: Criar ambiente de containerização para deploy.

Guidelines

• I have read the above statement and can confirm my post is relevant to the GitHub feature areas Issues and/or Projects.

[luckyyyroyyy]

O InfraPlus é uma plataforma web desenvolvida em Flask para facilitar o reporte e a gestão de problemas na rede de abastecimento de água, conectando cidadãos aos órgãos responsáveis de forma ágil e organizada. O projeto se destaca pela adoção de uma arquitetura em camadas com Repository Pattern e padrão MVC, garantindo separação clara de responsabilidades, melhor manutenção e escalabilidade. Entre as funcionalidades estão o registro de ocorrências com anexos e localização, painel administrativo com filtros e paginação, comentários automáticos vinculados ao usuário logado e notificações por e-mail em tempo real. A estrutura do sistema divide rotas por contexto, lógica de negócio, consultas ao banco e validações de formulário, utilizando Python, Flask, SQLAlchemy e variáveis de ambiente para segurança, com suporte a múltiplos bancos de dados e um roadmap que inclui migrações com Alembic, testes com pytest, geocodificação e containerização com Docker.