Quickstart (Docker-first)
=========================

Objectif
--------

Lancer l’application **en production containerisée** en 5 commandes, sans installer Python localement.

Les 5 commandes
---------------

::

   # 1) Cloner
   git clone <URL_REPO> && cd P13_Python-OC-Lettings-FR

   # 2) Préparer l’environnement
   cp .env.example .env   # puis adaptez les valeurs si nécessaire

   # 3) (optionnel) Lister les commandes utiles
   make help

   # 4) Build + (re)lance le conteneur
   make rebuild

   # 5) Vérifier que ça tourne
   open http://localhost:8001    # macOS
   # ou : xdg-open http://localhost:8001  # Linux
   # ou : ouvrez votre navigateur et tapez http://localhost:8001

Commandes courantes
-------------------

- **Logs en direct** ::

    make logs

- **Arrêter / supprimer le conteneur** ::

    make stop

- **Appliquer les migrations** ::

    docker exec -it oc-lettings python manage.py migrate

- **Lancer les tests** ::

    docker exec -it oc-lettings pytest -q

- **Collecter les fichiers statiques (prod)** ::

    docker exec -it oc-lettings python manage.py collectstatic --noinput

- **Ouvrir un shell Django** ::

    docker exec -it oc-lettings python manage.py shell

Générer la documentation (hors conteneur)
-----------------------------------------

::

   pip install -r docs/requirements.txt
   make -C docs html
   open docs/build/html/index.html  # Linux : xdg-open

Astuce
------

Tapez ``make help`` à la racine du projet pour afficher la liste des cibles disponibles
(Docker + Docs).