-- =====================================================================
-- HC MEDICA -- Migracion Onboarding/Tutorial guiado
-- =====================================================================
-- Agrega 2 columnas a la tabla `usuario` para soportar el sistema de
-- onboarding (Driver.js):
--   - tutorial_visto    TINYINT(1)  -- flag "ya vio el tour"
--   - tutorial_progreso TEXT        -- JSON corto con el ultimo paso visto
--
-- IDEMPOTENTE: usa `ADD COLUMN IF NOT EXISTS` (nativo de MariaDB 10.0.2+).
-- Si las columnas ya existen, MariaDB emite un warning pero NO falla;
-- el script puede ejecutarse varias veces sin error.
--
-- NOTA: la version anterior usaba information_schema, lo cual requiere
-- permisos que no estan disponibles en muchos cPanel compartidos.
-- Esta version solo necesita permisos de ALTER sobre la propia tabla.
--
-- COMPATIBILIDAD DE CHARSET: el ALTER NO especifica CHARACTER SET ni
-- COLLATE, por lo que las columnas nuevas heredan el charset de la tabla
-- `usuario` (latin1 / latin1_swedish_ci segun BASE PROJECT.sql).
--
-- Fecha: 2026-05-19
-- Ejecutar en: phpMyAdmin -> BD de cada tenant -> pestana SQL
-- =====================================================================


-- ---------------------------------------------------------------------
-- 1) Agregar ambas columnas si no existen (1 sola sentencia ALTER)
-- ---------------------------------------------------------------------
ALTER TABLE `usuario`
  ADD COLUMN IF NOT EXISTS `tutorial_visto`    TINYINT(1) NOT NULL DEFAULT 0
    COMMENT '0=no ha visto el tour, 1=ya lo vio',
  ADD COLUMN IF NOT EXISTS `tutorial_progreso` TEXT       NULL     DEFAULT NULL
    COMMENT 'JSON corto con el paso actual del tour';


-- ---------------------------------------------------------------------
-- 2) Verificacion final -- debe mostrar las 2 columnas
-- ---------------------------------------------------------------------
SHOW COLUMNS FROM `usuario` LIKE 'tutorial_%';
