Core ConceptsPDF Reports

PDF Reports

Institutional-grade PDF report generation and delivery.

PDF Reports

The Zoris Engine generates enterprise-grade PDF reports for institutional clients, designed with a Goldman Sachs/BlackRock aesthetic befitting Zorisord Group Limited.

Report Types

1. Quant Briefing (/api/quant-briefing.pdf)

A daily market intelligence report containing:

  • System Performance — OOS binary accuracy, OOS movers accuracy, tercile spread, training rows
  • JSE Market Sentiment — Index change, advancers/decliners/unchanged counts
  • Top AI Signals — Ranked by Zoris Score (0-100), includes price, return, RSI, AI predicted return, conviction score
  • AI Portfolio Summary — Open positions, portfolio value, position breakdown table

2. Compliance Report (/api/compliance-report.pdf)

A regulatory disclosure report containing:

  • Risk Disclosures — Model risk, out-of-sample accuracy, regime change risk, backtesting limitations, illiquidity risk, no investment advice, speculative nature
  • Model Performance Metrics — Binary accuracy, movers accuracy, tercile spread, training rows, feature count
  • Recent Trade Audit Trail — Date, symbol, action, quantity, price, value
  • Regulatory Notices — Corporate structure, nature of output, user responsibility, data provenance, forward-looking statements
  • Document Certification — Timestamp, generation method, rights statement

Design System

Typography

  • Headers: Cinzel (serif, bold) — conveys institutional gravitas
  • Subtext: Playfair Display (italic) — elegant, traditional financial feel
  • Body: Inter — clean, modern readability

Color Palette

RoleColorHex
Primary (Navy)Deep institutional blue#0A1A38
Accent (Emerald)Key numbers and positive metrics#059669
BackgroundWarm white#FCFCFB
TextCharcoal#1E242D
MutedSlate gray#647080
DividersSilver#D2D7DE

Layout Elements

  • White header band with 3px emerald accent stripe at bottom
  • Company name: ZORISORD GROUP LIMITED — Cinzel Bold, left-aligned
  • Sub-line: Zoris Production • Zoris Engine v3 — Playfair italic
  • Section headings: Cinzel Bold with silver full-width rule
  • KPI pills: Alternating row tints with 2px top accent (emerald for positive, navy for neutral)
  • Tables: Navy header row, alternating warm-white/white rows, silver bottom rule

Partner Logos Section

The final page of each report includes a "POWERED BY" section displaying:

  1. Zorisord Logo — Parent company (left)
  2. Zoris Production — Operational arm (center)
  3. Zoris Engine Symbol — Prediction engine (right)

Implementation

Technology Stack

  • Library: fpdf2 (Python)
  • Database: SQLite (internal portfolio store)
  • Fonts: Custom TTF — Inter (Regular, Medium, SemiBold, Bold), Cinzel (Regular, Bold), Playfair Display (Regular, Italic, Bold)

Data Sources

  • Performance metrics: Internal performance tracking store
  • Market sentiment: Internal market summary store
  • AI signals: Internal risk/signal store
  • Portfolio: Internal portfolio database (SQLite)

API Integration

Both reports are available via REST endpoints:

GET /api/quant-briefing.pdf
GET /api/compliance-report.pdf

Reports are generated on-demand with current data. No authentication required for public-facing reports; add X-API-Key header for protected endpoints.