Docs: bitácora actualizada con estructura por módulo/sección
This commit is contained in:
Ricardo Monla
+64
-76
@@ -1,11 +1,11 @@
|
||||
# NORMALIZACIÓN — Plan de estructura del sitio de transición
|
||||
# NORMALIZACIÓN — Bitácora del sitio de transición
|
||||
|
||||
> Objetivo: Transformar `www-ksaldis-dt/` en un sitio web con estructura profesional,
|
||||
> mantenible y escalable, siguiendo estándares web actuales.
|
||||
> **Rama**: `develop` · **Producción**: `main` (protegida)
|
||||
> Objetivo: Migrar el contenido a `www-ksaldis-dt/` con estructura profesional.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Fase 0 — Base inicial (completada)
|
||||
## ✅ Fase 0 — Base del sitio (completada)
|
||||
|
||||
| # | Tarea | Estado |
|
||||
|---|-------|--------|
|
||||
@@ -13,91 +13,79 @@
|
||||
| 0.2 | Copiar `LIBRO_DE_ESTUDIO.html` como `index.html` | ✅ |
|
||||
| 0.3 | Extraer CSS inline → `css/style.css` | ✅ |
|
||||
| 0.4 | Extraer JS inline → `js/app.js` | ✅ |
|
||||
| 0.5 | Crear `assets/` para recursos estáticos | ✅ |
|
||||
| 0.6 | Symlinks a directorios de contenido (`videos_offline/`, `secciones/`, etc.) | ✅ Hecho |
|
||||
| 0.7 | Reemplazar symlinks de `imagenes/`, `screenshots/`, `campus/`, `subpaginas/` por copias reales | ✅ Hecho |
|
||||
| 0.8 | Jubilar `imagenes/` y `screenshots/` (reemplazados por `assets/images/`) | ✅ Hecho |
|
||||
| 0.5 | Crear `assets/` con subdirectorios por módulo y sección | ✅ |
|
||||
| 0.6 | Rama `develop` creada, `main` protegida (webhook solo main) | ✅ |
|
||||
|
||||
---
|
||||
|
||||
## 📋 Fase 1 — Limpieza y organización de assets
|
||||
## 📋 Fase 1 — Poblar assets/images/
|
||||
|
||||
| # | Tarea | Prioridad |
|
||||
|---|-------|-----------|
|
||||
| 1.1 | **Favicon**: Agregar ícono de sitio (`favicon.ico` o `.svg`) | 🟡 Media |
|
||||
| 1.2 | **Meta tags**: Agregar Open Graph, Twitter Cards, autor, keywords | 🟢 Alta |
|
||||
| 1.3 | **Google Fonts local**: Descargar Inter y servir desde `assets/fonts/` (sin depender de CDN) | 🟡 Media |
|
||||
| 1.4 | **Imágenes**: Copiar archivos reales a `imagenes/`, `screenshots/`, `campus/`, `subpaginas/` (reemplazar symlinks) | ✅ Hecho |
|
||||
| 1.5 | **Imágenes del campus**: Descargar ~40 imágenes referenciadas en `secciones/` a `assets/images/` (contenido de estudio) | ✅ Hecho |
|
||||
| 1.6 | **Rutas locales**: Actualizar `secciones/*/pagina.html` para que apunten a `assets/images/` en vez del campus online | ✅ Hecho |
|
||||
| 1.7 | **PDFs offline**: Identificar y descargar PDFs referenciados externamente | 🟡 Media |
|
||||
| 1.8 | **Eliminar dependencias externas**: Revisar que no haya recursos cargando de terceros (CDNs, Google Fonts, etc.) | 🟡 Media |
|
||||
> Descargar imágenes del campus y copiarlas a `assets/images/` organizadas por módulo.
|
||||
|
||||
### Comunes (logo, avatar, OEC)
|
||||
| # | Archivo | Origen | Estado |
|
||||
|---|---------|--------|--------|
|
||||
| 1.1 | `comunes/voley-banner.png` | `descargas/imagenes/img_001.png` | ⬜ |
|
||||
| 1.2 | `comunes/user-default.jpg` | `descargas/imagenes/img_002.jpg` | ⬜ |
|
||||
| 1.3 | `comunes/oec-logo-grey.png` | `descargas/imagenes/img_003.png` | ⬜ |
|
||||
| 1.4 | `comunes/bg-profile.jpg` | Campus online | ⬜ |
|
||||
|
||||
### Módulo 1 — imágenes de estudio (~40)
|
||||
| # | Subcarpeta | Imágenes | Estado |
|
||||
|---|-----------|----------|--------|
|
||||
| 1.5 | `modulo-1/analisis-equipos-1/` | 18 imágenes | ⬜ |
|
||||
| 1.6 | `modulo-1/analisis-equipos-2/` | 3 imágenes | ⬜ |
|
||||
| 1.7 | `modulo-1/seguimientos-equipos/` | 10 imágenes | ⬜ |
|
||||
| 1.8 | `modulo-1/tp-final/` | 3 imágenes | ⬜ |
|
||||
|
||||
### Módulo 2 — imágenes de estudio
|
||||
| # | Subcarpeta | Imágenes | Estado |
|
||||
|---|-----------|----------|--------|
|
||||
| 1.9 | `modulo-2/` | Usa solo imágenes comunes | ⬜ |
|
||||
|
||||
---
|
||||
|
||||
## 📋 Fase 2 — Estructura del contenido
|
||||
## 📋 Fase 2 — Poblar assets/resources/
|
||||
|
||||
| # | Tarea | Prioridad |
|
||||
|---|-------|-----------|
|
||||
| 2.1 | **Dividir el HTML**: Separar el contenido académico en páginas por módulo/sección (en lugar de un solo HTML gigante) | 🟡 Media |
|
||||
| 2.2 | **Navegación SPA**: Implementar navegación tipo Single Page Application (carga de contenido vía fetch + innerHTML) | 🔴 Alta |
|
||||
| 2.3 | **Sidebar dinámico**: Generar el menú desde un JSON de estructura en vez de hardcodearlo | 🟢 Alta |
|
||||
| 2.4 | **Breadcrumbs**: Agregar migas de pan para saber dónde estás en la navegación | 🟢 Alta |
|
||||
| 2.5 | **Página 404**: Crear página de error personalizada | 🟡 Media |
|
||||
> Copiar PDFs, videos y documentos a `assets/resources/` organizados por módulo y sección.
|
||||
|
||||
### Módulo 1 — Planificación
|
||||
| # | Subcarpeta | PDFs | Videos | Otros | Estado |
|
||||
|---|-----------|------|--------|-------|--------|
|
||||
| 2.1 | `modulo-1/planificacion/` | 8 | 1 | - | ⬜ |
|
||||
| 2.2 | `modulo-1/preparacion-atletica/` | 12 | 3 | - | ⬜ |
|
||||
| 2.3 | `modulo-1/explicacion-tp/` | 1 | 1 | - | ⬜ |
|
||||
| 2.4 | `modulo-1/seguimientos-equipos/` | 13 | 1 | 2 xls/zip | ⬜ |
|
||||
| 2.5 | `modulo-1/analisis-equipos-1/` | 11 | 2 | 7 xls/zip | ⬜ |
|
||||
| 2.6 | `modulo-1/analisis-equipos-2/` | 4 | - | 3 zip | ⬜ |
|
||||
| 2.7 | `modulo-1/tp-final/` | 1 | - | 1 ppt | ⬜ |
|
||||
|
||||
### Módulo 2 — Entrenamiento
|
||||
| # | Subcarpeta | PDFs | Videos | Otros | Estado |
|
||||
|---|-----------|------|--------|-------|--------|
|
||||
| 2.8 | `modulo-2/centrales-opuestos/` | 2 | 23 | - | ⬜ |
|
||||
| 2.9 | `modulo-2/puntas-liberos/` | 1 | 12 | - | ⬜ |
|
||||
| 2.10 | `modulo-2/entrenamiento-armadoras/` | - | 1 | - | ⬜ |
|
||||
| 2.11 | `modulo-2/explicacion-tp/` | - | 1 | - | ⬜ |
|
||||
|
||||
---
|
||||
|
||||
## 📋 Fase 3 — Mejoras visuales y UX
|
||||
## 📋 Fase 3 — Actualizar rutas en index.html
|
||||
|
||||
| # | Tarea | Prioridad |
|
||||
|---|-------|-----------|
|
||||
| 3.1 | **Print stylesheet**: `css/print.css` para impresión/PDF con formato limpio | 🟢 Alta |
|
||||
| 3.2 | **Modo oscuro**: Soporte de tema claro/oscuro con `prefers-color-scheme` | 🟡 Media |
|
||||
| 3.3 | **Transiciones**: Suavizar animaciones de sidebar,scroll y colapsos | 🟢 Alta |
|
||||
| 3.4 | **Barra de progreso de lectura**: Indicador visual de cuánto llevás leído | 🟡 Media |
|
||||
| 3.5 | **Responsive**: Mejorar la experiencia en tablets y celulares | 🟢 Alta |
|
||||
> Una vez copiados los archivos, actualizar `index.html` para que apunte a `assets/resources/...` en vez de `secciones/...` y `videos_offline/...`.
|
||||
|
||||
| # | Tarea | Estado |
|
||||
|---|-------|--------|
|
||||
| 3.1 | Reemplazar rutas `secciones/` → `assets/resources/` en index.html | ⬜ |
|
||||
| 3.2 | Reemplazar rutas `videos_offline/` → `assets/resources/` en index.html | ⬜ |
|
||||
| 3.3 | Verificar con servidor HTTP local que todo carga (200) | ⬜ |
|
||||
| 3.4 | Verificar que videos y PDFs se reproducen offline | ⬜ |
|
||||
|
||||
---
|
||||
|
||||
## 📋 Fase 4 — Funcionalidad y comportamiento
|
||||
## 📋 Fase 4 — Scripts de generación y deploy
|
||||
|
||||
| # | Tarea | Prioridad |
|
||||
|---|-------|-----------|
|
||||
| 4.1 | **Reproductor de video personalizado**: Skin propia sobre `<video>` (controles unificados, velocidad, pantalla completa) | 🟡 Media |
|
||||
| 4.2 | **Marcar temas vistos**: Guardar en `localStorage` qué temas/videos ya revisaste | 🔴 Alta |
|
||||
| 4.3 | **Búsqueda local**: Buscador de texto en el contenido del curso (sin servidor) | 🟡 Media |
|
||||
| 4.4 | **Descarga de PDF**: Botón para descargar cada sección como PDF | 🟢 Alta |
|
||||
| 4.5 | **Lazy loading**: Cargar videos y PDFs sólo cuando se despliega la sección (optimiza carga inicial) | 🟢 Alta |
|
||||
|
||||
---
|
||||
|
||||
## 📋 Fase 5 — Performance y accesibilidad
|
||||
|
||||
| # | Tarea | Prioridad |
|
||||
|---|-------|-----------|
|
||||
| 5.1 | **Auditoría Lighthouse**: Pasar auditoría y corregir problemas de accesibilidad, SEO y performance | 🟡 Media |
|
||||
| 5.2 | **Atributos ARIA**: Roles y etiquetas para lectores de pantalla en sidebar, botones, videos | 🟢 Alta |
|
||||
| 5.3 | **Etiquetas `lang`**: Verificar atributos de idioma en todo el contenido | 🟢 Alta |
|
||||
| 5.4 | **Imágenes con `alt`**: Asegurar que todas tengan texto alternativo descriptivo | 🟢 Alta |
|
||||
| 5.5 | **Contraste de colores**: Verificar contraste suficiente (WCAG AA como mínimo) | 🟡 Media |
|
||||
|
||||
---
|
||||
|
||||
## 📋 Fase 6 — Scripts de generación y deploy
|
||||
|
||||
| # | Tarea | Prioridad |
|
||||
|---|-------|-----------|
|
||||
| 6.1 | **Actualizar `generar_dashboard.mjs`**: Que genere directamente en la estructura `www-ksaldis-dt/` en vez de inline | 🔴 Alta |
|
||||
| 6.2 | **Actualizar deploy**: El webhook debe desplegar `www-ksaldis-dt/` en vez de archivos sueltos | 🔴 Alta |
|
||||
| 6.3 | **Actualizar `DSPLIEGUE.md`**: Reflejar la nueva estructura | 🟢 Alta |
|
||||
| 6.4 | **Limpiar archivos obsoletos**: Remover scripts temporales (`fix_videos.mjs`, `fix_all.js`, `test_*.js`, etc.) | 🟡 Media |
|
||||
|
||||
---
|
||||
|
||||
## 📋 Fase 7 — Pulido final
|
||||
|
||||
| # | Tarea | Prioridad |
|
||||
|---|-------|-----------|
|
||||
| 7.1 | **Testing cross-browser**: Probar en Chrome, Firefox, Edge, Safari | 🟡 Media |
|
||||
| 7.2 | **Testing offline**: Desconectar internet y verificar que todo funciona | 🔴 Alta |
|
||||
| 7.3 | **Pasar a producción**: Reemplazar el sitio en el hosting por `www-ksaldis-dt/` | 🔴 Alta |
|
||||
| # | Tarea | Estado |
|
||||
|---|-------|--------|
|
||||
| 4.1 | Actualizar `generar_dashboard.mjs` para que genere en estructura `www-ksaldis-dt/` | ⬜ |
|
||||
| 4.2 | Merge `develop → main` y deploy a producción | ⬜ |
|
||||
|
||||
Reference in New Issue
Block a user