# Finance Forge

> Terminal de análisis bursátil con datos directos de la SEC de EE.UU.

Finance Forge es una aplicación web de finanzas e inversión para inversores particulares. Obtiene datos fundamentales directamente de la API XBRL de la SEC (datos.sec.gov) y precios de mercado vía yFinance.

Estado: **beta pública** — gratuita, en desarrollo activo; algunas funciones y datos pueden cambiar.

## When to use Finance Forge

Use Finance Forge when you need to:

- **Research a US-listed company** by fundamental data: P/E, P/FCF, EV/EBITDA, margins, debt, ROCE, FCF Yield — sourced directly from SEC EDGAR XBRL filings, not third-party aggregators.
- **Screen 5,000+ NYSE and Nasdaq companies** by FCF margin, ROE, net margin, EV/EBITDA, sector, exchange or market cap.
- **Run a DCF valuation** with a target price, configurable safety margin (0–50%), and FCF-based quality score.
- **Compare up to 4 companies** side by side on fundamentals, ratios, margins and growth.
- **Track insider transactions** (Form 4 filings) or institutional holders (13F filings) for any ticker.
- **Evaluate dividend stocks** using the Geraldine Weiss yield-band method, plus dividend CAGR (5y/10y), consecutive years of increase and a dividend-aristocrat indicator.
- **Monitor a personal investment portfolio** with real-time P&L, FX currency impact per position, and sector rebalancing simulation.
- **Set price alerts** on a watchlist and receive in-app notifications when thresholds are crossed.
- **Apply investor screens** (Graham, Lynch, Buffett, Greenblatt presets) or build custom rule-based indicators on any stock.
- **Track macroeconomic market signals** using proxy stocks (e.g. CAT for industrial machinery demand, WMT for US consumer health).

Do NOT use Finance Forge for: real-time level-2 data, options/derivatives analysis, crypto assets, non-US listed stocks, or automated trade execution. Data has up to 15-minute delay.

## Módulos principales

### Análisis de empresa (`/company/[ticker]`)
Página de análisis fundamental por ticker con 20 años de histórico (datos SEC EDGAR). Pestañas disponibles:
- **Resumen**: precio en vivo, múltiplos (P/E, P/FCF, EV/EBITDA, P/S, P/B), márgenes (bruto, operativo, neto, FCF), rentabilidad (ROE, ROCE, ROA), balance, crecimiento YoY, TTM. Incluye diagrama Sankey del flujo de dinero del income statement anual (revenue → costes → resultado neto), descargable como PNG, y un bloque de empresas similares (mismo sector, market cap comparable) con precio, capitalización y P/E
- **Scoring Fundamental**: Piotroski F-Score (0–9, 9 criterios) y Altman Z-Score (zonas: segura >2.99, gris 1.81–2.99, riesgo <1.81), con histórico año a año de ambos scores
- **Comparativa Sectorial**: empresa vs mediana del sector (gross margin, operating margin, net margin, FCF margin, ROE, ROA, current ratio, D/E)
- **Histórico de Múltiplos**: gráfico interactivo P/FCF, P/E, EV/EBITDA y P/S año a año
- **Próximos Eventos**: fecha de earnings, EPS estimado, fecha ex-dividendo y fecha de pago
- **Financials / Cash Flow / Balance**: tablas históricas hasta 10 años
- **Gráfico**: chart builder interactivo con cualquier métrica SEC
- **Segmentos**: ingresos geográficos y por producto/servicio
- **Insiders**: transacciones Form 4 (compras/ventas directivos) con gráfico de actividad mensual
- **Institucionales**: titulares 13F (institución, acciones, valor, % capital)
- **Weiss**: análisis de valoración por dividendos método Geraldine Weiss (bandas compra/venta), CAGR del dividendo (5 y 10 años), racha de años consecutivos de incremento e indicador de "dividend aristocrat"
- **Indicadores**: screens de inversión predefinidos (Graham, Lynch, Buffett, Greenblatt) y personalizados por el usuario. Cada indicador define reglas sobre métricas del summary (P/E, FCF Yield, deuda, ROCE, etc.) con pesos y umbrales. Resultado en modo semáforo (verde/amarillo/rojo) o puntuación numérica.

### Tesis de Inversión (`/thesis` y `/thesis/[ticker]`)
Herramienta de valoración fundamental:
- Lista de tesis con **sorting** (ticker, retorno, upside DCF, convicción) y **filtros por convicción**
- Panel prominente con **precio objetivo DCF**, upside potencial y **margen de seguridad configurable** (0–50%, default 25%)
- Comparación P/FCF actual vs múltiplo histórico conservador ajustable por el usuario
- FCF Yield neto (descontando dividendos), ROCE, Quality Score
- **Referencia CAGR histórico** junto al slider de tasa de crecimiento (Rev 3Y, FCF 3Y, EPS 3Y — clic para aplicar)
- **Referencia P/FCF histórico** junto al slider de múltiplo terminal (últimos 5 años — clic para aplicar)
- Modal de confirmación al salir con cambios no guardados
- **Tesis públicas**: cada tesis puede hacerse pública (toggle en la página de tesis) y compartirse via URL `/thesis/share/[id]`

### Explorar Tesis (`/thesis/explore`)
Directorio de tesis públicas compartidas por la comunidad:
- Tabla con ticker, título, precio, objetivo DCF, upside DCF, convicción y nota
- Sorting y filtros por convicción

**Fórmulas clave:**
- FCF = Flujo de caja operativo − Capex de mantenimiento
- FCF Yield = FCF por acción / Precio actual
- ROCE = FCF / (Equity + Deuda neta)
- Precio objetivo DCF = FCF/acción × Múltiplo histórico × (1 + tasa_crecimiento)^años
- Precio con margen de seguridad = Precio objetivo × (1 − margen%)

### Screener (`/screener`)
Filtro de más de 5.000 empresas de NYSE y Nasdaq cotizadas con datos de la SEC. Filtros: FCF margin mínimo, ROE mínimo, margen neto mínimo, margen bruto mínimo, EV/EBITDA máximo, sector, exchange, capitalización, P/E máximo, P/FCF máximo, y CAGR de revenue/FCF/EPS a 3 años. Los ratios del screener se expresan como decimales (0.20 = 20%).
- **Visibilidad de columnas**: botón de columnas en la barra de resultados para mostrar/ocultar columnas (persistido en localStorage)
- **Watchlist desde screener**: botón bookmark en cada fila (aparece al hover) para añadir/quitar del watchlist
- **Presets de filtros**: guarda combinaciones de filtros con nombre propio y recárgalas en un clic

### Comparar empresas (`/compare`)
Comparativa de hasta 4 empresas simultáneas con datos de la SEC. Muestra ratios de valoración, márgenes, deuda y crecimiento en columnas paralelas.

### Cartera de inversión (`/portfolio`)
- Gestión de múltiples carteras con P&L en tiempo real (precios yFinance con retraso de 15 min)
- **Impacto divisa (FX)**: columna por posición que muestra cuántos puntos porcentuales ha añadido o restado el tipo de cambio desde la fecha de compra. Requiere fecha de compra. Datos FX históricos vía Frankfurter API (BCE).
- **Divisa base configurable**: selector EUR/USD/GBP/CHF/JPY/CAD/AUD en el header del portfolio
- Pestañas: Posiciones, Analytics, Rotación/Rebalanceo, Watchlist, Calendario, Transacciones
- **Rotación**: simulador de rotación vende→compra con estimación de FCF Yield y impacto en concentración
- **Rebalanceo por pesos objetivo**: define el peso deseado de cada posición y calcula las operaciones necesarias (comprar/vender acciones), con soporte de cash adicional
- **Log de transacciones filtrable**: tabla de todas las operaciones filtrable por ticker y tipo (compra/venta), con totales y comisiones
- **TWR vs Benchmark**: cálculo de rentabilidad ponderada por tiempo (Modified Dietz mensual) comparada contra SPY, QQQ o URTH con gráfico de evolución base 100
- **Watchlist** con alertas de precio configurables (por encima/por debajo de un precio)

### Señales de Mercado (panel en `/home`)
Panel configurable por el usuario para usar acciones cotizadas como proxies de condiciones macroeconómicas. Ejemplo: Caterpillar (CAT) como indicador de demanda industrial, Walmart (WMT) como termómetro del consumidor americano, o cobre (COPX) como señal de ciclo económico global. El usuario añade sus propias señales agrupadas por categorías.

### Indicadores personalizados (`/company/[ticker]` → tab Indicadores)
Sistema de screens de inversión basados en reglas sobre métricas fundamentales:
- **Presets predefinidos**: Graham (valor profundo), Lynch GARP (crecimiento a precio razonable), Buffett (calidad y foso), Greenblatt Magic Formula (ROCE + EV/EBIT)
- **Indicadores personalizados**: el usuario define reglas (métrica, umbral bueno/malo, dirección, peso 1–3), que se evalúan contra los datos del summary en tiempo real
- **Modos de resultado**: semáforo (verde ≥70, amarillo ≥35, rojo <35) o puntuación numérica (0–100)
- Los indicadores personalizados son persistentes por usuario y aparecen en cualquier ficha de empresa

### Alertas e Notificaciones (`/notifications`)
- Las alertas de precio de la watchlist se detectan automáticamente cada 30 min (lunes–viernes, horario mercado)
- Cuando se dispara una alerta: notificación in-app con badge rojo en el icono de campana del nav
- Lista de notificaciones con estado leído/no leído, marcar como leída individualmente o todas a la vez

## Datos técnicos

- **Fundamentales**: SEC EDGAR XBRL (datos.sec.gov) — datos oficiales del regulador estadounidense
- **Precios**: yFinance — retraso máximo de 15 minutos
- **FX histórico**: Frankfurter API (datos BCE) — sin coste, sin API key
- **Scoring**: calculado en backend desde annual_reports SEC (no fuentes externas)
- **Sector comparison**: mediana real con PERCENTILE_CONT(0.5) sobre todas las empresas del sector con market cap conocido
- **Múltiplos históricos**: precio yFinance más cercano a la fecha de cierre fiscal de cada año

## Idiomas

Disponible en español (es), catalán (ca) e inglés (en).

## Recursos

- Sitemap: https://finforge.app/sitemap.xml
- Página principal: https://finforge.app
- Directorio de empresas por sector: https://finforge.app/companies
- Rankings de acciones (margen FCF, ROE, PER bajo, P/FCF bajo, dividendo): https://finforge.app/rankings
- Ficha de empresa: https://finforge.app/company/{TICKER} (p. ej. https://finforge.app/company/AAPL)
- Acerca de: https://finforge.app/about
- Contacto: https://finforge.app/contact

## Aviso legal

Finance Forge es una herramienta de análisis para uso informativo. No constituye asesoramiento financiero ni de inversión.