# miguelramosalarcon/novaserviciosapp architecture

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

- Interactive diagram: https://gitdiagram.com/miguelramosalarcon/novaserviciosapp
- Repository: https://github.com/miguelramosalarcon/novaserviciosapp

## Overview

##### Tipo y propósito del proyecto (qué diagrama conviene)
Por el árbol de archivos y el README, esto es una **aplicación Android nativa (Java)** construida con **Gradle**, con **UI en Activities + layouts XML**, y **persistencia local en SQLite** (vía `NovaDbHelper`). El README además declara una fase de **consumo de API REST (JSON)**, aunque **en el código actual no se ve** un cliente HTTP/REST; por tanto, en el diagrama conviene:
- Representar **lo que existe hoy** (UI + lógica + SQLite).
- Representar como **bloque opcional / planificado** la integración REST (HT04) si el objetivo es “arquitectura objetivo”.

##### Análisis estructural (cómo mapear carpetas a componentes)
Estructura relevante en `app/src/main/java/com/example/novaserviciosapp`:

- `ui/`
- `MainActivity.java`
- `ServiceListActivity.java`
- `AddServiceActivity.java`
=> **Capa de presentación** (pantallas / navegación / eventos UI).

- `model/Servicio.java`
=> **Modelo de dominio / DTO** (estructura de “Servicio”).

- `data/local/NovaDbHelper.java`
=> **Persistencia local** (SQLiteOpenHelper o equivalente): creación de tablas + CRUD.

Y en `app/src/main/res/`:
- `layout/` (`activity_main.xml`, `activity_service_list.xml`, `activity_add_service.xml`) => **Vistas XML**.
- `AndroidManifest.xml` => **definición de Activities, permisos, configuración app**.

Tests:
- `src/test` unit tests (JVM)
- `src/androidTest` instrumented tests (device/emulator)

Build/packaging:
- `build.gradle.kts` (root + app)
- `proguard-rules.pro` (shrink/obfuscation)
- `gradle/libs.versions.toml` (version catalog)

##### Qué diagramas dibujar (para “best and most accurate”)
Para una app Android pequeña/mediana, lo más claro y exacto es dibujar **3 niveles** (tipo C4 adaptado a móvil):

##### Diagrama de Contexto (Sistema en su entorno)
Objetivo: mostrar “quién usa la app” y “con qué se integra”.
**Elementos mínimos:**
- **Usuario** (Cliente/Operario) usando
- **Nova Servicios App (Android)** ejecutándose en
- **Dispositivo Android / Android OS**
- **SQLite (local, on-device)** como almacenamiento
- **API REST (externa, opcional/HT04)** como integración futura (marcar como “planned” si no existe aún)

Relaciones (flechas):
- Usuario → App (interacción UI)
- App ↔ SQLite (CRUD local)
- App ↔ API REST (HTTP/JSON) *(si decides incluirlo, diferéncialo como no implementado aún)*

##### Diagrama de Contenedores / Sub-sistemas (dentro de la app)
Objetivo: separar claramente UI, dominio y datos.

**Contenedores recomendados (bloques):**
##### UI Layer (Activities + XML Layouts)
- `MainActivity` + `activity_main.xml`
- `ServiceListActivity` + `activity_service_list.xml`
- `AddServiceActivity` + `activity_add_service.xml`

##### Domain/Model
- `Servicio`

##### Data Layer
- `NovaDbHelper` (local DB gateway)
- (Opcional futuro) `RemoteApiClient / Repository` (si HT04 se implementa)

##### Local Storage
- SQLite Database (tablas de servicios)

**Flechas (dirección de dependencias):**
- Activities → NovaDbHelper (llamadas CRUD)
- NovaDbHelper ↔ SQLite DB (SQL queries)
- Activities ↔ Servicio (creación/consumo de objetos del modelo)

**Nota importante de precisión:** en este repo no aparece un patrón MVVM/MVP con `ViewModel/Repository`; por tanto, si hoy las Activities llaman directo al DB helper, el diagrama debe reflejarlo (aunque arquitectónicamente “ideal” sería interponer repositorios).

##### Diagrama de Componentes (nivel clase/paquete, “as many components as possible”)
Objetivo: detallar componentes internos sin inventar capas.

**Componentes concretos (directamente del árbol):**
- `com.example.novaserviciosapp.ui`
- `MainActivity` (menú/landing)
- `ServiceListActivity` (consulta/listado)
- `AddServiceActivity` (registro/alta)
- `com.example.novaserviciosapp.data.local`
- `NovaDbHelper` (schema + CRUD)
- `com.example.novaserviciosapp.model`
- `Servicio`

**Relaciones típicas a dibujar:**
- `AddServiceActivity` → `NovaDbHelper.insertServicio(...)` → SQLite
- `ServiceListActivity` → `NovaDbHelper.getServicios(...)` → SQLite → devuelve `List<Servicio>`
- `MainActivity` → navegación (Intents) → `AddServiceActivity` / `ServiceListActivity`

Aquí conviene un sub-diagrama de **navegación** (pantallas) porque es parte esencial de apps Android:
- `MainActivity` --(Intent)--> `AddServiceActivity`
- `MainActivity` --(Intent)--> `ServiceListActivity`
- (Opcional) `ServiceListActivity` --(Back/Up)--> `MainActivity`

##### Interacciones clave (qué “flows” dibujar como secuencia)
Incluye 2 diagramas de secuencia simples (muy útiles para exactitud):

##### Mapea filas a `Servicio`
5. UI renderiza (ListView/RecyclerView) *(en README se menciona, en el árbol no se ve el adapter; si no existe, no lo inventes: pon “UI List Component” genérico)*

Si vas a incluir REST (arquitectura objetivo HT04), agrega un Flow 3 “Sincronizar”:
- `ServiceListActivity`/“Sync use case” → HTTP Client → API REST → JSON → parse → persist en SQLite → render.

##### Tecnologías y artefactos que deben verse en el diagrama
Etiquetas recomendadas en los bloques:
- **Android App (Java)**, **Activities**, **Intents**
- **SQLite (on-device)**, `NovaDbHelper`
- **XML Layouts** (res/layout)
- **Gradle build** (opcional en diagrama de build/deploy)
- **AndroidManifest** (opcional como “configuración runtime”)

Y si incluyes lo futuro:
- **REST API (JSON)**, **HTTP client** (biblioteca a definir)

##### Checklist final de “exactitud” contra este repo
- [ ] ¿Todas las Activities del paquete `ui/` están en el diagrama?
- [ ] ¿`Servicio` aparece como modelo central?
- [ ] ¿`NovaDbHelper` aparece como único acceso a SQLite?
- [ ] ¿Se ve SQLite como almacenamiento local (en el dispositivo)?
- [ ] ¿Navegación por Intents entre pantallas está dibujada?
- [ ] Si se muestra REST API: ¿está marcado como fase HT04 / futuro si no hay implementación?
- [ ] Recursos XML (layouts/themes) aparecen al menos como parte de UI (sin entrar a cada drawable salvo que sea relevante).

##### Secuencias: “Registrar” y “Listar” (y “Sync” si aplica)

Con esto obtienes un diagrama que es a la vez **fiel al árbol actual** y lo bastante **detallado** como para comunicar arquitectura y evolución por fases (HT01–HT05).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% =========================================================
    %% Context (System in environment)
    %% =========================================================
    subgraph "Contexto"
        User["Usuario"]:::external
        Device["Dispositivo Android\n(Android OS)"]:::platform

        subgraph "Nova Servicios App (Android / Java)"
            App["Aplicación Android"]:::app
        end

        SQLite[("SQLite (on-device)")]:::db
        RestApi["API REST (JSON)\n(Planned / HT04)"]:::externalPlanned
    end

    User -->|"interactúa(UI)"| App
    App -->|"se ejecuta_en"| Device
    App <-->|"CRUD(local)"| SQLite
    App <-.->|"HTTP/JSON(planned)"| RestApi

    %% =========================================================
    %% Containers / Subsystems
    %% =========================================================
    subgraph "Contenedores internos (dentro de la app)"
        direction TB

        subgraph "UI Layer (Activities + XML Layouts)"
            direction TB
            UI_Pkg["ui/ (package)"]:::ui

            MainAct["MainActivity\n(Landing / Menú)"]:::ui
            MainXml["activity_main.xml\n(Layout)"]:::xml

            ListAct["ServiceListActivity\n(Listado/Consulta)"]:::ui
            ListXml["activity_service_list.xml\n(Layout)"]:::xml
            UIList["UI List Component\n(ListView/RecyclerView - genérico)"]:::ui

            AddAct["AddServiceActivity\n(Alta/Registro)"]:::ui
            AddXml["activity_add_service.xml\n(Layout)"]:::xml

            Values["res/values/\n(strings,colors,themes)"]:::res
            NightTheme["values-night/themes.xml"]:::res
            Drawables["res/drawable/\n(iconos)"]:::res
        end

        subgraph "Domain / Model"
            direction TB
            Model_Pkg["model/ (package)"]:::domain
            Servicio["Servicio\n(DTO / Dominio)"]:::domain
        end

        subgraph "Data Layer (Local Persistence)"
            direction TB
            DataLocal_Pkg["data/local/ (package)"]:::data
            DbHelper["NovaDbHelper\n(SQLite gateway: schema + CRUD)"]:::data
        end

        subgraph "Runtime Config"
            direction TB
            Manifest["AndroidManifest.xml\n(Activities/permisos/config)"]:::config
        end

        subgraph "Planned (HT04)"
            direction TB
            RemoteClient["HTTP Client / RemoteApiClient\n(TBD)"]:::planned
            SyncUseCase["Sync / Import-Export\n(TBD)"]:::planned
        end
    end

    %% UI bindings (Layouts/Resources)
    MainAct -->|"renderiza_con"| MainXml
    ListAct -->|"renderiza_con"| ListXml
    AddAct -->|"renderiza_con"| AddXml

    MainXml -->|"usa"| Values
    ListXml -->|"usa"| Values
    AddXml -->|"usa"| Values
    Values -->|"tema"| NightTheme
    MainXml -->|"iconos"| Drawables
    ListXml -->|"iconos"| Drawables
    AddXml -->|"iconos"| Drawables

    %% Navigation (Intents)
    MainAct -->|"Intent(navega)"| AddAct
    MainAct -->|"Intent(navega)"| ListAct
    ListAct -->|"Back/Up"| MainAct

    %% Data access (current state: Activities call DbHelper directly)
    AddAct -->|"insertServicio(...)"| DbHelper
    ListAct -->|"getServicios(...)"| DbHelper
    DbHelper <-->|"SQL(INSERT/SELECT/UPDATE/DELETE)"| SQLite

    %% Model usage
    AddAct -->|"crea/valida"| Servicio
    ListAct <-->|"List<Servicio>"| Servicio
    DbHelper -->|"mapea_filas_a"| Servicio
    ListAct -->|"renderiza_items_en"| UIList

    %% Manifest relations
    Manifest -->|"declara"| MainAct
    Manifest -->|"declara"| ListAct
    Manifest -->|"declara"| AddAct

    %% Planned REST sync (optional / future)
    ListAct -.->|"trigger_sync(planned)"| SyncUseCase
    SyncUseCase -.->|"usa"| RemoteClient
    RemoteClient -.->|"HTTP/JSON"| RestApi
    SyncUseCase -.->|"persist_en"| DbHelper

    %% =========================================================
    %% Build & Test (supporting artifacts)
    %% =========================================================
    subgraph "Build & Tests"
        direction TB
        RootGradle["Gradle (root)\nbuild.gradle.kts"]:::build
        AppGradle["Gradle (app module)\napp/build.gradle.kts"]:::build
        Versions["Version Catalog\ngradle/libs.versions.toml"]:::build
        Proguard["Proguard/R8 Rules\napp/proguard-rules.pro"]:::build

        UnitTest["Unit Test\nExampleUnitTest (JVM)"]:::test
        InstrTest["Instrumented Test\nExampleInstrumentedTest (Android)"]:::test
    end

    RootGradle -->|"configura"| AppGradle
    Versions -->|"provee_deps"| AppGradle
    Proguard -->|"shrink/obfuscate"| AppGradle

    UnitTest -->|"testea(lógica)"| Servicio
    InstrTest -->|"testea(UI/DB)"| MainAct
    InstrTest -->|"testea(UI/DB)"| ListAct
    InstrTest -->|"testea(UI/DB)"| AddAct
    InstrTest -->|"testea(SQLite)"| DbHelper

    %% =========================================================
    %% Click events (from component_mapping) - paths only
    %% =========================================================
    click UI_Pkg "https://github.com/miguelramosalarcon/novaserviciosapp/tree/master/app/src/main/java/com/example/novaserviciosapp/ui/"
    click MainAct "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/java/com/example/novaserviciosapp/ui/MainActivity.java"
    click ListAct "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/java/com/example/novaserviciosapp/ui/ServiceListActivity.java"
    click AddAct "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/java/com/example/novaserviciosapp/ui/AddServiceActivity.java"

    click MainXml "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/res/layout/activity_main.xml"
    click ListXml "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/res/layout/activity_service_list.xml"
    click AddXml "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/res/layout/activity_add_service.xml"
    click Values "https://github.com/miguelramosalarcon/novaserviciosapp/tree/master/app/src/main/res/values/"
    click NightTheme "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/res/values-night/themes.xml"
    click Drawables "https://github.com/miguelramosalarcon/novaserviciosapp/tree/master/app/src/main/res/drawable/"
    click Manifest "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/AndroidManifest.xml"

    click Servicio "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/java/com/example/novaserviciosapp/model/Servicio.java"
    click Model_Pkg "https://github.com/miguelramosalarcon/novaserviciosapp/tree/master/app/src/main/java/com/example/novaserviciosapp/model/"

    click DataLocal_Pkg "https://github.com/miguelramosalarcon/novaserviciosapp/tree/master/app/src/main/java/com/example/novaserviciosapp/data/local/"
    click DbHelper "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/main/java/com/example/novaserviciosapp/data/local/NovaDbHelper.java"

    click UnitTest "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/test/java/com/example/novaserviciosapp/ExampleUnitTest.java"
    click InstrTest "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/src/androidTest/java/com/example/novaserviciosapp/ExampleInstrumentedTest.java"

    click AppGradle "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/build.gradle.kts"
    click RootGradle "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/build.gradle.kts"
    click Versions "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/gradle/libs.versions.toml"
    click Proguard "https://github.com/miguelramosalarcon/novaserviciosapp/blob/master/app/proguard-rules.pro"
    click MainXml "https://github.com/miguelramosalarcon/novaserviciosapp/tree/master/app/src/main/res/layout/"
    click ListXml "https://github.com/miguelramosalarcon/novaserviciosapp/tree/master/app/src/main/res/layout/"
    click AddXml "https://github.com/miguelramosalarcon/novaserviciosapp/tree/master/app/src/main/res/layout/"

    %% =========================================================
    %% Styles (color is critical)
    %% =========================================================
    classDef external fill:#E8F5E9,stroke:#1B5E20,stroke-width:1.5px,color:#0B2E13
    classDef externalPlanned fill:#E8F5E9,stroke:#1B5E20,stroke-width:1.5px,color:#0B2E13,stroke-dasharray: 6 4
    classDef platform fill:#ECEFF1,stroke:#455A64,stroke-width:1.5px,color:#1C2B33
    classDef app fill:#FFFDE7,stroke:#F57F17,stroke-width:1.5px,color:#4E3B05

    classDef ui fill:#E3F2FD,stroke:#1565C0,stroke-width:1.5px,color:#0B2A4A
    classDef xml fill:#E1F5FE,stroke:#0277BD,stroke-width:1.5px,color:#06324A
    classDef res fill:#E3F2FD,stroke:#1976D2,stroke-width:1.5px,color:#0B2A4A

    classDef domain fill:#F3E5F5,stroke:#6A1B9A,stroke-width:1.5px,color:#2B0B3A
    classDef data fill:#FFF3E0,stroke:#EF6C00,stroke-width:1.5px,color:#4A1F00
    classDef db fill:#ECEFF1,stroke:#37474F,stroke-width:2px,color:#111A1F

    classDef config fill:#FFF8E1,stroke:#FF8F00,stroke-width:1.5px,color:#4A2A00
    classDef planned fill:#F1F8E9,stroke:#558B2F,stroke-width:1.5px,color:#1D2B10,stroke-dasharray: 6 4

    classDef build fill:#FCE4EC,stroke:#AD1457,stroke-width:1.5px,color:#4A0B23
    classDef test fill:#E0F7FA,stroke:#00838F,stroke-width:1.5px,color:#03363A
```
