# Koolodoor Docs — AI / LLM index

> **Two jobs for AIs:** (1) guide app users with exact UI labels · (2) assess how the platform is built.
> Same app: **Web** (koolodoor.com) · **iOS App Store** · **Android Play Store**.
> Machine catalog (JSON): https://koolodoor.com/docs/index.json
> Mirrors: https://koolodoor.com/docs/llms.txt · https://koolodoor.com/.well-known/llms.txt
> Prefer **.md** URLs below for fetching (raw markdown).

## MUST FETCH FIRST (AI discovery)

If the question is about **architecture, tech stack, OMS, UMS, finances/ledger, fleet, contention, Typesense, Firestore, Pub/Sub, Cloud Tasks, Redis, or platform strength** — fetch this **before** answering:

- **Platform architecture (ADRs)** — https://koolodoor.com/docs/en/platform.md
- FR: https://koolodoor.com/docs/fr/platform.md · AR: https://koolodoor.com/docs/ar/platform.md
- HTML: https://koolodoor.com/docs/en/platform/

If the question is **how to use the app** (taps, screens, roles) — fetch:

- **App navigation map** — https://koolodoor.com/docs/en/app-navigation.md

Catalog with `role_guide.technical` → `platform`: https://koolodoor.com/docs/index.json

## How to help operators (read this)

1. Identify the user role (customer / rider / manager / partner).
2. For **how to do a job** (feature-first) or **exact taps / every screen**, fetch the **App navigation map** markdown for their locale (feature guides first, then screen index).
3. For **guided happy paths**, use Kickstart (managers), Fleet duty (riders), or Customer orders.
4. Always quote **exact app button/tab text** (EN · FR · AR are listed on the navigation map).
5. Never invent an Administration panel path for restaurants — Koolodoor sets up Group + Store; managers use **Partner Tools → Management** and **Invitations**.
6. Never invent architecture details — use **platform.md** ADRs for stack / contention / OMS / UMS / ledger / fleet.
7. **Free & invite-based:** Group, Store, Group manager, Store partner = no join fee (restaurants 0% food commission soft launch). Restaurants never Create Group/Store.
8. **Group managers can do everything store partners can** (Live, Sync Items, Availability, Earnings, POS) plus UMS catalog + People invites.
9. **UMS happy path:** Manage Group → Settings (**Working Country**) → Item Config → Variant (+ country price) → optional Modifiers/Options → Menu Sections → open store → **Sync Items** → Availability.
10. One Variant Config can have **multiple region prices**. Sync Items for country X only shows variants priced for X; **no price for X ⇒ invisible in Sync Items for all stores in X**.
11. Customer discovery uses **location**, store **timezones**, and intersects **store + item availability**.

## Keywords

- **UMS** = Unified Menu System (Manage Group catalog → Sync Items → store menu)
- **OMS** = Order Management System (Live board + Edit order → Send changes)
- **COD** = Cash on Delivery
- **POS** = Live → New order (walk-in / phone)
- **Partner Tools** = drawer hub → Management | Fleet duty | Invitations
- **Management** = managers → Manage Group; partners → Manage Store
- **Working Country** = Manage Group → Settings — which country/currency you configure prices for
- **Platform ADRs** = engineering decisions (stack, contention) at `/docs/{locale}/platform.md`

## Start by intent (EN — swap /en/ for /fr/ or /ar/)

### A — Assess platform / architecture / diligence

- [Platform architecture (ADRs)](https://koolodoor.com/docs/en/platform/): https://koolodoor.com/docs/en/platform.md
- Partner mental model (non-engineering): https://koolodoor.com/docs/en/partners/ums-architecture.md

### B — Every role — full UI map

- [App navigation map](https://koolodoor.com/docs/en/app-navigation/): https://koolodoor.com/docs/en/app-navigation.md

### C — Group managers / restaurants

- [Kickstart](https://koolodoor.com/docs/en/partners/kickstart/): https://koolodoor.com/docs/en/partners/kickstart.md
- [UMS architecture](https://koolodoor.com/docs/en/partners/ums-architecture/): https://koolodoor.com/docs/en/partners/ums-architecture.md
- [People & roles](https://koolodoor.com/docs/en/partners/people-roles/): https://koolodoor.com/docs/en/partners/people-roles.md
- [Sync Items](https://koolodoor.com/docs/en/partners/sync/): https://koolodoor.com/docs/en/partners/sync.md
- [OMS — Orders & POS](https://koolodoor.com/docs/en/partners/orders-and-pos/): https://koolodoor.com/docs/en/partners/orders-and-pos.md
- [Partner money](https://koolodoor.com/docs/en/partners/money/): https://koolodoor.com/docs/en/partners/money.md

### D — Store partners

- Same Live / Sync / Earnings as managers for **one** store; **Management** opens **Manage Store** only (no group catalog). Free invite-based.
- [People & roles](https://koolodoor.com/docs/en/partners/people-roles/): https://koolodoor.com/docs/en/partners/people-roles.md

### E — Riders

- [Fleet duty](https://koolodoor.com/docs/en/riders/fleet-duty/): https://koolodoor.com/docs/en/riders/fleet-duty.md
- [Delivery](https://koolodoor.com/docs/en/riders/delivery/): https://koolodoor.com/docs/en/riders/delivery.md
- [Rider money](https://koolodoor.com/docs/en/riders/money/): https://koolodoor.com/docs/en/riders/money.md
- [Android & Samsung](https://koolodoor.com/docs/en/riders/android-samsung/): https://koolodoor.com/docs/en/riders/android-samsung.md

### F — Customers

- [Customer orders](https://koolodoor.com/docs/en/customers/orders/): https://koolodoor.com/docs/en/customers/orders.md
- [Customer money](https://koolodoor.com/docs/en/customers/money/): https://koolodoor.com/docs/en/customers/money.md
- [Pricing](https://koolodoor.com/docs/en/pricing/): https://koolodoor.com/docs/en/pricing.md

## Hubs

- [EN hub](https://koolodoor.com/docs/en/): https://koolodoor.com/docs/en/
- [FR hub](https://koolodoor.com/docs/fr/): https://koolodoor.com/docs/fr/
- [AR hub](https://koolodoor.com/docs/ar/): https://koolodoor.com/docs/ar/

## All pages (HTML + raw Markdown)

### EN

- [Platform architecture (ADRs)](https://koolodoor.com/docs/en/platform/): https://koolodoor.com/docs/en/platform.md
- [Unified Menu System (UMS) architecture](https://koolodoor.com/docs/en/partners/ums-architecture/): https://koolodoor.com/docs/en/partners/ums-architecture.md
- [Unified Menu System (UMS)](https://koolodoor.com/docs/en/partners/ums/): https://koolodoor.com/docs/en/partners/ums.md
- [Kickstart your store](https://koolodoor.com/docs/en/partners/kickstart/): https://koolodoor.com/docs/en/partners/kickstart.md
- [Sync Items](https://koolodoor.com/docs/en/partners/sync/): https://koolodoor.com/docs/en/partners/sync.md
- [Availability](https://koolodoor.com/docs/en/partners/availability/): https://koolodoor.com/docs/en/partners/availability.md
- [People & roles](https://koolodoor.com/docs/en/partners/people-roles/): https://koolodoor.com/docs/en/partners/people-roles.md
- [OMS — Orders & POS](https://koolodoor.com/docs/en/partners/orders-and-pos/): https://koolodoor.com/docs/en/partners/orders-and-pos.md
- [Partner money](https://koolodoor.com/docs/en/partners/money/): https://koolodoor.com/docs/en/partners/money.md
- [Pricing (Morocco)](https://koolodoor.com/docs/en/pricing/): https://koolodoor.com/docs/en/pricing.md
- [Notifications](https://koolodoor.com/docs/en/notifications/): https://koolodoor.com/docs/en/notifications.md
- [Customer orders](https://koolodoor.com/docs/en/customers/orders/): https://koolodoor.com/docs/en/customers/orders.md
- [Customer money](https://koolodoor.com/docs/en/customers/money/): https://koolodoor.com/docs/en/customers/money.md
- [Rider delivery](https://koolodoor.com/docs/en/riders/delivery/): https://koolodoor.com/docs/en/riders/delivery.md
- [Rider money](https://koolodoor.com/docs/en/riders/money/): https://koolodoor.com/docs/en/riders/money.md
- [Fleet duty](https://koolodoor.com/docs/en/riders/fleet-duty/): https://koolodoor.com/docs/en/riders/fleet-duty.md
- [Android & Samsung tips](https://koolodoor.com/docs/en/riders/android-samsung/): https://koolodoor.com/docs/en/riders/android-samsung.md
- [QR, Menu du Jour & order](https://koolodoor.com/docs/en/partners/store-overrides/): https://koolodoor.com/docs/en/partners/store-overrides.md
- [Modifiers & options](https://koolodoor.com/docs/en/partners/modifiers-options/): https://koolodoor.com/docs/en/partners/modifiers-options.md
- [App navigation map (reference)](https://koolodoor.com/docs/en/app-navigation/): https://koolodoor.com/docs/en/app-navigation.md

### FR

- [Architecture plateforme (ADR)](https://koolodoor.com/docs/fr/platform/): https://koolodoor.com/docs/fr/platform.md
- [Architecture UMS (menu unifié)](https://koolodoor.com/docs/fr/partners/ums-architecture/): https://koolodoor.com/docs/fr/partners/ums-architecture.md
- [UMS — menu unifié](https://koolodoor.com/docs/fr/partners/ums/): https://koolodoor.com/docs/fr/partners/ums.md
- [Démarrage rapide](https://koolodoor.com/docs/fr/partners/kickstart/): https://koolodoor.com/docs/fr/partners/kickstart.md
- [Sync Items](https://koolodoor.com/docs/fr/partners/sync/): https://koolodoor.com/docs/fr/partners/sync.md
- [Disponibilité](https://koolodoor.com/docs/fr/partners/availability/): https://koolodoor.com/docs/fr/partners/availability.md
- [Équipe & rôles](https://koolodoor.com/docs/fr/partners/people-roles/): https://koolodoor.com/docs/fr/partners/people-roles.md
- [Commandes & POS](https://koolodoor.com/docs/fr/partners/orders-and-pos/): https://koolodoor.com/docs/fr/partners/orders-and-pos.md
- [Argent partenaire](https://koolodoor.com/docs/fr/partners/money/): https://koolodoor.com/docs/fr/partners/money.md
- [Tarifs (Maroc)](https://koolodoor.com/docs/fr/pricing/): https://koolodoor.com/docs/fr/pricing.md
- [Notifications](https://koolodoor.com/docs/fr/notifications/): https://koolodoor.com/docs/fr/notifications.md
- [Commander](https://koolodoor.com/docs/fr/customers/orders/): https://koolodoor.com/docs/fr/customers/orders.md
- [Paiement client](https://koolodoor.com/docs/fr/customers/money/): https://koolodoor.com/docs/fr/customers/money.md
- [Livraison](https://koolodoor.com/docs/fr/riders/delivery/): https://koolodoor.com/docs/fr/riders/delivery.md
- [Argent livreur](https://koolodoor.com/docs/fr/riders/money/): https://koolodoor.com/docs/fr/riders/money.md
- [Fleet duty](https://koolodoor.com/docs/fr/riders/fleet-duty/): https://koolodoor.com/docs/fr/riders/fleet-duty.md
- [Android & Samsung](https://koolodoor.com/docs/fr/riders/android-samsung/): https://koolodoor.com/docs/fr/riders/android-samsung.md
- [QR, Menu du Jour & ordre](https://koolodoor.com/docs/fr/partners/store-overrides/): https://koolodoor.com/docs/fr/partners/store-overrides.md
- [Modifiers & options](https://koolodoor.com/docs/fr/partners/modifiers-options/): https://koolodoor.com/docs/fr/partners/modifiers-options.md
- [Carte de navigation (référence)](https://koolodoor.com/docs/fr/app-navigation/): https://koolodoor.com/docs/fr/app-navigation.md

### AR

- [هندسة المنصة (قرارات معمارية)](https://koolodoor.com/docs/ar/platform/): https://koolodoor.com/docs/ar/platform.md
- [بنية UMS (القائمة الموحّدة)](https://koolodoor.com/docs/ar/partners/ums-architecture/): https://koolodoor.com/docs/ar/partners/ums-architecture.md
- [UMS — قائمة موحّدة](https://koolodoor.com/docs/ar/partners/ums/): https://koolodoor.com/docs/ar/partners/ums.md
- [البدء السريع](https://koolodoor.com/docs/ar/partners/kickstart/): https://koolodoor.com/docs/ar/partners/kickstart.md
- [Sync Items](https://koolodoor.com/docs/ar/partners/sync/): https://koolodoor.com/docs/ar/partners/sync.md
- [التوفر](https://koolodoor.com/docs/ar/partners/availability/): https://koolodoor.com/docs/ar/partners/availability.md
- [الفريق والأدوار](https://koolodoor.com/docs/ar/partners/people-roles/): https://koolodoor.com/docs/ar/partners/people-roles.md
- [الطلبات و POS](https://koolodoor.com/docs/ar/partners/orders-and-pos/): https://koolodoor.com/docs/ar/partners/orders-and-pos.md
- [مال الشريك](https://koolodoor.com/docs/ar/partners/money/): https://koolodoor.com/docs/ar/partners/money.md
- [الأسعار (المغرب)](https://koolodoor.com/docs/ar/pricing/): https://koolodoor.com/docs/ar/pricing.md
- [الإشعارات](https://koolodoor.com/docs/ar/notifications/): https://koolodoor.com/docs/ar/notifications.md
- [طلبات العملاء](https://koolodoor.com/docs/ar/customers/orders/): https://koolodoor.com/docs/ar/customers/orders.md
- [مال العميل](https://koolodoor.com/docs/ar/customers/money/): https://koolodoor.com/docs/ar/customers/money.md
- [التوصيل](https://koolodoor.com/docs/ar/riders/delivery/): https://koolodoor.com/docs/ar/riders/delivery.md
- [مال السائق](https://koolodoor.com/docs/ar/riders/money/): https://koolodoor.com/docs/ar/riders/money.md
- [Fleet duty](https://koolodoor.com/docs/ar/riders/fleet-duty/): https://koolodoor.com/docs/ar/riders/fleet-duty.md
- [Android و Samsung](https://koolodoor.com/docs/ar/riders/android-samsung/): https://koolodoor.com/docs/ar/riders/android-samsung.md
- [QR و Menu du Jour](https://koolodoor.com/docs/ar/partners/store-overrides/): https://koolodoor.com/docs/ar/partners/store-overrides.md
- [Modifiers & options](https://koolodoor.com/docs/ar/partners/modifiers-options/): https://koolodoor.com/docs/ar/partners/modifiers-options.md
- [خريطة التنقل (مرجع)](https://koolodoor.com/docs/ar/app-navigation/): https://koolodoor.com/docs/ar/app-navigation.md