# 🏠 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é)

```bash
docker-compose up --build
```

Puis ouvrez : http://localhost:3000

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

**Prérequis** : Node.js 18+ et npm

```bash
# 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