diff --git a/docs/UI_UX_PLATFORM_CORE_MIGRATION_ROADMAP.md b/docs/UI_UX_PLATFORM_CORE_MIGRATION_ROADMAP.md index 4c74cb2..7ec4ccb 100644 --- a/docs/UI_UX_PLATFORM_CORE_MIGRATION_ROADMAP.md +++ b/docs/UI_UX_PLATFORM_CORE_MIGRATION_ROADMAP.md @@ -18,6 +18,25 @@ Live source of truth for migrating `learning_ai_invt_trdg` UI/UX and platform cl - Product UI adapter (`web/src/components/ui/Primitives.tsx`, to be added): imports from `@bytelyst/ui`, maps product defaults, status tones, density, radius, focus behavior, and preserves trading-domain composition locally. - Product-owned UI: trading workflows, strategy/risk/execution domain composition, charts, order lifecycle views, and product-specific copy/state. +## Common-Platform Inventory + +| Product Need | Current Product Usage | Common-Platform Package | Migration Decision | +|---|---|---|---| +| Core UI primitives | Local `web/src/components/ui/*`, raw controls, local CSS classes | `@bytelyst/ui` | Add product adapter and migrate local primitives/workflows to common exports. | +| Design tokens | Product CSS variables and hardcoded literals in `web/src/index.css`, `web/src/App.css`, component styles | `@bytelyst/design-tokens` | Add shared token dependency and global `--bl-*` aliases before component migrations. | +| Platform API client | `@bytelyst/api-client` in web dependency graph through local/vendor resolution | `@bytelyst/api-client`, `@bytelyst/platform-client` | Keep current API client, evaluate `platform-client` where product uses platform-service workflows directly. | +| Auth/session | `@bytelyst/react-auth`, backend `@bytelyst/auth` | `@bytelyst/react-auth`, `@bytelyst/auth`, `@bytelyst/auth-client`, `@bytelyst/auth-ui`, `@bytelyst/secure-storage-web` | Keep current auth primitives; evaluate auth UI and secure storage during forms/auth migration. | +| Telemetry | `@bytelyst/telemetry-client` in shared web/mobile and backend telemetry singleton | `@bytelyst/telemetry-client`, `@bytelyst/backend-telemetry`, `@bytelyst/monitoring` | Keep current telemetry client; evaluate backend package consolidation separately from UI migration. | +| Diagnostics | Product-local operational status and error surfaces | `@bytelyst/diagnostics-client`, `@bytelyst/errors` | Add diagnostics client when operational panels migrate; keep `@bytelyst/errors` for shared error contracts. | +| Feature flags | Product-local feature gate utilities and backend config | `@bytelyst/feature-flag-client`, `@bytelyst/backend-flags` | Use common feature flag client for web gates when replacing product-local feature gate plumbing. | +| Kill switch | `@bytelyst/kill-switch-client` in root/web/mobile dependencies | `@bytelyst/kill-switch-client` | Already consumed; migrate UI status surfaces to common primitives, not new service code. | +| Blob and extraction | Product-specific research/import surfaces not yet common-backed | `@bytelyst/blob-client`, `@bytelyst/blob`, `@bytelyst/storage`, `@bytelyst/extraction` | Evaluate when file/blob/extraction workflows are touched; no trading-domain move. | +| Offline and broadcast | Product-local realtime/socket behavior and mobile support | `@bytelyst/offline-queue`, `@bytelyst/broadcast-client`, `@bytelyst/sync`, `@bytelyst/events` | Keep trading WebSocket domain local; use common offline/broadcast only for product-agnostic client concerns. | +| Billing/subscription | Membership tab/product tier policy | `@bytelyst/billing-client`, `@bytelyst/subscription-client`, `@bytelyst/marketplace-client` | Evaluate during membership/marketplace migration; keep trading tier rules local when domain-specific. | +| Feedback and survey | No first-class common client usage found | `@bytelyst/feedback-client`, `@bytelyst/survey-client` | Add only when feedback/survey surfaces are introduced or migrated. | +| Datastore/config | Backend Cosmos repositories and `@bytelyst/config` bootstrap | `@bytelyst/datastore`, `@bytelyst/cosmos`, `@bytelyst/config`, `@bytelyst/backend-config` | Existing `@bytelyst/cosmos`/`config` usage stays; consider `datastore` only for reusable storage helpers. | +| Operational shells/components | Local AppShell, Sidebar, cards, lists, status surfaces | `@bytelyst/ui`, `@bytelyst/dashboard-shell`, `@bytelyst/dashboard-components` | Prefer `@bytelyst/ui` first; evaluate dashboard packages only if they fit product-agnostic shell/list composition. | + ## Roadmap | Status | Phase | Scope / Repo | Implementation Summary | Verification Commands | Commit Hash | Notes / Deferrals |