# moeezshehzad/atech_vps_portal architecture

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

- Interactive diagram: https://gitdiagram.com/moeezshehzad/atech_vps_portal
- Repository: https://github.com/moeezshehzad/atech_vps_portal

## Overview

This repository is a consulting-services and VPS customer portal. Visitors browse company, services, pricing, and contact pages; users can register or sign in, then access a dashboard and account settings. The dashboard excerpt shows instance controls and local UI state, not a demonstrated provisioning backend. The backend handles token-based authentication, profile management, Google OAuth, and Prisma-backed user data. The supplied excerpts establish frontend routing and backend route mounting; the client-to-server API relationship is suggested by the API base URL and route paths, but is not directly demonstrated across those excerpts.

Main entry points: [`public/src/App.tsx`](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/App.tsx) (Page router), [`server.js`](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/server.js) (Express API), [`public/src/context/AuthContext.tsx`](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/context/AuthContext.tsx) (Auth state), [`public/src/pages/Dashboard.tsx`](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Dashboard.tsx) (VPS dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Portal UI"]
  node_entry["React entry<br/>[main.tsx]"]
  node_router["Page router<br/>[App.tsx]"]
  node_home["Home page<br/>[Home.tsx]"]
  node_about["About page<br/>[AboutUs.tsx]"]
  node_services["Services page<br/>[Services.tsx]"]
  node_pricing["Pricing page<br/>[Pricing.tsx]"]
  node_contact["Contact page<br/>[ContactUs.tsx]"]
end

subgraph group_auth["Identity"]
  node_login["Login page<br/>[Login.tsx]"]
  node_signup["Signup page<br/>[Signup.tsx]"]
  node_authstate["Auth state<br/>[AuthContext.tsx]"]
  node_api["API client<br/>[api.ts]"]
end

subgraph group_account["Customer Account"]
  node_dashboard["VPS dashboard<br/>[Dashboard.tsx]"]
  node_sidebar["Dashboard navigation<br/>[Sidebar.tsx]"]
  node_settings["Account settings"]
end

subgraph group_server["API Backend"]
  node_httpapi["Express API<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Auth handlers<br/>[authController.js]"]
  node_authmiddleware["Token middleware<br/>[authMiddleware.js]"]
  node_userroutes["User profile routes<br/>[user.js]"]
  node_oauth["Google OAuth<br/>[server.js]"]
end

subgraph group_data["Persistence"]
  node_database[("Application database<br/>[schema.prisma]")]
  node_prismaclient["Prisma client<br/>[prisma.js]"]
end

node_visitor(("Visitor or user"))

node_visitor -->|"opens portal"| node_entry
node_entry -->|"renders"| node_router
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_about
node_router -->|"routes to"| node_services
node_router -->|"routes to"| node_pricing
node_router -->|"routes to"| node_contact
node_router -->|"routes to"| node_login
node_router -->|"routes to"| node_signup
node_router -->|"protects route"| node_dashboard
node_router -->|"provides auth"| node_authstate
node_login -->|"uses auth"| node_authstate
node_signup -->|"uses auth"| node_authstate
node_authstate -->|"calls"| node_api
node_dashboard -->|"renders"| node_sidebar
node_dashboard -->|"renders"| node_settings
node_api -.->|"requests API"| node_httpapi
node_httpapi -->|"mounts routes"| node_authroutes
node_httpapi -->|"mounts routes"| node_userroutes
node_httpapi -->|"configures OAuth"| node_oauth
node_authroutes -->|"dispatches to"| node_authcontroller
node_authroutes -->|"guards profile"| node_authmiddleware
node_userroutes -->|"guards requests"| node_authmiddleware
node_authcontroller -->|"queries through"| node_prismaclient
node_authcontroller -->|"reads and writes"| node_database
node_userroutes -->|"reads and writes"| node_database
node_oauth -->|"stores user tokens"| node_database

click node_entry "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/main.tsx"
click node_router "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/App.tsx"
click node_home "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Home.tsx"
click node_about "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/AboutUs.tsx"
click node_services "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Services.tsx"
click node_pricing "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Pricing.tsx"
click node_contact "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/ContactUs.tsx"
click node_login "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Login.tsx"
click node_signup "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Signup.tsx"
click node_authstate "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/context/AuthContext.tsx"
click node_api "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/services/api.ts"
click node_dashboard "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Dashboard.tsx"
click node_sidebar "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/components/Sidebar.tsx"
click node_settings "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/components/AccountSettings.tsx"
click node_httpapi "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/server.js"
click node_authroutes "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/routes/authRoutes.js"
click node_authcontroller "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/controllers/authController.js"
click node_authmiddleware "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/middleware/authMiddleware.js"
click node_userroutes "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/routes/user.js"
click node_oauth "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/server.js"
click node_database "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/prisma/schema.prisma"
click node_prismaclient "https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/lib/prisma.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_entry,node_router,node_home,node_about,node_services,node_pricing,node_contact,node_visitor toneBlue
class node_login,node_signup,node_authstate,node_api toneAmber
class node_dashboard,node_sidebar,node_settings toneMint
class node_httpapi,node_authroutes,node_authcontroller,node_authmiddleware,node_userroutes,node_oauth toneRose
class node_database,node_prismaclient toneIndigo
```

## Components

### Portal UI

- [React entry](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/main.tsx): `public/src/main.tsx`
- [Page router](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/App.tsx): `public/src/App.tsx`
- [Home page](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Home.tsx): `public/src/pages/Home.tsx`
- [About page](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/AboutUs.tsx): `public/src/pages/AboutUs.tsx`
- [Services page](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Services.tsx): `public/src/pages/Services.tsx`
- [Pricing page](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Pricing.tsx): `public/src/pages/Pricing.tsx`
- [Contact page](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/ContactUs.tsx): `public/src/pages/ContactUs.tsx`

### Identity

- [Login page](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Login.tsx): `public/src/pages/Login.tsx`
- [Signup page](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Signup.tsx): `public/src/pages/Signup.tsx`
- [Auth state](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/context/AuthContext.tsx): `public/src/context/AuthContext.tsx`
- [API client](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/services/api.ts): `public/src/services/api.ts`

### Customer Account

- [VPS dashboard](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/pages/Dashboard.tsx): `public/src/pages/Dashboard.tsx`
- [Dashboard navigation](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/components/Sidebar.tsx): `public/src/components/Sidebar.tsx`
- [Account settings](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/public/src/components/AccountSettings.tsx): `public/src/components/AccountSettings.tsx`

### API Backend

- [Express API](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/server.js): `server.js`
- [Auth routes](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/routes/authRoutes.js): `routes/authRoutes.js`
- [Auth handlers](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/controllers/authController.js): `controllers/authController.js`
- [Token middleware](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/middleware/authMiddleware.js): `middleware/authMiddleware.js`
- [User profile routes](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/routes/user.js): `routes/user.js`
- [Google OAuth](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/server.js): `server.js`

### Persistence

- [Application database](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/prisma/schema.prisma): `prisma/schema.prisma`
- [Prisma client](https://github.com/moeezshehzad/atech_vps_portal/blob/feature/vps-dashboard/lib/prisma.js): `lib/prisma.js`

### Other components

- **Visitor or user**

## Connections

- Visitor or user → React entry: opens portal
- React entry → Page router: renders (evidence: `public/src/main.tsx`)
- Page router → Home page: routes to (evidence: `public/src/App.tsx`)
- Page router → About page: routes to (evidence: `public/src/App.tsx`)
- Page router → Services page: routes to (evidence: `public/src/App.tsx`)
- Page router → Pricing page: routes to (evidence: `public/src/App.tsx`)
- Page router → Contact page: routes to (evidence: `public/src/App.tsx`)
- Page router → Login page: routes to (evidence: `public/src/App.tsx`)
- Page router → Signup page: routes to (evidence: `public/src/App.tsx`)
- Page router → VPS dashboard: protects route (evidence: `public/src/App.tsx`)
- Page router → Auth state: provides auth (evidence: `public/src/App.tsx`)
- Login page → Auth state: uses auth (evidence: `public/src/pages/Login.tsx`)
- Signup page → Auth state: uses auth (evidence: `public/src/pages/Signup.tsx`)
- Auth state → API client: calls (evidence: `public/src/context/AuthContext.tsx`)
- VPS dashboard → Dashboard navigation: renders (evidence: `public/src/pages/Dashboard.tsx`)
- VPS dashboard → Account settings: renders (evidence: `public/src/pages/Dashboard.tsx`)
- API client → Express API: requests API
- Express API → Auth routes: mounts routes (evidence: `server.js`)
- Express API → User profile routes: mounts routes (evidence: `server.js`)
- Express API → Google OAuth: configures OAuth (evidence: `server.js`)
- Auth routes → Auth handlers: dispatches to (evidence: `routes/authRoutes.js`)
- Auth routes → Token middleware: guards profile (evidence: `routes/authRoutes.js`)
- User profile routes → Token middleware: guards requests (evidence: `routes/user.js`)
- Auth handlers → Prisma client: queries through (evidence: `controllers/authController.js`)
- Auth handlers → Application database: reads and writes (evidence: `controllers/authController.js`)
- User profile routes → Application database: reads and writes (evidence: `routes/user.js`)
- Google OAuth → Application database: stores user tokens (evidence: `server.js`)
