feat: 接入论坛奖励 outbox 链路

backend/services/taskclassforum/dao/connect.go

@@ -3,6 +3,7 @@ package dao
 import (
 	"fmt"
 
+	outboxinfra "github.com/LoveLosita/smartflow/backend/infra/outbox"
 	forummodel "github.com/LoveLosita/smartflow/backend/services/taskclassforum/model"
 	"github.com/spf13/viper"
 	"gorm.io/driver/mysql"
@@ -12,7 +13,7 @@ import (
 // OpenDBFromConfig 创建计划广场服务自己的数据库句柄，并迁移本服务私有表。
 //
 // 职责边界：
-// 1. 只迁移 forum_* 表，不迁移 task_classes / task_items，避免抢占 task-class 拆分线；
+// 1. 只迁移 forum_* 表和本服务 outbox 表，不迁移 task_classes / task_items，避免抢占 task-class 拆分线；
 // 2. 不负责装配 legacy TaskClass adapter，adapter 在服务实现阶段单独注入；
 // 3. 返回 *gorm.DB 供本服务 DAO 复用，调用方负责进程生命周期。
 func OpenDBFromConfig() (*gorm.DB, error) {
@@ -41,8 +42,10 @@ func OpenDBFromConfig() (*gorm.DB, error) {
 //
 // 步骤说明：
 // 1. 先创建帖子、模板、条目、点赞、评论、导入记录表；
-// 2. 唯一约束交给 GORM tag 生成，保证点赞和导入幂等有数据库兜底；
-// 3. 失败时直接返回错误，避免服务在 schema 不完整时继续启动。
+// 2. 再按 service catalog 创建 taskclass-forum outbox 表，为后续论坛自身异步事件预留稳定目录；
+// 3. 迁移期论坛奖励事件直接写 token-store outbox 表，发布端也兜底创建目标表，避免独立启动顺序导致奖励漏表；
+// 4. 唯一约束交给 GORM tag 生成，保证点赞和导入幂等有数据库兜底；
+// 5. 失败时直接返回错误，避免服务在 schema 不完整时继续启动。
 func AutoMigrate(db *gorm.DB) error {
 	if db == nil {
 		return fmt.Errorf("taskclassforum auto migrate failed: db is nil")
@@ -57,5 +60,11 @@ func AutoMigrate(db *gorm.DB) error {
 	); err != nil {
 		return fmt.Errorf("auto migrate taskclassforum tables failed: %w", err)
 	}
+	if err := outboxinfra.AutoMigrateServiceTable(db, outboxinfra.ServiceTaskClassForum); err != nil {
+		return err
+	}
+	if err := outboxinfra.AutoMigrateServiceTable(db, outboxinfra.ServiceTokenStore); err != nil {
+		return err
+	}
 	return nil
 }

backend/services/taskclassforum/dao/forum.go

@@ -29,6 +29,19 @@ func (dao *ForumDAO) WithTx(tx *gorm.DB) *ForumDAO {
 	return &ForumDAO{db: tx}
 }
 
+// GormDB 返回当前 DAO 绑定的 GORM 句柄。
+//
+// 职责边界：
+// 1. 只提供给需要和 forum 业务事务同提交的基础设施使用，例如 outbox 入队；
+// 2. 不鼓励业务层绕过 DAO 任意读写 forum_* 表；
+// 3. 若当前 DAO 来自 WithTx，返回值就是同一个事务句柄。
+func (dao *ForumDAO) GormDB() *gorm.DB {
+	if dao == nil {
+		return nil
+	}
+	return dao.db
+}
+
 // Transaction 在一个数据库事务内执行计划广场写操作。
 func (dao *ForumDAO) Transaction(ctx context.Context, fn func(txDAO *ForumDAO) error) error {
 	return dao.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {