Les biens et l'éditeur
Ce que contient un bien, comment un agent en ajoute et en modifie un dans le tableau de bord, ses photos et son emplacement, et comment la publication décide de ce que montre le site.
Pour le pack Full Stack
Ce que contient un bien
| Partie | Valeurs |
|---|---|
| Textes, en anglais et en arabe | Titre, courte description, description, ville, titre SEO et description SEO. L'anglais est obligatoire pour le titre. |
| Finalité | sale ou rent. Les locations sont au prix annuel. |
| Type | apartment, villa ou townhouse |
| Prix | Un montant positif en AED |
| Faits | Chambres, salles de bain, surface en mètres carrés, places de parking, ameublement (unfurnished, semi-furnished, furnished) et espace extérieur (terrace, balcony, garden, courtyard ou aucun) |
| Équipements | N'importe lesquels parmi 14 : piscine privée, terrasse, jardin, parking couvert, balcon, salle de sport, conciergerie, vue sur la mer, vue sur la marina, vue sur le canal, cour, bureau, chambre de service, maison connectée |
| Emplacement | Quartier, adresse, un point sur la carte, et si ce point est exact ou approximatif |
| Photos | Jusqu'à 30 dans l'éditeur, dans l'ordre choisi, l'une d'elles étant la couverture |
| Statut | draft, published, sold, rented ou archived |
| Interne | Une référence attribuée dans l'ordre (P001, P002 et ainsi de suite), un slug d'adresse fait à partir du titre, un indicateur de mise à la une et des notes que le site n'affiche jamais |
Les types, les équipements et les autres listes fermées sont définis une fois dans l'API et libellés dans les fichiers de messages des deux frontends : une nouvelle valeur est donc une modification dans les trois applications.
Les statuts et ce que montre le site
| Statut | Sur le site |
|---|---|
| Brouillon | Masqué. Chaque nouveau bien commence ici. |
| Publié | Listé, trouvable par la recherche, dans le sitemap, et sélectionnable pour la page d'accueil. La première publication fixe sa date de publication, qu'une republication ultérieure conserve. |
| Vendu, Loué | Masqué, conservé dans le tableau de bord comme archive. |
| Archivé | Masqué, et peut être publié de nouveau. |
Supprimer un bien le retire aussi du tableau de bord. La page d'accueil met en avant les trois biens choisis sous Paramètres, Page d'accueil ; quand aucun n'est publié, elle se rabat sur les biens publiés marqués à la une.
La liste des biens
- Des onglets Tous, Publiés et Brouillons avec leurs nombres, une recherche par titre (dans l'une ou l'autre langue) ou par référence, et des filtres par finalité, type et statut, six biens par page.
- Le menu de chaque ligne publie, dépublie (retour en brouillon), archive ou supprime le bien. Archiver et supprimer demandent d'abord confirmation.
- Les biens sont listés en commençant par les plus récemment mis à jour.
L'éditeur de bien
/en/dashboard/properties/new ajoute un bien et /en/dashboard/properties/<id>/edit en modifie un. L'éditeur a quatre onglets et une carte de publication à côté.
| Onglet | Ce qu'il contient | Limites |
|---|---|---|
| Détails | Le titre, la courte description et la description dans les deux langues, la finalité, le type, le prix, les faits, les équipements et l'indicateur de mise à la une | Titre 160 caractères, courte description 500, description 5000 |
| Médias | Des photos déposées ou choisies depuis l'ordinateur, ordonnées par glisser-déposer, l'une marquée comme couverture | Jusqu'à 30, en JPEG, PNG ou WebP |
| Emplacement | La ville dans les deux langues, le quartier, l'adresse, une épingle déplacée sur la carte ou trouvée par la recherche de lieu, et exact ou approximatif | Ville 80, adresse 255 |
| SEO | Le titre et la description SEO dans les deux langues, le slug d'adresse et les notes internes | Titre SEO 160, description SEO 320, notes 2000 |
- La carte de publication définit l'un des cinq statuts, et « Preview listing » ouvre le bien sur le site une fois qu'il est publié.
- La carte affiche des tuiles OpenFreeMap et la recherche de lieu utilise le service public Photon, tous deux sans clé.
NEXT_PUBLIC_MAP_STYLE_LIGHT,NEXT_PUBLIC_MAP_STYLE_DARKetNEXT_PUBLIC_PLACE_SEARCH_URLles font pointer ailleurs. - Les photos sont téléversées au fur et à mesure qu'on les ajoute et ré-encodées par l'API, sur 1920 pixels de large au maximum.
Qui peut faire quoi
| Permission | Autorise |
|---|---|
properties.view | Voir tous les biens, brouillons compris |
properties.create | Ajouter des biens |
properties.edit | Modifier les détails et les photos |
properties.publish | Publier, dépublier, archiver, et marquer comme vendu ou loué |
properties.delete | Supprimer des biens |
Les deux rôles du seed, Super Admin et Agent, détiennent les cinq.
Ce que vérifie l'API
- Chaque liste fermée (finalité, type, statut, ameublement, espace extérieur, équipements) est validée, et un prix, un nombre ou une surface hors de sa plage est refusé en nommant le champ.
- L'API accepte jusqu'à 40 photos dans une galerie ; l'éditeur s'arrête à 30.
- Un slug est rendu unique à partir du titre quand il n'est pas donné, et une référence n'est jamais attribuée deux fois.
- La liste du site accepte
purpose,type,neighborhood,min_price,max_price,bedrooms,amenities(séparés par des virgules) etq, trie parnewest,price_ascouprice_desc, et pagine avecpageetpage_size(12 par défaut, 24 au maximum). Une valeur inconnue dans l'un d'eux est refusée plutôt qu'ignorée.