Cherry1909/aimara

# Historias Vivientes Aymara Sistema comunitario para preservar la cultura aymara mediante la recolección de relatos orales, creando un archivo digital vivo y georreferenciado. ## Descripción del Proyecto "Historias Vivientes Aymara" es un sistema accesible que permite a las comunidades aymaras preservar su cultura mediante relatos orales. El sistema: - Permite grabar o subir audios de relatos - Georreferencia cada historia en un mapa - Procesa automáticamente los audios con IA (Groq) para transcripción y análisis cultural - Genera páginas públicas para cada relato con audio, texto, mapa y perfil del narrador - Crea códigos QR imprimibles para compartir físicamente ## Stack Tecnológico ### Frontend (PWA) - React 18 + Vite 5 - TailwindCSS para estilos - Leaflet.js para mapas interactivos - Firebase SDK (Storage + Firestore) - vite-plugin-pwa para funcionalidad offline - React Router para navegación - Zustand para gestión de estado ### Backend - FastAPI (Python) - Firebase Admin SDK - Groq API para transcripción y análisis - qrcode para generación de códigos QR ### Infraestructura - Firebase Storage (audios) - Firebase Firestore (metadatos) - Vercel/Netlify (frontend) - Railway/Render (backend) ## 🚀 Inicio Rápido con Docker (Recomendado) **La forma más fácil de ejecutar el proyecto completo:** ```bash # 1. Configurar variables de entorno copy .env.docker.example .env # Editar .env con tus credenciales # 2. Copiar credenciales de Firebase # Descargar serviceAccount.json desde Firebase Console # Guardar en: backend/credentials/serviceAccount.json # 3. Ejecutar start.bat # Windows ./start.sh # Linux/Mac ``` **Aplicación disponible en:** - Frontend: localhost - Backend: localhost - API Docs: localhost 📖 **Ver guía completa**: DOCKER_README.md --- ## Requisitos Previos ### Con Docker (Opción Recomendada) - Docker Desktop instalado - Cuenta de Firebase - API Key de Groq ### Sin Docker (Instalación Ma …