depor_os/CLAUDE.md

DeporOS — Guía para Claude

Qué es este proyecto

Port del panel de administración PHP (sc-admin) de un club deportivo a Flutter. Solo el panel de administración (uso interno), NO la parte pública.

Rutas clave

Recurso	Ruta
PHP original (referencia)	/home/conejo/private_html/sportscenter/sc-admin/
PHP sidebar (menú)	/home/conejo/private_html/sportscenter/sc-admin/themes/modern/sidebar.php
Flutter (este proyecto)	/home/conejo/public_html/depor_os/
Estado de tareas	/home/conejo/public_html/depor_os/TAREAS.md

API backend

• Base URL: https://reservas.madriguera.me/2.0
• Auth: POST /login con {"email": "...", "password": "..."} → {"access_token": "..."}
• Token Bearer, guardado en SharedPreferences. Sin expiración, sin endpoint de logout.

Stack técnico

• Flutter con Material 3, seed color #1565C0 (azul)
• go_router ^14 para navegación (ShellRoute con sidebar)
• http ^1.2 para llamadas a la API
• shared_preferences ^2.3 para persistir el token
• Soporte light/dark mode

Estructura Flutter (lib/)

core/
  constants.dart        ← kApiBase
  router.dart           ← GoRouter + ShellRoute, todas las rutas
models/
  nav_item.dart         ← modelo NavItem (label, icon, route, children)
navigation/
  app_navigation.dart   ← árbol completo del sidebar (kAdminNavItems)
services/
  auth_service.dart     ← login(), logout(), getToken(), isLoggedIn()
widgets/
  app_shell.dart        ← layout responsive: sidebar fijo ≥800px / drawer <800px
  sidebar/
    sidebar_widget.dart ← header + scroll nav + footer logout
    nav_item_tile.dart  ← tiles simples y grupos expandibles (ExpansionTile)
screens/
  login/login_screen.dart
  dashboard/dashboard_screen.dart   ← 4 accesos rápidos en grid
  placeholder_screen.dart           ← pantalla temporal para módulos pendientes

Cómo retomar trabajo

1. Leer TAREAS.md para ver qué está hecho y qué sigue
2. Para cada módulo nuevo: revisar el PHP original en /home/conejo/private_html/sportscenter/sc-admin/
3. Preguntar al usuario el endpoint de la API antes de codificar
4. Al terminar una tarea: actualizar TAREAS.md

Plataformas y responsive

• Objetivo principal: web + tablet Android landscape
• Breakpoint sidebar: 800px (permanente) / <800px (drawer)
• Grid dashboard: ≥900px = 4 col / resto = 2 col
• Preparado para móvil aunque no es prioritario

Convenciones

• UI en español
• No usar Scaffold en pantallas hijas del ShellRoute (ya lo provee AppShell)
• Pantallas aún no implementadas usan PlaceholderScreen