🧠🥗 NutriMente

Tecnologia para conectar cuidado psicológico, alimentação e pessoas.

O NutriMente é uma plataforma Web desenvolvida como Projeto Semestral Universitário do curso superior de Desenvolvimento de Software Multiplataforma (DSM) da FATEC Luigi Papaiz.

A proposta é aproximar profissionais de Psicologia e Nutrição de seus clientes em um único ambiente digital, oferecendo ferramentas para acompanhamento, comunicação, consultas e gerenciamento de planos personalizados.

---

✦ Sobre o projeto

O NutriMente nasceu da ideia de integrar duas áreas que frequentemente se encontram no cotidiano: saúde mental e alimentação.

A plataforma foi projetada para proporcionar uma experiência mais personalizada e organizada tanto para clientes quanto para profissionais.

Em vez de tratar consulta, acompanhamento e comunicação como partes isoladas, o sistema busca reunir essas experiências em um único ecossistema.

             NUTRIMENTE
                  │
       ┌──────────┴──────────┐
       │                     │
   🧠 Psicologia         🥗 Nutrição
       │                     │
       └──────────┬──────────┘
                  │
            👤 Cliente
                  │
          ┌───────┴───────┐
          │               │
      Acompanhamento   Comunicação
          │               │
          └───────┬───────┘
                  │
             📈 Progresso

---

🌱 Objetivos de Desenvolvimento Sustentável

O projeto está alinhado aos Objetivos de Desenvolvimento Sustentável (ODS) da Organização das Nações Unidas.

ODS 3 • Saúde e Bem-Estar

Promover saúde e bem-estar, contribuindo para ampliar o acesso a serviços relacionados à saúde mental e nutricional.

ODS 16 • Paz, Justiça e Instituições Eficazes

Aplicar princípios de segurança, privacidade e conformidade legal no desenvolvimento da plataforma, especialmente em relação à proteção de dados.

🔐 O projeto também considera a Lei Geral de Proteção de Dados (LGPD), Lei nº 13.709/2018, como parte dos requisitos de segurança e privacidade da aplicação.

---

✧ Funcionalidades

O NutriMente foi planejado a partir de diferentes necessidades de clientes e profissionais.

Seus recursos futuros serão:

📅 Gestão de consultas e agenda

• Agendamento de consultas
• Reagendamento e cancelamento
• Visualização da agenda
• Consultas online por videoconferência
• Definição de horários disponíveis
• Definição de valores das consultas

🔎 Perfis e busca de profissionais

• Cadastro de clientes
• Cadastro de profissionais
• Perfis profissionais personalizados
• Verificação de documentação profissional
• Busca por especialidade
• Filtros por preço
• Informações profissionais e áreas de atuação

🎯 Plano de ação personalizado

• Criação de planos personalizados
• Rotinas alimentares
• Definição de metas
• Checklists de acompanhamento
• Registro de progresso
• Acompanhamento periódico

💬 Comunicação e engajamento

• Chat interno em tempo real
• Comunicação entre cliente e profissional
• Sistema de notificações
• Avaliação dos usuários
• Histórico de interações

💳 Gestão financeira e legal

• Carteira digital
• Pagamentos
• Solicitação de reembolso
• Histórico financeiro
• Gerenciamento de informações de pagamento
• Recursos relacionados à privacidade e proteção de dados

---

🛠️ Tecnologias

A arquitetura do projeto utiliza diferentes tecnologias para construir a aplicação de forma modular.

Front-end

Next.js + React + TypeScript

Responsável pela interface e experiência de interação dos usuários.

Back-end

Java + Spring Boot

Responsável pela API REST e pelas regras de negócio: cadastro, login, confirmação de e-mail, perfis e permissões por papel. Detalhes em backend/README.md.

Node.js

Serviço de logs (services/logs-service): recebe os logs da aplicação por HTTP e grava no MongoDB.

Banco de dados

SQL Server

Banco relacional com os dados da plataforma: usuários, consultas, planos de ação, chat e financeiro.

MongoDB

Banco não relacional usado para os logs: aplicação, acessos e trilha de auditoria da LGPD.

Docker

Sobe os bancos e o serviço de logs com um único comando, sem instalar nada além do Docker. Detalhes em database/README.md.

 Next.js (front) ──► API Java (Spring Boot) ──► SQL Server   (dados)
                              │
                              └──► logs-service (Node.js) ──► MongoDB   (logs)

---

🚀 Instalação e execução

📘 Primeira vez? Siga o guia completo, com requisitos de computador, instalação de cada programa e solução de problemas: docs/INSTALACAO.md. Abaixo está o resumo.

🎤 Apresentação: roteiro, contas da demonstração, checklist do dia e plano B em docs/APRESENTACAO.md.

🚀 Colocar no ar? Passo a passo de deploy num VPS da Hostinger, com domínio, HTTPS, e-mail e backups: docs/DEPLOY-HOSTINGER.md.

1. Pré-requisitos

Instale uma vez no seu computador:

Ferramenta	Versão	Para quê	Download
Git	qualquer recente	Baixar o código	https://git-scm.com/downloads
Node.js	20 ou superior (LTS)	Rodar o front-end	https://nodejs.org
Docker Desktop	qualquer recente	Rodar SQL Server, MongoDB e serviço de logs	https://www.docker.com/products/docker-desktop/

Para conferir se deu certo, abra um terminal e rode:

git --version
node --version
docker --version

Cada comando deve mostrar um número de versão. No Windows, o Docker Desktop pode pedir para ativar o WSL 2: aceite e reinicie o computador.

2. Baixar o projeto

git clone https://github.com/linsjulia/NutriMentee.git
cd NutriMentee

3. Configurar as variáveis de ambiente

Copie o arquivo de exemplo para criar o seu .env:

# Linux, macOS ou Git Bash
cp .env.example .env

# Windows (PowerShell)
Copy-Item .env.example .env

Abra o .env e troque as senhas. A senha do SQL Server precisa ter 8 ou mais caracteres, com maiúscula, minúscula, número e símbolo; se não tiver, o banco não liga.

🔐 O .env guarda senhas e nunca deve ser enviado ao GitHub. Ele já está no .gitignore.

4. Subir o back-end (bancos, API e serviços)

Com o Docker Desktop aberto, rode na pasta do projeto:

docker compose up -d --build

Na primeira vez ele baixa as imagens (alguns minutos). Depois, confira se está tudo no ar:

docker compose ps

Os cinco serviços (nutrimente-sqlserver, nutrimente-mongodb, nutrimente-logs-service, nutrimente-mailpit e nutrimente-api) devem aparecer como healthy ou running. Na primeira vez, a API espera o banco terminar de ser criado: pode levar 1 a 2 minutos.

O banco, as tabelas e os dados iniciais são criados automaticamente. Para ver o andamento:

docker compose logs -f sqlserver

Quando aparecer Banco de dados criado com sucesso, está pronto. Aperte Ctrl + C para sair dos logs (os containers continuam rodando).

5. Rodar o front-end

npm install
npm run dev

Acesse http://localhost:3000 no navegador.

6. Endereços locais

Serviço	Endereço
Front-end (Next.js)	http://localhost:3000
SQL Server	localhost,1433
MongoDB	mongodb://localhost:27017
Serviço de logs	http://localhost:4000/health
API Java	http://localhost:8080/actuator/health
E-mails de teste (Mailpit)	http://localhost:8025

7. Primeiro acesso

• Administrador: entre com ADMIN_EMAIL e ADMIN_PASSWORD do .env. Ele aprova os profissionais.
• Cadastro: os e-mails de confirmação não vão para a sua caixa de entrada; abra o Mailpit (http://localhost:8025) e clique no link.
• As rotas da API e as regras de cada papel estão em backend/README.md.
• O mapa de papéis e fluxos (paciente, profissional, admin) está em docs/PAPEIS-E-FLUXOS.md (branch do front).

Comandos do dia a dia

Comando	O que faz
npm run dev	Roda o front-end em modo de desenvolvimento
npm run build e npm start	Gera e roda a versão de produção do front
npm run lint	Procura problemas no código
docker compose up -d	Liga os bancos
docker compose down	Desliga os bancos (os dados continuam salvos)
docker compose down -v	Desliga e apaga os dados; na próxima subida tudo é recriado do zero
cd database/tests && npm test	Roda os testes de integração dos bancos (containers ligados; npm install na 1ª vez)
cd services/logs-service && npm test	Roda os testes de integração do serviço de logs (containers ligados; npm install na 1ª vez)
npm run test:e2e	Testes do front no navegador: fluxos completos (precisa do docker compose no ar) e auditoria de acessibilidade. Na 1ª vez: npx playwright install chromium
docker compose logs -f api	Acompanha os logs da API Java
docker compose up -d --build api	Recompila e reinicia a API depois de mudar o código Java

Problemas comuns

Sintoma	Solução
error during connect ou cannot find the file specified	O Docker Desktop não está aberto. Abra e espere o ícone ficar verde.
port is already allocated	A porta já está em uso (ex.: um SQL Server instalado no PC). Mude a porta correspondente no .env (MSSQL_PORT, MONGO_PORT, LOGS_SERVICE_PORT, API_PORT, MAILPIT_UI_PORT).
nutrimente-sqlserver reiniciando sem parar	A senha MSSQL_SA_PASSWORD é fraca. Troque no .env e rode docker compose down -v e depois docker compose up -d --build.
nutrimente-api reiniciando sem parar	Veja o motivo com docker compose logs api. O mais comum é JWT_SECRET vazio ou com menos de 32 caracteres.
Alterei um script .sql e nada mudou	Os scripts só rodam na criação do banco. Rode docker compose down -v e suba de novo (apaga os dados locais).

Fluxo de contribuição

Nunca envie alterações direto para a main. Crie uma branch para cada mudança:

git switch main
git pull
git switch -c feature/nome-da-funcionalidade   # ou fix/nome-do-bug
# ... faça as alterações ...
git add .
git commit -m "feat: descreve a mudança"
git push -u origin feature/nome-da-funcionalidade

Depois abra um Pull Request no GitHub para a equipe revisar antes de juntar na main.

Testes automáticos (CI): em cada Pull Request, o GitHub Actions roda sozinho o TypeScript, o lint e todos os testes (banco, serviço de logs, API Java e site no navegador), usando o mesmo docker compose do passo 4. O resultado aparece no próprio PR:

• ✅ verde: pode revisar e juntar;
• ❌ vermelho: clique em Details para ver qual teste falhou. Se for um teste do site, o relatório fica em Summary → Artifacts → playwright-resultados.

Antes de abrir o PR, atualize sua branch com a main (git pull origin main) para resolver eventuais conflitos na sua própria branch. A configuração fica em .github/workflows/ci.yml.

---

🎨 Design & Desenvolvimento

A experiência do usuário também faz parte da construção do NutriMente.

Ferramentas

Figma Prototipação e desenvolvimento da interface.

Inkscape Criação de elementos vetoriais e identidade visual.

Git & GitHub Versionamento, colaboração e gerenciamento do código-fonte.

Acessibilidade & Responsividade A interface é planejada para diferentes dispositivos e busca seguir boas práticas de acessibilidade e usabilidade.

---

👥 Equipe

Daivid da Silva Afonso

Gabriely Benito Monteiro

Helder Virissio Araujo

Julia Lins Pereira da Silva (Líder)

Vitor Antonio Romualdo

---

🎓 Orientadores

Lucio Nunes de Lira

Bruno Zolotareff dos Santos

Patricia Gallo

Luiz Antonio

Rafael Miranda

---

🧠 + 🥗 + 💻

NutriMente

Conectando tecnologia, cuidado e acompanhamento.

---

Desenvolvido como projeto acadêmico da FATEC Luigi Papaiz • DSM