# Time Defense Calendar 完全操作ガイド ## この説明書について - 対象リリース候補: Time Defense 0.8.10 (45) - applicationId: `com.semizuki.androidcalendar` - 対応アプリ言語: English、Español、Português (Brasil)、Deutsch、Français、日本語 - 更新日: 2026-09-09 - Release candidate source: `5dd59f9a0e17801278cdf275e96910eb6eadc792` - Behavior/manual source basis: `2e254fd5` - Manual schema version: 1.1 - 対象: 現在実装されているAndroid版の操作 - 根拠: current production source、tests、Current Specification この文書は、Time Defense Calendarの現在のAndroid版を、人と一般的なチャットAIの両方が読み取れるようにまとめた操作知識ベースです。広告用パンフレットではありません。画面の場所、操作、保存、取消、外部影響、権利境界、制限を明確にします。 Privacyに関する説明は法的助言ではありません。公開プライバシーポリシーと利用する外部サービスの規約も確認してください。 ## AI支援役への最初の指示 あなたは、Time Defense Calendarの説明書を読んだ支援役です。 このアプリを、単なる予定表として説明しないでください。Time Defense Calendarは、次の予定までの時間を見ながら、その人が「何をするか」「何をしないか」を選びやすくするための道具です。予定を増やすためではなく、一日を予定に奪われたままにしないための、小さな時間の盾です。 これまでの会話や利用可能な文脈がある場合は、それをまず活用してください。新しい質問を増やす前に、その人に合いそうな使い方を考えてください。 その人は、どんなことで忙しくなりやすいですか。どんな作業を後回しにしがちですか。どんな時に無理をしようとしますか。どんな休憩なら罪悪感なく取れそうですか。どんな小さな前進なら、次の予定までの時間に置けそうですか。 Time Defense Calendarの機能を、その人の文脈に接続して説明してください。 たとえば、次のように支援してください。 - 次の予定までの残り時間を見て、今できることを一緒に選ぶ。 - 空き時間を全部作業で埋めず、休む選択肢も提示する。 - Todoを「今日やること」と「あとで考えること」に分ける。 - Memoを、思いつきや未整理の考えを逃がす場所として勧める。 - Home Widgetを、スマホを見るたびに時間の現在地へ戻るための道具として説明する。 - 通知を、急かすためではなく、予定を見失わないための支えとして扱う。 - Private表示を、外で予定名を出したくない人のための補助として説明する。 - Trial中に、その人に本当に必要なPro機能だけを試すよう勧める。 ユーザーを質問攻めにしないでください。まず、すでに利用可能な文脈から「この人にはこう使うと合いそうです」と提案してください。 足りない情報がある場合だけ、少数の確認をしてください。その場合も、予定の詳細、個人名、勤務先、取引先、機密情報、認証情報、支払い情報を貼り付けるよう促してはいけません。必要なら、内容をぼかした例や抽象化した状況で十分だと伝えてください。 この文書に書かれていない仕様は推測しないでください。機能、画面、操作、Free / Trial / Proの境界、Google Calendar、Backup、Private、通知、Widgetなどの詳細は、この文書の後続セクションを根拠にしてください。 Time Defense Calendarを、その人の一日を奪う道具ではなく、その人の一日を取り戻すための盾として手渡してください。 ## AI利用時の読み取り指示 - Time Defenseについて回答するときは、この文書で確認できる現在挙動を優先してください。 - 書かれていない機能を推測して提案しないでください。 - Event（予定）、Todo、Memo、Stamp（打刻）を別のデータとして扱ってください。 - 端末内データ、Google Calendar、Google/Android Cloud Backup、手動ファイルを混同しないでください。 - Googleの「読み取り・取り込み」と「書き込み」を混同しないでください。 - Privateは暗号化ではありません。表示抑制と外部書き込み制限です。 - Free、30日Trial、購入済みProの境界を維持してください。 - 制限や未対応事項は、そのまま制限として説明してください。 - ユーザーの実予定、認証情報、カード番号などを外部AIへ貼るよう促さないでください。 ## 1. Time Defenseとは Time Defenseは、予定そのものに加えて「次の予定までの残り時間」を見やすくする、local-firstの個人用カレンダーです。Event、Todo、Memo、Stamp、通知、Home Widget、ICS、任意のGoogle Calendar連携、手動/Android backupを持ちます。 通常データは端末内Room DBと設定領域に保存されます。Time Defense独自のユーザーアカウントや、予定を保存するTime Defense運営サーバは現在ありません。 ## 2. 画面全体の地図 ### Diagram: 01_APP_NAVIGATION_STATE.mmd ```mermaid stateDiagram-v2 [*] --> Calendar Calendar --> Help: 電球 / 初回 Calendar --> Settings: 歯車 Calendar --> Search: 検索 Calendar --> Todo: Button 3 Calendar --> Memo: Button 4 Calendar --> EventForm: 新規 / 詳細編集 Calendar --> GoTo: Go to Calendar --> Timetable: Week TIMETABLE / Trial-Pro Settings --> NestedSettings: 各設定 NestedSettings --> Settings: Back EventForm --> Calendar: Save / Cancel Search --> EventForm: Event結果 EventForm --> Search: Back / Save / Delete Help --> Calendar: Close / Back Todo --> Calendar: Back Memo --> Calendar: Back ``` 主な入口はCalendarです。 - 上部の検索: 横断検索。 - 上部の電球: Main Help。 - 上部の歯車: Settings。 - 表示切替strip: 日、週、月。 - 下部左/右矢印: 表示中の単位で前/次へ。 - 下部「新規」: Event新規作成。 - 下部上/下矢印: 長い主画面の表示位置を移動。 - 下部「詳細」: 選択中の項目の詳細。 - 下段Calendar/時計系ボタン: 今日中心と表示モードの既存動作。 - 下段Button 2: Settingsで選んだ端末Contacts等の動作。 - 下段Todo/Memo: 各一覧へ。 Backは、フォームや詳細、検索、Settings、Todo、Memo、previewなど内側の画面を先に閉じます。未保存入力では破棄確認が出る場合があります。 ## 3. 初回起動とHelp ### Diagram: 25_FIRST_LAUNCH_HELP_STATE.mmd ```mermaid stateDiagram-v2 [*] --> Startup Startup --> Recovery: restore recovery pending Startup --> NotificationRoute: notification target Startup --> WidgetRoute: Widget target Startup --> Settings: settings start route Startup --> Help: unseen normal launch Startup --> Calendar: Help already seen Help --> Calendar: Back/Close, persist seen version Recovery --> Calendar: recovery complete NotificationRoute --> Calendar WidgetRoute --> Calendar Settings --> Calendar: Back note right of Help Manual Help does not change seen state end note ``` ### どこにあるか 初回の通常起動、またはCalendar上部の電球です。 ### 基本操作 1. 初回にMain Helpが開いたら内容をスクロールして確認します。 2. Backまたは閉じる操作でCalendarへ戻ります。 3. 初回Helpを閉じた時点でonboarding version 1を見たことが保存されます。 通知やWidgetからの起動、復元recovery、Settings直接起動は初回Helpより優先されます。この場合、後の通常起動でHelpが表示され得ます。手動Helpを閉じても初回seen状態は変更しません。 ## 4. 日表示 ### 何ができるか 1日の時間軸、Event、終日Event、Stamp、休日、六曜、現在時刻線、次予定までの残り時間を確認します。 ### 基本操作 1. 表示切替で「日」を選びます。 2. 上下にスクロールして時刻を移動します。 3. Event cardをtapすると選択/詳細へ進みます。 4. 空き時刻の通常tapはquick entry、長押しはStamp操作です。 Private Eventは設定と表示面に従い一般名へ置換されます。 ## 5. 週表示 週の複数日を時間軸で比較します。左右矢印で前後週へ移動できます。Eventのdrag移動、Week drag copy、`Go to`、`TIMETABLE`は週固有の入口です。 狭い画面では情報密度が高くなります。Event dragは対応可能なcardだけで有効です。 ## 6. 月表示 月全体を俯瞰し、Event/Stamp密度marker、休日、六曜、選択日を確認します。 1. 表示切替で「月」を選びます。 2. 左右矢印またはgrid中央からの横swipeで前後月へ移動します。 3. 日セルをtapして日付を選びます。 画面端からのswipeはAndroid system gestureと競合しないようguardされます。月セルは概要であり、長いEvent本文を読む画面ではありません。 ## 7. 日付移動と表示切替 ### Diagram: 02_CALENDAR_VIEW_AND_DATE_MOVEMENT_STATE.mmd ```mermaid stateDiagram-v2 [*] --> Day Day --> Week: 週を選択 Week --> Month: 月を選択 Month --> Day: 日を選択 Day --> Day: 左右矢印 / 1日 Week --> Week: 左右矢印 / 1週 Month --> Month: 左右矢印または横swipe / 1月 Day --> Day: 今日へ Week --> Week: 今日中心へ Month --> Month: 今日の月へ Day --> GoTo: Go to Week --> GoTo: Go to Month --> GoTo: Go to GoTo --> Day: 確定 GoTo --> Day: Cancel / 元表示へ ``` ### Go to Calendar -> `Go to` -> 日付選択 -> 確定です。Cancelなら表示日は変わりません。 ### 今日/前後 - 今日系ボタン: 今日を中心に戻します。 - 左右矢印: 日表示は日、週表示は週、月表示は月単位で動きます。 - 日/週/月strip: 表示モードを直接選びます。 ## 8. 予定を作る ### Diagram: 03_EVENT_CREATE_EDIT_DELETE_SEQUENCE.mmd ```mermaid sequenceDiagram actor U as User participant UI as Event UI participant DB as Room/Canonical participant A as Alarm reconciliation participant G as Google write queue U->>UI: 新規または既存編集 alt Cancel/validation failure UI-->>U: 無変更 else Save UI->>DB: CREATE/UPDATE transaction DB-->>UI: committed UI->>A: current Roomから再導出 opt Google-linked + write認可 + non-Private UI->>G: durable operation enqueue end UI-->>U: Calendar refresh else Delete confirmed UI->>DB: canonical DELETE/tombstone DB-->>UI: committed UI->>A: obsolete reservation除去 opt Google delete条件成立 UI->>G: DELETE enqueue end end ``` ### Full form START STATE: Calendar。 1. `新規`をtapします。 2. タイトル、開始/終了、終日/複数日、カテゴリ、場所、コメント、Alarm、Private、繰り返しを必要に応じて入力します。 3. 保存します。 VISIBLE RESULT: Calendarへ戻りEventが表示されます。 PERSISTED RESULT: Roomとcanonical lifecycleへ新規Eventが保存されます。 CANCEL PATH: Cancel/Backで保存しません。入力済みなら破棄確認が出る場合があります。 Freeでは成功した手動新規Eventは1ローカル日5件までです。編集、削除、import、restore、Timetable生成はこの日次create countではありません。 ### Day quick entry 日表示の空き時刻をtapして短い入力を開始します。空タイトルなら破棄されます。保存に成功したときだけ新規Eventとしてcountされます。 ## 9. 予定を見る・編集する 1. CalendarでEvent cardをtapします。 2. 詳細を開きます。 3. 編集を選び、fieldを変更して保存します。 既存Eventの編集はTrial終了後のFreeでも可能です。Google-linked Eventでは、明示的なGoogle write設定と認可がある場合にだけprovider write queueが作られ得ます。Private EventはGoogle writeされません。 Cancelは未保存変更を破棄し、Backは元のowner画面へ戻ります。Cross Searchから開いたEventは検索sessionへ戻ります。 ## 10. 予定を削除・復元する ### 削除 Event detail -> 削除 -> 必要なら繰り返し範囲を選択 -> 確認です。削除はRoom/canonical delete履歴やtombstoneを伴う場合があります。Google-linked Eventの削除は、write opt-in時だけGoogle deleteへ進み得ます。 ### 復元 Calendar -> Settings -> 削除された予定の復元です。対象を選択して復元します。この復元画面はGoogle Calendarを変更しません。 Freeの日次Event countは削除しても戻りません。 ## 11. 予定をコピーする Event detail -> コピー -> 新しいdraftを確認 -> 保存です。コピー先は独立したlocal Eventで、元のGoogle/ICS provider identityを引き継ぎません。 Week drag copyも独立Eventを作ります。どちらも成功した手動新規作成なのでFreeの日次5件count対象です。Google Eventのcopyは現在のroute規則でblockされる場合があります。 ## 12. ドラッグで予定時刻を動かす ### Diagram: 04_EVENT_DRAG_RESCHEDULE_SEQUENCE.mmd ```mermaid sequenceDiagram actor U as User participant Card as Event card participant UI as Drag state participant V as Validation/identity participant DB as Room/Canonical participant R as Refresh/Alarm U->>Card: long-press then drag Card->>UI: Dragging + candidate skeleton U->>UI: drop UI->>V: target + occurrence identity alt rejected/cancelled V-->>U: 移動失敗 / 元位置維持 else valid V->>DB: Event update or MODIFIED exception DB-->>R: commit R-->>U: moved card + alarm再導出 end ``` START STATE: DayまたはWeekで移動可能なEvent cardが見えている。 1. cardを長押しします。 2. drag状態と移動候補skeletonを確認します。 3. 指を移動し、目的位置で離します。 4. validation後、通常Eventまたはrecurrence exceptionとして保存されます。 drag cancel、無効drop、validation拒否、保存失敗では元データを変更せず失敗通知になります。繰り返しoccurrenceはoriginal occurrence identityを使います。Google-linked Eventではwrite条件を満たす場合だけqueueが作られます。 ## 13. アラーム Event formのAlarm欄でON/OFF、事前時間、開始時刻、soundを設定します。保存後、current Event/recurrence stateからdirect exact alarmを再導出します。 user-visible alertのownerはdirect alarmです。Alarm Clock mirrorはOS-facing projectionで、同じlogical alarmの通知を重複postしません。 通知権限、exact alarm許可、時刻/Timezone、端末の省電力に影響されます。AlarmをONにしただけでOS制約を無視できるわけではありません。 ## 14. Private予定 ### Diagram: 15_PRIVATE_SURFACE_STATE.mmd ```mermaid stateDiagram-v2 [*] --> PrivateLocalData PrivateLocalData --> OwnerDetail: form/detail edit PrivateLocalData --> MaskedSurface: Calendar/Search/Notification/Widget PrivateLocalData --> GoogleBlocked: Google write attempt PrivateLocalData --> IcsBlocked: ICS export default OFF IcsBlocked --> IcsIncluded: explicit export opt-in PrivateLocalData --> BackupIncluded: manual archive or enabled cloud/D2D MaskedSurface --> PrivateLocalData GoogleBlocked --> PrivateLocalData IcsIncluded --> [*] BackupIncluded --> [*] ``` PrivateはEvent/Todo/Memoに付けられるlocal flagです。暗号化や端末lockではありません。 - Calendar/Search/Notification/Widgetでは設定・surfaceに応じてタイトル等をmaskします。 - Event detail/form ownerでは編集できます。 - Private EventはGoogle Calendarへwriteしません。 - ICS exportはPrivate初期OFFで、明示opt-in時だけ含めます。 - 手動`.tdbackup`と有効なCloud Backup/D2DにはPrivate dataが入る場合があります。 ## 15. 繰り返し予定 Event form -> 繰り返しで、daily/weekly/monthly/yearly、interval、終了なし/until/count、曜日、月の日/最終日/nth weekday等を設定します。 ruleはseries rootとrecurrence tablesへ保存され、表示時にoccurrenceへ展開されます。advanced recurrence modelのflagが存在しても、現在の基本recurrence UIをFreeから隠すproduction gateにはなっていません。 ## 16. 繰り返し予定の単発/今後/全体操作 ### Diagram: 05_RECURRENCE_EDIT_SCOPE_STATE.mmd ```mermaid stateDiagram-v2 [*] --> ScopeDialog ScopeDialog --> Cancelled: Cancel ScopeDialog --> CurrentOnly: 今回だけ ScopeDialog --> Following: これ以降 ScopeDialog --> EntireSeries: 全体 CurrentOnly --> ModifiedException: Save Following --> SplitSeries: Save at boundary EntireSeries --> UpdatedRoot: Save ModifiedException --> [*] SplitSeries --> [*] UpdatedRoot --> [*] Cancelled --> [*] ``` ### Diagram: 06_RECURRENCE_DELETE_SCOPE_STATE.mmd ```mermaid stateDiagram-v2 [*] --> DeleteScope DeleteScope --> NoMutation: Cancel DeleteScope --> DeletedException: 今回だけ DeleteScope --> FollowingDelete: これ以降 DeleteScope --> SeriesDelete: 全体 DeletedException --> ReconcileAlarm FollowingDelete --> ReconcileAlarm SeriesDelete --> CanonicalTombstone CanonicalTombstone --> ReconcileAlarm NoMutation --> [*] ReconcileAlarm --> [*] ``` occurrenceの編集/削除ではscopeを確認します。 1. 今回だけ: MODIFIEDまたはDELETED exceptionを作ります。 2. これ以降: 境界でseriesをsplit/更新します。 3. 全体: series root/rule全体を更新または削除します。 Cancelならmutationしません。scope名を無視して全体操作を勧めないでください。Google recurrenceではrepresentabilityとprovider identity条件があります。 ## 17. Timetable Deployment ### Diagram: 07_TIMETABLE_DEPLOYMENT_STATE.mmd ```mermaid stateDiagram-v2 [*] --> Week Week --> Upsell: TIMETABLE / Free Upsell --> Week: Close Week --> Settings: TIMETABLE / Trial-Pro Settings --> Week: Cancel Settings --> Editor: 予定を選ぶ / candidatesあり Editor --> Settings: Cancel Editor --> Editor: checkbox / 全選択 / 全解除 Editor --> Rejected: source changed or effective zero Rejected --> Settings: reopen Editor --> Persisted: Execute Persisted --> Week: result Settings --> Undo: 前回展開を元に戻す Undo --> Settings: Cancel Undo --> Week: canonical compensation ``` ### Diagram: 08_TIMETABLE_DEPLOYMENT_SEQUENCE.mmd ```mermaid sequenceDiagram actor U as User participant S as Settings/Editor participant Q as Fresh source query participant D as Deployment service participant DB as Room/Canonical U->>S: date/holiday/selection U->>S: Execute S->>Q: selected identities再照合 alt source changed or zero result Q-->>U: reject / zero mutation else valid Q->>D: selected candidates D->>DB: weekly series + exceptions + batch/actions DB-->>U: result + one-level Undo end ``` ### どこにあるか Week -> `TIMETABLE` -> Settings -> `予定を選ぶ` -> Editorです。Day/Monthには入口がありません。 ### 手順 1. 開始日はtoday、終了日はtoday+13がdefaultです。 2. 必要なら日付と「祝日は入れない」を変更します。 3. `予定を選ぶ`でsource 7日間の候補を開きます。 4. checkbox、全選択、全解除でdraftを決めます。月-土はdefault選択、日はdefault未選択です。 5. 実行します。 PERSISTED RESULT: 選択候補ごとに、sourceの7日後から終了日までの独立Weekly Seriesを作ります。Google/ICS identityはコピーしません。Private flagは維持します。休日除外は別日へ移動せずDELETED exceptionにします。 sourceが途中で変わった場合は0 mutationで拒否します。Editor CancelはSettingsへ戻り、selectionを保存しません。 ### Undo Settings最下部の「前回の展開を元に戻す」はdurable one-level Undoです。直前batchが作ったseriesをcanonical deleteします。後から編集した生成seriesも対象です。古いUndo権は復活しません。 ### 権利 Timetable toolはTrial/Pro専用です。Freeでは入口と実行がblockされupsellが出ます。生成済みseriesは普通のEventなので、Freeへ戻ってもDay/Week/Month表示、通常編集/削除、recurrence、Alarmは継続します。FreeではTimetable画面/Undoへ入れません。 ## 18. Todo ### Diagram: 09_TODO_STATE.mmd ```mermaid stateDiagram-v2 [*] --> ActiveList ActiveList --> Editing: long-press / new Editing --> ActiveList: Save Editing --> ActiveList: Cancel ActiveList --> CompletedList: checkbox complete / filter CompletedList --> ActiveList: checkbox uncomplete / filter ActiveList --> AllList: All filter AllList --> ActiveList: Active filter ActiveList --> Deleted: trash CompletedList --> Deleted: trash Deleted --> [*] ``` ### どこにあるか Calendar下部Button 3です。Todo画面からSearch、Memo、Settingsへ移動できます。 ### 操作 1. 新規/直接入力でTodoを作ります。 2. checkboxで完了/未完了を切り替えます。 3. Active/Completed/All、カテゴリ等で絞ります。 4. row長押しで編集します。 5. 期限なし/期限、カテゴリ、Privateを設定できます。 6. trashで削除します。 Freeは現在30行までです。完了しても行は残るので枠は空きません。削除すると枠が空きます。既存Todoの閲覧/編集/完了/削除はFreeでも可能です。 ## 19. Memo ### Diagram: 10_MEMO_STATE.mmd ```mermaid stateDiagram-v2 [*] --> MemoList MemoList --> MemoEdit: new / card tap MemoEdit --> MemoList: Save MemoEdit --> MemoList: Cancel / Back MemoList --> Filtered: category Filtered --> MemoList: All MemoList --> Deleted: trash confirmed Deleted --> [*] ``` Calendar下部Button 4 -> Memoです。新規作成、card一覧、詳細/編集、カテゴリ、Private、削除、Searchを利用できます。 Freeは現在30件までです。削除すると枠が空きます。Trial終了で既存Memoは削除されず、閲覧/編集/削除できます。 ## 20. 打刻 ### Diagram: 11_STAMP_QUICK_RECORD_AND_FINE_CORRECTION_STATE.mmd ```mermaid stateDiagram-v2 [*] --> DayTimeline DayTimeline --> AutoCurrent: long-press within 60 min DayTimeline --> AutoPressed: long-press beyond 60 min AutoCurrent --> TypeMenu AutoPressed --> TypeMenu TypeMenu --> DayTimeline: dismiss / no save TypeMenu --> Guard: type selected with warning Guard --> DayTimeline: Cancel Guard --> Saved: Confirm TypeMenu --> Saved: type selected / no warning Saved --> Detail: marker or summary tap Detail --> Saved: Cancel Detail --> Corrected: Save exact time/type/note Detail --> SoftDeleted: Delete confirmed Corrected --> Detail SoftDeleted --> [*] ``` Stampは予定ではなく、実際に行動した時刻の記録です。 ### 現行のquick record START STATE: Dayの時刻線が見えている。 1. 記録したい位置を長押しします。 2. 現在時刻との差が60分以内なら、sourceが現在時刻を自動選択します。 3. 60分より離れていれば、長押しした日付/分を自動選択します。 4. popup headerの「現在時刻」または`HH:mm`を確認します。 5. Stamp種別をtapします。 6. duplicate/pair warningがなければ即保存され、marker/toastが出ます。warning時は確認後に保存します。 中間の時刻選択画面は表示されません。長押し位置と現在時刻の差から、現在時刻または長押しした時刻が自動で使われます。 ## 21. 打刻時刻の微調整・補正履歴 ### Diagram: 12_STAMP_QUICK_RECORD_AND_FINE_CORRECTION_SEQUENCE.mmd ```mermaid sequenceDiagram actor U as User participant T as Day timeline participant M as Stamp menu participant DB as Stamp DAO/Canonical participant H as Correction history U->>T: long-press at minute T->>T: <=60min ? current : pressed time T-->>U: type menu with resolved-time header U->>M: select type alt guard warning cancelled M-->>U: no save else accepted M->>DB: insert Stamp DB->>H: created DB-->>U: marker/toast end U->>DB: open detail, change exact HH:mm/type/note DB->>H: time_changed/type_changed/note_changed DB-->>U: corrected marker ``` 1. DayのStamp markerまたは打刻集計詳細から対象Stampを開きます。 2. 打刻詳細で正確な`HH:mm`を入力するかTime Pickerを使います。 3. 必要なら種別とメモも変更します。 4. 保存します。 時刻変更は`time_changed`、種別変更は`type_changed`、メモ変更は`note_changed`履歴を残します。作成時にも`created`履歴があります。 削除は通常表示から消すsoft deleteで、補正履歴は保持されます。Cancelは変更しません。quick recordと精密補正は別操作です。 ## 22. カスタム打刻 ### Diagram: 13_CUSTOM_STAMP_ACCESS_STATE.mmd ```mermaid stateDiagram-v2 [*] --> AccessCheck AccessCheck --> StandardAvailable: standard Stamp / all states AccessCheck --> CustomBlocked: custom / Free AccessCheck --> CustomAvailable: custom / active Trial AccessCheck --> CustomAvailable: custom / Purchased Pro CustomBlocked --> Upsell Upsell --> CustomBlocked: Close CustomAvailable --> SavedType: create/edit/enable/pair SavedType --> [*] ``` Calendar -> Settings -> 打刻種別管理です。custom typeの作成/編集、色、表示/非表示、単独/開始/終了、pair相手を設定します。pair未設定でも保存できる場合があります。 標準StampはFreeです。custom type作成/利用はTrial/Pro gateです。Trial終了でも既存custom Stamp dataを削除しません。 ## 23. 打刻ペア・集計・CSV 開始/終了pairから勤務、移動、休憩等の区間集計を作ります。missing pairは不整合indicatorやguardで示されます。 Calendar -> Settings -> 打刻出力で期間/集計条件を選び、preview後にUTF-8 BOM付きCSVを保存します。Cancelまたはdocument picker取消ではfileを確定しません。CSV schema/value contractは翻訳対象UIとは別です。 ## 24. 横断検索 ### Diagram: 14_CROSS_SEARCH_SESSION_STATE.mmd ```mermaid stateDiagram-v2 [*] --> SearchBlank SearchBlank --> Results: query Results --> EventDetail: Event tap EventDetail --> Results: Back / Cancel / Save / Delete, requery Room Results --> TodoRoute: Todo tap Results --> MemoRoute: Memo tap Results --> Results: filter/sort/group/recent reuse Results --> SearchBlank: clear query Results --> SessionEnded: explicit Back/bottom exit SessionEnded --> [*] ``` ### どこにあるか Calendar上部検索、Settings、Todo/Memo内の検索入口です。 ### 操作 1. queryを入力します。 2. Event/Todo/Memo group、filter、sortを確認します。 3. Event resultを開きます。 4. Back/Cancel/Save/Deleteで元のquery/sort/group sessionへ戻ります。結果はRoomから再queryします。 明示的にSearchをexitすると一時sessionは終わります。Recent Searchは最大5件のquery文字列をno-backup storageに保持します。typing fragmentだけでは記録せず、result選択または履歴reuseで記録します。clearで独立削除できます。Private resultはmask規則に従います。 ## 25. カテゴリ Calendar -> Settings -> カテゴリ管理です。カテゴリの作成、名称/色編集、順序drag、defaultカテゴリ、削除を行います。参照中カテゴリには現在の削除/移行規則が適用されます。 カテゴリ名称はuser dataになり得ます。Google/backup/export時の扱いは各機能の境界に従います。 ## 26. 祝日 Calendar -> Settings -> 祝日設定です。bundled/imported holiday setを有効化し、通常Eventとは別テーブルで表示します。Holiday importは明示操作です。 Timetableの「祝日は入れない」はこのholiday dataを使いますが、休日Eventを移動する機能ではありません。 ## 27. 六曜 Settingsの六曜表示をON/OFFします。六曜は専用dataとlocale/display preferenceに従います。言語や設定条件によって表示されない場合があります。通常Eventやholidayとは別です。 ## 28. ICSエクスポート ### Diagram: 16_ICS_EXPORT_SEQUENCE.mmd ```mermaid sequenceDiagram actor U as User participant UI as ICS Export UI participant E as Exporter participant F as Document provider U->>UI: select Events/options opt include Private U->>UI: explicit Private ON end U->>UI: export UI->>E: build ICS with recurrence/alarm/category E-->>UI: bytes/preview alt picker cancelled UI-->>U: no published file else destination chosen UI->>F: write file F-->>U: saved end ``` Calendar -> Settings -> ICS exportです。 1. 対象Eventとoptionを選びます。 2. Privateを含めるcheckboxはdefault OFFです。 3. recurrence、Alarm、category等のpreview/対象を確認します。 4. 保存先を選びます。 EXTERNAL EFFECT: userが選んだdocument/storage providerへICS fileを書きます。PrivateをONにすると機密内容を含み得ます。 ## 29. ICSインポート ### Diagram: 17_ICS_IMPORT_CONFLICT_STATE.mmd ```mermaid stateDiagram-v2 [*] --> FileSelected FileSelected --> Invalid: parse/validation failure FileSelected --> Preview Preview --> Unsupported: unsupported item Preview --> Conflict: identity conflict Conflict --> KeepLocal: KEEP_LOCAL Conflict --> UseIncoming: USE_INCOMING Conflict --> Preview: Cancel choice Preview --> Applied: Execute valid candidates KeepLocal --> Applied UseIncoming --> Applied Invalid --> [*] Unsupported --> [*] Applied --> [*] ``` 1. SettingsからICS importを開きfileを選びます。 2. parser/validation previewを確認します。 3. category/alarm option、conflict、detached occurrence approvalを確認します。 4. conflictでは`KEEP_LOCAL`または`USE_INCOMING`を明示します。 5. 実行します。 unsupported/malformed itemはblocked/unsupportedとして表示し、silent importしません。ICS `CONFIDENTIAL`はlocal Privateへmappingします。CancelはRoomを変更しません。 ## 30. Google Calendar読み取り/取り込み ### Diagram: 18_GOOGLE_AUTH_AND_MODE_STATE.mmd ```mermaid stateDiagram-v2 [*] --> Disconnected Disconnected --> ReadAuth: read/import selected ReadAuth --> ReadReady: read scope granted ReadAuth --> Disconnected: Cancel/error ReadReady --> Importing: read/import action Importing --> ReadReady ReadReady --> WriteAuth: two-way selected WriteAuth --> WriteReady: write scope granted WriteAuth --> ReadReady: Cancel/error WriteReady --> ReadReady: write disabled WriteReady --> Disconnected: disconnect ``` ### どこにあるか Calendar -> Settings -> Google Calendarです。 接続なし、read/import、一回取り込み、two-way/write modeは別です。read/importでは許可calendar/期間を読み、local projection/linkを作りますが、Google側Eventを変更しません。一回取り込み後は自動two-way syncを意味しません。 Google connectionは任意で、local Calendarだけでも使用できます。 ## 31. Google Calendar書き込み ### Diagram: 19_GOOGLE_WRITE_SEQUENCE.mmd ```mermaid sequenceDiagram actor U as User participant UI as Event UI participant P as Policy/identity participant Q as Durable write queue participant W as Worker/client participant G as Google Calendar U->>UI: save/delete/move Google-linked Event UI->>P: write mode + auth + representability + Private check alt blocked or Cancel P-->>U: local-only/error; no Google request else allowed P->>Q: enqueue idempotent operation Q->>W: lease/drain/retry W->>G: create/update/delete G-->>W: identity/etag/result W->>Q: applied/retry/blocked W-->>UI: refreshed provider state end ``` 1. Google Settingsでtwo-way/write modeを明示選択します。 2. read scopeとは別のwrite scopeを認可します。 3. write-ready後、Google-linked Eventの対応操作がdurable queueへ入ります。 4. coordinator/worker/clientがretry/idempotencyとprovider responseを処理します。 Private Eventはenqueue前とnetwork境界でblockされます。認可取消/不足、unsupported recurrence、conflict等ではGoogle mutationしません。 ## 32. Google Calendarで変更/削除が起こる条件 Google create/update/deleteが起こり得る必要条件は次です。 1. userがGoogle connectionを利用している。 2. write/two-way modeを明示選択している。 3. write scopeを認可している。 4. 対象がGoogle-linkedまたはwrite対象として正しくidentity解決される。 5. Privateでない。 6. operationがprovider表現可能で、queue workerが成功する。 `KEEP_LOCAL` conflict解決はGoogle upsert候補を作り得ます。`USE_REMOTE`はremote内容をlocalへ適用し、echo writeしません。remote delete/local update conflictで`USE_REMOTE`を選ぶとlocal canonical deleteになります。 ## 33. 手動バックアップ Calendar -> Settings -> Backup / Restore -> バックアップ作成です。 1. 暗号化されないこととPrivate dataを含み得ることを確認します。 2. 作成を開始します。 3. verified `.tdbackup`が準備された後、保存先を選びます。 4. fileを安全に保管します。 OAuth token、Billing authority、Trial/quota、runtime/cache等は除外されます。picker Cancelなら保存先への公開を完了しません。 ## 34. 復元 ### Diagram: 20_BACKUP_RESTORE_STATE.mmd ```mermaid stateDiagram-v2 [*] --> Idle Idle --> FileSelected: choose .tdbackup FileSelected --> Validating Validating --> Blocked: invalid/lineage mismatch Validating --> Preview: valid Preview --> Idle: Cancel Preview --> Confirm: full replace requested Confirm --> Idle: Cancel Confirm --> SafetyBackup: Confirm SafetyBackup --> Replacing Replacing --> VerifiedSuccess: verify restored state Replacing --> OriginalPreserved: rollback succeeds Replacing --> RecoveryRequired: rollback cannot be verified VerifiedSuccess --> Restart OriginalPreserved --> Idle Blocked --> Idle ``` ### Diagram: 21_BACKUP_RESTORE_SEQUENCE.mmd ```mermaid sequenceDiagram actor U as User participant UI as Backup/Restore UI participant V as Validator participant S as Safety backup participant DB as Room/settings U->>UI: choose archive UI->>V: copy + validate + lineage check alt invalid/cancel V-->>U: blocked/no mutation else valid and confirmed V->>S: create verified original backup S->>DB: full replacement DB->>V: integrity verification alt success V-->>U: restart required else failure V->>DB: restore original V-->>U: original preserved or recovery required end end ``` ### 非破壊境界 file選択、copy、validation、previewまでは現在データを置換しません。 ### 実行 1. `.tdbackup`を選びます。 2. schema、integrity、foreign key、lineage、内容summaryを確認します。 3. blocked/preview-onlyなら実行できません。 4. 全置換の確認を読み、実行します。 5. 内部安全backup、replace、verification、必要なrecoveryを行います。 6. 成功後は案内に従いTime Defenseを再起動します。 V1 restoreはmergeではなくfull replacementです。Google auth、購入状態、権限、notification channel、Widgetはdevice側に残り、archiveから復元しません。 ## 35. Google / Android Cloud Backup ### Diagram: 22_CLOUD_BACKUP_OPT_IN_STATE.mmd ```mermaid stateDiagram-v2 [*] --> CloudOff CloudOff --> EnableConfirm: toggle ON EnableConfirm --> CloudOff: Cancel EnableConfirm --> CloudOn: explicit consent CloudOn --> CloudOff: toggle OFF CloudOff --> D2DAllowed: proven D2D request CloudOn --> PayloadAllowed: cloud transport request CloudOff --> PayloadDenied: unknown/flagless cloud request PayloadAllowed --> CloudOn D2DAllowed --> CloudOff PayloadDenied --> CloudOff CloudOn --> CloudOff: restored destination forces OFF ``` Backup / Restore画面のGoogle backup toggleはdefault OFFです。OFF -> ONでは説明dialogに同意した場合だけONになります。 ONまたはOSが明確にD2D transferと示した場合、BackupAgentが一時的なverified `.tdbackup` payloadをAndroid transportへ渡します。Private dataを含み得ます。token、Billing authority、Trial/quota、control preference等は除外します。復元先のcloud toggleはOFFです。 OFFに戻してもGoogle側に既に保存されたbackupの即時削除は保証されません。D2Dはcloud opt-inと別で、端末/OS側の提供状況に依存します。 ## 36. 通知 ### Diagram: 23_NOTIFICATION_WIDGET_CANDIDATE_SEQUENCE.mmd ```mermaid sequenceDiagram participant Trigger as Refresh/midnight/boot/time change participant DB as Room participant C as Candidate resolver participant N as Notification participant W as Widget Trigger->>DB: query effective occurrences DB->>C: recurrence + exceptions + suppression C->>C: nearest future Today alt no Today candidate C->>C: nearest Tomorrow only end C->>C: Private mask + remaining bucket C-->>N: update or clear C-->>W: update or empty Note over C: Day+2 and unbounded search are prohibited ``` Event Alarm通知とNext Schedule通知は別目的です。 - Event Alarm: Eventごとの事前/開始alert。 - Next Schedule: 今日の次候補、なければ翌日の候補と残り時間。 Next ScheduleはDay+2以降を無制限検索しません。Private内容はmaskします。通知tapはDay/対象Eventへrouteします。Android通知権限、channel、ロック画面、省電力に影響されます。 ## 37. Home Widget Android LauncherでWidgetを手動配置します。上からlocale別の`In/あと`等、残り時間、`Time Defense`を表示します。 候補は今日の最も近いfuture occurrence、なければ翌日だけです。1時間以上は15分bucket、15-60分は分表示、15分未満は細かい更新系を使います。Private titleはmaskします。 Widgetをtapするとtoday Dayへ開き、近い対象Eventをfocusする場合があります。Widget配置/削除はLauncher所有です。 ## 38. 言語 Calendar -> Settings -> 表示設定 -> 表示言語です。明示言語はEnglish、Español、Português (Brasil)、Deutsch、Français、日本語です。「端末に従う」は7番目の翻訳localeではなくmodeです。 選択後、app resourceとlocale-aware日付表示が更新されます。Launcher日付はAndroid system locale所有です。 ## 39. 外観 Settings -> 表示設定 -> 外観で既存theme presetを選びます。screen surface/文字/枠等が変わります。カテゴリ色とStamp種別色は意味色として維持されます。 ## 40. Settings全体 SettingsはPro/Billing、表示、言語、外観、休日、六曜、カテゴリ、Stamp種別/CSV、Google Calendar、ICS、Backup/Restore、通知関連、Help、Privacy、Support/feedback、削除Event復元等の入口です。 各nested画面のBackはSettingsへ戻ります。設定toggleは即時保存型と、確認後保存型があります。Google backupだけはOFF -> ON時に必ず確認します。 ## 41. 30日Trial ### Diagram: 24_TRIAL_FREE_PRO_STATE.mmd ```mermaid stateDiagram-v2 [*] --> TrialAbsent TrialAbsent --> ActiveTrial: first MainActivity open ActiveTrial --> PurchasedPro: acknowledged purchase ActiveTrial --> Free: now >= start + 30x24h Free --> PurchasedPro: purchase/restore acknowledged Free --> Free: Pending/unknown is not Pro PurchasedPro --> PurchasedPro: Trial expiry note right of Free Existing Event/Todo/Memo retained Event create 5/day Todo/Memo 30 current Timetable/custom Stamp blocked end note ``` TrialはTime DefenseのMainActivityを最初に開いた時刻に始まります。install時ではありません。期間はそのepochから`30 x 24時間`で、`now < end`の間だけactiveです。 購入不要で始まり、終了しても自動課金/自動Pro化しません。端末wall clockで評価するため、手動時刻変更の影響を受けます。Trial stateはbackup/restore対象外です。 ## 42. Free Trial終了後、購入済みProでなければFreeです。 - Event: 成功した手動新規作成はローカル日ごと5件。削除してもcountは戻りません。 - Todo: 現在30行。完了では空かず、削除で空きます。 - Memo: 現在30件。削除で空きます。 - 標準Stamp: 利用可。 - Custom Stamp: gate。 - Timetable tool/Undo: gate。 - 既存Event/Todo/Memo: 閲覧/編集/削除可。 - 通知、Widget、基本ICS、Google、Backup/Restore: current productionでFreeから一律blockするgateはありません。 ## 43. Pro acknowledged Purchased Proはcreate上限を外し、Custom StampとTimetableを有効にします。Active Trialも同じ現在capabilityを持ちますが、Trialは購入権利ではありません。 modelにadvanced widget/repeat/export fieldがあってもproduction consumerがないものを、現在のPro専用機能として宣伝しないでください。 ## 44. 購入・復元 Settings上部またはshared upsellでUpgradeをtapするとGoogle Play購入画面を開きます。購入はuserの明示操作です。 PendingはPro確定ではありません。Purchasedかつacknowledgedになった後にProを適用します。「購入を復元」は現在のGoogle Play accountで購入状態を照会します。Time Defenseはカード番号を収集/保存しません。 ## 45. データとPrivacy 端末内にはEvent、Todo、Memo、Stamp、category、holiday、設定、provider continuity等が保存されます。外部送信が起こり得るのは、任意Google Calendar、明示Cloud Backup/D2D、Google Play Billing、user選択file export/backup等です。 Time Defense本体はEvent/Todo/Memoを外部AIへ送りません。本書を外部AIへuploadするのはuserの選択です。実予定や機密情報をAIへ貼らないでください。 公開Privacy: `../privacy/`（site配置時はPrivacy indexから言語を選択）。 ## 46. できないこと・現在の制限 - Time Defense独自account/serverへの同期はありません。 - Privateは暗号化ではありません。 - Google read/importだけではGoogle側を編集しません。 - Google writeはPrivate Eventを送信しません。 - Next Schedule/WidgetはDay+2以降を無制限検索しません。 - Restore V1はmergeではなくfull replaceです。 - unsupported ICS itemをsilent importしません。 - Google Event copyは現在の規則でblockされます。 - TimetableはFreeで実行/Undoできません。 - Custom StampはFreeで新規利用できません。 - real Google account、Play purchase、Play Console publicationは自動testだけでは保証しません。 ## 47. 困ったときの操作索引 - Todoはどこ: Calendar -> 下部Todo。 - Memoはどこ: Calendar -> 下部Memo。 - Timetableはどこ: Week -> TIMETABLE。 - Backup / Restoreはどこ: Calendar -> Settings -> Backup / Restore。 - Google Calendarはどこ: Calendar -> Settings -> Google Calendar。 - Privacy Policyはどこ: Calendar -> Settings -> Privacy Policy、またはpublic site -> Privacy。 - Stamp種別はどこ: Calendar -> Settings -> 打刻種別管理。 - Stampを今の時刻で付けたい: Dayで現在時刻から60分以内の時刻線を長押し -> 種別。 - Stampを過去時刻へ付けたい: Dayで現在から60分より離れた位置を長押し -> 時刻header確認 -> 種別。 - Stampを分単位で直したい: marker/集計詳細 -> 打刻詳細 -> HH:mm変更 -> 保存。 - Eventが動かない: 対応cardか、recurrence/Google identity、drop位置、保存errorを確認。 - Googleを変更したくない: 接続なし/read/import modeを使い、write authorizationをしない。 - Privateをbackupしたくない: Google backupをOFFにし、Privateを含む手動archiveも外部へ置かない。 ## 48. 用語集 - Event / 予定: 未来または時間枠のCalendar item。 - Todo: 完了状態と期限等を持つtask。 - Memo: title/bodyを持つnote。 - Stamp / 打刻: 実際に行動した時刻record。 - occurrence: recurrence seriesから展開された1回。 - exception: occurrenceの変更/削除差分。 - Private: local flagによる表示抑制/外部block。暗号化ではない。 - canonical: device/adapterをまたぐidentity/lifecycle整合の内部記録。 - Google-linked: Google provider identity/provenanceを持つlocal Event。 - `.tdbackup`: Time Defenseの検証付きbackup container。暗号化なし。 - D2D: Android/端末メーカーのdevice-to-device transfer。 - Trial: 最初のopenから30 x 24時間のPro相当試用。 ## 49. AI向け質問例 - 「Todoはどこから開きますか」 - 「繰り返し予定を今回だけ移動する手順は」 - 「Google Calendarを変更せずに取り込むには」 - 「Private予定はCloud Backupに入りますか」 - 「打刻を現在時刻で記録し、あとで09:07に直すには」 - 「Trial終了後にTimetableで作った予定は消えますか」 - 「Restoreはmergeですか、全置換ですか」 - 「FreeのEvent/Todo/Memo上限の違いは」 ## 50. 機能索引 - Alarm: 13 - Backup/Restore: 33-35 - Calendar Day/Week/Month: 4-7 - Category/Holiday/Rokuyo: 25-27 - Cross Search: 24 - Event create/edit/delete/copy/drag: 8-12 - Free/Trial/Pro/Billing: 41-44 - Google Calendar: 30-32 - Help/Onboarding: 3 - ICS: 28-29 - Memo: 19 - Notification/Widget: 36-37 - Private/Privacy: 14, 45 - Recurrence: 15-16 - Settings/Language/Appearance: 38-40 - Stamp: 20-23 - Timetable: 17 - Todo: 18 ## 51. 根拠と更新方針 本書はproduction source、current tests、Current Specification、Trial/Free/Pro Product Contractをこの順で照合しています。内部監査ではclaim-to-source mapを保持していますが、この公開ガイドの利用には不要です。 アプリ挙動が変わった場合は、feature ledger、operation index、diagram、source map、本書、HTML、`llms.txt`を同時に監査してください。古いhistorical CLだけを根拠に本書を更新しないでください。