╔══════════════════════════════════════════════════════════════════════════════════════╗
║                                                                                      ║
║                  AIVA DEMO RECORDING - COMPLETE WORKFLOW                             ║
║                                                                                      ║
╚══════════════════════════════════════════════════════════════════════════════════════╝


┌─────────────────────────────────────────────────────────────────────────────────────┐
│                               PHASE 1: SETUP                                        │
└─────────────────────────────────────────────────────────────────────────────────────┘

    ┌─────────────────┐
    │  test_setup.py  │  ──┬──>  ✅ Python 3.8+
    │   (validate)    │    ├──>  ✅ requests, python-docx
    └─────────────────┘    ├──>  ❌ ffmpeg (INSTALL NEEDED)
                           ├──>  ✅ Demo script .docx
                           ├──>  ✅ Output directory
                           ├──>  ✅ Telnyx API key
                           └──>  ✅ Disk space

                ↓

    ┌─────────────────────────┐
    │  sudo apt-get install   │
    │       ffmpeg            │
    └─────────────────────────┘

                ↓

           [READY TO RUN]


┌─────────────────────────────────────────────────────────────────────────────────────┐
│                         PHASE 2: EXECUTION                                          │
└─────────────────────────────────────────────────────────────────────────────────────┘

    ┌──────────────────┐       OR        ┌──────────────────┐
    │ QUICK_START.sh   │  ─────────────> │ record_demo.py   │
    │ (automated)      │                 │ (manual)         │
    └──────────────────┘                 └──────────────────┘
                                                  │
                                                  ↓
                              ┌───────────────────────────────────┐
                              │  STEP 1: Read Demo Script         │
                              ├───────────────────────────────────┤
                              │  Source: .docx file               │
                              │  Fallback: Embedded text          │
                              │  Output: Script string (~75s)     │
                              └───────────────────────────────────┘
                                                  │
                                                  ↓
                              ┌───────────────────────────────────┐
                              │  STEP 2: Call Telnyx TTS API      │
                              ├───────────────────────────────────┤
                              │  POST /v2/text-to-speech          │
                              │  Voice: eucalyptus                │
                              │  Format: WAV (22.05kHz)           │
                              │  Time: ~5-10 seconds              │
                              └───────────────────────────────────┘
                                                  │
                                                  ↓
                              ┌───────────────────────────────────┐
                              │  STEP 3: Save Raw Audio           │
                              ├───────────────────────────────────┤
                              │  File: demo_raw.wav               │
                              │  Size: ~2-3 MB                    │
                              │  Format: 22.05kHz mono WAV        │
                              └───────────────────────────────────┘
                                                  │
                                                  ↓
                              ┌───────────────────────────────────┐
                              │  STEP 4: Normalize Volume         │
                              ├───────────────────────────────────┤
                              │  Tool: ffmpeg loudnorm filter     │
                              │  Target: -16 LUFS                 │
                              │  Output: demo_normalized.wav      │
                              └───────────────────────────────────┘
                                                  │
                                                  ↓
                              ┌───────────────────────────────────┐
                              │  STEP 5: Trim Silence             │
                              ├───────────────────────────────────┤
                              │  Tool: ffmpeg silenceremove       │
                              │  Threshold: -50dB                 │
                              │  Output: demo_trimmed.wav         │
                              └───────────────────────────────────┘
                                                  │
                                    ┌─────────────┴─────────────┐
                                    │                           │
                                    ↓                           ↓
                    ┌───────────────────────────┐   ┌───────────────────────────┐
                    │  STEP 6a: Convert to Opus │   │  STEP 6b: Convert to MP3  │
                    ├───────────────────────────┤   ├───────────────────────────┤
                    │  Tool: ffmpeg libopus     │   │  Tool: ffmpeg libmp3lame  │
                    │  Bitrate: 32 kbps VBR     │   │  Bitrate: 48 kbps CBR     │
                    │  Compression: Level 10    │   │  Channels: Mono           │
                    │  Output: demo.opus        │   │  Output: demo.mp3         │
                    │  Size: ~300KB             │   │  Size: ~450KB             │
                    └───────────────────────────┘   └───────────────────────────┘
                                    │                           │
                                    └─────────────┬─────────────┘
                                                  ↓
                              ┌───────────────────────────────────┐
                              │  STEP 7: Verification             │
                              ├───────────────────────────────────┤
                              │  Check: File sizes                │
                              │  Check: Duration                  │
                              │  Check: Quality                   │
                              │  Report: Pass/Fail                │
                              └───────────────────────────────────┘
                                                  │
                                                  ↓
                                          [AUDIO FILES READY]


┌─────────────────────────────────────────────────────────────────────────────────────┐
│                         PHASE 3: DEPLOYMENT                                         │
└─────────────────────────────────────────────────────────────────────────────────────┘

    ┌─────────────────────────────────────────────────────────────┐
    │  OUTPUT FILES                                               │
    ├─────────────────────────────────────────────────────────────┤
    │  ✅ demo.opus  (Primary - WebM/Opus, ~300KB)                │
    │  ✅ demo.mp3   (Fallback - MP3, ~450KB)                     │
    └─────────────────────────────────────────────────────────────┘
                              │
                              ↓
    ┌─────────────────────────────────────────────────────────────┐
    │  MANUAL DEPLOYMENT STEPS                                    │
    ├─────────────────────────────────────────────────────────────┤
    │  1. Listen to both files (quality check)                    │
    │  2. Upload to website: /assets/audio/                       │
    │  3. Update hero page HTML with <audio> element              │
    │  4. Add JavaScript to sync with video                       │
    │  5. Test on multiple browsers                               │
    │  6. Test on mobile devices                                  │
    │  7. Monitor performance (<2s load time)                     │
    └─────────────────────────────────────────────────────────────┘
                              │
                              ↓
                    [LIVE ON WEBSITE]


┌─────────────────────────────────────────────────────────────────────────────────────┐
│                         FILE RELATIONSHIP MAP                                       │
└─────────────────────────────────────────────────────────────────────────────────────┘

 📂 /mnt/e/genesis-system/
    │
    ├─ 📂 plans/
    │   └─ 📄 AIVA_DEMO_RECORDING_PIPELINE.md ───────> Technical design document
    │
    └─ 📂 RECEPTIONISTAI/
        │
        ├─ 📄 DEMO_RECORDING_SUMMARY.md ────────────────> Project overview
        ├─ 📄 Receptionist AI Pre-Recording Demo Script.docx ──> Input script
        │
        ├─ 📂 scripts/
        │   ├─ 📄 INDEX.md ─────────────────────────────> Navigation guide
        │   ├─ 📄 README_RECORDING.md ──────────────────> Detailed guide
        │   ├─ 📄 REFERENCE_CARD.txt ───────────────────> Quick reference
        │   ├─ 📄 WORKFLOW_DIAGRAM.txt ─────────────────> This file
        │   │
        │   ├─ 🔧 QUICK_START.sh ───────────────────────> Automated setup
        │   ├─ 🐍 record_demo.py ──────────────────────> Main script
        │   └─ 🐍 test_setup.py ───────────────────────> Validation
        │
        └─ 📂 assets/audio/
            ├─ 🔊 demo_raw.wav ─────────────────────────> Raw TTS output
            ├─ 🔊 demo_normalized.wav ──────────────────> Volume normalized
            ├─ 🔊 demo_trimmed.wav ─────────────────────> Silence removed
            ├─ ✅ demo.opus ────────────────────────────> FINAL PRIMARY
            └─ ✅ demo.mp3 ─────────────────────────────> FINAL FALLBACK


┌─────────────────────────────────────────────────────────────────────────────────────┐
│                         TECHNOLOGY STACK                                            │
└─────────────────────────────────────────────────────────────────────────────────────┘

    ┌──────────────┐
    │   Python 3   │ ──> Orchestration, API calls, file management
    └──────────────┘

    ┌──────────────┐
    │   requests   │ ──> HTTP library for Telnyx API
    └──────────────┘

    ┌──────────────┐
    │ python-docx  │ ──> Read .docx script file
    └──────────────┘

    ┌──────────────┐
    │    ffmpeg    │ ──> Audio processing (normalize, trim, convert)
    └──────────────┘

    ┌──────────────┐
    │ Telnyx TTS   │ ──> Text-to-speech API (eucalyptus voice)
    └──────────────┘

    ┌──────────────┐
    │ Opus Codec   │ ──> WebM/Opus encoding (32 kbps)
    └──────────────┘

    ┌──────────────┐
    │ LAME MP3     │ ──> MP3 encoding (48 kbps)
    └──────────────┘


┌─────────────────────────────────────────────────────────────────────────────────────┐
│                         DECISION TREE                                               │
└─────────────────────────────────────────────────────────────────────────────────────┘

                       START
                         │
                         ↓
              [First time running?]
                    /      \
                 YES        NO
                  │          │
                  ↓          ↓
         Read DEMO_    Run test_setup.py
         RECORDING_         │
         SUMMARY.md         ↓
                  │    [All checks pass?]
                  │       /         \
                  │     YES          NO
                  │      │            │
                  │      │            ↓
                  │      │    Install missing deps
                  │      │    (ffmpeg, packages)
                  │      │            │
                  └──────┴────────────┘
                         │
                         ↓
               [Want automation?]
                    /      \
                 YES        NO
                  │          │
                  ↓          ↓
          QUICK_START.sh   record_demo.py
                  │          │
                  └────┬─────┘
                       │
                       ↓
              [Audio generated?]
                    /      \
                 YES        NO
                  │          │
                  ↓          ↓
         Listen & verify  Check errors
              quality      Fix issues
                  │        Re-run
                  ↓
         [Quality OK?]
              /      \
           YES        NO
            │          │
            ↓          ↓
    Deploy to site  Adjust settings
                    (voice, bitrate)
                    Re-generate
                         │
                         ↓
                       DONE


┌─────────────────────────────────────────────────────────────────────────────────────┐
│                         QUICK COMMANDS CHEAT SHEET                                  │
└─────────────────────────────────────────────────────────────────────────────────────┘

  # Navigate to scripts directory
  cd /mnt/e/genesis-system/RECEPTIONISTAI/scripts

  # Test setup (first time)
  python test_setup.py

  # Install ffmpeg (if needed)
  sudo apt-get install ffmpeg

  # Generate audio (automated)
  ./QUICK_START.sh

  # Generate audio (manual)
  python record_demo.py

  # Listen to output
  ffplay ../assets/audio/demo.opus
  ffplay ../assets/audio/demo.mp3

  # Check file info
  ls -lh ../assets/audio/demo.*
  ffprobe ../assets/audio/demo.opus

  # Read documentation
  cat README_RECORDING.md
  cat REFERENCE_CARD.txt
  cat ../DEMO_RECORDING_SUMMARY.md


┌─────────────────────────────────────────────────────────────────────────────────────┐
│                         SUPPORT CONTACTS                                            │
└─────────────────────────────────────────────────────────────────────────────────────┘

  Documentation:   See README_RECORDING.md
  Troubleshooting: Run test_setup.py for diagnostics
  API Issues:      Check Telnyx dashboard
  Genesis Team:    Internal Genesis support


┌─────────────────────────────────────────────────────────────────────────────────────┐
│                         PROJECT STATUS                                              │
└─────────────────────────────────────────────────────────────────────────────────────┘

  ✅ Pipeline designed and documented
  ✅ Recording script implemented
  ✅ Testing tools created
  ✅ Documentation complete
  ⚠️  ffmpeg installation required (one-time)
  ⏳ Audio generation pending
  ⏳ Website deployment pending

  NEXT ACTION: Install ffmpeg → Run QUICK_START.sh


                              ──────────────
                           Genesis AI - 2026-02-15
                              ──────────────