Architecture
This chapter describes the technical architecture of the FS-CD Adapter.
The FS-CD Adapter follows a layered architecture pattern with clear separation of concerns, as shown in the following diagram:
Presentation Layer
The Presentation Layer provides entry points for external interaction with the FS-CD Adapter:
-
UI: Linkki-based user interface for manual interaction
-
REST: RESTful API endpoints for programmatic integration
Integration Layer
The Integration Layer enables event-driven communication:
-
Event Listeners: Components that react to domain events from the Faktor Zehn Suite. Instead of as library, this layer is delivered to projects as (sample) source code to allow for project-specific customization.
Domain Layer
The Domain Layer contains the core business logic:
-
Domain Services: Orchestrate business operations and coordinate between the domain model and infrastructure
-
Domain Model: Domain entities and business objects representing the FS-CD Adapter’s core concepts
Infrastructure Layer
The Infrastructure Layer handles technical concerns and external system communication:
-
Faktor Zehn JCo Library: F10’s abstraction layer wrapping the SAP Java Connector, providing a simplified interface for SAP integration
-
SAP Java Connector (JCo): SAP’s official Java library for communicating with SAP systems via RFC protocol
Data Flow
All presentation and integration components (UI, REST, Event Listeners) invoke domain services to perform business operations. Domain Services work with the Domain Model and delegate SAP communication to the Faktor Zehn JCo Library, which in turn uses the SAP Java Connector to interact with SAP FS-CD.
See [idempotency] for how the FS-CD Adapter handles duplicate messages.
No Local Persistence
The FS-CD Adapter follows a stateless architecture without a local database or persistent data store. It retrieves all data on demand from SAP FS-CD via RFC calls through the JCo connector. This means:
-
All operations require connectivity to SAP FS-CD
-
Performance depends on SAP system response times and network latency
-
The FS-CD Adapter acts as a thin integration layer rather than a data-owning service