CLI Commands

Integration

• `php artisan integration:register`

- Reads `config/integrations.php`, validates driver configuration against each Driver’s schema, and upserts `integrations`.

• `php artisan integration:setup`

- Interactive setup using `Laravel\Prompts` to create a new Integration record selecting a Driver.

• `php artisan integrations:health-check {--fix}`

- Checks health of configured integrations; `--fix` reserved for future automated repairs.

Akeneo

• `php artisan akeneo:import:data {entity} {--codes=} {--full}`

- `entity`: `product|attribute|family|category`.

- `--codes=code1,code2` restricts to specific identifiers/codes for the entity.

- `--full` skips incremental filtering (ignores updated-date filter) but still updates the last-synced timestamp.

- Uses repositories (`AkeneoProductRepository`, `AkeneoAttributeRepository`, `AkeneoFamilyRepository`, `AkeneoCategoryRepository`).

- Actions map Akeneo payloads to local tables (`ImportProductAction`, `ImportProductAttributeAction`, `ImportFamilyAction`, `ImportCategoryAction`).

- Filtering is built dynamically via builders configured in `config/akeneo.php` under `entity.filter.builder`:

- `UpdatedDateBuilder` adds `updated` filter from the settings table (per-entity groups: `pim_attribute`, `pim_product`, `pim_family`, `pim_category`, using `name=updated_at`).

- `NotEmptyFamilyBuilder` adds `family NOT EMPTY` for product imports.

- The incremental filter shape is equivalent to:

- `['updated' => [['operator' => '>', 'value' => '2025-12-18T06:00:00+00:00']]]` (ISO 8601 datetime)

- After each import run, the command updates settings `updated_at` for the processed entity to the current time (ISO 8601) for the next incremental run.

- Akeneo client: https://github.com/akeneo/php-api-client

Testing & Utilities

• `php artisan test:product-integration {uuid?}`

- Flips a product’s enabled flag and updates a price attribute to exercise the mutation pipeline.

• `php artisan horizon`

- Starts Horizon supervisors and dashboard.