feat(onboarding/phase-3): clinics, doctors, team invite/role CRUD

Replaces Phase 2 placeholder routes for /settings/clinics and
/settings/doctors with real list + add/edit slideouts backed directly by
the platform's ClinicCreateInput / DoctorCreateInput mutations. Rewrites
/settings/team to fetch roles via getRoles and let admins invite members
(sendInvitations) and change roles (updateWorkspaceMemberRole).

- src/components/forms/clinic-form.tsx — reusable form + GraphQL input
  transformer, handles address/phone/email composite types
- src/components/forms/doctor-form.tsx — reusable form with clinic
  dropdown and currency conversion for consultation fees
- src/components/forms/invite-member-form.tsx — multi-email chip input
  with comma-to-commit UX (AriaTextField doesn't expose onKeyDown)
- src/pages/clinics.tsx — list + slideout using ClinicForm, marks the
  clinics setup step complete on first successful add
- src/pages/doctors.tsx — list + slideout with parallel clinic fetch,
  disabled-state when no clinics exist, marks doctors step complete
- src/pages/team-settings.tsx — replaces email-pattern role inference
  with real getRoles + in-row role Select, adds invite slideout, marks
  team step complete on successful invitation
- src/main.tsx — routes /settings/clinics and /settings/doctors to real
  pages instead of SettingsPlaceholder stubs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-07 07:33:25 +05:30
parent c1b636cb6d
commit 4420b648d4
7 changed files with 1682 additions and 133 deletions

View File

@@ -0,0 +1,263 @@
import { Input } from '@/components/base/input/input';
import { Select } from '@/components/base/select/select';
import { TextArea } from '@/components/base/textarea/textarea';
import { Toggle } from '@/components/base/toggle/toggle';
// Reusable clinic form used by both the /settings/clinics slideout and the
// /setup wizard step. The parent owns the form state so it can also own the
// submit button and the loading/error UI.
//
// Field shapes mirror the platform's ClinicCreateInput (which uses
// `addressCustom`, not `address`, and `onlineBooking`, not
// `onlineBookingEnabled` as the SDK field). See
// FortyTwoApps/helix-engage/src/objects/clinic.object.ts for the SDK source of
// truth; GraphQL-level differences are normalised in clinicFormToGraphQLInput.
export type ClinicStatus = 'ACTIVE' | 'TEMPORARILY_CLOSED' | 'PERMANENTLY_CLOSED';
export type ClinicFormValues = {
clinicName: string;
addressStreet1: string;
addressStreet2: string;
addressCity: string;
addressState: string;
addressPostcode: string;
phone: string;
email: string;
weekdayHours: string;
saturdayHours: string;
sundayHours: string;
status: ClinicStatus;
walkInAllowed: boolean;
onlineBooking: boolean;
cancellationWindowHours: string;
arriveEarlyMin: string;
requiredDocuments: string;
};
export const emptyClinicFormValues = (): ClinicFormValues => ({
clinicName: '',
addressStreet1: '',
addressStreet2: '',
addressCity: '',
addressState: '',
addressPostcode: '',
phone: '',
email: '',
weekdayHours: '9:00 AM - 6:00 PM',
saturdayHours: '9:00 AM - 2:00 PM',
sundayHours: 'Closed',
status: 'ACTIVE',
walkInAllowed: true,
onlineBooking: true,
cancellationWindowHours: '24',
arriveEarlyMin: '15',
requiredDocuments: '',
});
const STATUS_ITEMS = [
{ id: 'ACTIVE', label: 'Active' },
{ id: 'TEMPORARILY_CLOSED', label: 'Temporarily closed' },
{ id: 'PERMANENTLY_CLOSED', label: 'Permanently closed' },
];
// Convert form state into the shape the platform's createClinic / updateClinic
// mutations expect. Only non-empty fields are included so the platform can
// apply its own defaults for the rest.
export const clinicFormToGraphQLInput = (v: ClinicFormValues): Record<string, unknown> => {
const input: Record<string, unknown> = {
clinicName: v.clinicName.trim(),
status: v.status,
walkInAllowed: v.walkInAllowed,
onlineBooking: v.onlineBooking,
};
const hasAddress = v.addressStreet1 || v.addressCity || v.addressState || v.addressPostcode;
if (hasAddress) {
input.addressCustom = {
addressStreet1: v.addressStreet1 || null,
addressStreet2: v.addressStreet2 || null,
addressCity: v.addressCity || null,
addressState: v.addressState || null,
addressPostcode: v.addressPostcode || null,
addressCountry: 'India',
};
}
if (v.phone.trim()) {
input.phone = {
primaryPhoneNumber: v.phone.trim(),
primaryPhoneCountryCode: 'IN',
primaryPhoneCallingCode: '+91',
additionalPhones: null,
};
}
if (v.email.trim()) {
input.email = {
primaryEmail: v.email.trim(),
additionalEmails: null,
};
}
if (v.weekdayHours.trim()) input.weekdayHours = v.weekdayHours.trim();
if (v.saturdayHours.trim()) input.saturdayHours = v.saturdayHours.trim();
if (v.sundayHours.trim()) input.sundayHours = v.sundayHours.trim();
if (v.cancellationWindowHours.trim()) {
const n = Number(v.cancellationWindowHours);
if (!Number.isNaN(n)) input.cancellationWindowHours = n;
}
if (v.arriveEarlyMin.trim()) {
const n = Number(v.arriveEarlyMin);
if (!Number.isNaN(n)) input.arriveEarlyMin = n;
}
if (v.requiredDocuments.trim()) input.requiredDocuments = v.requiredDocuments.trim();
return input;
};
type ClinicFormProps = {
value: ClinicFormValues;
onChange: (value: ClinicFormValues) => void;
};
export const ClinicForm = ({ value, onChange }: ClinicFormProps) => {
const patch = (updates: Partial<ClinicFormValues>) => onChange({ ...value, ...updates });
return (
<div className="flex flex-col gap-4">
<Input
label="Clinic name"
isRequired
placeholder="e.g. Main Hospital Campus"
value={value.clinicName}
onChange={(v) => patch({ clinicName: v })}
/>
<Select
label="Status"
placeholder="Select status"
items={STATUS_ITEMS}
selectedKey={value.status}
onSelectionChange={(key) => patch({ status: key as ClinicStatus })}
>
{(item) => <Select.Item id={item.id} label={item.label} />}
</Select>
<div className="flex flex-col gap-3">
<p className="text-xs font-semibold uppercase tracking-wider text-quaternary">Address</p>
<Input
label="Street address"
placeholder="Street / building / landmark"
value={value.addressStreet1}
onChange={(v) => patch({ addressStreet1: v })}
/>
<Input
label="Area / locality (optional)"
placeholder="Area, neighbourhood"
value={value.addressStreet2}
onChange={(v) => patch({ addressStreet2: v })}
/>
<div className="grid grid-cols-2 gap-3">
<Input
label="City"
placeholder="Bengaluru"
value={value.addressCity}
onChange={(v) => patch({ addressCity: v })}
/>
<Input
label="State"
placeholder="Karnataka"
value={value.addressState}
onChange={(v) => patch({ addressState: v })}
/>
</div>
<Input
label="Postcode"
placeholder="560034"
value={value.addressPostcode}
onChange={(v) => patch({ addressPostcode: v })}
/>
</div>
<div className="flex flex-col gap-3">
<p className="text-xs font-semibold uppercase tracking-wider text-quaternary">Contact</p>
<Input
label="Phone"
type="tel"
placeholder="9876543210"
value={value.phone}
onChange={(v) => patch({ phone: v })}
/>
<Input
label="Email"
type="email"
placeholder="branch@hospital.com"
value={value.email}
onChange={(v) => patch({ email: v })}
/>
</div>
<div className="flex flex-col gap-3">
<p className="text-xs font-semibold uppercase tracking-wider text-quaternary">Visiting hours</p>
<Input
label="Weekdays"
placeholder="9:00 AM - 6:00 PM"
value={value.weekdayHours}
onChange={(v) => patch({ weekdayHours: v })}
/>
<div className="grid grid-cols-2 gap-3">
<Input
label="Saturday"
placeholder="9:00 AM - 2:00 PM"
value={value.saturdayHours}
onChange={(v) => patch({ saturdayHours: v })}
/>
<Input
label="Sunday"
placeholder="Closed"
value={value.sundayHours}
onChange={(v) => patch({ sundayHours: v })}
/>
</div>
</div>
<div className="flex flex-col gap-3">
<p className="text-xs font-semibold uppercase tracking-wider text-quaternary">Booking policy</p>
<div className="flex flex-col gap-3 rounded-lg border border-secondary bg-secondary p-4">
<Toggle
label="Walk-ins allowed"
isSelected={value.walkInAllowed}
onChange={(checked) => patch({ walkInAllowed: checked })}
/>
<Toggle
label="Accept online bookings"
isSelected={value.onlineBooking}
onChange={(checked) => patch({ onlineBooking: checked })}
/>
</div>
<div className="grid grid-cols-2 gap-3">
<Input
label="Cancel window (hours)"
type="number"
value={value.cancellationWindowHours}
onChange={(v) => patch({ cancellationWindowHours: v })}
/>
<Input
label="Arrive early (min)"
type="number"
value={value.arriveEarlyMin}
onChange={(v) => patch({ arriveEarlyMin: v })}
/>
</div>
<TextArea
label="Required documents"
placeholder="ID proof, referral letter, previous reports..."
value={value.requiredDocuments}
onChange={(v) => patch({ requiredDocuments: v })}
rows={3}
/>
</div>
</div>
);
};

View File

@@ -0,0 +1,260 @@
import { Input } from '@/components/base/input/input';
import { Select } from '@/components/base/select/select';
import { TextArea } from '@/components/base/textarea/textarea';
import { Toggle } from '@/components/base/toggle/toggle';
// Reusable doctor form used by /settings/doctors and the /setup wizard. The
// parent owns both the form state and the list of clinics to populate the
// clinic dropdown (since the list page will already have it loaded).
//
// Field names mirror the platform's DoctorCreateInput — notably `active`, not
// `isActive`, and `clinicId` for the relation.
export type DoctorDepartment =
| 'CARDIOLOGY'
| 'GYNECOLOGY'
| 'ORTHOPEDICS'
| 'GENERAL_MEDICINE'
| 'ENT'
| 'DERMATOLOGY'
| 'PEDIATRICS'
| 'ONCOLOGY';
export type DoctorFormValues = {
firstName: string;
lastName: string;
department: DoctorDepartment | '';
specialty: string;
qualifications: string;
yearsOfExperience: string;
clinicId: string;
visitingHours: string;
consultationFeeNew: string;
consultationFeeFollowUp: string;
phone: string;
email: string;
registrationNumber: string;
active: boolean;
};
export const emptyDoctorFormValues = (): DoctorFormValues => ({
firstName: '',
lastName: '',
department: '',
specialty: '',
qualifications: '',
yearsOfExperience: '',
clinicId: '',
visitingHours: '',
consultationFeeNew: '',
consultationFeeFollowUp: '',
phone: '',
email: '',
registrationNumber: '',
active: true,
});
const DEPARTMENT_ITEMS: { id: DoctorDepartment; label: string }[] = [
{ id: 'CARDIOLOGY', label: 'Cardiology' },
{ id: 'GYNECOLOGY', label: 'Gynecology' },
{ id: 'ORTHOPEDICS', label: 'Orthopedics' },
{ id: 'GENERAL_MEDICINE', label: 'General medicine' },
{ id: 'ENT', label: 'ENT' },
{ id: 'DERMATOLOGY', label: 'Dermatology' },
{ id: 'PEDIATRICS', label: 'Pediatrics' },
{ id: 'ONCOLOGY', label: 'Oncology' },
];
// Convert form state into the shape createDoctor/updateDoctor mutations
// expect. yearsOfExperience and consultation fees are text fields in the UI
// but typed in GraphQL, so we parse + validate here.
export const doctorFormToGraphQLInput = (v: DoctorFormValues): Record<string, unknown> => {
const input: Record<string, unknown> = {
fullName: {
firstName: v.firstName.trim(),
lastName: v.lastName.trim(),
},
active: v.active,
};
if (v.department) input.department = v.department;
if (v.specialty.trim()) input.specialty = v.specialty.trim();
if (v.qualifications.trim()) input.qualifications = v.qualifications.trim();
if (v.yearsOfExperience.trim()) {
const n = Number(v.yearsOfExperience);
if (!Number.isNaN(n)) input.yearsOfExperience = n;
}
if (v.clinicId) input.clinicId = v.clinicId;
if (v.visitingHours.trim()) input.visitingHours = v.visitingHours.trim();
if (v.consultationFeeNew.trim()) {
const n = Number(v.consultationFeeNew);
if (!Number.isNaN(n)) {
input.consultationFeeNew = {
amountMicros: Math.round(n * 1_000_000),
currencyCode: 'INR',
};
}
}
if (v.consultationFeeFollowUp.trim()) {
const n = Number(v.consultationFeeFollowUp);
if (!Number.isNaN(n)) {
input.consultationFeeFollowUp = {
amountMicros: Math.round(n * 1_000_000),
currencyCode: 'INR',
};
}
}
if (v.phone.trim()) {
input.phone = {
primaryPhoneNumber: v.phone.trim(),
primaryPhoneCountryCode: 'IN',
primaryPhoneCallingCode: '+91',
additionalPhones: null,
};
}
if (v.email.trim()) {
input.email = {
primaryEmail: v.email.trim(),
additionalEmails: null,
};
}
if (v.registrationNumber.trim()) input.registrationNumber = v.registrationNumber.trim();
return input;
};
type ClinicOption = { id: string; label: string };
type DoctorFormProps = {
value: DoctorFormValues;
onChange: (value: DoctorFormValues) => void;
clinics: ClinicOption[];
};
export const DoctorForm = ({ value, onChange, clinics }: DoctorFormProps) => {
const patch = (updates: Partial<DoctorFormValues>) => onChange({ ...value, ...updates });
return (
<div className="flex flex-col gap-4">
<div className="grid grid-cols-2 gap-3">
<Input
label="First name"
isRequired
placeholder="Ananya"
value={value.firstName}
onChange={(v) => patch({ firstName: v })}
/>
<Input
label="Last name"
isRequired
placeholder="Rao"
value={value.lastName}
onChange={(v) => patch({ lastName: v })}
/>
</div>
<Select
label="Department"
placeholder="Select department"
items={DEPARTMENT_ITEMS}
selectedKey={value.department || null}
onSelectionChange={(key) => patch({ department: (key as DoctorDepartment) || '' })}
>
{(item) => <Select.Item id={item.id} label={item.label} />}
</Select>
<Input
label="Specialty"
placeholder="e.g. Interventional cardiology"
value={value.specialty}
onChange={(v) => patch({ specialty: v })}
/>
<div className="grid grid-cols-2 gap-3">
<Input
label="Qualifications"
placeholder="MBBS, MD"
value={value.qualifications}
onChange={(v) => patch({ qualifications: v })}
/>
<Input
label="Experience (years)"
type="number"
value={value.yearsOfExperience}
onChange={(v) => patch({ yearsOfExperience: v })}
/>
</div>
<Select
label="Clinic"
placeholder={clinics.length === 0 ? 'Add a clinic first' : 'Assign to a clinic'}
isDisabled={clinics.length === 0}
items={clinics}
selectedKey={value.clinicId || null}
onSelectionChange={(key) => patch({ clinicId: (key as string) || '' })}
>
{(item) => <Select.Item id={item.id} label={item.label} />}
</Select>
<TextArea
label="Visiting hours"
placeholder="MonFri 10 AM 2 PM, Sat 10 AM 12 PM"
value={value.visitingHours}
onChange={(v) => patch({ visitingHours: v })}
rows={2}
/>
<div className="grid grid-cols-2 gap-3">
<Input
label="New consult fee (₹)"
type="number"
placeholder="800"
value={value.consultationFeeNew}
onChange={(v) => patch({ consultationFeeNew: v })}
/>
<Input
label="Follow-up fee (₹)"
type="number"
placeholder="500"
value={value.consultationFeeFollowUp}
onChange={(v) => patch({ consultationFeeFollowUp: v })}
/>
</div>
<div className="flex flex-col gap-3">
<p className="text-xs font-semibold uppercase tracking-wider text-quaternary">Contact</p>
<Input
label="Phone"
type="tel"
placeholder="9876543210"
value={value.phone}
onChange={(v) => patch({ phone: v })}
/>
<Input
label="Email"
type="email"
placeholder="doctor@hospital.com"
value={value.email}
onChange={(v) => patch({ email: v })}
/>
<Input
label="Registration number"
placeholder="Medical council reg no."
value={value.registrationNumber}
onChange={(v) => patch({ registrationNumber: v })}
/>
</div>
<div className="flex flex-col gap-2 rounded-lg border border-secondary bg-secondary p-4">
<Toggle
label="Accepting appointments"
isSelected={value.active}
onChange={(checked) => patch({ active: checked })}
/>
<p className="text-xs text-tertiary">
Inactive doctors are hidden from appointment booking and call-desk transfer lists.
</p>
</div>
</div>
);
};

View File

@@ -0,0 +1,143 @@
import { useState } from 'react';
import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
import { faUserPlus, faTrash, faPlus } from '@fortawesome/pro-duotone-svg-icons';
import { Input } from '@/components/base/input/input';
import { Select } from '@/components/base/select/select';
import { Button } from '@/components/base/buttons/button';
// Multi-email invite form. Uses the platform's sendInvitations mutation which
// takes a list of emails; the invited members all get the same role (the
// platform doesn't support per-email roles in a single call). If the admin
// needs different roles, they invite in multiple batches, or edit roles
// afterwards via the team listing.
//
// Role selection is optional — leaving it blank invites members without a
// role, matching the platform's default. When a role is selected, the caller
// is expected to apply it via updateWorkspaceMemberRole after the invited
// member accepts (this form just reports the selected roleId back).
export type RoleOption = {
id: string;
label: string;
supportingText?: string;
};
export type InviteMemberFormValues = {
emails: string[];
roleId: string;
};
const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
type InviteMemberFormProps = {
value: InviteMemberFormValues;
onChange: (value: InviteMemberFormValues) => void;
roles: RoleOption[];
};
export const InviteMemberForm = ({ value, onChange, roles }: InviteMemberFormProps) => {
const [draft, setDraft] = useState('');
const addEmail = (rawValue?: string) => {
const source = (rawValue ?? draft).trim();
if (!source) return;
const trimmed = source.replace(/,+$/, '').trim();
if (!trimmed) return;
if (!EMAIL_REGEX.test(trimmed)) return;
if (value.emails.includes(trimmed)) {
setDraft('');
return;
}
onChange({ ...value, emails: [...value.emails, trimmed] });
setDraft('');
};
const removeEmail = (email: string) => {
onChange({ ...value, emails: value.emails.filter((e) => e !== email) });
};
// The Input component wraps react-aria TextField which doesn't expose
// onKeyDown via its typed props — so we commit on comma via the onChange
// handler instead. Users can also press the Add button or tab onto it.
const handleChange = (next: string) => {
if (next.endsWith(',')) {
addEmail(next);
return;
}
setDraft(next);
};
return (
<div className="flex flex-col gap-4">
<div className="flex flex-col gap-2">
<label className="text-sm font-medium text-secondary">
Emails <span className="text-error-primary">*</span>
</label>
<div className="flex items-center gap-2">
<div className="flex-1">
<Input
placeholder="colleague@hospital.com"
type="email"
value={draft}
onChange={handleChange}
/>
</div>
<Button
size="sm"
color="secondary"
iconLeading={({ className }: { className?: string }) => (
<FontAwesomeIcon icon={faPlus} className={className} />
)}
onClick={() => addEmail()}
isDisabled={!draft.trim() || !EMAIL_REGEX.test(draft.trim())}
>
Add
</Button>
</div>
<p className="text-xs text-tertiary">
Type a comma to add multiple emails, or click Add.
</p>
</div>
{value.emails.length > 0 && (
<div className="flex flex-col gap-2 rounded-lg border border-secondary bg-secondary p-3">
<p className="text-xs font-semibold uppercase tracking-wider text-quaternary">
{value.emails.length} invitee{value.emails.length === 1 ? '' : 's'}
</p>
<ul className="flex flex-col gap-1.5">
{value.emails.map((email) => (
<li
key={email}
className="flex items-center justify-between rounded-md bg-primary px-3 py-2 text-sm"
>
<span className="flex items-center gap-2 text-primary">
<FontAwesomeIcon icon={faUserPlus} className="size-3.5 text-fg-brand-primary" />
{email}
</span>
<button
type="button"
onClick={() => removeEmail(email)}
className="flex size-6 items-center justify-center rounded-md text-fg-quaternary hover:bg-secondary_hover hover:text-fg-error-primary"
title="Remove"
>
<FontAwesomeIcon icon={faTrash} className="size-3" />
</button>
</li>
))}
</ul>
</div>
)}
<Select
label="Role"
placeholder={roles.length === 0 ? 'No roles available' : 'Assign a role'}
isDisabled={roles.length === 0}
items={roles}
selectedKey={value.roleId || null}
onSelectionChange={(key) => onChange({ ...value, roleId: (key as string) || '' })}
>
{(item) => <Select.Item id={item.id} label={item.label} supportingText={item.supportingText} />}
</Select>
</div>
);
};