# jforplay/altoy architecture

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

- Interactive diagram: https://gitdiagram.com/jforplay/altoy
- Repository: https://github.com/jforplay/altoy

## Overview

ALtoy is a Korean-language Azur Lane fan viewer: users browse game story, skin, and information content, with separate interactive tools for chats, island systems, and combat simulations. The graph groups those product areas and includes shared caching and cloud-sync layers. The README establishes the main viewing capabilities; source excerpts and the SOURCE INDEX support the shown internal calls. Several other viewers and reference tools are present in the tree but are not expanded here because their wiring was not sampled.

Main entry points: [`public/js/island/island.engine.js`](https://github.com/jforplay/altoy/blob/main/public/js/island/island.engine.js) (Island coordinator), [`public/js/utils.js`](https://github.com/jforplay/altoy/blob/main/public/js/utils.js) (Shared utilities), [`public/js/story-viewer/story-viewer.engine.js`](https://github.com/jforplay/altoy/blob/main/public/js/story-viewer/story-viewer.engine.js) (Story reader), [`public/js/chat-viewer/chat-viewer.engine.js`](https://github.com/jforplay/altoy/blob/main/public/js/chat-viewer/chat-viewer.engine.js) (Chat viewer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Story and media"]
  node_story["Story reader"]
  node_story_parts["Story rendering"]
  node_expression["Expression data"]
  node_skin["Skin preview"]
  node_chat["Chat viewer"]
  node_chat_script["Chat branching"]
  node_chat_render["Chat rendering"]
end

subgraph group_island["Island tools"]
  node_island_core["Island coordinator<br/>[island.engine.js]"]
  node_island_character["Character browser"]
  node_island_technology["Technology tree"]
  node_island_resource["Resource tools"]
  node_island_tree["Recipe tree"]
  node_island_render["Resource display"]
  node_restaurant["Restaurant tools"]
  node_restaurant_calc["Ingredient calculator"]
  node_restaurant_planner["Menu planner"]
  node_season_calc["Season calculator"]
  node_season_map["Season map"]
end

subgraph group_simulation["Combat simulation"]
  node_sim_weapon["Weapon simulator"]
  node_sim_common["Simulation engine"]
  node_sim_bullet["Bullet engine"]
  node_sim_aircraft["Aircraft engine"]
  node_sim_physics["Physics world<br/>[world.js]"]
end

subgraph group_platform["Shared services"]
  node_utils["Shared utilities<br/>[utils.js]"]
  node_cache[("IndexedDB cache<br/>[cache.db.js]")]
  node_storage["Synced storage<br/>[synced-storage.js]"]
  node_drive_sync["Drive sync"]
end

node_user(("Viewer"))

node_user -->|"browses stories"| node_story
node_user -->|"views skins"| node_skin
node_user -.->|"opens chats"| node_chat
node_user -.->|"uses island tools"| node_island_core
node_user -.->|"runs simulation"| node_sim_weapon
node_story -->|"uses"| node_story_parts
node_story -->|"loads"| node_expression
node_story -->|"fetches data"| node_utils
node_skin -->|"loads"| node_expression
node_chat -->|"searches scripts"| node_chat_script
node_chat -->|"renders nodes"| node_chat_render
node_chat -->|"loads data"| node_utils
node_island_core -->|"initializes"| node_season_map
node_island_core -->|"coordinates"| node_island_character
node_island_core -->|"coordinates"| node_island_technology
node_island_core -->|"coordinates"| node_island_resource
node_island_core -->|"coordinates"| node_restaurant
node_island_core -->|"coordinates"| node_season_calc
node_island_character -->|"fetches data"| node_utils
node_island_technology -->|"fetches data"| node_utils
node_island_resource -->|"uses"| node_island_tree
node_island_resource -->|"uses"| node_island_render
node_restaurant -->|"calculates ingredients"| node_restaurant_calc
node_restaurant -->|"loads planner"| node_restaurant_planner
node_season_calc -->|"uses"| node_season_map
node_sim_weapon -->|"uses"| node_sim_common
node_sim_weapon -->|"uses"| node_sim_aircraft
node_sim_common -->|"dispatches to"| node_sim_bullet
node_sim_common -->|"uses"| node_sim_physics
node_sim_weapon -->|"uses registry"| node_sim_physics
node_utils -->|"uses"| node_cache
node_utils -->|"re-exports"| node_storage
node_drive_sync -->|"reads local data"| node_utils

click node_story "https://github.com/jforplay/altoy/blob/main/public/js/story-viewer/story-viewer.engine.js"
click node_story_parts "https://github.com/jforplay/altoy/tree/main/public/js/story-viewer"
click node_expression "https://github.com/jforplay/altoy/blob/main/public/js/expression-manifest.js"
click node_skin "https://github.com/jforplay/altoy/blob/main/public/js/skin/equip-skin.preview.js"
click node_chat "https://github.com/jforplay/altoy/blob/main/public/js/chat-viewer/chat-viewer.engine.js"
click node_chat_script "https://github.com/jforplay/altoy/blob/main/public/js/chat-viewer/chat-viewer.script.js"
click node_chat_render "https://github.com/jforplay/altoy/blob/main/public/js/chat-viewer/chat-viewer.render.js"
click node_island_core "https://github.com/jforplay/altoy/blob/main/public/js/island/island.engine.js"
click node_island_character "https://github.com/jforplay/altoy/blob/main/public/js/island/island.character.engine.js"
click node_island_technology "https://github.com/jforplay/altoy/blob/main/public/js/island/island.technology.engine.js"
click node_island_resource "https://github.com/jforplay/altoy/blob/main/public/js/island/island.resource.engine.js"
click node_island_tree "https://github.com/jforplay/altoy/blob/main/public/js/island/island.resource.tree.js"
click node_island_render "https://github.com/jforplay/altoy/blob/main/public/js/island/island.resource.render.js"
click node_restaurant "https://github.com/jforplay/altoy/blob/main/public/js/island/island.restaurant.engine.js"
click node_restaurant_calc "https://github.com/jforplay/altoy/blob/main/public/js/island/island.restaurant.calc.js"
click node_restaurant_planner "https://github.com/jforplay/altoy/blob/main/public/js/island/island.restaurant.planner.js"
click node_season_calc "https://github.com/jforplay/altoy/blob/main/public/js/island/island.season-calc.engine.js"
click node_season_map "https://github.com/jforplay/altoy/blob/main/public/js/island/island.season-map.js"
click node_sim_weapon "https://github.com/jforplay/altoy/blob/main/public/js/simulators/sim.weapon.controller.js"
click node_sim_common "https://github.com/jforplay/altoy/blob/main/public/js/simulators/sim.engine.common.js"
click node_sim_bullet "https://github.com/jforplay/altoy/blob/main/public/js/simulators/sim.engine.bullet.js"
click node_sim_aircraft "https://github.com/jforplay/altoy/blob/main/public/js/simulators/sim.engine.aircraft.js"
click node_sim_physics "https://github.com/jforplay/altoy/blob/main/public/js/simulators/physics/world.js"
click node_utils "https://github.com/jforplay/altoy/blob/main/public/js/utils.js"
click node_cache "https://github.com/jforplay/altoy/blob/main/public/js/cache.db.js"
click node_storage "https://github.com/jforplay/altoy/blob/main/public/js/synced-storage.js"
click node_drive_sync "https://github.com/jforplay/altoy/blob/main/public/js/sync/drive-sync.engine.js"

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_story,node_story_parts,node_expression,node_skin,node_chat,node_chat_script,node_chat_render,node_user toneBlue
class node_island_core,node_island_character,node_island_technology,node_island_resource,node_island_tree,node_island_render,node_restaurant,node_restaurant_calc,node_restaurant_planner,node_season_calc,node_season_map toneAmber
class node_sim_weapon,node_sim_common,node_sim_bullet,node_sim_aircraft,node_sim_physics toneMint
class node_utils,node_cache,node_storage,node_drive_sync toneRose
```

## Components

### Story and media

- [Story reader](https://github.com/jforplay/altoy/blob/main/public/js/story-viewer/story-viewer.engine.js): `public/js/story-viewer/story-viewer.engine.js`
- [Story rendering](https://github.com/jforplay/altoy/tree/main/public/js/story-viewer): `public/js/story-viewer`
- [Expression data](https://github.com/jforplay/altoy/blob/main/public/js/expression-manifest.js): `public/js/expression-manifest.js`
- [Skin preview](https://github.com/jforplay/altoy/blob/main/public/js/skin/equip-skin.preview.js): `public/js/skin/equip-skin.preview.js`
- [Chat viewer](https://github.com/jforplay/altoy/blob/main/public/js/chat-viewer/chat-viewer.engine.js): `public/js/chat-viewer/chat-viewer.engine.js`
- [Chat branching](https://github.com/jforplay/altoy/blob/main/public/js/chat-viewer/chat-viewer.script.js): `public/js/chat-viewer/chat-viewer.script.js`
- [Chat rendering](https://github.com/jforplay/altoy/blob/main/public/js/chat-viewer/chat-viewer.render.js): `public/js/chat-viewer/chat-viewer.render.js`

### Island tools

- [Island coordinator](https://github.com/jforplay/altoy/blob/main/public/js/island/island.engine.js): `public/js/island/island.engine.js`
- [Character browser](https://github.com/jforplay/altoy/blob/main/public/js/island/island.character.engine.js): `public/js/island/island.character.engine.js`
- [Technology tree](https://github.com/jforplay/altoy/blob/main/public/js/island/island.technology.engine.js): `public/js/island/island.technology.engine.js`
- [Resource tools](https://github.com/jforplay/altoy/blob/main/public/js/island/island.resource.engine.js): `public/js/island/island.resource.engine.js`
- [Recipe tree](https://github.com/jforplay/altoy/blob/main/public/js/island/island.resource.tree.js): `public/js/island/island.resource.tree.js`
- [Resource display](https://github.com/jforplay/altoy/blob/main/public/js/island/island.resource.render.js): `public/js/island/island.resource.render.js`
- [Restaurant tools](https://github.com/jforplay/altoy/blob/main/public/js/island/island.restaurant.engine.js): `public/js/island/island.restaurant.engine.js`
- [Ingredient calculator](https://github.com/jforplay/altoy/blob/main/public/js/island/island.restaurant.calc.js): `public/js/island/island.restaurant.calc.js`
- [Menu planner](https://github.com/jforplay/altoy/blob/main/public/js/island/island.restaurant.planner.js): `public/js/island/island.restaurant.planner.js`
- [Season calculator](https://github.com/jforplay/altoy/blob/main/public/js/island/island.season-calc.engine.js): `public/js/island/island.season-calc.engine.js`
- [Season map](https://github.com/jforplay/altoy/blob/main/public/js/island/island.season-map.js): `public/js/island/island.season-map.js`

### Combat simulation

- [Weapon simulator](https://github.com/jforplay/altoy/blob/main/public/js/simulators/sim.weapon.controller.js): `public/js/simulators/sim.weapon.controller.js`
- [Simulation engine](https://github.com/jforplay/altoy/blob/main/public/js/simulators/sim.engine.common.js): `public/js/simulators/sim.engine.common.js`
- [Bullet engine](https://github.com/jforplay/altoy/blob/main/public/js/simulators/sim.engine.bullet.js): `public/js/simulators/sim.engine.bullet.js`
- [Aircraft engine](https://github.com/jforplay/altoy/blob/main/public/js/simulators/sim.engine.aircraft.js): `public/js/simulators/sim.engine.aircraft.js`
- [Physics world](https://github.com/jforplay/altoy/blob/main/public/js/simulators/physics/world.js): `public/js/simulators/physics/world.js`

### Shared services

- [Shared utilities](https://github.com/jforplay/altoy/blob/main/public/js/utils.js): `public/js/utils.js`
- [IndexedDB cache](https://github.com/jforplay/altoy/blob/main/public/js/cache.db.js): `public/js/cache.db.js`
- [Synced storage](https://github.com/jforplay/altoy/blob/main/public/js/synced-storage.js): `public/js/synced-storage.js`
- [Drive sync](https://github.com/jforplay/altoy/blob/main/public/js/sync/drive-sync.engine.js): `public/js/sync/drive-sync.engine.js`

### Other components

- **Viewer**

## Connections

- Viewer → Story reader: browses stories (evidence: `README.md`)
- Viewer → Skin preview: views skins (evidence: `README.md`)
- Viewer → Chat viewer: opens chats
- Viewer → Island coordinator: uses island tools
- Viewer → Weapon simulator: runs simulation
- Story reader → Story rendering: uses (evidence: `public/js/story-viewer/story-viewer.engine.js`)
- Story reader → Expression data: loads (evidence: `public/js/story-viewer/story-viewer.engine.js`)
- Story reader → Shared utilities: fetches data (evidence: `public/js/story-viewer/story-viewer.engine.js`)
- Skin preview → Expression data: loads
- Chat viewer → Chat branching: searches scripts (evidence: `public/js/chat-viewer/chat-viewer.engine.js`)
- Chat viewer → Chat rendering: renders nodes (evidence: `public/js/chat-viewer/chat-viewer.engine.js`)
- Chat viewer → Shared utilities: loads data (evidence: `public/js/chat-viewer/chat-viewer.engine.js`)
- Island coordinator → Season map: initializes (evidence: `public/js/island/island.engine.js`)
- Island coordinator → Character browser: coordinates (evidence: `public/js/island/island.engine.js`)
- Island coordinator → Technology tree: coordinates (evidence: `public/js/island/island.engine.js`)
- Island coordinator → Resource tools: coordinates (evidence: `public/js/island/island.engine.js`)
- Island coordinator → Restaurant tools: coordinates (evidence: `public/js/island/island.engine.js`)
- Island coordinator → Season calculator: coordinates (evidence: `public/js/island/island.engine.js`)
- Character browser → Shared utilities: fetches data (evidence: `public/js/island/island.character.engine.js`)
- Technology tree → Shared utilities: fetches data (evidence: `public/js/island/island.technology.engine.js`)
- Resource tools → Recipe tree: uses (evidence: `public/js/island/island.resource.engine.js`)
- Resource tools → Resource display: uses (evidence: `public/js/island/island.resource.engine.js`)
- Restaurant tools → Ingredient calculator: calculates ingredients (evidence: `public/js/island/island.restaurant.engine.js`)
- Restaurant tools → Menu planner: loads planner (evidence: `public/js/island/island.restaurant.engine.js`)
- Season calculator → Season map: uses (evidence: `public/js/island/island.season-calc.engine.js`)
- Weapon simulator → Simulation engine: uses (evidence: `public/js/simulators/sim.weapon.controller.js`)
- Weapon simulator → Aircraft engine: uses (evidence: `public/js/simulators/sim.weapon.controller.js`)
- Simulation engine → Bullet engine: dispatches to (evidence: `public/js/simulators/sim.engine.common.js`)
- Simulation engine → Physics world: uses
- Weapon simulator → Physics world: uses registry (evidence: `public/js/simulators/sim.weapon.controller.js`)
- Shared utilities → IndexedDB cache: uses (evidence: `public/js/utils.js`)
- Shared utilities → Synced storage: re-exports (evidence: `public/js/synced-storage.js`)
- Drive sync → Shared utilities: reads local data (evidence: `public/js/sync/drive-sync.engine.js`)
