# Contenu editorial — guide pour l'equipe Biome

Ce guide explique comment gerer, depuis l'admin (`/admin`), les sections de
contenu editorial du site : le **contenu des pages** (Accueil,
Qui-sommes-nous, Investir), les **partenaires**, les **actualites** (le
"guide Biome"), les **offres d'emploi** (recrutement) et les
**realisations** (galerie de chantiers). Il s'adresse a l'equipe Biome, pas
seulement aux developpeurs.

Ces sections se trouvent dans le menu de gauche de l'admin, sous le groupe
**"Contenu du site"**. Elles sont differentes des **"Formulaires recus"** :
ici, c'est vous qui creez/modifiez le contenu ; les formulaires, eux, ne font
qu'afficher ce que les visiteurs ont envoye (pas de creation possible).

## 1. Contenu de page (Accueil, Qui-sommes-nous, Investir)

Menu admin : **Contenu du site > Contenu de page**. Cette section regroupe
les textes et images modifiables de trois pages du site : l'Accueil (`/`),
la page "Qui sommes-nous" (`/qui-sommes-nous`) et la page "Investir"
(`/investir`). Chaque page a sa propre fiche, avec ses propres blocs.

Comme pour les actualites ou les offres d'emploi, ces fiches se retrouvent
toutes dans la meme liste admin — mais contrairement a elles, il n'y a
**qu'une seule fiche par page** (pas de creation ni de suppression possible,
uniquement de la modification). Ouvrez la fiche correspondant a la page que
vous voulez modifier (son nom apparait dans la liste : "Accueil",
"Qui sommes-nous" ou "Investir").

### 1.1 Page Accueil

#### Modifier le hero

Ouvrez la fiche "Accueil", section **Hero** : titre, sous-titre, texte du
bouton et image de fond sont tous modifiables.

**Important : le lien du bouton n'est pas modifiable ici.** Seul le texte
affiche dessus (ex. "Voir nos biens disponibles") peut changer ; la page vers
laquelle il renvoie reste fixee dans le code du site. C'est vrai pour tous
les boutons de toutes les sections de l'Accueil (et des autres pages) : si un
lien doit changer de destination, il faut le demander a l'equipe technique.

#### Modifier les cartes "parcours"

Section **Cartes parcours** : les deux cartes affichees sous le hero
("Acheter" et "Vendre mon terrain") ont chacune une etiquette, un titre, un
texte, un texte de bouton et une image. Impossible d'ajouter ou de supprimer
une carte (toujours exactement 2), seul leur contenu est modifiable.

#### Modifier "Qui sommes-nous" (version courte)

Section **Qui sommes-nous (version courte)** : c'est le texte de
presentation affiche sur l'Accueil, plus court que celui de la page dediee
"Qui sommes-nous" (voir 1.2 ci-dessous). **Ces deux contenus sont geres
separement** : modifier l'un ne modifie pas l'autre. Pour les paragraphes,
laissez une ligne vide entre chaque paragraphe dans le champ "Texte" : chaque
bloc separe par une ligne vide devient un paragraphe distinct sur le site.

#### Modifier les valeurs

Section **Valeurs** : titre de la section, puis les 3 valeurs affichees
(titre + texte de chacune). Comme pour les cartes parcours, toujours
exactement 3 valeurs, seul leur contenu est modifiable. Les icones qui
accompagnent chaque valeur restent fixees dans le code.

#### Modifier l'en-tete "Partenaires"

Section **Partenaires** : uniquement le titre, le texte d'introduction et le
texte du bouton de cette section. Les 4 cartes de partenaires affichees en
dessous ne se gerent pas ici, mais dans la section **Partenaires** du menu
admin (voir chapitre 2 ci-dessous).

### 1.2 Page Qui-sommes-nous

Ouvrez la fiche "Qui sommes-nous" pour modifier la page complete
`/qui-sommes-nous` (a ne pas confondre avec le bloc court de l'Accueil,
voir 1.1). Elle comporte plusieurs sections, chacune avec ses propres textes
et parfois une image : presentation (hero, 3 paragraphes), les 4 valeurs de
l'entreprise, "Notre ambition" (avec une liste de points forts, une entree
par ligne comme pour les Offres d'emploi), "Pourquoi les familles choisissent
Biome" (3 arguments), "Notre force" (independance financiere), "Notre
equipe" et le bandeau de conclusion (CTA final).

**Le carrousel de photos "Nos realisations" ne se gere pas depuis cette
fiche.** Seul le titre de cette section est modifiable ici ; les photos
elles-memes se gerent dans la section **Realisations** du menu admin (voir
chapitre 5 ci-dessous).

Comme pour l'Accueil, les liens des boutons restent fixes dans le code : seul
le texte affiche dessus est modifiable.

### 1.3 Le guide Biome (bloc "Telechargez notre guide")

Ouvrez la fiche **"Actualites"** (meme liste que les autres pages, section
1 ci-dessus) pour gerer le bloc "Telechargez notre guide" affiche dans la
barre laterale de la page `/actualites`. Trois champs :

- **Titre** et **Texte** : l'accroche affichee au-dessus du formulaire
  (prenom + email) que les visiteurs remplissent pour recevoir le guide.
- **Fichier PDF** : le guide lui-meme, a uploader une fois pret. Tant qu'aucun
  fichier n'est uploade, ce champ reste vide.

**Ce que voit le visiteur selon que le PDF est configure ou non :**

- **PDF uploade** : apres avoir rempli le formulaire, le visiteur voit un
  message de confirmation avec un bouton "Telecharger le PDF" qui lance le
  telechargement immediatement.
- **Aucun PDF uploade** : le visiteur voit un message different, qui
  l'informe honnetement qu'il recevra le guide par e-mail (pas de faux
  bouton de telechargement qui ne menerait a rien). Pensez donc a uploader le
  PDF avant de communiquer sur ce bloc, sans quoi personne ne recoit
  automatiquement le guide en telechargement direct.

Dans les deux cas, la personne qui a rempli le formulaire est enregistree
dans **Formulaires recus > Telechargements guide** (voir chapitre "Consulter
les demandes de guide" ci-dessous).

### 1.4 Page Investir

Ouvrez la fiche "Investir" pour modifier la page `/investir`. Elle comporte :
le bandeau hero, la section "Pourquoi investir dans le neuf" (4 avantages),
l'en-tete de la section "Biens d'investissement" (titre et textes de
bouton uniquement), la section "Accompagnement" (4 etapes du parcours
investisseur) et le bandeau de conclusion.

**Important : les biens affiches dans la section "Biens d'investissement"
(cartes avec loyer estime, rendement, type de bien) ne sont PAS geres dans
l'admin.** Ces donnees proviennent exclusivement du CRM (le "Portail
vendeur"), au meme titre que les biens a vendre de la page Acheter — voir
`docs/architecture-donnees.md` section 3. Si un bien doit etre ajoute, retire
ou corrige dans cette section, la demande passe par le CRM, jamais par
l'admin du site.

Le bandeau "Recevez nos opportunites d'investissement" tout en bas de la page
(champ e-mail + bouton) est pour l'instant **purement decoratif** : il n'est
relie a aucune inscription reelle.

### Uploader une image

Chaque champ image (hero, cartes parcours, "Qui sommes-nous"...) fonctionne
de la meme facon, sur toutes les pages : cliquez sur la zone d'upload,
choisissez un fichier JPG ou PNG depuis votre ordinateur. L'image est
stockee automatiquement et remplace l'image actuelle sur le site des
l'enregistrement.

## 2. Partenaires

Menu admin : **Contenu du site > Partenaires**. Cette section gere la liste
des partenaires et sous-traitants de Biome, avec deux usages : le bloc
"Partenaires" de la page d'accueil (4 cartes maximum) et, plus tard, la page
dediee `/partenaires`.

| Champ | Explication | Exemple |
|---|---|---|
| Nom | Nom du partenaire ou de la categorie de metier. | "Macons & entreprises de gros oeuvre" |
| Categorie / metier | Affiche en badge sur la carte. | "Gros oeuvre" |
| Image | Photo illustrant le partenaire. Optionnelle : si absente, un bloc neutre s'affiche a la place, le site ne casse jamais visuellement. | — |
| Mis en avant sur l'accueil | Case a cocher. Seuls les partenaires coches peuvent apparaitre dans le bloc "Partenaires" de l'Accueil. | — |
| Ordre d'affichage | Un nombre. Plus il est petit, plus le partenaire apparait tot dans la liste. | `1` |

### Creer un partenaire

Bouton "New partenaire" (ou "Creer") en haut de la liste. Seuls le nom et la
categorie sont obligatoires ; l'image est facultative.

### Mettre en avant un partenaire sur l'accueil

Cochez "Mis en avant sur l'accueil" sur la fiche du partenaire. La page
d'accueil affiche au maximum **4 partenaires mis en avant**, tries par leur
"Ordre d'affichage" (du plus petit au plus grand). Si plus de 4 partenaires
sont coches "mis en avant", seuls les 4 avec l'ordre le plus bas
apparaissent sur l'Accueil — ajustez l'ordre ou decochez les partenaires en
trop pour controler precisement lesquels s'affichent.

### Ordonner les partenaires

Dans la liste de l'admin, la colonne "Ordre" est triable : utilisez-la pour
vous reperer rapidement. Pour changer l'ordre d'affichage sur le site,
modifiez le champ "Ordre d'affichage" sur chaque fiche partenaire (un nombre
plus petit passe avant un nombre plus grand).

## 3. Gerer une actualite

Menu admin : **Contenu du site > Actualites**. Chaque actualite correspond a
un article affiche sur la page `/actualites` du site public.

| Champ | Explication | Exemple |
|---|---|---|
| Titre | Titre de l'article, affiche en gros sur la carte et en haut de l'article. | "Combien coute une maison neuve en Wallonie en 2026 ?" |
| Slug (URL) | Partie de l'adresse web de l'article. **Laissez-le vide** : il est genere automatiquement a partir du titre. Ne le modifiez que si vous savez ce que vous faites (changer le slug d'un article deja publie casse les liens partages vers cet article). | `combien-coute-une-maison-neuve-en-wallonie-en-2026` |
| Categorie | Une des 5 categories fixes du site : Construire, Terrain, Investir, Fiscalite, Conseils. Determine dans quel filtre l'article apparait. | "Construire" |
| Extrait | Resume court (1-2 phrases), affiche sur la carte dans la liste des articles. | "Prix, facteurs qui influencent le budget et conseils pour mieux planifier votre projet." |
| Contenu | Le texte complet de l'article. | — |
| Image mise en avant | Photo affichee en tete de la carte. Formats image classiques (JPG, PNG...). Si aucune image n'est fournie, un bloc de couleur neutre s'affiche a la place — le site ne casse jamais visuellement. | — |
| Date de publication | Date et heure a partir de laquelle l'article devient visible sur le site. | — |
| Temps de lecture | Texte libre affiche a cote de la date. | "6 min" |
| Article populaire | Case a cocher. Si activee, l'article peut apparaitre dans le bloc "Articles populaires" de la barre laterale (jusqu'a 3 articles a la fois, les plus recents parmi ceux coches). | — |

### Publier un article a l'avance

La "Date de publication" n'a pas besoin d'etre la date du jour : vous pouvez
saisir une date future pour programmer la publication d'un article. Tant que
la date n'est pas atteinte, l'article reste enregistre dans l'admin mais
**n'apparait pas** sur le site public. Il suffit donc de preparer un article
a l'avance et de choisir sa date de sortie.

A l'inverse, un article avec une date de publication passee est visible
immediatement, meme si vous venez de le creer.

## 4. Gerer une offre d'emploi

Menu admin : **Contenu du site > Offres d'emploi**. Chaque offre correspond
a une fiche affichee sur la page `/offres-emploi`, avec une page de detail
dediee, et peut aussi apparaitre sur la page `/recrutement` (4 offres les
plus en avant au maximum).

| Champ | Explication | Exemple |
|---|---|---|
| Intitule du poste | Titre du poste. | "Conducteur de chantiers" |
| Slug (URL) | Comme pour les actualites : laissez-le vide, il se genere tout seul depuis l'intitule. | `conducteur-de-chantiers` |
| Lieu | Ville / commune du poste. | "Gedinne" |
| Type de contrat | Texte libre. | "CDI" |
| Temps de travail | Texte libre. | "Temps plein" |
| Description courte | Resume affiche dans la liste des offres. | "Vous etes responsable du suivi et de la coordination des chantiers residentiels..." |
| Missions | Liste des missions du poste, affichee sur la page de detail avec une puce par ligne. | voir ci-dessous |
| Profil recherche | Liste des criteres attendus du candidat, meme principe. | voir ci-dessous |
| Avantages | Liste des avantages proposes, meme principe. | voir ci-dessous |
| Badge "Nouveau" | Case a cocher qui affiche un badge "Nouveau" sur la carte de l'offre dans la liste. | — |
| Offre active | Case a cocher. Si decochee, l'offre **disparait du site public** immediatement, sans etre supprimee de l'admin (vous pouvez la reactiver plus tard). | — |
| Ordre d'affichage | Un nombre. Plus il est grand, plus l'offre apparait haut dans la liste. A egalite, l'offre la plus recemment creee passe devant. | `6` |

### Le format "une entree par ligne" (Missions, Profil, Avantages)

Ces trois champs sont de simples zones de texte : **chaque ligne que vous
tapez devient un point de la liste a puces** affichee sur le site. Pas de
tirets ni de numeros a ajouter vous-meme, juste retour a la ligne entre
chaque idee.

Exemple de saisie dans le champ "Missions" :

```
Planifier, organiser et superviser les chantiers de A a Z.
Coordonner les equipes et les differents intervenants.
Assurer le suivi technique et la qualite d'execution des travaux.
```

Cela donnera, sur la page de detail de l'offre, trois lignes distinctes avec
une puce devant chacune. Une ligne vide est ignoree, donc pas de souci si
vous laissez un saut de ligne en trop.

### Activer / desactiver une offre

Decocher "Offre active" est la maniere normale de retirer une offre pourvue
du site, sans perdre son contenu (vous pourrez la reutiliser ou vous en
inspirer pour une offre similaire plus tard). Ne supprimez une offre que si
vous etes certain de ne plus jamais en avoir besoin — la suppression est
definitive.

Les candidatures deja recues pour une offre restent visibles dans
**Formulaires recus > Candidatures**, meme si l'offre est ensuite desactivee
ou supprimee.

## 5. Realisations

Menu admin : **Contenu du site > Realisations**. Cette section gere les
photos du carrousel "Nos realisations" affiche sur la page "Qui sommes-nous"
(`/qui-sommes-nous`) : des exemples de chantiers termines par Biome.

| Champ | Explication | Exemple |
|---|---|---|
| Titre | Legende principale affichee sous (ou a la place de) la photo. | "Maison contemporaine" |
| Legende complementaire | Texte optionnel, plus precis que le titre. | "Ciney, 4 chambres" |
| Image | Photo du chantier realise. **Optionnelle** : si absente, un bloc neutre reprenant le titre/legende s'affiche a la place sur le carrousel, le site ne casse jamais visuellement. | — |
| Ordre d'affichage | Un nombre. Determine la position dans le carrousel, du plus petit au plus grand. | `1` |

### Creer une realisation

Bouton "New realisation" (ou "Creer") en haut de la liste. Seul le titre est
obligatoire ; l'image est facultative (mais fortement recommandee : sans
photo, le visiteur ne voit qu'un bloc de texte).

### Ordonner les realisations

Dans la liste de l'admin, vous pouvez glisser-deposer les lignes pour changer
l'ordre d'affichage directement (la colonne "Ordre" se met a jour toute
seule). Vous pouvez aussi modifier le champ "Ordre d'affichage" sur chaque
fiche individuellement.

Le carrousel du site defile en boucle automatiquement (aucune action du
visiteur necessaire) : toutes les realisations enregistrees sont affichees,
il n'y a pas de limite de nombre ni de case "mis en avant" a cocher.

## 6. Consulter les demandes de guide

Le formulaire "Telechargez notre guide" (voir 1.3 ci-dessus) n'est **pas**
gere depuis "Contenu du site", mais depuis le menu **Formulaires recus >
Telechargements guide**. C'est une liste en lecture seule : chaque ligne
correspond a une personne (prenom + email) qui a demande le guide, dans
l'ordre ou elle a rempli le formulaire. Rien a modifier ici, uniquement a
consulter (et supprimer si besoin, comme pour les autres formulaires recus).

Pour rappel, ces demandes sont automatiquement supprimees au bout de 24 mois
(purge RGPD, voir `docs/rgpd.md`) : pas d'action manuelle necessaire pour les
nettoyer.

## 7. Contenu en attente de redaction reelle

Le site a ete pre-rempli (via `php artisan migrate --seed`) avec le contenu
observe dans la maquette, pour permettre une recette visuelle fidele. Ce
contenu de demarrage n'est pas final : a remplacer par de vrais contenus des
que possible.

- **Corps des articles d'actualite.** La maquette source ne fournissait
  qu'un titre et un resume par article, jamais le texte complet. Le contenu
  actuellement enregistre dans le champ "Contenu" de chaque article seede est
  provisoirement une copie de l'extrait : ce n'est pas un article redige.
  A remplacer par un vrai texte via l'admin, article par article.
- **Images des actualites.** Aucune image n'est associee aux articles de
  depart (la maquette utilisait un simple bloc de texte a la place d'une
  photo). A ajouter via le champ "Image mise en avant" de chaque article.
- **Missions / profil / avantages des offres d'emploi.** Le contenu de
  depart est identique pour les 6 offres seedees (la maquette source ne
  detaillait pas ces listes offre par offre). A personnaliser au cas par cas
  si les missions different reellement d'un poste a l'autre.
- **Photos des realisations.** Les 6 realisations de depart n'ont aucune
  image (la maquette source n'affichait que des emplacements vides a cet
  endroit, aucune vraie photo de chantier dans l'export). A completer via le
  champ "Image" de chaque realisation des que de vraies photos de chantier
  sont disponibles.