# havriiash/tetris architecture

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

- Interactive diagram: https://gitdiagram.com/havriiash/tetris
- Repository: https://github.com/havriiash/tetris

## Overview

Tetris is an Android classic game: the player starts a session, manipulates falling pieces, and can review saved high scores. The UI activity handles input and presents the game; the MVC game model updates the playfield and reports changes through its controller, while canvas views render the board and preview. A separate records flow reads and updates the SQLite leaderboard. The README documents MVC, Android canvas, and SQLite; relationships below rely on shown excerpts or the source index, so unsampled implementation details are not inferred.

Main entry points: [`app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java`](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java) (Game screen), [`app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java`](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java) (Game model), [`app/src/main/java/com/tetris/dmitriy/tetris/records/RecordsService.java`](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/RecordsService.java) (Records service), [`app/src/main/java/com/tetris/dmitriy/tetris/RecordsActivity.java`](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/RecordsActivity.java) (Records screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_main["Main menu<br/>[MainActivity.java]"]
  node_game_activity["Game screen<br/>[GameActivity.java]"]
  node_records_activity["Records screen"]
end

subgraph group_game["Gameplay"]
  node_model["Game model<br/>[GlassModel.java]"]
  node_controller["Game callbacks"]
  node_field["Playfield state<br/>[PlayField.java]"]
  node_events["Game events<br/>[Events.java]"]
  node_messages["UI messages<br/>[MessageTypes.java]"]
  node_board_view["Board canvas<br/>[GlassView.java]"]
  node_preview["Next-piece view"]
end

subgraph group_records["High scores"]
  node_record["Score record<br/>[Record.java]"]
  node_db[("SQLite records<br/>[DBHelper.java]")]
  node_records_service["Records service"]
  node_update_service["Leaderboard updater<br/>[UpdateService.java]"]
  node_adapter["Record list adapter<br/>[RecordAdapter.java]"]
end

subgraph group_pieces["Tetrominoes"]
  node_figure["Figure base<br/>[Figure.java]"]
  node_figure_types["Piece variants"]
end

node_player(("Player"))

node_player -->|"opens"| node_main
node_main -->|"opens"| node_game_activity
node_main -->|"opens"| node_records_activity
node_game_activity -->|"starts and controls"| node_model
node_game_activity -->|"uses"| node_board_view
node_game_activity -.->|"updates preview"| node_preview
node_model -->|"updates state"| node_field
node_model -->|"creates and moves"| node_figure
node_figure -->|"creates variants"| node_figure_types
node_board_view -->|"reads state"| node_field
node_board_view -->|"renders"| node_figure
node_model -->|"reports changes"| node_controller
node_game_activity -->|"implements callbacks"| node_controller
node_game_activity -->|"dispatches actions"| node_events
node_model -->|"posts UI messages"| node_messages
node_model -->|"creates game result"| node_record
node_game_activity -->|"checks new score"| node_record
node_game_activity -->|"checks leaderboard"| node_records_service
node_game_activity -->|"submits score"| node_update_service
node_records_activity -->|"requests records"| node_records_service
node_records_service -->|"broadcasts records"| node_records_activity
node_records_activity -->|"displays records"| node_adapter
node_records_service -->|"reads records"| node_db
node_records_service -->|"builds records"| node_record
node_update_service -->|"loads current list"| node_records_service
node_update_service -->|"rewrites leaderboard"| node_db
node_adapter -->|"renders entries"| node_record

click node_main "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/MainActivity.java"
click node_game_activity "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java"
click node_records_activity "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/RecordsActivity.java"
click node_model "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java"
click node_controller "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/GlassController.java"
click node_field "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/PlayField.java"
click node_events "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/Events.java"
click node_messages "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/MessageTypes.java"
click node_board_view "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/GlassView.java"
click node_preview "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/NextFigureView.java"
click node_figure "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/figures/Figure.java"
click node_figure_types "https://github.com/havriiash/tetris/tree/master/app/src/main/java/com/tetris/dmitriy/tetris/game/figures"
click node_record "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/Record.java"
click node_db "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/DBHelper.java"
click node_records_service "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/RecordsService.java"
click node_update_service "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/UpdateService.java"
click node_adapter "https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/RecordAdapter.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_game_activity,node_records_activity toneBlue
class node_model,node_controller,node_field,node_events,node_messages,node_board_view,node_preview toneAmber
class node_record,node_db,node_records_service,node_update_service,node_adapter toneMint
class node_figure,node_figure_types toneRose
class node_player toneIndigo
```

## Components

### App navigation

- [Main menu](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/MainActivity.java): `app/src/main/java/com/tetris/dmitriy/tetris/MainActivity.java`
- [Game screen](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java): `app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java`
- [Records screen](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/RecordsActivity.java): `app/src/main/java/com/tetris/dmitriy/tetris/RecordsActivity.java`

### Gameplay

- [Game model](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java): `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java`
- [Game callbacks](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/GlassController.java): `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassController.java`
- [Playfield state](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/PlayField.java): `app/src/main/java/com/tetris/dmitriy/tetris/game/PlayField.java`
- [Game events](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/Events.java): `app/src/main/java/com/tetris/dmitriy/tetris/game/Events.java`
- [UI messages](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/MessageTypes.java): `app/src/main/java/com/tetris/dmitriy/tetris/game/MessageTypes.java`
- [Board canvas](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/GlassView.java): `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassView.java`
- [Next-piece view](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/NextFigureView.java): `app/src/main/java/com/tetris/dmitriy/tetris/game/NextFigureView.java`

### High scores

- [Score record](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/Record.java): `app/src/main/java/com/tetris/dmitriy/tetris/records/Record.java`
- [SQLite records](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/DBHelper.java): `app/src/main/java/com/tetris/dmitriy/tetris/records/DBHelper.java`
- [Records service](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/RecordsService.java): `app/src/main/java/com/tetris/dmitriy/tetris/records/RecordsService.java`
- [Leaderboard updater](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/UpdateService.java): `app/src/main/java/com/tetris/dmitriy/tetris/records/UpdateService.java`
- [Record list adapter](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/records/RecordAdapter.java): `app/src/main/java/com/tetris/dmitriy/tetris/records/RecordAdapter.java`

### Tetrominoes

- [Figure base](https://github.com/havriiash/tetris/blob/master/app/src/main/java/com/tetris/dmitriy/tetris/game/figures/Figure.java): `app/src/main/java/com/tetris/dmitriy/tetris/game/figures/Figure.java`
- [Piece variants](https://github.com/havriiash/tetris/tree/master/app/src/main/java/com/tetris/dmitriy/tetris/game/figures): `app/src/main/java/com/tetris/dmitriy/tetris/game/figures`

### Other components

- **Player**

## Connections

- Player → Main menu: opens
- Main menu → Game screen: opens (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/MainActivity.java`)
- Main menu → Records screen: opens (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/MainActivity.java`)
- Game screen → Game model: starts and controls (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java`)
- Game screen → Board canvas: uses (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java`)
- Game screen → Next-piece view: updates preview
- Game model → Playfield state: updates state (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java`)
- Game model → Figure base: creates and moves (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java`)
- Figure base → Piece variants: creates variants (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/game/figures/Figure.java`)
- Board canvas → Playfield state: reads state (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassView.java`)
- Board canvas → Figure base: renders (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassView.java`)
- Game model → Game callbacks: reports changes (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java`)
- Game screen → Game callbacks: implements callbacks (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java`)
- Game screen → Game events: dispatches actions (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java`)
- Game model → UI messages: posts UI messages (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java`)
- Game model → Score record: creates game result (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/game/GlassModel.java`)
- Game screen → Score record: checks new score (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java`)
- Game screen → Records service: checks leaderboard (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java`)
- Game screen → Leaderboard updater: submits score (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/GameActivity.java`)
- Records screen → Records service: requests records (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/RecordsActivity.java`)
- Records service → Records screen: broadcasts records (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/records/RecordsService.java`)
- Records screen → Record list adapter: displays records (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/RecordsActivity.java`)
- Records service → SQLite records: reads records (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/records/RecordsService.java`)
- Records service → Score record: builds records (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/records/RecordsService.java`)
- Leaderboard updater → Records service: loads current list (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/records/UpdateService.java`)
- Leaderboard updater → SQLite records: rewrites leaderboard (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/records/UpdateService.java`)
- Record list adapter → Score record: renders entries (evidence: `app/src/main/java/com/tetris/dmitriy/tetris/records/RecordAdapter.java`)
