# dev-lani/academic_commission_website architecture

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

- Interactive diagram: https://gitdiagram.com/dev-lani/academic_commission_website
- Repository: https://github.com/dev-lani/academic_commission_website

## Overview

Academic Commission is a PHP/MySQL marketplace connecting clients who post academic or everyday requests with commissioners who submit private offers. The main workflow runs from account access and request discovery through offer acceptance, escrow-backed order work, delivery review, and approval or dispute resolution. Messaging, saved requests, commissioner profiles, reputation, and administration support that workflow. The README documents the product stages; sampled source confirms bootstrap wiring, database setup, and preview logging and file access, but many page-to-page and helper calls were not shown.

Main entry points: [`src/bootstrap.php`](https://github.com/dev-lani/academic_commission_website/blob/main/src/bootstrap.php) (Bootstrap), [`src/database.php`](https://github.com/dev-lani/academic_commission_website/blob/main/src/database.php) (MySQL database), [`public/preview.php`](https://github.com/dev-lani/academic_commission_website/blob/main/public/preview.php) (Timed preview), [`public/admin/index.php`](https://github.com/dev-lani/academic_commission_website/blob/main/public/admin/index.php) (Admin console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and trust"]
  node_account_access["Account access<br/>[login.php]"]
  node_registration["Registration<br/>[register.php]"]
  node_profiles["Profiles and skills<br/>[edit_profile.php]"]
  node_reputation["Trust tiers<br/>[reputation.php]"]
end

subgraph group_market["Request marketplace"]
  node_request_creation["Request creation<br/>[create_post.php]"]
  node_request_browsing["Request forum<br/>[forum.php]"]
  node_request_detail["Request details<br/>[post.php]"]
  node_saved_requests["Saved requests<br/>[saved.php]"]
  node_offers["Private offers<br/>[offer.php]"]
end

subgraph group_orders["Order lifecycle"]
  node_orders["Order management<br/>[order.php]"]
  node_order_actions["Order actions<br/>[order_action.php]"]
  node_delivery["Delivery upload<br/>[deliver.php]"]
  node_preview["Timed preview<br/>[preview.php]"]
  node_downloads["File download<br/>[download.php]"]
  node_transactions["Transactions<br/>[transactions.php]"]
end

subgraph group_support["Communication and admin"]
  node_chat["Order chat<br/>[chat.php]"]
  node_messages["Messages<br/>[messages.php]"]
  node_dispute_admin["Dispute administration<br/>[order.php]"]
  node_admin_console["Admin console<br/>[index.php]"]
end

subgraph group_runtime["Application runtime"]
  node_database[("MySQL database<br/>[database.php]")]
  node_file_storage[("Private file storage<br/>[config.php]")]
  node_bootstrap["Bootstrap<br/>[bootstrap.php]"]
  node_helpers["Shared helpers<br/>[helpers.php]"]
  node_order_logic["Order logic<br/>[order_lib.php]"]
  node_chat_logic["Chat logic<br/>[chat_lib.php]"]
  node_auth_logic["Authentication<br/>[auth.php]"]
  node_cache["Cache<br/>[cache.php]"]
  node_reputation_logic["Reputation logic<br/>[reputation.php]"]
end

node_client(("Client"))
node_commissioner(("Commissioner"))
node_administrator(("Administrator"))

node_client -->|"creates account"| node_registration
node_client -->|"posts request"| node_request_creation
node_commissioner -->|"browses requests"| node_request_browsing
node_request_browsing -.->|"opens request"| node_request_detail
node_commissioner -->|"sends offer"| node_offers
node_client -->|"accepts offer"| node_orders
node_commissioner -.->|"delivers work"| node_delivery
node_client -->|"reviews delivery"| node_preview
node_preview -->|"reads preview file"| node_file_storage
node_preview -->|"logs preview views"| node_database
node_client -->|"approves or disputes"| node_order_actions
node_client -->|"saves requests"| node_saved_requests
node_client -.->|"chats on orders"| node_chat
node_commissioner -->|"updates profile"| node_profiles
node_administrator -->|"manages marketplace"| node_admin_console
node_admin_console -->|"opens dispute"| node_dispute_admin
node_bootstrap -->|"loads connection"| node_database
node_bootstrap -->|"loads module"| node_cache
node_bootstrap -->|"loads module"| node_helpers
node_bootstrap -->|"loads module"| node_auth_logic
node_bootstrap -->|"loads module"| node_reputation_logic
node_bootstrap -->|"loads module"| node_order_logic
node_bootstrap -->|"loads module"| node_chat_logic
node_admin_console -->|"queries accounts and disputes"| node_database
node_dispute_admin -->|"reads dispute records"| node_database
node_account_access -.->|"initializes app"| node_bootstrap
node_request_creation -.->|"initializes app"| node_bootstrap
node_orders -.->|"uses order rules"| node_order_logic
node_chat -.->|"uses chat functions"| node_chat_logic

click node_account_access "https://github.com/dev-lani/academic_commission_website/blob/main/public/login.php"
click node_registration "https://github.com/dev-lani/academic_commission_website/blob/main/public/register.php"
click node_profiles "https://github.com/dev-lani/academic_commission_website/blob/main/public/edit_profile.php"
click node_reputation "https://github.com/dev-lani/academic_commission_website/blob/main/src/reputation.php"
click node_request_creation "https://github.com/dev-lani/academic_commission_website/blob/main/public/create_post.php"
click node_request_browsing "https://github.com/dev-lani/academic_commission_website/blob/main/public/forum.php"
click node_request_detail "https://github.com/dev-lani/academic_commission_website/blob/main/public/post.php"
click node_saved_requests "https://github.com/dev-lani/academic_commission_website/blob/main/public/saved.php"
click node_offers "https://github.com/dev-lani/academic_commission_website/blob/main/public/offer.php"
click node_orders "https://github.com/dev-lani/academic_commission_website/blob/main/public/order.php"
click node_order_actions "https://github.com/dev-lani/academic_commission_website/blob/main/public/order_action.php"
click node_delivery "https://github.com/dev-lani/academic_commission_website/blob/main/public/deliver.php"
click node_preview "https://github.com/dev-lani/academic_commission_website/blob/main/public/preview.php"
click node_downloads "https://github.com/dev-lani/academic_commission_website/blob/main/public/download.php"
click node_transactions "https://github.com/dev-lani/academic_commission_website/blob/main/public/transactions.php"
click node_chat "https://github.com/dev-lani/academic_commission_website/blob/main/public/chat.php"
click node_messages "https://github.com/dev-lani/academic_commission_website/blob/main/public/messages.php"
click node_dispute_admin "https://github.com/dev-lani/academic_commission_website/blob/main/public/admin/order.php"
click node_admin_console "https://github.com/dev-lani/academic_commission_website/blob/main/public/admin/index.php"
click node_database "https://github.com/dev-lani/academic_commission_website/blob/main/src/database.php"
click node_file_storage "https://github.com/dev-lani/academic_commission_website/blob/main/src/config.php"
click node_bootstrap "https://github.com/dev-lani/academic_commission_website/blob/main/src/bootstrap.php"
click node_helpers "https://github.com/dev-lani/academic_commission_website/blob/main/src/helpers.php"
click node_order_logic "https://github.com/dev-lani/academic_commission_website/blob/main/src/order_lib.php"
click node_chat_logic "https://github.com/dev-lani/academic_commission_website/blob/main/src/chat_lib.php"
click node_auth_logic "https://github.com/dev-lani/academic_commission_website/blob/main/src/auth.php"
click node_cache "https://github.com/dev-lani/academic_commission_website/blob/main/src/cache.php"
click node_reputation_logic "https://github.com/dev-lani/academic_commission_website/blob/main/src/reputation.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_account_access,node_registration,node_profiles,node_reputation,node_client toneBlue
class node_request_creation,node_request_browsing,node_request_detail,node_saved_requests,node_offers toneAmber
class node_orders,node_order_actions,node_delivery,node_preview,node_downloads,node_transactions toneMint
class node_chat,node_messages,node_dispute_admin,node_admin_console toneRose
class node_database,node_file_storage,node_bootstrap,node_helpers,node_order_logic,node_chat_logic,node_auth_logic,node_cache,node_reputation_logic,node_commissioner,node_administrator toneIndigo
```

## Components

### Accounts and trust

- [Account access](https://github.com/dev-lani/academic_commission_website/blob/main/public/login.php): `public/login.php`
- [Registration](https://github.com/dev-lani/academic_commission_website/blob/main/public/register.php): `public/register.php`
- [Profiles and skills](https://github.com/dev-lani/academic_commission_website/blob/main/public/edit_profile.php): `public/edit_profile.php`
- [Trust tiers](https://github.com/dev-lani/academic_commission_website/blob/main/src/reputation.php): `src/reputation.php`

### Request marketplace

- [Request creation](https://github.com/dev-lani/academic_commission_website/blob/main/public/create_post.php): `public/create_post.php`
- [Request forum](https://github.com/dev-lani/academic_commission_website/blob/main/public/forum.php): `public/forum.php`
- [Request details](https://github.com/dev-lani/academic_commission_website/blob/main/public/post.php): `public/post.php`
- [Saved requests](https://github.com/dev-lani/academic_commission_website/blob/main/public/saved.php): `public/saved.php`
- [Private offers](https://github.com/dev-lani/academic_commission_website/blob/main/public/offer.php): `public/offer.php`

### Order lifecycle

- [Order management](https://github.com/dev-lani/academic_commission_website/blob/main/public/order.php): `public/order.php`
- [Order actions](https://github.com/dev-lani/academic_commission_website/blob/main/public/order_action.php): `public/order_action.php`
- [Delivery upload](https://github.com/dev-lani/academic_commission_website/blob/main/public/deliver.php): `public/deliver.php`
- [Timed preview](https://github.com/dev-lani/academic_commission_website/blob/main/public/preview.php): `public/preview.php`
- [File download](https://github.com/dev-lani/academic_commission_website/blob/main/public/download.php): `public/download.php`
- [Transactions](https://github.com/dev-lani/academic_commission_website/blob/main/public/transactions.php): `public/transactions.php`

### Communication and admin

- [Order chat](https://github.com/dev-lani/academic_commission_website/blob/main/public/chat.php): `public/chat.php`
- [Messages](https://github.com/dev-lani/academic_commission_website/blob/main/public/messages.php): `public/messages.php`
- [Dispute administration](https://github.com/dev-lani/academic_commission_website/blob/main/public/admin/order.php): `public/admin/order.php`
- [Admin console](https://github.com/dev-lani/academic_commission_website/blob/main/public/admin/index.php): `public/admin/index.php`

### Application runtime

- [MySQL database](https://github.com/dev-lani/academic_commission_website/blob/main/src/database.php): `src/database.php`
- [Private file storage](https://github.com/dev-lani/academic_commission_website/blob/main/src/config.php): `src/config.php`
- [Bootstrap](https://github.com/dev-lani/academic_commission_website/blob/main/src/bootstrap.php): `src/bootstrap.php`
- [Shared helpers](https://github.com/dev-lani/academic_commission_website/blob/main/src/helpers.php): `src/helpers.php`
- [Order logic](https://github.com/dev-lani/academic_commission_website/blob/main/src/order_lib.php): `src/order_lib.php`
- [Chat logic](https://github.com/dev-lani/academic_commission_website/blob/main/src/chat_lib.php): `src/chat_lib.php`
- [Authentication](https://github.com/dev-lani/academic_commission_website/blob/main/src/auth.php): `src/auth.php`
- [Cache](https://github.com/dev-lani/academic_commission_website/blob/main/src/cache.php): `src/cache.php`
- [Reputation logic](https://github.com/dev-lani/academic_commission_website/blob/main/src/reputation.php): `src/reputation.php`

### Other components

- **Client**
- **Commissioner**
- **Administrator**

## Connections

- Client → Registration: creates account (evidence: `README.md`)
- Client → Request creation: posts request (evidence: `README.md`)
- Commissioner → Request forum: browses requests (evidence: `README.md`)
- Request forum → Request details: opens request
- Commissioner → Private offers: sends offer (evidence: `README.md`)
- Client → Order management: accepts offer (evidence: `README.md`)
- Commissioner → Delivery upload: delivers work
- Client → Timed preview: reviews delivery (evidence: `README.md`)
- Timed preview → Private file storage: reads preview file (evidence: `public/preview.php`)
- Timed preview → MySQL database: logs preview views (evidence: `public/preview.php`)
- Client → Order actions: approves or disputes (evidence: `README.md`)
- Client → Saved requests: saves requests (evidence: `README.md`)
- Client → Order chat: chats on orders
- Commissioner → Profiles and skills: updates profile (evidence: `README.md`)
- Administrator → Admin console: manages marketplace (evidence: `public/admin/index.php`)
- Admin console → Dispute administration: opens dispute (evidence: `public/admin/index.php`)
- Bootstrap → MySQL database: loads connection (evidence: `src/bootstrap.php`)
- Bootstrap → Cache: loads module (evidence: `src/bootstrap.php`)
- Bootstrap → Shared helpers: loads module (evidence: `src/bootstrap.php`)
- Bootstrap → Authentication: loads module (evidence: `src/bootstrap.php`)
- Bootstrap → Reputation logic: loads module (evidence: `src/bootstrap.php`)
- Bootstrap → Order logic: loads module (evidence: `src/bootstrap.php`)
- Bootstrap → Chat logic: loads module (evidence: `src/bootstrap.php`)
- Admin console → MySQL database: queries accounts and disputes (evidence: `public/admin/index.php`)
- Dispute administration → MySQL database: reads dispute records (evidence: `public/admin/order.php`)
- Account access → Bootstrap: initializes app
- Request creation → Bootstrap: initializes app
- Order management → Order logic: uses order rules
- Order chat → Chat logic: uses chat functions
