Session 8: Add Patient & Booking Flow

# Partial name - WORKS
curl 'https://api-stg.kulcare.com/clinical/patients/federated_search?name=mohit' \
  -H 'Authorization: Bearer ...'
# Returns: Patient "Mohit Goyal" found

# Full name - FAILS
curl 'https://api-stg.kulcare.com/clinical/patients/federated_search?name=mohit%20goyal' \
  -H 'Authorization: Bearer ...'
# Returns: No results

def apply_name_filter(scope)
  scope.where('LOWER(first_name) LIKE :q OR LOWER(last_name) LIKE :q', q: safe_like_term(@name))
end

def serialize_in_kulcare(identity_patient)
  {
    identity_patient_id: identity_patient.id,
    name: identity_patient.display_name,
    phone: identity_patient.phone_number,
    phone_country_code: identity_patient.phone_country_code,
    age: identity_patient.respond_to?(:age) ? identity_patient.age : nil,
    gender: identity_patient.gender,
    birth_date: identity_patient.birth_date,  # Add this line
    registered_via: identity_patient.user_id.present? ? 'patient_app' : 'another_clinic'
  }
end

curl 'https://api-stg.kulcare.com/clinical/patients' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ...' \
  --data-raw '{
    "first_name":"ddasdsadsadasdsadsadsadsadsafsdfsdfsdfdsfsdfsfdsfdsfdsfdsfdfadsfdsfadsfdsdsadsadsadsadsadsadsa",
    "last_name":"dsadsadsadsadsadsadfdsfdsfdsfdsfdsfdsfdsfdsfdsfdsfdsfdsfdsfdsfdsfdsfdsf",
    "phone_number":"dsadasdsadsads",
    "phone_country_code":"91",
    "gender":"male",
    "birth_date":"2026-06-15"
  }'

const validationSchema = z.object({
  first_name: z.string().min(2, "Min 2 chars").max(50, "Max 50 chars"),
  last_name: z.string().min(2, "Min 2 chars").max(50, "Max 50 chars"),
  phone_number: z.string().regex(/^\d{10}$/, "Must be 10 digits"),
  birth_date: z.string().refine(
    (date) => new Date(date) <= new Date(),
    "DOB cannot be in future"
  ),
});

validates :first_name, length: { minimum: 2, maximum: 50 }
validates :last_name, length: { minimum: 2, maximum: 50 }
validates :phone_number, format: { with: /\A\d{10}\z/ }
validate :birth_date_not_in_future

def birth_date_not_in_future
  errors.add(:birth_date, "cannot be in future") if birth_date.present? && birth_date > Date.current
end

# Empty last_name - ACCEPTS
curl 'https://api-stg.kulcare.com/clinical/patients' \
  --data-raw '{
    "first_name":"Harsh",
    "last_name":"",
    "phone_number":"1234567890",
    "phone_country_code":"91",
    "gender":"male",
    "birth_date":"2026-06-15"
  }'
# Response: 200 OK - Patient created with last_name: ""

last_name: z.string().min(1, "Required").transform(val => val?.trim())

validates :last_name, presence: true, unless: -> { last_name.nil? }
before_validation :normalize_names

def normalize_names
  self.last_name = last_name&.strip
end

# Whitespace phone - ACCEPTS
curl 'https://api-stg.kulcare.com/clinical/patients' \
  --data-raw '{
    "first_name":"Chugh",
    "last_name":"",
    "phone_number":"          ",
    "phone_country_code":"91",
    "gender":"male",
    "birth_date":"2026-06-15"
  }'
# Response: 200 OK - Patient created with phone_number: "          "

phone_number: z.string()
  .min(10, "Min 10 digits")
  .max(10, "Max 10 digits")
  .regex(/^\d+$/, "Only digits allowed")

before_validation :normalize_phone

def normalize_phone
  self.phone_number = phone_number&.gsub(/\D/, '')
end

validates :phone_number, presence: true, format: { with: /\A\d{10}\z/ }

before_validation :normalize_phone

def normalize_phone
  self.phone_number = phone_number&.strip
end

validates :phone_number, presence: true, format: { with: /\A\d{10}\z/ }

const queryParams = {
  search: debouncedSearch || undefined,
  page: filters.page,
  per_page: filters.perPage,
  // dateRange NOT included here
};

birth_date_from: filters.dateRange?.from,
birth_date_to: filters.dateRange?.to,