veza/CHANGELOG.md

# Changelog - Veza

## [v0.303] - 2026-02-22

### Added

- **Lot C2 — Chat appels WebRTC 1-to-1**
  - Chat Server : signalisation CallOffer, CallAnswer, ICECandidate, CallHangup, CallReject
  - WebSocketManager.send_to_user pour livraison 1-to-1
  - RateLimitAction::CallSignaling (60 req/min)
  - Frontend : useWebRTC hook, CallButton, IncomingCallModal, ActiveCallBar
  - Appels audio 1-to-1 dans conversations DM

---

## [v0.302] - 2026-02-21

### Added

- **Lot S2 — Groupes avancés**
  - Demander à rejoindre (groupes privés), approbation/rejet par admin
  - Inviter membres par email ou user_id
  - Rôles assign/revoke (admin, moderator, member)
  - Feed type=groups (posts des membres des groupes)
  - GET /social/groups/mine
  - Migrations 069, 089, 092
- **Lot N1 — Notifications push Web**
  - POST /notifications/push/subscribe, PushService (webpush-go)
  - Envoi push sur follow/like/comment/message (selon préférences)
  - GET/PUT /notifications/preferences
  - Migrations 090, 093
  - Frontend : subscribePush, PushPreferencesSection, badge document.title
- **Lot P2 — Présence enrichie**
  - PUT /users/me/presence (status_message, track_id, track_title, invisible)
  - Rich presence : sync track en cours via usePresenceSync
  - Mode invisible (GetPresenceForViewer masque pour les autres)
  - PresenceBadge statusMessage tooltip
  - Migrations 091, 094

### Changed

- NotificationService : SetPushService, envoi push post-CreateNotification
- Shared NotificationService avec PushService pour profile, track, comment handlers

### Deferred (v0.303)

- **Lot C2** : Livré en v0.303

---

## [v0.301] - 2026-02-20

### Added

- **Lot P0 — Chat Server**
  - Protocole typing aligné : `{ type: 'Typing', conversation_id, is_typing }`
  - Limitation JWT auth (query param) documentée pour v0.302
- **Lot C1 — Chat avancé**
  - Typing indicators end-to-end (UserTyping, setUserTyping)
  - Read receipts (MarkAsRead, MessageRead, « Vu à HH:mm »)
  - Delivered status (Delivered, MessageDelivered)
- **Lot P1 — Présence**
  - Migration 088 user_presence (status, last_seen_at, status_message)
  - PresenceService, GET /users/:id/presence
  - Mise à jour last_seen_at sur chaque requête authentifiée
  - PresenceBadge, usePresence, intégration ChatSidebar
- **Lot S1 — Social enrichi**
  - Feed connecté à socialService.getFeed (remplace trackService.list)
  - Backend : enrichissement actor_name, actor_avatar, track dans GetGlobalFeed
  - SocialViewFeedItem : posts texte + posts avec track (mini player)
  - Pagination cursor (next_cursor), useInfiniteQuery, Load More
  - GET /social/explore (trending + suggested_users), onglet Explore
  - Filtres feed : all | following | groups (param type, OptionalAuth pour following)

### Changed

- useSocialView : socialService.getFeed, useInfiniteQuery, feedFilter
- SocialView : onglet Explore, filtres feed
- AuthMiddleware : SetPresenceService, UpdatePresence sur RequireAuth

### Documented

- FEATURE_STATUS, PROJECT_STATE mis à jour pour v0.301

---

## [v0.203] - 2026-02-20

### Added

- **Lot L — Social Trending**
  - GET /social/trending (extraction hashtags posts 7 jours, agrégation)
  - Cache Redis 15 min (clé trending:hashtags)
  - SocialViewTrending connecté à l’API (Loading, Error, Empty fallback)
  - MSW handler GET */api/v1/social/trending
- **Lot K — Recherche enrichie**
  - Migration 086 pg_trgm pour fuzzy search
  - TrackSearchService : similarity() sur title/artist/album (PostgreSQL), fallback ILIKE (SQLite)
  - query_parser.go : AND, OR, NOT, "phrase exacte"
  - SearchService + TrackSearchService utilisent le parser
  - SearchPageHeader : tooltip aide syntaxe
- **Lot D1 — Queue collaborative**
  - Migration 087 queue_sessions, shared_queue_items
  - Modèles QueueSession, SharedQueueItem
  - QueueSessionService : Create, Get, Delete, Add/Remove items
  - POST/GET/DELETE /queue/session, POST/DELETE /queue/session/:token/items
  - PlayerQueue : bouton Partager, badge Queue partagée, polling 8 s
  - queueSessionStore, useQueueSync mode session
  - MSW handlers pour queue session

### Changed

- SocialViewTrending : useQuery, skeletons, erreur → fallback tags
- TrackSearchService : dialect sqlite → LIKE, postgres → similarity
- SearchService : BuildWhereCondition pour requêtes booléennes
- PlayerQueue : mode session, partage lien, sync session
- useQueueSync : skip sync personnelle quand session active

### Documented

- FEATURE_STATUS, PROJECT_STATE mis à jour pour v0.203

---

## [v0.202] - 2026-02-20

### Added

- **Lot G — Recherche avancée**
  - Filtre musical_key dans track_search (G1)
  - Tri pertinence (relevance) dans SearchService (G2)
  - Autocomplete : GET /search/suggestions, dropdown debounced (G3)
  - Facettes type (tracks/artistes/playlists/users) dans SearchPage (G4)
  - Historique recherche localStorage (G5)
- **Lot H — Analytics créateur**
  - GET /analytics/creator/stats, carte Completion Rate (H1)
  - GET /analytics/creator/charts, graphiques (H2)
  - Taux de complétion intégré dashboard (H3)
  - GET /analytics/creator/export CSV/JSON (H4)
- **Lot F — Seller dashboard**
  - GET /sell/stats, connexion commerceService (F1)
  - Support seller_id=me dans ListProducts (F2)
- **Lot C — Player avancé**
  - Crossfade configurable (1–12 s) depuis Settings (C1)
  - Gapless préchargement via preloadTrack (C2)
  - PiP (Picture-in-Picture) si supporté (C3)
- **Lot D — Autoplay**
  - GET /tracks/recommendations (auth), section « À écouter ensuite » dans PlayerQueue (D2)

### Changed

- SearchPage : onglets type, suggestions dropdown, historique récent
- AnalyticsViewKpiGrid : métrique Completion Rate
- AnalyticsViewChart : graphiques creator
- SettingsPage : slider crossfade
- PlayerQueue : recommandations quand queue vide (authentifié)
- PlayerStore : crossfadeSeconds, préchargement ~5 s avant fin

### Documented

- D1 (queue collaborative) reporté v0.203+
- V0_202_RELEASE_SCOPE.md, FEATURE_STATUS.md, PROJECT_STATE.md mis à jour

---

## [v0.201] - 2026-02-20

### Added

- **Lot E — Métadonnées enrichies**
  - BPM : champ dans Track model, UpdateTrack, filtre track_search (E1)
  - Musical key : champ, input/select édition, affichage TrackDetailPageInfo (E2)
  - Lyrics : table track_lyrics, GET/PUT /tracks/:id/lyrics, section Paroles avec toggle (E3)
  - Tags suggérés : GET /tracks/suggested-tags?genre=X, migration tracks.tags, chips + dropdown (E4)

### Changed

- Track model : BPM, MusicalKey, Tags (pq.StringArray)
- TrackDetailPageInfo : affichage BPM, key, tags
- TrackMetadataEditModal : édition BPM, musical_key, tags avec suggestions

### Documented

- Lot G (Recherche avancée), H (Analytics), F (Seller), C (Player), D (Queue) reportés v0.202+

---

## [v0.103] - 2026-02-20

### Added
- **Auth (Lot A)** : OAuth Spotify (A1), page Sessions enrichie avec historique et révocation (A4)
- **Profils (Lot B)** : Bannière de profil éditable (B1), section liens sociaux sur profil public (B2), toggle profil privé dans Settings (B3)
- **Profil privé** : Vue « Profil privé » sur `/u/:username` quand le profil est masqué ; `is_public` exposé et persisté

### Documented
- 2FA SMS et Passkeys/WebAuthn reportés à v0.104

---

## [v0.102] - 2026-02-20

### Added
- **Queue persistante** : API CRUD (`GET/PUT/POST/DELETE /api/v1/queue`), sync frontend via `useQueueSync`, drag & drop reorder avec @dnd-kit (B3)
- **Developer API Keys** : CRUD clés API, X-API-Key middleware, CreateAPIKeyModal, révocation
- **Playlists** : activation PLAYLIST_SHARE, PLAYLIST_RECOMMENDATIONS ; boutons Export (JSON/CSV), Duplicate connectés
- **Social** : like/comment post connectés à l’API ; profil followers/following count ; badges rôles
- **Player** : playback speed (0.5x–2x), Media Session API, waveform dans progress bar

### Changed
- **Gear, Live, Queue, Developer** : routes opérationnelles (fin des placeholders Coming Soon)
- Feature flags PLAYLIST_SHARE et PLAYLIST_RECOMMENDATIONS activés (true)

### Documented
- Go Live (streaming vidéo) : non implémenté, prévu v0.703 — limitation A6
- Social Trending (tags) : statique, report v0.103 pour `GET /social/trending`

---

## [Unreleased] - 2024-12-07

### Security
- **chat-server**: Implemented JWT Authentication Middleware for HTTP API.
  - Secured `/api/messages` (POST) and `/api/messages/{id}` (GET).
  - Enforced permission checks (`can_send_message`, `can_read_conversation`).
  - Patched `sender_id` spoofing vulnerability by enforcing User ID from Token Claims.
- **backend**: Resolved `veza_errors_total` metric collision preventing proper monitoring initialization.

### Fixed
- **backend**: Fixed `JobWorker` starvation issue by replacing blocking `time.Sleep` with non-blocking scheduler.
- **stream-server**: Improved task safety by replacing unsafe `abort()` with graceful `join/await` for monitoring tasks.
- **chat-server**: Fixed resource leak by implementing 60s WebSocket inactivity/heartbeat timeout.
- **chat-server**: Implemented Graceful Shutdown handling for OS signals (SIGTERM/SIGINT).
- **backend-tests**: Fixed `RoomHandler` unit tests.
  - Refactored `RoomHandler` to use `RoomServiceInterface` for dependency injection.
  - Updated `CreateRoom` tests to match actual Service signatures.
  - Fixed `bitrate_handler_test.go` compilation errors.
  - Resolved global metric registration panics during testing.

### Removed
- **backend**: Deleted legacy maintenance code (`migrations_legacy/` and `src/cmd/main.go.legacy`).

### Known Issues
- **backend**: Some unit tests (`metrics_test.go`, `profile_handler_test.go`, `system_metrics_test.go`) are disabled due to bitrot/missing dependencies.
- **stream-server**: Compilation requires active Database connection (sqlx compile-time verification) or `sqlx-data.json`.