How angellandin/aplicacion-cbtis works
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.