<header class="page-heading">
  <p class="eyebrow">DOCUMENTACIÓN INTEGRADA</p>
  <h1>Manual completo de Eclipse Imperia</h1>
  <p>Guía de referencia para empezar, administrar el imperio, comprender cada sistema y jugar con teclado o lector de pantalla. Esta versión se incluye automáticamente en cada compilación.</p>
</header>

<div class="notice notice-success" role="status"><strong>Manual sincronizado con esta versión:</strong> {{ BUILDINGS|length }} edificios, {{ TECHNOLOGIES|length }} tecnologías, {{ SHIPS|length }} naves, {{ DEFENSES|length }} defensas, {{ MISSIONS|length }} misiones y {{ EXPEDITION_PROFILES|length }} expediciones profundas.</div>

{% set chapters = [
  ('manual-start','EMPEZAR','Primeros diez minutos'),
  ('manual-interface','INTERFAZ','Navegación, paneles y desplegables'),
  ('manual-accessibility','ACCESIBILIDAD','Teclado y lector de pantalla'),
  ('manual-economy','ECONOMÍA','Recursos, energía y construcción'),
  ('manual-science','CIENCIA','Investigación y requisitos'),
  ('manual-galaxy','CARTOGRAFÍA','Galaxia, lunas y escombros'),
  ('manual-fleet','FLOTAS','Naves, defensas y misiones'),
  ('manual-expeditions','EXPLORACIÓN','Expediciones y artefactos'),
  ('manual-population','SOCIEDAD','Agricultura, población y ecología'),
  ('manual-politics','RELACIONES','Comercio, mercado y diplomacia'),
  ('manual-strategy','MANDO','Centro estratégico y gobernadores'),
  ('manual-frontier','FRONTERA','Recursos raros y megaproyectos'),
  ('manual-timeline','HISTORIA','Cronología, instantáneas e informes de combate'),
  ('manual-government','GOBIERNO','Facciones, leyes y Senado galáctico'),
  ('manual-intelligence','INTELIGENCIA','Espionaje y contrainteligencia'),
  ('manual-designs','INGENIERÍA','Diseños de nave e invasiones terrestres'),
  ('manual-encounters','ENCUENTROS','Orígenes, situaciones, preespaciales y crisis'),
  ('manual-scenarios','COMUNIDAD','Semillas, escenarios, mods y aplicación instalable'),
  ('manual-community','GESTIÓN AVANZADA','Planificación y sistemas de comunidad'),
  ('manual-audio','AUDIO','Mezcla accesible e historial de señales'),
  ('manual-settings','SISTEMA','Configuración, guardado y copias'),
  ('manual-troubleshooting','AYUDA','Solución de problemas')
] %}

<div class="manual-actions button-row" aria-label="Acciones del manual"><button class="button" type="button" data-manual-panels="open">Abrir todos los capítulos</button><button class="button button-secondary" type="button" data-manual-panels="close">Cerrar todos los capítulos</button><a class="button button-secondary" href="{{ url_for('public_encyclopedia') if public_catalog|default(false) else url_for('game_view', section='encyclopedia') }}">Abrir enciclopedia técnica</a></div>

<div class="manual-chapters">
  {% for chapter_id, eyebrow, title in chapters %}
  <section class="panel collapsible-panel manual-chapter" data-collapsible-panel data-panel-key="{{ chapter_id }}" data-default-open="{{ 'true' if loop.first else 'false' }}">
    <h2 class="collapsible-heading"><button type="button" aria-label="{{ title }}" aria-expanded="{{ 'true' if loop.first else 'false' }}" aria-controls="{{ chapter_id }}-content"><span><small>{{ eyebrow }}</small>{{ title }}</span><span data-panel-indicator aria-hidden="true">{{ '−' if loop.first else '+' }}</span></button></h2>
    <div id="{{ chapter_id }}-content" data-panel-content {% if not loop.first %}hidden{% endif %}>
      {% if chapter_id == 'manual-start' %}
        <ol class="help-steps"><li><strong>Activa la economía.</strong> Sube Planta solar, Mina de metal y Mina de cristal sin dejar la energía en déficit.</li><li><strong>Abre Robótica.</strong> Reduce tiempos y desbloquea Astillero.</li><li><strong>Construye cargueros.</strong> Necesitarás capacidad para transportar y comerciar.</li><li><strong>Investiga.</strong> Laboratorio, Energía, Computación, Espionaje, motores y Astrofísica forman la base.</li><li><strong>Explora con prudencia.</strong> Mira Galaxia antes de enviar una misión y conserva combustible para el regreso.</li><li><strong>Lee Informes.</strong> Cada combate, expedición, cola o relación deja un resultado persistente.</li></ol>
      {% elif chapter_id == 'manual-interface' %}
        <p>La portada está dividida en paneles. Actívalos con <kbd>Enter</kbd> o <kbd>Espacio</kbd>; el estado expandido se comunica mediante <code>aria-expanded</code>. En Configuración puedes elegir portada compacta o abrirla completa.</p><p>La interfaz puede mostrarse en modo normal, con todos los apartados seguidos, o por pestañas, con un apartado visible cada vez y la navegación lateral agrupada. La elección se guarda por partida y ambos modos contienen todas las funciones.</p><p>En una lista de pestañas, Flecha izquierda y derecha recorren nombres, Inicio y Fin van a los extremos, Enter o Espacio abre el panel y Tab entra en su contenido. Los errores abren su panel antes de enfocar el campo.</p><p>Al enfocar un desplegable, la opción activa se coloca al principio sin cambiar su valor. Así puedes abrirlo y recorrer todas las alternativas con Flecha abajo. Puedes desactivar este comportamiento en Configuración.</p><p>La barra superior contiene recursos y accesos de visualización; la barra lateral conserva el planeta activo. Cambiar de sección mantiene el planeta seleccionado.</p>
      {% elif chapter_id == 'manual-accessibility' %}
        <div class="notice"><strong>Aviso para usuarios de lectores de pantalla:</strong> si NVDA, JAWS, Narrador u otro lector usa la misma combinación, su orden tiene prioridad y el juego no recibe esas teclas. Configuración permite añadir Shift a todos los atajos o remapear por separado cada acción mediante listas y casillas, sin tener que capturar pulsaciones simultáneas.</div><ul><li><kbd>{{ shortcut_map.galaxy }}</kbd> abre Galaxia incluso si estás en el selector de planeta y lleva el foco al título del mapa.</li><li><kbd>{{ shortcut_map.resources }}</kbd> enfoca y anuncia los recursos; <kbd>{{ shortcut_map.headings }}</kbd> abre el índice de secciones en modo normal o enfoca la pestaña activa en modo por pestañas.</li><li><kbd>{{ shortcut_map.shortcuts }}</kbd> muestra todas las teclas. Los cuadros emergentes colocan el foco en su título y al principio del contenido para empezar a leer con Flecha abajo; <kbd>Escape</kbd> los cierra y devuelve el foco.</li><li><kbd>{{ shortcut_map.manual }}</kbd> abre este manual en otra pestaña y conserva la pestaña del juego; <kbd>{{ shortcut_map.help }}</kbd> abre la ayuda breve.</li><li>El juego reconoce la tecla física, no el carácter producido por la distribución: si una combinación escribe otro carácter, se conserva la tecla física configurada.</li><li>Los atajos se desactivan en campos de texto para no interferir con AltGr, pero siguen funcionando desde selectores.</li><li>Hay foco visible, reflujo a 320 px, texto ampliado, colores forzados de Windows y reducción de movimiento.</li><li>Las pistas musicales cambian sin anuncios; solo los errores de audio importantes usan la región de estado.</li></ul>
      {% elif chapter_id == 'manual-economy' %}
        <p>Metal, cristal y deuterio se producen continuamente. La energía no se almacena: si el rendimiento cae, las minas producen menos. Los almacenes limitan cada recurso.</p><p>Solo hay una cola planetaria de edificios. Cancelarla devuelve el 75 %. Los edificios lunares no gastan campos del planeta: exigen una luna y consumen sus campos propios.</p><dl class="settings-list"><div><dt>Metal</dt><dd>Infraestructura, cascos y defensas.</dd></div><div><dt>Cristal</dt><dd>Electrónica, ciencia, escudos y sensores.</dd></div><div><dt>Deuterio</dt><dd>Combustible, motores y proyectos avanzados.</dd></div><div><dt>Energía</dt><dd>Porcentaje de rendimiento de minas e industria.</dd></div><div><dt>Alimento</dt><dd>Población, moral, ayuda y expediciones.</dd></div></dl>
      {% elif chapter_id == 'manual-science' %}
        <p>La investigación es imperial y solo puede existir una activa. Puede pagarse en el planeta actual o mediante la Red científica imperial, que previsualiza y reserva aportaciones automáticas o manuales de varios mundos y devuelve el 75 % a cada origen al cancelar. La velocidad científica es independiente de economía y flotas; Laboratorio, Supercomputador, Archivo de alianza y eras temporales también modifican la duración.</p><p>Los requisitos se muestran junto a cada ficha. Las {{ TECHNOLOGIES|length }} tecnologías cubren producción, combate, motores, diplomacia, ecología, logística, sigilo, infraestructura lunar, comunicaciones cuánticas y singularidades.</p>
      {% elif chapter_id == 'manual-galaxy' %}
        <p>Cada sistema contiene quince posiciones. La tabla de Galaxia muestra por separado planeta, imperio, luna, diámetro, campos lunares, metal, cristal y deuterio de escombros, anomalía y acciones. Sistemas y galaxias pueden ser lineales o circulares; la ruta efectiva se usa en todos los cálculos humanos y de IA.</p><p>Los porcentajes recuperables de naves, defensas y deuterio se fijan al crear el universo. Una concentración suficiente puede formar una luna con una probabilidad máxima del 20 %. Una luna abre Base lunar, Falange sensora, Portal de salto y Astillero lunar.</p><p>Envía Reciclaje directamente desde un campo visible. El campo desaparece al quedar vacío. Las anomalías solo aparecen cuando tu imperio las ha descubierto.</p>
      {% elif chapter_id == 'manual-fleet' %}
        <p>Las naves elegidas deben estar disponibles, la carga no puede superar su capacidad y el deuterio cubre carga más combustible. Computación amplía ranuras; motores, topología, eras, portales lunares, proyectos y artefactos modifican el viaje. La retirada ofrece por defecto una revisión de ruta, unidades, carga, regreso, combustible perdido y consecuencias; puede omitirse desde Asistencia.</p><div class="table-wrap"><table><caption>Las {{ MISSIONS|length }} misiones de flota</caption><thead><tr><th scope="col">Misión</th><th scope="col">Uso</th></tr></thead><tbody>{% for key, label in MISSIONS.items() %}<tr><th scope="row">{{ label }}</th><td>{{ MISSION_DESCRIPTIONS[key] }}</td></tr>{% endfor %}</tbody></table></div>
      {% elif chapter_id == 'manual-expeditions' %}
        <p>Las expediciones profundas consumen un Explorador, alimento y deuterio durante su duración. El especialista adecuado mejora el éxito; el protocolo altera tiempo, recompensa y probabilidad de regreso.</p><div class="table-wrap"><table><caption>{{ EXPEDITION_PROFILES|length }} objetivos expedicionarios</caption><thead><tr><th scope="col">Objetivo</th><th scope="col">Qué busca</th><th scope="col">Suministros base</th></tr></thead><tbody>{% for profile in EXPEDITION_PROFILES.values() %}<tr><th scope="row">{{ profile.name }}</th><td>{{ profile.description }}</td><td>{{ profile.food }} alimento · {{ profile.deuterium }} deuterio</td></tr>{% endfor %}</tbody></table></div>
      {% elif chapter_id == 'manual-population' %}
        <p>Las granjas asignan trabajadores y acumulan alimento hasta su capacidad. La población impulsa producción; hambre, contaminación y baja habitabilidad dañan moral y crecimiento.</p><p>Complejo agrícola añade parcelas, Biosfera y Hábitat orbital elevan población, y Centro de restauración, Matriz meteorológica, Nanomedicina y tecnologías ecológicas estabilizan mundos exigentes.</p>
      {% elif chapter_id == 'manual-politics' %}
        <p>Comercio planetario convierte alimento de inmediato. El Mercado galáctico usa ofertas persistentes con depósito. Las rutas comerciales exigen pacto o alianza; ayuda y rescate aumentan confianza.</p><p>Las relaciones pasan por neutralidad, comercio, no agresión, alianza o guerra. El sabotaje y los ataques rompen la paz. Los Depósitos de alianza de miembros activos aportan capacidad colectiva a observatorio, corredor, hospital, defensa, archivo y Astillero de socorro; los nodos requieren recursos y mantenimiento reales.</p>
      {% elif chapter_id == 'manual-strategy' %}
        <p>El Centro estratégico reúne libro mayor, recomendaciones explicables, plantillas, inteligencia, marcadores, simulación, logística y calculadores. Planificación añade la previsión acumulada de colas activas y pendientes, marca dependencias de producción futura y exporta CSV o JSON. Ningún planificador lanza una flota sin confirmación.</p><p>Los gobernadores son opcionales. Respetan enfoque, plan y reserva; pueden construir o cosechar, pero nunca atacan, cancelan colas ni invaden la reserva protegida.</p>
      {% elif chapter_id == 'manual-frontier' %}
        <p>Materia oscura, antimateria, materia exótica, datos cuánticos, muestras biológicas, influencia, reliquias y cronones alimentan la etapa avanzada. Proceden de edificios especializados, anomalías, mercado y expediciones.</p><p>Los megaproyectos son únicos por imperio, tardan tiempo real del juego y otorgan bonificaciones permanentes. Comprueba requisitos y reservas antes de iniciarlos.</p>
      {% elif chapter_id == 'manual-timeline' %}
        <p>Historia del universo importa los informes existentes y registra decisiones nuevas en una cronología filtrable por categoría, período y planeta. Un marcador conserva una entrada con etiqueta y nota.</p><p>Las instantáneas guardan reservas totales, puntuación, planetas, flotas y población. Selecciona dos para obtener diferencias exactas. Los informes de combate incluyen hasta seis rondas, daño, absorción, bajas por clase, tecnologías, doctrinas, políticas, botín, escombros y los tres grupos de factores decisivos. Atacante y defensor pueden exportar cada batalla en BBCode, Markdown o JSON. Informes y Estadísticas generan además un informe general del imperio en esos tres formatos.</p>
      {% elif chapter_id == 'manual-government' %}
        <p>Las cinco facciones cambian su apoyo según políticas, guerras, ciencia, comercio y expansión. Las diez leyes requieren apoyo, influencia inicial y mantenimiento periódico; si no puede pagarse, quedan suspendidas. Las elecciones renuevan mandatos y registran resultados completos.</p><p>El Senado permite proponer siete resoluciones, votar a favor, en contra o abstenerse, gastar favores para aumentar el peso, imponer reglas galácticas y elegir un custodio de crisis. Los imperios de IA votan con las mismas reglas cuando se cierra el plazo.</p>
      {% elif chapter_id == 'manual-intelligence' %}
        <p>Una red empieza con infiltración baja y gana acceso con el tiempo. El calor aumenta al actuar y puede revelar la autoría. Los agentes tienen especialidad y experiencia; los activos aportan fuentes con fiabilidad explícita.</p><p>Las posturas transparente, equilibrada, señuelos activos y cierre informativo alteran la confianza rival. Cada categoría conserva su propio grado y los datos inciertos aparecen como intervalos o estimaciones marcadas. Se pueden contrastar dos informes y el simulador conserva la incertidumbre. Las cinco operaciones encubiertas siguen exigiendo infiltración, influencia y tiempo reales.</p>
      {% elif chapter_id == 'manual-designs' %}
        <p>El diseñador ofrece cinco cascos y componentes de armas, escudos, blindaje, motores, sensores, sigilo, carga y reactor. La validación rechaza exceso de ranuras, energía o masa y calcula coste, potencia y rol antes de construir unidades personalizadas.</p><p>Las fuerzas terrestres consumen población y recursos. Una invasión exige guerra, origen, suministros y guarnición; avanza por aproximación, asalto y ocupación. Tras vencer puedes ocupar, integrar, vasallizar o liberar. La resistencia se reduce mediante negociación, ayuda civil, autonomía o liberación. Una rendición pacífica evita el combate si hay confianza, influencia y moral baja.</p>
        <div class="notice notice-warning"><strong>Importante:</strong> las defensas construidas en el Astillero solo combaten en órbita. Recluta la guarnición desde Fuerzas terrestres: cada soldado cuesta 8 metal y 3 cristal, cada blindado 160 metal, 80 cristal y 30 deuterio, y cada suministro 1 deuterio. El desembarco genera un aviso 30 segundos antes del primer asalto. Cada ronda y sus bajas quedan guardadas para atacante y defensor, incluso después de una derrota total.</div>
      {% elif chapter_id == 'manual-encounters' %}
        <p>Cada uno de los siete orígenes tiene tres capítulos y tres enfoques posibles. Las situaciones encadenadas conservan cuatro etapas, opciones, efectos, semilla y epílogo. Las decisiones quedan en Historia del universo.</p><p>Las civilizaciones preespaciales admiten observación, ayuda, infiltración y protección. Su contaminación, progreso y memoria persisten; cuando alcanzan el viaje interestelar nacen como un imperio nuevo y recuerdan el trato recibido.</p><p>Las siete crisis pasan por aviso, fase activa, clímax y resolución. Se puede combatir, investigar, negociar o alinearse con la amenaza. El Senado puede designar custodio; la amenaza causa daños si no se controla y las contribuciones de cada imperio quedan registradas.</p>
      {% elif chapter_id == 'manual-scenarios' %}
        <p>La semilla controla coordenadas, anomalías, contactos, situaciones y crisis. El código corto contiene toda la configuración y una suma de integridad, pero nunca incluye progreso ni una partida. El desafío semanal se genera localmente a partir del año y la semana.</p><p>Los mods usan manifiestos y catálogos JSON con identificadores en espacio de nombres, versiones y dependencias. Se validan antes de activarse, pueden deshabilitarse por universo y jamás ejecutan Python. El modo seguro ignora todos los mods.</p><p>La distribución incluye ocho mods completos con 16 orígenes, 16 campañas y 16 escenarios. Para crear o editar archivos, detén el servidor y abre <strong>Editor de mods</strong> en wxPython; <kbd>Control+H</kbd> explica cualquier control. La web conserva activación, aplicación de escenarios y modo seguro.</p><p>La PWA instala la interfaz y solo almacena recursos estáticos. Flask y wxPython siguen ejecutando el motor; acciones, sesión, recursos y exportaciones nunca se cachean.</p>
      {% elif chapter_id == 'manual-community' %}
        <p>Planificación reúne una cola de intenciones con requisitos, recursos reservados y previsión acumulada; un centro de notificaciones; recordatorios, agenda exportable y cuatro directivas consumibles obtenidas jugando. Protocolo ecológico, Acelerador temporal, Baliza de expedición e Impulso logístico admiten lotes, revisión y deshacer antes del siguiente ciclo; las IA usan el mismo inventario y límites.</p><p>El despacho de flotas muestra velocidad, salida, llegada, regreso, combustible y carga antes de confirmar. Mercado explica cada valoración. Las alianzas de IA conservan doctrina, tesorería, infraestructura, encargos, guerras puntuadas, mediación e historial.</p><p>Museo aplica conjuntos reales y permite desmontar, fabricar, restaurar y comerciar piezas permitidas. Estadísticas calcula beneficios netos y bajas; Informes añade reglas, búsquedas, conversaciones y retención con copia. Logística usa depósitos, rutas y convoyes físicos. Temporadas, recuperación y guerra orbital completan los objetivos rotatorios, la reconstrucción gradual y los misiles con capacidad, sensores y contramedidas.</p><p>Configuración permite programar cinco eras temporales con inicio, fin e historial, comunes para jugador e IA. La API local <code>/api/local/v1/</code> es temporal, de solo lectura, limitada a este equipo, desactivada por defecto y separa permisos para estado, planetas, flotas, calendario, informes y estadísticas. La interfaz permanece íntegramente en español.</p>
      {% elif chapter_id == 'manual-audio' %}
        <p>Música, interfaz, avisos, combate, efectos generales y ambiente tienen controles independientes. Mono mezcla los canales; la reducción para lector baja temporalmente el volumen al anunciarse texto, y el botón manual lo reduce durante veinte segundos.</p><p>El catálogo contiene {{ EFFECT_SOUNDS|length }} señales diferenciadas, incluidas planificación, recordatorio, artefacto, temporada, misil y recuperación. El historial textual conserva las últimas señales importantes con fecha, nombre y acción asociada. Todas las preferencias viajan dentro de la partida transferible.</p>
      {% elif chapter_id == 'manual-settings' %}
        <p><strong>Velocidad del universo:</strong> ×1 es tiempo base y el ritmo más lento. ×5 es pausada, ×10 es la opción recomendada para aprender, ×20 es acelerada y ×50 extrema. Producción, construcción, ciencia, viajes y sistemas temporales escalan de forma coherente también por debajo de ×5.</p>
        <p>Cada acción se guarda en <code>eclipse_imperia.dat</code>. En desarrollo está en <code>instance</code> y en la versión compilada en <code>datos</code>. El contenido SQLite se cifra y autentica con AES-GCM; su clave aleatoria se guarda mediante DPAPI en Windows, Keychain en macOS o Linux Secret Service. Una partida antigua DPAPI se migra automáticamente al formato común después de abrirse correctamente.</p><p>Las copias locales continúan ligadas al almacén seguro del sistema. Para otro equipo, detén el servidor, activa <strong>Importar o exportar partidas</strong> en wxPython y usa un <code>.eitransfer</code> con contraseña.</p><p>Configuración permite elegir navegación normal o por pestañas, pausar, cambiar reglas, expandir el universo, elegir asistencia, remapear cada tecla, usar el comodín Shift, cambiar audio, renombrar el planeta y descargar copias.</p><p><strong>Universo detenido</strong> congela producción, población, colas, flotas, operaciones, IA y temporizadores cuando cierras correctamente el servidor. <strong>Tiempo real</strong> reconstruye al volver la producción, los vencimientos y rondas estadísticas de IA con azar reproducible; los rivales pueden atacar. Resumen avisa del resultado y Configuración conserva las estadísticas. La pausa manual siempre congela. Los máximos son 128 rivales, 64 cooperativas agrícolas, 12 galaxias, 250 sistemas por galaxia y 12 agromundos propios iniciales.</p><p>El modo trampas exige escribir <strong>TRAMPAS</strong> exactamente. Después respeta la organización elegida para la partida: muestra sus siete apartados seguidos en el modo normal o uno cada vez en siete pestañas accesibles. Permite fijar o retirar recursos, niveles, tecnologías, unidades, fuerzas terrestres, granjas, lunas y artefactos del imperio humano. En el modo por pestañas, Flechas, Inicio y Fin recorren la lista; Enter o Espacio abre la elegida. Desactivarlo conserva los cambios y el universo permanece marcado como partida con trampas.</p>
      {% elif chapter_id == 'manual-troubleshooting' %}
        <dl class="compact-definition-list"><div><dt>Un atajo no responde o escribe otro carácter</dt><dd>En un campo de texto primero pulsa Tab. Si Control+Alt+1 produce <kbd>|</kbd>, la tecla física seguirá abriendo Resumen. Si el lector de pantalla captura la combinación, activa Shift adicional en Configuración y usa Control+Alt+Shift más la tecla.</dd></div><div><dt>No suena música</dt><dd>Actívala después de una interacción: los navegadores bloquean reproducción automática inicial.</dd></div><div><dt>No puedo construir</dt><dd>Revisa recursos, energía, requisitos, cola y campos; la infraestructura lunar necesita luna.</dd></div><div><dt>No aparece un escombro o una anomalía</dt><dd>Actualiza Galaxia. Las anomalías requieren descubrimiento y los escombros vacíos se eliminan.</dd></div><div><dt>No se inicia una misión</dt><dd>Comprueba nave especializada, destino, relación diplomática, carga, combustible y ranuras.</dd></div><div><dt>Quiero el dato exacto</dt><dd>Usa Enciclopedia: sus {{ manual_stats.articles }} artículos se generan desde los catálogos reales.</dd></div></dl>
      {% endif %}
    </div>
  </section>
  {% endfor %}
</div>
