# migawari0202-cpu/homemascotforge architecture

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

- Interactive diagram: https://gitdiagram.com/migawari0202-cpu/homemascotforge
- Repository: https://github.com/migawari0202-cpu/homemascotforge

## Overview

HomeMascot is an Android home-screen mascot widget combining character-driven speech and visuals with time, weather, battery, and memos; it also provides clock mode and character installation. The documented user flow is adding the widget, selecting or installing a character, and viewing or interacting with its changing information. README statements support the main feature branches; sampled code confirms memo persistence and battery-update handling. Most UI, character, weather, and widget orchestration files were not sampled, so those links are documented or left unverified rather than presented as inspected calls.

Main entry points: [`app/src/main/java/com/example/mascotforge/character/DynamicCharacter.kt`](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/character/DynamicCharacter.kt) (Character runtime), [`app/src/main/java/widget/database/MemoRepository.kt`](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoRepository.kt) (Memo repository), [`app/src/main/java/com/example/mascotforge/widget/TimeWidgetProvider.kt`](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/widget/TimeWidgetProvider.kt) (Home widget), [`app/src/main/java/widget/database/MemoDao.kt`](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoDao.kt) (Memo DAO)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_widget["Widget and clock"]
  node_home_widget["Home widget"]
  node_widget_update["Widget updates"]
  node_widget_schedule["Update scheduling"]
  node_clock["Clock mode<br/>[ClockActivity.kt]"]
end

subgraph group_character["Character runtime"]
  node_character_select["Character selection"]
  node_character_manager["Character management"]
  node_character_runtime["Character runtime"]
  node_speech["Speech rules<br/>[SpeechManager.kt]"]
  node_speech_parser["Speech parsing<br/>[Tagparser.kt]"]
  node_character_assets["Built-in character<br/>[character.json]"]
end

subgraph group_install["Character installation"]
  node_install_ui["Install screen"]
  node_install_flow["Character installer"]
  node_zip_validate["ZIP validation"]
  node_editor["Character editor"]
end

subgraph group_services["Data and services"]
  node_weather["Weather service"]
  node_weather_worker["Weather refresh"]
  node_battery["Battery cache<br/>[BatteryManager.kt]"]
  node_battery_receiver["Battery receiver<br/>[BatteryReceiver.kt]"]
  node_memo_ui["Memo screens"]
  node_memo_cache["Memo cache<br/>[MemoCache.kt]"]
  node_memo_repo["Memo repository<br/>[MemoRepository.kt]"]
  node_memo_dao["Memo DAO<br/>[MemoDao.kt]"]
  node_memo_db[("Memo database<br/>[MemoDatabase.kt]")]
  node_memo_entity["Memo records<br/>[MemoEntity.kt]"]
end

node_user(("Android user"))

node_user -->|"adds and views"| node_home_widget
node_user -->|"selects character"| node_character_select
node_user -->|"opens character ZIP"| node_install_ui
node_user -->|"opens clock mode"| node_clock
node_home_widget -.->|"requests updates"| node_widget_update
node_widget_schedule -.->|"schedules refresh"| node_widget_update
node_character_select -.->|"chooses character"| node_character_manager
node_character_manager -.->|"loads character"| node_character_runtime
node_character_runtime -.->|"reads assets"| node_character_assets
node_character_runtime -.->|"evaluates speech"| node_speech
node_speech -.->|"parses tags"| node_speech_parser
node_install_ui -.->|"starts install"| node_install_flow
node_install_flow -.->|"validates archive"| node_zip_validate
node_editor -->|"creates character"| node_user
node_weather_worker -.->|"fetches weather"| node_weather
node_battery_receiver -->|"updates cache"| node_battery
node_battery_receiver -->|"requests refresh"| node_home_widget
node_memo_ui -.->|"manages memos"| node_memo_cache
node_memo_cache -->|"delegates memo access"| node_memo_repo
node_memo_repo -->|"opens database"| node_memo_db
node_memo_db -->|"provides DAO"| node_memo_dao
node_memo_repo -->|"reads and writes"| node_memo_dao
node_memo_dao -->|"queries records"| node_memo_entity

click node_home_widget "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/widget/TimeWidgetProvider.kt"
click node_widget_update "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/widget/WidgetUpdateCoordinator.kt"
click node_widget_schedule "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/widget/WidgetUpdateScheduler.kt"
click node_clock "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/ClockActivity.kt"
click node_character_select "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/CharacterSelectorActivity.kt"
click node_character_manager "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/CharacterManager.kt"
click node_character_runtime "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/character/DynamicCharacter.kt"
click node_speech "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/SpeechManager.kt"
click node_speech_parser "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/speech/Tagparser.kt"
click node_character_assets "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/assets/characters/default_character/character.json"
click node_install_ui "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/ui/theme/components/CharacterInstallActivity.kt"
click node_install_flow "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/installer/CharacterInstaller.kt"
click node_zip_validate "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/installer/ZipSecurityValidator.kt"
click node_editor "https://github.com/migawari0202-cpu/homemascotforge/blob/main/HomeMascotForge-editor.html"
click node_weather "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/weather/WeatherRepository.kt"
click node_weather_worker "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/WeatherUpdateWorker.kt"
click node_battery "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/cache/BatteryManager.kt"
click node_battery_receiver "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/cache/BatteryReceiver.kt"
click node_memo_ui "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/MemoInputActivity.kt"
click node_memo_cache "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/cache/MemoCache.kt"
click node_memo_repo "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoRepository.kt"
click node_memo_dao "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoDao.kt"
click node_memo_db "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoDatabase.kt"
click node_memo_entity "https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoEntity.kt"

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_home_widget,node_widget_update,node_widget_schedule,node_clock,node_user toneBlue
class node_character_select,node_character_manager,node_character_runtime,node_speech,node_speech_parser,node_character_assets toneAmber
class node_install_ui,node_install_flow,node_zip_validate,node_editor toneMint
class node_weather,node_weather_worker,node_battery,node_battery_receiver,node_memo_ui,node_memo_cache,node_memo_repo,node_memo_dao,node_memo_db,node_memo_entity toneRose
```

## Components

### Widget and clock

- [Home widget](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/widget/TimeWidgetProvider.kt): `app/src/main/java/com/example/mascotforge/widget/TimeWidgetProvider.kt`
- [Widget updates](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/widget/WidgetUpdateCoordinator.kt): `app/src/main/java/com/example/mascotforge/widget/WidgetUpdateCoordinator.kt`
- [Update scheduling](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/widget/WidgetUpdateScheduler.kt): `app/src/main/java/com/example/mascotforge/widget/WidgetUpdateScheduler.kt`
- [Clock mode](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/ClockActivity.kt): `app/src/main/java/com/example/mascotforge/ClockActivity.kt`

### Character runtime

- [Character selection](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/CharacterSelectorActivity.kt): `app/src/main/java/com/example/mascotforge/CharacterSelectorActivity.kt`
- [Character management](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/CharacterManager.kt): `app/src/main/java/com/example/mascotforge/CharacterManager.kt`
- [Character runtime](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/character/DynamicCharacter.kt): `app/src/main/java/com/example/mascotforge/character/DynamicCharacter.kt`
- [Speech rules](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/SpeechManager.kt): `app/src/main/java/com/example/mascotforge/SpeechManager.kt`
- [Speech parsing](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/speech/Tagparser.kt): `app/src/main/java/com/example/mascotforge/speech/Tagparser.kt`
- [Built-in character](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/assets/characters/default_character/character.json): `app/src/main/assets/characters/default_character/character.json`

### Character installation

- [Install screen](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/ui/theme/components/CharacterInstallActivity.kt): `app/src/main/java/com/example/mascotforge/ui/theme/components/CharacterInstallActivity.kt`
- [Character installer](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/installer/CharacterInstaller.kt): `app/src/main/java/com/example/mascotforge/installer/CharacterInstaller.kt`
- [ZIP validation](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/installer/ZipSecurityValidator.kt): `app/src/main/java/com/example/mascotforge/installer/ZipSecurityValidator.kt`
- [Character editor](https://github.com/migawari0202-cpu/homemascotforge/blob/main/HomeMascotForge-editor.html): `HomeMascotForge-editor.html`

### Data and services

- [Weather service](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/weather/WeatherRepository.kt): `app/src/main/java/com/example/mascotforge/weather/WeatherRepository.kt`
- [Weather refresh](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/WeatherUpdateWorker.kt): `app/src/main/java/com/example/mascotforge/WeatherUpdateWorker.kt`
- [Battery cache](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/cache/BatteryManager.kt): `app/src/main/java/widget/cache/BatteryManager.kt`
- [Battery receiver](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/cache/BatteryReceiver.kt): `app/src/main/java/widget/cache/BatteryReceiver.kt`
- [Memo screens](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/com/example/mascotforge/MemoInputActivity.kt): `app/src/main/java/com/example/mascotforge/MemoInputActivity.kt`
- [Memo cache](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/cache/MemoCache.kt): `app/src/main/java/widget/cache/MemoCache.kt`
- [Memo repository](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoRepository.kt): `app/src/main/java/widget/database/MemoRepository.kt`
- [Memo DAO](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoDao.kt): `app/src/main/java/widget/database/MemoDao.kt`
- [Memo database](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoDatabase.kt): `app/src/main/java/widget/database/MemoDatabase.kt`
- [Memo records](https://github.com/migawari0202-cpu/homemascotforge/blob/main/app/src/main/java/widget/database/MemoEntity.kt): `app/src/main/java/widget/database/MemoEntity.kt`

### Other components

- **Android user**

## Connections

- Android user → Home widget: adds and views (evidence: `README.md`)
- Android user → Character selection: selects character (evidence: `README.md`)
- Android user → Install screen: opens character ZIP (evidence: `README.md`)
- Android user → Clock mode: opens clock mode (evidence: `README.md`)
- Home widget → Widget updates: requests updates
- Update scheduling → Widget updates: schedules refresh (evidence: `README.md`)
- Character selection → Character management: chooses character
- Character management → Character runtime: loads character (evidence: `README.md`)
- Character runtime → Built-in character: reads assets (evidence: `README.md`)
- Character runtime → Speech rules: evaluates speech (evidence: `README.md`)
- Speech rules → Speech parsing: parses tags (evidence: `README.md`)
- Install screen → Character installer: starts install (evidence: `README.md`)
- Character installer → ZIP validation: validates archive (evidence: `README.md`)
- Character editor → Android user: creates character (evidence: `README.md`)
- Weather refresh → Weather service: fetches weather (evidence: `README.md`)
- Battery receiver → Battery cache: updates cache (evidence: `app/src/main/java/widget/cache/BatteryReceiver.kt`)
- Battery receiver → Home widget: requests refresh (evidence: `app/src/main/java/widget/cache/BatteryReceiver.kt`)
- Memo screens → Memo cache: manages memos (evidence: `README.md`)
- Memo cache → Memo repository: delegates memo access (evidence: `app/src/main/java/widget/cache/MemoCache.kt`)
- Memo repository → Memo database: opens database (evidence: `app/src/main/java/widget/database/MemoRepository.kt`)
- Memo database → Memo DAO: provides DAO (evidence: `app/src/main/java/widget/database/MemoDatabase.kt`)
- Memo repository → Memo DAO: reads and writes (evidence: `app/src/main/java/widget/database/MemoRepository.kt`)
- Memo DAO → Memo records: queries records (evidence: `app/src/main/java/widget/database/MemoDao.kt`)
