# angellandin/aplicacion-cbtis architecture

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

- Interactive diagram: https://gitdiagram.com/angellandin/aplicacion-cbtis
- Repository: https://github.com/angellandin/aplicacion-cbtis

## Overview

Para diseñar un diagrama de arquitectura claro y preciso de este proyecto Android (“Proyecto Social para la comunidad estudiantil de mi Institución Educativa”), sigue estos pasos:

##### Identificación del tipo de proyecto y propósito
- Es una aplicación móvil nativa Android (Java) orientada a la comunidad estudiantil.
- Usa Firebase (FCM) para notificaciones y contiene funcionalidades offline (visor de PDFs) y online (servicios cloud).

##### Análisis de la estructura de carpetas
- Módulo único `app/` con código fuente (`src/main/java/...`), tests (`src/test` y `src/androidTest`), recursos (`src/main/res`) y configuración Gradle.
- Paquetes de Java organizados por características:
· `aplicacionCbtis/Actividades` (Activities)
· `aplicacionCbtis/ui/*` (Fragments + adapters + controladores de cada sección: comunidad, convocatorias, cursos, configuraciones, home)
· Servicio de mensajería: `MyFirebaseMessagingService.java`
· Visores de PDF: múltiples actividades bajo `VisoresPDF/`
- Archivos de configuración clave: `build.gradle`, `google-services.json`, `AndroidManifest.xml`, `proguard-rules.pro`.

##### Componentes principales a representar
a. Clientes Android (Activities, Fragments y Adapters)
b. Servicios de fondo (MyFirebaseMessagingService)
c. Librerías externas:
- Firebase Cloud Messaging
- PDF Viewer (u otra librería de renderizado PDF)
d. Recursos locales (assets, layouts, drawables)
e. Build system (Gradle + Google Services Plugin)
f. Plataforma Android OS

##### Relaciones e interacciones
- El usuario interactúa con Activities/Fragments → UI layer
- UI layer invoca controladores/adapters para gestionar datos y navegación interna
- Para notificaciones push, `MyFirebaseMessagingService` recibe mensajes desde Firebase Cloud Messaging → dispara notificaciones al usuario
- Para ver documentos, las Activities de `VisoresPDF` llaman a la librería PDF Viewer sobre archivos locales o descargados
- Gradle + Google Services Plugin construyen el APK incluyendo el manifest, recursos y código

##### Patrones y principios
- Organización por feature modules (paquetes por sección)
- Separación UI / controlador (Fragments + controladores de Pager, RecyclerViewAdapters)
- Uso de servicios Android (FirebaseMessagingService) para tareas background
- Uso de recursos XML para layouts, drawables y estilos

##### Guía para el diagrama
- Usa cajas grandes para representar capas:
1) Android OS
2) Build & Deployment (Gradle, Google Services)
3) App Runtime
- UI Layer (Activities & Fragments)
- Business Logic Layer (Controladores, Adapters)
- Services Layer (`MyFirebaseMessagingService`)
- Dibuja un icono o nube para Firebase Cloud Messaging fuera de la app, con flechas bidireccionales hacia el Service.
- Incluye un contenedor de “Recursos” (layouts, drawables, assets PDF).
- Si usas librería PDF, dibuja una dependencia externa (“PDF Viewer SDK”).
- Etiqueta claramente cada componente y emplea flechas direccionales para flujos de datos:
- Usuario → UI
- UI → Controladores/Adapters
- Service ↔ Firebase FCM
- VisorPDF → Recursos
- Azul: UI Components
- Verde: Servicios / Lógica
- Naranja: Dependencias externas
- Gris: Build / Deployment

##### Elementos a incluir en el diagrama final
- Nombre de cada módulo (ej. “HomeFragment”, “ConvocatoriasFragment”, “VisorPDFActivity”) o bien agruparlos por feature (“Comunidad UI”, “Convocatorias UI”, etc.)
- Flechas que indiquen dirección de interacción o flujo de eventos
- Diferentes formas o colores para distinguir:
- Activities/Fragments vs. Services vs. SDKs vs. Recursos
- Notas o leyenda que expliquen el significado de colores y formas

Con este enfoque obtendrás un diagrama modular, claro y alineado con la arquitectura real del proyecto, resaltando tanto la organización interna del código como las interacciones con servicios externos (Firebase) y librerías de terceros.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Build & Deployment Layer
    subgraph "Build & Deployment"
        GradleRoot["Root build.gradle & settings"]:::build
        AppGradle["App Module build.gradle & configs"]:::build
        Manifest["AndroidManifest.xml"]:::build
    end

    %% App Runtime Layer
    subgraph "App Runtime"
        subgraph "UI Layer"
            Activities["Activities Layer"]:::frontend
            Fragments["Fragments Layer"]:::frontend
        end
        subgraph "Business Logic Layer"
            subgraph "Comunidad Feature"
                ComunCtrl["Controllers & Adapters"]:::logic
            end
            subgraph "Convocatorias Feature"
                ConvocCtrl["Adapters & Controllers"]:::logic
            end
            subgraph "Cursos Feature"
                CursosCtrl["Pager & Controllers"]:::logic
                CuadAdapters["Cuadernillos Adapters"]:::logic
                CursosAdapters["Cursos Adapters"]:::logic
            end
            subgraph "Configuraciones Feature"
                ConfigCtrl["Ajustes Adapters"]:::logic
            end
            subgraph "Home Feature"
                HomeCtrl["Avisos Adapters"]:::logic
            end
        end
        subgraph "Services Layer"
            FirebaseService["MyFirebaseMessagingService"]:::logic
        end
        subgraph "Resources"
            Resources["Layouts, Drawables, Assets"]:::resources
        end
    end

    %% External Dependencies
    FirebaseFCM["Firebase Cloud Messaging"]:::external
    PDFSDK["PDF Viewer SDK"]:::external
    User["User"]:::external
    AndroidOS["Android OS"]:::external

    %% Connections
    User -->|"interacts with"| Activities
    Activities -->|"navigates to"| Fragments
    Fragments -->|"uses"| ComunCtrl
    Fragments -->|"uses"| ConvocCtrl
    Fragments -->|"uses"| CursosCtrl
    CursosCtrl -->|"renders list"| CursosAdapters
    CursosCtrl -->|"renders list"| CuadAdapters
    Fragments -->|"uses"| ConfigCtrl
    Fragments -->|"uses"| HomeCtrl
    ComunCtrl -->|"loads PDFs"| PDFSDK
    CuadAdapters -->|"loads PDFs"| PDFSDK
    ComunCtrl -->|"reads resources"| Resources
    CursosCtrl -->|"reads resources"| Resources
    ConfigCtrl -->|"reads resources"| Resources
    HomeCtrl -->|"reads resources"| Resources
    FirebaseFCM <-->|"push messages"| FirebaseService
    FirebaseService -->|"notifies"| User
    GradleRoot -->|"builds"| AppGradle
    AppGradle -->|"packages"| Activities
    AppGradle -->|"includes"| Resources
    Manifest -->|"defines app"| AppGradle
    Activities -->|"runs on"| AndroidOS
    FirebaseService -->|"runs on"| AndroidOS

    %% Click Events
    click Activities "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/java/cbtis/app/aplicacionCbtis/Actividades"
    click Fragments "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/java/cbtis/app/aplicacionCbtis/ui"
    click ComunCtrl "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/java/cbtis/app/aplicacionCbtis/ui/comunidad/controlador"
    click ConvocCtrl "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/java/cbtis/app/aplicacionCbtis/ui/convocatorias/adapter"
    click CursosCtrl "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/java/cbtis/app/aplicacionCbtis/ui/cursos/controlador"
    click CuadAdapters "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/java/cbtis/app/aplicacionCbtis/ui/cursos/adapterCuadernillos"
    click CursosAdapters "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/java/cbtis/app/aplicacionCbtis/ui/cursos/adapterCursos"
    click ConfigCtrl "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/java/cbtis/app/aplicacionCbtis/ui/configuraciones/adapterAjustes"
    click HomeCtrl "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/java/cbtis/app/aplicacionCbtis/ui/home/adapterAvisos"
    click FirebaseService "https://github.com/angellandin/aplicacion-cbtis/blob/main/app/src/main/java/cbtis/app/aplicacionCbtis/MyFirebaseMessagingService.java"
    click Resources "https://github.com/angellandin/aplicacion-cbtis/tree/main/app/src/main/res"
    click GradleRoot "https://github.com/angellandin/aplicacion-cbtis/blob/main/build.gradle"
    click AppGradle "https://github.com/angellandin/aplicacion-cbtis/blob/main/app/build.gradle"
    click Manifest "https://github.com/angellandin/aplicacion-cbtis/blob/main/app/src/main/AndroidManifest.xml"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0284C7,stroke-width:1px
    classDef logic fill:#E0F8E9,stroke:#059669,stroke-width:1px
    classDef external fill:#FFF4E5,stroke:#EA580C,stroke-width:1px
    classDef build fill:#F3F4F6,stroke:#6B7280,stroke-width:1px
    classDef resources fill:#F5E1FF,stroke:#9333EA,stroke-width:1px
```
