---
sidebar_position: 1
title: "1.1.3"
---

# 1.1.3

**Data de lançamento:** 05/06/2026

---

## Adicionado

### Analytics - Google Analytics 4 (GA4)

Integração completa de analytics para rastreamento de uso e experiência dos estudantes:

- **Rastreamento de páginas** — acompanha quais seções da plataforma são mais visitadas
- **Rastreamento de atividades** — identifica quais atividades educacionais são completadas, falhadas ou abandonadas
- **Rastreamento de fases** — permite entender em qual fase os estudantes têm dificuldade
- **Offline-aware** — não tenta enviar dados quando o estudante está sem conexão
- **Configurável** — pode ser habilitado ou desabilitado via variáveis de ambiente

#### Como usar

**Development (sem analytics):**

```bash
docker compose build --build-arg VITE_ANALYTICS_PROVIDER=noop app
```

**Production (com GA4):**

```bash
docker compose build \
  --build-arg VITE_ANALYTICS_PROVIDER=ga4 \
  --build-arg VITE_GA4_ID=G-SEU_ID_AQUI \
  --build-arg GIT_COMMIT_HASH=$(git rev-parse --short HEAD) app
```

Veja a [documentação completa de Analytics](../plataforma/arquitetura/analytics.md) para detalhes de integração e relatórios.

### Detecção Automática de Atualizações

Script no `index.html` que detecta novos deploys e recarrega automaticamente:

```javascript
(async function checkForUpdates() {
  const response = await fetch('/version.json');
  const newVersion = await response.json();
  const lastVersion = sessionStorage.getItem('app_version');
  
  if (lastVersion && lastVersion !== newVersion.commit) {
    console.log('🔄 Novo deploy detectado. Recarregando...');
    window.location.reload(true);
  }
  
  sessionStorage.setItem('app_version', newVersion.commit);
})();
```

**Benefícios:**
- Usuários recebem novas versões automaticamente
- Sem necessidade de limpar cache ou recarregar manual
- Transparente — nenhuma intervenção do usuário necessária
- Apenas recarrega se houver mudança de versão

---

## Melhorias

### Build Docker Aprimorado

O `Dockerfile` agora suporta argumentos de build para configurar analytics e versionamento:

```dockerfile
ARG GIT_COMMIT_HASH=unknown
ARG APP_VERSION=1.1.3
ARG VITE_ANALYTICS_PROVIDER=ga4
ARG VITE_GA4_ID=SEU_ID_AQUI
ARG VITE_GA4_DEBUG=false
```

Permite builds reproduzíveis e controlados por ambiente.

---

## Segurança

### Conformidade LGPD/GDPR

- Banner de consentimento antes de qualquer rastreamento
- Implementação de Google Consent Mode
- Opção clara de rejeitar analytics
- Dados anonimizados (anonymize_ip: true)
- Política de Privacidade atualizada em `/privacy-policy`

---

## Documentação

Documentação técnica completa adicionada:

- **[Analytics - GA4](../plataforma/arquitetura/analytics.md)** — Visão geral, arquitetura, build e relatórios
- **[Versionamento e Atualizações](../plataforma/arquitetura/versionamento-atualizacoes.md)** — Detecção automática de deploys

---

## Notas de Deploy

### Primeiro Deploy com Analytics

Ao fazer deploy em produção com GA4:

1. Configure as variáveis de ambiente:
   ```bash
   VITE_ANALYTICS_PROVIDER=ga4
   VITE_GA4_ID=G-SEU_ID_AQUI
   ```

2. Obtenha o ID do GA4:
   - Acesse [https://analytics.google.com](https://analytics.google.com)
   - Vá para `Administração → Data Streams`
   - Copie o ID de medição (formato: G-XXXXXXXXXX)

3. Compile com:
   ```bash
   docker compose build --build-arg VITE_GA4_ID=G-SEU_ID app
   ```

4. Teste em produção:
   - Abra a app no browser
   - Aceite cookies quando o banner aparecer
   - Abra DevTools → Network
   - Procure por requisições para `googletagmanager.com`
   - Verifique `Relatórios → Em tempo real` no GA4

### Se optar por não usar Analytics

Para desabilitar analytics em qualquer ambiente:

```bash
docker compose build --build-arg VITE_ANALYTICS_PROVIDER=noop app
```

---

## Changelog Completo

**Adicionado:**
- ✨ Analytics com Google Analytics 4 (mas preparado para uso de outras ferramentas no futuro como Umami)
- ✨ Detecção automática de atualizações no `index.html`
- ✨ Documentação de Analytics e build Docker
- ✨ Hooks de rastreamento: `usePageTracking`, `useActivityTracking`, `useLetramentoTracking`

**Melhorado:**
- 🔧 Build Docker com suporte a argumentos de GA4
- 🔧 Versionamento integrado (`version.json`)
- 📚 Documentação técnica expandida

**Segurança:**
- 🔒 Implementação de Google Consent Mode
- 🔒 Anonimização de IPs em GA4
