first commit

README.md

@@ -0,0 +1,53 @@
+# QCM Physique
+
+Application Flask pour s'entrainer avec des QCM de physique.
+
+Projet en ligne: [qcu.arthurp.fr](https://qcu.arthurp.fr)
+
+## Fonctionnalites
+
+- Scraping periodique des questions depuis une source distante.
+- Stockage local dans SQLite (`qcm.db`).
+- Interface web avec mode complet et mode aleatoire.
+- Affichage du score et correction des reponses.
+
+## Stack technique
+
+- Python 3.11
+- Flask
+- SQLite
+- Docker / Docker Compose
+
+## Lancer le projet en local avec Docker
+
+Prerrequis:
+
+- Docker
+- Docker Compose
+
+Commandes:
+
+```bash
+docker compose build
+docker compose up -d
+```
+
+Application web disponible sur: http://localhost:5000
+
+## Services Docker
+
+- `web`: demarre l'application Flask.
+- `scraper`: execute `main.py` en boucle pour mettre a jour `qcm.db`.
+
+Voir les logs:
+
+```bash
+docker compose logs -f web
+docker compose logs -f scraper
+```
+
+Arreter les conteneurs:
+
+```bash
+docker compose down
+```