FinceptTerminal is a modern finance application offering advanced market analytics, investment research, and economic data tools, designed for interactive exploration and data-driven decision-making in a user-friendly environment.
C++ ai-agentsalgorithmic-tradingbloomberg-terminalcppfinancefinancial-marketsfintechgood-first-issueinvestmentinvestment-researchmachine-learningopensourcepythonqtquantitative-financestock-markettrading
// src/screens/docs/DocsScreen_Pages_Intro.cpp
//
// Intro and orientation pages: Welcome, Getting Started, Keyboard Shortcuts,
// Dashboard, Markets, News, Watchlist.
//
// Part of the partial-class split of DocsScreen.cpp.
#include "core/keys/KeyConfigManager.h"
#include "screens/docs/DocsScreen.h"
#include "screens/docs/DocsScreen_internal.h"
#include "ui/theme/Theme.h"
#include <QCoreApplication>
#include <QFrame>
#include <QHBoxLayout>
#include <QKeySequence>
#include <QLabel>
#include <QList>
#include <QMap>
#include <QScrollArea>
#include <QVBoxLayout>
#include <QWidget>
namespace fincept::screens {
using fincept::screens::docs_internal::SCROLL_SS;
// ============================================================================
// Page builders — Welcome & Getting Started
// ============================================================================
QWidget* DocsScreen::page_welcome() {
auto* scroll = new QScrollArea;
scroll->setWidgetResizable(true);
scroll->setStyleSheet(SCROLL_SS());
auto* page = new QWidget(this);
page->setStyleSheet(QString("background: %1;").arg(ui::colors::BG_BASE()));
auto* vl = new QVBoxLayout(page);
vl->setContentsMargins(20, 16, 20, 20);
vl->setSpacing(12);
vl->addWidget(make_heading(tr("FINCEPT TERMINAL — DOCUMENTATION")));
// Version comes from the running application — the hardcoded "v4.0.0" was
// already stale against the shipped 4.0.1.
vl->addWidget(make_muted_label(
tr("v%1 | Native C++ Financial Intelligence Terminal").arg(QCoreApplication::applicationVersion())));
auto* sep = new QFrame;
sep->setFrameShape(QFrame::HLine);
sep->setStyleSheet(QString("color: %1;").arg(ui::colors::BORDER_DIM()));
vl->addWidget(sep);
vl->addWidget(
make_section_panel("■", tr("WHAT IS FINCEPT TERMINAL?"),
tr("Fincept Terminal is a professional-grade desktop financial intelligence platform "
"built in native C++ with Qt6. It provides institutional-quality market data, "
"trading capabilities, quantitative research tools, and AI-powered analytics — "
"all in a single unified terminal interface.\n\n"
"With 50+ integrated screens, real-time WebSocket feeds, embedded Python analytics, "
"and 20+ broker integrations, Fincept Terminal bridges the gap between "
"retail and institutional tooling."),
ui::colors::AMBER));
vl->addWidget(make_section_panel("■", tr("KEY CAPABILITIES"),
tr("■ Real-time market data across equities, crypto, forex, commodities\n"
"■ Multi-exchange crypto trading (Kraken, HyperLiquid, Binance, etc.)\n"
"■ Paper trading engine with simulated order matching\n"
"■ 1300+ Python analytics scripts (equity, portfolio, derivatives)\n"
"■ 18-module QuantLib quantitative analysis suite (590+ endpoints)\n"
"■ AI Quant Lab with ML models, factor discovery, HFT, RL trading\n"
"■ Multiple AI agent frameworks (Geopolitics, Economic, Hedge Fund)\n"
"■ Agent Workbench — Claude Code / Codex agents running on the terminal's tools\n"
"■ Visual node editor for workflow automation\n"
"■ DBnomics access to 100+ data providers, 500K+ datasets\n"
"■ Surface analytics for derivatives, fixed income, credit, risk\n"
"■ Report builder with drag-and-drop components\n"
"■ Backtesting with 6 providers and 50+ strategies\n"
"■ Algorithmic trading with strategy builder and scanner"),
ui::colors::POSITIVE));
vl->addWidget(make_section_panel("■", tr("WHO IS THIS FOR?"),
tr("■ Retail traders seeking institutional-quality tools\n"
"■ Quantitative researchers and data scientists\n"
"■ Portfolio managers and financial analysts\n"
"■ Finance students learning markets and analytics\n"
"■ Algorithmic trading developers\n"
"■ Crypto traders needing multi-exchange access\n"
"■ Economics researchers working with global datasets"),
ui::colors::INFO));
vl->addWidget(make_section_panel("■", tr("NAVIGATION"),
tr("Use the sidebar on the left to browse documentation by category. "
"Each section covers a terminal feature with:\n\n"
"■ Overview — what the feature does\n"
"■ Key Features — detailed capabilities\n"
"■ Real-World Usage — practical applications\n"
"■ Skill Levels — Beginner through Pro guidance"),
ui::colors::TEXT_SECONDARY));
vl->addStretch();
scroll->setWidget(page);
return scroll;
}
QWidget* DocsScreen::page_getting_started() {
auto* scroll = new QScrollArea;
scroll->setWidgetResizable(true);
scroll->setStyleSheet(SCROLL_SS());
auto* page = new QWidget(this);
page->setStyleSheet(QString("background: %1;").arg(ui::colors::BG_BASE()));
auto* vl = new QVBoxLayout(page);
vl->setContentsMargins(20, 16, 20, 20);
vl->setSpacing(12);
vl->addWidget(make_heading(tr("GETTING STARTED")));
vl->addWidget(make_muted_label(tr("Your first steps with Fincept Terminal")));
auto* sep = new QFrame;
sep->setFrameShape(QFrame::HLine);
sep->setStyleSheet(QString("color: %1;").arg(ui::colors::BORDER_DIM()));
vl->addWidget(sep);
vl->addWidget(make_section_panel("1", tr("LAUNCH & LOGIN"),
tr("When you first launch Fincept Terminal, you'll see the login screen. "
"You can:\n\n"
"■ Register a new account with your email (confirm it with the verification "
"code we email you)\n"
"■ Continue with Google\n"
"■ Log in with existing credentials (plus your two-factor code, if enabled)\n\n"
"After login you set a 6-digit PIN that unlocks the terminal — it also locks "
"after a period of inactivity, or on demand with Ctrl+L. You land on the "
"Dashboard — your home base. Free accounts see Plans & Pricing once per "
"release; CONTINUE WITH FREE goes straight in."),
ui::colors::POSITIVE));
vl->addWidget(make_section_panel("2", tr("THE INTERFACE"),
tr("The terminal is a dockable workspace:\n\n"
"TOOLBAR (top) — File, Navigate, View and Help menus + session info\n"
"PANELS — every screen opens as a panel you can tab, split, float, or tear "
"off into its own window (right-click a panel tab)\n"
"COMMAND BAR (Ctrl+\\) and COMPONENT BROWSER (Ctrl+K) — jump to any screen "
"or action by typing\n"
"STATUS BAR (bottom) — Version, market indicators, connection status\n\n"
"Use the Navigate menu to open any of the 50+ screens, organized by "
"category: Markets & Data, Trading & Portfolio, Crypto, Research & "
"Intelligence, and Tools. Click the coloured dot in a panel header to link "
"panels so they share their selected symbol."),
ui::colors::INFO));
vl->addWidget(make_section_panel("3", tr("KEYBOARD SHORTCUTS"),
tr("F11 — Toggle fullscreen\n"
"F10 — Focus mode (hide toolbar/status bars for maximum screen space)\n"
"F5 — Refresh current screen\n"
"Ctrl+P — Take screenshot (saved to home directory)\n\n"
"See the Keyboard Shortcuts topic for the full list. Every binding can be "
"changed in Settings → Keybindings."),
ui::colors::AMBER));
vl->addWidget(make_section_panel("4", tr("SUBSCRIPTION PLANS"),
tr("Your Fincept account has two plans. Credits pay for cloud analytics, AI "
"and premium data calls:\n\n"
"■ FREE — signup credits and community support; start right away\n"
"■ PRO — $10/month: a monthly credit allowance, higher limits, every cloud "
"analytics module and priority support\n\n"
"Open Plans & Pricing from the plan badge in the toolbar, Profile → Billing "
"or the command palette (Ctrl+Shift+P → \"plans\"). Your balance and "
"payment history are under Profile → Billing.\n\n"
"Firms and teams: Fincept Terminal Enterprise is the private edition — a "
"separate product with its own accounts (fincept.in/enterprise)."),
ui::colors::AMBER));
vl->addWidget(
make_skill_panel(tr("Explore the Dashboard, set up a watchlist, browse market data"),
tr("Configure broker connections, set up paper trading, explore analytics"),
tr("Deploy algo strategies, use QuantLib suite, build custom workflows"),
tr("Multi-agent AI systems, custom MCP servers, HFT backtesting, node editor automation")));
vl->addStretch();
scroll->setWidget(page);
return scroll;
}
QWidget* DocsScreen::page_keyboard_shortcuts() {
// Built from the live KeyConfigManager rather than a hand-written list: the
// old static page named four shortcuts and menus that no longer exist, and
// could not know about rebinds. Numbered runs (Focus Window 1-9, Move to
// Monitor 1-9) are collapsed into one row each.
auto& km = KeyConfigManager::instance();
auto key_text = [&km](KeyAction a) {
const QString k = km.key(a).toString(QKeySequence::NativeText);
return k.isEmpty() ? QStringLiteral("—") : k;
};
struct Row {
QString keys;
QString what;
};
QMap<QString, QList<Row>> groups;
QStringList group_order;
auto add_row = [&](const QString& group, const QString& keys, const QString& what) {
if (!groups.contains(group))
group_order.append(group);
groups[group].append({keys, what});
};
for (const KeyAction a : km.all_actions()) {
switch (a) {
case KeyAction::FocusWindow1:
add_row(km.group_name(a), QString("%1 … %2").arg(key_text(a), key_text(KeyAction::FocusWindow9)),
tr("Focus window 1–9"));
break;
case KeyAction::MoveWindowToMonitor1:
add_row(km.group_name(a),
QString("%1 … %2").arg(key_text(a), key_text(KeyAction::MoveWindowToMonitor9)),
tr("Move window to monitor 1–9"));
break;
case KeyAction::FocusWindow2:
case KeyAction::FocusWindow3:
case KeyAction::FocusWindow4:
case KeyAction::FocusWindow5:
case KeyAction::FocusWindow6:
case KeyAction::FocusWindow7:
case KeyAction::FocusWindow8:
case KeyAction::FocusWindow9:
case KeyAction::MoveWindowToMonitor2:
case KeyAction::MoveWindowToMonitor3:
case KeyAction::MoveWindowToMonitor4:
case KeyAction::MoveWindowToMonitor5:
case KeyAction::MoveWindowToMonitor6:
case KeyAction::MoveWindowToMonitor7:
case KeyAction::MoveWindowToMonitor8:
case KeyAction::MoveWindowToMonitor9:
break; // folded into the 1–9 rows above
default:
add_row(km.group_name(a), key_text(a), km.display_name(a));
break;
}
}
// No capture: tr() is a static member, and an unused `this` capture is a
// -Wunused-lambda-capture error on Apple Clang.
auto group_title = [](const QString& g) {
if (g == QLatin1String("Global"))
return tr("GLOBAL SHORTCUTS");
if (g == QLatin1String("Navigation"))
return tr("COMMAND BAR NAVIGATION");
if (g == QLatin1String("News"))
return tr("NEWS SCREEN");
if (g == QLatin1String("Code Editor"))
return tr("CODE EDITOR");
if (g == QLatin1String("Windows"))
return tr("WINDOWS & PANELS");
return g.toUpper();
};
std::vector<std::pair<QString, QString>> sections;
for (const QString& g : group_order) {
QStringList lines;
for (const Row& r : groups.value(g))
lines << QString("%1 — %2").arg(r.keys, r.what);
sections.emplace_back(group_title(g), lines.join('\n'));
}
sections.emplace_back(
tr("COMMAND BAR"),
tr("Ctrl+\\ — Toggle the command bar. Type a function code or a verb to do almost anything in the "
"terminal; type \"?\" to list the actions available."));
sections.emplace_back(
tr("MENUS"),
tr("FILE — New Window, Move to Monitor, Close Window / Close All Windows, New / Open / Save / Save As "
"layout, Import / Export layout, File Manager, Refresh All\n"
"NAVIGATE — Markets & Data, Trading & Portfolio, Crypto, Research & Intelligence and Tools sub-menus, "
"plus Docs, Support and About\n"
"VIEW — Component Browser, Fullscreen, Focus Mode, Always on Top, Float Panel, Quick Switch "
"(workspace perspectives), Refresh Screen, Take Screenshot\n"
"HELP — About, Help Center, Contact Us, Terms of Service, Privacy Policy, Trademarks, Check for "
"Updates, Logout"));
sections.emplace_back(tr("CUSTOMIZING"),
tr("Every binding above can be changed in Settings → Keybindings. This page shows the "
"bindings currently in effect."));
return make_page(tr("KEYBOARD SHORTCUTS"), tr("Global shortcuts and navigation keys"), sections);
}
// ============================================================================
// Core Screens
// ============================================================================
QWidget* DocsScreen::page_dashboard() {
auto* scroll = new QScrollArea;
scroll->setWidgetResizable(true);
scroll->setStyleSheet(SCROLL_SS());
auto* page = new QWidget(this);
page->setStyleSheet(QString("background: %1;").arg(ui::colors::BG_BASE()));
auto* vl = new QVBoxLayout(page);
vl->setContentsMargins(20, 16, 20, 20);
vl->setSpacing(12);
vl->addWidget(make_heading(tr("DASHBOARD")));
vl->addWidget(make_muted_label(tr("Your home base — customizable widget grid with live market data")));
auto* sep = new QFrame;
sep->setFrameShape(QFrame::HLine);
sep->setStyleSheet(QString("color: %1;").arg(ui::colors::BORDER_DIM()));
vl->addWidget(sep);
vl->addWidget(make_section_panel(
"■", tr("OVERVIEW"),
tr("The Dashboard is your primary workspace. It features a draggable widget grid "
"where you can arrange market widgets, a scrolling ticker bar showing live prices, "
"a market pulse panel with sector performance, and a status bar showing connection state."),
ui::colors::AMBER));
vl->addWidget(make_section_panel("■", tr("AVAILABLE WIDGETS"),
tr("■ Stock Quote — Real-time price, change, volume for any symbol\n"
"■ Watchlist — Your tracked symbols with live updates\n"
"■ Top Movers — Biggest gainers and losers of the session\n"
"■ Market Sentiment — Bull/bear indicators and fear/greed index\n"
"■ News — Latest headlines with sentiment tagging\n"
"■ Economic Calendar — Upcoming economic events and releases\n"
"■ Sector Heatmap — Visual sector performance map\n"
"■ Performance — Portfolio return tracking\n"
"■ Risk Metrics — VaR, Sharpe, beta, drawdown indicators\n"
"■ Screener — Quick stock screener with filters\n"
"■ Quote Table — Multi-symbol comparison table\n"
"■ Quick Trade — One-click trade entry\n"
"■ Indices — Major index tracking (S&P 500, NASDAQ, DOW)\n"
"■ Forex — Currency pair rates\n"
"■ Crypto — Top cryptocurrency prices\n"
"■ Commodities — Gold, oil, silver, natural gas\n"
"■ Portfolio Summary — Holdings overview with allocation"),
ui::colors::POSITIVE));
vl->addWidget(
make_section_panel("■", tr("REAL-WORLD USAGE"),
tr("■ Morning routine: Check top movers, review overnight news, scan economic calendar\n"
"■ Active trading: Pin stock quote + quick trade widgets, monitor watchlist\n"
"■ Portfolio management: Use portfolio summary + risk metrics + performance\n"
"■ Sector rotation: Combine sector heatmap + top movers + indices"),
ui::colors::INFO));
vl->addWidget(make_skill_panel(
tr("Start with default layout. Add a Stock Quote widget for a symbol you follow. Watch the ticker bar."),
tr("Customize your grid layout. Add multiple watchlists for different sectors. Use the market pulse panel."),
tr("Build specialized layouts for different strategies (day trading vs swing). Use risk metrics + performance "
"together."),
tr("Create multi-monitor layouts. Combine dashboard with algo trading feeds. Use economic calendar for "
"event-driven setups.")));
vl->addStretch();
scroll->setWidget(page);
return scroll;
}
QWidget* DocsScreen::page_markets() {
auto* scroll = new QScrollArea;
scroll->setWidgetResizable(true);
scroll->setStyleSheet(SCROLL_SS());
auto* page = new QWidget(this);
page->setStyleSheet(QString("background: %1;").arg(ui::colors::BG_BASE()));
auto* vl = new QVBoxLayout(page);
vl->setContentsMargins(20, 16, 20, 20);
vl->setSpacing(12);
vl->addWidget(make_heading(tr("MARKETS")));
vl->addWidget(make_muted_label(tr("Global and regional market overview with auto-refresh")));
auto* sep = new QFrame;
sep->setFrameShape(QFrame::HLine);
sep->setStyleSheet(QString("color: %1;").arg(ui::colors::BORDER_DIM()));
vl->addWidget(sep);
vl->addWidget(make_section_panel("■", tr("OVERVIEW"),
tr("The Markets screen provides a comprehensive view of global markets organized "
"by region. It displays indices, equities, forex, commodities, and crypto in "
"panel-based layouts with configurable auto-refresh (default: 10 minutes)."),
ui::colors::AMBER));
vl->addWidget(make_section_panel("■", tr("KEY FEATURES"),
tr("■ Regional panels — US, Europe, Asia, Global\n"
"■ Auto-refresh with configurable interval\n"
"■ Price, change, % change with color coding (green/red)\n"
"■ Market hours and session status indicators\n"
"■ Sort by name, price, change, or volume\n"
"■ Click any instrument to navigate to detailed view"),
ui::colors::POSITIVE));
vl->addWidget(make_section_panel("■", tr("REAL-WORLD USAGE"),
tr("■ Pre-market: Scan global indices to gauge overnight sentiment\n"
"■ Cross-market analysis: Compare US vs Europe vs Asia performance\n"
"■ Commodity tracking: Monitor gold, oil, natural gas alongside equities\n"
"■ FX correlation: Watch currency pairs relative to equity moves"),
ui::colors::INFO));
vl->addWidget(
make_skill_panel(tr("Browse the default view. Learn to read green (up) and red (down) color coding."),
tr("Compare multiple regions. Notice correlations between indices and currencies."),
tr("Use markets as a macro overlay for your trading decisions. Track relative strength."),
tr("Combine with economics data and geopolitics for macro-driven trading strategies.")));
vl->addStretch();
scroll->setWidget(page);
return scroll;
}
QWidget* DocsScreen::page_news() {
return make_page(
tr("NEWS"), tr("Real-time news with clustering, sentiment analysis, and deviation monitoring"),
{
{tr("OVERVIEW"), tr("The News screen aggregates financial news from multiple sources with intelligent "
"clustering, sentiment analysis, and customizable keyword monitors that alert you "
"to significant deviations from baseline coverage patterns.")},
{tr("KEY FEATURES"), tr("■ Category filtering — All, Markets, Economy, Tech, Crypto, Geopolitics\n"
"■ Time range selection — 1H, 4H, 24H, 7D, 30D\n"
"■ Sort by recency, relevance, or sentiment score\n"
"■ News clustering — related articles grouped together\n"
"■ Sentiment analysis — bullish/bearish/neutral tagging\n"
"■ Keyword monitors — set alerts for specific topics\n"
"■ Deviation detection — flags unusual coverage patterns\n"
"■ Full article reader with clean formatting")},
{tr("REAL-WORLD USAGE"), tr("■ Event-driven trading: Monitor breaking news for tradable events\n"
"■ Sentiment tracking: Gauge market mood before making positions\n"
"■ Due diligence: Research a company before investing\n"
"■ Macro awareness: Track central bank news, policy changes")},
{tr("SKILL LEVELS"), tr("BEGINNER: Browse headlines, filter by category, read articles\n"
"INTERMEDIATE: Set up keyword monitors for your positions, use sentiment filters\n"
"ADVANCED: Use deviation alerts to catch unusual news patterns early\n"
"PRO: Combine news sentiment with quantitative signals for alpha generation")},
});
}
QWidget* DocsScreen::page_watchlist() {
return make_page(
tr("WATCHLIST"), tr("Track your favorite instruments with live quotes"),
{
{tr("OVERVIEW"), tr("The Watchlist screen lets you create and manage multiple watchlists, each with "
"live price quotes, change indicators, and quick access to detailed analysis.")},
{tr("KEY FEATURES"), tr("■ Multiple named watchlists (Favorites, Day Trades, Swing, etc.)\n"
"■ Live price, change, % change, volume\n"
"■ Add/remove symbols easily\n"
"■ Color-coded performance (green/red)\n"
"■ Click to navigate to detailed chart/analysis\n"
"■ Persistent storage — watchlists saved between sessions")},
{tr("REAL-WORLD USAGE"),
tr("■ Organize by strategy: separate watchlists for day trades, swing trades, long-term\n"
"■ Sector watchlists: group symbols by industry for sector rotation\n"
"■ Earnings watchlist: track companies reporting this week\n"
"■ Correlation pairs: group correlated instruments together")},
{tr("SKILL LEVELS"), tr("BEGINNER: Create your first watchlist with 5-10 symbols you know\n"
"INTERMEDIATE: Multiple watchlists organized by strategy or sector\n"
"ADVANCED: Use watchlists as a pre-screened universe for your scanning\n"
"PRO: Dynamic watchlists driven by screener output and quantitative filters")},
});
}
QWidget* DocsScreen::page_screener() {
return make_page(
tr("SCREENER"), tr("Equity screener — predefined screens and a custom criteria builder"),
{
{tr("OVERVIEW"), tr("The Screener runs Yahoo Finance equity screens. Pick one of the predefined screens "
"or build your own criteria, then sort, export or act on the results.")},
{tr("PREDEFINED SCREENS"), tr("■ 22 ready-made screens: day gainers / losers, most actives, 52-week "
"gainers, high dividend yield, regional movers and more\n"
"■ US LARGE-CAP BASKET — the previous fixed large-cap list with live quotes")},
{tr("CUSTOM CRITERIA"), tr("■ Build a screen from 76 fields (valuation, profitability, growth, size, "
"price action, …)\n"
"■ Region, exchange, sector, industry and peer-group pickers\n"
"■ Save a screen and run it again later")},
{tr("WORKING WITH RESULTS"), tr("■ Sortable results table\n"
"■ CSV export\n"
"■ Add symbols to a watchlist\n"
"■ Open in… Equity Research, Equity Trading, News and other screens")},
});
}
// ============================================================================
// Trading
// ============================================================================
} // namespace fincept::screens