La app funciona directamente desde el navegador del celular, sin instalar nada en Play Store.

• 📷 Escáner de códigos de barras desde la cámara del celular
• 🎤 Búsqueda por voz en español — di el nombre del producto y lo encuentra
• 🗣️ Respuestas audibles — el sistema habla cuando hay errores o confirmaciones
• 🧾 Factura en JPG liviana, lista para compartir por WhatsApp
• 📲 Envío por WhatsApp automático al cliente al confirmar la venta
• 💳 Ventas al contado y a crédito con cuotas personalizadas
• 👥 Historial de clientes con fotos de productos comprados
• 📊 Reportes por categoría con fotos e índice único por producto
• 🎨 Temas de color configurables (8 temas incluidos)
• 📱 PWA instalable — funciona como app nativa en Android e iOS
• 👴 Diseño accesible — letras grandes, botones grandes, alto contraste

• Python 3.10+
• pip
• libzbar (para leer códigos de barras)

# Ubuntu / Debian
sudo apt-get install -y libzbar0

# macOS
brew install zbar

# Windows — descarga ZBar desde: http://zbar.sourceforge.net

git clone https://github.com/TU_USUARIO/inventario-nube.git
cd inventario-nube

python -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate

pip install -r requirements.txt

python manage.py migrate
python manage.py runserver 0.0.0.0:8000

Abre en tu navegador: http://localhost:8000

Desde el celular (misma red WiFi): http://[IP_DE_TU_PC]:8000

Para que la cámara funcione en Chrome Android:

1. Abre chrome://flags
2. Busca Insecure origins treated as secure
3. Agrega http://[TU_IP]:8000
4. Toca Relaunch

En la app ve a ⚙️ Configuración y edita nombre, RUC, teléfono y pie de página de factura.

En ⚙️ Configuración → Tema y colores elige entre 8 temas disponibles.

En el archivo inventario_project/settings.py, línea 8:

# CAMBIA ESTA LÍNEA — usa una clave larga y única para tu negocio
SECRET_KEY = config('SECRET_KEY', default='django-insecure-cambia-esto-en-produccion-xyz123')

Genera tu propia clave en: https://djecrety.ir

Ver guía completa paso a paso en: GUIA_RAILWAY.md

¿Quieres esta app instalada y configurada para tu negocio?

Puedo configurártela con:

• ✅ Tu nombre, logo y colores del negocio
• ✅ Tus categorías de productos
• ✅ Tu número de WhatsApp conectado
• ✅ Hosting en la nube 24/7 (Railway o VPS)
• ✅ Dominio personalizado (opcional)

1. Clic en la pestaña "Issues" arriba
2. Clic en "New Issue"
3. Escribe tu nombre, país y tipo de negocio
4. Te respondo con los detalles

💡 Al abrir un Issue puedo ver quién está interesado, en qué país están y qué tipo de negocio tienen — sin que necesiten mi contacto directo hasta que yo les responda.

Este proyecto fue desarrollado con la asistencia de Claude, el asistente de inteligencia artificial de Anthropic.

Claude ayudó a diseñar la arquitectura, escribir el código Django, la interfaz HTML/CSS/JS, la integración de voz, la generación de facturas JPG y la configuración para Railway.

"La mejor herramienta no es la que hace todo sola — es la que te ayuda a aprender mientras construyes."

MIT License — libre para usar, modificar y distribuir con atribución.

¿Tienes preguntas o quieres colaborar?

• 🐛 Bug o problema: abre un Issue
• 💡 Sugerencia: abre un Issue con etiqueta enhancement
• 📧 Contacto directo: disponible en mi perfil de GitHub