nowo-tech / working-time-bundle
Working time for Symfony: a working-hours register (art. 34.9 ET) with a tamper-evident hash chain, public holidays and leave in one bundle with three parts that can be switched on separately, a private entity manager, a UiKit + FormKit UI and bridges to the Nowo bundles.
Package info
github.com/nowo-tech/WorkingTimeBundle
Type:symfony-bundle
pkg:composer/nowo-tech/working-time-bundle
Fund package maintenance!
Requires
- php: >=8.2 <8.6
- doctrine/dbal: ^3.8.2 || ^4.0
- doctrine/doctrine-bundle: ^2.8 || ^3.0
- doctrine/orm: ^3.7
- doctrine/persistence: ^3.4 || ^4.0
- nowo-tech/brand-contracts: ^1.0
- nowo-tech/form-kit-bundle: ^2.22
- nowo-tech/outbound-url-guard-bundle: ^1.5
- nowo-tech/transaction-contract: ^1.0
- nowo-tech/transaction-doctrine: ^1.3
- nowo-tech/ui-kit-bundle: ^2.55
- psr/cache: ^2.0 || ^3.0
- psr/clock: ^1.0
- psr/log: ^2.0 || ^3.0
- symfony/clock: ^7.4 || ^8.0
- symfony/config: ^7.4 || ^8.0
- symfony/console: ^7.4 || ^8.0
- symfony/dependency-injection: ^7.4 || ^8.0
- symfony/event-dispatcher: ^7.4 || ^8.0
- symfony/form: ^7.4 || ^8.0
- symfony/framework-bundle: ^7.4 || ^8.0
- symfony/http-client: ^7.4 || ^8.0
- symfony/http-foundation: ^7.4 || ^8.0
- symfony/http-kernel: ^7.4 || ^8.0
- symfony/mime: ^7.4 || ^8.0
- symfony/routing: ^7.4 || ^8.0
- symfony/security-csrf: ^7.4 || ^8.0
- symfony/translation: ^7.4 || ^8.0
- symfony/twig-bundle: ^7.4 || ^8.0
- symfony/uid: ^7.4 || ^8.0
- symfony/validator: ^7.4 || ^8.0
- twig/extra-bundle: ^3.12
- twig/string-extra: ^3.12
Requires (Dev)
- dompdf/dompdf: ^3.1
- friendsofphp/php-cs-fixer: ^3.0
- igor-php/igor-php: ^0.10.1
- nowo-tech/phpstan-frankenphp: ^1.3
- nowo-tech/time-track-bundle: ^1.28
- nowo-tech/user-kit-bundle: ^1.19
- phpstan/extension-installer: ^1.4
- phpstan/phpstan: ^2.0
- phpstan/phpstan-phpunit: ^2.0
- phpstan/phpstan-symfony: ^2.0
- phpunit/phpunit: ^11.5
- rector/rector: ^2.0
- symfony/browser-kit: ^7.4 || ^8.0
- symfony/cache: ^7.4 || ^8.0
- symfony/css-selector: ^7.4 || ^8.0
- symfony/dom-crawler: ^7.4 || ^8.0
- symfony/filesystem: ^7.4 || ^8.0
- symfony/lock: ^7.4 || ^8.0
- symfony/mailer: ^7.4 || ^8.0
- symfony/messenger: ^7.4 || ^8.0
- symfony/phpunit-bridge: ^7.4 || ^8.0
- symfony/process: ^7.4 || ^8.0
- symfony/security-bundle: ^7.4 || ^8.0
- symfony/yaml: ^7.4 || ^8.0
Suggests
- dompdf/dompdf: PDF export of the register (closed rendering: no remote resources, JS or PHP)
- nowo-tech/audit-kit-bundle: Audit sink
- nowo-tech/http-log-bundle: Provider names on outbound calls
- nowo-tech/legal-kit-bundle: Privacy-notice section
- nowo-tech/notify-kit-bundle: Notifier
- nowo-tech/storage-kit-bundle: Attachments and export files
- nowo-tech/task-board-bundle: Calendar day annotations
- nowo-tech/time-track-bundle: TimeTrack bridge
- nowo-tech/user-kit-bundle: GDPR export and eraser
- nowo-tech/workflow-bundle: Leave approval flow bridge
- symfony/flex: For automatic recipe installation (declares the private entity manager)
- symfony/lock: Leave lock backend lock_factory (shared store)
- symfony/mailer: Default notifier
- symfony/messenger: Export generation and notices outside the request
- symfony/security-bundle: Default role-map permission checker
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-17 21:58:41 UTC
README
⭐ Found this useful? Install it from Packagist and give it a star on GitHub: it helps us maintain and improve the project.
A working-hours register (art. 34.9 ET), public holidays and leave for Symfony, in one bundle with three parts that can be enabled separately, a private entity manager, a UiKit + FormKit UI and bridges to the other Nowo bundles.
Standard Symfony by default, DDD / hexagonal opt-in: zero configuration in a standard project; public ports are interfaces and value objects with no Symfony, Doctrine or HTTP types, the bundle-owned tables are mapped in XML and referenced by id, and the bundle never flushes your EntityManager.
🚧 Status: 0.1 (S1) — the working-hours register. Holidays (S2) and leave (S3) arrive slice by slice from docs/CONTRACT.md (docs/ROADMAP.md). Usage: docs/USAGE.md.
📋 Compatible with Symfony 7.4, 8.0 and 8.1 · PHP 8.2+ (Symfony 8.x requires PHP 8.4+)
This bundle is FrankenPHP worker mode friendly (kernel kept alive and not reset).
Features
Three parts, switched separately (register.enabled on, holidays.enabled on, leave.enabled off):
- Register: workdays and segments, clock state machine, schedules, corrections with approval, append-only revisions with a SHA-256 hash chain and database triggers, verifier, inspection export (PDF / CSV / ZIP), retention purge.
- Holidays (stand-alone): holiday calendars, work centres, providers (festivos.io, OpenHolidays, CSV / ICS import).
- Leave: leave types, allowances, requests with a per-worker lock, approval chain, team calendar, iCal, payroll CSV.
- Private entity manager
nowo_working_time, declared by the Flex recipe, so the bundle never flushes the host's unit of work. - Closed PDF rendering: no remote resources, no JavaScript, no PHP.
Built slice by slice: S0 scaffold → S1 register (0.1) → S2 holidays + leave foundations → S3 leave workflow.
Installation
composer require nowo-tech/working-time-bundle
See docs/INSTALLATION.md.
Configuration
# config/packages/nowo_working_time.yaml nowo_working_time: doctrine: entity_manager: nowo_working_time register: { enabled: true } holidays: { enabled: true } leave: { enabled: false }
Every key of the contract is already accepted (strict tree): docs/CONFIGURATION.md.
Requirements
- PHP >= 8.2, < 8.6 (Symfony 8.x needs PHP 8.4+)
- Symfony 7.4, 8.0 or 8.1
- Doctrine DBAL 3.8+ / 4 and ORM 3.7+ with DoctrineBundle
nowo-tech/ui-kit-bundle^2.55,nowo-tech/transaction-doctrine^1.3,nowo-tech/form-kit-bundle^2.22,nowo-tech/outbound-url-guard-bundle^1.5
Demo
demo/symfony7 (Symfony 7.4, http://localhost:8240) and demo/symfony8 (Symfony 8.1, http://localhost:8241):
FrankenPHP worker mode, MySQL, UiKit + FormKit, the register with in-memory users ana (worker), mia (manager) and
admin (password demo); make -C demo up-symfony8, then make test-e2e for the Playwright run. See docs/DEMO-FRANKENPHP.md.
Documentation
- Installation
- Configuration
- Usage
- Contributing
- Code of Conduct
- Changelog
- Upgrading
- Release
- Security
- Engram
- Spec-driven development
- GitHub Spec Kit
- Roadmap
Additional documentation
Tests and coverage
make test # PHPUnit in Docker make test-coverage-100 # fails below 100 % of src/ make test-with-db # Database suite on MySQL 8.4, MariaDB 11.4 and PostgreSQL 16 make release-check # every gate, demo included
- PHP: 100 % of
src/(gate in CI). Database suite on SQLite, MySQL 8.4, MariaDB 11.4 and PostgreSQL 16 in CI.
License
MIT. See LICENSE.
Author
Created by Héctor Franco Aceituno at Nowo.tech.
