README.md

metadata

title: Financial Sankey Explorer
emoji: 💸
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 6.15.2
app_file: app.py
pinned: false
license: apache-2.0
short_description: Funds-flow Sankeys from synthetic financial statements
tags:
  - vynfi
  - sankey
  - financial-statements
  - cash-flow
  - synthetic-data

💸 Financial Sankey Explorer

Interactive multi-step funds-flow view of synthetic financial statements produced by datasynth-data. Pick an entity, a period, and a statement and read the money as it flows:

• Income statement — a left-to-right waterfall: Revenue → {Cost of Sales, Gross Profit} → {operating-expense sub-bands, Operating Income} → {Tax, Net Income}.
• Cash flow — each line item flows into its section (Operating / Investing / Financing), and the sections into Net Change in Cash.

Red bands are reductions / outflows; blue bands are retained amounts / inflows.

Data

The app renders the engine's native export, financial_reporting/sankey/flows.json (emitted when financial_reporting.sankey: true). Each entry is a self-describing SankeyFlow:

{
  "statement_type": "income_statement",
  "fiscal_year": 2024, "fiscal_period": 3,
  "company_code": "1000", "currency": "USD", "is_consolidated": false,
  "period_start": "2024-03-01", "period_end": "2024-03-31",
  "nodes": [{ "id": 0, "label": "Revenue", "section": "Revenue", "value": "1200000", "is_subtotal": false, "line_code": "IS-REV" }],
  "links": [{ "source": 0, "target": 1, "value": "480000", "label": "Gross Profit", "is_contra": false }]
}

fiscal_period: 0 denotes a full-year rollup. Upload your own flows.json, or browse the built-in demo (constructed with the same waterfall logic as the engine's Rust builder, so the shape is faithful).

Generate your own

datasynth-data generate --config config.yaml --output ./out
# with financial_reporting: { enabled: true, sankey: true, opex_breakout: true }
# → ./out/financial_reporting/sankey/flows.json