feat(onboarding/phase-6): setup wizard polish, seed script alignment, doctor visit slots

- Setup wizard: 3-pane layout with right-side live previews, resume
  banner, edit/copy icons on team step, AI prompt configuration
- Forms: employee-create replaces invite-member (no email invites),
  clinic form with address/hours/payment, doctor form with visit slots
- Seed script: aligned to current SDK schema — doctors created as
  workspace members (HelixEngage Manager role), visitingHours replaced
  by doctorVisitSlot entity, clinics seeded, portalUserId linked
  dynamically, SUB/ORIGIN/GQL configurable via env vars
- Pages: clinics + doctors CRUD updated for new schema, team settings
  with temp password + role assignment
- New components: time-picker, day-selector, wizard-right-panes,
  wizard-layout-context, resume-setup-banner
- Removed: invite-member-form (replaced by employee-create-form per
  no-email-invites rule)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-10 08:37:34 +05:30
parent efe67dc28b
commit f57fbc1f24
25 changed files with 3461 additions and 706 deletions

View File

@@ -1,14 +1,20 @@
import { FontAwesomeIcon } from '@fortawesome/react-fontawesome';
import { faPlus, faTrash } from '@fortawesome/pro-duotone-svg-icons';
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';
import { Button } from '@/components/base/buttons/button';
import { TimePicker } from '@/components/application/date-picker/time-picker';
// 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).
// Doctor form — hospital-wide profile with multi-clinic, multi-day
// visiting schedule. Each row in the "visiting schedule" section maps
// to one DoctorVisitSlot child record. The parent component owns the
// mutation orchestration (create doctor, then create each slot).
//
// Field names mirror the platform's DoctorCreateInput — notably `active`, not
// `isActive`, and `clinicId` for the relation.
// Previously the form had a single `clinicId` dropdown + a free-text
// `visitingHours` textarea. Both dropped — doctors are now hospital-
// wide, and their presence at each clinic is expressed via the
// DoctorVisitSlot records.
export type DoctorDepartment =
| 'CARDIOLOGY'
@@ -20,6 +26,27 @@ export type DoctorDepartment =
| 'PEDIATRICS'
| 'ONCOLOGY';
// Matches the DoctorVisitSlot.dayOfWeek SELECT enum on the SDK entity.
export type DayOfWeek =
| 'MONDAY'
| 'TUESDAY'
| 'WEDNESDAY'
| 'THURSDAY'
| 'FRIDAY'
| 'SATURDAY'
| 'SUNDAY';
export type DoctorVisitSlotEntry = {
// Populated on existing records when editing; undefined for
// freshly-added rows. Used by the parent to decide create vs
// update vs delete on save.
id?: string;
clinicId: string;
dayOfWeek: DayOfWeek | '';
startTime: string | null;
endTime: string | null;
};
export type DoctorFormValues = {
firstName: string;
lastName: string;
@@ -27,14 +54,14 @@ export type DoctorFormValues = {
specialty: string;
qualifications: string;
yearsOfExperience: string;
clinicId: string;
visitingHours: string;
consultationFeeNew: string;
consultationFeeFollowUp: string;
phone: string;
email: string;
registrationNumber: string;
active: boolean;
// Multi-clinic, multi-day visiting schedule. One entry per slot.
visitSlots: DoctorVisitSlotEntry[];
};
export const emptyDoctorFormValues = (): DoctorFormValues => ({
@@ -44,14 +71,13 @@ export const emptyDoctorFormValues = (): DoctorFormValues => ({
specialty: '',
qualifications: '',
yearsOfExperience: '',
clinicId: '',
visitingHours: '',
consultationFeeNew: '',
consultationFeeFollowUp: '',
phone: '',
email: '',
registrationNumber: '',
active: true,
visitSlots: [],
});
const DEPARTMENT_ITEMS: { id: DoctorDepartment; label: string }[] = [
@@ -65,10 +91,20 @@ const DEPARTMENT_ITEMS: { id: DoctorDepartment; label: string }[] = [
{ 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 DAY_ITEMS: { id: DayOfWeek; label: string }[] = [
{ id: 'MONDAY', label: 'Monday' },
{ id: 'TUESDAY', label: 'Tuesday' },
{ id: 'WEDNESDAY', label: 'Wednesday' },
{ id: 'THURSDAY', label: 'Thursday' },
{ id: 'FRIDAY', label: 'Friday' },
{ id: 'SATURDAY', label: 'Saturday' },
{ id: 'SUNDAY', label: 'Sunday' },
];
// Build the createDoctor / updateDoctor mutation payload. Visit slots
// are persisted via a separate mutation chain — see the parent
// component's handleSave.
export const doctorCoreToGraphQLInput = (v: DoctorFormValues): Record<string, unknown> => {
const input: Record<string, unknown> = {
fullName: {
firstName: v.firstName.trim(),
@@ -84,8 +120,6 @@ export const doctorFormToGraphQLInput = (v: DoctorFormValues): Record<string, un
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)) {
@@ -123,6 +157,23 @@ export const doctorFormToGraphQLInput = (v: DoctorFormValues): Record<string, un
return input;
};
// Build one DoctorVisitSlotCreateInput per complete slot. Drops any
// half-filled rows silently — the form can't validate mid-entry
// without blocking the user.
export const visitSlotInputsFromForm = (
v: DoctorFormValues,
doctorId: string,
): Array<Record<string, unknown>> =>
v.visitSlots
.filter((s) => s.clinicId && s.dayOfWeek && s.startTime && s.endTime)
.map((s) => ({
doctorId,
clinicId: s.clinicId,
dayOfWeek: s.dayOfWeek,
startTime: s.startTime,
endTime: s.endTime,
}));
type ClinicOption = { id: string; label: string };
type DoctorFormProps = {
@@ -134,6 +185,26 @@ type DoctorFormProps = {
export const DoctorForm = ({ value, onChange, clinics }: DoctorFormProps) => {
const patch = (updates: Partial<DoctorFormValues>) => onChange({ ...value, ...updates });
// Visit-slot handlers — add/edit/remove inline inside the form.
const addSlot = () => {
patch({
visitSlots: [
...value.visitSlots,
{ clinicId: clinics[0]?.id ?? '', dayOfWeek: '', startTime: '09:00', endTime: '13:00' },
],
});
};
const updateSlot = (index: number, updates: Partial<DoctorVisitSlotEntry>) => {
const next = [...value.visitSlots];
next[index] = { ...next[index], ...updates };
patch({ visitSlots: next });
};
const removeSlot = (index: number) => {
patch({ visitSlots: value.visitSlots.filter((_, i) => i !== index) });
};
return (
<div className="flex flex-col gap-4">
<div className="grid grid-cols-2 gap-3">
@@ -185,24 +256,94 @@ export const DoctorForm = ({ value, onChange, clinics }: DoctorFormProps) => {
/>
</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}
/>
{/* Visiting schedule — one row per clinic/day slot */}
<div className="flex flex-col gap-3">
<p className="text-xs font-semibold uppercase tracking-wider text-quaternary">
Visiting schedule
</p>
{clinics.length === 0 ? (
<div className="rounded-lg border border-dashed border-warning bg-warning-primary p-4">
<p className="text-sm font-semibold text-warning-primary">Add a clinic first</p>
<p className="mt-1 text-xs text-tertiary">
You need at least one clinic before you can schedule doctor visits.
</p>
</div>
) : (
<>
{value.visitSlots.length === 0 && (
<p className="text-xs text-tertiary">
No visit slots. Add rows for each clinic + day this doctor visits.
</p>
)}
{value.visitSlots.map((slot, idx) => (
<div
key={idx}
className="flex flex-col gap-3 rounded-lg border border-secondary bg-secondary p-3"
>
<div className="grid grid-cols-2 gap-3">
<Select
label="Clinic"
placeholder="Select clinic"
items={clinics}
selectedKey={slot.clinicId || null}
onSelectionChange={(key) =>
updateSlot(idx, { clinicId: (key as string) || '' })
}
>
{(item) => <Select.Item id={item.id} label={item.label} />}
</Select>
<Select
label="Day"
placeholder="Select day"
items={DAY_ITEMS}
selectedKey={slot.dayOfWeek || null}
onSelectionChange={(key) =>
updateSlot(idx, { dayOfWeek: (key as DayOfWeek) || '' })
}
>
{(item) => <Select.Item id={item.id} label={item.label} />}
</Select>
</div>
<div className="grid grid-cols-2 gap-3">
<TimePicker
label="Start time"
value={slot.startTime}
onChange={(startTime) => updateSlot(idx, { startTime })}
/>
<TimePicker
label="End time"
value={slot.endTime}
onChange={(endTime) => updateSlot(idx, { endTime })}
/>
</div>
<div className="flex justify-end">
<Button
size="sm"
color="tertiary-destructive"
iconLeading={({ className }: { className?: string }) => (
<FontAwesomeIcon icon={faTrash} className={className} />
)}
onClick={() => removeSlot(idx)}
>
Remove slot
</Button>
</div>
</div>
))}
<Button
size="sm"
color="secondary"
iconLeading={({ className }: { className?: string }) => (
<FontAwesomeIcon icon={faPlus} className={className} />
)}
onClick={addSlot}
className="self-start"
>
Add visit slot
</Button>
</>
)}
</div>
<div className="grid grid-cols-2 gap-3">
<Input