context7.json

{
  "$schema": "https://context7.com/schema/context7.json",
  "projectTitle": "Loggastic",
  "description": "Activity log bundle for Symfony: tracks entity changes and relations, storing activity logs in Elasticsearch or a relational database (Doctrine DBAL).",
  "folders": [],
  "excludeFolders": ["tests", ".github"],
  "excludeFiles": ["CHANGELOG.md", "SECURITY.md", "CODE_OF_CONDUCT.md", "CONTRIBUTING.md"],
  "rules": [
    "Requires PHP 8.2+, Symfony 6.4/7.x/8.x, and Doctrine ORM 3.4+. Storage backend: Elasticsearch 8 or 9 (default), any relational database via Doctrine DBAL, or in-memory for tests.",
    "Select the storage backend with the locastic_loggastic.storage config option: 'elasticsearch' (default, requires a PSR-18 HTTP client), 'doctrine' (stores logs in two shared database tables) or 'in_memory' (for test suites).",
    "Mark entities with the #[Loggable(groups: ['...'])] attribute and add the same serialization group to every field and relation you want tracked.",
    "Import Groups from Symfony\\Component\\Serializer\\Attribute, not Symfony\\Component\\Serializer\\Annotation; the Annotation import silently disables logging on Symfony 8.",
    "After configuring loggable entities, initialize the storage with bin/console locastic:activity-logs:create-loggable-indexes, then bin/console locastic:activity-logs:populate-current-data-trackers if data already exists.",
    "Read activity logs through the ActivityLogProviderInterface service instead of querying the storage backend directly.",
    "For a custom storage backend, implement ActivityLogStorageInterface, CurrentDataTrackerStorageInterface and StorageInitializerInterface, and alias the three interfaces to your services.",
    "The dataChanges field of an activity log holds two objects, previousValues and currentValues, each listing only the modified fields. It is not structured as per-field old/new pairs."
  ],
  "previousVersions": [
    { "tag": "v2.0.0" },
    { "tag": "v1.2.0" }
  ],
  "url": "https://context7.com/locastic/loggastic",
  "public_key": "pk_6nLhWveJT5eYd7x7e5w1o"
}