7. ドメイン層

業務のルールを画面と DB から切り離す

この章のゴール

1

ルールを書く

最大値の計算と自己ベストの判定

2

UseCase を作る

分析と保存をまとめた業務操作

3

ViewModel を薄くする

6章の計算を移す

ドメイン層とは

UI 層 — どう見せるか

測定値を大きな文字で表示する

ドメイン層 — 何をするか

最大角速度を求め、自己ベストかを判定する

データ層 — どこに置くか

セッションを SQLite に保存する

  • 紙とストップウォッチでやっても変わらないルール = ドメイン
  • 画面のデザインや DB を変えても、ルールは変わらない

分析のルール(純粋な計算)

lib/domain/motion_analyzer.dart
import 'package:motion_app/service/imu/imu_device.dart';

// 1回の測定のまとめ
class MotionSummary {
  const MotionSummary({
    required this.durationSec,
    required this.sampleCount,
    required this.peakGyro1,
    required this.peakGyro2,
    required this.peakAcc1,
    required this.peakAcc2,
  });

  final double durationSec;
  final int sampleCount;
  final double peakGyro1; // [dps]
  final double peakGyro2;
  final double peakAcc1; // [g]
  final double peakAcc2;
}

// 動きの分析ルール。画面にもDBにも依存しない純粋な計算
abstract final class MotionAnalyzer {
  static const double sampleRateHz = 100; // センサは 100Hz でデータを送る

  static MotionSummary summarize(List<ImuSample> samples) {
    double peak(double Function(ImuSample s) value) =>
        samples.fold(0, (max, s) => value(s) > max ? value(s) : max);
    return MotionSummary(
      durationSec: samples.length / sampleRateHz,
      sampleCount: samples.length,
      peakGyro1: peak((s) => s.gyro1.magnitude),
      peakGyro2: peak((s) => s.gyro2.magnitude),
      peakAcc1: peak((s) => s.acc1.magnitude),
      peakAcc2: peak((s) => s.acc2.magnitude),
    );
  }

  // 自己ベスト = センサ1の最大角速度が、これまでのすべての記録を上回った
  static bool isPersonalBest(double peakGyro1, List<double> pastPeaks) =>
      pastPeaks.every((past) => peakGyro1 > past);
}
  • Flutter にも DB にも依存しない → 単体テストしやすい(11章)
  • 6章で ViewModel に書いていた計算が、ここに引っ越した

UseCase

lib/domain/save_session_usecase.dart
import 'package:motion_app/domain/motion_analyzer.dart';
import 'package:motion_app/repository/session/session_repository.dart';
import 'package:motion_app/service/imu/imu_device.dart';

class SaveSessionResult {
  const SaveSessionResult({required this.summary, required this.isPersonalBest});

  final MotionSummary summary;
  final bool isPersonalBest;
}

// 測定データを分析し、自己ベストかを判定して保存する(ルール + 保存をまとめた業務操作)
class SaveSessionUseCase {
  SaveSessionUseCase({required SessionRepository sessionRepository})
      : _sessions = sessionRepository;

  final SessionRepository _sessions;

  Future<SaveSessionResult> call({
    required String userId,
    required List<ImuSample> samples,
  }) async {
    final summary = MotionAnalyzer.summarize(samples);
    final history = await _sessions.getByUser(userId);
    final isBest = MotionAnalyzer.isPersonalBest(
      summary.peakGyro1,
      [for (final s in history) s.peakGyro1],
    );
    await _sessions.add(
      userId: userId,
      durationSec: summary.durationSec,
      sampleCount: summary.sampleCount,
      peakGyro1: summary.peakGyro1,
      peakGyro2: summary.peakGyro2,
      peakAcc1: summary.peakAcc1,
      peakAcc2: summary.peakAcc2,
    );
    return SaveSessionResult(summary: summary, isPersonalBest: isBest);
  }
}

UseCase を作る基準

  • 作る: ルール(計算・判定)を含む / 複数の Repository をまたぐ / 2か所以上から使う
  • 作らない: Repository を1回呼ぶだけ(横流しのクラスが増えるだけ)

Provider に登録する

lib/provider/providers.dart
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:motion_app/domain/save_session_usecase.dart';
import 'package:motion_app/infrastructure/database/app_database.dart';
import 'package:motion_app/repository/session/session_repository.dart';
import 'package:motion_app/repository/user/user_repository.dart';
import 'package:motion_app/service/imu/fake_imu_device.dart';
import 'package:motion_app/service/imu/imu_device.dart';

part 'providers.g.dart';

@Riverpod(keepAlive: true)
AppDatabase appDatabase(Ref ref) {
  final db = AppDatabase();
  ref.onDispose(db.close);
  return db;
}

@Riverpod(keepAlive: true)
UserRepository userRepository(Ref ref) =>
    UserRepository(ref.watch(appDatabaseProvider));

@Riverpod(keepAlive: true)
SessionRepository sessionRepository(Ref ref) =>
    SessionRepository(ref.watch(appDatabaseProvider));

// 6軸センサ。今は偽物を使う(8章でBLEに差し替える)
@Riverpod(keepAlive: true)
ImuDevice imuDevice(Ref ref) {
  final device = FakeImuDevice();
  ref.onDispose(device.dispose);
  return device;
}

// センサのデータを Riverpod で購読できるようにする
@riverpod
Stream<ImuSample> imuSample(Ref ref) => ref.watch(imuDeviceProvider).samples;

@Riverpod(keepAlive: true)
SaveSessionUseCase saveSessionUseCase(Ref ref) => SaveSessionUseCase(
      sessionRepository: ref.watch(sessionRepositoryProvider),
    );

ViewModel を薄くする

lib/ui/measurement/view_model/measurement_view_model.dart
import 'package:freezed_annotation/freezed_annotation.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:motion_app/domain/save_session_usecase.dart';
import 'package:motion_app/provider/providers.dart';
import 'package:motion_app/service/imu/imu_device.dart';

part 'measurement_view_model.g.dart';
part 'measurement_view_model.freezed.dart';

@freezed
abstract class MeasurementState with _$MeasurementState {
  const factory MeasurementState({
    @Default(false) bool isMeasuring,
    @Default(0) double gyro1, // センサ1の現在の角速度の大きさ[dps]
    @Default(0) double gyro2, // センサ2の現在の角速度の大きさ[dps]
    @Default(0) int sampleCount,
  }) = _MeasurementState;
}

@riverpod
class MeasurementViewModel extends _$MeasurementViewModel {
  final _samples = <ImuSample>[]; // 測定中に受け取った全データ

  @override
  MeasurementState build(String userId) {
    // センサのデータを受け取る。購読の解除は Riverpod が自動で行う
    ref.listen(imuSampleProvider, (previous, next) {
      final sample = next.value;
      if (sample != null) _onSample(sample);
    });
    // 画面を閉じたら計測を止める(onDispose の中では ref を使えないので先に取得)
    final device = ref.read(imuDeviceProvider);
    ref.onDispose(device.stop);
    return const MeasurementState();
  }

  void _onSample(ImuSample sample) {
    if (!state.isMeasuring) return;
    _samples.add(sample);
    // 100Hz で画面を描き直すと重いので、5件に1回(20Hz)だけ状態を更新する
    if (_samples.length % 5 != 0) return;
    state = state.copyWith(
      gyro1: sample.gyro1.magnitude,
      gyro2: sample.gyro2.magnitude,
      sampleCount: _samples.length,
    );
  }

  Future<void> start() async {
    _samples.clear();
    state = const MeasurementState(isMeasuring: true);
    await ref.read(imuDeviceProvider).start();
  }

  // 止めて保存する。データがなければ null
  Future<SaveSessionResult?> stopAndSave() async {
    if (_samples.isEmpty) return null;
    // await のあとで ref を使わないよう、必要なものは先に取得しておく
    final saveSession = ref.read(saveSessionUseCaseProvider);
    final device = ref.read(imuDeviceProvider);
    state = state.copyWith(isMeasuring: false);
    await device.stop();
    // 分析(最大値・自己ベスト判定)と保存は UseCase に任せる
    return saveSession(userId: userId, samples: List.of(_samples));
  }
}
  • ViewModel は UseCase を呼んで、結果を返すだけになった

自己ベストを知らせる

lib/ui/measurement/view/measurement_page.dart
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/ui/measurement/view_model/measurement_view_model.dart';

class MeasurementPage extends ConsumerWidget {
  const MeasurementPage({super.key, required this.userId});

  final String userId;

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(measurementViewModelProvider(userId));
    final notifier = ref.read(measurementViewModelProvider(userId).notifier);
    final big = Theme.of(context).textTheme.displaySmall;

    return Scaffold(
      appBar: AppBar(title: const Text('測定')),
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text('センサ1  ${state.gyro1.toStringAsFixed(0)} dps', style: big),
            Text('センサ2  ${state.gyro2.toStringAsFixed(0)} dps', style: big),
            const SizedBox(height: 8),
            Text('${(state.sampleCount / 100).toStringAsFixed(1)} 秒'),
            const SizedBox(height: 32),
            state.isMeasuring
                ? FilledButton.icon(
                    icon: const Icon(Icons.stop),
                    label: const Text('停止して保存'),
                    onPressed: () async {
                      final result = await notifier.stopAndSave();
                      if (result == null || !context.mounted) return;
                      if (result.isPersonalBest) {
                        ScaffoldMessenger.of(context).showSnackBar(
                          const SnackBar(content: Text('自己ベスト更新!')),
                        );
                      }
                      context.pop(true);
                    },
                  )
                : FilledButton.icon(
                    icon: const Icon(Icons.play_arrow),
                    label: const Text('測定開始'),
                    onPressed: notifier.start,
                  ),
          ],
        ),
      ),
    );
  }
}
  • showSnackBar のすぐあとに context.pop(true) しても、SnackBar は前の画面に残って表示される(次のスライド)

ScaffoldMessenger と Fluttertoast:メリット

短いメッセージを出す方法は、標準の ScaffoldMessenger(SnackBar)と、パッケージの Fluttertoast がよく使われます。

ScaffoldMessenger(SnackBar)

  • Flutter 標準。パッケージを追加しなくてよい
  • どの OS でも同じ見た目・同じ動き。テーマ色も反映される
  • 「元に戻す」などのボタン(SnackBarAction)を付けられる
  • MaterialApp が持っているので、画面を閉じても消えない
  • widget テストで find.text(...) で確認できる

Fluttertoast

  • Fluttertoast.showToast(msg: ...) だけで出せる
  • context なしで、どこからでも呼べる
  • Android / iOS ではネイティブの Toast の見た目になる

ScaffoldMessenger と Fluttertoast:デメリット

ScaffoldMessenger(SnackBar)

  • context が必要。ViewModel からは直接出せない(await のあとは context.mounted を確認)
  • 画面下に出るので、下部のボタンと重なることがある
  • 続けて出すと順番待ちになる(すぐ切り替えたいときは hideCurrentSnackBar())

Fluttertoast

  • パッケージの追加が必要
  • showToast は Android / iOS / Web のみ。macOS / Windows では表示されない(FToast なら出せるが context が必要)
  • ボタンを付けられない。Android 11 以降は色などの指定が効かない
  • widget テストで確認しにくい。ViewModel に画面の処理が混ざりやすい

この教材では SnackBar を使う

  • macOS でも動かすので、どの OS でも同じに動く SnackBar を使う
  • 表示は View(画面)で行い、ViewModel は「自己ベストか」という結果だけを返す → ViewModel のテストに画面の処理が入らない
  • Fluttertoast は、Android / iOS 専用のアプリで、context のない場所から軽く知らせたいときに検討する

チェックポイント

CHECK 0 / 3