README

The kernel contracts of the CoolMS platform. Entity vocabulary, persistence-neutral mapping attributes, domain events, and the seams every module implements.

Four dependencies, all Symfony components. No ORM, no framework, no bundle.

use CoolMS\Core\Identifier\IdentifierProviderTrait;
use CoolMS\Core\Mapping\Column;
use CoolMS\Core\Model\AggregateRootInterface;

class OutboxRecord implements AggregateRootInterface
{
    use IdentifierProviderTrait;

    public function __construct(
        #[Column(type: 'string')]
        public string $type,
    ) {}
}

That entity is mapped by whichever persistence adapter is installed. It names none of them.

Installation

composer require coolms/core

On its own this package gives you contracts and value objects. To persist anything you also need an adapter — see Persistence.

What is in here

Persistence

The mapping attributes are declarations; something has to read them. A persistence adapter package provides coolms/core-persistence-implementation and does the reading:

composer require coolms/core-doctrine

The attribute vocabulary is deliberately small — the columns the traits actually use, and nothing else. It is a translation, not a second mapping layer: the moment it grows associations or inheritance, there are two schemas to keep in step instead of one.

Related packages

License

MIT. See LICENSE.