Architecture de Plateforme de Commission
Plateformes de commission multi-locataires où chaque utilisateur (artiste, créateur, freelance) dispose d'une page publique avec des fonctionnalités de commande. Ce skill couvre la décision architecturale d'offrir à la fois des modèles hébergés intégrés et la possibilité pour les créateurs disposant de leur propre site de s'intégrer.
Système de Pages à Trois Couches
Le modèle architectural central : prendre en charge les créateurs à trois niveaux de compétence technique et d'indépendance.
┌─────────────────────────────────────────────────┐
│ Couche 3 : Hébergement de page personnalisée │
│ Téléchargez votre propre HTML/CSS/JS → servi à│
│ /artiste/alice (fichiers statiques depuis uploads/)│
├─────────────────────────────────────────────────┤
│ Couche 2 : Widget intégrable │
│ Collez une balise <script> sur votre site │
│ → Bouton "Commander une commission" + formulaire│
├─────────────────────────────────────────────────┤
│ Couche 1 : Modèles intégrés │
│ Choisissez une variante de mise en page, zéro │
│ configuration → Page complète à /artiste/alice │
└─────────────────────────────────────────────────┘
Couche 1 : Modèles intégrés
À qui cela s'adresse : Créateurs qui n'ont pas leur propre site web ou qui ne souhaitent pas en maintenir un.
Implémentation : Composants Vue avec thème CSS Variables.
// Route : /artiste/:sous-domaine
routes.get('/artiste/:sous-domaine', async (req, reply) => {
const artiste = await artisteService.getBySousDomaine(req.params.sous-domaine)
if (artiste.type_page === 'default') {
// Rendre le SPA Vue intégré (ou SSR)
// le champ theme_page contrôle la variante de modèle
return reply.sendFile('index.html')
}
// ... passer aux couches 2-3 traitées ailleurs
})
Modèle = Disposition × Palette (axes orthogonaux) — la décision de modélisation la plus importante. Si deux "modèles" diffèrent principalement par la couleur, ce ne sont PAS deux modèles — c'est une disposition portant deux coloris. Intégrer la couleur dans la dimension du modèle gonfle le nombre de modèles avec du code de structure dupliqué (les utilisateurs le feront remarquer : "ces pages ont l'air identiques en couleurs différentes"). Séparez en axes que l'artiste choisit indépendamment :
| Axe | Qui choisit | Exemples | Contrôle |
|---|---|---|---|
| Disposition (structure) | Artiste | classique (studio deux colonnes) / galerie (musée plein écran) / portfolio (page d'accueil unique) / atelier (studio chaleureux façon livre) | Traitement d'ouverture, logique de colonnes, forme de galerie, navigation |
| Palette (ambiance) | Artiste | papier / encre / crépuscule / mousse — chacune définie avec des variantes claires ET sombres | Couleurs de fond/surface/texte de la page (variables CSS --pal-*) |
| Accent + mode | Visiteur | Sélecteur de 5 couleurs d'accent + préférence clair/sombre | --color-primary, html.dark |
Règles clés :
- Une palette est une ambiance avec des variantes claires+sombres, jamais "le thème sombre". L'artiste choisit
encre; les visiteurs en mode clair voient un gris pâle, ceux en mode sombre voient du charbon — l'ambiance reste cohérente, la luminosité suit le visiteur. - La couleur d'accent (boutons/liens/surlignages) utilise toujours la variable d'accent du visiteur (
--color-primary), jamais les variables de palette — les deux systèmes restent orthogonaux et fonctionnent tous les deux. - 4 dispositions × 4 palettes = 16 apparences distinctes à partir de 8 définitions.
- Les dispositions doivent différer structurellement (ouverture différente, logique de colonnes différente) ou elles doivent être fusionnées en une seule disposition.
Archétypes de disposition qui fonctionnent — chacun s'ouvre avec l'actif le plus distinctif de l'artiste (son art), pas un héros générique centré nom+bio+boutons :
| Disposition | Ouverture | Signature |
|---|---|---|
| galerie | Œuvre plein écran, nom comme petite plaque dans le coin | Galerie éditoriale grande/petite en alternance, zoom au survol, aperçu au clic |
| classique | Bannière avec l'œuvre phare, nom superposé sur l'art | Deux colonnes sur desktop, carte d'infos sticky avec CTA de commission toujours visible |
| portfolio | Écran split : texte à gauche, œuvres empilées à droite | Surbrillance de navigation défilante, hamburger mobile + CTA sticky en bas |
| atelier | Dépliage façon livre chaleureux, typographie serif (Noto Serif SC) | Fond texturé papier, marges éditoriales, espace blanc généreux, centré sur l'art avec ambiance littéraire |
Architecture de kit partagé (éprouvée) : les modèles ne lisent jamais directement les noms de champs backend — un composable adaptateur (useArtistData(props)) fournit imgUrl(), statusText() (i18n), socialLinks, heroArtwork ; les composants Tpl* réutilisables prennent des variantes via props (TplHero variant="banner|fullscreen|split", TplGallery layout="grid|editorial|masonry") avec des slots comme points d'extension (#addons sur la grille de paliers). Voir references/template-system.md pour le modèle complet incluant les corrections de synchronisation des composants asynchrones et le mappage des ID hérités.
Surcharge de la couleur d'accent définie par l'artiste (motif R49) : L'artiste peut définir une couleur d'accent persistante (liste blanche de 5 couleurs, stockée comme artists.accent_color TEXT) qui remplace le choix du ThemePicker du visiteur sur sa page publique. Implémentation dans ArtistHome.vue :
const ACCENT_INDEX = { '#34dbcb': '1', '#34c2db': '2', '#3498db': '3', '#346edb': '4', '#3445db': '5' }
const accentOverride = computed(() => {
const raw = previewAccent.value || artist.value?.accentColor
return raw ? (ACCENT_INDEX[String(raw).toLowerCase()] || null) : null
})
// watch(immediate) + onUnmounted : sauvegarder/restaurer document.documentElement.dataset.accent
Décisions clés : (1) Injection d'attribut global data-accent — AUCUN changement de variable CSS par modèle nécessaire (theme.css a déjà des sélecteurs data-accent="1"~"5" avec variantes claires+sombres). Ajouter le support d'accent aux 4 modèles = zéro changement de fichier de modèle. (2) L'accent de l'artiste prend la priorité sur le ThemePicker du visiteur sur la page de l'artiste ; le choix du visiteur est restauré dans onUnmounted. (3) Le backend valide par rapport à la liste blanche de 5 couleurs + null (effacer) ; normalisation toLowerCase() à l'écriture. (4) Interface utilisateur des paramètres : boutons circulaires (32px) avec ✓ sur l'actif + bouton "默认" (par défaut). PAS el-color-picker (une couleur libre briserait la liste blanche). (5) Décision C61 : l'accent n'affecte que les pages destinées aux clients, PAS le tableau de bord de l'artiste.
Mode aperçu via paramètres d'URL (motif R50) : Le bouton "预览主页" (Aperçu page d'accueil) des paramètres ouvre /artiste/:sous-domaine?_tpl=X&_pal=Y&_accent=Z dans une nouvelle fenêtre. ArtistHome.vue lit route.query._tpl/_pal/_accent comme surcharges de la couche de rendu (n'écrit jamais dans la couche de données). Une bannière d'avertissement sticky ("预览模式 — 修改尚未保存" - Mode aperçu — les modifications ne sont pas sauvegardées) s'affiche lorsqu'un paramètre d'aperçu est présent. Les valeurs calculées de modèle/palette/accent passent par défaut : previewParam || artist.field || default. Sûr pour un accès public — les paramètres d'aperçu n'affectent que le rendu, toutes les données proviennent de l'API publique.
Timeline d'activité remplaçant la liste de notes plates (motif R40) : Lors de la fusion des enregistrements de changement de statut (notes système) et des notes d'artiste dans une seule vue chronologique, utilisez el-timeline avec différenciation de type/creux :
<el-timeline-item :type="note.created_by === 'system' ? 'info' : (note.image_path ? 'success' : 'primary')"
:hollow="note.created_by === 'system'" :timestamp="formatDate(note.created_at)" placement="top">
Indicateurs de type : 🔄 changement de statut / 📝 note / 🖼 note avec image. Les notes système reçoivent la classe tl-item--system (couleur atténuée, police plus petite). Le bouton de suppression (R46) n'apparaît que pour les notes non système, révélé au survol avec repli tactile @media (hover: none). La zone de saisie se déplace en bas de la timeline. Zéro changement backend — les notes système existent déjà dans order_notes avec created_by='system'. La barre d'opérations (avancer/reculer/annuler) reste À L'EXTÉRIEUR de la carte de timeline.
Glisser-remplacer avec comportement de confirmation contextuel (R53 vs R55) : Deux fonctionnalités de glisser-remplacer dans la même application ont des exigences de confirmation DIFFÉRENTES — ne les unifiez PAS :
| R53 Image de focus du tableau de file d'attente | R55 Image d'exemple de palier | |
|---|---|---|
| Confirmation d'écrasement | Non (l'ancienne image reste dans la galerie de commandes) | Oui — ElMessageBox.confirm (ancienne image perdue) |
| Raison | Remplacer le focus ≠ supprimer l'image | Écraser l'exemple = ancienne image irrécupérable |
Implémentation : infrastructure de glisser partagée (dragover.prevent/dragleave avec contains(relatedTarget) anti-papillotement/drop.prevent + champ de fichier caché), mais la fonction de téléchargement vérifie if (row.example_image) { await ElMessageBox.confirm(...) } uniquement pour R55. Les deux réutilisent les API de téléchargement existantes. Le preview-src-list de el-image doit être supprimé de l'image de focus de R53 pour éviter qu'il n'absorbe l'événement de clic (même piège que R18). |
Extraction du composable du formulaire de commande (motif R58-1) : Lorsque le formulaire de commande dépasse environ 400 lignes (chargement des données + tarification + validation + téléchargement + soumission + récupération de brouillon), extrayez TOUTE la logique métier dans un composable partagé (useOrderForm.js). Le composant de page devient une mise en page pure (~300 lignes de modèle + style, le script est juste const of = useOrderForm(subdomain, formRef) + déstructuration). Le composable retourne un objet plat de refs/reactives/méthodes regroupés par préoccupation : chargement des données (artiste, paliers, règlesContent, chargement), état du formulaire + règles de validation, état de soumission (envoiEnCours, afficherSuccès, numéroRésultat, soumettre), images de référence (listeFichiersRef, gérerUploadRef, gérerSuppressionRef), tarification (sélectionsSuppl, aperçuPrix, tarificationDépliée, palierSélectionné, onChangementPalier), et HTML des règles assaini. Pourquoi cela compte pour les modèles multiples : lorsque la page de commande prend en charge plusieurs modèles de mise en page (étape par étape, type reçu, type magazine), chaque modèle est une coque de mise en page fine qui appelle le MÊME composable — zéro duplication de logique. Le composable est le "noyau", les modèles sont des "peaux". C'est le même modèle d'adaptateur que useArtistData pour la page d'accueil, appliqué au formulaire de commande. Détail d'implémentation clé : le composable prend formRef (la ref el-form du modèle) comme paramètre car la validation (formRef.value.validate()) doit appeler l'élément formulaire du modèle — le composable possède la logique mais PAS le DOM.
Mise en page du formulaire de commande étape par étape (motif R58-2, éprouvé) : La mise en page de commande par défaut est un flux guidé en trois étapes construit entièrement sur useOrderForm() (zéro changement du composable par rapport à R58-1 — valide l'extraction) :
- Indicateur d'étape : trois points numérotés + lignes de connexion. Actuel : agrandi + primaire. Terminé : ✓ + remplissage primaire. En attente : creux gris. Mobile (≤860px) : points uniquement.
- Étape 1 — Choisir le palier : grille de cartes responsive (
repeat(auto-fill, minmax(240px, 1fr))) remplaçantel-select. Sélectionné : transition--ease-bounce+ tampon tournant ✓ (@keyframes tier-stamp-in: échelle 0→1.2→1, rotation -15°→0°). La divulgation progressive R14 reste à l'intérieur de l'étape 1. - Étape 2 — Décrire + télécharger : zone de texte + tags d'inspiration (R58-4 : puces codées en dur par défaut, clic ajoute avec virgule intelligente + troncature à 2000 caractères) + téléchargement de référence (fichier + coller inchangé).
- Étape 3 — Contact : QQ + nom + accord sur les règles.
- Carte récapitulative sticky : colonne de droite grand écran (280px sticky), palier + détail + total + échéances en temps réel. Mobile : bas de l'étape active.
- Confirmation de reçu (R58-3) : soumettre → valider →
el-dialogtype reçu de café (téléporté au body, CSS global espace de nomsreceipt-*danstemplates.css). Papier#fdfbf5, police Courier, bords zigzag (repeating-conic-gradient), séparateurs en tirets, décoration code-barres, puces d'échéances. Thème clair fixe (métaphore du papier). Annuler retourne à l'étape 3 ; confirmer appellesubmit(). - Copier les informations de commande (R58-5) : boîte de dialogue de succès "复制约稿信息" (Copier les infos de commande) → presse-papiers multi-lignes (numéro de commande + palier + suppléments + total).
- Navigation par étapes : "下一步" (Suivant) valide l'étape actuelle avant d'avancer ; "上一步" (Précédent) toujours autorisé ; pas de saut.
Page de commande multi-modèle (architecture R58) : La page de commande prend en charge des modèles de mise en page sélectionnables par l'artiste, indépendants du modèle de page d'accueil. Backend (éprouvé, migration v16) : artists.order_template_id TEXT DEFAULT 'default' — validation de liste blanche au niveau service (ORDER_TEMPLATES = ['default'], étendre le tableau lors de l'ajout de modèles). GET /api/artists/:sous-domaine retourne orderTemplateId: artist.order_template_id || 'default'. PUT /api/artist/profile accepte orderTemplateId (mappé via keyMap vers order_template_id). Les valeurs invalides lèvent INVALID_ORDER_TEMPLATE (409). La chaîne vide revient à 'default'. Frontend : La page des paramètres de l'artiste affiche un sélecteur de modèle de type carte (même modèle d'interface que la sélection de modèle de page d'accueil). Routage côté client : OrderForm.vue lit artist.orderTemplateId et rend le composant de mise en page correspondant via <component :is="..."> ou une carte de registre de modèles. Tous les composants de mise en page partagent useOrderForm() — ils diffèrent UNIQUEMENT par la disposition visuelle (indicateurs d'étape, disposition des cartes, style de la boîte de dialogue de confirmation). Ajouter un nouveau modèle de commande = un nouveau fichier .vue avec une coque de mise en page + une entrée dans le tableau de liste blanche backend, zéro changement de logique. Aperçu : réutiliser le mécanisme de paramètre d'URL _tpl de l'aperçu de la page d'accueil.
Motif de contact QQ (R58-6) : Deux actions pour le contact QQ : "跳转QQ" (Aller à QQ) (window.open('tencent://message/?uin=' + encodeURIComponent(qq), '_self')) + "复制QQ" (Copier QQ) (navigator.clipboard.writeText(qq) avec toast). Repli du presse-papiers : en cas d'échec (autorisation refusée, non-HTTPS), affichez ElMessage.warning(qq) — le numéro QQ lui-même comme message d'avertissement, afin que l'utilisateur puisse le copier manuellement à partir du toast. Appliqué à deux endroits : boîte de dialogue de succès côté client (qqContact de l'artiste) et détail de commande côté artiste (qq du client). i18n : clés séparées par contexte (orderForm.jumpQq vs orderDetail.jumpQq) car le message du toast diffère ("QQ号已复制" - QQ copié vs "客户QQ已复制" - QQ client copié).
Motifs d'amélioration CSS (lot v0.16, éprouvés) :
- Assouplissement global du rebond :
--ease-bounce: cubic-bezier(.34, 1.56, .64, 1)dans:root. Utiliser UNIQUEMENT pour les transitions transform/box-shadow (jamais l'opacité — ne peut pas dépasser 1.0). Repli dans le code consommateur :var(--ease-bounce, cubic-bezier(0.22, 1, 0.36, 1)). - Modèle physique à trois états du bouton :
.el-button:hover:not(:disabled):not(.is-loading) { transform: translateY(-3px); box-shadow: plus profond }+:active { transform: translateY(-1px) scale(0.98) }. Les exclusions:not()empêchent les boutons désactivés/en chargement d'animer. - **
clamp()fluide`
...
[tronqué pour la traduction]