Files

fs 0c78dc4355 chore(setup): track config.php directly, slim README to setup checklist

config/config.php was gitignored and devs had to copy it from
config/config.php.example on every fresh clone. Since the bootstrap
config reads everything from .env via $envString() / $envInt() /
$envBool() defaults, there is nothing developer-specific in the file —
the cp step was dead ceremony.

- Remove config/config.php from .gitignore and track it directly
- Delete config/config.php.example
- Drop the example-existence + per-doc reference checks from
  bin/docs-drift-check.sh; add a legacy-pattern check that flags
  any new mention of the removed example file
- Update ConfigContractsTest to require config.php and forbid the
  example
- Clean stale references in CLAUDE.md, README.md, six docs files,
  and the core-guardrails skill

Same commit slims README down from 294 to 47 lines: one setup
checklist (now 3 commands instead of 4), the seeded login table,
the three quality-gate commands, and pointers to CLAUDE.md and
docs/index.md for everything else.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-29 08:37:45 +02:00

4.5 KiB

Raw Blame History

CLI-Kommandoreferenz

Letzte Aktualisierung: 2026-04-01

Einstiegspunkt

Alle CLI-Kommandos laufen ueber einen einzigen Einstiegspunkt:

php bin/console <command> [argumente] [optionen]

Uebersicht aller verfuegbaren Kommandos:

php bin/console list

Hilfe zu einem einzelnen Kommando:

php bin/console <command> --help

Kommandos

module:sync

Fuehrt den vollstaendigen Modul-Runtime-Sync aus: migrate → permissions-sync → build → assets-sync.

docker compose exec php php bin/console module:sync

Noetig nach jeder Aenderung an Modulen, Manifesten, Routen oder APP_ENABLED_MODULES.

Falls web/index.php den Fehler "Module runtime is stale" wirft, ist dieser Befehl die Loesung.

Maschinenlesbar:

docker compose exec php php bin/console module:sync --format=json

module:migrate

Wendet ausstehende SQL-Migrationen aus aktiven Modulen an.

docker compose exec php php bin/console module:migrate

module:permissions-sync

Synchronisiert Modul-Permissions in die DB. Deaktiviert verwaiste System-Permissions (is_system=1), die kein aktives Modul mehr beansprucht.

docker compose exec php php bin/console module:permissions-sync

module:build

Baut die Runtime-Seitenstruktur (storage/runtime/pages/) mit Symlinks zu Modul-Pages.

docker compose exec php php bin/console module:build

module:assets-sync

Publiziert Modul-Assets nach web/modules/<id>/.

docker compose exec php php bin/console module:assets-sync

module:deactivate

Fuehrt den optionalen Deactivation-Handler eines Moduls aus.

docker compose exec php php bin/console module:deactivate <module-id> --confirm
docker compose exec php php bin/console module:deactivate <module-id> --dry-run

Das Modul muss nicht in der Aktivliste stehen. --dry-run validiert den Handler ohne Ausfuehrung.

scheduler:run

Fuehrt faellige Scheduler-Jobs aus.

docker compose exec php php bin/console scheduler:run

Der Docker-Scheduler-Service ruft dieses Kommando automatisch alle 60 Sekunden auf.

module:validate

Validiert Manifest, Klassen und Struktur eines Moduls. Prueft JSON-Schema-Compliance des module.php, Namespace-Konventionen, Interface-Implementierungen, Permission-Key-Formate und Verzeichnisstruktur.

docker compose exec php php bin/console module:validate <module-id>
docker compose exec php php bin/console module:validate --all

--all validiert alle Module auf Disk (modules/*/module.php) auf einmal.

make:module

Erzeugt die vollstaendige Verzeichnisstruktur fuer ein neues Modul inkl. Manifest, ContainerRegistrar-Stub, AuthorizationPolicy-Stub und leeren Verzeichnissen.

docker compose exec php php bin/console make:module <module-id>

Argument module-id muss dem Pattern [a-z][a-z0-9-]* entsprechen.

doctor

Fuehrt System-Gesundheitschecks aus (ENV, DB, RBAC, Scheduler-Heartbeat).

docker compose exec php php bin/console doctor

Siehe /docs/howto-betriebscheck-doctor.md fuer Details.

Maschinenlesbar:

docker compose exec php php bin/console doctor --format=json

Developer-Orchestrator (`bin/dev`)

Fuer lokalen Workflow gibt es zusaetzlich den Dev-Orchestrator:

bin/dev init
bin/dev up
bin/dev down
bin/dev logs [service]
bin/dev console module:sync
bin/dev qa
bin/dev qa-required
bin/dev qa-extended

bin/dev console ... delegiert intern auf docker compose exec -T php php bin/console .... bin/dev qa ist ein Alias fuer bin/dev qa-required.

Neue Kommandos anlegen

Klasse in core/Console/Commands/ erstellen, die MintyPHP\Console\Command erweitert.
name(), description() und execute() implementieren.
Optional: usage() fuer --help-Ausgabe ueberschreiben.

Das Kommando wird automatisch erkannt — kein manuelles Registrieren noetig.

Beispiel:

namespace MintyPHP\Console\Commands\Make;

use MintyPHP\Console\Command;

final class ModuleCommand extends Command
{
    public function name(): string { return 'make:module'; }
    public function description(): string { return 'Scaffold a new module'; }

    public function execute(array $args, array $options): int
    {
        // ...
        return 0;
    }
}

Bootstrap-Helfer

Die Command-Basisklasse stellt Helfer bereit:

Methode	Zweck
`$this->bootstrapApp($channel)`	App-Bootstrap fuer Nicht-Modul-Kommandos
`$this->projectRoot()`	Gibt den absoluten Projekt-Root-Pfad zurueck

4.5 KiB Raw Blame History