feat: implement offline sync endpoints with Last-Write-Wins strategy

Add comprehensive offline synchronization support for habits and entries: ## Infrastructure (Phase 1) - Add UpdatedAt and DeletedAt timestamps to Habit and HabitEntry entities - Implement soft delete with Delete(), Touch(), and IsDeleted() methods - Create SQL migration with optimized composite indexes for sync queries - Add GetChangesSince() and SoftDelete() to both repositories - Update all Find* methods to exclude soft-deleted records - 13 comprehensive TDD tests for sync repository methods ## HTTP Endpoints (Phase 2) - GET /api/v1/sync/changes: retrieve all changes since timestamp - POST /api/v1/sync/batch: apply client changes with conflict resolution - Implement Last-Write-Wins strategy using UpdatedAt timestamps - Add authentication and rate limiting (100 req/min) - Validate user ownership for all sync operations - 9 tests for sync handlers (3 queries + 6 commands) ## Technical Details - Composite indexes: (user_id, updated_at) for optimal query performance - No pagination: atomic sync operations for data consistency - Upsert behavior: create resources if not found on server - DTOs with full entity state including timestamps - Swagger documentation updated for new endpoints All 220+ tests passing ✓
2025-12-12 00:11:46 +01:00
parent 1aedc2b69a
commit aa8f7af55d
25 changed files with 4554 additions and 87 deletions
@@ -0,0 +1,76 @@
+package queries
+
+import (
+	"context"
+	"time"
+
+	"apocapoc-api/internal/domain/entities"
+	"apocapoc-api/internal/domain/repositories"
+	"apocapoc-api/internal/shared/errors"
+)
+
+type HabitChangesDTO struct {
+	Created []*entities.Habit
+	Updated []*entities.Habit
+	Deleted []string
+}
+
+type EntryChangesDTO struct {
+	Created []*entities.HabitEntry
+	Updated []*entities.HabitEntry
+	Deleted []string
+}
+
+type SyncChangesDTO struct {
+	Habits  HabitChangesDTO
+	Entries EntryChangesDTO
+}
+
+type GetSyncChangesQuery struct {
+	UserID string
+	Since  time.Time
+}
+
+type GetSyncChangesHandler struct {
+	habitRepo repositories.HabitRepository
+	entryRepo repositories.HabitEntryRepository
+}
+
+func NewGetSyncChangesHandler(
+	habitRepo repositories.HabitRepository,
+	entryRepo repositories.HabitEntryRepository,
+) *GetSyncChangesHandler {
+	return &GetSyncChangesHandler{
+		habitRepo: habitRepo,
+		entryRepo: entryRepo,
+	}
+}
+
+func (h *GetSyncChangesHandler) Handle(ctx context.Context, query GetSyncChangesQuery) (*SyncChangesDTO, error) {
+	if query.UserID == "" {
+		return nil, errors.ErrInvalidInput
+	}
+
+	habitChanges, err := h.habitRepo.GetChangesSince(ctx, query.UserID, query.Since)
+	if err != nil {
+		return nil, err
+	}
+
+	entryChanges, err := h.entryRepo.GetChangesSince(ctx, query.UserID, query.Since)
+	if err != nil {
+		return nil, err
+	}
+
+	return &SyncChangesDTO{
+		Habits: HabitChangesDTO{
+			Created: habitChanges.Created,
+			Updated: habitChanges.Updated,
+			Deleted: habitChanges.Deleted,
+		},
+		Entries: EntryChangesDTO{
+			Created: entryChanges.Created,
+			Updated: entryChanges.Updated,
+			Deleted: entryChanges.Deleted,
+		},
+	}, nil
+}
@@ -0,0 +1,255 @@
+package queries
+
+import (
+	"context"
+	"testing"
+	"time"
+
+	"apocapoc-api/internal/domain/entities"
+	"apocapoc-api/internal/domain/repositories"
+	"apocapoc-api/internal/domain/value_objects"
+	"apocapoc-api/internal/shared/pagination"
+)
+
+type mockHabitRepoForSync struct {
+	changes *repositories.HabitChanges
+	err     error
+}
+
+func (m *mockHabitRepoForSync) GetChangesSince(ctx context.Context, userID string, since time.Time) (*repositories.HabitChanges, error) {
+	return m.changes, m.err
+}
+
+func (m *mockHabitRepoForSync) Create(ctx context.Context, habit *entities.Habit) error {
+	return nil
+}
+
+func (m *mockHabitRepoForSync) FindByID(ctx context.Context, id string) (*entities.Habit, error) {
+	return nil, nil
+}
+
+func (m *mockHabitRepoForSync) FindByUserID(ctx context.Context, userID string) ([]*entities.Habit, error) {
+	return nil, nil
+}
+
+func (m *mockHabitRepoForSync) FindActiveByUserID(ctx context.Context, userID string) ([]*entities.Habit, error) {
+	return nil, nil
+}
+
+func (m *mockHabitRepoForSync) Update(ctx context.Context, habit *entities.Habit) error {
+	return nil
+}
+
+func (m *mockHabitRepoForSync) Delete(ctx context.Context, id string) error {
+	return nil
+}
+
+func (m *mockHabitRepoForSync) FindActiveByUserIDWithPagination(ctx context.Context, userID string, params pagination.Params) ([]*entities.Habit, error) {
+	return nil, nil
+}
+
+func (m *mockHabitRepoForSync) FindByUserIDFiltered(ctx context.Context, userID string, filter repositories.HabitFilter, paginationParams *pagination.Params) ([]*entities.Habit, error) {
+	return nil, nil
+}
+
+func (m *mockHabitRepoForSync) CountActiveByUserID(ctx context.Context, userID string) (int, error) {
+	return 0, nil
+}
+
+func (m *mockHabitRepoForSync) CountByUserIDFiltered(ctx context.Context, userID string, filter repositories.HabitFilter) (int, error) {
+	return 0, nil
+}
+
+func (m *mockHabitRepoForSync) SoftDelete(ctx context.Context, id string) error {
+	return nil
+}
+
+type mockEntryRepoForSync struct {
+	changes *repositories.HabitEntryChanges
+	err     error
+}
+
+func (m *mockEntryRepoForSync) GetChangesSince(ctx context.Context, userID string, since time.Time) (*repositories.HabitEntryChanges, error) {
+	return m.changes, m.err
+}
+
+func (m *mockEntryRepoForSync) Create(ctx context.Context, entry *entities.HabitEntry) error {
+	return nil
+}
+
+func (m *mockEntryRepoForSync) FindByID(ctx context.Context, id string) (*entities.HabitEntry, error) {
+	return nil, nil
+}
+
+func (m *mockEntryRepoForSync) FindByHabitID(ctx context.Context, habitID string) ([]*entities.HabitEntry, error) {
+	return nil, nil
+}
+
+func (m *mockEntryRepoForSync) FindByHabitIDAndDateRange(ctx context.Context, habitID string, from, to time.Time) ([]*entities.HabitEntry, error) {
+	return nil, nil
+}
+
+func (m *mockEntryRepoForSync) FindByUserID(ctx context.Context, userID string) ([]*entities.HabitEntry, error) {
+	return nil, nil
+}
+
+func (m *mockEntryRepoForSync) FindPendingByHabitID(ctx context.Context, habitID string, beforeDate time.Time) ([]*entities.HabitEntry, error) {
+	return nil, nil
+}
+
+func (m *mockEntryRepoForSync) Update(ctx context.Context, entry *entities.HabitEntry) error {
+	return nil
+}
+
+func (m *mockEntryRepoForSync) Delete(ctx context.Context, id string) error {
+	return nil
+}
+
+func (m *mockEntryRepoForSync) SoftDelete(ctx context.Context, id string) error {
+	return nil
+}
+
+func TestGetSyncChangesHandler_Success(t *testing.T) {
+	now := time.Now()
+	since := now.Add(-1 * time.Hour)
+
+	createdHabit := entities.NewHabit("user-123", "New Habit", value_objects.HabitTypeBoolean, value_objects.FrequencyDaily, false, false)
+	createdHabit.ID = "habit-1"
+	createdHabit.CreatedAt = now
+	createdHabit.UpdatedAt = now
+
+	updatedHabit := entities.NewHabit("user-123", "Updated Habit", value_objects.HabitTypeCounter, value_objects.FrequencyWeekly, false, false)
+	updatedHabit.ID = "habit-2"
+	updatedHabit.CreatedAt = since.Add(-1 * time.Hour)
+	updatedHabit.UpdatedAt = now
+
+	habitRepo := &mockHabitRepoForSync{
+		changes: &repositories.HabitChanges{
+			Created: []*entities.Habit{createdHabit},
+			Updated: []*entities.Habit{updatedHabit},
+			Deleted: []string{"habit-3"},
+		},
+	}
+
+	createdEntry := entities.NewHabitEntry("habit-1", now, nil)
+	createdEntry.ID = "entry-1"
+
+	updatedEntry := entities.NewHabitEntry("habit-2", now, nil)
+	updatedEntry.ID = "entry-2"
+	updatedEntry.UpdatedAt = now
+
+	entryRepo := &mockEntryRepoForSync{
+		changes: &repositories.HabitEntryChanges{
+			Created: []*entities.HabitEntry{createdEntry},
+			Updated: []*entities.HabitEntry{updatedEntry},
+			Deleted: []string{"entry-3"},
+		},
+	}
+
+	handler := NewGetSyncChangesHandler(habitRepo, entryRepo)
+
+	query := GetSyncChangesQuery{
+		UserID: "user-123",
+		Since:  since,
+	}
+
+	result, err := handler.Handle(context.Background(), query)
+
+	if err != nil {
+		t.Fatalf("Expected no error, got %v", err)
+	}
+
+	if len(result.Habits.Created) != 1 {
+		t.Errorf("Expected 1 created habit, got %d", len(result.Habits.Created))
+	}
+
+	if len(result.Habits.Updated) != 1 {
+		t.Errorf("Expected 1 updated habit, got %d", len(result.Habits.Updated))
+	}
+
+	if len(result.Habits.Deleted) != 1 {
+		t.Errorf("Expected 1 deleted habit, got %d", len(result.Habits.Deleted))
+	}
+
+	if len(result.Entries.Created) != 1 {
+		t.Errorf("Expected 1 created entry, got %d", len(result.Entries.Created))
+	}
+
+	if len(result.Entries.Updated) != 1 {
+		t.Errorf("Expected 1 updated entry, got %d", len(result.Entries.Updated))
+	}
+
+	if len(result.Entries.Deleted) != 1 {
+		t.Errorf("Expected 1 deleted entry, got %d", len(result.Entries.Deleted))
+	}
+}
+
+func TestGetSyncChangesHandler_EmptyChanges(t *testing.T) {
+	habitRepo := &mockHabitRepoForSync{
+		changes: &repositories.HabitChanges{
+			Created: []*entities.Habit{},
+			Updated: []*entities.Habit{},
+			Deleted: []string{},
+		},
+	}
+
+	entryRepo := &mockEntryRepoForSync{
+		changes: &repositories.HabitEntryChanges{
+			Created: []*entities.HabitEntry{},
+			Updated: []*entities.HabitEntry{},
+			Deleted: []string{},
+		},
+	}
+
+	handler := NewGetSyncChangesHandler(habitRepo, entryRepo)
+
+	query := GetSyncChangesQuery{
+		UserID: "user-123",
+		Since:  time.Now().Add(-1 * time.Hour),
+	}
+
+	result, err := handler.Handle(context.Background(), query)
+
+	if err != nil {
+		t.Fatalf("Expected no error, got %v", err)
+	}
+
+	if len(result.Habits.Created) != 0 {
+		t.Errorf("Expected 0 created habits, got %d", len(result.Habits.Created))
+	}
+
+	if len(result.Entries.Created) != 0 {
+		t.Errorf("Expected 0 created entries, got %d", len(result.Entries.Created))
+	}
+}
+
+func TestGetSyncChangesHandler_InvalidUserID(t *testing.T) {
+	habitRepo := &mockHabitRepoForSync{
+		changes: &repositories.HabitChanges{
+			Created: []*entities.Habit{},
+			Updated: []*entities.Habit{},
+			Deleted: []string{},
+		},
+	}
+
+	entryRepo := &mockEntryRepoForSync{
+		changes: &repositories.HabitEntryChanges{
+			Created: []*entities.HabitEntry{},
+			Updated: []*entities.HabitEntry{},
+			Deleted: []string{},
+		},
+	}
+
+	handler := NewGetSyncChangesHandler(habitRepo, entryRepo)
+
+	query := GetSyncChangesQuery{
+		UserID: "",
+		Since:  time.Now(),
+	}
+
+	_, err := handler.Handle(context.Background(), query)
+
+	if err == nil {
+		t.Error("Expected error for empty UserID, got nil")
+	}
+}
@@ -89,6 +89,18 @@ func (m *mockEntryRepo) Delete(ctx context.Context, id string) error {
 	return nil
 }

+func (m *mockEntryRepo) GetChangesSince(ctx context.Context, userID string, since time.Time) (*repositories.HabitEntryChanges, error) {
+	return &repositories.HabitEntryChanges{
+		Created: []*entities.HabitEntry{},
+		Updated: []*entities.HabitEntry{},
+		Deleted: []string{},
+	}, nil
+}
+
+func (m *mockEntryRepo) SoftDelete(ctx context.Context, id string) error {
+	return nil
+}
+
 func TestGetTodaysHabitsHandler_DailyHabitNoEntries(t *testing.T) {
 	habit := entities.NewHabit("user-123", "Exercise", value_objects.HabitTypeBoolean, value_objects.FrequencyDaily, false, false)
 	habit.ID = "habit-1"
@@ -337,3 +349,15 @@ func (m *mockHabitRepo) FindByUserIDFiltered(ctx context.Context, userID string,
 func (m *mockHabitRepo) CountByUserIDFiltered(ctx context.Context, userID string, filter repositories.HabitFilter) (int, error) {
 	return 0, nil
 }
+
+func (m *mockHabitRepo) GetChangesSince(ctx context.Context, userID string, since time.Time) (*repositories.HabitChanges, error) {
+	return &repositories.HabitChanges{
+		Created: []*entities.Habit{},
+		Updated: []*entities.Habit{},
+		Deleted: []string{},
+	}, nil
+}
+
+func (m *mockHabitRepo) SoftDelete(ctx context.Context, id string) error {
+	return nil
+}
@@ -4,6 +4,7 @@ import (
 	"apocapoc-api/internal/domain/repositories"
 	"context"
 	"testing"
+	"time"

 	"apocapoc-api/internal/domain/entities"
 	"apocapoc-api/internal/domain/value_objects"
@@ -333,6 +334,18 @@ func (m *mockGetUserHabitsRepo) CountByUserIDFiltered(ctx context.Context, userI
 	return count, nil
 }

+func (m *mockGetUserHabitsRepo) GetChangesSince(ctx context.Context, userID string, since time.Time) (*repositories.HabitChanges, error) {
+	return &repositories.HabitChanges{
+		Created: []*entities.Habit{},
+		Updated: []*entities.Habit{},
+		Deleted: []string{},
+	}, nil
+}
+
+func (m *mockGetUserHabitsRepo) SoftDelete(ctx context.Context, id string) error {
+	return nil
+}
+
 func TestGetUserHabitsHandler_WithFilters(t *testing.T) {
 	habit1 := entities.NewHabit("user-123", "Exercise", value_objects.HabitTypeBoolean, value_objects.FrequencyDaily, false, false)
 	habit1.ID = "habit-1"