Most German docs were written with `ue`/`ae`/`oe`/`ss` ASCII fallbacks (`fuer`, `aenderung`, `koennen`, `gemaess`) — relic from older toolchain constraints. Replaced 237 occurrences across 38 .md files with proper umlauts and ß so the docs read naturally. Substitutions are constrained to plain prose: fenced code blocks (```...```), inline code spans (`...`), markdown link targets `[..](..)`, and HTML comments are preserved verbatim. Path references like `docs/howto-erste-aenderung.md` keep their original (umlaut-replaced) filenames — only the surrounding prose is normalised. Tool: bin/fix-md-umlauts.py (idempotent — no-op on already-clean files). Re-runnable if ASCII fallbacks creep back in via copy-paste. Doc-link-check + doc-drift-check stay green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
52 lines
1.9 KiB
Markdown
52 lines
1.9 KiB
Markdown
# CoreCore
|
|
|
|
Mandantenfaehige Admin-Anwendung auf 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)
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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/`)
|
|
|
|
## Lizenz
|
|
|
|
MIT (siehe `LICENSE.md`)
|