MovixOpenSource/API/README.md
Movix 3a7ab5ad42 feat: synchronise le repo privé — Cast, sources, API et mobile 2.5.7
Gros lot de travail synchronisé depuis le repo privé. Cette mise à jour
regroupe la refonte du lecteur et du Cast, de nouvelles sources VOD/Live TV,
le durcissement de l’API et des proxies, ainsi qu’une nouvelle version de
l’application mobile.

Lecteur, sources et Live TV

- Refonte du lecteur HLS avec sélection et mémorisation de la qualité,
  détection des résolutions, scan des liens, choix des pistes audio et
  fallback contrôlé de 1080p vers 720p.
- Ajoute une garde contre les boucles de changement de source, notamment
  lors des erreurs vidéo et des réponses 429.
- Revoit SeekStreaming de bout en bout : validation des embeds, prise en
  charge de plusieurs candidats, regroupement par serveur, règles de headers
  persistantes et cache d’extraction raccourci.
- Ajoute SwiftFlow pour les films et séries, avec lecteurs VF/VOSTFR, cache
  stale-while-revalidate, déduplication des requêtes et limite partagée côté API.
- Adapte Coflix à son nouveau domaine et à son nouveau thème, ajoute un kill
  switch, développe les wrappers 1jour1film et actualise le domaine Wiflix.
- Ajoute NorthLive et Vavoo à la Live TV, regroupe les variantes d’une même
  chaîne et permet de choisir le serveur ou la qualité.
- Enrichit les Top 10 avec des filtres par période et par algorithme, ainsi
  que de nouvelles métriques de visionnage.

Cast et application mobile

- Unifie le contrôle Cast entre le Web Cast SDK et le pont Android :
  état distant, lecture, pause, seek, arrêt et reprise après reconnexion.
- Ajoute sur Android un relais média LAN sécurisé, limité au Chromecast et
  au réseau Wi-Fi sélectionnés, avec sessions opaques et service foreground.
- Prépare les sources avant diffusion et prend en charge les playlists HLS
  TS/fMP4, les flux progressifs, les sous-titres VTT, SeekStreaming et les
  segments MPEG-TS encapsulés dans des PNG.
- Renforce le proxy média local : support Range, validation des redirections,
  liaison DNS/socket au réseau Cast et meilleure gestion des headers Fsvid.
- Sécurise le bridge WebView avec contrôle de l’origine top-frame, capacités
  propres à chaque document et invalidation lors des navigations.
- Ajoute le Picture-in-Picture Android avec lecture/pause et seek de
  10 secondes depuis la fenêtre flottante.
- Maintient désormais l’écran allumé uniquement pendant une lecture active.
- Publie l’application Android 2.5.7, build 16, avec le nouvel APK et ses
  métadonnées d’intégrité.

API, base de données et paiements

- Remplace 13 migrations SQL isolées par un manifeste de schéma MySQL
  centralisé, additif et capable de détecter les divergences de structure.
- Ajoute le workflow db:init avec prévisualisation, dry-run, verrou MySQL,
  confirmations pour les tables Wrapped et couverture de tests dédiée.
- Rend configurables les limites du pool MySQL et fiabilise les advisory locks.
- Revoit entièrement PayGate : références de callback séparées, nonces,
  validation des wallets et transactions, états monotones, déduplication des
  paiements et protection contre les courses ou réutilisations de txid.
- Renforce l’annulation, la réconciliation et la livraison idempotente des
  factures VIP, avec réponses no-store sur les routes sensibles.
- Distingue les JWT invalides des indisponibilités MySQL afin de renvoyer
  correctement 401 ou 503 sans provoquer de déconnexions inutiles.
- Utilise ZZAPI/Claude Haiku pour la modération, avec OpenRouter/DeepSeek en
  solution de secours.
- Améliore la gestion HLS et Range dans proxiesembed.

Frontend, profils et infrastructure

- Protège la sélection et l’hydratation des profils contre les réponses
  concurrentes, les intentions obsolètes et l’effacement accidentel du
  stockage local.
- Rend VITE_SITE_URL obligatoire et l’injecte dans le runtime, les données
  structurées, le service worker, robots.txt et sitemap.xml.
- Optimise les probes réseau du service worker avec cache court et single-flight.
- Charge dynamiquement les traductions anglaises, plusieurs routes secondaires
  et les données Search/TMDB uniquement lorsqu’elles deviennent nécessaires.
- Ajoute des caches mémoire/session pour les images et contenus TMDB et réduit
  les animations, calculs et rendus hors écran.
- Ajoute la page publique des frais, les coins carrés persistants, une nouvelle
  intro Movix, les avertissements de publicités adultes et de nombreux textes
  Cast, qualité, Live TV et sources.
- Met à jour les extensions Chrome 1.3.12 et Firefox 1.5.9, ainsi que le
  userscript, avec la nouvelle extraction SeekStreaming et la préparation Cast.
- Ajoute une large couverture de tests Kotlin et JavaScript pour le Cast, le
  proxy média, le PiP, le bridge, la base de données, PayGate et le lecteur.
- Ajoute bootstrap-icons et patch-package, régénère les lockfiles npm et
  actualise la documentation d’installation et d’initialisation MySQL.

Co-authored-by: GPT-5.6 Sol <noreply@openai.com>
2026-08-02 12:09:37 +02:00

81 lines
3.2 KiB
Markdown

# Services backend Movix
Le dossier `API/` regroupe les services serveurs du projet. Le point clé à retenir : le backend applicatif actif est `API/Mainapi/`. Le vieux backend directement posé sous `API/` n'est plus la référence.
Movix ne tourne pas sur un seul serveur monolithique. Selon la feature, le frontend peut parler au backend principal, à la WatchParty, à un proxy Python, à un worker Cloudflare ou à un outil navigateur.
## Carte rapide
| Dossier | Rôle | Lancement | Documentation |
| --- | --- | --- | --- |
| `API/Mainapi/` | Cœur applicatif : auth, sync, scraping, social, VIP, Live TV | `cd API/Mainapi && npm run dev` | [README](Mainapi/README.md) |
| `API/watchpartyAPI/` | Service temps réel WatchParty | `node API/watchpartyAPI/watchparty.js` | [README](watchpartyAPI/README.md) |
| `API/proxiesembed/` | Proxy aiohttp pour embeds, flux et DRM | `cd API/proxiesembed && python server.py` | [README](proxiesembed/README.md) |
| `API/miscs/` | Micro-service Flask pour certains 403 | `cd API/miscs && python bypass403.py` | [README](miscs/README.md) |
## Setup minimal
Toutes les commandes suivantes partent de la racine du dépôt et reviennent explicitement à celle-ci entre les services.
### Configurer les `.env`
Avant de lancer les services backend, crée et renseigne leurs fichiers de configuration :
```bash
cp API/Mainapi/.env.example API/Mainapi/.env
cp API/watchpartyAPI/.env.example API/watchpartyAPI/.env
cp API/proxiesembed/.env.example API/proxiesembed/.env
cp API/miscs/.env.example API/miscs/.env
```
Configure au minimum `API/Mainapi/.env` avant d'initialiser son schéma MySQL.
```bash
# Backend principal
cd API/Mainapi
npm install
npm run db:init
cd ../..
```
`db:init` initialise ou complète le schéma MainAPI. Sur une base existante, et pour les grandes tables Wrapped, il demande des confirmations : lis les avertissements du [README MainAPI](Mainapi/README.md#initialiser-ou-compléter-le-schéma-mysql) avant de continuer.
```bash
# Services Python
cd API/proxiesembed
pip install -r requirements.txt
cd ../miscs
pip install flask requests python-dotenv
cd ../..
```
Note utile :
- `API/watchpartyAPI/` n'a pas son propre `package.json` ; il utilise les dépendances racine.
- `API/Mainapi/` garde ses dépendances Node.
- Il n'y a pas de workspace tooling pour tout orchestrer d'un coup.
## Comment lire cette partie du repo
- Si tu touches auth, profils ou persistance utilisateur, commence par `API/Mainapi/app.js` et `API/Mainapi/routes/`.
- Si tu touches la lecture en groupe, regarde `API/watchpartyAPI/watchparty.js` en miroir du frontend WatchParty.
- Si tu touches la lecture vidéo ou les hosters, il faut souvent croiser `API/Mainapi/`, `API/proxiesembed/`, `API/miscs/` et parfois `cloudflareproxy/`.
## Stockage et dépendances
Selon les services, le backend Movix s'appuie sur :
- MySQL
- Redis
- caches JSON sur disque
- stockage local en mémoire pour certains services temps réel
- SQLite et fichiers de data sur quelques briques annexes
## Lire ensuite
- [README principal](../README.md)
- [Main API](Mainapi/README.md)
- [WatchParty API](watchpartyAPI/README.md)
- [Proxies Embed](proxiesembed/README.md)
- [bypass403](miscs/README.md)