netops/netops-todo-node/lib/store.js
Jon Vanvik 6b9dbf8254 Legg til Node/npm-versjon med sanntidssynk + Debian 13-oppsettsskript
Ny app i netops-todo-node/: Express + ws, WebSocket-push i stedet for
polling, kanban med drag & drop, kommentarer, aktivitetslogg, optimistisk
låsing, quick-add-parsing og presence. 12 integrasjonstester (node:test).
setup-debian13.sh setter opp alt på en fersk LXC; README dekker Nginx
Proxy Manager-oppsett. PHP-versjonen er uendret (kun handoff-peker).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 11:54:22 +02:00

319 lines
11 KiB
JavaScript

'use strict';
/**
* NetOps To-Do — datalager.
*
* Holder oppgaver + aktivitetslogg i minnet og persisterer til JSON-filer i
* data/. Skriving er atomisk (tmp-fil + rename) og serialisert gjennom en
* promise-kjede, så parallelle requests ikke ødelegger filene. Antakelsen er
* én node-prosess per datakatalog (samme antakelse som flock i PHP-versjonen).
*/
const fs = require('fs');
const path = require('path');
const crypto = require('crypto');
const VALID_STATUS = ['todo', 'progress', 'blocked', 'done'];
const VALID_PRIORITIES = ['P1', 'P2', 'P3', 'P4'];
const VALID_CATEGORIES = ['L1', 'L2', 'L3', 'L4', 'BGP', 'PEER', 'SEC', 'NMS', 'AUTO', 'DOC', 'INC', 'PROJ'];
const STATUS_LABELS = { todo: 'Å gjøre', progress: 'Pågår', blocked: 'Blokkert', done: 'Ferdig' };
const MAX_ACTIVITY = 400;
const MAX_COMMENTS = 200;
class NotFoundError extends Error {}
class ConflictError extends Error {
constructor(msg, task) { super(msg); this.task = task; }
}
function uid(prefix) {
return prefix + '_' + crypto.randomBytes(5).toString('hex');
}
function sanitizeStr(v, max = 500) {
if (typeof v !== 'string') return '';
// Fjern kontrolltegn (bortsett fra \n \r \t)
v = v.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '').trim();
return v.length > max ? v.slice(0, max) : v;
}
function sanitizeTags(v) {
if (!Array.isArray(v)) return [];
const out = [];
for (const t of v) {
const s = sanitizeStr(t, 40);
if (s) out.push(s);
if (out.length >= 20) break;
}
return out;
}
function sanitizeComments(v) {
if (!Array.isArray(v)) return [];
const out = [];
for (const c of v) {
if (!c || typeof c !== 'object') continue;
const text = sanitizeStr(c.text, 1000);
if (!text) continue;
out.push({
id: typeof c.id === 'string' ? c.id.replace(/[^a-z0-9_]/gi, '').slice(0, 32) || uid('c') : uid('c'),
by: sanitizeStr(c.by, 64) || 'anon',
at: typeof c.at === 'string' && !isNaN(Date.parse(c.at)) ? c.at : new Date().toISOString(),
text,
});
if (out.length >= MAX_COMMENTS) break;
}
return out;
}
function normalizeTask(input, user, existing = null, opts = {}) {
const inp = input && typeof input === 'object' ? input : {};
const ex = existing || {};
const t = {};
t.id = ex.id
|| (typeof inp.id === 'string' ? inp.id.replace(/[^a-z0-9_]/gi, '').slice(0, 32) : '')
|| uid('t');
t.title = sanitizeStr(inp.title ?? ex.title ?? '', 200);
t.desc = sanitizeStr(inp.desc ?? ex.desc ?? '', 4000);
const cat = inp.category ?? ex.category ?? 'L3';
t.category = VALID_CATEGORIES.includes(cat) ? cat : 'L3';
const prio = inp.priority ?? ex.priority ?? 'P3';
t.priority = VALID_PRIORITIES.includes(prio) ? prio : 'P3';
const stat = inp.status ?? ex.status ?? 'todo';
t.status = VALID_STATUS.includes(stat) ? stat : 'todo';
t.estHours = inp.estHours != null
? Math.max(0, Math.min(999, Number(inp.estHours) || 0))
: (ex.estHours ?? 0);
t.location = sanitizeStr(inp.location ?? ex.location ?? '', 120);
const dl = inp.deadline ?? ex.deadline ?? '';
t.deadline = typeof dl === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(dl) ? dl : '';
t.tags = sanitizeTags(inp.tags ?? ex.tags ?? []);
const owner = inp.owner != null ? sanitizeStr(inp.owner, 64) : (ex.owner ?? '');
t.owner = owner;
t.comments = opts.importComments ? sanitizeComments(inp.comments) : (ex.comments || []);
// Audit
const now = new Date().toISOString();
t.created = ex.created || now;
t.createdBy = ex.createdBy || user;
t.updated = now;
t.updatedBy = user;
t.v = (ex.v || 0) + 1;
// Fullført-tidsstempel
const wasDone = ex.status === 'done';
if (t.status === 'done' && !wasDone) {
t.completed = now.slice(0, 10);
t.completedBy = user;
} else if (t.status !== 'done') {
t.completed = null;
t.completedBy = null;
} else {
t.completed = ex.completed || now.slice(0, 10);
t.completedBy = ex.completedBy || user;
}
return t;
}
// Beskriver hva som endret seg, til aktivitetsloggen.
function diffDetail(before, after) {
const detail = [];
if (before.status !== after.status) {
detail.push(`${STATUS_LABELS[before.status]}${STATUS_LABELS[after.status]}`);
}
if (before.priority !== after.priority) detail.push(`${before.priority}${after.priority}`);
if ((before.owner || '') !== (after.owner || '')) detail.push(`eier → ${after.owner || 'utildelt'}`);
if (before.deadline !== after.deadline) detail.push(`frist → ${after.deadline || 'ingen'}`);
const silent = [];
if (before.title !== after.title) silent.push('tittel');
if (before.desc !== after.desc) silent.push('beskrivelse');
if (before.category !== after.category) silent.push('kategori');
if (before.location !== after.location) silent.push('lokasjon');
if (before.estHours !== after.estHours) silent.push('estimat');
if (JSON.stringify(before.tags) !== JSON.stringify(after.tags)) silent.push('tags');
if (silent.length) detail.push(silent.join(', '));
return detail;
}
class Store {
constructor(dataDir) {
this.dataDir = dataDir;
this.tasksFile = path.join(dataDir, 'tasks.json');
this.activityFile = path.join(dataDir, 'activity.json');
this.usersFile = path.join(dataDir, 'users.json');
this.tasks = [];
this.activity = [];
this.knownUsers = new Set();
this._writeChain = Promise.resolve();
}
load() {
fs.mkdirSync(this.dataDir, { recursive: true });
this.tasks = this._readJson(this.tasksFile, []);
this.activity = this._readJson(this.activityFile, []);
for (const u of this._readJson(this.usersFile, [])) this.knownUsers.add(u);
for (const t of this.tasks) {
for (const k of ['owner', 'createdBy', 'updatedBy', 'completedBy']) {
if (t[k]) this.knownUsers.add(t[k]);
}
if (!t.v) t.v = 1;
if (!Array.isArray(t.comments)) t.comments = [];
}
}
_readJson(file, fallback) {
try {
const data = JSON.parse(fs.readFileSync(file, 'utf8'));
return Array.isArray(data) ? data : fallback;
} catch {
return fallback;
}
}
// Atomisk, serialisert skriv: tmp-fil i samme katalog, så rename.
_persist(file, data) {
this._writeChain = this._writeChain.then(async () => {
const tmp = file + '.tmp';
await fs.promises.writeFile(tmp, JSON.stringify(data, null, 2) + '\n', 'utf8');
await fs.promises.rename(tmp, file);
}).catch(err => {
console.error(`Klarte ikke å skrive ${file}:`, err.message);
});
return this._writeChain;
}
_persistTasks() { return this._persist(this.tasksFile, this.tasks); }
_persistActivity() { return this._persist(this.activityFile, this.activity); }
rememberUser(user) {
if (user && !this.knownUsers.has(user)) {
this.knownUsers.add(user);
this._persist(this.usersFile, [...this.knownUsers].sort());
}
}
addActivity(user, action, { taskId = null, title = '', detail = [] } = {}) {
const entry = {
id: uid('a'),
at: new Date().toISOString(),
user,
action,
taskId,
title: sanitizeStr(title, 200),
detail,
};
this.activity.unshift(entry);
if (this.activity.length > MAX_ACTIVITY) this.activity.length = MAX_ACTIVITY;
this._persistActivity();
return entry;
}
list() { return this.tasks; }
get(id) {
return this.tasks.find(t => t.id === id) || null;
}
create(input, user) {
// importComments: lar "angre sletting" og import gjenopprette kommentarer
const task = normalizeTask(input, user, null, { importComments: true });
if (!task.title) throw new Error('title er påkrevd');
if (this.get(task.id)) task.id = uid('t'); // unngå kollisjon ved gjenbrukt id (angre-slett)
this.tasks.push(task);
this.rememberUser(user);
if (task.owner) this.rememberUser(task.owner);
this._persistTasks();
const activity = this.addActivity(user, 'create', { taskId: task.id, title: task.title });
return { task, activity };
}
update(id, input, user) {
const existing = this.get(id);
if (!existing) throw new NotFoundError('Fant ikke oppgaven');
// Optimistisk låsing: klienten sender versjonen den redigerte fra.
if (input && input.v != null && Number(input.v) !== existing.v) {
throw new ConflictError('Oppgaven er endret av noen andre', existing);
}
const updated = normalizeTask(input, user, existing);
const idx = this.tasks.indexOf(existing);
this.tasks[idx] = updated;
this.rememberUser(user);
if (updated.owner) this.rememberUser(updated.owner);
this._persistTasks();
let action = 'update';
if (existing.status !== 'done' && updated.status === 'done') action = 'done';
else if (existing.status === 'done' && updated.status !== 'done') action = 'reopen';
const activity = this.addActivity(user, action, {
taskId: id, title: updated.title, detail: diffDetail(existing, updated),
});
return { task: updated, activity };
}
remove(id, user) {
const existing = this.get(id);
if (!existing) throw new NotFoundError('Fant ikke oppgaven');
this.tasks = this.tasks.filter(t => t.id !== id);
this._persistTasks();
const activity = this.addActivity(user, 'delete', { taskId: id, title: existing.title });
return { task: existing, activity };
}
addComment(id, text, user) {
const task = this.get(id);
if (!task) throw new NotFoundError('Fant ikke oppgaven');
const clean = sanitizeStr(text, 1000);
if (!clean) throw new Error('Tom kommentar');
const comment = { id: uid('c'), by: user, at: new Date().toISOString(), text: clean };
task.comments.push(comment);
if (task.comments.length > MAX_COMMENTS) task.comments.shift();
this.rememberUser(user);
this._persistTasks();
const activity = this.addActivity(user, 'comment', {
taskId: id, title: task.title, detail: [clean.slice(0, 80)],
});
return { task, comment, activity };
}
deleteComment(id, commentId, user) {
const task = this.get(id);
if (!task) throw new NotFoundError('Fant ikke oppgaven');
const comment = task.comments.find(c => c.id === commentId);
if (!comment) throw new NotFoundError('Fant ikke kommentaren');
if (comment.by !== user) throw new Error('Kan bare slette egne kommentarer');
task.comments = task.comments.filter(c => c.id !== commentId);
this._persistTasks();
return { task };
}
replaceAll(arr, user, action = 'import') {
if (!Array.isArray(arr)) throw new Error('Forventet array');
const out = [];
for (const raw of arr) {
if (!raw || typeof raw !== 'object' || !raw.title) continue;
out.push(normalizeTask(raw, user, null, { importComments: true }));
}
this.tasks = out;
this._persistTasks();
const activity = this.addActivity(user, action, { detail: [`${out.length} oppgaver`] });
return { count: out.length, activity };
}
seed(seedArr, user) {
if (this.tasks.length > 0) throw new ConflictError('Data finnes allerede', null);
return this.replaceAll(seedArr, user, 'seed');
}
}
module.exports = { Store, NotFoundError, ConflictError, normalizeTask, VALID_CATEGORIES, VALID_PRIORITIES, VALID_STATUS };