1.2.12 (#58)

* 1.2.12

* Add metrics info (#56)

* Add metrics info

---------

Co-authored-by: Судомоин Даниил Сергеевич <d.sudomoin@tbank.ru>

* 1.2.12

* 1.2.12

---------

Co-authored-by: dsudomoin <155488585+dsudomoin@users.noreply.github.com>
Co-authored-by: Судомоин Даниил Сергеевич <d.sudomoin@tbank.ru>

Author: 3 people

mkdocs/config/en/mkdocs.yml

@@ -3,7 +3,7 @@ site_dir: "../../generated/en"
 
 
 # Project information
-site_name: Kora Framework 1.2.8
+site_name: Kora Framework 1.2.12
 site_url: https://kora-projects.github.io/kora-docs/en/
 nav:
   - Examples:
@@ -54,6 +54,8 @@ nav:
         - Camunda BPMN: documentation/camunda7-bpmn.md
         - Camunda REST: documentation/camunda7-rest.md
         - Camunda Zeebe: documentation/camunda8-worker.md
+  - Community:
+      - Development: community/development.md
   - Changelog: changelog/changelog.md
 
 

mkdocs/config/ru/mkdocs.yml

@@ -3,7 +3,7 @@ site_dir: "../../generated/ru"
 
 
 # Project information
-site_name: Kora фреймворк 1.2.8
+site_name: Kora фреймворк 1.2.12
 site_url: https://kora-projects.github.io/kora-docs/ru/
 nav:
   - Примеры:
@@ -54,6 +54,8 @@ nav:
         - Camunda BPMN: documentation/camunda7-bpmn.md
         - Camunda REST: documentation/camunda7-rest.md
         - Camunda Zeebe: documentation/camunda8-worker.md
+  - Сообщество:
+      - Разработки: community/development.md
   - Журнал изменений: changelog/changelog.md
 
 

mkdocs/docs/en/changelog/changelog.md

@@ -5,7 +5,51 @@ hide:
   - navigation
 ---
 
-## 1.2.8
+## 1.2.12
+
+Added:
+
+- Added OpenAPI generate support for `nameMapping` option for field names
+
+Fixed:
+
+- Fixed `KafkaPublisher` correct method handling of `CompletableFuture` signature in Kotlin
+- Fixed HTTP declarative client usage of `Map<String, List<T>>` query parameter
+- Fixed OpenAPI generate correct reserved keyword field names and support for `nameMapping` option
+
+### 1.2.11
+
+Added:
+
+- Enriched Flyway config with more options
+
+Fixed:
+
+- Fixed interface config default values in Kotlin broken in `1.2.10`
+- Fixed `TraceParent` header in HTTP server responses when interceptor throws error
+
+### 1.2.10
+
+Added:
+
+- Added aware of default values in constructors of `data` classes configs in Kotlin
+
+Fixed:
+
+- Fixed HTTP spans not following OpenTelemetry status specification
+- Fixed SQL parameter regex to handle `=` symbol without spaces for repositories
+
+### 1.2.9
+
+Added:
+- Add MAX_ENTITY_SIZE undertow option in http server config with default `256MiB`
+
+Fixed:
+
+- Fixed not necessary clearing HTTP server telemetry context after starting request processing
+- Fixed JUnit extension support for `Wrapped<T>` components finding in TestGraph
+
+### 1.2.8
 
 Fixed:
 

mkdocs/docs/en/community/development.md

@@ -0,0 +1,11 @@
+---
+search:
+  exclude: true
+---
+
+This section provides developments and extensions for Kora Framework created by the community.
+
+## Kora plugin
+
+[Kora plugin for IntelliJ IDEA](https://plugins.jetbrains.com/plugin/30225-kora) provides navigation 
+and display of dependency injection points and their implementations within Kora DI.

mkdocs/docs/en/documentation/cache.md

@@ -211,6 +211,8 @@ Example of a complete configuration for `mycache.config` cache, parameters are d
     2.  When reading, sets the time [expiration](https://redis.io/commands/getex/) (optional)
     3.  Prefix a key in a specific cache to avoid key collisions within a Redis database, can be an empty string then keys will be without prefixes (**required**)
 
+Module metrics are described in the [Metrics Reference](metrics.md#cache) section.
+
 #### Configurator
 
 Можно зарегистрировать `LettuceConfigurator` который позволит до настроить `Lettuce` клиент перед созданием.

mkdocs/docs/en/documentation/camunda7-bpmn.md

@@ -176,6 +176,8 @@ Example of the complete configuration described in the `CamundaEngineBpmnConfig`
     22. Enables collection of engine metrics/telemetry (default is `false`)
     23. Enables module tracing (default `true`)
 
+Module metrics are described in the [Metrics Reference](metrics.md#camunda-7-bpmn) section.
+
 ## Applications
 
 You can register in Camunda user [JavaDelegate](https://docs.camunda.org/manual/7.21/user-guide/process-engine/delegation-code/)

mkdocs/docs/en/documentation/camunda8-worker.md

@@ -159,6 +159,8 @@ Example of a complete client configuration described in the `ZeebeClientConfig`
     19. Configures [SLO](https://www.atlassian.com/ru/incident-management/kpis/sla-vs-slo-vs-sli) for [DistributionSummary](https://github.com/micrometer-metrics/micrometer-docs/blob/main/src/docs/concepts/distribution-summaries.adoc) metrics
     20. Enables module tracing (default `true`)
 
+Module metrics are described in the [Metrics Reference](metrics.md#camunda-8-worker) section.
+
 ## Worker
 
 Worker is a handler that can perform a specific job in a process.

mkdocs/docs/en/documentation/database-migration.md

@@ -42,20 +42,44 @@ Example of the complete configuration described in the `FlywayConfig` class (def
 
     ```javascript
     flyway {
-        locations = "db/migration" //(1)!
+        enabled = true //(1)!
+        locations = ["db/migration"] //(2)!
+        executeInTransaction = true //(3)!
+        validateOnMigrate = true //(4)!
+        mixed = false //(5)!
+        configurationProperties = {} //(6)!
     }
     ```
 
-    1.  Directory paths where to look for migration scripts
+    1. Whether database migration is enabled when the application starts. If `false`, migrations will not be executed.
+    2. Directory paths where migration scripts are located.
+    3. Whether to execute migrations within a transaction.
+    4. Whether to verify checksums of existing migrations before execution. An error will occur if they do not match.
+    5. Whether to allow mixing transactional and non-transactional SQL operations in a single migration. If enabled, the entire migration will be executed **without a transaction** to avoid errors in databases where certain operations cannot be run inside a transaction.
+
+       This setting is only relevant for databases that do not support executing certain operations within a transaction: PostgreSQL, Aurora PostgreSQL, SQL Server, and SQLite.
+    6. Additional key-value configuration properties for `Flyway#configurationProperties`.
 
 === ":simple-yaml: `YAML`"
 
     ```yaml
     flyway:
-      locations: "db/migration" #(1)!
+        enabled: true #(1)!
+        locations: ["db/migration"] #(2)!
+        executeInTransaction: true #(3)!
+        validateOnMigrate: true #(4)!
+        mixed: false #(5)!
+        configurationProperties: {} #(6)!
     ```
 
-    1.  Directory paths where to look for migration scripts
+    1. Whether database migration is enabled when the application starts. If `false`, migrations will not be executed.
+    2. Directory paths where migration scripts are located.
+    3. Whether to execute migrations within a transaction.
+    4. Whether to verify checksums of existing migrations before execution. An error will occur if they do not match.
+    5. Whether to allow mixing transactional and non-transactional SQL operations in a single migration. If enabled, the entire migration will be executed **without a transaction** to avoid errors in databases where certain operations cannot be run inside a transaction.
+
+       This setting is only relevant for databases that do not support executing certain operations within a transaction: PostgreSQL, Aurora PostgreSQL, SQL Server, and SQLite.
+    6. Additional key-value configuration properties for `Flyway#configurationProperties`.
 
 ## Liquibase
 

mkdocs/docs/en/documentation/general.md

@@ -125,7 +125,7 @@ dependency `ru.tinkoff.kora:kora-parent` which requires to specify the version o
     }
 
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.8")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.12")
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
     }
     ```
@@ -164,7 +164,7 @@ dependency `ru.tinkoff.kora:kora-parent` which requires to specify the version o
     }
 
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.8"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.12"))
         ksp("ru.tinkoff.kora:symbol-processors")
     }
     ```
@@ -190,7 +190,7 @@ and the [BOM dependency](https://docs.gradle.org/current/userguide/platforms.htm
     }
 
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.8")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.12")
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
     }
     ```
@@ -209,7 +209,7 @@ and the [BOM dependency](https://docs.gradle.org/current/userguide/platforms.htm
     }
 
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.8"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.12"))
         ksp("ru.tinkoff.kora:symbol-processors")
     }
     ```

mkdocs/docs/en/documentation/grpc-client.md

@@ -164,6 +164,8 @@ Example of the complete configuration described in the `GrpcClientConfig` class
 
 You can also configure [Netty transport](netty.md).
 
+Module metrics are described in the [Metrics Reference](metrics.md#grpc-client) section.
+
 ## Service
 
 Created gRPC services can be injected as dependency: