mirror of
https://github.com/temetro/temetro.git
synced 2026-08-19 14:46:29 +00:00
Claude
c57206bcf3
Email verification is no longer enforced (see backend), and sign-up now auto-signs-in, so route to clinic onboarding instead of /verify-email. Update CLAUDE.md: the app now talks to ../backend (auth + patient API), route protection via proxy.ts, and build/type-check guidance. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
107 lines
6.6 KiB
Markdown
107 lines
6.6 KiB
Markdown
# CLAUDE.md
|
||
|
||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||
|
||
@AGENTS.md
|
||
|
||
> The import above is load-bearing: this is a **customized Next.js 16** with breaking changes vs.
|
||
> public docs. Before writing any Next.js code (routing, metadata, `next/image`, `next/font`,
|
||
> route handlers, config), read the relevant guide under `node_modules/next/dist/docs/01-app/`.
|
||
|
||
## What this is
|
||
|
||
`temetro` — an **open-source** clinical "AI middleman" (see the project vision in the root
|
||
`../CLAUDE.md`). This app is the clinician-facing chat UI. It is now **wired to the real
|
||
`../backend/`** for authentication and patient data (no longer a standalone UI-only demo); the AI
|
||
chat replies are **still mocked** (no LLM call yet).
|
||
|
||
- The chat parses `/patient <file#>` (or a bare `/<file#>`) in `components/chat/chat-panel.tsx` and
|
||
renders the record as a horizontal row of cards (`components/chat/patient-cards.tsx`), with small
|
||
dependency-free trend sparklines (`components/chat/sparkline.tsx`). Each card opens a detail
|
||
dialog; the Summary card has an **Edit record** button.
|
||
- Patients can be **created and edited** via the shared `components/chat/patient-form-dialog.tsx`
|
||
(mode `create` | `edit`). The "Add patient" pill in `chat-input.tsx` opens it.
|
||
- Non-command messages still get a mock assistant reply.
|
||
|
||
### Auth & data (talks to `../backend`)
|
||
|
||
- **`lib/patients.ts`** keeps the canonical `Patient` types but its data functions (`getPatient`,
|
||
`listPatients`, `createPatient`, `updatePatient`) now call the backend via **`lib/api-client.ts`**
|
||
(`fetch` with `credentials: "include"`; 401 → `/login`). The old in-memory fixture is gone.
|
||
- **`lib/auth-client.ts`** — Better Auth React client (`useSession`, `signIn/up/out`,
|
||
`organization.*`, `useActiveOrganization`, `useListOrganizations`). Base URL from
|
||
`NEXT_PUBLIC_API_URL` (default `http://localhost:4000`); it appends `/api/auth`. **`lib/access.ts`**
|
||
mirrors the backend's RBAC roles for the org client.
|
||
- **`app/(auth)/`** — designed auth pages (login, signup, verify-email, forgot/reset-password,
|
||
onboarding = create clinic, accept-invite), in their own chrome-less layout.
|
||
- **Route protection:** this Next renames `middleware` → **`proxy.ts`** (root) — an optimistic
|
||
redirect to `/login` when no session cookie. The authoritative gate is client-side:
|
||
`components/auth/app-auth-guard.tsx` (wrapping `app/(app)/layout.tsx`) requires a session **and**
|
||
an active clinic, else redirects to `/login` / `/onboarding`.
|
||
- **Clinics (organizations):** `components/sidebar-02/team-switcher.tsx` is now the `OrgSwitcher`;
|
||
`components/settings/settings-care-team.tsx` manages members + invitations.
|
||
- `.env.local` / `.env.example` hold `NEXT_PUBLIC_API_URL`.
|
||
|
||
The signing / patient-owned-storage / approval features from the root vision are **still not built**.
|
||
|
||
## Commands
|
||
|
||
```bash
|
||
npm run dev # Next dev server (Turbopack) on http://localhost:3000
|
||
npm run build # production build (runs a full TypeScript typecheck — see caveat below)
|
||
npm run start # serve the production build
|
||
npm run lint # eslint (eslint-config-next: core-web-vitals + typescript)
|
||
```
|
||
|
||
There is **no test runner** configured (no `test` script, no vitest/jest/playwright). Don't invent
|
||
test commands; verify changes by running the dev server.
|
||
|
||
**Version control:** this folder is its own git repo. Commit after every change
|
||
(`git -C . add -A && git commit`), with the `Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>`
|
||
trailer. See the root `../CLAUDE.md` for the project-wide per-folder commit policy.
|
||
|
||
## Architecture
|
||
|
||
- **Stack:** Next.js 16.2.6 (App Router) · React 19 · TypeScript · Tailwind CSS **v4**. Path alias
|
||
`@/*` → repo root (`tsconfig.json`). `cn()` (clsx + tailwind-merge) lives in `lib/utils.ts`.
|
||
- **`app/`** — App Router. `app/page.tsx` is the product chat page (sidebar + chat panel);
|
||
`app/layout.tsx` **forces dark mode** by putting `dark` on `<html>` and loads the fonts.
|
||
- **`components/ui/`** — shadcn components, but built on **Base UI (`@base-ui/react`), not Radix.**
|
||
APIs differ: composition uses the `render` prop and `useRender`/`mergeProps`, not `asChild`.
|
||
Match existing files when adding/editing primitives. Config in `components.json` (style
|
||
`base-luma`, baseColor `neutral`).
|
||
- **`components/ai-elements/`** — a large AI-chat primitive library (`PromptInput`, `Conversation`,
|
||
`Message`, `Suggestion`, etc.) typed against **AI SDK v6** (`ai` package: `UIMessage`,
|
||
`ChatStatus`, `FileUIPart`). Note: `@ai-sdk/react` (`useChat`) is **not installed** — chat state
|
||
is managed with local React state.
|
||
- **`components/sidebar-02/`** — the dashboard sidebar (`SidebarProvider` / `Sidebar` /
|
||
`SidebarInset` from `components/ui/sidebar.tsx`). `app-sidebar.tsx` holds the nav config (New chat
|
||
· Patients · Settings) + notifications; `team-switcher.tsx` exists but is no longer used.
|
||
- **`components/chat/`** — the product chat UI. `chat-panel.tsx` owns message state + empty/active
|
||
layouts; `chat-input.tsx` is a bespoke (non–ai-elements) input matching a specific design.
|
||
|
||
## Theming
|
||
|
||
Tailwind v4 with `@theme inline` and **oklch CSS variables** in `app/globals.css` (a
|
||
Linear-inspired dark palette; `--primary` is indigo `#5e6ad2`). The app is dark-only. The radius
|
||
scale (`rounded-2xl` … `rounded-4xl`) is derived from `--radius`, so those utilities are larger than
|
||
stock Tailwind.
|
||
|
||
## Gotchas
|
||
|
||
- **Route protection lives in `proxy.ts`, not `middleware.ts`** — this customized Next renamed the
|
||
convention (`export function proxy(request)` + `config.matcher`, Node runtime). See
|
||
`node_modules/next/dist/docs/01-app/.../proxy.md`.
|
||
- `components/ai-elements/*` has **pre-existing type/lint errors** (Base UI drift) that used to fail
|
||
`next build`. `next.config.ts` now sets `output: "standalone"` plus
|
||
`typescript.ignoreBuildErrors` / `eslint.ignoreDuringBuilds` so production/Docker builds succeed —
|
||
**type-check app code with `npx tsc --noEmit`** (filter out `components/ai-elements/`), not via
|
||
`next build`. There's a `Dockerfile` for the standalone build.
|
||
- **`lucide-react@1.17` dropped brand glyphs** (e.g. `Github`, `Discord`) — import them and you get
|
||
a build error. Use inline SVGs instead.
|
||
- **`lucide-react@1.17` dropped brand glyphs** (e.g. `Github`, `Discord`) — import them and you get
|
||
a build error. Use inline SVGs instead.
|
||
- A sibling **`../landing-page/`** directory is a copy of this app with a marketing landing page
|
||
(`components/landing/`); it is a separate project, not part of this git repo.
|
||
- Multiple lockfiles in the tree produce a harmless Turbopack "inferred workspace root" warning.
|