Vue d'ensemble

Wolff Immobilier est une plateforme web pour une agence immobiliere de luxe. Elle propose deux interfaces distinctes : une zone client personnalisee par dossier, et un dashboard pour les agents.

Identite visuelle

Theme

Noir & Or (luxe immobilier)

Couleurs cles

Noir #0a0a0a · Or #c9a84c · Creme #faf8f3

Typographie

Cormorant Garamond (titres) · DM Sans (texte)

Deux interfaces

Page client (publique, par client) — chaque client a sa propre URL avec ses biens, ses visites, ses statuts (a visiter / coup de coeur / retire), et ses documents.

Dashboard agent (avec login) — gestion des clients, des biens par recherche, du planning de visites, et de tous les documents.

URLs

Site public

https://wolff-immobilier.com

Page client

https://wolff-immobilier.com/clients/<slug>/

Dashboard agent

https://agent.wolff-immobilier.com

Stack technique

Hebergement

Serveur

Hetzner Cloud · Ubuntu 24.04 LTS

IP publique

77.42.95.132

Acces

SSH (port 22, root)

Localisation

Allemagne

Runtime

Node.js

v20 LTS (sans dependance npm externe)

Gestionnaire

PM2 (process name : wolff)

Port interne

3000 (HTTP localhost)

Stockage

JSON local /root/wolff-immobilier/data/db.json

Reverse proxy & SSL

Nginx

v1.24, deux sites enabled : agent-wolff, wolff-immobilier

SSL

Let's Encrypt via Certbot (renouvellement automatique)

Config sites

/etc/nginx/sites-enabled/

DNS

Registrar

Infomaniak

Domaines

wolff-immobilier.com · agent.wolff-immobilier.com

Securite

• UFW : ports ouverts 22 (SSH), 80 (HTTP), 443 (HTTPS)
• JWT : authentification dashboard (HMAC-SHA256, 8h)
• Passwords : hash PBKDF2-SHA512 + sel
• Indexation : desactivee (robots.txt + header X-Robots-Tag)

Architecture des fichiers

Tout le projet vit dans /root/wolff-immobilier/ sur le serveur.

/root/wolff-immobilier/
├── server.js              # Serveur HTTP principal (routeur, API, fichiers statiques)
├── db.js                  # Acces a la base JSON + crypto (JWT, hash)
├── generator.js           # Genere les pages HTML clients au demarrage
├── README.md              # Documentation
├── data/
│   └── db.json            # Base de donnees JSON (seule source de verite)
├── public/
│   └── dashboard.html     # Interface dashboard agent (1 fichier autonome)
├── clients/               # Pages HTML clients generees
│   ├── vincent/index.html
│   └── jeremy-barnier/index.html
└── uploads/               # Fichiers uploades (PDF, images des biens)

Roles des fichiers

server.js

Le coeur. Routeur HTTP, toutes les routes API, sert les fichiers statiques. ~715 lignes.

db.js

Fonctions load(), save(), hash(), verifyJWT(). Lit/ecrit data/db.json.

generator.js

Au demarrage du serveur, regenere clients/<slug>/index.html pour chaque client en base.

dashboard.html

App mono-fichier (HTML+CSS+JS inline). Aucun framework. ~1424 lignes.

clients/<slug>/

Page autonome generee pour chaque client. Lit l'API publique sans auth.

Routes API

Toutes les routes utilisent le pattern /api/.... Les routes protegees attendent un header Authorization: Bearer <jwt>.

Authentification

Dashboard

Clients

Biens (routes generiques par slug)

Recherches

Visites

Documents

Structure de la base de donnees

Un seul fichier JSON : /root/wolff-immobilier/data/db.json. Lu/ecrit a chaque requete via db.load() / db.save().

Cles principales

Schema d'un bien

{
  "id": 1772548615726,           // timestamp Date.now()
  "ordre": 0,                    // unique par client, sert au tri et numerotage (#ordre+1)
  "recherche_id": "r1",          // appartient a quelle recherche
  "titre": "Appartement 3.5p",
  "prix": "920'000",
  "secteur": "Montreux",
  "pieces": "3.5",
  "surface": "82",
  "etage": "2e",
  "annee": "1985",
  "travaux": "non",
  "agence": "iad",
  "contact": "+41 79 XXX",
  "lien": "https://...",
  "note_agent": "..."
}

Schema d'une visite

{
  "id": 1773575578649,
  "client_slug": "vincent",
  "bien_id": "1800000000005",
  "date": "2026-03-16",          // ISO YYYY-MM-DD
  "heure": "11:30",              // HH:MM
  "adresse_rdv": "Route de ...",
  "statut_visite": "programmee", // programmee | visitee | retenu | controle
  "note_agent": "",
  "created_at": "2026-03-15T11:52:58.649Z"
}

Regles metier

Numerotation des biens

Chaque bien a un champ ordre (entier). Le numero affiche partout est ordre + 1 (ex : #5).

• Unique globalement par client — pas par recherche. Vincent a 55 biens numerotes #1 a #55, toutes recherches confondues.
• Calcule a la creation : ordre = max(ordres existants) + 1 dans la route POST.
• Affichage : utiliser b.ordre + 1 partout (jamais indexOf ni i+1).
• Reorder : drag/drop met a jour le champ ordre via PUT /api/biens-:slug-ordre.

Multi-clients / multi-recherches

• Architecture 100% slug-based. Aucun client n'est hardcode dans le code.
• Dashboard utilise _clientBiensActif (variable JS globale) pour savoir quel client est selectionne.
• Un client peut avoir plusieurs recherches (ex : Vincent a "Riviera vaudoise" et "Nyon/Rolle").
• L'onglet Biens du dashboard a un selecteur de client + onglets de recherches.

Statuts d'un bien (cote client)

Statuts d'une visite

Visibilite des documents

• Un document a un champ agent_only (boolean).
• agent_only: true = visible uniquement dans le dashboard, jamais sur la page client.
• agent_only: false = visible client (telechargeable depuis la fiche bien).

SSH & operations courantes

Se connecter au serveur

# Connexion SSH (mot de passe demande, non documente ici)
ssh root@77.42.95.132

# Aller dans le projet
cd /root/wolff-immobilier

Backup AVANT chaque modification

tar -czf /root/wolff-backup-$(date +%Y%m%d-%H%M).tar.gz /root/wolff-immobilier

Lister les backups

ls -lh /root/wolff-backup-*.tar.gz

Restaurer un backup

# Renommer l'actuel avant de restaurer
mv /root/wolff-immobilier /root/wolff-immobilier.broken

# Extraire le backup
tar -xzf /root/wolff-backup-20260512-1647.tar.gz -C /

# Restart
pm2 restart wolff

Restart du serveur applicatif

pm2 restart wolff
pm2 status
pm2 logs wolff --lines 10 --nostream

Restart Nginx

nginx -t                  # tester la config
systemctl reload nginx    # appliquer sans coupure
systemctl restart nginx   # redemarrer franchement

Update du systeme

apt update
DEBIAN_FRONTEND=noninteractive apt upgrade -y -o Dpkg::Options::="--force-confold"
apt autoremove -y

# Si reboot requis
[ -f /var/run/reboot-required ] && echo "REBOOT REQUIS"
reboot

Verifier le port et le service

# Le port 3000 doit etre en ecoute par node
ss -tlnp | grep 3000

# Le service systemd PM2 doit etre actif
systemctl is-active pm2-root

Commandes de depannage

Logs PM2

# Logs en direct
pm2 logs wolff

# Dernieres lignes seulement
pm2 logs wolff --lines 20 --nostream

# Vider les logs
pm2 flush wolff

Verifier la syntaxe du code

# server.js
node --check /root/wolff-immobilier/server.js

# JS dans dashboard.html (extraire avant)
SS=$(grep -n "^<script>" /root/wolff-immobilier/public/dashboard.html | head -1 | cut -d: -f1)
SE=$(grep -n "^</script>" /root/wolff-immobilier/public/dashboard.html | tail -1 | cut -d: -f1)
sed -n "$((SS+1)),$((SE-1))p" /root/wolff-immobilier/public/dashboard.html > /tmp/dash.js
node --check /tmp/dash.js

Tester l'API en live

# Obtenir un token
TOKEN=$(curl -s -X POST -H "Content-Type: application/json" \
  -d '{"email":"agent@wollf.fr","password":"PASSWORD"}' \
  http://localhost:3000/api/auth/login | grep -oP '"token":"[^"]+' | cut -d'"' -f4)

# Tester une route protegee
curl -H "Authorization: Bearer $TOKEN" http://localhost:3000/api/biens-vincent

Inspecter la base

# Voir toutes les cles + tailles
node -e "
const db = require('/root/wolff-immobilier/data/db.json');
Object.keys(db).forEach(k => {
  const v = db[k];
  console.log(k, Array.isArray(v) ? v.length+' items' : typeof v);
});"

# Voir les visites
node -e "
const db = require('/root/wolff-immobilier/data/db.json');
db.visites.forEach(v => console.log(v.date, v.heure, v.client_slug, v.bien_id));"

Modifier la base proprement

node << 'EOF'
const fs = require('fs');
const path = '/root/wolff-immobilier/data/db.json';
const db = JSON.parse(fs.readFileSync(path, 'utf8'));

// Modification ici, par exemple :
// db.visites = db.visites.filter(v => v.date);

fs.writeFileSync(path, JSON.stringify(db, null, 2));
console.log('OK');
EOF

Disque, memoire, processus

df -h /              # espace disque
free -h              # memoire
pm2 monit            # monitor interactif
htop                 # vue d'ensemble

Pieges a eviter (FAQ developpeur)

Outils utiles

• Toujours backup avant modif (commande en section 07)
• Verifier syntaxe : node --check fichier.js
• Lire les logs apres chaque restart : pm2 logs wolff --lines 10 --nostream
• Tester routes avec curl avant de modifier le front

Conventions de code

• Routes API : pattern slug-based (/api/<ressource>-:slug ou /api/<ressource>/:slug)
• Dashboard : variables d'etat globales prefixees par _ (ex : _clientBiensActif, _visites)
• Style : Noir & Or, typographie Cormorant + DM Sans, jamais d'emoji dans l'UI (utiliser des symboles unicode discrets : ◈ ◎ ⌂ ◷ ◻ ⚙)
• Numero de bien : toujours #<ordre+1>, dans une div en font-size:10px, color:gris, letter-spacing:1px