95 lines
2.5 KiB
Markdown
95 lines
2.5 KiB
Markdown
|
# E-Cosplay Ticket
|
||
|
|
|
||
|
|
Système de billetterie professionnelle pour associations cosplay. Génération, scan et contrôle de tickets pour événements.
|
||
|
|
|
||
|
|
## Fonctionnalités
|
||
|
|
|
||
|
|
- **Génération de tickets** — Création de billets avec QR codes uniques pour chaque participant
|
||
|
|
- **Scan & Contrôle** — Vérification des tickets par scan QR à l'entrée de l'événement
|
||
|
|
- **Gestion des événements** — Création et configuration d'événements (date, lieu, capacité, tarifs)
|
||
|
|
- **Gestion des participants** — Suivi des inscriptions et des présences
|
||
|
|
- **SEO** — Sitemap XML, métadonnées Open Graph, données structurées (JSON-LD) pour le référencement des événements
|
||
|
|
- **Notifications** — Envoi des tickets par email avec confirmation de commande
|
||
|
|
- **Tableau de bord** — Statistiques en temps réel (ventes, entrées, taux de remplissage)
|
||
|
|
|
||
|
|
## Stack technique
|
||
|
|
|
||
|
|
| Composant | Technologie |
|
||
|
|
|-----------|-------------|
|
||
|
|
| Framework | Symfony 8.0 |
|
||
|
|
| PHP | >= 8.4 |
|
||
|
|
| Base de données | PostgreSQL 16 |
|
||
|
|
| ORM | Doctrine 3.6 |
|
||
|
|
| Frontend | Twig + Stimulus 3.2 + Turbo |
|
||
|
|
| Assets | Asset Mapper (sans build) |
|
||
|
|
| PDF | Dompdf 3.1 |
|
||
|
|
| QR Code | endroid/qr-code 6.1 |
|
||
|
|
| Emails | Symfony Mailer |
|
||
|
|
| File d'attente | Symfony Messenger + Redis |
|
||
|
|
| Tests | PHPUnit 13 |
|
||
|
|
|
||
|
|
## Prérequis
|
||
|
|
|
||
|
|
- PHP 8.4+
|
||
|
|
- PostgreSQL 16
|
||
|
|
- Redis 7+
|
||
|
|
- Composer
|
||
|
|
- Symfony CLI (recommandé)
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Cloner le dépôt
|
||
|
|
git clone https://github.com/your-org/e-cosplay-ticket.git
|
||
|
|
cd e-cosplay-ticket
|
||
|
|
|
||
|
|
# Installer les dépendances
|
||
|
|
composer install
|
||
|
|
|
||
|
|
# Configurer l'environnement
|
||
|
|
cp .env .env.local
|
||
|
|
# Éditer .env.local avec vos paramètres (DATABASE_URL, MAILER_DSN, etc.)
|
||
|
|
|
||
|
|
# Créer la base de données et exécuter les migrations
|
||
|
|
php bin/console doctrine:database:create
|
||
|
|
php bin/console doctrine:migrations:migrate
|
||
|
|
|
||
|
|
# Lancer le serveur de développement
|
||
|
|
symfony server:start
|
||
|
|
```
|
||
|
|
|
||
|
|
## Docker (développement)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
docker compose up -d
|
||
|
|
```
|
||
|
|
|
||
|
|
Services inclus :
|
||
|
|
- **PostgreSQL 16** — port 5432
|
||
|
|
- **Redis 7** — port 6379 (transport Messenger)
|
||
|
|
- **Mailpit** — port 8025 (interface web pour les emails)
|
||
|
|
|
||
|
|
## Structure du projet
|
||
|
|
|
||
|
|
```
|
||
|
|
src/
|
||
|
|
├── Controller/ # Contrôleurs HTTP
|
||
|
|
├── Entity/ # Entités Doctrine (Ticket, Event, User…)
|
||
|
|
└── Repository/ # Repositories Doctrine
|
||
|
|
templates/ # Templates Twig
|
||
|
|
assets/ # JS (Stimulus) & CSS
|
||
|
|
config/ # Configuration Symfony
|
||
|
|
migrations/ # Migrations Doctrine
|
||
|
|
tests/ # Tests PHPUnit
|
||
|
|
```
|
||
|
|
|
||
|
|
## Tests
|
||
|
|
|
||
|
|
```bash
|
||
|
|
php bin/phpunit
|
||
|
|
```
|
||
|
|
|
||
|
|
## Licence
|
||
|
|
|
||
|
|
Projet privé — Tous droits réservés.
|