# Architecture UMS (menu unifié)

**UMS** = Unified Menu System. **OMS** = Order Management System. Menu groupe → **Sync Items** → magasin. Commandes : Maroc pour l'instant.

## Mots-clés

- **UMS — Unified Menu System** — catalogue unique au **Manage Group**.
- **OMS — Order Management System** — tableau **Live** (accepter, réviser, préparer).
- **COD — Cash on Delivery** — paiement cash · **POS** = **New order** sur Live.
- **Sync Items** — pousse le menu groupe vers le magasin (jamais auto).
- Stack technique / contention ? → **[Architecture plateforme (ADR)](/docs/fr/platform/)**.

## Deux couches : Group (UMS) vs Store (merchandising)

Le **Group** = livre de recettes. Chaque **Store** = cuisine qui vend depuis ce livre.

- **Koolodoor** crée ton **Group** + magasin(s), puis envoie **Invite Group Manager**.
- Le manager ne crée pas Group/Store — **Partner Tools → Invitations** → **ACCEPT**, puis **Manage Group**, **Sync Items**, **People**, **Live**.
- **UMS** vit dans **Manage Group** — un catalogue pour toutes les adresses.
- Le **Store** fait le merchandising : horaires, QR, Menu du Jour, ordre des sections, commandes Live.

> **Heads up:** Onboarding resto : on crée Group + Store(s) et on envoie **Invite Group Manager**. Premier geste : **Partner Tools → Invitations** → **ACCEPT**.

## Qu'est-ce qu'un article magasin ?

- Au **Group** : **Item Config** + **Variant Config** (ligne vendable avec prix).
- Au **Store** : un **article magasin** ≈ ce couple après **Sync Items**.
- Les modifs groupe ne partent pas seules → **Manage Store → Sync Items**.

> **Heads up:** Tu as changé le menu groupe ? **Sync Items**.

## Disponibilité (magasin + articles)

- Tu planifies le magasin **et** les articles (suivre horaires magasin, ou fenêtres custom).
- Magasin fermé = rien de commandable.
- Après sync : **Follow Store Hours** par défaut.

## Commandes — OMS (Order Management System)

- **OMS** = système de gestion des commandes — onglet **Live**.
- **Live** = app + **New order** (téléphone / comptoir).
- **Edit order** → **Send changes** → client **Accept changes** ou **Decline & cancel**.
- Par téléphone : le partenaire confirme oralement, puis avance le tableau.

## Devises, fuseaux & marchés

- L'app gère **plusieurs devises** et **fuseaux** (**Working Country**).
- La **commande in-app est limitée au Maroc** pour le soft launch.

## Cash (COD)

- COD uniquement · **0%** commission food.
- Livraison : **10 + 3 MAD/km** (plafond **50**) + **3 MAD** de service · livreur **80%**.

## Équipe & rôles

- Premier manager invité par **Koolodoor** après création Group + magasin(s).
- Managers : **Invite Group Manager** / **Invite Business Partner**.
- Partners = un seul magasin, pas d'invitations.

## Notifications

- **On store duty** · **Leave fleet** pour les livreurs.