# vineethtamarapalli-code/job-helper architecture

> Architecture diagram of the GitHub repository vineethtamarapalli-code/job-helper, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vineethtamarapalli-code/job-helper
- Repository: https://github.com/vineethtamarapalli-code/job-helper

## Overview

Job Helper is a PHP web portal for user accounts, job listings, personal files and shortcuts, sharing, favorites, messaging, and administrative management. The main user flow starts at the landing page, proceeds through account or OTP verification, and reaches the home/profile experience, where users manage and share content. Admin and Gmail-related pages form separate branches. The README is empty, and sampled source is partial, so some links and database ownership are omitted where implementation evidence is unavailable.

Main entry points: [`home.php`](https://github.com/vineethtamarapalli-code/job-helper/blob/main/home.php) (Workspace home), [`db6.php`](https://github.com/vineethtamarapalli-code/job-helper/blob/main/db6.php) (Application database), [`index.php`](https://github.com/vineethtamarapalli-code/job-helper/blob/main/index.php) (Sign in and signup), [`profile.php`](https://github.com/vineethtamarapalli-code/job-helper/blob/main/profile.php) (User profile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and accounts"]
  node_index["Sign in and signup<br/>[index.php]"]
  node_auth["Account authentication<br/>[auth.php]"]
  node_otp["OTP delivery<br/>[send_otp.php]"]
  node_verify["OTP verification<br/>[verify.php]"]
end

subgraph group_workspace["User workspace"]
  node_home["Workspace home<br/>[home.php]"]
  node_profile["User profile<br/>[profile.php]"]
  node_profile_handler["Profile actions"]
  node_files["File actions<br/>[file_handler.php]"]
  node_save["Save actions<br/>[save_handler.php]"]
  node_favorites["Favorite folders"]
  node_share["Sharing actions<br/>[share_handler.php]"]
  node_shortcuts["Shortcut actions"]
  node_messages["Message actions"]
  node_jobs["Job listings<br/>[home.php]"]
  node_vocalize["Text vocalization<br/>[vocalize.php]"]
end

subgraph group_admin["Administration"]
  node_admin_login["Admin sign-in<br/>[admin_login.php]"]
  node_admin_panel["Admin console<br/>[admin_panel.php]"]
  node_admin_ui["Admin management UI<br/>[file_handler.php]"]
  node_admin_handler["Admin actions<br/>[admin_handler.php]"]
end

subgraph group_integrations["External integrations"]
  node_gmail_login["Gmail sign-in<br/>[gmail_login.php]"]
  node_gmail_callback["Gmail callback<br/>[gmail_callback.php]"]
  node_gmail_view["Gmail view<br/>[gmail_view.php]"]
end

node_visitor(("Visitor"))
node_database[("Application database<br/>[db6.php]")]
node_mail_service(("Email service"))
node_gmail_service(("Gmail"))

node_visitor -->|"opens"| node_index
node_index -->|"submits credentials"| node_auth
node_index -->|"requests OTP"| node_otp
node_index -->|"posts OTP"| node_verify
node_otp -->|"sends code"| node_mail_service
node_auth -->|"checks account"| node_database
node_verify -->|"checks code"| node_database
node_home -->|"loads workspace"| node_database
node_profile -->|"loads profile"| node_database
node_profile -->|"submits profile changes"| node_profile_handler
node_profile_handler -->|"updates account"| node_database
node_home -->|"submits file actions"| node_files
node_files -->|"updates file records"| node_database
node_home -->|"submits save actions"| node_save
node_home -->|"manages favorites"| node_favorites
node_favorites -->|"updates favorites"| node_database
node_profile -->|"submits sharing"| node_share
node_share -->|"creates shared records"| node_database
node_home -->|"submits shortcut actions"| node_shortcuts
node_home -->|"submits message actions"| node_messages
node_home -->|"views jobs"| node_jobs
node_home -.->|"requests vocalization"| node_vocalize
node_visitor -->|"opens"| node_admin_login
node_admin_login -->|"authenticates"| node_admin_panel
node_admin_panel -->|"opens management"| node_admin_ui
node_admin_ui -->|"submits admin actions"| node_admin_handler
node_admin_handler -->|"updates portal data"| node_database
node_visitor -->|"opens"| node_gmail_login
node_gmail_login -->|"redirects"| node_gmail_callback
node_gmail_callback -.->|"exchanges authorization"| node_gmail_service
node_gmail_view -.->|"accesses mail"| node_gmail_service

click node_index "https://github.com/vineethtamarapalli-code/job-helper/blob/main/index.php"
click node_auth "https://github.com/vineethtamarapalli-code/job-helper/blob/main/auth.php"
click node_otp "https://github.com/vineethtamarapalli-code/job-helper/blob/main/send_otp.php"
click node_verify "https://github.com/vineethtamarapalli-code/job-helper/blob/main/verify.php"
click node_home "https://github.com/vineethtamarapalli-code/job-helper/blob/main/home.php"
click node_profile "https://github.com/vineethtamarapalli-code/job-helper/blob/main/profile.php"
click node_profile_handler "https://github.com/vineethtamarapalli-code/job-helper/blob/main/profile_handler.php"
click node_files "https://github.com/vineethtamarapalli-code/job-helper/blob/main/file_handler.php"
click node_save "https://github.com/vineethtamarapalli-code/job-helper/blob/main/save_handler.php"
click node_favorites "https://github.com/vineethtamarapalli-code/job-helper/blob/main/favorites_handler.php"
click node_share "https://github.com/vineethtamarapalli-code/job-helper/blob/main/share_handler.php"
click node_shortcuts "https://github.com/vineethtamarapalli-code/job-helper/blob/main/shortcut_handler.php"
click node_messages "https://github.com/vineethtamarapalli-code/job-helper/blob/main/message_handler.php"
click node_jobs "https://github.com/vineethtamarapalli-code/job-helper/blob/main/home.php"
click node_vocalize "https://github.com/vineethtamarapalli-code/job-helper/blob/main/vocalize.php"
click node_admin_login "https://github.com/vineethtamarapalli-code/job-helper/blob/main/admin_login.php"
click node_admin_panel "https://github.com/vineethtamarapalli-code/job-helper/blob/main/admin_panel.php"
click node_admin_ui "https://github.com/vineethtamarapalli-code/job-helper/blob/main/file_handler.php"
click node_admin_handler "https://github.com/vineethtamarapalli-code/job-helper/blob/main/admin_handler.php"
click node_gmail_login "https://github.com/vineethtamarapalli-code/job-helper/blob/main/gmail_login.php"
click node_gmail_callback "https://github.com/vineethtamarapalli-code/job-helper/blob/main/gmail_callback.php"
click node_gmail_view "https://github.com/vineethtamarapalli-code/job-helper/blob/main/gmail_view.php"
click node_database "https://github.com/vineethtamarapalli-code/job-helper/blob/main/db6.php"

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_index,node_auth,node_otp,node_verify toneBlue
class node_home,node_profile,node_profile_handler,node_files,node_save,node_favorites,node_share,node_shortcuts,node_messages,node_jobs,node_vocalize,node_database toneAmber
class node_admin_login,node_admin_panel,node_admin_ui,node_admin_handler toneMint
class node_gmail_login,node_gmail_callback,node_gmail_view toneRose
class node_visitor,node_mail_service,node_gmail_service toneIndigo
```

## Components

### Entry and accounts

- [Sign in and signup](https://github.com/vineethtamarapalli-code/job-helper/blob/main/index.php): `index.php`
- [Account authentication](https://github.com/vineethtamarapalli-code/job-helper/blob/main/auth.php): `auth.php`
- [OTP delivery](https://github.com/vineethtamarapalli-code/job-helper/blob/main/send_otp.php): `send_otp.php`
- [OTP verification](https://github.com/vineethtamarapalli-code/job-helper/blob/main/verify.php): `verify.php`

### User workspace

- [Workspace home](https://github.com/vineethtamarapalli-code/job-helper/blob/main/home.php): `home.php`
- [User profile](https://github.com/vineethtamarapalli-code/job-helper/blob/main/profile.php): `profile.php`
- [Profile actions](https://github.com/vineethtamarapalli-code/job-helper/blob/main/profile_handler.php): `profile_handler.php`
- [File actions](https://github.com/vineethtamarapalli-code/job-helper/blob/main/file_handler.php): `file_handler.php`
- [Save actions](https://github.com/vineethtamarapalli-code/job-helper/blob/main/save_handler.php): `save_handler.php`
- [Favorite folders](https://github.com/vineethtamarapalli-code/job-helper/blob/main/favorites_handler.php): `favorites_handler.php`
- [Sharing actions](https://github.com/vineethtamarapalli-code/job-helper/blob/main/share_handler.php): `share_handler.php`
- [Shortcut actions](https://github.com/vineethtamarapalli-code/job-helper/blob/main/shortcut_handler.php): `shortcut_handler.php`
- [Message actions](https://github.com/vineethtamarapalli-code/job-helper/blob/main/message_handler.php): `message_handler.php`
- [Job listings](https://github.com/vineethtamarapalli-code/job-helper/blob/main/home.php): `home.php`
- [Text vocalization](https://github.com/vineethtamarapalli-code/job-helper/blob/main/vocalize.php): `vocalize.php`

### Administration

- [Admin sign-in](https://github.com/vineethtamarapalli-code/job-helper/blob/main/admin_login.php): `admin_login.php`
- [Admin console](https://github.com/vineethtamarapalli-code/job-helper/blob/main/admin_panel.php): `admin_panel.php`
- [Admin management UI](https://github.com/vineethtamarapalli-code/job-helper/blob/main/file_handler.php): `file_handler.php`
- [Admin actions](https://github.com/vineethtamarapalli-code/job-helper/blob/main/admin_handler.php): `admin_handler.php`

### External integrations

- [Gmail sign-in](https://github.com/vineethtamarapalli-code/job-helper/blob/main/gmail_login.php): `gmail_login.php`
- [Gmail callback](https://github.com/vineethtamarapalli-code/job-helper/blob/main/gmail_callback.php): `gmail_callback.php`
- [Gmail view](https://github.com/vineethtamarapalli-code/job-helper/blob/main/gmail_view.php): `gmail_view.php`

### Other components

- **Visitor**
- [Application database](https://github.com/vineethtamarapalli-code/job-helper/blob/main/db6.php): `db6.php`
- **Email service**
- **Gmail**

## Connections

- Visitor → Sign in and signup: opens
- Sign in and signup → Account authentication: submits credentials
- Sign in and signup → OTP delivery: requests OTP
- Sign in and signup → OTP verification: posts OTP
- OTP delivery → Email service: sends code
- Account authentication → Application database: checks account
- OTP verification → Application database: checks code
- Workspace home → Application database: loads workspace
- User profile → Application database: loads profile
- User profile → Profile actions: submits profile changes
- Profile actions → Application database: updates account
- Workspace home → File actions: submits file actions
- File actions → Application database: updates file records
- Workspace home → Save actions: submits save actions
- Workspace home → Favorite folders: manages favorites
- Favorite folders → Application database: updates favorites
- User profile → Sharing actions: submits sharing
- Sharing actions → Application database: creates shared records
- Workspace home → Shortcut actions: submits shortcut actions
- Workspace home → Message actions: submits message actions
- Workspace home → Job listings: views jobs
- Workspace home → Text vocalization: requests vocalization
- Visitor → Admin sign-in: opens
- Admin sign-in → Admin console: authenticates
- Admin console → Admin management UI: opens management
- Admin management UI → Admin actions: submits admin actions
- Admin actions → Application database: updates portal data
- Visitor → Gmail sign-in: opens
- Gmail sign-in → Gmail callback: redirects
- Gmail callback → Gmail: exchanges authorization
- Gmail view → Gmail: accesses mail