Que es Polaris
Polaris es una plataforma de gestion economica colaborativa con mas de 30 herramientas, construida con React + TypeScript, Supabase, Gemini IA y Hedera Hashgraph.
Vision General
Polaris es una Progressive Web App (PWA) construida con Vite + React 18 + TypeScript, con TailwindCSS + Radix UI para la interfaz, Supabase como backend (Auth + Postgres + RLS), Google Gemini para 8 modulos de IA, y Hedera SDK + Plume Network para blockchain, wallets y NFTs. Licenciada bajo GPLv3.
Permite gestionar ingresos, gastos, inventario (simple y compuesto), servicios, CRM, facturas, reportes ejecutivos, proyecciones, deudas, metas, pagos recurrentes, agenda y contenido para redes sociales, todo con inteligencia artificial y respaldo en blockchain.
Stack Tecnologico
| Capa | Tecnologias |
|---|---|
| Frontend | Vite, React 18, TypeScript, TailwindCSS, Radix UI, Recharts |
| Estado | Zustand (global), TanStack Query (cache IA), React Hook Form + Zod |
| Backend | Supabase (Auth + Postgres + RLS + Storage) |
| IA | Google Gemini (gemini-2.5-flash-lite), @google/generative-ai |
| Blockchain | Hedera SDK, Ethers.js, Plume Network (PUSD) |
| Almacenamiento descentralizado | Pinata + IPFS para metadata de NFTs |
| Exportacion | jsPDF, html2canvas, CSV nativo |
| Otros | date-fns, Framer Motion, QR scanner (html5-qrcode) |
Modulos Principales (30+)
Encriptacion Total
Cifrado AES-GCM para llaves y payloads (crypto.ts). RLS en Supabase para aislamiento de datos. Datos en blockchain encriptados antes de escribirse on-chain. Solo descifrables dentro de la plataforma. Control de acceso via PublicRoute/ProtectedRoute.
8 Modulos de IA con Gemini
Todos los modulos usan gemini-2.5-flash-lite con prompts estructurados, respuesta en JSON y caching via TanStack Query.
Chatbot Polo
Asistente conversacional con contexto completo del negocio. Respuestas en Markdown.
Predictor de Ventas
Pronostico 30-90 dias. Requiere 7+ dias de datos. Analisis de tendencia y estacionalidad.
Facturador IA
Genera borradores de factura con items, impuestos, terminos y notas automaticamente.
Reportes Ejecutivos
Narrativos estilo PM: causa raiz, impacto, recomendaciones, alternativas y riesgos.
Posts para Redes
Instagram, Facebook, Twitter, TikTok, LinkedIn. Hashtags, estrategia y tipo de contenido.
Sugeridor de Categorias
Analiza patrones de uso y sugiere 5-10 categorias nuevas filtrando duplicados.
Generador de Metas
Metas realistas basadas en ultimos 30 dias. Categorias: ventas, ahorro, reduccion.
Planificador de Agenda
Agenda PM-style con bloques de trabajo, responsables y evita conflictos existentes.
Sistema de Wallets
Wallet principal Hedera (testnet) con balance en HBAR y PUSD (Plume Network). Multiples wallets personales para organizacion financiera. Metas de reinversion vinculadas a wallets.
| Balance | Descripcion |
|---|---|
| HBAR (Hedera) | Dinero real en blockchain, envio y recepcion de fondos |
| PUSD (Plume) | Stablecoin en Plume Network para pagos estables |
| Wallets Personales | Multiples wallets para organizacion con transferencias entre ellas |
Variables de Entorno
Polaris requiere las siguientes variables en runtime:
VITE_SUPABASE_URL # URL de tu proyecto Supabase VITE_SUPABASE_PUBLISHABLE_KEY # Key publica de Supabase VITE_GOOGLE_AI_API_KEY # API key de Gemini (gratuita) VITE_ENCRIPTED_KEY # Llave maestra AES para cifrado VITE_RPC_URL # RPC de Plume Network VITE_OPERATOR_ID # Operator ID de Hedera VITE_OPERATOR_KEY # Operator Key de Hedera VITE_PLUME_API_BASE # URL base API Plume VITE_PINATA_JWT_SECRET # JWT para Pinata/IPFS VITE_PINATA_URL # URL gateway Pinata
Licencia
GNU General Public License v3 (GPLv3). Copyright 2026 Wilkenson Canton Medel. Si modificas el programa, debes licenciar las modificaciones bajo GPLv3, marcar los cambios, y proveer el codigo fuente.