const { all, audit, json, now, one, parseJson, run, tx } = require('../db'); const FREQUENCY_UNITS = ['days', 'weeks', 'months', 'quarters', 'semiannual', 'years']; function todayStr() { return new Date().toISOString().slice(0, 10); } function addInterval(dateStr, value, unit) { const date = new Date(`${dateStr || todayStr()}T00:00:00`); const v = Math.max(1, Number(value) || 1); switch (unit) { case 'days': date.setDate(date.getDate() + v); break; case 'weeks': date.setDate(date.getDate() + v * 7); break; case 'quarters': date.setMonth(date.getMonth() + v * 3); break; case 'semiannual': date.setMonth(date.getMonth() + v * 6); break; case 'years': date.setFullYear(date.getFullYear() + v); break; case 'months': default: date.setMonth(date.getMonth() + v); break; } return date.toISOString().slice(0, 10); } // ---- PM plan templates ----------------------------------------------------- function round2(value) { return Math.round((Number(value || 0) + Number.EPSILON) * 100) / 100; } function yearOf(value) { return value ? Number(String(value).slice(0, 4)) : null; } function planSteps(planId) { return all('SELECT id, step_order, title, details, est_minutes FROM pm_plan_steps WHERE plan_id = ? ORDER BY step_order, id', [planId]); } function planComponents(planId) { return all('SELECT id, sort_order, part_number, description, supplier, cost FROM pm_plan_components WHERE plan_id = ? ORDER BY sort_order, id', [planId]); } // Guidance photos for a plan. `withData` is false for list views (omits the base64 blob). function planPhotos(planId, withData = true) { const columns = withData ? 'id, name, mime_type, caption, data_base64, sort_order' : 'id, name, mime_type, caption, sort_order'; return all(`SELECT ${columns} FROM pm_plan_photos WHERE plan_id = ? ORDER BY sort_order, id`, [planId]) .map((p) => ({ id: p.id, name: p.name, mime: p.mime_type, caption: p.caption, ...(withData ? { data: p.data_base64 } : {}) })); } function stepsMinutes(steps) { return (steps || []).reduce((sum, step) => sum + (Number(step.est_minutes) || 0), 0); } function componentsTotal(components) { return round2((components || []).reduce((sum, component) => sum + (Number(component.cost) || 0), 0)); } function planFromRow(row, { withPhotoData = true } = {}) { if (!row) return null; const components = planComponents(row.id); const photos = planPhotos(row.id, withPhotoData); return { ...row, steps: planSteps(row.id), components, components_total: componentsTotal(components), photos, photo_count: photos.length }; } function listPlans() { return all('SELECT * FROM pm_plans ORDER BY name').map((row) => planFromRow(row, { withPhotoData: false })); } function getPlan(id) { return planFromRow(one('SELECT * FROM pm_plans WHERE id = ?', [id])); } function writeSteps(planId, steps) { run('DELETE FROM pm_plan_steps WHERE plan_id = ?', [planId]); (steps || []).forEach((step, index) => { const title = (step.title || '').trim(); if (!title) return; const est = step.est_minutes === '' || step.est_minutes == null ? null : Number(step.est_minutes); run('INSERT INTO pm_plan_steps (plan_id, step_order, title, details, est_minutes) VALUES (?, ?, ?, ?, ?)', [planId, index, title, step.details || null, est]); }); } function writeComponents(planId, components) { run('DELETE FROM pm_plan_components WHERE plan_id = ?', [planId]); (components || []).forEach((component, index) => { const part = (component.part_number || '').trim(); const description = (component.description || '').trim(); if (!part && !description && !Number(component.cost)) return; run( 'INSERT INTO pm_plan_components (plan_id, sort_order, part_number, description, supplier, cost) VALUES (?, ?, ?, ?, ?, ?)', [planId, index, component.part_number || null, component.description || null, component.supplier || null, Number(component.cost) || 0] ); }); } // Reconcile guidance photos: existing items (carry an id) keep their stored blob and // only update caption/order; new items (carry data) are inserted; missing ones are removed. function writePhotos(planId, photos) { const existing = all('SELECT id FROM pm_plan_photos WHERE plan_id = ?', [planId]).map((r) => r.id); const keep = new Set(); (photos || []).forEach((photo, index) => { if (photo.id && existing.includes(photo.id)) { keep.add(photo.id); run('UPDATE pm_plan_photos SET caption = ?, sort_order = ? WHERE id = ? AND plan_id = ?', [photo.caption || null, index, photo.id, planId]); } else if (photo.data) { const result = run( 'INSERT INTO pm_plan_photos (plan_id, name, mime_type, caption, data_base64, sort_order, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)', [planId, photo.name || null, photo.mime || photo.mime_type || 'image/jpeg', photo.caption || null, photo.data, index, now()] ); keep.add(result.lastInsertRowid); } }); for (const id of existing) { if (!keep.has(id)) run('DELETE FROM pm_plan_photos WHERE id = ?', [id]); } } // Estimated minutes are derived from the step times when steps are supplied. function resolveEstimatedMinutes(body, fallback) { if (Array.isArray(body.steps)) { const total = stepsMinutes(body.steps); if (total > 0) return total; } if (body.estimated_minutes != null && body.estimated_minutes !== '') return Number(body.estimated_minutes); return fallback ?? null; } function createPlan(body, userId) { const ts = now(); return tx(() => { const result = run( `INSERT INTO pm_plans (name, description, category, frequency_value, frequency_unit, estimated_minutes, instructions, created_by, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [ body.name || 'PM plan', body.description || null, body.category || null, Number(body.frequency_value) || 1, FREQUENCY_UNITS.includes(body.frequency_unit) ? body.frequency_unit : 'months', resolveEstimatedMinutes(body, null), body.instructions || null, userId, ts, ts ] ); writeSteps(result.lastInsertRowid, body.steps); writeComponents(result.lastInsertRowid, body.components); writePhotos(result.lastInsertRowid, body.photos); audit(userId, 'create', 'pm_plan', result.lastInsertRowid, null, { name: body.name }); return getPlan(result.lastInsertRowid); }); } function updatePlan(id, body, userId) { const before = one('SELECT * FROM pm_plans WHERE id = ?', [id]); if (!before) return null; return tx(() => { run( `UPDATE pm_plans SET name = ?, description = ?, category = ?, frequency_value = ?, frequency_unit = ?, estimated_minutes = ?, instructions = ?, updated_at = ? WHERE id = ?`, [ body.name ?? before.name, body.description ?? before.description, body.category ?? before.category, body.frequency_value != null ? Number(body.frequency_value) : before.frequency_value, FREQUENCY_UNITS.includes(body.frequency_unit) ? body.frequency_unit : before.frequency_unit, resolveEstimatedMinutes(body, before.estimated_minutes), body.instructions ?? before.instructions, now(), id ] ); if (Array.isArray(body.steps)) writeSteps(id, body.steps); if (Array.isArray(body.components)) writeComponents(id, body.components); if (Array.isArray(body.photos)) writePhotos(id, body.photos); audit(userId, 'update', 'pm_plan', id, before, { name: body.name }); return getPlan(id); }); } function deletePlan(id, userId) { const before = one('SELECT * FROM pm_plans WHERE id = ?', [id]); if (!before) return false; run('DELETE FROM pm_plans WHERE id = ?', [id]); audit(userId, 'delete', 'pm_plan', id, before, null); return true; } // ---- Per-asset PM schedules ------------------------------------------------ function assetPmRows(assetId) { return all( `SELECT ap.*, p.name AS plan_name, p.description AS plan_description, p.instructions AS plan_instructions, u.name AS assigned_to_name FROM asset_pm_plans ap LEFT JOIN pm_plans p ON p.id = ap.plan_id LEFT JOIN users u ON u.id = ap.assigned_to WHERE ap.asset_id = ? ORDER BY ap.active DESC, ap.next_due_date IS NULL, ap.next_due_date`, [assetId] ).map((row) => { const components = row.plan_id ? planComponents(row.plan_id) : []; const completions = all( `SELECT c.id, c.completed_at, c.notes, c.notes_json, c.steps_json, c.cost, c.components_json, c.rating_safety, c.rating_physical, c.rating_operating, CASE WHEN c.signature IS NOT NULL THEN 1 ELSE 0 END AS has_signature, c.next_due_date, u.name AS completed_by_name, (SELECT COUNT(*) FROM pm_completion_photos ph WHERE ph.completion_id = c.id) AS photo_count FROM pm_completions c LEFT JOIN users u ON u.id = c.completed_by WHERE c.asset_pm_id = ? ORDER BY c.completed_at DESC LIMIT 12`, [row.id] ).map((c) => ({ ...c, has_signature: Boolean(c.has_signature), notes: parseJson(c.notes_json, c.notes ? [c.notes] : []), steps: parseJson(c.steps_json, []), components: parseJson(c.components_json, []), ratings: { safety: c.rating_safety, physical: c.rating_physical, operating: c.rating_operating } })); const totalCost = round2(completions.reduce((sum, c) => sum + Number(c.cost || 0), 0)); return { ...row, active: Boolean(row.active), steps: row.plan_id ? planSteps(row.plan_id) : [], plan_photos: row.plan_id ? planPhotos(row.plan_id) : [], components, expected_cost: componentsTotal(components), total_cost: totalCost, last_cost: completions[0] ? round2(completions[0].cost) : 0, completions }; }); } function attachPlan(assetId, body, userId) { const ts = now(); const plan = body.plan_id ? one('SELECT * FROM pm_plans WHERE id = ?', [body.plan_id]) : null; const value = Number(body.frequency_value) || (plan ? plan.frequency_value : 1); const unit = FREQUENCY_UNITS.includes(body.frequency_unit) ? body.frequency_unit : (plan ? plan.frequency_unit : 'months'); const startDate = body.start_date || todayStr(); const nextDue = body.next_due_date || startDate; const result = run( `INSERT INTO asset_pm_plans (asset_id, plan_id, frequency_value, frequency_unit, start_date, end_date, next_due_date, assigned_to, active, notes, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?)`, [assetId, body.plan_id || null, value, unit, startDate, body.end_date || null, nextDue, body.assigned_to || null, body.notes || null, ts, ts] ); audit(userId, 'attach', 'asset_pm', result.lastInsertRowid, null, { asset_id: assetId, plan_id: body.plan_id }); return one('SELECT * FROM asset_pm_plans WHERE id = ?', [result.lastInsertRowid]); } function updateAssetPm(assetId, apId, body, userId) { const before = one('SELECT * FROM asset_pm_plans WHERE id = ? AND asset_id = ?', [apId, assetId]); if (!before) return null; run( `UPDATE asset_pm_plans SET frequency_value = ?, frequency_unit = ?, start_date = ?, end_date = ?, next_due_date = ?, assigned_to = ?, active = ?, notes = ?, updated_at = ? WHERE id = ?`, [ body.frequency_value != null ? Number(body.frequency_value) : before.frequency_value, FREQUENCY_UNITS.includes(body.frequency_unit) ? body.frequency_unit : before.frequency_unit, body.start_date ?? before.start_date, body.end_date !== undefined ? body.end_date : before.end_date, body.next_due_date ?? before.next_due_date, body.assigned_to !== undefined ? body.assigned_to : before.assigned_to, body.active === undefined ? before.active : (body.active ? 1 : 0), body.notes ?? before.notes, now(), apId ] ); audit(userId, 'update', 'asset_pm', apId, before, body); return one('SELECT * FROM asset_pm_plans WHERE id = ?', [apId]); } function detachAssetPm(assetId, apId, userId) { const result = run('DELETE FROM asset_pm_plans WHERE id = ? AND asset_id = ?', [apId, assetId]); if (!result.changes) return false; audit(userId, 'detach', 'asset_pm', apId, null, { asset_id: assetId }); return true; } function clampRating(value) { if (value == null || value === '') return null; return Math.max(1, Math.min(5, Number(value))); } function completePm(assetId, apId, body, userId) { const ap = one('SELECT * FROM asset_pm_plans WHERE id = ? AND asset_id = ?', [apId, assetId]); if (!ap) return null; if (!body.signature) throw Object.assign(new Error('A signature is required to complete a PM'), { status: 400 }); const ts = now(); const completedDate = (body.completed_at || ts).slice(0, 10); let nextDue = addInterval(completedDate, ap.frequency_value, ap.frequency_unit); let active = ap.active; if (ap.end_date && nextDue > ap.end_date) { nextDue = null; active = 0; // schedule complete — past the asset's maintenance end date } const planComps = ap.plan_id ? planComponents(ap.plan_id) : []; const components = Array.isArray(body.components) ? body.components : planComps; const cost = body.cost != null && body.cost !== '' ? round2(body.cost) : componentsTotal(planComps); const notesList = Array.isArray(body.notes_list) ? body.notes_list.filter((n) => String(n || '').trim()) : (body.notes ? [body.notes] : []); const ratings = body.ratings || {}; const photos = Array.isArray(body.photos) ? body.photos.filter((p) => p && p.data) : []; return tx(() => { const inserted = run( `INSERT INTO pm_completions (asset_pm_id, completed_at, completed_by, notes, notes_json, steps_json, cost, components_json, signature, rating_safety, rating_physical, rating_operating, next_due_date, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [ apId, ts, userId, notesList.join('\n') || null, json(notesList), json(body.steps || []), cost, json(components), body.signature, clampRating(ratings.safety), clampRating(ratings.physical), clampRating(ratings.operating), nextDue, ts ] ); for (const photo of photos) { run('INSERT INTO pm_completion_photos (completion_id, name, mime_type, data_base64, created_at) VALUES (?, ?, ?, ?, ?)', [ inserted.lastInsertRowid, photo.name || null, photo.mime || photo.mime_type || 'image/jpeg', photo.data, ts ]); } run('UPDATE asset_pm_plans SET last_completed_date = ?, next_due_date = ?, active = ?, updated_at = ? WHERE id = ?', [completedDate, nextDue, active, ts, apId]); audit(userId, 'complete', 'asset_pm', apId, null, { next_due_date: nextDue, completion_id: inserted.lastInsertRowid }); return one('SELECT * FROM asset_pm_plans WHERE id = ?', [apId]); }); } function listCompletions(query = {}) { return all( `SELECT c.id, c.completed_at, c.cost, c.notes_json, c.rating_safety, c.rating_physical, c.rating_operating, CASE WHEN c.signature IS NOT NULL THEN 1 ELSE 0 END AS has_signature, u.name AS completed_by_name, a.asset_id AS asset_code, a.description AS asset_description, p.name AS plan_name, (SELECT COUNT(*) FROM pm_completion_photos ph WHERE ph.completion_id = c.id) AS photo_count FROM pm_completions c JOIN asset_pm_plans ap ON ap.id = c.asset_pm_id JOIN assets a ON a.id = ap.asset_id LEFT JOIN pm_plans p ON p.id = ap.plan_id LEFT JOIN users u ON u.id = c.completed_by WHERE (? IS NULL OR ap.asset_id = ?) ORDER BY c.completed_at DESC, c.id DESC LIMIT 500`, [query.asset_id || null, query.asset_id || null] ).map((r) => ({ ...r, has_signature: Boolean(r.has_signature), notes: parseJson(r.notes_json, []) })); } function getCompletion(id) { const row = one( `SELECT c.*, u.name AS completed_by_name, a.asset_id AS asset_code, a.description AS asset_description, p.name AS plan_name FROM pm_completions c JOIN asset_pm_plans ap ON ap.id = c.asset_pm_id JOIN assets a ON a.id = ap.asset_id LEFT JOIN pm_plans p ON p.id = ap.plan_id LEFT JOIN users u ON u.id = c.completed_by WHERE c.id = ?`, [id] ); if (!row) return null; return { id: row.id, asset_code: row.asset_code, asset_description: row.asset_description, plan_name: row.plan_name, completed_at: row.completed_at, completed_by_name: row.completed_by_name, cost: row.cost, notes: parseJson(row.notes_json, row.notes ? [row.notes] : []), steps: parseJson(row.steps_json, []), components: parseJson(row.components_json, []), signature: row.signature || null, ratings: { safety: row.rating_safety, physical: row.rating_physical, operating: row.rating_operating }, photos: all('SELECT id, name, mime_type, data_base64 FROM pm_completion_photos WHERE completion_id = ? ORDER BY id', [row.id]) .map((p) => ({ id: p.id, name: p.name, mime: p.mime_type, data: p.data_base64 })) }; } // ---- Settings & alert candidates ------------------------------------------ function getSettings() { const rows = all("SELECT key, value FROM app_settings WHERE key LIKE 'pm_%'"); const map = Object.fromEntries(rows.map((r) => [r.key, r.value])); return { pm_default_frequency_value: Number(map.pm_default_frequency_value || 3), pm_default_frequency_unit: map.pm_default_frequency_unit || 'months', pm_lead_days: Number(map.pm_lead_days || 7) }; } function saveSettings(body, userId) { const set = (k, v) => run('INSERT INTO app_settings (key, value, updated_at) VALUES (?, ?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at', [k, String(v), now()]); if (body.pm_default_frequency_value !== undefined) set('pm_default_frequency_value', Number(body.pm_default_frequency_value) || 3); if (body.pm_default_frequency_unit !== undefined) set('pm_default_frequency_unit', FREQUENCY_UNITS.includes(body.pm_default_frequency_unit) ? body.pm_default_frequency_unit : 'months'); if (body.pm_lead_days !== undefined) set('pm_lead_days', Number(body.pm_lead_days) || 7); audit(userId, 'update', 'pm_settings', null, null, body); return getSettings(); } // Alert candidates for PM schedules that are due/overdue. function pmAlertCandidates() { const lead = getSettings().pm_lead_days; const today = todayStr(); const horizon = new Date(Date.now() + lead * 86400000).toISOString().slice(0, 10); const rows = all( `SELECT ap.*, p.name AS plan_name, a.asset_id AS asset_code FROM asset_pm_plans ap LEFT JOIN pm_plans p ON p.id = ap.plan_id LEFT JOIN assets a ON a.id = ap.asset_id WHERE ap.active = 1 AND ap.next_due_date IS NOT NULL` ); const list = []; for (const ap of rows) { const name = ap.plan_name || 'Preventative maintenance'; const where = ap.asset_code ? ` on ${ap.asset_code}` : ''; if (ap.next_due_date < today) { list.push({ type: 'pm_overdue', reference_type: 'asset_pm', reference_id: ap.id, asset_id: ap.asset_id, severity: 'critical', title: `PM overdue: ${name}`, message: `${name}${where} was due ${ap.next_due_date}.`, due_date: ap.next_due_date }); } else if (ap.next_due_date <= horizon) { list.push({ type: 'pm_due', reference_type: 'asset_pm', reference_id: ap.id, asset_id: ap.asset_id, severity: 'warning', title: `PM due: ${name}`, message: `${name}${where} is due ${ap.next_due_date}.`, due_date: ap.next_due_date }); } } return list; } // Maintenance-cost "ledger" for the PM book: actual PM spend per asset for a year. function pmBookLedger(year) { const rows = all( `SELECT c.cost, c.completed_at, a.asset_id, a.description FROM pm_completions c JOIN asset_pm_plans ap ON ap.id = c.asset_pm_id JOIN assets a ON a.id = ap.asset_id` ); const byAsset = {}; let total = 0; let count = 0; for (const row of rows) { if (yearOf(row.completed_at) !== Number(year)) continue; const cost = Number(row.cost || 0); const entry = byAsset[row.asset_id] || (byAsset[row.asset_id] = { asset_id: row.asset_id, description: row.description, completions: 0, cost: 0, last_service: null }); entry.completions += 1; entry.cost += cost; const day = String(row.completed_at).slice(0, 10); if (!entry.last_service || day > entry.last_service) entry.last_service = day; total += cost; count += 1; } const assets = Object.values(byAsset).map((a) => ({ ...a, cost: round2(a.cost) })).sort((a, b) => b.cost - a.cost); const accounts = [ { account: '6450', type: 'PM / maintenance expense', debit: round2(total), credit: 0 }, { account: '2000', type: 'Maintenance clearing', debit: 0, credit: round2(total) } ]; return { year: Number(year), kind: 'maintenance', rule_set: {}, summary: { assets: assets.length, completions: count, cost: round2(total) }, accounts, accountTotals: { debit: round2(total), credit: round2(total) }, assets }; } module.exports = { FREQUENCY_UNITS, addInterval, assetPmRows, pmBookLedger, attachPlan, completePm, createPlan, deletePlan, detachAssetPm, getCompletion, getPlan, listCompletions, getSettings, listPlans, pmAlertCandidates, saveSettings, updateAssetPm, updatePlan };