# cosmicviraj/freelancer-website architecture

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

- Interactive diagram: https://gitdiagram.com/cosmicviraj/freelancer-website
- Repository: https://github.com/cosmicviraj/freelancer-website

## Overview

This is a PHP/MySQL freelancer marketplace. Employers publish and manage jobs; freelancers browse and apply; employers review applications, and accepted work can use a shared workspace for messaging, notes, and files. The main path runs through role dashboards and POST handlers into MySQL. Workspace endpoints are documented by the workspace page’s fetch calls, though their internal data handling was not fully sampled. Authentication and database setup are represented as distinct supporting stages; unsampled relationships are omitted.

Main entry points: [`workspace/workspace.php`](https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/workspace.php) (Workspace interface), [`db_connect.php`](https://github.com/cosmicviraj/freelancer-website/blob/main/db_connect.php) (MySQL database), [`dashboard-employer.php`](https://github.com/cosmicviraj/freelancer-website/blob/main/dashboard-employer.php) (Employer dashboard), [`dashboard-freelancer.php`](https://github.com/cosmicviraj/freelancer-website/blob/main/dashboard-freelancer.php) (Freelancer dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts"]
  node_login["Login form<br/>[login.html]"]
  node_auth["Authentication<br/>[auth.php]"]
  node_session["Session routing<br/>[dashboard.php]"]
end

subgraph group_marketplace["Job marketplace"]
  node_freelancer["Freelancer dashboard"]
  node_employer["Employer dashboard"]
  node_job_post["Job posting<br/>[post_job.php]"]
  node_job_delete["Job deletion<br/>[delete_job.php]"]
  node_application["Job application<br/>[apply.php]"]
  node_application_review["Application review<br/>[manage_bid.php]"]
  node_application_status["Status updater"]
end

subgraph group_workspace["Work collaboration"]
  node_workspace_ui["Workspace interface<br/>[workspace.php]"]
  node_messages["Messaging endpoints<br/>[send_message.php]"]
  node_message_reader["Message retrieval<br/>[get_messages.php]"]
  node_notes["Note endpoints<br/>[save_note.php]"]
  node_note_reader["Note retrieval<br/>[get_notes.php]"]
  node_file_upload["File upload<br/>[upload.php]"]
  node_file_listing["File listing<br/>[list_files.php]"]
end

subgraph group_persistence["Persistence"]
  node_database_setup["Schema setup<br/>[setup_database.php]"]
  node_mysql[("MySQL database<br/>[db_connect.php]")]
end

node_visitor(("User"))

node_visitor -->|"opens"| node_login
node_visitor -.->|"submits credentials"| node_auth
node_auth -->|"checks and stores users"| node_mysql
node_auth -->|"routes after login"| node_session
node_visitor -->|"uses role dashboard"| node_freelancer
node_visitor -->|"uses role dashboard"| node_employer
node_freelancer -->|"reads jobs and applications"| node_mysql
node_freelancer -->|"submits proposal"| node_application
node_application -->|"creates application"| node_mysql
node_employer -->|"submits job"| node_job_post
node_job_post -->|"creates job"| node_mysql
node_employer -->|"requests deletion"| node_job_delete
node_job_delete -->|"deletes job"| node_mysql
node_employer -->|"reads jobs and bids"| node_mysql
node_employer -->|"accepts or deletes bid"| node_application_review
node_application_review -->|"updates applications"| node_mysql
node_application_status -->|"updates status"| node_mysql
node_freelancer -->|"opens accepted-work workspace"| node_workspace_ui
node_employer -->|"opens job workspace"| node_workspace_ui
node_workspace_ui -->|"sends messages"| node_messages
node_workspace_ui -->|"loads messages"| node_message_reader
node_workspace_ui -->|"saves notes"| node_notes
node_workspace_ui -->|"loads notes"| node_note_reader
node_workspace_ui -->|"uploads files"| node_file_upload
node_workspace_ui -->|"loads file list"| node_file_listing
node_database_setup -->|"creates tables"| node_mysql

click node_login "https://github.com/cosmicviraj/freelancer-website/blob/main/login.html"
click node_auth "https://github.com/cosmicviraj/freelancer-website/blob/main/auth.php"
click node_session "https://github.com/cosmicviraj/freelancer-website/blob/main/dashboard.php"
click node_freelancer "https://github.com/cosmicviraj/freelancer-website/blob/main/dashboard-freelancer.php"
click node_employer "https://github.com/cosmicviraj/freelancer-website/blob/main/dashboard-employer.php"
click node_job_post "https://github.com/cosmicviraj/freelancer-website/blob/main/post_job.php"
click node_job_delete "https://github.com/cosmicviraj/freelancer-website/blob/main/delete_job.php"
click node_application "https://github.com/cosmicviraj/freelancer-website/blob/main/apply.php"
click node_application_review "https://github.com/cosmicviraj/freelancer-website/blob/main/manage_bid.php"
click node_application_status "https://github.com/cosmicviraj/freelancer-website/blob/main/process_application.php"
click node_workspace_ui "https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/workspace.php"
click node_messages "https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/send_message.php"
click node_message_reader "https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/get_messages.php"
click node_notes "https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/save_note.php"
click node_note_reader "https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/get_notes.php"
click node_file_upload "https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/upload.php"
click node_file_listing "https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/list_files.php"
click node_database_setup "https://github.com/cosmicviraj/freelancer-website/blob/main/setup_database.php"
click node_mysql "https://github.com/cosmicviraj/freelancer-website/blob/main/db_connect.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_login,node_auth,node_session,node_visitor toneBlue
class node_freelancer,node_employer,node_job_post,node_job_delete,node_application,node_application_review,node_application_status toneAmber
class node_workspace_ui,node_messages,node_message_reader,node_notes,node_note_reader,node_file_upload,node_file_listing toneMint
class node_database_setup,node_mysql toneRose
```

## Components

### Accounts

- [Login form](https://github.com/cosmicviraj/freelancer-website/blob/main/login.html): `login.html`
- [Authentication](https://github.com/cosmicviraj/freelancer-website/blob/main/auth.php): `auth.php`
- [Session routing](https://github.com/cosmicviraj/freelancer-website/blob/main/dashboard.php): `dashboard.php`

### Job marketplace

- [Freelancer dashboard](https://github.com/cosmicviraj/freelancer-website/blob/main/dashboard-freelancer.php): `dashboard-freelancer.php`
- [Employer dashboard](https://github.com/cosmicviraj/freelancer-website/blob/main/dashboard-employer.php): `dashboard-employer.php`
- [Job posting](https://github.com/cosmicviraj/freelancer-website/blob/main/post_job.php): `post_job.php`
- [Job deletion](https://github.com/cosmicviraj/freelancer-website/blob/main/delete_job.php): `delete_job.php`
- [Job application](https://github.com/cosmicviraj/freelancer-website/blob/main/apply.php): `apply.php`
- [Application review](https://github.com/cosmicviraj/freelancer-website/blob/main/manage_bid.php): `manage_bid.php`
- [Status updater](https://github.com/cosmicviraj/freelancer-website/blob/main/process_application.php): `process_application.php`

### Work collaboration

- [Workspace interface](https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/workspace.php): `workspace/workspace.php`
- [Messaging endpoints](https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/send_message.php): `workspace/send_message.php`
- [Message retrieval](https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/get_messages.php): `workspace/get_messages.php`
- [Note endpoints](https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/save_note.php): `workspace/save_note.php`
- [Note retrieval](https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/get_notes.php): `workspace/get_notes.php`
- [File upload](https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/upload.php): `workspace/upload.php`
- [File listing](https://github.com/cosmicviraj/freelancer-website/blob/main/workspace/list_files.php): `workspace/list_files.php`

### Persistence

- [Schema setup](https://github.com/cosmicviraj/freelancer-website/blob/main/setup_database.php): `setup_database.php`
- [MySQL database](https://github.com/cosmicviraj/freelancer-website/blob/main/db_connect.php): `db_connect.php`

### Other components

- **User**

## Connections

- User → Login form: opens (evidence: `README.md`)
- User → Authentication: submits credentials
- Authentication → MySQL database: checks and stores users (evidence: `auth.php`)
- Authentication → Session routing: routes after login (evidence: `auth.php`)
- User → Freelancer dashboard: uses role dashboard (evidence: `README.md`)
- User → Employer dashboard: uses role dashboard (evidence: `README.md`)
- Freelancer dashboard → MySQL database: reads jobs and applications (evidence: `dashboard-freelancer.php`)
- Freelancer dashboard → Job application: submits proposal (evidence: `dashboard-freelancer.php`)
- Job application → MySQL database: creates application (evidence: `apply.php`)
- Employer dashboard → Job posting: submits job (evidence: `dashboard-employer.php`)
- Job posting → MySQL database: creates job (evidence: `post_job.php`)
- Employer dashboard → Job deletion: requests deletion (evidence: `dashboard-employer.php`)
- Job deletion → MySQL database: deletes job (evidence: `delete_job.php`)
- Employer dashboard → MySQL database: reads jobs and bids (evidence: `dashboard-employer.php`)
- Employer dashboard → Application review: accepts or deletes bid (evidence: `dashboard-employer.php`)
- Application review → MySQL database: updates applications (evidence: `manage_bid.php`)
- Status updater → MySQL database: updates status (evidence: `process_application.php`)
- Freelancer dashboard → Workspace interface: opens accepted-work workspace (evidence: `dashboard-freelancer.php`)
- Employer dashboard → Workspace interface: opens job workspace (evidence: `dashboard-employer.php`)
- Workspace interface → Messaging endpoints: sends messages (evidence: `workspace/workspace.php`)
- Workspace interface → Message retrieval: loads messages (evidence: `workspace/workspace.php`)
- Workspace interface → Note endpoints: saves notes (evidence: `workspace/workspace.php`)
- Workspace interface → Note retrieval: loads notes (evidence: `workspace/workspace.php`)
- Workspace interface → File upload: uploads files (evidence: `workspace/workspace.php`)
- Workspace interface → File listing: loads file list (evidence: `workspace/workspace.php`)
- Schema setup → MySQL database: creates tables (evidence: `setup_database.php`)
