# Arquitectura Responsiva y Layouts Multi-Pantalla - CPIC Conecta Este documento define la estrategia estructural de interfaz para soportar cualquier dispositivo: smartphones pequeños (`320px`), tablets, laptops de alta resolución y monitores ultrawide (`1440px+`). --- ## 1. Diagramas de Disposición por Dispositivo ### 1.1. Vista Móvil (`< 768px`) ``` ┌────────────────────────────────────────────────────────┐ │ [☰] [Logo] CPIC Conecta [💬 Chat] │ <- Cabecera Compacta (pl-14) ├────────────────────────────────────────────────────────┤ │ [🏠 Inicio] [🎓 Oferta] [🧭 Misión] [📞 Contacto] │ <- Chips Horizontales (Swipeable) ├────────────────────────────────────────────────────────┤ │ │ │ │ │ CONTENIDO PRINCIPAL │ │ (Scroll Vertical Fluido) │ │ │ │ │ │ │ ├────────────────────────────────────────────────────────┤ │ [♿] [💬] │ <- Píldora Flotante Inferior └────────────────────────────────────────────────────────┘ ``` *Cuando se pulsa el botón hamburguesa `[☰]`, se despliega un Drawer lateral off-canvas (`fixed inset-y-0 left-0 z-50`) con telón de fondo oscuro translúcido.* --- ### 1.2. Vista de Escritorio Estándar (`1024px` a `1439px`) ``` ┌───────┬────────────────────────────────────────┬───────┐ │ APP │ [🏠 Secciones / Títulos Principales] │ RIGHT │ │ SIDE │ │ SIDE │ │ BAR │ Tarjeta de Sección (Tier 2 Glass) │ BAR │ │ │ - Título H1 / H2 │ │ │ [🏠] │ - Párrafos de alto contraste │ [Logo]│ │ [💬] │ - Botones con acento Lime │ │ │ [👥] │ │ [♿] │ │ [📊] │ ------------------------------------ │ │ │ │ │ [💬] │ │ │ (Scroll con Snap Vertical Obligatorio)│ • │ <- Dots Nav │ │ │ • │ │ [⚙️] │ │ • │ │ [🌓] │ │ │ │ [🚪] │ [ 🏷️ CPIC Conecta • SofiaPlus • SENA ] │ │ <- Footer Retráctil └───────┴────────────────────────────────────────┴───────┘ ``` --- ## 2. Especificación Técnica por Rango de Pantalla ### 2.1. Móvil Pequeño y Estándar (`320px` - `639px`) - **Contenedor Principal**: ```jsx
``` - **Botón Hamburguesa Flotante**: - Posición: `fixed top-3 left-3 z-30 md:hidden`. - Tamaño: `w-10 h-10 min-w-[40px] min-h-[40px] rounded-xl bg-white/80 dark:bg-[rgba(10,22,10,0.85)] backdrop-blur-xl border border-black/8 dark:border-white/10`. - **Barra Superior**: - Espaciado izquierdo obligatorio: `pl-14` para no solaparse con el botón hamburguesa flotante. - **Navegación por Chips**: - Contenedor con `overflow-x-auto flex items-center gap-1.5 py-1 px-1`. - Ocultar scrollbar estándar: `style={{ scrollbarWidth: 'none', msOverflowStyle: 'none' }}`. - Auto-centrado del chip activo mediante `scrollIntoView({ behavior: 'smooth', block: 'nearest', inline: 'center' })`. - **Modales en Móvil**: - En lugar de modales centrados flotantes, se convierten en **Bottom Sheets**: ```jsx
``` --- ### 2.2. Tablet Portrait y Landscape (`640px` - `1023px`) - **Estructura**: - `sm:` activa rejillas de 2 columnas para tarjetas: `grid grid-cols-1 sm:grid-cols-2 gap-3`. - En `md:` (768px), `AppSidebar` pasa de ser un drawer móvil oculto a ser una barra lateral fija o colapsada a iconos (`w-16`). - Las tablas deben estar envueltas en contenedores de scroll horizontal con sombra indicadora: ```jsx
``` --- ### 2.3. Escritorio Estándar (`1024px` - `1439px`) - **Estructura de 3 Columnas**: 1. **Columna Izquierda (`AppSidebar`)**: Ancho base colapsado `w-[72px]`, expandible a `w-64` en hover o al pinchar el botón de anclaje. 2. **Columna Central (`main`)**: `flex-1 min-w-0 flex flex-col h-full overflow-hidden`. - Snap scrolling vertical: `snap-y snap-mandatory`. - Máscara de desvanecimiento superior e inferior para evitar cortes bruscos: ```css mask-image: linear-gradient(to bottom, transparent 0%, black 1.5%, black 98.5%, transparent 100%); -webkit-mask-image: linear-gradient(to bottom, transparent 0%, black 1.5%, black 98.5%, transparent 100%); ``` 3. **Columna Derecha (`RightSidebar`)**: Ancho `w-14 lg:w-16`, conteniendo el icono de accesibilidad (`AccessibilityPanel`), el iniciador del chat flotante (`FloatingChat`) y el logo institucional. - **Navegador de Puntos**: Columna vertical flotante centrada a la derecha (`hidden lg:flex absolute right-4 top-1/2 -translate-y-1/2`). --- ### 2.4. Pantallas Ultrawide (`1440px+` y monitores 4K) - En resoluciones ultrawide, evitar que las burbujas de texto o tablas se extiendan de lado a lado sin límite: - Ancho máximo de tarjetas: `max-w-6xl` o `max-w-7xl` con centrado automático `mx-auto`. - Burbujas de chat: limitadas a `max-w-[75%]` o `max-w-[800px]`. - Formularios de administración: disposición en 2 o 3 columnas de campos en lugar de una lista vertical estirada. --- ## 3. Manejo de Viewport y Safe Areas ```css /* Altura completa del viewport sin salto por barra de navegador móvil */ .app-container { height: 100dvh; max-height: 100dvh; min-height: 100dvh; } /* Espaciado para iPhone Notch e Isla Dinámica */ .safe-padding-top { padding-top: max(0.75rem, env(safe-area-inset-top)); } /* Espaciado para barra de inicio (Home indicator) en iOS y Android */ .safe-padding-bottom { padding-bottom: max(0.75rem, env(safe-area-inset-bottom)); } .safe-right { right: max(0.75rem, env(safe-area-inset-right)); } ``` --- ## 4. Reglas de Accesibilidad Táctil (Mobile Touch Standards) 1. **Tamaño Mínimo de Botón**: `min-h-[44px] min-w-[44px]`. 2. **Espaciado entre Interactivos**: Mínimo `8px` (`gap-2`) para evitar pulsaciones erróneas. 3. **Gestos y Navegación por Teclado**: - `ArrowDown` / `PageDown`: Desplazar a la siguiente sección activa. - `ArrowUp` / `PageUp`: Desplazar a la sección anterior. - `Escape`: Cerrar cualquier drawer, modal o menú abierto.