Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 1m14s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 1m12s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 1m7s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 1m19s
CI / PHP 8.3 / mysql:8.0 (pull_request) Successful in 1m32s
CI / PHP 8.4 / mysql:8.0 (pull_request) Successful in 1m22s
CI / PHP 8.4 / mysql:8.4 (pull_request) Successful in 1m32s
CI / PHP 8.3 / mysql:8.4 (pull_request) Successful in 1m35s
CI / Build-Artefakte aktuell (pull_request) Failing after 1m7s
- Laravel 13 mit Filament 5 (Admin), Inertia 3 + Vue 3 + Vuetify 4 (Material 3) - Anmeldung über Fortify (Login, Passwort vergessen/ändern), keine Selbstregistrierung - Profil mit Profilbild (WebP in festen Größen), Personenseiten, Header mit Avatar-Menü - Material-3-Farbschema aus der Primärfarbe, hell/dunkel/System pro Person - Basis-Branding (Portalname, Logo, Primärfarbe) im Admin unter „Erscheinungsbild“ - Benutzerverwaltung im Admin, Zugang vorläufig über is_admin - vendor/ (ohne Dev-Pakete) und Frontend-Build mitversioniert, Dev-Pakete in vendor-dev/ - PHPUnit-Tests gegen MySQL/MariaDB, Forgejo-CI-Matrix, Docker-Entwicklungsumgebung - VERSION, CHANGELOG.md und CONTRIBUTING.md mit Release-Ablauf Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
47 lines
1.4 KiB
Markdown
47 lines
1.4 KiB
Markdown
# Contributing
|
|
|
|
Pull requests and issues are more than welcome.
|
|
|
|
## Getting started
|
|
|
|
```bash
|
|
composer install
|
|
```
|
|
|
|
## Running tests
|
|
|
|
```bash
|
|
composer test
|
|
# or directly:
|
|
vendor/bin/phpunit
|
|
```
|
|
|
|
## Running static analysis
|
|
|
|
```bash
|
|
composer analyse
|
|
```
|
|
|
|
This runs PHPStan and then Psalm. Both must pass.
|
|
|
|
## Which branch to target
|
|
|
|
See the [Version Support](README.md#version-support) table in the README for the full policy. In short:
|
|
|
|
- **`9.x`** — the active branch. Target this for new features, bug fixes, and PHP/PHPUnit compatibility work.
|
|
- **`8.x`** — maintenance only. Target this only for security fixes or low-risk maintenance (CI bumps, doc fixes).
|
|
- **`7.x` and older** — unsupported. Please upgrade instead of patching these.
|
|
|
|
## Before opening a pull request
|
|
|
|
- Run `composer test` and `composer analyse` locally — CI runs both across a wide PHP/PHPUnit matrix, but catching issues locally first saves a round trip.
|
|
- Keep the change focused; unrelated formatting/rewrites make a PR harder to review.
|
|
- If your change affects behavior (not just tooling/docs), add or update a test.
|
|
|
|
## Reporting security vulnerabilities
|
|
|
|
Please do **not** open a public issue or pull request for security vulnerabilities — see [SECURITY.md](SECURITY.md) for how to report privately.
|
|
|
|
## Questions
|
|
|
|
See [SUPPORT.md](SUPPORT.md) for where to ask questions or file bug reports.
|