@salifbiaye/create-boutique 0.5.0 → 0.7.0

package/templates/backend/src/modules/product-review/migrations/Migration20261001090000.ts

@@ -0,0 +1,18 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations";
+
+// Écrite à la main (même forme que celles générées par `medusa db:generate productReview`) : table des avis.
+export class Migration20261001090000 extends Migration {
+
+  override async up(): Promise<void> {
+    this.addSql(`create table if not exists "product_review" ("id" text not null, "product_id" text not null, "sales_channel_id" text not null, "order_id" text not null, "customer_email" text not null, "author_name" text not null, "rating" integer not null, "title" text null, "comment" text not null, "status" text check ("status" in ('pending', 'approved', 'rejected')) not null default 'pending', "created_at" timestamptz not null default now(), "updated_at" timestamptz not null default now(), "deleted_at" timestamptz null, constraint "product_review_pkey" primary key ("id"));`);
+    this.addSql(`CREATE INDEX IF NOT EXISTS "IDX_product_review_product_id" ON "product_review" ("product_id") WHERE deleted_at IS NULL;`);
+    this.addSql(`CREATE INDEX IF NOT EXISTS "IDX_product_review_sales_channel_id" ON "product_review" ("sales_channel_id") WHERE deleted_at IS NULL;`);
+    this.addSql(`CREATE UNIQUE INDEX IF NOT EXISTS "IDX_product_review_order_id_product_id_unique" ON "product_review" ("order_id", "product_id") WHERE deleted_at IS NULL;`);
+    this.addSql(`CREATE INDEX IF NOT EXISTS "IDX_product_review_deleted_at" ON "product_review" ("deleted_at") WHERE deleted_at IS NULL;`);
+  }
+
+  override async down(): Promise<void> {
+    this.addSql(`drop table if exists "product_review" cascade;`);
+  }
+
+}

package/templates/backend/src/modules/product-review/models/review.ts

@@ -0,0 +1,25 @@
+import { model } from "@medusajs/framework/utils"
+
+/**
+ * Avis client sur un produit. Seul un acheteur peut en laisser un (lien signé de l'e-mail « commande livrée »),
+ * une fois par produit et par commande ; il n'est affiché qu'après validation dans l'admin (page Avis).
+ * sales_channel_id = boutique d'où vient la commande : l'admin filtre par boutique, et le site affiche les avis
+ * de toutes les boutiques (réglage « shared », défaut) ou seulement les siens (« boutique », project.json → defaults.reviews).
+ * customer_email n'est jamais renvoyé par les routes publiques.
+ */
+const Review = model
+  .define("product_review", {
+    id: model.id({ prefix: "prev" }).primaryKey(),
+    product_id: model.text().index(),
+    sales_channel_id: model.text().index(),
+    order_id: model.text(),
+    customer_email: model.text(),
+    author_name: model.text(),
+    rating: model.number(),
+    title: model.text().nullable(),
+    comment: model.text(),
+    status: model.enum(["pending", "approved", "rejected"]).default("pending"),
+  })
+  .indexes([{ on: ["order_id", "product_id"], unique: true }])
+
+export default Review

package/templates/backend/src/modules/product-review/service.ts

@@ -0,0 +1,6 @@
+import { MedusaService } from "@medusajs/framework/utils"
+import Review from "./models/review"
+
+class ProductReviewModuleService extends MedusaService({ Review }) {}
+
+export default ProductReviewModuleService

package/templates/backend/src/modules/product-review/validators.ts

@@ -0,0 +1,27 @@
+import { z } from "@medusajs/framework/zod"
+
+/** Texte simple uniquement (aucun < ou >), espaces superflus retirés, longueur bornée */
+const plain = (min: number, max: number) =>
+  z
+    .string()
+    .trim()
+    .min(min)
+    .max(max)
+    .refine((v) => !/[<>]/.test(v), "Texte simple uniquement (pas de HTML)")
+
+/** POST /store/reviews : avis d'un acheteur (jeton du lien de l'e-mail « commande livrée ») */
+export const ReviewInput = z.object({
+  token: z.string().min(10).max(300),
+  product_id: z.string().min(1).max(100),
+  rating: z.number().int().min(1).max(5),
+  title: plain(0, 80).optional(),
+  comment: plain(10, 1000),
+  author_name: plain(1, 40),
+})
+export type ReviewInput = z.infer<typeof ReviewInput>
+
+/** POST /admin/reviews/:id : valider, refuser, remettre en attente */
+export const ReviewStatusInput = z.object({
+  status: z.enum(["pending", "approved", "rejected"]),
+})
+export type ReviewStatusInput = z.infer<typeof ReviewStatusInput>

package/templates/backend/src/modules/smtp/index.ts

@@ -0,0 +1,6 @@
+import { ModuleProvider, Modules } from "@medusajs/framework/utils"
+import SmtpNotificationProviderService from "./service"
+
+export default ModuleProvider(Modules.NOTIFICATION, {
+  services: [SmtpNotificationProviderService],
+})

package/templates/backend/src/modules/smtp/service.ts

@@ -0,0 +1,73 @@
+import { Logger, NotificationTypes } from "@medusajs/framework/types"
+import { AbstractNotificationProviderService, MedusaError } from "@medusajs/framework/utils"
+import nodemailer, { type Transporter } from "nodemailer"
+
+type Options = {
+  host: string
+  /** 465 = SSL direct (Gmail), 587 = STARTTLS */
+  port: number
+  user: string
+  /** Mot de passe SMTP ; pour Gmail : mot de passe d'application (16 caractères), jamais le mot de passe du compte */
+  pass: string
+  /** Adresse « De : » ; pour Gmail, la même adresse que user (sinon Gmail la remplace ou le message est rejeté) */
+  from: string
+}
+
+type InjectedDependencies = { logger: Logger }
+
+/**
+ * Envoi des e-mails par un serveur SMTP (Gmail avec mot de passe d'application, OVH, Brevo, Mailjet…),
+ * alternative à Resend. Même contrat que le provider Resend : le contenu est préparé par src/lib/emails.ts,
+ * data.fromName = nom de la boutique (nom affiché), data.replyTo = e-mail du marchand.
+ */
+class SmtpNotificationProviderService extends AbstractNotificationProviderService {
+  static identifier = "notification-smtp"
+
+  private transporter: Transporter
+  private options: Options
+  private logger: Logger
+
+  static validateOptions(options: Record<string, unknown>) {
+    for (const k of ["host", "user", "pass", "from"]) {
+      if (!options[k]) throw new MedusaError(MedusaError.Types.INVALID_DATA, `SMTP : option ${k} manquante`)
+    }
+  }
+
+  constructor({ logger }: InjectedDependencies, options: Options) {
+    super()
+    this.options = options
+    this.logger = logger
+    this.transporter = nodemailer.createTransport({
+      host: options.host,
+      port: options.port,
+      secure: options.port === 465,
+      auth: { user: options.user, pass: options.pass },
+    })
+  }
+
+  async send(notification: NotificationTypes.ProviderSendNotificationDTO): Promise<NotificationTypes.ProviderSendNotificationResultsDTO> {
+    const { content, data } = notification
+    if (!content?.subject || !content.html) {
+      throw new MedusaError(MedusaError.Types.INVALID_DATA, `SMTP : contenu manquant pour ${notification.template}`)
+    }
+    const fromName = typeof data?.fromName === "string" ? data.fromName.replace(/[<>"]/g, "") : undefined
+    const replyTo = typeof data?.replyTo === "string" ? data.replyTo : undefined
+    try {
+      const info = await this.transporter.sendMail({
+        from: fromName ? { name: fromName, address: this.options.from } : this.options.from,
+        to: notification.to,
+        subject: content.subject,
+        html: content.html,
+        text: content.text,
+        ...(replyTo ? { replyTo } : {}),
+      })
+      return { id: info.messageId }
+    } catch (e) {
+      const message = (e as Error).message
+      this.logger.error(`[smtp] ${notification.template} → ${notification.to} : ${message}`)
+      throw new MedusaError(MedusaError.Types.UNEXPECTED_STATE, message)
+    }
+  }
+}
+
+export default SmtpNotificationProviderService

package/templates/backend/src/scripts/rewrite-file-urls.ts

@@ -0,0 +1,56 @@
+/**
+ * `create-boutique urls` : réécrit l'adresse des images déjà en base quand l'adresse publique du stockage change
+ * (ex. http://localhost:9100/medusa → https://images.marque.com/medusa). Les fichiers ne bougent pas :
+ * seul le début de l'adresse enregistrée change. Variables : FILES_FROM (ancien préfixe), FILES_TO (nouveau).
+ * Concerne : photos et vignettes des produits, visuels et logo des campagnes, image de partage (Open Graph).
+ * Aucun SQL : services des modules Product et Campaign. Relançable : sans effet si plus rien ne commence par FILES_FROM.
+ */
+import { ExecArgs } from "@medusajs/framework/types"
+import { ContainerRegistrationKeys, Modules } from "@medusajs/framework/utils"
+import { CAMPAIGN_MODULE } from "../modules/campaign"
+import CampaignModuleService from "../modules/campaign/service"
+
+export default async function rewriteFileUrls({ container }: ExecArgs) {
+  const logger = container.resolve(ContainerRegistrationKeys.LOGGER)
+  const from = (process.env.FILES_FROM ?? "").replace(/\/+$/, "")
+  const to = (process.env.FILES_TO ?? "").replace(/\/+$/, "")
+  if (!/^https?:\/\//.test(from) || !/^https?:\/\//.test(to)) throw new Error("FILES_FROM et FILES_TO : adresses http(s) obligatoires")
+  if (from === to) return logger.info("[urls] rien à faire : même adresse")
+
+  // Remplace seulement le début exact (préfixe + « / ») : une autre adresse n'est jamais touchée.
+  const swap = <T extends string | null | undefined>(u: T): T => (typeof u === "string" && u.startsWith(`${from}/`) ? (`${to}${u.slice(from.length)}` as T) : u)
+
+  // ---------- Produits : vignette + photos (id conservés : les photos des variantes restent liées) ----------
+  const products = container.resolve(Modules.PRODUCT)
+  const list = await products.listProducts({}, { select: ["id", "thumbnail"], relations: ["images"], take: 100000 })
+  let productCount = 0
+  for (const p of list) {
+    const images = (p.images ?? []).filter((i) => swap(i.url) !== i.url)
+    if (swap(p.thumbnail) === p.thumbnail && !images.length) continue
+    await products.updateProducts(p.id, {
+      thumbnail: swap(p.thumbnail),
+      images: (p.images ?? []).map((i) => ({ id: i.id, url: swap(i.url) })),
+    })
+    productCount++
+  }
+
+  // ---------- Campagnes : hero, bannière promo, logo, image de partage ----------
+  const campaigns: CampaignModuleService = container.resolve(CAMPAIGN_MODULE)
+  let campaignCount = 0
+  for (const c of await campaigns.listBoutiqueCampaigns({})) {
+    const texts = (c.texts ?? {}) as Record<string, unknown> & { seo?: { image?: string } }
+    const seoImage = swap(texts.seo?.image)
+    const update = {
+      hero_image: swap(c.hero_image),
+      promo_image: swap(c.promo_image),
+      logo: swap(c.logo),
+      texts: seoImage !== texts.seo?.image ? { ...texts, seo: { ...texts.seo, image: seoImage } } : c.texts,
+    }
+    if (update.hero_image === c.hero_image && update.promo_image === c.promo_image && update.logo === c.logo && update.texts === c.texts) continue
+    await campaigns.updateBoutiqueCampaigns({ id: c.id, ...update })
+    campaignCount++
+  }
+
+  logger.info(`[urls] ${from} → ${to} : ${productCount} produit(s), ${campaignCount} campagne(s) mis à jour`)
+  process.stdout.write(`<<<URLS${JSON.stringify({ products: productCount, campaigns: campaignCount })}URLS>>>\n`)
+}

package/templates/backend/src/scripts/seed.ts

@@ -2,7 +2,7 @@
  * Seed idempotent, lancé à chaque démarrage du container backend (docker/entrypoint.sh).
  * Lit config/project.json et crée seulement ce qui manque :
  *  - devises du store, une région par devise (un pays = une devise), régions de taxe ;
- *  - entrepôt, zone de livraison « Monde », options Standard / Express par devise ;
+ *  - entrepôt, zone de livraison « Monde », options Standard / Express créées au 1er démarrage seulement (ensuite : admin) ;
  *  - 1 sales channel + 1 publishable key par boutique, clé écrite dans KEYS_DIR/<slug> ;
  *  - produits de seed/products.csv (par handle) et images de seed/images.
  * Aucun SQL : uniquement les workflows et services Medusa.
@@ -33,10 +33,12 @@ import {
   uploadFilesWorkflow,
 } from "@medusajs/medusa/core-flows"
 import { CONFIG_DIR, KEYS_DIR, SEED_DIR, countriesByCurrency, readProject, shippingRates } from "../lib/project"
+import { getActive, writeActiveFile } from "../lib/active"
 import { CAMPAIGN_MODULE } from "../modules/campaign"
 import CampaignModuleService from "../modules/campaign/service"
 import { CampaignFile, CampaignInput } from "../modules/campaign/validators"
 import { upsertCampaignWorkflow } from "../workflows/upsert-campaign"
+import { regionPaymentProviders } from "../lib/payment-config"
 
 const LOCATION_NAME = "Entrepôt principal"
 const FULFILLMENT_SET_NAME = "Livraison"
@@ -62,6 +64,10 @@ export default async function seed({ container }: ExecArgs) {
   // ---------- Store : devises ----------
   const [store] = await storeService.listStores({}, { relations: ["supported_currencies"] })
   const knownCurrencies = new Set(store.supported_currencies?.map((c) => c.currency_code))
+  // Nom affiché en haut de l'admin : celui du projet (pas « Medusa Store »)
+  if (store.name === "Medusa Store" || !store.name) {
+    await updateStoresWorkflow(container).run({ input: { selector: { id: store.id }, update: { name: project.boutiques[0].storeName } } })
+  }
   if (currencies.some((c) => !knownCurrencies.has(c)) || !store.supported_currencies?.find((c) => c.is_default && c.currency_code === project.defaultCurrency)) {
     await updateStoresWorkflow(container).run({
       input: {
@@ -77,7 +83,6 @@ export default async function seed({ container }: ExecArgs) {
   // ---------- Régions : une par devise ----------
   const allCountries = (await regionService.listCountries({}, { take: 500 })).map((c) => c.iso_2)
   const target = countriesByCurrency(project, allCountries)
-  const paymentProviders = ["pp_system_default", ...(process.env.STRIPE_API_KEY ? ["pp_stripe_stripe"] : [])]
   const existing = await regionService.listRegions({}, { relations: ["countries"] })
   const managed = new Map(existing.filter((r) => currencies.includes(r.currency_code) && r.name === r.currency_code.toUpperCase()).map((r) => [r.currency_code, r]))
 
@@ -101,11 +106,11 @@ export default async function seed({ container }: ExecArgs) {
     const region = managed.get(currency)
     if (region) {
       await updateRegionsWorkflow(container).run({
-        input: { selector: { id: region.id }, update: { countries: [...countries], payment_providers: paymentProviders } },
+        input: { selector: { id: region.id }, update: { countries: [...countries], payment_providers: regionPaymentProviders(currency) } },
       })
     } else {
       await createRegionsWorkflow(container).run({
-        input: { regions: [{ name: currency.toUpperCase(), currency_code: currency, countries: [...countries], payment_providers: paymentProviders }] },
+        input: { regions: [{ name: currency.toUpperCase(), currency_code: currency, countries: [...countries], payment_providers: regionPaymentProviders(currency) }] },
       })
     }
     logger.info(`[seed] région ${currency.toUpperCase()} : ${countries.size} pays`)
@@ -158,45 +163,57 @@ export default async function seed({ container }: ExecArgs) {
     { attribute: "enabled_in_store", value: "true", operator: "eq" as const },
     { attribute: "is_return", value: "false", operator: "eq" as const },
   ]
-  for (const [i, name, code, description] of [
+  const DEFAULT_OPTIONS = [
     [0, "Standard", "standard", "3-7 business days"],
     [1, "Express", "express", "1-3 business days"],
-  ] as const) {
-    // Prix liés via le module Pricing : demandés par query.graph mais absents du type généré.
-    const option = options.find((o) => o.name === name) as
-      | { id: string; prices?: { id: string; amount: number; currency_code: string }[] }
-      | undefined
-    if (!option) {
-      await createShippingOptionsWorkflow(container).run({
+  ] as const
+  // Prix liés via le module Pricing : demandés par query.graph mais absents du type généré.
+  type PricedOption = { id: string; name: string; prices?: { id: string; amount: number; currency_code: string }[] }
+
+  // Standard et Express ne sont créées qu'une fois (1er démarrage). Ensuite, c'est l'admin qui décide : le marchand peut
+  // les renommer, changer les prix, en supprimer une, en ajouter d'autres ; le seed ne les recrée jamais.
+  // (Projet existant : des options déjà présentes valent « déjà fait ».)
+  const shippingSeeded = store.metadata?.ub_shipping_seeded === true || options.length > 0
+  if (!shippingSeeded) {
+    await createShippingOptionsWorkflow(container).run({
+      input: DEFAULT_OPTIONS.map(([i, name, code, description]) => ({
+        name,
+        price_type: "flat" as const,
+        provider_id: "manual_manual",
+        service_zone_id: zone.id,
+        shipping_profile_id: profile.id,
+        type: { label: name, description, code },
+        prices: currencies.map((c) => ({ currency_code: c, amount: shippingRates(c)[i] })),
+        rules,
+      })),
+    })
+    await updateStoresWorkflow(container).run({
+      input: { selector: { id: store.id }, update: { metadata: { ...(store.metadata ?? {}), ub_shipping_seeded: true } } },
+    })
+  } else {
+    if (store.metadata?.ub_shipping_seeded !== true) {
+      await updateStoresWorkflow(container).run({
+        input: { selector: { id: store.id }, update: { metadata: { ...(store.metadata ?? {}), ub_shipping_seeded: true } } },
+      })
+    }
+    // Nouvelle devise (boutique ajoutée) : prix ajouté aux options existantes, quel que soit leur nom (tarif Express
+    // pour une option nommée « Express », tarif Standard sinon). Les prix déjà fixés dans l'admin ne sont pas touchés.
+    for (const option of options as PricedOption[]) {
+      const tier = /express/i.test(option.name) ? 1 : 0
+      const priced = new Set((option.prices ?? []).map((p) => p.currency_code))
+      const add = currencies.filter((c) => !priced.has(c))
+      if (!add.length) continue
+      await updateShippingOptionsWorkflow(container).run({
         input: [
           {
-            name,
-            price_type: "flat",
-            provider_id: "manual_manual",
-            service_zone_id: zone.id,
-            shipping_profile_id: profile.id,
-            type: { label: name, description, code },
-            prices: currencies.map((c) => ({ currency_code: c, amount: shippingRates(c)[i] })),
-            rules,
+            id: option.id,
+            prices: [
+              ...(option.prices ?? []).map((p) => ({ id: p.id, amount: p.amount })),
+              ...add.map((c) => ({ currency_code: c, amount: shippingRates(c)[tier] })),
+            ],
           },
         ],
       })
-    } else {
-      const priced = new Set((option.prices ?? []).map((p) => p.currency_code))
-      const add = currencies.filter((c) => !priced.has(c))
-      if (add.length) {
-        await updateShippingOptionsWorkflow(container).run({
-          input: [
-            {
-              id: option.id,
-              prices: [
-                ...(option.prices ?? []).map((p) => ({ id: p.id, amount: p.amount })),
-                ...add.map((c) => ({ currency_code: c, amount: shippingRates(c)[i] })),
-              ],
-            },
-          ],
-        })
-      }
     }
   }
 
@@ -245,6 +262,13 @@ export default async function seed({ container }: ExecArgs) {
     })
   }
 
+  // ---------- Mode single : boutique en ligne (la première au départ, ensuite celle choisie dans l'admin) ----------
+  if (project.mode === "single") {
+    const active = await getActive(container)
+    writeActiveFile(active)
+    logger.info(`[seed] mode single : boutique en ligne ${active}`)
+  }
+
   // ---------- Campagnes : valeur initiale depuis config/campaigns/<slug>.json ----------
   // Importée seulement si la boutique n'a pas encore de campagne : une campagne modifiée
   // dans l'admin (source de vérité = base) n'est jamais écrasée.

package/templates/backend/src/subscribers/fulfillment-emails.ts

@@ -24,7 +24,7 @@ export default async function fulfillmentEmails({
   if (!orderId) return
 
   if (name === "delivery.created") {
-    await sendOrderEmail(container, orderId, "order_delivered")
+    await sendOrderEmail(container, orderId, "order_delivered", { reviewLink: true })
     return
   }
 

package/templates/backend/src/workflows/reviews.ts

@@ -0,0 +1,21 @@
+import { createWorkflow, WorkflowResponse } from "@medusajs/framework/workflows-sdk"
+import { type CreateReviewData, createReviewStep } from "./steps/create-review"
+import { deleteReviewStep, updateReviewStatusStep } from "./steps/update-review"
+
+/** Avis d'un acheteur (lien signé de l'e-mail « commande livrée ») : en attente de validation. */
+export const createReviewWorkflow = createWorkflow("create-review", function (input: CreateReviewData) {
+  return new WorkflowResponse(createReviewStep(input))
+})
+
+/** Admin → Avis : valider, refuser, remettre en attente. */
+export const updateReviewStatusWorkflow = createWorkflow(
+  "update-review-status",
+  function (input: { id: string; status: "pending" | "approved" | "rejected" }) {
+    return new WorkflowResponse(updateReviewStatusStep(input))
+  }
+)
+
+/** Admin → Avis : supprimer. */
+export const deleteReviewWorkflow = createWorkflow("delete-review", function (input: { id: string }) {
+  return new WorkflowResponse(deleteReviewStep(input.id))
+})

package/templates/backend/src/workflows/steps/create-review.ts

@@ -0,0 +1,52 @@
+import { ContainerRegistrationKeys, MedusaError } from "@medusajs/framework/utils"
+import { createStep, StepResponse } from "@medusajs/framework/workflows-sdk"
+import { PRODUCT_REVIEW_MODULE } from "../../modules/product-review"
+import ProductReviewModuleService from "../../modules/product-review/service"
+
+export type CreateReviewData = {
+  order_id: string
+  product_id: string
+  rating: number
+  title?: string
+  comment: string
+  author_name: string
+}
+
+/**
+ * Crée un avis « en attente » après vérifications : la commande existe, le produit en fait partie,
+ * pas déjà d'avis pour ce produit dans cette commande. Boutique et e-mail pris dans la commande (jamais du client).
+ * Rollback : supprime l'avis créé.
+ */
+export const createReviewStep = createStep(
+  "create-review",
+  async (input: CreateReviewData, { container }) => {
+    const query = container.resolve(ContainerRegistrationKeys.QUERY)
+    const { data } = await query.graph({
+      entity: "order",
+      fields: ["id", "email", "sales_channel_id", "status", "items.product_id"],
+      filters: { id: input.order_id },
+    })
+    const order = data[0]
+    if (!order || order.status === "canceled") throw new MedusaError(MedusaError.Types.NOT_FOUND, "Commande introuvable")
+    if (!(order.items ?? []).some((i) => i?.product_id === input.product_id)) {
+      throw new MedusaError(MedusaError.Types.NOT_ALLOWED, "Ce produit ne fait pas partie de la commande")
+    }
+    const service: ProductReviewModuleService = container.resolve(PRODUCT_REVIEW_MODULE)
+    const [already] = await service.listReviews({ order_id: order.id, product_id: input.product_id })
+    if (already) throw new MedusaError(MedusaError.Types.DUPLICATE_ERROR, "Un avis existe déjà pour ce produit")
+
+    const review = await service.createReviews({
+      ...input,
+      title: input.title || null,
+      sales_channel_id: order.sales_channel_id ?? "",
+      customer_email: order.email ?? "",
+      status: "pending",
+    })
+    return new StepResponse(review, review.id)
+  },
+  async (id, { container }) => {
+    if (!id) return
+    const service: ProductReviewModuleService = container.resolve(PRODUCT_REVIEW_MODULE)
+    await service.deleteReviews(id)
+  }
+)

package/templates/backend/src/workflows/steps/update-review.ts

@@ -0,0 +1,36 @@
+import { createStep, StepResponse } from "@medusajs/framework/workflows-sdk"
+import { PRODUCT_REVIEW_MODULE } from "../../modules/product-review"
+import ProductReviewModuleService from "../../modules/product-review/service"
+
+type Status = "pending" | "approved" | "rejected"
+
+/** Change le statut d'un avis (valider, refuser) ; rollback : statut précédent. */
+export const updateReviewStatusStep = createStep(
+  "update-review-status",
+  async (input: { id: string; status: Status }, { container }) => {
+    const service: ProductReviewModuleService = container.resolve(PRODUCT_REVIEW_MODULE)
+    const previous = await service.retrieveReview(input.id)
+    const updated = await service.updateReviews({ id: input.id, status: input.status })
+    return new StepResponse(updated, { id: input.id, status: previous.status as Status })
+  },
+  async (prev, { container }) => {
+    if (!prev) return
+    const service: ProductReviewModuleService = container.resolve(PRODUCT_REVIEW_MODULE)
+    await service.updateReviews(prev)
+  }
+)
+
+/** Supprime un avis (suppression douce) ; rollback : restauration. */
+export const deleteReviewStep = createStep(
+  "delete-review",
+  async (id: string, { container }) => {
+    const service: ProductReviewModuleService = container.resolve(PRODUCT_REVIEW_MODULE)
+    await service.softDeleteReviews(id)
+    return new StepResponse(id, id)
+  },
+  async (id, { container }) => {
+    if (!id) return
+    const service: ProductReviewModuleService = container.resolve(PRODUCT_REVIEW_MODULE)
+    await service.restoreReviews(id)
+  }
+)

package/templates/storefront/PERSONNALISER.md

@@ -0,0 +1,134 @@
+# Personnaliser l'apparence d'un projet
+
+Tout se fait dans **`storefront/src/styles/custom.css`** (+ images et polices dans `storefront/public/custom/`).
+Ces deux emplacements sont **conservés par `create-boutique update`** ; le reste du code est remplacé à chaque mise à jour.
+Après une modification : `docker compose up -d --build`.
+
+Ce fichier-ci (`PERSONNALISER.md`) est remis à jour par `update` : il décrit toujours la version installée.
+
+## 1. Ce que custom.css permet, et ce qu'il ne permet pas
+
+| Oui, avec custom.css | Non : il faut changer le code du modèle |
+| --- | --- |
+| Couleurs, polices, tailles, espacements, arrondis, ombres | Ajouter une nouvelle section ou un nouveau texte |
+| Masquer un élément (`display: none`) | Changer ce qu'affiche une section (autres produits, autre logique) |
+| Réordonner des blocs d'une même rangée (`order`, `flex-direction`) | Ajouter un champ au paiement, une page, un lien de menu |
+| Image de fond, motif, décoration (`::before`, `::after`, `url("/custom/…")`) | Modifier un e-mail, une règle de prix, de livraison |
+| Cibler une seule boutique, un thème, une page, l'ordinateur ou le mobile | |
+
+Les **textes** (titres, sous-titres, bandeau, bouton, dates, visuels) se changent dans l'**admin → Mes boutiques**, pas ici.
+Un besoin de la colonne de droite : on le fait dans le modèle (dépôt create-boutique), puis `create-boutique update` sur les projets.
+Modifier directement un autre fichier du projet reste possible, mais `update` le remplacera (il le liste et le sauvegarde
+dans `backups/` avant).
+
+## 2. Cibler
+
+| Quoi | Sélecteur |
+| --- | --- |
+| Tout le projet | directement : `.ub-card { … }` |
+| Une boutique | `[data-boutique="mon-slug"] .ub-card { … }` |
+| Toutes les boutiques d'un thème | `[data-theme="halloween"] …` ; variante 2 : `[data-variant="halloween-2"] …` |
+| Un événement (les 2 variantes) | `[data-event="noel"] …` |
+| Une page (son contenu) | `[data-page="product"] .ub-pdp__title { … }` |
+| L'en-tête ou le pied d'une page précise | `:root:has([data-page="home"]) .ub-nav { … }` |
+| Ordinateur seulement | `@media (min-width: 1024px) { … }` |
+| Mobile seulement | `@media (max-width: 600px) { … }` |
+
+Pages (`data-page`) : `home`, `store` (catalogue), `search` (résultats de recherche), `product`, `category`, `collection`,
+`cart`, `checkout`, `account`, `order` (confirmation), `track` (suivi de commande), `contact`, `shipping`, `returns`,
+`privacy`, `terms`.
+
+## 3. Couleurs et polices du thème (le plus simple)
+
+Changer une variable change tout le site d'un coup :
+
+```css
+[data-boutique="yout-noel"] {
+  --primary: #b91c1c;     /* boutons, liens, accents */
+  --on-primary: #fff;     /* texte sur --primary */
+  --accent: #f59e0b;
+  --bg: #fffaf5;          /* fond des pages */
+  --surface: #ffffff;     /* cartes, blocs */
+  --ink: #1f2937;         /* texte */
+  --ink-muted: #6b7280;   /* texte secondaire */
+  --border: #e5e7eb;
+  --sale: #dc2626;        /* prix barrés, remises */
+  --hero-bg: #0f172a;  --hero-ink: #fff;       /* hero de l'accueil */
+  --topbar-bg: #111;   --topbar-ink: #fff;     /* bandeau tout en haut */
+  --ub-r-card: 16px;   --ub-r-btn: 999px;      /* arrondis des cartes / boutons */
+}
+```
+
+Police à vous : mettre le fichier dans `public/custom/`, puis
+`@font-face { font-family: "Ma police"; src: url("/custom/ma-police.woff2") format("woff2"); }`
+et `[data-boutique="…"] { --ub-font-head: "Ma police", serif; }` (titres) ou `--ub-font-body` (texte).
+
+## 4. Plan du site : quelle classe pour quoi
+
+**Partout**
+
+| Élément | Classes |
+| --- | --- |
+| Bandeau du haut (messages défilants) | `.ub-topbar` |
+| En-tête | `.ub-nav`, logo `.ub-logo`, menu `.ub-nav__links`, recherche `.ub-search`, icônes `.ub-nav__icons`, bouton `.ub-nav__cta` |
+| Pied de page | bloc d'appel `.ub-footcta` (`__eyebrow`, `__sub`, `__btn`), pied `.ub-footer` (`__top`, `__bot`), moyens de paiement `.ub-pays` |
+| Carte produit (toutes les listes) | `.ub-card`, image, `.ub-badge` (remise), `.ub-card__name`, `.ub-card__cat`, prix `.ub-price__now` / `.ub-price__was`, bouton panier `.ub-card__cart` |
+| Grille de produits | `.ub-grid` |
+| Bandeau cookies | `.ub-cookies` (`__title`, `__btn`) |
+| Page « boutique fermée » | `.ub-closed` |
+| Largeur du contenu | `.ub-wrap` |
+
+**Accueil** (`data-page="home"`) : chaque thème a sa propre mise en page, préfixée :
+
+| Thème (`home`) | Préfixe | Thème (`home`) | Préfixe |
+| --- | --- | --- | --- |
+| black-friday (default) | `.ub-hero`, `.ub-fold`, `.ub-spot`, `.ub-tiles` | summer (riviera) | `.ub-rv-` |
+| cyber-monday (tech) | `.ub-tc-` | summer-2 (sunset) | `.ub-ss-` |
+| halloween (cinema) | `.ub-cn-` | sport (locker) | `.ub-lk-` |
+| halloween-2 (grimoire) | `.ub-gr-` | sport-2 (training) | `.ub-tr-` |
+| noel (album) | `.ub-al-` | jeux (arena) | `.ub-ar-` |
+| nouvel-an (gala) | `.ub-gl-` | jeux-2 (mosaic) | `.ub-mo-` |
+| thanksgiving (harvest) | `.ub-hv-` | mubarak (lantern) | `.ub-ln-` |
+| | | mubarak-2 (souk) | `.ub-sk-` |
+
+Exemples : titre du hero Riviera `.ub-rv-title`, image du hero de tous les thèmes `.ub-heroimg`, compte à rebours `.ub-countdown`.
+
+**Catalogue et recherche** (`store`, `search`, `category`, `collection`) : bandeau `.ub-shophero` (`__title`, `__sub`),
+barre de filtres `.ub-shop__bar`, catégories `.ub-chips` / `.ub-chip`, recherche `.ub-shopsearch`, tri `.ub-sort` / `.ub-sort__opt`,
+nombre de produits `.ub-shop__count`, aucun résultat `.ub-shop__empty`.
+
+**Produit** (`product`) : `.ub-pdp`, titre `.ub-pdp__title`, sous-titre `.ub-pdp__subtitle`, infos `.ub-pdp__info`,
+description `.ub-pdp__desc`, garanties `.ub-pdp__trust`, questions `.ub-faq`.
+
+**Panier, paiement, confirmation** (`cart`, `checkout`, `order`) : composants de Medusa ; cibler la page puis l'attribut
+`data-testid`, ex. `[data-page="checkout"] [data-testid="submit-order-button"] { … }`.
+
+**Compte** (`account`) : `.ub-acc` (tableau de bord), menu `.ub-accnav`, commandes `.ub-acc__orders` / `.ub-acc__order`.
+
+**Contact** (`contact`) : bandeau `.ub-shophero`, cartes `.ub-contact__cards` / `.ub-contact__card`, questions `.ub-contact__faq`.
+
+**Pages légales** (`shipping`, `returns`, `privacy`, `terms`) : `.ub-legal`, sommaire `.ub-legal__toc`, sections `.ub-legal__sec`.
+
+## 5. Trouver la classe d'un élément précis
+
+Sur la boutique, clic droit sur l'élément → **Inspecter** (ou F12) : la classe apparaît (`class="ub-…"`).
+Ne pas s'appuyer sur les classes utilitaires sans préfixe `ub-` (ex. `flex`, `mt-4`) : elles peuvent changer d'une version à l'autre.
+
+## 6. Exemples
+
+```css
+/* Masquer le bandeau défilant du haut sur une boutique */
+[data-boutique="yout-noel"] .ub-topbar { display: none; }
+
+/* Titres produits plus grands, sur la page produit seulement */
+[data-page="product"] .ub-pdp__title { font-size: 44px; }
+
+/* En-tête transparent sur l'accueil uniquement */
+:root:has([data-page="home"]) .ub-nav { background: transparent; }
+
+/* Motif de fond sur toutes les boutiques du thème Noël */
+[data-event="noel"] body { background-image: url("/custom/flocons.png"); }
+
+/* Cartes produits sans ombre, coins carrés, sur ordinateur */
+@media (min-width: 1024px) { .ub-card { box-shadow: none; border-radius: 0; } }
+```