1  Alcance, arquitectura y sistema de aprendizaje

CCPE-000 · Primera sesión

Un producto científico no es solamente su informe, figura o script final. También depende de datos, decisiones, herramientas, versiones y personas. Esta sesión permite reconocer ese sistema antes de intentar mejorarlo.

Producto esperado. Un primer mapa razonado de un producto científico real, con entradas, salidas, dependencias, pasos manuales y riesgos.

1.1 Delimitación del libro

El objeto de aprendizaje es el ecosistema digital científico: el conjunto organizado de personas, datos, archivos, formatos, lenguajes, herramientas, repositorios, servicios, reglas y flujos que permite producir conocimiento verificable y comunicable.

El libro se concentra en infraestructura digital, reproducibilidad, portabilidad, trazabilidad y seguridad. Puede usar ejemplos pesqueros o ecológicos para enseñar herramientas, pero deja la teoría estadística y el modelamiento cuantitativo para otro proyecto.

Concepto clave. Las herramientas cambian; deben permanecer la posibilidad de reconstruir el producto, el registro de decisiones y la separación entre fuentes, transformaciones y resultados.

Componentes que conviene distinguir

Tipo Pregunta que responde Ejemplos
Lenguaje ¿Con qué instrucciones proceso información? R, Python, SQL
Entorno de desarrollo ¿Dónde escribo, ejecuto y organizo? Positron
Formato ¿Cómo se representa o almacena? .csv, .qmd, .parquet
Base de datos ¿Dónde consulto datos persistentes? PostgreSQL, DuckDB
Plataforma o servicio ¿Dónde colaboro, alojo o publico? GitHub, GitHub Pages
Flujo de trabajo ¿Qué secuencia produce el resultado? datos → código → informe

Comprobación. Explique con sus propias palabras por qué R, Positron y un archivo .R no son el mismo tipo de componente.

1.2 Diagnóstico inicial

Responda antes de buscar soluciones. El diagnóstico no se califica por aciertos: sirve para registrar el punto de partida.

  1. ¿Qué diferencia existe entre un lenguaje, un entorno de desarrollo y un archivo de código?
  2. ¿Qué problema resuelve Git que no resuelve una copia de seguridad?
  3. ¿Qué parte de su flujo depende de copiar o renombrar archivos manualmente?
  4. ¿Qué debería permanecer reproducible si cambia el entorno de desarrollo?
  5. ¿Dónde existe mayor riesgo de usar una versión incorrecta de datos, código o resultados?
  6. ¿Qué criterio emplearía para decidir si una tarea debe automatizarse?

Reflexión. Señale qué respuesta le resultó más incierta y qué evidencia necesitaría para revisarla al final de la sesión.

1.3 Primera actividad: representar un producto real

Elija un informe, artículo, tablero, figura recurrente u otro producto que conozca. Dibuje su recorrido mínimo:

fuente → adquisición → dato de trabajo → transformación → validación
       → figura o tabla → documento → publicación o archivo

Para cada paso, anote:

  • responsable y herramienta;
  • entrada y salida;
  • ubicación y regla de versión;
  • acción manual o automática;
  • restricción de acceso;
  • evidencia necesaria para repetirlo.

Actividad (25 minutos). Construya el mapa en papel o en un formato abierto. Marque con un círculo los pasos manuales, con un candado la información restringida y con un signo de interrogación las dependencias que no pueda explicar.

Preguntas de comprobación

  • ¿Una persona distinta podría localizar la entrada correcta?
  • ¿El mapa separa el dato original del dato derivado?
  • ¿Se reconoce qué versión del código produjo el resultado?
  • ¿Existe algún dato o servicio que no deba publicarse?
  • ¿Cuál es el punto de falla con mayor impacto científico?

Error frecuente. Enumerar programas no equivale a representar un flujo. El mapa debe mostrar relaciones, transformaciones y evidencia.

1.4 Primera tarea

Revise el mapa fuera de la sesión y entréguelo acompañado por una nota breve que incluya:

  1. el propósito y los usuarios del producto;
  2. tres riesgos de reproducibilidad, seguridad o mantenimiento;
  3. una mejora pequeña que pueda verificarse;
  4. la evidencia con la que demostraría esa mejora;
  5. una pregunta que deba resolverse en la siguiente sesión.

Criterio de avance. El mapa permite reconocer entradas, transformaciones, salidas, responsables, restricciones y al menos tres riesgos, sin exponer datos institucionales.

No publique todavía un post sobre esta unidad. Primero complete la tarea, contraste el diagnóstico y evalúe la evidencia de aprendizaje.