How huahill/jfoundry works
JFoundry is a composable Java DDD framework, not a full application framework. Its principal use is to model aggregates and application boundaries, run use cases with transaction and event capabilities, persist aggregates, and optionally deliver messages reliably. Runtime-neutral contracts sit inward of persistence and runtime adapters; Spring, Quarkus, and Helidon assemble selected capabilities. The graph retains the README’s architecture, web, messaging, reliable-messaging, and runtime branches. Several subsystem links are documented capabilities rather than inspected calls; source excerpts were limited, so those links cite the README.
Main entry points: jfoundry-runtime Runtime assembly · ApplicationService.java Application boundary · persistence Persistence lifecycle · DefaultOutboxDispatchService.java Outbox dispatch
Components 24
Domain and architecture
- Domain model
jfoundry-core/jfoundry-domain/src/main/java/org/jfoundry/domain - Repository contract
jfoundry-core/jfoundry-domain/src/main/java/org/jfoundry/domain/repository/AggregateRepository.java - Architecture semantics
jfoundry-core/jfoundry-architecture - CQRS contracts
jfoundry-core/jfoundry-architecture/jfoundry-cqrs/src/main/java/org/jfoundry/architecture/cqrs
Application capabilities
- Application boundary
jfoundry-core/jfoundry-application/jfoundry-application-core/src/main/java/org/jfoundry/application/ApplicationService.java - Transaction SPI
jfoundry-core/jfoundry-application/jfoundry-transaction-core/src/main/java/org/jfoundry/application/transaction - Domain event dispatch
jfoundry-core/jfoundry-application/jfoundry-domain-event-core/src/main/java/org/jfoundry/application/event - Distributed locks
jfoundry-core/jfoundry-application/jfoundry-lock-core/src/main/java/org/jfoundry/application/lock - Message transport SPI
jfoundry-core/jfoundry-application/jfoundry-messaging-core/src/main/java/org/jfoundry/application/messaging
Infrastructure adapters
- Persistence lifecycle
jfoundry-core/jfoundry-infrastructure/jfoundry-persistence-core/src/main/java/org/jfoundry/infrastructure/persistence - JPA adapter
jfoundry-core/jfoundry-infrastructure/jfoundry-persistence-jpa/src/main/java/org/jfoundry/infrastructure/persistence/jpa/JpaAggregateRepository.java - MyBatis adapter
jfoundry-core/jfoundry-infrastructure/jfoundry-persistence-mybatis-plus/src/main/java/org/jfoundry/infrastructure/persistence/mybatis/MybatisPlusAggregateRepository.java - Web errors and logging
jfoundry-core/jfoundry-infrastructure/jfoundry-web/src/main/java/org/jfoundry/http - Outbox and inbox stores
jfoundry-core/jfoundry-infrastructure
Reliable messaging
- Outbox dispatch
jfoundry-core/jfoundry-application/jfoundry-outbox-core/src/main/java/org/jfoundry/application/outbox/DefaultOutboxDispatchService.java - Inbox idempotency
jfoundry-core/jfoundry-application/jfoundry-inbox-core/src/main/java/org/jfoundry/application/inbox - Event externalization
jfoundry-core/jfoundry-application/jfoundry-domain-event-outbox-core/src/main/java/org/jfoundry/application/event/externalization
Runtime integrations
- Runtime assembly
jfoundry-runtime - Spring web adapter
jfoundry-runtime/jfoundry-spring/runtime/jfoundry-webmvc-spring/src/main/java/org/jfoundry/webmvc/spring/ProblemDetailsExceptionHandler.java - Helidon integration
jfoundry-runtime/jfoundry-helidon - Quarkus integration
jfoundry-runtime/jfoundry-quarkus - Spring integration
jfoundry-runtime/jfoundry-spring
Other components
- Application developer
- Message broker
Connections 26
- Application developer → Domain model: models
README.md - Application developer → Application boundary: defines use cases
README.md - Domain model → Repository contract: uses contract
jfoundry-core/jfoundry-domain/src/main/java/org/jfoundry/domain/repository/AggregateRepository.java - Application boundary → Transaction SPI: sets boundaries
README.md - Application boundary → Domain event dispatch: orchestrates events
README.md - Application boundary → Repository contract: persists aggregates
jfoundry-core/jfoundry-domain/src/main/java/org/jfoundry/domain/repository/AggregateRepository.java - Application boundary → CQRS contracts: may dispatch
README.md - Application developer → Architecture semantics: marks boundaries
README.md - Repository contract → Persistence lifecycle: implemented by
jfoundry-core/jfoundry-infrastructure/jfoundry-persistence-core/src/main/java/org/jfoundry/infrastructure/persistence/AbstractAggregateRepository.java - Persistence lifecycle → JPA adapter: implemented by
jfoundry-core/jfoundry-infrastructure/jfoundry-persistence-jpa/src/main/java/org/jfoundry/infrastructure/persistence/jpa/JpaAggregateRepository.java - Persistence lifecycle → MyBatis adapter: implemented by
jfoundry-core/jfoundry-infrastructure/jfoundry-persistence-mybatis-plus/src/main/java/org/jfoundry/infrastructure/persistence/mybatis/MybatisPlusAggregateRepository.java - Application boundary → Distributed locks: may acquire
README.md - Domain event dispatch → Event externalization: composed with
README.md - Event externalization → Outbox dispatch: records events
README.md - Outbox dispatch → Outbox and inbox stores: claims and updates
jfoundry-core/jfoundry-application/jfoundry-outbox-core/src/main/java/org/jfoundry/application/outbox/DefaultOutboxDispatchService.java - Outbox dispatch → Message transport SPI: sends messages
jfoundry-core/jfoundry-application/jfoundry-outbox-core/src/main/java/org/jfoundry/application/outbox/DefaultOutboxDispatchService.java - Message transport SPI → Message broker: delivers messages
README.md - Inbox idempotency → Outbox and inbox stores: stores claims
README.md - Runtime assembly → Transaction SPI: assembles
README.md - Runtime assembly → Domain event dispatch: assembles
README.md - Runtime assembly → Persistence lifecycle: binds adapters
README.md - Runtime assembly → Outbox dispatch: assembles optionally
README.md - Spring integration → Runtime assembly: configures
README.md - Quarkus integration → Runtime assembly: configures
README.md - Helidon integration → Runtime assembly: configures
README.md - Spring web adapter → Web errors and logging: maps errors
jfoundry-runtime/jfoundry-spring/runtime/jfoundry-webmvc-spring/src/main/java/org/jfoundry/webmvc/spring/ProblemDetailsExceptionHandler.java