feat: Guest WiFi, network intelligence, firmware orchestration, platform automation, api-ssl (v0.16.3-beta)
Guest WiFi (Hotspot): one-click captive-portal wizard that creates the guest SSID (virtual AP per radio), VLAN/bridge segregation + L3 VLAN interface, pool, DHCP, portal, rate-limited guest profile, and masquerade; vouchers with limits + printable sheets; live guest sessions; walled garden. Network intelligence: per-client device fingerprinting (vendor/hostname → category) with a persisted per-client override on the detail page; rogue/neighbor AP detection from stored AP scans (evil-twin flagging); Mist-style anomaly insights (client-count/CPU vs same-hour 14-day baseline + error bursts) in the Operations engine. Firmware orchestration: staged wave-based RouterOS rollouts (canary first) with pre-upgrade backup, reboot-ride-out, version verification, halt-on-failure, and scheduling; live per-device progress + cancel. Platform & automation: scoped API tokens (mtm_, read/write, hashed at rest, Bearer auth in requireAuth); outbound webhooks (12 events, HMAC-signed) fired from the alert pipeline + firmware orchestrator; scheduled email reports. api-ssl: RouterOSClient negotiates TLS on port 8729 and accepts RouterOS's default self-signed certs (rejectUnauthorized:false), so SSL-secured API devices connect without manual cert trust. Fixes #57. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2GT-Rich
co-authored by
Claude Opus 4.8
Claude Opus 4.8
parent
efb430d934
commit
9dfb8a5333
@@ -0,0 +1,150 @@
|
||||
// Scheduled email reports — periodic fleet summaries (device health, alerts,
|
||||
// top clients, updates, backups) delivered over the SMTP settings of the first
|
||||
// enabled email alert channel. An hourly scheduler sends whatever is due.
|
||||
|
||||
import nodemailer from 'nodemailer';
|
||||
import { query, queryOne } from '../config/database';
|
||||
|
||||
interface ScheduleRow {
|
||||
id: number; name: string; frequency: 'daily' | 'weekly' | 'monthly';
|
||||
recipients: string; enabled: boolean; next_run_at: string;
|
||||
}
|
||||
|
||||
const PERIOD_DAYS: Record<string, number> = { daily: 1, weekly: 7, monthly: 30 };
|
||||
|
||||
export function computeNextRun(frequency: string, from: Date): Date {
|
||||
const next = new Date(from);
|
||||
if (frequency === 'daily') next.setDate(next.getDate() + 1);
|
||||
else if (frequency === 'monthly') next.setMonth(next.getMonth() + 1);
|
||||
else next.setDate(next.getDate() + 7);
|
||||
return next;
|
||||
}
|
||||
|
||||
const fmtBytes = (b: number) =>
|
||||
b >= 1024 ** 4 ? `${(b / 1024 ** 4).toFixed(2)} TB`
|
||||
: b >= 1024 ** 3 ? `${(b / 1024 ** 3).toFixed(2)} GB`
|
||||
: b >= 1024 ** 2 ? `${(b / 1024 ** 2).toFixed(1)} MB`
|
||||
: `${(b / 1024).toFixed(1)} KB`;
|
||||
|
||||
export class ReportService {
|
||||
private timer: ReturnType<typeof setInterval> | null = null;
|
||||
|
||||
startScheduler(): void {
|
||||
if (this.timer) return;
|
||||
this.timer = setInterval(() => {
|
||||
this.sendDue().catch(e => console.error('[Reports] scheduler error:', e));
|
||||
}, 60 * 60_000);
|
||||
}
|
||||
|
||||
stopScheduler(): void {
|
||||
if (this.timer) { clearInterval(this.timer); this.timer = null; }
|
||||
}
|
||||
|
||||
private async sendDue(): Promise<void> {
|
||||
const due = await query<ScheduleRow>(
|
||||
`SELECT * FROM report_schedules WHERE enabled = TRUE AND next_run_at <= NOW()`);
|
||||
for (const s of due) {
|
||||
try {
|
||||
await this.send(s);
|
||||
await query(
|
||||
`UPDATE report_schedules SET last_sent_at = NOW(), next_run_at = $2 WHERE id = $1`,
|
||||
[s.id, computeNextRun(s.frequency, new Date())]);
|
||||
} catch (e) {
|
||||
console.error(`[Reports] "${s.name}" failed:`, (e as Error).message);
|
||||
// push next_run_at forward anyway so a broken SMTP config doesn't retry hourly forever
|
||||
await query(`UPDATE report_schedules SET next_run_at = $2 WHERE id = $1`,
|
||||
[s.id, computeNextRun(s.frequency, new Date())]);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
async send(schedule: Pick<ScheduleRow, 'name' | 'frequency' | 'recipients'>): Promise<void> {
|
||||
const smtp = await this.smtpConfig();
|
||||
const html = await this.buildHtml(schedule.frequency);
|
||||
const recipients = schedule.recipients.split(',').map(r => r.trim()).filter(Boolean);
|
||||
if (recipients.length === 0) throw new Error('No recipients configured');
|
||||
|
||||
const transport = nodemailer.createTransport({
|
||||
host: smtp.host, port: smtp.port, secure: smtp.secure,
|
||||
auth: smtp.user ? { user: smtp.user, pass: smtp.pass } : undefined,
|
||||
});
|
||||
await transport.sendMail({
|
||||
from: smtp.from,
|
||||
to: recipients.join(', '),
|
||||
subject: `MikroTik Manager — ${schedule.frequency} network report`,
|
||||
html,
|
||||
});
|
||||
console.log(`[Reports] sent "${schedule.name}" to ${recipients.length} recipient(s)`);
|
||||
}
|
||||
|
||||
// SMTP settings come from the first enabled email alert channel
|
||||
private async smtpConfig(): Promise<{ host: string; port: number; secure: boolean; user?: string; pass?: string; from: string }> {
|
||||
const ch = await queryOne<{ config: Record<string, unknown> }>(
|
||||
`SELECT config FROM alert_channels WHERE type = 'email' AND enabled = TRUE ORDER BY id LIMIT 1`);
|
||||
const cfg = ch?.config;
|
||||
const host = cfg?.smtp_host as string | undefined;
|
||||
if (!host) throw new Error('No enabled email alert channel — configure one under Settings → Alerting to send reports');
|
||||
return {
|
||||
host,
|
||||
port: (cfg?.smtp_port as number) || 587,
|
||||
secure: !!cfg?.smtp_secure,
|
||||
user: cfg?.smtp_user as string | undefined,
|
||||
pass: cfg?.smtp_pass as string | undefined,
|
||||
from: (cfg?.from_address as string) || (cfg?.smtp_user as string) || 'reports@mikrotik-manager',
|
||||
};
|
||||
}
|
||||
|
||||
private async buildHtml(frequency: string): Promise<string> {
|
||||
const days = PERIOD_DAYS[frequency] ?? 7;
|
||||
const [devices, outages, alerts, topClients, backups] = await Promise.all([
|
||||
query<{ total: string; online: string; updates: string }>(
|
||||
`SELECT COUNT(*)::text AS total,
|
||||
COUNT(*) FILTER (WHERE status='online')::text AS online,
|
||||
COUNT(*) FILTER (WHERE firmware_update_available)::text AS updates
|
||||
FROM devices`),
|
||||
query<{ n: string; secs: string }>(
|
||||
`SELECT COUNT(*)::text AS n, COALESCE(SUM(COALESCE(duration_seconds,0)),0)::text AS secs
|
||||
FROM device_availability WHERE went_offline_at > NOW() - ($1 || ' days')::interval`, [days]),
|
||||
query<{ errors: string; warnings: string }>(
|
||||
`SELECT COUNT(*) FILTER (WHERE severity='error')::text AS errors,
|
||||
COUNT(*) FILTER (WHERE severity='warning')::text AS warnings
|
||||
FROM events WHERE event_time > NOW() - ($1 || ' days')::interval`, [days]),
|
||||
query<{ name: string; bytes: string }>(
|
||||
`SELECT COALESCE(NULLIF(c.custom_name,''), NULLIF(c.hostname,''), ctd.mac_address) AS name,
|
||||
SUM(ctd.upload_bytes + ctd.download_bytes)::text AS bytes
|
||||
FROM client_traffic_daily ctd
|
||||
LEFT JOIN clients c ON LOWER(c.mac_address) = ctd.mac_address
|
||||
WHERE ctd.day > CURRENT_DATE - $1::int
|
||||
GROUP BY 1 ORDER BY SUM(ctd.upload_bytes + ctd.download_bytes) DESC LIMIT 5`, [days]),
|
||||
query<{ n: string }>(
|
||||
`SELECT COUNT(*)::text AS n FROM backups WHERE created_at > NOW() - ($1 || ' days')::interval`, [days]),
|
||||
]);
|
||||
|
||||
const d = devices[0];
|
||||
const outageMin = Math.round(parseInt(outages[0]?.secs || '0', 10) / 60);
|
||||
const row = (label: string, value: string) =>
|
||||
`<tr><td style="padding:6px 12px;color:#64748b;">${label}</td><td style="padding:6px 12px;font-weight:600;color:#0f172a;">${value}</td></tr>`;
|
||||
|
||||
const clientRows = topClients.map((c, i) =>
|
||||
`<tr><td style="padding:4px 12px;color:#64748b;">${i + 1}. ${c.name}</td><td style="padding:4px 12px;color:#0f172a;">${fmtBytes(parseInt(c.bytes, 10))}</td></tr>`).join('');
|
||||
|
||||
return `
|
||||
<div style="font-family:-apple-system,system-ui,sans-serif;max-width:560px;margin:0 auto;">
|
||||
<h2 style="color:#0f172a;">MikroTik Manager — ${frequency} report</h2>
|
||||
<p style="color:#64748b;font-size:13px;">Covering the last ${days} day${days !== 1 ? 's' : ''} · generated ${new Date().toUTCString()}</p>
|
||||
<table style="border-collapse:collapse;width:100%;background:#f8fafc;border-radius:8px;">
|
||||
${row('Devices online', `${d?.online ?? 0} / ${d?.total ?? 0}`)}
|
||||
${row('Outages', `${outages[0]?.n ?? 0} (${outageMin} min total downtime)`)}
|
||||
${row('Error events', alerts[0]?.errors ?? '0')}
|
||||
${row('Warning events', alerts[0]?.warnings ?? '0')}
|
||||
${row('Firmware updates available', d?.updates ?? '0')}
|
||||
${row('Backups taken', backups[0]?.n ?? '0')}
|
||||
</table>
|
||||
${topClients.length ? `<h3 style="color:#0f172a;font-size:14px;margin-top:20px;">Top clients by traffic</h3>
|
||||
<table style="border-collapse:collapse;width:100%;background:#f8fafc;border-radius:8px;">${clientRows}</table>` : ''}
|
||||
<p style="color:#94a3b8;font-size:11px;margin-top:20px;">Sent by MikroTik Manager scheduled reports.</p>
|
||||
</div>`;
|
||||
}
|
||||
}
|
||||
|
||||
export const reportService = new ReportService();
|
||||
Reference in New Issue
Block a user