RH ↔ FW Cross-Core Integration Contract

interface RhResidentAdmittedPayload {
  organization_id: string;
  resident_id: string;          // UUID - rh_residents.id
  program_id: string;           // UUID - rh_programs.id
  house_id: string;             // UUID - rh_houses.id
  bed_id?: string;              // UUID - rh_beds.id
  admission_date: string;       // ISO date
  admission_type: string;       // 'new' | 'readmission' | 'transfer'
  referral_source?: string;     // 'self' | 'court' | 'provider' | 'insurance'
  site_id?: string;
  timestamp: string;
}

interface RhResidentDischargedPayload {
  organization_id: string;
  resident_id: string;
  program_id: string;
  house_id: string;
  bed_id?: string;              // UUID - bed to release
  discharge_date: string;       // ISO date
  discharge_type: string;       // 'completed' | 'ama' | 'administrative' | 'transfer' | 'relapse'
  timestamp: string;
}

interface RhPhaseAdvancedPayload {
  organization_id: string;
  resident_id: string;
  program_id: string;
  previous_phase_id: string;    // UUID - rh_phases.id
  new_phase_id: string;         // UUID - rh_phases.id
  progression_type: string;     // 'automatic' | 'manual_approved'
  approved_by?: string;         // UUID - approver (if manual)
  timestamp: string;
}

interface RhPhaseProgressionRequestedPayload {
  organization_id: string;
  resident_id: string;
  program_id: string;
  current_phase_id: string;
  requested_phase_id: string;
  requested_by: string;         // UUID - staff member requesting progression
  assessment_score?: number;    // Phase assessment result
  timestamp: string;
}

interface RhSafetyEventCreatedPayload {
  organization_id: string;
  safety_event_id: string;      // UUID - rh_safety_events.id
  event_type: string;           // 'significant_event' | 'behavioral' | 'medical' | 'property' | 'other'
  severity: string;             // 'low' | 'medium' | 'high' | 'critical'
  resident_id?: string;         // UUID - involved resident (if applicable)
  house_id: string;
  site_id?: string;
  reported_by: string;          // UUID - staff member
  timestamp: string;
}

interface RhUdsTestPositivePayload {
  organization_id: string;
  uds_test_id: string;          // UUID - rh_uds_tests.id
  episode_id: string;           // UUID - context for downstream workflows
  tested_at: string;            // ISO 8601 timestamp
  correlation_id?: string;
}

interface RhPassRequestedPayload {
  organization_id: string;
  pass_id: string;              // UUID - rh_passes.id
  resident_id: string;
  pass_type: string;            // 'day' | 'overnight' | 'weekend' | 'extended'
  departure_date: string;
  return_date: string;
  destination: string;          // General area, not specific address
  house_id: string;
  timestamp: string;
}

interface RhAttendanceThresholdBreachedPayload {
  organization_id: string;
  resident_id: string;
  program_id: string;
  activity_type: string;        // 'group' | 'meeting' | 'counseling' | 'community_service'
  attendance_rate: number;       // 0-100 percentage
  threshold: number;             // Required minimum percentage
  period_start: string;
  period_end: string;
  timestamp: string;
}

interface RhComplianceDeadlinePayload {
  organization_id: string;
  compliance_item_id: string;
  compliance_type: string;      // 'fire_inspection' | 'license_renewal' | 'staff_training' | 'audit'
  deadline_date: string;
  days_until_deadline: number;
  house_id?: string;
  site_id?: string;
  timestamp: string;
}

-- rh_programs table references fw_forms for associated forms
ALTER TABLE rh_programs
  ADD COLUMN intake_form_id UUID REFERENCES fw_forms(id),
  ADD COLUMN assessment_form_id UUID REFERENCES fw_forms(id),
  ADD COLUMN exit_survey_form_id UUID REFERENCES fw_forms(id);

// Forms
import { useFormTemplate, FormRenderer } from '@/platform/forms';

// Approvals
import { useSubmitApprovalRequest, useMyApprovalRequests } from '@/platform/approvals';

// Events
import { publishEvent } from '@/platform/events';
import type { KnownEventName } from '@/platform/events';

// Data lookups for form fields
import { useLookupOptions } from '@/platform/data-lookup';

// Signatures for consent forms
import { SignatureCapture, useFormSignature } from '@/platform/signatures';