ghostguild-org/server/utils/adminAlerts.js

229 lines
5.9 KiB
JavaScript

import { createHash } from 'node:crypto'
import Member from '../models/member.js'
import Event from '../models/event.js'
import PreRegistration from '../models/preRegistration.js'
import TagSuggestion from '../models/tagSuggestion.js'
import AdminAlertDismissal, { ADMIN_ALERT_TYPES } from '../models/adminAlertDismissal.js'
import { connectDB } from './mongoose.js'
export const ALERT_THRESHOLDS = {
NO_SLACK_DAYS: 7,
STUCK_PAYMENT_DAYS: 7,
PREREG_SELECTED_DAYS: 3,
DRAFT_IMMINENT_DAYS: 14,
NEAR_CAPACITY_RATIO: 0.8
}
const DAY_MS = 24 * 60 * 60 * 1000
function daysAgo(days) {
return new Date(Date.now() - days * DAY_MS)
}
function daysSince(date) {
if (!date) return null
return Math.floor((Date.now() - new Date(date).getTime()) / DAY_MS)
}
export function computeSignature(ids) {
const normalized = ids
.map((id) => (id == null ? '' : String(id)))
.sort()
const hash = createHash('sha1')
hash.update(JSON.stringify(normalized))
return hash.digest('hex')
}
function memberItem(member, sublabel) {
return {
id: String(member._id),
label: member.name,
sublabel: sublabel ?? member.email,
href: `/admin/members/${member._id}`
}
}
export async function detectSlackInviteFailed() {
await connectDB()
const members = await Member
.find({ slackInviteStatus: 'failed' })
.select('name email')
.lean()
return {
type: 'slack_invite_failed',
severity: 'critical',
title: 'Slack invites failed',
items: members.map((m) => memberItem(m))
}
}
export async function detectNoSlackHandleAfterWeek() {
await connectDB()
const cutoff = daysAgo(ALERT_THRESHOLDS.NO_SLACK_DAYS)
const members = await Member
.find({
status: 'active',
createdAt: { $lte: cutoff },
$or: [
{ slackUserId: { $exists: false } },
{ slackUserId: null },
{ slackUserId: '' }
]
})
.select('name email createdAt')
.lean()
return {
type: 'no_slack_handle_week',
severity: 'attention',
title: 'Active members without a Slack handle',
items: members.map((m) =>
memberItem(m, `${daysSince(m.createdAt)} days since joining`)
)
}
}
export async function detectStuckPendingPayment() {
await connectDB()
const cutoff = daysAgo(ALERT_THRESHOLDS.STUCK_PAYMENT_DAYS)
const members = await Member
.find({
status: 'pending_payment',
createdAt: { $lte: cutoff }
})
.select('name email createdAt')
.lean()
return {
type: 'stuck_pending_payment',
severity: 'attention',
title: 'Members stuck in pending payment',
items: members.map((m) =>
memberItem(m, `${daysSince(m.createdAt)} days stuck`)
)
}
}
export async function detectSuspendedMembers() {
await connectDB()
const members = await Member
.find({ status: 'suspended' })
.select('name email')
.lean()
return {
type: 'member_suspended',
severity: 'attention',
title: 'Suspended members',
items: members.map((m) => memberItem(m))
}
}
function preRegItem(preReg, sublabel) {
return {
id: String(preReg._id),
label: preReg.name || preReg.email,
sublabel,
href: '/admin/pre-registrants'
}
}
export async function detectPreRegistrantSelectedNotInvited() {
await connectDB()
const cutoff = daysAgo(ALERT_THRESHOLDS.PREREG_SELECTED_DAYS)
const preRegs = await PreRegistration
.find({
status: 'selected',
updatedAt: { $lte: cutoff }
})
.select('name email updatedAt')
.lean()
return {
type: 'preregistrant_selected_not_invited',
severity: 'attention',
title: 'Pre-registrants selected but not invited',
items: preRegs.map((p) =>
preRegItem(p, `${p.email}${daysSince(p.updatedAt)} days selected`)
)
}
}
export async function detectPreRegistrantExpired() {
await connectDB()
const preRegs = await PreRegistration
.find({ status: 'expired' })
.select('name email updatedAt')
.lean()
return {
type: 'preregistrant_expired',
severity: 'attention',
title: 'Expired pre-registrant invitations',
items: preRegs.map((p) =>
preRegItem(p, `${p.email} — expired ${daysSince(p.updatedAt)} days ago`)
)
}
}
function eventItem(ev, sublabel) {
return {
id: String(ev._id),
label: ev.title,
sublabel,
href: '/admin/events'
}
}
export async function detectDraftEventsImminent() {
await connectDB()
const now = new Date()
const horizon = new Date(now.getTime() + ALERT_THRESHOLDS.DRAFT_IMMINENT_DAYS * DAY_MS)
const events = await Event
.find({
isVisible: false,
isCancelled: { $ne: true },
startDate: { $gte: now, $lte: horizon }
})
.select('title startDate')
.lean()
return {
type: 'event_draft_imminent',
severity: 'critical',
title: 'Draft events with imminent start',
items: events.map((ev) => {
const days = Math.max(0, Math.ceil((new Date(ev.startDate).getTime() - Date.now()) / DAY_MS))
return eventItem(ev, `Starts in ${days} days`)
})
}
}
export async function detectEventsNearCapacity() {
await connectDB()
const now = new Date()
const events = await Event
.find({
'tickets.enabled': true,
'tickets.capacity.total': { $gt: 0 },
isCancelled: { $ne: true },
startDate: { $gte: now }
})
.select('title startDate tickets registrations')
.lean()
const matched = events
.map((ev) => {
const total = ev.tickets?.capacity?.total
if (!total) return null
const reserved = ev.tickets?.capacity?.reserved || 0
const taken = (ev.registrations?.length || 0) + reserved
const ratio = taken / total
if (ratio < ALERT_THRESHOLDS.NEAR_CAPACITY_RATIO) return null
return eventItem(ev, `${taken} / ${total} seats taken`)
})
.filter(Boolean)
return {
type: 'event_near_capacity',
severity: 'attention',
title: 'Events approaching capacity',
items: matched
}
}
// Aggregator lands in task 8.