🔧 Miscellaneous Processing

📖 Overview

This section covers additional Queue Manager modules including project processing, Intercom lead management, and schedule utilization monitoring.

Environment Flags:

• QM_PROJECTS=true - Project processing
• QM_INTERCOM_LEADS=true - Intercom lead synchronization
• QM_SCHEDULE_UTILIZATION_MONITORING=true - Schedule utilization tracking

Source Locations: queue-manager/crons/projects.js, queue-manager/crons/misc/, queue-manager/crons/schedule/

🔧 Projects Processing

Overview

Handles project-related background tasks and updates.

Environment Flag: QM_PROJECTS=true

Source: queue-manager/crons/projects.js, queue-manager/services/projects/

Key Features

• Project Updates: Processes project status changes
• Task Management: Handles task assignments and updates
• Milestone Tracking: Monitors project milestones
• Client Notifications: Sends project update notifications

---

📧 Intercom Leads

Overview

Synchronizes leads from Intercom conversations into the DashClicks system.

Environment Flag: QM_INTERCOM_LEADS=true

Source: queue-manager/crons/misc/intercom.leads.js

Key Features

• Lead Capture: Imports new leads from Intercom
• Conversation Sync: Syncs conversation history
• Contact Enrichment: Enriches contact data
• CRM Integration: Creates deals from qualified leads
• Duplicate Prevention: Avoids duplicate contact creation

Processing Flow

1. Query Intercom API for new conversations
2. Extract lead information (name, email, company)
3. Check for existing contacts
4. Create or update contact records
5. Sync conversation messages
6. Create deal if qualified
7. Mark as processed

---

📊 Schedule Utilization Monitoring

Overview

Monitors and tracks utilization of scheduling system resources.

Environment Flag: QM_SCHEDULE_UTILIZATION_MONITORING=true

Source: queue-manager/crons/schedule/utilization-monitoring.js

Key Features

• Resource Tracking: Monitors calendar availability
• Usage Metrics: Calculates utilization percentages
• Capacity Planning: Identifies overbooked resources
• Alert Generation: Notifies on low/high utilization
• Historical Analysis: Tracks utilization trends

Metrics Tracked

• Calendar Utilization: Percentage of booked time slots
• Meeting Count: Number of scheduled meetings
• Average Duration: Mean meeting length
• Peak Hours: Most utilized time periods
• Cancellation Rate: Percentage of cancelled meetings

Use Cases

• Staff capacity planning
• Resource allocation optimization
• Schedule efficiency analysis
• Overbooking prevention

---

🗄️ Collections Used

project

• Operations: Read/Update
• Model: shared/models/project.js
• Usage: Project records and status

contact

• Operations: Create/Update
• Model: shared/models/contact.js
• Usage: Leads from Intercom

deal

• Operations: Create
• Model: shared/models/deal.js
• Usage: Deals created from qualified leads

availability-scheduler

• Operations: Read
• Model: shared/models/availability-scheduler.js
• Usage: Schedule and utilization data

---

Module Status: Active
Execution Pattern: Various (polling, daily, hourly)
Last Updated: 2025-10-10