breadcrumb-the-shire/README.md

The Shire

Anwendung auf Basis von MintyPHP (PHP 8.5, MariaDB 11, Nginx, Memcached, Docker). Liefert Tenants, User, Rollen, Adressbuch, Mail, Scheduler, Microsoft SSO und ein Helpdesk-Modul mit Business-Central-Anbindung.

Setup (frischer Clone)

cp .env.example .env                                  # 1. ENV (enthaelt APP_CRYPTO_KEY fuer Test-Secrets)
docker compose up --build -d                          # 2. Container starten + init.sql einspielen
docker compose exec php php bin/console module:sync   # 3. Modul-Migrationen + Asset-Publish

App: http://localhost:8080 · phpMyAdmin: http://localhost:8081

APP_CRYPTO_KEY aus .env.example nicht ändern — sonst lassen sich die geseeded Microsoft-SSO- und BC-Test-Secrets nicht entschlüsseln.

Login

Alle Demo-User haben das Passwort Demo123:

E-Mail	Rolle
demo@user.com	Admin
max@user.com	Manager
bernd@user.com	User
petra@user.com	Auditor
hilde@user.com	Support

Plus der Live-User fs@breadcrumb-solutions.de (alle Rollen, Passwort nur per Reset). Microsoft SSO ist für den Tenant breadcrumb mediasolutions GmbH vorkonfiguriert (Domain breadcrumb-solutions.de).

Quality Gates

docker compose exec php vendor/bin/phpunit                                    # Tests
docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon            # Static Analysis
docker compose exec php composer cs:fix                                       # Code Style autofix

Wo was steht

• Architektur, Konventionen, Guards — CLAUDE.md
• Tutorials, How-Tos, Referenzen — docs/index.md
• Production-Deployment — docs/howto-docker-produktiv.md
• Schema + Seed — db/init/init.sql, idempotente Updates in db/updates/
• Module — modules/<id>/ (eigene Migrationen unter modules/<id>/migrations/)