# retraite-maurice.fr — réflexion d'architecture (v2, 29/10/2026)

Rien n'est mis en ligne. Ce document sert à penser l'ensemble avant de construire.

## 1. L'idée de fond : une base de données au centre, et tout le reste en découle

Aujourd'hui, les connaissances sont écrites sous forme de texte (`Datas/*.md`, 690 Ko).
Un chiffre comme « 24 000 $ par an » apparaît dans des dizaines de paragraphes.
S'il change, il faut le corriger partout. Et le texte ne peut pas alimenter une carte, un simulateur ou un mail.

On inverse donc le sens. On construit **une base unique de faits**, et le site, la carte, les simulateurs, le guide PDF, les posts, les mails et l'espace client ne sont que **des façons de la montrer**.

```
                 COLLECTE                    VALIDATION
  scrapers, API, sources officielles  ──►  file « à valider »  ──►  toi (oui / non)
                                                                       │
                                                                       ▼
 ┌──────────────────────────── LA BASE (la vérité) ───────────────────────────┐
 │ LIEUX       plages, golfs, cliniques, marchés, banques, agences, résidences │
 │             PDS/IRS, radars, webcams, restaurants…  (coordonnées, région)    │
 │ CHIFFRES    seuil du permis, barème fiscal, loyers par région et niveau,     │
 │             taux de change, carburant…  (valeur, source, date, validité)     │
 │ RÈGLES      conditions du permis, 183 jours, calendrier des démarches        │
 │ TARIFS      nos prix (même source que les devis), remises selon l'arrivée    │
 │ PROFILS     seul ou en couple, âge, niveau de vie, région, animaux           │
 └──────────────────────────────────────────────────────────────────────────────┘
          │            │            │            │            │            │
          ▼            ▼            ▼            ▼            ▼            ▼
      ARTICLES      CARTE      SIMULATEURS   GUIDE PDF    POSTS/MAILS   ESPACE
      (texte        (tous les   budget,       gratuit,    actus, réseaux, CLIENT
      réécrit)      lieux)      tarifs, quiz  personnalisé newsletter    (Conseils)
```

**Ce que ça règle d'un coup :**
- **Mises à jour** : on corrige un chiffre une fois, et il change dans les articles, les simulateurs, le PDF et les mails.
- **Remix du contenu** : le texte se réécrit à partir des faits pour chaque site et chaque canal, alors que les chiffres restent justes. Le contenu n'est donc jamais copié d'un site à l'autre.
- **Carte au maximum** : tous les lieux de la base s'y affichent, chacun avec sa fiche.
- **Calculateur de budget** : il lit les loyers, les courses et les coûts de santé région par région, et par niveau de vie.
- **Espace client** : l'onglet Conseils, encore vide, lit la même base selon la région du client et son étape.

## 2. Comment les pièces se relient entre elles

Chaque objet porte des liens vers les autres. Ce sont ces liens qui font la pertinence du site.

- Un **lieu** appartient à une **région**, et une région a ses **chiffres** (loyers, climat).
- Un **article** cite des chiffres et des lieux. Il ne les recopie pas : les blocs se remplissent tout seuls, par exemple `{{chiffre:seuil_permis}}` ou `{{lieux:golfs région=nord}}`.
- Un **article** est relié à un **service** (« Faire venir son chien » → le service Animaux) et à un **outil** (« Combien pour vivre » → le calculateur de budget).
- Un **outil** produit un **profil**. Ce profil personnalise la carte (« pour moi »), le guide PDF et les mails. Il pré-remplit aussi la demande de devis.

## 3. Le parcours d'un visiteur

```
Google / réseaux ──► article ──► outil (quiz, budget, carte)
                                     │ résultat personnalisé
                                     ▼
                       « Recevez votre guide personnalisé » (e-mail)
                                     │
                      séquence de mails tirée de la base
                                     │
                       tarifs interactifs ──► rendez-vous
                                     │
                     fiche dans l'app de gestion, avec le profil
                     (région, budget, animaux, date d'arrivée)
                                     │
                         client ──► espace client (même base)
```

Un lead qui arrive a déjà répondu au quiz et au simulateur.
Le conseiller sait donc qui il a en face de lui, et le devis est presque prêt.

## 4. Chaque besoin de ta liste, à sa place

| Besoin | Où il se branche | Ce qu'il faut construire |
|---|---|---|
| **Carte interactive au maximum** | couche « Lieux » de la base | une seule carte, avec des calques (santé, plages, golfs, marchés, radars, webcams, météo en direct, résidences PDS/IRS) et un filtre « pour moi » venant du profil. Chaque lieu a sa propre page. |
| **SEO au maximum et analyses** | toutes les pages | des grappes (une page centrale par rubrique, et ses articles autour). Des pages générées automatiquement région × thème (« vivre à Tamarin », « coût de la vie Grand Baie », « golf de… »). Le balisage schema.org (FAQ, Article, HowTo, Place, Service + Offer). Des liens internes posés tout seuls à partir des liens de la base. Search Console, GA4 et le suivi de chaque action (quiz terminé, simulateur, guide, rendez-vous). |
| **Système de données, mises à jour, scraping** | collecte puis validation | des scrapers planifiés (actualités, change, carburant, alertes cyclone, programmes immobiliers, tarifs des golfs). Chaque changement va dans une file d'attente : rien n'entre dans la base sans ton oui. Chaque chiffre porte une date de vérification, et une alerte se déclenche s'il devient trop ancien. |
| **Posts automatiques** | une actualité ou un chiffre qui change | un brouillon d'article d'actualité, que tu valides avant publication. |
| **Contrôle Yoast et outil d'audit** | avant chaque publication | un contrôleur qui applique les règles de Yoast (expression clé, title et meta, lisibilité, liens, alt des images) et refuse les pages en rouge. Puis un audit externe du site entier. |
| **Réseaux sociaux + « vie auto »** | même source que les posts | un visuel et un texte par canal, générés depuis l'actualité ou une fiche (lieu, chiffre de la semaine). Tu valides avant publication. |
| **Mails** | profil + base | le résultat du simulateur envoyé par mail, une séquence d'accueil (J0 guide, J2 budget, J5 permis, J10 témoignage, invitation au rendez-vous) et une newsletter tirée des actualités. Emojis en images Noto. |
| **Simulateur / quiz** | règles + profils | le quiz « Quel coin de l'île », le quiz « Maurice est-elle faite pour moi » et « Mes économies tiendront-elles ». Ils créent tous le profil. |
| **Guide gratuit** | toute la base | un PDF généré, personnalisé selon le profil (sa région, son budget, sa checklist). C'est l'aimant à e-mails. |
| **App espace client** | même base | la même app que l'espace client « Lagon », avec l'onglet Conseils alimenté par la base. |
| **Calculateur de budget** | chiffres par région et par niveau | entrées : région, seul ou couple, location ou achat, appartement ou villa, voiture, santé (selon l'âge), loisirs (golf, restaurants). Sortie : un total mensuel animé, comparé à la pension, le gain fiscal, la vérification du seuil du permis, et l'économie par rapport à la France. |
| **Tarifs dynamiques** | couche « Tarifs » | « Composez votre installation » : on choisit le permis, puis on ajoute des services, des personnes et des animaux. Le prix s'anime, la remise selon la date d'arrivée s'affiche, et le tout part en demande de devis. |

### Les tarifs : ce qui existe déjà (`EM_design/Princing_table/permis_retraite_v3_site.html`)

- **3 formules.**
  - Classique : le permis.
  - Confort : le permis et le logement.
  - Zen : tout le Confort, plus l'aéroport, le véhicule et le déménagement.
- **Calcul (`computePrices`).**
  - Classique : 1 290 €. Confort : 1 890 €.
  - Chaque personne en plus : +250 puis +150 en Classique, +220 puis +120 en Confort, avec 5 personnes au maximum.
  - Chaque animal : +280 en Classique, +240 en Confort, avec 2 animaux au maximum.
  - Zen : le prix du Confort + 930, avec un minimum de 3 450 €.
  - Remise selon l'arrivée : −7 % entre 4 et 6 mois, −14 % au-delà de 6 mois.
- **Échéancier** : de 1 à 5 versements selon le montant, la même règle que `getPaymentSchedule()` dans `form_start_v2.php`.
- **Autour du calcul** : la devise vient de `exchange_ratesx.json`. Le bouton ouvre `form_start_v2.php?service=permis-retraite&formule=…&personnes=…&prix=…`. Le suivi passe par `tracker_global.php`.
- **Le problème** : ces règles sont copiées en dur dans chaque page de prix (retraite, indépendant, investisseur, premium) et dans le formulaire.
- **Pour retraite-maurice.fr** :
  - Les règles passent dans **un seul fichier de tarifs**. Les pages de prix des deux sites et `form_start_v2.php` le lisent tous.
  - La nouvelle présentation (différente, interactive et animée) ne contient plus aucun prix, seulement de l'affichage.
  - On garde le même formulaire de démarrage et le même suivi, avec une source `retraite-maurice`. Les demandes arrivent donc dans le circuit actuel sans rien changer côté gestion.

## 5. La technique : ce qu'il faut faire

**Ma recommandation : un site statique généré + une petite API PHP sur le serveur actuel.**

- **Pages** : générées par un script Python à partir de la base et des gabarits Lagoon.
  - C'est très rapide, ce qui compte pour le SEO (Core Web Vitals).
  - On garde la main totale sur les animations du thème.
  - La synchro automatique Dropbox → serveur publie déjà sans rien faire.
- **La base** : des fichiers dans Dropbox, versionnés, faciles à relire et à corriger par toi ou par Claude. Le script les compile en JSON pour le site et pour l'API.
- **L'API PHP** pour ce qui doit bouger : enregistrer les leads et profils, les tarifs, l'inscription au guide, les mails. Les données des personnes restent dans MySQL, la base existante de l'app de gestion.
- **Les tâches planifiées** pour les scrapers et les brouillons de posts. Elles déposent tout dans la file « à valider » et ne publient jamais seules.
- **Ce qui est déjà fait et qu'on réutilise** : le thème, les modèles de mails, l'espace client, l'app de gestion, la source des tarifs des devis.

**L'autre voie, WordPress** : elle a un seul avantage, le vrai Yoast.
Elle est plus lente, et les animations sont plus dures à tenir.
Le contrôleur « façon Yoast » à la construction donne le même résultat, sans ces défauts.

## 6. L'ordre de construction (toujours en local, rien en ligne)

1. **Modèle de données** : écrire la liste des types (lieu, chiffre, règle, tarif, profil) et de leurs champs. On valide ensemble.
2. **Extraction** : découper `Datas/` en faits et en lieux, avec leurs sources. On commence par 2 ou 3 fichiers en test avant le reste.
3. **Gabarits + générateur + contrôleur SEO**, avec les captures ordi et mobile en local.
4. **Outils** : la carte, le budget, les tarifs, les quiz.
5. **Tunnel** : le guide PDF, les mails, les leads envoyés à l'app.
6. **Automatisations** : les scrapers, les posts, les réseaux, toujours avec validation.
