feat: WS /t2/live — proxy Gemini Live API — 124/124 tests

This commit is contained in:
Hermann_Kitio 2026-04-17 03:39:21 +03:00
parent f08be960b0
commit 653fc3150e
8 changed files with 422 additions and 66 deletions

View file

@ -1,6 +1,6 @@
# ARCHITECTURE.md — Expria / Coach TCF Canada
> **Document de référence — Version 1.1**
> **Document de référence — Version 1.2**
> Ce document décrit l'architecture technique complète du projet.
> Toute décision architecturale majeure doit être documentée ici avant d'être implémentée.
> À lire conjointement avec PLANS_TARIFAIRES.md et PARCOURS_UTILISATEURS.md.
@ -424,35 +424,17 @@ NODE_ENV=production
## 9. Déploiement
### Contexte — Contrainte d'hébergement Git
### Hébergement Git — GitHub
GitHub et GitLab appliquent les sanctions américaines OFAC qui restreignent l'accès
aux résidents de Crimée. Ces plateformes ne sont pas utilisables de façon fiable
pour ce projet.
**Solution actuelle (Phase 1 — MVP) :**
Codeberg (plateforme européenne, Allemagne) pour l'hébergement Git privé.
Render ne supporte pas l'auto-deploy depuis Codeberg — le déploiement est donc manuel.
**Évolution prévue (Phase 2 — après premiers revenus) :**
Migration vers un VPS Hetzner (3,29€/mois) avec Coolify.
Coolify supporte l'auto-deploy depuis n'importe quel serveur Git privé (Codeberg, Gitea).
Cette migration supprime la dépendance à Render et restaure l'auto-deploy complet.
---
### Hébergement Git — Codeberg (Phase 1)
- Plateforme : codeberg.org (Allemagne — hors juridiction américaine)
- Dépôts : privés
- Dépôt frontend : `https://codeberg.org/Hermann_Kitio/expria-frontend`
- Dépôt backend : `https://codeberg.org/Hermann_Kitio/expria-backend`
- Dépôt archive (ancienne version) : `https://codeberg.org/Hermann_Kitio/Expria`
- Limitation : pas d'auto-deploy natif vers Render
- Plateforme : github.com
- Dépôt frontend : `https://github.com/germannoff/expria-frontend`
- Dépôt backend : `https://github.com/germannoff/expria-backend`
- Note : compte GitHub réactivé le 17 avril 2026 après restriction OFAC levée
- Auto-deploy : disponible via Render (connecté à GitHub)
### Frontend — Cloudflare Pages
- Source : dépôt Codeberg `expria-frontend`
- Source : dépôt GitHub `expria-frontend`
- Build command : `npm run build`
- Output directory : `dist`
- Domaine : `expria.app` (DNS pointé depuis Vercel vers Cloudflare Pages)
@ -466,23 +448,15 @@ npx wrangler pages deploy dist --project-name=expria
### Backend — Render
- Source : dépôt Codeberg `expria-backend`
- Source : dépôt GitHub `expria-backend`
- Type : Web Service (Node.js)
- Région : Frankfurt (EU) — proximité utilisateurs Afrique du Nord
- Build command : `npm run build`
- Start command : `npm start`
- Domaine : `api.expria.app`
- Domaine : `api.expria.app` (certificat SSL actif)
- URL Render : `https://expria-backend.onrender.com` (alias)
- WebSocket : activé nativement sur Render
- Déploiement : **manuel via Render CLI ou dashboard**
```bash
# Commande de déploiement backend
# Option 1 : via Render CLI
render deploy
# Option 2 : via dashboard Render
# → Manual Deploy → Deploy latest commit
```
- Déploiement : **automatique à chaque push sur main (GitHub → Render)**
### Base de données — Supabase
@ -490,39 +464,18 @@ render deploy
- Migrations : versionnées dans `supabase/migrations/`
- Déploiement : `supabase db push` (manuel, après validation)
### Procédure de déploiement complète (Phase 1)
### Procédure de déploiement complète
```
1. Tester localement (npm run test — tous les tests verts)
2. Rejouer le Golden Dataset
3. Commit + push sur Codeberg (branche main)
4. Déployer le backend : render deploy (ou dashboard Render)
3. Commit + push sur GitHub (branche main)
4. Backend : auto-deploy Render déclenché automatiquement
5. Déployer le frontend : npm run build && npx wrangler pages deploy dist
6. Vérifier les URLs de production (expria.app + api.expria.app)
7. Rejouer le Smoke Test (Groupe Z du Golden Dataset)
```
### Évolution Phase 2 — VPS Hetzner + Coolify
Quand Expria génère ses premiers revenus, migrer vers :
```
Codeberg (Git privé — inchangé)
↓ auto-deploy via webhook
Coolify sur VPS Hetzner CAX11 (3,29€/mois)
— remplace Render pour le backend
— auto-deploy natif depuis Codeberg
— Docker, SSL automatique, logs intégrés
Supabase (inchangé)
```
Avantages de la Phase 2 :
- Auto-deploy restauré (push → déploiement automatique)
- Coût réduit (3,29€/mois vs Render Starter)
- Aucune dépendance à une plateforme américaine pour le backend
- Cloudflare Pages reste pour le frontend (gratuit, CDN mondial)
---
## 10. Règles de développement