hamid
4b4243c451
Turns a logged-in user into a usable account, consuming the b3 identity-profiles
contract behind the services/{domain} seam.
Services (mock default true; real HTTP clients wired for a one-line flip):
- services/patients: rewritten to b3 PatientDto + client-augmented relation/conditions;
full CRUD, optimistic soft-archive, cache-splice on create, age<->birthDate helper.
- services/profiles: customer + nurse profile get/upsert + avatar (404->null mapping).
- services/nurse: payout bank accounts + IBAN(Sheba) util + pending-only polling.
Screens: A3->A4 onboarding wizard, E1 patients list/CRUD, A5 home (first-login gate +
nudge), customer profile (no national-ID), nurse profile bootstrap (unverified
placeholder), nurse bank settings (pending/verified/mismatch + make-primary).
Shared composites (each tested): GenderToggle, ConditionChips, RelationSelect,
PatientForm, PatientCard, BankStatusPanel; reuses f0 StepperHeader/StatusChip/PhoneField.
Adds onboarding/home/profile/nurseProfile/bank i18n namespaces (both locales, in sync),
the --bal-primary-soft token, and nurse sidebar Profile + Bank entries.
Contract gaps filed: REQ-005 (patient relation/conditions), REQ-006 (avatar route),
REQ-007 (customer name/language). Gate: check + 112 tests + build all green.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
75 lines
6.0 KiB
Markdown
75 lines
6.0 KiB
Markdown
# Frontend status log (append-only)
|
|
|
|
One block per completed frontend phase. Newest at the top. Frontend lane writes here; backend reads
|
|
for awareness.
|
|
|
|
<!-- TEMPLATE — copy for each phase
|
|
## frontend-phase-N-bM — <Title> — <YYYY-MM-DD>
|
|
- **Shipped:** <screens/flows/services/hooks/components in one or two lines>
|
|
- **Consumes:** dev/contracts/domains/<domain>.md (backend phase bM)
|
|
- **Mocked client-side:** <which services are mocked pending which backend phase>
|
|
- **Gate:** npm run check green / tests green
|
|
- **Requests filed:** frontend/requests/for-backend.md (yes/no)
|
|
-->
|
|
|
|
## frontend-phase-2-b3 — Onboarding & profiles (customer, patient, nurse, bank) — 2026-07-02
|
|
- **Shipped:** three domain services — `services/patients` (rewritten to the b3 `PatientDto` + client-augmented
|
|
`relation`/`conditions`; full CRUD seam + mock + real client; `usePatients`/`useCreatePatient`/
|
|
`useUpdatePatient`/`useArchivePatient` with optimistic soft-archive), `services/profiles` (customer + nurse
|
|
profile get/upsert + avatar; `useCustomerProfile`/`useUpsertCustomerProfile`/`useNurseProfile`/
|
|
`useUpsertNurseProfile`/`useUploadAvatar`), `services/nurse` (bank accounts; `useNurseBankAccounts` with
|
|
pending-only `refetchInterval`, `useAddNurseBankAccount`, `useSetPrimaryBankAccount`; `iban.ts` Sheba
|
|
validate/normalize/bank-name). Screens: **A3→A4 onboarding wizard** (`(customer)/onboarding`), **E1 patients
|
|
list/CRUD** (add/edit dialog reusing the A4 form, soft-archive confirm, empty + skeleton states), **A5 Home**
|
|
(first-login redirect into onboarding when 0 patients + "complete patient record" nudge), **customer profile**
|
|
(name + preferred language + emergency contact, no national-ID), **nurse profile bootstrap** (avatar + bio +
|
|
years, unverified "not bookable" placeholder → verification), **nurse bank settings** (IBAN form + the three
|
|
ownership states pending/verified/mismatch). Shared composites `GenderToggle`/`ConditionChips`/`RelationSelect`/
|
|
`PatientForm`/`PatientCard`/`BankStatusPanel` (each tested); reused the f0 `StepperHeader`/`StatusChip`/
|
|
`PhoneNumberField`. Added `onboarding`/`home`/`profile`/`nurseProfile`/`bank` i18n namespaces + `patients`
|
|
extensions (both locales); `--bal-primary-soft` token (both schemes); nurse sidebar gains Profile + Bank.
|
|
- **Consumes:** dev/contracts/domains/identity-profiles.md (backend-phase-3). Routes `api/v1/{customer_profiles,
|
|
nurse_profiles}/{me,upsert}`, `api/v1/patients/{list,get,create,update,archive}`, `api/v1/nurse_bank_accounts/
|
|
{list,add,set_primary,verify_ownership}`.
|
|
- **Mocked client-side:** `services/patients` (`USE_PATIENTS_MOCK`), `services/profiles` (`USE_PROFILES_MOCK`),
|
|
`services/nurse` (`USE_NURSE_BANK_MOCK`) — all default `true`; real clients wired for a one-line flip. See
|
|
mocks-registry + the report for exactly what/why (relation/conditions, avatar, customer name/language gaps).
|
|
- **Gate:** npm run check green · npm run test:ci green (112 tests, +17) · npm run build green with
|
|
NEXT_PUBLIC_API_URL set (routes /onboarding, /nurse/profile, /nurse/bank generated).
|
|
- **Requests filed:** frontend/requests/for-backend.md — yes (REQ-005 patient relation/conditions, REQ-006 avatar
|
|
upload route, REQ-007 customer name/preferred-language).
|
|
|
|
## frontend-phase-1-b2 — Auth: phone-OTP login & role routing — 2026-07-02
|
|
- **Shipped:** `services/auth` rewritten for phone-OTP (types/keys/apis[client+mock+seam]/hooks:
|
|
`useRequestOtp`/`useVerifyOtp`/`useMe`/`useRefresh`/`useLogout`/`useSelectRole`/`useSessionRoleSync`) —
|
|
the username/password stub is gone; A1/A2 customer login + B1/B2 nurse switch (one OTP flow parameterised
|
|
by intended role) at `/login`; the **role router** (`RoleRouter` + pure `resolveRoleDestination`) →
|
|
customer→family, nurse→nurse app, no-role→`/select-role`, admin→admin console (splash while `/me` loads,
|
|
no wrong-shell flash); `SelectRole` screen at `/select-role`; **silent token refresh** in the fetch layer
|
|
(single-flight `attemptTokenRefresh`, one retry on 401); widened `AuthState` (roles via `SessionUser`,
|
|
hydrated from `/me` by `useSessionRoleSync` in the private layout); `auth` i18n namespace + `common.brand*`
|
|
in both locales.
|
|
- **Consumes:** dev/contracts/domains/identity-auth.md + openapi/swagger.v1.json (backend-phase-2). Wire is
|
|
**camelCase**; routes `api/v1/auth/{request_otp,verify_otp,refresh,logout}`, `api/v1/me`, `api/v1/me/select_role`.
|
|
- **Mocked client-side:** `services/auth` via `authMockApi` behind `USE_AUTH_MOCK` (**default false** — b2 is
|
|
live; flip true for offline dev, dev code `123456`). See mocks-registry.
|
|
- **Gate:** npm run check green · npm run test:ci green (95 tests, +23) · npm run build green with
|
|
NEXT_PUBLIC_API_URL set. Fixed the jest `@/`→`src` alias (was `<rootDir>/$1`).
|
|
- **Requests filed:** frontend/requests/for-backend.md — yes (REQ-002 OTP length/expiry, REQ-003 verify
|
|
error codes + lockout retry-after, REQ-004 multi-role `activeRole?`).
|
|
|
|
## frontend-phase-0 — Foundations: app shells, design system & data/contract patterns — 2026-07-02
|
|
- **Shipped:** 3 actor shells (customer bottom-nav / nurse / admin sidebar) + role-aware routing under
|
|
`(private-routes)`; `useActorRole`; the `services/{domain}` reference (`patients`, mocked behind a
|
|
seam) with deliberate Query caching + invalidation; `lib/api/types.ts` (envelope/pagination); money +
|
|
Shamsi-date utils; shared composites `OtpInput`/`PhoneNumberField`/`StepperHeader`/`StatusChip`/
|
|
`PlaceholderScreen` (each tested); i18n `nav`/`common`/`shell`/`patients` in both locales. Removed the
|
|
demo scaffolding; fixed the `BottomBar` pathname bug.
|
|
- **Consumes:** dev/contracts/conventions/* + openapi/swagger.v1.json (b0 = ping only). No feature
|
|
contract consumed yet.
|
|
- **Mocked client-side:** `services/patients` via `patientsMockApi` (USE_PATIENTS_MOCK=true) — template
|
|
for f1+. Swap is one line once real endpoints land.
|
|
- **Gate:** npm run check green · npm run test:ci green (72 tests) · npm run build green with
|
|
NEXT_PUBLIC_API_URL set.
|
|
- **Requests filed:** frontend/requests/for-backend.md — yes (REQ-001).
|