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

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo.response_example

@@ -71,25 +71,47 @@
     ],
     "graphics": [
         {
-            "sqlalchemy_query": "sales_by_month = (session.query(func.strftime('%Y-%m', Order.date_shipped).label('Month'), func.sum(Item.amount)) .join(Item, Order.id == Item.order_id) .group_by(func.strftime('%Y-%m', Order.date_shipped)) .order_by(func.strftime('%Y-%m', Order.date_shipped)))",
-            "classes_used": "Order, Item",
-            "name": "sales_by_month",
-            "html_code": "function drawSalesByMonthChart(result) {\n    const labels = result.map(entry => entry.Month);\n    const data = result.map(entry => entry.TotalSales);\n    const ctx = document.getElementById('salesByMonthChart').getContext('2d');\n    new Chart(ctx, {\n        type: 'bar',\n        data: {\n            labels: labels,\n            datasets: [{\n                label: 'Sales by Month',\n                data: data,\n                backgroundColor: '#42A5F5',\n                borderColor: '#1E88E5',\n                borderWidth: 1\n            }]\n        },\n        options: {\n            scales: {\n                yAxes: [{\n                    ticks: {\n                        beginAtZero: true\n                    }\n                }]\n            }\n        }\n    });\n}"
+            "sqlalchemy_query": "session.query(Product.name, func.sum(Item.amount).label('TotalSales')).join(Item, Product.id == Item.product_id).filter(Order.date_shipped.isnot(None)).group_by(Product.name).order_by(func.sum(Item.amount).desc())",
+            "sql_query": "SELECT Product.name, SUM(Item.amount) AS TotalSales FROM Product JOIN Item ON Product.id = Item.product_id JOIN Order ON Item.order_id = Order.id WHERE Order.date_shipped IS NOT NULL GROUP BY Product.name ORDER BY TotalSales DESC",
+            "classes_used": "Product, Item, Order",
+            "class_x_axis": "Product",
+            "name": "sales_by_product",
+            "prompt": "Graph Sales by Product",
+            "title": "Sales by Product",
+            "xAxis": "Product",
+            "yAxis": "Total Sales",
+            "dashboard": true,
+            "graph_type": "Bar",
+            "html_code": "var data = result.result; var categories = data.map(item => item[0]); var totals = data.map(item => item[1]); var ctx = document.getElementById('salesByProductChart').getContext('2d'); new Chart(ctx, {type: 'bar', data: {labels: categories, datasets: [{label: 'Sales by Product', data: totals}]}});"
+        },
+        {
+            "sqlalchemy_query": "session.query(Customer.name, func.sum(Order.amount_total).label('TotalCustomerSales')).join(Order, Customer.id == Order.customer_id).filter(Order.date_shipped.isnot(None)).group_by(Customer.name).order_by(func.sum(Order.amount_total).desc())",
+            "sql_query": "SELECT Customer.name, SUM(Order.amount_total) AS TotalCustomerSales FROM Customer JOIN Order ON Customer.id = Order.customer_id WHERE Order.date_shipped IS NOT NULL GROUP BY Customer.name ORDER BY TotalCustomerSales DESC",
+            "classes_used": "Customer, Order",
+            "class_x_axis": "Customer",
+            "name": "sales_by_customer",
+            "prompt": "Graph Sales by Customer",
+            "title": "Sales by Customer",
+            "xAxis": "Customer",
+            "yAxis": "Total Sales",
+            "dashboard": true,
+            "graph_type": "Bar",
+            "html_code": "var data = result.result; var customers = data.map(item => item[0]); var sales = data.map(item => item[1]); var ctx = document.getElementById('salesByCustomerChart').getContext('2d'); new Chart(ctx, {type: 'bar', data: {labels: customers, datasets: [{label: 'Sales by Customer', data: sales}]}});"
         }
     ],
     "test_data": "This is the test data generated for Customers, Orders, Items, and Products in the new system.",
     "test_data_rows": [
         {
             "test_data_row_variable": "customer1",
-            "code": "customer1 = Customer(name=\"Alice\", balance=1000.00, credit_limit=5000.00)"
+            "code": "customer1 = Customer(name=\"Alice\", balance=90.00, credit_limit=5000.00)"
         },
         {
             "test_data_row_variable": "customer2",
-            "code": "customer2 = Customer(name=\"Bob\", balance=2000.00, credit_limit=3000.00)"
+            "code": "customer2 = Customer(name=\"Bob\", balance=0.00, credit_limit=3000.00)"
         },
         {
             "test_data_row_variable": "customer3",
-            "code": "customer3 = Customer(name=\"Charlie\", balance=500.00, credit_limit=2000.00)"
+            "code": "customer3 = Customer(name=\"Charlie\", balance=220.00, credit_limit=2000.00)"
         },
         {
             "test_data_row_variable": "customer4",
@@ -113,15 +135,15 @@
         },
         {
             "test_data_row_variable": "order1",
-            "code": "order1 = Order(notes=\"First Order\", customer_id=1, date_shipped=date(2023, 3, 22), amount_total=300.00)"
+            "code": "order1 = Order(notes=\"First Order\", customer_id=2, date_shipped=date(2023, 3, 22), amount_total=300.00)"
         },
         {
             "test_data_row_variable": "order2",
-            "code": "order2 = Order(notes=\"Second Order\", customer_id=2, date_shipped=None, amount_total=0.00)"
+            "code": "order2 = Order(notes=\"Second Order\", customer_id=1, date_shipped=None, amount_total=90.00)"
         },
         {
             "test_data_row_variable": "order3",
-            "code": "order3 = Order(notes=\"Pending Shipment\", customer_id=3, date_shipped=None, amount_total=300.00)"
+            "code": "order3 = Order(notes=\"Pending Shipment\", customer_id=3, date_shipped=None, amount_total=220.00)"
         },
         {
             "test_data_row_variable": "order4",

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/docs/002_create_db_models.prompt

@@ -5,8 +5,6 @@ Create a system with customers, orders, items and products.
 
 Include a notes field for orders.
 
-Use LogicBank to enforce these requirements (do not generate check constraints); be sure to update the data model and *all* test data with any attributes used in the logic:
-
 Use case: Check Credit    
     1. The Customer's balance is less than the credit limit
     2. The Customer's balance is the sum of the Order amount_total where date_shipped is null
@@ -17,12 +15,14 @@ Use case: Check Credit
 Use case: App Integration
     1. Send the Order to Kafka topic 'order_shipping' if the date_shipped is not None.
 
-Ensure each customer and product has a unique name.
+Ensure each customer has a unique name.
 
 Ensure each Item quantity is not null.
 
 Ensure each order has a valid customer_id that exists in the Customer table.
-.
+
+Graph sales by month, for dashboard.
+Graph Sales by Product, for dashboard.
 </Requirements>
 
 Hints: use autonum keys (for all tables - including for link/join/junction/intersection tables), allow nulls, foreign keys, no check constraints.

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

@@ -2,140 +2,170 @@
     "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"
+            "code": "class Customer(Base):\n    __tablename__ = 'customer'\n\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    name = Column(String, unique=True)\n    balance = Column(DECIMAL)\n    credit_limit = Column(DECIMAL)",
+            "description": "Defines the Customer entity with a unique name, balance, and credit limit.",
+            "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"
+            "code": "class Order(Base):\n    __tablename__ = 'order'\n\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    notes = Column(String)\n    customer_id = Column(Integer, ForeignKey('customer.id'), nullable=False)\n    date_shipped = Column(Date)\n    amount_total = Column(DECIMAL)",
+            "description": "Defines the Order entity which belongs to a customer. Includes notes and amount total.",
+            "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"
+            "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'), nullable=False)\n    quantity = Column(Integer, nullable=False)\n    amount = Column(DECIMAL)\n    unit_price = Column(DECIMAL)",
+            "description": "Defines the Item entity with quantity, amounts, and unit price details.",
+            "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"
+            "code": "class Product(Base):\n    __tablename__ = 'product'\n\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    name = Column(String, unique=True)\n    unit_price = Column(DECIMAL)",
+            "description": "Defines the Product entity with a unique name and unit price.",
+            "name": "Product"
         }
     ],
     "rules": [
         {
-            "name": "Check Balance Constraint",
-            "description": "Ensure customer balance is within credit limit.",
+            "name": "Customer Balance Constraint",
+            "description": "Ensure the customer's balance is less than their 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})\")"
+            "code": "Rule.constraint(validate=Customer, as_condition=lambda row: row.balance <= row.credit_limit, 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.",
+            "name": "Customer Balance Derivation",
+            "description": "Derive the customer's balance as the sum of order totals where not yet shipped.",
             "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)"
+            "code": "Rule.sum(derive=Customer.balance, as_sum_of=Order.amount_total, where=lambda row: row.date_shipped is None)"
         },
         {
-            "name": "Order Amount Total Sum",
-            "description": "Sum of item amounts for each order.",
+            "name": "Order Total Derivation",
+            "description": "Derive the order's total amount from the sum of item amounts.",
             "use_case": "Check Credit",
             "entity": "Order",
-            "code": "Rule.sum(derive=Order.amount_total, \n          as_sum_of=Item.amount)"
+            "code": "Rule.sum(derive=Order.amount_total, as_sum_of=Item.amount)"
         },
         {
-            "name": "Item Amount Formula",
-            "description": "Calculate item amount as quantity times unit price.",
+            "name": "Item Amount Calculation",
+            "description": "Calculate item amount based on quantity and unit price.",
             "use_case": "Check Credit",
             "entity": "Item",
-            "code": "Rule.formula(derive=Item.amount, \n             as_expression=lambda row: row.quantity * row.unit_price)"
+            "code": "Rule.formula(derive=Item.amount, as_expression=lambda row: row.quantity * row.unit_price)"
         },
         {
-            "name": "Copy Unit Price",
+            "name": "Item Unit Price Copy",
             "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)"
+            "code": "Rule.copy(derive=Item.unit_price, from_parent=Product.unit_price)"
         },
         {
-            "name": "Order Shipping Kafka Event",
-            "description": "Send orders to Kafka when shipped date is not None.",
+            "name": "Order Kafka Notification",
+            "description": "Send order details to Kafka if order is shipped.",
             "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\"})"
+            "code": "Rule.after_flush_row_event(on_class=Order, calling=kafka_producer.send_row_to_kafka, if_condition=lambda row: row.date_shipped is not None, 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)",
+    "graphics": [
+        {
+            "sqlalchemy_query": "session.query(Product.name, func.sum(Item.amount).label('TotalSales')).join(Item, Product.id == Item.product_id).filter(Order.date_shipped.isnot(None)).group_by(Product.name).order_by(func.sum(Item.amount).desc())",
+            "sql_query": "SELECT Product.name, SUM(Item.amount) AS TotalSales FROM Product JOIN Item ON Product.id = Item.product_id JOIN Order ON Item.order_id = Order.id WHERE Order.date_shipped IS NOT NULL GROUP BY Product.name ORDER BY TotalSales DESC",
+            "classes_used": "Product, Item, Order",
+            "class_x_axis": "Product",
+            "name": "sales_by_product",
+            "prompt": "Graph Sales by Product",
+            "title": "Sales by Product",
+            "xAxis": "Product",
+            "yAxis": "Total Sales",
+            "dashboard": true,
+            "graph_type": "Bar",
+            "html_code": "var data = result.result; var categories = data.map(item => item[0]); var totals = data.map(item => item[1]); var ctx = document.getElementById('salesByProductChart').getContext('2d'); new Chart(ctx, {type: 'bar', data: {labels: categories, datasets: [{label: 'Sales by Product', data: totals}]}});"
+        },
+        {
+            "sqlalchemy_query": "session.query(Customer.name, func.sum(Order.amount_total).label('TotalCustomerSales')).join(Order, Customer.id == Order.customer_id).filter(Order.date_shipped.isnot(None)).group_by(Customer.name).order_by(func.sum(Order.amount_total).desc())",
+            "sql_query": "SELECT Customer.name, SUM(Order.amount_total) AS TotalCustomerSales FROM Customer JOIN Order ON Customer.id = Order.customer_id WHERE Order.date_shipped IS NOT NULL GROUP BY Customer.name ORDER BY TotalCustomerSales DESC",
+            "classes_used": "Customer, Order",
+            "class_x_axis": "Customer",
+            "name": "sales_by_customer",
+            "prompt": "Graph Sales by Customer",
+            "title": "Sales by Customer",
+            "xAxis": "Customer",
+            "yAxis": "Total Sales",
+            "dashboard": true,
+            "graph_type": "Bar",
+            "html_code": "var data = result.result; var customers = data.map(item => item[0]); var sales = data.map(item => item[1]); var ctx = document.getElementById('salesByCustomerChart').getContext('2d'); new Chart(ctx, {type: 'bar', data: {labels: customers, datasets: [{label: 'Sales by Customer', data: sales}]}});"
+        }
+    ],
+    "test_data": "This is the test data generated for Customers, Orders, Items, and Products in the new system.",
     "test_data_rows": [
         {
             "test_data_row_variable": "customer1",
-            "code": "customer1 = Customer(id=1, name=\"John Doe\", credit_limit=1000, balance=0)"
+            "code": "customer1 = Customer(name=\"Alice\", balance=1000.00, credit_limit=5000.00)"
         },
         {
             "test_data_row_variable": "customer2",
-            "code": "customer2 = Customer(id=2, name=\"Jane Roe\", credit_limit=2000, balance=0)"
+            "code": "customer2 = Customer(name=\"Bob\", balance=2000.00, credit_limit=3000.00)"
         },
         {
             "test_data_row_variable": "customer3",
-            "code": "customer3 = Customer(id=3, name=\"Acme Corp\", credit_limit=5000, balance=0)"
+            "code": "customer3 = Customer(name=\"Charlie\", balance=500.00, credit_limit=2000.00)"
         },
         {
             "test_data_row_variable": "customer4",
-            "code": "customer4 = Customer(id=4, name=\"Globex Inc\", credit_limit=3000, balance=0)"
+            "code": "customer4 = Customer(name=\"Diana\", balance=0.00, credit_limit=1000.00)"
         },
         {
             "test_data_row_variable": "product1",
-            "code": "product1 = Product(id=1, name=\"Widget\", unit_price=10)"
+            "code": "product1 = Product(name=\"Gadget\", unit_price=150.00)"
         },
         {
             "test_data_row_variable": "product2",
-            "code": "product2 = Product(id=2, name=\"Gadget\", unit_price=20)"
+            "code": "product2 = Product(name=\"Widget\", unit_price=90.00)"
         },
         {
             "test_data_row_variable": "product3",
-            "code": "product3 = Product(id=3, name=\"Doodad\", unit_price=15)"
+            "code": "product3 = Product(name=\"Thingamajig\", unit_price=75.00)"
         },
         {
             "test_data_row_variable": "product4",
-            "code": "product4 = Product(id=4, name=\"Thingamajig\", unit_price=25)"
+            "code": "product4 = Product(name=\"Doodad\", unit_price=110.00)"
         },
         {
             "test_data_row_variable": "order1",
-            "code": "order1 = Order(id=1, customer_id=1, amount_total=0, notes=\"First order\")"
+            "code": "order1 = Order(notes=\"First Order\", customer_id=1, date_shipped=date(2023, 3, 22), amount_total=300.00)"
         },
         {
             "test_data_row_variable": "order2",
-            "code": "order2 = Order(id=2, customer_id=2, amount_total=0, notes=\"Second order\")"
+            "code": "order2 = Order(notes=\"Second Order\", customer_id=2, date_shipped=None, amount_total=0.00)"
         },
         {
             "test_data_row_variable": "order3",
-            "code": "order3 = Order(id=3, customer_id=3, amount_total=0, notes=\"Third order\")"
+            "code": "order3 = Order(notes=\"Pending Shipment\", customer_id=3, date_shipped=None, amount_total=300.00)"
         },
         {
             "test_data_row_variable": "order4",
-            "code": "order4 = Order(id=4, customer_id=4, amount_total=0, notes=\"Fourth order\")"
+            "code": "order4 = Order(notes=\"Urgent Order\", customer_id=4, date_shipped=date(2023, 7, 15), amount_total=220.00)"
         },
         {
             "test_data_row_variable": "item1",
-            "code": "item1 = Item(id=1, order_id=1, product_id=1, quantity=2, unit_price=10, amount=20)"
+            "code": "item1 = Item(order_id=1, product_id=1, quantity=2, amount=300.00, unit_price=150.00)"
         },
         {
             "test_data_row_variable": "item2",
-            "code": "item2 = Item(id=2, order_id=2, product_id=2, quantity=1, unit_price=20, amount=20)"
+            "code": "item2 = Item(order_id=2, product_id=2, quantity=1, amount=90.00, unit_price=90.00)"
         },
         {
             "test_data_row_variable": "item3",
-            "code": "item3 = Item(id=3, order_id=3, product_id=3, quantity=3, unit_price=15, amount=45)"
+            "code": "item3 = Item(order_id=3, product_id=4, quantity=2, amount=220.00, unit_price=110.00)"
         },
         {
             "test_data_row_variable": "item4",
-            "code": "item4 = Item(id=4, order_id=4, product_id=4, quantity=4, unit_price=25, amount=100)"
+            "code": "item4 = Item(order_id=4, product_id=3, quantity=4, amount=300.00, unit_price=75.00)"
         }
     ],
-    "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);",
+    "test_data_sqlite": "INSERT INTO customer (name, balance, credit_limit) VALUES ('Alice', 1000.00, 5000.00);\nINSERT INTO customer (name, balance, credit_limit) VALUES ('Bob', 2000.00, 3000.00);\nINSERT INTO customer (name, balance, credit_limit) VALUES ('Charlie', 500.00, 2000.00);\nINSERT INTO customer (name, balance, credit_limit) VALUES ('Diana', 0.00, 1000.00);\n\nINSERT INTO product (name, unit_price) VALUES ('Gadget', 150.00);\nINSERT INTO product (name, unit_price) VALUES ('Widget', 90.00);\nINSERT INTO product (name, unit_price) VALUES ('Thingamajig', 75.00);\nINSERT INTO product (name, unit_price) VALUES ('Doodad', 110.00);\n\nINSERT INTO [order] (notes, customer_id, date_shipped, amount_total) VALUES ('First Order', 1, '2023-03-22', 300.00);\nINSERT INTO [order] (notes, customer_id, date_shipped, amount_total) VALUES ('Second Order', 2, NULL, 0.00);\nINSERT INTO [order] (notes, customer_id, date_shipped, amount_total) VALUES ('Pending Shipment', 3, NULL, 300.00);\nINSERT INTO [order] (notes, customer_id, date_shipped, amount_total) VALUES ('Urgent Order', 4, '2023-07-15', 220.00);\n\nINSERT INTO item (order_id, product_id, quantity, amount, unit_price) VALUES (1, 1, 2, 300.00, 150.00);\nINSERT INTO item (order_id, product_id, quantity, amount, unit_price) VALUES (2, 2, 1, 90.00, 90.00);\nINSERT INTO item (order_id, product_id, quantity, amount, unit_price) VALUES (3, 4, 2, 220.00, 110.00);\nINSERT INTO item (order_id, product_id, quantity, amount, unit_price) VALUES (4, 3, 4, 300.00, 75.00);",
     "name": "CustomerOrderSystem"
 }

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_informal.prompt

@@ -16,4 +16,4 @@ Ensure each customer has a unique name.
 
 Ensure each Item quantity is not null.
 
-Ensure each order has a valid customer_id that exists in the Customer table.
+Ensure: each order has a valid customer_id that exists in the Customer table.

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/dashboard_services.jinja

@@ -0,0 +1,83 @@
+from database import models
+import logging
+from safrs import jsonapi_attr
+from sqlalchemy.orm import relationship, remote, foreign
+from functools import wraps # This convenience func preserves name and docstring
+import decimal as decimal
+from sqlalchemy import extract, func
+from flask import request, jsonify
+from safrs import jsonapi_rpc, SAFRSAPI
+from database import models
+import safrs
+from pathlib import Path
+
+"""
+Called by iFrame in home.js when admin app is loaded
+
+Returns iFrame for ui/admin/home.js, with entries like this to populate the dashboard:
+<iframe src="http://localhost:5656/chart_graphics/sales_per_category" style="flex: 1; border: none; width: 90%; height: 200px;">
+
+curl -X GET "http://localhost:5656/dashboard"
+
+You typically do not alter this file - it is rebuilt on `als genai-graphics`
+
+"""
+
+app_logger = logging.getLogger(__name__)
+dashboard_result = {}
+
+
+def add_service(app, api, project_dir, swagger_host: str, PORT: str, method_decorators = []):
+    pass
+
+    @app.route('/dashboard', methods=['GET','OPTIONS'])
+    def dashboard():
+
+
+        if request.method == 'OPTIONS':
+            return jsonify({"result": "ok"})
+
+        server = request.host_url
+    
+        iframe_template = '<div class="dashboard-iframe"><iframe src="{url}" style="flex: 1; border: none; width: 90%; height: 200px;"></iframe></div>'
+        {% for iframe in iframe_templates %}
+        {{iframe}}
+        {% endfor %}
+
+        {% if has_iframe %}
+        return f'<div style="display: flex; flex-direction: row; gap: 10px;  border: none; ">{{ iframe_links }}</div>'
+        {% endif %}
+        {% if has_iframe == false %}
+        return jsonify({})
+        {% endif %}
+
+    @app.route('/chart_graphics/<path:path>', methods=['GET','OPTIONS'])
+    def chart_graphics(path):
+        if request.method == 'OPTIONS':
+            return jsonify({"result": "ok"})
+
+        dashboards = get_dashboards()
+        if len(dashboards) == 0:
+            return jsonify({"result": "No dashboards Found"}), 404
+        if path in dashboards:
+            return dashboards[path]
+        return jsonify({"result": "not found"}), 404
+
+
+    ##############################
+    # generated queries follow
+    ##############################
+
+    def get_dashboards():
+        if len(dashboard_result) > 0:
+            return dashboard_result
+    
+        from jinja2 import Environment, FileSystemLoader
+        env = Environment(loader = FileSystemLoader('ui/templates'))
+        template = env.get_template('bar_chart.jinja')
+            
+        {% for dashboard in dashboards %}
+        {{dashboard}}
+        {% endfor %}
+        
+        return dashboard_result

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/graphics_dashboard_WIP.py

@@ -0,0 +1,34 @@
+from functools import wraps
+import logging
+from flask_jwt_extended import get_jwt, jwt_required, verify_jwt_in_request
+from config.config import Config, Args
+from security.system.authorization import Security
+import api.system.api_utils as api_utils
+from typing import List
+import safrs
+import sqlalchemy
+from flask import request, jsonify
+from safrs import jsonapi_rpc, SAFRSAPI
+from sqlalchemy.ext.hybrid import hybrid_property
+from sqlalchemy.orm import object_mapper
+from sqlalchemy import extract, func
+from database import models
+from flask_cors import cross_origin
+from logic_bank.rule_bank.rule_bank import RuleBank
+import integration.system.RowDictMapper as row_dict_mapper
+
+# called by home.js to populate dashboard iFrame with results of all dsahboard queries
+
+app_logger = logging.getLogger("api_logic_server_app")
+
+def add_service(app, api, project_dir, swagger_host: str, PORT: str, method_decorators = []):
+    pass
+
+    api.expose_object(GraphicsDashboard)  # Swagger-visible services
+
+
+class GraphicsDashboard(safrs.JABase):
+    """GraphicsDashboard service - results of all dsahboard queries"""
+    result = []
+
+{{dashboard_lines}}

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/{graphics_services.py → graphics_services_api_xxx.py}

@@ -29,13 +29,4 @@ app_logger = logging.getLogger("api_logic_server_app")
 def add_service(app, api, project_dir, swagger_host: str, PORT: str, method_decorators = []):
     pass
 
-    api.expose_object(GraphicsServices)  # Swagger-visible services
 
-
-"""
-Illustrates #als: apis for graphics
-
-* Custom service - visible in swagger
-"""
-class GraphicsServices(safrs.JABase):
-    pass

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/graphics_services_db.jinja

@@ -0,0 +1,46 @@
+from database import models
+import logging
+from safrs import jsonapi_attr
+from sqlalchemy.orm import relationship, remote, foreign
+from functools import wraps # This convenience func preserves name and docstring
+import decimal as decimal
+from sqlalchemy import extract, func
+from flask import request, jsonify
+from safrs import jsonapi_rpc, SAFRSAPI
+import safrs
+
+"""
+Graphics methods for database classes, created when: 
+* `als genai create` contains prompts like: 'Graph Sales by Category', etc.
+* `als add-graphics` --using the docs/graphics directory
+
+Called by api/api_discovery/dashboard_services.py when admin app loaded
+
+You typically do not alter this file - rebuilt on als genai--graphics.
+
+"""
+
+app_logger = logging.getLogger(__name__)
+
+
+def add_method(cls):
+  """
+  Decorator to add method to class, e.g., db class group by query method
+
+  Thanks to: https://mgarod.medium.com/dynamically-add-a-method-to-a-class-in-python-c49204b85bd6
+  """
+  def decorator(func):
+    @wraps(func) 
+    def wrapper(self, *args, **kwargs): 
+      return func(*args, **kwargs)
+    
+    setattr(cls, func.__name__, wrapper)
+    # Note we are not binding func, but wrapper which accepts self but does exactly the same as func
+    return func # returning func means func can still be used normally
+  return decorator
+
+##############################
+# generated services follow
+##############################
+
+

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/graphics_services_db_each_method.jinja

@@ -0,0 +1,36 @@
+
+@classmethod
+@add_method(models.{{class_x_axis}})
+@jsonapi_rpc(http_methods=['GET', 'OPTIONS'])
+def {{name}}(*args, **kwargs):
+    """        
+    Complex query with multiple joins, for graphics, from 'Graph Sales by Category', etc.
+    Test with Swagger.
+    """
+    if request.method == 'OPTIONS':
+        return jsonify({ "result": "ok" })
+        
+    from database.models import {{classes_used}}
+    db = safrs.DB
+    session = db.session    # sqlalchemy.orm.scoping.scoped_session
+    # Security.set_user_sa()  # an endpoint that requires no auth header (see also @bypass_security)
+
+    # SQLAlchemy query
+    query = {{ sqlalchemy_query }} 
+    # Execute query and fetch results
+    results = query.all()
+    from decimal import Decimal
+    columns = ['{{ xAxis }}' , '{{ yAxis }}']
+    results = [{columns[0]: row[0], columns[1]: round(float(row[1]), 2)} for row in results]
+    title = '{{ title }}'
+    graph_type = '{{ graph_type }}'.lower()
+    json_results = {
+        "results": results,
+        "columns": columns,
+        "title": title,
+        "chart_type": graph_type,
+        "xAxis": columns[0],
+        "yAxis": columns[1],
+    }
+    
+    return json_results 

api_logic_server_cli/prototypes/manager/system/genai/prompt_inserts/graphics.prompt

@@ -1,8 +1,11 @@
 
-Create WGResult Graphics for prompts like 'graph sales by region'.
-    * use 'sales by region' to create a WGResult Graphic.sqlalchemy_query
+Create WGResult Graphics, with graphics elements for each prompts like 'graph sales by region'.
+    * do not create graphics elements unless explicitly requested.
+    * query results should always return exactly 2 columns.
+    * use 'sales by region' to create a WGResult Graphic.sqlalchemy_query for *each* such line
     * Be sure to use class names, not table names
-    * for example, using Northwind:
+    * Create joins for only explicitly defined foreign key relationships
+    * for example, using Northwind - important!  note the 2 right parens closing label("Total Sales"):
         # SQLAlchemy query for Sales by Category
         sales_by_category = (
             session.query(
@@ -16,3 +19,4 @@ Create WGResult Graphics for prompts like 'graph sales by region'.
             .group_by(Category.CategoryName)
             .order_by(func.sum(OrderDetail.Quantity * OrderDetail.UnitPrice * (1 - OrderDetail.Discount)).desc())
         )
+

api_logic_server_cli/prototypes/manager/system/genai/prompt_inserts/response_format.prompt

@@ -21,7 +21,14 @@ class Graphic(BaseModel):
     sqlalchemy_query: str  # sqlalchemy query using group by, returns result = { "result": [ ("name", "value")  ] }
     sql_query: str  # sql query using group by, returns result = { "result": [ ("name", "value")  ] }
     classes_used: str # comma-delimited list of classes used in sqlalchemy_query
-    name: str  # suggested Python name for sqlalchemy_query
+    class_x_axis: str # name of class for x axis
+    name: str  # suggested Python name for sqlalchemy_query - unique
+    prompt: str  # prompt used to create the graphic
+    title: str # expanded name
+    xAxis: str # caption for x axis
+    yAxis: str # caption for y axis
+    dashboard: bool  # whether appears on home page
+    graph_type: str  # Bar, Line, Pie
     html_code: str # create a java script app to show a bar chart from sqlalchemy_query result
 
 class WGResult(BaseModel):  # must match system/genai/prompt_inserts/response_format.prompt