unified demo readme

valhuber · valhuber · commit cebfe1af0f01 · 2025-05-22T17:08:17.000-07:00
diff --git a/docs/Integration-MCP.md b/docs/Integration-MCP.md
@@ -1,11 +1,11 @@
 !!! pied-piper ":bulb: TL;DR - MCP: Enable Bus Users to use NL to create multi-step execution flows"
 
-	MCP enables Business Users to use Natural Language to create declarative execution flows across multiple business-rule-enforced API services.  For example: *find the overdue orders, and send an email offering a discount*.
+	MCP enables Business Users to use Natural Language to create multi-step execution flows across existing business-rule-enforced APIs.  For example: *find the overdue orders, and send an email offering a discount*.  This is a new request, composed from existing steps (find orders, send email).
 	
 	MCP is an open protocol than enables:
 	
 	1. **MCP Client Executors** to leverage LLMs to translate NL queries into multi-step execution flows called **Tool Context Blocks.**. 
-	2. The MCP Client Executor executes the Tool Context block steps, making calls on the  **MCP Server Executors.**
+	2. The MCP Client Executor executes the Tool Context Block steps, making calls on the  **MCP Server Executors.**
 	
 		* MCP Server Executors are commonly provided via **logic-enabled JSON:APIs.**  (Note the logic is critical in maintaining integrity and security.)
 	
@@ -63,6 +63,8 @@ Create the **basic_demo** under the [Manager](Manager.md) as described in the Ma
 4. Run `python integration/mcp/mcp_client_executor.py`
 
 
+The [basic_demo](Sample-Basic-Demo.md){:target="_blank" rel="noopener"} project illustrates basic GenAI-Logic operation: creating projects from new or existing databases, adding logic and security, and customizing your project using your IDE and Python.
+
 You will need an environment variable: `APILOGICSERVER_CHATGPT_APIKEY` ChatGPT APIKey (obtain one [like this](WebGenAI-CLI.md/#configuration)).
 
 &nbsp;
diff --git a/docs/Sample-Basic-Demo.md b/docs/Sample-Basic-Demo.md
@@ -8,17 +8,12 @@ See how to build a complete database system -- in minutes instead of weeks or mo
 
 1. **An API**, and, we'll add ui and logic to make it a microservice...
 2. **Logic and Security:** multi-table constraints and derivations, role-based security, and application integration
-3. **An Admin App:** and finally, a multi-page, multi-table web app
+3. **An Admin App:** a multi-page, multi-table web app 
+4. **Customizable:** use your IDE to customize with declarative rules and standard Python
 
 &nbsp;
 
-We'll use API Logic Server (open source), providing:
-
-| Key Feature | What It Means | Why It Matters|
-| :--- |:---|:---|
-| **Automation** | Instant Project Creation:<br>An API and an Admin web app  | Unblock UI App Dev<br>Instant Agile Collaboration |
-| **Customization** | Declarative logic and security <br> 5 rules vs. 200 lines of Python | 40X less backend code |
-| **Iteration** | Revise the data model, and <br>Add rules, plus Python | Iterative development <br> Extensiblity with Python |
+We'll use API Logic Server (open source), providing [these key features](https://www.genai-logic.com/product/key-features){:target="_blank" rel="noopener"}.
 
 The entire process takes 20 minutes, instead of several weeks using traditional development.
 
@@ -32,17 +27,49 @@ You can use this article in several ways:
 
 &nbsp;
 
-## 1. Automation: Instant Project
+## 1. Automation: Project Creation
+
+API Logic Server can create projects from existing databases, or use GenAI to create projects with new databases.  See the sub-sections below.
+
+&nbsp;
+### Create From Existing Database
 
 This project was created with a command like:
 
 ```bash
 $ ApiLogicServer create --project_name=basic_demo --db_url=basic_demo
 ```
 
-> Note: the `db_url` value is [an abbreviation](https://apilogicserver.github.io/Docs/Data-Model-Examples/).  You would normally supply a SQLAlchemy URI.
+> Note: the `db_url` value is [an abbreviation](https://apilogicserver.github.io/Docs/Data-Model-Examples/){:target="_blank" rel="noopener"} for a test database provided as part of the installation.  You would normally supply a SQLAlchemy URI to your existing database.
+
+This creates a project by reading your schema.  The database is Customer, Orders, Items and Product, as shown in the Appendix.
+
+&nbsp;
+
+### Create With New Database
+
+You can create a project from a prompt using GenAI, either by [WebGenAI](WebGenAI.md), or the the [GenAI CLI](WebGenAI-CLI.md){:target="_blank" rel="noopener"} as shown here.
+
+Use the GenAI CLI with or without signup:
+
+1. If you have signed up (see *Obtain a OpenAI API Key*, below), 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 --project-name=genai_demo
+```
+
+  
+
+2. ***Or,*** you can simulate the process (no signup) using:
+
+```bash
+
+als genai --repaired-response=system/genai/examples/genai_demo/genai_demo.response_example --project-name=genai_demo
+
+```
 
-This creates a project by reading your schema.  The database is Customer, Orders, Items and Product, as shown in the Appendix.  
+&nbsp;
+### Open in your IDE and Run
 
 You can open with VSCode, and run it as follows:
 
@@ -73,9 +100,9 @@ The sections below explore the system that has been created (which would be simi
 
 &nbsp;
 
-## 2. Customize in your IDE
+## 2. Declare Logic And Security
 
-While API/UI automation is a great start, it's critical to enforce logic and security.  Here's how.
+While API/UI automation is a great start, it's critical to enforce logic and security.  You do this in your IDE.  Here's how.
 
 The following `add_customizations` process simulates:
 
@@ -332,7 +359,7 @@ This is a "cheat sheet" for experienced ALS users, e.g., to show your colleagues
 # Admin App, API, Project
 als create --project-name=basic_demo --db-url=basic_demo
 
-# Logic and Security
+# Logic, Security and MCP example
 # see logic (logic/declare_logic.py, logic/cocktail-napkin.jpg);  add an Order and Item
 # see security (security/declare_security.py); compare customers, s1 vs. admin
 als add-cust
@@ -456,4 +483,15 @@ __3. Start the Server and open the App in the Browser__
 ![API Logic Server Intro](images/git-codespaces/start-codespaces.png)
 
 
-We think you'll find Codespaces pretty amazing - check it out!
+We think you'll find Codespaces pretty amazing - check it out!
+
+&nbsp;
+
+## Appendix: Obtain an OpenAI ApiKey
+
+To obtain a ChatGPT API Key
+<br>GenAI-Logic uses OpenAI, which requires an Open API Key:
+
+1. Obtain one from [here](https://platform.openai.com/account/api-keys) or [here](https://platform.openai.com/api-keys)
+
+2. Authorize payments [here](https://platform.openai.com/settings/organization/billing/overview)
diff --git a/docs/Sample-Basic_Demo.md b/docs/Sample-Basic_Demo.md
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -25,15 +25,14 @@ nav:
         - Execute From Terminal: Execute.md
     - Express Eval: Install-Eval.md
   - Demos, Tutorial, Samples:
+    - "Basic Self-Demo": Sample-Basic-Demo.md
     - "GenAI Microservice Automation": Sample-Genai.md
     - "Tutorial": Tutorial.md
     - "AI - Copilot": Sample-AI.md
     - "Sample DB, Project": Sample-Database.md
     - "Sample Integration": Sample-Integration.md
-    - "Sample DB, Project": Sample-Database.md
     - "Deployment Tutorial": Tutorial-Deployment.md
     - "Agile Tutorial": Tutorial-Agile.md
-    - "Basic Self-Demo": Sample-Basic-Demo.md
     - "AI - ChatGPT, Agile": Tutorial-AI.md
     - "Sample Systems": Data-Model-Examples.md
   - GenAI:
