cryptotweezer/pitsypet

Purpose and Runtime

This is a Next.js App Router application for pet-health management: authenticated users manage pet records, medications, symptoms, appointments, veterinary contacts, and AI-assisted health assessments. It runs as a TypeScript web application with server-rendered routes, client components, and route-handler APIs.

• src/app/layout.tsx

• src/app/page.tsx

• src/middleware.ts

Route Domains and User Entry Points

The public landing page leads into separate authenticated application and dashboard route groups. Pet-centric workflows use slugged pet URLs and assessment IDs/sequences; account, billing, clinic, history, and appointment views live under the dashboard.

• src/app/(app)/pets/[slug]/page.tsx

• src/app/(app)/assessment/[id]/page.tsx

• src/app/(dashboard)/dashboard/page.tsx

Identity, Authorization, and Data Boundary

Supabase is the primary backend boundary for authentication and Postgres persistence. Middleware and server/client/admin Supabase adapters establish request-specific access; migrations define profiles, pets, assessments, medical records, vector knowledge, search, and row-level-security policies.

• src/lib/supabase/middleware.ts

• src/lib/supabase/server.ts

• supabase/migrations/20260619001200_rls_policies.sql

Pet Medical Record Lifecycle

The pet API is the core record-management surface: it owns pet CRUD, soft-delete/restore/purge operations, and nested appointment, medication, and active-symptom resources. UI forms and sections consume this domain, while validation modules define request boundaries.

• src/app/api/pets/[id]/route.ts

• src/app/api/pets/[id]/symptoms/reconcile/route.ts

• src/components/pets/pet-form.tsx

Assessment and AI Triage Pipeline

Assessment routes orchestrate conversational symptom collection, classification/safety controls, retrieval-augmented veterinary knowledge, formatting, and fallback behavior. Results are persisted/displayed as clinical reasoning, risk, recommendations, and emergency guidance; assessment output can be exported for veterinary use.

• src/app/api/assessment/chat/route.ts

• src/lib/ai/rag.ts

• src/components/assessment/results/results-view.tsx

Knowledge Retrieval and Safety Controls

The AI layer is explicitly decomposed into schemas, classification, embeddings, RAG, safety, cost controls, and fallback handling. Supabase migrations provide veterinary knowledge, first-aid/emergency content, vector search, and audit support; these form the grounding boundary rather than treating model output as standalone advice.

• src/lib/ai/safety.ts

• src/lib/ai/embed.ts

• supabase/migrations/20260619001000_vector_search_function.sql

External Services and Operational Integrations

Stripe supports subscription checkout, billing portal access, and webhook-driven billing state. PostHog provides client analytics; Sentry instrumentation supports error monitoring; Arcjet/rate-limit utilities indicate request protection. Assessment export produces a vet-oriented document/summary.

• src/app/api/billing/webhook/route.ts

• src/lib/stripe.ts

• src/instrumentation.ts