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

api_logic_server_cli/prototypes/basic_demo/iteration/ui/admin/admin.yaml

@@ -1,105 +1,180 @@
 about:
-  date: November 07, 2023 19:47:04
+  date: May 13, 2025 20:12:31
   merged:
-    at: November 07, 2023 19:48:02
-    new_attributes: 'Product.CarbonNeutral '
-    new_resources: ''
-    new_tab_groups: ''
+    at: May 13, 2025 20:15:21
+    new_attributes: 'Customer.email Order.CreatedOn '
+    new_resources: 'Email '
+    new_tab_groups: 'Customer.EmailList '
   recent_changes: works with modified safrs-react-admin
   version: 0.0.0
 api_root: '{http_type}://{swagger_host}:{port}/{api}'
-authentication:
-  endpoint: '{http_type}://{swagger_host}:{port}/api/auth/login'
+authentication: '{system-default}'
 info:
-  number_relationships: 3
-  number_tables: 4
+  number_relationships: 4
+  number_tables: 5
+info_toggle_checked: true
 resources:
   Customer:
     attributes:
-    - label: ' Name*'
-      name: Name
-      required: true
+    - label: ' name*'
+      name: name
       search: true
       sort: true
-    - name: Balance
-    - name: CreditLimit
-    - name: Region
-    - name: ContactName
-    - name: CustomerID
+    - name: balance
+      type: DECIMAL
+    - name: credit_limit
+      type: DECIMAL
+    - name: id
+    - name: email
+    - name: email_opt_out
+      type: BOOLEAN
+    description: Defines the Customer entity with a unique name, balance, and credit
+      limit.
+    info_list: Defines the Customer entity with a unique name, balance, and credit
+      limit.    
     tab_groups:
     - direction: tomany
       fks:
-      - CustomerID
+      - customer_id
       name: OrderList
       resource: Order
+    - direction: tomany
+      fks:
+      - customer_id
+      name: EmailList
+      resource: Email
     type: Customer
-    user_key: Name
+    user_key: name
+  Email:
+    attributes:
+    - label: ' id*'
+      name: id
+      search: true
+      sort: true
+    - name: customer_id
+      required: true
+    - name: message
+    - name: CreatedOn
+      type: DATE
+    tab_groups:
+    - direction: toone
+      fks:
+      - customer_id
+      name: customer
+      resource: Customer
+    type: Email
+    user_key: id
   Item:
     attributes:
-    - label: ' Item I D*'
-      name: ItemID
+    - label: ' id*'
+      name: id
       search: true
       sort: true
-    - name: OrderID
-    - name: ProductID
-    - name: Quantity
-    - name: Amount
-    - name: UnitPrice
+    - name: order_id
+    - name: product_id
+      required: true
+    - name: quantity
+      required: true
+    - name: amount
+      type: DECIMAL
+    - name: unit_price
+      type: DECIMAL
+    description: Defines the Item entity with quantity, amounts, and unit price details.
+    info_list: Defines the Item entity with quantity, amounts, and unit price details.
     tab_groups:
     - direction: toone
       fks:
-      - OrderID
-      name: Order
+      - order_id
+      name: order
       resource: Order
     - direction: toone
       fks:
-      - ProductID
-      name: Product
+      - product_id
+      name: product
       resource: Product
     type: Item
-    user_key: ItemID
+    user_key: id
   Order:
     attributes:
-    - label: ' Order I D*'
-      name: OrderID
+    - label: ' id*'
+      name: id
       search: true
       sort: true
-    - name: CustomerID
-    - name: AmountTotal
-    - name: ShipDate
+    - name: customer_id
+      required: true
+    - name: notes
+    - name: amount_total
+      type: DECIMAL
+    - name: date_shipped
       type: DATE
-    - name: Notes
+    - name: CreatedOn
+      type: DATE
+    description: Defines the Order entity which belongs to a customer. Includes notes
+      and amount total.
+    info_list: Defines the Order entity which belongs to a customer. Includes notes
+      and amount total.
     tab_groups:
     - direction: tomany
       fks:
-      - OrderID
+      - order_id
       name: ItemList
       resource: Item
     - direction: toone
       fks:
-      - CustomerID
-      name: Customer
+      - customer_id
+      name: customer
       resource: Customer
     type: Order
-    user_key: OrderID
+    user_key: id
   Product:
     attributes:
-    - label: ' Name*'
-      name: Name
-      required: true
+    - label: ' name*'
+      name: name
       search: true
       sort: true
-    - name: UnitPrice
-    - name: ProductID
-    - name: CarbonNeutral
+    - name: unit_price
+      type: DECIMAL
+    - name: carbon_neutral
+      type: BOOLEAN
+    - name: id
+    description: Defines the Product entity with a unique name and unit price.
+    info_list: Defines the Product entity with a unique name and unit price.
     tab_groups:
     - direction: tomany
       fks:
-      - ProductID
+      - product_id
       name: ItemList
       resource: Item
     type: Product
-    user_key: Name
+    user_key: name
 settings:
-  HomeJS: http://localhost:5656/admin-app/home.js
+  HomeJS: /admin-app/home.js
   max_list_columns: 8
+  style_guide:
+    applicationLocales:
+    - en
+    - es
+    currency_symbol: $
+    currency_symbol_position: left
+    date_format: LL
+    decimal_max: '1000000000'
+    decimal_min: '2'
+    decimal_separator: .
+    detail_mode: tab
+    edit_on_mode: dblclick
+    exclude_listpicker: false
+    include_translation: 'false'
+    keycloak_client_id: alsclient
+    keycloak_realm: kcals
+    keycloak_url: http://localhost:8080
+    locale: en
+    max_decimal_digits: '4'
+    min_decimal_digits: '2'
+    new_mode: dialog
+    pick_style: list
+    row_height: small,
+    serviceType: JSONAPI
+    startSessionPath: /auth/login
+    style: light
+    thousand_separator: ','
+    use_keycloak: 'false'

api_logic_server_cli/prototypes/genai_demo/ui/admin/admin.yaml

@@ -135,7 +135,7 @@ settings:
     new_mode: dialog
     pick_style: list
     row_height: small,
-    serviceType: OntimizeEE
+    serviceType: JSONAPI
     startSessionPath: /auth/login
     style: light
     thousand_separator: ','

api_logic_server_cli/prototypes/manager/README.md

@@ -79,6 +79,10 @@ Created projects use standard Flask and SQLAlchemy; automation is provided by Lo
 als create --project-name=basic_demo --db-url=basic_demo
 ```
 
+<br>The self-demo provides:
+1. A quick look at logic, security and integration
+2. Integration includes Kafka and MCP (**[Model Context Protocol](https://apilogicserver.github.io/Docs/Integration-MCP/)**)
+
 <br>To create a larger project, try the pre-installed [**northwind database**](https://apilogicserver.github.io/Docs/Tutorial/) (imagine your own database here):
 
 ```
@@ -165,20 +169,28 @@ Verify it's operating properly:
 
 <summary> You can iterate the logic and data model</summary>
 
-<br>Logic iterations are particuarly useful.  For example, here we take the basic check-credit logic, and add:
+<br>The approach for an iteration is to create a new project from an existing one:
+
+1. add another prompt to an existing projects `docs` directory, specifying your changes
+2. use `als genai`, specifying 
+    * `--using` existing projects `docs` directory, and 
+    * `--project-name` as the output project
+ 
+ **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:
+Explore [genai_demo_iteration_discount](system/genai/examples/genai_demo/genai_demo_iteration_discount).  It's an iteration of basic_demo (see system/genai/examples/genai_demo/genai_demo_iteration_discount/002_create_db_models.prompt).  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
+als genai --project-name='genai_demo_with_discount' --using=system/genai/examples/genai_demo/genai_demo_iteration_discount
 # open Docs/db.dbml
 ```
+
 <br>
 
-You can add new columns/tables, while keeping the prior model intact:
+You can perform **model iterations:** add new columns/tables, while keeping the prior model intact.  First, we create a project with no logic, perhaps just to see the screens (this step is optional, provided just to illustrate that iterations create new projects from existing ones):
 
 ```bash title='Iterate Without Logic'
 # Step 1 - create without logic
@@ -186,6 +198,8 @@ als genai --project-name='genai_demo_no_logic' --using=system/genai/examples/gen
 # open Docs/db.dbml
 ```
 
+Then, we would create another prompt in the docs directory with our model changes. We've already created these for you in `system/genai/examples/genai_demo/genai_demo_iteration` - we use that to alter the data model (see `system/genai/examples/genai_demo/genai_demo_iteration/004_iteration_renames_logic.prompt`):
+
 ```bash title='Iterate With Logic'
 # Iterate with data model and logic
 als genai --project-name='genai_demo_with_logic' --using=system/genai/examples/genai_demo/genai_demo_iteration
@@ -502,6 +516,18 @@ als create --project-name=sample_ai --from-model=sample_ai.py --db-url=sqlite
 
 4. This will create your database, create an API Logic Project from it, and launch your IDE.
 
+5. Create business logic
+
+    * You can create logic with either your IDE (and code completion), or Natural Language
+    * To use Natural Language:
+
+        1. Use the CoPilot chat,
+        2. Paste the logic above
+        3. Copy it to `logic/declare_logic.py` after `discover_logic()`
+        
+            * Alert:  Table and Column Names may require correction to conform to the model
+            * Alert: you may to apply [defaulting](https://apilogicserver.github.io/Docs/Logic-Use/#insert-defaulting), and initialize derived attributes in your database
+
 </details>
 </br>