🧠🥗 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:
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
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
