ApiLogicServer 15.0.37__tar.gz → 15.0.40__tar.gz

{apilogicserver-15.0.37 → apilogicserver-15.0.40}/ApiLogicServer.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ApiLogicServer
-Version: 15.0.37
+Version: 15.0.40
 Author-email: Val Huber <apilogicserver@gmail.com>
 License: BSD-3-Clause
 Project-URL: Homepage, https://www.genai-logic.com

{apilogicserver-15.0.37 → apilogicserver-15.0.40}/ApiLogicServer.egg-info/SOURCES.txt

@@ -526,7 +526,9 @@ api_logic_server_cli/prototypes/allocation/images/allocation/logic-diagram.png
 api_logic_server_cli/prototypes/allocation/logic/declare_logic.py
 api_logic_server_cli/prototypes/allocation/test/test.sh
 api_logic_server_cli/prototypes/base/.DS_Store
+api_logic_server_cli/prototypes/base/.copilot-instructions.md
 api_logic_server_cli/prototypes/base/.gitignore
+api_logic_server_cli/prototypes/base/README_PROJECT.md
 api_logic_server_cli/prototypes/base/api_logic_server_run.py
 api_logic_server_cli/prototypes/base/readme.md
 api_logic_server_cli/prototypes/base/requirements.txt
@@ -542,6 +544,7 @@ api_logic_server_cli/prototypes/base/.idea/runConfigurations/Run_Behave.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/Windows_Run_Behave.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/run___No_Security.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/run_docker.xml
+api_logic_server_cli/prototypes/base/.vscode/.copilot-instructions.md
 api_logic_server_cli/prototypes/base/.vscode/launch.json
 api_logic_server_cli/prototypes/base/.vscode/settings.json
 api_logic_server_cli/prototypes/base/api/__init__.py
@@ -641,15 +644,17 @@ api_logic_server_cli/prototypes/base/docs/logic_suggestions/readme_logic_suggest
 api_logic_server_cli/prototypes/base/docs/training/admin_app_1_context.prompt.md
 api_logic_server_cli/prototypes/base/docs/training/admin_app_2_functionality.prompt.md
 api_logic_server_cli/prototypes/base/docs/training/admin_app_3_architecture.prompt.md
-api_logic_server_cli/prototypes/base/docs/training/admin_app_unused.md
 api_logic_server_cli/prototypes/base/docs/training/logic_bank_api.prompt
 api_logic_server_cli/prototypes/base/docs/training/logic_example.py
+api_logic_server_cli/prototypes/base/docs/training/react_map.prompt.md
+api_logic_server_cli/prototypes/base/docs/training/react_tree.prompt.md
 api_logic_server_cli/prototypes/base/integration/kafka/kafka_consumer.py
 api_logic_server_cli/prototypes/base/integration/kafka/kafka_producer.py
 api_logic_server_cli/prototypes/base/integration/kafka/kafka_readme.md
 api_logic_server_cli/prototypes/base/integration/mcp/.DS_Store
 api_logic_server_cli/prototypes/base/integration/mcp/mcp_client_executor.py
 api_logic_server_cli/prototypes/base/integration/mcp/mcp_server_discovery.json
+api_logic_server_cli/prototypes/base/integration/mcp/readme-mcp.md
 api_logic_server_cli/prototypes/base/integration/mcp/examples/mcp_context_results.txt
 api_logic_server_cli/prototypes/base/integration/mcp/examples/mcp_discovery_response.json
 api_logic_server_cli/prototypes/base/integration/mcp/examples/mcp_request.prompt
@@ -664,10 +669,13 @@ api_logic_server_cli/prototypes/base/integration/system/FlaskKafka.py
 api_logic_server_cli/prototypes/base/integration/system/RowDictMapper.py
 api_logic_server_cli/prototypes/base/logic/declare_logic.py
 api_logic_server_cli/prototypes/base/logic/load_verify_rules.py
-api_logic_server_cli/prototypes/base/logic/readme_declare_logic.md
+api_logic_server_cli/prototypes/base/logic/readme_logic.md
 api_logic_server_cli/prototypes/base/logic/logic_discovery/auto_discovery.py
+api_logic_server_cli/prototypes/base/logic/logic_discovery/readme_logic_discovery.md
+api_logic_server_cli/prototypes/base/logic/logic_discovery/use_case.py
 api_logic_server_cli/prototypes/base/security/__init__.py
 api_logic_server_cli/prototypes/base/security/declare_security.py
+api_logic_server_cli/prototypes/base/security/readme_security.md
 api_logic_server_cli/prototypes/base/security/authentication_provider/__init__.py
 api_logic_server_cli/prototypes/base/security/authentication_provider/abstract_authentication_provider.py
 api_logic_server_cli/prototypes/base/security/authentication_provider/keycloak/auth_provider.py
@@ -820,11 +828,13 @@ api_logic_server_cli/prototypes/genai_demo/logic/load_verify_rules.py
 api_logic_server_cli/prototypes/genai_demo/logic/readme_declare_logic.md
 api_logic_server_cli/prototypes/genai_demo/security/declare_security.py
 api_logic_server_cli/prototypes/genai_demo/ui/admin/admin.yaml
+api_logic_server_cli/prototypes/manager/.copilot-instructions.md
 api_logic_server_cli/prototypes/manager/.gitignore
 api_logic_server_cli/prototypes/manager/README.md
 api_logic_server_cli/prototypes/manager/run_sample.sh
 api_logic_server_cli/prototypes/manager/run_web_genai.sh
 api_logic_server_cli/prototypes/manager/settings.txt
+api_logic_server_cli/prototypes/manager/.vscode/.copilot-instructions.md
 api_logic_server_cli/prototypes/manager/.vscode/ApiLogicServer.code-workspace
 api_logic_server_cli/prototypes/manager/.vscode/launch.json
 api_logic_server_cli/prototypes/manager/.vscode/settings.json
@@ -1919,14 +1929,29 @@ api_logic_server_cli/prototypes/nginx_exp/docker-compose-dev-azure-nginx/unused/
 api_logic_server_cli/prototypes/nw/.DS_Store
 api_logic_server_cli/prototypes/nw/Tutorial.md
 api_logic_server_cli/prototypes/nw/api/customize_api.py
+api_logic_server_cli/prototypes/nw/api/api_discovery/authentication_expose_api_models.py
+api_logic_server_cli/prototypes/nw/api/api_discovery/auto_discovery.py
+api_logic_server_cli/prototypes/nw/api/api_discovery/count_orders_by_month.html
+api_logic_server_cli/prototypes/nw/api/api_discovery/count_orders_by_month.sql
+api_logic_server_cli/prototypes/nw/api/api_discovery/dashboard_services.py
+api_logic_server_cli/prototypes/nw/api/api_discovery/mcp_discovery.py
+api_logic_server_cli/prototypes/nw/api/api_discovery/new_service.py
+api_logic_server_cli/prototypes/nw/api/api_discovery/newer_service.py
+api_logic_server_cli/prototypes/nw/api/api_discovery/number_of_sales_per_category.html
+api_logic_server_cli/prototypes/nw/api/api_discovery/number_of_sales_per_category.sql
+api_logic_server_cli/prototypes/nw/api/api_discovery/ontimize_api.py
+api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category.html
 api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category.py
+api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category.sql
 api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category_bar_chart.html
 api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category_bar_chart_app.request
 api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category_bar_chart_query.request
 api_logic_server_cli/prototypes/nw/api/api_discovery/sales_by_category_result.png
+api_logic_server_cli/prototypes/nw/api/api_discovery/system.py
 api_logic_server_cli/prototypes/nw/api/multi-table-example/multi-table.json
 api_logic_server_cli/prototypes/nw/api/multi-table-example/multi-table.txt
 api_logic_server_cli/prototypes/nw/database/customize_models.py
+api_logic_server_cli/prototypes/nw/database/database_discovery/graphics_services.py
 api_logic_server_cli/prototypes/nw/docs/graphics/count_orders_by_category.prompt
 api_logic_server_cli/prototypes/nw/docs/graphics/order_count_by_month.prompt
 api_logic_server_cli/prototypes/nw/docs/graphics/request copy.json
@@ -2002,6 +2027,7 @@ api_logic_server_cli/prototypes/nw/ui/images/Employee/leverling.jpg
 api_logic_server_cli/prototypes/nw/ui/images/Employee/peacock.jpg
 api_logic_server_cli/prototypes/nw/ui/images/Employee/suyama.jpg
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/.DS_Store
+api_logic_server_cli/prototypes/nw/ui/reference_react_app/DEPARTMENT_TREE_VIEW.md
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/README.md
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/README_create_react_app.md
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/compile-errors.txt
@@ -2018,12 +2044,15 @@ api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/App.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/App.test.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/Category.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/Config.js
+api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/CustomLayout.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/Customer.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/CustomerDemographic.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/Department.js
+api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/DepartmentTree.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/Employee.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/EmployeeAudit.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/EmployeeTerritory.js
+api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/LandingPage.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/Location.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/Order.js
 api_logic_server_cli/prototypes/nw/ui/reference_react_app/src/OrderDetail.js

{apilogicserver-15.0.37 → apilogicserver-15.0.40}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ApiLogicServer
-Version: 15.0.37
+Version: 15.0.40
 Author-email: Val Huber <apilogicserver@gmail.com>
 License: BSD-3-Clause
 Project-URL: Homepage, https://www.genai-logic.com

{apilogicserver-15.0.37 → apilogicserver-15.0.40}/api_logic_server_cli/api_logic_server.py

@@ -12,10 +12,10 @@ ApiLogicServer CLI: given a database url, create [and run] customizable ApiLogic
 Called from api_logic_server_cli.py, by instantiating the ProjectRun object.
 '''
 
-__version__ = "15.00.37"  # last public release: 15.00.36 (15.00.12)
+__version__ = "15.00.40"  # last public release: 15.00.36 (15.00.12)
 recent_changes = \
     f'\n\nRecent Changes:\n' +\
-    "\t07/02/2024 - 15.00.37: minor bug in mgr symlink creation, nw cards, mgr readme diagnostics, mcp printer \n"\
+    "\t07/08/2024 - 15.00.40: copilot uSvc vibe, fix mgr symlink creation, nw cards, mgr readme diagnostics, mcp printer, bug[98] \n"\
     "\t06/30/2024 - 15.00.33: Tech Preview: genai-logic genai-add-app --vibe, bug [96, 97] \n"\
     "\t06/10/2024 - 15.00.12: MCP Security, win fixes for readme, graphics quotes \n"\
     "\t06/08/2024 - 15.00.10: MCP, optional shortening of stacktrace lines, bugfix[92] \n"\

apilogicserver-15.0.40/api_logic_server_cli/api_logic_server_info.yaml

@@ -0,0 +1,3 @@
+last_created_date: July 08, 2025 21:48:29
+last_created_project_name: samples/nw_sample_nocust
+last_created_version: 15.00.39

{apilogicserver-15.0.37 → apilogicserver-15.0.40}/api_logic_server_cli/genai/genai_svcs.py

@@ -906,10 +906,11 @@ def call_chatgpt(messages: List[Dict[str, str]], api_version: str, using: str, r
         request_path.parent.mkdir(parents=True, exist_ok=True)
         return request_path
     
-    def string_to_lines(dict_long_string: dict) -> dict:
+    def string_to_lines(dict_long_string: list) -> dict:
         result = dict_long_string
-        if isinstance(result[1]['content'], str):
-            result[1]['content'] = result[1]['content'].split('\n')
+        if len(result) > 1:
+            if isinstance(result[1]['content'], str):
+                result[1]['content'] = result[1]['content'].split('\n')
         return result
 
     try:

apilogicserver-15.0.40/api_logic_server_cli/prototypes/base/.copilot-instructions.md

@@ -0,0 +1,10 @@
+# Primary Copilot Instructions
+
+**Note**: The main Copilot instructions are in `.vscode/.copilot-instructions.md`
+
+Please refer to that file for complete guidance on helping users with GenAI-Logic.
+
+## Quick Reference for AI Assistants
+
+When users ask "what do I do now?":
+1. Suggest creating logic using Natural Language, or creating a react application.

apilogicserver-15.0.40/api_logic_server_cli/prototypes/base/.vscode/.copilot-instructions.md

@@ -0,0 +1,178 @@
+# GitHub Copilot Instructions for GenAI-Logic (aka API Logic Server) Projects
+
+## Project Type: Auto-Generated Microservice
+
+This is a **GenAI-Logic (aka API Logic Server) project** - a complete, working microservice - auto-generated from a database schema.
+
+## ⚠️ IMPORTANT: What's Already Built
+
+**DO NOT recreate these - they're already working:**
+
+1. **Admin Web Application** - Live at `http://localhost:5656`
+2. **REST API Endpoints** - All database tables exposed at `/api/*`
+3. **Database Models** - Complete SQLAlchemy ORM in `database/models.py`
+4. **Authentication System** - JWT-based auth framework
+5. **Business Logic Engine** - Declarative rules system
+
+## 🎯 Common Tasks
+
+If the user asks "what do I do now?", these subsections are good suggestions.
+
+List these as choices, do not just do all of them at once - that would be overwhelming.
+
+### 🚀 To Run This Project
+
+Use F5 (pre-configured run configuration - supports debugger for server logic), or (when focused on client apps):
+
+```bash
+python api_logic_server_run.py
+# Then open: http://localhost:5656
+```
+
+### Adding Business Logic
+Use `docs/training` to accept Natural Language logic, and translate it into rules like:
+
+```python
+# Edit: logic/declare_logic.py
+Rule.sum(derive=Customer.Balance, as_sum_of=Order.AmountTotal)
+Rule.constraint(validate=Customer, as_condition=lambda row: row.Balance <= row.CreditLimit)
+```
+
+Generally CoPilot solicits Natural Language logic for translation (see logic/logic_discovery/readme_logic_discovery.md), 
+but you can also offer to suggest rules.
+
+### Adding MCP
+
+The API is automatically MCP-enabled.
+
+To add MCP Client (requires OpenAI key):
+
+```bash
+# Add MCP Client
+genai-logic genai-add-mcp-client
+```
+
+### Configuring Admin UI
+
+This is built when project is created - no need to add it.
+Customize by editing the underlying yaml.
+
+```yaml
+# Edit: ui/admin/admin.yaml
+resources:
+  Customer:
+    attributes:
+      - name: CompanyName
+        search: true
+        sort: true
+```
+
+### Create and Customize React Apps
+
+Complete customization is provided by generating a React Application (requires OpenAI key, Node):
+
+```bash
+# Create: ui/admin/my-app-name
+genai-logic genai-create-app --app-name=my-app-name --vibe
+```
+
+Then, `npm install` and `npm start`
+
+Temporary restriction: security must be disabled.
+
+Customize using CoPilot chat, with `docs/training`.
+
+### Security - Role-Based Access Control
+
+Configure:
+```
+als add-auth --provider-type=sql --db-url=
+als add-auth --provider-type=sql --db_url=postgresql://postgres:p@localhost/authdb
+
+als add-auth --provider-type=keycloak --db-url=localhost
+als add-auth --provider-type=keycloak --db-url=hardened
+
+als add-auth --provider-type=None # to disable
+``` 
+
+Keycloak quick start [(more information here:)](https://apilogicserver.github.io/Docs/Security-Keycloak/)
+```bash
+cd devops/keycloak
+docker compose up
+als add-auth --provider-type=keycloak --db-url=localhost
+```
+
+For more on KeyCloak: https://apilogicserver.github.io/Docs/Security-Keycloak/
+
+Declaration:
+```python
+# Edit: security/declare_security.py
+Grant(on_entity=Customer, to_role=sales, filter=lambda: Customer.SalesRep == current_user())
+```
+
+### Adding Custom API Endpoints
+```python
+# Edit: api/customize_api.py
+@app.route('/api/custom-endpoint')
+def my_endpoint():
+    return {"message": "Custom endpoint"}
+```
+
+### Customize Models - Add Derived attributes
+
+Here is a sample derived attribute, `proper_salary`:
+
+```python
+
+# add derived attribute: https://github.com/thomaxxl/safrs/blob/master/examples/demo_pythonanywhere_com.py
+@add_method(models.Employee)
+@jsonapi_attr
+def __proper_salary__(self):  # type: ignore [no-redef]
+    import database.models as models
+    import decimal
+    if isinstance(self, models.Employee):
+        rtn_value = self.Salary
+        if rtn_value is None:
+          rtn_value = decimal.Decimal('0')
+        rtn_value = decimal.Decimal('1.25') * rtn_value
+        self._proper_salary = int(rtn_value)
+        return self._proper_salary
+    else:
+        rtn_value = decimal.Decimal('0')
+        self._proper_salary = int(rtn_value)
+        return self._proper_salary
+
+@add_method(models.Employee)
+@__proper_salary__.setter
+def _proper_salary(self, value):  # type: ignore [no-redef]
+    self._proper_salary = value
+    print(f'_proper_salary={self._proper_salary}')
+    pass
+
+models.Employee.ProperSalary = __proper_salary__
+
+```
+
+When customizing SQLAlchemy models:
+
+Don't use direct comparisons with database fields in computed properties
+Convert to Python values first using float(), int(), str()
+Use property() function instead of @jsonapi_attr for computed properties
+Always add error handling for type conversions
+
+## 📁 Key Directories
+
+- `logic/` - Business rules (declarative)
+- `api/` - REST API customization
+- `security/` - Authentication/authorization
+- `database/` - Data models and schemas
+- `ui/admin/` - Admin interface configuration
+- `ui/app/` - Alternative Angular admin app
+
+## 💡 Helpful Context
+
+- This uses Flask + SQLAlchemy + SAFRS for JSON:API
+- Admin UI is React-based with automatic CRUD generation
+- Business logic uses LogicBank (declarative rule engine)
+- Everything is auto-generated from database introspection
+- Focus on CUSTOMIZATION, not re-creation

apilogicserver-15.0.40/api_logic_server_cli/prototypes/base/README_PROJECT.md

@@ -0,0 +1,43 @@
+# API Logic Server Project
+
+This is an **auto-generated microservice** created by [API Logic Server](https://apilogicserver.github.io/).
+
+## 🚀 What's Included (Auto-Generated)
+
+- **Complete Admin Web App** - Multi-table CRUD interface
+- **JSON:API REST Endpoints** - All database tables exposed
+- **Business Logic Engine** - Declarative rules system
+- **Security Framework** - Authentication and authorization
+- **Swagger Documentation** - Interactive API docs
+
+## Quick Start
+
+```bash
+# Run the complete system
+python api_logic_server_run.py
+
+# Access admin app
+open http://localhost:5656
+
+# View API documentation  
+open http://localhost:5656/api
+```
+
+## 📖 Documentation
+
+- [Getting Started Guide](./docs/COPILOT_GUIDE.md)
+- [Main README](./readme.md)
+- [API Logic Server Docs](https://apilogicserver.github.io/)
+
+## 🛠️ Customization
+
+This is a **working system** - customize rather than recreate:
+
+- **Business Logic**: `logic/declare_logic.py`
+- **API Endpoints**: `api/customize_api.py` 
+- **Security Rules**: `security/declare_security.py`
+- **Admin UI Config**: `ui/admin/admin.yaml`
+
+---
+
+**Generated by API Logic Server** - Instant microservices from your database.

{apilogicserver-15.0.37 → apilogicserver-15.0.40}/api_logic_server_cli/prototypes/base/api_logic_server_run.py

@@ -1,19 +1,31 @@
 #!/usr/bin/env python3
 
 ###############################################################################
+# 🚀 API Logic Server - AUTO-GENERATED MICROSERVICE
 #
-#    This file initializes and starts the API Logic Server, e.g.:
-#        $ Use your IDE Run Configurations (for debug)
-#        $ sh run.sh
-#        $ python3 api_logic_server_run.py [--help]
-#        $ gunicorn --log-level=info -b 0.0.0.0:5656 -w2 --reload api_logic_server_run:flask_app
+# This file starts a COMPLETE, WORKING microservice with:
+#   ✅ Admin Web App at http://localhost:5656 (React-based, multi-table CRUD)
+#   ✅ JSON:API endpoints at http://localhost:5656/api/* (auto-generated from database)
+#   ✅ Swagger documentation at http://localhost:5656/api
+#   ✅ Business logic engine (declarative rules)
+#   ✅ Security framework (authentication/authorization)
 #
-#    Then, access the Admin App and API via the Browser, eg:  
-#        http://api_logic_server_host:api_logic_server_port
+# 🎯 TO RUN:
+#    Press F5 in VSCode, or run: python api_logic_server_run.py
+#
+# 🌐 TO ACCESS:
+#    Admin App: http://localhost:5656
+#    API Docs:  http://localhost:5656/api
+#
+# 📝 TO CUSTOMIZE:
+#    See docs/COPILOT_GUIDE.md for GitHub Copilot guidance
+#    Logic: logic/declare_logic.py
+#    API: api/customize_api.py
+#    Security: security/declare_security.py
 #
 #    You typically do not customize this file.
 #
-#    (v api_logic_server_version, api_logic_server_created_on)
+#    (v 15.00.38, July 06, 2025 22:11:00)
 #
 #    See Main Code (at end).
 #        Use log messages to understand API and Logic activation.

apilogicserver-15.0.40/api_logic_server_cli/prototypes/base/docs/training/react_map.prompt.md

@@ -0,0 +1,13 @@
+I need to enhance a React Admin supplier page to include a professional, interactive world map view that displays suppliers on a real map with proper geography. Requirements:
+
+1. **Use a proper mapping library** (like Leaflet.js) - NOT custom SVG drawings
+2. **Real world map** with accurate geography, countries, and coastlines
+3. **Interactive controls**: pan, zoom, mouse wheel support
+4. **Clickable supplier markers** that navigate to supplier detail pages
+5. **Professional UI** with map legend and controls
+6. **Toggle between list and map view**
+7. **Position suppliers** by country with slight offsets to avoid overlap
+
+The current supplier data has fields: Id, CompanyName, ContactName, City, Country, etc.
+
+Please install the necessary mapping library dependencies and create a production-ready map component that looks professional like Google Maps, not a hand-drawn cartoon map.

apilogicserver-15.0.40/api_logic_server_cli/prototypes/base/docs/training/react_tree.prompt.md

@@ -0,0 +1,10 @@
+Provide an option to see departments either as a list (as now), or as a tree.  The tree expands to show related sub departments, as links.  If I click on the dept name link, then open the department "show" to the right.
+
+TECHNICAL CONSTRAINTS:
+
+- Avoid recursion stack overflow: include proper termination conditions
+- Handle mixed data types: use parseInt() for ID comparisons  
+- Prevent import conflicts: use aliases for Material-UI components
+- Verify data relationships: check actual field names in backend
+- Use incremental development: start simple, add complexity gradually
+- Test each layer: tree logic → expansion → detail panel → tabs

apilogicserver-15.0.40/api_logic_server_cli/prototypes/base/integration/mcp/readme-mcp.md

@@ -0,0 +1,9 @@
+GenAI-Logic APIs are pre-configured to support MCP - see `api/api_discovery/mcp_discovery.py`.
+
+`integration/mcp/mcp_client_executor.py` provides an mcp client executor.  You can enable an MCP User Interface:
+
+```bash
+genai-logic genai-add-mcp-client
+```
+
+For more information, [click here](https://apilogicserver.github.io/Docs/Integration-MCP/#mcp-client-executor-ui).

apilogicserver-15.0.40/api_logic_server_cli/prototypes/base/logic/logic_discovery/readme_logic_discovery.md

@@ -0,0 +1,9 @@
+You can declare logic in `declare_logic.py`,
+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`).  
+
+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.

apilogicserver-15.0.40/api_logic_server_cli/prototypes/base/logic/logic_discovery/use_case.py

@@ -0,0 +1,27 @@
+import datetime
+from decimal import Decimal
+from logic_bank.exec_row_logic.logic_row import LogicRow
+from logic_bank.extensions.rule_extensions import RuleExtension
+from logic_bank.logic_bank import Rule
+from database import models
+import api.system.opt_locking.opt_locking as opt_locking
+from security.system.authorization import Grant
+import logging
+from flask import jsonify
+
+
+""" Best practice: create logic files for each use case """
+
+app_logger = logging.getLogger(__name__)
+
+
+def declare_logic():
+    """
+    Use GenAI to convert Natural Language into logic, paste here.  See readme_logic_discovery_readme.md for an example.
+    
+    Sample logic:
+    Rule.constraint(validate=models.Customer,
+        as_condition=lambda row: row.CompanyName != 'x',
+        error_msg="CompanyName cannot be 'x'")
+    """
+    pass

apilogicserver-15.0.37/api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/logic/readme_declare_logic.md → apilogicserver-15.0.40/api_logic_server_cli/prototypes/base/logic/readme_logic.md

@@ -1,6 +1,6 @@
 This describes how to use Logic; for more information, [see here](https://apilogicserver.github.io/Docs/Logic-Why).
 
-> Key Takeway -  Logic: Multi-table Derivation and Constraint Rules, Extensible with Python 
+> What is Logic: Multi-table Derivation and Constraint Rules, Extensible with Python 
 <br>Rules are:
 <br>1. **Declared** in your IDE - 40X more concise
 <br>2. **Activated** on server start
@@ -10,6 +10,61 @@ This describes how to use Logic; for more information, [see here](https://apilog
 
 &nbsp;
 
+## 🚀 Quick Start, using the `basic_demo` sample database
+
+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:  
+    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.
+```
+
+Basic process:
+1. Create a file such as `logic/logic_discovery/check_credit.py` (e.g., copy from `use_case.py`).
+2. Paste the prompt above into CoPilot - use `docs/training` to generate logic
+3. Paste the generated logic into `logic/logic_discovery/check_credit.py`
+
+From the Natural Language, Copilot will create Python rules (you can also create these directly using code completion):
+```python
+    if os.environ.get("WG_PROJECT"):
+        # Inside WG: Load rules from docs/expprt/export.json
+        load_verify_rules()
+    else:
+        # Outside WG: load declare_logic function
+        from logic.logic_discovery.auto_discovery import discover_logic
+        discover_logic()
+
+    # Logic from GenAI: (or, use your IDE w/ code completion)
+    from database.models import Product, Order, Item, Customer, SysEmail
+
+    # Ensure the customer's balance is less than their credit limit
+    Rule.constraint(validate=Customer, as_condition=lambda row: row.balance <= row.credit_limit, error_msg="Customer balance ({row.balance}) exceeds credit limit ({row.credit_limit})")
+
+    # Derive the customer's balance as the sum of order totals where not yet shipped.
+    Rule.sum(derive=Customer.balance, as_sum_of=Order.amount_total, where=lambda row: row.date_shipped is None)
+
+    # Derive the order's total amount from the sum of item amounts.
+    Rule.sum(derive=Order.amount_total, as_sum_of=Item.amount)
+
+    # Calculate item amount based on quantity and unit price.
+    Rule.formula(derive=Item.amount, as_expression=lambda row: row.quantity * row.unit_price)
+
+    # Copy unit price from product to item.
+    Rule.copy(derive=Item.unit_price, from_parent=Product.unit_price)
+
+    # Send order details to Kafka if order is shipped.
+    Rule.after_flush_row_event(on_class=Order, calling=kafka_producer.send_row_to_kafka, if_condition=lambda row: row.date_shipped is not None, with_args={'topic': 'order_shipping'})
+
+    # End Logic from GenAI
+```
+
 ## Natural Language vs. IDE
 
 If you are using WebGenAI, you can specify rules in Natural Language. You can also augment them in the IDE using code completion.  There are some important usage guidelines.  
@@ -18,6 +73,20 @@ If you are using WebGenAI, you can specify rules in Natural Language. You can al
 
 &nbsp;
 
+## Using Discovery
+
+You can declare logic in `declare_logic.py`,
+but that can lead to a lot of rules in 1 file.
+
+A *best practice* is to create logic files in `logic/logic_discovery`,
+named after the use case (e.g., `check_credit.py`).  
+
+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.
+
+<br>
+
 ## Examples      
 Examples from tutorial project:
 * Examples drawn from [tutorial project](https://github.com/ApiLogicServer/demo/blob/main/logic/declare_logic.py)