Skip to content
CAI
Software that uses CAICheck a score

beyondxscratch/hexagonal-architecture-java-springboot

49.7

Weak · 10 November 2026

300

lines of production code

Java

primary language

9

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This is a Spring Boot application that assembles rescue fleets by querying the Star Wars API (SWAPI) for starship data. It filters and selects starships based on passenger and cargo capacity requirements, exposing a REST API to trigger fleet assembly and retrieve results. The system is structured with a domain layer for business logic and an infrastructure layer for external API integration, supported by comprehensive functional and integration tests.

Features

Added DomainService and Stub annotations

New Java annotations, DomainService and Stub, have been introduced in the ddd package. DomainService marks features belonging to the domain and ubiquitous language, while Stub serves as a marker for stub implementations.

domain/src/main/java/ddd · medium confidence

Added RescueFleetController to manage fleet assembly and retrieval

A new REST API endpoint has been introduced to allow users to assemble a fleet based on the number of passengers and retrieve fleet details by ID. The controller exposes a POST /rescueFleets endpoint that accepts a request body specifying the number of passengers, triggering the fleet assembly process, and a GET /rescueFleets/{id} endpoint to fetch fleet information. Supporting resource classes (FleetResource, StarShipResource) and a request DTO (RescueFleetRequest) were added to handle the data transfer between the client and the controller.

infrastructure/src/main/java/rebelsrescue/controllers · high confidence

Added Spring Boot application entry point

A new Spring Boot application class, StarwarsRebelsRescueApplication, has been added to the infrastructure module. This class serves as the main entry point for the application, annotated with @SpringBootApplication and containing the standard main method to launch the Spring Boot application.

infrastructure/src/main/java/rebelsrescue · high confidence

Added SwapiClient to fetch and map Star Wars API data

A new SwapiClient has been introduced to retrieve starship data from the Star Wars API (SWAPI). The client paginates through the API's starship endpoint, mapping the external JSON response into internal StarShip objects. It handles non-integer passenger counts by filtering out invalid entries and explicitly parses the cargo capacity field, ensuring that only valid data is exposed to the rest of the application.

infrastructure/src/main/java/rebelsrescue/swapi · high confidence

Introduce fleet assembly logic for passenger rescue operations

Added new domain classes and services to support assembling fleets for passenger rescue. The system now filters starships with a minimum cargo capacity of 100,000 and selects those with available passenger capacity, sorting them by passenger capacity to optimize rescue operations. The Fleet and StarShip records, along with the FleetAssembler service, enable the creation of rescue fleets based on passenger requirements.

domain/src/main/java/rebelsrescue/fleet · high confidence

Introduce in-memory stubs for fleet and starship inventory services

New in-memory implementations for the fleet and starship inventory SPIs have been added to support development and testing. The \InMemoryFleets\ class provides a basic in-memory store for fleet records, while \StarShipInventoryStub\ supplies a hardcoded list of starships (including the Millennium Falcon and X-Wing) for use as a test double. These stubs allow the application to function without a persistent backend during early development phases.

domain/src/main/java/rebelsrescue/fleet/spi · high confidence

Project documentation and configuration files added

The repository now includes essential configuration and documentation files to support development and CI/CD workflows. A \.gitignore\ file is added to exclude IDE-specific and build artifacts from version control. A \.gitlab-ci.yml\ file is introduced to configure a Maven build pipeline for Java 21. The \README.md\ is updated to replace generic GitLab onboarding instructions with specific details about the Hexagonal Architecture Spring Boot project, including links to related articles and videos. Additionally, a \LICENSE\ file is added to specify the MIT license, and an HTTP request file (\StarWars Rescue Fleet.http\) is included to demonstrate API usage.

(repo-wide) · high confidence

Behavioural changes

Configure application port and Swapi client base URI

The application now explicitly sets its server port to 1977 and configures the Swapi client to use the https://swapi.dev/ endpoint, replacing the previous stub-based implementation with a live external API integration.

infrastructure/src/main/resources · medium confidence

Domain configuration refactored to use Swapi Client instead of Stub

The domain configuration has been updated to replace the previous Stub implementation with the Swapi Client. This change modifies the component scanning filters to include the new client while excluding the old StarShipInventoryStub, ensuring the application uses the live API integration rather than the local stub for domain services.

infrastructure/src/main/java/rebelsrescue/configuration · medium confidence

Test coverage

Added functional test for fleet assembly; Added integration test for fleet assembly; Added test fixtures for SwapiClient; Added tests for the Rescue Fleet controller; Added unit tests for SwapiClient.

Dependencies

Initial Maven multi-module project structure

The project is initialized as a Maven multi-module build with a parent POM defining 'domain' and 'infrastructure' modules. The domain module enforces an anti-corruption layer by banning non-domain dependencies via the maven-enforcer-plugin, while the infrastructure module integrates Spring Boot 3.2.4 (including web, devtools, and test starters) and Spring Cloud Contract Wiremock 4.1.2. The parent POM configures Java 21 compilation, JUnit 5.10.1 and AssertJ 3.25.2 for testing, and the Maven Surefire 3.2.5 plugin.

(dependencies) · medium confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 49 → 50 (+0.2)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 74 → 74 (+0.0)
  • Architecture 84 → 84 (-0.4)
  • Maturity 56 → 56 (+0.0)
  • Readiness 28 → 28 (+0.4)
  • Security 99 → 100 (+1.3)

Resolved (2)

  • Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
  • Documentation: no installation or build instructions (README.md)

New (9)

  • Dependency hygiene PARTLY measured — Maven build resolved part of the dependency graph, currency reported but not scored
  • Outdated (test): net.bytebuddy:byte-buddy
  • Outdated (test): org.assertj:assertj-core
  • Outdated (test): org.junit.jupiter:junit-jupiter
  • Outdated (test): org.junit.jupiter:junit-jupiter-api
  • Outdated (test): org.junit.jupiter:junit-jupiter-engine
  • Outdated (test): org.junit.jupiter:junit-jupiter-params
  • Outdated (test): org.junit.platform:junit-platform-commons
  • Outdated (test): org.junit.platform:junit-platform-engine

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

beyondxscratch/hexagonal-architecture-java-springboot was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 10 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit fa1ea991e04490d8988197090fe8843a8ff27474 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.4+preprod-464a0040a931.