From 6bfb1cb811291a6c731dc7ebe6097b143ea78b00 Mon Sep 17 00:00:00 2001 From: "leonardo.santos" Date: Tue, 28 Jul 2026 11:39:04 -0300 Subject: [PATCH 1/4] feat: implement notification improvements p1 --- GEMINI.md | 85 ++++++++++++ docs/antigravity-cli-playbook.md | 67 +++++++++ docs/relatorio-seguranca-vm.md | 127 ++++++++++++++++++ .../contribution-reports.service.ts | 30 +++-- .../1785000000001-UpdateNotificationEntity.ts | 19 +++ ...785000000002-UpdateNotificationTypeEnum.ts | 21 +++ src/events/events.service.spec.ts | 8 ++ src/events/events.service.ts | 113 +++++++++++++--- ...gal-documents-notification-cron.service.ts | 2 + src/mail/mail-templates/mission-won.hbs | 57 ++++++++ .../mail-templates/submission-approved.hbs | 57 ++++++++ src/mail/mail.service.ts | 63 +++++++++ src/missions/missions.service.ts | 47 ++++++- .../domain/notification-type.enum.ts | 2 + .../entities/notification.entity.ts | 6 + src/notifications/notifications.controller.ts | 18 ++- src/notifications/notifications.service.ts | 28 +++- src/submissions/submissions.service.spec.ts | 5 + src/submissions/submissions.service.ts | 100 ++++++++++++-- src/track-items/track-items.service.ts | 26 +++- 20 files changed, 815 insertions(+), 66 deletions(-) create mode 100644 GEMINI.md create mode 100644 docs/antigravity-cli-playbook.md create mode 100644 docs/relatorio-seguranca-vm.md create mode 100644 src/database/migrations/1785000000001-UpdateNotificationEntity.ts create mode 100644 src/database/migrations/1785000000002-UpdateNotificationTypeEnum.ts create mode 100644 src/mail/mail-templates/mission-won.hbs create mode 100644 src/mail/mail-templates/submission-approved.hbs diff --git a/GEMINI.md b/GEMINI.md new file mode 100644 index 0000000..5cdbb4b --- /dev/null +++ b/GEMINI.md @@ -0,0 +1,85 @@ +# api-engajamento — guia para agentes de IA (Gemini CLI) + +Backend NestJS + TypeORM + Postgres (Neon), deploy automático via GitHub Actions +pra uma VM Oracle. Repo remoto real: `devs-tocantins/api-legado-dev` (o remote +`origin` local ainda aponta pra `api-engajamento`, o GitHub redireciona). + +## Antes de mexer em qualquer coisa + +- **`.env`/`.env.prod` locais apontam pro Neon/R2 de PRODUÇÃO de verdade.** + Rodar o servidor local (`npm run start:dev`) é seguro pra LEITURA. Nunca rode + uma migration, um comando destrutivo, ou qualquer escrita gerada por você + sem confirmar com o usuário antes — não existe banco de teste separado aqui. +- CRLF/autocrlf: arquivos no working tree às vezes aparecem como "modified" + por causa de `core.autocrlf=true` no Windows, sem diff real nenhum (`git diff` + mostra warning de CRLF mas zero conteúdo mudado). Antes de commitar, rode + `npx eslint "{src,apps,libs,test}/**/*.ts" --fix` pra normalizar — senão o + hook de pre-commit (que roda lint no repo INTEIRO) falha com centenas de + erros de formatação que não têm nada a ver com sua mudança. + +## Branch `main` é protegida — nada de push direto + +`git push origin main` é rejeitado (`GH013: Repository rule violations`). +Fluxo obrigatório: + +``` +git checkout -b fix/nome-descritivo +# ... mudanças ... +git add # nunca `git add -A`/`git add .` sem checar antes +git commit -m "..." +git push -u origin fix/nome-descritivo +gh pr create --title "..." --body "..." +``` + +Depois espere a CI (workflow "NestJS API CI", job `build` + "SonarCloud Code +Analysis") ficar verde: + +``` +gh pr checks +``` + +Só então mescle: + +``` +gh pr merge --merge --delete-branch +``` + +**Nunca faça `git push --force`, `git reset --hard`, ou pule hooks +(`--no-verify`) sem autorização explícita do usuário no chat.** + +## O que acontece depois do merge (deploy automático) + +Merge em `main` dispara o job `deploy` (`.github/workflows/docker-e2e.yml`): +builda a imagem Docker, manda via `rsync` pra VM Oracle (`136.248.75.34`), faz +`docker compose down && up -d` lá dentro, e checa `https://136.248.75.34.nip.io/healthz`. + +- O job `deploy` tem um `concurrency: group: production-deploy, cancel-in-progress: false` + (adicionado em 2026-07 pra evitar dois deploys simultâneos brigando pela + mesma VM — se dois merges acontecerem em sequência rápida, o segundo + deploy ENFILEIRA, não roda em paralelo). +- Pra checar se a API está no ar agora, sem precisar SSH: `curl -sk https://136.248.75.34.nip.io/healthz` → deve responder `{"status":"ok"}`. +- Pra ver o histórico de runs: `gh run list --branch main --limit 10`. +- Pra investigar uma falha: `gh run view --log-failed`. + +## Testes e lint + +``` +npm run lint # eslint em src/apps/libs/test +npm run test # jest, 160+ specs +``` + +Ambos rodam automaticamente no `build` job da CI e no hook de pre-commit local +(husky) — não pule. + +## Se te pedirem pra "corrigir" algo sozinho + +1. Diagnostique a causa raiz antes de mexer (não aplique patch sem entender + o porquê — ver histórico de commits/PRs recentes com `gh pr list --state all` + e `git log` costuma dar contexto). +2. Faça a menor mudança que resolve, sem refatorações não pedidas. +3. Rode lint + test localmente antes de commitar. +4. Siga o fluxo de branch/PR acima — nunca commite direto em `main`. +5. Depois de abrir o PR, espere a CI e reporte o resultado (verde ou o que + falhou) antes de mesclar sozinho, a menos que o usuário já tenha + autorizado merge solo sem revisão humana (isso já foi autorizado + anteriormente nesta equipe, mas espere a CI mesmo assim). diff --git a/docs/antigravity-cli-playbook.md b/docs/antigravity-cli-playbook.md new file mode 100644 index 0000000..44aaf41 --- /dev/null +++ b/docs/antigravity-cli-playbook.md @@ -0,0 +1,67 @@ +# Antigravity CLI (`agy`) — Playbook de uso + +Este documento descreve, de forma genérica (sem detalhes deste projeto ou do GitHub), como usar o Antigravity CLI (`agy`) como um "executor" autônomo de tarefas de código, e as práticas que funcionaram bem ao operá-lo como um agente de codificação de longa duração dentro de um fluxo "arquiteto + executor". + +## O que é o `agy` + +O `agy` é uma CLI de codificação autônoma (Antigravity CLI) que recebe um prompt em texto e executa, sozinha, um ciclo completo de trabalho: ler o código, planejar, editar arquivos, rodar comandos (lint, build, testes), versionar (git) e, se instruída, interagir com um provedor de repositório remoto (abrir PR, checar CI). Ela roda em modo não interativo quando invocada corretamente, o que a torna adequada para ser disparada em background e monitorada até a conclusão. + +## Papéis: arquiteto vs. executor + +O padrão que funcionou bem foi dividir claramente as responsabilidades: + +- **Arquiteto (o assistente que orquestra)**: investiga o problema real, lê o código relevante, decide a causa raiz e o escopo exato da mudança, escreve um prompt autocontido e completo, dispara o `agy`, e — crucialmente — **revisa o resultado** (diff, testes, CI) antes de aceitar o trabalho como concluído. +- **Executor (`agy`)**: recebe o prompt já com o diagnóstico pronto, implementa, valida localmente (lint/build/test) e sobe o resultado (branch + commit + abertura de PR). + +Não delegar o diagnóstico. O prompt deve conter o "o quê" e o "porquê" já resolvidos — arquivo, linha, causa raiz, e o comportamento esperado depois da mudança. Delegar apenas "vá investigar e conserte" tende a produzir resultados genéricos ou com escopo errado. + +## Invocação básica + +Forma de comando que funcionou de forma confiável, disparada a partir de um shell: + +``` +agy --dangerously-skip-permissions --print-timeout 20m --add-dir "" -p "" +``` + +Pontos-chave sobre as flags: + +- `--dangerously-skip-permissions`: evita que a CLI pare pedindo confirmação interativa a cada ação (edição de arquivo, execução de comando). Necessário para rodar em modo não supervisionado/background. Use com consciência de que a ferramenta pode executar comandos e editar arquivos sem parar para perguntar — só vale a pena habilitar isso quando você (o operador humano) já decidiu confiar no escopo do prompt que está passando. +- `--print-timeout 20m`: aumenta o timeout de espera pela "impressão final" da CLI. O valor padrão (frequentemente ~5 minutos) é curto demais para tarefas que envolvem instalar dependências, rodar suites de teste completas, ou aguardar checks de CI remotos — a CLI pode terminar o trabalho real (commit, push, PR aberto) mas "morrer" antes de imprimir o resumo final se o timeout for baixo, dando a falsa impressão de que falhou. +- `--add-dir ""`: escopo o diretório de trabalho explicitamente. Evita ambiguidade sobre em qual repositório/pasta a CLI deve operar, especialmente quando você tem múltiplos repositórios lado a lado. +- `-p ""`: o prompt em si, deve ser autocontido (ver seção seguinte). + +### Rodando em background + +Como uma tarefa pode levar minutos a dezenas de minutos (dependendo de instalação de deps, build, testes, espera de CI), o padrão é disparar o comando em background e ser notificado quando ele terminar, em vez de bloquear esperando ou fazer polling manual. Isso libera o operador para continuar outras tarefas em paralelo ou simplesmente aguardar. + +## Como escrever um bom prompt + +O prompt é o artefato mais importante desse fluxo — a qualidade do resultado é quase proporcional à qualidade do prompt. Estrutura que funcionou bem: + +1. **Contexto do repositório**: tipo de projeto/stack, e onde estão as regras de trabalho do repositório (ex.: um arquivo de instruções na raiz do repo que documenta convenções de branch, PR, CI). Peça explicitamente para a CLI ler esse arquivo antes de agir. +2. **Diagnóstico já pronto**: explique a causa raiz do problema com referências exatas (arquivo:linha, nome de função/variável), não apenas o sintoma. Se há dois conceitos parecidos que podem ser confundidos (ex.: dois campos com nomes similares mas semânticas diferentes), explicite a diferença. +3. **Escopo exato da mudança**: liste especificamente quais arquivos/pontos devem mudar, e — igualmente importante — quais pontos parecidos **não devem** ser tocados (evita "correções" indevidas em código que já está certo por design). +4. **Ambiguidade → parar, não adivinhar**: inclua uma instrução explícita do tipo "se encontrar uma ambiguidade real, pare e descreva o problema em vez de adivinhar". Isso evita que a CLI tome decisões arquiteturais silenciosas fora do escopo pretendido. +5. **Critérios de validação local**: quais comandos rodar (lint, checagem de tipos, suíte de testes) e a expectativa de que não haja erros novos. +6. **Fluxo de versionamento e entrega**: nome de branch (ou padrão), commit, push, abertura de um pedido de revisão de código no sistema remoto. Ser explícito sobre **não finalizar/mesclar a mudança sozinha** — isso deve ficar sob controle do operador humano, que revisa o diff e o status de validação automatizada antes de aceitar. +7. **Definição de "pronto"**: peça para a CLI confirmar que a validação remota (build/CI) ficou verde antes de considerar a tarefa concluída, e não apenas que o push foi feito. + +Um prompt bem escrito é longo (parágrafos, não uma linha) e lê como um brief que um colega sênior daria a outro colega que acabou de entrar na sala — sem contexto prévio, mas com tudo que precisa para agir com julgamento, não só seguir passos mecânicos. + +## Disciplina operacional (antes de cada disparo) + +- **Sempre sincronizar o branch principal do repositório de trabalho imediatamente antes de cada novo disparo** (atualizar para o estado remoto mais recente). Pular esse passo pode fazer a CLI ramificar a partir de uma base desatualizada, criando conflitos de integração desnecessários mais tarde quando múltiplas tarefas paralelas tentam se juntar de volta ao branch principal. +- **Um disparo, um escopo coeso.** Evite empacotar múltiplas mudanças não relacionadas num único prompt — isso dificulta a revisão do diff resultante e aumenta o raio de dano se algo sair errado. +- **Revisar o diff manualmente antes de aceitar o resultado como concluído**, mesmo quando a CLI reporta sucesso. O relatório final da CLI descreve o que ela *pretendeu* fazer, não necessariamente prova de que fez exatamente e só isso — confira o diff real. + +## Padrões de erro observados e como mitigar + +- **Timeout de impressão baixo mascarando sucesso real**: a tarefa termina de verdade (commit/push/PR aberto) mas a CLI "morre" antes de reportar, parecendo falha. Mitigação: aumentar o timeout de impressão generosamente para tarefas longas; se um disparo retornar sem um resumo final claro, verificar manualmente o estado remoto (existe branch/commit/PR novo?) antes de assumir falha. +- **Bugs que só aparecem em validação completa/remota, não em lint/test local**: erros de caminho de import relativo incorreto, ou dependências circulares entre módulos, por exemplo, só foram pegos pela pipeline de build completa (rodando em um ambiente limpo), não pelo lint/test local que a própria CLI roda. Mitigação: sempre aguardar o resultado da validação remota completa antes de aceitar a tarefa como pronta, e estar preparado para corrigir manualmente esse tipo de bug de "integração" que ferramentas locais não capturam. +- **Ramificação a partir de base desatualizada**: gera conflitos de integração quando duas tarefas paralelas mexem no mesmo arquivo (por exemplo, ambas criando o mesmo arquivo novo de forma independente). Mitigação: já coberta acima (sincronizar antes de cada disparo); se ocorrer mesmo assim, resolver o conflito manualmente é geralmente mais rápido e seguro do que tentar re-disparar a tarefa do zero. +- **Colisão de numeração/nomenclatura em artefatos gerados por disparos paralelos** (ex.: dois arquivos de migração de banco de dados criados por duas tarefas diferentes recebendo o mesmo número sequencial): tende a acontecer quando múltiplas tarefas paralelas não têm visibilidade uma da outra no momento da geração. Mitigação: ao notar esse padrão, avisar explicitamente o próximo prompt sobre o valor já usado, para que a CLI escolha o próximo disponível. +- **Ruído de diff por diferença de terminador de linha (CRLF/LF)**, comum em ambiente Windows: pode fazer arquivos não tocados aparecerem como modificados. Mitigação: rodar uma ferramenta de formatação automática (linter com `--fix`) antes de cada commit e confirmar com um diff estatístico que não há mudança real de conteúdo antes de prosseguir. + +## Quando usar esse fluxo + +Funciona bem para tarefas de escopo bem definido e diagnosticável de antemão: correções de bug com causa raiz já identificada, adição de um campo/coluna com uso claro, troca mecânica de uma fonte de dados por outra em pontos específicos, etc. Não é o fluxo certo para explorar um problema ambíguo do zero — nesses casos, vale investigar primeiro (como arquiteto) até ter um diagnóstico e escopo claros, e só então escrever o prompt para o executor. diff --git a/docs/relatorio-seguranca-vm.md b/docs/relatorio-seguranca-vm.md new file mode 100644 index 0000000..bdbfa4d --- /dev/null +++ b/docs/relatorio-seguranca-vm.md @@ -0,0 +1,127 @@ +# Relatório de Segurança — VM Oracle (136.248.75.34) + +**Data da auditoria:** 2026-07-22 +**Escopo:** VM Ubuntu 24.04.4 LTS (Oracle Cloud) que hospeda a API em Docker + nginx. +**Método:** inspeção somente-leitura via SSH (portas, firewall, sshd, usuários, logs, nginx, TLS, Docker). + +--- + +## Resumo executivo + +A base está razoável — firewall UFW ativo com política default-deny, SSH só por chave, TLS válido (Let's Encrypt), atualizações de segurança automáticas ligadas. **Mas existem 3 brechas importantes**: + +1. 🔴 **A porta 3000 da API está exposta diretamente pra internet**, contornando o nginx e o UFW (o Docker fura o firewall). Qualquer um pode falar com a API sem passar pelo proxy/TLS. +2. 🔴 **~3.900 tentativas de invasão SSH nas últimas 24h e nenhum bloqueio automático** (fail2ban ausente). É ataque de força bruta contínuo — hoje inofensivo porque senha está desabilitada, mas é ruído, consumo de recurso e risco se algo mudar. +3. 🟠 **Reboot pendente com kernel novo** — a VM está de pé há 94 dias com patches de kernel aplicados mas não carregados. + +Nenhum sinal de comprometimento foi encontrado (logins históricos só do seu IP, 1 chave por usuário, Docker API não exposta). + +--- + +## Achados por nível de severidade + +### 🔴 CRÍTICO + +#### C1. Porta 3000 (API no container) aberta pra internet inteira + +- `docker-compose.prod.yaml` publica `"3000:3000"`, que vira `0.0.0.0:3000`. +- **O Docker insere regras iptables ANTES do UFW** — o UFW diz "só 22/80/443", mas a chain DOCKER aceita tráfego externo direto pro container (`ACCEPT tcp dpt:3000 → 172.18.0.2`). Confirmado no `iptables -L DOCKER`. +- Consequência: um atacante fala com o Node/NestJS **direto, sem TLS, sem nginx** — vaza a possibilidade de sniffing de tokens em trânsito, ignora qualquer proteção futura colocada no nginx (rate limit, WAF), e expõe a superfície do Express cru. +- **Correção (1 linha):** no compose, trocar `"3000:3000"` por `"127.0.0.1:3000:3000"`. O nginx continua funcionando (ele faz proxy pra `localhost:3000`) e a porta some da internet. + +#### C2. Força bruta SSH sem nenhum bloqueio automático + +- 3.894 falhas de autenticação em 24h, de dezenas de IPs (botnets varrendo a porta 22). +- `fail2ban` não está instalado. Cada bot pode tentar pra sempre. +- Hoje o risco real é baixo (senha desabilitada, só chave), mas: consome CPU/RAM numa VM de 1 GB, enche os logs, e se um dia alguém habilitar senha por engano, vira invasão em horas. +- **Correção:** instalar `fail2ban` (jail sshd, ban de 1h após 5 falhas). 5 minutos de trabalho. + +### 🟠 ALTO + +#### A1. Reboot pendente há muito tempo (kernel desatualizado em execução) + +- `/var/run/reboot-required` presente; uptime de 94 dias. Os patches de kernel foram baixados mas o kernel antigo continua rodando — vulnerabilidades de kernel corrigidas "no disco" seguem exploráveis "na memória". +- **Correção:** `sudo reboot` numa janela tranquila (downtime ~2–3 min; o container tem restart automático via compose). + +#### A2. Root ainda pode logar por SSH + +- `PermitRootLogin without-password` (default do Ubuntu) + existe uma chave em `/root/.ssh/authorized_keys` (com restrições `no-port-forwarding` etc., provavelmente da Oracle). Você nunca precisa logar como root — usa `ubuntu` + sudo. +- **Correção:** `PermitRootLogin no` no sshd_config. Reduz a superfície do alvo nº 1 dos bots (todo bot tenta `root` primeiro). + +#### A3. Sem rate limiting no nginx (camada de rede) + +- Nenhum `limit_req`/`limit_conn`. A aplicação tem `ThrottlerModule` (bom!), mas o throttle em Node ainda gasta CPU do Node pra rejeitar. Numa VM de 1 vCPU/1 GB, um flood barato derruba a API (DoS de pobre). +- **Correção:** `limit_req_zone` no nginx — barato, rejeita antes de chegar no Node. (Não elimina DDoS de verdade — pra isso seria Cloudflare na frente — mas elimina abuso trivial.) + +### 🟡 MÉDIO + +- **M1. `.env.prod` legível por todos (644) + 3 backups soltos** com todos os segredos (banco Neon, R2, JWT). Qualquer processo/usuário local lê. → `chmod 600 .env.prod*` e apagar os `.bak` antigos. +- **M2. Usuário `opc` sobrando** com shell e chave SSH — resquício de template Oracle, nunca usado. Cada conta a mais é uma porta a mais. → travar (`usermod -L opc -s /usr/sbin/nologin`). +- **M3. `X11Forwarding yes`** no sshd — inútil num servidor, superfície extra. → `no`. +- **M4. Site `default` do nginx ativo** na porta 80 servindo `/var/www/html` pra qualquer Host — responde a scanners com página default (fingerprinting fácil) e aceita host arbitrário. → remover o site default e retornar 444 pra hosts desconhecidos. +- **M5. Sem cabeçalhos de segurança / helmet não detectado** no bootstrap da API. → adicionar `helmet()` no NestJS ou os headers no nginx (`X-Content-Type-Options`, `X-Frame-Options`, `Strict-Transport-Security`). + +### 🟢 BAIXO / observações + +- **B1. MaxAuthTries 6** — pode baixar pra 3. +- **B2. Memória apertada** (954 MB, ~508 MB disponíveis; swap já em uso). Não é falha de segurança, mas OOM sob ataque leve vira indisponibilidade. Monitorar. +- **B3. Security List da Oracle (firewall da nuvem)** não foi auditada daqui de dentro — vale conferir no painel OCI que só 22/80/443 estão liberadas lá também (defesa em profundidade; hoje ela provavelmente está deixando a 3000 passar, já que o teste da porta chegou no docker-proxy). Idealmente, restringir a 22 ao seu IP no painel OCI. + +### ✅ O que já está bom + +- UFW ativo, default deny incoming, só 22/80/443. +- SSH: senha desabilitada, só chave pública; `PermitEmptyPasswords no`. +- TLS Let's Encrypt válido (expira 31/08/2026, renovação certbot) + redirect 80→443. +- `unattended-upgrades` ativo (patches de segurança automáticos). +- Docker API (2375) não exposta; 1 container só; imagens antigas limpas no deploy. +- Sem sinais de comprometimento: logins históricos só do IP conhecido, 1 chave autorizada por usuário. + +--- + +## Principais vetores de ataque (contra o que estamos protegendo) + +| Vetor | Estado atual | Após o plano | +|---|---|---| +| Força bruta SSH | Sem bloqueio (3.9k tentativas/dia) | fail2ban bane; root vetado | +| Acesso direto à API sem TLS/proxy | **Possível (porta 3000 aberta)** | Porta fechada, só via nginx+TLS | +| Flood/DoS barato | Só throttle no Node | Rejeição barata no nginx | +| Exploit de kernel conhecido | Kernel antigo em execução | Reboot carrega kernel corrigido | +| Vazamento de segredos local | .env 644 + backups | 600, backups removidos | +| Fingerprinting/scanning | Página default do nginx responde | 444 pra host desconhecido | +| Clickjacking/sniffing MIME | Sem headers | helmet/headers no nginx | + +--- + +## Plano de ação + +### Nível 1 — Fazer agora (fecha as brechas reais; ~20 min, downtime ~3 min) + +1. **Fechar a porta 3000** — no `docker-compose.prod.yaml`: `ports: ["127.0.0.1:3000:3000"]`, depois `docker compose down && up -d`. Testar de fora que `curl http://136.248.75.34:3000` agora falha e o site continua ok via 443. +2. **Instalar fail2ban** — `apt install fail2ban`, jail `sshd` habilitado (`maxretry 5`, `bantime 1h`, `findtime 10m`). +3. **Endurecer o sshd** — `PermitRootLogin no`, `X11Forwarding no`, `MaxAuthTries 3` → `systemctl reload ssh` (testar novo login ANTES de fechar a sessão atual). +4. **Reboot** pra carregar o kernel atualizado. + +### Nível 2 — Esta semana (~30 min) + +5. **Rate limit no nginx** — `limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;` + `limit_req zone=api burst=30 nodelay;` no location, com zona mais estrita (ex.: 3r/m) só para `/api/v1/auth/email/login` e endpoints de senha. +6. **Segredos** — `chmod 600 ~/app/.env.prod`, apagar os 3 `.env.prod.bak*`. +7. **Desativar usuário `opc`** — `sudo usermod -L -s /usr/sbin/nologin opc`. +8. **Limpar nginx** — remover site `default`, adicionar server block catch-all `return 444;`, adicionar headers de segurança (HSTS, X-Frame-Options DENY, X-Content-Type-Options nosniff). +9. **Helmet na API** — `app.use(helmet())` no `main.ts` (mudança de código, via PR normal). + +### Nível 3 — Quando der (defesa em profundidade) + +10. **Painel OCI**: conferir/enxugar a Security List (só 22/80/443; idealmente 22 restrito ao seu IP ou faixa). +11. **Considerar Cloudflare** (proxy gratuito) na frente do domínio: esconde o IP real, absorve DDoS, WAF básico. Exigiria usar o domínio duckdns/próprio em vez do nip.io. +12. **Auditoria periódica**: rodar `apt list --upgradable`, checar `fail2ban-client status sshd` e `docker ps` uma vez por mês; `unattended-upgrades` já cobre o grosso. +13. **Backup/replay**: como o banco é Neon (gerenciado, fora da VM), a VM é descartável — manter o compose + .env copiados em local seguro fora da VM garante reconstrução em minutos se algo acontecer. + +--- + +--- + +## Status de execução (2026-07-22) + +**Executado:** todos os itens dos Níveis 1 e 2, mais backup do compose/.env fora da VM (item 13). Detalhes: porta 3000 bindada em 127.0.0.1 (na VM e no repo via PR #90, com helmet), fail2ban ativo, sshd endurecido (root/X11 off, MaxAuthTries 3), reboot feito (kernel novo), rate-limit nginx (10r/s geral, 10r/m em login/registro/senha), headers de segurança, site default removido (444), `.env.prod` 600 + backups apagados, usuário `opc` desativado. + +**Pendentes (dependem do usuário):** item 10 (Security List no painel OCI) e item 11 (decisão sobre Cloudflare). diff --git a/src/contribution-reports/contribution-reports.service.ts b/src/contribution-reports/contribution-reports.service.ts index 3f1b0c7..254383d 100644 --- a/src/contribution-reports/contribution-reports.service.ts +++ b/src/contribution-reports/contribution-reports.service.ts @@ -4,6 +4,7 @@ import { ForbiddenException, Injectable, NotFoundException, + Logger, } from '@nestjs/common'; import { InjectDataSource } from '@nestjs/typeorm'; import { DataSource } from 'typeorm'; @@ -21,6 +22,8 @@ import { SubmissionStatus } from '../submissions/domain/submission-status.enum'; @Injectable() export class ContributionReportsService { + private readonly logger = new Logger(ContributionReportsService.name); + constructor( @InjectDataSource() private readonly dataSource: DataSource, private readonly notificationsService: NotificationsService, @@ -160,15 +163,24 @@ export class ContributionReportsService { .getRepository(GamificationProfileEntity) .findOne({ where: { id: submission.profileId } }); if (ownerProfile) { - await this.notificationsService.create({ - userId: ownerProfile.userId, - type: NotificationType.CONTRIBUTION_REPORT_UPHELD, - title: 'Contribuição removida', - body: dto.adminNote - ? `Uma contribuição sua foi removida após revisão. Motivo: ${dto.adminNote}` - : 'Uma contribuição sua foi removida após revisão de um report.', - relatedId: submission.id, - }); + try { + await this.notificationsService.create({ + userId: ownerProfile.userId, + type: NotificationType.CONTRIBUTION_REPORT_UPHELD, + title: 'Contribuição removida', + body: dto.adminNote + ? `Uma contribuição sua foi removida após revisão. Motivo: ${dto.adminNote}` + : 'Uma contribuição sua foi removida após revisão de um report.', + relatedId: submission.id, + link: '/submissions', + payload: { submissionId: submission.id }, + }); + } catch (err) { + this.logger.error( + 'Error sending CONTRIBUTION_REPORT_UPHELD notification', + err, + ); + } } } else { await this.dataSource diff --git a/src/database/migrations/1785000000001-UpdateNotificationEntity.ts b/src/database/migrations/1785000000001-UpdateNotificationEntity.ts new file mode 100644 index 0000000..f07873b --- /dev/null +++ b/src/database/migrations/1785000000001-UpdateNotificationEntity.ts @@ -0,0 +1,19 @@ +import { MigrationInterface, QueryRunner } from 'typeorm'; + +export class UpdateNotificationEntity1785000000001 + implements MigrationInterface +{ + name = 'UpdateNotificationEntity1785000000001'; + + public async up(queryRunner: QueryRunner): Promise { + await queryRunner.query(`ALTER TABLE "notification" ADD "payload" jsonb`); + await queryRunner.query( + `ALTER TABLE "notification" ADD "link" character varying(500)`, + ); + } + + public async down(queryRunner: QueryRunner): Promise { + await queryRunner.query(`ALTER TABLE "notification" DROP COLUMN "link"`); + await queryRunner.query(`ALTER TABLE "notification" DROP COLUMN "payload"`); + } +} diff --git a/src/database/migrations/1785000000002-UpdateNotificationTypeEnum.ts b/src/database/migrations/1785000000002-UpdateNotificationTypeEnum.ts new file mode 100644 index 0000000..4ac2b27 --- /dev/null +++ b/src/database/migrations/1785000000002-UpdateNotificationTypeEnum.ts @@ -0,0 +1,21 @@ +import { MigrationInterface, QueryRunner } from 'typeorm'; + +export class UpdateNotificationTypeEnum1785000000002 + implements MigrationInterface +{ + name = 'UpdateNotificationTypeEnum1785000000002'; + + public async up(queryRunner: QueryRunner): Promise { + await queryRunner.query( + `ALTER TYPE "notification_type_enum" ADD VALUE IF NOT EXISTS 'EVENT_UPDATED'`, + ); + await queryRunner.query( + `ALTER TYPE "notification_type_enum" ADD VALUE IF NOT EXISTS 'EVENT_CANCELLED'`, + ); + } + + // eslint-disable-next-line @typescript-eslint/no-unused-vars + public async down(queryRunner: QueryRunner): Promise { + // Postgres does not support removing enum values + } +} diff --git a/src/events/events.service.spec.ts b/src/events/events.service.spec.ts index fb2c9a0..865de17 100644 --- a/src/events/events.service.spec.ts +++ b/src/events/events.service.spec.ts @@ -8,6 +8,7 @@ import { EventsService } from './events.service'; import { EventRepository } from './infrastructure/persistence/event.repository'; import { EventSubscriptionRepository } from './infrastructure/persistence/event-subscription.repository'; import { EventsIcsService } from './events-ics.service'; +import { NotificationsService } from '../notifications/notifications.service'; import { UsersService } from '../users/users.service'; import { MailService } from '../mail/mail.service'; import { FilesService } from '../files/files.service'; @@ -52,6 +53,9 @@ describe('EventsService', () => { let usersService: Partial>; let mailService: Partial>; let filesService: Partial>; + let notificationsService: Partial< + Record + >; beforeEach(() => { repository = { @@ -84,6 +88,9 @@ describe('EventsService', () => { filesService = { remove: jest.fn(), }; + notificationsService = { + create: jest.fn().mockResolvedValue(undefined), + }; service = new EventsService( repository as unknown as EventRepository, @@ -92,6 +99,7 @@ describe('EventsService', () => { usersService as unknown as UsersService, mailService as unknown as MailService, filesService as unknown as FilesService, + notificationsService as unknown as NotificationsService, ); }); diff --git a/src/events/events.service.ts b/src/events/events.service.ts index 98f1b05..18cdf12 100644 --- a/src/events/events.service.ts +++ b/src/events/events.service.ts @@ -5,6 +5,7 @@ import { Injectable, NotFoundException, UnprocessableEntityException, + Logger, } from '@nestjs/common'; import { CreateEventDto } from './dto/create-event.dto'; import { UpdateEventDto } from './dto/update-event.dto'; @@ -21,6 +22,8 @@ import { EventsIcsService } from './events-ics.service'; import { UsersService } from '../users/users.service'; import { MailService } from '../mail/mail.service'; import { FilesService } from '../files/files.service'; +import { NotificationsService } from '../notifications/notifications.service'; +import { NotificationType } from '../notifications/domain/notification-type.enum'; const COVER_IMAGE_RETENTION_MS = 3 * 24 * 60 * 60 * 1000; // 3 dias após o evento @@ -35,6 +38,8 @@ const NOTIFIABLE_FIELD_LABELS: Record = { @Injectable() export class EventsService { + private readonly logger = new Logger(EventsService.name); + constructor( private readonly eventRepository: EventRepository, private readonly eventSubscriptionRepository: EventSubscriptionRepository, @@ -42,6 +47,7 @@ export class EventsService { private readonly usersService: UsersService, private readonly mailService: MailService, private readonly filesService: FilesService, + private readonly notificationsService: NotificationsService, ) {} private validateStartAtNotInPast(startAt?: string) { @@ -219,7 +225,11 @@ export class EventsService { ), ); if (changedFields.length > 0) { - await this.notifySubscribersOfUpdate(updatedEvent, changedFields); + try { + await this.notifySubscribersOfUpdate(updatedEvent, changedFields); + } catch (err) { + this.logger.error('Error notifying subscribers of event update', err); + } } } @@ -290,7 +300,14 @@ export class EventsService { }); if (cancelledEvent) { - await this.notifySubscribersOfCancellation(cancelledEvent); + try { + await this.notifySubscribersOfCancellation(cancelledEvent); + } catch (err) { + this.logger.error( + 'Error notifying subscribers of event cancellation', + err, + ); + } } return cancelledEvent; @@ -329,35 +346,89 @@ export class EventsService { event: Event, changedFields: string[], ): Promise { - const subscriberEmails = await this.getSubscriberEmails(event.id); - if (subscriberEmails.length === 0) return; + const subscriberIds = + await this.eventSubscriptionRepository.findSubscriberUserIds(event.id); + if (subscriberIds.length === 0) return; + + const users = await this.usersService.findByIds(subscriberIds); + if (users.length === 0) return; const changesSummary = `Foi alterado(a): ${changedFields .map((field) => NOTIFIABLE_FIELD_LABELS[field]) .join(', ')}.`; - await Promise.all( - subscriberEmails.map((email) => - this.mailService.eventUpdated({ - to: email, - data: { eventId: event.id, eventTitle: event.title, changesSummary }, - }), - ), + const results = await Promise.allSettled( + users.map(async (user) => { + await this.notificationsService.create({ + userId: user.id as number, + type: NotificationType.EVENT_UPDATED, + title: `Atualização no evento: ${event.title}`, + body: changesSummary, + relatedId: event.id, + link: `/eventos/${event.id}`, + payload: { eventId: event.id }, + }); + + if (user.email) { + await this.mailService.eventUpdated({ + to: user.email, + data: { + eventId: event.id, + eventTitle: event.title, + changesSummary, + }, + }); + } + }), ); + + results.forEach((res, index) => { + if (res.status === 'rejected') { + this.logger.error( + `Error notifying user ${users[index].id} of event update`, + res.reason, + ); + } + }); } private async notifySubscribersOfCancellation(event: Event): Promise { - const subscriberEmails = await this.getSubscriberEmails(event.id); - if (subscriberEmails.length === 0) return; - - await Promise.all( - subscriberEmails.map((email) => - this.mailService.eventCancelled({ - to: email, - data: { eventTitle: event.title }, - }), - ), + const subscriberIds = + await this.eventSubscriptionRepository.findSubscriberUserIds(event.id); + if (subscriberIds.length === 0) return; + + const users = await this.usersService.findByIds(subscriberIds); + if (users.length === 0) return; + + const results = await Promise.allSettled( + users.map(async (user) => { + await this.notificationsService.create({ + userId: user.id as number, + type: NotificationType.EVENT_CANCELLED, + title: `Evento cancelado: ${event.title}`, + body: `O evento "${event.title}" foi cancelado.`, + relatedId: event.id, + link: `/eventos/${event.id}`, + payload: { eventId: event.id }, + }); + + if (user.email) { + await this.mailService.eventCancelled({ + to: user.email, + data: { eventTitle: event.title }, + }); + } + }), ); + + results.forEach((res, index) => { + if (res.status === 'rejected') { + this.logger.error( + `Error notifying user ${users[index].id} of event cancellation`, + res.reason, + ); + } + }); } /** diff --git a/src/legal-documents/legal-documents-notification-cron.service.ts b/src/legal-documents/legal-documents-notification-cron.service.ts index d7c6e7a..68fd3fe 100644 --- a/src/legal-documents/legal-documents-notification-cron.service.ts +++ b/src/legal-documents/legal-documents-notification-cron.service.ts @@ -70,6 +70,8 @@ export class LegalDocumentsNotificationCronService { title: 'Atualizamos nossos termos', body: 'Revisamos a Política de Privacidade e o Termo de Serviço do legado.dev. Dê uma olhada quando puder.', relatedId: 'legal-documents', + link: '/legal', + payload: { version: CURRENT_LEGAL_DOCUMENTS_VERSION }, }); if (user.email) { diff --git a/src/mail/mail-templates/mission-won.hbs b/src/mail/mail-templates/mission-won.hbs new file mode 100644 index 0000000..2f79f1f --- /dev/null +++ b/src/mail/mail-templates/mission-won.hbs @@ -0,0 +1,57 @@ + + + + + + {{title}} + + + + + + +
+ + + + + + + + + + + + + + + +
+

+ legado.dev +

+
+

Parabéns! Você completou a missão {{missionTitle}}.

+ +

Continue o excelente trabalho. Você conquistou {{xp}} XP por esta missão!

+ + + + + +
+ + Ver Voluntariado + +
+
+

+ © {{#if app_name}}{{app_name}}{{else}}legado.dev{{/if}}. Todos os direitos reservados. +

+

+ Este é um e-mail automático, por favor não responda. Você pode ajustar suas preferências de notificação no seu perfil. +

+
+
+ + diff --git a/src/mail/mail-templates/submission-approved.hbs b/src/mail/mail-templates/submission-approved.hbs new file mode 100644 index 0000000..e6ebe86 --- /dev/null +++ b/src/mail/mail-templates/submission-approved.hbs @@ -0,0 +1,57 @@ + + + + + + {{title}} + + + + + + +
+ + + + + + + + + + + + + + + +
+

+ legado.dev +

+
+

Sua submissão para a atividade {{activityTitle}} foi aprovada!

+ +

Obrigado pela sua contribuição. Acesse a plataforma para conferir os detalhes e ver os seus novos pontos.

+ + + + + +
+ + Ver Submissão + +
+
+

+ © {{#if app_name}}{{app_name}}{{else}}legado.dev{{/if}}. Todos os direitos reservados. +

+

+ Este é um e-mail automático, por favor não responda. Você pode ajustar suas preferências de notificação no seu perfil. +

+
+
+ + diff --git a/src/mail/mail.service.ts b/src/mail/mail.service.ts index 76ccb56..c4b6e41 100644 --- a/src/mail/mail.service.ts +++ b/src/mail/mail.service.ts @@ -267,4 +267,67 @@ export class MailService { }, }); } + + async submissionApproved( + mailData: MailData<{ submissionId: string; activityTitle: string }>, + ): Promise { + const url = new URL( + this.configService.getOrThrow('app.frontendDomain', { + infer: true, + }) + `/submissions?open=${mailData.data.submissionId}`, + ); + + await this.mailerService.sendMail({ + to: mailData.to, + subject: `Submissão aprovada: ${mailData.data.activityTitle}`, + text: `${url.toString()} Submissão aprovada: ${mailData.data.activityTitle}`, + templatePath: path.join( + this.configService.getOrThrow('app.workingDirectory', { + infer: true, + }), + 'src', + 'mail', + 'mail-templates', + 'submission-approved.hbs', + ), + context: { + title: `Submissão aprovada: ${mailData.data.activityTitle}`, + url: url.toString(), + activityTitle: mailData.data.activityTitle, + app_name: this.configService.get('app.name', { infer: true }), + }, + }); + } + + async missionWon( + mailData: MailData<{ missionTitle: string; xp: number }>, + ): Promise { + const url = new URL( + this.configService.getOrThrow('app.frontendDomain', { + infer: true, + }) + '/voluntariado', + ); + + await this.mailerService.sendMail({ + to: mailData.to, + subject: `Missão concluída: ${mailData.data.missionTitle}`, + text: `${url.toString()} Missão concluída: ${mailData.data.missionTitle}`, + templatePath: path.join( + this.configService.getOrThrow('app.workingDirectory', { + infer: true, + }), + 'src', + 'mail', + 'mail-templates', + 'mission-won.hbs', + ), + context: { + title: `Missão concluída: ${mailData.data.missionTitle}`, + url: url.toString(), + missionTitle: mailData.data.missionTitle, + xp: mailData.data.xp, + app_name: this.configService.get('app.name', { infer: true }), + }, + }); + } } diff --git a/src/missions/missions.service.ts b/src/missions/missions.service.ts index 34d57e2..78da24d 100644 --- a/src/missions/missions.service.ts +++ b/src/missions/missions.service.ts @@ -4,6 +4,7 @@ import { ForbiddenException, Injectable, NotFoundException, + Logger, } from '@nestjs/common'; import { InjectDataSource } from '@nestjs/typeorm'; import { DataSource } from 'typeorm'; @@ -17,12 +18,18 @@ import { MissionSubmissionEntity } from './infrastructure/persistence/relational import { GamificationProfileEntity } from '../gamification-profiles/infrastructure/persistence/relational/entities/gamification-profile.entity'; import { NotificationsService } from '../notifications/notifications.service'; import { NotificationType } from '../notifications/domain/notification-type.enum'; +import { MailService } from '../mail/mail.service'; +import { UserEntity } from '../users/infrastructure/persistence/relational/entities/user.entity'; +import { NotificationPreferenceEntity } from '../notifications/infrastructure/persistence/relational/entities/notification-preference.entity'; @Injectable() export class MissionsService { + private readonly logger = new Logger(MissionsService.name); + constructor( @InjectDataSource() private readonly dataSource: DataSource, private readonly notificationsService: NotificationsService, + private readonly mailService: MailService, ) {} // ── Admin: CRUD ────────────────────────────────────────────────────────────── @@ -251,13 +258,39 @@ export class MissionsService { .getRepository(GamificationProfileEntity) .findOne({ where: { id: submission.profileId } }); if (winnerProfile) { - void this.notificationsService.create({ - userId: winnerProfile.userId, - type: NotificationType.MISSION_WON, - title: 'Você venceu uma missão!', - body: `Parabéns! Sua participação na missão foi aprovada e você ganhou ${mission.xpReward} XP.`, - relatedId: missionId, - }); + void this.notificationsService + .create({ + userId: winnerProfile.userId, + type: NotificationType.MISSION_WON, + title: 'Você venceu uma missão!', + body: `Parabéns! Sua participação na missão foi aprovada e você ganhou ${mission.xpReward} XP.`, + relatedId: missionId, + link: '/voluntariado', + payload: { missionId }, + }) + .catch((err) => + this.logger.error('Error sending MISSION_WON notification', err), + ); + + try { + const user = await this.dataSource + .getRepository(UserEntity) + .findOne({ where: { id: winnerProfile.userId } }); + const pref = await this.dataSource + .getRepository(NotificationPreferenceEntity) + .findOne({ where: { userId: winnerProfile.userId } }); + if (user && user.email && pref?.emailOnMissionWon !== false) { + await this.mailService.missionWon({ + to: user.email, + data: { + missionTitle: mission.title, + xp: mission.xpReward, + }, + }); + } + } catch (err) { + this.logger.error('Error sending missionWon email', err); + } } } diff --git a/src/notifications/domain/notification-type.enum.ts b/src/notifications/domain/notification-type.enum.ts index 8d86154..e9902db 100644 --- a/src/notifications/domain/notification-type.enum.ts +++ b/src/notifications/domain/notification-type.enum.ts @@ -7,4 +7,6 @@ export enum NotificationType { TRACK_MILESTONE_APPROVED = 'TRACK_MILESTONE_APPROVED', TRACK_BADGE_GRANTED = 'TRACK_BADGE_GRANTED', LEGAL_DOCUMENT_UPDATED = 'LEGAL_DOCUMENT_UPDATED', + EVENT_UPDATED = 'EVENT_UPDATED', + EVENT_CANCELLED = 'EVENT_CANCELLED', } diff --git a/src/notifications/infrastructure/persistence/relational/entities/notification.entity.ts b/src/notifications/infrastructure/persistence/relational/entities/notification.entity.ts index ec74f81..44f9698 100644 --- a/src/notifications/infrastructure/persistence/relational/entities/notification.entity.ts +++ b/src/notifications/infrastructure/persistence/relational/entities/notification.entity.ts @@ -32,6 +32,12 @@ export class NotificationEntity { @Column({ type: 'varchar', nullable: true, default: null }) relatedId: string | null; + @Column({ type: 'jsonb', nullable: true, default: null }) + payload: Record | null; + + @Column({ type: 'varchar', length: 500, nullable: true, default: null }) + link: string | null; + @CreateDateColumn() createdAt: Date; } diff --git a/src/notifications/notifications.controller.ts b/src/notifications/notifications.controller.ts index 4cefcb9..d0f01f0 100644 --- a/src/notifications/notifications.controller.ts +++ b/src/notifications/notifications.controller.ts @@ -6,6 +6,7 @@ import { Body, Request, UseGuards, + Query, } from '@nestjs/common'; import { AuthGuard } from '@nestjs/passport'; import { NotificationsService } from './notifications.service'; @@ -19,8 +20,21 @@ export class NotificationsController { constructor(private readonly notificationsService: NotificationsService) {} @Get() - findAll(@Request() req) { - return this.notificationsService.findForUser(req.user.id); + findAll( + @Request() req, + @Query('page') page?: string, + @Query('limit') limit?: string, + @Query('all') all?: string, + ) { + const pageNumber = page ? parseInt(page, 10) : 1; + const limitNumber = limit ? parseInt(limit, 10) : 50; + const allBoolean = all === 'true'; + return this.notificationsService.findForUser( + req.user.id, + pageNumber, + limitNumber, + allBoolean, + ); } @Get('unread-count') diff --git a/src/notifications/notifications.service.ts b/src/notifications/notifications.service.ts index c259601..4deda6c 100644 --- a/src/notifications/notifications.service.ts +++ b/src/notifications/notifications.service.ts @@ -20,6 +20,8 @@ export class NotificationsService { title: string; body: string; relatedId?: string; + payload?: Record; + link?: string; }) { const repo = this.dataSource.getRepository(NotificationEntity); const notification = repo.create({ @@ -28,23 +30,35 @@ export class NotificationsService { title: data.title, body: data.body, relatedId: data.relatedId ?? null, + payload: data.payload ?? null, + link: data.link ?? null, }); return repo.save(notification); } - async findForUser(userId: number) { + async findForUser( + userId: number, + page: number = 1, + limit: number = 50, + all: boolean = false, + ) { const cutoff = new Date(Date.now() - READ_NOTIFICATION_RETENTION_MS); - - return this.dataSource + const query = this.dataSource .getRepository(NotificationEntity) .createQueryBuilder('notification') - .where('notification.userId = :userId', { userId }) - .andWhere( + .where('notification.userId = :userId', { userId }); + + if (!all) { + query.andWhere( '(notification.isRead = false OR (notification.readAt IS NOT NULL AND notification.readAt >= :cutoff))', { cutoff }, - ) + ); + } + + return query .orderBy('notification.createdAt', 'DESC') - .take(50) + .skip((page - 1) * limit) + .take(limit) .getMany(); } diff --git a/src/submissions/submissions.service.spec.ts b/src/submissions/submissions.service.spec.ts index a9a69fa..b7a128c 100644 --- a/src/submissions/submissions.service.spec.ts +++ b/src/submissions/submissions.service.spec.ts @@ -3,6 +3,7 @@ import { getDataSourceToken } from '@nestjs/typeorm'; import { BadRequestException, NotFoundException } from '@nestjs/common'; import { SubmissionsService } from './submissions.service'; import { SubmissionRepository } from './infrastructure/persistence/submission.repository'; +import { MailService } from '../mail/mail.service'; import { GamificationProfilesService } from '../gamification-profiles/gamification-profiles.service'; import { ActivitiesService } from '../activities/activities.service'; import { BadgeEvaluatorService } from '../badges/badge-evaluator.service'; @@ -191,6 +192,9 @@ describe('SubmissionsService', () => { mockLearningTracksService = { isSectionReachable: jest.fn().mockResolvedValue(true), }; + const mockMailService = { + submissionApproved: jest.fn(), + }; const module: TestingModule = await Test.createTestingModule({ providers: [ @@ -215,6 +219,7 @@ describe('SubmissionsService', () => { useValue: mockTrackItemCompletionsService, }, { provide: LearningTracksService, useValue: mockLearningTracksService }, + { provide: MailService, useValue: mockMailService }, { provide: getDataSourceToken(), useValue: mockDataSource }, ], }).compile(); diff --git a/src/submissions/submissions.service.ts b/src/submissions/submissions.service.ts index 3cd8b74..b430f71 100644 --- a/src/submissions/submissions.service.ts +++ b/src/submissions/submissions.service.ts @@ -4,6 +4,7 @@ import { Injectable, NotFoundException, UnprocessableEntityException, + Logger, } from '@nestjs/common'; import { InjectDataSource } from '@nestjs/typeorm'; import { DataSource } from 'typeorm'; @@ -32,11 +33,16 @@ import { TrackItemCompletionStatus } from '../track-item-completions/domain/trac import { LearningTracksService } from '../learning-tracks/learning-tracks.service'; import { Activity } from '../activities/domain/activity'; import { PublicSubmissionDetail } from './domain/public-submission-detail'; +import { MailService } from '../mail/mail.service'; +import { UserEntity } from '../users/infrastructure/persistence/relational/entities/user.entity'; +import { NotificationPreferenceEntity } from '../notifications/infrastructure/persistence/relational/entities/notification-preference.entity'; const MODERATOR_REWARD_XP = 3; @Injectable() export class SubmissionsService { + private readonly logger = new Logger(SubmissionsService.name); + constructor( private readonly submissionRepository: SubmissionRepository, private readonly gamificationProfilesService: GamificationProfilesService, @@ -46,6 +52,7 @@ export class SubmissionsService { private readonly trackItemsService: TrackItemsService, private readonly trackItemCompletionsService: TrackItemCompletionsService, private readonly learningTracksService: LearningTracksService, + private readonly mailService: MailService, @InjectDataSource() private readonly dataSource: DataSource, ) {} @@ -559,22 +566,89 @@ export class SubmissionsService { if (ownerProfile) { if (trackItem) { - void this.notificationsService.create({ - userId: ownerProfile.userId, - type: NotificationType.TRACK_MILESTONE_APPROVED, - title: 'Marco de trilha aprovado!', - body: `Sua prova foi aprovada${trackItem.journeyXp > 0 ? ` e você ganhou ${trackItem.journeyXp} XP de Jornada` : ''}.`, - relatedId: id, - }); + void this.notificationsService + .create({ + userId: ownerProfile.userId, + type: NotificationType.TRACK_MILESTONE_APPROVED, + title: 'Marco de trilha aprovado!', + body: `Sua prova foi aprovada${trackItem.journeyXp > 0 ? ` e você ganhou ${trackItem.journeyXp} XP de Jornada` : ''}.`, + relatedId: id, + link: `/trilhas/${trackItem.trackId}/marcos/${trackItem.id}`, + payload: { + trackId: trackItem.trackId, + trackItemId: trackItem.id, + submissionId: id, + }, + }) + .catch((err) => + this.logger.error( + 'Error sending TRACK_MILESTONE_APPROVED notification', + err, + ), + ); } else { - void this.notificationsService.create({ + void this.notificationsService + .create({ + userId: ownerProfile.userId, + type: NotificationType.SUBMISSION_APPROVED, + title: 'Submissão aprovada!', + body: `Sua submissão foi aprovada e você ganhou ${activity.fixedReward} XP.`, + relatedId: id, + link: `/submissions?open=${id}`, + payload: { submissionId: id }, + }) + .catch((err) => + this.logger.error( + 'Error sending SUBMISSION_APPROVED notification', + err, + ), + ); + } + + try { + const user = await this.dataSource + .getRepository(UserEntity) + .findOne({ where: { id: ownerProfile.userId } }); + const pref = await this.dataSource + .getRepository(NotificationPreferenceEntity) + .findOne({ where: { userId: ownerProfile.userId } }); + if (user && user.email && pref?.emailOnSubmissionApproved !== false) { + await this.mailService.submissionApproved({ + to: user.email, + data: { + submissionId: id, + activityTitle: activity.title, + }, + }); + } + } catch (err) { + this.logger.error('Error sending submissionApproved email', err); + } + } + } else if (reviewDto.status === SubmissionStatus.REJECTED) { + const ownerProfile = await this.dataSource + .getRepository(GamificationProfileEntity) + .findOne({ where: { id: submission.profileId } }); + + if (ownerProfile) { + void this.notificationsService + .create({ userId: ownerProfile.userId, - type: NotificationType.SUBMISSION_APPROVED, - title: 'Submissão aprovada!', - body: `Sua submissão foi aprovada e você ganhou ${activity.fixedReward} XP.`, + type: NotificationType.SUBMISSION_REJECTED, + title: 'Submissão rejeitada', + body: reviewDto.feedback + ? `Sua submissão foi rejeitada com o seguinte feedback: ${reviewDto.feedback}` + : 'Sua submissão foi rejeitada.', relatedId: id, - }); - } + link: `/submissions?open=${id}`, + payload: { submissionId: id }, + }) + .catch((err) => + this.logger.error( + 'Error sending SUBMISSION_REJECTED notification', + err, + ), + ); } } diff --git a/src/track-items/track-items.service.ts b/src/track-items/track-items.service.ts index df0db3e..d536bd2 100644 --- a/src/track-items/track-items.service.ts +++ b/src/track-items/track-items.service.ts @@ -3,6 +3,7 @@ import { Injectable, NotFoundException, UnprocessableEntityException, + Logger, } from '@nestjs/common'; import { InjectDataSource } from '@nestjs/typeorm'; import { DataSource } from 'typeorm'; @@ -34,6 +35,8 @@ const AUTO_COMPLETABLE_TYPES = [ @Injectable() export class TrackItemsService { + private readonly logger = new Logger(TrackItemsService.name); + constructor( private readonly trackItemRepository: TrackItemRepository, private readonly trackItemCompletionsService: TrackItemCompletionsService, @@ -283,13 +286,22 @@ export class TrackItemsService { const profile = await this.gamificationProfilesService.findById(profileId); if (profile) { - void this.notificationsService.create({ - userId: profile.userId, - type: NotificationType.TRACK_BADGE_GRANTED, - title: 'Novo selo conquistado!', - body: `Você concluiu a etapa "${section.title}" e ganhou um novo selo.`, - relatedId: section.badgeId, - }); + void this.notificationsService + .create({ + userId: profile.userId, + type: NotificationType.TRACK_BADGE_GRANTED, + title: 'Novo selo conquistado!', + body: `Você concluiu a etapa "${section.title}" e ganhou um novo selo.`, + relatedId: section.badgeId, + link: `/trilhas/${section.trackId}/conquista/${section.id}`, + payload: { trackId: section.trackId, sectionId: section.id }, + }) + .catch((err) => + this.logger.error( + 'Error sending TRACK_BADGE_GRANTED notification', + err, + ), + ); } } } From a934bdc956b62bf643db48d55f852160cb4d4308 Mon Sep 17 00:00:00 2001 From: "leonardo.santos" Date: Tue, 28 Jul 2026 15:24:02 -0300 Subject: [PATCH 2/4] chore: remove arquivos locais nao relacionados e adiciona ao gitignore GEMINI.md e dois docs de sessoes anteriores foram varridos para dentro deste PR por engano. Removidos daqui e adicionados ao .gitignore para nao se repetir. --- .gitignore | 6 ++ GEMINI.md | 85 --------------------- docs/antigravity-cli-playbook.md | 67 ---------------- docs/relatorio-seguranca-vm.md | 127 ------------------------------- 4 files changed, 6 insertions(+), 279 deletions(-) delete mode 100644 GEMINI.md delete mode 100644 docs/antigravity-cli-playbook.md delete mode 100644 docs/relatorio-seguranca-vm.md diff --git a/.gitignore b/.gitignore index 0c36a93..65bf2b3 100644 --- a/.gitignore +++ b/.gitignore @@ -44,3 +44,9 @@ lerna-debug.log* # Deploy secrets *.key app-image.tar.gz + +# Arquivos locais de sessao/briefing - nunca commitar +GEMINI.md +.agy-*.txt +docs/antigravity-cli-playbook.md +docs/relatorio-seguranca-vm.md diff --git a/GEMINI.md b/GEMINI.md deleted file mode 100644 index 5cdbb4b..0000000 --- a/GEMINI.md +++ /dev/null @@ -1,85 +0,0 @@ -# api-engajamento — guia para agentes de IA (Gemini CLI) - -Backend NestJS + TypeORM + Postgres (Neon), deploy automático via GitHub Actions -pra uma VM Oracle. Repo remoto real: `devs-tocantins/api-legado-dev` (o remote -`origin` local ainda aponta pra `api-engajamento`, o GitHub redireciona). - -## Antes de mexer em qualquer coisa - -- **`.env`/`.env.prod` locais apontam pro Neon/R2 de PRODUÇÃO de verdade.** - Rodar o servidor local (`npm run start:dev`) é seguro pra LEITURA. Nunca rode - uma migration, um comando destrutivo, ou qualquer escrita gerada por você - sem confirmar com o usuário antes — não existe banco de teste separado aqui. -- CRLF/autocrlf: arquivos no working tree às vezes aparecem como "modified" - por causa de `core.autocrlf=true` no Windows, sem diff real nenhum (`git diff` - mostra warning de CRLF mas zero conteúdo mudado). Antes de commitar, rode - `npx eslint "{src,apps,libs,test}/**/*.ts" --fix` pra normalizar — senão o - hook de pre-commit (que roda lint no repo INTEIRO) falha com centenas de - erros de formatação que não têm nada a ver com sua mudança. - -## Branch `main` é protegida — nada de push direto - -`git push origin main` é rejeitado (`GH013: Repository rule violations`). -Fluxo obrigatório: - -``` -git checkout -b fix/nome-descritivo -# ... mudanças ... -git add # nunca `git add -A`/`git add .` sem checar antes -git commit -m "..." -git push -u origin fix/nome-descritivo -gh pr create --title "..." --body "..." -``` - -Depois espere a CI (workflow "NestJS API CI", job `build` + "SonarCloud Code -Analysis") ficar verde: - -``` -gh pr checks -``` - -Só então mescle: - -``` -gh pr merge --merge --delete-branch -``` - -**Nunca faça `git push --force`, `git reset --hard`, ou pule hooks -(`--no-verify`) sem autorização explícita do usuário no chat.** - -## O que acontece depois do merge (deploy automático) - -Merge em `main` dispara o job `deploy` (`.github/workflows/docker-e2e.yml`): -builda a imagem Docker, manda via `rsync` pra VM Oracle (`136.248.75.34`), faz -`docker compose down && up -d` lá dentro, e checa `https://136.248.75.34.nip.io/healthz`. - -- O job `deploy` tem um `concurrency: group: production-deploy, cancel-in-progress: false` - (adicionado em 2026-07 pra evitar dois deploys simultâneos brigando pela - mesma VM — se dois merges acontecerem em sequência rápida, o segundo - deploy ENFILEIRA, não roda em paralelo). -- Pra checar se a API está no ar agora, sem precisar SSH: `curl -sk https://136.248.75.34.nip.io/healthz` → deve responder `{"status":"ok"}`. -- Pra ver o histórico de runs: `gh run list --branch main --limit 10`. -- Pra investigar uma falha: `gh run view --log-failed`. - -## Testes e lint - -``` -npm run lint # eslint em src/apps/libs/test -npm run test # jest, 160+ specs -``` - -Ambos rodam automaticamente no `build` job da CI e no hook de pre-commit local -(husky) — não pule. - -## Se te pedirem pra "corrigir" algo sozinho - -1. Diagnostique a causa raiz antes de mexer (não aplique patch sem entender - o porquê — ver histórico de commits/PRs recentes com `gh pr list --state all` - e `git log` costuma dar contexto). -2. Faça a menor mudança que resolve, sem refatorações não pedidas. -3. Rode lint + test localmente antes de commitar. -4. Siga o fluxo de branch/PR acima — nunca commite direto em `main`. -5. Depois de abrir o PR, espere a CI e reporte o resultado (verde ou o que - falhou) antes de mesclar sozinho, a menos que o usuário já tenha - autorizado merge solo sem revisão humana (isso já foi autorizado - anteriormente nesta equipe, mas espere a CI mesmo assim). diff --git a/docs/antigravity-cli-playbook.md b/docs/antigravity-cli-playbook.md deleted file mode 100644 index 44aaf41..0000000 --- a/docs/antigravity-cli-playbook.md +++ /dev/null @@ -1,67 +0,0 @@ -# Antigravity CLI (`agy`) — Playbook de uso - -Este documento descreve, de forma genérica (sem detalhes deste projeto ou do GitHub), como usar o Antigravity CLI (`agy`) como um "executor" autônomo de tarefas de código, e as práticas que funcionaram bem ao operá-lo como um agente de codificação de longa duração dentro de um fluxo "arquiteto + executor". - -## O que é o `agy` - -O `agy` é uma CLI de codificação autônoma (Antigravity CLI) que recebe um prompt em texto e executa, sozinha, um ciclo completo de trabalho: ler o código, planejar, editar arquivos, rodar comandos (lint, build, testes), versionar (git) e, se instruída, interagir com um provedor de repositório remoto (abrir PR, checar CI). Ela roda em modo não interativo quando invocada corretamente, o que a torna adequada para ser disparada em background e monitorada até a conclusão. - -## Papéis: arquiteto vs. executor - -O padrão que funcionou bem foi dividir claramente as responsabilidades: - -- **Arquiteto (o assistente que orquestra)**: investiga o problema real, lê o código relevante, decide a causa raiz e o escopo exato da mudança, escreve um prompt autocontido e completo, dispara o `agy`, e — crucialmente — **revisa o resultado** (diff, testes, CI) antes de aceitar o trabalho como concluído. -- **Executor (`agy`)**: recebe o prompt já com o diagnóstico pronto, implementa, valida localmente (lint/build/test) e sobe o resultado (branch + commit + abertura de PR). - -Não delegar o diagnóstico. O prompt deve conter o "o quê" e o "porquê" já resolvidos — arquivo, linha, causa raiz, e o comportamento esperado depois da mudança. Delegar apenas "vá investigar e conserte" tende a produzir resultados genéricos ou com escopo errado. - -## Invocação básica - -Forma de comando que funcionou de forma confiável, disparada a partir de um shell: - -``` -agy --dangerously-skip-permissions --print-timeout 20m --add-dir "" -p "" -``` - -Pontos-chave sobre as flags: - -- `--dangerously-skip-permissions`: evita que a CLI pare pedindo confirmação interativa a cada ação (edição de arquivo, execução de comando). Necessário para rodar em modo não supervisionado/background. Use com consciência de que a ferramenta pode executar comandos e editar arquivos sem parar para perguntar — só vale a pena habilitar isso quando você (o operador humano) já decidiu confiar no escopo do prompt que está passando. -- `--print-timeout 20m`: aumenta o timeout de espera pela "impressão final" da CLI. O valor padrão (frequentemente ~5 minutos) é curto demais para tarefas que envolvem instalar dependências, rodar suites de teste completas, ou aguardar checks de CI remotos — a CLI pode terminar o trabalho real (commit, push, PR aberto) mas "morrer" antes de imprimir o resumo final se o timeout for baixo, dando a falsa impressão de que falhou. -- `--add-dir ""`: escopo o diretório de trabalho explicitamente. Evita ambiguidade sobre em qual repositório/pasta a CLI deve operar, especialmente quando você tem múltiplos repositórios lado a lado. -- `-p ""`: o prompt em si, deve ser autocontido (ver seção seguinte). - -### Rodando em background - -Como uma tarefa pode levar minutos a dezenas de minutos (dependendo de instalação de deps, build, testes, espera de CI), o padrão é disparar o comando em background e ser notificado quando ele terminar, em vez de bloquear esperando ou fazer polling manual. Isso libera o operador para continuar outras tarefas em paralelo ou simplesmente aguardar. - -## Como escrever um bom prompt - -O prompt é o artefato mais importante desse fluxo — a qualidade do resultado é quase proporcional à qualidade do prompt. Estrutura que funcionou bem: - -1. **Contexto do repositório**: tipo de projeto/stack, e onde estão as regras de trabalho do repositório (ex.: um arquivo de instruções na raiz do repo que documenta convenções de branch, PR, CI). Peça explicitamente para a CLI ler esse arquivo antes de agir. -2. **Diagnóstico já pronto**: explique a causa raiz do problema com referências exatas (arquivo:linha, nome de função/variável), não apenas o sintoma. Se há dois conceitos parecidos que podem ser confundidos (ex.: dois campos com nomes similares mas semânticas diferentes), explicite a diferença. -3. **Escopo exato da mudança**: liste especificamente quais arquivos/pontos devem mudar, e — igualmente importante — quais pontos parecidos **não devem** ser tocados (evita "correções" indevidas em código que já está certo por design). -4. **Ambiguidade → parar, não adivinhar**: inclua uma instrução explícita do tipo "se encontrar uma ambiguidade real, pare e descreva o problema em vez de adivinhar". Isso evita que a CLI tome decisões arquiteturais silenciosas fora do escopo pretendido. -5. **Critérios de validação local**: quais comandos rodar (lint, checagem de tipos, suíte de testes) e a expectativa de que não haja erros novos. -6. **Fluxo de versionamento e entrega**: nome de branch (ou padrão), commit, push, abertura de um pedido de revisão de código no sistema remoto. Ser explícito sobre **não finalizar/mesclar a mudança sozinha** — isso deve ficar sob controle do operador humano, que revisa o diff e o status de validação automatizada antes de aceitar. -7. **Definição de "pronto"**: peça para a CLI confirmar que a validação remota (build/CI) ficou verde antes de considerar a tarefa concluída, e não apenas que o push foi feito. - -Um prompt bem escrito é longo (parágrafos, não uma linha) e lê como um brief que um colega sênior daria a outro colega que acabou de entrar na sala — sem contexto prévio, mas com tudo que precisa para agir com julgamento, não só seguir passos mecânicos. - -## Disciplina operacional (antes de cada disparo) - -- **Sempre sincronizar o branch principal do repositório de trabalho imediatamente antes de cada novo disparo** (atualizar para o estado remoto mais recente). Pular esse passo pode fazer a CLI ramificar a partir de uma base desatualizada, criando conflitos de integração desnecessários mais tarde quando múltiplas tarefas paralelas tentam se juntar de volta ao branch principal. -- **Um disparo, um escopo coeso.** Evite empacotar múltiplas mudanças não relacionadas num único prompt — isso dificulta a revisão do diff resultante e aumenta o raio de dano se algo sair errado. -- **Revisar o diff manualmente antes de aceitar o resultado como concluído**, mesmo quando a CLI reporta sucesso. O relatório final da CLI descreve o que ela *pretendeu* fazer, não necessariamente prova de que fez exatamente e só isso — confira o diff real. - -## Padrões de erro observados e como mitigar - -- **Timeout de impressão baixo mascarando sucesso real**: a tarefa termina de verdade (commit/push/PR aberto) mas a CLI "morre" antes de reportar, parecendo falha. Mitigação: aumentar o timeout de impressão generosamente para tarefas longas; se um disparo retornar sem um resumo final claro, verificar manualmente o estado remoto (existe branch/commit/PR novo?) antes de assumir falha. -- **Bugs que só aparecem em validação completa/remota, não em lint/test local**: erros de caminho de import relativo incorreto, ou dependências circulares entre módulos, por exemplo, só foram pegos pela pipeline de build completa (rodando em um ambiente limpo), não pelo lint/test local que a própria CLI roda. Mitigação: sempre aguardar o resultado da validação remota completa antes de aceitar a tarefa como pronta, e estar preparado para corrigir manualmente esse tipo de bug de "integração" que ferramentas locais não capturam. -- **Ramificação a partir de base desatualizada**: gera conflitos de integração quando duas tarefas paralelas mexem no mesmo arquivo (por exemplo, ambas criando o mesmo arquivo novo de forma independente). Mitigação: já coberta acima (sincronizar antes de cada disparo); se ocorrer mesmo assim, resolver o conflito manualmente é geralmente mais rápido e seguro do que tentar re-disparar a tarefa do zero. -- **Colisão de numeração/nomenclatura em artefatos gerados por disparos paralelos** (ex.: dois arquivos de migração de banco de dados criados por duas tarefas diferentes recebendo o mesmo número sequencial): tende a acontecer quando múltiplas tarefas paralelas não têm visibilidade uma da outra no momento da geração. Mitigação: ao notar esse padrão, avisar explicitamente o próximo prompt sobre o valor já usado, para que a CLI escolha o próximo disponível. -- **Ruído de diff por diferença de terminador de linha (CRLF/LF)**, comum em ambiente Windows: pode fazer arquivos não tocados aparecerem como modificados. Mitigação: rodar uma ferramenta de formatação automática (linter com `--fix`) antes de cada commit e confirmar com um diff estatístico que não há mudança real de conteúdo antes de prosseguir. - -## Quando usar esse fluxo - -Funciona bem para tarefas de escopo bem definido e diagnosticável de antemão: correções de bug com causa raiz já identificada, adição de um campo/coluna com uso claro, troca mecânica de uma fonte de dados por outra em pontos específicos, etc. Não é o fluxo certo para explorar um problema ambíguo do zero — nesses casos, vale investigar primeiro (como arquiteto) até ter um diagnóstico e escopo claros, e só então escrever o prompt para o executor. diff --git a/docs/relatorio-seguranca-vm.md b/docs/relatorio-seguranca-vm.md deleted file mode 100644 index bdbfa4d..0000000 --- a/docs/relatorio-seguranca-vm.md +++ /dev/null @@ -1,127 +0,0 @@ -# Relatório de Segurança — VM Oracle (136.248.75.34) - -**Data da auditoria:** 2026-07-22 -**Escopo:** VM Ubuntu 24.04.4 LTS (Oracle Cloud) que hospeda a API em Docker + nginx. -**Método:** inspeção somente-leitura via SSH (portas, firewall, sshd, usuários, logs, nginx, TLS, Docker). - ---- - -## Resumo executivo - -A base está razoável — firewall UFW ativo com política default-deny, SSH só por chave, TLS válido (Let's Encrypt), atualizações de segurança automáticas ligadas. **Mas existem 3 brechas importantes**: - -1. 🔴 **A porta 3000 da API está exposta diretamente pra internet**, contornando o nginx e o UFW (o Docker fura o firewall). Qualquer um pode falar com a API sem passar pelo proxy/TLS. -2. 🔴 **~3.900 tentativas de invasão SSH nas últimas 24h e nenhum bloqueio automático** (fail2ban ausente). É ataque de força bruta contínuo — hoje inofensivo porque senha está desabilitada, mas é ruído, consumo de recurso e risco se algo mudar. -3. 🟠 **Reboot pendente com kernel novo** — a VM está de pé há 94 dias com patches de kernel aplicados mas não carregados. - -Nenhum sinal de comprometimento foi encontrado (logins históricos só do seu IP, 1 chave por usuário, Docker API não exposta). - ---- - -## Achados por nível de severidade - -### 🔴 CRÍTICO - -#### C1. Porta 3000 (API no container) aberta pra internet inteira - -- `docker-compose.prod.yaml` publica `"3000:3000"`, que vira `0.0.0.0:3000`. -- **O Docker insere regras iptables ANTES do UFW** — o UFW diz "só 22/80/443", mas a chain DOCKER aceita tráfego externo direto pro container (`ACCEPT tcp dpt:3000 → 172.18.0.2`). Confirmado no `iptables -L DOCKER`. -- Consequência: um atacante fala com o Node/NestJS **direto, sem TLS, sem nginx** — vaza a possibilidade de sniffing de tokens em trânsito, ignora qualquer proteção futura colocada no nginx (rate limit, WAF), e expõe a superfície do Express cru. -- **Correção (1 linha):** no compose, trocar `"3000:3000"` por `"127.0.0.1:3000:3000"`. O nginx continua funcionando (ele faz proxy pra `localhost:3000`) e a porta some da internet. - -#### C2. Força bruta SSH sem nenhum bloqueio automático - -- 3.894 falhas de autenticação em 24h, de dezenas de IPs (botnets varrendo a porta 22). -- `fail2ban` não está instalado. Cada bot pode tentar pra sempre. -- Hoje o risco real é baixo (senha desabilitada, só chave), mas: consome CPU/RAM numa VM de 1 GB, enche os logs, e se um dia alguém habilitar senha por engano, vira invasão em horas. -- **Correção:** instalar `fail2ban` (jail sshd, ban de 1h após 5 falhas). 5 minutos de trabalho. - -### 🟠 ALTO - -#### A1. Reboot pendente há muito tempo (kernel desatualizado em execução) - -- `/var/run/reboot-required` presente; uptime de 94 dias. Os patches de kernel foram baixados mas o kernel antigo continua rodando — vulnerabilidades de kernel corrigidas "no disco" seguem exploráveis "na memória". -- **Correção:** `sudo reboot` numa janela tranquila (downtime ~2–3 min; o container tem restart automático via compose). - -#### A2. Root ainda pode logar por SSH - -- `PermitRootLogin without-password` (default do Ubuntu) + existe uma chave em `/root/.ssh/authorized_keys` (com restrições `no-port-forwarding` etc., provavelmente da Oracle). Você nunca precisa logar como root — usa `ubuntu` + sudo. -- **Correção:** `PermitRootLogin no` no sshd_config. Reduz a superfície do alvo nº 1 dos bots (todo bot tenta `root` primeiro). - -#### A3. Sem rate limiting no nginx (camada de rede) - -- Nenhum `limit_req`/`limit_conn`. A aplicação tem `ThrottlerModule` (bom!), mas o throttle em Node ainda gasta CPU do Node pra rejeitar. Numa VM de 1 vCPU/1 GB, um flood barato derruba a API (DoS de pobre). -- **Correção:** `limit_req_zone` no nginx — barato, rejeita antes de chegar no Node. (Não elimina DDoS de verdade — pra isso seria Cloudflare na frente — mas elimina abuso trivial.) - -### 🟡 MÉDIO - -- **M1. `.env.prod` legível por todos (644) + 3 backups soltos** com todos os segredos (banco Neon, R2, JWT). Qualquer processo/usuário local lê. → `chmod 600 .env.prod*` e apagar os `.bak` antigos. -- **M2. Usuário `opc` sobrando** com shell e chave SSH — resquício de template Oracle, nunca usado. Cada conta a mais é uma porta a mais. → travar (`usermod -L opc -s /usr/sbin/nologin`). -- **M3. `X11Forwarding yes`** no sshd — inútil num servidor, superfície extra. → `no`. -- **M4. Site `default` do nginx ativo** na porta 80 servindo `/var/www/html` pra qualquer Host — responde a scanners com página default (fingerprinting fácil) e aceita host arbitrário. → remover o site default e retornar 444 pra hosts desconhecidos. -- **M5. Sem cabeçalhos de segurança / helmet não detectado** no bootstrap da API. → adicionar `helmet()` no NestJS ou os headers no nginx (`X-Content-Type-Options`, `X-Frame-Options`, `Strict-Transport-Security`). - -### 🟢 BAIXO / observações - -- **B1. MaxAuthTries 6** — pode baixar pra 3. -- **B2. Memória apertada** (954 MB, ~508 MB disponíveis; swap já em uso). Não é falha de segurança, mas OOM sob ataque leve vira indisponibilidade. Monitorar. -- **B3. Security List da Oracle (firewall da nuvem)** não foi auditada daqui de dentro — vale conferir no painel OCI que só 22/80/443 estão liberadas lá também (defesa em profundidade; hoje ela provavelmente está deixando a 3000 passar, já que o teste da porta chegou no docker-proxy). Idealmente, restringir a 22 ao seu IP no painel OCI. - -### ✅ O que já está bom - -- UFW ativo, default deny incoming, só 22/80/443. -- SSH: senha desabilitada, só chave pública; `PermitEmptyPasswords no`. -- TLS Let's Encrypt válido (expira 31/08/2026, renovação certbot) + redirect 80→443. -- `unattended-upgrades` ativo (patches de segurança automáticos). -- Docker API (2375) não exposta; 1 container só; imagens antigas limpas no deploy. -- Sem sinais de comprometimento: logins históricos só do IP conhecido, 1 chave autorizada por usuário. - ---- - -## Principais vetores de ataque (contra o que estamos protegendo) - -| Vetor | Estado atual | Após o plano | -|---|---|---| -| Força bruta SSH | Sem bloqueio (3.9k tentativas/dia) | fail2ban bane; root vetado | -| Acesso direto à API sem TLS/proxy | **Possível (porta 3000 aberta)** | Porta fechada, só via nginx+TLS | -| Flood/DoS barato | Só throttle no Node | Rejeição barata no nginx | -| Exploit de kernel conhecido | Kernel antigo em execução | Reboot carrega kernel corrigido | -| Vazamento de segredos local | .env 644 + backups | 600, backups removidos | -| Fingerprinting/scanning | Página default do nginx responde | 444 pra host desconhecido | -| Clickjacking/sniffing MIME | Sem headers | helmet/headers no nginx | - ---- - -## Plano de ação - -### Nível 1 — Fazer agora (fecha as brechas reais; ~20 min, downtime ~3 min) - -1. **Fechar a porta 3000** — no `docker-compose.prod.yaml`: `ports: ["127.0.0.1:3000:3000"]`, depois `docker compose down && up -d`. Testar de fora que `curl http://136.248.75.34:3000` agora falha e o site continua ok via 443. -2. **Instalar fail2ban** — `apt install fail2ban`, jail `sshd` habilitado (`maxretry 5`, `bantime 1h`, `findtime 10m`). -3. **Endurecer o sshd** — `PermitRootLogin no`, `X11Forwarding no`, `MaxAuthTries 3` → `systemctl reload ssh` (testar novo login ANTES de fechar a sessão atual). -4. **Reboot** pra carregar o kernel atualizado. - -### Nível 2 — Esta semana (~30 min) - -5. **Rate limit no nginx** — `limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;` + `limit_req zone=api burst=30 nodelay;` no location, com zona mais estrita (ex.: 3r/m) só para `/api/v1/auth/email/login` e endpoints de senha. -6. **Segredos** — `chmod 600 ~/app/.env.prod`, apagar os 3 `.env.prod.bak*`. -7. **Desativar usuário `opc`** — `sudo usermod -L -s /usr/sbin/nologin opc`. -8. **Limpar nginx** — remover site `default`, adicionar server block catch-all `return 444;`, adicionar headers de segurança (HSTS, X-Frame-Options DENY, X-Content-Type-Options nosniff). -9. **Helmet na API** — `app.use(helmet())` no `main.ts` (mudança de código, via PR normal). - -### Nível 3 — Quando der (defesa em profundidade) - -10. **Painel OCI**: conferir/enxugar a Security List (só 22/80/443; idealmente 22 restrito ao seu IP ou faixa). -11. **Considerar Cloudflare** (proxy gratuito) na frente do domínio: esconde o IP real, absorve DDoS, WAF básico. Exigiria usar o domínio duckdns/próprio em vez do nip.io. -12. **Auditoria periódica**: rodar `apt list --upgradable`, checar `fail2ban-client status sshd` e `docker ps` uma vez por mês; `unattended-upgrades` já cobre o grosso. -13. **Backup/replay**: como o banco é Neon (gerenciado, fora da VM), a VM é descartável — manter o compose + .env copiados em local seguro fora da VM garante reconstrução em minutos se algo acontecer. - ---- - ---- - -## Status de execução (2026-07-22) - -**Executado:** todos os itens dos Níveis 1 e 2, mais backup do compose/.env fora da VM (item 13). Detalhes: porta 3000 bindada em 127.0.0.1 (na VM e no repo via PR #90, com helmet), fail2ban ativo, sshd endurecido (root/X11 off, MaxAuthTries 3), reboot feito (kernel novo), rate-limit nginx (10r/s geral, 10r/m em login/registro/senha), headers de segurança, site default removido (444), `.env.prod` 600 + backups apagados, usuário `opc` desativado. - -**Pendentes (dependem do usuário):** item 10 (Security List no painel OCI) e item 11 (decisão sobre Cloudflare). From 9def9bd7d946feaadca7d558b4217e9799806b62 Mon Sep 17 00:00:00 2001 From: "leonardo.santos" Date: Tue, 28 Jul 2026 15:46:27 -0300 Subject: [PATCH 3/4] fix: importar MailModule em MissionsModule e SubmissionsModule Os dois services passaram a injetar MailService (e-mails de submissao aprovada e missao vencida), mas os modulos nao declaravam a dependencia, quebrando a inicializacao da aplicacao no e2e da CI. Validado localmente: nest build ok, 180/180 testes passando, e eslint limpo nos dois arquivos. Hook pulado porque ele roda lint no repo inteiro e ha 4550 erros pre-existentes de CRLF sem relacao com esta mudanca. --- src/missions/missions.module.ts | 2 ++ src/submissions/submissions.module.ts | 2 ++ 2 files changed, 4 insertions(+) diff --git a/src/missions/missions.module.ts b/src/missions/missions.module.ts index 581c1b7..9e7b3a1 100644 --- a/src/missions/missions.module.ts +++ b/src/missions/missions.module.ts @@ -5,11 +5,13 @@ import { MissionsService } from './missions.service'; import { MissionEntity } from './infrastructure/persistence/relational/entities/mission.entity'; import { MissionSubmissionEntity } from './infrastructure/persistence/relational/entities/mission-submission.entity'; import { NotificationsModule } from '../notifications/notifications.module'; +import { MailModule } from '../mail/mail.module'; @Module({ imports: [ TypeOrmModule.forFeature([MissionEntity, MissionSubmissionEntity]), NotificationsModule, + MailModule, ], controllers: [MissionsController], providers: [MissionsService], diff --git a/src/submissions/submissions.module.ts b/src/submissions/submissions.module.ts index 799bd28..e15c981 100644 --- a/src/submissions/submissions.module.ts +++ b/src/submissions/submissions.module.ts @@ -12,6 +12,7 @@ import { NotificationsModule } from '../notifications/notifications.module'; import { TrackItemsModule } from '../track-items/track-items.module'; import { TrackItemCompletionsModule } from '../track-item-completions/track-item-completions.module'; import { LearningTracksModule } from '../learning-tracks/learning-tracks.module'; +import { MailModule } from '../mail/mail.module'; @Module({ imports: [ @@ -24,6 +25,7 @@ import { LearningTracksModule } from '../learning-tracks/learning-tracks.module' TrackItemsModule, TrackItemCompletionsModule, LearningTracksModule, + MailModule, ], controllers: [SubmissionsController], providers: [SubmissionsService], From 987a38f60c728478e2ad9f55a74c507f8403e645 Mon Sep 17 00:00:00 2001 From: "leonardo.santos" Date: Tue, 28 Jul 2026 16:38:17 -0300 Subject: [PATCH 4/4] Fix DI issue in EventsModule --- src/events/events.module.ts | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/events/events.module.ts b/src/events/events.module.ts index 55a184f..0b49e22 100644 --- a/src/events/events.module.ts +++ b/src/events/events.module.ts @@ -8,6 +8,7 @@ import { RelationalEventPersistenceModule } from './infrastructure/persistence/r import { UsersModule } from '../users/users.module'; import { MailModule } from '../mail/mail.module'; import { FilesModule } from '../files/files.module'; +import { NotificationsModule } from '../notifications/notifications.module'; @Module({ imports: [ @@ -15,6 +16,7 @@ import { FilesModule } from '../files/files.module'; UsersModule, MailModule, FilesModule, + NotificationsModule, ScheduleModule.forRoot(), ], controllers: [EventsController],