# vishnu252007/ai_personalized_assisant architecture

> Architecture diagram of the GitHub repository vishnu252007/ai_personalized_assisant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vishnu252007/ai_personalized_assisant
- Repository: https://github.com/vishnu252007/ai_personalized_assisant

## Overview

LearnAI is presented as an AI-personalized learning product, but the sampled UI currently shows only a static landing page. The visible runtime workflow is a page request passing through session middleware; the other implemented flow exchanges an authentication callback code for a Supabase session. The database types describe learner profiles, topics, conversations, and assessment records, but sampled sources do not show their application-level workflows. AI tutoring and adaptive-learning behavior cannot be mapped from the available evidence.

Main entry points: [`lib/supabase/server.ts`](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/supabase/server.ts) (Server client), [`lib/supabase/client.ts`](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/supabase/client.ts) (Browser client), [`lib/supabase/admin.ts`](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/supabase/admin.ts) (Admin client), [`lib/env.ts`](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/env.ts) (Client env)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and auth"]
  node_middleware["Session middleware<br/>[middleware.ts]"]
  node_home["Landing page<br/>[page.tsx]"]
  node_callback["Auth callback<br/>[route.ts]"]
end

subgraph group_supabase["Supabase access"]
  node_server_client["Server client<br/>[server.ts]"]
  node_browser_client["Browser client<br/>[client.ts]"]
  node_admin_client["Admin client<br/>[admin.ts]"]
end

subgraph group_config["Configuration and schema"]
  node_client_env["Client env<br/>[env.ts]"]
  node_server_env["Server env<br/>[env.server.ts]"]
  node_db_types["Database types<br/>[database.ts]"]
  node_data_model[("Learning data model")]
end

node_learner(("Learner"))
node_supabase[("Supabase")]

node_learner -->|"sends request"| node_middleware
node_learner -->|"views"| node_home
node_middleware -->|"checks session"| node_supabase
node_callback -->|"creates client"| node_server_client
node_server_client -->|"accesses"| node_supabase
node_browser_client -->|"accesses"| node_supabase
node_admin_client -->|"accesses"| node_supabase
node_server_client -->|"reads config"| node_client_env
node_browser_client -->|"reads config"| node_client_env
node_admin_client -->|"reads config"| node_server_env
node_server_env -->|"extends schema"| node_client_env
node_server_client -->|"types client"| node_db_types
node_browser_client -->|"types client"| node_db_types
node_admin_client -->|"types client"| node_db_types

click node_middleware "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/middleware.ts"
click node_home "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/app/page.tsx"
click node_callback "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/app/auth/callback/route.ts"
click node_server_client "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/supabase/server.ts"
click node_browser_client "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/supabase/client.ts"
click node_admin_client "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/supabase/admin.ts"
click node_client_env "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/env.ts"
click node_server_env "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/env.server.ts"
click node_db_types "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/types/database.ts"
click node_data_model "https://github.com/vishnu252007/ai_personalized_assisant/blob/main/supabase/migrations/001_initial_schema.sql"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_middleware,node_home,node_callback toneBlue
class node_server_client,node_browser_client,node_admin_client,node_supabase toneAmber
class node_client_env,node_server_env,node_db_types,node_data_model toneMint
class node_learner toneIndigo
```

## Components

### Web and auth

- [Session middleware](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/middleware.ts): `middleware.ts`
- [Landing page](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/app/page.tsx): `app/page.tsx`
- [Auth callback](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/app/auth/callback/route.ts): `app/auth/callback/route.ts`

### Supabase access

- [Server client](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`
- [Browser client](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/supabase/client.ts): `lib/supabase/client.ts`
- [Admin client](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/supabase/admin.ts): `lib/supabase/admin.ts`

### Configuration and schema

- [Client env](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/env.ts): `lib/env.ts`
- [Server env](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/lib/env.server.ts): `lib/env.server.ts`
- [Database types](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/types/database.ts): `types/database.ts`
- [Learning data model](https://github.com/vishnu252007/ai_personalized_assisant/blob/main/supabase/migrations/001_initial_schema.sql): `supabase/migrations/001_initial_schema.sql`

### Other components

- **Learner**
- **Supabase**

## Connections

- Learner → Session middleware: sends request (evidence: `middleware.ts`)
- Learner → Landing page: views (evidence: `app/page.tsx`)
- Session middleware → Supabase: checks session (evidence: `middleware.ts`)
- Auth callback → Server client: creates client (evidence: `app/auth/callback/route.ts`)
- Server client → Supabase: accesses (evidence: `lib/supabase/server.ts`)
- Browser client → Supabase: accesses (evidence: `lib/supabase/client.ts`)
- Admin client → Supabase: accesses (evidence: `lib/supabase/admin.ts`)
- Server client → Client env: reads config (evidence: `lib/supabase/server.ts`)
- Browser client → Client env: reads config (evidence: `lib/supabase/client.ts`)
- Admin client → Server env: reads config (evidence: `lib/supabase/admin.ts`)
- Server env → Client env: extends schema (evidence: `lib/env.server.ts`)
- Server client → Database types: types client (evidence: `lib/supabase/server.ts`)
- Browser client → Database types: types client (evidence: `lib/supabase/client.ts`)
- Admin client → Database types: types client (evidence: `lib/supabase/admin.ts`)
