nowo-tech / crm-kit-bundle
A CRM for Symfony organisations: companies and contacts with custom fields, tags, owners, notes, an activity timeline, CSV / vCard import, duplicate merging and a 360° page with host panels; tenant-aware, deny by default, GDPR-ready, on a private entity manager with a UiKit + FormKit UI. Pipeline, q
Package info
github.com/nowo-tech/CrmKitBundle
Type:symfony-bundle
pkg:composer/nowo-tech/crm-kit-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/form-kit-bundle: ^2.23
- nowo-tech/transaction-contract: ^1.0
- nowo-tech/transaction-doctrine: ^1.6
- nowo-tech/ui-kit-bundle: ^2.55
- 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-foundation: ^7.4 || ^8.0
- symfony/http-kernel: ^7.4 || ^8.0
- symfony/routing: ^7.4 || ^8.0
- symfony/security-csrf: ^7.4 || ^8.0
- symfony/string: ^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)
- friendsofphp/php-cs-fixer: ^3.0
- igor-php/igor-php: ^0.10.1
- nowo-tech/phpstan-frankenphp: ^1.3
- 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/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
- nowo-tech/search-kit-bundle: Header search provider for companies and contacts (SearchKit >= 1.7, PHP >= 8.3)
- symfony/flex: Automatic recipe installation (declares the private entity manager)
- symfony/security-bundle: Default role-map access checker and actor directory
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-19 13:40:10 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 CRM for Symfony applications: companies and contacts with owners, tags, custom fields, notes, an activity timeline, CSV / vCard import and export, duplicate merging, GDPR consent / export / erasure and a 360° record page that shows your own modules through host panels. Tenant-aware, deny by default, on a private entity manager, with a UiKit + FormKit UI.
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.0 released (companies and contacts); 0.2.0 in progress (party roles, the company's primary contact and affiliation purposes). Funnels, tasks and agenda, quotes, invoices, a customer portal, scoring, segments, informative circulars and reports follow phase by phase 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
Phase A (0.1.0), always on when the bundle is enabled:
- Companies and contacts: core fields, owners (people of your application), tags, custom fields per tenant (text, textarea, number, date, boolean, choice, url, email), trash with restore and purge.
- Party roles (0.2.0): one entity for customers, suppliers, partners and so on: a company or a contact holds any
number of roles from a configurable catalogue (
customer,supplier,partner;distributoropt-in), filtered in the lists, imported and exported. - Affiliations: a contact belongs to any number of companies, each with a role, one of them primary; a company has at most one primary contact, and each affiliation says what the contact is for (purposes: billing, orders, technical, general; configurable).
- Notes and timeline: plain-text notes (pinned first) and an append-only activity timeline per record; a company's timeline includes its contacts' entries; your application adds its own entries.
- 360° page: details, contacts / companies, host links (your projects, tickets and so on, referenced by id and resolved by your code on every view), host panels (your read models), notes, timeline, possible duplicates, consents.
- Import and export: CSV (
,or;) and vCard 3.0 / 4.0 import with a preview, an editable column mapping and a duplicate policy; CSV export of a filtered list (formula cells neutralised) and a vCard 4.0 per contact. - Duplicates and merging: hints by name, website domain and tax id (companies) or sort name (contacts); a field-by-field merge that moves every child row and keeps a snapshot.
- GDPR: consent per contact and purpose (append-only), a JSON export, an erasure that keeps consent proof without its evidence, and a retention purge.
- Plan limits: atomic counters per tenant, so two creates at the limit can never both pass.
- Header search: two SearchKit providers when
nowo-tech/search-kit-bundleis installed. - Private entity manager
nowo_crm_kit, declared by the Flex recipe, so the bundle never flushes the host's unit of work; every write is a transaction-doctrine write unit (409 withCONFLICT_001/CONFLICT_002).
Built phase by phase: companies and contacts (0.1) → roles and purposes (0.2) → funnels (0.3) → tasks and agenda (0.4) → quotes (0.5) → invoices (0.6) → customer portal (0.7) → scoring (0.8) → lists and segments (0.9) → informative circulars (0.10) → reports (1.0).
Installation
composer require nowo-tech/crm-kit-bundle
See docs/INSTALLATION.md.
Configuration
# config/packages/nowo_crm_kit.yaml nowo_crm_kit: doctrine: entity_manager: nowo_crm_kit security: # REQ-UI-002: also lock the path with access_control in security.yaml access_roles: [ROLE_USER] manage_roles: [ROLE_USER] settings_roles: [ROLE_ADMIN] export_roles: [ROLE_ADMIN] erase_roles: [ROLE_ADMIN] ui: enabled: true
# config/routes/nowo_crm_kit.yaml nowo_crm_kit: resource: . type: nowo_crm_kit_ui prefix: /admin
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/form-kit-bundle^2.23,nowo-tech/transaction-doctrine^1.6,nowo-tech/transaction-contract^1.0- Optional:
nowo-tech/search-kit-bundle^1.7 (header search; SearchKit needs PHP >= 8.3),symfony/security-bundle(default access checker and actor directory)
Demo
demo/symfony7 (Symfony 7.4, http://localhost:8263) and demo/symfony8 (Symfony 8.1, http://localhost:8262):
FrankenPHP worker mode, MySQL, UiKit + FormKit, in-memory users ana, mia 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
- Contract
- Architecture
- Concurrency
- FrankenPHP worker audit
- Demo with FrankenPHP
- PSR compliance
- GitHub CI
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, two-connection race tests included (docs/CONCURRENCY.md).
License
MIT. See LICENSE.
Author
Created by Héctor Franco Aceituno at Nowo.tech.
