flutter: transactions Phase A — search/filter bar + grouping scaffold

jive-flutter/.dart_tool/package_config.json

@@ -261,7 +261,7 @@
     },
     {
       "name": "flutter",
-      "rootUri": "file:///opt/homebrew/share/flutter/packages/flutter",
+      "rootUri": "file:///Users/huazhou/flutter-sdk/packages/flutter",
       "packageUri": "lib/",
       "languageVersion": "3.8"
     },
@@ -285,7 +285,7 @@
     },
     {
       "name": "flutter_localizations",
-      "rootUri": "file:///opt/homebrew/share/flutter/packages/flutter_localizations",
+      "rootUri": "file:///Users/huazhou/flutter-sdk/packages/flutter_localizations",
       "packageUri": "lib/",
       "languageVersion": "3.8"
     },
@@ -309,13 +309,13 @@
     },
     {
       "name": "flutter_test",
-      "rootUri": "file:///opt/homebrew/share/flutter/packages/flutter_test",
+      "rootUri": "file:///Users/huazhou/flutter-sdk/packages/flutter_test",
       "packageUri": "lib/",
       "languageVersion": "3.8"
     },
     {
       "name": "flutter_web_plugins",
-      "rootUri": "file:///opt/homebrew/share/flutter/packages/flutter_web_plugins",
+      "rootUri": "file:///Users/huazhou/flutter-sdk/packages/flutter_web_plugins",
       "packageUri": "lib/",
       "languageVersion": "3.8"
     },
@@ -789,7 +789,7 @@
     },
     {
       "name": "sky_engine",
-      "rootUri": "file:///opt/homebrew/share/flutter/bin/cache/pkg/sky_engine",
+      "rootUri": "file:///Users/huazhou/flutter-sdk/bin/cache/pkg/sky_engine",
       "packageUri": "lib/",
       "languageVersion": "3.8"
     },
@@ -1054,7 +1054,7 @@
   ],
   "generator": "pub",
   "generatorVersion": "3.9.2",
-  "flutterRoot": "file:///opt/homebrew/share/flutter",
+  "flutterRoot": "file:///Users/huazhou/flutter-sdk",
   "flutterVersion": "3.35.3",
   "pubCache": "file:///Users/huazhou/.pub-cache"
 }

jive-flutter/lib/ui/components/transactions/transaction_list.dart

@@ -11,6 +11,10 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 typedef TransactionData = Transaction;
 
 class TransactionList extends ConsumerWidget {
+  // Phase A: lightweight search/group controls
+  final ValueChanged<String>? onSearch;
+  final VoidCallback? onClearSearch;
+  final VoidCallback? onToggleGroup;
   final List<TransactionData> transactions;
   final bool groupByDate;
   final bool showSearchBar;
@@ -36,6 +40,9 @@ class TransactionList extends ConsumerWidget {
     this.onTransactionLongPress,
     this.scrollController,
     this.isLoading = false,
+    this.onSearch,
+    this.onClearSearch,
+    this.onToggleGroup,
     this.formatAmount,
     this.transactionItemBuilder,
   });
@@ -50,9 +57,14 @@ class TransactionList extends ConsumerWidget {
       return _buildEmptyState(context);
     }
 
-    final content = groupByDate
-        ? _buildGroupedList(context, ref)
-        : _buildSimpleList(context, ref);
+    final listContent = groupByDate ? _buildGroupedList(context, ref) : _buildSimpleList(context, ref);
+
+    final content = Column(
+      children: [
+        if (showSearchBar) _buildSearchBar(context),
+        Expanded(child: listContent),
+      ],
+    );
 
     if (onRefresh != null) {
       return RefreshIndicator(
@@ -64,6 +76,55 @@ class TransactionList extends ConsumerWidget {
     return content;
   }
 
+
+
+  Widget _buildSearchBar(BuildContext context) {
+    final theme = Theme.of(context);
+    return Container(
+      padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
+      color: theme.colorScheme.surfaceContainerHighest.withValues(alpha: 0.3),
+      child: Row(
+        children: [
+          Expanded(
+            child: TextField(
+              decoration: InputDecoration(
+                hintText: '搜索 描述/备注/收款方…',
+                prefixIcon: const Icon(Icons.search),
+                suffixIcon: onClearSearch != null
+                    ? IconButton(icon: const Icon(Icons.clear), onPressed: onClearSearch)
+                    : null,
+                border: OutlineInputBorder(
+                  borderRadius: BorderRadius.circular(12),
+                  borderSide: BorderSide.none,
+                ),
+                filled: true,
+                fillColor: theme.colorScheme.surface,
+                isDense: true,
+              ),
+              textInputAction: TextInputAction.search,
+              onSubmitted: onSearch,
+            ),
+          ),
+          const SizedBox(width: 8),
+          IconButton(
+            tooltip: groupByDate ? '切换为平铺' : '按日期分组',
+            onPressed: onToggleGroup,
+            icon: Icon(groupByDate ? Icons.view_agenda_outlined : Icons.calendar_today_outlined),
+          ),
+          IconButton(
+            tooltip: '筛选',
+            onPressed: () {
+              ScaffoldMessenger.of(context).showSnackBar(
+                const SnackBar(content: Text('筛选功能开发中')),
+              );
+            },
+            icon: const Icon(Icons.filter_list),
+          ),
+        ],
+      ),
+    );
+  }
+
   Widget _buildEmptyState(BuildContext context) {
     final theme = Theme.of(context);
 

jive-flutter/test/transactions/transaction_controller_grouping_test.dart

@@ -2,6 +2,7 @@
 import 'dart:async';
 
 import 'package:flutter_test/flutter_test.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:jive_money/providers/transaction_provider.dart';
 import 'package:jive_money/services/api/transaction_service.dart';
 import 'package:shared_preferences/shared_preferences.dart';
@@ -11,7 +12,7 @@ class _DummyTransactionService extends TransactionService {}
 
 /// Test controller that skips network loading on init.
 class _TestTransactionController extends TransactionController {
-  _TestTransactionController() : super(_DummyTransactionService());
+  _TestTransactionController(Ref ref) : super(ref, _DummyTransactionService());
 
   @override
   Future<void> loadTransactions() async {
@@ -28,6 +29,12 @@ class _TestTransactionController extends TransactionController {
   }
 }
 
+// Test provider for creating controllers in tests
+final testControllerProvider =
+    StateNotifierProvider<_TestTransactionController, TransactionState>((ref) {
+  return _TestTransactionController(ref);
+});
+
 void main() {
   TestWidgetsFlutterBinding.ensureInitialized();
 
@@ -38,7 +45,9 @@ void main() {
     });
 
     test('setGrouping persists to SharedPreferences', () async {
-      final controller = _TestTransactionController();
+      final container = ProviderContainer();
+      addTearDown(container.dispose);
+      final controller = container.read(testControllerProvider.notifier);
 
       // Default should be date
       expect(controller.state.grouping, TransactionGrouping.date);
@@ -54,7 +63,9 @@ void main() {
     });
 
     test('toggleGroupCollapse persists collapsed keys', () async {
-      final controller = _TestTransactionController();
+      final container = ProviderContainer();
+      addTearDown(container.dispose);
+      final controller = container.read(testControllerProvider.notifier);
       const key = 'category:未分类';
 
       // Toggle on (collapse)