[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CSQHEX53Z2J3602XEE1C86":3,"skill-same:01M7CSQHEX53Z2J3602XEE1C86":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":14,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7CSQHEX53Z2J3602XEE1C86","quarkus-patterns",null,"Quarkus 3.x LTS architecture patterns with Camel for messaging, RESTful API design, CDI services, data access with Panache, and async processing. Use for Java Quarkus backend work with event-driven architectures.","Henrique1601\u002FSkiilsToIAs","Henrique1601","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F92006691?v=4","01M7CRXVT0GVXVK80JT1GR687S","Henrique Bezerra Dos Santos","01M7CRXVTN5Y8TMWJ1MDSKCQ1T",0,"MIT","https:\u002F\u002Fgithub.com\u002FHenrique1601\u002FSkiilsToIAs\u002Fblob\u002Fmain\u002Fbackend-database\u002Fquarkus-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: quarkus-patterns\ndescription: Quarkus 3.x LTS architecture patterns with Camel for messaging, RESTful API design, CDI services, data access with Panache, and async processing. Use for Java Quarkus backend work with event-driven architectures.\nmetadata:\n  origin: ECC\n---\n\n# Quarkus Development Patterns\n\nQuarkus 3.x architecture and API patterns for cloud-native, event-driven services with Apache Camel.\n\n## When to Activate\n\n- Building REST APIs with JAX-RS or RESTEasy Reactive\n- Structuring resource → service → repository layers\n- Implementing event-driven patterns with Apache Camel and RabbitMQ\n- Configuring Hibernate Panache, caching, or reactive streams\n- Adding validation, exception mapping, or pagination\n- Setting up profiles for dev\u002Fstaging\u002Fproduction environments (YAML config)\n- Custom logging with LogContext and Logback\u002FLogstash encoder\n- Working with CompletableFuture for async operations\n- Implementing conditional flow processing\n- Working with GraalVM native compilation\n\n## Service Layer with Multiple Dependencies\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class OrderProcessingService {\n\n    private final OrderValidator orderValidator;\n    private final EventService eventService;\n    private final OrderRepository orderRepository;\n    private final FulfillmentPublisher fulfillmentPublisher;\n    private final AuditPublisher auditPublisher;\n\n    @Transactional\n    public OrderReceipt process(CreateOrderCommand command) {\n        ValidationResult validation = orderValidator.validate(command);\n        if (!validation.valid()) {\n            eventService.createErrorEvent(command, \"ORDER_REJECTED\", validation.message());\n            throw new WebApplicationException(validation.message(), Response.Status.BAD_REQUEST);\n        }\n\n        Order order = Order.from(command);\n        orderRepository.persist(order);\n\n        OrderReceipt receipt = OrderReceipt.from(order);\n        fulfillmentPublisher.publishAsync(receipt);\n        auditPublisher.publish(\"ORDER_ACCEPTED\", receipt);\n        eventService.createSuccessEvent(receipt, \"ORDER_ACCEPTED\");\n\n        log.info(\"Processed order {}\", order.id);\n        return receipt;\n    }\n}\n```\n\n**Key Patterns:**\n- `@RequiredArgsConstructor` for constructor injection via Lombok\n- `@Slf4j` for Logback logging\n- `@Transactional` on service methods that write through Panache or repositories\n- Validate input before persistence or message publication\n- Event tracking for success\u002Ferror scenarios\n- Async Camel message publishing\n\n## Custom Logging Context Pattern (Logback)\n\n```java\n@ApplicationScoped\npublic class ProcessingService {\n\n    public void processDocument(Document doc) {\n        LogContext logContext = CustomLog.getCurrentContext();\n        try (SafeAutoCloseable ignored = CustomLog.startScope(logContext)) {\n            \u002F\u002F Add context to all log statements\n            logContext.put(\"documentId\", doc.getId().toString());\n            logContext.put(\"documentType\", doc.getType());\n            logContext.put(\"userId\", SecurityContext.getUserId());\n\n            log.info(\"Starting document processing\");\n\n            \u002F\u002F All logs within this scope inherit the context\n            processInternal(doc);\n\n            log.info(\"Document processing completed\");\n        } catch (Exception e) {\n            log.error(\"Document processing failed\", e);\n            throw e;\n        }\n    }\n}\n```\n\n**Logback Configuration (logback.xml):**\n\n```xml\n\u003Cconfiguration>\n    \u003Cappender name=\"CONSOLE\" class=\"ch.qos.logback.core.ConsoleAppender\">\n        \u003Cencoder class=\"net.logstash.logback.encoder.LogstashEncoder\">\n            \u003CincludeContext>true\u003C\u002FincludeContext>\n            \u003CincludeMdc>true\u003C\u002FincludeMdc>\n        \u003C\u002Fencoder>\n    \u003C\u002Fappender>\n\n    \u003Clogger name=\"com.example\" level=\"INFO\"\u002F>\n    \u003Croot level=\"WARN\">\n        \u003Cappender-ref ref=\"CONSOLE\"\u002F>\n    \u003C\u002Froot>\n\u003C\u002Fconfiguration>\n```\n\n## Event Service Pattern\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class EventService {\n    private final EventRepository eventRepository;\n    private final ObjectMapper objectMapper;\n\n    public void createSuccessEvent(Object payload, String eventType) {\n        Objects.requireNonNull(payload, \"Payload cannot be null\");\n        Event event = new Event();\n        event.setType(eventType);\n        event.setStatus(EventStatus.SUCCESS);\n        event.setPayload(serializePayload(payload));\n        event.setTimestamp(Instant.now());\n\n        eventRepository.persist(event);\n        log.info(\"Success event created: {}\", eventType);\n    }\n\n    public void createErrorEvent(Object payload, String eventType, String errorMessage) {\n        Objects.requireNonNull(payload, \"Payload cannot be null\");\n        if (errorMessage == null || errorMessage.isBlank()) {\n            throw new IllegalArgumentException(\"Error message cannot be blank\");\n        }\n        Event event = new Event();\n        event.setType(eventType);\n        event.setStatus(EventStatus.ERROR);\n        event.setErrorMessage(errorMessage);\n        event.setPayload(serializePayload(payload));\n        event.setTimestamp(Instant.now());\n\n        eventRepository.persist(event);\n        log.error(\"Error event created: {} - {}\", eventType, errorMessage);\n    }\n\n    private String serializePayload(Object payload) {\n        try {\n            return objectMapper.writeValueAsString(payload);\n        } catch (JsonProcessingException e) {\n            throw new IllegalStateException(\"Failed to serialize event payload\", e);\n        }\n    }\n}\n```\n\n## Camel Message Publishing (RabbitMQ)\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class BusinessRulesPublisher {\n    private final ProducerTemplate producerTemplate;\n\n    public void publishSync(BusinessRulesPayload payload) {\n        producerTemplate.sendBody(\n            \"direct:business-rules-publisher\",\n            payload\n        );\n    }\n}\n```\n\n**Camel Route Configuration:**\n\n```java\n@ApplicationScoped\npublic class BusinessRulesRoute extends RouteBuilder {\n\n    @ConfigProperty(name = \"camel.rabbitmq.queue.business-rules\")\n    String businessRulesQueue;\n\n    @ConfigProperty(name = \"rabbitmq.host\")\n    String rabbitHost;\n\n    @ConfigProperty(name = \"rabbitmq.port\")\n    Integer rabbitPort;\n\n    @Override\n    public void configure() {\n        from(\"direct:business-rules-publisher\")\n            .routeId(\"business-rules-publisher\")\n            .log(\"Publishing message to RabbitMQ: ${body}\")\n            .marshal().json(JsonLibrary.Jackson)\n            .toF(\"spring-rabbitmq:%s?hostname=%s&portNumber=%d\",\n                businessRulesQueue, rabbitHost, rabbitPort);\n    }\n}\n```\n\n## Camel Direct Routes (In-Memory)\n\n```java\n@ApplicationScoped\npublic class DocumentProcessingRoute extends RouteBuilder {\n\n    @Override\n    public void configure() {\n        \u002F\u002F Error handling\n        onException(ValidationException.class)\n            .handled(true)\n            .to(\"direct:validation-error-handler\")\n            .log(\"Validation error: ${exception.message}\");\n\n        \u002F\u002F Main processing route\n        from(\"direct:process-document\")\n            .routeId(\"document-processing\")\n            .log(\"Processing document: ${header.documentId}\")\n            .bean(DocumentValidator.class, \"validate\")\n            .bean(DocumentTransformer.class, \"transform\")\n            .choice()\n                .when(header(\"documentType\").isEqualTo(\"INVOICE\"))\n                    .to(\"direct:process-invoice\")\n                .when(header(\"documentType\").isEqualTo(\"CREDIT_NOTE\"))\n                    .to(\"direct:process-credit-note\")\n                .otherwise()\n                    .to(\"direct:process-generic\")\n            .end();\n\n        from(\"direct:validation-error-handler\")\n            .bean(EventService.class, \"createErrorEvent\")\n            .log(\"Validation error handled\");\n    }\n}\n```\n\n## Camel File Processing\n\n```java\n@ApplicationScoped\npublic class FileMonitoringRoute extends RouteBuilder {\n\n    @ConfigProperty(name = \"file.input.directory\")\n    String inputDirectory;\n\n    @ConfigProperty(name = \"file.processed.directory\")\n    String processedDirectory;\n\n    @ConfigProperty(name = \"file.error.directory\")\n    String errorDirectory;\n\n    @Override\n    public void configure() {\n        from(\"file:\" + inputDirectory + \"?move=\" + processedDirectory +\n             \"&moveFailed=\" + errorDirectory + \"&delay=5000\")\n            .routeId(\"file-monitor\")\n            .log(\"Processing file: ${header.CamelFileName}\")\n            .to(\"direct:process-file\");\n\n        from(\"direct:process-file\")\n            .bean(OrderProcessingService.class, \"processFile\")\n            .log(\"File processing completed\");\n    }\n}\n```\n\n## Camel Bean Invocation\n\n```java\n@ApplicationScoped\npublic class InvoiceRoute extends RouteBuilder {\n\n    @Override\n    public void configure() {\n        from(\"direct:invoice-validation\")\n            .bean(InvoiceFlowValidator.class, \"validateFlowWithConfig\")\n            .log(\"Validation result: ${body}\");\n\n        from(\"direct:persist-and-publish\")\n            .bean(DocumentJobService.class, \"createDocumentAndJobEntities\")\n            .bean(BusinessRulesPublisher.class, \"publishAsync\")\n            .bean(EventService.class, \"createSuccessEvent(${body}, 'PUBLISHED')\");\n    }\n}\n```\n\n## REST API Structure\n\n```java\n@Path(\"\u002Fapi\u002Fdocuments\")\n@Produces(MediaType.APPLICATION_JSON)\n@Consumes(MediaType.APPLICATION_JSON)\n@RequiredArgsConstructor\npublic class DocumentResource {\n  private final DocumentService documentService;\n\n  @GET\n  public Response list(\n      @QueryParam(\"page\") @DefaultValue(\"0\") int page,\n      @QueryParam(\"size\") @DefaultValue(\"20\") int size) {\n    List\u003CDocument> documents = documentService.list(page, size);\n    return Response.ok(documents).build();\n  }\n\n  @POST\n  public Response create(@Valid CreateDocumentRequest request, @Context UriInfo uriInfo) {\n    Document document = documentService.create(request);\n    URI location = uriInfo.getAbsolutePathBuilder()\n        .path(String.valueOf(document.id))\n        .build();\n    return Response.created(location).entity(DocumentResponse.from(document)).build();\n  }\n\n  @GET\n  @Path(\"\u002F{id}\")\n  public Response getById(@PathParam(\"id\") Long id) {\n    return documentService.findById(id)\n        .map(DocumentResponse::from)\n        .map(Response::ok)\n        .orElse(Response.status(Response.Status.NOT_FOUND))\n        .build();\n  }\n}\n```\n\n## Repository Pattern (Panache Repository)\n\n```java\n@ApplicationScoped\npublic class DocumentRepository implements PanacheRepository\u003CDocument> {\n\n  public List\u003CDocument> findByStatus(DocumentStatus status, int page, int size) {\n    return find(\"status = ?1 order by createdAt desc\", status)\n        .page(page, size)\n        .list();\n  }\n\n  public Optional\u003CDocument> findByReferenceNumber(String referenceNumber) {\n    return find(\"referenceNumber\", referenceNumber).firstResultOptional();\n  }\n\n  public long countByStatusAndDate(DocumentStatus status, LocalDate date) {\n    return count(\"status = ?1 and createdAt >= ?2\", status, date.atStartOfDay());\n  }\n}\n```\n\n## Service Layer with Transactions\n\n```java\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class DocumentService {\n  private final DocumentRepository repo;\n  private final EventService eventService;\n\n  @Transactional\n  public Document create(CreateDocumentRequest request) {\n    Document document = new Document();\n    document.setReferenceNumber(request.referenceNumber());\n    document.setDescription(request.description());\n    document.setStatus(DocumentStatus.PENDING);\n    document.setCreatedAt(Instant.now());\n\n    repo.persist(document);\n\n    eventService.createSuccessEvent(document, \"DOCUMENT_CREATED\");\n\n    return document;\n  }\n\n  public Optional\u003CDocument> findById(Long id) {\n    return repo.findByIdOptional(id);\n  }\n\n  public List\u003CDocument> list(int page, int size) {\n    return repo.findAll()\n        .page(page, size)\n        .list();\n  }\n}\n```\n\n## DTOs and Validation\n\n```java\npublic record CreateDocumentRequest(\n    @NotBlank @Size(max = 200) String referenceNumber,\n    @NotBlank @Size(max = 2000) String description,\n    @NotNull @FutureOrPresent Instant validUntil,\n    @NotEmpty List\u003C@NotBlank String> categories) {}\n\npublic record DocumentResponse(Long id, String referenceNumber, DocumentStatus status) {\n  public static DocumentResponse from(Document document) {\n    return new DocumentResponse(document.getId(), document.getReferenceNumber(),\n        document.getStatus());\n  }\n}\n```\n\n## Exception Mapping\n\n```java\n@Provider\npublic class ValidationExceptionMapper implements ExceptionMapper\u003CConstraintViolationException> {\n  @Override\n  public Response toResponse(ConstraintViolationException exception) {\n    String message = exception.getConstraintViolations().stream()\n        .map(cv -> cv.getPropertyPath() + \": \" + cv.getMessage())\n        .collect(Collectors.joining(\", \"));\n\n    return Response.status(Response.Status.BAD_REQUEST)\n        .entity(Map.of(\"error\", \"validation_error\", \"message\", message))\n        .build();\n  }\n}\n\n@Provider\n@Slf4j\npublic class GenericExceptionMapper implements ExceptionMapper\u003CException> {\n\n  @Override\n  public Response toResponse(Exception exception) {\n    log.error(\"Unhandled exception\", exception);\n    return Response.status(Response.Status.INTERNAL_SERVER_ERROR)\n        .entity(Map.of(\"error\", \"internal_error\", \"message\", \"An unexpected error occurred\"))\n        .build();\n  }\n}\n```\n\n## CompletableFuture Async Operations\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class FileStorageService {\n    private final S3Client s3Client;\n    private final ExecutorService executorService;\n\n    @ConfigProperty(name = \"storage.bucket-name\")\n    String bucketName;\n\n    public CompletableFuture\u003CStoredDocumentInfo> uploadOriginalFile(\n            InputStream inputStream,\n            long size,\n            LogContext logContext,\n            InvoiceFormat format) {\n\n        return CompletableFuture.supplyAsync(() -> {\n            try (SafeAutoCloseable ignored = CustomLog.startScope(logContext)) {\n                String path = generateStoragePath(format);\n\n                PutObjectRequest request = PutObjectRequest.builder()\n                    .bucket(bucketName)\n                    .key(path)\n                    .contentLength(size)\n                    .build();\n\n                s3Client.putObject(request, RequestBody.fromInputStream(inputStream, size));\n\n                log.info(\"File uploaded to S3: {}\", path);\n\n                return new StoredDocumentInfo(path, size, Instant.now());\n            } catch (Exception e) {\n                log.error(\"Failed to upload file to S3\", e);\n                throw new StorageException(\"Upload failed\", e);\n            }\n        }, executorService);\n    }\n}\n```\n\n## Caching\n\n```java\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class DocumentCacheService {\n  private final DocumentRepository repo;\n\n  @CacheResult(cacheName = \"document-cache\")\n  public Optional\u003CDocument> getById(@CacheKey Long id) {\n    return repo.findByIdOptional(id);\n  }\n\n  @CacheInvalidate(cacheName = \"document-cache\")\n  public void evict(@CacheKey Long id) {}\n\n  @CacheInvalidateAll(cacheName = \"document-cache\")\n  public void evictAll() {}\n}\n```\n\n## Configuration as YAML\n\n```yaml\n# application.yml\n\"%dev\":\n  quarkus:\n    datasource:\n      jdbc:\n        url: jdbc:postgresql:\u002F\u002Flocalhost:5432\u002Fdev_db\n      username: dev_user\n      password: ${DB_PASSWORD}\n    hibernate-orm:\n      database:\n        generation: drop-and-create\n\n  rabbitmq:\n    host: localhost\n    port: 5672\n    username: ${RABBITMQ_USER}\n    password: ${RABBITMQ_PASSWORD}\n\n\"%test\":\n  quarkus:\n    datasource:\n      jdbc:\n        url: jdbc:h2:mem:test\n    hibernate-orm:\n      database:\n        generation: drop-and-create\n\n\"%prod\":\n  quarkus:\n    datasource:\n      jdbc:\n        url: ${DATABASE_URL}\n      username: ${DB_USER}\n      password: ${DB_PASSWORD}\n    hibernate-orm:\n      database:\n        generation: validate\n\n  rabbitmq:\n    host: ${RABBITMQ_HOST}\n    port: ${RABBITMQ_PORT}\n    username: ${RABBITMQ_USER}\n    password: ${RABBITMQ_PASSWORD}\n\n# Camel configuration\ncamel:\n  rabbitmq:\n    queue:\n      business-rules: business-rules-queue\n      invoice-processing: invoice-processing-queue\n```\n\n## Health Checks\n\n```java\n@Readiness\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class DatabaseHealthCheck implements HealthCheck {\n  private final AgroalDataSource dataSource;\n\n  @Override\n  public HealthCheckResponse call() {\n    try (Connection conn = dataSource.getConnection()) {\n      boolean valid = conn.isValid(2);\n      return HealthCheckResponse.named(\"Database connection\")\n          .status(valid)\n          .build();\n    } catch (SQLException e) {\n      return HealthCheckResponse.down(\"Database connection\");\n    }\n  }\n}\n\n@Liveness\n@ApplicationScoped\npublic class CamelHealthCheck implements HealthCheck {\n  @Inject\n  CamelContext camelContext;\n\n  @Override\n  public HealthCheckResponse call() {\n    boolean isStarted = camelContext.getStatus().isStarted();\n    return HealthCheckResponse.named(\"Camel Context\")\n        .status(isStarted)\n        .build();\n  }\n}\n```\n\n## Dependencies (Maven)\n\n```xml\n\u003Cproperties>\n    \u003Cquarkus.platform.version>3.27.0\u003C\u002Fquarkus.platform.version>\n    \u003Clombok.version>1.18.42\u003C\u002Flombok.version>\n    \u003Cassertj-core.version>3.24.2\u003C\u002Fassertj-core.version>\n    \u003Cjacoco-maven-plugin.version>0.8.13\u003C\u002Fjacoco-maven-plugin.version>\n    \u003Cmaven.compiler.release>17\u003C\u002Fmaven.compiler.release>\n\u003C\u002Fproperties>\n\n\u003CdependencyManagement>\n    \u003Cdependencies>\n        \u003Cdependency>\n            \u003CgroupId>io.quarkus.platform\u003C\u002FgroupId>\n            \u003CartifactId>quarkus-bom\u003C\u002FartifactId>\n            \u003Cversion>${quarkus.platform.version}\u003C\u002Fversion>\n            \u003Ctype>pom\u003C\u002Ftype>\n            \u003Cscope>import\u003C\u002Fscope>\n        \u003C\u002Fdependency>\n        \u003Cdependency>\n            \u003CgroupId>io.quarkus.platform\u003C\u002FgroupId>\n            \u003CartifactId>quarkus-camel-bom\u003C\u002FartifactId>\n            \u003Cversion>${quarkus.platform.version}\u003C\u002Fversion>\n            \u003Ctype>pom\u003C\u002Ftype>\n            \u003Cscope>import\u003C\u002Fscope>\n        \u003C\u002Fdependency>\n    \u003C\u002Fdependencies>\n\u003C\u002FdependencyManagement>\n\n\u003Cdependencies>\n    \u003C!-- Quarkus Core -->\n    \u003Cdependency>\n        \u003CgroupId>io.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>quarkus-arc\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>io.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>quarkus-config-yaml\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\n    \u003C!-- Camel Extensions -->\n    \u003Cdependency>\n        \u003CgroupId>org.apache.camel.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>camel-quarkus-spring-rabbitmq\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.apache.camel.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>camel-quarkus-direct\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.apache.camel.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>camel-quarkus-bean\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\n    \u003C!-- Lombok -->\n    \u003Cdependency>\n        \u003CgroupId>org.projectlombok\u003C\u002FgroupId>\n        \u003CartifactId>lombok\u003C\u002FartifactId>\n        \u003Cversion>${lombok.version}\u003C\u002Fversion>\n        \u003Cscope>provided\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n\n    \u003C!-- Logging -->\n    \u003Cdependency>\n        \u003CgroupId>io.quarkiverse.logging.logback\u003C\u002FgroupId>\n        \u003CartifactId>quarkus-logging-logback\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.logstash.logback\u003C\u002FgroupId>\n        \u003CartifactId>logstash-logback-encoder\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n```\n\n## Best Practices\n\n### Architecture\n- Use `@RequiredArgsConstructor` with Lombok for constructor injection\n- Keep service layer thin; delegate complex logic to specialized classes\n- Use Camel routes for message routing and integration patterns\n- Prefer Panache Repository pattern for data access\n\n### Event-Driven\n- Always track operations with EventService (success\u002Ferror events)\n- Use Camel `direct:` endpoints for in-memory routing\n- Use `spring-rabbitmq` component for RabbitMQ integration\n- Implement async publishing with `ProducerTemplate.asyncSendBody()`\n\n### Logging\n- Use Logback with Logstash encoder for structured logging\n- Propagate LogContext through service calls with `SafeAutoCloseable`\n- Add contextual information to LogContext for request tracing\n- Use `@Slf4j` instead of manual logger instantiation\n\n### Async Operations\n- Use CompletableFuture for non-blocking I\u002FO operations\n- Call `.join()` when you need to wait for completion\n- Handle exceptions from CompletableFuture properly\n- Pass LogContext to async operations for tracing\n\n### Configuration\n- Use YAML configuration (`quarkus-config-yaml`)\n- Profile-aware configuration for dev\u002Ftest\u002Fprod environments\n- Externalize sensitive configuration to environment variables\n- Use `@ConfigProperty` for type-safe config injection\n\n### Validation\n- Validate at resource layer with `@Valid`\n- Use Bean Validation annotations on DTOs\n- Map exceptions to proper HTTP responses with `@Provider`\n\n### Transactions\n- Use `@Transactional` on service methods that modify data\n- Keep transactions short and focused\n- Avoid calling async operations within transactions\n\n### Testing\n- Use `camel-quarkus-junit5` for route testing\n- Use AssertJ for assertions\n- Mock all external dependencies\n- Test conditional flow logic thoroughly\n\n### Quarkus-Specific\n- Stay on latest LTS version (3.x)\n- Use Quarkus dev mode for hot reload\n- Add health checks for production readiness\n- Test native compilation compatibility periodically\n","# Quarkus Development Patterns\n\nQuarkus 3.x architecture and API patterns for cloud-native, event-driven services with Apache Camel.\n\n## When to Activate\n\n- Building REST APIs with JAX-RS or RESTEasy Reactive\n- Structuring resource → service → repository layers\n- Implementing event-driven patterns with Apache Camel and RabbitMQ\n- Configuring Hibernate Panache, caching, or reactive streams\n- Adding validation, exception mapping, or pagination\n- Setting up profiles for dev\u002Fstaging\u002Fproduction environments (YAML config)\n- Custom logging with LogContext and Logback\u002FLogstash encoder\n- Working with CompletableFuture for async operations\n- Implementing conditional flow processing\n- Working with GraalVM native compilation\n\n## Service Layer with Multiple Dependencies\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class OrderProcessingService {\n\n    private final OrderValidator orderValidator;\n    private final EventService eventService;\n    private final OrderRepository orderRepository;\n    private final FulfillmentPublisher fulfillmentPublisher;\n    private final AuditPublisher auditPublisher;\n\n    @Transactional\n    public OrderReceipt process(CreateOrderCommand command) {\n        ValidationResult validation = orderValidator.validate(command);\n        if (!validation.valid()) {\n            eventService.createErrorEvent(command, \"ORDER_REJECTED\", validation.message());\n            throw new WebApplicationException(validation.message(), Response.Status.BAD_REQUEST);\n        }\n\n        Order order = Order.from(command);\n        orderRepository.persist(order);\n\n        OrderReceipt receipt = OrderReceipt.from(order);\n        fulfillmentPublisher.publishAsync(receipt);\n        auditPublisher.publish(\"ORDER_ACCEPTED\", receipt);\n        eventService.createSuccessEvent(receipt, \"ORDER_ACCEPTED\");\n\n        log.info(\"Processed order {}\", order.id);\n        return receipt;\n    }\n}\n```\n\n**Key Patterns:**\n- `@RequiredArgsConstructor` for constructor injection via Lombok\n- `@Slf4j` for Logback logging\n- `@Transactional` on service methods that write through Panache or repositories\n- Validate input before persistence or message publication\n- Event tracking for success\u002Ferror scenarios\n- Async Camel message publishing\n\n## Custom Logging Context Pattern (Logback)\n\n```java\n@ApplicationScoped\npublic class ProcessingService {\n\n    public void processDocument(Document doc) {\n        LogContext logContext = CustomLog.getCurrentContext();\n        try (SafeAutoCloseable ignored = CustomLog.startScope(logContext)) {\n            \u002F\u002F Add context to all log statements\n            logContext.put(\"documentId\", doc.getId().toString());\n            logContext.put(\"documentType\", doc.getType());\n            logContext.put(\"userId\", SecurityContext.getUserId());\n\n            log.info(\"Starting document processing\");\n\n            \u002F\u002F All logs within this scope inherit the context\n            processInternal(doc);\n\n            log.info(\"Document processing completed\");\n        } catch (Exception e) {\n            log.error(\"Document processing failed\", e);\n            throw e;\n        }\n    }\n}\n```\n\n**Logback Configuration (logback.xml):**\n\n```xml\n\u003Cconfiguration>\n    \u003Cappender name=\"CONSOLE\" class=\"ch.qos.logback.core.ConsoleAppender\">\n        \u003Cencoder class=\"net.logstash.logback.encoder.LogstashEncoder\">\n            \u003CincludeContext>true\u003C\u002FincludeContext>\n            \u003CincludeMdc>true\u003C\u002FincludeMdc>\n        \u003C\u002Fencoder>\n    \u003C\u002Fappender>\n\n    \u003Clogger name=\"com.example\" level=\"INFO\"\u002F>\n    \u003Croot level=\"WARN\">\n        \u003Cappender-ref ref=\"CONSOLE\"\u002F>\n    \u003C\u002Froot>\n\u003C\u002Fconfiguration>\n```\n\n## Event Service Pattern\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class EventService {\n    private final EventRepository eventRepository;\n    private final ObjectMapper objectMapper;\n\n    public void createSuccessEvent(Object payload, String eventType) {\n        Objects.requireNonNull(payload, \"Payload cannot be null\");\n        Event event = new Event();\n        event.setType(eventType);\n        event.setStatus(EventStatus.SUCCESS);\n        event.setPayload(serializePayload(payload));\n        event.setTimestamp(Instant.now());\n\n        eventRepository.persist(event);\n        log.info(\"Success event created: {}\", eventType);\n    }\n\n    public void createErrorEvent(Object payload, String eventType, String errorMessage) {\n        Objects.requireNonNull(payload, \"Payload cannot be null\");\n        if (errorMessage == null || errorMessage.isBlank()) {\n            throw new IllegalArgumentException(\"Error message cannot be blank\");\n        }\n        Event event = new Event();\n        event.setType(eventType);\n        event.setStatus(EventStatus.ERROR);\n        event.setErrorMessage(errorMessage);\n        event.setPayload(serializePayload(payload));\n        event.setTimestamp(Instant.now());\n\n        eventRepository.persist(event);\n        log.error(\"Error event created: {} - {}\", eventType, errorMessage);\n    }\n\n    private String serializePayload(Object payload) {\n        try {\n            return objectMapper.writeValueAsString(payload);\n        } catch (JsonProcessingException e) {\n            throw new IllegalStateException(\"Failed to serialize event payload\", e);\n        }\n    }\n}\n```\n\n## Camel Message Publishing (RabbitMQ)\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class BusinessRulesPublisher {\n    private final ProducerTemplate producerTemplate;\n\n    public void publishSync(BusinessRulesPayload payload) {\n        producerTemplate.sendBody(\n            \"direct:business-rules-publisher\",\n            payload\n        );\n    }\n}\n```\n\n**Camel Route Configuration:**\n\n```java\n@ApplicationScoped\npublic class BusinessRulesRoute extends RouteBuilder {\n\n    @ConfigProperty(name = \"camel.rabbitmq.queue.business-rules\")\n    String businessRulesQueue;\n\n    @ConfigProperty(name = \"rabbitmq.host\")\n    String rabbitHost;\n\n    @ConfigProperty(name = \"rabbitmq.port\")\n    Integer rabbitPort;\n\n    @Override\n    public void configure() {\n        from(\"direct:business-rules-publisher\")\n            .routeId(\"business-rules-publisher\")\n            .log(\"Publishing message to RabbitMQ: ${body}\")\n            .marshal().json(JsonLibrary.Jackson)\n            .toF(\"spring-rabbitmq:%s?hostname=%s&portNumber=%d\",\n                businessRulesQueue, rabbitHost, rabbitPort);\n    }\n}\n```\n\n## Camel Direct Routes (In-Memory)\n\n```java\n@ApplicationScoped\npublic class DocumentProcessingRoute extends RouteBuilder {\n\n    @Override\n    public void configure() {\n        \u002F\u002F Error handling\n        onException(ValidationException.class)\n            .handled(true)\n            .to(\"direct:validation-error-handler\")\n            .log(\"Validation error: ${exception.message}\");\n\n        \u002F\u002F Main processing route\n        from(\"direct:process-document\")\n            .routeId(\"document-processing\")\n            .log(\"Processing document: ${header.documentId}\")\n            .bean(DocumentValidator.class, \"validate\")\n            .bean(DocumentTransformer.class, \"transform\")\n            .choice()\n                .when(header(\"documentType\").isEqualTo(\"INVOICE\"))\n                    .to(\"direct:process-invoice\")\n                .when(header(\"documentType\").isEqualTo(\"CREDIT_NOTE\"))\n                    .to(\"direct:process-credit-note\")\n                .otherwise()\n                    .to(\"direct:process-generic\")\n            .end();\n\n        from(\"direct:validation-error-handler\")\n            .bean(EventService.class, \"createErrorEvent\")\n            .log(\"Validation error handled\");\n    }\n}\n```\n\n## Camel File Processing\n\n```java\n@ApplicationScoped\npublic class FileMonitoringRoute extends RouteBuilder {\n\n    @ConfigProperty(name = \"file.input.directory\")\n    String inputDirectory;\n\n    @ConfigProperty(name = \"file.processed.directory\")\n    String processedDirectory;\n\n    @ConfigProperty(name = \"file.error.directory\")\n    String errorDirectory;\n\n    @Override\n    public void configure() {\n        from(\"file:\" + inputDirectory + \"?move=\" + processedDirectory +\n             \"&moveFailed=\" + errorDirectory + \"&delay=5000\")\n            .routeId(\"file-monitor\")\n            .log(\"Processing file: ${header.CamelFileName}\")\n            .to(\"direct:process-file\");\n\n        from(\"direct:process-file\")\n            .bean(OrderProcessingService.class, \"processFile\")\n            .log(\"File processing completed\");\n    }\n}\n```\n\n## Camel Bean Invocation\n\n```java\n@ApplicationScoped\npublic class InvoiceRoute extends RouteBuilder {\n\n    @Override\n    public void configure() {\n        from(\"direct:invoice-validation\")\n            .bean(InvoiceFlowValidator.class, \"validateFlowWithConfig\")\n            .log(\"Validation result: ${body}\");\n\n        from(\"direct:persist-and-publish\")\n            .bean(DocumentJobService.class, \"createDocumentAndJobEntities\")\n            .bean(BusinessRulesPublisher.class, \"publishAsync\")\n            .bean(EventService.class, \"createSuccessEvent(${body}, 'PUBLISHED')\");\n    }\n}\n```\n\n## REST API Structure\n\n```java\n@Path(\"\u002Fapi\u002Fdocuments\")\n@Produces(MediaType.APPLICATION_JSON)\n@Consumes(MediaType.APPLICATION_JSON)\n@RequiredArgsConstructor\npublic class DocumentResource {\n  private final DocumentService documentService;\n\n  @GET\n  public Response list(\n      @QueryParam(\"page\") @DefaultValue(\"0\") int page,\n      @QueryParam(\"size\") @DefaultValue(\"20\") int size) {\n    List\u003CDocument> documents = documentService.list(page, size);\n    return Response.ok(documents).build();\n  }\n\n  @POST\n  public Response create(@Valid CreateDocumentRequest request, @Context UriInfo uriInfo) {\n    Document document = documentService.create(request);\n    URI location = uriInfo.getAbsolutePathBuilder()\n        .path(String.valueOf(document.id))\n        .build();\n    return Response.created(location).entity(DocumentResponse.from(document)).build();\n  }\n\n  @GET\n  @Path(\"\u002F{id}\")\n  public Response getById(@PathParam(\"id\") Long id) {\n    return documentService.findById(id)\n        .map(DocumentResponse::from)\n        .map(Response::ok)\n        .orElse(Response.status(Response.Status.NOT_FOUND))\n        .build();\n  }\n}\n```\n\n## Repository Pattern (Panache Repository)\n\n```java\n@ApplicationScoped\npublic class DocumentRepository implements PanacheRepository\u003CDocument> {\n\n  public List\u003CDocument> findByStatus(DocumentStatus status, int page, int size) {\n    return find(\"status = ?1 order by createdAt desc\", status)\n        .page(page, size)\n        .list();\n  }\n\n  public Optional\u003CDocument> findByReferenceNumber(String referenceNumber) {\n    return find(\"referenceNumber\", referenceNumber).firstResultOptional();\n  }\n\n  public long countByStatusAndDate(DocumentStatus status, LocalDate date) {\n    return count(\"status = ?1 and createdAt >= ?2\", status, date.atStartOfDay());\n  }\n}\n```\n\n## Service Layer with Transactions\n\n```java\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class DocumentService {\n  private final DocumentRepository repo;\n  private final EventService eventService;\n\n  @Transactional\n  public Document create(CreateDocumentRequest request) {\n    Document document = new Document();\n    document.setReferenceNumber(request.referenceNumber());\n    document.setDescription(request.description());\n    document.setStatus(DocumentStatus.PENDING);\n    document.setCreatedAt(Instant.now());\n\n    repo.persist(document);\n\n    eventService.createSuccessEvent(document, \"DOCUMENT_CREATED\");\n\n    return document;\n  }\n\n  public Optional\u003CDocument> findById(Long id) {\n    return repo.findByIdOptional(id);\n  }\n\n  public List\u003CDocument> list(int page, int size) {\n    return repo.findAll()\n        .page(page, size)\n        .list();\n  }\n}\n```\n\n## DTOs and Validation\n\n```java\npublic record CreateDocumentRequest(\n    @NotBlank @Size(max = 200) String referenceNumber,\n    @NotBlank @Size(max = 2000) String description,\n    @NotNull @FutureOrPresent Instant validUntil,\n    @NotEmpty List\u003C@NotBlank String> categories) {}\n\npublic record DocumentResponse(Long id, String referenceNumber, DocumentStatus status) {\n  public static DocumentResponse from(Document document) {\n    return new DocumentResponse(document.getId(), document.getReferenceNumber(),\n        document.getStatus());\n  }\n}\n```\n\n## Exception Mapping\n\n```java\n@Provider\npublic class ValidationExceptionMapper implements ExceptionMapper\u003CConstraintViolationException> {\n  @Override\n  public Response toResponse(ConstraintViolationException exception) {\n    String message = exception.getConstraintViolations().stream()\n        .map(cv -> cv.getPropertyPath() + \": \" + cv.getMessage())\n        .collect(Collectors.joining(\", \"));\n\n    return Response.status(Response.Status.BAD_REQUEST)\n        .entity(Map.of(\"error\", \"validation_error\", \"message\", message))\n        .build();\n  }\n}\n\n@Provider\n@Slf4j\npublic class GenericExceptionMapper implements ExceptionMapper\u003CException> {\n\n  @Override\n  public Response toResponse(Exception exception) {\n    log.error(\"Unhandled exception\", exception);\n    return Response.status(Response.Status.INTERNAL_SERVER_ERROR)\n        .entity(Map.of(\"error\", \"internal_error\", \"message\", \"An unexpected error occurred\"))\n        .build();\n  }\n}\n```\n\n## CompletableFuture Async Operations\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class FileStorageService {\n    private final S3Client s3Client;\n    private final ExecutorService executorService;\n\n    @ConfigProperty(name = \"storage.bucket-name\")\n    String bucketName;\n\n    public CompletableFuture\u003CStoredDocumentInfo> uploadOriginalFile(\n            InputStream inputStream,\n            long size,\n            LogContext logContext,\n            InvoiceFormat format) {\n\n        return CompletableFuture.supplyAsync(() -> {\n            try (SafeAutoCloseable ignored = CustomLog.startScope(logContext)) {\n                String path = generateStoragePath(format);\n\n                PutObjectRequest request = PutObjectRequest.builder()\n                    .bucket(bucketName)\n                    .key(path)\n                    .contentLength(size)\n                    .build();\n\n                s3Client.putObject(request, RequestBody.fromInputStream(inputStream, size));\n\n                log.info(\"File uploaded to S3: {}\", path);\n\n                return new StoredDocumentInfo(path, size, Instant.now());\n            } catch (Exception e) {\n                log.error(\"Failed to upload file to S3\", e);\n                throw new StorageException(\"Upload failed\", e);\n            }\n        }, executorService);\n    }\n}\n```\n\n## Caching\n\n```java\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class DocumentCacheService {\n  private final DocumentRepository repo;\n\n  @CacheResult(cacheName = \"document-cache\")\n  public Optional\u003CDocument> getById(@CacheKey Long id) {\n    return repo.findByIdOptional(id);\n  }\n\n  @CacheInvalidate(cacheName = \"document-cache\")\n  public void evict(@CacheKey Long id) {}\n\n  @CacheInvalidateAll(cacheName = \"document-cache\")\n  public void evictAll() {}\n}\n```\n\n## Configuration as YAML\n\n```yaml\n# application.yml\n\"%dev\":\n  quarkus:\n    datasource:\n      jdbc:\n        url: jdbc:postgresql:\u002F\u002Flocalhost:5432\u002Fdev_db\n      username: dev_user\n      password: ${DB_PASSWORD}\n    hibernate-orm:\n      database:\n        generation: drop-and-create\n\n  rabbitmq:\n    host: localhost\n    port: 5672\n    username: ${RABBITMQ_USER}\n    password: ${RABBITMQ_PASSWORD}\n\n\"%test\":\n  quarkus:\n    datasource:\n      jdbc:\n        url: jdbc:h2:mem:test\n    hibernate-orm:\n      database:\n        generation: drop-and-create\n\n\"%prod\":\n  quarkus:\n    datasource:\n      jdbc:\n        url: ${DATABASE_URL}\n      username: ${DB_USER}\n      password: ${DB_PASSWORD}\n    hibernate-orm:\n      database:\n        generation: validate\n\n  rabbitmq:\n    host: ${RABBITMQ_HOST}\n    port: ${RABBITMQ_PORT}\n    username: ${RABBITMQ_USER}\n    password: ${RABBITMQ_PASSWORD}\n\n# Camel configuration\ncamel:\n  rabbitmq:\n    queue:\n      business-rules: business-rules-queue\n      invoice-processing: invoice-processing-queue\n```\n\n## Health Checks\n\n```java\n@Readiness\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class DatabaseHealthCheck implements HealthCheck {\n  private final AgroalDataSource dataSource;\n\n  @Override\n  public HealthCheckResponse call() {\n    try (Connection conn = dataSource.getConnection()) {\n      boolean valid = conn.isValid(2);\n      return HealthCheckResponse.named(\"Database connection\")\n          .status(valid)\n          .build();\n    } catch (SQLException e) {\n      return HealthCheckResponse.down(\"Database connection\");\n    }\n  }\n}\n\n@Liveness\n@ApplicationScoped\npublic class CamelHealthCheck implements HealthCheck {\n  @Inject\n  CamelContext camelContext;\n\n  @Override\n  public HealthCheckResponse call() {\n    boolean isStarted = camelContext.getStatus().isStarted();\n    return HealthCheckResponse.named(\"Camel Context\")\n        .status(isStarted)\n        .build();\n  }\n}\n```\n\n## Dependencies (Maven)\n\n```xml\n\u003Cproperties>\n    \u003Cquarkus.platform.version>3.27.0\u003C\u002Fquarkus.platform.version>\n    \u003Clombok.version>1.18.42\u003C\u002Flombok.version>\n    \u003Cassertj-core.version>3.24.2\u003C\u002Fassertj-core.version>\n    \u003Cjacoco-maven-plugin.version>0.8.13\u003C\u002Fjacoco-maven-plugin.version>\n    \u003Cmaven.compiler.release>17\u003C\u002Fmaven.compiler.release>\n\u003C\u002Fproperties>\n\n\u003CdependencyManagement>\n    \u003Cdependencies>\n        \u003Cdependency>\n            \u003CgroupId>io.quarkus.platform\u003C\u002FgroupId>\n            \u003CartifactId>quarkus-bom\u003C\u002FartifactId>\n            \u003Cversion>${quarkus.platform.version}\u003C\u002Fversion>\n            \u003Ctype>pom\u003C\u002Ftype>\n            \u003Cscope>import\u003C\u002Fscope>\n        \u003C\u002Fdependency>\n        \u003Cdependency>\n            \u003CgroupId>io.quarkus.platform\u003C\u002FgroupId>\n            \u003CartifactId>quarkus-camel-bom\u003C\u002FartifactId>\n            \u003Cversion>${quarkus.platform.version}\u003C\u002Fversion>\n            \u003Ctype>pom\u003C\u002Ftype>\n            \u003Cscope>import\u003C\u002Fscope>\n        \u003C\u002Fdependency>\n    \u003C\u002Fdependencies>\n\u003C\u002FdependencyManagement>\n\n\u003Cdependencies>\n    \u003C!-- Quarkus Core -->\n    \u003Cdependency>\n        \u003CgroupId>io.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>quarkus-arc\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>io.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>quarkus-config-yaml\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\n    \u003C!-- Camel Extensions -->\n    \u003Cdependency>\n        \u003CgroupId>org.apache.camel.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>camel-quarkus-spring-rabbitmq\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.apache.camel.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>camel-quarkus-direct\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.apache.camel.quarkus\u003C\u002FgroupId>\n        \u003CartifactId>camel-quarkus-bean\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\n    \u003C!-- Lombok -->\n    \u003Cdependency>\n        \u003CgroupId>org.projectlombok\u003C\u002FgroupId>\n        \u003CartifactId>lombok\u003C\u002FartifactId>\n        \u003Cversion>${lombok.version}\u003C\u002Fversion>\n        \u003Cscope>provided\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n\n    \u003C!-- Logging -->\n    \u003Cdependency>\n        \u003CgroupId>io.quarkiverse.logging.logback\u003C\u002FgroupId>\n        \u003CartifactId>quarkus-logging-logback\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.logstash.logback\u003C\u002FgroupId>\n        \u003CartifactId>logstash-logback-encoder\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n```\n\n## Best Practices\n\n### Architecture\n- Use `@RequiredArgsConstructor` with Lombok for constructor injection\n- Keep service layer thin; delegate complex logic to specialized classes\n- Use Camel routes for message routing and integration patterns\n- Prefer Panache Repository pattern for data access\n\n### Event-Driven\n- Always track operations with EventService (success\u002Ferror events)\n- Use Camel `direct:` endpoints for in-memory routing\n- Use `spring-rabbitmq` component for RabbitMQ integration\n- Implement async publishing with `ProducerTemplate.asyncSendBody()`\n\n### Logging\n- Use Logback with Logstash encoder for structured logging\n- Propagate LogContext through service calls with `SafeAutoCloseable`\n- Add contextual information to LogContext for request tracing\n- Use `@Slf4j` instead of manual logger instantiation\n\n### Async Operations\n- Use CompletableFuture for non-blocking I\u002FO operations\n- Call `.join()` when you need to wait for completion\n- Handle exceptions from CompletableFuture properly\n- Pass LogContext to async operations for tracing\n\n### Configuration\n- Use YAML configuration (`quarkus-config-yaml`)\n- Profile-aware configuration for dev\u002Ftest\u002Fprod environments\n- Externalize sensitive configuration to environment variables\n- Use `@ConfigProperty` for type-safe config injection\n\n### Validation\n- Validate at resource layer with `@Valid`\n- Use Bean Validation annotations on DTOs\n- Map exceptions to proper HTTP responses with `@Provider`\n\n### Transactions\n- Use `@Transactional` on service methods that modify data\n- Keep transactions short and focused\n- Avoid calling async operations within transactions\n\n### Testing\n- Use `camel-quarkus-junit5` for route testing\n- Use AssertJ for assertions\n- Mock all external dependencies\n- Test conditional flow logic thoroughly\n\n### Quarkus-Specific\n- Stay on latest LTS version (3.x)\n- Use Quarkus dev mode for hot reload\n- Add health checks for production readiness\n- Test native compilation compatibility periodically\n",{"name":5,"metadata":24,"description":7},{"origin":25},"ECC","main","a73152352c0612252131e5cf84e91312a6cf17dc","backend-database\u002Fquarkus-patterns","https:\u002F\u002Fgithub.com\u002FHenrique1601\u002FSkiilsToIAs","https:\u002F\u002Fgithub.com\u002FHenrique1601","https:\u002F\u002Fbezerraportifolio.netlify.app\u002F","Full Stack Developer | React, Next.js, TypeScript, Node.js & IA | Construindo produtos digitais e soluções SaaS","2026-11-15 02:56:04",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Henrique1601\u002FSkiilsToIAs --skill quarkus-patterns",{"tool":40,"command":41},"bunx","bunx skills add Henrique1601\u002FSkiilsToIAs --skill quarkus-patterns",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Henrique1601\u002FSkiilsToIAs --skill quarkus-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHenrique1601\u002FSkiilsToIAs\u002Fblob\u002Fmain\u002Fbackend-database\u002Fquarkus-patterns\u002FSKILL.md",true,[],[49,56,63,71,78,85],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7E2ANBW9V6AVX5JXNCEAWF8","rag-architect-agent","Agente Arquiteto de RAG, Embeddings & Busca Vetorial. Especialista em design e implementação de pipelines de Retrieval-Augmented Generation de alta fidelidade: chunking semântico, modelagem pgvector no PostgreSQL (Neon\u002FSupabase), busca híbrida (cosseno + BM25), reranking, validação via TypeSafe AI e filosofia Ponytail (anti-overengineering).","https:\u002F\u002Fgithub.com\u002FHenrique1601\u002FSkiilsToIAs\u002Fblob\u002Fmain\u002Fcustom-agents\u002Frag-architect-agent\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7E29KKF8R02ZRGYE2MJM67G","rag-architecture-patterns","Padrões arquiteturais e implementação de pipelines RAG (Retrieval-Augmented Generation) de alta fidelidade para qualquer projeto ou sistema. Cobre chunking semântico, embeddings, busca híbrida (pgvector + BM25), reranking, validação via TypeSafe AI e filosofia Ponytail (anti-overengineering).","https:\u002F\u002Fgithub.com\u002FHenrique1601\u002FSkiilsToIAs\u002Fblob\u002Fmain\u002Fai-agents\u002Frag-architecture-patterns\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7CWRA8E3BJ7CPY8N8EG28J1","skill-repair","Use this to fix and re-install agent skills that have failed installation.\nThis skill provides the necessary context and permissions to surgically update\nthe `manifest.json` after a fix has been applied.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FHenrique1601\u002FSkiilsToIAs\u002Fblob\u002Fmain\u002Futilities\u002Fskill-repair\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7CWR66FZP8FA47WVZ4Z2EXC","security-scan","Scan your Claude Code configuration (.claude\u002F directory) for security vulnerabilities, misconfigurations, and injection risks using AgentShield. Checks CLAUDE.md, settings.json, MCP servers, hooks, and agent definitions.","https:\u002F\u002Fgithub.com\u002FHenrique1601\u002FSkiilsToIAs\u002Fblob\u002Fmain\u002Futilities\u002Fsecurity-scan\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7CWR0QPY58QPTR1P759TFNG","security-review","Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment\u002Fsensitive features. Provides comprehensive security checklist and patterns.","https:\u002F\u002Fgithub.com\u002FHenrique1601\u002FSkiilsToIAs\u002Fblob\u002Fmain\u002Futilities\u002Fsecurity-review\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7CWQXCE40XWT4FZ3VWZFGDP","security-bounty-hunter","Hunt for exploitable, bounty-worthy security issues in repositories. Focuses on remotely reachable vulnerabilities that qualify for real reports instead of noisy local-only findings.","https:\u002F\u002Fgithub.com\u002FHenrique1601\u002FSkiilsToIAs\u002Fblob\u002Fmain\u002Futilities\u002Fsecurity-bounty-hunter\u002FSKILL.md",[],[]]