📱 Catequesis San Pedro Claver

Aplicación educativa interactiva para la formación cristiana de niños y familias

Características • Instalación • Uso • Documentación

---

🌟 Descripción

Catequesis San Pedro Claver es una aplicación móvil diseñada para la formación religiosa de niños y familias en la Parroquia San Pedro Claver de Planeta Rica, Córdoba. La app ofrece contenido interactivo sobre los sacramentos de iniciación cristiana: Bautismo, Primera Comunión y Confirmación.

✨ Características Principales

• 🌊 Bautismo Interactivo: Explora los símbolos del bautismo (agua, luz, crisma, vestidura blanca) con actividades tap-to-reveal
• 🥖 Primera Comunión: Aprende sobre la Eucaristía con historias, actividades de ordenar la Misa, y oraciones completas
• 🔥 Confirmación: Descubre los 7 dones del Espíritu Santo con cards expandibles e interactivos
• ⛪ Galería de la Iglesia: Conoce la Parroquia San Pedro Claver con 10 fotografías
• 🔊 Audio Integrado: Text-to-Speech en español y archivos de audio pregrabados
• 🎨 Diseño Glassmorphism: Interfaz moderna con efectos de transparencia y blur
• 🎯 Actividades Interactivas: Quizzes, drag & drop, tap-to-reveal, memory games

---

🚀 Instalación

Requisitos Previos

• Flutter SDK 3.10.0 o superior
• Dart SDK (incluido con Flutter)
• Android SDK (API Level 21+)
• Android Studio o VS Code con extensiones de Flutter

Pasos de Instalación

1. Clonar el repositorio (o descargar el proyecto)

   cd Catequesis

2. Instalar dependencias

   flutter pub get

3. Verificar configuración

   flutter doctor

4. Ejecutar la aplicación

   flutter run

---

📦 Generar APK

APK de Debug (para pruebas)

flutter build apk --debug

APK de Release (para distribución)

flutter build apk --release

El APK se generará en: build/app/outputs/flutter-apk/

---

🎯 Uso

Navegación Principal

1. Pantalla de Inicio: Muestra los 3 sacramentos y opciones de galería y recursos
2. Journeys: Cada sacramento tiene su propio camino de aprendizaje con múltiples pasos
3. Actividades: Interactúa con símbolos, responde quizzes, ordena elementos
4. Audio: Toca el botón de audio en cualquier pantalla para escuchar el contenido

Actividades Disponibles

• Tap-to-Reveal: Toca símbolos para descubrir su significado
• Drag & Drop: Ordena los momentos de la Misa
• Expansion Tiles: Explora los 7 dones del Espíritu Santo
• Quiz: Responde preguntas con feedback inmediato
• Memory Game: Encuentra parejas de símbolos eucarísticos

---

🛠️ Tecnologías Utilizadas

• Framework: Flutter 3.10.0+
• Lenguaje: Dart 3.0+
• UI/UX: Material Design 3 con Glassmorphism
• Fuentes: Google Fonts (Outfit, Nunito)
• Audio: flutter_tts (Text-to-Speech), audioplayers
• Animaciones: flutter_animate

Dependencias Principales

dependencies:
  flutter:
    sdk: flutter
  google_fonts: ^6.2.1
  flutter_animate: ^4.5.0
  flutter_tts: ^3.8.3
  audioplayers: ^6.5.1

---

📁 Estructura del Proyecto

lib/
├── components/          # Componentes reutilizables
│   ├── glassmorphic_card.dart
│   ├── audio_player_button.dart
│   └── ...
├── screens/             # Pantallas de la aplicación
│   ├── home_screen.dart
│   ├── journey_screen.dart
│   ├── church_gallery_screen.dart
│   └── ...
├── services/            # Servicios (audio, contenido)
│   ├── audio_service.dart
│   └── content_service.dart
├── theme/               # Tema y estilos
│   └── app_theme.dart
└── main.dart            # Punto de entrada

assets/
├── images/              # Imágenes de la app
└── ...

Project_assets/
├── audio/               # Archivos de audio WAV
└── images/              # Imágenes originales

content.json             # Contenido de la aplicación

---

🎨 Personalización

Cambiar Colores del Tema

Edita lib/theme/app_theme.dart:

static const Color emeraldGreen = Color(0xFF009B77);  // Verde Esmeralda
static const Color skyBlue = Color(0xFF4FC3F7);       // Azul Cielo
static const Color partyRed = Color(0xFFE53935);      // Rojo Fiesta
static const Color wealthYellow = Color(0xFFFFD700);  // Amarillo

Modificar Contenido

Edita content.json para:

• Cambiar textos y descripciones
• Agregar más preguntas a los quizzes
• Añadir nuevos pasos a los journeys
• Actualizar rutas de imágenes y audios

---

📖 Documentación

• GUIA_ENTREGA.md: Guía completa de entrega con instrucciones de build, instalación y testing
• content.json: Estructura de contenido de la aplicación
• Flutter Docs: Documentación oficial de Flutter

---

🐛 Solución de Problemas

Las imágenes no cargan

• Verifica que las imágenes estén en assets/images/
• Ejecuta flutter clean y flutter pub get
• Verifica pubspec.yaml incluya las rutas correctas

Los audios no se reproducen

• Verifica que los archivos WAV estén en Project_assets/audio/
• El TTS funciona como fallback automático
• Revisa los logs: flutter logs

Error de compilación

• Ejecuta flutter clean
• Ejecuta flutter pub get
• Verifica que content.json sea JSON válido
• Ejecuta flutter doctor para verificar la configuración

---

📝 Características Implementadas

✅ Sacramentos

• Bautismo (4 símbolos, reflexiones, quiz)
• Primera Comunión (historia, actividades, oraciones, juego)
• Confirmación (7 dones, reflexión, quiz)

✅ UI/UX

• Glassmorphism design
• Animaciones suaves
• Tipografía para niños
• Colores de Planeta Rica

✅ Funcionalidades

• Sistema de audio con TTS y archivos WAV
• Actividades interactivas
• Galería de la iglesia
• Navegación fluida
• Manejo de errores robusto

---

👥 Créditos

Desarrollado para: Parroquia San Pedro Claver, Planeta Rica, Córdoba
Propósito: Formación cristiana de niños y familias
Versión: 1.0.0
Año: 2025

---

📄 Licencia

Este proyecto es privado y está destinado exclusivamente para uso de la Parroquia San Pedro Claver.

---

🙏 Agradecimientos

A todos los catequistas, padrinos y familias que hacen posible la formación cristiana de nuestros niños.

¡Que Dios bendiga este proyecto! ✨

---

Hecho con ❤️ para la formación cristiana