refactor(repo): reorganize repository structure into apps/ and workshops/ directories

- Updated .gitignore to reflect new paths under apps/ subdirectory for various applications
- Modified README.md to add Repository Structure section and update all project links to point to correct subdirectories (apps/ for applications, workshops/ for educational materials)
- Ensures better organization and clarity for users navigating the DevRel Labs repository

Author: jasperan

.gitignore

@@ -32,11 +32,11 @@ Temporary Items
 .csr
 .pem
 
-oci-language-translation/config.yaml
-oci-subtitle-translation/config.yaml
-oci-csv-json-translation/config.yaml
-oci-language-multiple-translation/config.yaml
-
-agentic_rag/config.yaml
-agentic_rag/chroma_db
-agentic_rag/embeddings
+apps/oci-language-translation/config.yaml
+apps/oci-subtitle-translation/config.yaml
+apps/oci-csv-json-translation/config.yaml
+apps/oci-language-multiple-translation/config.yaml
+
+apps/agentic_rag/config.yaml
+apps/agentic_rag/chroma_db
+apps/agentic_rag/embeddings

README.md

@@ -2,9 +2,15 @@
 
 Welcome to DevRel Labs, a collection of AI solutions and tools built with Oracle technologies. This repository contains practical implementations, demos, and guides for various AI use cases.
 
+## Repository Structure
+
+- `apps/`: Deployable applications, automation scripts, and infrastructure-as-code projects.
+- `workshops/`: Step-by-step guides, LiveLabs content, and educational materials.
+- `notebooks/`: Reserved for notebook-driven explorations and tutorials (currently minimal).
+
 ## 🚀 New AI Solutions (2024)
 
-### 1. [Oracle MCP AI Agents](./oracle-mcp-ai-agents/)
+### 1. [Oracle MCP AI Agents](./apps/oracle-mcp-ai-agents/)
 **Building AI Agents with Model Context Protocol (MCP) and Oracle Database 26ai**
 
 - **MCP Integration**: Secure tool calling between LLMs and Oracle Database
@@ -13,7 +19,7 @@ Welcome to DevRel Labs, a collection of AI solutions and tools built with Oracle
 - **Langflow Integration**: Visual workflow builder for AI agents
 - **Use Cases**: Financial advisor, customer service, business intelligence
 
-### 2. [Oracle RAG Applications](./oracle-rag-applications/)
+### 2. [Oracle RAG Applications](./apps/oracle-rag-applications/)
 **Building RAG Applications with Oracle Database 26ai**
 
 - **Vector Embeddings**: Native vector storage and search
@@ -22,7 +28,7 @@ Welcome to DevRel Labs, a collection of AI solutions and tools built with Oracle
 - **LLM Integration**: Seamless integration with various Large Language Models
 - **Use Cases**: Knowledge management, customer support, content creation
 
-### 3. [Oracle Select AI Insights](./oracle-select-ai-insights/)
+### 3. [Oracle Select AI Insights](./apps/oracle-select-ai-insights/)
 **Talk with Industry-Specific Domain Data and Gain Insights Using Select AI**
 
 - **Natural Language Queries**: Ask questions in plain English
@@ -34,27 +40,27 @@ Welcome to DevRel Labs, a collection of AI solutions and tools built with Oracle
 ## 🔧 Existing Solutions
 
 ### AI & Machine Learning
-- [Agentic RAG](./agentic_rag/) - AI RAG in a BOX Demo using Oracle AI Database 26ai and Local LLMs
-- [PlaneLLM](./planeLLM/) - PlaneLLM integration with Oracle Database
-- [Neural Networks Hero](./neural_networks_hero/) - Neural network implementations and tutorials
+- [Agentic RAG](./apps/agentic_rag/) - AI RAG in a BOX Demo using Oracle AI Database 26ai and Local LLMs
+- [PlaneLLM](./apps/planeLLM/) - PlaneLLM integration with Oracle Database
+- [Neural Networks Hero](./workshops/neural_networks_hero/) - Neural network implementations and tutorials
 
 ### Computer Vision
 - [OCI Vision AI](./oci-vision-ai/) - Computer vision solutions using Oracle Cloud Infrastructure
-- [Mask Detection](./mask_detection_training/) - Training and labeling for mask detection models
+- [Mask Detection](./workshops/mask_detection_training/) - Training and labeling for mask detection models
 
 ### Language & Translation
-- [OCI Language Translation](./oci-language-translation/) - Multi-language translation services
-- [OCI Subtitle Translation](./oci-subtitle-translation/) - Automated subtitle translation
-- [OCI CSV-JSON Translation](./oci-csv-json-translation/) - Data format conversion tools
+- [OCI Language Translation](./apps/oci-language-translation/) - Multi-language translation services
+- [OCI Subtitle Translation](./apps/oci-subtitle-translation/) - Automated subtitle translation
+- [OCI CSV-JSON Translation](./apps/oci-csv-json-translation/) - Data format conversion tools
 
 ### Infrastructure & Deployment
-- [NVIDIA NIM on OKE](./nvidia-nim-oke/) - NVIDIA Inference Microservices on Oracle Container Engine
-- [Holoscan](./holoscan/) - Holoscan applications and deployments
+- [NVIDIA NIM on OKE](./apps/nvidia-nim-oke/) - NVIDIA Inference Microservices on Oracle Container Engine
+- [Holoscan](./apps/holoscan/) - Holoscan applications and deployments
 - [Kubeflow on OKE](./kubeflow-oke-old/) - Machine learning workflows on Kubernetes
 
 ### Data & Analytics
-- [Data in AI Revolution](./data-in-ai-revolution/) - Data-driven AI solutions and insights
-- [RAG in a Box](./rag_in_a_box/) - Retrieval-Augmented Generation solutions
+- [Data in AI Revolution](./workshops/data-in-ai-revolution/) - Data-driven AI solutions and insights
+- [RAG in a Box](./apps/rag_in_a_box/) - Retrieval-Augmented Generation solutions
 
 ## 🚀 Getting Started
 

apps/agentic_rag/README.md

@@ -50,8 +50,8 @@ Here you can find a result of using Chain of Thought (CoT) reasoning:
 1. Clone the repository and install dependencies:
 
     ```bash
-    git clone https://github.com/oracle-devrel/devrel-labs.git
-    cd devrel-labs/agentic_rag
+    git clone https://github.com/oracle-devrel/ai-solutions.git
+    cd ai-solutions/apps/agentic_rag
     pip install -r requirements.txt
     ```
 

apps/agentic_rag/articles/kubernetes_rag.md

@@ -85,8 +85,8 @@ Then, we can start setting up the solution in our cluster by following these ste
 1. Clone the repository containing the Kubernetes manifests:
 
   ```bash
-  git clone https://github.com/oracle-devrel/devrel-labs.git
-  cd devrel-labs/agentic_rag/k8s
+  git clone https://github.com/oracle-devrel/ai-solutions.git
+  cd ai-solutions/apps/agentic_rag/k8s
   ```
 
 2. Create a namespace:
@@ -188,4 +188,4 @@ The deployment of this solution requires the following minimum resources:
 
 ## Conclusion
 
-You can check out the full AI solution and the deployment options we mention in this article in [the official GitHub repository](https://github.com/oracle-devrel/devrel-labs/tree/main/agentic_rag).
+You can check out the full AI solution and the deployment options we mention in this article in [the official GitHub repository](https://github.com/oracle-devrel/ai-solutions/tree/main/apps/agentic_rag).

apps/agentic_rag/k8s/kustom/demo/deployment.yaml

@@ -101,13 +101,13 @@ spec:
           
           # Clone and set up the application
           cd /app
-          git clone -b agentic_rag_automation https://github.com/vmleon/devrel-labs.git
-          cd devrel-labs/agentic_rag
+          git clone -b "${GIT_BRANCH:-main}" https://github.com/oracle-devrel/ai-solutions.git
+          cd ai-solutions/apps/agentic_rag
           pip install -r requirements.txt
 
           # Move config.yaml file to agentic-rag folder
-          echo "Copying config.yaml to /app/devrel-labs/agentic_rag/config.yaml"
-          cp /app/config.yaml /app/devrel-labs/agentic_rag/config.yaml
+          echo "Copying config.yaml to /app/ai-solutions/apps/agentic_rag/config.yaml"
+          cp /app/config.yaml /app/ai-solutions/apps/agentic_rag/config.yaml
           
           # Start the Gradio app
           echo "Starting Gradio application..."

apps/agentic_rag/k8s/local-deployment/deployment.yaml

@@ -83,8 +83,8 @@ spec:
           
           # Clone and set up the application
           cd /app
-          git clone https://github.com/oracle-devrel/devrel-labs.git
-          cd devrel-labs/agentic_rag
+          git clone -b "${GIT_BRANCH:-main}" https://github.com/oracle-devrel/ai-solutions.git
+          cd ai-solutions/apps/agentic_rag
           pip install -r requirements.txt
           
           # Start the Gradio app

apps/langgraph_agent_with_genai/README.md

@@ -74,8 +74,8 @@ This blog demonstrates how to index PDF, Images, DOCx or TXT files using Python
 2. Let's start indexing the files  
   2.1 - On your shell machine, get the code and create your .env file 
     ````
-    git clone https://github.com/oracle-devrel/devrel-labs.git
-    cd langgraph_agent_with_genai/src
+    git clone https://github.com/oracle-devrel/ai-solutions.git
+    cd ai-solutions/apps/langgraph_agent_with_genai/src
     ## Create your .env file from the template
     cp .env_template .env 
     ```` 

apps/mongo-migration/mongodb2ora_migrationtools/migrate_all_collections.py

@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+
+import os
+import subprocess
+import configparser
+import logging
+from datetime import datetime
+
+# Configure logging
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(levelname)s - %(message)s',
+    filename='log/multi_collection_migration.log'
+)
+logger = logging.getLogger(__name__)
+
+def get_collections(mongo_url, db_name):
+    """Get list of collections from MongoDB"""
+    from pymongo import MongoClient
+    client = MongoClient(mongo_url)
+    db = client[db_name]
+    return db.list_collection_names()
+
+def update_config(config_file, collection_name):
+    """Update config.ini with new collection name"""
+    config = configparser.ConfigParser()
+    config.read(config_file)
+    config['mongodb']['collection'] = collection_name
+    with open(config_file, 'w') as f:
+        config.write(f)
+
+def migrate_collection(collection_name):
+    """Migrate a single collection"""
+    logger.info(f"Starting migration of collection: {collection_name}")
+    try:
+        # Update config with collection name
+        update_config('config/config.ini', collection_name)
+        
+        # Run migration script
+        result = subprocess.run(
+            ['python', 'mongo2ora_data.py'],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        
+        logger.info(f"Successfully migrated collection: {collection_name}")
+        logger.debug(f"Migration output: {result.stdout}")
+        
+    except subprocess.CalledProcessError as e:
+        logger.error(f"Failed to migrate collection {collection_name}: {e}")
+        logger.error(f"Error output: {e.stderr}")
+        raise
+    except Exception as e:
+        logger.error(f"Unexpected error during migration of {collection_name}: {e}")
+        raise
+
+def main():
+    # Read MongoDB connection details from config
+    config = configparser.ConfigParser()
+    config.read('config/config.ini')
+    
+    mongo_user = config['mongodb']['userid']
+    mongo_password = config['mongodb']['password']
+    mongo_host = config['mongodb']['hostname']
+    mongo_port = config['mongodb']['port']
+    mongo_db = config['mongodb']['sourcedb']
+    
+    # Construct MongoDB URL
+    mongo_url = f"mongodb://{mongo_user}:{mongo_password}@{mongo_host}:{mongo_port}/{mongo_db}"
+    
+    try:
+        # Get list of collections
+        collections = get_collections(mongo_url, mongo_db)
+        logger.info(f"Found {len(collections)} collections to migrate")
+        
+        # Migrate each collection
+        for collection in collections:
+            logger.info(f"Processing collection: {collection}")
+            migrate_collection(collection)
+            
+        logger.info("All collections migrated successfully")
+        
+    except Exception as e:
+        logger.error(f"Migration failed: {e}")
+        raise
+
+if __name__ == "__main__":
+    main() 

apps/mongo-migration/solutions/simple-migration/scripts/migrate_all_collections.py

@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+
+import os
+import subprocess
+import configparser
+import logging
+from datetime import datetime
+
+# Configure logging
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(levelname)s - %(message)s',
+    filename='log/multi_collection_migration.log'
+)
+logger = logging.getLogger(__name__)
+
+def get_collections(mongo_url, db_name):
+    """Get list of collections from MongoDB"""
+    from pymongo import MongoClient
+    client = MongoClient(mongo_url)
+    db = client[db_name]
+    return db.list_collection_names()
+
+def update_config(config_file, collection_name):
+    """Update config.ini with new collection name"""
+    config = configparser.ConfigParser()
+    config.read(config_file)
+    config['mongodb']['collection'] = collection_name
+    with open(config_file, 'w') as f:
+        config.write(f)
+
+def migrate_collection(collection_name):
+    """Migrate a single collection"""
+    logger.info(f"Starting migration of collection: {collection_name}")
+    try:
+        # Update config with collection name
+        update_config('config/config.ini', collection_name)
+        
+        # Run migration script
+        result = subprocess.run(
+            ['python', 'mongo2ora_data.py'],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        
+        logger.info(f"Successfully migrated collection: {collection_name}")
+        logger.debug(f"Migration output: {result.stdout}")
+        
+    except subprocess.CalledProcessError as e:
+        logger.error(f"Failed to migrate collection {collection_name}: {e}")
+        logger.error(f"Error output: {e.stderr}")
+        raise
+    except Exception as e:
+        logger.error(f"Unexpected error during migration of {collection_name}: {e}")
+        raise
+
+def main():
+    # Read MongoDB connection details from config
+    config = configparser.ConfigParser()
+    config.read('config/config.ini')
+    
+    mongo_user = config['mongodb']['userid']
+    mongo_password = config['mongodb']['password']
+    mongo_host = config['mongodb']['hostname']
+    mongo_port = config['mongodb']['port']
+    mongo_db = config['mongodb']['sourcedb']
+    
+    # Construct MongoDB URL
+    mongo_url = f"mongodb://{mongo_user}:{mongo_password}@{mongo_host}:{mongo_port}/{mongo_db}"
+    
+    try:
+        # Get list of collections
+        collections = get_collections(mongo_url, mongo_db)
+        logger.info(f"Found {len(collections)} collections to migrate")
+        
+        # Migrate each collection
+        for collection in collections:
+            logger.info(f"Processing collection: {collection}")
+            migrate_collection(collection)
+            
+        logger.info("All collections migrated successfully")
+        
+    except Exception as e:
+        logger.error(f"Migration failed: {e}")
+        raise
+
+if __name__ == "__main__":
+    main()