@stackonward/cli 0.0.1 → 1.0.0

package/dist/resources/templates/go-backend/internal/core/commandreplay/persistence_test.go

@@ -0,0 +1,185 @@
+package commandreplay
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"net/http"
+	"strings"
+	"testing"
+	"time"
+
+	"github.com/stretchr/testify/require"
+	"gorm.io/driver/sqlite"
+	"gorm.io/gorm"
+
+	"{{module}}/internal/core/database"
+)
+
+func TestCommandReplayRepositoryCreateAndFindByScope(t *testing.T) {
+	db := newCommandReplayTestDB(t)
+	repo := NewCommandReplayRepository(db)
+	ctx := context.Background()
+
+	record := newPersistenceTestCommandReplayRecord("test.command.checkout", "quote:create", "idem-1", time.Now().Add(time.Hour))
+	require.NoError(t, repo.Create(ctx, record))
+
+	found, err := repo.FindByScope(ctx, " test.command.checkout ", " quote:create ", " idem-1 ")
+	require.NoError(t, err)
+	require.NotNil(t, found)
+	require.Equal(t, "test.command.checkout", found.Namespace)
+	require.Equal(t, "quote:create", found.CommandScope)
+	require.Equal(t, "idem-1", found.IdempotencyKey)
+
+	missing, err := repo.FindByScope(ctx, "test.command.checkout", "quote:create", "idem-missing")
+	require.NoError(t, err)
+	require.Nil(t, missing)
+}
+
+func TestCommandReplayRepositoryDuplicateCreateReturnsSentinel(t *testing.T) {
+	db := newCommandReplayTestDB(t)
+	repo := NewCommandReplayRepository(db)
+	ctx := context.Background()
+	expiresAt := time.Now().Add(time.Hour)
+
+	require.NoError(t, repo.Create(ctx, newPersistenceTestCommandReplayRecord("test.command.checkout", "quote:create", "idem-1", expiresAt)))
+	err := repo.Create(ctx, newPersistenceTestCommandReplayRecord("test.command.checkout", "quote:create", "idem-1", expiresAt))
+	require.Error(t, err)
+	require.True(t, errors.Is(err, ErrCommandReplayRecordExists))
+
+	require.NoError(t, repo.Create(ctx, newPersistenceTestCommandReplayRecord("test.command.checkout", "quote:create", "idem-2", expiresAt)))
+	require.NoError(t, repo.Create(ctx, newPersistenceTestCommandReplayRecord("test.command.checkout", "quote:update", "idem-1", expiresAt)))
+	require.NoError(t, repo.Create(ctx, newPersistenceTestCommandReplayRecord("test.command.fulfillment", "quote:create", "idem-1", expiresAt)))
+	require.NoError(t, repo.Create(ctx, newPersistenceTestCommandReplayRecord("other.command.checkout", "quote:create", "idem-1", expiresAt)))
+	var total int64
+	require.NoError(t, db.Model(&CommandReplayRecord{}).Count(&total).Error)
+	require.Equal(t, int64(5), total)
+}
+
+func TestCommandReplayRepositoryTryAcquireScopeLockRejectsSQLite(t *testing.T) {
+	db := newCommandReplayTestDB(t)
+	repo := NewCommandReplayRepository(db)
+
+	acquired, err := repo.TryAcquireScopeLock(context.Background(), "test.command.checkout", "quote:create", "idem-1")
+	require.Error(t, err)
+	require.False(t, acquired)
+}
+
+func TestCommandReplayRepositoryMarkTerminalStates(t *testing.T) {
+	db := newCommandReplayTestDB(t)
+	repo := NewCommandReplayRepository(db)
+	ctx := context.Background()
+	expiresAt := time.Now().Add(time.Hour)
+
+	succeededRecord := newPersistenceTestCommandReplayRecord("test.command.checkout", "quote:create", "idem-success", expiresAt)
+	require.NoError(t, repo.Create(ctx, succeededRecord))
+	succeededAt := time.Now().Add(time.Minute)
+	require.NoError(t, repo.MarkSucceeded(ctx, succeededRecord.ID, json.RawMessage(`{"quote_no":"quote_1"}`), succeededAt))
+
+	loaded, err := repo.FindByScope(ctx, "test.command.checkout", "quote:create", "idem-success")
+	require.NoError(t, err)
+	require.NotNil(t, loaded)
+	require.Equal(t, CommandReplayStatusSucceeded, loaded.Status)
+	require.JSONEq(t, `{"quote_no":"quote_1"}`, string(loaded.ResponsePayload))
+	require.Nil(t, loaded.ErrorCode)
+	require.NotNil(t, loaded.CompletedAt)
+
+	err = repo.MarkFailed(ctx, succeededRecord.ID, "COMMERCE_QUOTE_FAILED", http.StatusConflict, json.RawMessage(`{"error":"failed"}`), time.Now().Add(2*time.Minute))
+	require.Error(t, err)
+
+	failedRecord := newPersistenceTestCommandReplayRecord("test.command.checkout", "quote:create", "idem-failed", expiresAt)
+	require.NoError(t, repo.Create(ctx, failedRecord))
+	failedAt := time.Now().Add(3 * time.Minute)
+	require.NoError(t, repo.MarkFailed(ctx, failedRecord.ID, " COMMERCE_QUOTE_FAILED ", http.StatusConflict, json.RawMessage(`{"error":"failed"}`), failedAt))
+
+	loaded, err = repo.FindByScope(ctx, "test.command.checkout", "quote:create", "idem-failed")
+	require.NoError(t, err)
+	require.NotNil(t, loaded)
+	require.Equal(t, CommandReplayStatusFailed, loaded.Status)
+	require.NotNil(t, loaded.ErrorCode)
+	require.Equal(t, "COMMERCE_QUOTE_FAILED", *loaded.ErrorCode)
+	require.NotNil(t, loaded.ErrorStatus)
+	require.Equal(t, http.StatusConflict, *loaded.ErrorStatus)
+	require.JSONEq(t, `{"error":"failed"}`, string(loaded.ResponsePayload))
+	require.NotNil(t, loaded.CompletedAt)
+
+	err = repo.MarkSucceeded(ctx, failedRecord.ID, json.RawMessage(`{"quote_no":"quote_2"}`), time.Now().Add(4*time.Minute))
+	require.Error(t, err)
+}
+
+func TestCommandReplayRepositoryJoinsAmbientTransaction(t *testing.T) {
+	db := newCommandReplayTestDB(t)
+	repo := NewCommandReplayRepository(db)
+	manager := database.NewTransactionManager(db)
+	ctx := context.Background()
+	rollbackErr := errors.New("rollback command idempotency transaction")
+
+	err := manager.WithTransaction(ctx, func(txCtx context.Context) error {
+		record := newPersistenceTestCommandReplayRecord("test.command.checkout", "quote:create", "idem-rollback", time.Now().Add(time.Hour))
+		require.NoError(t, repo.Create(txCtx, record))
+		return rollbackErr
+	})
+	require.ErrorIs(t, err, rollbackErr)
+
+	found, err := repo.FindByScope(ctx, "test.command.checkout", "quote:create", "idem-rollback")
+	require.NoError(t, err)
+	require.Nil(t, found)
+}
+
+func newCommandReplayTestDB(t *testing.T) *gorm.DB {
+	t.Helper()
+	name := strings.NewReplacer("/", "_", " ", "_").Replace(t.Name())
+	db, err := gorm.Open(sqlite.Open(fmt.Sprintf("file:%s?mode=memory&cache=shared&_loc=auto", name)), &gorm.Config{})
+	require.NoError(t, err)
+	createCommandReplayRecordSchema(t, db)
+	return db
+}
+
+func createCommandReplayRecordSchema(t *testing.T, db *gorm.DB) {
+	t.Helper()
+	require.NoError(t, db.Exec(`
+		CREATE TABLE sys_command_replay_records (
+			id INTEGER PRIMARY KEY AUTOINCREMENT,
+			created_at DATETIME NOT NULL,
+			updated_at DATETIME NOT NULL,
+			namespace TEXT NOT NULL,
+			command_scope TEXT NOT NULL,
+			idempotency_key TEXT NOT NULL,
+			request_hash TEXT NOT NULL,
+			principal_type TEXT,
+			principal_ref TEXT,
+			status TEXT NOT NULL DEFAULT 'started',
+			response_payload TEXT NOT NULL DEFAULT '{}',
+			error_code TEXT,
+			error_status INTEGER,
+			expires_at DATETIME NOT NULL,
+			completed_at DATETIME,
+			external_reference_type TEXT,
+			external_reference_no TEXT,
+			execution_token_hash TEXT,
+			lease_expires_at DATETIME,
+			external_next_recovery_at DATETIME,
+			external_attempt_count INTEGER NOT NULL DEFAULT 0,
+			external_last_error_code TEXT,
+			metadata TEXT NOT NULL DEFAULT '{}'
+		)
+	`).Error)
+	require.NoError(t, db.Exec(`
+		CREATE UNIQUE INDEX uk_sys_command_replay_records_namespace_scope_key
+		ON sys_command_replay_records (namespace, command_scope, idempotency_key)
+	`).Error)
+}
+
+func newPersistenceTestCommandReplayRecord(namespace, commandScope, idempotencyKey string, expiresAt time.Time) *CommandReplayRecord {
+	return &CommandReplayRecord{
+		Namespace:       namespace,
+		CommandScope:    commandScope,
+		IdempotencyKey:  idempotencyKey,
+		RequestHash:     strings.Repeat("a", 64),
+		Status:          CommandReplayStatusStarted,
+		ResponsePayload: json.RawMessage(`{}`),
+		ExpiresAt:       expiresAt,
+		Metadata:        json.RawMessage(`{}`),
+	}
+}

package/dist/resources/templates/go-backend/internal/core/commandreplay/provider.go

@@ -0,0 +1,9 @@
+package commandreplay
+
+import "github.com/google/wire"
+
+// ProviderSet 提供跨领域命令回放的持久化与应用服务。
+var ProviderSet = wire.NewSet(
+	NewCommandReplayRepository,
+	NewCommandReplayService,
+)

package/dist/resources/templates/go-backend/internal/core/commandreplay/repository.go

@@ -0,0 +1,22 @@
+package commandreplay
+
+import (
+	"context"
+	"encoding/json"
+	"time"
+)
+
+// CommandReplayRepository 命令幂等回放仓储接口。
+type CommandReplayRepository interface {
+	FindByScope(ctx context.Context, namespace, commandScope, idempotencyKey string) (*CommandReplayRecord, error)
+	TryAcquireScopeLock(ctx context.Context, namespace, commandScope, idempotencyKey string) (bool, error)
+	Create(ctx context.Context, record *CommandReplayRecord) error
+	MarkSucceeded(ctx context.Context, id int64, responsePayload json.RawMessage, completedAt time.Time) error
+	MarkFailed(ctx context.Context, id int64, errorCode string, errorStatus int, responsePayload json.RawMessage, completedAt time.Time) error
+	FindByIDForUpdate(ctx context.Context, id int64) (*CommandReplayRecord, error)
+	StartExternalExecution(ctx context.Context, id int64, referenceType, referenceNo, tokenHash string, preparedResponsePayload json.RawMessage, leaseExpiresAt time.Time) error
+	ClaimExternalRecovery(ctx context.Context, id int64, expectedRecoveryAt time.Time, tokenHash string, leaseExpiresAt time.Time) error
+	DeferExternalExecution(ctx context.Context, id int64, tokenHash, errorCode string, nextRecoveryAt time.Time) error
+	ClearExternalExecution(ctx context.Context, id int64, tokenHash string) error
+	ListDueExternalRecoveries(ctx context.Context, referenceType string, at time.Time, limit int) ([]CommandReplayRecord, error)
+}