# iancortez2005/petsadepeligro architecture

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

- Interactive diagram: https://gitdiagram.com/iancortez2005/petsadepeligro
- Repository: https://github.com/iancortez2005/petsadepeligro

## Overview

Petsa de Peligro is a Swing survival game: the player chooses an apartment, then manages three daily time slots across a 30-day schedule, balancing cash, needs, studies, work, rent and events to reach the ending. RoomPanel is the main play interface and sends actions to GameEngine, which updates the game state and ledger; the UI presents day summaries and ending screens. Save/load and leaderboard are additional persistence-backed capabilities. The graph follows documented and indexed references; unsampled panel wiring is not expanded beyond relationships shown by the index.

Main entry points: [`src/petsa/ui/RoomPanel.java`](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/RoomPanel.java) (Room play), [`src/petsa/model/GameEngine.java`](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/GameEngine.java) (Game engine), [`src/petsa/ui/GameApp.java`](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/GameApp.java) (Swing app), [`src/petsa/model/GameState.java`](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/GameState.java) (Game state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Game flow"]
  node_engine["Game engine<br/>[GameEngine.java]"]
  node_state["Game state<br/>[GameState.java]"]
  node_timeline["30-day timeline<br/>[Timeline.java]"]
end

subgraph group_rules["Simulation rules"]
  node_playerstate["Needs and inventory<br/>[Player.java]"]
  node_tasks["Daily actions<br/>[Task.java]"]
  node_job["Part-time work<br/>[PartTimeJob.java]"]
  node_events["Random events<br/>[RandomEvent.java]"]
  node_scheduler["Event scheduler"]
end

subgraph group_interface["Game interface"]
  node_app["Swing app<br/>[GameApp.java]"]
  node_room["Room play<br/>[RoomPanel.java]"]
  node_board["Action board<br/>[BoardOverlay.java]"]
  node_phone["Phone events<br/>[PhoneOverlay.java]"]
  node_summary["Day summary<br/>[EndOfDayPanel.java]"]
  node_rent["Rent day"]
  node_apartment["Apartment choice"]
  node_story["Story and tutorial"]
  node_notebook["Calendar notebook"]
  node_window["Window view<br/>[WindowOverlay.java]"]
  node_shelf["Supply shelf<br/>[ShelfOverlay.java]"]
  node_tutorial["Tutorial"]
  node_render["Pixel UI kit<br/>[PixelKit.java]"]
  node_load["Load game<br/>[LoadGamePanel.java]"]
  node_leaderboardui["Leaderboard screen"]
end

subgraph group_records["Player records"]
  node_ledger["Daily ledger<br/>[DailyLedger.java]"]
  node_saves[("Save checkpoints<br/>[SaveManager.java]")]
  node_leaderboard[("Leaderboard")]
end

node_player(("Player"))

node_player -->|"starts game"| node_app
node_app -->|"shows play"| node_room
node_app -->|"shows choice"| node_apartment
node_app -->|"shows story"| node_story
node_app -->|"shows summary"| node_summary
node_app -->|"opens load"| node_load
node_app -->|"opens screen"| node_leaderboardui
node_app -->|"creates engine"| node_engine
node_app -->|"uses saves"| node_saves
node_app -->|"uses records"| node_leaderboard
node_room -->|"performs actions"| node_engine
node_room -.->|"opens board"| node_board
node_room -.->|"opens phone"| node_phone
node_room -.->|"opens notebook"| node_notebook
node_room -.->|"opens window"| node_window
node_room -.->|"opens shelf"| node_shelf
node_room -.->|"shows rent"| node_rent
node_room -.->|"shows tutorial"| node_tutorial
node_room -.->|"shows results"| node_summary
node_board -->|"reads status"| node_engine
node_board -->|"offers actions"| node_tasks
node_phone -->|"resolves choice"| node_engine
node_phone -->|"displays event"| node_events
node_load -->|"loads checkpoints"| node_saves
node_leaderboardui -->|"reads scores"| node_leaderboard
node_engine -->|"updates"| node_state
node_engine -->|"records cash"| node_ledger
node_engine -->|"plans events"| node_scheduler
node_engine -->|"executes task"| node_tasks
node_engine -->|"resolves events"| node_events
node_engine -->|"handles shifts"| node_job
node_engine -->|"restores snapshot"| node_saves
node_state -->|"holds player"| node_playerstate
node_state -->|"tracks time"| node_timeline
node_scheduler -->|"selects events"| node_events
node_events -->|"changes needs"| node_playerstate
node_events -->|"schedules effects"| node_state
node_tasks -->|"changes needs"| node_playerstate
node_tasks -->|"uses state"| node_state
node_job -->|"updates cash"| node_playerstate
node_ledger -->|"summarizes balance"| node_playerstate
node_saves -->|"stores ledger"| node_ledger
node_saves -->|"stores checkpoint"| node_state
node_render -.->|"draws interface"| node_room

click node_app "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/GameApp.java"
click node_room "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/RoomPanel.java"
click node_board "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/BoardOverlay.java"
click node_phone "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/PhoneOverlay.java"
click node_summary "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/EndOfDayPanel.java"
click node_rent "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/RentDayOverlay.java"
click node_apartment "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/ApartmentSelectPanel.java"
click node_story "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/StoryboardPanel.java"
click node_notebook "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/NotebookOverlay.java"
click node_window "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/WindowOverlay.java"
click node_shelf "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/ShelfOverlay.java"
click node_tutorial "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/TutorialOverlay.java"
click node_render "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/PixelKit.java"
click node_engine "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/GameEngine.java"
click node_state "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/GameState.java"
click node_timeline "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/Timeline.java"
click node_ledger "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/DailyLedger.java"
click node_playerstate "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/Player.java"
click node_tasks "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/Task.java"
click node_job "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/PartTimeJob.java"
click node_events "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/RandomEvent.java"
click node_scheduler "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/EventScheduler.java"
click node_saves "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/SaveManager.java"
click node_load "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/LoadGamePanel.java"
click node_leaderboard "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/LeaderboardManager.java"
click node_leaderboardui "https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/LeaderboardPanel.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_engine,node_state,node_timeline toneBlue
class node_playerstate,node_tasks,node_job,node_events,node_scheduler toneAmber
class node_app,node_room,node_board,node_phone,node_summary,node_rent,node_apartment,node_story,node_notebook,node_window,node_shelf,node_tutorial,node_render,node_load,node_leaderboardui toneMint
class node_ledger,node_saves,node_leaderboard toneRose
class node_player toneIndigo
```

## Components

### Game flow

- [Game engine](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/GameEngine.java): `src/petsa/model/GameEngine.java`
- [Game state](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/GameState.java): `src/petsa/model/GameState.java`
- [30-day timeline](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/Timeline.java): `src/petsa/model/Timeline.java`

### Simulation rules

- [Needs and inventory](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/Player.java): `src/petsa/model/Player.java`
- [Daily actions](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/Task.java): `src/petsa/model/Task.java`
- [Part-time work](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/PartTimeJob.java): `src/petsa/model/PartTimeJob.java`
- [Random events](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/RandomEvent.java): `src/petsa/model/RandomEvent.java`
- [Event scheduler](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/EventScheduler.java): `src/petsa/model/EventScheduler.java`

### Game interface

- [Swing app](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/GameApp.java): `src/petsa/ui/GameApp.java`
- [Room play](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/RoomPanel.java): `src/petsa/ui/RoomPanel.java`
- [Action board](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/BoardOverlay.java): `src/petsa/ui/BoardOverlay.java`
- [Phone events](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/PhoneOverlay.java): `src/petsa/ui/PhoneOverlay.java`
- [Day summary](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/EndOfDayPanel.java): `src/petsa/ui/EndOfDayPanel.java`
- [Rent day](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/RentDayOverlay.java): `src/petsa/ui/RentDayOverlay.java`
- [Apartment choice](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/ApartmentSelectPanel.java): `src/petsa/ui/ApartmentSelectPanel.java`
- [Story and tutorial](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/StoryboardPanel.java): `src/petsa/ui/StoryboardPanel.java`
- [Calendar notebook](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/NotebookOverlay.java): `src/petsa/ui/NotebookOverlay.java`
- [Window view](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/WindowOverlay.java): `src/petsa/ui/WindowOverlay.java`
- [Supply shelf](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/ShelfOverlay.java): `src/petsa/ui/ShelfOverlay.java`
- [Tutorial](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/TutorialOverlay.java): `src/petsa/ui/TutorialOverlay.java`
- [Pixel UI kit](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/PixelKit.java): `src/petsa/ui/PixelKit.java`
- [Load game](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/LoadGamePanel.java): `src/petsa/ui/LoadGamePanel.java`
- [Leaderboard screen](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/ui/LeaderboardPanel.java): `src/petsa/ui/LeaderboardPanel.java`

### Player records

- [Daily ledger](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/DailyLedger.java): `src/petsa/model/DailyLedger.java`
- [Save checkpoints](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/SaveManager.java): `src/petsa/model/SaveManager.java`
- [Leaderboard](https://github.com/iancortez2005/petsadepeligro/blob/main/src/petsa/model/LeaderboardManager.java): `src/petsa/model/LeaderboardManager.java`

### Other components

- **Player**

## Connections

- Player → Swing app: starts game (evidence: `README.md`)
- Swing app → Room play: shows play (evidence: `src/petsa/ui/GameApp.java`)
- Swing app → Apartment choice: shows choice (evidence: `src/petsa/ui/GameApp.java`)
- Swing app → Story and tutorial: shows story (evidence: `src/petsa/ui/GameApp.java`)
- Swing app → Day summary: shows summary (evidence: `src/petsa/ui/GameApp.java`)
- Swing app → Load game: opens load (evidence: `src/petsa/ui/GameApp.java`)
- Swing app → Leaderboard screen: opens screen (evidence: `src/petsa/ui/GameApp.java`)
- Swing app → Game engine: creates engine (evidence: `src/petsa/ui/GameApp.java`)
- Swing app → Save checkpoints: uses saves (evidence: `src/petsa/ui/GameApp.java`)
- Swing app → Leaderboard: uses records (evidence: `src/petsa/ui/GameApp.java`)
- Room play → Game engine: performs actions (evidence: `src/petsa/ui/RoomPanel.java`)
- Room play → Action board: opens board (evidence: `src/petsa/ui/RoomPanel.java`)
- Room play → Phone events: opens phone (evidence: `src/petsa/ui/RoomPanel.java`)
- Room play → Calendar notebook: opens notebook (evidence: `src/petsa/ui/RoomPanel.java`)
- Room play → Window view: opens window (evidence: `src/petsa/ui/RoomPanel.java`)
- Room play → Supply shelf: opens shelf (evidence: `src/petsa/ui/RoomPanel.java`)
- Room play → Rent day: shows rent (evidence: `src/petsa/ui/RoomPanel.java`)
- Room play → Tutorial: shows tutorial (evidence: `src/petsa/ui/RoomPanel.java`)
- Room play → Day summary: shows results
- Action board → Game engine: reads status (evidence: `src/petsa/ui/BoardOverlay.java`)
- Action board → Daily actions: offers actions (evidence: `src/petsa/ui/BoardOverlay.java`)
- Phone events → Game engine: resolves choice (evidence: `src/petsa/ui/PhoneOverlay.java`)
- Phone events → Random events: displays event (evidence: `src/petsa/ui/PhoneOverlay.java`)
- Load game → Save checkpoints: loads checkpoints (evidence: `src/petsa/ui/LoadGamePanel.java`)
- Leaderboard screen → Leaderboard: reads scores (evidence: `src/petsa/ui/LeaderboardPanel.java`)
- Game engine → Game state: updates (evidence: `src/petsa/model/GameEngine.java`)
- Game engine → Daily ledger: records cash (evidence: `src/petsa/model/GameEngine.java`)
- Game engine → Event scheduler: plans events (evidence: `src/petsa/model/GameEngine.java`)
- Game engine → Daily actions: executes task (evidence: `src/petsa/model/GameEngine.java`)
- Game engine → Random events: resolves events (evidence: `src/petsa/model/GameEngine.java`)
- Game engine → Part-time work: handles shifts (evidence: `src/petsa/model/GameEngine.java`)
- Game engine → Save checkpoints: restores snapshot (evidence: `src/petsa/model/GameEngine.java`)
- Game state → Needs and inventory: holds player (evidence: `src/petsa/model/GameState.java`)
- Game state → 30-day timeline: tracks time (evidence: `src/petsa/model/GameState.java`)
- Event scheduler → Random events: selects events (evidence: `src/petsa/model/EventScheduler.java`)
- Random events → Needs and inventory: changes needs (evidence: `src/petsa/model/RandomEvent.java`)
- Random events → Game state: schedules effects (evidence: `src/petsa/model/RandomEvent.java`)
- Daily actions → Needs and inventory: changes needs (evidence: `src/petsa/model/Task.java`)
- Daily actions → Game state: uses state (evidence: `src/petsa/model/Task.java`)
- Part-time work → Needs and inventory: updates cash (evidence: `src/petsa/model/PartTimeJob.java`)
- Daily ledger → Needs and inventory: summarizes balance (evidence: `src/petsa/model/DailyLedger.java`)
- Save checkpoints → Daily ledger: stores ledger (evidence: `src/petsa/model/SaveManager.java`)
- Save checkpoints → Game state: stores checkpoint (evidence: `src/petsa/model/SaveManager.java`)
- Pixel UI kit → Room play: draws interface (evidence: `src/petsa/ui/RoomPanel.java`)
