@crvouga/atlas 0.0.0-stage → 0.2.0

package/packages/visualizer/fixtures/full/specs/coffee/ordering/journeys.yaml

@@ -0,0 +1,129 @@
+# Named paths through the composed chart. Hand-off events from Checkout are inserted automatically.
+journeys:
+  Orders a drink and pays by card:
+    description: The everyday order, from the menu to picking the drink up.
+    tour: true
+    events:
+      - Picks a drink
+      - Picks a size
+      - Picks a milk
+      - Adds the drink to the cart
+      - Starts checkout
+      - Picks card
+      - Submits the card
+      - Payment provider approves the payment
+      - Barista starts the drink
+      - Barista finishes the drink
+      - Picks up the drink
+    endsIn:
+      - Order complete
+  Pays with a wallet:
+    description: The wallet confirms the payment instead of a card.
+    events:
+      - Picks a drink
+      - Picks a size
+      - Picks a milk
+      - Adds the drink to the cart
+      - Starts checkout
+      - Picks wallet
+      - Confirms with the wallet
+      - Payment provider approves the payment
+    endsIn:
+      - Paid, waiting for the barista
+      - Updates on
+  Card declined, then a wallet works:
+    description: The card is declined and the wallet goes through.
+    events:
+      - Picks a drink
+      - Picks a size
+      - Picks a milk
+      - Adds the drink to the cart
+      - Starts checkout
+      - Picks card
+      - Submits the card
+      - Payment provider declines the payment
+      - Tries another way to pay
+      - Picks wallet
+      - Confirms with the wallet
+      - Payment provider approves the payment
+    endsIn:
+      - Paid, waiting for the barista
+  Slow payment:
+    description: The payment provider takes more than a minute to answer.
+    events:
+      - Picks a drink
+      - Picks a size
+      - Picks a milk
+      - Adds the drink to the cart
+      - Starts checkout
+      - Picks card
+      - Submits the card
+      - Payment takes longer than a minute
+      - Checks the payment again
+      - Payment provider approves the payment
+    endsIn:
+      - Paid, waiting for the barista
+  Leaves checkout and comes back:
+    description: The customer closes checkout, then starts it again.
+    events:
+      - Picks a drink
+      - Picks a size
+      - Picks a milk
+      - Adds the drink to the cart
+      - Starts checkout
+      - Closes checkout
+      - Starts checkout
+    endsIn:
+      - Checking out
+      - Choosing how to pay
+  Drink left too long:
+    description: Nobody picks the drink up, so it is thrown away and refunded.
+    events:
+      - Picks a drink
+      - Picks a size
+      - Picks a milk
+      - Adds the drink to the cart
+      - Starts checkout
+      - Picks card
+      - Submits the card
+      - Payment provider approves the payment
+      - Barista starts the drink
+      - Barista finishes the drink
+      - Drink sits ready for ten minutes
+      - Orders again
+    endsIn:
+      - Browsing the menu
+  Turns off updates while waiting:
+    description: Updates go off while the drink is in the queue; the drink is still made.
+    events:
+      - Picks a drink
+      - Picks a size
+      - Picks a milk
+      - Adds the drink to the cart
+      - Starts checkout
+      - Picks wallet
+      - Confirms with the wallet
+      - Payment provider approves the payment
+      - Turns off updates
+      - Barista starts the drink
+    endsIn:
+      - Updates off
+      - Drink being made
+  Changes their mind about the drink:
+    description: The customer backs out while choosing the drink.
+    events:
+      - Picks a drink
+      - Picks a size
+      - Goes back to the menu
+    endsIn:
+      - Browsing the menu
+  Empties the cart:
+    description: The only drink is removed from the cart.
+    events:
+      - Picks a drink
+      - Picks a size
+      - Picks a milk
+      - Adds the drink to the cart
+      - Removes the last drink
+    endsIn:
+      - Browsing the menu

package/packages/visualizer/fixtures/full/specs/coffee/ordering/known-issues.md

@@ -0,0 +1,14 @@
+# Known issues
+
+## Drink being made
+
+- The progress bar jumps back once. It settles after a second.
+
+## Drink ready for pickup → Picks up the drink
+
+- The pickup button needs two taps on small screens.
+
+## Other
+
+- `Updates off` shows the wrong icon.
+- Nothing named here.

package/packages/visualizer/fixtures/full/specs/coffee/ordering/machine.yaml

@@ -0,0 +1,158 @@
+# The root chart: XState v5 machine config, as Stately Studio imports and exports it.
+# "Checking out" runs the Checkout chart (checkout.scxml) with a standard invoke.
+id: Coffee order
+initial: Browsing the menu
+meta:
+  description: A customer picks a drink, pays for it, and picks it up when it is ready.
+  timeEvents:
+    Drink sits ready for ten minutes: 10 minutes
+  eventKinds:
+    Barista starts the drink: system
+states:
+  Browsing the menu:
+    meta:
+      description: The menu of drinks, with a cart button.
+      snapshot: menu
+      confidence: confirmed
+      hints:
+        - A list of drinks with prices
+        - A cart button with the number of drinks
+      source:
+        - src/screens/menu.tsx
+    on:
+      Picks a drink:
+        target: '#Customizing the drink'
+  Customizing the drink:
+    initial: Choosing a size
+    meta:
+      description: The customer sets the drink up before adding it to the cart.
+    states:
+      Choosing a size:
+        meta:
+          description: Small, medium and large buttons.
+          snapshot: size
+          confidence: confirmed
+        on:
+          Picks a size:
+            target: '#Choosing the milk'
+      Choosing the milk:
+        meta:
+          description: A list of milks, with "No milk" first.
+          snapshot: milk
+          confidence: confirmed
+        on:
+          Picks a milk:
+            target: '#Ready to add the drink'
+      Ready to add the drink:
+        meta:
+          description: A summary of the drink with an "Add to cart" button.
+          snapshot: drink-summary
+          confidence: confirmed
+          checks:
+            - The summary shows the size and the milk
+        on:
+          Adds the drink to the cart:
+            target: '#Reviewing the cart'
+    on:
+      Goes back to the menu:
+        target: '#Browsing the menu'
+  Reviewing the cart:
+    meta:
+      description: The drinks in the cart, the total, and a checkout button.
+      snapshot: cart
+      confidence: confirmed
+      checks:
+        - The total matches the drinks in the cart
+    on:
+      Removes the last drink:
+        target: '#Browsing the menu'
+      Starts checkout:
+        target: '#Checking out'
+  Checking out:
+    meta:
+      description: Checkout runs as its own chart.
+    invoke:
+      src: Checkout
+      id: checkout
+    on:
+      Payment goes through:
+        target: '#Order in progress'
+      Leaves checkout:
+        target: '#Reviewing the cart'
+  Order in progress:
+    type: parallel
+    meta:
+      description: The drink is made while the customer chooses how to hear about it.
+    states:
+      Drink:
+        initial: Paid, waiting for the barista
+        meta:
+          description: Where the drink is.
+        states:
+          Paid, waiting for the barista:
+            meta:
+              description: A card says the order is paid and in the queue.
+              snapshot: order-queued
+              confidence: confirmed
+              events:
+                - Order paid
+            on:
+              Barista starts the drink:
+                target: '#Drink being made'
+          Drink being made:
+            meta:
+              description: A progress bar while the barista makes the drink.
+              snapshot: order-making
+              confidence: assumed
+            on:
+              Barista finishes the drink:
+                target: '#Drink ready for pickup'
+          Drink ready for pickup:
+            meta:
+              description: A card says the drink is ready, with the pickup counter.
+              snapshot: order-ready
+              confidence: confirmed
+              events:
+                - Customer notified
+            on:
+              Picks up the drink:
+                target: '#Order complete'
+              Drink sits ready for ten minutes:
+                target: '#Told the drink was thrown away'
+      Updates:
+        initial: Updates on
+        meta:
+          description: Whether the customer gets a notification at each step.
+        states:
+          Updates on:
+            meta:
+              description: The updates switch is on.
+              snapshot: updates-on
+            on:
+              Turns off updates:
+                target: '#Updates off'
+          Updates off:
+            meta:
+              description: The updates switch is off.
+              snapshot: updates-off
+            on:
+              Turns on updates:
+                target: '#Updates on'
+  Told the drink was thrown away:
+    meta:
+      description: A message says the drink waited too long and was refunded.
+      snapshot: order-expired
+      confidence: assumed
+      events:
+        - Order refunded
+    on:
+      Orders again:
+        target: '#Browsing the menu'
+  Order complete:
+    type: final
+    meta:
+      description: A thank-you screen with the receipt.
+      snapshot: order-complete
+      confidence: confirmed
+      events:
+        - Order completed

package/packages/visualizer/fixtures/full/specs/coffee/ordering/open-questions.md

@@ -0,0 +1,25 @@
+# Open questions
+
+## Paying
+
+1. **Should a declined card be kept for next time?** Nothing stores it today.
+   - S: Told the payment was declined, Choosing how to pay.
+   - T: Waiting for the payment → Payment provider declines the payment.
+2. **How long can an order wait for the barista?** Nobody follows up on a long queue.
+   - S: Paid, waiting for the barista.
+   - T: Paid, waiting for the barista → Barista starts the drink.
+   - Spec today: it waits **forever**.
+
+## Pickup
+
+3. **Refund or remake?** A drink left too long is refunded; a remake might be kinder.
+   - S: Told the drink was thrown away (assumed). T: Drink ready for pickup → Drink sits ready for ten minutes.
+4. **Who can pick the drink up?** Anyone at the counter can today.
+   - T: Picks up the drink.
+
+## Not modeled
+
+5. These are outside this spec today:
+   - tips
+   - **gift cards** and promo codes
+   - ordering for a later time