Import de morceau par lien — socle : registre de providers + Deezer
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 35/100
調査の方向性
Start by reading the existing Song model, API routing and JWTAuth setup, cache package, and SongForm.svelte to understand how imports fit the current flow. Then design the provider interface and registry around the Deezer API, while accounting for the different authentication needs of future providers. Done means the import endpoint and editable form prefill meet the listed acceptance criteria, including fallback, timeout, rate limiting, and caching; the issue names make test-backend the verification command.
索引モデルが issue の本文から書いたものです。
説明
Objectif
Permettre de créer une chanson en collant simplement un lien (Deezer, Spotify, YouTube…). L'application reconnaît la source toute seule et pré-remplit le formulaire.
L'utilisateur ne choisit jamais la source. Il colle une URL, l'app se débrouille.
Ce ticket pose le socle et livre un provider de référence (Deezer). Chaque source supplémentaire fera l'objet d'un ticket dédié, sur ce même socle.
Principe de mapping
Chaque provider récupère ce qu'il peut auprès de son API et remplit un maximum de champs du modèle Song : titre, durée, tonalité, tempo, album, paroles, liens… Les champs renvoyés par l'API qui ne correspondent à rien dans le modèle sont ignorés. Les champs du modèle que l'API ne fournit pas restent vides.
Pas de règle par champ : on prend le maximum de ce qui est disponible, l'utilisateur complète le reste à la main.
Tâches
Backend
- Interface provider — dans un nouveau package (
backend/api/service/musicimport/par exemple) :type Provider interface { Name() string Matches(u *url.URL) bool Fetch(ctx context.Context, u *url.URL) (TrackResult, error) } - Registre — une liste de providers enregistrés ; le premier dont
Matchesrenvoietruetraite l'URL. Ajouter un provider ne doit demander qu'une seule ligne d'enregistrement. TrackResult— une structure reprenant les champs demodel.Songsusceptibles d'être renseignés, tous optionnels.- Endpoint —
POST /api/song/importrecevant{"url": "..."}, protégé parJWTAuth. Il retourne les données sans créer la chanson : la création reste au formulaire existant, après validation par l'utilisateur. - Provider Deezer — reconnaît les URL
deezer.com(etdzr.page.link), appelle l'API publique Deezer (ni clé ni OAuth), mappe ce qu'elle renvoie. - Fallback — si aucun provider ne reconnaît l'URL, ne pas échouer : renvoyer un résultat vide contenant l'URL, que le front placera dans le champ
linksexistant. Coller un lien ne doit jamais être une impasse. - Robustesse — timeout de 5 s sur l'appel externe, erreurs typées via
apierror, rate limiting du endpoint (c'est un proxy vers un tiers). Une panne du fournisseur ne doit jamais empêcher de créer une chanson à la main. - Cache — mettre les résultats en cache Redis via
backend/cache/, TTL d'environ 1 h.
Frontend
- Dans
SongForm.svelte, ajouter au-dessus du formulaire un champ « Coller un lien ». À la validation, appeler l'endpoint et pré-remplir les champs retournés. - Tous les champs pré-remplis restent modifiables avant enregistrement.
Critères d'acceptation
- Coller une URL Deezer pré-remplit le formulaire avec les données disponibles
- L'utilisateur n'indique jamais de quelle plateforme vient le lien
- Tous les champs pré-remplis restent éditables
- Une URL non reconnue range le lien dans
linkssans erreur bloquante - Le fournisseur indisponible ou en timeout n'empêche pas la saisie manuelle
- Deux imports successifs de la même URL ne déclenchent qu'un appel externe
- Aucune clé d'API n'est exposée au navigateur
- Ajouter un provider ne demande que d'implémenter l'interface et de l'enregistrer
-
make test-backendpasse
⚠️ Point de vigilance
Le soin apporté à l'interface Provider conditionne tous les tickets suivants. Elle doit rester assez générique pour couvrir des API très différentes : Deezer ne demande aucune authentification, Spotify impose un OAuth, YouTube une clé et un quota.
- 主要言語
- 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 日以内に返信