# jhonuwu0934/tolearn_app_front architecture

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

- Interactive diagram: https://gitdiagram.com/jhonuwu0934/tolearn_app_front
- Repository: https://github.com/jhonuwu0934/tolearn_app_front

## Overview

A. Project Type and Purpose
1. This is a “front‐end only” Smart TV educational application (no external backend) built with HTML5, CSS, and JavaScript.
2. Purpose: Teach arithmetic (addition, subtraction, multiplication, division) to children (4–8 years) via interactive exercises on Tizen‐powered Smart TVs, persisting progress in LocalStorage.

B. File Structure Analysis
- Top‐level assets:
- HTML pages (e.g., inicio.html, menu.html, niveles.html, preguntas*.html, apisuma.html, etc.)
- CSS directory (/css/*.css) for styling each view and component
- JS directory (/js/*.js) for UI logic, module controllers, and LocalStorage operations
- Audio assets (/audio/*.mp3) for background music/feedback
- Config & tooling:
- config.xml – Tizen app manifest
- README, LICENSE, NOTICE – documentation
- Eclipse/Tizen Studio metadata – IDE settings

##### Platform Layer
- Tizen OS Web Runtime: the container executing HTML/CSS/JS
##### Application Logic Layer
- JS Modules:
- main.js – app initialization, page routing
- niveles.js – mapping age/level to available operations
- preguntas*.js – question generation and answer evaluation per operation
- progreso.js – computing and updating progress
- audio/*.js – playing feedback sounds
##### Data Persistence
- LocalStorage API: saving and retrieving user profile (name, age, level) and progress metrics
##### Assets
- Audio engine: background music and positive/negative feedback sounds

D. Relationships & Interactions
- User → Remote Control → Tizen Web Runtime
- Runtime → loads HTML view → loads associated CSS + JS
- JS modules ↔ LocalStorage (read/write)
- JS modules → dynamically update DOM in HTML view
- JS modules → trigger Audio player
- Navigation flows:
- Registration → Animal Selection → Level Selection → Module Exercises → Feedback → Progress

E. Architectural Patterns & Principles
- Modular JS: one file per functional area (separation of concerns)
- View‐Controller style: HTML/CSS for view; JS for controller/logic
- Client‐side state management via LocalStorage
- Event‐driven input handling (remote control events)

F. Diagramming Guidelines
- Platform (Tizen Web Runtime)
- UI (HTML Views + CSS)
- Logic (JS modules grouped by feature)
- Storage (LocalStorage)
- Assets (Audio, Images)
- Data flow (e.g., Logic → Storage)
- Control flow (e.g., Remote Control → Runtime → Logic)
- Dependency (e.g., HTML views depend on CSS + JS)

G. Tailoring to This Front-End Smart TV App
- Separation: Presentation vs. Logic vs. Storage.
- That all code runs client-side in the Tizen Web Runtime—no external API calls.
- Control‐flow loop: Remote Control events → JS Handlers → DOM updates + Storage updates + Audio feedback.
- Config.xml as the manifest binding the app to Tizen device APIs.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Platform Layer
    subgraph "Platform Layer"
        Runtime["Tizen Web Runtime"]:::platform
        Manifest["Manifest (config.xml)"]:::platform
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        subgraph "HTML Views"
            Home["Home Screen (inicio.html)"]:::ui
            Registro["Registration (registro.html)"]:::ui
            AnimalSel["Animal Selection (seleccionanimal.html)"]:::ui
            Menu["Menu (menu.html)"]:::ui
            NivelSel["Level Selection (niveles.html)"]:::ui
            PreguntasMix["Mixed Questions (preguntasmezcladas.html)"]:::ui
            PreguntasAdd["Addition (preguntas.html)"]:::ui
            PreguntasSub["Subtraction (preguntasresta.html)"]:::ui
            PreguntasMul["Multiplication (preguntasmultiplicacion.html)"]:::ui
            PreguntasDiv["Division (preguntasdivision.html)"]:::ui
            FruitVariant["Fruit Counting (sumasfrutas.html)"]:::ui
            ProgresoView["Progress Screen (progreso.html)"]:::ui
        end
        subgraph "CSS Stylesheets"
            CSSDir["css/"]:::ui
        end
    end

    %% Application Logic Layer
    subgraph "Application Logic Layer"
        MainJS["main.js"]:::logic
        NivelesJS["niveles.js"]:::logic
        PregCore["preguntas.js (core)"]:::logic
        PregAddAPI["apisuma.js"]:::logic
        PregAdd["preguntas.js"]:::logic
        PregSubAPI["apirestas.js"]:::logic
        PregSub["preguntasrestas.js"]:::logic
        PregMulAPI["apimultiplicacion.js"]:::logic
        PregMul["preguntasmultiplicacion.js"]:::logic
        PregDivAPI["apidivision.js"]:::logic
        PregDiv["preguntasdivision.js"]:::logic
        PregMix["preguntasmezcladas.js"]:::logic
        FruitLogic["sumarfrutas.js"]:::logic
        AnimalJS["animal.js"]:::logic
        ProgresoJS["progreso.js"]:::logic
    end

    %% Data Persistence
    subgraph "Data Persistence"
        LocalStore["LocalStorage API"]:::storage
    end

    %% Assets
    subgraph "Assets"
        AudioEngine["Audio Engine (audio/)"]:::assets
        ImagesDir["Images/"]:::assets
    end

    %% Control & Data Flows
    RemoteControl["Remote Control Input"]:::platform --> Runtime
    Runtime --> Home
    Runtime --> Registro
    Runtime --> AnimalSel
    Runtime --> Menu
    Runtime --> NivelSel
    Runtime --> PreguntasMix
    Runtime --> PreguntasAdd
    Runtime --> PreguntasSub
    Runtime --> PreguntasMul
    Runtime --> PreguntasDiv
    Runtime --> FruitVariant
    Runtime --> ProgresoView

    %% Dependencies
    Home --> CSSDir
    Registro --> CSSDir
    AnimalSel --> CSSDir
    Menu --> CSSDir
    NivelSel --> CSSDir
    PreguntasMix --> CSSDir
    PreguntasAdd --> CSSDir
    PreguntasSub --> CSSDir
    PreguntasMul --> CSSDir
    PreguntasDiv --> CSSDir
    FruitVariant --> CSSDir
    ProgresoView --> CSSDir

    Home --> MainJS
    Registro --> MainJS
    AnimalSel --> AnimalJS
    Menu --> MainJS
    NivelSel --> NivelesJS
    PreguntasMix --> PregMix
    PreguntasAdd --> PregAdd
    PreguntasSub --> PregSub
    PreguntasMul --> PregMul
    PreguntasDiv --> PregDiv
    FruitVariant --> FruitLogic
    ProgresoView --> ProgresoJS

    %% Logic interactions
    MainJS --> LocalStore
    NivelesJS --> LocalStore
    PregCore --> LocalStore
    ProgresoJS --> LocalStore

    %% Audio
    PregCore --> AudioEngine
    PregAdd --> AudioEngine
    PregSub --> AudioEngine
    PregMul --> AudioEngine
    PregDiv --> AudioEngine
    PregMix --> AudioEngine
    FruitLogic --> AudioEngine

    %% Styles
    classDef platform fill:#cce5ff,stroke:#004085,color:#004085;
    classDef ui fill:#d4edda,stroke:#155724,color:#155724;
    classDef logic fill:#fff3cd,stroke:#856404,color:#856404;
    classDef storage fill:#fff3cd,stroke:#856404,color:#856404;
    classDef assets fill:#e2e3e5,stroke:#6c757d,color:#6c757d;

    %% Click Events for Component Mapping
    click Manifest "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/config.xml"
    click Home "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/inicio.html"
    click Registro "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/registro.html"
    click AnimalSel "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/seleccionanimal.html"
    click Menu "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/menu.html"
    click NivelSel "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/niveles.html"
    click PreguntasMix "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/preguntasmezcladas.html"
    click PreguntasAdd "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/preguntas.html"
    click PreguntasSub "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/preguntasresta.html"
    click PreguntasMul "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/preguntasmultiplicacion.html"
    click PreguntasDiv "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/preguntasdivision.html"
    click FruitVariant "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/sumasfrutas.html"
    click ProgresoView "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/progreso.html"
    click CSSDir "https://github.com/jhonuwu0934/tolearn_app_front/tree/main/css/"
    click MainJS "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/main.js"
    click NivelesJS "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/niveles.js"
    click PregCore "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/preguntas.js"
    click PregAddAPI "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/apisuma.js"
    click PregAdd "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/preguntas.js"
    click PregSubAPI "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/apirestas.js"
    click PregSub "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/preguntasrestas.js"
    click PregMulAPI "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/apimultiplicacion.js"
    click PregMul "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/preguntasmultiplicacion.js"
    click PregDivAPI "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/apidivision.js"
    click PregDiv "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/preguntasdivision.js"
    click PregMix "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/preguntasmezcladas.js"
    click FruitLogic "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/sumarfrutas.js"
    click AnimalJS "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/animal.js"
    click ProgresoJS "https://github.com/jhonuwu0934/tolearn_app_front/blob/main/js/progreso.js"
    click AudioEngine "https://github.com/jhonuwu0934/tolearn_app_front/tree/main/audio/"
    click ImagesDir "https://github.com/jhonuwu0934/tolearn_app_front/tree/main/Images/"
```
