ApiLogicServer 14.3.14__py3-none-any.whl → 14.3.25__py3-none-any.whl

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/create_db_models.py

@@ -0,0 +1,117 @@
+# using resolved_model self.resolved_model FIXME
+# created from response, to create create_db_models.sqlite, with test data
+#    that is used to create project
+# should run without error in manager 
+#    if not, check for decimal, indent, or import issues
+
+import decimal
+import logging
+import sqlalchemy
+from sqlalchemy.sql import func 
+from decimal import Decimal
+from logic_bank.logic_bank import Rule
+from sqlalchemy import create_engine, Column, Integer, String, Float, ForeignKey, Date, DateTime, Numeric, Boolean, Text, DECIMAL
+from sqlalchemy.types import *
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import sessionmaker
+from sqlalchemy.orm import relationship
+from sqlalchemy.orm import Mapped
+from datetime import date   
+from datetime import datetime
+from typing import List
+
+
+logging.getLogger('sqlalchemy.engine.Engine').disabled = True  # remove for additional logging
+
+Base = declarative_base()  # from system/genai/create_db_models_inserts/create_db_models_prefix.py
+
+
+from sqlalchemy.dialects.sqlite import *
+
+class Customer(Base):
+    """description: Represents a customer entity with unique name, credit limit, and balance."""
+    __tablename__ = 'customer'
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    name = Column(String(255), unique=True)
+    credit_limit = Column(DECIMAL)
+    balance = Column(DECIMAL)
+
+class Order(Base):
+    """description: Represents an order entity linked to a customer with a note field."""
+    __tablename__ = 'order'
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    customer_id = Column(Integer, ForeignKey('customer.id'))
+    date_shipped = Column(DateTime)
+    amount_total = Column(DECIMAL)
+    notes = Column(String(255))
+
+class Item(Base):
+    """description: Represents an item within an order, linked to a product with mandatory quantity."""
+    __tablename__ = 'item'
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    order_id = Column(Integer, ForeignKey('order.id'))
+    product_id = Column(Integer, ForeignKey('product.id'))
+    quantity = Column(Integer, nullable=False)
+    unit_price = Column(DECIMAL)
+    amount = Column(DECIMAL)
+
+class Product(Base):
+    """description: Represents a product entity with unique name and unit price."""
+    __tablename__ = 'product'
+    id = Column(Integer, primary_key=True, autoincrement=True)
+    name = Column(String(255), unique=True)
+    unit_price = Column(DECIMAL)
+
+
+# end of model classes
+
+
+try:
+    
+    
+    # ALS/GenAI: Create an SQLite database
+    import os
+    mgr_db_loc = True
+    if mgr_db_loc:
+        print(f'creating in manager: sqlite:///system/genai/temp/create_db_models.sqlite')
+        engine = create_engine('sqlite:///system/genai/temp/create_db_models.sqlite')
+    else:
+        current_file_path = os.path.dirname(__file__)
+        print(f'creating at current_file_path: {current_file_path}')
+        engine = create_engine(f'sqlite:///{current_file_path}/create_db_models.sqlite')
+    Base.metadata.create_all(engine)
+    
+    
+    Session = sessionmaker(bind=engine)
+    session = Session()
+    
+    # ALS/GenAI: Prepare for sample data
+    
+    
+    session.commit()
+    customer1 = Customer(id=1, name="John Doe", credit_limit=1000, balance=0)
+    customer2 = Customer(id=2, name="Jane Roe", credit_limit=2000, balance=0)
+    customer3 = Customer(id=3, name="Acme Corp", credit_limit=5000, balance=0)
+    customer4 = Customer(id=4, name="Globex Inc", credit_limit=3000, balance=0)
+    product1 = Product(id=1, name="Widget", unit_price=10)
+    product2 = Product(id=2, name="Gadget", unit_price=20)
+    product3 = Product(id=3, name="Doodad", unit_price=15)
+    product4 = Product(id=4, name="Thingamajig", unit_price=25)
+    order1 = Order(id=1, customer_id=1, amount_total=0, notes="First order")
+    order2 = Order(id=2, customer_id=2, amount_total=0, notes="Second order")
+    order3 = Order(id=3, customer_id=3, amount_total=0, notes="Third order")
+    order4 = Order(id=4, customer_id=4, amount_total=0, notes="Fourth order")
+    item1 = Item(id=1, order_id=1, product_id=1, quantity=2, unit_price=10, amount=20)
+    item2 = Item(id=2, order_id=2, product_id=2, quantity=1, unit_price=20, amount=20)
+    item3 = Item(id=3, order_id=3, product_id=3, quantity=3, unit_price=15, amount=45)
+    item4 = Item(id=4, order_id=4, product_id=4, quantity=4, unit_price=25, amount=100)
+    
+    
+    
+    session.add_all([customer1, customer2, customer3, customer4, product1, product2, product3, product4, order1, order2, order3, order4, item1, item2, item3, item4])
+    session.commit()
+    # end of test data
+    
+    
+except Exception as exc:
+    print(f'Test Data Error: {exc}')

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/db.dbml

@@ -0,0 +1,49 @@
+// Copy this text, paste to https://dbdiagram.io/d
+// Or, https://databasediagram.com/app
+// Or, view in VSCode with extension: "DBML Live Preview"
+
+Project DBML {
+  Note: '''
+Customer: Represents a customer entity with unique name, credit limit, and balance.
+Item: Represents an item within an order, linked to a product with mandatory quantity.
+Order: Represents an order entity linked to a customer with a note field.
+Product: Represents a product entity with unique name and unit price.
+'''
+}
+
+Table Customer {
+    id INTEGER [primary key]
+    name VARCHAR(255) 
+    credit_limit DECIMAL 
+    balance DECIMAL 
+    }
+
+Table Item {
+    id INTEGER [primary key]
+    order_id INTEGER 
+    product_id INTEGER 
+    quantity INTEGER 
+    unit_price DECIMAL 
+    amount DECIMAL 
+    }
+
+Table Order {
+    id INTEGER [primary key]
+    customer_id INTEGER 
+    date_shipped DATETIME 
+    amount_total DECIMAL 
+    notes VARCHAR(255) 
+    }
+
+Table Product {
+    id INTEGER [primary key]
+    name VARCHAR(255) 
+    unit_price DECIMAL 
+    }
+
+
+
+// Relationships
+    Ref: Item.(order_id) < Order.(id)
+    Ref: Item.(product_id) < Product.(id)
+    Ref: Order.(customer_id) < Customer.(id)

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/logic/check_credit.prompt

@@ -0,0 +1,6 @@
+Enforce the Check Credit:
+1. Customer.balance <= credit_limit
+2. Customer.balance = Sum(Order.amount_total where date_shipped is null)
+3. Order.amount_total = Sum(Item.amount)
+4. Item.amount = quantity * unit_price
+5. Store the Item.unit_price as a copy from Product.unit_price

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/logic/constraint_tests.prompt

@@ -0,0 +1,5 @@
+Use case: Simple contraints for testing
+
+Customer names cannot be 'x'.
+Product names cannot be 'xx'.
+Product carbon_neutral must be true if the product name contains 'green'.

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/logic/readme.md

@@ -0,0 +1,19 @@
+### Add Natural Language Logic to Your Project
+
+You can add Natural Language logic files to this directory, e.g. in `genai_demo/docs/logic`: 
+
+* `valid_names.prompt`: Customer and Product Names cannot be 'x'
+* `valid_currency.prompt`: Customer credit limits cannot be negative; Product prices must be positive.
+
+Then, use GenAI to create executable logic in your `logic/logic_discovery` directory, e.g.,
+
+```bash
+als genai-logic
+```
+
+Notes:
+
+1. Ensure derived attributes exist in the data model (see [Database Design Changes](https://apilogicserver.github.io/Docs/Database-Changes/))
+2. Be sure to initialize such attributes in your database
+3. For more information, [click here](https://apilogicserver.github.io/Docs/WebGenAI-CLI/#add-logic-to-existing-projects)
+4. Consider renaming your logic files afterward (`valid_names.z-prompt`)so they are skipped on future runs

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/logic_suggestions/readme_logic_suggestions.md

@@ -0,0 +1,3 @@
+### Ask GenAI for logic suggestions
+
+This is a work directory used by the system to capture [logic suggestions](https://apilogicserver.github.io/Docs/WebGenAI-CLI/#logic-suggestions).

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/pretty_print.py

@@ -0,0 +1,85 @@
+import json
+
+''' quick and dirty printout of json, 
+    to see large json content strings in a more readable format
+'''
+
+def pretty_print_json(data):
+    if isinstance(data, dict):
+        for key, value in data.items():
+            if isinstance(value, str):
+                if not_json := False:
+                    print(value)
+                else:
+                    try:
+                        json_value = json.loads(value)
+                        data[key] = json.dumps(json_value, indent=4)
+                        print(data[key])
+                    except json.JSONDecodeError:
+                        print(value)
+            else:
+                pretty_print_json(value)
+    elif isinstance(data, list):
+        for index, item in enumerate(data):
+            if isinstance(item, str):
+                try:
+                    json_value = json.loads(item)
+                    data[index] = json.dumps(json_value, indent=4)
+                    print(data[index])
+                except json.JSONDecodeError:
+                    pass
+            else:
+                pretty_print_json(item)
+    else:
+        print(data)
+
+def pretty_print_jsonZ(data):
+    if isinstance(data, dict):
+        for key, value in data.items():
+            if isinstance(value, str):
+                try:
+                    json_value = json.loads(value)
+                    data[key] = json.dumps(json_value, indent=4)
+                except json.JSONDecodeError:
+                    pass
+            else:
+                pretty_print_json(value)
+    elif isinstance(data, list):
+        for index, item in enumerate(data):
+            if isinstance(item, str):
+                try:
+                    json_value = json.loads(item)
+                    data[index] = json.dumps(json_value, indent=4)
+                except json.JSONDecodeError:
+                    pass
+            else:
+                pretty_print_json(item)
+
+# Example JSON data
+data = [
+    {
+        "role": "user",
+        "content": "You are a data modelling expert and python software architect who expands on user input ideas. You create data models with at least 4 tables"
+    },
+    {
+        "role": "user",
+        "content": "{\"models\": null, \"test_data_rows\": null, \"rules\": null}"
+    },
+    {
+        "role": "user",
+        "content": "\n\nUpdate the Data Model and Test Data to ensure that:\n- The Data Model includes every column referenced in rules\n- Every column referenced in rules is properly initialized in the test data\n"
+    }
+]
+
+# Pretty print the JSON data
+# Load the JSON data from the file
+with open('genai_demo_no_logic/docs/request_fixup.json', 'r') as file:
+    data = json.load(file)
+pretty_print_json(data)
+pretty_json = json.dumps(data, indent=4)
+
+# Save the pretty printed JSON to a new file
+with open('pretty_request_fixup.json', 'w') as file:
+    file.write(pretty_json)
+
+print("Pretty printed JSON saved to pretty_request_fixup.json")

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/readme.md

@@ -0,0 +1,6 @@
+## GenAI Notes
+
+Review the [database diagram](https://apilogicserver.github.io/Docs/Database-Diagram/).
+
+GenAI work files (exact prompts, with inserts) saved for iterations, diagnostics
+See [WebGenAI-CLI](https://apilogicserver.github.io/Docs/WebGenAI-CLI/). 

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/readme_genai_example.md

@@ -0,0 +1,87 @@
+Status: this example under construction.  
+It should work (build and run), but:
+
+1. the resultant project combines the rules into `declare_logic.py` -- 
+they should be under `logic/discovery`
+2. additional customizations (new endpoints, security, etc) are not migrated in this procedure.
+    * Consider copying back to the original: database/db.sqlite, database/models, rebuilt api/expose_api_models.py
+
+Use this to explore:
+
+1. [managing logic in your project with multiple files](https://apilogicserver.github.io/Docs/WebGenAI-CLI/#add-logic-to-existing-projects)
+2. Merging multiple logic files into a single project, reflecting newly introduced attributes into:
+    * the data model
+    * and the test data
+
+<br/>
+
+## Create genai_no_logic and add logic files
+
+<br/>
+
+1. Create the `genai_demo_no_logic` project
+```
+als genai  --retries=3 --project-name=genai_demo_no_logic --using=system/genai/examples/genai_demo/genai_demo_no_logic.prompt
+```
+<br/>
+
+2. Acquire the logic files into `genai_demo_no_logic/docs/logic`
+```
+cp -r system/genai/examples/genai_demo/multiple_logic_files/docs/logic genai_demo_no_logic/docs
+```
+
+The `/logic` files are natural language prompts - `credit_check.prompt` and `constraint_tests`.
+ 
+> Observe this logic introduces new attributes: `customer.balance, product.carbon_neutral`
+
+<br/>
+
+3. Use `genai-logic` to translate Natural Language logic into logic code at `genai_demo_no_logic/logic/logic_discovery` (it takes a few moments):
+
+```
+cd genai_demo_no_logic
+als genai-logic
+```
+
+<br/>
+<br/>
+
+## Fixup to account for new attributes
+
+The project is not yet runnable, since: 
+* the logic refers to attributes not in the data model / database
+* the test data is incomplete and incorrect.
+
+To address, use the `genai-utils --fixup` utility, then create a new project:
+
+<br/>
+
+1. Execute `fixup` to get a revised data model and test data
+
+```
+# cd genai_demo_no_logic  # (you should already be at the directory)
+als genai-utils --fixup    
+```
+
+Creates `docs/fixup` -- verify:
+1.   `2_models.response` contains customer.balance, product.carbon_neutral
+2.   `3_rules.response` contains all logic
+
+
+<br/>
+
+2. Create a new project with the logic, revised data model and test data
+
+```
+cd ..   # This cd is important!  (else you get TypeError: ...)
+als genai --using=genai-utils_fixed --project-name=genai_demo_no_logic_fixed --retries=-1 --repaired-response=genai_demo_no_logic/docs/fixup/response_fixup.json
+
+# or, --repaired-response now supports a directory of data model / rule models:
+als genai --using=genai-utils_fixed --project-name=genai_demo_no_logic_fixed --retries=-1 --repaired-response=genai_demo_no_logic/docs/fixup
+```
+
+<br/>
+
+## Test
+
+To test, open and start `genai_demo_no_logic_fixed`, and use the Admin app to update a customer name to "x".  This should trigger a constraint message.

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/response.json

@@ -0,0 +1,141 @@
+{
+    "models": [
+        {
+            "classname": "Customer",
+            "code": "class Customer(Base):\n    __tablename__ = 'customer'\n\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    name = Column(String(255), unique=True)\n    credit_limit = Column(DECIMAL)\n    balance = Column(DECIMAL)\n",
+            "description": "Represents a customer entity with unique name, credit limit, and balance.",
+            "name": "customer"
+        },
+        {
+            "classname": "Order",
+            "code": "class Order(Base):\n    __tablename__ = 'order'\n\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    customer_id = Column(Integer, ForeignKey('customer.id'))\n    date_shipped = Column(DateTime)\n    amount_total = Column(DECIMAL)\n    notes = Column(String(255))\n",
+            "description": "Represents an order entity linked to a customer with a note field.",
+            "name": "order"
+        },
+        {
+            "classname": "Item",
+            "code": "class Item(Base):\n    __tablename__ = 'item'\n\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    order_id = Column(Integer, ForeignKey('order.id'))\n    product_id = Column(Integer, ForeignKey('product.id'))\n    quantity = Column(Integer, nullable=False)\n    unit_price = Column(DECIMAL)\n    amount = Column(DECIMAL)\n",
+            "description": "Represents an item within an order, linked to a product with mandatory quantity.",
+            "name": "item"
+        },
+        {
+            "classname": "Product",
+            "code": "class Product(Base):\n    __tablename__ = 'product'\n\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    name = Column(String(255), unique=True)\n    unit_price = Column(DECIMAL)\n",
+            "description": "Represents a product entity with unique name and unit price.",
+            "name": "product"
+        }
+    ],
+    "rules": [
+        {
+            "name": "Check Balance Constraint",
+            "description": "Ensure customer balance is within credit limit.",
+            "use_case": "Check Credit",
+            "entity": "Customer",
+            "code": "Rule.constraint(validate=Customer, \n                as_condition=lambda row: row.balance <= row.credit_limit, \n                error_msg=\"Customer balance ({row.balance}) exceeds credit limit ({row.credit_limit})\")"
+        },
+        {
+            "name": "Customer Balance Sum",
+            "description": "Sum of order amount totals where date shipped is null.",
+            "use_case": "Check Credit",
+            "entity": "Customer",
+            "code": "Rule.sum(derive=Customer.balance, \n          as_sum_of=Order.amount_total, \n          where=lambda row: row.date_shipped is None)"
+        },
+        {
+            "name": "Order Amount Total Sum",
+            "description": "Sum of item amounts for each order.",
+            "use_case": "Check Credit",
+            "entity": "Order",
+            "code": "Rule.sum(derive=Order.amount_total, \n          as_sum_of=Item.amount)"
+        },
+        {
+            "name": "Item Amount Formula",
+            "description": "Calculate item amount as quantity times unit price.",
+            "use_case": "Check Credit",
+            "entity": "Item",
+            "code": "Rule.formula(derive=Item.amount, \n             as_expression=lambda row: row.quantity * row.unit_price)"
+        },
+        {
+            "name": "Copy Unit Price",
+            "description": "Copy unit price from product to item.",
+            "use_case": "Check Credit",
+            "entity": "Item",
+            "code": "Rule.copy(derive=Item.unit_price, \n          from_parent=Product.unit_price)"
+        },
+        {
+            "name": "Order Shipping Kafka Event",
+            "description": "Send orders to Kafka when shipped date is not None.",
+            "use_case": "App Integration",
+            "entity": "Order",
+            "code": "Rule.after_flush_row_event(on_class=Order, \n                             calling=kafka_producer.send_row_to_kafka, \n                             if_condition=lambda row: row.date_shipped is not None, \n                             with_args={\"topic\": \"order_shipping\"})"
+        }
+    ],
+    "test_data": "# Customer Test Data Rows\ncustomer1 = Customer(id=1, name=\"John Doe\", credit_limit=1000, balance=0)\ncustomer2 = Customer(id=2, name=\"Jane Roe\", credit_limit=2000, balance=0)\ncustomer3 = Customer(id=3, name=\"Acme Corp\", credit_limit=5000, balance=0)\ncustomer4 = Customer(id=4, name=\"Globex Inc\", credit_limit=3000, balance=0)\n\n# Product Test Data Rows\nproduct1 = Product(id=1, name=\"Widget\", unit_price=10)\nproduct2 = Product(id=2, name=\"Gadget\", unit_price=20)\nproduct3 = Product(id=3, name=\"Doodad\", unit_price=15)\nproduct4 = Product(id=4, name=\"Thingamajig\", unit_price=25)\n\n# Order Test Data Rows\norder1 = Order(id=1, customer_id=1, amount_total=0, notes=\"First order\")\norder2 = Order(id=2, customer_id=2, amount_total=0, notes=\"Second order\")\norder3 = Order(id=3, customer_id=3, amount_total=0, notes=\"Third order\")\norder4 = Order(id=4, customer_id=4, amount_total=0, notes=\"Fourth order\")\n\n# Item Test Data Rows\nitem1 = Item(id=1, order_id=1, product_id=1, quantity=2, unit_price=10, amount=20)\nitem2 = Item(id=2, order_id=2, product_id=2, quantity=1, unit_price=20, amount=20)\nitem3 = Item(id=3, order_id=3, product_id=3, quantity=3, unit_price=15, amount=45)\nitem4 = Item(id=4, order_id=4, product_id=4, quantity=4, unit_price=25, amount=100)",
+    "test_data_rows": [
+        {
+            "test_data_row_variable": "customer1",
+            "code": "customer1 = Customer(id=1, name=\"John Doe\", credit_limit=1000, balance=0)"
+        },
+        {
+            "test_data_row_variable": "customer2",
+            "code": "customer2 = Customer(id=2, name=\"Jane Roe\", credit_limit=2000, balance=0)"
+        },
+        {
+            "test_data_row_variable": "customer3",
+            "code": "customer3 = Customer(id=3, name=\"Acme Corp\", credit_limit=5000, balance=0)"
+        },
+        {
+            "test_data_row_variable": "customer4",
+            "code": "customer4 = Customer(id=4, name=\"Globex Inc\", credit_limit=3000, balance=0)"
+        },
+        {
+            "test_data_row_variable": "product1",
+            "code": "product1 = Product(id=1, name=\"Widget\", unit_price=10)"
+        },
+        {
+            "test_data_row_variable": "product2",
+            "code": "product2 = Product(id=2, name=\"Gadget\", unit_price=20)"
+        },
+        {
+            "test_data_row_variable": "product3",
+            "code": "product3 = Product(id=3, name=\"Doodad\", unit_price=15)"
+        },
+        {
+            "test_data_row_variable": "product4",
+            "code": "product4 = Product(id=4, name=\"Thingamajig\", unit_price=25)"
+        },
+        {
+            "test_data_row_variable": "order1",
+            "code": "order1 = Order(id=1, customer_id=1, amount_total=0, notes=\"First order\")"
+        },
+        {
+            "test_data_row_variable": "order2",
+            "code": "order2 = Order(id=2, customer_id=2, amount_total=0, notes=\"Second order\")"
+        },
+        {
+            "test_data_row_variable": "order3",
+            "code": "order3 = Order(id=3, customer_id=3, amount_total=0, notes=\"Third order\")"
+        },
+        {
+            "test_data_row_variable": "order4",
+            "code": "order4 = Order(id=4, customer_id=4, amount_total=0, notes=\"Fourth order\")"
+        },
+        {
+            "test_data_row_variable": "item1",
+            "code": "item1 = Item(id=1, order_id=1, product_id=1, quantity=2, unit_price=10, amount=20)"
+        },
+        {
+            "test_data_row_variable": "item2",
+            "code": "item2 = Item(id=2, order_id=2, product_id=2, quantity=1, unit_price=20, amount=20)"
+        },
+        {
+            "test_data_row_variable": "item3",
+            "code": "item3 = Item(id=3, order_id=3, product_id=3, quantity=3, unit_price=15, amount=45)"
+        },
+        {
+            "test_data_row_variable": "item4",
+            "code": "item4 = Item(id=4, order_id=4, product_id=4, quantity=4, unit_price=25, amount=100)"
+        }
+    ],
+    "test_data_sqlite": "INSERT INTO customer (id, name, credit_limit, balance) VALUES (1, \"John Doe\", 1000, 0);\nINSERT INTO customer (id, name, credit_limit, balance) VALUES (2, \"Jane Roe\", 2000, 0);\nINSERT INTO customer (id, name, credit_limit, balance) VALUES (3, \"Acme Corp\", 5000, 0);\nINSERT INTO customer (id, name, credit_limit, balance) VALUES (4, \"Globex Inc\", 3000, 0);\n\nINSERT INTO product (id, name, unit_price) VALUES (1, \"Widget\", 10);\nINSERT INTO product (id, name, unit_price) VALUES (2, \"Gadget\", 20);\nINSERT INTO product (id, name, unit_price) VALUES (3, \"Doodad\", 15);\nINSERT INTO product (id, name, unit_price) VALUES (4, \"Thingamajig\", 25);\n\nINSERT INTO \"order\" (id, customer_id, amount_total, notes) VALUES (1, 1, 0, \"First order\");\nINSERT INTO \"order\" (id, customer_id, amount_total, notes) VALUES (2, 2, 0, \"Second order\");\nINSERT INTO \"order\" (id, customer_id, amount_total, notes) VALUES (3, 3, 0, \"Third order\");\nINSERT INTO \"order\" (id, customer_id, amount_total, notes) VALUES (4, 4, 0, \"Fourth order\");\n\nINSERT INTO item (id, order_id, product_id, quantity, unit_price, amount) VALUES (1, 1, 1, 2, 10, 20);\nINSERT INTO item (id, order_id, product_id, quantity, unit_price, amount) VALUES (2, 2, 2, 1, 20, 20);\nINSERT INTO item (id, order_id, product_id, quantity, unit_price, amount) VALUES (3, 3, 3, 3, 15, 45);\nINSERT INTO item (id, order_id, product_id, quantity, unit_price, amount) VALUES (4, 4, 4, 4, 25, 100);",
+    "name": "CustomerOrderSystem"
+}

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/integration/kafka/kafka_consumer.py

@@ -0,0 +1,60 @@
+"""
+Invoked at server start (api_logic_server_run.py -> config/setup.py)
+
+Listen/consume Kafka topis, if KAFKA_CONSUMER specified in Config.py
+
+Alter this file to add handlers for consuming kafka topics
+"""
+
+from config.config import Args
+from confluent_kafka import Producer, KafkaException, Consumer
+import signal
+import logging
+import json
+import socket
+import safrs
+from threading import Event
+from integration.system.FlaskKafka import FlaskKafka
+
+
+conf = None
+
+logger = logging.getLogger('integration.kafka')
+logger.debug("kafka_consumer imported")
+
+
+def kafka_consumer(safrs_api: safrs.SAFRSAPI = None):
+    """
+    Called by api_logic_server_run to listen on kafka
+
+    Enabled by config.KAFKA_CONSUMER
+
+    Args:
+        app (safrs.SAFRSAPI): safrs_api
+    """
+
+    if not Args.instance.kafka_consumer:
+        logger.debug(f'Kafka Consumer not activated')
+        return
+
+    conf = Args.instance.kafka_consumer
+    #  eg, KAFKA_CONSUMER = '{"bootstrap.servers": "localhost:9092", "group.id": "als-default-group1"}'
+    logger.debug(f'\nKafka Consumer configured, starting')
+
+    INTERRUPT_EVENT = Event()
+
+    bus = FlaskKafka(interrupt_event=INTERRUPT_EVENT, conf=conf, safrs_api=safrs_api)
+    
+    bus.run()  # Kafka consumption, threading, handler annotations
+
+    logger.debug(f'Kafka Listener thread activated {bus}')
+
+    '''   Your Code Goes Here
+    
+    Define topic handlers here, e.g.
+
+    @bus.handle('order_shipping')
+    def order_shipping(msg: object, safrs_api: safrs.SAFRSAPI):
+
+    '''
+