StreetPass 📡

Bluetooth（BLE）を使ったスマホ版すれ違い通信アプリ

概要

StreetPassは、近くにいるユーザー同士がBluetooth Low Energy（BLE）を通じて自動的にすれ違い通信を行い、プロフィールや一言メッセージを交換できるアプリです。

技術スタック

カテゴリ	技術
フレームワーク	Flutter / Dart
状態管理	Riverpod
ルーティング	GoRouter
HTTP通信	Dio
BLE通信	flutter_blue_plus
データクラス	freezed / json_serializable
トークン管理	flutter_secure_storage

アーキテクチャ

Clean Architecture（feature-first ディレクトリ構成）を採用しています。

lib/
├── core/                  # 共通基盤（ネットワーク等）
├── common/                # 共通Widget・ルーター
├── features/
│   ├── auth/              # 認証機能
│   │   ├── data/          # リポジトリ（API通信）
│   │   ├── domain/        # 状態管理（Notifier）
│   │   └── presentation/  # 画面（UI）
│   ├── user/              # ユーザー機能
│   ├── encounter/         # すれ違い通信機能
│   ├── home/              # ホーム画面
│   ├── plaza/             # 広場機能
│   ├── calendar/          # カレンダー機能
│   └── my_page/           # マイページ機能
└── main.dart

セットアップ

# 依存パッケージのインストール
flutter pub get

# freezed等のコード生成
dart run build_runner build --delete-conflicting-outputs

# 実行
flutter run

対象OS

• Android
• iOS（考慮した設計）

開発の鉄則（時間・タイムゾーンの扱いについて）

バックエンドとのタイムゾーンの破綻や、時計操作による不正（チート）を防ぐため、本アプリの時間管理は以下の厳格なルールに従うこと。

1. UI表示・日またぎ判定は必ず AppTime を使う 画面への日時表示や、カレンダーの「今日」の判定には、直接 DateTime.now() を使わず、必ず lib/core/utils/app_time.dart の AppTime (JST固定) を経由させること。

2. システム保存・API通信は必ず UTC で行う バックエンドへのデータ送信時や、トークンの有効期限の比較時には AppTime は絶対に使用せず、必ず DateTime.now().toUtc() を使用すること。表示用の時間(JST)をそのままサーバーに送ると、タイムゾーンが二重適用される致命的なバグが発生する。