La Viste
🌐 English | 🇦🇷 Español
What is La Viste? | ¿Qué es La Viste?
EN: La Viste is an educational investment simulator for the Argentine market. Create investment theses through AI-powered conversation, track simulated portfolios with practice money (not real), monitor relevant news automatically, and learn investment strategies in a risk-free environment. Multi-user platform with Clarity & Growth fintech design.
ES: La Viste es un simulador educativo de inversiones para el mercado argentino. Creá tesis de inversión mediante conversación con IA, seguí carteras simuladas con dinero de práctica (no real), monitoreá noticias relevantes automáticamente y aprendé estrategias de inversión en un entorno sin riesgo. Plataforma multiusuario con diseño fintech Clarity & Growth.
🌐 Live site: https://laviste.diegodella.ar
✨ Key Features | Características principales
🤖 AI-Powered Thesis Creation | Creación de tesis con IA
- EN: Natural conversation with OpenAI to develop investment ideas and generate structured proposals
- ES: Conversación natural con OpenAI para desarrollar ideas de inversión y generar propuestas estructuradas
📊 Simulated Portfolio Tracking | Seguimiento de cartera simulada
- EN: Practice money (ARS) portfolio with delayed public market prices from data912 and Yahoo Finance
.BA tickers. No real money, commissions, dividends, or actual orders.
- ES: Cartera de dinero de práctica (ARS) con precios públicos demorados de data912 y tickers
.BA de Yahoo Finance. Sin dinero real, comisiones, dividendos ni órdenes reales.
📰 Automated News Monitoring | Monitoreo automático de noticias
- EN: Web search with OpenAI to track thesis-relevant news, sources, and coverage. Daily, weekly, or manual frequency with background job processing.
- ES: Búsqueda web con OpenAI para rastrear noticias relevantes a la tesis, fuentes y cobertura. Frecuencia diaria, semanal o manual con procesamiento de trabajos en segundo plano.
👥 Multi-User Support | Soporte multiusuario
- EN: User roles (superadmin, regular), daily quotas (20 chat messages, 5 news reviews, 100k tokens, 3 active monitored theses), login via email/password or optional Google OAuth
- ES: Roles de usuario (superadmin, regular), cuotas diarias (20 mensajes de chat, 5 revisiones de noticias, 100k tokens, 3 tesis activas monitoreadas), login por email/contraseña o Google OAuth opcional
🎨 Clarity & Growth Design System | Sistema de diseño Clarity & Growth
- EN: Modern fintech UI with canvas
#F8FAFC, white cards, Plus Jakarta Sans / Inter / JetBrains Mono fonts, electric blue accents, 8/16px radii, ambient shadows
- ES: Interfaz fintech moderna con canvas
#F8FAFC, tarjetas blancas, fuentes Plus Jakarta Sans / Inter / JetBrains Mono, acentos azul eléctrico, radios 8/16px, sombras ambient
🛠 Tech Stack | Stack tecnológico
| Component | Technology |
|---|
| Runtime | Node.js 22.22.0+ |
| Database | SQLite (WAL mode) |
| AI Provider | OpenAI (Structured Outputs + Web Search) |
| Market Data | Delayed public prices: data912, Yahoo Finance .BA tickers |
| Auth | Session-based (12h TTL), optional Google OAuth |
| Security | AES-256-GCM encrypted credentials, CSP, origin restrictions, rate limiting |
| Deployment | Docker Compose (self-hosted Raspberry Pi) |
| CI/CD | GitHub Actions (self-hosted runner + ubuntu-24.04) |
| Testing | Node test runner, Playwright browser tests |
Production dependencies: None (zero npm runtime dependencies)
Dev dependencies: @playwright/test only
🚀 Local Development | Desarrollo local
Requirements | Requisitos: Node 22.22.0+, Chromium (for browser tests | para tests de navegador)
# Install dependencies | Instalar dependencias
npm ci
# Setup database and secrets | Configurar base de datos y secretos
npm run setup
# Start server | Iniciar servidor
APP_PASSWORD_FILE=./secrets/app-password MASTER_KEY_FILE=./secrets/master.key npm start
# Server runs on http://127.0.0.1:3080 (use PORT=3475 to change)
# Run checks | Ejecutar verificaciones
npm run check
# Run tests | Ejecutar tests
npm test
npm run test:browser
npm run test:site
# Build static site pages | Construir páginas estáticas del sitio
npm run build:site
Browser tests use /usr/bin/chromium by default. Configure with CHROMIUM_PATH or PLAYWRIGHT_USE_BUNDLED=true after npx playwright install chromium.
Tests de navegador usan /usr/bin/chromium por defecto. Configurar con CHROMIUM_PATH o PLAYWRIGHT_USE_BUNDLED=true después de npx playwright install chromium.
🏗 Architecture | Arquitectura
EN:
- Monolith: Node + SQLite WAL, persistent job queue with one concurrent investigator
- Session management: 12-hour sessions stored in SQLite (hashed tokens), survives restarts
- Security: Encrypted credentials in SQLite, origin restrictions, CSP, login rate limiting, persistent daily quotas
- Job processing: News review tied to thesis version; if thesis changes during search, result becomes historical and recovery is scheduled
- Resilience: Restart interruptions are logged; missing reviews are never invented; source failures don't erase previous alerts
This is the beginning of the README. Read the rest at the original. Read the full README ↗
