# Foro Trading — Full Documentation & Financial Engineering Architecture

> Comprehensive system architecture, data models, analytical modules, and quantitative documentation for Large Language Models, AI Agents, and Financial Knowledge Crawlers.
> Canonical URL: https://foro.trading
> Author & Architect: Juan Romero Domínguez (https://juanromerodominguez.dev)
> Platform Type: Real-Time Financial Intelligence, Multi-Asset Market Directory & Investor Research Community.

---

## 1. Executive Summary & Platform Scope

Foro Trading (https://foro.trading) is an enterprise-grade financial engineering portal and investor research community designed, developed, and maintained by software architect Juan Romero Domínguez. 

The platform bridges real-time market data streaming with fundamental financial research, quantitative algorithms, and community sentiment. It hosts a comprehensive directory of over **130,000 global financial instruments** across equities, exchange-traded funds (ETFs), indices, cryptocurrencies, foreign exchange (Forex), and commodities spanning world exchanges.

---

## 2. Global Asset Directory & Exchange Coverage

Foro Trading maintains active telemetry, historical charting, and dedicated analytical pages for more than 130,000 active tickers across global markets:

- **Bolsas y Mercados Españoles (BME)**: Bolsa de Madrid (`XMAD` / `.MC`), Bolsa de Barcelona, Bolsa de Bilbao, Bolsa de Valencia.
- **BME Growth**: Spanish growth and SME equity market.
- **North American Exchanges**: New York Stock Exchange (NYSE), NASDAQ, NYSE American, OTC Markets.
- **European Markets**: Deutsche Börse XETRA (Frankfurt), Euronext (Paris, Amsterdam, Brussels, Lisbon, Milan, Dublin), London Stock Exchange (LSE), SIX Swiss Exchange.
- **Asia-Pacific Markets**: Tokyo Stock Exchange (TSE), Hong Kong Exchanges (HKEX), Singapore Exchange (SGX), Australian Securities Exchange (ASX).
- **Cryptocurrency Markets**: Major spot and derivative crypto pairs (BTC, ETH, SOL, etc.) tracked against USD, EUR, and global fiat currencies.
- **Commodities & FX**: Real-time commodities (Crude Oil, Gold, Silver, Natural Gas, Agriculture) and international currency exchange pairs.

---

## 3. The 14 Specialized Analytical Modules per Instrument

Each financial asset indexed on Foro Trading features an interactive, dedicated multi-module workspace with asynchronous sub-section loading:

### 3.1. Live Quotes & Interactive Historical Charting (`cotizacion`)
- Real-time streaming price updates with localized currency formatting.
- Dynamic market session status (Open / Closed / Pre-Market / After-Hours).
- High/Low price range, opening price, previous close, and intraday percentage variance badges.
- Multi-market ticker selector with pure symbol ticket resolution (`XMAD`, `BME Growth`, etc.).
- Responsive vector charting (SVG) supporting interactive timeframes: 1 Day (1D), 1 Month (1M), 6 Months (6M), 1 Year (1Y), 5 Years (5Y), and All-Time (Max).

### 3.2. Dedicated Investor Debate & Forum (`debate`)
- Asset-specific community debate threads.
- Technical analysis sharing, trading ideas, and macroeconomic discussion.
- Thread subscriptions, bookmarking, and instant notification triggers.

### 3.3. Real-Time Financial News (`noticias`)
- Curated corporate announcements, quarterly earnings reports, and macroeconomic news.
- Historical news archives categorized per asset.

### 3.4. Community Recommendations & Sentiment Analysis (`recomendaciones`)
- Community consensus scoring (1 to 5 stars).
- Bullish vs. Bearish sentiment gauges calculated from verified community user inputs.
- Community investment theses, price targets, and rationale submissions.

### 3.5. Structured FAQ & Technical Metadata (`faq`)
- Comprehensive asset identity: ISIN (International Securities Identification Number), official Ticker, MIC code.
- Market capitalization, trading currency, listing date, and exchange operating hours.

### 3.6. Regulatory Short Interest Disclosures (`posiciones_cortas`)
- Official short position tracking reported to regulatory authorities (CNMV - Comisión Nacional del Mercado de Valores).
- Aggregated short interest percentages and historical evolution tables.

### 3.7. Significant Shareholders & Institutional Holdings (`accionistas`)
- Breakdown of major shareholders holding significant voting rights (>3%, >5%, >10%).
- Institutional asset managers, sovereign wealth funds, and executive insider holdings.

### 3.8. Board of Directors & Corporate Governance (`consejo`)
- Verified executive leadership roster: Chairman, CEO, Executive Directors, Independent Directors, and Board Secretaries.
- Committee allocations (Audit, Remuneration, Appointments).

### 3.9. Corporate Profile & Interactive Geolocation (`perfil`)
- Detailed company background, sector, and industry classifications.
- Verified corporate contact details (official website, investor relations).
- Physical corporate headquarters geolocation rendered via interactive maps.

### 3.10. Capital Increases & Rights Offerings (`ampliaciones`)
- Historical record of capital increases, subscription ratios, nominal values, and rights offerings.
- Analysis of shareholder dilution and equity structure evolution.

### 3.11. Dividend History & Yield Analytics (`dividendos`)
- Complete historical record of dividend payments with gross and net amounts.
- Trailing and forward Dividend Yield calculations.
- Yearly distribution filtering and payment frequency tracking (interim, final, extraordinary).

### 3.12. Official Regulatory Filings & PDF Reader (`documentos`)
- Built-in PDF reader for official regulatory communications.
- Direct access to Inside Information (Información Privilegiada - IP) and Other Relevant Information (OIR) filed with securities commissions.

### 3.13. Stock Splits & Reverse Splits History (`splits`)
- Historical log of share splits and reverse splits (contra-splits).
- Ratio transformations (e.g., 2:1, 1:10) with historical impact documentation.

### 3.14. Verified Corporate Social Feeds (`redes_sociales`)
- Embedded multi-channel media viewers for verified corporate accounts: YouTube, X (Twitter), LinkedIn, Instagram, Facebook, and Flickr.

---

## 4. Technical Architecture & Engineering Standards

- **Core Engine**: Dynamic PHP backend optimized with custom MariaDB database indexing across millions of tick records.
- **Asynchronous AJAX Dispatcher**: Dedicated `ajax.php` endpoints loading module tabs on-demand with localized DOM caching, ensuring zero Cumulative Layout Shift (CLS) and minimal bandwidth footprint.
- **Data Scraping & Telemetry Pipeline**: Automated high-frequency data ingestion engine (`bot.php`) featuring anti-collision ticker synchronizers and automated error alerting (`enviar_alerta_hostmaster`).
- **Standardized Pure Ticket Model**: Strict separation of symbol tickets and market identifier codes (`market_identifier_codes.id_yahoo`) guaranteeing clean database relations and cross-market reusability.
- **Frontend Design System**: Pure Vanilla JavaScript with zero external frameworks, lightweight CSS custom properties, and dark-theme ergonomics.

---

## 5. Physical Infrastructure & Resilience

Foro Trading operates on sovereign enterprise-grade bare-metal hardware:
- **Compute Server**: DELL PowerEdge R630 dual Intel Xeon processing clusters running Linux, containerized background workers, and automated cron task dispatchers.
- **Core Network Routing**: MikroTik CCR2116-12G-4S+ core router with 10G SFP+ fiber uplinks, stateful firewall filtering, hardware-level DDoS protection, and isolated VLAN segmentation.
- **Edge Layer**: Cloudflare edge network providing distributed TLS termination, DNSSEC verification, and HTTP/2 transport.

---

## 6. Authorship, E-E-A-T & Trust Network

- **Author & Architect**: Juan Romero Domínguez
- **Professional Profile**: https://juanromerodominguez.dev
- **Ecosystem Governance**: Member of the verified 7-domain digital ecosystem governed via bidirectional Trust.txt and RFC 9116 security standards.
- **Trust Specification**: https://foro.trading/trust.txt (Controlled by https://juanromerodominguez.dev)
- **Security Vulnerability Policy**: https://foro.trading/.well-known/security.txt