Bed Board & Census — Integration

{
  event_name: 'rh_resident_admitted';
  event_timestamp: string;       // ISO 8601
  organization_id: string;       // UUID
  episode_id: string;            // UUID
  resident_profile_id: string;   // UUID
  residence_id: string;          // UUID
  bed_id: string;                // UUID
  admission_date: string;        // ISO date
  facility_type: 'recovery_housing' | 'psychiatric_residential' | 'inpatient_unit';
  // PM uses facility_type to derive POS: recovery_housing→55, psychiatric_residential→56, inpatient_unit→51
  agreement_id?: string;         // UUID — if agreement already created at admission
}

{
  event_name: 'rh_resident_discharged';
  event_timestamp: string;
  organization_id: string;
  episode_id: string;
  resident_profile_id: string;
  residence_id: string;
  discharge_date: string;
  discharge_reason: string;
  discharge_type: 'planned' | 'ama' | 'non_compliance' | 'completion' | 'extension';
  facility_type: 'recovery_housing' | 'psychiatric_residential' | 'inpatient_unit';
  exit_destination?: string;
}

{
  event_name: 'rh_bed_assigned';
  event_timestamp: string;
  organization_id: string;
  episode_id: string;
  bed_id: string;
  residence_id: string;
  facility_type: 'recovery_housing' | 'psychiatric_residential' | 'inpatient_unit';
  unit_label?: string;   // Non-null for inpatient_unit
  assigned_at: string;
}

{
  event_name: 'rh_bed_released';
  event_timestamp: string;
  organization_id: string;
  episode_id: string;
  bed_id: string;
  residence_id: string;
  facility_type: 'recovery_housing' | 'psychiatric_residential' | 'inpatient_unit';
  released_at: string;
}

{
  event_type: 'rh_invoice_creation_requested';
  event_timestamp: string;
  organization_id: string;
  episode_id: string;
  resident_profile_id: string;
  residence_id: string;
  agreement_id: string;
  payment_amount: number;
  payment_frequency: 'weekly' | 'bi_weekly' | 'monthly';
  payment_start_date: string;
  due_day_of_month?: number;
  payment_methods: string[];
  late_fee_amount: number;
  grace_period_days: number;
  admission_date: string;
  facility_type: 'recovery_housing' | 'psychiatric_residential' | 'inpatient_unit';
}

// Response
{
  episode_id: string;
  current_balance: number;
  last_payment_date: string | null;
  last_payment_amount: number | null;
  payment_status: 'current' | 'past_due' | 'paid_in_full' | 'unavailable';
}

interface BedCensusSummary {
  totalBeds: number;
  occupiedBeds: number;
  availableBeds: number;
  reservedBeds: number;
  maintenanceBeds: number;
  occupancyRate: number; // rounded percentage, 0 if totalBeds === 0
}

import { useQuery } from '@tanstack/react-query';
import { fetchBedCensusSummary } from '@/platform/census';

const { data, isLoading } = useQuery({
  queryKey: ['rh-bed-census', organizationId],
  queryFn: () => fetchBedCensusSummary(organizationId),
  enabled: !!organizationId,
  staleTime: 5 * 60 * 1000,
  gcTime: 10 * 60 * 1000,
  refetchInterval: 30 * 1000,
});

import { useCensusData } from '@/platform/census';

const { data } = useCensusData({
  organizationId,
  facilityType: 'inpatient_unit',  // optional filter
});
// data.totalCensus, data.totalCapacity, data.averageOccupancy

// Returns current episode's residence + bed for a given patient_id
GET /api/v1/rh/current-residence?patient_id={patientId}

// Response
{
  episode_id: string;
  residence_id: string;
  residence_name: string;
  facility_type: 'recovery_housing' | 'psychiatric_residential' | 'inpatient_unit';
  bed_label: string;
  room_number: string | null;
  unit_label: string | null;   // non-null for inpatient
  admission_date: string;
}