Présentation du projet

La calculatrice immobilière est une application web permettant aux utilisateurs de simuler des prêts immobiliers en fonction du montant emprunté, du taux d'intérêt et de la durée du prêt. Elle a été développée avec une approche moderne et responsive, et peut également être utilisée comme application de bureau grâce à Electron.

Architecture technique

Technologies utilisées :

• Frontend HTML5, CSS3, JavaScript
• Framework Electron pour la version desktop
• Système de génération PDF avec html2pdf.js
• Responsive design avec Media Queries

Structure du code

Le projet est organisé selon une architecture simple mais efficace :

• index.html Structure principale de l'application
• style.css Fichier CSS principal pour le style de l'application
• main.js Script JavaScript principal contenant la logique de calcul
• images/ Dossier contenant les images et autres ressources
• electron.js / electron_fr.js Configuration pour la version desktop
• forge.config.js Configuration pour le packaging Electron

Algorithmes de calcul

La calculatrice utilise plusieurs formules financières pour effectuer les calculs de prêt immobilier :

• Calcul de mensualité : E = (P * m * (1 + m)^n) / ((1 + m)^n - 1)
• Calcul des intérêts mensuels : I = S * m
• Calcul de l'amortissement mensuel : A = E - I

Où :

• E = Échéance mensuelle
• P = Montant emprunté
• m = Taux d'intérêt mensuel (taux annuel / (100 * 12))
• n = Nombre de mensualités (durée en années * 12)
• I = Intérêts mensuels
• A = Amortissement mensuel
• S = Solde restant du prêt

Fonctionnalités principales

Calcul de mensualité et tableau d'amortissement

Cette fonctionnalité permet de calculer les mensualités d'un prêt en fonction du montant emprunté, du taux d'intérêt et de la durée du prêt. L'application génère également un tableau d'amortissement complet montrant l'évolution du prêt mois par mois.

Validation des données

L'application vérifie que les données saisies sont valides avant de procéder au calcul : - Le montant doit être un nombre entier supérieur ou égal à 1000 - Le taux doit être un nombre entre 0.01 et 100 - La durée doit être un nombre entier entre 1 et 100 ans

Génération de PDF

L'application permet de générer un document PDF contenant la simulation de prêt complète avec le tableau d'amortissement, en adaptant automatiquement la mise en page selon la taille de l'écran pour garantir une bonne lisibilité.

Version desktop

Grâce à Electron, l'application web peut être packagée en une application de bureau fonctionnant sur Windows, macOS et Linux, offrant ainsi une expérience utilisateur similaire à une application native.

Tests et validation

Plusieurs types de tests ont été mis en place pour garantir la fiabilité de l'application :

• Validation des entrées : Vérification des données saisies par l'utilisateur
• Adaptation responsive : Ajustement automatique de l'interface selon la taille de l'écran
• Tests de compatibilité : Vérification sur différents navigateurs
• Tests d'export PDF : Validation de la génération correcte du document PDF

Déploiement

L'application est déployée selon deux méthodes :

• Version web : Peut être déployée sur n'importe quel serveur web standard
• Version desktop : Packagée avec Electron Forge pour créer des applications natives (.exe pour Windows, .dmg pour macOS, .AppImage pour Linux)

Installation sur PC

Pour installer et exécuter l'application sur votre ordinateur, suivez ces étapes :

Prérequis

• Node.js (version 14 ou supérieure)
• npm (généralement installé avec Node.js)
• Git (optionnel, pour cloner le dépôt)

Installation des dépendances

1. Clonez ou téléchargez le code source du projet
2. Ouvrez un terminal dans le répertoire du projet
3. Exécutez la commande npm install pour installer toutes les dépendances

Lancement de l'application

• Version web : Ouvrez simplement le fichier index.html dans votre navigateur
• Version Electron : Exécutez npm run start pour lancer l'application en mode développement

Création d'un exécutable

Pour créer un fichier exécutable que vous pouvez distribuer :

1. Exécutez npm run make dans le terminal
2. Les fichiers d'installation seront générés dans le dossier out/make
3. Pour Windows : utilisez le fichier .exe dans le dossier squirrel.windows
4. Pour macOS : utilisez le fichier .dmg
5. Pour Linux : utilisez le fichier .deb ou .rpm selon votre distribution

Perspectives d'évolution

Plusieurs améliorations sont envisagées pour les versions futures :

• Intégration d'une API pour récupérer les taux d'intérêt en temps réel
• Ajout de l'assurance emprunteur dans les calculs
• Possibilité de sauvegarder et comparer plusieurs simulations
• Amélioration de l'interface utilisateur avec des graphiques
• Ajout de calculs supplémentaires (capacité d'emprunt, taux d'endettement)