@eventcatalog/create-eventcatalog 4.3.3 → 4.3.4

package/templates/default/domains/Orders/services/InventoryService/events/OutOfStock/index.mdx

@@ -1,102 +0,0 @@
----
-id: OutOfStock
-name: Inventory out of stock
-version: 0.0.4
-schemaPath: schema.json
-summary: |
-  Indicates inventory is out of stock
-owners:
-  - dboyne
-  - msmith
-  - asmith
-  - full-stack
-  - mobile-devs
-badges:
-  - content: Recently updated!
-    backgroundColor: green
-    textColor: green
-  - content: 'Channel:Apache Kafka'
-    backgroundColor: yellow
-    textColor: yellow
----
-
-import Footer from '@catalog/components/footer.astro';
-
-## Overview
-
-The `Inventory Adjusted` event is triggered whenever there is a change in the inventory levels of a product. This could occur due to various reasons such as receiving new stock, sales, returns, or manual adjustments by the inventory management team. The event ensures that all parts of the system that rely on inventory data are kept up-to-date with the latest inventory levels.
-
-<NodeGraph />
-
-### Payload
-
-The payload of the `Inventory Adjusted` event includes the following fields:
-
-```json title="Example of payload" frame="terminal"
-{
-  "event_id": "string",
-  "timestamp": "ISO 8601 date-time",
-  "product_id": "string",
-  "adjusted_quantity": "integer",
-  "new_quantity": "integer",
-  "adjustment_reason": "string",
-  "adjusted_by": "string"
-}
-```
-
-### Producing the Event
-
-To produce an Inventory Adjusted event, use the following example Kafka producer configuration in Python:
-
-```python title="Produce event in Python" frame="terminal"
-from kafka import KafkaProducer
-import json
-from datetime import datetime
-
-# Kafka configuration
-producer = KafkaProducer(
-    bootstrap_servers=['localhost:9092'],
-    value_serializer=lambda v: json.dumps(v).encode('utf-8')
-)
-
-# Event data
-event_data = {
-  "event_id": "abc123",
-  "timestamp": datetime.utcnow().isoformat() + 'Z',
-  "product_id": "prod987",
-  "adjusted_quantity": 10,
-  "new_quantity": 150,
-  "adjustment_reason": "restock",
-  "adjusted_by": "user123"
-}
-
-# Send event to Kafka topic
-producer.send('inventory.adjusted', event_data)
-producer.flush()
-```
-
-### Consuming the Event
-
-To consume an Inventory Adjusted event, use the following example Kafka consumer configuration in Python:
-
-```python title="Consuming the event with python" frame="terminal"
-from kafka import KafkaConsumer
-import json
-
-# Kafka configuration
-consumer = KafkaConsumer(
-    'inventory.adjusted',
-    bootstrap_servers=['localhost:9092'],
-    auto_offset_reset='earliest',
-    enable_auto_commit=True,
-    group_id='inventory_group',
-    value_serializer=lambda v: json.dumps(v).encode('utf-8')
-)
-
-# Consume events
-for message in consumer:
-    event_data = json.loads(message.value)
-    print(f"Received Inventory Adjusted event: {event_data}")
-```
-
-<Footer />

package/templates/default/domains/Orders/services/InventoryService/events/OutOfStock/schema.json

@@ -1,28 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "event_id": {
-      "type": "string",
-      "description": "Unique identifier for the event"
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Timestamp when the out-of-stock condition was detected"
-    },
-    "product_id": {
-      "type": "string",
-      "description": "Identifier of the out-of-stock product"
-    },
-    "last_available_quantity": {
-      "type": "integer",
-      "description": "The last known available quantity before stock ran out"
-    },
-    "warehouse_id": {
-      "type": "string",
-      "description": "Identifier of the warehouse reporting the stock-out"
-    }
-  },
-  "required": ["event_id", "timestamp", "product_id"]
-}

package/templates/default/domains/Orders/services/InventoryService/events/OutOfStock/versioned/0.0.1/index.mdx

@@ -1,98 +0,0 @@
----
-id: OutOfStock
-name: Inventory out of stock
-version: 0.0.1
-schemaPath: schema.json
-summary: |
-  Indicates inventory is out of stock
-owners:
-  - dboyne
-  - msmith
-  - asmith
-  - full-stack
-  - mobile-devs
-badges:
-  - content: Recently updated!
-    backgroundColor: green
-    textColor: green
-  - content: Channel:Apache Kafka
-    backgroundColor: yellow
-    textColor: yellow
----
-
-## Overview
-
-The `Inventory Adjusted` event is triggered whenever there is a change in the inventory levels of a product. This could occur due to various reasons such as receiving new stock, sales, returns, or manual adjustments by the inventory management team. The event ensures that all parts of the system that rely on inventory data are kept up-to-date with the latest inventory levels.
-
-<NodeGraph />
-
-### Payload
-
-The payload of the `Inventory Adjusted` event includes the following fields:
-
-```json title="Example of payload" frame="terminal"
-{
-  "event_id": "string",
-  "timestamp": "ISO 8601 date-time",
-  "product_id": "string",
-  "adjusted_quantity": "integer",
-  "new_quantity": "integer",
-  "adjustment_reason": "string",
-  "adjusted_by": "string"
-}
-```
-
-### Producing the Event
-
-To produce an Inventory Adjusted event, use the following example Kafka producer configuration in Python:
-
-```python title="Produce event in Python" frame="terminal"
-from kafka import KafkaProducer
-import json
-from datetime import datetime
-
-# Kafka configuration
-producer = KafkaProducer(
-    bootstrap_servers=['localhost:9092'],
-    value_serializer=lambda v: json.dumps(v).encode('utf-8')
-)
-
-# Event data
-event_data = {
-  "event_id": "abc123",
-  "timestamp": datetime.utcnow().isoformat() + 'Z',
-  "product_id": "prod987",
-  "adjusted_quantity": 10,
-  "new_quantity": 150,
-  "adjustment_reason": "restock",
-  "adjusted_by": "user123"
-}
-
-# Send event to Kafka topic
-producer.send('inventory.adjusted', event_data)
-producer.flush()
-```
-
-### Consuming the Event
-
-To consume an Inventory Adjusted event, use the following example Kafka consumer configuration in Python:
-
-```python title="Consuming the event with python" frame="terminal"
-from kafka import KafkaConsumer
-import json
-
-# Kafka configuration
-consumer = KafkaConsumer(
-    'inventory.adjusted',
-    bootstrap_servers=['localhost:9092'],
-    auto_offset_reset='earliest',
-    enable_auto_commit=True,
-    group_id='inventory_group',
-    value_serializer=lambda v: json.dumps(v).encode('utf-8')
-)
-
-# Consume events
-for message in consumer:
-    event_data = json.loads(message.value)
-    print(f"Received Inventory Adjusted event: {event_data}")
-```

package/templates/default/domains/Orders/services/InventoryService/events/OutOfStock/versioned/0.0.1/schema.json

@@ -1,28 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "event_id": {
-      "type": "string",
-      "description": "Unique identifier for the event"
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Timestamp when the out-of-stock condition was detected"
-    },
-    "product_id": {
-      "type": "string",
-      "description": "Identifier of the out-of-stock product"
-    },
-    "last_available_quantity": {
-      "type": "integer",
-      "description": "The last known available quantity before stock ran out"
-    },
-    "warehouse_id": {
-      "type": "string",
-      "description": "Identifier of the warehouse reporting the stock-out"
-    }
-  },
-  "required": ["event_id", "timestamp", "product_id"]
-}

package/templates/default/domains/Orders/services/InventoryService/index.mdx

@@ -1,120 +0,0 @@
----
-id: InventoryService
-version: 0.0.2
-name: Inventory Service
-summary: |
-  Service that handles the inventory
-owners:
-  - dboyne
-  - full-stack
-  - mobile-devs
-receives:
-  - id: OrderConfirmed
-    version: 0.0.1
-    from:
-      - id: inventory-queue
-  - id: OrderAmended
-    from:
-      - id: inventory-queue
-  - id: UpdateInventory
-    version: 0.0.3
-    from:
-      - id: 'inventory.{env}.events'
-        parameters:
-          env: staging
-  - id: AddInventory
-    from:
-      - id: 'inventory.{env}.events'
-        parameters:
-          env: staging
-  - id: GetInventoryStatus
-  - id: GetInventoryList
-sends:
-  - id: InventoryAdjusted
-    version: 1.0.1
-    to:
-      - id: 'inventory.{env}.events'
-  - id: OutOfStock
-    version: 0.0.4
-    to:
-      - id: 'inventory.{env}.events'
-repository:
-  language: JavaScript
-  url: 'https://github.com/event-catalog/pretend-shipping-service'
----
-
-import Footer from '@catalog/components/footer.astro';
-
-## Overview
-
-The Inventory Service is a critical component of the system responsible for managing product stock levels, tracking inventory movements, and ensuring product availability. It interacts with other services to maintain accurate inventory records and supports operations such as order fulfillment, restocking, and inventory audits.
-
-<Tiles>
-  <Tile
-    icon="DocumentIcon"
-    href={`/docs/services/${frontmatter.id}/${frontmatter.version}/changelog`}
-    title="View the changelog"
-    description="Want to know the history of this service? View the change logs"
-  />
-  <Tile
-    icon="UserGroupIcon"
-    href="/docs/teams/full-stack"
-    title="Contact the team"
-    description="Any questions? Feel free to contact the owners"
-  />
-  <Tile
-    icon="BoltIcon"
-    href={`/visualiser/services/${frontmatter.id}/${frontmatter.version}`}
-    title={`Sends ${frontmatter.sends.length} messages`}
-    description="This service sends messages to downstream consumers"
-  />
-  <Tile
-    icon="BoltIcon"
-    href={`/visualiser/services/${frontmatter.id}/${frontmatter.version}`}
-    title={`Receives ${frontmatter.receives.length} messages`}
-    description="This service receives messages from other services"
-  />
-</Tiles>
-
-## Architecture diagram
-
-<NodeGraph title="Hello world" />
-
-<Steps title="How to connect to Inventory Service">
-  <Step title="Obtain API credentials">
-    Request API credentials from the Inventory Service team.
-  </Step>
-  <Step title="Install the SDK">
-    Run the following command in your project directory:
-    ```bash
-    npm install inventory-service-sdk
-    ```
-  </Step>
-  <Step title="Initialize the client">
-  Use the following code to initialize the Inventory Service client:
-
-```js
-const InventoryService = require('inventory-service-sdk');
-const client = new InventoryService.Client({
-  clientId: 'YOUR_CLIENT_ID',
-  clientSecret: 'YOUR_CLIENT_SECRET',
-  apiUrl: 'https://api.inventoryservice.com/v1',
-});
-```
-
-  </Step>
-  <Step title="Make API calls">
-  
-  You can now use the client to make API calls. For example, to get all products:
-
-```js
-client
-  .getProducts()
-  .then((products) => console.log(products))
-  .catch((error) => console.error(error));
-```
-
-  </Step>
-</Steps>
-
-<Footer />

package/templates/default/domains/Orders/services/InventoryService/queries/GetInventoryList/index.mdx

@@ -1,22 +0,0 @@
----
-id: GetInventoryList
-name: List inventory list
-version: 0.0.1
-summary: |
-  GET request that will return inventory list
-owners:
-  - dboyne
-badges:
-  - content: Recently updated!
-    backgroundColor: green
-    textColor: green
-schemaPath: schema.json
----
-
-import Footer from '@catalog/components/footer.astro';
-
-## Overview
-
-The GetInventoryList message is a query used to retrieve a comprehensive list of all available inventory items within a system. It is designed to return detailed information about each item, such as product names, quantities, availability status, and potentially additional metadata like categories or locations. This query is typically utilized by systems or services that require a real-time view of current stock, ensuring that downstream applications or users have accurate and up-to-date information for decision-making or operational purposes. The GetInventoryList is ideal for use cases such as order processing, stock management, or reporting, providing visibility into the full range of inventory data.
-
-<NodeGraph />

package/templates/default/domains/Orders/services/InventoryService/queries/GetInventoryList/schema.json

@@ -1,52 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "GetInventoryList",
-  "description": "A query to retrieve a list of all available inventory items with their details.",
-  "type": "object",
-  "properties": {
-    "filters": {
-      "type": "object",
-      "description": "Optional filters to narrow down the inventory search.",
-      "properties": {
-        "category": {
-          "type": "string",
-          "description": "Filter items by category (e.g., electronics, clothing, etc.)."
-        },
-        "location": {
-          "type": "string",
-          "description": "Filter items by storage location or warehouse."
-        },
-        "minStockLevel": {
-          "type": "integer",
-          "description": "Filter items with a stock level greater than or equal to this value."
-        },
-        "inStock": {
-          "type": "boolean",
-          "description": "Filter items that are currently in stock (true) or out of stock (false)."
-        }
-      },
-      "additionalProperties": false
-    },
-    "pagination": {
-      "type": "object",
-      "description": "Pagination options for the query.",
-      "properties": {
-        "page": {
-          "type": "integer",
-          "description": "The current page of results.",
-          "minimum": 1,
-          "default": 1
-        },
-        "pageSize": {
-          "type": "integer",
-          "description": "The number of items per page.",
-          "minimum": 1,
-          "default": 10
-        }
-      },
-      "required": ["page", "pageSize"]
-    }
-  },
-  "required": [],
-  "additionalProperties": false
-}

package/templates/default/domains/Orders/services/InventoryService/queries/GetInventoryStatus/index.mdx

@@ -1,40 +0,0 @@
----
-id: GetInventoryStatus
-name: Get inventory status
-version: 0.0.1
-summary: |
-  GET request that will return the current stock status for a specific product.
-owners:
-  - dboyne
-badges:
-  - content: GET Request
-    backgroundColor: green
-    textColor: green
-schemaPath: schema.json
----
-
-import Footer from '@catalog/components/footer.astro';
-
-## Overview
-
-The GetInventoryStatus message is a query designed to retrieve the current stock status for a specific product.
-
-This query provides detailed information about the available quantity, reserved quantity, and the warehouse location where the product is stored. It is typically used by systems or services that need to determine the real-time availability of a product, enabling efficient stock management, order fulfillment, and inventory tracking processes.
-
-This query is essential for ensuring accurate stock levels are reported to downstream systems, including e-commerce platforms, warehouse management systems, and sales channels.
-
-<NodeGraph />
-
-<SchemaViewer file="schema.json" title="JSON Schema" maxHeight="500" />
-
-### Query using CURL
-
-Use this snippet to query the inventory status
-
-```sh title="Example CURL command"
-curl -X GET "https://api.yourdomain.com/inventory/status" \
--H "Content-Type: application/json" \
--d '{
-  "productId": "12345"
-}'
-```

package/templates/default/domains/Orders/services/InventoryService/queries/GetInventoryStatus/schema.json

@@ -1,27 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "GetInventoryStatusResponse",
-  "type": "object",
-  "properties": {
-    "productId": {
-      "type": "string",
-      "description": "The unique identifier for the product"
-    },
-    "availableQuantity": {
-      "type": "integer",
-      "description": "The quantity of the product currently available in stock",
-      "minimum": 0
-    },
-    "reservedQuantity": {
-      "type": "integer",
-      "description": "The quantity of the product that is reserved for pending orders",
-      "minimum": 0
-    },
-    "warehouseLocation": {
-      "type": "string",
-      "description": "The location of the warehouse where the product is stored"
-    }
-  },
-  "required": ["productId", "availableQuantity", "reservedQuantity", "warehouseLocation"],
-  "additionalProperties": false
-}

package/templates/default/domains/Orders/services/InventoryService/versioned/0.0.1/index.mdx

@@ -1,52 +0,0 @@
----
-id: InventoryService
-version: 0.0.1
-name: Inventory Service
-summary: |
-  Service that handles the inventory
-owners:
-  - dboyne
-  - full-stack
-  - mobile-devs
-receives:
-  - id: OrderConfirmed
-    version: 0.0.1
-    from:
-      - id: 'orders.{env}.events'
-  - id: OrderCancelled
-    version: 0.0.1
-    from:
-      - id: 'orders.{env}.events'
-  - id: OrderAmended
-    version: 0.0.1
-    from:
-      - id: 'orders.{env}.events'
-        parameters:
-          env: staging
-  - id: UpdateInventory
-    version: 0.0.3
-    from:
-      - id: 'inventory.{env}.events'
-        parameters:
-          env: staging
-sends:
-  - id: InventoryAdjusted
-    version: 1.0.1
-    to:
-      - id: 'inventory.{env}.events'
-  - id: OutOfStock
-    version: 0.0.4
-    to:
-      - id: 'inventory.{env}.events'
-repository:
-  language: JavaScript
-  url: 'https://github.com/event-catalog/pretend-shipping-service'
----
-
-## Overview
-
-The Inventory Service is a critical component of the system responsible for managing product stock levels, tracking inventory movements, and ensuring product availability. It interacts with other services to maintain accurate inventory records and supports operations such as order fulfillment, restocking, and inventory audits.
-
-## Architecture diagram
-
-<NodeGraph title="Hello world" />

package/templates/default/domains/Orders/services/NotificationService/index.mdx

@@ -1,82 +0,0 @@
----
-id: NotificationService
-version: 0.0.2
-name: Notifications
-summary: |
-  Service that handles orders
-owners:
-  - dboyne
-receives:
-  - id: InventoryAdjusted
-    version: '>1.0.0'
-    from:
-      - id: 'inventory.{env}.events'
-  - id: PaymentProcessed
-    version: ^1.0.0
-    from:
-      - id: 'payments.{env}.events'
-        parameters:
-          env: staging
-  - id: GetNotificationDetails
-  - id: GetUserNotifications
-sends:
-  - id: OutOfStock
-    version: latest
-    to:
-      - id: 'inventory.{env}.events'
-repository:
-  language: JavaScript
-  url: 'https://github.com/event-catalog/pretend-shipping-service'
----
-
-import Footer from '@catalog/components/footer.astro';
-
-## Overview
-
-The Notification Service is responsible for managing and delivering notifications to users and other services. It supports various notification channels such as email, SMS, push notifications, and in-app notifications. The service ensures reliable and timely delivery of messages and integrates with other services to trigger notifications based on specific events.
-
-<Tiles>
-  <Tile
-    icon="DocumentIcon"
-    href={`/docs/services/${frontmatter.id}/${frontmatter.version}/changelog`}
-    title="View the changelog"
-    description="Want to know the history of this service? View the change logs"
-  />
-  <Tile
-    icon="UserGroupIcon"
-    href="/docs/teams/full-stack"
-    title="Contact the team"
-    description="Any questions? Feel free to contact the owners"
-  />
-  <Tile
-    icon="BoltIcon"
-    href={`/visualiser/services/${frontmatter.id}/${frontmatter.version}`}
-    title={`Sends ${frontmatter.sends.length} messages`}
-    description="This service sends messages to downstream consumers"
-  />
-  <Tile
-    icon="BoltIcon"
-    href={`/visualiser/services/${frontmatter.id}/${frontmatter.version}`}
-    title={`Receives ${frontmatter.receives.length} messages`}
-    description="This service receives messages from other services"
-  />
-</Tiles>
-
-## Architecture diagram
-
-<NodeGraph />
-
-## Core Concepts
-
-<AccordionGroup>
-  <Accordion title="Notification">
-    - Description: A message that is sent to a user or a service. - Attributes: notificationId, type, recipient, content, channel,
-    status, timestamp
-  </Accordion>
-  <Accordion title="Channel">
-    - Description: The medium through which the notification is delivered (e.g., email, SMS, push notification). - Attributes:
-    channelId, name, provider, configuration
-  </Accordion>
-</AccordionGroup>
-
-<Footer />

package/templates/default/domains/Orders/services/NotificationService/queries/GetNotificationDetails/index.mdx

@@ -1,26 +0,0 @@
----
-id: GetNotificationDetails
-name: Get notification details
-version: 0.0.1
-summary: |
-  GET request that will return detailed information about a specific notification, identified by its notificationId.
-owners:
-  - dboyne
-badges:
-  - content: Recently updated!
-    backgroundColor: green
-    textColor: green
-schemaPath: schema.json
----
-
-import Footer from '@catalog/components/footer.astro';
-
-## Overview
-
-The `GetNotificationDetails` message is a query used to retrieve detailed information about a specific notification identified by its `notificationId`. It provides a comprehensive overview of the notification, including the title, message content, status (read/unread), the date it was created, and any additional metadata related to the notification, such as associated orders or system events. This query is helpful in scenarios where users or systems need detailed insights into a particular notification, such as retrieving full messages or auditing notifications sent to users.
-
-Use cases include viewing detailed information about order updates, system notifications, or promotional messages, allowing users to view their full notification history and details.
-
-<NodeGraph />
-
-<SchemaViewer file="schema.json" title="JSON Schema" maxHeight="500" />