# xelor-dev/moviles_proyectofinal architecture

> Architecture diagram of the GitHub repository xelor-dev/moviles_proyectofinal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xelor-dev/moviles_proyectofinal
- Repository: https://github.com/xelor-dev/moviles_proyectofinal

## Overview

##### Project type and purpose
- This is a Unity-based Android game (client-side application) that uses Firebase (Authentication, Realtime Database) and DOTween for animations, plus Unity’s Input System and URP for rendering.

##### File structure
- Top-level Unity folders:
- Assets/               — all game assets, scenes, scripts, prefabs, scriptable objects
- Packages/             — Unity package manifest
- ProjectSettings/      — Unity project settings and build configuration
- Keystore/             — Android signing key
- .utmp/                — temporary CMake build output (native plugin build)
- Within Assets/:
- ProjectAssets/        — organized art, audio, models, prefabs, scenes, UI sprites
- Plugins/              — third-party libraries (DOTween, Firebase AARs)
- Scriptable Objects/   — SO data for configs (AudioConfig, RobotNeeds, etc.)
- Scripts/              — C# code organized by feature:
· Firebase/          — AuthenticationManager.cs, DatabaseManager.cs
· Managers/          — GameSceneLoader, AudioManager, ResourceManager, UI managers
· Minigames/         — modules for ExteriorRunner, Punteria, RobotWalk
· SaveSystem/, UtilityScripts/, RepairSystem.cs, TouchInputHandler.cs
- Settings/             — render pipeline assets, volume profiles
- StreamingAssets/      — google-services-desktop.json
- Configuration files:
- Packages/manifest.json & packages-lock.json — package dependencies
- ProjectSettings/*.asset / .json — Unity build, quality, input, graphics, etc.
- Keystore/LastHopeBot.keystore — Android keystore for signing

##### README
- “assignment final project using Unity, this game is for android.”
- No further architectural detail, so infer architecture from file structure and Firebase usage.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Application Layer
    subgraph "Client Application" 
        direction TB

        subgraph "Unity Engine & Build Config" 
            direction TB
            UE["Unity Engine & Runtime"]:::engine
            Settings["ProjectSettings & Packages & Keystore"]:::engine
        end

        subgraph "Scenes & Asset Bundles"
            direction TB
            Scenes["Scenes & AssetBundles"]:::frontend
        end

        subgraph "Input System & Touch Handling"
            direction TB
            InputSystem["Unity Input System"]:::frontend
            TouchHandler["TouchInputHandler"]:::frontend
        end

        subgraph "UI Layer"
            direction TB
            UI["UI Controllers & Canvases"]:::frontend
        end

        subgraph "Game Logic & Managers"
            direction TB
            Logic["Game Logic & Manager Services"]:::frontend
        end

        subgraph "Animation & Tweening"
            direction TB
            Tween["DOTween Plugin"]:::frontend
        end

        subgraph "Data & Config Layer"
            direction TB
            Scriptable["Scriptable Objects"]:::data
        end

        subgraph "Save System"
            direction TB
            Save["Save System (Local Persistence)"]:::data
        end

        subgraph "Minigame Modules"
            direction TB
            Minigames["Minigames (ExteriorRunner, Punteria, RobotWalk)"]:::frontend
        end

        subgraph "Native Android Plugin"
            direction TB
            Plugin["GameActivity Native Plugin"]:::plugin
        end
    end

    %% Cloud Services Layer
    subgraph "Cloud Services"
        direction TB
        Auth["Firebase Authentication"]:::external
        Database["Firebase Realtime Database"]:::external
    end

    %% Connections
    Scenes -->|loads into| UE
    UE -->|executes| Logic
    InputSystem -->|drives| TouchHandler
    TouchHandler -->|sends input to| Logic
    Logic -->|updates| UI
    UI -->|invokes| Logic
    Logic -->|animates via| Tween
    Logic -->|reads/writes| Scriptable
    Logic -->|saves locally via| Save
    Logic -->|loads minigame| Minigames
    Logic -->|auth & data calls| Auth
    Logic -->|auth & data calls| Database
    Plugin -->|integrates with| UE

    %% Click Events
    click Settings "https://github.com/xelor-dev/moviles_proyectofinal/tree/master/ProjectSettings/"
    click Settings "https://github.com/xelor-dev/moviles_proyectofinal/blob/master/Packages/manifest.json"
    click Settings "https://github.com/xelor-dev/moviles_proyectofinal/blob/master/Packages/packages-lock.json"
    click Settings "https://github.com/xelor-dev/moviles_proyectofinal/blob/master/Keystore/LastHopeBot.keystore"
    click Scenes "https://github.com/xelor-dev/moviles_proyectofinal/tree/master/Assets/ProjectAssets/Scenes/"
    click InputSystem "https://github.com/xelor-dev/moviles_proyectofinal/blob/master/Assets/InputSystem_Actions.inputactions"
    click TouchHandler "https://github.com/xelor-dev/moviles_proyectofinal/blob/master/Assets/ProjectAssets/Scripts/TouchInputHandler.cs"
    click UI "https://github.com/xelor-dev/moviles_proyectofinal/tree/master/Assets/ProjectAssets/Scripts/UI/"
    click Logic "https://github.com/xelor-dev/moviles_proyectofinal/tree/master/Assets/ProjectAssets/Scripts/Managers/"
    click Tween "https://github.com/xelor-dev/moviles_proyectofinal/tree/master/Assets/Plugins/Demigiant/DOTween/"
    click Scriptable "https://github.com/xelor-dev/moviles_proyectofinal/tree/master/Assets/ProjectAssets/Scriptable Objects/"
    click Save "https://github.com/xelor-dev/moviles_proyectofinal/tree/master/Assets/ProjectAssets/Scripts/SaveSystem/"
    click Auth "https://github.com/xelor-dev/moviles_proyectofinal/blob/master/Assets/ProjectAssets/Scripts/Firebase/AuthenticationManager.cs"
    click Database "https://github.com/xelor-dev/moviles_proyectofinal/blob/master/Assets/ProjectAssets/Scripts/Firebase/DatabaseManager.cs"
    click Minigames "https://github.com/xelor-dev/moviles_proyectofinal/tree/master/Assets/ProjectAssets/Scripts/Minigames/"
    click Plugin "https://github.com/xelor-dev/moviles_proyectofinal/tree/master/.utmp/Debug/.../arm64-v8a/GameActivity/"

    %% Styles
    classDef engine fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef frontend fill:#a2d2ff,stroke:#333,stroke-width:1px
    classDef data fill:#c8e6c9,stroke:#333,stroke-width:1px
    classDef external fill:#ffcc80,stroke:#333,stroke-width:1px
    classDef plugin fill:#e0e0e0,stroke:#333,stroke-width:1px
```
