[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AJZ646S73WR20140BB4E9K":3,"skill-same:01M7AJZ646S73WR20140BB4E9K":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":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7AJZ646S73WR20140BB4E9K","quarkus-patterns",null,"Patrones de arquitectura Quarkus 3.x LTS con Camel para mensajería, diseño de API RESTful, servicios CDI, acceso a datos con Panache y procesamiento asíncrono.","Cyrilthetecchieee\u002Fcyril-code-","Cyrilthetecchieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219787998?v=4","01M7AF0MMMKRAA0H61XMJPV92H","Julian Cyril D ","01M7AF0MQ10AVG6QJQ1C2BC0F5",2,"MIT","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fes\u002Fskills\u002Fquarkus-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: quarkus-patterns\ndescription: Patrones de arquitectura Quarkus 3.x LTS con Camel para mensajería, diseño de API RESTful, servicios CDI, acceso a datos con Panache y procesamiento asíncrono.\norigin: ECC\n---\n\n# Patrones de Desarrollo Quarkus\n\nPatrones de arquitectura y API de Quarkus 3.x para servicios cloud-native y orientados a eventos con Apache Camel.\n\n## Cuándo Activar\n\n- Construir APIs REST con JAX-RS o RESTEasy Reactive\n- Estructurar capas resource → service → repository\n- Implementar patrones orientados a eventos con Apache Camel y RabbitMQ\n- Configurar Hibernate Panache, caché o streams reactivos\n- Agregar validación, mapeo de excepciones o paginación\n- Configurar perfiles para entornos dev\u002Fstaging\u002Fproducción (configuración YAML)\n- Logging personalizado con LogContext y Logback\u002FLogstash encoder\n- Trabajar con CompletableFuture para operaciones asíncronas\n- Implementar procesamiento condicional de flujos\n- Trabajar con compilación nativa GraalVM\n\n## Capa de Servicio con Múltiples Dependencias\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(\"Orden procesada {}\", order.id);\n        return receipt;\n    }\n}\n```\n\n**Patrones Clave:**\n- `@RequiredArgsConstructor` para inyección por constructor mediante Lombok\n- `@Slf4j` para logging con Logback\n- `@Transactional` en métodos de servicio que escriben a través de Panache o repositorios\n- Validar entrada antes de persistencia o publicación de mensajes\n- Seguimiento de eventos para escenarios de éxito\u002Ferror\n- Publicación asíncrona de mensajes Camel\n\n## Patrón de Contexto de Logging Personalizado (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            logContext.put(\"documentId\", doc.getId().toString());\n            logContext.put(\"documentType\", doc.getType());\n            logContext.put(\"userId\", SecurityContext.getUserId());\n\n            log.info(\"Iniciando procesamiento de documento\");\n\n            processInternal(doc);\n\n            log.info(\"Procesamiento de documento completado\");\n        } catch (Exception e) {\n            log.error(\"Error en el procesamiento de documento\", e);\n            throw e;\n        }\n    }\n}\n```\n\n**Configuración de Logback (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## Patrón de Servicio de Eventos\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, \"El payload no puede ser 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(\"Evento de éxito creado: {}\", eventType);\n    }\n\n    public void createErrorEvent(Object payload, String eventType, String errorMessage) {\n        Objects.requireNonNull(payload, \"El payload no puede ser null\");\n        if (errorMessage == null || errorMessage.isBlank()) {\n            throw new IllegalArgumentException(\"El mensaje de error no puede estar en blanco\");\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(\"Evento de error creado: {} - {}\", 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(\"Error al serializar el payload del evento\", e);\n        }\n    }\n}\n```\n\n## Publicación de Mensajes Camel (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**Configuración de Ruta Camel:**\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(\"Publicando mensaje en 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## Rutas Camel Direct (En Memoria)\n\n```java\n@ApplicationScoped\npublic class DocumentProcessingRoute extends RouteBuilder {\n\n    @Override\n    public void configure() {\n        onException(ValidationException.class)\n            .handled(true)\n            .to(\"direct:validation-error-handler\")\n            .log(\"Error de validación: ${exception.message}\");\n\n        from(\"direct:process-document\")\n            .routeId(\"document-processing\")\n            .log(\"Procesando documento: ${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}\n```\n\n## Procesamiento de Archivos Camel\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(\"Procesando archivo: ${header.CamelFileName}\")\n            .to(\"direct:process-file\");\n    }\n}\n```\n\n## Estructura de API REST\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## Patrón de Repositorio (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```\n\n## Capa de Servicio con Transacciones\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```\n\n## DTOs y Validación\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## Mapeo de Excepciones\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\n## Operaciones Asíncronas con CompletableFuture\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class FileStorageService {\n    private final S3Client s3Client;\n    private final ExecutorService executorService;\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                return new StoredDocumentInfo(path, size, Instant.now());\n            } catch (Exception e) {\n                log.error(\"Error al subir archivo a S3\", e);\n                throw new StorageException(\"Subida fallida\", e);\n            }\n        }, executorService);\n    }\n}\n```\n\n## Caché\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```\n\n## Configuración como 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\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```\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\n## Dependencias (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\n## Buenas Prácticas\n\n### Arquitectura\n- Usar `@RequiredArgsConstructor` con Lombok para inyección por constructor\n- Mantener la capa de servicio delgada; delegar lógica compleja a clases especializadas\n- Usar rutas Camel para enrutamiento de mensajes y patrones de integración\n- Preferir el patrón Panache Repository para acceso a datos\n\n### Orientado a Eventos\n- Siempre rastrear operaciones con EventService (eventos de éxito\u002Ferror)\n- Usar endpoints `direct:` de Camel para enrutamiento en memoria\n- Usar el componente `spring-rabbitmq` para integración con RabbitMQ\n\n### Logging\n- Usar Logback con Logstash encoder para logging estructurado\n- Propagar LogContext a través de llamadas de servicio con `SafeAutoCloseable`\n- Usar `@Slf4j` en lugar de instanciación manual del logger\n\n### Configuración\n- Usar configuración YAML (`quarkus-config-yaml`)\n- Configuración consciente de perfil para entornos dev\u002Ftest\u002Fprod\n- Externalizar configuración sensible a variables de entorno\n","# Patrones de Desarrollo Quarkus\n\nPatrones de arquitectura y API de Quarkus 3.x para servicios cloud-native y orientados a eventos con Apache Camel.\n\n## Cuándo Activar\n\n- Construir APIs REST con JAX-RS o RESTEasy Reactive\n- Estructurar capas resource → service → repository\n- Implementar patrones orientados a eventos con Apache Camel y RabbitMQ\n- Configurar Hibernate Panache, caché o streams reactivos\n- Agregar validación, mapeo de excepciones o paginación\n- Configurar perfiles para entornos dev\u002Fstaging\u002Fproducción (configuración YAML)\n- Logging personalizado con LogContext y Logback\u002FLogstash encoder\n- Trabajar con CompletableFuture para operaciones asíncronas\n- Implementar procesamiento condicional de flujos\n- Trabajar con compilación nativa GraalVM\n\n## Capa de Servicio con Múltiples Dependencias\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(\"Orden procesada {}\", order.id);\n        return receipt;\n    }\n}\n```\n\n**Patrones Clave:**\n- `@RequiredArgsConstructor` para inyección por constructor mediante Lombok\n- `@Slf4j` para logging con Logback\n- `@Transactional` en métodos de servicio que escriben a través de Panache o repositorios\n- Validar entrada antes de persistencia o publicación de mensajes\n- Seguimiento de eventos para escenarios de éxito\u002Ferror\n- Publicación asíncrona de mensajes Camel\n\n## Patrón de Contexto de Logging Personalizado (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            logContext.put(\"documentId\", doc.getId().toString());\n            logContext.put(\"documentType\", doc.getType());\n            logContext.put(\"userId\", SecurityContext.getUserId());\n\n            log.info(\"Iniciando procesamiento de documento\");\n\n            processInternal(doc);\n\n            log.info(\"Procesamiento de documento completado\");\n        } catch (Exception e) {\n            log.error(\"Error en el procesamiento de documento\", e);\n            throw e;\n        }\n    }\n}\n```\n\n**Configuración de Logback (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## Patrón de Servicio de Eventos\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, \"El payload no puede ser 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(\"Evento de éxito creado: {}\", eventType);\n    }\n\n    public void createErrorEvent(Object payload, String eventType, String errorMessage) {\n        Objects.requireNonNull(payload, \"El payload no puede ser null\");\n        if (errorMessage == null || errorMessage.isBlank()) {\n            throw new IllegalArgumentException(\"El mensaje de error no puede estar en blanco\");\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(\"Evento de error creado: {} - {}\", 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(\"Error al serializar el payload del evento\", e);\n        }\n    }\n}\n```\n\n## Publicación de Mensajes Camel (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**Configuración de Ruta Camel:**\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(\"Publicando mensaje en 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## Rutas Camel Direct (En Memoria)\n\n```java\n@ApplicationScoped\npublic class DocumentProcessingRoute extends RouteBuilder {\n\n    @Override\n    public void configure() {\n        onException(ValidationException.class)\n            .handled(true)\n            .to(\"direct:validation-error-handler\")\n            .log(\"Error de validación: ${exception.message}\");\n\n        from(\"direct:process-document\")\n            .routeId(\"document-processing\")\n            .log(\"Procesando documento: ${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}\n```\n\n## Procesamiento de Archivos Camel\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(\"Procesando archivo: ${header.CamelFileName}\")\n            .to(\"direct:process-file\");\n    }\n}\n```\n\n## Estructura de API REST\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## Patrón de Repositorio (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```\n\n## Capa de Servicio con Transacciones\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```\n\n## DTOs y Validación\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## Mapeo de Excepciones\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\n## Operaciones Asíncronas con CompletableFuture\n\n```java\n@Slf4j\n@ApplicationScoped\n@RequiredArgsConstructor\npublic class FileStorageService {\n    private final S3Client s3Client;\n    private final ExecutorService executorService;\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                return new StoredDocumentInfo(path, size, Instant.now());\n            } catch (Exception e) {\n                log.error(\"Error al subir archivo a S3\", e);\n                throw new StorageException(\"Subida fallida\", e);\n            }\n        }, executorService);\n    }\n}\n```\n\n## Caché\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```\n\n## Configuración como 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\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```\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\n## Dependencias (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\n## Buenas Prácticas\n\n### Arquitectura\n- Usar `@RequiredArgsConstructor` con Lombok para inyección por constructor\n- Mantener la capa de servicio delgada; delegar lógica compleja a clases especializadas\n- Usar rutas Camel para enrutamiento de mensajes y patrones de integración\n- Preferir el patrón Panache Repository para acceso a datos\n\n### Orientado a Eventos\n- Siempre rastrear operaciones con EventService (eventos de éxito\u002Ferror)\n- Usar endpoints `direct:` de Camel para enrutamiento en memoria\n- Usar el componente `spring-rabbitmq` para integración con RabbitMQ\n\n### Logging\n- Usar Logback con Logstash encoder para logging estructurado\n- Propagar LogContext a través de llamadas de servicio con `SafeAutoCloseable`\n- Usar `@Slf4j` en lugar de instanciación manual del logger\n\n### Configuración\n- Usar configuración YAML (`quarkus-config-yaml`)\n- Configuración consciente de perfil para entornos dev\u002Ftest\u002Fprod\n- Externalizar configuración sensible a variables de entorno\n",{"name":5,"origin":24,"description":7},"ECC","main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fes\u002Fskills\u002Fquarkus-patterns",0,"https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee","https:\u002F\u002Fwithcyril.me\u002F","Hi, I’m Julian Cyril D, a Computer Science and Business Systems student at PSNACET.\r\nI’m passionate about full-stack development, UI\u002FUX design, and building sma","2026-11-04 23:28:50",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Cyrilthetecchieee\u002Fcyril-code- --skill quarkus-patterns",{"tool":40,"command":41},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill quarkus-patterns",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill quarkus-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fes\u002Fskills\u002Fquarkus-patterns\u002FSKILL.md",true,[],[49,58,65,73,80,87],{"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":53,"licenseFileUrl":54,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7AQV6CYX8RMC78420V9WZ62","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7AQV2895N3S1MEX6K76G6G2","youtube-downloader","Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fvideo-downloader\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AQTRNX62DNKVZ5GXEHRBKB","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AQTNNVHAAN9H6DA8T6ZVE0","template-skill","Replace with description of the skill and when Claude should use it.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftemplate-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AQTJ3MQ6AKX152MEX2MYCC","tailored-resume-generator","Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftailored-resume-generator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7AQTD7D5MYET2YWG7HG9WM3","slack-gif-creator","Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like \"make me a GIF for Slack of X doing Y\".","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FSKILL.md",[],[]]