# valker/intime architecture

> Architecture diagram of the GitHub repository valker/intime, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/valker/intime
- Repository: https://github.com/valker/intime

## Overview

InTime is an Android app for managing recurring reminders. Users create or edit interval-based tasks, view them sorted by due time, acknowledge or delete them, and receive overdue notifications; SQLite persists task schedules. The README also documents JSON export from Settings. The map separates task interaction, persistence, and alarm/notification behavior. Source excerpts establish the main UI, scheduling, and database calls; export is documented, but its implementation details were not sampled.

Main entry points: [`app/src/main/java/com/vpe_soft/intime/intime/database/DatabaseUtil.java`](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/database/DatabaseUtil.java) (Task database), [`app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java`](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java) (Task list), [`app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmUtil.java`](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmUtil.java) (Alarm scheduler), [`app/src/main/java/com/vpe_soft/intime/intime/activity/SettingsActivity.java`](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/activity/SettingsActivity.java) (Settings and export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Task interface"]
  node_main["Task list<br/>[MainActivity.java]"]
  node_task_form["Task editor"]
  node_task_view["Task cards"]
  node_task_dialog["Task actions"]
end

subgraph group_data["Task data"]
  node_task["Task model<br/>[Task.java]"]
  node_task_state["Undo state<br/>[TaskState.java]"]
  node_db["Task database<br/>[DatabaseUtil.java]"]
  node_schema[("SQLite schema")]
  node_one_task["Task operations<br/>[OneTask.java]"]
end

subgraph group_alerts["Reminder scheduling"]
  node_alarm_util["Alarm scheduler<br/>[AlarmUtil.java]"]
  node_alarm_receiver["Alarm handler<br/>[AlarmReceiver.java]"]
  node_ack_receiver["Notification acknowledge<br/>[AckReceiver.java]"]
  node_boot["Boot recovery<br/>[BootReceiver.java]"]
end

subgraph group_settings["Settings and backup"]
  node_settings["Settings and export"]
end

node_user(("User"))
node_android_alarm["Android alarm service"]
node_notifications["Android notifications"]
node_json_file["JSON backup file"]
node_file_picker["System file picker"]

node_user -->|"opens"| node_main
node_main -->|"loads tasks"| node_db
node_main -->|"displays"| node_task_view
node_task_view -->|"formats due time"| node_alarm_util
node_user -->|"creates or edits"| node_task_form
node_task_form -->|"saves task"| node_db
node_task_form -->|"calculates due time"| node_alarm_util
node_main -.->|"offers actions"| node_task_dialog
node_main -->|"acknowledges"| node_one_task
node_main -->|"deletes task"| node_db
node_one_task -->|"updates schedule"| node_db
node_one_task -->|"reschedules"| node_alarm_util
node_db -.->|"opens database"| node_schema
node_db -.->|"reads and writes"| node_task
node_db -->|"captures prior state"| node_task_state
node_alarm_util -->|"queries due tasks"| node_db
node_alarm_util -->|"schedules"| node_android_alarm
node_android_alarm -.->|"dispatches"| node_alarm_receiver
node_alarm_receiver -->|"posts alert"| node_notifications
node_ack_receiver -->|"acknowledges"| node_one_task
node_boot -->|"restores alarms"| node_alarm_util
node_user -->|"opens settings"| node_settings
node_settings -->|"exports task data"| node_db
node_settings -->|"chooses destination"| node_file_picker
node_settings -->|"writes JSON backup"| node_json_file
node_file_picker -->|"selects path"| node_json_file

click node_main "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java"
click node_task_form "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/activity/NewTaskActivity.java"
click node_task_view "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/recyclerview/TaskRecyclerViewAdapter.java"
click node_task_dialog "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/view/ManageDialogView.java"
click node_task "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/database/Task.java"
click node_task_state "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/database/TaskState.java"
click node_db "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/database/DatabaseUtil.java"
click node_schema "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/database/InTimeOpenHelper.java"
click node_one_task "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/OneTask.java"
click node_alarm_util "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmUtil.java"
click node_alarm_receiver "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmReceiver.java"
click node_ack_receiver "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/receiver/AckReceiver.java"
click node_boot "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/receiver/BootReceiver.java"
click node_settings "https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/activity/SettingsActivity.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_task_form,node_task_view,node_task_dialog,node_user toneBlue
class node_task,node_task_state,node_db,node_schema,node_one_task toneAmber
class node_alarm_util,node_alarm_receiver,node_ack_receiver,node_boot toneMint
class node_settings toneRose
class node_android_alarm,node_notifications,node_json_file,node_file_picker toneIndigo
```

## Components

### Task interface

- [Task list](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java): `app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java`
- [Task editor](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/activity/NewTaskActivity.java): `app/src/main/java/com/vpe_soft/intime/intime/activity/NewTaskActivity.java`
- [Task cards](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/recyclerview/TaskRecyclerViewAdapter.java): `app/src/main/java/com/vpe_soft/intime/intime/recyclerview/TaskRecyclerViewAdapter.java`
- [Task actions](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/view/ManageDialogView.java): `app/src/main/java/com/vpe_soft/intime/intime/view/ManageDialogView.java`

### Task data

- [Task model](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/database/Task.java): `app/src/main/java/com/vpe_soft/intime/intime/database/Task.java`
- [Undo state](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/database/TaskState.java): `app/src/main/java/com/vpe_soft/intime/intime/database/TaskState.java`
- [Task database](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/database/DatabaseUtil.java): `app/src/main/java/com/vpe_soft/intime/intime/database/DatabaseUtil.java`
- [SQLite schema](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/database/InTimeOpenHelper.java): `app/src/main/java/com/vpe_soft/intime/intime/database/InTimeOpenHelper.java`
- [Task operations](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/OneTask.java): `app/src/main/java/com/vpe_soft/intime/intime/OneTask.java`

### Reminder scheduling

- [Alarm scheduler](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmUtil.java): `app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmUtil.java`
- [Alarm handler](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmReceiver.java): `app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmReceiver.java`
- [Notification acknowledge](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/receiver/AckReceiver.java): `app/src/main/java/com/vpe_soft/intime/intime/receiver/AckReceiver.java`
- [Boot recovery](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/receiver/BootReceiver.java): `app/src/main/java/com/vpe_soft/intime/intime/receiver/BootReceiver.java`

### Settings and backup

- [Settings and export](https://github.com/valker/intime/blob/master/app/src/main/java/com/vpe_soft/intime/intime/activity/SettingsActivity.java): `app/src/main/java/com/vpe_soft/intime/intime/activity/SettingsActivity.java`

### Other components

- **User**
- **Android alarm service**
- **Android notifications**
- **JSON backup file**
- **System file picker**

## Connections

- User → Task list: opens (evidence: `README.md`)
- Task list → Task database: loads tasks (evidence: `app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java`)
- Task list → Task cards: displays (evidence: `app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java`)
- Task cards → Alarm scheduler: formats due time (evidence: `app/src/main/java/com/vpe_soft/intime/intime/recyclerview/TaskRecyclerViewAdapter.java`)
- User → Task editor: creates or edits (evidence: `app/src/main/java/com/vpe_soft/intime/intime/activity/NewTaskActivity.java`)
- Task editor → Task database: saves task (evidence: `app/src/main/java/com/vpe_soft/intime/intime/activity/NewTaskActivity.java`)
- Task editor → Alarm scheduler: calculates due time (evidence: `app/src/main/java/com/vpe_soft/intime/intime/activity/NewTaskActivity.java`)
- Task list → Task actions: offers actions (evidence: `app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java`)
- Task list → Task operations: acknowledges (evidence: `app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java`)
- Task list → Task database: deletes task (evidence: `app/src/main/java/com/vpe_soft/intime/intime/activity/MainActivity.java`)
- Task operations → Task database: updates schedule (evidence: `app/src/main/java/com/vpe_soft/intime/intime/OneTask.java`)
- Task operations → Alarm scheduler: reschedules (evidence: `app/src/main/java/com/vpe_soft/intime/intime/OneTask.java`)
- Task database → SQLite schema: opens database (evidence: `app/src/main/java/com/vpe_soft/intime/intime/database/DatabaseUtil.java`)
- Task database → Task model: reads and writes (evidence: `app/src/main/java/com/vpe_soft/intime/intime/database/DatabaseUtil.java`)
- Task database → Undo state: captures prior state (evidence: `app/src/main/java/com/vpe_soft/intime/intime/database/DatabaseUtil.java`)
- Alarm scheduler → Task database: queries due tasks (evidence: `app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmUtil.java`)
- Alarm scheduler → Android alarm service: schedules (evidence: `app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmUtil.java`)
- Android alarm service → Alarm handler: dispatches
- Alarm handler → Android notifications: posts alert (evidence: `app/src/main/java/com/vpe_soft/intime/intime/receiver/AlarmReceiver.java`)
- Notification acknowledge → Task operations: acknowledges (evidence: `app/src/main/java/com/vpe_soft/intime/intime/receiver/AckReceiver.java`)
- Boot recovery → Alarm scheduler: restores alarms (evidence: `app/src/main/java/com/vpe_soft/intime/intime/receiver/BootReceiver.java`)
- User → Settings and export: opens settings (evidence: `README.md`)
- Settings and export → Task database: exports task data (evidence: `README.md`)
- Settings and export → System file picker: chooses destination (evidence: `README.md`)
- Settings and export → JSON backup file: writes JSON backup (evidence: `README.md`)
- System file picker → JSON backup file: selects path (evidence: `README.md`)
