# wordpress/wordpress.org architecture

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

- Interactive diagram: https://gitdiagram.com/wordpress/wordpress.org
- Repository: https://github.com/wordpress/wordpress.org

## Overview

This is WordPress.org’s multi-site application repository, spanning public APIs, support operations, identity, and community integrations. One concrete workflow is an administrator starting a FreeScout mailbox import: the controller creates a run and queues paginated work, which reads the source API, resolves people, and imports conversations. Other substantial branches include plugin-review support, WordPress.org SSO, the Composer package API, and Slack/Trac integrations. The repository README describes GitHub automation rather than these runtime products; unsampled branches are included from the tree and index, but their internal call paths are not asserted.

Main entry points: [`freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php`](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php) (FreeScout Import), [`freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Jobs/ImportPage.php`](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Jobs/ImportPage.php) (Page Import Job), [`freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/RemoteApi.php`](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/RemoteApi.php) (Source API Client), [`freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Entities/Run.php`](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Entities/Run.php) (Import Run)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_imports["Support Imports"]
  node_free_controller["FreeScout Import"]
  node_import_run[("Import Run<br/>[Run.php]")]
  node_page_job["Page Import Job<br/>[ImportPage.php]"]
  node_remote_api["Source API Client<br/>[RemoteApi.php]"]
  node_people["People Resolver<br/>[People.php]"]
  node_importer["Conversation Importer<br/>[Importer.php]"]
  node_import_records[("Import Records")]
end

subgraph group_reviews["Plugin Reviews"]
  node_review_provider["Review Integration"]
  node_review_service[("Review Index<br/>[Review.php]")]
  node_review_subject["Subject Formatter<br/>[Subject.php]"]
end

subgraph group_identity["Identity"]
  node_sso_controller["SSO Controller<br/>[SsoController.php]"]
  node_sso_client["WordPress.org Client<br/>[Client.php]"]
end

subgraph group_apis["Public APIs"]
  node_composer_api["Composer Repository"]
end

subgraph group_community["Community Integrations"]
  node_slack_hooks["Slack and Trac"]
  node_trac_mentions["Trac Mentions"]
end

node_admin(("Support Admin"))
node_remote_freescout["Source FreeScout"]
node_login_idp["WordPress.org Login"]
node_plugin_api["Plugin Directory API"]
node_theme_api["Theme Directory API"]

node_admin -->|"starts import"| node_free_controller
node_free_controller -->|"checks mailboxes"| node_remote_api
node_free_controller -->|"creates run"| node_import_run
node_free_controller -->|"queues work"| node_page_job
node_free_controller -->|"reads run state"| node_import_run
node_page_job -->|"updates progress"| node_import_run
node_page_job -->|"fetches pages"| node_remote_api
node_page_job -->|"imports conversations"| node_importer
node_page_job -->|"resolves people"| node_people
node_remote_api -.->|"reads source data"| node_remote_freescout
node_importer -.->|"writes conversations"| node_import_records
node_review_provider -->|"uses review index"| node_review_service
node_review_service -->|"formats subjects"| node_review_subject
node_sso_controller -->|"redirects for login"| node_login_idp
node_sso_controller -->|"uses account client"| node_sso_client
node_composer_api -->|"queries plugin data"| node_plugin_api
node_composer_api -->|"queries theme data"| node_theme_api

click node_free_controller "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php"
click node_import_run "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Entities/Run.php"
click node_page_job "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Jobs/ImportPage.php"
click node_remote_api "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/RemoteApi.php"
click node_people "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/People.php"
click node_importer "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/Importer.php"
click node_import_records "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Entities/ImportedConversation.php"
click node_review_provider "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgPluginReview/Providers/WPOrgPluginReviewServiceProvider.php"
click node_review_service "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgPluginReview/Services/Review.php"
click node_review_subject "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgPluginReview/Services/Subject.php"
click node_sso_controller "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgSSO/Http/Controllers/SsoController.php"
click node_sso_client "https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgSSO/Services/Client.php"
click node_composer_api "https://github.com/wordpress/wordpress.org/blob/trunk/api.wordpress.org/public_html/packages/includes/class-composer-repository.php"
click node_slack_hooks "https://github.com/wordpress/wordpress.org/blob/trunk/common/includes/slack/trac/comment-handler.php"
click node_trac_mentions "https://github.com/wordpress/wordpress.org/blob/trunk/api.wordpress.org/public_html/dotorg/trac/mentions-handler.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_free_controller,node_import_run,node_page_job,node_remote_api,node_people,node_importer,node_import_records toneBlue
class node_review_provider,node_review_service,node_review_subject toneAmber
class node_sso_controller,node_sso_client,node_plugin_api,node_theme_api toneMint
class node_composer_api toneRose
class node_slack_hooks,node_trac_mentions,node_admin,node_remote_freescout,node_login_idp toneIndigo
```

## Components

### Support Imports

- [FreeScout Import](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php): `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php`
- [Import Run](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Entities/Run.php): `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Entities/Run.php`
- [Page Import Job](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Jobs/ImportPage.php): `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Jobs/ImportPage.php`
- [Source API Client](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/RemoteApi.php): `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/RemoteApi.php`
- [People Resolver](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/People.php): `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/People.php`
- [Conversation Importer](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/Importer.php): `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Services/Importer.php`
- [Import Records](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Entities/ImportedConversation.php): `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Entities/ImportedConversation.php`

### Plugin Reviews

- [Review Integration](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgPluginReview/Providers/WPOrgPluginReviewServiceProvider.php): `freescout.wordpress.net/Modules/WPOrgPluginReview/Providers/WPOrgPluginReviewServiceProvider.php`
- [Review Index](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgPluginReview/Services/Review.php): `freescout.wordpress.net/Modules/WPOrgPluginReview/Services/Review.php`
- [Subject Formatter](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgPluginReview/Services/Subject.php): `freescout.wordpress.net/Modules/WPOrgPluginReview/Services/Subject.php`

### Identity

- [SSO Controller](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgSSO/Http/Controllers/SsoController.php): `freescout.wordpress.net/Modules/WPOrgSSO/Http/Controllers/SsoController.php`
- [WordPress.org Client](https://github.com/wordpress/wordpress.org/blob/trunk/freescout.wordpress.net/Modules/WPOrgSSO/Services/Client.php): `freescout.wordpress.net/Modules/WPOrgSSO/Services/Client.php`

### Public APIs

- [Composer Repository](https://github.com/wordpress/wordpress.org/blob/trunk/api.wordpress.org/public_html/packages/includes/class-composer-repository.php): `api.wordpress.org/public_html/packages/includes/class-composer-repository.php`

### Community Integrations

- [Slack and Trac](https://github.com/wordpress/wordpress.org/blob/trunk/common/includes/slack/trac/comment-handler.php): `common/includes/slack/trac/comment-handler.php`
- [Trac Mentions](https://github.com/wordpress/wordpress.org/blob/trunk/api.wordpress.org/public_html/dotorg/trac/mentions-handler.php): `api.wordpress.org/public_html/dotorg/trac/mentions-handler.php`

### Other components

- **Support Admin**
- **Source FreeScout**
- **WordPress.org Login**
- **Plugin Directory API**
- **Theme Directory API**

## Connections

- Support Admin → FreeScout Import: starts import (evidence: `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php`)
- FreeScout Import → Source API Client: checks mailboxes (evidence: `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php`)
- FreeScout Import → Import Run: creates run (evidence: `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php`)
- FreeScout Import → Page Import Job: queues work (evidence: `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php`)
- FreeScout Import → Import Run: reads run state (evidence: `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Http/Controllers/ImportController.php`)
- Page Import Job → Import Run: updates progress (evidence: `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Jobs/ImportPage.php`)
- Page Import Job → Source API Client: fetches pages (evidence: `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Jobs/ImportPage.php`)
- Page Import Job → Conversation Importer: imports conversations (evidence: `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Jobs/ImportPage.php`)
- Page Import Job → People Resolver: resolves people (evidence: `freescout.wordpress.net/Modules/WPOrgFreeScoutImport/Jobs/ImportPage.php`)
- Source API Client → Source FreeScout: reads source data
- Conversation Importer → Import Records: writes conversations
- Review Integration → Review Index: uses review index (evidence: `freescout.wordpress.net/Modules/WPOrgPluginReview/Providers/WPOrgPluginReviewServiceProvider.php`)
- Review Index → Subject Formatter: formats subjects (evidence: `freescout.wordpress.net/Modules/WPOrgPluginReview/Services/Review.php`)
- SSO Controller → WordPress.org Login: redirects for login (evidence: `freescout.wordpress.net/Modules/WPOrgSSO/Http/Controllers/SsoController.php`)
- SSO Controller → WordPress.org Client: uses account client (evidence: `freescout.wordpress.net/Modules/WPOrgSSO/Http/Controllers/SsoController.php`)
- Composer Repository → Plugin Directory API: queries plugin data (evidence: `api.wordpress.org/public_html/packages/includes/class-composer-repository.php`)
- Composer Repository → Theme Directory API: queries theme data (evidence: `api.wordpress.org/public_html/packages/includes/class-composer-repository.php`)
