Stocker la durée totale d'une setlist et l'afficher sur les cartes de la page d'accueil
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
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ả
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/UPDATEdesong_id,interlude_id) → recalcule la setlist concernée ; - trigger sur
songsetinterludes(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 triggerFOR EACH ROWla couvre sans code supplémentaire ; SongServiceetInterludeServicen'auraient pas besoin de dépendre deSetlistRepository;- l'ajout d'item est déjà transactionnel avec un
SELECT ... FOR UPDATEsur 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
- 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.sqlqui supprime triggers et colonne. - Somme cohérente avec l'affichage actuel — utiliser la même règle que
GetSetlistItemsBySetlistID:COALESCE(s.duration_seconds, i.duration_seconds),NULLcompté comme 0. Les chansons supprimées en soft delete restent visibles dans les setlists aujourd'hui ; elles doivent donc continuer à compter dans le total. - Backend — modèle — exposer le champ dans
model.Setlist(total_duration_seconds), ce qui le fait remonter automatiquement dansGET /api/setlistsetGET /api/setlists/{id}. Ajouter la colonne auxSELECT/RETURNINGdePgSetlistRepository. - ⚠️ Backend — invalidation du cache —
GetAllForBandmet la liste en cache Redis 30 minutes souscache.SetlistKey(bandID). Les mutations d'items n'invalident aujourd'hui quecache.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 siduration_secondsa réellement changé : renommer une chanson ne doit pas vider le cache des setlists. - Réconciliation à la lecture du détail —
SetlistService.GetDetailscharge 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 invalidercache.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. - Frontend — type — ajouter le champ à
SetlistSummary(frontend/src/lib/types.ts), dont hériteSetlistDetails. - Frontend — affichage — afficher la durée sur la carte de la page d'accueil, à côté de la date de création, via
formatDurationde$lib/utils/utils.ts. La page de détail ne change pas : elle continue de calculer son total à la volée aveccalculateTotalDuration, 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
0et ne casse pas l'affichage - La liste des setlists reste une seule requête SQL, sans N+1
-
make test-backendpasse
- 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
- Có Dockerfile hoặc tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của Doud75/Setly
-
agent-ready chore
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 86/100
-
Connexion avec Apple (SSO)Đang mởbackend enhancement frontend security
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 48/100
-
agent-ready backend enhancement frontend security
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
-
agent-ready backend enhancement frontend security
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100
-
agent-ready backend bug frontend security
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
marketcalls/openalgo#2472 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 95/100
marimo-team/marimo#11949 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug server-time v2
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
modelcontextprotocol/servers#5559 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
jxxghp/MoviePilot#7449 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
devops help wanted
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
guaardvark/guaardvark#421 ·
Maintainer thường phản hồi trong vòng 2 ngày