Search by

nowo-tech / crm-kit-bundle

HecFranco

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

Documentation

Type:symfony-bundle

pkg:composer/nowo-tech/crm-kit-bundle

Fund package maintenance!

HecFranco

Statistics

Installs: 3

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 2

v0.2.0 2026-11-19 12:27 UTC

README

CI Packagist Version Packagist Downloads License PHP Symfony GitHub stars Coverage

⭐ 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+)

FrankenPHP Friendly Worker Mode

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; distributor opt-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-bundle is 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 with CONFLICT_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

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, two-connection race tests included (docs/CONCURRENCY.md).

License

MIT. See LICENSE.

Author

Created by Héctor Franco Aceituno at Nowo.tech.