Files
baya-monorepo/dev
hamid 17a82832ab frontend phase 1: auth — phone-OTP login, role routing & session refresh
Replace the username/password stub with Balinyaar's real credential (phone-OTP)
and add the role router every authenticated screen sits behind.

- services/auth rewritten for OTP over the b2 contract: types/keys/constants,
  clientApi+mockApi behind a config'd seam, hooks (useRequestOtp/useVerifyOtp/
  useMe/useRefresh/useLogout/useSelectRole/useSessionRoleSync). Stub removed.
- A1/A2 customer login + B1/B2 nurse switch as one OTP flow at /login
  (PhoneStep/OtpStep: auto-verify, resend countdown, wrong/expired/lockout states).
- Role router: pure resolveRoleDestination + RoleRouter -> family / nurse /
  admin / select-role, with a splash while /me loads (no wrong-shell flash).
- SelectRole first-use screen at /select-role.
- Widened AuthState (roles via SessionUser), hydrated from /me by useSessionRoleSync.
- Fetch-layer silent token refresh (single-flight + one retry) + shared
  persistAuthTokens/clearAuthTokens; useRefresh as the on-demand path.
- auth i18n namespace in both locales; tests for routing branches, countdown,
  OtpStep state machine, RoleRouter branches; fixed jest @/ -> src alias.
- Docs: client/CLAUDE.md, frontend STATUS/report, for-backend REQ-002..004.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-02 11:58:52 +03:30
..
2026-06-28 21:59:59 +03:30
2026-06-28 21:59:59 +03:30

dev/ — the Balinyaar build workspace

This folder is the plan for building Balinyaar, not application code. It takes the repo from its current starter + auth baseline to the MVP described in product/, as a chain of agent-runnable prompt files split into two parallel tracks.

Folder What it is
phases/ The prompt chain — backend/ (b0b15) and frontend/ (f0f15), plus the shared rules/template in phases/_shared/. Start at phases/README.md.
contracts/ The shared API/flow contract between the two independent projects. Backend writes, frontend reads.
shared-working-context/ The parallel-agent handoff + per-phase reports + the mock registry. Each lane writes only its own files.

How to use it

  1. Read phases/README.md — the roadmap and dependency graph.
  2. To run a phase, point a fresh agent at one phase file (e.g. "Execute dev/phases/backend/backend-phase-2.md"). The phase file tells it what to read, what to build, and how to close out.
  3. Run the two tracks in parallel with two agents if you like: a frontend phase named frontend-phase-N-bM.md only needs backend phase bM merged first; everything else about the two tracks is decoupled through contracts/ and shared-working-context/ (which are designed so the two agents never touch the same files).

Non-negotiables (every phase enforces them)