quarkus

Quarkus — MIND CTI Development Standards

MIND CTI standard for Quarkus 3.x (3.15+) projects. Detected in: CCS (3.23.3), CCSApi (3.22.2), CCSSessionsCleaner (3.23.3), PaymentProcessor (3.4.3), MindBill-Orders-Backend (3.15.1), and Mind-Api projects (2.0.0.CR3 — migrate to 3.x).

When This Applies

This skill applies when the project has Quarkus as a dependency (detected via quarkus-maven-plugin or io.quarkus dependencies in pom.xml). It supplements the java-core skill with Quarkus-specific patterns.

Target version: Quarkus 3.x (3.15+ preferred).

Critical migration note: Mind-Api projects (Account, Customer, ProductCatalog, ProductOrdering, Service) are on Quarkus 2.0.0.CR3 — a pre-release version. These must migrate to Quarkus 3.x (javax→jakarta namespace change, RESTEasy Classic→Reactive).

Core Principles

1. CDI-first — Dependency injection via CDI (ArC), not Spring annotations.
2. Build-time optimization — Quarkus does work at build time. Avoid runtime reflection.
3. Dev services — Use Quarkus dev services for local development.
4. Native-ready — Write code that can compile to native images (GraalVM).
5. MicroProfile standards — Prefer MicroProfile APIs (Config, Health, OpenAPI, REST Client).

Quick Reference — Top 10 Quarkus Rules

1. @ApplicationScoped for services (singleton-like). @RequestScoped for request-bound.
2. Constructor injection with @Inject on fields or constructor. CDI does not use @Autowired.
3. JBoss LogManager for logging — Logger.getLogger(MyClass.class).
4. application.properties with MicroProfile Config syntax.
5. Quarkus REST (RESTEasy Reactive) for REST endpoints in new projects.
6. Hibernate ORM (not Spring Data) for data access.
7. @QuarkusTest for integration tests, REST Assured for API testing.
8. SmallRye OpenAPI for API documentation at /swagger.
9. SmallRye Health for liveness/readiness probes.
10. Native profile — always maintain native Maven profile for GraalVM builds.

Detailed Reference

• For project layout and extension management → project-structure.md
• For RESTEasy Reactive, serialization, and exception mappers → rest-api.md
• For CDI scopes, injection, producers, and ArC specifics → cdi.md
• For Hibernate ORM, entity mapping, and Flyway → data-access.md
• For application.properties, MicroProfile Config, and profiles → configuration.md
• For @QuarkusTest, REST Assured, and test profiles → testing.md
• For native compilation, reflection registration, and GraalVM → native.md

MIND CTI Specific Notes

• Parent BOM: MindBill-GitBOM v10.00.001 for git/ projects, MindBill-BOM for V10.00 projects
• Database: Oracle (ojdbc17 for Quarkus 3.x, ojdbc8 for legacy 2.x)
• Connection pooling: Quarkus Agroal (built-in)
• Security: Keycloak OIDC via quarkus-oidc and quarkus-keycloak-authorization
• Metrics: Micrometer + Prometheus via quarkus-micrometer-registry-prometheus
• Caching: Caffeine (via quarkus-cache)
• Scheduling: Quartz for complex schedules, quarkus-scheduler for simple intervals
• Legacy interop: PaymentProcessor uses wildfly-ejb-client-bom for V10.00 EJB calls