Files
ims/lib/incidents/validate.ts
T
adminandClaude Fable 5 576557181a feat: Phase 5 & 6 — usability, compliance hardening, analytics
Phase 5 (usability + compliance):
- In-app notification bell/badge: migration 016 adds read state + per-user
  RLS + create_in_app_notification SECURITY DEFINER RPC; /api/notifications;
  wired into incident creation, CAPA assign/verify, escalation cron
- Incident closure: new POST /api/incidents/[id]/close (requires verification
  status + all CAPAs verified); migration 017 locks closed incidents at DB
  level (update/delete triggers) with append-only incident_addenda + UI panel
- Server-side pagination on HSE/supervisor incident inboxes (.range, 25/page)
- Investigation form: alcohol/urine test result + witness statement refs
  (existing schema columns, now editable)
- Type-specific intake fields: migration 018 adds incidents.type_details
  JSONB; whitelist validation; environmental/asset/security/fire field
  groups in report form; EN/MS/ZH labels; offline queue support
- JKKP 8 annual register CSV export (/api/reports/jkkp8) + dashboard button
  + January statutory deadline banner
- Admin page: user invite (service-role client), role/site/active management,
  site + zone CRUD with QR report links — replaces Phase 0 stub
- Evidence gallery thumbnails via Supabase render transform with fallback

Phase 6 (analytics):
- 12-month stacked trend chart (leading/lagging/other) + top root causes
  (lib/dashboard/trends.ts pure helpers)
- AI rising-risk zones: /api/dashboard/ai/risk-flags aggregates 90-day
  zone stats, claude-opus-4-8 forced tool_use, panel on HSE + management
  dashboards, suggestion audit-logged

Also fixes 9 pre-existing missing /ims basePath prefixes in client fetches
and download links.

132 tests passing, tsc clean, next build clean.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CPf5Rc8QPx6V8KLEEgfKEQ
2026-07-12 10:25:08 +08:00

82 lines
3.0 KiB
TypeScript

export const INCIDENT_TYPES = ['injury', 'near_miss', 'hazard', 'asset_damage', 'environmental', 'security', 'fire'] as const
export const MEDICAL_STATUSES = ['none', 'first_aid', 'medical_treatment', 'lti'] as const
export type IncidentType = typeof INCIDENT_TYPES[number]
export type MedicalStatus = typeof MEDICAL_STATUSES[number]
export interface IncidentInput {
zone_token: string
incident_type: IncidentType
description: string
injury_involved: boolean
medical_status?: MedicalStatus
asset_involved: boolean
type_details?: Record<string, unknown>
}
// Whitelisted type-specific intake fields per incident type (PRD §3).
// 's' = free text, 'b' = boolean. Near miss / hazard / injury stay minimal by design.
export const TYPE_DETAIL_FIELDS: Partial<Record<IncidentType, Record<string, 's' | 'b'>>> = {
environmental: { substance: 's', estimated_volume: 's', containment_deployed: 'b' },
asset_damage: { equipment_id: 's', loto_applied: 'b' },
security: { persons_involved: 's', police_reported: 'b' },
fire: { alarm_raised: 'b', fire_brigade_called: 'b' },
}
export function validateTypeDetails(
incidentType: IncidentType,
details: Record<string, unknown> | undefined,
): { ok: boolean; errors: string[]; sanitized: Record<string, unknown> | null } {
if (details == null || Object.keys(details).length === 0) {
return { ok: true, errors: [], sanitized: null }
}
const allowed = TYPE_DETAIL_FIELDS[incidentType]
if (!allowed) {
return { ok: false, errors: [`type_details not allowed for incident_type ${incidentType}`], sanitized: null }
}
const errors: string[] = []
const sanitized: Record<string, unknown> = {}
for (const [key, value] of Object.entries(details)) {
const kind = allowed[key]
if (!kind) {
errors.push(`unknown type_details field: ${key}`)
continue
}
if (kind === 's') {
if (typeof value !== 'string') {
errors.push(`${key} must be a string`)
continue
}
const trimmed = value.trim()
if (trimmed) sanitized[key] = trimmed.slice(0, 500)
} else {
if (typeof value !== 'boolean') {
errors.push(`${key} must be a boolean`)
continue
}
sanitized[key] = value
}
}
return {
ok: errors.length === 0,
errors,
sanitized: Object.keys(sanitized).length > 0 ? sanitized : null,
}
}
export function validateIncidentInput(input: IncidentInput): { ok: boolean; errors: string[] } {
const errors: string[] = []
if (!input.zone_token?.trim()) errors.push('zone_token is required')
if (input.description.trim().length < 10) errors.push('description must be at least 10 characters')
if (!INCIDENT_TYPES.includes(input.incident_type)) errors.push('incident_type is invalid')
if (input.injury_involved && !input.medical_status) errors.push('medical_status is required when injury is involved')
if (input.medical_status && !MEDICAL_STATUSES.includes(input.medical_status)) errors.push('medical_status is invalid')
return { ok: errors.length === 0, errors }
}