ApiLogicServer 14.2.2__py3-none-any.whl → 14.3.0__py3-none-any.whl

api_logic_server_cli/prototypes/base/logic/logic_discovery/auto_discovery.py

@@ -23,18 +23,30 @@ def discover_logic():
                     spec.loader.exec_module(each_logic_file)  # runs "bare" module code (e.g., initialization)
                     each_logic_file.declare_logic()  # invoke create function
 
+    # if False and Path(__file__).parent.parent.parent.joinpath("docs/project_is_genai_demo.txt").exists():
+    #     return  # for genai_demo, logic is in logic/declare_logic.py (so ignore logic_discovery)
+    
     wg_logic_path = Path(__file__).parent.parent.joinpath("wg_rules")
-    for root, dirs, files in os.walk(wg_logic_path):
-        for file in files:
-            if file.endswith(".py"):
-                spec = importlib.util.spec_from_file_location("module.name", wg_logic_path.joinpath(file))
-                if file.endswith("auto_discovery.py"):
-                    pass
-                else:
-                    logic.append(file)
-                    each_logic_file = importlib.util.module_from_spec(spec)
-                    spec.loader.exec_module(each_logic_file)  # runs "bare" module code (e.g., initialization)
-                    each_logic_file.init_rule()  # invoke create function
+    if wg_logic_path.exists():
+        run_local = os.environ.get("WG_PROJECT") is None  # eg, running export locally
+        # run_local = False  # for debug
+        if run_local:  
+            wg_export_logic_path = Path(__file__).parent.parent.parent.joinpath("logic/wg_rules/active_rules_export.py") 
+            if wg_export_logic_path.is_file():
+                    spec = importlib.util.spec_from_file_location("module.name", wg_export_logic_path)
+                    logic.append(str(wg_export_logic_path))
+                    wg_export_logic_file = importlib.util.module_from_spec(spec)
+                    spec.loader.exec_module(wg_export_logic_file)  # runs "bare" module code (e.g., initialization)  
+                    wg_export_logic_file.declare_logic()  # invoke create function
+        else:
+            for root, dirs, files in os.walk(wg_logic_path):
+                for file in files:
+                    if file.endswith(".py") and 'active_rules_export.py' != file:
+                        spec = importlib.util.spec_from_file_location("module.name", wg_logic_path.joinpath(file))
+                        logic.append(file)
+                        each_logic_file = importlib.util.module_from_spec(spec)
+                        spec.loader.exec_module(each_logic_file)  # runs "bare" module code (e.g., initialization)
+                        each_logic_file.init_rule()  # invoke create function
 
     app_logger.info(f"..discovered logic: {logic}")
     return

api_logic_server_cli/prototypes/genai_demo/database/models.py

@@ -16,9 +16,9 @@ from sqlalchemy.ext.declarative import declarative_base
 # mypy: ignore-errors
 ########################################################################################################################
 
-from safrs import SAFRSBase
+from database.system.SAFRSBaseX import SAFRSBaseX, TestBase
 from flask_login import UserMixin
-import safrs, flask_sqlalchemy
+import safrs, flask_sqlalchemy, os
 from safrs import jsonapi_attr
 from flask_sqlalchemy import SQLAlchemy
 from sqlalchemy.orm import relationship
@@ -35,12 +35,16 @@ metadata = Base.metadata
 
 from sqlalchemy.dialects.sqlite import *
 
+if os.getenv('APILOGICPROJECT_NO_FLASK') is None or os.getenv('APILOGICPROJECT_NO_FLASK') == 'None':
+    Base = SAFRSBaseX   # enables rules to be used outside of Flask, e.g., test data loading
+else:
+    Base = TestBase     # ensure proper types, so rules work for data loading
+    print('*** Models.py Using TestBase ***')
 
 
-class Customer(SAFRSBase, Base):
+class Customer(Base):
     __tablename__ = 'Customers'
     _s_collection_name = 'Customer'  # type: ignore
-    __bind_key__ = 'None'
 
     CustomerID = Column(Integer, primary_key=True)
     CustomerName = Column(Text, nullable=False)
@@ -54,23 +58,10 @@ class Customer(SAFRSBase, Base):
     # child relationships (access children)
     OrderList : Mapped[List["Order"]] = relationship(back_populates="Customer")
 
-    @jsonapi_attr
-    def _check_sum_(self):  # type: ignore [no-redef]
-        return None if isinstance(self, flask_sqlalchemy.model.DefaultMeta) \
-            else self._check_sum_property if hasattr(self,"_check_sum_property") \
-                else None  # property does not exist during initialization
 
-    @_check_sum_.setter
-    def _check_sum_(self, value):  # type: ignore [no-redef]
-        self._check_sum_property = value
-
-    S_CheckSum = _check_sum_
-
-
-class Product(SAFRSBase, Base):
+class Product(Base):
     __tablename__ = 'Products'
     _s_collection_name = 'Product'  # type: ignore
-    __bind_key__ = 'None'
 
     ProductID = Column(Integer, primary_key=True)
     ProductName = Column(Text, nullable=False)
@@ -82,23 +73,11 @@ class Product(SAFRSBase, Base):
     # child relationships (access children)
     ItemList : Mapped[List["Item"]] = relationship(back_populates="Product")
 
-    @jsonapi_attr
-    def _check_sum_(self):  # type: ignore [no-redef]
-        return None if isinstance(self, flask_sqlalchemy.model.DefaultMeta) \
-            else self._check_sum_property if hasattr(self,"_check_sum_property") \
-                else None  # property does not exist during initialization
-
-    @_check_sum_.setter
-    def _check_sum_(self, value):  # type: ignore [no-redef]
-        self._check_sum_property = value
-
-    S_CheckSum = _check_sum_
 
 
-class Order(SAFRSBase, Base):
+class Order(Base):
     __tablename__ = 'Orders'
     _s_collection_name = 'Order'  # type: ignore
-    __bind_key__ = 'None'
 
     OrderID = Column(Integer, primary_key=True)
     CustomerID = Column(ForeignKey('Customers.CustomerID'))
@@ -113,23 +92,11 @@ class Order(SAFRSBase, Base):
     # child relationships (access children)
     ItemList : Mapped[List["Item"]] = relationship(back_populates="Order")
 
-    @jsonapi_attr
-    def _check_sum_(self):  # type: ignore [no-redef]
-        return None if isinstance(self, flask_sqlalchemy.model.DefaultMeta) \
-            else self._check_sum_property if hasattr(self,"_check_sum_property") \
-                else None  # property does not exist during initialization
 
-    @_check_sum_.setter
-    def _check_sum_(self, value):  # type: ignore [no-redef]
-        self._check_sum_property = value
 
-    S_CheckSum = _check_sum_
-
-
-class Item(SAFRSBase, Base):
+class Item(Base):
     __tablename__ = 'Items'
     _s_collection_name = 'Item'  # type: ignore
-    __bind_key__ = 'None'
 
     ItemID = Column(Integer, primary_key=True)
     OrderID = Column(ForeignKey('Orders.OrderID'))
@@ -144,14 +111,3 @@ class Item(SAFRSBase, Base):
 
     # child relationships (access children)
 
-    @jsonapi_attr
-    def _check_sum_(self):  # type: ignore [no-redef]
-        return None if isinstance(self, flask_sqlalchemy.model.DefaultMeta) \
-            else self._check_sum_property if hasattr(self,"_check_sum_property") \
-                else None  # property does not exist during initialization
-
-    @_check_sum_.setter
-    def _check_sum_(self, value):  # type: ignore [no-redef]
-        self._check_sum_property = value
-
-    S_CheckSum = _check_sum_

api_logic_server_cli/prototypes/genai_demo/logic/declare_logic.py

@@ -20,19 +20,16 @@ def declare_logic():
     ''' Declarative multi-table derivations and constraints, extensible with Python.
  
     Brief background: see readme_declare_logic.md
-    
-    Your Code Goes Here - Use code completion (Rule.) to declare rules
 
-    GenAI: Paste the following into Copilot Chat, and paste the result below.
+    GenAI: the following prompt was sent to GenAI-Logic, which translated it into the code below:
         
-    Use Logic Bank to enforce these requirements:
+    Use case: Check Credit 
     
-    Enforce the Check Credit requirement (do not generate check constraints):
-    1. Customer.Balance <= CreditLimit
-    2. Customer.Balance = Sum(Order.AmountTotal where date shipped is null)
-    3. Order.AmountTotal = Sum(Items.Amount)
-    4. Items.Amount = Quantity * UnitPrice
-    5. Store the Items.UnitPrice as a copy from Product.UnitPrice
+    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
+    3. The Order's amount_total is the sum of the Item amount
+    4. The Item amount is the quantity * unit_price
+    5. The Item unit_price is copied from the Product unit_price
     '''
 
     from logic_bank.logic_bank import Rule
@@ -40,39 +37,50 @@ def declare_logic():
     from logic.logic_discovery.auto_discovery import discover_logic
     discover_logic()
 
-    # Logic from GenAI: (or, use your IDE w/ code completion)n
+    # Logic from GenAI: (or, use your IDE w/ code completion)
+
+    # Ensures the customer's balance is less than the credit limit.
+    Rule.constraint(validate=Customer,
+                    as_condition=lambda row: row.Balance <= row.CreditLimit,
+                    error_msg="Customer balance ({row.Balance}) exceeds credit limit ({row.CreditLimit})")
+
+    # Computes the customer's balance as the sum of unshipped orders.
     Rule.sum(derive=Customer.Balance, as_sum_of=Order.AmountTotal, where=lambda row: row.ShipDate is None)
+
+    # Computes the total amount of an order as the sum of item amounts.
     Rule.sum(derive=Order.AmountTotal, as_sum_of=Item.Amount)
+
+    # Calculates the item amount as the quantity times unit price.  (original rule, prior to iteration)
     # Rule.formula(derive=Item.amount, as_expression=lambda row: row.quantity * row.unit_price)
+
+    # Copies the unit price from the parent product to the item.
     Rule.copy(derive=Item.UnitPrice, from_parent=Product.UnitPrice)
-    Rule.constraint(validate=Customer,
-                    as_condition=lambda row: row.Balance <= row.CreditLimit,
-                    error_msg="Customer balance ({row.balance}) exceeds credit limit ({row.credit_limit})")
 
     # End Logic from GenAI
 
+
+    #als: Demonstrate that logic == Rules + Python (for extensibility)
+
+    # 4. Items.Amount = Quantity * UnitPrice, altered with IDE for CarbonNeutral discount
     def derive_amount(row: Item, old_row: Item, logic_row: LogicRow):
         amount = row.Quantity * row.UnitPrice
         if row.Product.CarbonNeutral == True and row.Quantity >= 10:
            amount = amount * Decimal(0.9)  # breakpoint here
         return amount
-
-    # 4. Items.Amount = Quantity * UnitPrice
-    Rule.formula(derive=Item.Amount, calling=derive_amount)
-
-    #als: Demonstrate that logic == Rules + Python (for extensibility)
+    # now register function; note logic ordering is automatic
+    Rule.formula(derive=Item.Amount, calling=derive_amount)  
 
     def send_order_to_shipping(row: Order, old_row: Order, logic_row: LogicRow):
         """ #als: Send Kafka message formatted by OrderShipping RowDictMapper
 
         Format row per shipping requirements, and send (e.g., a message)
 
-        NB: the after_flush event makes Order.Id avaible.  Contrast to congratulate_sales_rep().
+        NB: the after_flush event makes Order.Id avaible.
 
         Args:
             row (Order): inserted Order
             old_row (Order): n/a
-            logic_row (LogicRow): bundles curr/old row, with ins/upd/dlt logic
+            logic_row (LogicRow): bundles curr/old row, with ins/upd/dlt (etc) state
         """
         if logic_row.is_inserted():
             kafka_producer.send_kafka_message(logic_row=logic_row,

api_logic_server_cli/prototypes/manager/.vscode/launch.json

@@ -5,7 +5,7 @@
     "version": "0.2.0",
     "configurations": [
         {
-            "name": "1. GENAI - Create a project from one of the system/genai/examples",
+            "name": "1. GENAI - Create genai_logic demo project",
             "type": "debugpy",
             "request": "launch",
             "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
@@ -18,8 +18,8 @@
                 "APILOGICSERVER_DEBUG": "False",
                 "OPT_LOCKING": "optional"},
             "justMyCode": false,
-            "args": [ "genai", "--retries=-1",
-                "--using=${workspaceFolder}/system/genai/examples/${input:inputGenaiProjectName}"],
+            "args": [ "genai", "--retries=-1", "--project-name=genai_demo",
+                "--using=${workspaceFolder}/system/genai/examples/genai_demo/genai_demo_informal.prompt"],
             "console": "internalConsole",
             "internalConsoleOptions": "openOnSessionStart"
         },

api_logic_server_cli/prototypes/manager/README.md

@@ -101,7 +101,7 @@ Then, try your own databases [(db-url examples here)](https://apilogicserver.git
 1. If you have signed up, this will create and open a project called `genai_demo` from `genai_demo.prompt` (available in left Explorer pane):
 
 ```bash
-als genai --using=system/genai/examples/genai_demo/genai_demo.prompt
+als genai --using=system/genai/examples/genai_demo/genai_demo.prompt --project-name=genai_demo
 ```
 
 
@@ -109,7 +109,7 @@ als genai --using=system/genai/examples/genai_demo/genai_demo.prompt
 
 
 ```bash
-als genai --using=genai_demo.prompt --repaired-response=system/genai/examples/genai_demo/genai_demo_iteration/005_create_db_models.response-example
+als genai --repaired-response=system/genai/examples/genai_demo/genai_demo_iteration/005_create_db_models.response-example --project-name=genai_demo
 ```
 
 Verify it's operating properly:
@@ -140,7 +140,7 @@ Verify it's operating properly:
 
 2. Your created project is opened in your IDE, ready to execute and customize.  
 
-    a. Review `Sample-Genai.md`, Explore Customizations.
+    a. Review `Tutorial.md`, Explore Customizations.
 
 ![GenAI Automation](system/images/genai.png)
 
@@ -149,9 +149,22 @@ Verify it's operating properly:
 
 <details markdown>
 
-<summary> You can iterate the data model and logic</summary>
+<summary> You can iterate the logic and data model</summary>
 
-<br>You can add new columns/tables, while keeping the prior model intact:
+<br>Logic iterations are particuarly useful.  For example, here we take the basic check-credit logic, and add:
+
+> Provide a 10% discount when buying more than 10 carbon neutral products.<br><br>The Item carbon neutral is copied from the Product carbon neutral
+
+Explore [genai_demo_iteration_discount](system/genai/examples/genai_demo/genai_demo_iteration_discount).  This will add carbon_neutral to the data model, and update the logic to provide the discount:
+
+```bash title='Iterate Business Logic'
+# Iterate with data model and logic
+als genai --project-name='genai_demo_with_logic' --using=system/genai/examples/genai_demo/genai_demo_iteration
+# open Docs/db.dbml
+```
+<br>
+
+You can add new columns/tables, while keeping the prior model intact:
 
 ```bash title='Iterate Without Logic'
 # Step 1 - create without logic
@@ -164,7 +177,9 @@ als genai --project-name='genai_demo_no_logic' --using=system/genai/examples/gen
 als genai --project-name='genai_demo_with_logic' --using=system/genai/examples/genai_demo/genai_demo_iteration
 # open Docs/db.dbml
 ```
-> Explore [genai_demo_iteration](system/genai/examples/genai_demo/genai_demo_iteration) - observe the `--using` is a *directory* of prompts.  These include the prompts from the first example, plus an *iteration prompt* (`004_iteration_renames_logic.prompt`) to rename tables and add logic.
+
+Explore [genai_demo_iteration](system/genai/examples/genai_demo/genai_demo_iteration) - observe the `--using` is a *directory* of prompts.  These include the prompts from the first example, plus an *iteration prompt* (`004_iteration_renames_logic.prompt`) to rename tables and add logic.
+
 
 </details>
 </br>
@@ -274,7 +289,7 @@ After starting the [Manager](https://apilogicserver.github.io/Docs/Manager):
 
 ```bash title="0. Create Project Requiring Fixup"
 # 0. Create a project requiring fixup
-als genai --using=genai_demo.prompt --repaired-response=system/genai/examples/genai_demo/genai_demo_fixup_required.json --project-name=genai_demo_fixup_required
+als genai --repaired-response=system/genai/examples/genai_demo/genai_demo_fixup_required.json --project-name=genai_demo_fixup_required
 ```
 
 If you run this project, you will observe that it fails with:
@@ -298,7 +313,7 @@ Finally, use the created [fixup files](genai_demo_fixup_required/docs/fixup/) to
 ```bash title="2. Rebuild the project from the fixup response data model"
 # 2. Rebuild the project from the fixup response data model
 cd ../
-als genai --using=genai_demo.prompt --repaired-response=genai_demo_fixup_required/docs/fixup/response_fixup.json --project-name=fixed_project
+als genai --repaired-response=genai_demo_fixup_required/docs/fixup/response_fixup.json --project-name=fixed_project
 ```
     
 &nbsp;
@@ -390,7 +405,7 @@ als create --project-name=genai_demo --from-model=system/genai/temp/create_db_mo
 Or, correct the chatgpt response, and
 
 ```bash
-als genai --using=genai_demo.prompt --repaired-response=system/genai/examples/genai_demo/genai_demo.response_example --project-name=genai_demo
+als genai --repaired-response=system/genai/examples/genai_demo/genai_demo.response_example --project-name=genai_demo
 ```
 
 We have seen failures such as:
@@ -583,7 +598,7 @@ als genai --using=system/genai/examples/genai_demo/genai_demo.prompt
 
 # Or, Microservice Automation from Saved Response
 # Admin App, API, Project
-als genai --using=genai_demo.prompt --repaired-response=system/genai/temp/chatgpt_retry.response
+als genai --repaired-response=system/genai/temp/chatgpt_retry.response
 
 # Logic and Security
 #   - see logic (logic/declare_logic.py, logic/cocktail-napkin.jpg);  add an Order and Item

api_logic_server_cli/prototypes/manager/system/genai/create_db_models_inserts/create_db_models_imports.py

@@ -7,6 +7,7 @@ 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 *

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

@@ -2,62 +2,63 @@
     "models": [
         {
             "classname": "Customer",
-            "code": "class Customer(Base):\n    __tablename__ = 'customers'\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    name = Column(String, nullable=False)\n    balance = Column(Integer, default=0)\n    credit_limit = Column(Integer, nullable=False)\n\n    def __repr__(self):\n        return f\"Customer(id={self.id}, name='{self.name}', balance={self.balance}, credit_limit={self.credit_limit})\"",
-            "sqlite_create": "CREATE TABLE customers (\n    id INTEGER PRIMARY KEY AUTOINCREMENT, \n    name VARCHAR NOT NULL, \n    balance INTEGER DEFAULT 0, \n    credit_limit INTEGER NOT NULL\n)",
-            "description": "description: Customers table",
-            "name": "customers"
+            "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.",
+            "name": "Customer"
         },
         {
             "classname": "Order",
-            "code": "class Order(Base):\n    __tablename__ = 'orders'\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    customer_id = Column(Integer, ForeignKey('customers.id'))\n    notes = Column(String)\n    date_shipped = Column(Date)\n    amount_total = Column(Integer, default=0)\n\n    def __repr__(self):\n        return f\"Order(id={self.id}, customer_id={self.customer_id}, notes='{self.notes}', amount_total={self.amount_total}, date_shipped={self.date_shipped})\"",
-            "sqlite_create": "CREATE TABLE orders (\n    id INTEGER PRIMARY KEY AUTOINCREMENT, \n    customer_id INTEGER, \n    notes VARCHAR, \n    date_shipped DATE, \n    amount_total INTEGER DEFAULT 0, \n    FOREIGN KEY(customer_id) REFERENCES customers (id)\n)",
-            "description": "description: Orders table",
-            "name": "orders"
+            "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.",
+            "name": "Order"
         },
         {
             "classname": "Item",
-            "code": "class Item(Base):\n    __tablename__ = 'items'\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    order_id = Column(Integer, ForeignKey('orders.id'))\n    product_id = Column(Integer, ForeignKey('products.id'))\n    quantity = Column(Integer, nullable=False)\n    unit_price = Column(Integer, nullable=False)\n    amount = Column(Integer, default=0)\n\n    def __repr__(self):\n        return f\"Item(id={self.id}, order_id={self.order_id}, product_id={self.product_id}, quantity={self.quantity}, unit_price={self.unit_price}, amount={self.amount})\"",
-            "sqlite_create": "CREATE TABLE items (\n    id INTEGER PRIMARY KEY AUTOINCREMENT, \n    order_id INTEGER, \n    product_id INTEGER, \n    quantity INTEGER NOT NULL, \n    unit_price INTEGER NOT NULL, \n    amount INTEGER DEFAULT 0, \n    FOREIGN KEY(order_id) REFERENCES orders (id), \n    FOREIGN KEY(product_id) REFERENCES products (id)\n)",
-            "description": "description: Items table",
-            "name": "items"
+            "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.",
+            "name": "Item"
         },
         {
             "classname": "Product",
-            "code": "class Product(Base):\n    __tablename__ = 'products'\n    id = Column(Integer, primary_key=True, autoincrement=True)\n    name = Column(String, nullable=False)\n    unit_price = Column(Integer, nullable=False)\n\n    def __repr__(self):\n        return f\"Product(id={self.id}, name='{self.name}', unit_price={self.unit_price})\"",
-            "sqlite_create": "CREATE TABLE products (\n    id INTEGER PRIMARY KEY AUTOINCREMENT, \n    name VARCHAR NOT NULL, \n    unit_price INTEGER NOT NULL\n)",
-            "description": "description: Products table",
-            "name": "products"
+            "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.",
+            "name": "Product"
         }
     ],
     "rules": [
         {
             "name": "Customer Balance Constraint",
-            "description": "Ensures the customer's balance does not exceed the credit limit.",
+            "description": "Ensures the customer's balance is aligned with the credit limit.",
             "use_case": "Customer.balance <= credit_limit",
-            "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})\")"
+            "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 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)",
+            "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)",
+            "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",
+            "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",
+            "entity": "Item",
             "code": "Rule.copy(derive=Item.unit_price, from_parent=Product.unit_price)"
         }
     ],

api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_iteration_discount/000_you_are.prompt

@@ -0,0 +1 @@
+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