Guía de desarrollo - Primeros Auxilios AR

1. Repositorio en GitHub (acceso privado)

El código fuente del proyecto está alojado en GitHub. El repositorio es privado, por lo que solo las personas autorizadas pueden verlo y descargarlo.

URL del repositorio:
https://github.com/Jhan321/primeros_auxilios_ar

Cómo solicitar acceso

Paso 1 — Contactar al desarrollador Envíe un correo a contacto@jhanstudios.com (o use el teléfono +57 314 717 7797) indicando que desea acceso al repositorio primeros_auxilios_ar.

Paso 2 — Indicar su usuario de GitHub Incluya en el mensaje su nombre de usuario de GitHub (por ejemplo: mi_usuario). Si aún no tiene cuenta, puede crearla gratis en github.com/join.

Paso 3 — Invitación El desarrollador le enviará una invitación como colaborador del repositorio. Recibirá un correo de GitHub; debe aceptar la invitación para poder acceder.

Paso 4 — Clonar o descargar Una vez aceptada la invitación, podrá clonar el proyecto con:
git clone https://github.com/Jhan321/primeros_auxilios_ar.git
o descargar el código en ZIP desde la página del repositorio.

Nota: Si el repositorio pasa a ser público en el futuro, no será necesario solicitar permiso; cualquier persona podrá clonarlo. Mientras sea privado, solo los colaboradores añadidos tendrán acceso.

2. Creación de la app en Flutter

La aplicación se desarrolló con Flutter, el framework de Google para aplicaciones multiplataforma (móvil, web, escritorio). Un solo código base sirve para Android, iOS y, con limitaciones, web.

Flutter SDK 3.9.2+ y Dart 3.9.2+
Estructura estándar: lib/ (código Dart), android/, ios/, assets/ (imágenes, modelos 3D, etc.)
Punto de entrada: lib/main.dart — define el flujo inicial: splash → selección de idioma → registro → menú principal

Comandos básicos:

Instalar dependencias: flutter pub get
Ejecutar en desarrollo: flutter run
Generar APK (Android): flutter build apk
Generar para iOS: flutter build ios

3. Estructura del proyecto

Resumen de carpetas y archivos clave:

Carpeta / archivo	Qué contiene
`lib/main.dart`	Entrada de la app, rutas y pantalla inicial
`lib/core/`	Constantes (app_constants.dart) y tema (app_theme.dart)
`lib/models/`	Modelos de datos (usuario, etc.)
`lib/screens/`	Todas las pantallas (splash, idioma, registro, menú, contenido, AR, quiz, referencias, términos)
`lib/services/`	Lógica de negocio: autenticación, formularios, TTS, AR, idioma
`lib/widgets/`	Componentes reutilizables (botones de referencias, quiz, etc.)
`assets/`	Imágenes y recursos; `assets/models/` son los modelos 3D (.glb)
`android/`, `ios/`	Configuración nativa (permisos, iconos, builds)
`pubspec.yaml`	Dependencias del proyecto y lista de assets

Documentos útiles en la raíz del repo: README.md (visión general e instalación) y ESTRUCTURA.md (detalle de la estructura y configuración).

4. Dónde cambiar textos, pantallas y configuración

Referencia rápida para encontrar lo que quiere modificar:

Textos y contenido educativo

lib/screens/content/content_screen.dart — Contenido genérico (importancia de primeros auxilios, evaluación inicial, etc.).
lib/screens/emergency/emergency_content_screen.dart — Textos de emergencias (RCP, atragantamiento, hemorragias, quemaduras, fracturas, shock).
lib/screens/quiz/ — Cuestionarios por tema (preguntas, respuestas y explicaciones).
lib/screens/references/ — Referencias bibliográficas.

Pantallas y flujo

lib/main.dart — Rutas y pantalla inicial.
lib/screens/splash_screen.dart — Pantalla de inicio con logo.
lib/screens/language_screen.dart — Selección de idioma (ES/EN).
lib/screens/registration_screen.dart — Formulario de registro (campos, validaciones).
lib/screens/main_menu_screen.dart — Menú principal, grid de secciones y menú desplegable.

Colores y tema visual

lib/core/theme/app_theme.dart — Tema global, paleta (naranja, teal, azul) y estilos.

Constantes y configuración

lib/core/constants/app_constants.dart — URLs de Google Forms, entry IDs de campos, rutas de modelos AR, duración del splash, configuración TTS.

Realidad Aumentada (AR)

lib/services/ar_service.dart — Apertura de AR (Android Scene Viewer, iOS Quick Look, enlaces Lensyar).
lib/screens/ar/ar_maneuvers_screen.dart — Lista de maniobras AR mostrada al usuario.
lib/screens/ar/ar_viewer_screen.dart — Pantalla del visor AR: vista previa 3D, instrucciones paso a paso y narración.
assets/models/ — Modelos 3D en formato .glb (y .usdz para iOS si se usan).

Narración (TTS), idioma y formularios

lib/services/tts_service.dart — Text-to-Speech (velocidad, idioma, reproducción).
lib/services/locale_service.dart — Idioma de la aplicación.
lib/services/form_service.dart — Envío a Google Forms (registro y resultados de cuestionarios).
lib/models/user_model.dart — Campos del usuario (registro).

5. Tecnologías usadas

Tecnología	Uso en la app
Flutter 3.9.2+ / Dart 3.9.2+	Framework y lenguaje del proyecto
flutter_tts	Narración automática del contenido (TTS)
http	Envío de datos a Google Forms (registro y quiz)
url_launcher	Abrir enlaces (p. ej. Lensyar en el navegador, iOS)
android_intent_plus	Lanzar Google Scene Viewer en Android para AR
shared_preferences	Guardar preferencias (idioma, sesión de usuario)
intl / flutter_localizations	Internacionalización (español e inglés)
google_fonts	Tipografía (con fallback a fuentes del sistema)
model_viewer_plus	Vista previa 3D de modelos .glb dentro de la app

Plataformas objetivo: Android (API 21+), iOS (12.0+). Existe estructura base para web, macOS, Linux y Windows.

6. Instalación y primeros pasos

Requisitos

Flutter SDK 3.9.2 o superior (y Dart incluido)
Android Studio o Xcode para compilar para móvil
Git (para clonar el repositorio)

Pasos después de tener acceso al repo

1. Clonar el repositorio

git clone https://github.com/Jhan321/primeros_auxilios_ar.git
cd primeros_auxilios_ar

2. Instalar dependencias

flutter pub get

3. Ejecutar la app Conecte un dispositivo o inicie un emulador y ejecute: flutter run

4. Generar APK (Android) flutter build apk — el APK se genera en build/app/outputs/flutter-apk/.

Para más detalles (iconos, configuración de Forms, etc.) consulte el README.md del proyecto.

7. Configuración importante

Google Forms

Los datos de registro y de cuestionarios se envían a formularios de Google. Para usar sus propios formularios:

Cree los formularios en Google Forms y obtenga la URL de envío y los entry IDs de cada campo.
Actualice lib/core/constants/app_constants.dart: registrationFormUrl, quizFormUrl y todos los formField* con los IDs correctos.

Modelos AR

La app usa modelos locales en assets/models/ (archivos .glb) y enlaces a Lensyar para abrir experiencias AR en el navegador. Las URLs de Lensyar están definidas en lib/screens/ar/ar_viewer_screen.dart. Si añade nuevas maniobras, debe registrar allí la URL correspondiente y, si aplica, el archivo .glb en assets/models/ y en pubspec.yaml.

Permisos

Internet y estado de red están declarados en android/app/src/main/AndroidManifest.xml y en ios/Runner/Info.plist según necesidad. Si integra cámara o almacenamiento, hay que añadir los permisos correspondientes.

8. Enlaces Web AR (Lensyar)

Los proyectos de Realidad Aumentada están disponibles en la web a través de lensyar.com. Puede abrirlos desde la app o compartir el enlace para ver los modelos en el navegador:

Botiquín — id=115
RCP — id=114
DAE (Desfibrilador) — id=113
Posición lateral — id=110
Heimlich niños — id=109
Heimlich lactantes — id=108
Heimlich adultos — id=106

URL base: https://www.lensyar.com

9. Soporte y contacto

JhanStudios — Desarrollador del proyecto

Email: contacto@jhanstudios.com
Teléfono: +57 314 717 7797
Web: jhanstudios.com
Ubicación: Bello, Antioquia, Colombia

Para solicitar acceso al repositorio, cambios en la app, nuevas funcionalidades o soporte técnico, contacte por correo o teléfono.