Merge branch 'architecture-md'

Author: codedmonkey

AGENTS.md

@@ -2,38 +2,9 @@
 
 Dirigent is a free and open package registry for Composer, the PHP package manager. It allows users to publish private packages and mirror packages from external registries like Packagist.
 
-### Project structure
+## Architecture
 
-```
-assets/                         # Frontend assets
-config/                         # Symfony configuration
-migrations/                     # Doctrine migrations (PostgreSQL)
-src/
-├── Attribute/                  # PHP attributes
-├── Command/                    # Symfony console commands
-├── Composer/                   # Composer integration logic
-├── Controller/                 # HTTP controllers
-│   └── Dashboard/              # EasyAdmin dashboard controllers
-├── Doctrine/
-│   ├── Entity/                 # Doctrine ORM entities
-│   ├── Repository/             # Doctrine repositories
-│   ├── Type/                   # Custom Doctrine types
-│   └── DataFixtures/           # Database fixtures
-├── Encryption/                 # Encryption utilities
-├── Entity/                     # Enums (UserRole, PackageUpdateSource)
-├── EventListener/              # Symfony event listeners
-├── Form/                       # Symfony form types
-├── Message/                    # Symfony messenger messages and handlers (async jobs)
-├── Package/                    # Package management services
-├── Routing/                    # Symfony routing logic
-├── Twig/                       # Twig extensions
-└── Validator/                  # Symfony validators
-templates/                      # Twig templates
-tests/
-├── UnitTests/                  # Unit tests
-├── FunctionalTests/            # Functional/Integration tests
-└── Docker/                     # Docker image tests
-```
+@ARCHITECTURE.md
 
 ## Coding style
 

ARCHITECTURE.md

@@ -0,0 +1,58 @@
+# Dirigent architecture
+
+## Technology stack
+
+- **Languages & frameworks**:
+    - PHP 8.3+
+    - Symfony 7.3
+    - PostgreSQL 16.x (via Doctrine ORM 3.x)
+    - TypeScript
+- **Development requirements**:
+    - Docker
+    - Symfony CLI
+- **Package managers**:
+    - **PHP**: Composer
+    - **TypeScript**: NPM
+- **Frontend**: Twig, EasyAdmin 4.x
+- **Frontend (JavaScript)**: Webpack Encore, Stimulus
+- **Linting**: Rector, PHP-CS-Fixer, PHPStan
+- **Testing**: PHPUnit 12.x, Testcontainers
+
+## Directory structure
+
+```
+assets/                         # Frontend assets
+config/                         # Symfony configuration
+migrations/                     # Doctrine migrations (PostgreSQL)
+src/
+├── Attribute/                  # PHP attributes
+├── Command/                    # Symfony console commands
+├── Composer/                   # Composer integration logic
+├── Controller/                 # HTTP controllers
+│   └── Dashboard/              # EasyAdmin dashboard controllers
+├── Doctrine/
+│   ├── Entity/                 # Doctrine ORM entities
+│   ├── Repository/             # Doctrine repositories
+│   ├── Type/                   # Custom Doctrine types
+│   └── DataFixtures/           # Database fixtures
+├── Encryption/                 # Encryption utilities
+├── Entity/                     # Enums (UserRole, PackageUpdateSource)
+├── EventListener/              # Symfony event listeners
+├── Form/                       # Symfony form types
+├── Message/                    # Symfony messenger messages and handlers (async jobs)
+├── Package/                    # Package management services
+├── Routing/                    # Symfony routing logic
+├── Twig/                       # Twig extensions
+└── Validator/                  # Symfony validators
+templates/                      # Twig templates
+tests/
+├── UnitTests/                  # Unit tests
+├── FunctionalTests/            # Functional/Integration tests
+└── Docker/                     # Docker image tests
+```
+
+## Coding style
+
+### PHP
+
+Dirigent follows the [PER coding style][per-coding-style] and the [Symfony coding standards][symfony-coding-standards].

CONTRIBUTING.md

@@ -1,36 +1,14 @@
 # Contributing to Dirigent
 
-Dirigent is an open-source project, contributions of all kind are welcome, including
+Dirigent is an open-source project, contributions of all kinds are welcome, including
 [financial contributions][codedmonkey-sponsor].
 
-This guide contains technical information and instructions about the development process of the project that you should
+This guide contains instructions about the development process of the project that you should
 follow when contributing code.
 
-## Project information
+## Architecture
 
-### Technology stack
-
-- **Languages & frameworks**:
-    - PHP 8.3+
-    - Symfony 7.3
-    - PostgreSQL 16.x (via Doctrine ORM 3.x)
-    - TypeScript
-- **Development requirements**:
-    - Docker
-    - Symfony CLI
-- **Package managers**:
-    - **PHP**: Composer
-    - **TypeScript**: NPM
-- **Frontend**: Twig, EasyAdmin 4.x
-- **Frontend (JavaScript)**: Webpack Encore, Stimulus
-- **Linting**: Rector, PHP-CS-Fixer, PHPStan
-- **Testing**: PHPUnit 12.x, Testcontainers
-
-### Coding style
-
-#### PHP
-
-Dirigent follows the [PER coding style][per-coding-style] and the [Symfony coding standards][symfony-coding-standards].
+For an overview of the architecture of this project, see [ARCHITECTURE.md](./ARCHITECTURE.md).
 
 ## Running Dirigent locally