À propos du projet

BoardPxl est une application web conçue pour centraliser la gestion des flux financiers de la plateforme SportPXL. Elle permet aux photographes et administrateurs de suivre leurs transactions, gérer leurs crédits et consulter leur historique financier de manière claire et efficace.

Fonctionnalités principales :

Gestion centralisée des factures et transactions
Suivi des crédits photographes
Intégration avec Stripe, Pennylane et ForestAdmin
Tableau de bord intuitif pour photographes et administrateurs

(retour en haut)

Technologies principales

Les technologies principales utilisées pour développer BoardPxl :

(retour en haut)

Pour commencer

Pour obtenir une copie locale et la faire fonctionner, suivez ces étapes simples.

Prérequis

Assurez-vous d'avoir les outils suivants installés sur votre machine :

Docker et Docker Compose
# Vérifier l'installation de Docker

docker --version

docker-compose --version
Node.js 18+
node --version

npm --version
PHP 7.4+ et Composer
php --version

composer --version

Installation

Cloner le repository
git clone https://github.com/Trosalie/projetsportpxl.git

cd projetsportpxl
Démarrer les services avec Docker
docker-compose up -d
Configurer le Backend (Laravel)
cd boardpxl-backend

cp .env.example .env

composer install

php artisan key:generate

php artisan migrate

php artisan db:seed
Configurer le Frontend (Angular)
cd ../boardpxl-frontend

npm install
Configurer les variables d'environnement

Backend - Modifier .env :
DB_CONNECTION=mysql

DB_HOST=db

DB_DATABASE=boardpxl

STRIPE_KEY=your_stripe_key

STRIPE_SECRET=your_stripe_secret

PENNYLANE_API_KEY=your_pennylane_key
Lancer l'application
# Le frontend sera accessible sur http://localhost:4200

(retour en haut)

Utilisation

BoardPxl propose deux espaces utilisateur distincts :

Espace Photographe

Consulter l'historique des factures
Visualiser le solde de crédits
Demander un versement de chiffre d'affaires

Espace Administrateur

Gérer les utilisateurs de la plateforme
Générer des factures (crédits, versements)
Consulter les flux financiers globaux
Accéder à l'historique complet des transactions

Commandes utiles :

# Démarrer/Arrêter les services
docker-compose up -d
docker-compose down
 
# Voir les logs
docker-compose logs -f
 
# Tests Backend
cd boardpxl-backend
php artisan test

Tests & rapport de couverture (backend)

Les tests backend (Laravel) s'exécutent depuis le dossier boardpxl-backend.

Exécuter tous les tests :

cd boardpxl-backend

php artisan test

Générer un résumé de couverture (console) :

php artisan test --coverage

Générer un rapport HTML de couverture (dossier coverage) :

# en local (via PHPUnit)
vendor/bin/phpunit --coverage-html coverage
 
# ou via Artisan (si configuré) :
php artisan test --coverage-html coverage

Le rapport HTML est écrit dans boardpxl-backend/coverage/index.html — ouvrez-le dans votre navigateur pour une vue complète.

Exécuter les tests depuis le conteneur Docker (si vous utilisez Docker Compose) :

docker compose exec backend php artisan test

Conseils :

Utilisez php artisan test --filter ClassName::methodName pour lancer un test spécifique.
Si la génération du rapport HTML échoue, utilisez vendor/bin/phpunit --coverage-html coverage.

(retour en haut)

Contact

Mail : proje.nosp@m.tspo.nosp@m.rtpxl.nosp@m.@gma.nosp@m.il.co.nosp@m.m

Lien du projet: https://github.com/Trosalie/projetsportpxl

(retour en haut)