PSX Investment OS

Overview

A private investment operating system for Pakistan Stock Exchange investors: an immutable transaction ledger, FIFO holdings and P&L, sourced end-of-day market data, research memory, and AI recommendations that must cite their evidence or say there isn't enough data.

Highlights

1. 01Immutable ledger: transactions are added, corrected or reversed rather than edited, and every CSV import batch can be rolled back
2. 02FIFO position reconstruction with realized P&L, cash and dividends, using decimal arithmetic throughout
3. 03No fabricated numbers: prices come only from verified end-of-day observations, stale prices are flagged, and missing values stay blank
4. 04Analytics for returns, allocation, drawdown and volatility, plus a versioned portfolio health score
5. 05AI recommendations with strict JSON-schema output, stored evidence, prompt and model versions, per-user quotas and an explicit “insufficient data” outcome
6. 06Cloudflare Queue workers that schedule, retry and monitor data ingestion, snapshots, alerts and reports, with 19 Vitest suites