gigafibre-fsm/services/targo-hub/lib/dispatch.js
louispaulb 320655b0a0 refactor: major cleanup — remove dead dispatch app, commit all backend code, extract client composables
- Remove apps/dispatch/ (100% replaced by ops dispatch module, unmaintained)
- Commit services/targo-hub/lib/ (24 modules, 6290 lines — was never tracked)
- Commit services/docuseal + services/legacy-db docker-compose configs
- Extract client app composables: useOTP, useAddressSearch, catalog data, format utils
- Refactor CartPage.vue 630→175 lines, CatalogPage.vue 375→95 lines
- Clean hardcoded credentials from config.js fallback values
- Add client portal: catalog, cart, checkout, OTP verification, address search
- Add ops: NetworkPage, AgentFlowsPage, ConversationPanel, UnifiedCreateModal
- Add ops composables: useBestTech, useConversations, usePermissions, useScanner
- Add field app: scanner composable, docker/nginx configs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-08 17:38:38 -04:00

230 lines
9.9 KiB
JavaScript

'use strict'
const cfg = require('./config')
const { log, json, parseBody, erpFetch } = require('./helpers')
// Return today's date as YYYY-MM-DD in Eastern time (America/Toronto)
function todayET () {
return new Date().toLocaleDateString('en-CA', { timeZone: 'America/Toronto' })
}
// ── Distance helper (Euclidean approximation, km at Montreal latitude) ───────
function distKm (a, b) {
if (!a || !b) return 999
const dx = (a[0] - b[0]) * 80, dy = (a[1] - b[1]) * 111
return Math.sqrt(dx * dx + dy * dy)
}
// ── Fetch all technicians with their today queues ────────────────────────────
async function getTechsWithLoad (dateStr) {
const [techRes, jobRes] = await Promise.all([
erpFetch(`/api/resource/Dispatch Technician?fields=${encodeURIComponent(JSON.stringify(['name', 'technician_id', 'full_name', 'status', 'longitude', 'latitude', 'traccar_device_id', 'phone']))}&limit_page_length=50`),
erpFetch(`/api/resource/Dispatch Job?filters=${encodeURIComponent(JSON.stringify({ status: ['in', ['open', 'assigned']], scheduled_date: dateStr }))}&fields=${encodeURIComponent(JSON.stringify(['name', 'assigned_tech', 'duration_h', 'longitude', 'latitude', 'status', 'route_order']))}&limit_page_length=200`),
])
if (techRes.status !== 200) throw new Error('Failed to fetch technicians')
const techs = techRes.data.data || []
const jobs = jobRes.status === 200 ? (jobRes.data.data || []) : []
return techs.map(t => {
const queue = jobs
.filter(j => j.assigned_tech === t.technician_id)
.sort((a, b) => (a.route_order || 0) - (b.route_order || 0))
const load = queue.reduce((s, j) => s + (parseFloat(j.duration_h) || 1), 0)
return {
id: t.technician_id, name: t.full_name, status: t.status || 'available',
coords: [t.longitude || -73.5673, t.latitude || 45.5017],
traccarDeviceId: t.traccar_device_id, phone: t.phone,
queue, load, tags: [],
}
})
}
// ── Get live GPS positions from Traccar ──────────────────────────────────────
async function enrichWithGps (techs) {
try {
const { getDevices, getPositions } = require('./traccar')
const devices = await getDevices()
const deviceMap = {}
techs.forEach(t => {
if (!t.traccarDeviceId) return
const dev = devices.find(d => d.id === parseInt(t.traccarDeviceId) || d.uniqueId === t.traccarDeviceId)
if (dev) deviceMap[dev.id] = t
})
const deviceIds = Object.keys(deviceMap).map(Number)
if (!deviceIds.length) return
const positions = await getPositions(deviceIds)
positions.forEach(p => {
const tech = deviceMap[p.deviceId]
if (tech && p.latitude && p.longitude) {
tech.gpsCoords = [p.longitude, p.latitude]
tech.gpsOnline = true
}
})
} catch (e) { log('GPS enrichment error:', e.message) }
}
// ── Rank technicians for optimal assignment ──────────────────────────────────
function rankTechs (techs, jobCoords, jobDuration = 1) {
const hasCoords = jobCoords && (jobCoords[0] || jobCoords[1])
const candidates = techs.filter(t => t.status !== 'off' && t.status !== 'unavailable')
return candidates.map(tech => {
const pos = tech.gpsOnline ? tech.gpsCoords : tech.coords
const distance = hasCoords ? distKm(pos, jobCoords) : 999
const remainingCap = Math.max(0, 8 - tech.load)
let score = 0
const reasons = []
// Proximity (40%)
score += Math.min(distance, 100) * 4
reasons.push(distance < 5 ? `${distance.toFixed(1)} km (très proche)` :
distance < 15 ? `${distance.toFixed(1)} km` : `${distance.toFixed(1)} km (loin)`)
// Load balance (30%)
score += tech.load * 30
if (remainingCap < jobDuration) {
score += 500
reasons.push(`Surchargé (${tech.load.toFixed(1)}h/8h)`)
} else if (tech.load < 4) {
reasons.push(`Dispo (${tech.load.toFixed(1)}h/8h)`)
} else {
reasons.push(`Chargé (${tech.load.toFixed(1)}h/8h)`)
}
// GPS freshness bonus (10%)
if (tech.gpsOnline) { score -= 20; reasons.push('GPS en direct') }
return { techId: tech.id, techName: tech.name, phone: tech.phone, score, distance, load: tech.load, remainingCap, reasons }
}).sort((a, b) => a.score - b.score)
}
// ── Create dispatch job in ERPNext ───────────────────────────────────────────
async function createDispatchJob ({ subject, address, priority, duration_h, job_type, customer, service_location, source_issue, notes, latitude, longitude, assigned_tech, scheduled_date }) {
const ticketId = 'DJ-' + Date.now().toString(36).toUpperCase()
const payload = {
ticket_id: ticketId,
subject: subject || 'Travail urgent',
address: address || '',
duration_h: parseFloat(duration_h) || 1,
priority: priority || 'high',
status: assigned_tech ? 'assigned' : 'open',
job_type: job_type || 'Dépannage',
customer: customer || '',
service_location: service_location || '',
source_issue: source_issue || '',
notes: notes || '',
latitude: latitude || '',
longitude: longitude || '',
assigned_tech: assigned_tech || '',
scheduled_date: scheduled_date || todayET(),
}
const r = await erpFetch('/api/resource/Dispatch Job', { method: 'POST', body: JSON.stringify(payload) })
if (r.status < 200 || r.status >= 300) throw new Error('Failed to create dispatch job')
return { success: true, job_id: r.data?.data?.name || ticketId, ...payload }
}
// ── HTTP handler for /dispatch/* endpoints ───────────────────────────────────
async function handle (req, res, method, path) {
const sub = path.replace('/dispatch/', '')
// POST /dispatch/best-tech — find optimal tech for a job location
if (sub === 'best-tech' && method === 'POST') {
try {
const body = await parseBody(req)
const dateStr = body.date || todayET()
const jobCoords = body.latitude && body.longitude ? [parseFloat(body.longitude), parseFloat(body.latitude)] : null
const techs = await getTechsWithLoad(dateStr)
await enrichWithGps(techs)
const ranked = rankTechs(techs, jobCoords, parseFloat(body.duration_h) || 1)
return json(res, 200, { ranking: ranked })
} catch (e) {
log('best-tech error:', e.message)
return json(res, 500, { error: e.message })
}
}
// POST /dispatch/create-job — create + optionally auto-assign to best tech
if (sub === 'create-job' && method === 'POST') {
try {
const body = await parseBody(req)
let assignedTech = body.assigned_tech
// Auto-pick best tech if requested
if (body.auto_assign) {
const dateStr = body.scheduled_date || todayET()
const jobCoords = body.latitude && body.longitude ? [parseFloat(body.longitude), parseFloat(body.latitude)] : null
const techs = await getTechsWithLoad(dateStr)
await enrichWithGps(techs)
const ranked = rankTechs(techs, jobCoords, parseFloat(body.duration_h) || 1)
if (ranked.length) {
assignedTech = ranked[0].techId
log(`Auto-assigned to ${ranked[0].techName} (score: ${ranked[0].score.toFixed(0)}, ${ranked[0].reasons.join(', ')})`)
}
}
const result = await createDispatchJob({ ...body, assigned_tech: assignedTech })
return json(res, 200, result)
} catch (e) {
log('create-job error:', e.message)
return json(res, 500, { error: e.message })
}
}
json(res, 404, { error: 'Dispatch endpoint not found' })
}
// ── Agent tool: create dispatch job with auto-assignment ─────────────────────
async function agentCreateDispatchJob ({ customer_id, service_location, subject, priority, job_type, notes, auto_assign }) {
// Resolve address + coords from service location
let address = '', latitude = null, longitude = null
if (service_location) {
const locRes = await erpFetch(`/api/resource/Service Location/${encodeURIComponent(service_location)}`)
if (locRes.status === 200) {
const loc = locRes.data.data
address = [loc.address_line, loc.city, loc.postal_code].filter(Boolean).join(', ')
latitude = loc.latitude || null
longitude = loc.longitude || null
}
}
const dateStr = todayET()
let assignedTech = null, techInfo = null
if (auto_assign !== false) {
try {
const jobCoords = latitude && longitude ? [parseFloat(longitude), parseFloat(latitude)] : null
const techs = await getTechsWithLoad(dateStr)
await enrichWithGps(techs)
const ranked = rankTechs(techs, jobCoords, 1)
if (ranked.length) {
assignedTech = ranked[0].techId
techInfo = { name: ranked[0].techName, phone: ranked[0].phone, distance: ranked[0].distance, reasons: ranked[0].reasons }
log(`Agent auto-assigned to ${ranked[0].techName}`)
}
} catch (e) { log('Agent auto-assign error:', e.message) }
}
const result = await createDispatchJob({
subject: subject || 'Intervention urgente',
address, latitude, longitude,
priority: priority || 'high',
duration_h: 1,
job_type: job_type || 'Dépannage',
customer: customer_id || '',
service_location: service_location || '',
notes: notes || '',
assigned_tech: assignedTech,
scheduled_date: dateStr,
})
return {
success: true,
job_id: result.job_id,
assigned_tech: techInfo ? `${techInfo.name} (${techInfo.reasons.join(', ')})` : 'Aucun tech disponible — job créé en attente',
address: result.address,
message: techInfo ? `Travail créé et assigné à ${techInfo.name}` : 'Travail créé, en attente d\'assignation',
}
}
module.exports = { handle, agentCreateDispatchJob, rankTechs, getTechsWithLoad, enrichWithGps }