23fe67470b
Remplace les diagrammes Mermaid par DBML (via kroki-dbml) pour une meilleure expressivité des schémas de base de données : - Ajout support notes, contraintes et indexes détaillés - Migration de tous les schémas d'entités partagées - Ajout fichier exemple dbml-example.md - Configuration plugin mkdocs-kroki pour rendu DBML
78 lines
2.5 KiB
Markdown
78 lines
2.5 KiB
Markdown
# Data Exports
|
|
|
|
📖 Exports de données utilisateur (portabilité RGPD Article 20)
|
|
|
|
## Diagramme
|
|
|
|
```kroki-dbml
|
|
Table users {
|
|
id uuid [primary key]
|
|
}
|
|
|
|
Table data_exports {
|
|
id uuid [primary key]
|
|
user_id uuid [not null, ref: > users.id]
|
|
status export_status_enum [not null, default: 'pending']
|
|
export_url varchar(512) [note: 'S3/CDN signed URL (NULL until generated)']
|
|
size_bytes bigint [note: 'File size in bytes (NULL until generated)']
|
|
format export_format_enum [not null, default: 'json']
|
|
requested_at timestamp [not null, default: `now()`]
|
|
generated_at timestamp [note: 'When export file was created (NULL if pending/generating)']
|
|
expires_at timestamp [note: 'Auto-calculated: generated_at + 7 days']
|
|
downloaded_at timestamp [note: 'First download timestamp (NULL if not yet downloaded)']
|
|
|
|
indexes {
|
|
(user_id, requested_at) [note: 'User export history']
|
|
(status, requested_at) [note: 'Background worker queue (WHERE status = pending)']
|
|
(expires_at) [note: 'Daily cleanup job (DELETE WHERE expires_at < NOW())']
|
|
}
|
|
}
|
|
|
|
Enum export_status_enum {
|
|
pending [note: 'Demande en file d attente']
|
|
generating [note: 'Génération en cours (worker background)']
|
|
ready [note: 'Export disponible au téléchargement']
|
|
downloaded [note: 'Export téléchargé par l utilisateur']
|
|
expired [note: 'Export expiré (supprimé automatiquement)']
|
|
}
|
|
|
|
Enum export_format_enum {
|
|
json [note: 'Machine-readable (données brutes)']
|
|
html [note: 'Human-readable (page web stylée)']
|
|
zip [note: 'Archive complète (JSON + HTML + audio files)']
|
|
}
|
|
```
|
|
|
|
## Légende
|
|
|
|
**Formats d'export** :
|
|
|
|
- `json` : Machine-readable (données brutes)
|
|
- `html` : Human-readable (page web stylée)
|
|
- `zip` : Archive complète (JSON + HTML + audio files)
|
|
|
|
**Contenu de l'export** :
|
|
|
|
- Profil utilisateur (email, pseudo, date inscription, bio)
|
|
- Historique d'écoute (titres, dates, durées)
|
|
- Contenus créés (audio + métadonnées)
|
|
- Abonnements et likes
|
|
- Centres d'intérêt (jauges)
|
|
- Historique consentements RGPD
|
|
|
|
**Statuts** :
|
|
|
|
- `pending` : Demande en file d'attente
|
|
- `generating` : Génération en cours (worker background)
|
|
- `ready` : Export disponible au téléchargement
|
|
- `downloaded` : Export téléchargé par l'utilisateur
|
|
- `expired` : Export expiré (supprimé automatiquement)
|
|
|
|
**Règles** :
|
|
|
|
- Génération asynchrone (worker background)
|
|
- Délai max : **48h** (conformité RGPD)
|
|
- Conservation : **7 jours** après génération
|
|
- Limite : **1 export/mois** (anti-abus)
|
|
- Notification par email avec lien de téléchargement
|