┌─────────────────────────────────────────────────────────────────────────────────┐
│                        ALPHAVAULT AI - REQUEST FLOW                              │
│                     (User → CDN → Frontend → Workers → APIs)                     │
└─────────────────────────────────────────────────────────────────────────────────┘

1⃣  USER ACTION
    └─> User accesses: https://alphavault-ai.com/advanced-analysis
        • Browser: Chrome 130 (Desktop)
        • Location: New York, USA
        • Action: Search for stock symbol "AAPL"

2⃣  DNS RESOLUTION (Cloudflare DNS)
    └─> Query: alphavault-ai.com
        • TTL: 300 seconds
        • Response: 104.21.x.x (Cloudflare Edge IP)
        • Latency: ~8ms

3⃣  TLS HANDSHAKE (Cloudflare Edge)
    └─> Protocol: TLS 1.3
        • Cipher: AES-256-GCM
        • Certificate: Let's Encrypt (Auto-renewed)
        • Latency: ~12ms

4⃣  CLOUDFLARE PAGES (Static CDN)
    └─> Request: GET /advanced-analysis
        • Cache: HIT (Edge cached for 24h)
        • Compression: Brotli (78% size reduction)
        • Response Size: 42 KB (compressed from 190 KB)
        • Latency: ~18ms
        • Headers:
          - CF-Cache-Status: HIT
          - CF-Ray: 8d7e2f3a1b2c3d4e-JFK
          - Server: cloudflare

5⃣  BROWSER RENDERING (Client-Side)
    └─> Parse HTML (42 KB)
        • Load CSS: advanced-analysis.css (132 KB)
        • Load JavaScript: advanced-analysis.js (4,292 lines)
        • Initialize Firebase SDK
        • Execute: auth-guard.js (Check authentication)
        • Execute: access-control.js (Verify plan: Pro ✅)
        • Render UI: 14 chart containers + search form
        • Total Load Time: ~350ms

6⃣  USER SEARCHES SYMBOL "AAPL"
    └─> JavaScript Call: analyzeSymbol('AAPL')
        • Function: advanced-analysis.js (line 1247)
        • API Client: api-client.js (FinanceAPIClient class)
        • Parallel Requests: 4

7⃣  CLOUDFLARE WORKER: finance-hub-api
    └─> Endpoint: https://finance-hub-api.your-account.workers.dev/api/quote?symbol=AAPL
        • Method: GET
        • Headers: Authorization (API Key)
        • Cache Check: KV Storage ("quote:AAPL")
          - Cache Miss (expired 65 seconds ago)
        • Proxy to: Twelve Data API
        • Response: 200 OK (Real-time quote)
        • Store in KV: TTL 60 seconds
        • Latency: ~145ms

8⃣  TWELVE DATA API (External)
    └─> Request: GET https://api.twelvedata.com/quote?symbol=AAPL&apikey=***
        • API Key: Valid (Quota: 800/800 requests remaining)
        • Response: JSON (2.1 KB)
        • Data:
          {
            symbol: "AAPL",
            name: "Apple Inc",
            exchange: "NASDAQ",
            open: 185.50,
            high: 187.20,
            low: 184.80,
            close: 186.95,
            volume: 52847300,
            previous_close: 184.25,
            change: 2.70,
            percent_change: 1.47
          }
        • Latency: ~120ms

9⃣  DATA PROCESSING (Frontend)
    └─> Function: processAnalysisData()
        • Calculate 14 technical indicators locally
        • Generate AI recommendations (3 horizons)
        • Calculate composite score (0-100)
        • Prepare Highcharts data structures
        • Processing Time: ~95ms

🔟  UI RENDERING (Highcharts)
    └─> Render 14 interactive charts:
        • Candlestick chart (365 data points)
        • RSI chart (14 periods)
        • MACD chart (histogram + signal)
        • Bollinger Bands
        • Moving Averages (SMA/EMA)
        • Fibonacci Retracements
        • Ichimoku Cloud
        • Pivot Points
        • ADX + DMI
        • Stochastic Oscillator
        • Volume chart
        • Support/Resistance levels
        • AI Recommendations (3 cards)
        • Risk Metrics dashboard
        • Rendering Time: ~280ms

═══════════════════════════════════════════════════════════════════════════════
TOTAL TIME BREAKDOWN:
═══════════════════════════════════════════════════════════════════════════════

DNS Resolution:        8ms
TLS Handshake:        12ms
CDN Delivery:         18ms
Browser Load:        350ms
API Request:         145ms
External API:        120ms
Data Processing:      95ms
Chart Rendering:     280ms
────────────────────────────
TOTAL:               1,028ms

Cache Hit Next Time:  ~650ms (API cached)

alphavault-ai/
├── assets/
│   ├── css/                          (49 files - 1.8 MB)
│   │   ├── common.css                (2,090 lines - Global styles)
│   │   ├── landing.css               (5,886 lines - Homepage)
│   │   ├── community.css             (6,890 lines - Community hub)
│   │   ├── admin-analytics.css       (4,039 lines - Admin dashboard)
│   │   ├── advanced-analysis.css     (5,490 lines - Technical analysis)
│   │   ├── investment-analytics.css  (3,748 lines - Portfolio analytics)
│   │   ├── trend-prediction.css      (2,599 lines - ML predictions)
│   │   ├── sidebar.css               (1,101 lines - Navigation)
│   │   ├── user-menu.css             (538 lines - User dropdown)
│   │   ├── chatbot-futuristic.css    (1,679 lines - AI chatbot)
│   │   └── ... (39 other files)
│   │
│   ├── js/                           (112 files - 8.5 MB)
│   │   ├── admin-analytics.js        (7,846 lines - Admin backend)
│   │   ├── investment-analytics.js   (4,869 lines - Portfolio)
│   │   ├── advanced-analysis.js      (4,292 lines - 14 indicators)
│   │   ├── trend-prediction.js       (2,485 lines - ML predictions)
│   │   ├── insider-flow-tracker.js   (2,554 lines - Form 4 analysis)
│   │   ├── ipo-intelligence.js       (2,429 lines - IPO screening)
│   │   ├── ma-predictor.js           (1,066 lines - M&A screening)
│   │   ├── access-control.js         (2,660 lines - Plan-based access)
│   │   ├── api-client.js             (2,237 lines - API client)
│   │   ├── firebase-config.js        (783 lines - Auth & Firestore)
│   │   ├── auth-guard.js             (287 lines - Page protection)
│   │   ├── chatbot-fullpage-ui.js    (1,115 lines - AI chatbot UI)
│   │   └── ... (100 other files)
│   │
│   └── images/                       (Logos, favicons, illustrations)
│
├── index                        (Homepage - 1,951 lines)
├── dashboard-financier          (Budget dashboard - 828 lines)
├── advanced-analysis            (14 indicators + AI - 2,906 lines)
├── trend-prediction             (ML predictions - 1,565 lines)
├── investment-analytics         (Multi-allocation - 1,103 lines)
├── community-hub                (Social features - 675 lines)
├── admin-analytics              (Admin backend - 2,989 lines)
├── chatbot-fullpage             (FinanceGPT - 771 lines)
└── ... (57 other pages)

// Firebase Configuration (Production)
const firebaseConfig = {
    apiKey: "YOUR_FIREBASE_API_KEY",
    authDomain: "alphavault-ai.firebaseapp.com",
    projectId: "alphavault-ai",
    storageBucket: "alphavault-ai.appspot.com",
    messagingSenderId: "YOUR_SENDER_ID",
    appId: "YOUR_APP_ID",
    measurementId: "YOUR_MEASUREMENT_ID"
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);

// Initialize Services
const auth = firebase.auth();
const db = firebase.firestore();
const storage = firebase.storage();

// Configure Auth Providers
const googleProvider = new firebase.auth.GoogleAuthProvider();
googleProvider.setCustomParameters({ prompt: 'select_account' });

// Enable Offline Persistence
db.enablePersistence({ synchronizeTabs: true })
    .catch((err) => console.warn('Offline persistence failed:', err));

console.log('🔥 Firebase initialized successfully');

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    
    // ============================================
    // USERS COLLECTION
    // ============================================
    match /users/{userId} {
      // ✅ Read: Any authenticated user
      allow read: if request.auth != null;

      // ✅ Create: User can create their own document
      allow create: if request.auth != null && request.auth.uid == userId;

      // ✅ Update: User or Admin ([email protected])
      // OR automated updates (followers, posts count, etc.)
      allow update: if request.auth != null && 
                       (request.auth.uid == userId || 
                        request.auth.token.email == '[email protected]' ||
                        (request.resource.data.diff(resource.data).affectedKeys()
                         .hasOnly(['followersCount', 'followingCount', 'reputation', 
                                   'postCount', 'lastLoginAt', 'points', 'postsCount', 
                                   'commentsCount', 'likesReceived', 'updatedAt', 'photoURL'])));

      // ✅ Delete: User only
      allow delete: if request.auth != null && request.auth.uid == userId;
    }
    
    // ============================================
    // POSTS COLLECTION
    // ============================================
    match /posts/{postId} {
      // ✅ Read: Any authenticated user
      allow read: if request.auth != null;
      
      // ✅ Create: User must be author
      allow create: if request.auth != null && 
                       request.resource.data.authorId == request.auth.uid;
      
      // ✅ Update: Author, Admin, or automated counters (views, likes)
      allow update: if request.auth != null && 
                       (request.auth.uid == resource.data.authorId || 
                        request.auth.token.email == '[email protected]' ||
                        (request.resource.data.diff(resource.data).affectedKeys()
                         .hasOnly(['views', 'likes', 'commentsCount', 'updatedAt'])));
      
      // ✅ Delete: Author or Admin
      allow delete: if request.auth != null && 
                       (request.auth.uid == resource.data.authorId || 
                        request.auth.token.email == '[email protected]');
    }
    
    // ============================================
    // CONVERSATIONS (Private Messages + Groups)
    // ============================================
    match /conversations/{conversationId} {
      // ✅ Read: Participants only
      allow read: if request.auth != null && 
                     request.auth.uid in resource.data.participants;

      // ✅ Create: User must be a participant (1-to-1 or group)
      allow create: if request.auth != null && 
                       request.auth.uid in request.resource.data.participants;

      // ✅ Update/Delete: Participants only
      allow update, delete: if request.auth != null && 
                               request.auth.uid in resource.data.participants;

      // Messages subcollection
      match /messages/{messageId} {
        allow read: if request.auth != null && 
                       request.auth.uid in get(/databases/$(database)/documents/conversations/$(conversationId)).data.participants;

        allow create: if request.auth != null && 
                         request.auth.uid == request.resource.data.senderId &&
                         request.auth.uid in get(/databases/$(database)/documents/conversations/$(conversationId)).data.participants;

        allow update, delete: if request.auth != null && 
                                 request.auth.uid in get(/databases/$(database)/documents/conversations/$(conversationId)).data.participants;
      }
    }
    
    // ============================================
    // ADMIN-ONLY COLLECTIONS
    // ============================================
    match /analytics_visits/{document} {
      allow create: if true;  // Public write for tracking
      allow read: if request.auth != null && 
                     request.auth.token.email == '[email protected]';
    }

    match /payments/{document} {
      allow read: if request.auth != null && 
                     request.auth.token.email == '[email protected]';
    }
    
    // ============================================
    // BLOCK ALL OTHER ACCESS
    // ============================================
    match /{document=**} {
      allow read, write: if false;
    }
  }
}

┌─────────────────────────────────────────────────────────────────────────────────┐
│                          USER REGISTRATION FLOW                                  │
│                     (Browser → Firebase Auth → Firestore → Email)                │
└─────────────────────────────────────────────────────────────────────────────────┘

1⃣  USER SUBMITS REGISTRATION FORM
    ├─ Page: auth
    ├─ Email: [email protected]
    ├─ Password: ************ (min 6 chars)
    ├─ Name: John Doe
    └─ Function: handleEmailSignup()

2⃣  FIREBASE AUTHENTICATION
    ├─ SDK: firebase.auth().createUserWithEmailAndPassword(email, password)
    ├─ Validation:
    │  ✓ Email format check
    │  ✓ Password strength (min 6 chars)
    │  ✓ Email not already registered
    ├─ Create User:
    │  • UID: abc123xyz456 (auto-generated)
    │  • JWT Token: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9... (expires in 1h)
    └─ Response: { uid, email, emailVerified: false, token }

3⃣  FIRESTORE USER DOCUMENT CREATION
    ├─ Collection: /users/{abc123xyz456}
    ├─ Function: createUserProfile()
    └─ Document Structure:
       {
         uid: "abc123xyz456",
         email: "[email protected]",
         name: "John Doe",
         plan: "basic",                    // Default plan
         subscriptionStatus: "inactive",
         createdAt: "2026-01-07T14:30:00.000Z",
         updatedAt: "2026-01-07T14:30:00.000Z",
         lastLogin: "2026-01-07T14:30:00.000Z",
         photoURL: "https://ui-avatars.com/api/?name=John+Doe",
         emailVerified: false,
         onboardingCompleted: false,
         preferences: {
           theme: "light",
           language: "en",
           notifications: true,
           newsletter: false
         },
         usage: {
           apiCalls: 0,
           chatbotMessages: 0,
           simulationsCreated: 0
         }
       }

4⃣  WELCOME EMAIL (Cloudflare Worker → Resend API)
    ├─ Worker: finance-hub-api
    ├─ Function: sendWelcomeEmail()
    ├─ Email Service: Resend API
    ├─ Sender: AlphaVault AI 
    └─ Email Template (HTML + Glassmorphism):
       ┌─────────────────────────────────────────────────────────────────┐
       │ 🎉 WELCOME TO ALPHAVAULT AI!                                    │
       │ ─────────────────────────────────────────────────────────────── │
       │ [GRADIENT HEADER: Purple → Blue]                               │
       │ [PNG LOGO 192x192]                                             │
       │                                                                 │
       │ Hi John Doe,                                                    │
       │                                                                 │
       │ Your account has been created successfully!                    │
       │                                                                 │
       │ 👑 AlphaVault Basic (9 pages unlocked)                         │
       │                                                                 │
       │ 📊 Pages You Can Access:                                       │
       │ ✓ Dashboard Budget                                             │
       │ ✓ Community Hub                                                │
       │ ✓ Monte Carlo Simulations                                      │
       │ ✓ Real Estate Tax Simulator                                    │
       │ ✓ Portfolio Optimizer (Markowitz)                              │
       │ ✓ Economic Dashboard                                           │
       │ ✓ Companies Directory                                          │
       │ ✓ Settings & User Profile                                      │
       │ ✓ Create Posts & Messages                                      │
       │                                                                 │
       │ [ACCESS YOUR DASHBOARD →] (Gradient Button)                    │
       │                                                                 │
       │ Need more features? Upgrade to Pro or Platinum!                │
       │                                                                 │
       │ ─────────────────────────────────────────────────────────────── │
       │ © 2026 AlphaVault AI | [email protected]                  │
       └─────────────────────────────────────────────────────────────────┘

5⃣  ANALYTICS TRACKING
    ├─ Worker: admin-analytics-api
    ├─ Collection: /analytics_activity
    └─ Event Data:
       {
         eventType: "user_registered",
         userId: "abc123xyz456",
         email: "[email protected]",
         plan: "basic",
         timestamp: "2026-01-07T14:30:00.000Z",
         source: "organic",
         userAgent: "Mozilla/5.0...",
         device: "desktop",
         location: { country: "US", city: "New York" }
       }

6⃣  REDIRECT TO DASHBOARD
    ├─ URL: /dashboard-financier
    ├─ Session: Active (JWT token stored in localStorage)
    ├─ Plan: Basic (9 pages unlocked)
    └─ ✅ REGISTRATION COMPLETE

═══════════════════════════════════════════════════════════════════════════════
KEY FILES INVOLVED:
═══════════════════════════════════════════════════════════════════════════════

Frontend:
• auth                           (Registration form UI)
• assets/js/auth.js                   (Form handling + Firebase calls)
• assets/js/firebase-config.js        (Firebase initialization)

Backend:
• Firebase Authentication             (User creation + JWT)
• Firestore Database                  (/users collection)
• Cloudflare Worker: finance-hub-api  (Email sending)
• Resend API                           (Email delivery)

Analytics:
• Cloudflare Worker: admin-analytics-api
• Firestore: /analytics_activity

┌─────────────────────────────────────────────────────────────────────────────────┐
│                          STRIPE PAYMENT FLOW                                     │
│              (User → Worker → Stripe → Webhook → Firebase → Email)              │
└─────────────────────────────────────────────────────────────────────────────────┘

1⃣  USER SELECTS PLAN
    ├─ Page: checkout
    ├─ Plan: Pro ($10/month)
    ├─ Promo Code: LAUNCH15 (15% off)
    └─ Action: Click "Subscribe"

2⃣  CLOUDFLARE WORKER: finance-hub-api
    ├─ Endpoint: POST /create-checkout-session
    ├─ Body: { plan: "pro", userId: "abc123", promoCode: "LAUNCH15" }
    ├─ Process:
    │  ✓ Validate plan (basic/pro/platinum)
    │  ✓ Verify promo code: LAUNCH15
    │    → Type: percentage (15%)
    │    → Duration: forever
    │  ✓ Create Stripe Coupon: coupon_launch15_abc123
    │  ✓ Get Price ID: env.STRIPE_PRICE_PRO
    └─ Stripe API Call:
       POST https://api.stripe.com/v1/checkout/sessions
       {
         mode: "subscription",
         customer_email: "[email protected]",
         client_reference_id: "abc123xyz456",
         line_items: [{ price: "price_pro_id", quantity: 1 }],
         discounts: [{ coupon: "coupon_launch15_abc123" }],
         subscription_data: {
           trial_period_days: 14,
           metadata: { userId: "abc123xyz456", plan: "pro", promoCode: "LAUNCH15" }
         },
         success_url: "https://alphavault-ai.com/success?session_id={CHECKOUT_SESSION_ID}",
         cancel_url: "https://alphavault-ai.com/checkout?cancelled=true"
       }
       Response: { id: "cs_test_abc123", url: "https://checkout.stripe.com/..." }

3⃣  REDIRECT TO STRIPE CHECKOUT
    ├─ URL: https://checkout.stripe.com/c/pay/cs_test_abc123
    ├─ User enters payment details:
    │  • Card: 4242 4242 4242 4242
    │  • Expiry: 12/28
    │  • CVC: 123
    └─ Stripe validates payment method

4⃣  STRIPE PROCESSES PAYMENT
    ├─ Create Customer: cus_abc123
    ├─ Create Subscription: sub_xyz789
    ├─ Apply Discount: 15% off (final: $8.50/month)
    ├─ Start Trial: 14 days (no charge until Jan 21, 2026)
    ├─ Schedule Invoice: Jan 21, 2026 ($8.50)
    └─ Subscription Details:
       {
         id: "sub_xyz789",
         customer: "cus_abc123",
         status: "trialing",
         trial_end: "2026-01-21T00:00:00.000Z",
         plan: { amount: 1000, currency: "usd", interval: "month" },
         discount: { coupon: { percent_off: 15, duration: "forever" } },
         metadata: { userId: "abc123xyz456", plan: "pro", promoCode: "LAUNCH15" }
       }

5⃣  STRIPE WEBHOOK → WORKER
    ├─ Event: checkout.session.completed
    ├─ Endpoint: POST /webhook (finance-hub-api)
    ├─ Signature Verification: STRIPE_WEBHOOK_SECRET
    ├─ Handler: handleCheckoutSessionCompleted()
    └─ Actions:
       • Extract userId from client_reference_id
       • Update Firebase Firestore (/users/{userId}):
         {
           plan: "pro",
           stripeCustomerId: "cus_abc123",
           stripeSubscriptionId: "sub_xyz789",
           subscriptionStatus: "active",
           promoCode: "LAUNCH15",
           discount: 15,
           trialEnd: "2026-01-21T00:00:00.000Z",
           updatedAt: serverTimestamp()
         }
       • User now has access to 17 pages (Pro plan)
       • Trigger confirmation email

6⃣  RESEND API - CONFIRMATION EMAIL
    ├─ Service: Resend (https://api.resend.com/emails)
    ├─ Sender: AlphaVault AI 
    └─ Email Template (Glassmorphism + HTML Invoice):
       ┌─────────────────────────────────────────────────────────────────┐
       │ ✅ PAYMENT CONFIRMED - ALPHAVAULT AI                            │
       │ ─────────────────────────────────────────────────────────────── │
       │ [GRADIENT HEADER: Purple → Blue]                               │
       │ [PNG LOGO 192x192]                                             │
       │                                                                 │
       │ [✓ SUCCESS ICON - Green Circle]                                │
       │                                                                 │
       │ Hi John Doe,                                                    │
       │                                                                 │
       │ Your subscription has been successfully processed!             │
       │                                                                 │
       │ 👑 AlphaVault Pro                                              │
       │ ⏱ 14-Day Free Trial - No charges until Jan 21, 2026          │
       │                                                                 │
       │ ╔═══════════════════════════════════════════════════════════╗ │
       │ ║ TRANSACTION DETAILS                                       ║ │
       │ ╠═══════════════════════════════════════════════════════════╣ │
       │ ║ Customer:   John Doe                                      ║ │
       │ ║ Email:      [email protected]                              ║ │
       │ ║ Plan:       AlphaVault Pro                                ║ │
       │ ║ Amount:     $8.50/month (15% discount applied)            ║ │
       │ ║ Invoice:    #AV-202601-147820                             ║ │
       │ ║ Date:       January 07, 2026                              ║ │
       │ ║ Status:     ✓ Active                                      ║ │
       │ ╚═══════════════════════════════════════════════════════════╝ │
       │                                                                 │
       │ 🎉 FEATURES UNLOCKED (17 PAGES):                               │
       │ ✓ Everything in Free (9 pages)                                │
       │ ✓ Investment Analytics (Multi-allocation portfolios)          │
       │ ✓ Risk Parity Optimization                                     │
       │ ✓ Scenario Analysis (Bull/Base/Bear)                          │
       │ ✓ Advanced Analysis (14 Wall Street indicators)               │
       │ ✓ Forex Converter (38 currencies + 14 indicators)             │
       │ ✓ Inflation Calculator                                         │
       │ ✓ Interest Rate Tracker                                        │
       │ ✓ News Terminal (Real-time financial news)                    │
       │                                                                 │
       │ [ACCESS YOUR DASHBOARD →] (Gradient Button)                    │
       │                                                                 │
       │ Thank you for choosing AlphaVault AI!                          │
       │ You can cancel anytime from your account settings.             │
       │                                                                 │
       │ ─────────────────────────────────────────────────────────────── │
       │ Dashboard | Website | Support                                  │
       │ © 2026 AlphaVault AI | [email protected]                  │
       └─────────────────────────────────────────────────────────────────┘
       
       📎 Attachment: AlphaVault_Invoice_AV-202601-147820
          (HTML invoice with SVG logo + transaction details)

7⃣  SUCCESS PAGE
    ├─ URL: /success
    ├─ Confirmation message displayed
    ├─ Email sent notification
    └─ ✅ PAYMENT COMPLETE

═══════════════════════════════════════════════════════════════════════════════
STRIPE WEBHOOK EVENTS HANDLED:
═══════════════════════════════════════════════════════════════════════════════

• checkout.session.completed    → Update Firebase, send email
• customer.subscription.updated  → Sync subscription status
• customer.subscription.deleted  → Downgrade to Basic, cancel subscription
• invoice.payment_succeeded      → Update payment date, send receipt
• invoice.payment_failed         → Set grace period, send notification

┌─────────────────────────────────────────────────────────────────────────────────┐
│                      MARKET DATA RETRIEVAL FLOW                                  │
│            (api-client.js → Cloudflare Worker → Twelve Data / FinnHub)           │
└─────────────────────────────────────────────────────────────────────────────────┘

1⃣  USER SEARCHES SYMBOL "AAPL"
    ├─ Page: advanced-analysis
    ├─ Input: "AAPL"
    ├─ Action: Click "Analyze"
    └─ JavaScript: analyzeSymbol('AAPL')

2⃣  API CLIENT (Frontend)
    ├─ File: assets/js/api-client.js
    ├─ Class: FinanceAPIClient
    └─ Parallel Requests (4):
       • getQuote('AAPL')              → Real-time price
       • getTimeSeries('AAPL', '1day', 365) → Historical data (1 year)
       • getTechnicalIndicator('AAPL', 'rsi') → RSI indicator
       • getProfile('AAPL')            → Company fundamentals

3⃣  CLOUDFLARE WORKER: finance-hub-api
    ├─ Base URL: https://finance-hub-api.your-account.workers.dev
    └─ Request 1: GET /api/quote?symbol=AAPL
       ├─ Cache Check: KV Storage ("quote:AAPL")
       │  └─ Cache Miss (expired 65s ago)
       ├─ Proxy to: Twelve Data API
       │  → GET https://api.twelvedata.com/quote?symbol=AAPL&apikey=***
       ├─ Response: 200 OK (Real-time quote)
       │  {
       │    symbol: "AAPL",
       │    name: "Apple Inc",
       │    exchange: "NASDAQ",
       │    open: 185.50,
       │    high: 187.20,
       │    low: 184.80,
       │    close: 186.95,
       │    volume: 52847300,
       │    previous_close: 184.25,
       │    change: 2.70,
       │    percent_change: 1.47
       │  }
       ├─ Store in KV: TTL 60 seconds
       └─ Latency: ~145ms

    └─ Request 2: GET /api/time-series?symbol=AAPL&interval=1day&size=365
       ├─ Cache Check: KV Storage ("timeseries:AAPL:1day:365")
       │  └─ Cache Hit! (cached 15 minutes ago)
       ├─ Response (from cache):
       │  {
       │    symbol: "AAPL",
       │    interval: "1day",
       │    data: [
       │      { datetime: "2025-01-07", open: 185.50, high: 187.20, ... },
       │      { datetime: "2025-01-06", open: 182.30, high: 184.50, ... },
       │      ... (365 data points)
       │    ]
       │  }
       └─ Latency: ~25ms (cache hit)

    └─ Request 3: GET /api/technical-indicators?symbol=AAPL&indicator=rsi
       ├─ Cache Check: KV Storage ("indicator:AAPL:rsi:1day:14")
       │  └─ Cache Miss
       ├─ Proxy to: Twelve Data API
       │  → GET https://api.twelvedata.com/rsi?symbol=AAPL&interval=1day...
       ├─ Response: 200 OK
       │  {
       │    symbol: "AAPL",
       │    indicator: "RSI",
       │    values: [
       │      { datetime: "2025-01-07", rsi: 62.45 },
       │      { datetime: "2025-01-06", rsi: 58.32 },
       │      ... (100 data points)
       │    ]
       │  }
       ├─ Store in KV: TTL 1800 seconds (30 min)
       └─ Latency: ~135ms

    └─ Request 4: GET /api/profile?symbol=AAPL
       ├─ Cache Check: KV Storage ("profile:AAPL")
       │  └─ Cache Hit! (cached 2 hours ago)
       ├─ Response (from cache):
       │  {
       │    symbol: "AAPL",
       │    name: "Apple Inc",
       │    sector: "Technology",
       │    industry: "Consumer Electronics",
       │    market_cap: 2800000000000,
       │    pe_ratio: 28.5,
       │    eps: 6.55,
       │    dividend_yield: 0.52,
       │    beta: 1.24
       │  }
       └─ Latency: ~18ms (cache hit)

4⃣  DATA PROCESSING (Frontend)
    ├─ File: assets/js/advanced-analysis.js
    ├─ Function: processAnalysisData()
    └─ Actions:
       • Merge all API responses
       • Calculate 14 technical indicators locally:
         → RSI, MACD, Bollinger Bands, Fibonacci, Moving Averages,
            Ichimoku Cloud, Pivot Points, ADX, Stochastic, etc.
       • Generate AI recommendations (3 horizons: Short/Medium/Long)
       • Calculate composite score (0-100)
       • Calculate risk metrics (VaR, Sharpe, Beta, Volatility)
       • Processing Time: ~95ms

5⃣  UI RENDERING (Highcharts)
    ├─ Render 14 interactive charts:
    │  • Candlestick chart (365 data points)
    │  • RSI chart (14 periods)
    │  • MACD chart (histogram + signal)
    │  • Bollinger Bands
    │  • Moving Averages (SMA/EMA)
    │  • Fibonacci Retracements
    │  • Ichimoku Cloud
    │  • Pivot Points
    │  • ADX + DMI
    │  • Stochastic Oscillator
    │  • Volume chart
    │  • Support/Resistance levels
    │  • AI Recommendations (3 cards)
    │  • Risk Metrics dashboard
    └─ Rendering Time: ~280ms

6⃣  FINAL RESULT DISPLAYED
    ├─ Total Time: ~630ms (fetch + process + render)
    ├─ Cache Efficiency: 50% (2/4 requests cached)
    └─ ✅ ANALYSIS COMPLETE

═══════════════════════════════════════════════════════════════════════════════
CACHE TTL CONFIGURATION:
═══════════════════════════════════════════════════════════════════════════════

• quote:                 60s      (1 minute - real-time data)
• timeSeries:         1,800s      (30 minutes - historical data)
• indicators:         1,800s      (30 minutes - technical data)
• profile:           86,400s      (24 hours - company fundamentals)
• search:            86,400s      (24 hours - symbol search)
• statistics:         3,600s      (1 hour - company statistics)

Cache Hit Rate Average: 70%
API Cost Reduction: 85% (compared to no caching)

📊 ADMIN ANALYTICS API
════════════════════════════════════════════════════════════════════

Base URL: https://admin-analytics-api.raphnardone.workers.dev
Purpose: Aggregate Stripe & Cloudflare analytics for admin dashboard

🔌 ENDPOINTS:

1. GET /stripe-analytics
   ├─ Purpose: Retrieve all Stripe subscription data
   ├─ Response: { customers, subscriptions, revenue, plans }
   └─ Auth: Stripe Secret Key

2. GET /cloudflare-analytics?days=30
   ├─ Purpose: Cloudflare httpRequests1dGroups (up to 365 days)
   ├─ Response: { requests, bandwidth, threats, status_codes }
   └─ Limitation: Max 365 days

3. GET /cloudflare-geo
   ├─ Purpose: Geographic distribution of visitors
   └─ Response: { country_code, requests, bandwidth }

4. GET /cloudflare-devices
   ├─ Purpose: Device type breakdown (desktop/mobile/tablet)
   └─ Response: { deviceType, requests, percentage }

5. GET /cloudflare-pages
   ├─ Purpose: Top pages by traffic
   └─ Response: { path, requests, unique_visitors }

6. GET /cloudflare-cache
   ├─ Purpose: Cache hit/miss statistics
   └─ Response: { hit_rate, cached_bytes, requests }

7. GET /cloudflare-referrers
   ├─ Purpose: Top referrer sources
   ├─ Response: { referrer, requests }
   └─ Requirement: Cloudflare Pro plan

8. POST /send-alert-email
   ├─ Purpose: Send admin email alerts (Resend API)
   ├─ Body: { to, subject, html }
   └─ Response: { success, messageId }

9. GET /health
   ├─ Purpose: Health check endpoint
   └─ Response: { status: "ok", timestamp }

⚠ LIMITATIONS:
• Cloudflare Overview: Up to 365 days
• Cloudflare Details (httpRequestsAdaptiveGroups): Max 24 hours
• Referrers: Requires Cloudflare Pro plan

🏛 SEC EDGAR API PROXY
════════════════════════════════════════════════════════════════════

Base URL: https://sec-edgar-api.raphnardone.workers.dev
Purpose: Proxy SEC EDGAR API (bypass 403 errors from Cloudflare IPs)

🔌 ENDPOINTS:

1. GET /filings/form4/recent?count=100
   ├─ Purpose: Recent Form 4 insider trading filings
   ├─ Response: { filings: [...], count, date_range }
   └─ User-Agent: "AlphaVault AI [email protected]"

2. GET /filings/s1/recent?count=50
   ├─ Purpose: Recent S-1 IPO registration filings
   └─ Response: { filings: [...], count }

3. GET /filings/8k/recent?count=100
   ├─ Purpose: Recent 8-K current event reports
   └─ Response: { filings: [...], count }

4. GET /company/{cik}/filings
   ├─ Purpose: All filings for a specific CIK number
   ├─ Example: /company/0000320193/filings (Apple)
   └─ Response: { cik, company_name, filings: [...] }

5. GET /search?ticker=AAPL
   ├─ Purpose: Search company by ticker symbol
   └─ Response: { cik, company_name, tickers }

⚠ KNOWN ISSUE:
SEC EDGAR blocks many cloud provider IPs (403 Forbidden).
Alternative: Use direct CIK numbers or pre-cached data.

💳 PAYMENT FLOW MANAGER
════════════════════════════════════════════════════════════════════

Base URL: https://payment-flow-manager.raphnardone.workers.dev
Purpose: Handle complete payment flow (Stripe + Firebase + Resend)

🔌 ENDPOINTS:

1. POST /create-checkout-session
   ├─ Body: { plan, userId, email, promoCode? }
   ├─ Process:
   │  • Validate plan & promo code
   │  • Create Stripe Coupon (if discount)
   │  • Create Stripe Checkout Session
   │  • Apply trial period (14 days)
   └─ Response: { sessionId, url }

2. POST /webhook (Stripe Webhooks)
   ├─ Events Handled:
   │  • checkout.session.completed
   │  • customer.subscription.updated
   │  • customer.subscription.deleted
   │  • invoice.payment_succeeded
   │  • invoice.payment_failed
   ├─ Actions:
   │  • Update Firebase user plan
   │  • Send confirmation email (Resend)
   │  • Generate HTML invoice
   │  • Log analytics event
   └─ Security: Signature verification (STRIPE_WEBHOOK_SECRET)

3. POST /create-free-customer
   ├─ Body: { userId, email, plan }
   ├─ Purpose: Create free access (FREEPRO/FREEPLATINUM codes)
   └─ Response: { success, plan }

4. GET /verify-subscription?userId={uid}
   ├─ Purpose: Verify active subscription status
   └─ Response: { active, plan, trialEnd, status }

5. POST /cancel-subscription
   ├─ Body: { userId, subscriptionId }
   ├─ Process:
   │  • Cancel Stripe subscription
   │  • Update Firebase (plan: "basic")
   │  • Send cancellation email
   └─ Response: { success, message }

📧 EMAIL TEMPLATES (Resend Integration):
• Payment Confirmation (with HTML invoice attachment)
• Trial Activation (14-day countdown)
• Free Access Granted (lifetime confirmation)
• Subscription Cancelled (downgrade notification)
• Payment Failed (grace period warning)

📰 NEWSLETTER AUTOMATION
════════════════════════════════════════════════════════════════════

Base URL: https://newsletter-automation.raphnardone.workers.dev
Purpose: Automated weekly newsletters based on market events

🔌 ENDPOINTS:

1. POST /generate-newsletter
   ├─ Body: { topics, period }
   ├─ Process:
   │  • Fetch top market news (FinnHub API)
   │  • Analyze major political events (News API)
   │  • Generate AI summary (Gemini 2.5 Flash)
   │  • Create HTML email template
   └─ Response: { html, subject, preview_text }

2. POST /send-newsletter
   ├─ Body: { subject, html, subscribers }
   ├─ Process:
   │  • Fetch subscribers from Firestore (/users with newsletter: true)
   │  • Batch send via Resend API (max 100 recipients/email)
   │  • Track opens/clicks (UTM parameters)
   │  • Log campaign analytics
   └─ Response: { sent, failed, campaign_id }

3. GET /subscribers
   ├─ Purpose: Get all newsletter subscribers
   └─ Response: { count, subscribers: [...] }

4. POST /schedule-newsletter
   ├─ Body: { cron, topics }
   ├─ Purpose: Schedule recurring newsletters
   └─ Response: { scheduled, next_send }

🤖 AI-POWERED CONTENT:
• Major market movements (S&P 500, Nasdaq, Dow Jones)
• Political events impacting markets (Fed decisions, elections, policy changes)
• Top stock gainers/losers (daily/weekly)
• Economic calendar highlights (CPI, NFP, GDP releases)
• Sector rotation analysis
• Expert commentary synthesis

🤖 MACHINE LEARNING TREND PREDICTION
════════════════════════════════════════════════════════════════════

File: assets/js/trend-prediction.js (2,485 lines)
Purpose: Predict stock price movements using 5 ML models + ensemble

📊 MODELS IMPLEMENTED:

1⃣  LINEAR REGRESSION
    Formula: y = β₀ + β₁x₁ + β₂x₂ + ... + βₙxₙ
    Features: Price, Volume, MA20, MA50, RSI, MACD
    Training: Least squares optimization
    Prediction Horizon: 1-30 days
    Accuracy: ~65-70% (short-term)

2⃣  RIDGE REGRESSION (L2 Regularization)
    Formula: y = β₀ + Σ(βᵢxᵢ) + λΣ(βᵢ²)
    Purpose: Prevent overfitting in volatile markets
    Lambda (λ): Auto-tuned via cross-validation
    Accuracy: ~68-73% (medium-term)

3⃣  LASSO REGRESSION (L1 Regularization)
    Formula: y = β₀ + Σ(βᵢxᵢ) + λΣ|βᵢ|
    Purpose: Feature selection (automatic)
    Best for: Identifying key market drivers
    Accuracy: ~66-71% (long-term)

4⃣  RANDOM FOREST (Ensemble Decision Trees)
    Trees: 100 estimators
    Max Depth: 10 levels
    Features: Technical indicators + volume patterns
    Bootstrap Sampling: 80% of data per tree
    Accuracy: ~72-78% (all horizons)

5⃣  LSTM (Long Short-Term Memory Neural Network)
    Architecture: 3 layers (128, 64, 32 neurons)
    Sequence Length: 60 days (lookback window)
    Activation: Tanh (hidden), Linear (output)
    Training: Adam optimizer, MSE loss
    Epochs: 100 (with early stopping)
    Accuracy: ~75-82% (best for time series)

🎯 ENSEMBLE PREDICTION:
    Final Prediction = Weighted Average of 5 models
    Weights: [0.15, 0.15, 0.15, 0.25, 0.30]
    (LSTM gets highest weight due to superior accuracy)

    Ensemble Accuracy: ~78-85% (production)

📈 BACKTESTING ENGINE:
    • Walk-forward validation (rolling window)
    • Out-of-sample testing (20% holdout)
    • Performance metrics: MAE, RMSE, R², Sharpe Ratio
    • Signal accuracy: Directional hit rate (up/down/neutral)

💡 FEATURES USED (Total: 18):
    Price Features: Open, High, Low, Close, Volume
    Moving Averages: SMA 20/50/100/200, EMA 20/50
    Momentum: RSI (14), MACD (12,26,9), Stochastic (14,3,3)
    Volatility: Bollinger Bands (20,2), ATR (14)
    Trend: ADX (14), Parabolic SAR

🎲 MONTE CARLO PORTFOLIO SIMULATION
════════════════════════════════════════════════════════════════════

File: assets/js/monte-carlo.js (2,086 lines)
Purpose: Probabilistic forecasting with 6 statistical models

🔢 MODELS IMPLEMENTED:

1⃣  GEOMETRIC BROWNIAN MOTION (Normal Distribution)
    Formula: S(t) = S₀ × exp((μ - σ²/2)t + σ√t × Z)
    Where:
    • S(t) = Stock price at time t
    • S₀ = Initial price
    • μ = Expected return (drift)
    • σ = Volatility (standard deviation)
    • Z ~ N(0,1) = Random normal variable
    
    Use Case: Standard stock price simulation
    Assumptions: Log-normal returns, constant volatility

2⃣  STUDENT-T DISTRIBUTION
    Formula: S(t) = S₀ × exp((μ - σ²/2)t + σ√t × T)
    Where:
    • T ~ t(df) = Student-t random variable
    • df = Degrees of freedom (default: 5)
    
    Use Case: Fat-tailed distributions (market crashes)
    Advantage: Captures extreme events better than Normal

3⃣  LOG-NORMAL DISTRIBUTION
    Formula: S(t) = S₀ × exp(μt + σ√t × Z)
    Where:
    • Returns are log-normally distributed
    • Ensures positive prices (S > 0)
    
    Use Case: Long-term portfolio projections
    Advantage: No negative prices possible

4⃣  JUMP DIFFUSION (Merton Model)
    Formula: S(t) = S₀ × exp((μ - σ²/2)t + σ√t × Z + Σ Jumps)
    Where:
    • Jumps ~ Poisson(λ) process
    • Jump size ~ N(μⱼ, σⱼ²)
    • λ = Jump intensity (avg jumps/year)
    
    Use Case: Sudden market shocks (earnings, news)
    Parameters:
    • λ = 2 jumps/year
    • μⱼ = -0.05 (avg -5% jump)
    • σⱼ = 0.10 (10% jump volatility)

5⃣  REGIME SWITCHING (Markov Chain)
    States: Bull Market (μ₁, σ₁) ↔ Bear Market (μ₂, σ₂)
    Transition Matrix:
    P = | 0.90  0.10 |  (90% stay Bull, 10% switch to Bear)
        | 0.20  0.80 |  (20% switch to Bull, 80% stay Bear)
    
    Bull: μ = 12%, σ = 15%
    Bear: μ = -8%, σ = 25%
    
    Use Case: Economic cycles, recession modeling

6⃣  GARCH (Generalized Autoregressive Conditional Heteroskedasticity)
    Volatility Equation: σₜ² = ω + α × εₜ₋₁² + β × σₜ₋₁²
    Where:
    • ω = Long-term variance baseline
    • α = ARCH effect (reaction to shocks)
    • β = GARCH effect (volatility persistence)
    • Constraint: α + β < 1 (stationarity)
    
    Use Case: Time-varying volatility (VIX-like behavior)
    Parameters: ω=0.000001, α=0.15, β=0.80

🎯 SIMULATION PARAMETERS:
    • Number of Simulations: 10,000 paths
    • Time Horizon: 1 day to 10 years
    • Time Steps: Daily granularity
    • Initial Capital: User-defined
    • Annual Return (μ): Historical or user input
    • Volatility (σ): Historical std dev or implied vol

📊 OUTPUT METRICS:
    • Percentile Distribution: 5%, 25%, 50%, 75%, 95%
    • Value at Risk (VaR): 95% confidence level
    • Conditional VaR (CVaR): Expected loss in worst 5%
    • Probability of Loss: P(Final Value < Initial)
    • Maximum Drawdown: Worst peak-to-trough decline
    • Sharpe Ratio: Risk-adjusted return

📊 PORTFOLIO OPTIMIZATION ALGORITHMS
════════════════════════════════════════════════════════════════════

🎯 MARKOWITZ MEAN-VARIANCE OPTIMIZATION

Objective: Maximize Sharpe Ratio
Formula: SR = (E[Rₚ] - Rբ) / σₚ

Where:
• E[Rₚ] = Portfolio expected return = Σ(wᵢ × E[Rᵢ])
• Rբ = Risk-free rate (default: 2%)
• σₚ = Portfolio volatility = √(wᵀ × Σ × w)
• w = Asset weights (w₁, w₂, ..., wₙ)
• Σ = Covariance matrix

Constraints:
• Σwᵢ = 1 (fully invested)
• 0 ≤ wᵢ ≤ 1 (long-only, no short selling)
• wᵢ ≥ min_weight (optional: 5% minimum per asset)
• wᵢ ≤ max_weight (optional: 40% maximum per asset)

Solver: Sequential Quadratic Programming (SQP)
Output: Optimal weights for Maximum Sharpe Ratio

────────────────────────────────────────────────────────────────────

⚖ RISK PARITY ALLOCATION

Objective: Equalize Risk Contribution
Formula: RCᵢ = wᵢ × (Σw)ᵢ / σₚ = 1/N (for all assets)

Where:
• RCᵢ = Risk contribution of asset i
• (Σw)ᵢ = Marginal contribution to portfolio risk
• Target: RCᵢ = RC_target = 1/N (equal risk)

Algorithm:
1. Calculate covariance matrix Σ from historical returns
2. Initialize weights: w₀ = (1/N, 1/N, ..., 1/N)
3. Iterate until convergence:
   a. Calculate portfolio volatility: σₚ = √(wᵀΣw)
   b. Calculate marginal risk: MRᵢ = (Σw)ᵢ / σₚ
   c. Calculate risk contributions: RCᵢ = wᵢ × MRᵢ
   d. Adjust weights: w_new = w × (RC_target / RCᵢ)^λ
   e. Normalize: w_new = w_new / Σw_new
4. Repeat until |RCᵢ - RC_target| < tolerance (ε = 0.0001)

Advantage: Better diversification in crisis periods
Use Case: Risk-balanced portfolios (60/40 alternative)

────────────────────────────────────────────────────────────────────

📈 EFFICIENT FRONTIER CONSTRUCTION

1. Minimum Variance Portfolio (leftmost point)
   Minimize: σₚ = √(wᵀΣw)
   Subject to: Σwᵢ = 1

2. Maximum Return Portfolio (rightmost point)
   Maximize: E[Rₚ] = Σ(wᵢ × E[Rᵢ])
   Subject to: Σwᵢ = 1

3. Intermediate Portfolios (100 points on frontier)
   For target return r ∈ [min_return, max_return]:
   Minimize: σₚ
   Subject to: E[Rₚ] = r, Σwᵢ = 1

4. Capital Allocation Line (CAL)
   Tangent line from risk-free rate to efficient frontier
   Slope = Maximum Sharpe Ratio

Output: 100 portfolios (return, risk, weights) + CAL

📊 14 WALL STREET TECHNICAL INDICATORS
════════════════════════════════════════════════════════════════════

1⃣  RSI (Relative Strength Index)
    Period: 14
    Formula: RSI = 100 - (100 / (1 + RS))
    Where: RS = Average Gain / Average Loss
    Signals:
    • RSI > 70: Overbought (sell signal)
    • RSI < 30: Oversold (buy signal)
    • RSI = 50: Neutral

2⃣  MACD (Moving Average Convergence Divergence)
    Fast EMA: 12 periods
    Slow EMA: 26 periods
    Signal Line: 9-period EMA of MACD
    Formula: MACD = EMA(12) - EMA(26)
    Histogram: MACD - Signal
    Signals:
    • MACD crosses above Signal: Bullish
    • MACD crosses below Signal: Bearish

3⃣  BOLLINGER BANDS
    Period: 20
    Standard Deviations: 2
    Formula:
    • Middle Band = SMA(20)
    • Upper Band = SMA(20) + 2×σ
    • Lower Band = SMA(20) - 2×σ
    Signals:
    • Price touches upper band: Overbought
    • Price touches lower band: Oversold
    • Bollinger Squeeze: Low volatility (breakout imminent)

4⃣  FIBONACCI RETRACEMENTS
    Levels: 0%, 23.6%, 38.2%, 50%, 61.8%, 78.6%, 100%
    Extensions: 161.8%, 261.8%
    Formula: Level = High - (High - Low) × Fib_Ratio
    Use Case: Support/resistance levels

5⃣  MOVING AVERAGES
    • SMA 20 (Short-term trend)
    • SMA 50 (Medium-term trend)
    • SMA 100 (Long-term trend)
    • SMA 200 (Major trend line)
    • EMA 20 (Faster response)
    • EMA 50 (Faster response)
    Signals:
    • Golden Cross: SMA(50) > SMA(200) → Bullish
    • Death Cross: SMA(50) < SMA(200) → Bearish

6⃣  ICHIMOKU CLOUD
    Components:
    • Tenkan-sen (9): (High₉ + Low₉) / 2
    • Kijun-sen (26): (High₂₆ + Low₂₆) / 2
    • Senkou A: (Tenkan + Kijun) / 2 (shifted 26 ahead)
    • Senkou B: (High₅₂ + Low₅₂) / 2 (shifted 26 ahead)
    • Chikou: Close (shifted 26 back)
    • Kumo (Cloud): Area between Senkou A & B
    Signals:
    • Price above cloud: Bullish
    • Price below cloud: Bearish

7⃣  PIVOT POINTS (Standard, Fibonacci, Camarilla)
    Standard:
    • Pivot (P) = (High + Low + Close) / 3
    • R1 = 2P - Low, S1 = 2P - High
    • R2 = P + (High - Low), S2 = P - (High - Low)
    • R3 = High + 2(P - Low), S3 = Low - 2(High - P)
    
    Fibonacci:
    • R1 = P + 0.382(High - Low)
    • R2 = P + 0.618(High - Low)
    
    Camarilla:
    • R4 = Close + (High - Low) × 1.1/2
    • S4 = Close - (High - Low) × 1.1/2

8⃣  ADX (Average Directional Index) + DMI
    Period: 14
    Components:
    • +DI (Positive Directional Indicator)
    • -DI (Negative Directional Indicator)
    • ADX (Trend Strength)
    Formula: ADX = SMA(14) of DX
    Where: DX = 100 × |+DI - -DI| / (+DI + -DI)
    Signals:
    • ADX > 25: Strong trend
    • ADX < 20: Weak trend (range-bound)
    • +DI > -DI: Uptrend
    • -DI > +DI: Downtrend

9⃣  STOCHASTIC OSCILLATOR
    %K Period: 14
    %D Period: 3 (SMA of %K)
    Slow Period: 3
    Formula: %K = 100 × (Close - Low₁₄) / (High₁₄ - Low₁₄)
    Signals:
    • %K > 80: Overbought
    • %K < 20: Oversold
    • %K crosses above %D: Buy
    • %K crosses below %D: Sell

🔟  ATR (Average True Range)
    Period: 14
    Formula: ATR = SMA(14) of True Range
    Where: TR = max(High - Low, |High - Close_prev|, |Low - Close_prev|)
    Use: Volatility measurement (not directional)

1⃣1⃣  PARABOLIC SAR
    Acceleration Factor: 0.02 (increments by 0.02, max 0.20)
    Formula: SAR = SAR_prev + AF × (EP - SAR_prev)
    Where: EP = Extreme Point (highest high or lowest low)
    Signals:
    • SAR below price: Uptrend
    • SAR above price: Downtrend

1⃣2⃣  OBV (On-Balance Volume)
    Formula: OBV = OBV_prev + Volume (if Close > Close_prev)
             OBV = OBV_prev - Volume (if Close < Close_prev)
    Use: Volume-based momentum indicator

1⃣3⃣  SUPPORT & RESISTANCE LEVELS
    Algorithm:
    1. Identify local peaks (resistance)
    2. Identify local troughs (support)
    3. Cluster similar levels (±2% tolerance)
    4. Rank by touch count (more touches = stronger level)

1⃣4⃣  VOLUME ANALYSIS
    Metrics:
    • Volume MA(20): Average daily volume
    • Relative Volume: Current / MA(20)
    • Volume Breakout: Volume > 2× MA(20)
    Signals:
    • High volume + price up: Strong bullish
    • High volume + price down: Strong bearish
    • Low volume: Weak trend (reversal risk)