Stocker la durée totale d'une setlist et l'afficher sur les cartes de la page d'accueil

Đang mở
#103 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
go, postgresql, redis, typescript
Lĩnh vực
backend, database, frontend

Hướng nghiên cứu

Start with frontend/src/routes/(app)/+page.svelte and frontend/src/lib/utils/utils.ts to trace how setlist cards display dates and how detail totals are calculated. Then inspect the migration files, PgSetlistRepository, SetlistService.GetDetails, and the item, song, and interlude mutation paths named in the issue. Done means the stored total stays aligned with the item sum, cached lists refresh when it changes, and both homepage tabs show the formatted duration.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

backend enhancement frontend

Contexte

Sur la page d'accueil (frontend/src/routes/(app)/+page.svelte), chaque carte de setlist n'affiche que sa pastille de couleur, son nom et sa date de création. Pour savoir combien de temps dure un set, il faut ouvrir la setlist : la durée totale n'est calculée que sur la page de détail, côté client, par calculateTotalDuration (frontend/src/lib/utils/utils.ts) à partir des items chargés.

C'est l'information la plus utile quand on choisit une setlist : « laquelle fait 45 minutes pour le concert de samedi ? ». La comparer entre plusieurs setlists demande aujourd'hui autant d'allers-retours qu'il y a de setlists.

User story

En tant que membre d'un groupe, je veux voir la durée totale de chaque setlist directement sur la page d'accueil, afin de comparer mes setlists sans les ouvrir une par une.

Décision : la durée est stockée sur la setlist

La durée totale devient une colonne de la table setlists, maintenue à jour à chaque modification de la setlist. Elle n'est plus recalculée à la volée.

Conséquence : l'information est disponible partout où on lit une setlist, sans charger ses items — page d'accueil, liste, futurs écrans, export — pour le coût d'une lecture de colonne.

Contrepartie assumée : une valeur dénormalisée peut diverger de la réalité. Chaque chemin d'écriture qui touche à une durée doit donc la recalculer — et, filet de sécurité, c'est le calcul à partir des items qui fait foi : quand on charge le détail d'une setlist, on compare la somme réelle à la valeur stockée, et on corrige la valeur stockée si elle diverge. La colonne est une commodité de lecture, jamais l'autorité.

Ce qui doit déclencher une mise à jour

Chemin Effet sur le total
Ajout d'un item (AddItemToSetlist) oui
Suppression d'un item (DeleteSetlistItem) oui
Duplication d'une setlist (CopyItemsToNewSetlist, insertion en CopyFrom) oui, sur la nouvelle setlist
Modification de la durée d'une chanson oui, sur toutes les setlists qui la contiennent
Modification de la durée d'un interlude oui, sur toutes les setlists qui le contiennent
Réordonnancement (UpdateItemOrder) non
Modification des notes d'un item (UpdateSetlistItem) non

Les deux lignes en gras sont celles qu'on oublie : elles partent de SongService / InterludeService, qui ne connaissent aujourd'hui ni les setlists ni SetlistRepository.

Approche recommandée : trigger PostgreSQL

Recalculer la colonne dans un trigger, au plus près de la donnée :

  • trigger sur setlist_items (INSERT / DELETE / UPDATE de song_id, interlude_id) → recalcule la setlist concernée ;
  • trigger sur songs et interludes (UPDATE OF duration_seconds) → recalcule toutes les setlists qui référencent la ligne.

Le recalcul se fait par un SELECT COALESCE(SUM(...), 0) complet plutôt que par un delta : c'est auto-réparateur, une valeur fausse se corrige à la modification suivante.

Pourquoi ce choix plutôt qu'un recalcul dans les services Go :

  • la duplication de setlist passe par CopyFrom (CopyItemsToNewSetlist) — un trigger FOR EACH ROW la couvre sans code supplémentaire ;
  • SongService et InterludeService n'auraient pas besoin de dépendre de SetlistRepository ;
  • l'ajout d'item est déjà transactionnel avec un SELECT ... FOR UPDATE sur la setlist parente (cf. #100) : le trigger s'exécute dans cette transaction, le compteur ne peut pas dériver sous concurrence.

L'alternative — un recalcul explicite en Go après chaque mutation — reste acceptable si on préfère garder toute la logique visible dans les services, mais elle impose de câbler SetlistRepository dans deux services de plus et de ne jamais oublier un chemin d'écriture. À trancher dans l'issue avant de coder.

Tâches

  1. Migration — ajouter total_duration_seconds INT NOT NULL DEFAULT 0 à setlists, créer les triggers, et backfiller les setlists existantes dans la même migration. Prévoir un .down.sql qui supprime triggers et colonne.
  2. Somme cohérente avec l'affichage actuel — utiliser la même règle que GetSetlistItemsBySetlistID : COALESCE(s.duration_seconds, i.duration_seconds), NULL compté comme 0. Les chansons supprimées en soft delete restent visibles dans les setlists aujourd'hui ; elles doivent donc continuer à compter dans le total.
  3. Backend — modèle — exposer le champ dans model.Setlist (total_duration_seconds), ce qui le fait remonter automatiquement dans GET /api/setlists et GET /api/setlists/{id}. Ajouter la colonne aux SELECT / RETURNING de PgSetlistRepository.
  4. ⚠️ Backend — invalidation du cache — GetAllForBand met la liste en cache Redis 30 minutes sous cache.SetlistKey(bandID). Les mutations d'items n'invalident aujourd'hui que cache.SetlistDetailKey, et une modification de chanson ou d'interlude n'invalide rien du tout côté setlists. Le trigger corrige la base, pas le cache : sans invalidation, la page d'accueil affichera une durée périmée jusqu'à 30 minutes. Dès que la durée change, le cache doit sauter — ajout d'item, suppression d'item, mise à jour d'une chanson ou d'un interlude dont la durée change, et correction par réconciliation (tâche 7). Sur les chemins chanson / interlude, ne l'invalider que si duration_seconds a réellement changé : renommer une chanson ne doit pas vider le cache des setlists.
  5. Réconciliation à la lecture du détail — SetlistService.GetDetails charge déjà tous les items. Il doit y recalculer la somme, la comparer à total_duration_seconds, et si les deux diffèrent, écrire la valeur recalculée dans la setlist et invalider cache.SetlistKey(bandID). C'est le calcul qui fait foi : la colonne s'aligne dessus, jamais l'inverse. En régime normal les valeurs sont égales et rien n'est écrit — l'écriture n'a lieu que sur dérive, donc elle est rare. Elle rattrape aussi les setlists qu'un futur chemin d'écriture oublierait de mettre à jour.
  6. Frontend — type — ajouter le champ à SetlistSummary (frontend/src/lib/types.ts), dont hérite SetlistDetails.
  7. Frontend — affichage — afficher la durée sur la carte de la page d'accueil, à côté de la date de création, via formatDuration de $lib/utils/utils.ts. La page de détail ne change pas : elle continue de calculer son total à la volée avec calculateTotalDuration, puisque c'est ce calcul qui fait autorité.

Règle de calcul — les transitions ne comptent pas

calculateTotalDuration ignore transition_duration_seconds. Comme c'est ce calcul qui fait foi, la colonne stockée, le trigger et la réconciliation doivent l'ignorer aussi : somme des COALESCE(s.duration_seconds, i.duration_seconds) des items, et rien d'autre. Inclure les transitions serait un autre sujet, à traiter partout à la fois (calcul client, colonne, PDF) dans une issue dédiée.

Critères d'acceptation

  • La colonne existe, est alimentée pour les setlists créées et pour celles qui existaient avant la migration
  • La durée totale apparaît sur chaque carte de la page d'accueil (onglets « Actuelles » et « Archivées »), au format formatDuration (45m 30s)
  • Ajouter ou supprimer un item met à jour la valeur stockée immédiatement, et la page d'accueil la reflète sans attendre l'expiration du cache
  • Modifier la durée d'une chanson met à jour toutes les setlists qui la contiennent, et la page d'accueil les reflète immédiatement
  • Modifier la durée d'un interlude met à jour toutes les setlists qui le contiennent, et la page d'accueil les reflète immédiatement
  • Modifier une chanson sans toucher à sa durée n'invalide pas le cache des setlists
  • Dupliquer une setlist produit une copie avec la bonne durée
  • Réordonner les items ne change pas la durée
  • Si la valeur stockée est faussée à la main en base, ouvrir la setlist la corrige et rafraîchit la page d'accueil
  • La valeur stockée est égale au total affiché sur la page de détail, pour la même setlist
  • Une setlist sans item vaut 0 et ne casse pas l'affichage
  • La liste des setlists reste une seule requête SQL, sans N+1
  • make test-backend passe
Ngôn ngữ chính
Python
Star
2
Fork
0
Merge trung bình
21 phút
Pull request đã merge (30 ngày)
2

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Doud75/Setly

Tất cả issue của Doud75/Setly

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.