XIP — Réseau social « sans modération »

SPA satirique : un chat public en temps réel où ton pseudo = ton adresse IP, noyé sous les pubs et le merchandising. Catalogue de messages distant, liste perso de favoris, statistiques dérivées, marketplace à crédits fictifs, thèmes (dont WhatsApp).

🌐 Application déployée : https://xip.kerboul.me

---

Stack

Couche	Technologies
Frontend	Vue 3 (<script setup>, Composition API), Vite, TypeScript, vue-router
Backend	Bun, Hono, Prisma, PostgreSQL, Redis (WebSocket temps réel)
Tests	Vitest, @vue/test-utils, happy-dom
Déploiement	Docker, nginx, Traefik, CI Gitea Actions (auto-deploy sur push main)

Pas de framework de composants prêts-à-l'emploi : tout le découpage et le CSS sont faits à la main.

---

Fonctionnalités

• Chat temps réel (WebSocket) : messages, réponses en thread, présence, stats live qui défilent.
• Explorer (/explorer) : catalogue distant paginé (défilement infini), recherche debouncée et annulable (AbortController), filtre.
• Détail d'un message (/message/:id) et d'un produit (/shop/p/:id) par identifiant d'URL.
• Favoris (/favoris) : liste personnelle persistée en localStorage, notation (note + statut + commentaire), reflétée partout (★).
• Mes stats (/mes-stats) : synthèse dérivée des favoris (note moyenne, répartition par pays, top auteurs…), mise à jour automatique ; page gardée (inaccessible si aucun favori).
• Marketplace à crédits fictifs : cosmétiques (couleur d'IP, pets, skin du bouton d'envoi), abonnement NoAds, messages riches (HTML/CSS, et JS en iframe sandbox), pièces jointes.
• Thèmes dynamiques (Classique, Bulles, Compact, WhatsApp), persistés.
• Géolocalisation des IP (drapeau + ville) sur chaque message.

---

Lancer en local

Prérequis : Bun + Docker (pour Postgres/Redis).

bun install
bun run dev:stack

dev:stack lève Postgres + Redis (docker compose), applique les migrations Prisma, seede la base, puis démarre le backend (http://localhost:3000) et le frontend (http://localhost:5173).

En local, le paywall est désactivé (tout gratuit).

---

Tests

bun run --cwd frontend test       # exécution
bun run --cwd frontend test:cov   # avec couverture

Couvre la logique d'état (favoris, wallet, perks), des fonctions réutilisables (parseMeta, debounce, couleur d'IP) et l'interaction de composants (ThemePicker, SearchBox). Couverture ≈ 86 % sur le code métier ciblé.

Vérifications

bun run --cwd frontend typecheck  # vue-tsc, 0 erreur
bun run --cwd frontend build      # build de production
bun run --cwd backend typecheck   # tsc, 0 erreur

---

Configuration / secrets

Aucun secret dans le code. Copier les exemples committés et renseigner les vraies valeurs (les .env réels sont gitignorés) :

• backend/.env.example → backend/.env (dév local)
• .env.prod.example → .env.prod (production)

---

Déploiement

Déploiement continu : tout push sur main déclenche la CI Gitea qui rebuild et redéploie la stack Docker derrière Traefik. Détails dans DEPLOY.md.

---

Auteurs

• Ethan Puyaubreau
• Raphaël Thieffry
• Antonin Russac