8000 GitHub - Kawa-Vinicius-Dev/Denguinho-V2: App para casais acompanharem objetivos e desafios, com placar e agenda. Backend Java/Spring Boot. · GitHub
[go: up one dir, main page]

Skip to content

About

App para casais acompanharem objetivos e desafios, com placar e agenda. Backend Java/Spring Boot.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

27 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Denguinho V2

O Denguinho V2 é uma aplicação privada para casais acompanharem objetivos, cumprirem desafios e manterem uma competição leve e saudável.

O projeto está sendo reconstruído com foco em Java e Spring Boot, transformando a primeira versão em uma aplicação mais completa e organizada para portfólio.

Status: MVP funcional, em evolução. Desafios, placar, agenda, pedidos de dengo e foco em dupla já funcionam de ponta a ponta; os itens de "Funcionalidades futuras" ainda não foram implementados.

Objetivo

Criar um ambiente exclusivo para duas pessoas que una relacionamento, organização e motivação. Cada pessoa poderá acompanhar seu próprio desempenho, participar de missões em dupla e visualizar a evolução do casal ao longo do tempo.

O Denguinho não terá desafios diários. A dinâmica será baseada apenas em:

  • desafios semanais;
  • desafios mensais;
  • missões individuais;
  • disputas competitivas;
  • missões realizadas em dupla.

MVP

A versão atual entrega:

  • cadastro e autenticação do casal;
  • criação de desafios semanais e mensais;
  • definição de participante, categoria, prazo e pontuação;
  • registro da conclusão dos desafios;
  • placar entre os participantes;
  • acompanhamento do progresso individual e conjunto;
  • histórico dos desafios;
  • definição do vencedor da semana e do mês;
  • dashboard com o card Nossa Jornada.

Categorias dos desafios

  • Estudos
  • Trabalho
  • Projetos
  • Saúde
  • Organização
  • Finanças
  • Relacionamento
  • Lazer
  • Outros

Além do MVP, já funcionam:

  • Preciso de um Dengo: pedido rápido de atenção ou apoio, respondido pela outra pessoa, e "energia" enviada para os desafios dela;
  • Foco juntos: sessões de 15, 25 ou 45 minutos em que cada minuto concluído soma um ponto para o casal.

Como funcionam os desafios

  • Cada desafio é semanal (segunda a domingo) ou mensal e tem uma meta de 1 a 20 avanços por período.
  • O progresso recomeça a cada período, contado no fuso do casal (APP_TIME_ZONE, padrão America/Sao_Paulo). Os últimos quatro períodos ficam no histórico.
  • Desafios individuais valem 25 pontos por avanço e só quem os criou registra avanços; desafios em casal valem 40 pontos e os dois avançam.
  • Um avanço do período atual pode ser desfeito por quem o registrou. Excluir um desafio o tira da lista, mas mantém os pontos no placar.
  • O placar mostra os pontos do mês e da semana; pontos de desafios em casal e de sessões de foco vão para o casal.

Funcionalidades futuras

Após o MVP, o projeto poderá receber:

  • Modo Foco Juntos em tempo real: sessões sincronizadas entre os dois aparelhos;
  • Modo Retomada: espaço para o casal se reorganizar após um período difícil;
  • mural privado com mensagens e registros;
  • recompensas definidas pelo casal;
  • surpresas semanais e mensais;
  • retrospectiva mensal da evolução do casal.

Esses recursos fazem parte do planejamento e ainda não devem ser considerados implementados.

Tecnologias planejadas

Backend

  • Java 21
  • Spring Boot
  • Spring Data JPA
  • Spring Security
  • JWT
  • PostgreSQL
  • Flyway
  • Maven
  • Swagger / OpenAPI
  • JUnit e Mockito

Frontend

  • React
  • Vite
  • interface responsiva e mobile-first
  • integração com API REST
  • instalável como app no celular (PWA)

Roadmap

  • Definir regras do domínio e estrutura do banco de dados
  • Criar o backend com Java e Spring Boot
  • Implementar autenticação e vínculo do casal
  • Implementar desafios semanais e mensais
  • Criar pontuação, placar e histórico
  • Desenvolver o dashboard principal
  • Integrar frontend e API
  • Adicionar testes automatizados
  • Documentar a API
  • Preparar demonstração do projeto

App no celular

O Denguinho é um PWA: dá para instalar no iPhone e no Android direto do site, sem loja de aplicativos. Instalado, ele ganha ícone próprio, abre em tela cheia e co 8250 ntinua abrindo mesmo sem internet (os dados do casal aparecem de novo quando a conexão volta).

  • Android (Chrome, Edge, Samsung Internet): o próprio app mostra o botão Instalar o app no início. Também dá para usar o menu do navegador → Instalar app.
  • iPhone e iPad (Safari): toque em Compartilhar → Adicionar à Tela de Início. O app do iPhone não usa o login do Safari, então é preciso entrar uma vez dentro dele.

Os passos também ficam em Mais → Instalar o app e em Configurações → Aplicativo. Instale sempre pelo domínio oficial do site: a API só aceita o endereço configurado em APP_CORS_ALLOWED_ORIGINS.

Por dentro:

  • frontend/public/manifest.webmanifest e os ícones em frontend/public/icons (inclusive os adaptáveis do Android) descrevem o app;
  • frontend/pwa/vitePlugin.js gera o sw.js a cada build, com a lista de arquivos do deploy e uma versão calculada a partir do conteúdo deles;
  • o service worker busca as páginas primeiro na rede (sempre a versão mais nova) e usa o HTML guardado quando não há conexão; arquivos com hash no nome vêm do cache. Chamadas para a API nunca passam por ele;
  • quando sai um deploy novo com o app aberto, aparece o aviso Chegou uma versão nova do Denguinho com o botão Atualizar.

Como executar

Pré-requisitos: Java 21, Node 22 e Docker (para o PostgreSQL local).

cp .env.example .env            # ajuste os valores locais
docker compose up -d postgres   # banco em localhost:5432

cd backend
DB_URL=jdbc:postgresql://localhost:5432/denguinho DB_USERNAME=denguinho \
DB_PASSWORD=change-me-locally JWT_SECRET=um-segredo-local-com-pelo-menos-32-caracteres \
./mvnw spring-boot:run          # API em http://localhost:8080/api

cd ../frontend
npm install
npm run dev                     # http://localhost:5173, usando a API local

Para ver a interface sem backend, use npm run dev:demo: o modo apresentação guarda tudo no navegador e simula a outra pessoa da dupla.

A documentação interativa da API fica em http://localhost:8080/swagger-ui.html.

Testes

cd backend && ./mvnw test        # unitários, controller e integração (H2)
cd frontend && npm test          # regras de datas, desafios, notificações e PWA
cd frontend && npm run lint
cd frontend && npm run test:e2e  # Playwright no modo apresentação e no build de produção

Supabase

O banco de produção está no projeto Denguinho V2, na região de São Paulo. O backend usa o Session Pooler com SSL e mantém o esquema exclusivamente pelas migrations do Flyway. A Data API do Supabase permanece desativada porque o frontend conversa apenas com a API Spring Boot.

Configure no ambiente do backend:

  • DB_URL: URL JDBC do Session Pooler indicada em .env.example.
  • DB_USERNAME: usuário do pool indicado em .env.example.
  • DB_PASSWORD: senha do banco, armazenada somente como segredo do ambiente.
  • JWT_SECRET: segredo aleatório com pelo menos 32 caracteres.
  • APP_CORS_ALLOWED_ORIGINS: domínio público do frontend.
  • APP_TIME_ZONE (opcional): fuso usado para fechar semanas e meses dos desafios. Padrão America/Sao_Paulo.

O pool do backend usa no máximo cinco conexões por padrão, adequado ao compute nano. Esse valor pode ser ajustado por DB_POOL_MAX_SIZE.

Projetos gratuitos do Supabase são pausados depois de alguns dias sem uso, e aí a API não consegue iniciar (a Vercel responde FUNCTION_INVOCATION_FAILED). Para evitar isso, backend/vercel.json agenda um cron diário (12h UTC) que chama /actuator/health, e essa verificação consulta o banco. Se o projeto já estiver pausado, reative-o no painel do Supabase (Restore project).

Segurança

Segredos, tokens e fotos pessoais não são versionados. As fotos privadas ficam no PostgreSQL do Supabase e só são entregues pela API autenticada. A imagem pública é um fallback genérico.

Versão anterior

A primeira versão do Denguinho permanece disponível para registrar a evolução do projeto:

Denguinho - versão original

Autor

Desenvolvido por Kawã Vinicius.

About

App para casais acompanharem objetivos e desafios, com placar e agenda. Backend Java/Spring Boot.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0