================================================================================
MINIMUM FILES REQUIRED FOR HUGGINGFACE SPACES
================================================================================

THESE 9 FILES ARE ABSOLUTELY REQUIRED:
(App will crash without these)

  1. app.py                    ← MAIN FILE (HF Spaces entry point)
  2. llm.py                    ← LLM inference
  3. extractors.py             ← Document extraction
  4. tagging.py                ← Speaker tagging
  5. chunking.py               ← Text chunking
  6. validation.py             ← Quality validation
  7. reporting.py              ← CSV/PDF reports
  8. dashboard.py              ← Dashboard generation
  9. requirements.txt          ← Python dependencies

================================================================================
OPTIONAL FILES:
(App will work without these, but with reduced features)

 10. production_logger.py      ← Advanced logging (now optional)
 11. quote_extractor.py        ← Market research quotes (now optional)

If missing, you'll see warnings like:
⚠️ Production logging not available - using basic logging
⚠️ Quote extraction not available - reports will not include storytelling quotes

================================================================================
RECOMMENDED UPLOAD:
================================================================================

Upload all 11 files for full functionality:

  1. app.py
  2. llm.py
  3. extractors.py
  4. tagging.py
  5. chunking.py
  6. validation.py
  7. reporting.py
  8. dashboard.py
  9. requirements.txt
 10. production_logger.py
 11. quote_extractor.py

================================================================================
SPACE SETTINGS:
================================================================================

SDK:       Gradio
Hardware:  GPU (T4 or better)

================================================================================
STATUS: READY TO DEPLOY
================================================================================

✅ Import errors fixed - app will not crash on missing optional files
✅ Local model inference configured
✅ No .env file needed
✅ No terminal commands needed

Just upload the files and it works!

================================================================================