ApiLogicServer 15.2.3__py3-none-any.whl → 15.2.10__py3-none-any.whl

api_logic_server_cli/prototypes/basic_demo/customizations/logic/declare_logic.py

@@ -32,7 +32,23 @@ def declare_logic():
         from logic.logic_discovery.auto_discovery import discover_logic
         discover_logic()
 
-    # Logic from GenAI: (or, use your IDE w/ code completion)
+    # Logic from GenAI
+    '''
+    You can enter logic in 2 ways:
+        1. Using your IDE and code completion (Rule.)
+
+        2. Use your AI Assistant and enter logic in Natural Language, e.g.:
+            Create Business Logic for 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
+                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
+
+            Use case: App Integration
+                1. Send the Order to Kafka topic 'order_shipping' if the date_shipped is not None.
+    Also, using logic/logic_discovery is a Best Practice - see logic/readme_logic.md
+    '''
     from database.models import Product, Order, Item, Customer, SysEmail
 
     # Ensure the customer's balance is less than their credit limit

api_logic_server_cli/prototypes/basic_demo/readme.md

@@ -1,6 +1,7 @@
 ---
 title: Instant Microservices - with Logic and Security
 notes: gold is proto (-- doc); alert for apostrophe
+do_process_code_block_titles: True
 version: 0.23 from docsite, for readme 7/11/2025
 ---
 <style>
@@ -18,14 +19,19 @@ This illustrates basic [GenAI-Logic](https://www.genai-logic.com/product/key-fea
 2. Adding declarative logic and security, and 
 3. Customizing your project using your IDE and Python<br><br>
 
-> 🤖 **Bootstrap Copilot by pasting the following into the chat:**
-```
+**🤖 Two Ways to Explore:**
+
+* **Self-Paced:** Follow the sections below at your own speed
+* **AI-Guided Tour:** Say to Copilot: *"Guide me through basic_demo"*
+
+**Bootstrap Copilot:**
+```bash title='🤖 Bootstrap Copilot by pasting the following into the chat'
 Please find and read `.github/.copilot-instructions.md`.
 ```
 
 <br>
 
-The entire process takes 20 minutes; usage notes:
+The entire process takes 45 minutes; usage notes:
 
 * Important: look for **readme files** in created projects
 * You may find it more convenient to view this [in your Browser](https://apilogicserver.github.io/Docs/Sample-Basic-Tour)
@@ -152,9 +158,10 @@ And you are ready to Vibe:
 * Instead of creating data mockups, you have a **running API server with real data**
 * Instead of starting from scratch, you have a **running multi-page app** 
 * And, you'll have projects that are **architecturally correct:** shared logic, enforced in the server, available for both User Interfaces and services.
-* Then, use you favorite Vibe tools with your running API
+* Then, use you favorite Vibe tools with your running API:
 
 
+**Customize using Natural Language:**
 ```txt title='Customize using Natural Language'
 In the ui/react app, Update the Product list to provide users an option to see results in a list, or in cards.
 ```
@@ -294,7 +301,7 @@ Note that it's a `Multi-Table Transaction`, as indicated by the indentation.  Th
 
 **b. 40X More Concise**
 
-The 5 spreadsheet-like rules represent the same logic as 200 lines of code, [shown here](https://github.com/valhuber/LogicBank/wiki/by-code).  That's a remarkable 40X decrease in the backend half of the system.
+The 5 spreadsheet-like rules represent the same logic as 200 lines of code, [shown here](https://apilogicserver.github.io/Docs/https://github.com/ApiLogicServer/basic_demo/blob/main/logic/procedural/declarative-vs-procedural-comparison).  That's a remarkable 40X decrease in the backend half of the system.
 
 > 💡 No FrankenCode<br>Note the rules look like syntactically correct requirements.  They are not turned into piles of unmanageable "frankencode" - see [models not frankencode](https://www.genai-logic.com/faqs#h.3fe4qv21qtbs).
 
@@ -358,6 +365,7 @@ Or, use the command line.
 > Since the CLI does not pass an auth token, 
 you must first stop the server and disable security.
 
+**MCP from the command line:**
 ```bash title='MCP from the command line'
 python integration/mcp/mcp_client_executor.py mcp
 ```