# Analytique (analytics)

> Module analytics : Événements et écrans vus, envoyés par lots dans Supabase (table analytics_events, écriture seule).

Événements et écrans vus, envoyés par lots dans Supabase (table analytics_events, écriture seule).

:::note[Page générée]
Générée depuis `modules/analytics/README.md`, `module.json`, `config.ts`, `index.ts` à chaque build du site : modifier la source, pas cette page.
:::

## Fiche technique

| | |
|---|---|
| Paquet | `@daroms/module-analytics` |
| Activer | `bun daroms module add analytics` |
| Requiert | aucun module |
| Dépendances natives | aucune |
| Routes ajoutées | aucune |
| Onglets | aucun |
| Migrations | `migrations/analytics_events.sql` |
| Edge functions | aucune |
| Variables d'environnement | aucune |
| Gate de navigation | non |
| Section de réglages | non |

## Mise en place et usage

Analytique légère et souveraine : événements envoyés par lots dans Supabase (`analytics_events`, écriture seule).

- Activer : `bun daroms module add analytics`.
- Code : `track('todo_created', { source: 'sheet' })` ; les écrans sont suivis automatiquement.
- Lecture : requêtes SQL dans le tableau de bord Supabase (aucune lecture depuis l'app).
- Config : `sink` (`supabase` | `console`), `flushIntervalMs`, `screens`.

## Configuration

Dans `app.manifest.ts > modules['analytics']`, validée par `modules/analytics/config.ts` au démarrage.

| Clé | Schéma zod | Rôle |
|---|---|---|
| `sink` | `z.enum(['supabase', 'console']).default('supabase')` | supabase : table analytics_events ; console : journal de dev. |
| `flushIntervalMs` | `z.number().int().min(2000).default(15000)` | - |
| `screens` | `z.boolean().default(true)` | Enregistre automatiquement chaque écran vu. |

Valeurs écrites par `module add` :

```json
{
  "sink": "supabase",
  "flushIntervalMs": 15000,
  "screens": true
}
```

## Exports

```ts
import { flush, track, trackScreen } from '@daroms/module-analytics'
```

- Valeurs : `flush`, `track`, `trackScreen`

---

Page HTML : https://daromsartof.github.io/daroms-speedapp/reference/modules/analytics/
Index de la documentation : https://daromsartof.github.io/daroms-speedapp/llms.txt