Create README.md
Cahier des Charges Fonctionnel & Technique — Senpaio
- Présentation Générale du Projet
Nom de la plateforme : Senpaio (senpaio.com)
Communauté porteuse : Senpai Squad
Nature du projet : Application Web moderne & Progressive Web App (PWA) de streaming, d'exploration et de catalogage d'animes.
Inspiration & Données : Intégration / passerelle basée sur l'écosystème de données d'Anime-Sama (via l'API TMCooper/AnimeSamaApi).
Positionnement : Plateforme indépendante, non-copie, avec une identité de marque forte, ultra-moderne et une expérience utilisateur haut de gamme. - Architecture & Type d'Application
2.1 Web App & PWA (Mobile & Desktop)
Format principal : Application web développée en Single Page Application (SPA / TanStack Start) avec navigation instantanée sans rechargement de page (zéro latence perçue, pas d'actualisation de style PHP classique).
Compatibilité mobile (PWA) : Installable directement sur smartphone (iOS / Android) comme une application native depuis le navigateur (icône sur l'écran d'accueil, affichage plein écran sans barre d'adresse, réactivité tactile).
Backend & Base de données : Supabase (Postgres, Row Level Security, tables d'utilisateurs, sessions, favoris, historique et transactions de pièces).
Authentification : Connexion directe en un clic via Google OAuth (gérée par Supabase). - Direction Artistique & UI / UX
Palette de couleurs :
Fond & structure : Contraste monochrome pur (Noir profond #0B0F12 et Blanc pur #FFFFFF).
Accent / Éclat : Vert glace trempé (Frosty Ice Mint / Cyber Jade #00F5A0 / #00D992), apportant une lueur moderne, dynamique et haut de gamme.
Style visuel :
Glassmorphism : Effets de verre dépoli (backdrop-blur), bordures translucides subtiles.
Bordures & Formes : Angles très arrondis (rounded-2xl, rounded-3xl), boutons pilules, cartes aérées.
Animations & Micro-interactions : Transitions douces à 60 FPS, retours haptiques/sonores discrets et futuristes lors des clics et validations.
Navigation :
Barre de recherche omnibox en temps réel avec suggestions instantanées.
Recommandations intelligentes et affichage dynamique des tendances ("Top de la semaine", "Dernières sorties", "Reprendre la lecture"). - Fonctionnalités Cœurs
4.1 Catalogue & Exploration
Recherche floue instantanée sans rechargement.
Filtres avancés : par genre, statut (en cours, terminé), saison/année, versions (VOSTFR, VF).
Fiches d'anime complètes : synopsis, casting, bandes-annonces, liste ordonnée des saisons, épisodes et OAV/films.
4.2 Lecteur Vidéo Avancé
Lecteur vidéo HTML5 / HLS ultra-optimisé.
Sélecteur de qualité à la volée (1080p, 720p, 360p, Auto).
Bascule fluide entre VOSTFR et VF en un clic.
Mémorisation de la progression à la seconde près.
Passage automatique à l'épisode suivant et raccourcis clavier.
4.3 Espace Téléchargement
Page dédiée permettant le téléchargement des épisodes pour visionnage hors-ligne.
Possibilité d'enregistrement direct sur l'appareil (galerie / dossier téléchargements).
4.4 Historique & Profil Utilisateur
Synchronisation continue dans Supabase :
Historique de visionnage avec barre de progression.
Listes personnalisées : "En cours", "À voir", "Favoris", "Terminés". - Modèle Économique & Monétisation
5.1 Système de Pièces ("Watch-to-Earn")
Les utilisateurs sans abonnement peuvent visionner de courtes publicités sponsorisées pour accumuler des pièces Senpaio.
Les pièces permettent de débloquer des épisodes en haute qualité, des téléchargements ou du temps de visionnage sans publicité.
5.2 Abonnements Flexibles & Accessibles
Formules pensées comme un compromis équitable (gagnant-gagnant) entre l'utilisateur et la plateforme :
Pass 24 Heures (1 Jour) : Micro-paiement très faible pour un marathon d'un soir.
Pass Hebdomadaire (1 Semaine) : Idéal pour les vacances ou le suivi d'une série.
Pass Mensuel (1 Mois) : Formule récurrente sans engagement à prix doux.
Avantages abonnés : Zéro publicité, qualité maximale garantie, téléchargements illimités, badge exclusif "Senpai Squad".
5.3 Encarts Publicitaires Optimisés
Emplacements publicitaires prévus nativement dans l'interface (bannières natives, interstitiels non-intrusifs, pop-unders modérés).
Intégration de régies publicitaires respectueuses de l'expérience utilisateur.
5.4 Affiliation & Parrainage
Liens de parrainage uniques par utilisateur : inviter un ami rapporte des pièces aux deux membres.
Référencement naturel (SEO) optimisé pour chaque anime et page d'épisode pour capter le trafic Google.
6. Feuille de Route Technique
Phase 1 : Création du squelette UI/UX responsive (Noir, Blanc, Vert Glace) avec TanStack / Tailwind / Shadcn.
Phase 2 : Configuration de Supabase (tables profils, favoris, historique, transactions pièces).
Phase 3 : Connecteur API AnimeSama pour alimenter le catalogue et le lecteur.
Phase 4 : Module de pièces, publicités et checkout pour abonnements (1j / 1s / 1m).
Phase 5 : Système de téléchargement et déploiement PWA.