z77 / module-dms

1.5.0 2026-08-31 06:08 UTC

Requires

• php: >=8.2
• ext-gd: *
• z77/kernel: ^1.0

MIT

• Peter Ruepp

• framework
• php
• dms
• documents
• z77

Published on Packagist.org on 2026-09-02 15:51 UTC

README

The document management module (ADR-017). Owns the user-facing DMS surfaces and the authorized byte delivery. Depends on z77/kernel. Built incrementally by the DMS rebuild plan (docs/03-development/dms-umbauplan.md). Read-only split from z77-ch/z77-framework. Do not commit here.

Current scope (R4c)

• OutputController (Ui/Controllers/Media/OutputController.php) — the GUEST output endpoint behind the /media reserved route. It resolves a structural /media/{area}/{folder…}/{file} path to a document + variant (DocumentService::resolve), branches on the effective deliveryMode (public = open; protected/sealed = AclService::canRead ACL + active gate before any byte), and returns a FileResponse (portable PHP range-stream) or 404 — existence is never leaked.

The /media reserved route is registered in App/Config/dmsConfig.inc.php and replaces the former MediaController + /media NavigationAlias.

Planned (later phases)

• Logged-in user / admin "drive" management surface (R6).
• Share controller + supplier upload + API auth (R7).

Getting started

Don't start a project with composer require. Use the z77-skeleton template — Use this template → composer install. It wires all four packages, the installer, and the override structure. composer require z77/module-dms only adds this module to an existing z77 project.