Version: 0.4.9.dev.260309

feat: 🗄️ 新增自动建表功能

* 新增项目启动时自动建表能力，减少手动初始化数据库步骤
* 解决 `agent_chat` 与 `chat_history` 结构体互相持有对方结构体用于 `preload` 导致的循环依赖问题
* 修复因结构体互相依赖引发的建表失败问题，保证数据库初始化流程稳定

feat: 🐳 Docker Compose 引入 Kafka 分区自动初始化

* 更新 `docker-compose` 配置，引入 Kafka partition 自动初始化脚本
* 保证服务启动后 Topic 即具备可用 partition，实现开箱即用
* 修复转移环境后 MySQL 等容器数据无法持久化的问题，统一改为使用命名卷进行数据持久化

docs: 📚 补充 Outbox + Kafka 持久化链路注释

* 为 Outbox + Kafka 消息持久化链路补充详细代码注释
* 提升异步消息链路的可读性与维护性
* 当前代码 Review 进度约 50%

undo: ⚠️ Kafka 初始化阶段出现消息短暂堆积

* 初次初始化项目时观察到消息在 Kafka 中短暂堆积现象
* 后续被消费者一次性消费且未再次复现
* 已在生产者启动、消费者启动以及消息消费流程中增加控制台日志输出，降低系统黑箱程度
* 后续若条件允许将进一步排查该现象的触发原因

docker-compose.yml

@@ -1,8 +1,8 @@
 services:
   mysql:
     image: mysql:8.0
-    container_name: SmartFlow-mysql
-    restart: always
+    container_name: smartflow-mysql
+    restart: unless-stopped
     environment:
       MYSQL_ROOT_PASSWORD: root_password_123
       MYSQL_DATABASE: smartflow
@@ -10,24 +10,34 @@ services:
       MYSQL_PASSWORD: smartflow_password_456
     ports:
       - "3306:3306"
-    volumes:
-      - ./docker/mysql/data:/var/lib/mysql
     command: --default-authentication-plugin=mysql_native_password
+    volumes:
+      - mysql_data:/var/lib/mysql
+    healthcheck:
+      test: ["CMD-SHELL", "mysqladmin ping -h localhost -uroot -proot_password_123"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
 
   redis:
-    image: redis:latest
-    container_name: redflow-redis
-    restart: always
-    command: redis-server --requirepass redis_password_789
+    image: redis:7
+    container_name: smartflow-redis
+    restart: unless-stopped
+    command: redis-server --appendonly yes --requirepass redis_password_789
     ports:
       - "6379:6379"
     volumes:
-      - ./docker/redis/data:/data
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "-a", "redis_password_789", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
 
   kafka:
     image: apache/kafka:3.7.2
-    container_name: SmartFlow-kafka
-    restart: always
+    container_name: smartflow-kafka
+    restart: unless-stopped
     ports:
       - "9092:9092"
     environment:
@@ -40,16 +50,39 @@ services:
       KAFKA_INTER_BROKER_LISTENER_NAME: INTERNAL
       KAFKA_CONTROLLER_LISTENER_NAMES: CONTROLLER
       KAFKA_CONTROLLER_QUORUM_VOTERS: 1@kafka:9093
-      KAFKA_AUTO_CREATE_TOPICS_ENABLE: "false"
+      KAFKA_AUTO_CREATE_TOPICS_ENABLE: "true"
       KAFKA_NUM_PARTITIONS: 3
+      KAFKA_DEFAULT_REPLICATION_FACTOR: 1
       KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1
       KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR: 1
       KAFKA_TRANSACTION_STATE_LOG_MIN_ISR: 1
       KAFKA_LOG_DIRS: /var/lib/kafka/data
     volumes:
       - kafka_data:/var/lib/kafka/data
+    healthcheck:
+      test: ["CMD-SHELL", "/opt/kafka/bin/kafka-topics.sh --bootstrap-server localhost:9092 --list >/dev/null 2>&1"]
+      interval: 10s
+      timeout: 5s
+      retries: 15
+
+  kafka-init:
+    image: apache/kafka:3.7.2
+    container_name: smartflow-kafka-init
+    depends_on:
+      kafka:
+        condition: service_healthy
+    entrypoint: ["/bin/bash", "-c"]
+    command: >
+      /opt/kafka/bin/kafka-topics.sh
+      --bootstrap-server kafka:9094
+      --create
+      --if-not-exists
+      --topic smartflow.agent.outbox
+      --partitions 3
+      --replication-factor 1
+    restart: "no"
 
 volumes:
   mysql_data:
   redis_data:
-  kafka_data:
+  kafka_data: