Initial commit: AudiOhm - Alternative Spotify avec streaming YouTube

Backend:
- FastAPI avec PostgreSQL et Redis
- Authentification JWT complète
- API REST pour musique, playlists, recherche
- Streaming audio via yt-dlp
- SQLAlchemy 2.0 async

Frontend:
- Flutter avec thème néon cyberpunk
- State management Riverpod
- Layout adaptatif desktop/mobile
- Lecteur audio avec mini-player

Infrastructure:
- Docker Compose (PostgreSQL + Redis)
- Scripts d'installation automatisés
- Scripts de build pour exécutables

Fichiers ajoutés:
- BUILD_CLIENT_*.bat/sh: Scripts de compilation
- BUILD_CLIENT_README.md: Documentation compilation
- CHECK_FLUTTER.sh: Vérificateur d'environnement
- requirements.txt mis à jour pour Python 3.13
- Modèles SQLAlchemy corrigés (metadata -> extra_metadata)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
root
2026-01-18 20:08:36 +00:00
commit a89c7894cf
132 changed files with 23178 additions and 0 deletions
+724
View File
@@ -0,0 +1,724 @@
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Spotify Le 2 - Design Preview Neon Cyberpunk</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;500;600;700&display=swap" rel="stylesheet">
<style>
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
:root {
--bg-primary: #0A0E27;
--bg-surface: #1A1F3A;
--bg-surface-variant: #252B4A;
--color-primary: #00F0FF;
--color-secondary: #BF00FF;
--color-accent: #FF006E;
--color-success: #39FF14;
--color-warning: #FFD600;
--color-error: #FF2A6D;
--text-on-bg: #E0E6FF;
--text-on-surface: #B0B8D4;
--text-muted: #6A7294;
}
body {
font-family: 'Outfit', sans-serif;
background-color: var(--bg-primary);
color: var(--text-on-bg);
min-height: 100vh;
overflow-x: hidden;
position: relative;
}
/* Scanlines overlay effect */
body::before {
content: '';
position: fixed;
top: 0;
left: 0;
width: 100%;
height: 100%;
background: repeating-linear-gradient(
0deg,
rgba(0, 240, 255, 0.03) 0px,
rgba(0, 240, 255, 0.03) 1px,
transparent 1px,
transparent 2px
);
pointer-events: none;
z-index: 1000;
}
.container {
max-width: 1400px;
margin: 0 auto;
padding: 40px 20px;
}
/* Header */
.header {
text-align: center;
margin-bottom: 60px;
position: relative;
}
.header h1 {
font-size: 48px;
font-weight: 700;
background: linear-gradient(135deg, var(--color-primary), var(--color-secondary));
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
background-clip: text;
text-shadow: 0 0 60px rgba(0, 240, 255, 0.5);
margin-bottom: 10px;
}
.header p {
color: var(--text-muted);
font-size: 18px;
}
/* Section */
.section {
margin-bottom: 60px;
}
.section-title {
font-size: 28px;
font-weight: 600;
margin-bottom: 30px;
color: var(--color-primary);
display: flex;
align-items: center;
gap: 15px;
}
.section-title::before {
content: '';
width: 4px;
height: 30px;
background: linear-gradient(180deg, var(--color-primary), var(--color-secondary));
border-radius: 2px;
}
/* Color Palette Grid */
.color-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
gap: 20px;
margin-bottom: 40px;
}
.color-card {
background: var(--bg-surface);
border-radius: 12px;
padding: 20px;
border: 1px solid rgba(0, 240, 255, 0.1);
transition: all 0.3s ease;
cursor: pointer;
}
.color-card:hover {
transform: translateY(-4px);
box-shadow: 0 10px 40px rgba(0, 240, 255, 0.2);
border-color: var(--color-primary);
}
.color-swatch {
width: 100%;
height: 80px;
border-radius: 8px;
margin-bottom: 12px;
position: relative;
overflow: hidden;
}
.color-swatch::after {
content: '';
position: absolute;
top: 0;
left: 0;
right: 0;
bottom: 0;
background: linear-gradient(135deg, rgba(255,255,255,0.1) 0%, transparent 50%);
}
.color-name {
font-weight: 600;
font-size: 14px;
margin-bottom: 4px;
}
.color-hex {
font-family: 'Courier New', monospace;
font-size: 12px;
color: var(--text-muted);
}
/* Buttons */
.button-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
gap: 20px;
}
.btn {
padding: 14px 28px;
border-radius: 8px;
font-family: 'Outfit', sans-serif;
font-size: 14px;
font-weight: 600;
border: none;
cursor: pointer;
transition: all 0.2s ease;
position: relative;
overflow: hidden;
}
.btn-primary {
background: linear-gradient(135deg, var(--color-primary), var(--color-secondary));
color: var(--bg-primary);
box-shadow: 0 4px 20px rgba(0, 240, 255, 0.4);
}
.btn-primary:hover {
transform: scale(1.02);
box-shadow: 0 6px 30px rgba(0, 240, 255, 0.6);
}
.btn-primary:active {
transform: scale(0.98);
}
.btn-secondary {
background: transparent;
color: var(--color-primary);
border: 2px solid var(--color-primary);
}
.btn-secondary:hover {
background: rgba(0, 240, 255, 0.1);
box-shadow: 0 0 20px rgba(0, 240, 255, 0.3);
}
.btn-accent {
background: var(--color-accent);
color: white;
box-shadow: 0 4px 20px rgba(255, 0, 110, 0.4);
}
.btn-accent:hover {
transform: scale(1.02);
box-shadow: 0 6px 30px rgba(255, 0, 110, 0.6);
}
/* Cards */
.card-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
gap: 25px;
}
.card {
background: var(--bg-surface);
border-radius: 16px;
overflow: hidden;
border: 1px solid rgba(0, 240, 255, 0.15);
transition: all 0.3s ease;
}
.card:hover {
transform: translateY(-6px);
box-shadow: 0 15px 50px rgba(0, 240, 255, 0.2);
border-color: var(--color-primary);
}
.card-image {
width: 100%;
height: 200px;
background: linear-gradient(135deg, var(--color-primary), var(--color-secondary));
display: flex;
align-items: center;
justify-content: center;
position: relative;
}
.card-image::after {
content: '►';
font-size: 48px;
color: rgba(255,255,255,0.8);
}
.card-content {
padding: 20px;
}
.card-title {
font-size: 18px;
font-weight: 600;
margin-bottom: 8px;
}
.card-subtitle {
font-size: 14px;
color: var(--text-muted);
margin-bottom: 12px;
}
.card-meta {
display: flex;
gap: 15px;
font-size: 12px;
color: var(--text-on-surface);
}
/* Player Mini */
.player-preview {
background: var(--bg-surface);
border-radius: 16px;
padding: 20px;
border: 1px solid rgba(0, 240, 255, 0.2);
position: relative;
overflow: hidden;
}
.player-preview::before {
content: '';
position: absolute;
top: 0;
left: 0;
right: 0;
height: 3px;
background: linear-gradient(90deg, var(--color-primary), var(--color-secondary), var(--color-accent));
}
.player-info {
display: flex;
align-items: center;
gap: 20px;
margin-bottom: 20px;
}
.player-art {
width: 80px;
height: 80px;
background: linear-gradient(135deg, var(--color-secondary), var(--color-accent));
border-radius: 12px;
display: flex;
align-items: center;
justify-content: center;
font-size: 32px;
box-shadow: 0 8px 30px rgba(191, 0, 255, 0.4);
}
.player-text {
flex: 1;
}
.player-title {
font-size: 18px;
font-weight: 600;
margin-bottom: 4px;
}
.player-artist {
font-size: 14px;
color: var(--text-muted);
}
.player-controls {
display: flex;
align-items: center;
justify-content: center;
gap: 30px;
}
.control-btn {
width: 50px;
height: 50px;
border-radius: 50%;
background: var(--bg-surface-variant);
border: none;
color: var(--text-on-bg);
font-size: 20px;
cursor: pointer;
transition: all 0.2s ease;
display: flex;
align-items: center;
justify-content: center;
}
.control-btn:hover {
background: var(--color-primary);
color: var(--bg-primary);
box-shadow: 0 0 20px rgba(0, 240, 255, 0.5);
}
.control-btn.play {
width: 60px;
height: 60px;
background: linear-gradient(135deg, var(--color-primary), var(--color-secondary));
font-size: 24px;
box-shadow: 0 4px 25px rgba(0, 240, 255, 0.5);
}
.progress-bar {
width: 100%;
height: 6px;
background: var(--bg-surface-variant);
border-radius: 3px;
overflow: hidden;
margin-top: 20px;
}
.progress-fill {
width: 35%;
height: 100%;
background: linear-gradient(90deg, var(--color-primary), var(--color-secondary));
border-radius: 3px;
position: relative;
}
.progress-fill::after {
content: '';
position: absolute;
right: 0;
top: 50%;
transform: translateY(-50%);
width: 12px;
height: 12px;
background: var(--color-primary);
border-radius: 50%;
box-shadow: 0 0 10px var(--color-primary);
}
/* Input Fields */
.input-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
gap: 20px;
}
.input-group {
position: relative;
}
.input-field {
width: 100%;
padding: 16px 20px;
background: var(--bg-surface);
border: 2px solid rgba(0, 240, 255, 0.2);
border-radius: 10px;
color: var(--text-on-bg);
font-family: 'Outfit', sans-serif;
font-size: 14px;
transition: all 0.3s ease;
}
.input-field:focus {
outline: none;
border-color: var(--color-primary);
box-shadow: 0 0 20px rgba(0, 240, 255, 0.3);
}
.input-field::placeholder {
color: var(--text-muted);
}
/* Search Bar */
.search-preview {
position: relative;
max-width: 600px;
margin: 0 auto;
}
.search-input {
width: 100%;
padding: 18px 60px 18px 24px;
background: var(--bg-surface);
border: 2px solid rgba(0, 240, 255, 0.2);
border-radius: 50px;
color: var(--text-on-bg);
font-family: 'Outfit', sans-serif;
font-size: 16px;
transition: all 0.3s ease;
}
.search-input:focus {
outline: none;
border-color: var(--color-primary);
box-shadow: 0 0 30px rgba(0, 240, 255, 0.4);
}
.search-icon {
position: absolute;
right: 24px;
top: 50%;
transform: translateY(-50%);
color: var(--color-primary);
font-size: 20px;
}
/* Tags */
.tags-container {
display: flex;
flex-wrap: wrap;
gap: 12px;
}
.tag {
padding: 8px 16px;
background: var(--bg-surface);
border: 1px solid rgba(0, 240, 255, 0.3);
border-radius: 20px;
font-size: 13px;
color: var(--color-primary);
transition: all 0.2s ease;
cursor: pointer;
}
.tag:hover {
background: rgba(0, 240, 255, 0.1);
border-color: var(--color-primary);
box-shadow: 0 0 15px rgba(0, 240, 255, 0.3);
}
.tag.active {
background: linear-gradient(135deg, var(--color-primary), var(--color-secondary));
color: var(--bg-primary);
border-color: transparent;
}
/* Animations */
@keyframes pulse-glow {
0%, 100% { box-shadow: 0 0 20px rgba(0, 240, 255, 0.4); }
50% { box-shadow: 0 0 40px rgba(0, 240, 255, 0.8); }
}
.glow-pulse {
animation: pulse-glow 2s infinite;
}
@keyframes gradient-shift {
0% { background-position: 0% 50%; }
50% { background-position: 100% 50%; }
100% { background-position: 0% 50%; }
}
.gradient-text {
background: linear-gradient(90deg, var(--color-primary), var(--color-secondary), var(--color-accent), var(--color-primary));
background-size: 300% 100%;
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
background-clip: text;
animation: gradient-shift 3s infinite;
}
</style>
</head>
<body>
<div class="container">
<!-- Header -->
<div class="header">
<h1 class="gradient-text">Spotify Le 2</h1>
<p>Design System - Néon Cyberpunk Theme</p>
</div>
<!-- Color Palette -->
<div class="section">
<h2 class="section-title">Palette de Couleurs</h2>
<div class="color-grid">
<div class="color-card">
<div class="color-swatch" style="background: #0A0E27;"></div>
<div class="color-name">Background Primary</div>
<div class="color-hex">#0A0E27</div>
</div>
<div class="color-card">
<div class="color-swatch" style="background: #1A1F3A;"></div>
<div class="color-name">Background Surface</div>
<div class="color-hex">#1A1F3A</div>
</div>
<div class="color-card">
<div class="color-swatch" style="background: #00F0FF;"></div>
<div class="color-name">Primary (Cyan)</div>
<div class="color-hex">#00F0FF</div>
</div>
<div class="color-card">
<div class="color-swatch" style="background: #BF00FF;"></div>
<div class="color-name">Secondary (Violet)</div>
<div class="color-hex">#BF00FF</div>
</div>
<div class="color-card">
<div class="color-swatch" style="background: #FF006E;"></div>
<div class="color-name">Accent (Rose)</div>
<div class="color-hex">#FF006E</div>
</div>
<div class="color-card">
<div class="color-swatch" style="background: #39FF14;"></div>
<div class="color-name">Success (Vert)</div>
<div class="color-hex">#39FF14</div>
</div>
</div>
</div>
<!-- Buttons -->
<div class="section">
<h2 class="section-title">Boutons</h2>
<div class="button-grid">
<button class="btn btn-primary glow-pulse">Primary Button</button>
<button class="btn btn-secondary">Secondary Button</button>
<button class="btn btn-accent">Accent Button</button>
</div>
</div>
<!-- Cards -->
<div class="section">
<h2 class="section-title">Cards (Tracks/Albums)</h2>
<div class="card-grid">
<div class="card">
<div class="card-image"></div>
<div class="card-content">
<div class="card-title">Midnight City</div>
<div class="card-subtitle">M83</div>
<div class="card-meta">
<span>4:03</span>
<span></span>
<span>Electronic</span>
</div>
</div>
</div>
<div class="card">
<div class="card-image" style="background: linear-gradient(135deg, #FF006E, #BF00FF);"></div>
<div class="card-content">
<div class="card-title">Blinding Lights</div>
<div class="card-subtitle">The Weeknd</div>
<div class="card-meta">
<span>3:20</span>
<span></span>
<span>Synthwave</span>
</div>
</div>
</div>
<div class="card">
<div class="card-image" style="background: linear-gradient(135deg, #39FF14, #00F0FF);"></div>
<div class="card-content">
<div class="card-title">Nightcall</div>
<div class="card-subtitle">Kavinsky</div>
<div class="card-meta">
<span>4:18</span>
<span></span>
<span>Retrowave</span>
</div>
</div>
</div>
</div>
</div>
<!-- Player -->
<div class="section">
<h2 class="section-title">Mini Player</h2>
<div class="player-preview">
<div class="player-info">
<div class="player-art">🎵</div>
<div class="player-text">
<div class="player-title">Resonance</div>
<div class="player-artist">Home</div>
</div>
</div>
<div class="player-controls">
<button class="control-btn"></button>
<button class="control-btn play"></button>
<button class="control-btn"></button>
</div>
<div class="progress-bar">
<div class="progress-fill"></div>
</div>
</div>
</div>
<!-- Search -->
<div class="section">
<h2 class="section-title">Barre de Recherche</h2>
<div class="search-preview">
<input type="text" class="search-input" placeholder="Rechercher des tracks, artistes, albums...">
<span class="search-icon">🔍</span>
</div>
</div>
<!-- Input Fields -->
<div class="section">
<h2 class="section-title">Champs de Saisie</h2>
<div class="input-grid">
<div class="input-group">
<input type="text" class="input-field" placeholder="Email">
</div>
<div class="input-group">
<input type="password" class="input-field" placeholder="Password">
</div>
</div>
</div>
<!-- Tags -->
<div class="section">
<h2 class="section-title">Tags / Genres</h2>
<div class="tags-container">
<span class="tag">Electronic</span>
<span class="tag active">Synthwave</span>
<span class="tag">Retrowave</span>
<span class="tag">Cyberpunk</span>
<span class="tag">Dark Synth</span>
<span class="tag">Dream Pop</span>
</div>
</div>
<!-- Typography Demo -->
<div class="section">
<h2 class="section-title">Typographie</h2>
<div style="color: var(--text-on-bg);">
<h1 style="font-size: 32px; margin-bottom: 10px;">Heading 1 - 32px Bold</h1>
<h2 style="font-size: 24px; margin-bottom: 10px;">Heading 2 - 24px SemiBold</h2>
<h3 style="font-size: 20px; margin-bottom: 10px;">Heading 3 - 20px SemiBold</h3>
<p style="font-size: 16px; margin-bottom: 10px; color: var(--text-on-bg);">Body Large - 16px Regular - Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
<p style="font-size: 14px; margin-bottom: 10px; color: var(--text-on-surface);">Body - 14px Regular - Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
<p style="font-size: 12px; color: var(--text-muted);">Caption - 12px Regular - Texte secondaire ou métadonnées.</p>
</div>
</div>
</div>
<script>
// Interactive demo - button clicks
document.querySelectorAll('.control-btn').forEach(btn => {
btn.addEventListener('click', function() {
this.style.transform = 'scale(0.95)';
setTimeout(() => {
this.style.transform = '';
}, 100);
});
});
// Tags toggle
document.querySelectorAll('.tag').forEach(tag => {
tag.addEventListener('click', function() {
this.classList.toggle('active');
});
});
// Cards hover effect enhancement
document.querySelectorAll('.card').forEach(card => {
card.addEventListener('mouseenter', function() {
this.style.borderColor = 'var(--color-primary)';
});
card.addEventListener('mouseleave', function() {
this.style.borderColor = 'rgba(0, 240, 255, 0.15)';
});
});
</script>
</body>
</html>
File diff suppressed because it is too large Load Diff
+273
View File
@@ -0,0 +1,273 @@
# Spotify Le 2 - UI/UX Design Document
**Date:** 2025-01-18
**Thème:** Néon Cyberpunk
**Priorité:** Interface fluide (navigation instantanée, contrôles réactifs, chargement progressif)
---
## 1. Architecture Globale
### Stack Technique
- **Frontend:** Flutter (Dart 3.2+) avec Riverpod pour state management
- **Backend:** Python + FastAPI
- **Base de données:** PostgreSQL 15+
- **Cache:** Redis 7+
### Layout Adaptatif
**Desktop (Windows/Linux):**
- Sidebar navigation à gauche (240px fixe)
- Zone de contenu principale avec AdaptiveScaffold
- Player persistant en bas de l'écran (mini player)
- Modal fullscreen pour player complet
**Mobile (Android):**
- Bottom navigation bar (4 onglets)
- Content zone avec AppBars dynamiques
- Mini player en bas (sticky)
- Fullscreen player avec swipe-up
### State Management (Riverpod)
```dart
- StateProvider UI simple (current page, theme)
- StateNotifierProvider Player state (contrôles réactifs)
- AsyncNotifierProvider API data avec cache automatique
- StreamProvider Player progress (60fps)
```
### Optimisations Fluidité
1. **Preloading** - Données page suivante en arrière-plan
2. **Image caching** - cached_network_image avec cache disque infini
3. **ListView builder** - Rendu progressif longues listes
4. **Isolates** - Traitement lourd dans isolates séparés
---
## 2. Thème Néon Cyberpunk
### Palette de Couleurs
```dart
class AppColors {
// Backgrounds
static const primary = Color(0xFF0A0E27); // Bleu nuit très foncé
static const surface = Color(0xFF1A1F3A); // Bleu nuit
static const surfaceVariant = Color(0xFF252B4A);
// Accent colors
static const cyan = Color(0xFF00F0FF); // Cyan électrique néon
static const violet = Color(0xFFBF00FF); // Violet/magenta néon
static const rose = Color(0xFFFF006E); // Rose néon vif
static const vert = Color(0xFF39FF14); // Vert néon matrix
static const jaune = Color(0xFFFFD600); // Jaune néon
static const rouge = Color(0xFFFF2A6D); // Rouge néon
// Text
static const onBg = Color(0xFFE0E6FF); // Blanc bleuté
static const onSurface = Color(0xFFB0B8D4); // Bleu gris clair
static const muted = Color(0xFF6A7294); // Bleu gris désaturé
}
```
### Typographie
```dart
Font family: 'Outfit' (Google Fonts)
Sizes:
- H1: 32px/700 (titres pages)
- H2: 24px/600 (sections)
- H3: 20px/600 (cards headers)
- Body large: 16px/400
- Body: 14px/400
- Caption: 12px/400
```
### Effets Visuels
1. **Glow effects**
```dart
BoxShadow(
color: AppColors.cyan.withOpacity(0.3),
blurRadius: 20,
spreadRadius: 2,
)
```
2. **Gradient borders** - Dégradés cyan→violet sur cards importantes
3. **Glassmorphism** - Surfaces semi-transparentes avec blur
4. **Scanlines** - Overlay subtil sur backgrounds (style retro)
### Animation Standards
- Durée: 200ms (rapide pour réactivité)
- Courbe: curves.easeOutCubic
- Hover: scale(1.02) + glow intensifié
- Press: scale(0.98) immédiat
---
## 3. Composants UI Critiques
### Mini Player
**Priorité:** Contrôles réactifs (réponse < 50ms)
```dart
- Stream 60fps pour progress bar
- setState synchrone pour mises à jour
- Slider sans animation de transition
- Contrôles avec feedback immédiat
```
### Infinite Scroll
```dart
- ListView.builder pour rendu progressif
- Préchargement 5 items avant fin
- PaginatedAsyncNotifier
- Shimmer placeholder pendant chargement
```
### Image Caching
```dart
- CachedNetworkImage avec cache infini
- Placeholder gradient animé
- Fallback gradient on error
- FadeIn 200ms
```
---
## 4. Navigation
### Desktop Layout
```
┌────────────────────────────────────────────────────┐
│ Sidebar │ Main Content │ Right Panel │
│ (240px) │ │ (320px) │
│ │ │ │
│ - Home │ Top Bar │ Queue / Now Playing │
│ - Search│──────────────│ │
│ - Lib │ Page Content │ │
│ - Play │ │ │
│ │ │ │
│ │ │ │
├─────────┴───────────────┴───────────────────────────┤
│ Mini Player (persistent) │
└────────────────────────────────────────────────────┘
```
### Mobile Layout
```
┌────────────────────┐
│ Top Bar │
├────────────────────┤
│ │
│ Page Content │
│ │
│ │
├────────────────────┤
│ Mini Player │
├────────────────────┤
│ Bottom Nav (56px) │
└────────────────────┘
```
### Pages Principales
- Home (Sections: Recommanded, Recently Played, New Releases)
- Search (Barre recherche + Résultats)
- Library (Playlists, Albums, Artists)
- Settings
---
## 5. Structure du Projet Flutter
```
lib/
├── main.dart
├── core/
│ ├── constants/
│ │ ├── app_constants.dart
│ │ └── api_constants.dart
│ ├── theme/
│ │ ├── app_theme.dart
│ │ ├── colors.dart
│ │ └── text_styles.dart
│ └── utils/
│ ├── validators.dart
│ └── formatters.dart
├── domain/
│ ├── entities/
│ │ ├── user.dart
│ │ ├── track.dart
│ │ ├── playlist.dart
│ │ └── artist.dart
│ └── repositories/
│ └── (repository interfaces)
├── infrastructure/
│ ├── datasources/
│ │ ├── local/
│ │ └── remote/
│ └── repositories/
│ └── (repository implementations)
└── presentation/
├── providers/
│ ├── auth_provider.dart
│ ├── music_provider.dart
│ └── navigation_provider.dart
├── pages/
│ ├── desktop/
│ ├── mobile/
│ ├── home/
│ ├── search/
│ └── library/
└── widgets/
├── common/
├── player/
└── adaptive/
```
---
## 6. Critères de Succès
### Performance
- Navigation < 100ms entre pages
- Contrôles player < 50ms de latence
- Scroll 60fps constant
- Images chargées progressivement sans blocking
### UX
- Interface adaptative seamless
- Feedback visuel immédiat sur toutes interactions
- États de chargement clairs
- Gestion d'erreur gracieuse
### Design
- Cohérence visuelle néon cyberpunk
- Hiérarchie visuelle claire
- Accessibilité (contrast ratios)
- Animations fluides (200ms)
---
## Prototype
Un preview HTML du design est disponible dans: `docs/design-preview.html`
Ouvrir dans un navigateur pour voir:
- Palette de couleurs interactive
- Composants UI stylisés
- Effets néon cyberpunk
- Animations et interactions
+27
View File
@@ -0,0 +1,27 @@
# Search Feature
## Overview
Real-time search with debouncing across tracks, artists, and albums.
## Usage
- Access from sidebar (desktop) or bottom nav (mobile)
- Type to search with 500ms debounce
- Results grouped by type
- Tap track to play immediately
- Tap artist/album for details (TODO)
## Components
- `SearchProvider` - State management with debouncing
- `SearchPage` - Adaptive UI (desktop/mobile)
- `SearchTrackCard`, `SearchArtistCard`, `SearchAlbumCard` - Result cards
- `CachedNetworkImageWithFallback` - Reusable image widget
## Architecture
- Uses typed entities (Track, Artist, Album) from domain layer
- Integrates with MusicApiService for backend calls
- Connects to PlayerNotifier for playback
## Testing
Test stubs created at:
- `test/presentation/providers/search_provider_test.dart`
- `test/presentation/pages/search/search_page_test.dart`