GestionLocative

🏠 Gestion Locative

Application web de gestion locative : encaissement des loyers, suivi des charges, génération de quittances PDF.

Fonctionnalités

• 🔐 Multi-propriétaires avec authentification sécurisée (JWT)
• 🏠 Gestion des biens immobiliers (CRUD)
• 👤 Gestion des locataires (CRUD)
• 📋 Baux : loyer HC, charges, dépôt de garantie, dates
• 💰 Encaissements : enregistrer les paiements mois par mois
• 📄 Quittances PDF générées automatiquement et téléchargeables
• 📊 Dashboard : baux actifs, loyers attendus vs encaissés

Démarrage rapide

Option 1 : Docker (recommandé)

docker-compose up --build

Puis ouvrez : http://localhost:3000

Option 2 : Node.js (développement local)

Prérequis : Node.js 18+ et npm

# Backend
cd backend
npm install
npm run dev    # Démarre sur http://localhost:3001

# Frontend (dans un autre terminal)
cd frontend
npm install
npm run dev    # Démarre sur http://localhost:3000

Stack technique

Couche	Technologie
Backend	Node.js + Express
Base de données	SQLite (better-sqlite3)
Auth	JWT + bcrypt
PDF	PDFKit
Frontend	React 18 + Vite
UI	Tailwind CSS
Déploiement	Docker + Nginx

Structure

TestApp/
├── backend/
│   ├── src/
│   │   ├── routes/       # auth, properties, tenants, leases, payments, receipts
│   │   ├── db.js         # SQLite + migrations
│   │   ├── auth.js       # JWT middleware
│   │   └── server.js
│   └── data/             # Fichier SQLite (créé automatiquement)
└── frontend/
    └── src/
        ├── pages/        # Dashboard, Properties, Tenants, Leases, Payments
        ├── components/   # Layout
        └── context/      # AuthContext

Utilisation

1. Créer un compte → Register
2. Ajouter vos biens → 🏠 Biens
3. Ajouter vos locataires → 👤 Locataires
4. Créer un bail → 📋 Baux (associer bien + locataire + montants)
5. Enregistrer un paiement → Cliquer sur un bail → "Enregistrer un paiement"
6. Télécharger la quittance PDF → Bouton 📄 Quittance sur chaque paiement