Import de morceau par lien — socle : registre de providers + Deezer

Đang mở
#87 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ó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
go
Lĩnh vực
api, backend, frontend

Hướng nghiên cứu

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.

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

Mô tả

backend enhancement frontend

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
  1. 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)
    }
    
  2. Registre — une liste de providers enregistrés ; le premier dont Matches renvoie true traite l'URL. Ajouter un provider ne doit demander qu'une seule ligne d'enregistrement.
  3. TrackResult — une structure reprenant les champs de model.Song susceptibles d'être renseignés, tous optionnels.
  4. Endpoint — POST /api/song/import recevant {"url": "..."}, protégé par JWTAuth. Il retourne les données sans créer la chanson : la création reste au formulaire existant, après validation par l'utilisateur.
  5. Provider Deezer — reconnaît les URL deezer.com (et dzr.page.link), appelle l'API publique Deezer (ni clé ni OAuth), mappe ce qu'elle renvoie.
  6. 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 links existant. Coller un lien ne doit jamais être une impasse.
  7. 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.
  8. Cache — mettre les résultats en cache Redis via backend/cache/, TTL d'environ 1 h.
Frontend
  1. 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.
  2. 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 links sans 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-backend passe

⚠️ 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.

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.