feat: update doc

This commit is contained in:
2026-06-05 09:05:53 -03:00
parent fd8e9049bf
commit d09d695d29
11 changed files with 1091 additions and 15 deletions

View File

@@ -143,6 +143,51 @@ plataforma-edu-docs-1 Up 2 minutes
plataforma-edu-proxy-1 Up 2 minutes 0.0.0.0:80->80/tcp
```
#### Build com Google Analytics 4 (GA4)
Para ativar analytics em produção, use argumentos de build:
**Com variáveis de ambiente:**
Crie um arquivo `.env` na raiz do projeto:
```bash
GIT_COMMIT_HASH=abc1234
VITE_ANALYTICS_PROVIDER=ga4
VITE_GA4_ID=G-SEU_ID_GA4
VITE_GA4_DEBUG=false
```
Então execute:
```bash
docker compose build app
docker compose up -d
```
**Ou diretamente via argumentos:**
```bash
docker compose build \
--build-arg GIT_COMMIT_HASH=$(git rev-parse --short HEAD) \
--build-arg VITE_ANALYTICS_PROVIDER=ga4 \
--build-arg VITE_GA4_ID=SEU_ID_AQUI \
app
docker compose up -d
```
**Para desabilitar analytics (desenvolvimento):**
```bash
docker compose build --build-arg VITE_ANALYTICS_PROVIDER=noop app
docker compose up -d
```
> 📊 **Nota:** Obtém seu ID do GA4 em [https://analytics.google.com](https://analytics.google.com) → Administração → Data Streams → Copie o ID de medição (formato: G-XXXXXXXXXX)
Para mais detalhes, veja: [Documentação de Analytics](docs/docs/plataforma/arquitetura/analytics.md)
---
### Opção 2: Desenvolvimento Local