add testing to demo app (June 2025 delivery)

Author: timothywarner

.claude/settings.local.json

@@ -23,7 +23,12 @@
       "Bash(cp:*)",
       "Bash(git reset:*)",
       "Bash(git config:*)",
-      "Bash(git lfs:*)"
+      "Bash(git lfs:*)",
+      "Bash(npm install:*)",
+      "Bash(npm test:*)",
+      "Bash(node:*)",
+      "Bash(npm run test:unit:*)",
+      "Bash(npx jest:*)"
     ],
     "deny": []
   }

.cursorignore

@@ -0,0 +1 @@
+# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)

.env.example

@@ -1,53 +1,45 @@
 # =============================================================================
-# Azure AI Services Configuration - AI-900 Course
-# EXAMPLE FILE FOR LEARNERS - Replace with your actual values
+# Azure AI Services Configuration for AI-900 Demos and Tests
 # =============================================================================
 
-# Azure AI Services Multi-Service (Primary - use this for most demos)
-AI_SERVICES_ENDPOINT=https://YOUR_REGION.api.cognitive.microsoft.com/
-AI_SERVICES_KEY=YOUR_AI_SERVICES_KEY_HERE
-
-# Azure OpenAI Service
-AZURE_OPENAI_ENDPOINT=https://YOUR_OPENAI_RESOURCE_NAME.openai.azure.com/
-AZURE_OPENAI_KEY=YOUR_OPENAI_KEY_HERE
-
-# Speech Services
-SPEECH_SERVICE_ENDPOINT=https://YOUR_REGION.api.cognitive.microsoft.com/
-SPEECH_SERVICE_KEY=YOUR_SPEECH_KEY_HERE
-
-# Language Service
-LANGUAGE_SERVICE_ENDPOINT=https://YOUR_REGION.api.cognitive.microsoft.com/
-LANGUAGE_SERVICE_KEY=YOUR_LANGUAGE_KEY_HERE
-
-# Computer Vision Service
-COMPUTER_VISION_ENDPOINT=https://YOUR_REGION.api.cognitive.microsoft.com/
-COMPUTER_VISION_KEY=YOUR_COMPUTER_VISION_KEY_HERE
-
-# Document Intelligence Service
-DOCUMENT_INTELLIGENCE_ENDPOINT=https://YOUR_REGION.api.cognitive.microsoft.com/
-DOCUMENT_INTELLIGENCE_KEY=YOUR_DOCUMENT_INTELLIGENCE_KEY_HERE
-
-# Content Safety Service
-CONTENT_SAFETY_ENDPOINT=https://YOUR_REGION.api.cognitive.microsoft.com/
-CONTENT_SAFETY_KEY=YOUR_CONTENT_SAFETY_KEY_HERE
-
-# Custom Vision Services
-CUSTOM_VISION_TRAINING_ENDPOINT=https://YOUR_REGION.api.cognitive.microsoft.com/
-CUSTOM_VISION_TRAINING_KEY=YOUR_CUSTOM_VISION_TRAINING_KEY_HERE
-CUSTOM_VISION_PREDICTION_ENDPOINT=https://YOUR_REGION.api.cognitive.microsoft.com/
-CUSTOM_VISION_PREDICTION_KEY=YOUR_CUSTOM_VISION_PREDICTION_KEY_HERE
-
-# Search Service
-SEARCH_SERVICE_ENDPOINT=https://YOUR_SEARCH_SERVICE_NAME.search.windows.net/
-SEARCH_SERVICE_KEY=YOUR_SEARCH_KEY_HERE
-
-# Common Azure Settings
-AZURE_RESOURCE_GROUP=YOUR_RESOURCE_GROUP_NAME
-AZURE_LOCATION=YOUR_AZURE_REGION
-
-# =============================================================================
-# Instructions for Learners:
-# 1. Copy this file to .env
-# 2. Replace all YOUR_* placeholders with actual values from Azure Portal
-# 3. Never commit the .env file to version control (its in .gitignore)
-# =============================================================================
+# Multi-service key for Computer Vision, Language, and other cognitive capabilities
+AI_SERVICES_KEY=your_multi_service_key_here
+AI_SERVICES_ENDPOINT=https://your-region.api.cognitive.microsoft.com
+
+# Analyzes images for objects, faces, text recognition, and scene understanding
+COMPUTER_VISION_KEY=your_computer_vision_key_here
+COMPUTER_VISION_ENDPOINT=https://your-computervision-service.cognitiveservices.azure.com
+
+# Processes text for sentiment analysis, language detection, and key phrase extraction
+LANGUAGE_SERVICE_KEY=your_language_service_key_here
+LANGUAGE_SERVICE_ENDPOINT=https://your-language-service.cognitiveservices.azure.com
+
+# Extracts structured data from forms, receipts, invoices, and business documents
+DOCUMENT_INTELLIGENCE_KEY=your_form_recognizer_key_here
+DOCUMENT_INTELLIGENCE_ENDPOINT=https://your-formrecognizer-service.cognitiveservices.azure.com
+
+# Provides access to GPT models for chat completions and text generation
+AZURE_OPENAI_KEY=your_azure_openai_key_here
+AZURE_OPENAI_ENDPOINT=https://your-openai-service.openai.azure.com
+AZURE_OPENAI_DEPLOYMENT_NAME=gpt-35-turbo
+
+# Converts speech to text, text to speech, and provides real-time translation
+SPEECH_SERVICE_KEY=your_speech_service_key_here
+SPEECH_SERVICE_ENDPOINT=https://your-speech-service.cognitiveservices.azure.com
+SPEECH_SERVICE_REGION=your_region_here
+
+# Enables full-text search, semantic search, and AI-powered search suggestions
+SEARCH_SERVICE_KEY=your_search_admin_key_here
+SEARCH_SERVICE_ENDPOINT=https://your-search-service.search.windows.net
+SEARCH_INDEX_NAME=your_search_index_name
+
+# Detects harmful content, adult material, hate speech, and violence in text/images
+CONTENT_SAFETY_KEY=your_content_safety_key_here
+CONTENT_SAFETY_ENDPOINT=https://your-contentsafety-service.cognitiveservices.azure.com
+
+# Custom image classification and object detection models
+CUSTOM_VISION_PREDICTION_KEY=your_prediction_key_here
+CUSTOM_VISION_TRAINING_KEY=your_training_key_here
+CUSTOM_VISION_ENDPOINT=https://your-customvision-service.cognitiveservices.azure.com
+CUSTOM_VISION_PROJECT_ID=your_project_id_here
+CUSTOM_VISION_PUBLISHED_NAME=your_published_iteration_name

DISCUSSION-TEMPLATE.md

@@ -0,0 +1,87 @@
+# 🎓 Welcome O'Reilly Live Learning Students!
+
+Welcome to the AI-900 Microsoft Azure AI Fundamentals course repository! This discussion thread is specifically for students attending the O'Reilly Live Learning session.
+
+## 🚀 Getting Started with the Demo App
+
+1. **Clone the Repository**
+   ```bash
+   git clone https://github.com/timothywarner/ai900.git
+   cd ai900
+   npm install
+   ```
+
+2. **Set Up Your Azure Services**
+   - Copy `sample.env` to `.env`
+   - Add your Azure AI service credentials
+   - Need help? Ask here!
+
+3. **Run the Demos**
+   - Console: `npm start`
+   - Web Interface: `npm run web`
+
+## 💬 Discussion Topics
+
+### Before the Course
+- [ ] Introduce yourself! What's your background?
+- [ ] What are your AI/ML learning goals?
+- [ ] Any specific Azure AI services you're excited about?
+
+### During the Course
+- [ ] Share your "aha!" moments
+- [ ] Post questions about demos
+- [ ] Help fellow students with setup issues
+
+### After the Course
+- [ ] Share your certification journey
+- [ ] Post your AI-900 exam success stories
+- [ ] Connect with study partners
+
+## 🎯 Course Resources
+
+- **Slides**: Available during the live session
+- **Demo Code**: In the `/demos/` folder
+- **Practice Questions**: See README for links
+- **Azure Free Account**: https://azure.microsoft.com/free/
+
+## 🤝 Community Guidelines
+
+1. **Be Helpful**: Share solutions and insights
+2. **Be Respectful**: Everyone's learning journey is different
+3. **Be Specific**: When asking questions, include error messages
+4. **Be Generous**: Share resources and tips
+
+## 📅 Live Session Schedule
+
+- **Hour 1**: AI Fundamentals & Azure AI Platform
+- **Hour 2**: Machine Learning on Azure
+- **Hour 3**: Computer Vision Workloads
+- **Hour 4**: Natural Language Processing
+- **Hour 5**: Generative AI & Azure AI Foundry
+
+## 🆘 Common Issues & Solutions
+
+**Port 3000 in use?**
+```bash
+npm run force-close
+```
+
+**Missing environment variables?**
+- Check your `.env` file
+- Ensure you've created services in Azure Portal
+
+**Module not found?**
+```bash
+npm install
+```
+
+## 📧 Contact
+
+- **Instructor**: Tim Warner
+- **Email**: [email protected]
+- **LinkedIn**: [Timothy Warner](https://linkedin.com/in/timothywarner)
+- **Course Feedback**: Please share in O'Reilly platform
+
+---
+
+**Let's learn together! Drop a 👋 to say hello!**