# 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.