gigafibre-fsm/services/targo-hub/lib/skill-resolver.js

// ── Résolveur « raison → compétence(s) requises » — SOURCE UNIQUE ─────────────
// Pont réutilisable entre TROIS systèmes qui, jusqu'ici, ne se parlaient pas :
//   1. la RAISON d'une demande (chip de département, type de job, ou texte dicté) ;
//   2. la/les COMPÉTENCE(S) réelle(s) d'un technicien (installation, tv, réparation…) ;
//   3. la DISPONIBILITÉ filtrée par compétence (dénominateur des bandes d'occupation).
//
// Appelable de PARTOUT (ticket, courriel, fiche client) via le composant front
// <AvailabilityByReason> et l'endpoint /roster/resolve-skills. Un seul endroit à
// éditer pour faire évoluer la correspondance raison→compétence.
//
// N'importe RIEN de roster.js/dispatch.js (pour éviter tout cycle) — au contraire,
// roster.js ré-exporte `deptToSkill` d'ici pour ne pas dupliquer la logique.
const fs = require('fs')
const path = require('path')
const cfg = require('./config')
const { log } = require('./helpers')

// Vocabulaire CANONIQUE des compétences terrain (= sorties possibles de deptToSkill).
// Une demande à distance / facturation / vente ne requiert AUCUNE compétence → [].
const SKILL_VOCAB = ['installation', 'réparation', 'tv', 'telephone', 'épissure', 'monteur', 'netadmin', 'support']

function normSkill (s) { return String(s || '').trim().toLowerCase() }
function stripAccents (s) { return String(s || '').normalize('NFD').replace(/[̀-ͯ]/g, '') }
// Liste depuis un tableau OU une CSV brute (champ ERP / _user_tags), triée par ordre (= priorité).
function toSkillList (v) { return Array.isArray(v) ? v.filter(Boolean) : String(v || '').split(/[,;]/).map(s => s.trim()).filter(Boolean) }
// 'HH:MM' → heure décimale (pour borner un quart) ; '' → NaN.
function hmToH (t) { const p = String(t || '').split(':'); const h = Number(p[0]); const m = Number(p[1]); return Number.isFinite(h) ? h + (Number.isFinite(m) ? m / 60 : 0) : NaN }

// ── Prédicat PARTAGÉ « ce technicien a-t-il la compétence ? » ──────────────────
// Sémantique IDENTIQUE à celle qui vivait (dupliquée) dans dispatch.js techOccupancy
// + suggestSlots : match exact OU inclusion (≥3 car.) tolérant aux variantes.
// techSkills accepte un TABLEAU (fetchTechnicians) OU une CSV brute (champ ERP / _user_tags).
function techHasSkill (techSkills, want) {
  const w = normSkill(want)
  if (!w) return true
  const list = Array.isArray(techSkills) ? techSkills : String(techSkills || '').split(/[,;]/)
  return list.some(s => {
    s = normSkill(s)
    return s && (s === w || (s.length >= 3 && (s.includes(w) || w.includes(s))))
  })
}
// Plusieurs compétences requises → le tech doit les avoir TOUTES (aligné sur techCovers du solveur).
function techHasSkills (techSkills, wants) {
  const ws = (Array.isArray(wants) ? wants : [wants]).map(normSkill).filter(Boolean)
  if (!ws.length) return true
  return ws.every(w => techHasSkill(techSkills, w))
}

// ── Repli déterministe : texte/département legacy → UNE compétence ─────────────
// (déplacé de roster.js — logique pure, réutilisée partout ; roster.js ré-exporte.)
function deptToSkill (txt) {
  const d = stripAccents(txt).toLowerCase()
  if (!d) return ''
  if (/teleph/.test(d)) return 'telephone'
  if (/\btv\b|tele|televis/.test(d)) return 'tv'
  if (/fusion|episs/.test(d)) return 'épissure'
  if (/monteur|aerien/.test(d)) return 'monteur'
  if (/netadmin|net admin/.test(d)) return 'netadmin'
  // Diagnostic / panne / dépannage → réparation, AVANT l'installation : « voir signal fibre », « panne », « internet lent »,
  // « coupé », « ne fonctionne pas » = une RÉPARATION, pas une pose. (« fibre » seul = une techno, PAS une intention d'installer.)
  // Échange/remplacement d'équipement (modem / ONU / borne) = une RÉPARATION fibre, pas une nouvelle pose : « changer modem »,
  // « remplacement ONU », « swap borne » (accents déjà retirés par stripAccents → tokens sans accent).
  if (/repar|desinstall|panne|signal|lent|coupe|coupure|hors.?service|ne fonctionne|fonctionne pas|marche pas|sans internet|pas d.?internet|no internet|deconnect|intermitten|verifi|diagnostic|depann|probleme|trouble|\bbris\b|defect|\bmodem\b|\bonu\b|remplac|\bswap\b|echange/.test(d)) return 'réparation'
  if (/install|raccord|activ|nouveau|nouvelle|mise en service|branchement/.test(d)) return 'installation'
  return ''
}

// ── Pont DÉPARTEMENT/CATÉGORIE → compétence(s) ────────────────────────────────
// Clés = catégories de departments.js (SPA) ET valeurs CAT de categories.js (hub).
// [] = aucune compétence terrain (traité à distance / au bureau) → dénominateur = tous les techs.
const DEPARTMENT_SKILLS = {
  Installation: ['installation'],
  'Installation Fibre': ['installation'],
  Réparation: ['réparation'],
  Reparation: ['réparation'],
  Télévision: ['tv'],
  Television: ['tv'],
  Téléphonie: ['telephone'],
  Telephonie: ['telephone'],
  Monteur: ['monteur'],
  Épissure: ['épissure'],
  Fusionneur: ['épissure'],
  'Net Admin': ['netadmin'],
  Support: ['support'], // ne lister que les agents ayant la compétence « support » (pas les techs sans compétence)
  Facturation: [],
  Commercial: [], // vente / bureau
  Vente: [],
  Autre: [],
}
function deptSkills (dep) {
  if (!dep) return null
  if (Object.prototype.hasOwnProperty.call(DEPARTMENT_SKILLS, dep)) return DEPARTMENT_SKILLS[dep]
  // tolérant aux accents/casse (« telephonie » → « Téléphonie »)
  const key = Object.keys(DEPARTMENT_SKILLS).find(k => stripAccents(k).toLowerCase() === stripAccents(dep).toLowerCase())
  return key ? DEPARTMENT_SKILLS[key] : null
}

// ── Chemin IA : texte libre dicté → compétence(s) ─────────────────────────────
// Réutilise le PATRON de inbox-triage.classifyEmail : JSON strict + reasoningEffort:'none'
// (sinon gemini « pense » et tronque le JSON → parse échoue silencieusement). Focalisé sur
// LA compétence (pas de match client), contraint au vocabulaire réel des techs.
async function aiSkills (text) {
  if (!cfg.AI_API_KEY) return null
  const sys = 'Tu assignes la ou les COMPÉTENCE(S) technique(s) requises pour traiter la demande d\'un client d\'un fournisseur Internet/télécom par fibre (TARGO / Gigafibre). ' +
    'Choisis UNIQUEMENT parmi cette liste : ' + SKILL_VOCAB.join(', ') + '. ' +
    'Un simple dépannage à distance, une question de facturation ou une vente ne requièrent AUCUNE compétence terrain → réponds "skills":[]. ' +
    'Réponds UNIQUEMENT en JSON, sans texte autour : {"skills":["…"],"reason":"une courte phrase en français"}.'
  try {
    const out = await require('./ai').chat({ task: 'triage', maxTokens: 150, temperature: 0, reasoningEffort: 'none', messages: [{ role: 'system', content: sys }, { role: 'user', content: String(text || '').slice(0, 900) }] })
    const j = JSON.parse((out.match(/\{[\s\S]*\}/) || ['{}'])[0])
    const skills = (Array.isArray(j.skills) ? j.skills : []).map(normSkill).filter(s => SKILL_VOCAB.includes(s))
    return { skills, reason: String(j.reason || '').slice(0, 200) }
  } catch (e) { log('aiSkills error:', e.message); return null }
}

// ── Résolveur unifié ──────────────────────────────────────────────────────────
// resolveSkills({ text, department, jobType, useAI }) → { skills, primary, confidence, source, department, reason }
// Priorité : chip/département explicite (sûr) > type de job / regex sur le texte (moyen) > IA sur texte libre (moyen).
// confidence : 'high' (chip) · 'medium' (règle/IA) · 'low' (rien trouvé → aucune compétence, tous les techs).
async function resolveSkills ({ text = '', department = '', jobType = '', useAI = false } = {}) {
  // 1. Département / chip explicite = intention claire de l'agent.
  const ds = deptSkills(department)
  if (ds) return { skills: ds, primary: ds[0] || '', confidence: 'high', source: 'chip', department, reason: '' }

  // 2. Type de job explicite (Installation/Réparation…), puis regex sur le texte.
  const rule = deptToSkill(jobType) || deptToSkill(text)
  if (rule) return { skills: [rule], primary: rule, confidence: 'medium', source: 'rule', department, reason: '' }

  // 3. IA sur le texte dicté (seulement si demandé ET clé dispo).
  if (useAI && String(text || '').trim().length >= 4) {
    const ai = await aiSkills(text)
    if (ai && ai.skills.length) return { skills: ai.skills, primary: ai.skills[0], confidence: 'medium', source: 'ai', department, reason: ai.reason }
    if (ai) return { skills: [], primary: '', confidence: 'low', source: 'ai', department, reason: ai.reason }
  }

  // 4. Rien de fiable → aucune compétence (le dénominateur reste « tous les techs »).
  return { skills: [], primary: '', confidence: 'low', source: 'none', department, reason: '' }
}

// ── FONCTIONS (skillsets nommés, réutilisables) — catalogue hub durable ───────
// Une « fonction » = un rôle terrain porté par un QUART : elle définit ce que le
// dispatch TERRAIN peut envoyer au tech pendant ce quart.
//   mode 'replace' (défaut) : remplace les compétences de base pour ce quart
//                             (« lundi = support » → ce jour-là il ne fait QUE support) ;
//   mode 'add'              : s'ajoute aux compétences de base (accorde une capacité en plus).
// Le helpdesk/support est géré SÉPARÉMENT — une fonction « hors terrain » (ex. support/remote)
// ne fait que RETIRER le tech du dispatch terrain ; on n'injecte personne dans l'horaire du helpdesk.
// Store JSON durable (même patron que job-skills.json ; l'API Custom Field ERPNext v16 est cassée
// et de toute façon un catalogue de rôles n'est pas de la donnée transactionnelle).
const FUNCTIONS_FILE = path.join(__dirname, '..', 'data', 'functions.json')
function getFunctionsMap () { try { return JSON.parse(fs.readFileSync(FUNCTIONS_FILE, 'utf8')) || {} } catch { return {} } }
function _normFn (id, raw) {
  return {
    id,
    name: String(raw.name || id).trim(),
    skills: [...new Set(toSkillList(raw.skills).map(s => s.trim()).filter(Boolean))],
    mode: raw.mode === 'add' ? 'add' : 'replace',
    color: raw.color || '',
    icon: raw.icon || '',
  }
}
function listFunctions () { const m = getFunctionsMap(); return Object.keys(m).map(id => _normFn(id, m[id])) }
// Résolution TOLÉRANTE : par id, sinon par nom (casse/accents ignorés) — un quart stocke le nom ou l'id.
function getFunction (idOrName) {
  if (!idOrName) return null
  const m = getFunctionsMap()
  if (m[idOrName]) return _normFn(idOrName, m[idOrName])
  const want = stripAccents(idOrName).toLowerCase()
  const k = Object.keys(m).find(k => stripAccents(k).toLowerCase() === want || stripAccents(m[k].name || '').toLowerCase() === want)
  return k ? _normFn(k, m[k]) : null
}
function setFunction (fn) {
  const m = getFunctionsMap()
  const id = String((fn && (fn.id || fn.name)) || '').trim()
  if (!id) return m
  m[id] = { name: String(fn.name || id).trim(), skills: [...new Set(toSkillList(fn.skills))], mode: fn.mode === 'add' ? 'add' : 'replace', color: fn.color || '', icon: fn.icon || '' }
  try { fs.mkdirSync(path.dirname(FUNCTIONS_FILE), { recursive: true }) } catch (e) {}
  fs.writeFileSync(FUNCTIONS_FILE, JSON.stringify(m)); return m
}
function deleteFunction (id) {
  const m = getFunctionsMap(); if (!m[id]) return m
  delete m[id]
  try { fs.writeFileSync(FUNCTIONS_FILE, JSON.stringify(m)) } catch (e) {}
  return m
}

// ── EXCEPTIONS de compétence PONCTUELLES (par tech, plage de dates) ────────────
// [{ from, to, mode:'remove'|'add', skills:[], reason }]. Ex. « mal de dos → pas d'installation
// cette semaine » = {mode:'remove', skills:['installation']}. (Le cas « reste à la maison
// aujourd'hui, prend le support » se fait plutôt via la FONCTION du quart de ce jour.)
const SKILL_EXC_FILE = path.join(__dirname, '..', 'data', 'skill-exceptions.json')
function getSkillExceptionsMap () { try { return JSON.parse(fs.readFileSync(SKILL_EXC_FILE, 'utf8')) || {} } catch { return {} } }
function getSkillExceptions (techId) { const v = getSkillExceptionsMap()[String(techId)]; return Array.isArray(v) ? v : [] }
function setSkillExceptions (techId, list) {
  const m = getSkillExceptionsMap()
  const arr = (Array.isArray(list) ? list : []).map(e => ({
    from: String(e.from || ''), to: String(e.to || e.from || ''),
    mode: e.mode === 'add' ? 'add' : 'remove',
    skills: [...new Set(toSkillList(e.skills))],
    reason: String(e.reason || '').slice(0, 200),
  })).filter(e => e.from && e.skills.length)
  if (arr.length) m[String(techId)] = arr; else delete m[String(techId)]
  try { fs.mkdirSync(path.dirname(SKILL_EXC_FILE), { recursive: true }) } catch (e) {}
  fs.writeFileSync(SKILL_EXC_FILE, JSON.stringify(m)); return m
}

// Compétences effectives d'UN quart : la valeur portée par le quart est un ENSEMBLE de compétences EXPLICITE
// (les « chips » curés par le répartiteur). Une fonction du catalogue n'est qu'un GABARIT qui PRÉ-REMPLIT ces
// chips côté UI ; on retire/ajoute ensuite à la main (ex. Technicien = installation+réparation+tv+téléphone,
// puis on retire « installation » car mal de dos). L'ensemble curé REMPLACE les compétences de base ce quart-là
// (pas de réconciliation automatique — le répartiteur voit et contrôle exactement ce qui est posé).
//   • valeur vide → compétences de base.
//   • RÉTRO-COMPAT : si la valeur est le NOM d'une fonction du catalogue, on l'étend à ses compétences.
//   • sinon (CSV de compétences) → ces compétences telles quelles.
function _shiftEffective (base, fnVal) {
  if (!fnVal) return base.slice()
  const f = getFunction(fnVal)
  const skills = f ? f.skills.slice() : toSkillList(fnVal)
  return skills.length ? [...new Set(skills)] : base.slice()
}

// ── COMPÉTENCES EFFECTIVES d'un tech pour un JOUR (point d'entrée UNIQUE) ──────
// Le dispatch terrain, l'occupation, le solveur et la capacité doivent TOUS voir les mêmes
// compétences dépendantes du jour. Retourne un objet tech « shadow » : skills restreint +
// skill_levels / skill_eff RÉDUITS aux seules compétences effectives — les ★ (niveau) et la
// cadence d'une compétence retirée disparaissent aussi (elles ne doivent PAS peser sur l'offre).
//
//   tech         : objet tech ({ skills[], skill_levels{}, skill_eff{}, id })
//   iso          : 'YYYY-MM-DD'
//   opts.shifts  : quarts du tech CE JOUR = [{ function|fn, start, end }] (fournis par l'appelant :
//                  fetchAssignments enrichi du champ `function`, repli patron weekly_schedule).
//   opts.time    : 'HH:MM' → restreint au quart couvrant cette heure ; sinon UNION des quarts du jour.
//
// Aucun quart fourni (ou aucune fonction) → compétences de BASE (rétro-compat total : les
// appelants qui ne passent pas `shifts` obtiennent exactement le comportement d'avant).
function effectiveSkills (tech, iso, opts = {}) {
  const base = toSkillList(tech && tech.skills)
  const shifts = Array.isArray(opts.shifts) ? opts.shifts : []
  let eff
  if (!shifts.length) {
    eff = base.slice()
  } else {
    let use = shifts
    if (opts.time) {
      const th = hmToH(opts.time)
      const covering = shifts.filter(s => { const a = hmToH(s.start), b = hmToH(s.end); return !Number.isFinite(a) || !Number.isFinite(b) || (a <= th && th < b) })
      if (covering.length) use = covering // si l'heure ne tombe dans aucun quart → repli sur tous les quarts du jour
    }
    eff = [...new Set(use.flatMap(s => _shiftEffective(base, s.function || s.fn || '')))]
  }
  // Exceptions ponctuelles (après la fonction : elles ajustent l'ensemble de travail du jour).
  const exs = (tech && tech.id != null) ? getSkillExceptions(tech.id).filter(e => iso >= e.from && iso <= e.to) : []
  for (const e of exs) {
    if (e.mode === 'add') eff = [...new Set([...eff, ...e.skills])]
    else eff = eff.filter(s => !e.skills.some(x => normSkill(x) === normSkill(s)))
  }
  // Réduire niveaux ★ + cadence aux seules compétences effectives (sinon une compétence retirée
  // continuerait de peser sur le scoring / l'offre — ce que l'utilisateur ne veut pas).
  const inEff = (k) => eff.some(s => normSkill(s) === normSkill(k))
  const scope = (obj) => { const o = {}; if (obj) for (const k of Object.keys(obj)) if (inEff(k)) o[k] = obj[k]; return o }
  return { ...tech, skills: eff, skill_levels: scope(tech && tech.skill_levels), skill_eff: scope(tech && tech.skill_eff) }
}

module.exports = {
  SKILL_VOCAB,
  normSkill,
  toSkillList,
  techHasSkill,
  techHasSkills,
  deptToSkill,
  deptSkills,
  DEPARTMENT_SKILLS,
  aiSkills,
  resolveSkills,
  // Fonctions (catalogue) + exceptions + résolveur jour-conscient :
  listFunctions,
  getFunction,
  setFunction,
  deleteFunction,
  getSkillExceptions,
  getSkillExceptionsMap,
  setSkillExceptions,
  effectiveSkills,
}