docs: enhance Kafka adapter documentation with detailed class and async configuration information

- Expanded the Kafka adapter documentation to include descriptions of five adapter classes for admin, sync, and async operations.
- Updated the tutorial to reflect the addition of async variants and their specific configuration options.
- Improved logging examples in the tutorial for better clarity and consistency.
- Added a section on async adapters, detailing their lazy initialization and usage in non-async contexts.

Author: HosseinNejatiJavaremi

docs/api_reference/adapters/kafka.md

@@ -5,12 +5,22 @@ description: API reference for the Kafka adapter ports, adapters, and mocks.
 
 # Kafka
 
-The `kafka` adapter provides integration with Apache Kafka for producing and consuming messages in event-driven
-architectures.
+The `kafka` adapter provides integration with Apache Kafka for producing and consuming messages in
+event-driven architectures. It ships **five** adapter classes — one for admin operations and two
+sync/async pairs for producing and consuming.
+
+| Class                       | Mode  | Port                     |
+|-----------------------------|-------|--------------------------|
+| `KafkaAdminAdapter`         | sync  | `KafkaAdminPort`         |
+| `KafkaProducerAdapter`      | sync  | `KafkaProducerPort`      |
+| `KafkaConsumerAdapter`      | sync  | `KafkaConsumerPort`      |
+| `AsyncKafkaProducerAdapter` | async | `AsyncKafkaProducerPort` |
+| `AsyncKafkaConsumerAdapter` | async | `AsyncKafkaConsumerPort` |
 
 ## Ports
 
-Abstract port interface defining the Kafka adapter contract for message production and consumption.
+Abstract port interfaces defining the Kafka adapter contracts for sync and async message
+production and consumption.
 
 ::: archipy.adapters.kafka.ports
 options:
@@ -19,7 +29,8 @@ heading_level: 3
 
 ## Adapters
 
-Concrete Kafka adapter implementing producer and consumer patterns with ArchiPy conventions.
+Concrete Kafka adapter implementations for both sync and async producer/consumer patterns,
+built on `confluent_kafka` and `confluent_kafka.aio`.
 
 ::: archipy.adapters.kafka.adapters
 options: