Les playlists suivent la lecture de leurs morceaux.

pmoplaylist/src/openapi.rs

@@ -0,0 +1,44 @@
+//! Documentation OpenAPI pour les endpoints playlists (SSE évènements).
+
+#[cfg(feature = "pmoserver")]
+use utoipa::OpenApi;
+
+/// Documentation OpenAPI pour l'API playlist (flux SSE).
+#[derive(OpenApi)]
+#[openapi(
+    paths(
+        crate::sse::playlist_events_sse,
+    ),
+    components(
+        schemas(
+            crate::sse::EventPayload,
+            crate::sse::EventsQuery,
+        )
+    ),
+    tags(
+        (name = "playlists", description = "Suivi des playlists et des morceaux joués")
+    ),
+    info(
+        title = "PMO Playlist API",
+        version = "0.1.0",
+        description = r#"
+# Flux d'évènements playlists
+
+Endpoint SSE pour suivre :
+- les modifications de playlists (updated)
+- les lectures de morceaux appartenant aux playlists (track_played)
+
+Payload JSON par évènement :
+- `playlist_id` : identifiant de la playlist
+- `kind` : `updated` ou `track_played`
+- `cache_pk` : pk du morceau (si track_played)
+- `qualifier` : qualifier de diffusion (orig/stream/etc.)
+- `timestamp` : horodatage UTC
+- `source_client` : client à l'origine (optionnel)
+        "#,
+        license(
+            name = "MIT",
+        ),
+    )
+)]
+pub struct ApiDoc;