SCORMScopeAI Training Search Platform

Overview

The SCORMScopeAI Training Search Platform is an enterprise-grade solution that transforms how HR professionals and employees access training materials. By leveraging Azure AI services, this platform processes hundreds of SCORM training packages and makes them instantly searchable through a modern web interface. Users can find relevant training content using natural language queries, eliminating the need to manually browse through complex folder structures or remember specific module names.

UI

Business Value

Current Challenges

Training materials are stored across multiple SCORM packages in Azure Blob Storage
Finding specific content requires manual navigation through nested folders
No way to search across all training materials simultaneously
Different content types (PDFs, videos, audio) are not uniformly accessible

Our Solution

Unified Search: One search box to query all training materials
AI-Powered Understanding: Natural language processing understands intent, not just keywords
Multi-Format Support: Seamlessly search across PDFs, videos, audio, and text content
Enterprise Scale: Processes hundreds of training packages automatically
Time Savings: Reduces content discovery time from hours to seconds

Architecture

┌─────────────────────┐     ┌─────────────────────┐     ┌─────────────────────┐
│   SCORM Packages    │────▶│  Backend Pipeline   │────▶│   Azure AI Search   │
│  (Azure Blob)       │     │  (Python/FastAPI)   │     │   (Vector Index)    │
└─────────────────────┘     └─────────────────────┘     └─────────────────────┘
                                      │                            │
                                      ▼                            ▼
┌─────────────────────┐     ┌─────────────────────┐     ┌─────────────────────┐
│    HR Users         │────▶│  Frontend Web App   │────▶│    Search API       │
│                     │     │  (Next.js/React)    │     │  (RAG-powered)      │
└─────────────────────┘     └─────────────────────┘     └─────────────────────┘

Key Features

For HR Professionals

Natural Language Search: Ask questions like "How do I report a safety incident?" instead of memorizing file names
Instant Results: Get relevant training materials in seconds
Source Citations: Every result shows exactly which training module it came from
Content Preview: See summaries before opening full documents

For IT Administrators

Automated Processing: New SCORM packages are automatically processed when added
Scalable Architecture: Built on Azure services that scale with demand
Security: Enterprise-grade security with Azure AD integration
Monitoring: Comprehensive logging and performance metrics

Technology Stack

Backend Services

Language: Python 3.11+
Framework: FastAPI for REST APIs
AI Services:
- Azure OpenAI (GPT-4) for query understanding and response generation
- Azure Document Intelligence for PDF processing
- Azure Computer Vision for image analysis
- Azure Speech Services for audio transcription
- Azure Video Indexer for video content analysis
Search: Azure AI Search with hybrid (keyword + vector) search
Storage: Azure Blob Storage for SCORM packages and processed content

Frontend Application

Framework: Next.js 15 with App Router
UI Library: React with TypeScript
Styling: Tailwind CSS with shadcn/ui components
State Management: React hooks and context
Package Manager: pnpm

Project Structure

SCORMScopeAI/
├── backend/
│   ├── 1_extractor/          # SCORM package extraction
│   ├── 2_text-processor/     # HTML/XML processing
│   ├── 3_pdf-processor/      # PDF analysis
│   ├── 4_image-processor/    # Image analysis
│   ├── 5_audio-processor/    # Audio transcription
│   ├── 6_video-processor/    # Video indexing
│   ├── 7_azure-ai-index/     # Search indexing
│   ├── scorm_chat/           # Search agent
│   ├── azure/                # Azure deployment configs
│   ├── app.py                # FastAPI application
│   ├── requirements.txt      # Python dependencies
│   └── .env                  # Environment variables
├── frontend/
│   ├── app/                  # Next.js app directory
│   ├── components/           # React components
│   ├── hooks/                # Custom React hooks
│   └── lib/                  # Utilities
└── docs/                     # Additional documentation

Quick Start

Prerequisites

Python 3.11 or higher
Node.js 20 or higher
pnpm package manager
Azure subscription with required services
Git

Backend Setup

Set up Python environment:

cd backend
python -m venv venv
venv\Scripts\activate  # On Windows
pip install -r requirements.txt

Configure environment variables:

# Copy the example environment file
copy .env.example .env
# Edit .env with your Azure credentials

Process SCORM packages:

# Extract SCORM packages
cd 1_extractor && python scorm_extractor.py

# Process content (run applicable processors)
cd ../2_text-processor && python text_files_extractor.py --all
cd ../3_pdf-processor && python azure_ai_doc_intel.py --all

# Index for search
cd ../7_azure-ai-index && python scorm_indexer.py

Start the API server:

cd ..
uvicorn app:app --reload

Frontend Setup

Navigate to frontend directory:

cd frontend

Install dependencies:

pnpm install

Configure environment:

copy .env.example .env.local
# Edit .env.local with API endpoint

Start development server:

pnpm dev

Open http://localhost:3000 in your browser

Deployment

Azure Deployment (Recommended)

The platform is designed for Azure deployment:

Backend: Deploy as Azure Container Instance or App Service
Frontend: Deploy to Azure Static Web Apps
Services: All Azure services are already cloud-native

Detailed deployment instructions are available in:

Docker Deployment

Both frontend and backend include Dockerfiles for containerized deployment:

# Build backend
cd backend
docker build -t SCORMScopeAI-backend .

# Build frontend
cd frontend
docker build -t SCORMScopeAI-frontend .

Usage Examples

Search Queries

The platform understands various types of queries:

Safety Questions: "What are the emergency evacuation procedures?"
Equipment Training: "How do I operate a forklift safely?"
Compliance: "What are the requirements for hazardous material handling?"
Procedures: "Steps for reporting a workplace incident"

API Usage

# Search via API
curl -X POST http://localhost:8000/scorm \
  -H "Content-Type: application/json" \
  -d '{"prompt": "chemical spill procedures"}'

Security Considerations

All Azure services use managed identities where possible
API keys are stored securely in Azure Key Vault
Frontend-backend communication uses HTTPS
User authentication via Azure AD (when deployed)
Content access controls based on user roles

Monitoring and Maintenance

Health Checks

Backend: /health endpoint
Frontend: /api/health endpoint
Azure Monitor integration for all services

Logs

Application logs in Azure Log Analytics
Search analytics for usage patterns
Performance metrics for optimization

Contributing

We welcome contributions! Please see our Contributing Guide for details on:

Code style and standards
Testing requirements
Pull request process
Issue reporting

Support

For support and questions:

Check the FAQ
Review Troubleshooting Guide
Contact the development team

License

This software is proprietary and confidential to SCORMScopeAI

Acknowledgments

This platform leverages cutting-edge Azure AI services to deliver an exceptional search experience for training content. Special thanks to the HR and IT teams for their valuable input during development.

Name		Name	Last commit message	Last commit date
Latest commit History 15 Commits
.vscode		.vscode
backend		backend
frontend		frontend
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
ui.png		ui.png

blazekids4/SCORMScopeAI

Folders and files

Latest commit

History

Repository files navigation