# LLM Data Pack Schemas

This folder contains machine-readable companions to the visual deck at
`https://deck.ozel.fi/`.

## Files

| File | Purpose | Key Columns / Structure |
| --- | --- | --- |
| `deck.md` | Canonical LLM-optimized narrative deck text. | Markdown with frontmatter and sectioned content. |
| `deck.json` | Structured overview for agents and pipelines. | Top-level objects: `source`, `company`, `product`, `business_model`, `quantitative_highlights`, `go_to_market_and_execution`, `regulatory_paths`, `data_files`, `sections`. |
| `metrics.csv` | Cross-deck headline KPIs in one table. | `metric`, `display_value`, `numeric_value`, `unit`, `notes` |
| `market-opportunity.csv` | Market sizing table from the deck. | `segment`, `size_display`, `size_numeric`, `size_unit`, `notes` |
| `projections-headline.csv` | Projection assumptions and outputs. | `metric`, `value_display`, `value_numeric`, `unit`, `notes` |
| `unit-economics-scenarios.csv` | Per-liquidity simulation outcomes. | `liquidity_scenario`, `triggered_epochs`, `batch_rate_percent`, `avg_orders_per_batch`, `profit_per_batch_usd`, `profit_per_order_usd`, `annual_net_profit_usd` |
| `unit-economics-kpis.csv` | Conservative vs high-end KPI pairs. | `kpi`, conservative/high-end value columns, `unit`, `description` |
| `unit-economics-costs.csv` | Cost take-rate breakdown by liquidity. | `liquidity_scenario`, gross/cost/net USD columns, `take_rate_percent` |
| `unit-economics-liquidity-tvl.csv` | Liquidity-to-TVL mapping table. | `scenario`, `raw_liquidity`, `approx_tvl_usd` |
| `diversification.csv` | Multi-commodity expansion economics. | `commodity`, `symbol`, `venue`, `modeled_revenue_usd` |
| `revenue-streams.csv` | Secondary revenue stream catalog. | `stream`, `mechanism`, `description`, `precedent` |
| `preseed-budget.csv` | Pre-seed use-of-funds breakdown. | `category`, `item`, `amount_usd`, `notes` |

## Conventions

- Currency values in `*_usd` columns are numeric and unformatted.
- Percentage values use numeric percent units (for example `1.81` means 1.81%).
- Display-oriented formatting (like `$614.3M`) is preserved in `*_display` fields.
- Scenario labels are normalized (`Low`, `Medium`, `Med-High`, `High`).