Projeto-Faculdade/GuiaSeniorWeb/README.md

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:

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:

   cd GuiaSeniorWeb
   

2. Execute o comando para construir e rodar:

   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