81 lines
3.1 KiB
Markdown
81 lines
3.1 KiB
Markdown
# GuiaSenior - Web App para Idosos
|
|
|
|
O **GuiaSenior** é uma aplicação web desenvolvida em Java (Spring Boot) com foco em acessibilidade digital para a terceira idade. O objetivo é facilitar o acesso a sites governamentais e serviços de utilidade pública, além de educar sobre segurança digital contra golpes.
|
|
|
|
## 📱 Destaques e Funcionalidades
|
|
|
|
1. **Acessibilidade**:
|
|
* Botões grandes e de alto contraste.
|
|
* Textos claros e linguagem direta.
|
|
* Animações suaves para guiar o olhar do usuário.
|
|
|
|
2. **Sites Governamentais**:
|
|
* Acesso facilitado ao **Meu INSS**, **Gov.br**, **Receita Federal** e **Conecte SUS**.
|
|
* **Explicação Prévia**: Antes de enviar o idoso para o site oficial, uma tela explica exatamente o que é aquele serviço e como funciona.
|
|
|
|
3. **Utilidades (Luz e Água)**:
|
|
* Filtro por **Região** (Norte, Sul, Sudeste, etc.).
|
|
* Lista das principais concessionárias (Enel, Sabesp, Copel, etc.).
|
|
* Instruções de como tirar a 2ª via da conta.
|
|
|
|
4. **Segurança Digital**:
|
|
* Dicas específicas contra golpes no **WhatsApp**, **SMS** e **E-mail**.
|
|
* Orientações sobre senhas e verificação de duas etapas.
|
|
|
|
---
|
|
|
|
## 🛠️ Tecnologias Utilizadas
|
|
|
|
* **Java 17**: Linguagem principal.
|
|
* **Spring Boot 3.x**: Framework para criação da aplicação web.
|
|
* **Thymeleaf**: Motor de templates para gerar as páginas HTML no servidor.
|
|
* **CSS3**: Estilização com Flexbox/Grid e Animações (Keyframes).
|
|
* **Docker & Docker Compose**: Para empacotar e rodar a aplicação em qualquer lugar.
|
|
|
|
---
|
|
|
|
## 📂 Estrutura do Código
|
|
|
|
A estrutura do projeto segue o padrão MVC (Model-View-Controller) do Spring Boot:
|
|
|
|
```text
|
|
GuiaSeniorWeb/
|
|
├── src/main/java/com/example/guiasenior/
|
|
│ ├── GuiaSeniorApplication.java # Classe principal que inicia o Spring
|
|
│ └── HomeController.java # "Cérebro" do app. Contém os dados dos sites/dicas e as rotas.
|
|
│
|
|
├── src/main/resources/templates/ # Telas (HTML)
|
|
│ ├── home.html # Tela Inicial (Menu Principal)
|
|
│ ├── sites.html # Lista de sites do governo
|
|
│ ├── regions.html # Seleção de região (Luz e Água)
|
|
│ ├── site_detail.html # Tela de explicação detalhada de um site
|
|
│ └── safety_detail.html # Tela com lista de dicas de segurança
|
|
│
|
|
├── src/main/resources/static/css/
|
|
│ └── style.css # Cores, tamanhos de fonte e animações
|
|
│
|
|
├── Dockerfile # Receita para criar a imagem do sistema
|
|
└── docker-compose.yml # Comando único para rodar o sistema
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 Como Rodar o Projeto
|
|
|
|
É muito simples rodar o projeto usando Docker. Você não precisa instalar Java no seu computador, apenas o Docker.
|
|
|
|
1. Abra o terminal na pasta do projeto:
|
|
```bash
|
|
cd GuiaSeniorWeb
|
|
```
|
|
|
|
2. Execute o comando para construir e rodar:
|
|
```bash
|
|
docker-compose up --build
|
|
```
|
|
|
|
3. Aguarde aparecer a mensagem de que o aplicativo iniciou.
|
|
|
|
4. Abra seu navegador (Chrome, Firefox, etc.) e acesse:
|
|
👉 **http://localhost:8080**
|