Adapte-moi si tu peux 🎥📚

Bienvenue sur Adapte-moi si tu peux, une application web construite avec Flask pour vous aider à découvrir des films adaptés de livres. Cette application vous permet de rechercher des adaptations, de consulter des informations détaillées sur les livres et les films, et de gérer une liste personnalisée de films à voir.

---

Fonctionnalités principales 🚀

Fonctions de base :

1. Recherche intuitive 🔍

   • Recherchez des livres adaptés en films par titre ou mot-clé.
   • Accédez à des liens vers les pages Wikipedia pour plus d'informations.
   • Consultez un indice de recommandation pour chaque adaptation.

2. Top 10 des livres les plus recherchés 📖

   • Découvrez les 10 livres les plus populaires adaptés en films.

3. Système d'authentification 🔐

   • Inscription et connexion des utilisateurs.
   • Gérez votre profil utilisateur.
   • Consultez et mettez à jour une liste personnalisée de films à voir.

4. Pages dynamiques 🖥️

   • Une page "À propos" expliquant ce qu'est une adaptation, des statistiques clés et l'objectif de l'application.
   • Une page "Profil" pour gérer les paramètres utilisateur et afficher les films enregistrés.

Améliorations à venir 🌟 :

• Intégration avec des APIs comme TMDB ou Open Library pour des données en temps réel.
• Algorithmes de recommandation améliorés.
• Partage social des listes de films.

---

Installation 🛠️

Suivez ces étapes pour configurer le projet en local :

Prérequis :

• Python 3.7+
• Environnement virtuel (recommandé)

Étapes :

1. Clonez le dépôt :

   git clone https://github.com/sambec/adapte-moi.git
   cd adapte-moi

2. Créez un environnement virtuel :

   python3 -m venv venv
   source venv/bin/activate  # Sur Windows : venv\Scripts\activate

3. Installez les dépendances :

   pip install -r requirements.txt

4. Configurez la base de données :

   flask db init
   flask db migrate -m "Initial migration."
   flask db upgrade

5. Lancez l'application :

   flask run

6. Ouvrez l'application dans votre navigateur à : http://127.0.0.1:5000

---

Structure du projet 📂

/project-root
├── app/
│   ├── routes/           # Routes de l'application
│   ├── models/           # Modèles de base de données
│   ├── forms.py          # Formulaires Flask-WTF
│   ├── static/           # CSS, JavaScript et images
│   └── templates/        # Templates HTML
│   └── utils/            # Boîte à outils
├── config.py             # Paramètres de configuration
├── run.py                # Point d'entrée de l'application
├── requirements.txt      # Dépendances du projet
└── README.md             # Documentation du projet

---

Technologies utilisées 🛠️

• Backend : Python, Flask, Flask-SQLAlchemy, Flask-Login, Flask-WTF
• Frontend : HTML, CSS, Bootstrap (optionnel)
• Base de données : SQLite (par défaut, peut être remplacée par PostgreSQL ou MySQL)

---

Comment contribuer 🤝

1. Forkez le dépôt.
2. Créez une nouvelle branche :

   git checkout -b nom-de-fonctionnalite

3. Commitez vos modifications :

   git commit -m "Ajout d'une nouvelle fonctionnalité"

4. Pushez sur votre branche :

   git push origin nom-de-fonctionnalite

5. Ouvrez une pull request.

---

Licence 📜

Ce projet est sous licence MIT. Consultez le fichier LICENSE pour plus de détails.

---

Auteurs ✍️

• Groupe Fun 2025
  Un projet collaboratif des étudiants du M2 Archives TNAH de l'Ecole des Chartes.
• Sarah, Joël, Camille, Juliette

---

Documentation

• Documentation Flask
• Framework Bootstrap
• API TMDB
• API Open Library

---

Profitez de votre exploration du monde des adaptations cinématographiques ! 🎬📖