# kian-007/practice_vercel architecture

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

- Interactive diagram: https://gitdiagram.com/kian-007/practice_vercel
- Repository: https://github.com/kian-007/practice_vercel

## Overview

Practice is a web app for account management, URL handling, device sessions, and real-time chat/presence. Users enter through the React client, which checks login state and makes cookie-authenticated API requests; the Express routes handle domain operations, backed by PostgreSQL and Redis, while WebSocket connections provide live presence and messaging. The map preserves the major route and page areas named in the source index. Some route implementations and client pages were not excerpted, so their internal links are omitted where evidence is insufficient.

Main entry points: [`practice-backend/app.js`](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/app.js) (Express app), [`practice/src/App.jsx`](https://github.com/kian-007/practice_vercel/blob/main/practice/src/App.jsx) (React app), [`practice-backend/routes/auth.js`](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/auth.js) (Auth routes), [`practice/src/api.jsx`](https://github.com/kian-007/practice_vercel/blob/main/practice/src/api.jsx) (Authenticated API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["React app<br/>[App.jsx]"]
  node_api["Authenticated API<br/>[api.jsx]"]
  node_layout["Shared layout<br/>[layots.jsx]"]
end

subgraph group_identity["Identity and sessions"]
  node_authctx["Auth state<br/>[authContext.jsx]"]
  node_account_pages["Account pages"]
  node_session_ui["Session manager<br/>[sessions.jsx]"]
  node_auth_routes["Auth routes<br/>[auth.js]"]
  node_session_routes["Session routes<br/>[sessions.js]"]
  node_user_routes["User routes<br/>[user.js]"]
  node_auth_middleware["Auth middleware<br/>[auth.js]"]
  node_rate_limit["Rate limiting<br/>[rateLimiter.js]"]
  node_email["Reset email<br/>[email.js]"]
end

subgraph group_domain["API domain"]
  node_dashboard["Dashboard<br/>[dashboard.jsx]"]
  node_url_ui["URL manager<br/>[urls.jsx]"]
  node_api_server["Express app<br/>[app.js]"]
  node_url_routes["URL routes<br/>[urls.js]"]
  node_admin_routes["Admin routes<br/>[admin.js]"]
  node_async_handler["Async wrapper<br/>[asyncHandler.js]"]
end

subgraph group_realtime["Realtime"]
  node_chat_ui["Chat page<br/>[chat.jsx]"]
  node_message_routes["Message routes<br/>[messages.js]"]
  node_ws_context["Socket client<br/>[socketContext.jsx]"]
  node_websocket["WebSocket service<br/>[websocket.js]"]
end

subgraph group_data["Persistence"]
  node_db_config["Postgres access<br/>[db.js]"]
  node_postgres[("PostgreSQL")]
  node_redis_config["Redis access<br/>[redis.js]"]
end

node_visitor(("User"))
node_mail_service["Email provider"]

node_visitor -->|"uses"| node_app
node_app -->|"provides auth"| node_authctx
node_app -->|"provides sockets"| node_ws_context
node_app -->|"renders routes"| node_layout
node_app -->|"routes to"| node_account_pages
node_authctx -->|"checks identity"| node_api
node_account_pages -->|"updates login"| node_authctx
node_dashboard -->|"renders"| node_url_ui
node_dashboard -->|"renders"| node_session_ui
node_url_ui -->|"requests URLs"| node_api
node_session_ui -->|"requests sessions"| node_api
node_chat_ui -->|"loads messages"| node_api
node_chat_ui -->|"uses events"| node_ws_context
node_api -.->|"sends HTTP"| node_api_server
node_api_server -->|"mounts routes"| node_auth_routes
node_api_server -->|"mounts routes"| node_user_routes
node_api_server -->|"mounts routes"| node_session_routes
node_api_server -->|"mounts routes"| node_admin_routes
node_api_server -->|"mounts routes"| node_url_routes
node_api_server -->|"mounts routes"| node_message_routes
node_auth_routes -->|"queries users"| node_db_config
node_session_routes -->|"queries sessions"| node_db_config
node_url_routes -->|"accesses data"| node_db_config
node_admin_routes -->|"queries data"| node_db_config
node_user_routes -->|"requires auth"| node_auth_middleware
node_auth_routes -->|"requires auth"| node_auth_middleware
node_session_routes -->|"requires auth"| node_auth_middleware
node_auth_routes -->|"limits requests"| node_rate_limit
node_auth_routes -->|"sends reset"| node_email
node_email -.->|"delivers email"| node_mail_service
node_ws_context -.->|"opens socket"| node_websocket
node_message_routes -->|"uses sockets"| node_websocket
node_db_config -->|"connects to"| node_postgres

click node_app "https://github.com/kian-007/practice_vercel/blob/main/practice/src/App.jsx"
click node_authctx "https://github.com/kian-007/practice_vercel/blob/main/practice/src/authContext.jsx"
click node_api "https://github.com/kian-007/practice_vercel/blob/main/practice/src/api.jsx"
click node_account_pages "https://github.com/kian-007/practice_vercel/tree/main/practice/src/pages"
click node_dashboard "https://github.com/kian-007/practice_vercel/blob/main/practice/src/pages/dashboard/dashboard.jsx"
click node_url_ui "https://github.com/kian-007/practice_vercel/blob/main/practice/src/components/urls/urls.jsx"
click node_session_ui "https://github.com/kian-007/practice_vercel/blob/main/practice/src/components/sessions/sessions.jsx"
click node_chat_ui "https://github.com/kian-007/practice_vercel/blob/main/practice/src/pages/chat/chat.jsx"
click node_layout "https://github.com/kian-007/practice_vercel/blob/main/practice/src/components/layots/layots.jsx"
click node_api_server "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/app.js"
click node_auth_routes "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/auth.js"
click node_session_routes "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/sessions.js"
click node_url_routes "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/urls.js"
click node_user_routes "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/user.js"
click node_admin_routes "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/admin.js"
click node_message_routes "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/messages.js"
click node_auth_middleware "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/middleware/auth.js"
click node_rate_limit "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/middleware/rateLimiter.js"
click node_async_handler "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/middleware/asyncHandler.js"
click node_ws_context "https://github.com/kian-007/practice_vercel/blob/main/practice/src/socketContext.jsx"
click node_websocket "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/websocket.js"
click node_db_config "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/config/db.js"
click node_redis_config "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/config/redis.js"
click node_email "https://github.com/kian-007/practice_vercel/blob/main/practice-backend/email.js"

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_app,node_api,node_layout,node_visitor toneBlue
class node_authctx,node_account_pages,node_session_ui,node_auth_routes,node_session_routes,node_user_routes,node_auth_middleware,node_rate_limit,node_email toneAmber
class node_dashboard,node_url_ui,node_api_server,node_url_routes,node_admin_routes,node_async_handler toneMint
class node_chat_ui,node_message_routes,node_ws_context,node_websocket toneRose
class node_db_config,node_postgres,node_redis_config,node_mail_service toneIndigo
```

## Components

### Web client

- [React app](https://github.com/kian-007/practice_vercel/blob/main/practice/src/App.jsx): `practice/src/App.jsx`
- [Authenticated API](https://github.com/kian-007/practice_vercel/blob/main/practice/src/api.jsx): `practice/src/api.jsx`
- [Shared layout](https://github.com/kian-007/practice_vercel/blob/main/practice/src/components/layots/layots.jsx): `practice/src/components/layots/layots.jsx`

### Identity and sessions

- [Auth state](https://github.com/kian-007/practice_vercel/blob/main/practice/src/authContext.jsx): `practice/src/authContext.jsx`
- [Account pages](https://github.com/kian-007/practice_vercel/tree/main/practice/src/pages): `practice/src/pages`
- [Session manager](https://github.com/kian-007/practice_vercel/blob/main/practice/src/components/sessions/sessions.jsx): `practice/src/components/sessions/sessions.jsx`
- [Auth routes](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/auth.js): `practice-backend/routes/auth.js`
- [Session routes](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/sessions.js): `practice-backend/routes/sessions.js`
- [User routes](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/user.js): `practice-backend/routes/user.js`
- [Auth middleware](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/middleware/auth.js): `practice-backend/middleware/auth.js`
- [Rate limiting](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/middleware/rateLimiter.js): `practice-backend/middleware/rateLimiter.js`
- [Reset email](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/email.js): `practice-backend/email.js`

### API domain

- [Dashboard](https://github.com/kian-007/practice_vercel/blob/main/practice/src/pages/dashboard/dashboard.jsx): `practice/src/pages/dashboard/dashboard.jsx`
- [URL manager](https://github.com/kian-007/practice_vercel/blob/main/practice/src/components/urls/urls.jsx): `practice/src/components/urls/urls.jsx`
- [Express app](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/app.js): `practice-backend/app.js`
- [URL routes](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/urls.js): `practice-backend/routes/urls.js`
- [Admin routes](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/admin.js): `practice-backend/routes/admin.js`
- [Async wrapper](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/middleware/asyncHandler.js): `practice-backend/middleware/asyncHandler.js`

### Realtime

- [Chat page](https://github.com/kian-007/practice_vercel/blob/main/practice/src/pages/chat/chat.jsx): `practice/src/pages/chat/chat.jsx`
- [Message routes](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/routes/messages.js): `practice-backend/routes/messages.js`
- [Socket client](https://github.com/kian-007/practice_vercel/blob/main/practice/src/socketContext.jsx): `practice/src/socketContext.jsx`
- [WebSocket service](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/websocket.js): `practice-backend/websocket.js`

### Persistence

- [Postgres access](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/config/db.js): `practice-backend/config/db.js`
- **PostgreSQL**
- [Redis access](https://github.com/kian-007/practice_vercel/blob/main/practice-backend/config/redis.js): `practice-backend/config/redis.js`

### Other components

- **User**
- **Email provider**

## Connections

- User → React app: uses (evidence: `practice/src/App.jsx`)
- React app → Auth state: provides auth (evidence: `practice/src/App.jsx`)
- React app → Socket client: provides sockets (evidence: `practice/src/App.jsx`)
- React app → Shared layout: renders routes (evidence: `practice/src/App.jsx`)
- React app → Account pages: routes to (evidence: `practice/src/App.jsx`)
- Auth state → Authenticated API: checks identity (evidence: `practice/src/authContext.jsx`)
- Account pages → Auth state: updates login (evidence: `practice/src/pages/chat/chat.jsx`)
- Dashboard → URL manager: renders (evidence: `practice/src/pages/dashboard/dashboard.jsx`)
- Dashboard → Session manager: renders (evidence: `practice/src/pages/dashboard/dashboard.jsx`)
- URL manager → Authenticated API: requests URLs (evidence: `practice/src/components/urls/urls.jsx`)
- Session manager → Authenticated API: requests sessions (evidence: `practice/src/components/sessions/sessions.jsx`)
- Chat page → Authenticated API: loads messages (evidence: `practice/src/pages/chat/chat.jsx`)
- Chat page → Socket client: uses events (evidence: `practice/src/pages/chat/chat.jsx`)
- Authenticated API → Express app: sends HTTP
- Express app → Auth routes: mounts routes (evidence: `practice-backend/app.js`)
- Express app → User routes: mounts routes (evidence: `practice-backend/app.js`)
- Express app → Session routes: mounts routes (evidence: `practice-backend/app.js`)
- Express app → Admin routes: mounts routes (evidence: `practice-backend/app.js`)
- Express app → URL routes: mounts routes (evidence: `practice-backend/app.js`)
- Express app → Message routes: mounts routes (evidence: `practice-backend/app.js`)
- Auth routes → Postgres access: queries users (evidence: `practice-backend/routes/auth.js`)
- Session routes → Postgres access: queries sessions (evidence: `practice-backend/routes/sessions.js`)
- URL routes → Postgres access: accesses data (evidence: `practice-backend/routes/urls.js`)
- Admin routes → Postgres access: queries data (evidence: `practice-backend/routes/admin.js`)
- User routes → Auth middleware: requires auth (evidence: `practice-backend/routes/user.js`)
- Auth routes → Auth middleware: requires auth (evidence: `practice-backend/routes/auth.js`)
- Session routes → Auth middleware: requires auth (evidence: `practice-backend/routes/sessions.js`)
- Auth routes → Rate limiting: limits requests (evidence: `practice-backend/routes/auth.js`)
- Auth routes → Reset email: sends reset (evidence: `practice-backend/routes/auth.js`)
- Reset email → Email provider: delivers email
- Socket client → WebSocket service: opens socket
- Message routes → WebSocket service: uses sockets (evidence: `practice-backend/routes/messages.js`)
- Postgres access → PostgreSQL: connects to (evidence: `practice-backend/config/db.js`)
