JDR Java Spring Boot Module
Relevant source files
The following files were used as context for generating this wiki page:
The JDR (Java/Spring Boot) module provides a hardened persistence and domain service for the Isabella Villaseñor AI ecosystem. It manages characters, game rules, memory links, and quantum jobs while enforcing zero-trust security principles. The module operates as a companion service to the primary Node.js gateway, handling high-integrity data storage and complex domain logic.
Sources: README.md:200-205, jdr-generator/api/pom.xml:17-20
Architecture and Integration
The JDR module integrates with the broader system as a specialized persistence layer. It relies on the Isabella Gateway for identity and authorization, while providing its own internal hardening via Spring Security and JPA.
The diagram shows the request flow where the JDR module sits behind the main gateway and manages its own MySQL storage.
Sources: README.md:213-222, server.ts:316-320
Security and Hardening
The module implements several security layers:
- Deny-by-default: All endpoints require explicit authorization.
- Tenant Isolation: Extracts tenant identity directly from verified JWTs.
- Idempotency: Uses UUID-based idempotency keys for mutations to prevent duplicate processing.
- Concurrency Control: Employs optimistic locking via
@Versionannotations on entities.
Sources: jdr-generator/openapi/isabella-jdr-v1.yaml:4-8, README.md:207-211
API Definition and Contracts
The JDR module exposes a RESTful API defined by the OpenAPI 3.1.0 specification. It covers character management, memory linkages, and quantum job scheduling.
Primary API Endpoints
| Endpoint | Method | Operation | Key Requirements |
|---|---|---|---|
/api/v1/characters | GET | List Characters | Tenant-filtered cursor pagination |
/api/v1/characters | POST | Create Character | Idempotency-Key, Max Level 100 |
/api/v1/memory-links | POST | Link Entities | Source/Target IDs, Weight (0-1) |
/api/v1/quantum/jobs | POST | Submit Job | Provider Selection, Wires (1-64) |
/actuator/health | GET | Health Check | No security required |
Sources: jdr-generator/openapi/isabella-jdr-v1.yaml:124-210
Request Validation
The module enforces strict validation rules on incoming payloads:
- Character Level: Must be between 1 and 100.
- Attributes: Maximum of 32 properties, each between 0 and 100.
- Quantum Operations: Maximum of 2000 operations per job.
- Memory Link Weights: Normalized float between 0.0 and 1.0.
Sources: jdr-generator/openapi/isabella-jdr-v1.yaml:57-122
Technical Stack and Build Configuration
The JDR module is built on Java 17 and Spring Boot 3.3.5. It uses Maven for dependency management and CI/CD pipelines.
Dependency Manifest
The module includes the following core components:
- Spring Boot Starters: Web, Security, Data JPA, Validation, and Actuator.
- Database: MySQL Connector J with Flyway for schema migrations.
- Observability: Micrometer registry for Prometheus metrics.
- Testing: Testcontainers for isolated MySQL integration tests.
Sources: jdr-generator/api/pom.xml:27-75
Build and Quality Profiles
The module includes a ci profile that enforces strict code quality checks during the verify phase.
<!-- Example Checkstyle configuration from pom.xml -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-checkstyle-plugin</artifactId>
<version>3.5.0</version>
<configuration>
<consoleOutput>true</consoleOutput>
<failOnViolation>true</failOnViolation>
</configuration>
</plugin>
Sources: jdr-generator/api/pom.xml:93-113
Operational Management
The JDR module includes self-healing and monitoring capabilities integrated into the Isabella Automation Mesh.
The sequence shows the health monitoring flow where the mesh verifies JDR and its database connectivity.
Sources: server.ts:1330-1340, src/lib/automation/human-interface.ts:250-260
Production Readiness Criteria
Before releasing to production, the JDR service must meet several functional and security requirements:
- JWT/JWKS Configuration: Must use real, verified identity providers.
- Multi-tenant Isolation: Formal verification of data partitioning.
- SBOM Generation: Production of Software Bill of Materials via Maven plugins.
- Trivy Scan: Zero high/critical vulnerabilities in the container image.
Sources: README.md:224-230, jdr-generator/api/pom.xml:132-148
The JDR module serves as the high-integrity backbone for Isabella's domain data, ensuring that character progression, memory associations, and quantum executions are handled within a strictly governed Java environment.