# relic7663/proyectospersonalesyactividades_utn architecture

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

- Interactive diagram: https://gitdiagram.com/relic7663/proyectospersonalesyactividades_utn
- Repository: https://github.com/relic7663/proyectospersonalesyactividades_utn

## Overview

Para guiar al ingeniero a confeccionar un diagrama de arquitectura claro y detallado de este proyecto Android (“Gestor de Proyectos Personales – UTN”), podemos seguir estos pasos:

##### Identificación del tipo de proyecto y su propósito
- Es una aplicación móvil nativa Android escrita en Kotlin.
- Su objetivo es ofrecer gestión de usuarios (autenticación), CRUD de proyectos, seguimiento de actividades y persistencia local en SQLite.
- Emplea el patrón MVVM y Jetpack Navigation, con una capa de acceso a datos propia (DataController + DBHelper).

##### Análisis de la estructura de archivos
- Módulo “app” contiene todo el código de la aplicación.
- Paquetes clave:
- auth: controlador de datos (DataController) que actúa como repositorio.
- database: helper para abrir/consultar la base de datos SQLite.
- models: entidades Kotlin que reflejan las tablas (User, Project, Activity).
- ui/navigation: host de navegación (AppNavHost) con NavGraph.
- ui/screens: pantallas Compose/KTX de Login, Register, Projects, Activities.
- viewmodel: MainViewModel que expone datos a la UI y orquesta llamadas a DataController.
- Recursos: layouts XML, themes, assets, navigation XML.
- Tests y configuraciones gradle para CI/build.

##### Elementos principales para el diagrama
a. Componentes:
1. UI Layer
- MainActivity
- AppNavHost (Jetpack Navigation)
- Pantallas (LoginScreen, RegisterScreen, ProjectsScreen, ActivitiesScreen)
2. ViewModel Layer
- MainViewModel
3. Data Layer
- DataController (repositorio)
- DBHelper (SQLiteOpenHelper)
4. Persistence
- SQLite Database (Users, Projects, Activities)
5. (Opcional) System/Android Framework
- Android OS (Lifecycle, Room si existiera, Permissions)
b. Relaciones e interacciones:
- UI → ViewModel: invoca métodos expuestos (login, loadProjects, etc.) y observa LiveData/StateFlow.
- ViewModel → DataController: solicita operaciones CRUD.
- DataController → DBHelper: abre conexiones, ejecuta queries SQL, mapea results a models.
- DBHelper → SQLite: capa real de almacenamiento local.
- AppNavHost gestiona flujos de navegación entre pantallas.
c. Patrones y principios:
- MVVM: separación entre vista (UI) y lógica de negocio (ViewModel).
- Repository Pattern: DataController centraliza acceso a datos.
- Dependencia unidireccional de la UI hacia la capa de datos.
d. Tecnologías clave:
- Kotlin + Coroutines / LiveData o StateFlow
- Android Jetpack (Navigation, ViewModel)
- SQLite a través de DBHelper
- XML + Jetpack Compose (según implementación en .kt)

##### Guía para confeccionar el diagrama
- Usar cajas/rectángulos distintos para cada capa (por ejemplo, azules para UI, verdes para ViewModel, naranjas para Data).
- Etiquetar claramente cada componente con su nombre de paquete o clase principal.
- Dibujar flechas dirigidas que indiquen flujo de datos o llamadas de método:
- UI → ViewModel → DataController → DBHelper → SQLite
- DBHelper → DataController → ViewModel → UI (flujo de datos de vuelta)
- Incorporar un contorno que represente el “módulo app” y dentro agrupar los componentes.
- Opcional: incluir referencia al Android Framework (API Level) y a componentes del sistema como Activity/Fragment lifecycle.

##### Aspectos específicos de un proyecto Android de este tipo
- Separar la capa de navegación (AppNavHost y nav_graph.xml) dentro de la capa UI.
- Marcar el boundary entre componentes Android (Activity, OS) y nuestro código.
- Mostrar la persistencia local (SQLite) como un servicio/interno, sin backend remoto.
- Si en el futuro existiera integración con servicios externos (ej. API REST), dibujar las flechas e iconos HTTP/API.

##### Elementos imprescindibles en el diagrama final
- Etiquetas claras: nombres de clases y paquetes clave.
- Flechas direccionales: indicar llamadas y retorno de datos.
- Colores o formas distintas: diferenciar UI, lógica de negocio, acceso a datos y almacenamiento.
- Agrupaciones por capa o módulo.

Con esta guía, el ingeniero podrá representar de forma precisa y detallada la arquitectura de “Gestor de Proyectos Personales – UTN”, resaltando tanto el flujo de interacción usuario–datos como los patrones (MVVM, Repository) y tecnologías (Kotlin, Jetpack, SQLite) utilizados.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Module boundary
    subgraph "Module: app" 
        class AppModule module

        %% UI Layer
        subgraph "UI Layer" 
            classDef ui fill:#D0E8FF,stroke:#0366D6
            MainActivity["MainActivity"]:::ui
            AppNavHost["AppNavHost"]:::ui
            LoginScreen["LoginScreen"]:::ui
            RegisterScreen["RegisterScreen"]:::ui
            ProjectsScreen["ProjectsScreen"]:::ui
            ActivitiesScreen["ActivitiesScreen"]:::ui
            NavGraph["nav_graph.xml"]:::resource
        end

        %% ViewModel Layer
        subgraph "ViewModel Layer"
            classDef vm fill:#DFFFE0,stroke:#28A745
            MainViewModel["MainViewModel"]:::vm
        end

        %% Data Layer
        subgraph "Data Layer"
            classDef data fill:#FFE5B4,stroke:#FF8C00
            DataController["DataController"]:::data
            DBHelper["DBHelper"]:::data
        end

        %% Models
        subgraph "Models"
            classDef model fill:#F0E68C,stroke:#B8860B
            UserModel["User.kt"]:::model
            ProjectModel["Project.kt"]:::model
            ActivityModel["Activity.kt"]:::model
        end

        %% Persistence
        SQLiteDB["SQLite Database"]:::db
    end

    %% Android Framework
    AndroidOS["Android OS"]:::android

    %% Connections
    MainActivity -->|"hosts"| AppNavHost
    AppNavHost -->|uses NavGraph| NavGraph
    AppNavHost -->|navigates to| LoginScreen
    AppNavHost -->|navigates to| RegisterScreen
    AppNavHost -->|navigates to| ProjectsScreen
    AppNavHost -->|navigates to| ActivitiesScreen

    LoginScreen -->|"calls login() / register()"| MainViewModel
    RegisterScreen -->|"calls register()"| MainViewModel
    ProjectsScreen -->|"calls loadProjects()"| MainViewModel
    ActivitiesScreen -->|"calls loadActivities()"| MainViewModel

    MainViewModel -->|"CRUD operations"| DataController
    DataController -->|"executes queries"| DBHelper
    DBHelper -->|"reads/writes"| SQLiteDB

    DBHelper -->|"maps results"| DataController
    DataController -->|"returns data"| MainViewModel
    MainViewModel -->|"updates UI"| LoginScreen
    MainViewModel -->|"updates UI"| RegisterScreen
    MainViewModel -->|"updates UI"| ProjectsScreen
    MainViewModel -->|"updates UI"| ActivitiesScreen

    MainActivity -->|"lifecycle events"| AndroidOS
    DBHelper -->|"uses SQLite APIs"| AndroidOS

    %% Click Events
    click MainActivity "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/MainActivity.kt"
    click AppNavHost "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/ui/navigation/AppNavHost.kt"
    click LoginScreen "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/ui/screens/LoginScreen.kt"
    click RegisterScreen "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/ui/screens/RegisterScreen.kt"
    click ProjectsScreen "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/ui/screens/ProjectsScreen.kt"
    click ActivitiesScreen "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/ui/screens/ActivitiesScreen.kt"
    click NavGraph "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/res/navigation/nav_graph.xml"
    click MainViewModel "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/viewmodel/MainViewModel.kt"
    click DataController "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/auth/DataController.kt"
    click DBHelper "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/database/dbhelper.kt"
    click UserModel "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/models/User.kt"
    click ProjectModel "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/models/Project.kt"
    click ActivityModel "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/src/main/java/com/example/proyectospersonalesyactividades_utn/models/Activity.kt"
    click AppModule "https://github.com/relic7663/proyectospersonalesyactividades_utn/blob/main/app/build.gradle.kts"

    %% Styles
    classDef module fill:#F5F5F5,stroke:#555
    classDef resource fill:#FFEAF0,stroke:#D63384
    classDef db fill:#FFF5BA,stroke:#DAA520
    classDef android fill:#E8E8E8,stroke:#888888

    class MainActivity,AppNavHost,LoginScreen,RegisterScreen,ProjectsScreen,ActivitiesScreen ui
    class MainViewModel vm
    class DataController,DBHelper data
    class UserModel,ProjectModel,ActivityModel model
    class SQLiteDB db
    class NavGraph resource
    class AndroidOS android
```
