# realabidhasnine/uiu_web_4165 architecture

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

- Interactive diagram: https://gitdiagram.com/realabidhasnine/uiu_web_4165
- Repository: https://github.com/realabidhasnine/uiu_web_4165

## Overview

SkillMatch is a freelance marketplace: guests discover jobs and professionals; clients post work and review proposals; freelancers verify skills, apply, and deliver; both parties manage projects, payments, reviews, disputes, and chat. Admins oversee accounts, verification content, and reporting. The graph groups the documented product capabilities with the sampled API implementation and shared database utilities. Several branches are documented in the README but their detailed implementation was not sampled; edges from those actors reflect documented capabilities, not inspected UI wiring.

Main entry points: [`api/config/db.php`](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/config/db.php) (Database and API utilities), [`api/admin/reports.php`](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/admin/reports.php) (Analytics and PDF reports), [`api/auth`](https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/auth) (Account access), [`api/freelancers/index.php`](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/freelancers/index.php) (Freelancer discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and identity"]
  node_auth["Account access"]
  node_freelancer_discovery["Freelancer discovery<br/>[index.php]"]
  node_job_discovery["Job discovery and posting<br/>[index.php]"]
  node_verification["Skill verification"]
end

subgraph group_work["Marketplace workflow"]
  node_proposals["Proposals"]
  node_project_delivery["Project delivery<br/>[deliverables.php]"]
  node_milestones["Milestones and approval"]
  node_billing["Escrow billing<br/>[billing.php]"]
end

subgraph group_trust["Trust and communication"]
  node_reviews["Reviews<br/>[index.php]"]
  node_disputes["Dispute resolution"]
  node_chat["Project chat"]
  node_notifications["Notifications<br/>[index.php]"]
end

subgraph group_admin["Administration"]
  node_admin_management["Accounts and verification content"]
  node_admin_reporting["Analytics and PDF reports<br/>[reports.php]"]
  node_pdf["PDF rendering<br/>[pdf.php]"]
end

subgraph group_foundation["Shared backend"]
  node_database[("Database and API utilities<br/>[db.php]")]
end

node_guest(("Guest"))
node_client(("Client"))
node_freelancer(("Freelancer"))
node_admin_actor(("Admin"))

node_guest -->|"browse profiles"| node_freelancer_discovery
node_guest -->|"browse jobs"| node_job_discovery
node_client -->|"create account"| node_auth
node_freelancer -->|"create account"| node_auth
node_client -->|"post projects"| node_job_discovery
node_client -->|"review proposals"| node_proposals
node_freelancer -->|"take skill tests"| node_verification
node_freelancer -->|"showcase profile"| node_freelancer_discovery
node_freelancer -->|"apply for jobs"| node_proposals
node_freelancer -->|"submit work"| node_project_delivery
node_client -->|"approve deliverables"| node_milestones
node_client -->|"view escrow ledger"| node_billing
node_client -->|"rate completed work"| node_reviews
node_client -->|"raise disputes"| node_disputes
node_freelancer -->|"respond to disputes"| node_disputes
node_client -->|"communicate"| node_chat
node_freelancer -->|"communicate"| node_chat
node_admin_actor -->|"manage accounts and tests"| node_admin_management
node_admin_actor -->|"view analytics"| node_admin_reporting
node_admin_reporting -->|"renders reports"| node_pdf
node_auth -->|"uses database utilities"| node_database
node_freelancer_discovery -->|"queries profiles"| node_database
node_job_discovery -->|"reads and writes jobs"| node_database
node_proposals -->|"queries proposals"| node_database
node_project_delivery -->|"stores delivery records"| node_database
node_billing -->|"queries payment ledger"| node_database
node_reviews -->|"stores reviews"| node_database
node_disputes -->|"queries disputes"| node_database
node_chat -->|"reads and writes messages"| node_database
node_notifications -->|"reads and updates notifications"| node_database
node_admin_management -->|"uses database utilities"| node_database
node_admin_reporting -->|"queries report data"| node_database

click node_auth "https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/auth"
click node_freelancer_discovery "https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/freelancers/index.php"
click node_job_discovery "https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/jobs/index.php"
click node_verification "https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/skills"
click node_proposals "https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/proposals"
click node_project_delivery "https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/projects/deliverables.php"
click node_milestones "https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/projects"
click node_billing "https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/clients/billing.php"
click node_reviews "https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/reviews/index.php"
click node_disputes "https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/disputes"
click node_chat "https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/chat"
click node_notifications "https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/notifications/index.php"
click node_admin_management "https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/admin"
click node_admin_reporting "https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/admin/reports.php"
click node_pdf "https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/config/pdf.php"
click node_database "https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/config/db.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_auth,node_freelancer_discovery,node_job_discovery,node_verification,node_client toneBlue
class node_proposals,node_project_delivery,node_milestones,node_billing toneAmber
class node_reviews,node_disputes,node_chat,node_notifications toneMint
class node_admin_management,node_admin_reporting,node_pdf toneRose
class node_database,node_guest,node_freelancer,node_admin_actor toneIndigo
```

## Components

### Discovery and identity

- [Account access](https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/auth): `api/auth`
- [Freelancer discovery](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/freelancers/index.php): `api/freelancers/index.php`
- [Job discovery and posting](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/jobs/index.php): `api/jobs/index.php`
- [Skill verification](https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/skills): `api/skills`

### Marketplace workflow

- [Proposals](https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/proposals): `api/proposals`
- [Project delivery](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/projects/deliverables.php): `api/projects/deliverables.php`
- [Milestones and approval](https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/projects): `api/projects`
- [Escrow billing](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/clients/billing.php): `api/clients/billing.php`

### Trust and communication

- [Reviews](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/reviews/index.php): `api/reviews/index.php`
- [Dispute resolution](https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/disputes): `api/disputes`
- [Project chat](https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/chat): `api/chat`
- [Notifications](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/notifications/index.php): `api/notifications/index.php`

### Administration

- [Accounts and verification content](https://github.com/realabidhasnine/uiu_web_4165/tree/main/api/admin): `api/admin`
- [Analytics and PDF reports](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/admin/reports.php): `api/admin/reports.php`
- [PDF rendering](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/config/pdf.php): `api/config/pdf.php`

### Shared backend

- [Database and API utilities](https://github.com/realabidhasnine/uiu_web_4165/blob/main/api/config/db.php): `api/config/db.php`

### Other components

- **Guest**
- **Client**
- **Freelancer**
- **Admin**

## Connections

- Guest → Freelancer discovery: browse profiles (evidence: `README.md`)
- Guest → Job discovery and posting: browse jobs (evidence: `README.md`)
- Client → Account access: create account (evidence: `README.md`)
- Freelancer → Account access: create account (evidence: `README.md`)
- Client → Job discovery and posting: post projects (evidence: `README.md`)
- Client → Proposals: review proposals (evidence: `README.md`)
- Freelancer → Skill verification: take skill tests (evidence: `README.md`)
- Freelancer → Freelancer discovery: showcase profile (evidence: `README.md`)
- Freelancer → Proposals: apply for jobs (evidence: `README.md`)
- Freelancer → Project delivery: submit work (evidence: `README.md`)
- Client → Milestones and approval: approve deliverables (evidence: `README.md`)
- Client → Escrow billing: view escrow ledger (evidence: `api/clients/billing.php`)
- Client → Reviews: rate completed work (evidence: `README.md`)
- Client → Dispute resolution: raise disputes (evidence: `README.md`)
- Freelancer → Dispute resolution: respond to disputes (evidence: `api/disputes/index.php`)
- Client → Project chat: communicate (evidence: `README.md`)
- Freelancer → Project chat: communicate (evidence: `README.md`)
- Admin → Accounts and verification content: manage accounts and tests (evidence: `README.md`)
- Admin → Analytics and PDF reports: view analytics (evidence: `README.md`)
- Analytics and PDF reports → PDF rendering: renders reports (evidence: `api/admin/reports.php`)
- Account access → Database and API utilities: uses database utilities (evidence: `api/auth/login.php`)
- Freelancer discovery → Database and API utilities: queries profiles (evidence: `api/freelancers/index.php`)
- Job discovery and posting → Database and API utilities: reads and writes jobs (evidence: `api/jobs/index.php`)
- Proposals → Database and API utilities: queries proposals (evidence: `api/proposals/index.php`)
- Project delivery → Database and API utilities: stores delivery records (evidence: `api/projects/deliverables.php`)
- Escrow billing → Database and API utilities: queries payment ledger (evidence: `api/clients/billing.php`)
- Reviews → Database and API utilities: stores reviews (evidence: `api/reviews/index.php`)
- Dispute resolution → Database and API utilities: queries disputes (evidence: `api/disputes/index.php`)
- Project chat → Database and API utilities: reads and writes messages (evidence: `api/chat/messages.php`)
- Notifications → Database and API utilities: reads and updates notifications (evidence: `api/notifications/index.php`)
- Accounts and verification content → Database and API utilities: uses database utilities (evidence: `api/admin/categories.php`)
- Analytics and PDF reports → Database and API utilities: queries report data (evidence: `api/admin/reports.php`)
