🏦 Khipu - Sistema de Ahorro Grupal Descentralizado

¡La evolución digital de las tandas mexicanas con tecnología blockchain!

🚀 INSTALACIÓN RÁPIDA

Para Usuarios (1 minuto):

git clone https://github.com/tu-usuario/Contrato-Proyecto.git
cd Contrato-Proyecto
npm install && npm run mvp

Para Desarrolladores:

git clone https://github.com/tu-usuario/Contrato-Proyecto.git
cd Contrato-Proyecto
./install.sh

📚 DOCUMENTACIÓN COMPLETA

• 📋 Guía de Instalación Completa - Para usuarios y desarrolladores
• ⚡ Inicio Rápido - Comandos esenciales
• 🚀 Documentación MVP - Arquitectura técnica
• 🎯 Documentación Khipu - Funcionalidades del sistema

🎯 ¿Qué es Khipu?

Una aplicación web moderna que digitaliza las tandas mexicanas (sistemas de ahorro grupal) usando blockchain de Stellar:

• 💰 $10 USD semanales por participante
• 🔐 Login con Google/Facebook - sin tecnicismos
• 🤝 Invitaciones por WhatsApp - crece tu grupo fácilmente
• 📊 Reputación transparente - todos ven quién es confiable
• 💎 Wallet automático - se crea tu billetera digital sola

🌟 Características Destacadas

Para Usuarios Finales:

• ✅ Súper Fácil: Login social, sin configuración técnica
• ✅ Seguro: Blockchain verifica todas las transacciones
• ✅ Transparente: Ve el historial completo del grupo
• ✅ Social: Invita amigos por WhatsApp con tu código

Para Desarrolladores:

• ✅ Arquitectura MVP: React + Firebase + Soroban
• ✅ Smart Contracts: Rust/Soroban en Stellar
• ✅ Wallet Integration: Generación automática de keypairs
• ✅ Tests Completos: Suite de pruebas automatizadas

🛠️ Stack Tecnológico

• 🔗 Blockchain: Soroban (Stellar)
• ⚙️ Smart Contract: Rust
• 🌐 Frontend: HTML5 + JavaScript ES6
• 🔐 Auth: Firebase (Google/Facebook)
• 💰 Wallet: Stellar SDK
• 📱 Social: WhatsApp Business API

🚀 Comandos Esenciales

npm start           # Ejecutar aplicación completa
npm run mvp         # Demo MVP con login social  
npm run demo        # Mismo que mvp
npm run help        # Ver todos los comandos

📱 Versiones Disponibles

Versión	URL	Descripción
MVP	localhost:3000/mvp-khipu.html	Login social + Wallet automático
Original	localhost:3000/khipu.html	Versión básica con Freighter
Demo	localhost:3000	Página de bienvenida

🎮 Cómo Empezar

1. Instalar: npm install && npm run mvp
2. Acceder: http://localhost:3000
3. Login: Click en Google o Facebook
4. Contribuir: $10 USD semanales con un click
5. Invitar: Compartir por WhatsApp

🆘 ¿Necesitas Ayuda?

• 📖 Guía Completa - Instalación paso a paso
• ⚡ Inicio Rápido - Comandos esenciales
• 🐛 Issues - Reportar problemas
• 💬 Email: soporte@khipu.com

🌟 ¡Contribuye!

¿Te gusta el proyecto?

• ⭐ Dale una estrella en GitHub
• 🐦 Compártelo en redes sociales
• 🤝 Contribuye con código
• 💡 Sugiere nuevas ideas

---

Desarrollado con ❤️ por la comunidad blockchain mexicana 🇲🇽

🚀 ¡Únete a la revolución del ahorro digital!