Manual de Uso y Mantenimiento

1. Actualización de Productos

Los productos se gestionan a través de archivos JavaScript situados en la carpeta data/. Hay un archivo para cada idioma.

Español: data/productos_es.js
Inglés: data/productos_en.js

Para añadir un producto, puedes usar la herramienta Nexus Forge (generator.html) o editar el archivo manualmente siguiendo este formato:

{
    "title": "Nombre del Producto",
    "description": "Descripción corta...",
    "price": "1299€",
    "category": "Robótica", // Categorías: Robótica, IA Soft, Hologramas, VR, Formación
    "image": "URL_de_la_imagen",
    "link": "URL_de_afiliado",
    "platform": "Amazon", // Opcional (para cursos: Udemy, Coursera)
    "duration": "10h",    // Solo para cursos
    "level": "Intermedio", // Solo para cursos
    "date": "2025-12-05",
    "review_url": "URL_video_review", // Opcional
    "audit_link": "URL_auditoria_etechal", // Opcional (Link a audit.html?id=...)
    "etica_tip": "Consejo ético sobre el uso..."
}

2. Configuración de Noticias (RSS)

Las noticias se extraen automáticamente de fuentes RSS. Puedes configurar estas fuentes en los archivos de configuración:

Español: data/config_es.js
Inglés: data/config_en.js

El formato es un objeto donde la clave es la Categoría (debe coincidir con las categorías de los productos) y el valor es una lista de URLs RSS.

"rssFeeds": {
    "general": ["https://web.com/rss"],
    "Robótica": ["https://web.com/tag/robotica/feed"],
    "IA Soft": ["https://web.com/tag/ai/feed"]
}

Nota: Si seleccionas la categoría "Robótica" en la web, se cargarán las noticias definidas en "Robótica". Si no hay feeds específicos, se usarán los de "general".

3. Modelos de Auditoría (JSON)

El sistema de auditoría soporta múltiples tipos de productos. Cada uno tiene un esquema de 5 pilares específico.

Tipos Soportados:

app: Aplicaciones Móviles / Web
robot: Robots Físicos / Drones
vr: Realidad Virtual / Aumentada
car: Vehículos Autónomos
ai: Modelos de IA / LLMs
hologram: Hologramas / Pantallas Públicas

Ejemplo de estructura JSON para un Robot:

{
    "id": "robot-asimo-x",
    "type": "robot", // IMPORTANTE: Definir el tipo
    "metadata": {
        "appName": "Asimo X",
        "org": "Honda Robotics",
        "date": "2025-12-10",
        "summary": "..."
    },
    "scores": { "p1": 4.5, ... },
    "details": {
        "p1": { // Seguridad Física & Asimov
            "s1": 5, // Daño Cero
            "s2": 5, // Parada Emergencia
            "s3": 4, // Seguridad Fallos
            "notes": "..."
        },
        // ... p2 (Privacidad), p3 (Autonomía), p4 (Social), p5 (Ciclo de Vida)
    }
}

Utiliza el Generador de Auditoría (tools/audit_generator.html) para crear estos JSONs automáticamente seleccionando el tipo de producto adecuado.

3.5. Herramientas de Privacidad

El sistema incluye nuevas herramientas de privacidad en la carpeta tools/:

EXIF Purge (metadata.html): Limpiador de metadatos para imágenes.
Stego Vault (stego.html): Esteganografía para ocultar texto en imágenes.
Neural Camouflage (camou.html): Ruido adversarial para proteger rostros de IA.

4. Auditoría de Impacto Laboral (HFI)

Para productos que afectan al empleo (robots, IA), puedes incluir el módulo Human Factor Index.

Añade este objeto al JSON de la auditoría:

"labor_impact": {
    "enabled": true,
    "analysis_summary": "Resumen del impacto...",
    "sectors": [
        {
            "name": "Logística",
            "substitution_score": 85, // 0-100 (Eje X)
            "augmentation_score": 20, // 0-100 (Eje Y)
            "verdict": "Riesgo Alto",
            "barrier_entry": "Baja", // Baja, Media, Alta
            "description": "Explicación...",
            "pros": ["Eficiencia", "Seguridad"],
            "cons": ["Despidos", "Coste inicial"]
        }
    ]
}

3. Arquitectura y SEO: ¿Una página o varias?

Opción Actual (SPA - Single Page)

✅ Mantenimiento fácil: Solo editas index.html y los cambios se aplican a todo.
✅ Experiencia de usuario: Navegación instantánea, sin recargas.
✅ Moderno: Se siente como una app.
⚠️ SEO: Bueno para la marca general. Usamos "Dynamic Meta Tags" para cambiar la descripción según el idioma.

Opción Multi-Página (HTML por categoría)

✅ SEO Específico: Puedes tener robotica.html posicionado específicamente para "comprar robots".
❌ Mantenimiento Pesadilla: Si quieres cambiar el pie de página, tienes que editar 5 o 6 archivos HTML manualmente.
❌ Experiencia: La página parpadea y recarga al cambiar de categoría.

Recomendación Técnica

Para un proyecto de este tamaño gestionado manualmente, la arquitectura actual (SPA) es superior. El beneficio de mantenimiento supera con creces la pequeña ventaja de SEO que tendrías con archivos separados.

Si en el futuro el tráfico crece mucho y necesitas un SEO muy agresivo, la solución profesional NO es hacer HTMLs sueltos, sino migrar a un generador de sitios estáticos (como Astro o Next.js) que genere esos HTMLs automáticamente.

Conclusión: Mantén la estructura actual.