docs/queue.md

System Status: Queue Tracking & Dependency Optimization Complete

Both the Resume Parser and Resume Generator backends are now fully secured, optimized, and deployed live with real-time queue position tracking.

---

What Was Completed

1. Real-Time Server Queue Tracking & UI

• Accurate Backlog Calculation: Built dynamic queue position calculation on the server (queue.size + 1 backlog tracking in index.js).
• Modal UI Live Badge: Updated ExportModal.tsx to display:
  • [ 🟡 In Server Queue (Position #X) ] when waiting in queue.
  • [ 🔵 Active Queue Slot #1 (Processing PDF...) ] when actively rendering.
  • Real-time progress bar.
• Stress-Tested with 100 Jobs: Confirmed live queue positions (#5, #14, #24, #29, #34, #52) advancing in sequence under real concurrent traffic.

2. Generator Dependency Cleanup

• Removed unused packages (react, react-dom, chromium-bidi) from package.json.
• Reduced Docker build size and memory footprint on Hugging Face Spaces.

3. Architecture Summary

Frontend (https://hirechart.netlify.app)
  │
  ├── Resume Parser (Spring Boot - Java 17)
  │     ├── CORS: Restricted to Netlify
  │     ├── Firebase Auth: Bearer Token Check (Free, local cryptographic check)
  │     └── Guest 2-Try Limit: Enforced on LocalStorage & Server
  │
  └── Resume Generator (Express + Puppeteer - Node.js)
        ├── CORS: Restricted to Netlify
        ├── Firebase Auth: Bearer Token Check & 2-Try Guest Limit
        ├── RAM Cache: Instant 0ms re-downloads for identical hashes
        └── P-Queue: Live position tracking (#1, #2, etc.) & concurrency protection