adb (parent Maven + proxy)

Role

adb/ is the parent project of the Java backend. It provides:

1. A parent POM that centralizes Spring Boot, Spring Cloud, common dependency (MapStruct, Lombok, Apache POI, etc.) and Maven plugin versions.
2. Nine shared modules consumed by every microservice: adb-common, adb-model, adb-test, adb-actions, adb-action-logs, adb-descriptor, adb-messaging, adb-openapi, adb-communication, adb-security.
3. The Nginx reverse proxy (proxy/) that acts as the platform's API gateway.

No runnable service is defined here: it is exclusively shared libraries and configuration.

Tech stack

Current parent version: 0.3.116.

Module architecture

flowchart TB
    parent[adb<br/>parent POM]

    subgraph Modules
        common[adb-common<br/>FQDN, RequestContext]
        model[adb-model<br/>shared DTOs]
        test[adb-test<br/>test helpers]
        actions[adb-actions<br/>action processor]
        actionlogs[adb-action-logs<br/>traceability]
        descriptor[adb-descriptor<br/>metadata]
        messaging[adb-messaging<br/>SQS/SNS abstractions]
        openapi[adb-openapi<br/>specs + codegen]
        communication[adb-communication<br/>WebClient helpers]
        security[adb-security<br/>delegation models]
    end

    proxy[proxy<br/>Nginx]

    parent --> Modules
    parent --> proxy

    Services[adb-persons<br/>adb-parts<br/>adb-contracts<br/>...]

    common -.dependency.-> Services
    model -.dependency.-> Services
    messaging -.dependency.-> Services
    actions -.dependency.-> Services
    actionlogs -.dependency.-> Services

adb-common

Core of the module: the FQDN enum (fr.lifeconnect.adb.client.FQDN), a directory of all internal services:

Also contains: RequestContextData (user-context propagation), client interfaces (NotesClient, TicketsClient, ...), and various utilities.

adb-model

DTOs shared between services to avoid duplicating business data structures.

adb-messaging

Abstractions on top of Spring Cloud AWS to publish (SnsTemplate) and consume (@SqsListener) events. Configures regions, JSON serializers, and DLQs.

adb-actions / adb-action-logs

• adb-actions: framework to trigger and trace business actions (modifications, validations).
• adb-action-logs: persistence of action logs in MongoDB (one dedicated collection per service).

Used by adb-persons, adb-parts, adb-contracts, adb-accounting, adb-utilities.

adb-openapi

Generates OpenAPI specs from Spring annotations (SpringDoc). Acts as the source for the TypeScript client in adb-web/packages/api-client.

adb-security

Cross-cutting delegation module. Provides the model and service layer for access delegation between entities (e.g. a person delegating scoped access on a contract to another person):

• Delegation — persisted record: delegatee, resource (TargetObject), validity window, set of delegated scopes.
• DelegateePort / DelegationPort — reactive repository interfaces implemented per-service.
• DelegationService.hasAccess(contextData, resource, requester, scope) — reactive check used in controllers.

Services that need delegation import this module and implement the port interfaces.

adb-test, adb-descriptor, adb-communication

• adb-test: integration test helpers (TestContainers, Mongo fixtures).
• adb-descriptor: module metadata (version, dependencies).
• adb-communication: reactive WebClient helpers (RestClientImpl, retry, error mapping).

proxy/ — Nginx gateway

Nginx configuration (proxy/default.conf) that routes external requests to internal services:

Configuration / deployment

• Build: mvn clean install -pl adb-common,adb-model,adb-messaging,... or mvn install at the root.
• Versioning: SNAPSHOT during development, releases handled via the script adb/doc/release.md.
• Proxy deployment: Helm chart adb-charts/charts/ingress-route/ and Docker image built from proxy/Dockerfile.

Links

• Code: adb/
• Parent POM: adb/pom.xml
• FQDN enum: adb/adb-common/src/main/java/fr/lifeconnect/adb/client/FQDN.java