# MASTER_INVENTORY.yml - Trading Platform Frontend
# Sistema SIMCO v3.8+ | Ciclo CAPVED
# Ultima actualizacion: 2026-01-13

metadata:
  proyecto: trading-platform-frontend
  version: 1.0.0
  tema: STC Theme (Gold/Black)
  stack:
    - React 18
    - TypeScript
    - Vite
    - Tailwind CSS
    - shadcn/ui
    - Radix UI Primitives
    - Zustand (state management)
    - TanStack Query (data fetching)

# =============================================================================
# COMPONENTES UI BASE (shadcn/ui migrados)
# =============================================================================
componentes_ui:
  estado: COMPLETADO
  ruta_base: src/components/ui/

  items:
    - nombre: button.tsx
      tipo: componente
      dependencias: [class-variance-authority, @radix-ui/react-slot]
      variantes: [default, destructive, outline, secondary, ghost, link]
      estado: migrado

    - nombre: card.tsx
      tipo: componente
      dependencias: []
      exports: [Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent]
      estado: migrado

    - nombre: input.tsx
      tipo: componente
      dependencias: []
      estado: migrado

    - nombre: label.tsx
      tipo: componente
      dependencias: [@radix-ui/react-label]
      estado: migrado

    - nombre: badge.tsx
      tipo: componente
      dependencias: [class-variance-authority]
      variantes: [default, secondary, destructive, outline]
      estado: migrado

    - nombre: dialog.tsx
      tipo: componente
      dependencias: [@radix-ui/react-dialog, lucide-react]
      exports: [Dialog, DialogPortal, DialogOverlay, DialogTrigger, DialogClose, DialogContent, DialogHeader, DialogFooter, DialogTitle, DialogDescription]
      estado: migrado

    - nombre: select.tsx
      tipo: componente
      dependencias: [@radix-ui/react-select, lucide-react]
      exports: [Select, SelectGroup, SelectValue, SelectTrigger, SelectContent, SelectLabel, SelectItem, SelectSeparator, SelectScrollUpButton, SelectScrollDownButton]
      estado: migrado

    - nombre: progress.tsx
      tipo: componente
      dependencias: [@radix-ui/react-progress]
      modificaciones:
        - descripcion: Agregado prop indicatorClassName para estilos custom
          fecha: 2026-01-13
      estado: migrado

    - nombre: skeleton.tsx
      tipo: componente
      dependencias: []
      notas: Creado para estados de carga
      estado: creado

    - nombre: sheet.tsx
      tipo: componente
      dependencias: [@radix-ui/react-dialog, class-variance-authority, lucide-react]
      exports: [Sheet, SheetPortal, SheetOverlay, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription]
      variantes_posicion: [top, bottom, left, right]
      notas: Creado para CartSidebar
      estado: creado

    - nombre: tabs.tsx
      tipo: componente
      dependencias: [@radix-ui/react-tabs]
      exports: [Tabs, TabsList, TabsTrigger, TabsContent]
      estado: migrado

    - nombre: avatar.tsx
      tipo: componente
      dependencias: [@radix-ui/react-avatar]
      exports: [Avatar, AvatarImage, AvatarFallback]
      estado: migrado

    - nombre: dropdown-menu.tsx
      tipo: componente
      dependencias: [@radix-ui/react-dropdown-menu, lucide-react]
      estado: migrado

    - nombre: separator.tsx
      tipo: componente
      dependencias: [@radix-ui/react-separator]
      estado: migrado

    - nombre: switch.tsx
      tipo: componente
      dependencias: [@radix-ui/react-switch]
      estado: migrado

    - nombre: textarea.tsx
      tipo: componente
      dependencias: []
      estado: migrado

    - nombre: tooltip.tsx
      tipo: componente
      dependencias: [@radix-ui/react-tooltip]
      exports: [Tooltip, TooltipTrigger, TooltipContent, TooltipProvider]
      estado: migrado

    - nombre: alert.tsx
      tipo: componente
      dependencias: [class-variance-authority]
      exports: [Alert, AlertTitle, AlertDescription]
      variantes: [default, destructive]
      estado: migrado

    - nombre: form.tsx
      tipo: componente
      dependencias: [@radix-ui/react-label, @radix-ui/react-slot, react-hook-form]
      estado: migrado

    - nombre: scroll-area.tsx
      tipo: componente
      dependencias: [@radix-ui/react-scroll-area]
      estado: migrado

    - nombre: table.tsx
      tipo: componente
      dependencias: []
      exports: [Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption]
      estado: migrado

# =============================================================================
# MODULOS DE APLICACION
# =============================================================================
modulos:

  # ---------------------------------------------------------------------------
  # MODULO AUTH
  # ---------------------------------------------------------------------------
  auth:
    estado: COMPLETADO
    ruta: src/modules/auth/

    pages:
      - nombre: LoginPage.tsx
        descripcion: Pagina de inicio de sesion
        componentes_ui: [Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Input, Label, Button, Separator]
        iconos: [Eye, EyeOff, Loader2]
        tema: STC Gold/Black
        estado: migrado

      - nombre: RegisterPage.tsx
        descripcion: Pagina de registro de organizacion
        componentes_ui: [Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Input, Label, Button, Separator, Checkbox]
        iconos: [Eye, EyeOff, Loader2, Check, Circle]
        tema: STC Gold/Black
        caracteristicas:
          - Password strength validation
          - Auto-generate organization slug
          - Terms acceptance checkbox
        estado: migrado

      - nombre: ForgotPasswordPage.tsx
        descripcion: Pagina de recuperacion de contrasena
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Input, Label, Button]
        iconos: [Loader2, Mail, ArrowLeft, AlertTriangle]
        tema: STC Gold/Black
        estado: migrado

      - nombre: ResetPasswordPage.tsx
        descripcion: Pagina de restablecimiento de contrasena
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Input, Label, Button]
        iconos: [Loader2, Lock, Check, Circle, AlertTriangle]
        tema: STC Gold/Black
        estado: migrado

  # ---------------------------------------------------------------------------
  # MODULO WALLET
  # ---------------------------------------------------------------------------
  wallet:
    estado: COMPLETADO
    ruta: src/modules/wallet/

    pages:
      - nombre: WalletPage.tsx
        descripcion: Pagina principal de billetera
        componentes_ui: [Button, Skeleton]
        tema: STC Gold/Black
        estado: migrado

    components:
      - nombre: WalletCard.tsx
        descripcion: Tarjeta de balance de billetera
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Progress, Badge]
        iconos: [Wallet]
        tema: STC Gold/Black
        estado: migrado

      - nombre: TransactionList.tsx
        descripcion: Lista de transacciones
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Skeleton]
        iconos: [ArrowUpRight, ArrowDownLeft]
        tema: STC Gold/Black
        estado: migrado

      - nombre: DepositModal.tsx
        descripcion: Modal para depositos
        componentes_ui: [Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, Input, Label, Button]
        iconos: [Loader2]
        tema: STC Gold/Black
        fix_aplicado: Removido import no utilizado de X
        estado: migrado

      - nombre: WithdrawModal.tsx
        descripcion: Modal para retiros
        componentes_ui: [Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, Input, Label, Button]
        iconos: [Loader2]
        tema: STC Gold/Black
        estado: migrado

  # ---------------------------------------------------------------------------
  # MODULO PRODUCTS
  # ---------------------------------------------------------------------------
  products:
    estado: COMPLETADO
    ruta: src/modules/products/

    pages:
      - nombre: ProductsPage.tsx
        descripcion: Pagina de marketplace de productos
        componentes_ui: [Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Card, CardContent, CardHeader, CardTitle, Input, Button, Badge]
        iconos: [Search, SlidersHorizontal, ShoppingCart]
        tema: STC Gold/Black
        estado: migrado

    components:
      - nombre: ProductGrid.tsx
        descripcion: Grid de productos con skeleton loading
        componentes_ui: [Skeleton]
        tema: STC Gold/Black
        estado: migrado

      - nombre: ProductCard.tsx
        descripcion: Tarjeta de producto individual
        componentes_ui: [Card, CardContent, Badge, Button]
        iconos: [Star, ShoppingCart]
        tema: STC Gold/Black
        estado: migrado

      - nombre: CartSidebar.tsx
        descripcion: Sidebar de carrito de compras
        componentes_ui: [Sheet, SheetContent, SheetHeader, SheetTitle, Button]
        iconos: [Trash2, Plus, Minus, Loader2]
        tema: STC Gold/Black
        fix_aplicado:
          - Removido import no utilizado de X
          - Agregado tipo explicito a parametro open
        estado: migrado

  # ---------------------------------------------------------------------------
  # MODULO VIP
  # ---------------------------------------------------------------------------
  vip:
    estado: COMPLETADO
    ruta: src/modules/vip/

    pages:
      - nombre: VipPage.tsx
        descripcion: Pagina de suscripciones VIP
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Button, Skeleton]
        tema: STC Gold/Black
        estado: migrado

    components:
      - nombre: TierCard.tsx
        descripcion: Tarjeta de tier VIP (GOLD, PLATINUM, DIAMOND)
        componentes_ui: [Card, CardContent, CardFooter, CardHeader, Button, Badge]
        iconos: [Loader2, Check]
        tema: STC Gold/Black
        colores_tier:
          GOLD: bg-gold/10, border-gold/50, text-gold
          PLATINUM: bg-gray-300/10, border-gray-300/50, text-gray-300
          DIAMOND: bg-cyan-400/10, border-cyan-400/50, text-cyan-400
        estado: migrado

      - nombre: SubscriptionCard.tsx
        descripcion: Tarjeta de suscripcion activa
        componentes_ui: [Card, CardContent, CardHeader, Button, Badge, Progress]
        iconos: []
        tema: STC Gold/Black
        gradiente: from-gold/20 to-primary-700/50 (header)
        estado: migrado

      - nombre: ModelAccessList.tsx
        descripcion: Lista de acceso a modelos ML por tier
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Badge]
        iconos: [Check, Lock]
        tema: STC Gold/Black
        notas: Tier badges con colores gold/gray/cyan
        estado: migrado

  # ---------------------------------------------------------------------------
  # MODULO INVESTMENT
  # ---------------------------------------------------------------------------
  investment:
    estado: COMPLETADO
    ruta: src/modules/investment/

    pages:
      - nombre: InvestmentPage.tsx
        descripcion: Pagina de agentes de inversion
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Skeleton]
        tema: STC Gold/Black
        gradiente: from-gold/20 to-primary-700/50 (Portfolio Summary)
        estado: migrado

    components:
      - nombre: AgentCard.tsx
        descripcion: Tarjeta de agente de inversion
        componentes_ui: [Card, CardContent, CardFooter, Button, Badge]
        iconos: []
        tema: STC Gold/Black
        gradiente: from-gold/20 to-primary-700/20 (ORION agent)
        estado: migrado

      - nombre: AllocationCard.tsx
        descripcion: Tarjeta de asignacion de inversion
        componentes_ui: [Card, CardContent, CardFooter, CardHeader, Button, Badge]
        iconos: []
        tema: STC Gold/Black
        notas: Badge variants para estados (ACTIVE, PENDING, etc.)
        estado: migrado

      - nombre: AllocationModal.tsx
        descripcion: Modal para gestionar asignaciones
        componentes_ui: [Dialog, DialogContent, DialogHeader, DialogTitle, Input, Label, Button, Tabs, TabsList, TabsTrigger, TabsContent]
        iconos: [Loader2]
        tema: STC Gold/Black
        estado: migrado

  # ---------------------------------------------------------------------------
  # MODULO PREDICTIONS
  # ---------------------------------------------------------------------------
  predictions:
    estado: COMPLETADO
    ruta: src/modules/predictions/

    pages:
      - nombre: PredictionsPage.tsx
        descripcion: Marketplace de predicciones ML
        componentes_ui: [Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Card, CardContent, CardHeader, CardTitle, Button, Label, Skeleton]
        iconos: [History, Loader2]
        tema: STC Gold/Black
        gradiente: from-gold/20 to-primary-700/50 (Request Section)
        estado: migrado

      - nombre: PredictionHistoryPage.tsx
        descripcion: Pagina de historial y validacion de predicciones
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Button, Input, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Dialog, DialogContent, DialogHeader, DialogTitle, Skeleton]
        iconos: []
        tema: STC Gold/Black
        caracteristicas:
          - Filtros por tipo, asset class, status
          - Modal de detalle de prediccion
          - StatsOverview integrado
        fix_aplicado: Removido import no utilizado de X
        estado: migrado

    components:
      - nombre: PackageCard.tsx
        descripcion: Tarjeta de paquete de predicciones
        componentes_ui: [Card, CardContent, CardFooter, CardHeader, Button, Badge]
        iconos: [Loader2]
        tema: STC Gold/Black
        colores_tipo:
          AMD: border-blue-500/50 bg-blue-500/10
          RANGE: border-green-500/50 bg-green-500/10
          TPSL: border-gold/50 bg-gold/10
          ICT_SMC: border-orange-500/50 bg-orange-500/10
          STRATEGY_ENSEMBLE: border-cyan-500/50 bg-cyan-500/10
        estado: migrado

      - nombre: PredictionCard.tsx
        descripcion: Tarjeta de prediccion individual
        componentes_ui: [Card, CardContent, CardHeader, Badge]
        iconos: []
        tema: STC Gold/Black
        caracteristicas:
          - Direction indicator (LONG/SHORT/NEUTRAL)
          - Confidence display
          - Entry/Target/StopLoss prices
          - Outcome section (win/loss/partial)
        estado: migrado

      - nombre: StatsOverview.tsx
        descripcion: Vista de estadisticas de predicciones
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Progress]
        iconos: []
        tema: STC Gold/Black
        caracteristicas:
          - Total predictions, win rate, avg P&L
          - By type breakdown con progress bars
          - By asset class breakdown
          - Outcome distribution bar
        estado: migrado

  # ---------------------------------------------------------------------------
  # MODULO RBAC
  # ---------------------------------------------------------------------------
  rbac:
    estado: COMPLETADO
    ruta: src/modules/rbac/

    components:
      - nombre: PermissionGate.tsx
        descripcion: Componente de control de acceso por permisos
        tipo: utilidad (sin UI)
        exports: [RequirePermission, RequirePermissions, RequireRole, PermissionGate]
        notas: Componente logico, no requiere tema visual
        estado: completo

  # ---------------------------------------------------------------------------
  # MODULO DASHBOARD
  # ---------------------------------------------------------------------------
  dashboard:
    estado: COMPLETADO
    ruta: src/modules/dashboard/

    pages:
      - nombre: DashboardPage.tsx
        descripcion: Pagina principal del dashboard con overview
        componentes_ui: [Card, CardContent, CardHeader, CardTitle, Button, Badge, Skeleton]
        iconos: [Wallet, Star, Bot, Target, TrendingUp, TrendingDown, ShoppingCart, ArrowRight, LayoutDashboard]
        tema: STC Gold/Black
        caracteristicas:
          - Welcome header con gradiente gold
          - Quick stats (balance, VIP, P&L, positions)
          - Quick actions links
          - Recent activity section
          - Market overview placeholder
        estado: creado

  # ---------------------------------------------------------------------------
  # MODULO SETTINGS
  # ---------------------------------------------------------------------------
  settings:
    estado: COMPLETADO
    ruta: src/modules/settings/

    pages:
      - nombre: SettingsPage.tsx
        descripcion: Pagina de configuracion de usuario
        componentes_ui: [Card, CardContent, CardDescription, CardHeader, CardTitle, Button, Input, Label, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Separator, Avatar, AvatarFallback]
        iconos: [User, Shield, Bell, Palette, Save, Loader2, Eye, EyeOff, Check]
        tema: STC Gold/Black
        caracteristicas:
          - Tab Profile (datos personales, avatar)
          - Tab Security (cambio password, 2FA, sesiones)
          - Tab Preferences (notificaciones, tema)
        estado: creado

# =============================================================================
# COMPONENTES GLOBALES
# =============================================================================
componentes_globales:
  estado: COMPLETADO
  ruta_base: src/

  items:
    - nombre: components/Layout.tsx
      descripcion: Layout principal de la aplicacion
      componentes_ui: [Button, Badge, DropdownMenu, Tooltip, Avatar]
      iconos: [Moon, Sun, Settings, LogOut, Wallet, ShoppingCart, Star, Bot, Target]
      tema: STC Gold/Black
      caracteristicas:
        - Top navigation con rutas
        - Mobile navigation responsive
        - User dropdown menu
        - Theme toggle
        - VIP badge
        - Wallet balance display
      estado: migrado

    - nombre: components/ProtectedRoute.tsx
      descripcion: Componentes de rutas protegidas y publicas
      exports: [ProtectedRoute, PublicRoute]
      tema: STC Gold/Black (spinner)
      fix_aplicado: Migrado spinner de purple a gold
      estado: migrado

    - nombre: routes.tsx
      descripcion: Definicion de rutas de la aplicacion
      caracteristicas:
        - Lazy loading para code splitting
        - PageLoader con tema STC
        - Pagina 404 con tema STC
        - Rutas publicas y protegidas
      fix_aplicado:
        - Migrado PageLoader de purple a gold
        - Migrado 404 page de purple a gold
      estado: migrado

    - nombre: App.tsx
      descripcion: Componente principal de la aplicacion
      dependencias: [Layout, AppRoutes, TooltipProvider, QueryClientProvider, Toaster]
      tema: STC Gold/Black (toast styles)
      estado: completo

# =============================================================================
# CONFIGURACION DE TEMA
# =============================================================================
configuracion_tema:
  archivo_tailwind: tailwind.config.js
  archivo_css: src/index.css

  colores_principales:
    gold: "#ffd700"
    primary-50: "#f8f5e8"
    primary-100: "#eee8cc"
    primary-200: "#ddd19c"
    primary-300: "#c9b462"
    primary-400: "#b89a35"
    primary-500: "#9a7d1f"
    primary-600: "#7a6118"
    primary-700: "#5d4a15"
    primary-800: "#423614"
    primary-900: "#111827"
    primary-950: "#0a0c10"

  variables_css:
    background: "222.2 47.4% 11.2%"
    foreground: "210 40% 98%"
    primary: "43 100% 50%"
    secondary: "43 80% 45%"
    accent: "43 60% 40%"
    muted: "217.2 32.6% 17.5%"
    border: "217.2 32.6% 25%"

# =============================================================================
# VALIDACION FINAL
# =============================================================================
validacion:
  build: PASSED
  lint: PASSED
  typecheck: PASSED
  fecha_validacion: 2026-01-13
  resultado_build: "1991 modules transformed in 3.19s"

  componentes_migrados_sesion_2:
    - investment/AgentCard.tsx
    - investment/AllocationCard.tsx
    - investment/AllocationModal.tsx
    - vip/TierCard.tsx
    - vip/SubscriptionCard.tsx
    - vip/ModelAccessList.tsx
    - predictions/PackageCard.tsx
    - predictions/PredictionCard.tsx
    - predictions/StatsOverview.tsx
    - predictions/PredictionHistoryPage.tsx

  componentes_migrados_sesion_3:
    - routes.tsx (PageLoader, 404 page)
    - components/ProtectedRoute.tsx (spinner)
    - Documentacion actualizada con LoginPage, RegisterPage, RBAC, componentes globales

  componentes_creados_sesion_4:
    - dashboard/DashboardPage.tsx (pagina principal)
    - settings/SettingsPage.tsx (configuracion usuario)
    - routes.tsx (rutas Dashboard y Settings)
    - components/Layout.tsx (Dashboard en navegacion)
    - build: "1997 modules transformed in 3.49s"