breadcrumb-the-shire/modules/helpdesk/web/js/helpdesk-team.js

/**
 * Team workload dashboard — visual workload map with avatar cards.
 * Current tab: queue section + agent cards with ticket pills.
 * Performance tab: compact agent cards with resolved counts.
 */

const container = document.querySelector('.app-details-container[data-team-workload-url]');
if (container) {
  const dataUrl = container.dataset.teamWorkloadUrl;
  const labelQueue = container.dataset.labelQueue || 'Queue';
  const labelTickets = container.dataset.labelTickets || 'Tickets';

  const elLoading = document.getElementById('team-loading');
  const elError = document.getElementById('team-error');
  const elEmpty = document.getElementById('team-empty');
  const elContent = document.getElementById('team-content');
  const elCurrentCards = document.getElementById('team-current-cards');
  const elPerformanceCards = document.getElementById('team-performance-cards');
  const elRefresh = container.querySelector('button[name="team-refresh"]');
  const periodSelector = document.getElementById('team-period-selector');

  let currentPeriod = 90;

  function showState(state) {
    if (elLoading) elLoading.hidden = state !== 'loading';
    if (elError) elError.hidden = state !== 'error';
    if (elEmpty) elEmpty.hidden = state !== 'empty';
    if (elContent) elContent.hidden = state !== 'success';
    if (elLoading) elLoading.setAttribute('aria-busy', state === 'loading' ? 'true' : 'false');
  }

  function h(tag, cls, text) {
    const e = document.createElement(tag);
    if (cls) e.className = cls;
    if (text !== undefined) e.textContent = text;
    return e;
  }

  /**
   * Generate two-letter initials from a display name.
   */
  function initials(name) {
    const parts = name.trim().split(/\s+/);
    if (parts.length >= 2) return (parts[0][0] + parts[parts.length - 1][0]).toUpperCase();
    return name.substring(0, 2).toUpperCase();
  }

  /**
   * Deterministic hue from string — consistent color per agent.
   */
  function nameHue(name) {
    let hash = 0;
    for (let i = 0; i < name.length; i++) {
      hash = name.charCodeAt(i) + ((hash << 5) - hash);
    }
    return Math.abs(hash) % 360;
  }

  function formatAge(hours) {
    if (hours < 24) return hours + 'h';
    return Math.floor(hours / 24) + 'd';
  }

  /**
   * Build a ticket pill: "T-1234 · K-10610 · 12h"
   */
  function buildTicketPill(t) {
    const pill = h('span', 'helpdesk-team-pill');
    if (t.critical) pill.classList.add('helpdesk-team-pill-critical');

    pill.appendChild(h('span', 'helpdesk-team-pill-no', t.no));
    if (t.customer) {
      pill.appendChild(h('span', 'helpdesk-team-pill-sep', '·'));
      pill.appendChild(h('span', 'helpdesk-team-pill-customer', t.customer));
    }
    pill.appendChild(h('span', 'helpdesk-team-pill-sep', '·'));
    pill.appendChild(h('span', 'helpdesk-team-pill-age', formatAge(t.age_hours)));

    if (t.description) pill.title = t.description;
    return pill;
  }

  /**
   * Build the queue section (unassigned tickets).
   */
  function buildQueueSection(member) {
    const section = h('div', 'helpdesk-team-queue');

    const header = h('div', 'helpdesk-team-queue-header');
    header.appendChild(h('span', 'helpdesk-team-queue-title', labelQueue));
    header.appendChild(h('span', 'helpdesk-team-queue-count', String(member.open_tickets) + ' ' + labelTickets));
    section.appendChild(header);

    const pills = h('div', 'helpdesk-team-pills');
    for (const t of member.open_ticket_details || []) {
      pills.appendChild(buildTicketPill(t));
    }
    section.appendChild(pills);

    return section;
  }

  /**
   * Build an agent card with avatar, load bar, and ticket pills.
   */
  function buildAgentCard(m, maxOpen) {
    const pct = maxOpen > 0 ? Math.round((m.open_tickets / maxOpen) * 100) : 0;
    const hue = nameHue(m.display_name);

    const card = h('article', 'helpdesk-team-agent');

    // Avatar
    const avatar = h('div', 'helpdesk-team-avatar', initials(m.display_name));
    avatar.style.setProperty('--agent-hue', hue);
    card.appendChild(avatar);

    // Content area
    const content = h('div', 'helpdesk-team-agent-content');

    // Name row
    const nameRow = h('div', 'helpdesk-team-agent-header');
    nameRow.appendChild(h('span', 'helpdesk-team-agent-name', m.display_name));
    const countBadge = h('span', 'helpdesk-team-agent-count', String(m.open_tickets));
    if (m.critical_tickets > 0) countBadge.classList.add('helpdesk-team-agent-count-warning');
    nameRow.appendChild(countBadge);
    content.appendChild(nameRow);

    // Load bar
    const barTrack = h('div', 'helpdesk-team-agent-bar-track');
    const barFill = h('div', 'helpdesk-team-agent-bar-fill');
    barFill.style.width = pct + '%';
    barFill.style.setProperty('--agent-hue', hue);
    barTrack.appendChild(barFill);
    content.appendChild(barTrack);

    // Ticket pills
    const tickets = m.open_ticket_details || [];
    if (tickets.length > 0) {
      const pills = h('div', 'helpdesk-team-pills');
      for (const t of tickets) pills.appendChild(buildTicketPill(t));
      content.appendChild(pills);
    }

    card.appendChild(content);
    return card;
  }

  /**
   * Build a compact performance card with avatar and resolved bar.
   */
  function buildPerformanceCard(m, maxResolved) {
    const pct = maxResolved > 0 ? Math.round((m.resolved_in_period / maxResolved) * 100) : 0;
    const hue = nameHue(m.display_name || 'queue');

    const card = h('article', 'helpdesk-team-agent helpdesk-team-agent-compact');

    const avatar = h('div', 'helpdesk-team-avatar helpdesk-team-avatar-sm', m.support_user === '' ? '?' : initials(m.display_name));
    avatar.style.setProperty('--agent-hue', m.support_user === '' ? 0 : hue);
    if (m.support_user === '') avatar.classList.add('helpdesk-team-avatar-muted');
    card.appendChild(avatar);

    const content = h('div', 'helpdesk-team-agent-content');
    const nameRow = h('div', 'helpdesk-team-agent-header');
    nameRow.appendChild(h('span', 'helpdesk-team-agent-name', m.support_user === '' ? labelQueue : m.display_name));
    nameRow.appendChild(h('span', 'helpdesk-team-agent-count helpdesk-team-agent-count-success', String(m.resolved_in_period)));
    content.appendChild(nameRow);

    const barTrack = h('div', 'helpdesk-team-agent-bar-track');
    const barFill = h('div', 'helpdesk-team-agent-bar-fill helpdesk-team-agent-bar-success');
    barFill.style.width = pct + '%';
    barTrack.appendChild(barFill);
    content.appendChild(barTrack);

    card.appendChild(content);
    return card;
  }

  function renderCurrentTab(members) {
    if (!elCurrentCards) return;
    elCurrentCards.replaceChildren();

    const queue = members.find(m => m.support_user === '' && m.open_tickets > 0);
    const agents = members.filter(m => m.support_user !== '' && (m.open_tickets > 0 || m.critical_tickets > 0));
    const maxOpen = Math.max(1, ...agents.map(m => m.open_tickets));

    if (queue) elCurrentCards.appendChild(buildQueueSection(queue));
    for (const m of agents) elCurrentCards.appendChild(buildAgentCard(m, maxOpen));
  }

  function renderPerformanceTab(members) {
    if (!elPerformanceCards) return;
    elPerformanceCards.replaceChildren();

    const sorted = [...members]
      .filter(m => m.resolved_in_period > 0)
      .sort((a, b) => {
        if (a.support_user === '') return 1;
        if (b.support_user === '') return -1;
        return b.resolved_in_period - a.resolved_in_period;
      });

    const maxResolved = Math.max(1, ...sorted.map(m => m.resolved_in_period));
    for (const m of sorted) elPerformanceCards.appendChild(buildPerformanceCard(m, maxResolved));
  }

  async function fetchData(refresh = false) {
    showState('loading');

    const params = new URLSearchParams({ periodDays: String(currentPeriod) });
    if (refresh) params.set('refresh', '1');

    try {
      const res = await fetch(dataUrl + '?' + params.toString(), { credentials: 'same-origin' });
      const json = await res.json();

      if (!json.ok) { showState('error'); return; }
      if (!json.members || json.members.length === 0) { showState('empty'); return; }

      renderCurrentTab(json.members);
      renderPerformanceTab(json.members);
      showState('success');
    } catch {
      showState('error');
    }
  }

  if (periodSelector) {
    periodSelector.addEventListener('change', (e) => {
      const radio = e.target.closest('input[name="team-period"]');
      if (!radio) return;
      const period = parseInt(radio.value, 10);
      if (!period || period === currentPeriod) return;
      currentPeriod = period;
      fetchData();
    });
  }

  if (elRefresh) {
    elRefresh.addEventListener('click', () => fetchData(true));
  }

  fetchData();
}