mirror of https://github.com/temetro/temetro.git synced 2026-08-12 03:26:53 +00:00

Files

T

Claude c57206bcf3 Sign-up goes straight to onboarding; refresh CLAUDE.md

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>

2026-06-02 21:56:06 +03:00

6.6 KiB

Raw Blame History

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

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.

6.6 KiB Raw Blame History Unescape Escape