feat(core)!: add ingestion mode management

[RVANDO12]

PR Description

What this PR Provides

• Introduces the MappingAction enum to support granular ingestion modes (UPDATE_ENTITY, UPDATE_PROPERTIES, UPDATE_RELATIONS, DELETE).
• Implements targeted property updates (UPDATE_PROPERTIES) that strictly preserve existing relationship edges.
• Implements targeted relationship updates (UPDATE_RELATIONS) that strictly preserve existing scalar properties.
• Adds event-driven hard deletion (DELETE) that gracefully cleans up parent relation references before removing the entity.
• Enhances EntityDynamicMapping configuration to accept and validate the required action mode.

Fixes

• fixes IPD-CORE Add ingestion mode management

Review

The reviewer must double-check these points:

• The reviewer has tested the feature
• The reviewer has reviewed the implementation of the feature
• The documentation has been updated
• The feature implementation respects the Technical Doc / ADR previously produced
• The Pull Request title has a ! after the type/scope to identify the breaking
  change in the release note and ensure we will release a major version.

How to test

• The initial state:
  Ensure you have a valid EntityTemplate deployed in back-end, and create an initial baseline Entity with both properties and relations populated.
  Set up a Webhook Connector targeting this template.
• What and how to test:

1. Send a webhook payload configured for UPDATE_PROPERTIES that alters a property (e.g., status).
2. Send a webhook payload configured for UPDATE_RELATIONS that alters a relationship target array.
3. Send a webhook payload configured for UPDATE_RELATIONS with an empty array [] for a specific relation.
4. Send a webhook payload configured for DELETE.

• Expected results:

1. For step 1, a GET request should show the property updated while all original relations remain untouched.
2. For step 2, a GET request should show the relation updated while all original properties remain untouched.
3. For step 3, a GET request should show the relation successfully unlinked (cleared).
4. For step 4, a GET request to the entity should return a 404 Not Found, and any parent entities that previously referenced it should no longer contain its ID in their relation arrays.

Breaking changes !

• API JSON schema modification (existing resource / behavior)

Context of the Breaking Change

The API schema for configuring Webhook Connectors has been modified. The EntityDynamicMapping payload now requires an action field to dictate the mutation logic.

Result of the Breaking Change

Existing webhook mapping configurations must be migrated to include "action": "UPDATE_ENTITY" to retain their current default behavior (Full Merge).

---

[github-code-quality]

Code Coverage Overview

Languages: Java

Java / code-coverage/jacoco

The overall coverage in commit 6afe4a6 in the feat/ingestion/mode-... branch is 91%. The coverage in commit f148be0 in the main branch is 90%.

Show a code coverage summary of the most impacted files.

File	main f148be0	feat/ingestion/mode-... 6afe4a6	+/-
com/decathlon/i...ityService.java	98%	97%	-1%
com/decathlon/i...ineAdapter.java	82%	81%	-1%
com/decathlon/i...pingMapper.java	98%	98%	0%
com/decathlon/i...kErrorCode.java	100%	100%	0%
com/decathlon/i...uteBuilder.java	100%	100%	0%
com/decathlon/i...uteBuilder.java	100%	100%	0%
com/decathlon/i...MapperImpl.java	93%	94%	+1%
com/decathlon/i...ingAdaptor.java	88%	89%	+1%
com/decathlon/i...nProcessor.java	6%	100%	+94%
com/decathlon/i...pingAction.java	0%	100%	+100%

---

_{Updated August 19, 2026 15:38 UTC}

[sonarqubecloud]

Quality Gate passed

Issues
4 New issues
0 Accepted issues

Measures
0 Security Hotspots
98.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud