ApiLogicServer 16.1.3__py3-none-any.whl → 16.1.18__py3-none-any.whl

api_logic_server_cli/prototypes/base/.github/welcome.md

@@ -1,22 +1,36 @@
 ---
-use: welcome for GenAI-Logic Projects
+use: Standard welcome for GenAI-Logic Projects
+note: Edit this for a project-specific Copilot welcome
 ---
 
-## Welcome to the `basic_demo` project
+## Welcome to Your GenAI-Logic Project
 
-This is a complete, working microservice auto-generated from a database schema - **uncustomized**, so you can see what to expect when you create projects from your own databases.
+This is a complete, working microservice auto-generated from a database schema.
 
-Created from database schema introspection:
+**What's been created:**
 - **Admin Web Application** - Live at `http://localhost:5656`
-- **REST API Endpoints** - All database tables exposed at MCP discoverable `/api/*`
+- **REST API Endpoints** - All database tables exposed at `/api/*`
 - **Database Models** - Complete SQLAlchemy ORM in `database/models.py`
-- **Authentication System** - JWT-based auth framework
-- **Business Logic Engine** - Declarative rules system
+- **Authentication System** - JWT-based auth framework ready to configure
+- **Business Logic Engine** - Declarative rules system in `logic/declare_logic.py`
 
 ---
 
-To start your application, ***Press F5***
+**To start your application:** ***Press F5***
 
 ---
 
-Ask ***'show me what you can help me with'*** for a list of services I can provide.
+**What can I help you with?**
+
+Ask me to ***'show me what you can help me with'*** for a complete list of services, or jump right in:
+
+1. **Add business logic** - Translate requirements into declarative rules
+2. **Configure security** - Set up role-based access control (RBAC)
+3. **Customize the Admin UI** - Edit `ui/admin/admin.yaml`
+4. **Create custom API endpoints** - Add routes in `api/customize_api.py`
+5. **Build React apps** - Generate custom UIs with `genai-logic genai-add-app`
+6. **Add automated tests** - Create Behave scenarios for requirements traceability
+7. **Integrate with other systems** - Add Kafka events, webhooks, or B2B APIs
+8. **Understand the architecture** - Explore what was auto-generated and why
+
+Ready to customize your project?

api_logic_server_cli/prototypes/base/docs/training/{logic_bank_api.prompt → logic_bank_api.md}

@@ -1,15 +1,73 @@
 ---
 # LogicBank API Reference
-# Version: 1.0.1
-# Last Updated: November 17, 2025
+# Version: 1.0.3
+# Last Updated: January 29, 2026
 # Description: The Logic Rosetta Stone: simplified API for creating declarative business logic rules
 ---
 
+=============================================================================
+💎 CORE PRINCIPLE: Path-Independent Rules = Automatic Reuse
+=============================================================================
+
+**What you're really doing:** Distilling path-independent rules from path-dependent logic.
+
+**Path-dependent (procedural):** Separate code for each execution path
+- Add item → recalc amounts
+- Change quantity → recalc amounts  
+- Change customer → adjust both balances
+- Ship order → adjust balance
+- Delete item → recalc amounts
+
+**Path-independent (declarative):** ONE rule works for ALL paths
+```python
+Rule.sum(derive=models.Customer.balance, as_sum_of=models.Order.amount_total, where=lambda row: row.date_shipped is None)
+```
+
+**Automatic reuse over use cases:** Whereas reuse is typically a high-order design skill, declarative rules provide *automatic reuse* - write the relationship once, it works for insert/update/delete/parent changes. No use case explosion.
+
+=============================================================================
+
 Here is the simplified API for LogicBank:
 
 PREREQUISITE: For general patterns (event handler signatures, logging, request pattern, anti-patterns),
 see docs/training/logic_bank_patterns.prompt
 
+=============================================================================
+🗂️ CRITICAL: Directory Structure = Requirements Traceability
+=============================================================================
+
+**Pattern Recognition:**
+- Context phrases ("When X", "For Y", "On Z") → directory: logic/logic_discovery/x/
+- After context, each colon-terminated phrase → file: phrase.py
+- Prefixes like "Use case:", "Requirement:" are optional (just noise words)
+- No context phrase → single file (flat structure OK)
+
+**Naming:** Convert to snake_case, remove articles
+- "When Placing Orders" / "On Placing Orders" → place_order/
+- "Check Credit:" → check_credit.py
+- "Use case: App Integration:" → app_integration.py
+
+**Requirements Traceability:** File structure provides direct link from use case to implementation
+```
+Prompt: "On Placing Orders, Check Credit: ..."
+Result: logic/logic_discovery/place_order/check_credit.py
+Trace:  Use Case Name → File Path → Rules → Logic Report
+```
+
+**Examples:**
+```
+Prompt: "When Placing Orders, Check Credit: ... App Integration: ..."
+Result: logic/logic_discovery/place_order/{__init__.py, check_credit.py, app_integration.py}
+
+Prompt: "For Customer Management, Validate Credit: ... Calculate Loyalty: ..."
+Result: logic/logic_discovery/customer_management/{__init__.py, validate_credit.py, calculate_loyalty.py}
+
+Prompt: "Check Credit: ..." (no context)
+Result: logic/logic_discovery/check_credit.py (flat)
+```
+
+=============================================================================
+
 Translate the user prompt into a series of calls to Rule methods, described here.
 
 Do not generate import statements.
@@ -360,5 +418,68 @@ RIGHT (do this instead):
                                if_condition=lambda row: row.date_shipped is not None,
                                with_args={"topic": "order_shipping"})
 
-logic should create python files in logic/logic_discovery, 
-and cross-check/use attribute names in database/models.py
+=============================================================================
+🗂️ FILE ORGANIZATION: Complete Example with Directory Structure
+=============================================================================
+
+When given a prompt with context phrase and multiple use cases, create organized structure:
+
+Example Prompt:
+```
+When Placing Orders, implement Requirement: 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 Product count_suppliers is the sum of the Product Suppliers
+6. Item unit_price copied from the Product
+
+Use case: App Integration
+
+1. Send the Order to Kafka topic 'order_shipping' if the date_shipped is not None.
+```
+
+Response Structure:
+```
+logic/logic_discovery/
+  place_order/
+    __init__.py
+    check_credit.py
+    app_integration.py
+```
+
+File: logic/logic_discovery/place_order/__init__.py
+```python
+# Empty file - makes this a Python package for auto-discovery
+```
+
+File: logic/logic_discovery/place_order/check_credit.py
+```python
+"""
+Check Credit Use Case - Business Logic Rules
+
+Natural Language Requirements:
+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 Product count_suppliers is the sum of the Product Suppliers
+6. Item unit_price copied from the Product
+
+version: 1.0
+date: [Current Date]
+"""
+
+from logic_bank.logic_bank import Rule
+from database import models
+
+
+def declare_logic():
+    """Business logic rules for Check Credit use case."""
+    
+    Rule.sum(derive=models.Customer.balance, as_sum_of=models.Order.amount_total, where=lambda row: row.date_shipped is None)
+    Rule.sum(derive=models.Order.amount_total, as_sum_of=models.Item.amount)
+    Rule.formula(derive=models.Item.amount, as_expression=lambda row: row.quantity * row.unit_price)
+    Rule.copy(derive=models.Item.unit_price, from_parent=models.Product.unit_price)
+    Rule.count(derive=models.Product.count_suppliers, as_count_of=models.ProductSupplier)

api_logic_server_cli/prototypes/base/logic/logic_discovery/readme_logic_discovery.md

@@ -4,6 +4,21 @@ but that can lead to a lot of rules in 1 file.
 A *best practice* is to create logic files in this directory,
 named after the use case (e.g., `check_credit.py`).  
 
+## Organizing Related Use Cases
+
+For complex scenarios with multiple related use cases, you can organize them hierarchically:
+
+- **Flat structure** (simple cases): `check_credit.py`, `validate_order.py`
+- **Hierarchical structure** (complex workflows): 
+  - `place_order/check_credit.py` - Credit validation for order placement
+  - `place_order/app_integration.py` - External integrations for order placement
+  - `ship_order/validate_inventory.py` - Inventory checks for shipping
+
+**When to use hierarchical structure:**
+- The prompt describes a parent use case with sub-cases (e.g., "On Placing Orders, Check Credit:")
+- Multiple related operations share a common workflow (e.g., order placement, customer onboarding)
+- You want to group related logic files for better organization
+
 The easiest way to to copy/paste `use_case.py` to a new file, then
 add your logic either by Natural Language (use your Coding Assistant, such as CoPilot),
 or your IDE's code completion.

api_logic_server_cli/prototypes/base/logic/readme_logic.md

@@ -15,7 +15,7 @@ This describes how to use Logic; for more information, [see here](https://apilog
 You can provide prompts like this to CoPilot.  This is a good approach for new users:
 
 ```text title="Declare Logic in Natural Language"
-Create Business Logic for Use Case = Check Credit:  
+Create Business Logic for on Placing Orders, 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

api_logic_server_cli/prototypes/manager/.github/welcome.md

@@ -12,32 +12,36 @@ Welcome! This is the **Project Manager** - your workspace for creating and manag
 
 ## Getting Started
 
-**If you're new here**, start with the 20-minute basic_demo tutorial - it's the best way to see what GenAI-Logic can do:
-
-```bash
-genai-logic create --project_name=basic_demo --db_url=basic_demo
-```
-
-After it runs, the project will auto-open with its own README and I'll guide you through a hands-on tour.
-
----
-
 **If you're returning**, here's what I can help you with:
 
 **Creating New Projects:**
+
 1. **Create from existing database** - Generate project from your database schema
 2. **Create with GenAI** - Describe database + logic in natural language, get complete working system
 3. **Create manually** - I'll help you design and build a database, then generate the project
 
 **Working with Existing Projects:**
+
 4. **Guide through basic_demo** - Take the interactive 30-45 min hands-on tour
 5. **Customize projects** - Add logic, security, custom APIs, React apps, tests
 6. **Review project structure** - Understand what was auto-generated
 7. **Debug issues** - Help troubleshoot problems in your projects
 
 **Learning & Examples:**
+
 8. **Explore sample databases** - See what's in `samples/dbs/`
 9. **Review GenAI examples** - Learn from `system/genai/examples/`
 10. **Understand architecture** - Explain how the system works
 
+---
+
+**If you're new here**, start with the 20-minute basic_demo tutorial - it's the best way to see what GenAI-Logic can do:
+
+```bash
+genai-logic create --project_name=basic_demo --db_url=basic_demo
+```
+
+After it runs, the project will auto-open with its own README and I'll guide you through a hands-on tour.
+
+
 **What would you like to work on?**

api_logic_server_cli/prototypes/manager/readme_vibe.md

@@ -0,0 +1,376 @@
+---
+title: Vibe MCP / Microservice
+do_process_code_block_titles: True
+version: 1.1 from docsite, for readme 10/28/2025
+Propagation: Build copies to api_logic_server_cli/prototypes/basic_demo/readme_vibe → BLT copies to Manager samples/basic_demo_sample/readme_vibe
+Guided_Tour: See tutor for AI guided tour instructions (user says "Guide me through basic_demo")
+---
+<style>
+  -typeset h1,
+  -content__button {
+    display: none;
+  }
+</style>
+
+# Vibe an MCP Microservice
+
+This illustrates [GenAI-Logic](https://apilogicserver.github.io/Docs/Sample-Basic-Demo-Vibe) automation to create an MCP system using **Vibe:** 
+> **1) Natural Language**, **2) Declarative** (*what not now*), **3) Trusted error correction** with the coding assistant
+
+<br>
+
+**🤖 Bootstrap Copilot by pasting the following into the chat:**
+``` bash title='🤖 Bootstrap Copilot by pasting the following into the chat'
+Please load `.github/.copilot-instructions.md`
+```
+
+> **Important:** be sure CoPilot is in "Agent" Mode.  "Ask" will not work.  Also, we get consistently good results with `Claude Sonnet 4.5`.
+
+<br>
+
+**How to Use This Demo:**
+
+This demo teaches AI-assisted development patterns. Each step is a **natural language prompt** you copy/paste into Copilot chat. The prompts are self-documenting - they explain what they do.
+
+**Vibe Philosophy:** AI makes errors. That's expected. When something fails, tell Copilot: *"Error X occurred, fix it"*. Copilot is exceptionally good at finding and correcting its own mistakes.
+
+**Recommended Path:** If you're new to GenAI-Logic, start with the [Standard Demo](https://apilogicserver.github.io/Docs/Sample-Basic-Demo) (creates `basic_demo` with guided tutor) to learn platform fundamentals. Then return here to explore AI-assisted development with `basic_demo_vibe`.
+
+<br>
+
+<details markdown>
+
+<summary>Demo Overview: Vibe an MCP API, Custom Client and Business Logic; pre-reqs </summary>
+
+<br>Here we will use Vibe to:
+
+1. **[Create From Existing DB](#1-create-from-existing-db)** - Provides a MCP-enabled API and an Admin App
+   - [Project Opens: Run](#1a-project-opens-run) - Launch and verify your system
+
+2. **[Custom UI: GenAI, Vibe](#2-custom-ui-genai-vibe)** - Create a custom (React) client
+
+3. **[Declare Business Logic](#3-declare-business-logic)** - Add rules with natural language
+
+4. **[Enterprise Connectivity: B2B](#4-enterprise-connectivity-b2b)** - Create integration endpoints
+
+5. **[MCP: Logic, User Interface](#5-mcp-logic-user-interface)** - Implement Model Context Protocol
+
+6. **[Iterate: Rules and Python](#6-iterate-rules-and-python)** - Advanced customization patterns<br><br>
+
+Pre-reqs:
+
+1. Install
+2. OpenAI API Key is useful but not required; [click here](WebGenAI-CLI#configuration).
+
+  * The React App has pre-built apps (`ui/my-react-app`) you can use; they require `npm install; npm start`
+  * The `integration/mcp/mcp_client_executor.py` has `create_tool_context_from_llm` set to bypass LLM calls and use saved context; alter as required.
+3. NodeJS to run the react app
+
+The entire process takes 20 minutes; usage notes:
+
+* Most find it **more convenient** to view this in your Browser; [click here](https://apilogicserver.github.io/Docs/Sample-Basic-Tour)
+* A slide show summary is available [on our Web Site](https://www.genai-logic.com/product/tour)
+* Tip: look for **readme files** in created projects
+
+![product-tour](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/basic_demo/product-tour.png?raw=true)
+
+</details>
+
+<br>
+
+## 1. Create From Existing DB
+
+**Create a project from an existing database (open the disclosure box for details):**
+```bash title="Create a project from an existing database (open the disclosure box for details)"
+Create a database project named basic_demo_vibe from samples/dbs/basic_demo.sqlite
+```
+
+<details markdown>
+
+<summary> The database is Customer, Orders, Items and Product; you can also create the database</summary>
+
+![existing database](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/vscode/vibe/create-project.png?raw=true)
+
+**Or, create a *new* database** with this prompt:
+```bash
+Create a system with customers, orders, items and products.
+
+Include a notes field for orders.
+
+on Placing Orders, 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.
+```
+
+<br>
+
+In either case, the database model is customer, orders and items:
+
+![basic_demo_data_model](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/basic_demo/basic_demo_data_model.jpeg?raw=true)
+
+</details>
+
+&nbsp;
+
+### 1a. Project Opens: Run
+
+The project should automatically open a new window in VSCode. <br>
+
+**🤖 Again, bootstrap Copilot by pasting the following into the chat:**
+``` bash title='🤖 Again, bootstrap Copilot by pasting the following into the chat'
+Please load `.github/.copilot-instructions.md`.
+```
+
+Run it as follows:
+
+1. **Start the Server:** F5 
+2. **Start the Admin App:** browse to [http://localhost:5656/](http://localhost:5656/).  The Admin App screen shown below should appear in your Browser.
+3. **Verify as shown below**
+
+<details markdown>
+
+<summary>API: filtering, sorting, pagination, optimistic locking,related data access... see Swagger </summary>
+
+Your API is MCP enabled, and ready for custom app dev.  For more information, [click here](https://apilogicserver.github.io/Docs/API-Self-Serve).
+
+![swagger](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/basic_demo/api-swagger.jpeg?raw=true)
+</details>
+
+<br>
+
+<details markdown>
+
+<summary>Admin App: multi-page, multi-table, automatic joins, lookups, cascade add - collaboration-ready</summary>
+
+For more information, [click here](https://apilogicserver.github.io/Docs/Admin-Tour).
+
+The Admin App is ready for **[business user agile collaboration](https://apilogicserver.github.io/Docs/Tech-AI/),** and back office data maintenance.  This complements custom UIs created with the API.
+
+Explore the app - click Customer Alice, and see their Orders, and Items.  
+
+![admin-app-initial](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/basic_demo/admin-app-initial.jpeg?raw=true)
+</details>
+
+<br>
+
+## 2. Custom UI: GenAI, Vibe
+
+The app above is suitable for collaborative iteration to nail down the requirements, and back office data maintenance.  It's also easy to make simple customizations, using the yaml file.  For more custom apps, use Vibe:
+
+**Create a custom react app - customize in your IDE directly or with Vibe:**
+```bash title="Create a custom react app - customize in your IDE directly or with Vibe"
+Create a new react app using genai-add-app, 
+wait for it to complete, 
+then update the Product list to provide users an option to see results in a list or in cards.
+
+```
+
+<details markdown>
+
+<summary>Vibe Automation provides a running start (and can make errors)</summary>
+
+* 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:
+
+> Note: AI makes errors.  Part of Vibe is to accept that, and insist that AI find and fix them.  CoPilot is generally exceptionally good at this.
+
+</details>
+
+<br>
+
+> Below is an example from Northwind: [click here](https://apilogicserver.github.io/Docs/Admin-Vibe-Sample)
+
+![vibe-cards](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/ui-vibe/nw/vibe-gallery.png?raw=true)
+
+
+<br>
+
+## 3. Declare Business Logic
+
+Logic (multi-table derivations and constraints) is a significant portion of a system, typically nearly half.  GenAI-Logic provides **spreadsheet-like rules** that dramatically simplify and accelerate logic development.
+
+Rules are declared in Python, simplified with IDE code completion.  The screen below shows the 5 rules for **Check Credit Logic.**
+
+**1. Stop the Server** (Red Stop button, or Shift-F5 -- see Appendix)
+
+**2. Add Business Logic**
+
+**Check Credit Logic (instead of 220 lines of code):**
+```bash title="Check Credit Logic (instead of 220 lines of code)"
+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.
+```
+
+![Nat Lang Logic](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/sample-ai/copilot/copilot-logic-vibe.png?raw=true)
+
+To test the logic:
+
+**1. Use the Admin App to access the first order for `Customer Alice`**
+
+**2. Edit its first item to a very high quantity**
+
+The update is properly rejected because it exceeds the credit limit.  Observe the rules firing in the console log - see Logic In Action, below.
+
+<br>
+
+<details markdown>
+
+<summary>Logic is critical - half the effort; Declarative is 40X More Concise, Maintainable </summary>
+
+<br>Logic is critical to your system - it represents nearly *half the effort.*  Instead of procedural code, [***declare logic***](Logic#declaring-rules) with WebGenAI, or in your IDE using code completion or Natural Language as shown above.
+
+
+**a. 40X More Concise**
+
+The 5 spreadsheet-like rules represent the same logic as 200 lines of code, [shown here](https://apilogicserver.github.io/Docs/Logic-Why).  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).
+
+**b. Maintainable: Debugging, Logging**
+
+The screenshot below shows our logic declarations, and the logging for inserting an `Item`.  Each line represents a rule firing, and shows the complete state of the row.
+
+Note that it's a `Multi-Table Transaction`, as indicated by the indentation.  This is because - like a spreadsheet - **rules automatically chain, *including across tables.***
+
+![logic-chaining](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/basic_demo/logic-debugging.jpeg?raw=true)
+
+
+</details>
+
+<br>
+
+## 4. Enterprise Connectivity: B2B
+
+To fit our system into the Value Chain,
+we need a custom API to accept orders from B2B partners, and forward paid orders to shipping via Kafka.
+
+**Create the Custom B2B API Endpoint:**
+``` bash title="Create the Custom B2B API Endpoint"
+Create a B2B order API called 'OrderB2B' that accepts orders from external partners. 
+
+The external format should map:
+- 'Account' field to find customers by name
+- 'Notes' field to order notes
+- 'Items' array where each item maps 'Name' to find products and 'QuantityOrdered' to item quantity
+
+The API should create complete orders with automatic lookups and inherit all business logic rules.
+```
+
+The Kafka logic was created earlier, so we are ready to test.
+
+You can use Swagger (note the test data is provided), or use CLI:
+
+**Test the B2B Endpoint:**
+``` bash title="Test the B2B Endpoint"
+curl -X POST http://localhost:5656/api/OrderB2BEndPoint/OrderB2B -H "Content-Type: application/json" -d '{"meta":{"args":{"data":{"Account":"Alice","Notes":"RUSH order for Q4 promotion","date_shipped":"2025-08-04","Items":[{"Name":"Widget","QuantityOrdered":5},{"Name":"Gadget","QuantityOrdered":3}]}}}}'
+```
+
+Observe the logic execution in the VSCode debug window.
+
+<br>
+
+## 5. MCP: Logic, User Interface
+
+The server is automatically mcp-enabled, but we also require a user-interface to enable business users to send email, subject to business logic for customer email opt-outs.  Build it as follows:<br><br>
+
+
+**1. Stop the Server:**  click the red stop icon 🟥 or press <kbd>Shift</kbd>+<kbd>F5</kbd>.
+
+**2. Create the SysEmail Table to Track Sent Emails**
+
+**Add a Table to Track Sent Emails:**
+``` bash title="Add a Table to Track Sent Emails"
+Create a table SysEmail in `database/db.sqlite` as a child of customer, 
+with columns id, message, subject, customer_id and CreatedOn.
+```
+Follow the suggestions to update the admin app.
+
+<br>
+
+**3. Create an MCP Client Executor to process MCP Requests:**
+
+**Create an MCP Client Executor (don:**
+``` bash title="Create an MCP Client Executor (don't run yet)"
+Create the mcp client executor
+```
+
+MCP Clients accept MCP Requests, invoke the LLM to obtain a series of API calls to run, and runs them.  For more on MCP, [click here](https://apilogicserver.github.io/Docs/Integration-MCP).
+
+<br>
+
+**4. Create the email service using a Request Table**
+
+**Create the email service using SysEmail as a Request Table:**
+``` bash title="Create the email service using SysEmail as a Request Table"
+Add an after_flush event on SysEmail to produce a log message "email sent",
+unless the customer has opted out.
+```
+
+Inserts into SysEmail will now send mails (stubbed here with a log message).  Request objects are a common rule pattern - for more information, [click here](Integration-MCP#3b-logic-request-pattern).
+
+<br>
+
+<details markdown>
+
+<summary>Creates logic like this </summary>
+
+<br>When sending email, we require ***business rules*** to ensure it respects the opt-out policy:
+
+![email request](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/integration/mcp/3a-email-logic.png?raw=true)
+
+</details>
+
+<br>
+
+**5. Restart the Server** - F5
+
+<br>
+
+**6. Start the Admin App**
+
+<br>
+
+**7. Click SysMCP >> Create New, and enter:**
+
+**Test the MCP using the Admin App:**
+```text title="Test the MCP using the Admin App"
+List the orders date_shipped is null and CreatedOn before 2023-07-14, 
+and send a discount email (subject: 'Discount Offer') 
+to the customer for each one.
+```
+
+<br>
+
+![mcp-ui](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/basic_demo/mcp-ui.png?raw=true)
+
+
+<details markdown>
+
+<summary>More on MCP; Observe the log </summary>
+
+<br>For more on MCP, [click here](https://apilogicserver.github.io/Docs/Integration-MCP).
+
+![mcp-retrieval](https://github.com/ApiLogicServer/Docs/blob/main/docs/images/basic_demo/mcp-retrieval.png?raw=true)
+
+</details>
+
+<br>
+
+## 6. Iterate: Rules and Python
+
+This is addressed in the related CLI-based demo - to continue, [click here](Sample-Basic-Demo#5-iterate-with-rules-and-python).