# Roadmap

## Phase 1 - Foundation
- Inspect current static project.
- Add brand assets and favicon pack.
- Establish premium design direction.
- Create documentation foundation.
- Decide migration path to Next.js monorepo.

## Phase 2 - Premium Landing
- Build hero section with supplied whale artwork and no terminal card in the first viewport.
- Add problem and solution sections.
- Add key features and arbitrage type coverage.
- Add risk engine section.
- Add pricing, FAQ and final CTA.
- Add premium language switcher and language route shells. Done for landing.

## Phase 3 - Terminal MVP
- Create terminal dashboard. Done as a static `/terminal/` mock route.
- Create premium institutional command center. Done as route-aware static `/dashboard/` shell.
- Create arbitrage platform with mock data. Done as static `/terminal/arbitrage/`.
- Add platform filters, loading, empty and error states. Done in static platform foundation.
- Add bundle detail view. Done as static BTC/USDT detail page.
- Add spread convergence chart. Done with CSS mock chart blocks.
- Add mock order book and event timeline.

## Phase 4 - Event Intelligence
- Create listings radar. Done as static `/terminal/listings/`.
- Create announcements feed. Done as static `/terminal/announcements/`.
- Add event classification. Done for Binance and Bybit live sources through `/api/market/events`.
- Add official exchange source statuses. Done for the 39-source Fundoor-style registry: 16 CEX, 17 DEX and 6 HL hip3 sources.
- Add event-to-bundle correlation. Static UI done; live scoring depth pending.

## Phase 5 - Engines
- Add arbitrage calculation engine. Done as `packages/arbitrage-engine`.
- Add fee and slippage calculation. Done in arbitrage engine.
- Add risk engine. Done as `packages/risk-engine`.
- Add confidence scoring. Done in arbitrage engine.
- Add unit tests. Done with Node built-in test runner.
- Add shared mock data package. Done as `packages/mock-data`.
- Add access-control helpers. Done as `packages/access-control`.
- Add notification mock adapters. Done as `packages/notifications`.
- Add static link checker. Done as `scripts/check-links.mjs`.
- Add i18n runtime and translation dictionaries. Done as `src/i18n`.

## Phase 6 - SaaS Layer
- Add auth structure. Done as static `/login/` and `/register/` shells.
- Add billing and subscription plan guards. Done as static `/billing/` foundation.
- Add terminal settings. Done as static `/terminal/settings/`.
- Add upgrade modal and usage limits. Pending.
- Add RBAC and plan guard mock state. Done as `packages/access-control`; route-level UI wiring is pending.

## Phase 7 - Admin And Monitoring
- Add admin shell. Done as static `/admin/`.
- Add users, plans, exchange health, bundle logs and audit logs. Users, bundle logs and health are represented in static admin routes; plan/audit depth is pending.

## Phase 8 - Futures / Funding
- Futures dashboard. Done as static `/terminal/futures/`.
- Funding rates. Done as static `/terminal/funding/`.
- Basis spread. Covered in static futures module.
- Open interest. Covered in static futures module.
- Futures arbitrage platform. Covered as static table foundation.
- Funding alerts. Covered by static `/terminal/alerts/` foundation; real notification adapters are pending.
- Mock notification adapters. Done for Telegram, email and webhooks; real providers are pending.

## Phase 9 - Full Product Localization
- Extend i18n from the landing page into terminal, auth, billing and admin pages.
- Move language routing to middleware when the app migrates to Next.js.
- Replace client-side geo lookup with server-side geo headers where available.