Spaces:

ayush-thakur02
/

self-help

Sleeping

App Files Files Community

ayush-thakur02 commited on Jun 28

Commit

07aa026

verified ·

1 Parent(s): 767fee0

Upload 9 files

Browse files

Files changed (9) hide show

.dockerignore +41 -0
Dockerfile +26 -0
blog-viewer.html +884 -0
blogs/azure-app-service.md +85 -0
blogs/azure-vm-setup.md +264 -0
blogs/itimesheet.md +68 -0
index.html +598 -0
requirements.txt +2 -0
server.py +282 -0

.dockerignore ADDED Viewed

	@@ -0,0 +1,41 @@

+# Git files
+.git
+.gitignore
+.gitattributes
+# Python cache
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.so
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+# Documentation
+README.md
+*.md
+!blogs/*.md
+# Other
+.dockerignore

Dockerfile ADDED Viewed

	@@ -0,0 +1,26 @@

+# Use Python 3.11 slim image for smaller size
+FROM python:3.11-slim
+# Set working directory
+WORKDIR /app
+# Set environment variables
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+# Install system dependencies if needed
+RUN apt-get update && apt-get install -y \
+    && rm -rf /var/lib/apt/lists/*
+# Copy all application files
+COPY . .
+# Create a non-root user for security
+RUN useradd -m -u 1000 user && chown -R user:user /app
+USER user
+# Expose the port that Hugging Face Spaces expects
+EXPOSE 7860
+# Command to run the application on port 7860 (Hugging Face default)
+CMD ["python", "server.py", "--port", "7860"]

blog-viewer.html ADDED Viewed

	@@ -0,0 +1,884 @@

+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Documentation Viewer</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Lexend:[email protected]&display=swap" rel="stylesheet">
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+            font-family: "Lexend", sans-serif;
+        }
+        body {
+            /* font-family: -apple-system, BlinkMacSystemFont, 'SF Pro Display', 'Segoe UI', Roboto, sans-serif; */
+            line-height: 1.5;
+            color: #1d1d1f;
+            background: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%);
+            /* background: black; */
+            min-height: 100vh;
+        }
+        .header {
+            background: rgba(255, 255, 255, 0.6);
+            backdrop-filter: blur(1px);
+            -webkit-backdrop-filter: blur(1px);
+            color: #1d1d1f;
+            padding: 16px;
+            border-bottom: 1px solid rgba(255, 255, 255, 0.2);
+            box-shadow: 0 0px 10px rgba(0, 0, 0, 0.1);
+            position: fixed;
+            top: 0;
+            margin: 10px;
+            border-radius: 20px;
+            z-index: 100;
+        }
+        .header-content {
+            /* max-width: 1200px; */
+            margin: 0 auto;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+        }
+        .header h1 {
+            font-size: 1.3rem;
+            font-weight: 600;
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+        #documentTitle {
+            background: rgba(255, 255, 255);
+            border: 1px solid rgba(0, 0, 0, 0.2);
+            border-radius: 15px;
+            padding: 10px 15px;
+            margin-right: 10px;
+        }
+        .back-btn {
+            background: rgba(0, 122, 255, 0.3);
+            backdrop-filter: blur(200px);
+            -webkit-backdrop-filter: blur(200px);
+            /* background: rgba(255, 255, 255); */
+            color: #007aff;
+            border: none;
+            padding: 8px 16px;
+            border-radius: 20px;
+            cursor: pointer;
+            text-decoration: none;
+            display: flex;
+            align-items: center;
+            gap: 6px;
+            font-size: 0.9rem;
+            font-weight: 500;
+            transition: all 0.3s ease;
+        }
+        .back-btn:hover {
+            background: rgba(0, 122, 255, 0.2);
+            transform: translateY(-1px);
+        }
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 24px 20px;
+            margin-top: 90px;
+        }
+        .document-meta {
+            background: rgba(255, 255, 255, 0.8);
+            backdrop-filter: blur(20px);
+            -webkit-backdrop-filter: blur(20px);
+            border: 1px solid rgba(255, 255, 255, 0.3);
+            border-radius: 12px;
+            padding: 16px;
+            margin-bottom: 20px;
+            border-left: 3px solid #007aff;
+        }
+        .meta-row {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 8px;
+        }
+        .meta-row:last-child {
+            margin-bottom: 0;
+        }
+        .meta-label {
+            font-weight: 600;
+            color: #007aff;
+            font-size: 0.9rem;
+        }
+        .meta-value {
+            color: #86868b;
+            font-size: 0.9rem;
+        }
+        .content {
+            background: rgba(255, 255, 255, 0.8);
+            backdrop-filter: blur(20px);
+            -webkit-backdrop-filter: blur(20px);
+            border: 1px solid rgba(255, 255, 255, 0.3);
+            border-radius: 12px;
+            padding: 32px;
+            min-height: 400px;
+        }
+        .loading {
+            text-align: center;
+            padding: 60px;
+            color: #007aff;
+            font-size: 1.1rem;
+        }
+        .error {
+            background: rgba(255, 59, 48, 0.1);
+            border: 1px solid rgba(255, 59, 48, 0.3);
+            color: #d70015;
+            padding: 20px;
+            border-radius: 12px;
+            text-align: center;
+        }
+        /* Markdown styling */
+        .markdown-content h1,
+        .markdown-content h2,
+        .markdown-content h3,
+        .markdown-content h4,
+        .markdown-content h5,
+        .markdown-content h6 {
+            margin-top: 2rem;
+            margin-bottom: 1rem;
+            font-weight: 600;
+            line-height: 1.25;
+        }
+        .markdown-content h1 {
+            font-size: 2rem;
+            border-bottom: 2px solid #eee;
+            padding-bottom: 0.5rem;
+        }
+        .markdown-content h2 {
+            font-size: 1.5rem;
+            border-bottom: 1px solid #eee;
+            padding-bottom: 0.3rem;
+        }
+        .markdown-content h3 {
+            font-size: 1.25rem;
+        }
+        .markdown-content p {
+            margin-bottom: 1rem;
+        }
+        .markdown-content ul,
+        .markdown-content ol {
+            margin-bottom: 1rem;
+            padding-left: 2rem;
+        }
+        .markdown-content li {
+            margin-bottom: 0.25rem;
+        }
+        .markdown-content blockquote {
+            border-left: 3px solid #007aff;
+            background: rgba(0, 122, 255, 0.05);
+            padding: 1rem;
+            margin: 1rem 0;
+            border-radius: 6px;
+            font-style: italic;
+        }
+        .markdown-content code {
+            background: rgba(0, 0, 0, 0.05);
+            padding: 0.2rem 0.4rem;
+            border-radius: 4px;
+            font-family: 'SF Mono', 'Monaco', 'Cascadia Code', 'Roboto Mono', monospace;
+            font-size: 0.9rem;
+        }
+        .markdown-content pre {
+            background: rgba(0, 0, 0, 0.05);
+            border: 1px solid rgba(0, 0, 0, 0.1);
+            border-radius: 8px;
+            padding: 1rem;
+            overflow-x: auto;
+            margin: 1rem 0;
+        }
+        .markdown-content pre code {
+            background: none;
+            padding: 0;
+        }
+        .markdown-content table {
+            border-collapse: collapse;
+            width: 100%;
+            margin: 1rem 0;
+        }
+        .markdown-content th,
+        .markdown-content td {
+            border: 1px solid #ddd;
+            padding: 0.75rem;
+            text-align: left;
+        }
+        .markdown-content th {
+            background: #f8f9fa;
+            font-weight: 600;
+        }
+        .markdown-content a {
+            color: #007aff;
+            text-decoration: none;
+        }
+        .markdown-content a:hover {
+            text-decoration: underline;
+        }
+        .markdown-content img {
+            max-width: 100%;
+            height: auto;
+            border-radius: 8px;
+            margin: 1rem 0;
+        }
+        /* Custom scrollbar */
+        ::-webkit-scrollbar {
+            width: 8px;
+        }
+        ::-webkit-scrollbar-track {
+            background: rgba(255, 255, 255, 0.1);
+        }
+        ::-webkit-scrollbar-thumb {
+            background: rgba(0, 0, 0, 0.2);
+            border-radius: 4px;
+        }
+        ::-webkit-scrollbar-thumb:hover {
+            background: rgba(0, 0, 0, 0.3);
+        }
+        @media (max-width: 768px) {
+            .header-content {
+                flex-direction: column;
+                gap: 15px;
+                text-align: center;
+            }
+            .container {
+                padding: 20px 15px;
+            }
+            .content {
+                padding: 20px;
+            }
+            .meta-row {
+                flex-direction: column;
+                align-items: flex-start;
+                gap: 5px;
+            }
+        }
+    </style>
+    <!-- Include marked.js for markdown parsing -->
+    <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
+</head>
+<body>
+    <div class="header">
+        <div class="header-content">
+            <h1>
+                <!-- <span>📄</span> -->
+                <span id="documentTitle">Loading Document...</span>
+            </h1>
+            <a href="javascript:void(0)" class="back-btn" onclick="window.close()">
+                <!-- <span>←</span> -->
+                <span>Close</span>
+            </a>
+        </div>
+    </div>
+    <div class="container">
+        <div class="document-meta" id="documentMeta" style="display: none;">
+            <div class="meta-row">
+                <span class="meta-label">📁 File:</span>
+                <span class="meta-value" id="fileName"></span>
+            </div>
+            <div class="meta-row">
+                <span class="meta-label">📅 Last Modified:</span>
+                <span class="meta-value" id="lastModified"></span>
+            </div>
+            <div class="meta-row">
+                <span class="meta-label">📊 Size:</span>
+                <span class="meta-value" id="fileSize"></span>
+            </div>
+        </div>
+        <div class="content">
+            <div class="loading" id="loadingState">
+                📖 Loading document content...
+            </div>
+            <div id="markdownContent" class="markdown-content" style="display: none;"></div>
+        </div>
+    </div>
+    <script>
+        class BlogViewer {
+            constructor() {
+                this.filename = this.getQueryParameter('file');
+                this.documentTitle = document.getElementById('documentTitle');
+                this.documentMeta = document.getElementById('documentMeta');
+                this.fileName = document.getElementById('fileName');
+                this.lastModified = document.getElementById('lastModified');
+                this.fileSize = document.getElementById('fileSize');
+                this.loadingState = document.getElementById('loadingState');
+                this.markdownContent = document.getElementById('markdownContent');
+                this.init();
+            }
+            getQueryParameter(name) {
+                const urlParams = new URLSearchParams(window.location.search);
+                return urlParams.get(name);
+            }
+            async init() {
+                if (!this.filename) {
+                    this.showError('No file specified');
+                    return;
+                }
+                try {
+                    await this.loadMarkdownFile();
+                } catch (error) {
+                    this.showError('Failed to load the document');
+                }
+            }
+            async loadMarkdownFile() {
+                try {
+                    // First, try to get file metadata from the API
+                    let fileMetadata = null;
+                    try {
+                        const metaResponse = await fetch('./api/blogs');
+                        if (metaResponse.ok) {
+                            const blogs = await metaResponse.json();
+                            fileMetadata = blogs.find(blog => blog.filename === this.filename);
+                        }
+                    } catch (error) {
+                        console.log('Could not fetch metadata from API:', error);
+                    }
+                    // Try to fetch the actual markdown file
+                    const response = await fetch(`./blogs/${this.filename}`);
+                    if (!response.ok) {
+                        // If file doesn't exist, show sample content
+                        this.showSampleContent();
+                        return;
+                    }
+                    const markdownText = await response.text();
+                    this.renderMarkdown(markdownText);
+                    this.updateMetadata(false, fileMetadata);
+                } catch (error) {
+                    // Fallback to sample content
+                    this.showSampleContent();
+                }
+            }
+            showSampleContent() {
+                const sampleContent = this.getSampleContent();
+                this.renderMarkdown(sampleContent);
+                this.updateMetadata(true, null);
+            }
+            getSampleContent() {
+                const samples = {
+                    'getting-started.md': `# Getting Started Guide
+Welcome to our platform! This guide will help you get up and running quickly.
+## Prerequisites
+Before you begin, make sure you have:
+- A modern web browser
+- Basic understanding of web technologies
+- Access to our platform
+## Quick Start
+1. **Sign up for an account**
+   - Visit our registration page
+   - Fill in your details
+   - Verify your email address
+2. **Set up your profile**
+   - Add your personal information
+   - Configure your preferences
+   - Upload a profile picture
+3. **Create your first project**
+   - Click on "New Project"
+   - Choose a template or start from scratch
+   - Give your project a name
+## Next Steps
+Once you've completed the initial setup:
+- Explore our [API Documentation](./api-documentation.md)
+- Check out the [Troubleshooting Guide](./troubleshooting.md)
+- Join our community forums
+> **Tip:** Don't forget to bookmark this documentation for easy access!
+## Need Help?
+If you run into any issues, please:
+1. Check our FAQ section
+2. Search our knowledge base
+3. Contact our support team
+---
+*Last updated: June 28, 2025*`,
+                    'api-documentation.md': `# API Documentation
+Complete reference for all API endpoints, authentication, and usage examples.
+## Authentication
+All API requests require authentication using API keys.
+### Getting Your API Key
+1. Log into your dashboard
+2. Navigate to Settings > API Keys
+3. Click "Generate New Key"
+4. Store it securely - it won't be shown again
+### Using Your API Key
+Include your API key in the header of all requests:
+\`\`\`
+Authorization: Bearer YOUR_API_KEY
+Content-Type: application/json
+\`\`\`
+## Base URL
+All API endpoints are relative to:
+\`\`\`
+https://api.yourcompany.com/v1/
+\`\`\`
+## Endpoints
+### Users
+#### Get User Profile
+\`\`\`
+GET /users/me
+\`\`\`
+**Response:**
+\`\`\`json
+{
+  "id": "12345",
+  "name": "John Doe",
+  "email": "[email protected]",
+  "created_at": "2025-01-01T00:00:00Z"
+}
+\`\`\`
+#### Update User Profile
+\`\`\`
+PUT /users/me
+\`\`\`
+**Request Body:**
+\`\`\`json
+{
+  "name": "John Smith",
+  "email": "[email protected]"
+}
+\`\`\`
+### Projects
+#### List Projects
+\`\`\`
+GET /projects
+\`\`\`
+**Query Parameters:**
+- \`limit\` (optional): Number of results (default: 10)
+- \`offset\` (optional): Pagination offset (default: 0)
+#### Create Project
+\`\`\`
+POST /projects
+\`\`\`
+**Request Body:**
+\`\`\`json
+{
+  "name": "My Project",
+  "description": "Project description",
+  "settings": {
+    "public": false
+  }
+}
+\`\`\`
+## Error Handling
+All errors follow this format:
+\`\`\`json
+{
+  "error": {
+    "code": "INVALID_REQUEST",
+    "message": "The request is invalid",
+    "details": "Additional error information"
+  }
+}
+\`\`\`
+### Common Error Codes
+| Code | Description |
+|------|-------------|
+| \`UNAUTHORIZED\` | Invalid or missing API key |
+| \`FORBIDDEN\` | Insufficient permissions |
+| \`NOT_FOUND\` | Resource not found |
+| \`RATE_LIMITED\` | Too many requests |
+## Rate Limits
+- **Free Plan:** 100 requests per hour
+- **Pro Plan:** 1,000 requests per hour
+- **Enterprise:** Custom limits
+## SDKs and Libraries
+We provide official SDKs for:
+- **JavaScript/Node.js:** \`npm install @yourcompany/api-client\`
+- **Python:** \`pip install yourcompany-api\`
+- **PHP:** Available via Composer
+---
+*For more examples and advanced usage, visit our [GitHub repository](https://github.com/yourcompany/api-examples).*`,
+                    'troubleshooting.md': `# Troubleshooting Guide
+Common issues and their solutions to help you resolve problems quickly.
+## Authentication Issues
+### Problem: "Invalid API Key" Error
+**Symptoms:**
+- Receiving 401 Unauthorized responses
+- Error message mentions invalid API key
+**Solutions:**
+1. **Check your API key format**
+   - Ensure it starts with the correct prefix
+   - Verify there are no extra spaces or characters
+2. **Verify key permissions**
+   - Log into your dashboard
+   - Check that the key has the required permissions
+   - Regenerate the key if necessary
+3. **Check request headers**
+   \`\`\`
+   Authorization: Bearer YOUR_API_KEY
+   Content-Type: application/json
+   \`\`\`
+### Problem: Rate Limiting
+**Symptoms:**
+- Receiving 429 Too Many Requests
+- Requests being rejected
+**Solutions:**
+1. **Implement exponential backoff**
+2. **Upgrade your plan** for higher limits
+3. **Cache responses** to reduce API calls
+## Connection Issues
+### Problem: Timeout Errors
+**Possible Causes:**
+- Network connectivity issues
+- Server overload
+- Large request payloads
+**Solutions:**
+1. **Increase timeout values**
+   \`\`\`javascript
+   // Example in JavaScript
+   fetch(url, {
+     timeout: 30000 // 30 seconds
+   })
+   \`\`\`
+2. **Implement retry logic**
+   \`\`\`python
+   # Example in Python
+   import time
+   import requests
+   def retry_request(url, max_retries=3):
+       for attempt in range(max_retries):
+           try:
+               response = requests.get(url, timeout=30)
+               return response
+           except requests.Timeout:
+               if attempt < max_retries - 1:
+                   time.sleep(2 ** attempt)  # Exponential backoff
+               else:
+                   raise
+   \`\`\`
+3. **Break large requests into smaller chunks**
+## Data Issues
+### Problem: Unexpected Response Format
+**Symptoms:**
+- Missing expected fields
+- Different data types than documented
+**Solutions:**
+1. **Check API version**
+   - Ensure you're using the correct API version
+   - Update your client library if needed
+2. **Validate request parameters**
+   - Check parameter names and types
+   - Review the documentation for changes
+3. **Handle optional fields gracefully**
+   \`\`\`javascript
+   // Safe property access
+   const name = user.name || 'Unknown User';
+   const email = user.email || '';
+   \`\`\`
+## Performance Issues
+### Problem: Slow Response Times
+**Common Causes:**
+- Inefficient queries
+- Large datasets
+- Network latency
+**Optimization Tips:**
+1. **Use pagination**
+   \`\`\`
+   GET /api/items?limit=10&offset=0
+   \`\`\`
+2. **Request only needed fields**
+   \`\`\`
+   GET /api/users?fields=id,name,email
+   \`\`\`
+3. **Implement caching**
+   - Use HTTP caching headers
+   - Implement client-side caching
+   - Consider CDN for static resources
+## Integration Issues
+### Problem: Webhook Delivery Failures
+**Symptoms:**
+- Webhooks not being received
+- Delayed or duplicate deliveries
+**Solutions:**
+1. **Verify endpoint availability**
+   - Ensure your endpoint is publicly accessible
+   - Check firewall and security settings
+2. **Return proper HTTP status codes**
+   - Return 200 for successful processing
+   - Return 4xx for client errors
+   - Return 5xx for server errors
+3. **Implement idempotency**
+   \`\`\`javascript
+   // Track processed webhook IDs
+   const processedWebhooks = new Set();
+   function handleWebhook(webhookId, data) {
+     if (processedWebhooks.has(webhookId)) {
+       return; // Already processed
+     }
+     // Process webhook
+     processWebhookData(data);
+     processedWebhooks.add(webhookId);
+   }
+   \`\`\`
+## Getting Additional Help
+If you're still experiencing issues:
+1. **Check our status page** - [status.yourcompany.com](https://status.yourcompany.com)
+2. **Search our community forums** - Common issues are often discussed
+3. **Contact support** - Include:
+   - Error messages
+   - Request/response examples
+   - Timestamps
+   - Your account ID
+### Support Channels
+- **Email:** [email protected]
+- **Chat:** Available in your dashboard
+- **Phone:** +1-555-0123 (Business hours)
+---
+*This guide is updated regularly. Last revision: June 28, 2025*`
+                };
+                return samples[this.filename] || `# ${this.filename}
+This is a sample document. To see actual content, add your markdown files to the \`blogs\` folder.
+## Getting Started
+1. Create your markdown files in the \`blogs\` directory
+2. Add your content using standard markdown syntax
+3. The documentation hub will automatically list and display them
+## Markdown Features Supported
+- **Headers** (H1-H6)
+- **Lists** (ordered and unordered)
+- **Links** and images
+- **Code blocks** and inline code
+- **Tables**
+- **Blockquotes**
+- And much more!
+---
+*Add your own content to replace this sample.*`;
+            }
+            renderMarkdown(markdownText) {
+                try {
+                    // Configure marked options
+                    marked.setOptions({
+                        breaks: true,
+                        gfm: true,
+                        highlight: function (code, lang) {
+                            // Simple syntax highlighting placeholder
+                            return code;
+                        }
+                    });
+                    const htmlContent = marked.parse(markdownText);
+                    this.loadingState.style.display = 'none';
+                    this.markdownContent.innerHTML = htmlContent;
+                    this.markdownContent.style.display = 'block';
+                    // Update page title
+                    const firstHeading = this.markdownContent.querySelector('h1');
+                    if (firstHeading) {
+                        this.documentTitle.textContent = firstHeading.textContent;
+                        document.title = firstHeading.textContent;
+                    } else {
+                        this.documentTitle.textContent = this.filename;
+                        document.title = this.filename;
+                    }
+                } catch (error) {
+                    this.showError('Failed to render the document');
+                }
+            }
+            updateMetadata(isSample = false, fileMetadata = null) {
+                this.fileName.textContent = this.filename;
+                if (fileMetadata) {
+                    // Use actual file metadata from server
+                    this.lastModified.textContent = fileMetadata.lastModified;
+                    this.fileSize.textContent = fileMetadata.size;
+                } else if (isSample) {
+                    // Sample content
+                    this.lastModified.textContent = new Date().toLocaleDateString();
+                    this.fileSize.textContent = 'Sample Content';
+                } else {
+                    // Fallback when no metadata available
+                    this.lastModified.textContent = new Date().toLocaleDateString();
+                    this.fileSize.textContent = 'File Size Unavailable';
+                }
+                this.documentMeta.style.display = 'block';
+            }
+            showError(message) {
+                this.loadingState.style.display = 'none';
+                this.markdownContent.innerHTML = `
+                    <div class="error">
+                        <h3>⚠️ Error</h3>
+                        <p>${message}</p>
+                        <p>Please check if the file exists in the blogs directory.</p>
+                    </div>
+                `;
+                this.markdownContent.style.display = 'block';
+                this.documentTitle.textContent = 'Error Loading Document';
+            }
+        }
+        // Initialize the blog viewer
+        document.addEventListener('DOMContentLoaded', () => {
+            new BlogViewer();
+        });
+    </script>
+</body>
+</html>

blogs/azure-app-service.md ADDED Viewed

	@@ -0,0 +1,85 @@

+# Azure App Service Hosting Guide
+In this guide, we will walk through the process of setting up Azure App Service hosting for your application. This includes creating a new App Service plan, configuring the App Service, and setting up networking and private endpoints. Let's dive right in!
+## Step 1: Create a New App Service Plan
+### 1.1 Navigate to the Azure Portal
+* Go to your **Azure Portal**.
+* Select **App Service Plans** under the **App Services** section.
+### 1.2 Create the Plan
+* Click on **+ Add** to create a new App Service Plan.
+* Under **Resource Group**, select the existing group `DBS_HDU_MAIN`.
+* Enter a unique **name** for your plan.
+* Choose the **Operating System** (Windows or Linux).
+* Set the **Region** to **Central India**.
+* Select a pricing plan that fits your requirements. Ensure the plan supports up to 16 GB of RAM (no GUP).
+### 1.3 Finalize and Create
+* Once all fields are filled, click on **Create** to provision the plan.
+## Step 2: Configure the App Service
+### 2.1 Create the App Service
+* Navigate to the **App Services** section in the Azure portal.
+* Under **Resource Group**, select the same group `DBS_HDU_MAIN`.
+* Enter an **App Name** for your application.
+* Select **Code** as the hosting option.
+* Choose the **Runtime Stack** (such as Node.js, Python, etc.).
+* Select **Linux** for the operating system.
+* In the **Pricing Plan** section, select the plan created in Step 1.
+### 2.2 Network Configuration
+* **Enable Public Access** should be turned **off**.
+* Turn on **Virtual Network Integration** and select **Default**.
+* Under **Inbound Access**, turn on the switch.
+* Enter a **Private Endpoint Name** under Inbound Access.
+* Select an **Inbound Subnet** from the available options.
+* Set **DNS** to **Manual**.
+* Enable **Outbound Access** and select the available option.
+### 2.3 Review and Create
+* Once you have reviewed the settings, click on **Review + Create**.
+* If there are no issues, click on **Create** to deploy the app.
+> **Note:** The process might fail at first, but don't worry—your app will still be deployed. Just proceed to the next steps.
+## Step 3: Add Private Endpoint (If Required)
+If the private endpoint is not showing up, you will need to manually configure it.
+### 3.1 Access Networking Settings
+* Go to the **App Service** settings page.
+* Under **Networking**, check if there is a private endpoint listed.
+  * If it shows **0**, click on **Add New (Advanced)** to configure the endpoint.
+### 3.2 Configure the Private Endpoint
+* Under **Resource Group**, select `DBS_HDU_MAIN`.
+* Fill in the necessary **Instance Details**.
+* In the **Virtual Network** tab, select the appropriate subnet with an available IP.
+* Go to **DNS**, and select **GTM-LZ-Central India** for the subscription.
+* The **Resource Group** will be auto-selected.
+### 3.3 Review and Create
+* After reviewing the settings, click **Create**.
+## Step 4: Clean Up Unused Private Endpoints
+To ensure proper networking setup, make sure you have only one active private endpoint.
+* If there are any unused private endpoints, remove them from the configuration.
+## Final Thoughts
+After completing these steps, your app should be successfully hosted on Azure with private network access configured. Keep an eye on the settings, especially the private endpoints, to ensure smooth performance and secure networking for your application.

blogs/azure-vm-setup.md ADDED Viewed

	@@ -0,0 +1,264 @@

+# Azure Virtual Machine Setup and Troubleshooting Guide
+## Point of Contact
+For any issues related to Azure instances or troubleshooting errors that persist even after referring to the Standard Operating Procedure (SOP) document, please reach out to the following contacts:
+* **Git-Content Team**: [[email protected]](mailto:[email protected])
+* **GIT Cloud-LZSupport-Azure**: [[email protected]](mailto:[email protected])
+## Introduction
+Setting up and creating an Azure Virtual Machine (AVM) requires a systematic approach. In this guide, we will cover the key steps involved in the process and provide troubleshooting advice for common issues that may arise.
+## Steps for Creating and Configuring AVM
+### 1. Configure VM
+* **URL**: [Azure Virtual Desktop](https://client.wvd.microsoft.com/arm/webclient/index.html)
+#### Process:
+1. Get added to the **Desktop (DBS-HDU\_POC)** group. Once access is granted (usually within 24 hours), you will be able to log in to Azure Virtual Desktop.
+2. Double-click on the Desktop shortcut to access the Virtual Machine.
+3. **Common Issue**: If the connection fails on the first attempt, minimize the window and enter your HCL credentials when prompted. If the login window does not appear automatically, it will show once you minimize the screen.
+4. Once connected, visit the Azure portal by navigating to [Azure Portal](https://portal.azure.com/) and enter your credentials to access your environment.
+### 2. Switch to HCL Directory
+If you are logged into a client directory, follow these steps to switch to the HCL directory:
+1. Click on your profile picture at the top right.
+2. Select **Switch Directory** and ensure the **HCL TECH** directory is active.
+### 3. Create and Use AVM
+To create the AVM using an existing resource group (e.g., `RG-Prabhat`), follow these steps:
+1. In the Azure Portal, click **Virtual Machine** from the homepage.
+2. Select **Create** > **Azure Virtual Machine**.
+3. Choose the **Existing Resource Group** (e.g., `RG-Prabhat`).
+4. Under **Image**, select **Shared Images** and pick the appropriate image.
+5. **Networking**:
+   * Select the Virtual Network: `DBS-HDU-spoke-vnet`
+   * Subnet: `DBS-HDU-pep-subnet (10.131.108.48/28)`
+   * Public IP: **None**
+6. Click **Create** to finalize the VM creation.
+### 4. Configuring AVM
+#### Windows Proxy Settings
+To ensure smooth connectivity, you need to set up proxy configurations and environment variables.
+1. **Configure Proxy Settings**:
+   * Contact **[[email protected]](mailto:[email protected])** for assistance in enabling URL access or solving connectivity issues.
+2. **System Variables**:
+   * Edit the system variables to include `http_proxy` and `https_proxy` with the value: `http://199.19.250.205:80`.
+#### PIP.ini File for Trusted Hosts
+1. Navigate to the **AVM** and open **This PC** > **Disk C** > **Temp**.
+2. Create a new text file, add the following content, and rename it to **pip.ini**:
+   ```ini
+   [global]
+   trusted-host = pypi.python.org
+                  pypi.org
+                  files.pythonhosted.org
+                  huggingface.co
+   ```
+3. Save the file.
+#### SSL Certificate Installation
+1. Install the SSL certificates by following the **Certificate Installation SOP** document.
+2. **ActiveX Control**: Ensure ActiveX control is enabled on the machine.
+#### Proxy Configuration in VS Code
+1. Open **VS Code** and navigate to **Settings**.
+2. Search for **Proxy** and edit the proxy settings as instructed in the SOP.
+### 5. Common Errors and Solutions
+#### Error: **Pip Installation SSL Certificate Issues**
+If you encounter SSL certificate errors during `pip install`:
+1. Open the certificate file provided in the SOP as **Notepad\_1**.
+2. In **VS Code Terminal**, run the following command:
+   ```bash
+   pip install --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org certify
+   ```
+3. Run the following Python code:
+   ```python
+   import certify
+   print(certify.where())
+   ```
+4. Copy the file path output and open the corresponding file in Notepad (**Notepad\_2**).
+5. Append the contents from **Notepad\_1** to the end of **Notepad\_2** and save the file.
+#### Error: **Private Endpoint Error**
+If you receive an error such as:
+```
+openai.PermissionDeniedError: Error code: 403 - {'error': {'code': '403', 'message': 'Public access is disabled. Please configure private endpoint.'}}
+```
+Solution: Use the following one-liner code to bypass this error:
+```python
+os.environ["NO_PROXY"] = "https://prabhatopenaiservice.openai.azure.com"
+```
+### 6. Existing AVM from Resource Group
+To access an existing AVM from a resource group:
+1. In the **Azure Portal**, click on the **Resource Group**.
+2. Select **Virtual Machine** and click **Connect**.
+3. Download the **RDP** file and open it.
+4. Enter your credentials to connect to the VM.
+### 7. Test Functionality
+Once your AVM is configured, run the following tests to ensure everything is set up correctly:
+#### Test 1: Pip Installation and API Access
+```python
+import os
+from dotenv import load_dotenv
+from langchain_openai import AzureChatOpenAI
+from langchain_core.messages import SystemMessage, HumanMessage
+# Load environment variables
+load_dotenv()
+os.environ["NO_PROXY"] = "https://prabhatopenaiservice.openai.azure.com"
+# Initialize OpenAI API client
+AZURE_OPENAI_API_KEY = os.getenv("AZURE_OPENAI_API_KEY")
+AZURE_OPENAI_ENDPOINT = os.getenv("AZURE_OPENAI_ENDPOINT")
+AZURE_OPENAI_DEPLOYMENT_NAME = os.getenv("AZURE_OPENAI_DEPLOYMENT_NAME")
+AZURE_OPENAI_API_VERSION = os.getenv("AZURE_OPENAI_API_VERSION")
+AZURE_OPENAI_TEMPERATURE = float(os.getenv("AZURE_OPENAI_TEMPERATURE"))
+llm = AzureChatOpenAI(
+    azure_endpoint=AZURE_OPENAI_ENDPOINT,
+    azure_deployment=AZURE_OPENAI_DEPLOYMENT_NAME,
+    api_key=AZURE_OPENAI_API_KEY,
+    api_version=AZURE_OPENAI_API_VERSION,
+    temperature=AZURE_OPENAI_TEMPERATURE,
+)
+# Test querying a document
+with open("demo.txt", "r", encoding="utf-8") as f:
+    document_content = f.read()
+system_prompt = "You are a helpful assistant that answers questions based on the given document."
+user_query = "Who is the highest run scorer in BGT history?"
+messages = [
+    SystemMessage(content=system_prompt),
+    HumanMessage(content=f"Document:\n{document_content}\n\nQuestion: {user_query}")
+]
+response = llm.invoke(messages)
+print(response.content)
+```
+#### Test 2: Hugging Face Model and Embeddings
+```python
+import transformers
+pipeline = transformers.pipeline(
+    "text-generation",
+    model="microsoft/phi-4",
+    model_kwargs={"torch_dtype": "auto"},
+    device_map="auto",
+)
+messages = [
+    {"role": "system", "content": "You are a medieval knight and must provide explanations to modern people."},
+    {"role": "user", "content": "How should I explain the Internet?"},
+]
+outputs = pipeline(messages, max_new_tokens=128)
+print(outputs[0]["generated_text"][-1])
+```
+#### Test 3: FAISS Indexing and Search
+```python
+import time
+import faiss
+import numpy as np
+# Start test
+start_time = time.time()
+# Create dummy vectors
+embedding_dim = 384
+num_vectors = 100
+db_vectors = np.random.random((num_vectors, embedding_dim)).astype('float32')
+query_vector = np.random.random((1, embedding_dim)).astype('float32')
+# Build FAISS index
+index = faiss.IndexFlatL2(embedding_dim)
+index.add(db_vectors)
+# Perform search
+k = 5
+distances, indices = index.search(query_vector, k)
+print(f"Search results: {distances}, {indices}")
+# End test
+end_time = time.time()
+print(f"Test 3 Finished in {end_time - start_time:.2f} seconds")
+```

blogs/itimesheet.md ADDED Viewed

	@@ -0,0 +1,68 @@

+# How to Fill Timesheets
+Filling out your timesheet in the **MyHCL** portal can be straightforward if you follow the right steps. Whether you're new to the portal or just need a refresher, here’s a quick guide to help you log your hours seamlessly.
+## 🔐 Step 1: Log in to MyHCL
+Start by visiting [**myhcl.com**](https://www.myhcl.com) and log in using your HCL credentials.
+## 🔍 Step 2: Search for iTimesheet
+Once logged in:
+* Locate the **search bar** on the homepage.
+* Type **iTimesheet** into the search field.
+* Click on the **iTimesheet** link from the results.
+## ➕ Step 3: Add/Edit Project, Phase & Activity
+After opening the iTimesheet portal:
+1. Click on **Add/Edit Project/Phase/Activity**.
+2. A modal window will appear. In this window:
+   * Select **Project**: Choose `hclt`
+   * Select your assigned project: `DBS GENAI`
+   * Choose the appropriate **Phase**
+   * Choose the relevant `Activity`
+3. Click **Save and Proceed** to continue.
+## 📝 Step 4: Fill Your Timesheet
+Now that your project details are set up:
+* Navigate to the respective date slots.
+* Enter your working hours or activities as required.
+* Double-check for accuracy.
+> ⚠️ **Important Note:**
+> Make sure to fill your timesheet **only for the current week**.
+> Filling out past or future weeks may result in being **marked absent**.
+## ✅ Step 5: Submit for Approval
+Once you have filled in all your time entries:
+* Click on **Submit for Approval**.
+Your timesheet will now be forwarded to your reporting manager or supervisor for approval.
+## 🎉 That’s It!
+By following these steps, you'll ensure your time is accurately logged and submitted on time. Make it a weekly habit to avoid last-minute rushes or missed deadlines.
+Happy working! 💼

index.html ADDED Viewed

	@@ -0,0 +1,598 @@

+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>AI HDU - Self Help Desk</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Lexend:[email protected]&display=swap" rel="stylesheet">
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+            font-family: "Lexend", sans-serif;
+        }
+        body {
+            /* font-family: -apple-system, BlinkMacSystemFont, 'SF Pro Display', 'Segoe UI', Roboto, sans-serif; */
+            line-height: 1.5;
+            color: #1d1d1f;
+            background: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%);
+            min-height: 100vh;
+            overflow-x: hidden;
+        }
+        /* Top Navigation Bar */
+        .top-nav {
+            position: fixed;
+            top: 0;
+            left: 0;
+            right: 0;
+            height: 60px;
+            background: rgba(255, 255, 255, 0.6);
+            backdrop-filter: blur(10px);
+            -webkit-backdrop-filter: blur(10px);
+            border-bottom: 1px solid rgba(255, 255, 255, 0.2);
+            z-index: 1000;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            margin: 10px;
+            border-radius: 20px;
+            box-shadow: 0 0px 10px rgba(0, 0, 0, 0.1);
+        }
+        .nav-content {
+            /* max-width: 1200px; */
+            width: 100%;
+            padding: 0 24px;
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+        }
+        .nav-title {
+            font-size: 1.1rem;
+            font-weight: 600;
+            color: #1d1d1f;
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+        .nav-stats {
+            font-size: 0.85rem;
+            color: #86868b;
+            display: flex;
+            align-items: center;
+            gap: 16px;
+        }
+        /* Main Container */
+        .container {
+            max-width: 1400px;
+            margin: 0 auto;
+            padding: 80px 20px 120px;
+        }
+        /* Content Grid */
+        .blog-grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+            gap: 16px;
+            margin-top: 20px;
+        }
+        .blog-card {
+            background: rgba(255, 255, 255, 0.8);
+            backdrop-filter: blur(20px);
+            -webkit-backdrop-filter: blur(20px);
+            border: 1px solid rgba(255, 255, 255, 0.3);
+            border-radius: 12px;
+            padding: 16px;
+            transition: all 0.3s cubic-bezier(0.25, 0.46, 0.45, 0.94);
+            cursor: pointer;
+            position: relative;
+            overflow: hidden;
+        }
+        .blog-card:hover {
+            transform: translateY(-2px);
+            background: rgba(255, 255, 255, 0.9);
+            border-color: rgba(0, 122, 255, 0.3);
+            box-shadow: 0 8px 25px rgba(0, 0, 0, 0.15);
+        }
+        .blog-title {
+            font-size: 1.1rem;
+            font-weight: 600;
+            color: #1d1d1f;
+            margin-bottom: 6px;
+            line-height: 1.3;
+            display: -webkit-box;
+            -webkit-line-clamp: 2;
+            line-clamp: 2;
+            -webkit-box-orient: vertical;
+            overflow: hidden;
+        }
+        .blog-excerpt {
+            color: #86868b;
+            margin-bottom: 12px;
+            line-height: 1.4;
+            font-size: 0.9rem;
+            display: -webkit-box;
+            -webkit-line-clamp: 2;
+            line-clamp: 2;
+            -webkit-box-orient: vertical;
+            overflow: hidden;
+        }
+        .blog-meta {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            font-size: 0.8rem;
+            color: #86868b;
+        }
+        .blog-date {
+            color: #007aff;
+            font-weight: 500;
+        }
+        .blog-size {
+            background: rgba(0, 122, 255, 0.1);
+            color: #007aff;
+            padding: 2px 6px;
+            border-radius: 6px;
+            font-weight: 500;
+        }
+        .match-indicators {
+            font-size: 0.75rem;
+            color: #007aff;
+            margin-bottom: 6px;
+            font-weight: 500;
+        }
+        /* Floating Search Bar */
+        .search-container {
+            position: fixed;
+            bottom: 24px;
+            left: 50%;
+            transform: translateX(-50%);
+            background: rgba(255, 255, 255, 0.1);
+            backdrop-filter: blur(1px);
+            -webkit-backdrop-filter: blur(1px);
+            border: 1px solid rgba(255, 255, 255, 0.3);
+            border-radius: 20px;
+            padding: 20px;
+            max-width: 500px;
+            width: calc(100% - 48px);
+            box-shadow: 0 0px 10px rgba(0, 0, 0, 0.1);
+            z-index: 999;
+        }
+        .search-box {
+            position: relative;
+        }
+        .search-input {
+            width: 100%;
+            padding: 10px 15px;
+            font-size: 1rem;
+            border: none;
+            background: rgba(255, 255, 255, 0.9);
+            border-radius: 10px;
+            outline: none;
+            transition: all 0.3s ease;
+            color: #1d1d1f;
+        }
+        .search-input::placeholder {
+            color: #86868b;
+        }
+        .search-input:focus {
+            background: rgba(255, 255, 255, 0.9);
+            box-shadow: 0 0 0 2px rgba(0, 122, 255, 0.3);
+        }
+        .search-icon {
+            position: absolute;
+            right: 12px;
+            top: 50%;
+            transform: translateY(-50%);
+            color: #86868b;
+            font-size: 1rem;
+        }
+        .search-highlight {
+            background: rgba(255, 214, 10, 0.7);
+            color: #1d1d1f;
+            padding: 1px 2px;
+            border-radius: 3px;
+            font-weight: 600;
+        }
+        .no-results {
+            text-align: center;
+            padding: 60px 20px;
+            color: #86868b;
+            background: rgba(255, 255, 255, 0.6);
+            backdrop-filter: blur(20px);
+            -webkit-backdrop-filter: blur(20px);
+            border-radius: 16px;
+            border: 1px solid rgba(255, 255, 255, 0.3);
+        }
+        .no-results h3 {
+            font-size: 1.3rem;
+            margin-bottom: 8px;
+            color: #1d1d1f;
+            font-weight: 600;
+        }
+        .loading {
+            text-align: center;
+            padding: 40px;
+            color: #007aff;
+            font-size: 1rem;
+            background: rgba(255, 255, 255, 0.6);
+            backdrop-filter: blur(20px);
+            -webkit-backdrop-filter: blur(20px);
+            border-radius: 16px;
+            border: 1px solid rgba(255, 255, 255, 0.3);
+        }
+        .error {
+            background: rgba(255, 59, 48, 0.1);
+            border: 1px solid rgba(255, 59, 48, 0.3);
+            color: #d70015;
+            padding: 16px;
+            border-radius: 12px;
+            margin: 20px 0;
+            backdrop-filter: blur(20px);
+            -webkit-backdrop-filter: blur(20px);
+        }
+        /* Smooth scrolling */
+        html {
+            scroll-behavior: smooth;
+        }
+        /* Custom scrollbar */
+        ::-webkit-scrollbar {
+            width: 8px;
+        }
+        ::-webkit-scrollbar-track {
+            background: rgba(255, 255, 255, 0.1);
+        }
+        ::-webkit-scrollbar-thumb {
+            background: rgba(0, 0, 0, 0.2);
+            border-radius: 4px;
+        }
+        ::-webkit-scrollbar-thumb:hover {
+            background: rgba(0, 0, 0, 0.3);
+        }
+        @media (max-width: 768px) {
+            .container {
+                padding: 80px 16px 120px;
+            }
+            .blog-grid {
+                grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
+                gap: 12px;
+            }
+            .nav-content {
+                padding: 0 16px;
+            }
+            .nav-stats {
+                flex-direction: column;
+                gap: 4px;
+                align-items: flex-end;
+                font-size: 0.8rem;
+            }
+            .search-container {
+                bottom: 16px;
+                width: calc(100% - 32px);
+            }
+        }
+        @media (max-width: 480px) {
+            .blog-grid {
+                grid-template-columns: 1fr;
+            }
+            .nav-stats {
+                display: none;
+            }
+        }
+    </style>
+</head>
+<body>
+    <!-- Top Navigation -->
+    <div class="top-nav">
+        <div class="nav-content">
+            <div class="nav-title">
+                <span>🤖</span>
+                <span>Artificial Intelligence Horizontal Division Unit - Self Help Desk</span>
+            </div>
+            <div class="nav-stats">
+                <span id="resultsCount">Loading...</span>
+                <span id="lastUpdated"></span>
+            </div>
+        </div>
+    </div>
+    <!-- Main Container -->
+    <div class="container">
+        <div id="blogContainer">
+            <div class="loading">
+                📁 Loading documentation files...
+            </div>
+        </div>
+    </div>
+    <!-- Floating Search Bar -->
+    <div class="search-container">
+        <div class="search-box">
+            <input type="text" class="search-input" placeholder="Search documentation..." id="searchInput">
+            <span class="search-icon">🔍</span>
+        </div>
+    </div>
+    <script>
+        class DocumentationHub {
+            constructor() {
+                this.blogs = [];
+                this.filteredBlogs = [];
+                this.allBlogsCache = []; // Cache for offline search
+                this.searchInput = document.getElementById('searchInput');
+                this.blogContainer = document.getElementById('blogContainer');
+                this.resultsCount = document.getElementById('resultsCount');
+                this.lastUpdated = document.getElementById('lastUpdated');
+                this.searchTimeout = null; // For debouncing
+                this.init();
+            }
+            async init() {
+                await this.loadBlogs();
+                this.setupEventListeners();
+                this.renderBlogs();
+                this.updateStats();
+            }
+            async loadBlogs() {
+                try {
+                    // Try to fetch from the local API first
+                    try {
+                        const response = await fetch('/api/blogs');
+                        if (response.ok) {
+                            this.blogs = await response.json();
+                            this.allBlogsCache = [...this.blogs]; // Cache for offline search
+                            this.filteredBlogs = [...this.blogs];
+                            return;
+                        }
+                    } catch (error) {
+                        console.log('Local API not available, using sample data');
+                    }
+                    // Fallback to sample data
+                    const sampleBlogs = [
+                        {
+                            filename: 'getting-started.md',
+                            title: 'Getting Started Guide',
+                            excerpt: 'Learn how to get started with our platform and set up your first project.',
+                            size: '2.5 KB',
+                            lastModified: '2025-06-20'
+                        },
+                        {
+                            filename: 'api-documentation.md',
+                            title: 'API Documentation',
+                            excerpt: 'Complete reference for all API endpoints, authentication, and examples.',
+                            size: '15.2 KB',
+                            lastModified: '2025-06-25'
+                        },
+                        {
+                            filename: 'troubleshooting.md',
+                            title: 'Troubleshooting Guide',
+                            excerpt: 'Common issues and their solutions to help you resolve problems quickly.',
+                            size: '8.7 KB',
+                            lastModified: '2025-06-22'
+                        }
+                    ];
+                    this.blogs = sampleBlogs;
+                    this.allBlogsCache = [...sampleBlogs];
+                    this.filteredBlogs = [...this.blogs];
+                } catch (error) {
+                    this.showError('Failed to load documentation files');
+                }
+            }
+            setupEventListeners() {
+                this.searchInput.addEventListener('input', (e) => {
+                    // Debounce search for better performance
+                    if (this.searchTimeout) {
+                        clearTimeout(this.searchTimeout);
+                    }
+                    this.searchTimeout = setTimeout(() => {
+                        this.searchBlogs(e.target.value);
+                    }, 300);
+                });
+                this.searchInput.addEventListener('keypress', (e) => {
+                    if (e.key === 'Enter') {
+                        if (this.searchTimeout) {
+                            clearTimeout(this.searchTimeout);
+                        }
+                        this.searchBlogs(e.target.value);
+                    }
+                });
+            }
+            async searchBlogs(query) {
+                const searchTerm = query.toLowerCase().trim();
+                if (!searchTerm) {
+                    this.filteredBlogs = [...this.allBlogsCache];
+                    this.renderBlogs();
+                    this.updateStats();
+                    return;
+                }
+                // Show loading state for search
+                this.showSearchLoading();
+                try {
+                    // Try to use server-side search API for full-text search
+                    const response = await fetch(`/api/search?q=${encodeURIComponent(searchTerm)}`);
+                    if (response.ok) {
+                        const searchData = await response.json();
+                        this.filteredBlogs = searchData.results;
+                        this.renderBlogs(searchTerm);
+                        this.updateStats(searchData.query);
+                        return;
+                    }
+                } catch (error) {
+                    console.log('Server search not available, using client-side search');
+                }
+                // Fallback to client-side search (title, excerpt, filename only)
+                this.filteredBlogs = this.allBlogsCache.filter(blog =>
+                    blog.title.toLowerCase().includes(searchTerm) ||
+                    blog.excerpt.toLowerCase().includes(searchTerm) ||
+                    blog.filename.toLowerCase().includes(searchTerm)
+                );
+                this.renderBlogs(searchTerm);
+                this.updateStats(searchTerm);
+            }
+            showSearchLoading() {
+                this.blogContainer.innerHTML = `
+                    <div class="loading">
+                        🔍 Searching through documentation...
+                    </div>
+                `;
+            }
+            renderBlogs(searchTerm = '') {
+                if (this.filteredBlogs.length === 0) {
+                    const noResultsHTML = searchTerm
+                        ? `<div class="no-results">
+                            <h3>🔍 No documents found for "${searchTerm}"</h3>
+                            <p>Try different keywords or browse all available documentation.</p>
+                           </div>`
+                        : `<div class="no-results">
+                            <h3>📁 No documents available</h3>
+                            <p>Add markdown files to the blogs directory to get started.</p>
+                           </div>`;
+                    this.blogContainer.innerHTML = noResultsHTML;
+                    return;
+                }
+                const blogHTML = this.filteredBlogs.map(blog => {
+                    // Highlight search terms in title and excerpt
+                    let highlightedTitle = blog.title;
+                    let highlightedExcerpt = blog.excerpt;
+                    if (searchTerm) {
+                        highlightedTitle = this.highlightText(blog.title, searchTerm);
+                        highlightedExcerpt = this.highlightText(blog.excerpt, searchTerm);
+                    }
+                    // Show match indicators if available
+                    let matchIndicators = '';
+                    if (blog.matches) {
+                        const indicators = [];
+                        if (blog.matches.filename) indicators.push('📁 filename');
+                        if (blog.matches.title) indicators.push('📝 title');
+                        if (blog.matches.content) indicators.push('📄 content');
+                        if (indicators.length > 0) {
+                            matchIndicators = `<div class="match-indicators">Found in: ${indicators.join(', ')}</div>`;
+                        }
+                    }
+                    return `
+                        <div class="blog-card" onclick="window.openBlog('${blog.filename}')">
+                            <div class="blog-title">${highlightedTitle}</div>
+                            <div class="blog-excerpt">${highlightedExcerpt}</div>
+                            ${matchIndicators}
+                            <div class="blog-meta">
+                                <span class="blog-date">📅 ${blog.lastModified}</span>
+                                <span class="blog-size">📄 ${blog.size}</span>
+                            </div>
+                        </div>
+                    `;
+                }).join('');
+                this.blogContainer.innerHTML = `<div class="blog-grid">${blogHTML}</div>`;
+            }
+            highlightText(text, searchTerm) {
+                if (!searchTerm) return text;
+                const regex = new RegExp(`(${this.escapeRegExp(searchTerm)})`, 'gi');
+                return text.replace(regex, '<mark class="search-highlight">$1</mark>');
+            }
+            escapeRegExp(string) {
+                return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            }
+            updateStats(searchQuery = '') {
+                const total = this.allBlogsCache.length;
+                const shown = this.filteredBlogs.length;
+                if (searchQuery) {
+                    this.resultsCount.textContent = `${shown} of ${total} documents found`;
+                } else if (this.searchInput.value.trim()) {
+                    this.resultsCount.textContent = `${shown} of ${total} documents`;
+                } else {
+                    this.resultsCount.textContent = `${total} documents`;
+                }
+                this.lastUpdated.textContent = `Updated ${new Date().toLocaleDateString()}`;
+            }
+            showError(message) {
+                this.blogContainer.innerHTML = `
+                    <div class="error">
+                        <strong>Error:</strong> ${message}
+                    </div>
+                `;
+            }
+        }
+        // Global function to open blog files
+        window.openBlog = function (filename) {
+            // Open the blog viewer in a new window
+            const blogUrl = `./blog-viewer.html?file=${encodeURIComponent(filename)}`;
+            window.open(blogUrl, '_blank', 'width=1000,height=700,scrollbars=yes,resizable=yes');
+        };
+        // Initialize the documentation hub
+        document.addEventListener('DOMContentLoaded', () => {
+            new DocumentationHub();
+        });
+    </script>
+</body>
+</html>

requirements.txt ADDED Viewed

	@@ -0,0 +1,2 @@


1	+ # No external dependencies required - using only Python standard library
2	+ # The server uses only built-in modules: http.server, socketserver, json, os, pathlib, etc.

server.py ADDED Viewed

	@@ -0,0 +1,282 @@

+#!/usr/bin/env python3
+"""
+Simple HTTP server for serving the documentation hub locally.
+This allows proper CORS handling and file serving for the markdown files.
+"""
+import http.server
+import socketserver
+import json
+import os
+import mimetypes
+from urllib.parse import urlparse, parse_qs
+from pathlib import Path
+class DocumentationHandler(http.server.SimpleHTTPRequestHandler):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, directory=str(Path(__file__).parent), **kwargs)
+    def end_headers(self):
+        # Add CORS headers
+        self.send_header('Access-Control-Allow-Origin', '*')
+        self.send_header('Access-Control-Allow-Methods', 'GET, POST, OPTIONS')
+        self.send_header('Access-Control-Allow-Headers', 'Content-Type')
+        super().end_headers()
+    def do_GET(self):
+        # Handle the blogs directory listing API
+        if self.path.startswith('/api/blogs'):
+            self.handle_blogs_api()
+        elif self.path.startswith('/api/search'):
+            self.handle_search_api()
+        else:
+            # Serve static files normally
+            super().do_GET()
+    def handle_blogs_api(self):
+        """API endpoint to list blog files and their metadata"""
+        try:
+            blogs_dir = Path(__file__).parent / 'blogs'
+            if not blogs_dir.exists():
+                self.send_error(404, "Blogs directory not found")
+                return
+            blogs = []
+            for md_file in blogs_dir.glob('*.md'):
+                # Get file stats
+                stat = md_file.stat()
+                size_kb = round(stat.st_size / 1024, 1)
+                # Read first few lines to extract title and excerpt
+                try:
+                    with open(md_file, 'r', encoding='utf-8') as f:
+                        content = f.read()
+                        lines = content.split('\n')
+                        # Extract title (first # header)
+                        title = md_file.stem.replace('-', ' ').title()
+                        for line in lines:
+                            if line.startswith('# '):
+                                title = line[2:].strip()
+                                break
+                        # Extract excerpt (first paragraph after title)
+                        excerpt = "No description available."
+                        for i, line in enumerate(lines):
+                            if line.startswith('# '):
+                                # Look for first non-empty paragraph after title
+                                for j in range(i + 1, min(i + 10, len(lines))):
+                                    if lines[j].strip() and not lines[j].startswith('#'):
+                                        excerpt = lines[j].strip()[:150]
+                                        if len(lines[j].strip()) > 150:
+                                            excerpt += "..."
+                                        break
+                                break
+                        blogs.append({
+                            'filename': md_file.name,
+                            'title': title,
+                            'excerpt': excerpt,
+                            'size': f"{size_kb} KB",
+                            'lastModified': stat.st_mtime
+                        })
+                except Exception as e:
+                    print(f"Error reading {md_file}: {e}")
+                    continue
+            # Sort by last modified (newest first)
+            blogs.sort(key=lambda x: x['lastModified'], reverse=True)
+            # Format dates
+            import datetime
+            for blog in blogs:
+                blog['lastModified'] = datetime.datetime.fromtimestamp(
+                    blog['lastModified']
+                ).strftime('%Y-%m-%d')
+            # Send JSON response
+            response = json.dumps(blogs, indent=2)
+            self.send_response(200)
+            self.send_header('Content-Type', 'application/json')
+            self.end_headers()
+            self.wfile.write(response.encode('utf-8'))
+        except Exception as e:
+            print(f"Error in blogs API: {e}")
+            self.send_error(500, f"Internal server error: {e}")
+    def handle_search_api(self):
+        """API endpoint to search within blog content"""
+        try:
+            # Parse query parameters
+            parsed_url = urlparse(self.path)
+            query_params = parse_qs(parsed_url.query)
+            search_query = query_params.get('q', [''])[0].lower().strip()
+            if not search_query:
+                self.send_error(400, "Missing search query parameter 'q'")
+                return
+            blogs_dir = Path(__file__).parent / 'blogs'
+            if not blogs_dir.exists():
+                self.send_error(404, "Blogs directory not found")
+                return
+            search_results = []
+            for md_file in blogs_dir.glob('*.md'):
+                try:
+                    with open(md_file, 'r', encoding='utf-8') as f:
+                        content = f.read()
+                        lines = content.split('\n')
+                        # Extract title
+                        title = md_file.stem.replace('-', ' ').title()
+                        for line in lines:
+                            if line.startswith('# '):
+                                title = line[2:].strip()
+                                break
+                        # Check if search term is in title, filename, or content
+                        filename_match = search_query in md_file.name.lower()
+                        title_match = search_query in title.lower()
+                        content_match = search_query in content.lower()
+                        if filename_match or title_match or content_match:
+                            # Get file stats
+                            stat = md_file.stat()
+                            size_kb = round(stat.st_size / 1024, 1)
+                            # Extract excerpt (preferably containing search term)
+                            excerpt = self.extract_search_excerpt(content, search_query)
+                            # Calculate relevance score
+                            relevance = 0
+                            if filename_match:
+                                relevance += 3
+                            if title_match:
+                                relevance += 2
+                            if content_match:
+                                relevance += 1
+                            search_results.append({
+                                'filename': md_file.name,
+                                'title': title,
+                                'excerpt': excerpt,
+                                'size': f"{size_kb} KB",
+                                'lastModified': stat.st_mtime,
+                                'relevance': relevance,
+                                'matches': {
+                                    'filename': filename_match,
+                                    'title': title_match,
+                                    'content': content_match
+                                }
+                            })
+                except Exception as e:
+                    print(f"Error searching {md_file}: {e}")
+                    continue
+            # Sort by relevance, then by last modified
+            search_results.sort(key=lambda x: (x['relevance'], x['lastModified']), reverse=True)
+            # Format dates
+            import datetime
+            for result in search_results:
+                result['lastModified'] = datetime.datetime.fromtimestamp(
+                    result['lastModified']
+                ).strftime('%Y-%m-%d')
+                # Remove relevance from final response
+                del result['relevance']
+            # Send JSON response
+            response = json.dumps({
+                'query': search_query,
+                'results': search_results,
+                'total': len(search_results)
+            }, indent=2)
+            self.send_response(200)
+            self.send_header('Content-Type', 'application/json')
+            self.end_headers()
+            self.wfile.write(response.encode('utf-8'))
+        except Exception as e:
+            print(f"Error in search API: {e}")
+            self.send_error(500, f"Internal server error: {e}")
+    def extract_search_excerpt(self, content, search_term, context_chars=150):
+        """Extract excerpt around search term or fallback to beginning"""
+        content_lower = content.lower()
+        search_pos = content_lower.find(search_term)
+        if search_pos == -1:
+            # If search term not found, return beginning of content
+            lines = content.split('\n')
+            for line in lines:
+                if line.strip() and not line.startswith('#'):
+                    excerpt = line.strip()[:context_chars]
+                    if len(line.strip()) > context_chars:
+                        excerpt += "..."
+                    return excerpt
+            return "No description available."
+        # Extract context around the search term
+        start = max(0, search_pos - context_chars // 2)
+        end = min(len(content), search_pos + len(search_term) + context_chars // 2)
+        excerpt = content[start:end].strip()
+        # Clean up excerpt (remove incomplete words at edges)
+        if start > 0:
+            space_pos = excerpt.find(' ')
+            if space_pos > 0:
+                excerpt = excerpt[space_pos:].strip()
+                excerpt = "..." + excerpt
+        if end < len(content):
+            last_space = excerpt.rfind(' ')
+            if last_space > 0:
+                excerpt = excerpt[:last_space].strip()
+                excerpt += "..."
+        return excerpt
+def run_server(port=8000):
+    """Start the documentation server"""
+    try:
+        with socketserver.TCPServer(("", port), DocumentationHandler) as httpd:
+            print(f"🌐 Server running at: http://localhost:{port}")
+            print(f"📁 Serving from: {Path(__file__).parent}")
+            print(f"🔍 Open http://localhost:{port} in your browser")
+            print()
+            httpd.serve_forever()
+    except KeyboardInterrupt:
+        print("\n👋 Server stopped by user")
+    except OSError as e:
+        if e.errno == 10048:  # Windows: Address already in use
+            print(f"❌ Port {port} is already in use. Try a different port:")
+            print(f"   python server.py --port 8001")
+        else:
+            print(f"❌ Error starting server: {e}")
+if __name__ == "__main__":
+    import sys
+    port = 8000
+    # Simple command line argument parsing
+    if len(sys.argv) > 1:
+        for i, arg in enumerate(sys.argv):
+            if arg in ['--port', '-p'] and i + 1 < len(sys.argv):
+                try:
+                    port = int(sys.argv[i + 1])
+                except ValueError:
+                    print("❌ Invalid port number")
+                    sys.exit(1)
+            elif arg in ['--help', '-h']:
+                print("Usage: python server.py [--port PORT]")
+                print("Options:")
+                print("  --port, -p PORT   Port to run server on (default: 8000)")
+                print("  --help, -h        Show this help message")
+                sys.exit(0)
+    run_server(port)