本文へスキップ
公開日: 使った技術: swiftui · sqlite · ios · photokit · healthkit · vision · storekit

ひとつづり(hitotsuzuri)

写真・⁠動画・⁠メモ・⁠音声・⁠歩いた場所を、ひとつの時系列に綴じて振り返るiPhoneアプリ。サーバーを持たず、記録の正本を端末内のSQLiteに置く設計、写真の原本を写真ライブラリに残す保存、すべての記録を1本の表に寄せたデータモデル、端末内だけで行う解析、暗号化したバックアップを実装。

写真・動画・メモ・音声・歩いた場所を、ひとつの時系列に綴じて振り返るiPhoneアプリ。日記を書かなかった日にも、写真フォルダの一枚や短いメモは残っている。それを時間の流れに沿って綴じていく。記録はすべて端末の中にあり、サーバーを持たない。

App Store: ひとつづり(新しいタブで開きます) / 紹介サイト: hitotsuzuri.app(新しいタブで開きます)

コンセプト

何でもない日々の記憶を、ひとつづりに。

  • すでにある記録を取り込む。写真ライブラリや位置の記録など、暮らしの中にすでにある記録を取り込み、毎日の入力の手間を抑える
  • 種類をまたいでたどる。写真・メモ・音声・場所を種類ごとに分けず、その日の出来事として一緒にたどる。スクロールして生活の流れを振り返るのが画面の基本
  • 記憶のまとまりは自分で決める。時間や場所が近い記録は自動で「まとまり」になり、そこから先は思い出す単位で重ねたり切り分けたりできる
  • 記録を失わない。通信の切断やアプリの終了で記録を失わないことと、蓄積した記録を確実に取り出せることを優先する

機能紹介

  • たどる: 上ほど過去、下ほど最新のタイムライン。まとまりごとに写真の束・メモ・音声・移動と滞在を並べる
  • まとめる・切り分ける: 見出しを長押しして別のまとまりへ重ねると、ひとつにまとまる。記録を右へスワイプすると、ハサミが進んでその上で分かれる。元の記録や日時は書き換えず、直前の整理は「元に戻す」で取り消せる
  • 取り込み: 写真・動画、端末の位置の記録(滞在と大きな移動)、ヘルスケアの睡眠と運動、音声、メモ、Google タイムラインの書き出し
  • 探す: ことば・時刻・場所・種類で絞り込む。自分で付けた場所の名前でも探せる
  • 写真の説明文: 写真の中の文字を読み取り、対応する iPhone では端末内のモデルで一文の説明を付ける。画像は端末の外へ出ない
  • 場所と現地時刻: 座標から現地の時差を通信なしで推定する。Apple の地図・地名は、有効にした場合だけ記録の詳細で確かめられる
  • バックアップ: 暗号化した控えを、本人が選んだフォルダ(iCloud Drive など)へ毎日/毎週を目安に書き出す
  • 料金: 残す・たどるは無料。まとまりの編集は2週間の試用と、買い切りの購入

たどる(一覧)、まとまりの記録、場所の詳細の画面。紹介サイトに載せている、架空の記録で撮った画面

アーキテクチャ

ひとつづりの iPhone アプリの構成。写真・動画(PhotoKit)、位置(滞在と移動)、ヘルスケア(睡眠と運動)、アプリで録る音声と書くメモ、Google タイムラインを取り込み、まず端末へ保存して、同じ記録を二重にしない。記録の正本は端末内の SQLite で、すべての記録を1本の表に持ち、ことば検索は FTS5。解析は Vision の文字認識、端末内の音声認識、端末内モデルの説明文で、端末の中で行う。SwiftUI の画面でたどり、まとめ、切り分け、探す。現地時刻は通信なしで推定する。バックアップは記録の写しを暗号化して本人が選んだフォルダへ書き出す。Apple の地図と地名は有効にしたときだけ使い、応答は短く保持する。サーバーを持たず、外部の AI へは送らない。写真の原本は写真ライブラリに残す

  • SwiftUI: 画面。日本語と英語に対応する(本人の本文や取り込んだデータは翻訳しない)
  • PhotoKit / Core Location / HealthKit: 写真・動画の取り込みと原本の表示、省電力の滞在検知と大きな移動の検知、睡眠と運動の読み取り
  • SQLite: 記録の正本。WAL と同期書き込みで耐久性を優先し、キーワード検索は FTS5(日本語のため trigram)
  • Vision / 音声認識 / 端末内のモデル: 画像の文字認識と分類、端末内の文字起こし、写真の説明文。端末内で処理できない端末・言語では、外へ送らずに断る
  • MapKit: 地図と地名(有効にした場合だけ)。現地時刻は同梱の境界データで端末内で推定する
  • バックアップ: SQLite のオンラインバックアップで一貫した写しを作り、AES-GCM で暗号化して書き出す。OS のバックグラウンド処理で定期的に実行する
  • StoreKit: 試用と買い切りの購入

設計の判断

判断はADRと設計の文書に記録している。そのなかから、何に困り、何を比べ、何を引き換えにしたかが伝わるものを選んだ。

ひとつづりで記録が綴じられる流れ。1. 写真・位置・ヘルスケア・音声・メモ・Google タイムラインを、まず端末へ保存し、通信の切断や終了でも失わない。2. 種類が違っても同じ表に同じ形で持ち、出来事の時刻と取り込みの時刻を分け、時差は座標から端末内で推定する。3. 時間や場所が近い記録を自動でまとまりに綴じ、長押しで重ね、スワイプで切る。元の記録と日時は書き換えない。4. 上ほど過去へスクロールしてたどり、ことば・時刻・場所・種類で探す。写真の説明文も端末内の解析で付く。どの段も端末の中で完結する

記録は端末の中だけに置く

  • 生活の記録は、本人の端末の中だけに置く。記録の保存・閲覧・編集・検索・削除と、バックアップの書き出しは、すべて端末の中で処理する。記録そのものの操作に通信は要らず、運用するサーバーもない。端末の外とつながるのは、写真の原本の取得やバックアップ先への転送など、Apple のシステムのサービスを使うところと、本人が有効にした Apple の地図・地名だけ
  • 記録の正本は端末内の SQLite。WAL と同期書き込みで耐久性を優先し、ファイルの保護は、画面のロック中も位置などの取り込みを続けられる段階にした
  • 位置・音声・取り込みは、まず端末の台帳へ保存してから記録にする。通信の切断やアプリの終了があっても、記録を失わずに続きから再開できる
  • 表の変更は端末の中の移行として順に適用し、知らない版の DB は開かない
  • 引き換えに、記録を確実に取り出せることはバックアップが支える(後述)

すべての記録を1本の表に寄せる

  • 写真・音声・位置・メモ・ヘルスケアは形式がばらばら。形式ごとに表を分けると、表示も検索も形式ごとに戻ってしまう
  • 1本の events 表に種類を持たせ、形式ごとの属性は JSON に入れた。検索する本文は独立した列にし、全文検索の索引を張れるようにした
  • 出来事の時刻と取り込みの時刻を必ず分け、幅のある出来事(滞在や睡眠など)のために終わりの時刻も最初から持つ。時刻は UTC の整数で持ち、時差を別に持つ
  • 撮影の時差が分からないときは、いまの端末の設定から推測しない。代わりに、座標と同梱の境界データから端末内で地域を推定し、元の時差とは分けて保存する。境界があいまいな地点は不明のままにする
  • これでタイムラインは形式が混ざったまま1回の問い合わせで取れる

写真の原本は持たない

  • 写真・動画の原本は写真ライブラリ(と iCloud 写真)に残し、写真の識別子だけを持つ。二重に保存すると、容量とプライバシーの両方で不利になる
  • 表示は必要な大きさをその場で原本から描く。手元に残す一枚の役割は「原本が消えたとき・読めないときに記録として残ること」だけなので、小さな縮小画像にした
  • 引き換えに、写真アプリで原本を消すと縮小画像しか残らない。そのときは隠さずに「元の写真は見つかりません」と示す。消したのか、アクセスを許していないのかは本人にしか分からないため
  • 機種を変えたときは、写真の識別子が変わっても原本を対応づけ直せるようにしている

同じ記録は二重にしない

  • 取り込みは、写真の追加分の読み込み、アプリを開いたときの自動の取り込み、Google タイムラインの書き出しの読み込みなど、何度も重なって走る。途中で止まることも普通にある
  • 冪等のキーを (source, source_id) の一意制約にした。もう一度取り込んでも既存の記録をそのまま返し、内容を書き換えない。本人が記録を非表示にした状態も、取り込み直しで戻らない
  • 取り込みの途中で止まっても、端末へ先に保存した台帳から再開する

AI は端末の中だけで使う

  • 外部の AI へは記録を送らない。AI を使う処理を分け、端末内だけ(取り込み・閲覧・編集・検索・削除)と端末内の AI(文字起こし・画像の文字認識と分類・写真の説明文)だけで中核の機能がすべて使えるようにした
  • 写真の説明文は、端末内のモデルが使える iPhone だけで付ける。画像は端末の外へ出さず、端末の外で処理するしくみも使わない。使えない端末では、有効にする方法を状況ごとに案内する
  • 引き換えに、意味で探す検索は持たない。端末の埋め込みが日本語に対応しないことを確かめ、ことばの全文検索(FTS5)で代える

取り出せることをバックアップで支える

  • 記録を確実に取り出せることはバックアップが担う。SQLite のオンラインバックアップで一貫した写しを作り、AES-GCM で暗号化した1つのファイルにして、本人が選んだフォルダへ書き出す。断片の差し替えや並べ替えも検出する
  • 書き出しが途中で失敗しても前回の控えは残す。古い控えを消すのは、新しい控えが完成した後だけで、手動の控えや別の端末の控えは消さない
  • 復元は使用中の DB を上書きせず、別の保存領域に展開してから切り替える
  • OS がバックグラウンドの実行機会を決めるので、決まった時刻の実行は約束しない。アプリを前面に出したときにも期限を確かめる。iCloud Drive などへの「保存できた」は、クラウドへのアップロードの完了まで保証する表示にはしない

場所の確かめは任意にする

  • 現地時刻は、同梱の境界データで通信なしで推定する。Apple の地図・地名の確認は既定でオフにし、有効にした場合だけ座標を送る。応答は短い間だけ保持し、記録の正本には蓄えない
  • 本人が付けた場所の名前(「いつもの店」など)は端末に保存し、元の座標や題を書き換えずに一覧や検索の表示に反映する
  • 天気の表示は外した。利用量に応じて続く費用が、買い切りの料金と合わないため

画面: 絵巻のようにたどる

  • 紙の色・深い緑・細い綴じ線で、時間を絵巻のようにスクロールしてたどる画面にした。記録の時差が分かるときは、時間帯の色と光を背景に映す
  • 一覧は記録の数ではなく「まとまり」の単位で読み、写真は軽く重なった束で見せる。束からまとまりの全件を開ける
  • 整理の操作(重ねる・切る)は、元の記録や日時を変えない表示上の整理として扱い、「元に戻す」で直前の状態に戻せる。初めての案内では、架空の記録で操作を試せる

開発・運用

  • AI エージェントとの開発: サービスの思想・画面の決まり・守る設計の方針を AGENTS.md と docs/ に置き、本人の指示で決まったことを日付つきで書き足しながら進めている
  • iOS: XcodeGen でプロジェクトを生成し、Xcode Cloud の設定を置いている。App Store の画面写真は、架空の記録を作る撮影用の UI テストで撮る
  • 公開の準備: 法令・プライバシーの表示・権限の用途の説明を文書で整理し、プライバシーマニフェストを同梱している
  • 紹介サイト: 日本語・英語の静的なサイトを GitHub Actions から公開している。画面の図は架空の記録で撮り、そのことをサイトにも書いている