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

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

@@ -2,140 +2,148 @@
     "models": [
         {
             "classname": "Customer",
-            "code": "class Customer(Base):\n    __tablename__ = 'customer'\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": "Represents a customer in the system with unique name, balance, and credit limit attributes.",
+            "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    id = Column(Integer, primary_key=True, autoincrement=True)\n    customer_id = Column(Integer, ForeignKey('customer.id'))\n    date_shipped = Column(Date)\n    amount_total = Column(DECIMAL)\n    notes = Column(String)",
-            "description": "Represents an order made by a customer, including a notes field.",
+            "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    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)",
-            "description": "Represents an item in an order, including quantity and pricing details.",
+            "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    id = Column(Integer, primary_key=True, autoincrement=True)\n    name = Column(String)\n    unit_price = Column(DECIMAL)",
-            "description": "Represents a product available in the system with a unit price.",
+            "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": "Customer Balance Constraint",
-            "description": "Ensures the customer's balance is aligned with the credit limit.",
-            "use_case": "Customer.balance <= credit_limit",
+            "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 Derivation",
-            "description": "Calculates the customer's balance as the sum of orders' amount_total where date_shipped is null.",
-            "use_case": "Customer.balance = Sum(Order.amount_total where date_shipped is null)",
+            "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, as_sum_of=Order.amount_total, where=lambda row: row.date_shipped is None)"
         },
         {
-            "name": "Order Amount Total Derivation",
-            "description": "Calculates order's amount_total as the sum of item amounts.",
-            "use_case": "Order.amount_total = Sum(Item.amount)",
+            "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, as_sum_of=Item.amount)"
         },
         {
-            "name": "Item Amount Derivation",
-            "description": "Calculates item amount as quantity multiplied by unit price.",
-            "use_case": "Item.amount = quantity * 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, as_expression=lambda row: row.quantity * row.unit_price)"
         },
         {
-            "name": "Copy Item Unit Price",
-            "description": "Copies the product's unit price to the item.",
-            "use_case": "Store the Item.unit_price as a copy from Product.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, from_parent=Product.unit_price)"
         },
         {
-            "name": "Order Kafka Integration",
-            "description": "Sends the order to Kafka topic 'order_shipping' if the date shipped 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, calling=kafka_producer.send_row_to_kafka, if_condition=lambda row: row.date_shipped is not None, 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": "Insert test data into the tables with values compatible with the derived logic.",
+    "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}"
+        }
+    ],
+    "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": "test_customer_1",
-            "code": "test_customer_1 = Customer(name='Customer 1', balance=150, credit_limit=1000)"
+            "test_data_row_variable": "customer1",
+            "code": "customer1 = Customer(name=\"Alice\", balance=1000.00, credit_limit=5000.00)"
         },
         {
-            "test_data_row_variable": "test_customer_2",
-            "code": "test_customer_2 = Customer(name='Customer 2', balance=275, credit_limit=750)"
+            "test_data_row_variable": "customer2",
+            "code": "customer2 = Customer(name=\"Bob\", balance=2000.00, credit_limit=3000.00)"
         },
         {
-            "test_data_row_variable": "test_customer_3",
-            "code": "test_customer_3 = Customer(name='Customer 3', balance=150, credit_limit=1500)"
+            "test_data_row_variable": "customer3",
+            "code": "customer3 = Customer(name=\"Charlie\", balance=500.00, credit_limit=2000.00)"
         },
         {
-            "test_data_row_variable": "test_customer_4",
-            "code": "test_customer_4 = Customer(name='Customer 4', balance=0, credit_limit=1200)"
+            "test_data_row_variable": "customer4",
+            "code": "customer4 = Customer(name=\"Diana\", balance=0.00, credit_limit=1000.00)"
         },
         {
-            "test_data_row_variable": "test_order_1",
-            "code": "test_order_1 = Order(customer_id=1, notes='Order 1 notes', amount_total=150)"
+            "test_data_row_variable": "product1",
+            "code": "product1 = Product(name=\"Gadget\", unit_price=150.00)"
         },
         {
-            "test_data_row_variable": "test_order_2",
-            "code": "test_order_2 = Order(customer_id=2, notes='Order 2 notes', amount_total=225)"
+            "test_data_row_variable": "product2",
+            "code": "product2 = Product(name=\"Widget\", unit_price=90.00)"
         },
         {
-            "test_data_row_variable": "test_order_3",
-            "code": "test_order_3 = Order(customer_id=2, notes='Order 3 notes', amount_total=50)"
+            "test_data_row_variable": "product3",
+            "code": "product3 = Product(name=\"Thingamajig\", unit_price=75.00)"
         },
         {
-            "test_data_row_variable": "test_order_4",
-            "code": "test_order_4 = Order(customer_id=3, notes='Order 4 notes', amount_total=150)"
+            "test_data_row_variable": "product4",
+            "code": "product4 = Product(name=\"Doodad\", unit_price=110.00)"
         },
         {
-            "test_data_row_variable": "test_item_1",
-            "code": "test_item_1 = Item(order_id=1, product_id=1, quantity=3, unit_price=50, amount=150)"
+            "test_data_row_variable": "order1",
+            "code": "order1 = Order(notes=\"First Order\", customer_id=1, date_shipped=date(2023, 3, 22), amount_total=300.00)"
         },
         {
-            "test_data_row_variable": "test_item_2",
-            "code": "test_item_2 = Item(order_id=2, product_id=2, quantity=2, unit_price=25, amount=50)"
+            "test_data_row_variable": "order2",
+            "code": "order2 = Order(notes=\"Second Order\", customer_id=2, date_shipped=None, amount_total=0.00)"
         },
         {
-            "test_data_row_variable": "test_item_3",
-            "code": "test_item_3 = Item(order_id=3, product_id=3, quantity=3, unit_price=75, amount=225)"
+            "test_data_row_variable": "order3",
+            "code": "order3 = Order(notes=\"Pending Shipment\", customer_id=3, date_shipped=None, amount_total=300.00)"
         },
         {
-            "test_data_row_variable": "test_item_4",
-            "code": "test_item_4 = Item(order_id=4, product_id=1, quantity=3, unit_price=50, amount=150)"
+            "test_data_row_variable": "order4",
+            "code": "order4 = Order(notes=\"Urgent Order\", customer_id=4, date_shipped=date(2023, 7, 15), amount_total=220.00)"
         },
         {
-            "test_data_row_variable": "test_product_1",
-            "code": "test_product_1 = Product(name='Product 1', unit_price=50)"
+            "test_data_row_variable": "item1",
+            "code": "item1 = Item(order_id=1, product_id=1, quantity=2, amount=300.00, unit_price=150.00)"
         },
         {
-            "test_data_row_variable": "test_product_2",
-            "code": "test_product_2 = Product(name='Product 2', unit_price=25)"
+            "test_data_row_variable": "item2",
+            "code": "item2 = Item(order_id=2, product_id=2, quantity=1, amount=90.00, unit_price=90.00)"
         },
         {
-            "test_data_row_variable": "test_product_3",
-            "code": "test_product_3 = Product(name='Product 3', unit_price=75)"
+            "test_data_row_variable": "item3",
+            "code": "item3 = Item(order_id=3, product_id=4, quantity=2, amount=220.00, unit_price=110.00)"
         },
         {
-            "test_data_row_variable": "test_product_4",
-            "code": "test_product_4 = Product(name='Product 4', unit_price=100)"
+            "test_data_row_variable": "item4",
+            "code": "item4 = Item(order_id=4, product_id=3, quantity=4, amount=300.00, unit_price=75.00)"
         }
     ],
-    "test_data_sqlite": "INSERT INTO customers (name, balance, credit_limit) VALUES ('Customer 1', 300, 1000);\nINSERT INTO customers (name, balance, credit_limit) VALUES ('Customer 2', 500, 750);\nINSERT INTO customers (name, balance, credit_limit) VALUES ('Customer 3', 0, 1500);\nINSERT INTO customers (name, balance, credit_limit) VALUES ('Customer 4', 200, 1200);\n\nINSERT INTO orders (customer_id, notes, date_shipped, amount_total) VALUES (1, 'Order 1 notes', NULL, 150);\nINSERT INTO orders (customer_id, notes, date_shipped, amount_total) VALUES (2, 'Order 2 notes', NULL, 0);\nINSERT INTO orders (customer_id, notes, date_shipped, amount_total) VALUES (2, 'Order 3 notes', NULL, 0);\nINSERT INTO orders (customer_id, notes, date_shipped, amount_total) VALUES (3, 'Order 4 notes', NULL, 150);\n\nINSERT INTO items (order_id, product_id, quantity, unit_price, amount) VALUES (1, 1, 3, 50, 150);\nINSERT INTO items (order_id, product_id, quantity, unit_price, amount) VALUES (2, 2, 2, 25, 0);\nINSERT INTO items (order_id, product_id, quantity, unit_price, amount) VALUES (3, 3, 1, 75, 0);\nINSERT INTO items (order_id, product_id, quantity, unit_price, amount) VALUES (4, 1, 3, 50, 150);\n\nINSERT INTO products (name, unit_price) VALUES ('Product 1', 50);\nINSERT INTO products (name, unit_price) VALUES ('Product 2', 25);\nINSERT INTO products (name, unit_price) VALUES ('Product 3', 75);\nINSERT INTO products (name, unit_price) VALUES ('Product 4', 100);",
-    "name": "OrderManagementSystem"
+    "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/graphics_templates/graphics_services.py

@@ -0,0 +1,41 @@
+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
+
+# Customize this file to add endpoints/services, using SQLAlchemy as required
+#     Separate from expose_api_models.py, to simplify merge if project rebuilt
+# Called by api_logic_server_run.py
+
+app_logger = logging.getLogger("api_logic_server_app")
+
+# called by api_logic_server_run.py, to customize api (new end points, services).
+# separate from expose_api_models.py, to simplify merge if project recreated
+
+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/html_template.jinja

@@ -0,0 +1,76 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Bar Chart Example</title>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+</head>
+<body>
+    <canvas id="myChart" width="400" height="200"></canvas>
+    <script>
+        // Input data
+        fetch('http://localhost:5656/api/GraphicsServices/{{ name }}', {
+            method: 'POST',
+            headers: {
+            'accept': 'application/vnd.api+json',
+            'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({}) // Add any required payload here
+        })
+            .then(response => {
+                if (!response.ok) {
+                    throw new Error(`HTTP error! status: ${response.status}`);
+                }
+                return response.json();
+            })
+            .then(result => {
+                const labels = [];
+                const data = [];
+                const type = result.meta.result.chart_type;
+                const title = result.meta.result.title;
+                const columns = result.meta.result.columns;
+                console.log(JSON.stringify(result));
+                result.meta.result.results.forEach(item => {
+                    labels.push(item[columns[0]]);
+                    data.push(parseFloat(item[columns[1]]));
+                });
+
+                // Create the bar chart
+                const ctx = document.getElementById('myChart').getContext('2d');
+                const myChart = new Chart(ctx, {
+                    type: type,
+                    data: {
+                    labels: labels,
+                    datasets: [{
+                        label: title,
+                        data: data,
+                        backgroundColor: 'rgba(75, 192, 192, 0.2)',
+                        borderColor: 'rgba(75, 192, 192, 1)',
+                        borderWidth: 1
+                    }]
+                    },
+                    options: {
+                    responsive: true,
+                    plugins: {
+                        legend: {
+                        position: 'top',
+                        },
+                        title: {
+                        display: true,
+                        text: title
+                        }
+                    },
+                    scales: {
+                        y: {
+                        beginAtZero: true
+                        }
+                    }
+                    }
+                });
+                })
+                .catch(error => console.error('Error fetching data:', error));
+
+    </script>
+</body>
+</html>

api_logic_server_cli/prototypes/manager/system/genai/graphics_templates/index.html

@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Sales by Region</title>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+</head>
+<body>
+    <h1>Sales by Region</h1>
+    <p>This page displays a bar chart of sales by region.</p>
+
+    <div style="display: flex; flex-direction: row; width: 50%; height: 100vh;">
+        <iframe id="iframeTarget1" src="http://localhost:5656/sales_by_region" style="flex: 1; border: none;"></iframe>
+    </div>
+
+    
+</html>

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

@@ -0,0 +1,63 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Sales by Region</title>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+    <style>
+        body {
+            margin: 0;
+            padding: 0;
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            height: 100%;
+            box-sizing: border-box;
+        }
+        canvas {
+            display: block;
+        }
+    </style>
+</head>
+<body>
+    <canvas id="salesChart" width="200" height="200"></canvas>
+    <script>
+        const labels = [];
+        const data = [];
+        result = {{ result | tojson }};
+        console.log(result);
+        const type = result.chart_type;
+        const title = result.title;
+        const columns = result.columns;
+        console.log(JSON.stringify(result));
+        result.results.forEach(item => {
+            labels.push(item[columns[0]]);
+            data.push(parseFloat(item[columns[1]]));
+        });
+        const ctx = document.getElementById('salesChart').getContext('2d');
+        const salesChart = new Chart(ctx, {
+            type: type,
+            data: {
+                labels: labels,
+                datasets: [{
+                    label: title,
+                    data: data,
+                    backgroundColor: 'rgba(75, 192, 192, 0.2)',
+                    borderColor: 'rgba(75, 192, 192, 1)',
+                    borderWidth: 1
+                }]
+            },
+            options: {
+                responsive: true,
+                maintainAspectRatio: false,
+                scales: {
+                    y: {
+                        beginAtZero: true
+                    }
+                }
+            }
+        });
+    </script>
+</body>
+</html>

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

@@ -0,0 +1,37 @@
+
+    @classmethod
+    @jsonapi_rpc(http_methods=['POST','GET', 'OPTIONS'])
+    def {{name}}(self, *args, **kwargs):
+        """        
+        Illustrates:
+        * Complex query with multiple joins, for graphics
+        * That Thomas is a duck.
+        
+        """
+        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 = ['RegionDescription', 'TotalSales']  # {{ xAxis }} {{ yAxis }}
+        results = [{columns[0]: row[0], columns[1]: str(Decimal(row[1]).quantize(Decimal('0.01')))} for row in results]
+        title = "Sales by Region" # {{ title }}
+        chart_type = 'bar' # {{ chart_type }}
+        json_results = {
+            "results": results,
+            "columns": columns,
+            "title": title,
+            "chart_type": "bar",
+            "xAxis": columns[0],
+            "yAxis": columns[1],
+        }
+        
+        return json_results 

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

@@ -0,0 +1,38 @@
+from flask import request, jsonify
+import logging
+import safrs
+from sqlalchemy.orm import aliased
+from sqlalchemy import extract, func
+from database.models import {{classes_used}}
+
+app_logger = logging.getLogger("api_logic_server_app")
+
+def add_service(app, api, project_dir, swagger_host: str, PORT: str, method_decorators = []):
+    pass
+
+    @app.route('/{{name}}, methods=["GET","OPTIONS"]')
+    def {{name}}():
+        """        
+        Illustrates:
+        * Complex query with multiple joins
+
+        Test it with:
+        
+                curl -X GET "http://localhost:5656/{{name}}"
+        
+        """
+        if request.method == 'OPTIONS':
+            return jsonify({ "result": "ok" })
+            
+        from api.api_discovery.graphics_services import GraphicsServices 
+        results = GraphicsServices.{{ name }}()
+        # Render the HTML template with the results
+        # Ensure the template is located in the "templates" directory relative to the project root.
+        from jinja2 import Environment, FileSystemLoader
+        from flask import Response
+        env = Environment(loader = FileSystemLoader('templates')) # create a templates folder in root path and add jinja files
+        template = env.get_template('{{ name }}.jinja')
+        output = template.render(result=results)
+        print(output)
+    
+        return output

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

@@ -0,0 +1,18 @@
+
+Create WGResult Graphics for prompts like 'graph sales by region'.
+    * use 'sales by region' to create a WGResult Graphic.sqlalchemy_query
+    * Be sure to use class names, not table names
+    * for example, using Northwind:
+        # SQLAlchemy query for Sales by Category
+        sales_by_category = (
+            session.query(
+                Category.CategoryName,
+                func.sum(OrderDetail.Quantity * OrderDetail.UnitPrice * (1 - OrderDetail.Discount)).label("TotalSales")
+            )
+            .join(Product, category.Id == Product.CategoryId)
+            .join(OrderDetail, Product.Id == OrderDetail.ProductId)
+            .join(Order, OrderDetail.OrderId == Order.Id)
+            .filter(Order.ShippedDate.isnot(None))  # Consider only shipped orders
+            .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/graphics_request.prompt

@@ -0,0 +1,5 @@
+You are a data modelling expert and python software architect who expands on user input ideas. 
+
+{{% include 'response_format.prompt' % }}
+
+{{% include 'graphics.prompt' % }}

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

@@ -17,10 +17,18 @@ class TestDataRow(BaseModel):
     test_data_row_variable: str  # the Python test data row variable
     code: str  # Python code to create a test data row instance
 
+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
+    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
     # response: str # result
     models : List[Model] # list of sqlalchemy classes in the response
     rules : List[Rule] # list rule declarations
+    graphics: List[Graphic] # list of Graphic objects
     test_data: str
     test_data_rows: List[TestDataRow]  # list of test data rows
     test_data_sqlite: str # test data as sqlite INSERT statements

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

@@ -6,4 +6,6 @@ Requirements:
 
 {{% include 'sqlite_inserts_model_test_hints.prompt' % }}
 
+{{% include 'graphics.prompt' % }}
+
 {{% include 'response_format.prompt' % }}

api_logic_server_cli/prototypes/manager/webgenai/docker-compose.yml

@@ -0,0 +1,27 @@
+# Run WebGenAI locally from docker container
+
+# cd webgenai
+
+# docker compose up
+# docker compose down
+
+name: webgenai
+services:
+    web_genai:
+        stdin_open: true
+        tty: true
+        container_name: webgenai
+        ports:
+            - 8282:80
+        volumes:
+            - ./webg_temp:/tmp
+            - ./webg_config:/config
+            - ./webg_projects:/opt/projects
+        image: apilogicserver/web_genai 
+        user: root
+        environment:
+            - APILOGICPROJECT_EXTERNAL_PORT=8282
+            - APILOGICPROJECT_PORT=5657
+            - APILOGICPROJECT_EXTERNAL_HOST=localhost
+            - GENAI_LOGIC_APIKEY=<paste license here from registration email>
+            - APILOGICSERVER_CHATGPT_APIKEY=<sk-proj-your-openai-key-here>