feat: Week 4 收尾 + 架构治理 — 搜索/家长中心/Feature Flag/Docker/环境配置

架构治理:
- Feature Flag 落地: Cargo.toml [features] default=["diary"] + main.rs cfg 条件编译
- 环境配置统一: AppConfig 类 + --dart-define 注入 + SSE 端口 8080→3000 修复

搜索替代方案 (无 FTS):
- SearchBloc + 标签/心情筛选接入后端 API
- JournalRepository 扩展 mood/tag 筛选参数
- 搜索页 UI 接入实际数据（替换占位文本）

家长中心最小集 (PIPL 合规):
- 后端: parent_service (绑定/查看/导出/删除/解绑) + parent_handler (6 个 API 端点)
- 前端: ParentBloc + ParentPage 功能完整实现
- 绑定孩子、只读查看日记、导出数据、删除数据、解绑

Docker 部署:
- verify.sh 健康检查脚本 (Axum/PG/Redis/OpenAPI 四项检查)

测试修复:
- home_bloc_test / calendar_bloc_test 适配 JournalRepository 新参数

验证: flutter test 84/84 pass, cargo test 76/76 pass, cargo check pass

app/lib/features/search/bloc/search_bloc.dart

@@ -0,0 +1,79 @@
+// 搜索 BLoC — 标签+心情筛选日记
+//
+// 状态机: SearchInitial → SearchLoading → SearchLoaded/SearchError
+// Phase 1 使用简单的标签+心情筛选，后续可扩展全文搜索。
+
+import 'package:flutter_bloc/flutter_bloc.dart';
+
+import '../../../data/models/journal_entry.dart';
+import '../../../data/repositories/journal_repository.dart';
+
+part 'search_event.dart';
+part 'search_state.dart';
+
+/// 搜索 BLoC — 处理标签和心情筛选日记的状态转换
+class SearchBloc extends Bloc<SearchEvent, SearchState> {
+  final JournalRepository _journalRepo;
+
+  SearchBloc({required JournalRepository journalRepository})
+      : _journalRepo = journalRepository,
+        super(const SearchInitial()) {
+    on<SearchByMood>(_onSearchByMood);
+    on<SearchByTag>(_onSearchByTag);
+    on<SearchClear>(_onSearchClear);
+  }
+
+  /// 按心情筛选日记
+  Future<void> _onSearchByMood(
+    SearchByMood event,
+    Emitter<SearchState> emit,
+  ) async {
+    emit(const SearchLoading());
+    try {
+      if (event.mood == null) {
+        emit(const SearchLoaded());
+        return;
+      }
+      final results = await _journalRepo.getJournals(
+        mood: event.mood!.value,
+        page: 1,
+        pageSize: 50,
+      );
+      emit(SearchLoaded(
+        results: results,
+        activeMood: event.mood!.value,
+      ));
+    } catch (e) {
+      emit(const SearchError('搜索失败，请重试'));
+    }
+  }
+
+  /// 按标签筛选日记
+  Future<void> _onSearchByTag(
+    SearchByTag event,
+    Emitter<SearchState> emit,
+  ) async {
+    emit(const SearchLoading());
+    try {
+      final results = await _journalRepo.getJournals(
+        tag: event.tag,
+        page: 1,
+        pageSize: 50,
+      );
+      emit(SearchLoaded(
+        results: results,
+        activeTag: event.tag,
+      ));
+    } catch (e) {
+      emit(const SearchError('搜索失败，请重试'));
+    }
+  }
+
+  /// 清除搜索结果
+  void _onSearchClear(
+    SearchClear event,
+    Emitter<SearchState> emit,
+  ) {
+    emit(const SearchLoaded());
+  }
+}

app/lib/features/search/bloc/search_event.dart

@@ -0,0 +1,25 @@
+// 搜索事件 — SearchBloc 接收的用户操作
+
+part of 'search_bloc.dart';
+
+/// 搜索事件基类
+sealed class SearchEvent {
+  const SearchEvent();
+}
+
+/// 按心情筛选日记
+final class SearchByMood extends SearchEvent {
+  final Mood? mood;
+  const SearchByMood(this.mood);
+}
+
+/// 按标签筛选日记
+final class SearchByTag extends SearchEvent {
+  final String tag;
+  const SearchByTag(this.tag);
+}
+
+/// 清除搜索结果
+final class SearchClear extends SearchEvent {
+  const SearchClear();
+}

app/lib/features/search/bloc/search_state.dart

@@ -0,0 +1,56 @@
+// 搜索状态 — SearchBloc 输出的 UI 状态
+
+part of 'search_bloc.dart';
+
+/// 搜索状态基类
+sealed class SearchState {
+  const SearchState();
+}
+
+/// 初始状态 — 未执行任何搜索
+final class SearchInitial extends SearchState {
+  const SearchInitial();
+}
+
+/// 加载中 — 正在查询日记
+final class SearchLoading extends SearchState {
+  const SearchLoading();
+}
+
+/// 搜索结果已加载
+final class SearchLoaded extends SearchState {
+  /// 搜索结果列表（空列表表示无匹配）
+  final List<JournalEntry> results;
+
+  /// 当前活跃的心情筛选条件
+  final String? activeMood;
+
+  /// 当前活跃的标签筛选条件
+  final String? activeTag;
+
+  const SearchLoaded({
+    this.results = const [],
+    this.activeMood,
+    this.activeTag,
+  });
+
+  /// 是否有活跃的筛选条件
+  bool get hasActiveFilter => activeMood != null || activeTag != null;
+
+  SearchLoaded copyWith({
+    List<JournalEntry>? results,
+    String? activeMood,
+    String? activeTag,
+  }) =>
+      SearchLoaded(
+        results: results ?? this.results,
+        activeMood: activeMood ?? this.activeMood,
+        activeTag: activeTag ?? this.activeTag,
+      );
+}
+
+/// 搜索出错
+final class SearchError extends SearchState {
+  final String message;
+  const SearchError(this.message);
+}

app/lib/features/search/views/search_page.dart

@@ -1,10 +1,20 @@
-// 搜索页面 — 日记搜索 + 标签筛选
+// 搜索页面 — 标签+心情筛选日记
+//
+// 通过 SearchBloc 驱动搜索状态：
+// - 标签点击 → SearchByTag event
+// - 心情选择 → SearchByMood event
+// - 清除按钮 → SearchClear event
+// 搜索结果由 BlocBuilder<SearchBloc, SearchState> 响应式渲染。
 
 import 'package:flutter/material.dart';
-import 'package:nuanji_app/core/theme/app_colors.dart';
-import 'package:nuanji_app/data/models/journal_entry.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
+import 'package:intl/intl.dart';
 
-/// 搜索页面 — 全文搜索日记（Phase 1 占位 UI）
+import '../../../core/theme/app_colors.dart';
+import '../../../data/models/journal_entry.dart';
+import '../bloc/search_bloc.dart';
+
+/// 搜索页面 — 标签+心情筛选日记
 class SearchPage extends StatefulWidget {
   const SearchPage({super.key});
 
@@ -14,9 +24,8 @@ class SearchPage extends StatefulWidget {
 
 class _SearchPageState extends State<SearchPage> {
   final _searchController = TextEditingController();
-  bool _hasSearched = false;
 
-  // Phase 1 占位数据
+  // Phase 1 占位标签数据
   final _recentTags = ['日常', '学校', '旅行', '美食', '读书', '心情'];
   final _moodFilters = Mood.values;
 
@@ -31,48 +40,88 @@ class _SearchPageState extends State<SearchPage> {
     final theme = Theme.of(context);
     final colorScheme = theme.colorScheme;
 
-    return Scaffold(
-      appBar: AppBar(
-        title: TextField(
-          controller: _searchController,
-          decoration: InputDecoration(
-            hintText: '搜索日记...',
-            hintStyle: theme.textTheme.bodyLarge?.copyWith(
-              color: colorScheme.onSurface.withValues(alpha: 0.4),
+    return BlocBuilder<SearchBloc, SearchState>(
+      builder: (context, state) {
+        final hasFilter = state is SearchLoaded && state.hasActiveFilter;
+
+        return Scaffold(
+          appBar: AppBar(
+            title: TextField(
+              controller: _searchController,
+              decoration: InputDecoration(
+                hintText: '搜索日记...',
+                hintStyle: theme.textTheme.bodyLarge?.copyWith(
+                  color: colorScheme.onSurface.withValues(alpha: 0.4),
+                ),
+                border: InputBorder.none,
+                prefixIcon: const Icon(Icons.search),
+                suffixIcon: hasFilter
+                    ? IconButton(
+                        icon: const Icon(Icons.filter_alt_off),
+                        tooltip: '清除筛选',
+                        onPressed: _clearSearch,
+                      )
+                    : (_searchController.text.isNotEmpty
+                        ? IconButton(
+                            icon: const Icon(Icons.clear),
+                            onPressed: () {
+                              _searchController.clear();
+                              _clearSearch();
+                            },
+                          )
+                        : null),
+              ),
+              textInputAction: TextInputAction.search,
+              onSubmitted: (value) {
+                if (value.trim().isNotEmpty) {
+                  context.read<SearchBloc>().add(SearchByTag(value.trim()));
+                }
+              },
             ),
-            border: InputBorder.none,
-            prefixIcon: const Icon(Icons.search),
-            suffixIcon: _searchController.text.isNotEmpty
-                ? IconButton(
-                    icon: const Icon(Icons.clear),
-                    onPressed: () {
-                      _searchController.clear();
-                      setState(() => _hasSearched = false);
-                    },
-                  )
-                : null,
           ),
-          textInputAction: TextInputAction.search,
-          onSubmitted: (_) => _doSearch(),
-        ),
-      ),
-      body: _hasSearched
-          ? _buildSearchResults(context, colorScheme)
-          : _buildSuggestions(context, theme, colorScheme),
+          body: _buildBody(context, theme, colorScheme, state),
+        );
+      },
     );
   }
 
-  void _doSearch() {
-    setState(() => _hasSearched = true);
+  /// 根据搜索状态构建 body
+  Widget _buildBody(
+    BuildContext context,
+    ThemeData theme,
+    ColorScheme colorScheme,
+    SearchState state,
+  ) {
+    return switch (state) {
+      SearchInitial() => _buildSuggestions(context, theme, colorScheme),
+      SearchLoading() => const Center(child: CircularProgressIndicator()),
+      SearchLoaded(:final results, :final activeMood, :final activeTag) =>
+        _hasActiveFilter(activeMood, activeTag)
+            ? _buildResults(context, theme, colorScheme, results)
+            : _buildSuggestions(context, theme, colorScheme),
+      SearchError(:final message) => _buildError(colorScheme, message),
+    };
   }
 
-  Widget _buildSuggestions(BuildContext context, ThemeData theme, ColorScheme colorScheme) {
+  bool _hasActiveFilter(String? mood, String? tag) =>
+      mood != null || tag != null;
+
+  /// 建议区域 — 标签云 + 心情选择
+  Widget _buildSuggestions(
+    BuildContext context,
+    ThemeData theme,
+    ColorScheme colorScheme,
+  ) {
     return SingleChildScrollView(
       padding: const EdgeInsets.all(16),
       child: Column(
         crossAxisAlignment: CrossAxisAlignment.start,
         children: [
-          Text('常用标签', style: theme.textTheme.titleSmall?.copyWith(fontWeight: FontWeight.w600)),
+          Text(
+            '常用标签',
+            style:
+                theme.textTheme.titleSmall?.copyWith(fontWeight: FontWeight.w600),
+          ),
           const SizedBox(height: 8),
           Wrap(
             spacing: 8,
@@ -82,23 +131,28 @@ class _SearchPageState extends State<SearchPage> {
                 label: Text(tag),
                 onPressed: () {
                   _searchController.text = tag;
-                  _doSearch();
+                  context.read<SearchBloc>().add(SearchByTag(tag));
                 },
               );
             }).toList(),
           ),
           const SizedBox(height: 24),
-          Text('按心情筛选', style: theme.textTheme.titleSmall?.copyWith(fontWeight: FontWeight.w600)),
+          Text(
+            '按心情筛选',
+            style:
+                theme.textTheme.titleSmall?.copyWith(fontWeight: FontWeight.w600),
+          ),
           const SizedBox(height: 12),
           Wrap(
             spacing: 12,
             runSpacing: 12,
             children: _moodFilters.map((mood) {
-              final color = AppColors.moodColors[mood.value] ?? colorScheme.primary;
+              final color =
+                  AppColors.moodColors[mood.value] ?? colorScheme.primary;
               return GestureDetector(
                 onTap: () {
                   _searchController.text = _moodLabel(mood);
-                  _doSearch();
+                  context.read<SearchBloc>().add(SearchByMood(mood));
                 },
                 child: Column(
                   children: [
@@ -110,7 +164,8 @@ class _SearchPageState extends State<SearchPage> {
                         color: color.withValues(alpha: 0.15),
                       ),
                       alignment: Alignment.center,
-                      child: Text(_moodEmoji(mood), style: const TextStyle(fontSize: 24)),
+                      child: Text(_moodEmoji(mood),
+                          style: const TextStyle(fontSize: 24)),
                     ),
                     const SizedBox(height: 4),
                     Text(_moodLabel(mood), style: theme.textTheme.labelSmall),
@@ -124,24 +179,81 @@ class _SearchPageState extends State<SearchPage> {
     );
   }
 
-  Widget _buildSearchResults(BuildContext context, ColorScheme colorScheme) {
+  /// 搜索结果列表
+  Widget _buildResults(
+    BuildContext context,
+    ThemeData theme,
+    ColorScheme colorScheme,
+    List<JournalEntry> results,
+  ) {
+    if (results.isEmpty) {
+      return Center(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            Icon(Icons.search_off_rounded,
+                size: 48,
+                color: colorScheme.onSurface.withValues(alpha: 0.2)),
+            const SizedBox(height: 12),
+            Text(
+              '没有找到匹配的日记',
+              style: theme.textTheme.bodyMedium?.copyWith(
+                color: colorScheme.onSurface.withValues(alpha: 0.5),
+              ),
+            ),
+            const SizedBox(height: 16),
+            FilledButton.tonal(
+              onPressed: _clearSearch,
+              child: const Text('清除筛选'),
+            ),
+          ],
+        ),
+      );
+    }
+
+    return ListView.separated(
+      padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
+      itemCount: results.length,
+      separatorBuilder: (_, _) => const SizedBox(height: 8),
+      itemBuilder: (context, index) {
+        final entry = results[index];
+        return _JournalCard(entry: entry);
+      },
+    );
+  }
+
+  /// 错误提示
+  Widget _buildError(ColorScheme colorScheme, String message) {
     return Center(
       child: Column(
         mainAxisSize: MainAxisSize.min,
         children: [
-          Icon(Icons.search_off_rounded, size: 48, color: colorScheme.onSurface.withValues(alpha: 0.2)),
+          Icon(Icons.error_outline_rounded,
+              size: 48,
+              color: colorScheme.error.withValues(alpha: 0.6)),
           const SizedBox(height: 12),
           Text(
-            'Phase 1: 搜索功能待 Isar FTS 集成',
-            style: Theme.of(context).textTheme.bodyMedium?.copyWith(
-              color: colorScheme.onSurface.withValues(alpha: 0.5),
+            message,
+            style: TextStyle(
+              color: colorScheme.error,
+              fontSize: 14,
             ),
           ),
+          const SizedBox(height: 16),
+          FilledButton.tonal(
+            onPressed: _clearSearch,
+            child: const Text('重试'),
+          ),
         ],
       ),
     );
   }
 
+  void _clearSearch() {
+    _searchController.clear();
+    context.read<SearchBloc>().add(const SearchClear());
+  }
+
   String _moodEmoji(Mood mood) => switch (mood) {
         Mood.happy => '😊',
         Mood.calm => '😌',
@@ -158,3 +270,101 @@ class _SearchPageState extends State<SearchPage> {
         Mood.thinking => '思考',
       };
 }
+
+/// 日记卡片 — 在搜索结果中展示单条日记摘要
+class _JournalCard extends StatelessWidget {
+  final JournalEntry entry;
+
+  const _JournalCard({required this.entry});
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final colorScheme = theme.colorScheme;
+    final moodColor =
+        AppColors.moodColors[entry.mood.value] ?? colorScheme.primary;
+
+    return Card(
+      elevation: 0,
+      shape: RoundedRectangleBorder(
+        borderRadius: BorderRadius.circular(16),
+        side: BorderSide(color: colorScheme.outlineVariant),
+      ),
+      child: InkWell(
+        borderRadius: BorderRadius.circular(16),
+        onTap: () {
+          // TODO: 导航到日记详情页
+        },
+        child: Padding(
+          padding: const EdgeInsets.all(16),
+          child: Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              // 第一行：心情 emoji + 标题 + 日期
+              Row(
+                children: [
+                  Text(
+                    _moodEmoji(entry.mood),
+                    style: const TextStyle(fontSize: 20),
+                  ),
+                  const SizedBox(width: 8),
+                  Expanded(
+                    child: Text(
+                      entry.title,
+                      style: theme.textTheme.titleSmall?.copyWith(
+                        fontWeight: FontWeight.w600,
+                      ),
+                      maxLines: 1,
+                      overflow: TextOverflow.ellipsis,
+                    ),
+                  ),
+                  Text(
+                    DateFormat('MM/dd').format(entry.date),
+                    style: theme.textTheme.labelSmall?.copyWith(
+                      color: colorScheme.onSurfaceVariant,
+                    ),
+                  ),
+                ],
+              ),
+              // 第二行：标签
+              if (entry.tags.isNotEmpty) ...[
+                const SizedBox(height: 8),
+                Wrap(
+                  spacing: 6,
+                  runSpacing: 4,
+                  children: entry.tags.take(4).map((tag) {
+                    return Container(
+                      padding: const EdgeInsets.symmetric(
+                        horizontal: 8,
+                        vertical: 2,
+                      ),
+                      decoration: BoxDecoration(
+                        color: moodColor.withValues(alpha: 0.1),
+                        borderRadius: BorderRadius.circular(8),
+                      ),
+                      child: Text(
+                        tag,
+                        style: theme.textTheme.labelSmall?.copyWith(
+                          color: moodColor,
+                          fontSize: 11,
+                        ),
+                      ),
+                    );
+                  }).toList(),
+                ),
+              ],
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+
+  String _moodEmoji(Mood mood) => switch (mood) {
+        Mood.happy => '😊',
+        Mood.calm => '😌',
+        Mood.sad => '😢',
+        Mood.angry => '😠',
+        Mood.thinking => '🤔',
+      };
+}