Xalass est une plateforme de partage d'histoires anonymes où les utilisateurs peuvent créer, partager et interagir avec des posts de manière anonyme.
- ✅ Authentification anonyme avec UUID
- ✅ Création et publication de posts avec catégories
- ✅ Système de likes/réactions sur les posts
- ✅ Commentaires sur les posts
- ✅ Notifications en temps réel
- ✅ Recherche et filtrage par catégorie
- ✅ Profil utilisateur avec statistiques
- Frontend : HTML/CSS/JavaScript (Vanilla JS)
- Backend : Laravel (PHP) avec API REST
- Base de données : MySQL
- Authentification : Système anonyme avec UUID
Avant de commencer, assurez-vous d'avoir installé :
-
PHP >= 8.1 avec les extensions suivantes :
- BCMath
- Ctype
- Fileinfo
- JSON
- Mbstring
- OpenSSL
- PDO
- Tokenizer
- XML
-
Composer (gestionnaire de dépendances PHP)
-
MySQL >= 5.7 ou MariaDB >= 10.3
-
Python >= 3.7 (pour le serveur frontend) ou PHP (alternative)
-
Git
Windows (PowerShell) :
php --version
composer --version
python --version
mysql --versionLinux/Mac :
php --version
composer --version
python3 --version
mysql --versiongit clone <URL_DU_REPO>
cd Xalass-web-Frontendcd Xalass_Backend
composer installCopiez le fichier .env.example vers .env :
copy .env.example .envOu sur Linux/Mac :
cp .env.example .envOuvrez le fichier .env et configurez votre base de données :
DB_CONNECTION=mysql
DB_HOST=api.xalass.com
DB_PORT=3306
DB_DATABASE=xalass_db
DB_USERNAME=votre_utilisateur
DB_PASSWORD=votre_mot_de_passephp artisan key:generateCréez une base de données MySQL nommée xalass_db (ou le nom que vous avez configuré dans .env).
php artisan migrateCela créera toutes les tables nécessaires :
anonymous_users- Utilisateurs anonymesposts- Posts/histoirescomments- Commentairesreactions- Réactions (likes)notifications- Notifications
php artisan db:seed-
Lancer le Backend :
- Double-cliquez sur
LANCER_BACKEND.bat - Une fenêtre de terminal s'ouvre
- Vous devriez voir :
Server running on [https://api.xalass.com] ⚠️ Ne fermez PAS cette fenêtre
- Double-cliquez sur
-
Lancer le Frontend :
- Double-cliquez sur
LANCER_FRONTEND.bat - Une autre fenêtre de terminal s'ouvre
- Vous devriez voir :
Serving HTTP on 0.0.0.0 port 8080 ⚠️ Ne fermez PAS cette fenêtre
- Double-cliquez sur
-
Ouvrir l'application :
- Ouvrez votre navigateur
- Allez sur :
http://localhost:8080/xalass-login.html
cd Xalass_Backend
php artisan serveRésultat attendu :
INFO Server running on [https://api.xalass.com]
Option A : Python (Recommandé)
# Depuis la racine du dépôt (Xalass-web-Frontend)
python -m http.server 8080Option B : PHP
# Depuis la racine du dépôt (Xalass-web-Frontend)
php -S localhost:8080Option C : Node.js (si installé)
# Depuis la racine du dépôt (Xalass-web-Frontend)
npx http-server -p 8080Résultat attendu :
Serving HTTP on 0.0.0.0 port 8080 (http://0.0.0.0:8080/) ...
Dans un nouveau terminal :
Windows (PowerShell) :
Invoke-WebRequest -Uri "https://api.xalass.com/api/health" -Method GETLinux/Mac :
curl https://api.xalass.com/api/healthRésultat attendu :
{
"status": "ok",
"database": "connected",
"timestamp": "2026-01-04T..."
}-
Page de login :
http://localhost:8080/xalass-login.html- Créez un compte ou connectez-vous
- Vous recevrez un UUID anonyme
-
Page feed :
http://localhost:8080/xalass-feed.html- Créez un nouveau post
- Likez des posts
- Ajoutez des commentaires
-
Page profil :
http://localhost:8080/xalass-profile.html- Consultez vos statistiques
Xalass-web-Frontend/
├── Xalass_Backend/ # Backend Laravel
│ ├── app/
│ │ ├── Http/
│ │ │ ├── Controllers/ # Contrôleurs API
│ │ │ └── Middleware/ # Middleware d'authentification
│ │ ├── Models/ # Modèles Eloquent
│ │ └── services/ # Services métier
│ ├── database/
│ │ └── migrations/ # Migrations de base de données
│ ├── routes/
│ │ └── api.php # Routes API
│ └── .env # Configuration (à créer)
│
├── js/ # Frontend - Scripts JavaScript
│ ├── api.js # Service API JavaScript
│ ├── config.js # Configuration API
│ └── xalass.js # Fonctions utilitaires
├── css/ # Frontend - Styles CSS
├── images/ # Frontend - Images et ressources
└── xalass-*.html # Frontend - Pages HTML
├── xalass-login.html # Page de connexion
├── xalass-feed.html # Page principale (feed)
├── xalass-story.html # Détail d'un post
├── xalass-profile.html # Profil utilisateur
├── xalass-search.html # Recherche
└── xalass-notifications.html # Notifications
Le fichier js/config.js (à la racine du dépôt) contient l'URL du backend :
const API_CONFIG = {
BASE_URL: 'https://api.xalass.com/api',
// ...
};Si votre backend tourne sur un autre port ou domaine, modifiez cette URL.
Les principales configurations sont dans Xalass_Backend/.env :
- Base de données :
DB_* - Application :
APP_* - CORS : Configuré dans
config/cors.php
POST /api/create/anoUser- Créer un utilisateur anonymePOST /api/login/anoUser- Se connecter
POST /api/create/posts- Créer un postPOST /api/all/posts- Récupérer tous les posts (paginé)POST /api/author/posts- Posts d'un auteurPOST /api/category/posts- Posts par catégorieGET /api/posts/{id}- Détails d'un postPOST /api/update/posts- Mettre à jour un postPOST /api/delete/posts- Supprimer un post
POST /api/posts/{id}/reactions- Liker/unliker un postPOST /api/comments/{id}/reactions- Liker/unliker un commentaire
POST /api/create/comment- Créer un commentaireGET /api/posts/{id}/comments- Commentaires d'un postPOST /api/delete/comment- Supprimer un commentaire
GET /api/notifications- Récupérer les notificationsPUT /api/notifications/{id}/read- Marquer comme luPUT /api/notifications/read-all- Tout marquer comme luDELETE /api/notifications/{id}- Supprimer une notification
GET /api/health- Vérifier l'état du serveur et de la base de donnéesGET /api/media/avatars- Liste des avatars disponibles
Note : La plupart des endpoints nécessitent l'authentification via le header X-Anon-ID.
Erreur : Class 'PDO' not found
- Solution : Installez l'extension PDO pour PHP
Erreur : SQLSTATE[HY000] [2002] No connection could be made
- Solution : Vérifiez que MySQL est démarré et que les identifiants dans
.envsont corrects
Erreur : The stream or file could not be opened
- Solution : Vérifiez les permissions du dossier
storage/:chmod -R 775 storage bootstrap/cache
Erreur : ERR_EMPTY_RESPONSE
- Solution :
- Vérifiez que le serveur frontend est bien lancé
- Vérifiez qu'aucun autre processus n'utilise le port 8080
- Essayez un autre port :
python -m http.server 3000
Erreur : CORS policy: No 'Access-Control-Allow-Origin'
- Solution : Vérifiez que le backend est bien démarré et que CORS est configuré dans
config/cors.php
Erreur dans la console : Impossible de se connecter au serveur
- Solution :
- Vérifiez que le backend est lancé :
https://api.xalass.com/api/health - Vérifiez l'URL dans
js/config.js - Ouvrez la console (F12) et vérifiez les erreurs réseau
- Vérifiez que le backend est lancé :
Le bouton reste sur "Publication..."
- Solution :
- Vérifiez que vous êtes connecté (UUID présent dans localStorage)
- Vérifiez la console (F12) pour les erreurs
- Vérifiez que le backend répond :
https://api.xalass.com/api/health
- PHP installé et dans le PATH
- Composer installé
- MySQL démarré
- Base de données créée
- Fichier
.envconfiguré - Migrations exécutées (
php artisan migrate) - Backend lancé sur le port 8000
- Frontend lancé sur le port 8080
- Test
/api/healthrépond OK
# Installer les dépendances
composer install
# Exécuter les migrations
php artisan migrate
# Vider le cache
php artisan cache:clear
php artisan config:clear
php artisan route:clear
# Voir les routes
php artisan route:list
# Voir les logs
tail -f storage/logs/laravel.log# Se connecter à MySQL
mysql -u votre_utilisateur -p
# Voir les tables
SHOW TABLES;
# Voir les posts
SELECT * FROM posts LIMIT 10;
# Compter les posts
SELECT COUNT(*) FROM posts;Une fois les serveurs lancés :
- Login :
http://localhost:8080/xalass-login.html - Feed :
http://localhost:8080/xalass-feed.html - Profil :
http://localhost:8080/xalass-profile.html - Recherche :
http://localhost:8080/xalass-search.html - Notifications :
http://localhost:8080/xalass-notifications.html - Détail post :
http://localhost:8080/xalass-story.html?id=1
API :
- Health Check :
https://api.xalass.com/api/health - API Base :
https://api.xalass.com/api
Pour arrêter les serveurs, appuyez sur Ctrl+C dans chaque terminal où ils tournent.
Windows : Si les processus restent bloqués :
Get-Process php | Stop-Process -Force
Get-Process python | Stop-Process -ForcePour contribuer au projet :
- Forkez le projet
- Créez une branche pour votre fonctionnalité (
git checkout -b feature/AmazingFeature) - Committez vos changements (
git commit -m 'Add some AmazingFeature') - Push vers la branche (
git push origin feature/AmazingFeature) - Ouvrez une Pull Request
Ce projet est sous licence MIT.
- Équipe Xalass
- Laravel Framework
- Winku Template
Bon développement ! 🚀