Stocker la durée totale d'une setlist et l'afficher sur les cartes de la page d'accueil
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 35/100
- issue の種類
- 機能追加
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
- 技術スタック
- go, postgresql, redis, typescript
調査の方向性
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.
索引モデルが issue の本文から書いたものです。
説明
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
- 主要言語
- Python
- スター
- 2
- フォーク
- 0
- 平均マージ
- 21分
- マージ済み PR(30日)
- 2
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
Doud75/Setly のほかの issue
-
agent-ready chore
難易度 2/5 1〜3時間 初心者へのやさしさ 86/100
-
backend enhancement frontend security
難易度 4/5 3〜5日 初心者へのやさしさ 48/100
-
agent-ready backend enhancement frontend security
難易度 5/5 1週間以上 初心者へのやさしさ 25/100
-
agent-ready backend enhancement frontend security
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
-
agent-ready backend bug frontend security
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
marketcalls/openalgo#2472 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 95/100
marimo-team/marimo#11949 ·
メンテナーはふだん 1 日以内に返信
-
bug server-time v2
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
modelcontextprotocol/servers#5559 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
jxxghp/MoviePilot#7449 ·
メンテナーはふだん 1 日以内に返信
-
devops help wanted
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
guaardvark/guaardvark#421 ·
メンテナーはふだん 2 日以内に返信