From 277de454fa75afa37a77282322156c02841fc4fc Mon Sep 17 00:00:00 2001
From: Andreas von Studnitz <avs@integer-net.de>
Date: Wed, 17 Apr 2024 09:45:43 +0000
Subject: [PATCH] Add suggestions for related modules (Common Events and Admin
 UI)

---
 README.md              |  37 +++++++++++++++++++++++++++++++++++++
 composer.json          |   4 ++++
 docs/admin_ui_form.png | Bin 0 -> 30070 bytes
 3 files changed, 41 insertions(+)
 create mode 100644 docs/admin_ui_form.png

diff --git a/README.md b/README.md
index ff95cad..1e6131a 100644
--- a/README.md
+++ b/README.md
@@ -245,3 +245,40 @@ Search all events with the order increment id starting with `CK` and status succ
 
 To turn off asynchronous event indexing visit Admin > Stores > Settings > Configuration > Advanced > System >
 Async Events and disable `Enable Asynchronous Events Indexing`.
+
+## Related Modules
+
+### Common Events
+
+[Mage-OS Common Asynchronous Events](https://github.com/mage-os/mageos-common-async-events) includes several
+default events for this module:
+
+| Event identifier         | Description                                    |
+|--------------------------|------------------------------------------------|
+| customer.created         | Whenever a customer is created                 |
+| customer.updated         | Whenever a customer is saved, except it's new  |
+| customer.address.created | Whenever a customer address is created                |
+| customer.address.updated | Whenever a customer address is saved, except it's new |
+| sales.order.created      | When a new order is created                    |
+| sales.order.updated      | When the state of an existing order is changed |
+| sales.order.paid         | When an order is fully paid                    |
+| sales.order.shipped      | When an order is fully shipped                 |
+| sales.order.holded       | When an order is set "on hold"                 |
+| sales.order.unholded     | When an order is released from "on hold"       |
+| sales.order.cancelled    | When an order is cancelled                     |
+| sales.shipment.created   | When a new shipment is created                 |
+| sales.invoice.created    | When a new invoice is created                  |
+| sales.invoice.paid       | When an invoice is paid                        |
+| sales.creditmemo.created | When a new creditmemo is created               |
+
+These events work out of the box and can be used within subcribers.
+The module can also be used as a template on how to implement custom events.
+
+### Admin UI
+
+[Mage-OS Asynchronous Events Admin Ui](https://github.com/mage-os/mageos-async-events-admin-ui) provides
+a simple interface to create subscribers for this module in the Magento Admin area instead of via REST API.
+It only supports HTTP subscribers at the moment.
+
+![Admin UI Form](docs/admin_ui_form.png)
+
diff --git a/composer.json b/composer.json
index 70d2e31..6a056b8 100644
--- a/composer.json
+++ b/composer.json
@@ -27,6 +27,10 @@
       "MageOS\\AsyncEvents\\": ""
     }
   },
+  "suggest": {
+    "mage-os/mageos-common-async-events": "Adds default events for the async events module, like sales.order.created, sales.invoice.paid or customer.address.updated",
+    "mage-os/mageos-async-events-admin-ui": "Adds a basic admin UI for the async events module which can be used to create subscribers instead of using the REST API"
+  },
   "scripts": {
     "post-install-cmd": [
       "([ $COMPOSER_DEV_MODE -eq 0 ] || vendor/bin/phpcs --config-set installed_paths ../../magento/magento-coding-standard/)"
diff --git a/docs/admin_ui_form.png b/docs/admin_ui_form.png
new file mode 100644
index 0000000000000000000000000000000000000000..9e30d35afe27e6671665a1ccf14899674584e54b
GIT binary patch
literal 30070
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
SuLTjH-ZMq@C#CW)-~JDvg!h{O

literal 0
HcmV?d00001