Aethera

Un universo emocional para parejas a distancia.
Diseno visual cinematografico, arquitectura modular y base real-time con Flutter + Firebase.

---

Demo visual

---

Que hace especial a Aethera

• Universo compartido que evoluciona con la conexion emocional de la pareja.
• Experiencia visual en capas: cielo emocional, aurora, estrellas, memorias y horizonte de metas.
• Diseno de producto orientado a retencion: ritual semanal, rachas, puntos y progresion.
• Arquitectura preparada para escalar a produccion con separacion por dominios (core, features, shared).

---

Arquitectura (alto nivel)

flowchart LR
    A["UI Flutter (Features)"] --> B["StateNotifiers (Riverpod)"]
    B --> C["Servicios Core"]
    C --> D["Firebase Auth"]
    C --> E["Cloud Firestore"]
    C --> F["Realtime Database"]
    C --> G["Firebase Messaging"]
    C --> H["Notificaciones Locales"]

Loading

---

Stack tecnologico

• Flutter + Dart
• Estado con flutter_riverpod
• Navegacion con go_router
• Backend con Firebase (Auth, Firestore, Realtime DB, Messaging, Storage)
• UI y motion con flutter_animate + sistema visual propio (AetheraTokens)

---

Estructura del proyecto

lib/
|-- core/
|   |-- constants/
|   |-- providers/
|   |-- router/
|   |-- services/
|   |-- theme/
|   `-- utils/
|-- features/
|   |-- auth/
|   |-- onboarding/
|   |-- pairing/
|   |-- profile/
|   |-- ritual/
|   |-- splash/
|   `-- universe/
`-- shared/
    |-- models/
    `-- widgets/

---

Inicio rapido

1) Requisitos

• Flutter SDK 3.x
• Dart SDK (incluido en Flutter)
• Proyecto Firebase configurado para Android/iOS/Web

2) Instalar dependencias

flutter pub get

3) Configurar Firebase (local)

flutterfire configure

Notas de seguridad del repositorio:

• lib/firebase_options.dart contiene configuracion de cliente Firebase generada.
• No guardes secretos de backend en el cliente; usa variables/secret manager en servidor.
• android/app/google-services.json no se versiona.
• Usa android/app/google-services.json.example solo como plantilla.

4) Ejecutar

flutter run

5) Calidad

flutter analyze
flutter test

---

CI y estandares del repositorio

• Pipeline de CI en GitHub Actions: .github/workflows/ci_flutter.yml
• Guia de colaboracion: CONTRIBUTING.md
• Codigo de conducta: CODE_OF_CONDUCT.md
• Licencia: LICENSE

---

Roadmap tecnico

• Integracion completa con Firestore/Realtime DB en todos los flujos.
• Memorias multimedia con timeline visual.
• Ritual semanal enriquecido y personalizable.
• Metricas de producto y base para experimentacion A/B.

---

Autor

Jheisson Loor
Ingeniero Flutter enfocado en producto, tiempo real y experiencias visuales.