Paquete para instructores · v1.0
Enseñar con Holarch: paquete para instructores
Resultados de aprendizaje del curso y seis tareas con rúbricas para un curso semestral de ingeniería de sistemas o MBSE, todo construido sobre el modelo de referencia MBSE abierto EO-1 v1.1, un CubeSat 6U ficticio de observación de la Tierra. Gratuito bajo CC BY 4.0.
Descargar el paquete para instructores v1.0
Todos los archivos (.zip, 17 KB)
Archivos Markdown que se abren en cualquier editor. Usa el modelo de referencia EO-1 v1.1. Licencia: CC BY 4.0, con el crédito «Holarch».
En esta página
- Qué contiene
- Cómo usarlo
- Notas de solución
- Resultados de aprendizaje
- A1 · Trazar una necesidad
- A2 · Revisión y reelaboración de requisitos
- A3 · Encontrar los huecos de cobertura
- A4 · Ampliar la arquitectura
- A5 · Trabajar el cambio
- A6 · Plan de validación
- Enseñar SysML v2 con Holarch: qué comprueba y qué solo conserva
- Descargas
- Versiones
- Cómo citarlo
- Licencia
Qué contiene
| Archivo | Para | Qué contiene |
|---|---|---|
learning-outcomes.md | Instructores, registros de acreditación | Los resultados de aprendizaje del curso, las tareas que evalúan cada uno y las funciones de Holarch que se usan. |
assignments/A1-trace-a-need.md a A6-validation-plan.md | Estudiantes (para repartir) | Seis tareas sobre EO-1, cada una con contexto, enunciado, lo que hay que entregar y una rúbrica. |
sysml-v2-teaching-boundaries.md | Instructores | Lo que comprueban los proyectos SysML v2 de Holarch, lo que conservan sin interpretar y lo que todavía no está disponible. |
Cómo usarlo
- Dé a cada grupo su propia copia de EO-1 v1.1. En Holarch: Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → CubeSat EO-1, o descargue
eo-1-v1.1.holarch.jsondesde holarch.app/reference-models/eo-1/ e impórtelo con Gestionar proyectos → Archivos de proyecto ▾ → Importar proyecto…. Todas las tareas parten del modelo tal como se distribuye. - Imparta el curso en una organización de clase. Añada cada tarea con su fecha de entrega en Ajustes de la organización → Revisión del curso → + Nueva tarea. Revisión del curso conserva una versión de cada proyecto de grupo en cada fecha de entrega y muestra el trabajo de cada estudiante.
- Para A2, únase a cada proyecto de grupo como Revisor: puede comentar, aprobar, rechazar y reabrir requisitos, y nada más.
- Para A6, los estudiantes parten de la plantilla integrada Plan de verificación y validación. Para darles una versión reducida con sus propias instrucciones, guarde una como plantilla de la organización (Escribir ▾ → Plantillas ▸ Guardar como plantilla…, Guardar en: Organización) y conviértala en la predeterminada para el documento de plan de pruebas.
- Fije las ponderaciones, el tamaño de los grupos y las fechas de entrega de su curso. Las ponderaciones indicadas son sugerencias.
Las tareas mencionan páginas de Holarch, pero todas las preguntas pueden responderse también a partir de los archivos CSV de EO-1, de modo que los estudiantes que trabajan con otra herramienta pueden participar.
Notas de solución
Las notas de solución con los hallazgos esperados, respuestas de ejemplo y errores habituales de A1 a A6 no se publican, para que los estudiantes no puedan descargar las respuestas. Los instructores las descargan en Holarch: Ajustes de la organización → Revisión del curso → Descargar notas de solución. El botón aparece para los administradores de la organización (instructores y ayudantes de enseñanza) de una organización con condición de clase.
Resultados de aprendizaje
Curso: Ingeniería de sistemas basada en modelos, un semestre, últimos cursos de grado o primer año de posgrado.
Al final del curso, los estudiantes son capaces de:
| # | Resultado | Evaluado en | Funciones de Holarch utilizadas |
|---|---|---|---|
| LO1 | Distinguir las necesidades de las partes interesadas de los requisitos del sistema, y trazar cada necesidad hasta los requisitos que la formalizan. | A1, examen parcial | Statements, relaciones traced to, la sección Trazabilidad de la Vista del elemento, Matriz de trazabilidad |
| LO2 | Escribir requisitos necesarios, singulares, inequívocos y verificables, con un método de verificación y criterios de éxito. | A2, examen parcial | Atributos de requisito, Calidad, TBD/TBR |
| LO3 | Llevar a cabo un ciclo de revisión y aprobación de requisitos, y responder a los comentarios de revisión con cambios en el modelo. | A2, participación en la revisión | Rol de revisor, Aprobaciones (Aprobar, Rechazar…, Reabrir), comentarios con menciones |
| LO4 | Analizar la trazabilidad y la cobertura de verificación, y decidir para cada hueco si lo que está mal es el modelo o el requisito. | A3 | Matriz de trazabilidad, RVTM, comprobaciones del modelo |
| LO5 | Descomponer funciones, definir una arquitectura lógica, asignar funciones a elementos lógicos y físicos, y derivar las interfaces que resultan. | A4, examen final | Diagramas de Action y FFBD, Assets, asignación, Registro de interfaces |
| LO6 | Evaluar el impacto de un cambio de requisito a través del modelo, y registrar una decisión para cada elemento afectado. | A5, examen final | Vínculos por revisar, análisis de impacto, Solicitudes de cambio, Líneas base y versiones |
| LO7 | Planificar la verificación y la validación: distinguirlas, elegir métodos, redactar procedimientos de prueba y de validación en los términos adecuados, e interpretar una RVTM. | A6, examen final | Casos y conjuntos de prueba, Centro de pruebas, RVTM y VCRM, plantillas de documentos |
| LO8 | Generar entregables de ingeniería a partir del modelo y mantenerlos coherentes con él: documentos y matrices con línea base exportados para revisión. | A2, A6, examen final | Documentos, matrices en vivo, líneas base, exportación a Word y Excel |
| LO9 (opcional) | Leer y escribir la notación textual de SysML v2 para un subsistema, e indicar qué propiedades comprobó una herramienta y cuáles solo conservó. | Parte opcional de A6 | Proyecto SysML v2, las comprobaciones del editor, la nota didáctica sobre SysML v2 |
Correspondencia con las tareas
| Resultado | A1 Trazar una necesidad | A2 Reelaboración de requisitos | A3 Huecos de cobertura | A4 Arquitectura | A5 Impacto de un cambio | A6 Plan de validación |
|---|---|---|---|---|---|---|
| LO1 | ● | ○ | ○ | |||
| LO2 | ● | ○ | ||||
| LO3 | ● | |||||
| LO4 | ○ | ● | ○ | |||
| LO5 | ● | |||||
| LO6 | ● | |||||
| LO7 | ○ | ○ | ○ | ● | ||
| LO8 | ○ | ● |
● resultado principal evaluado, ○ también contribuye.
Notas para el instructor
- Los resultados describen la capacidad en ingeniería de sistemas, no la destreza con la herramienta. Holarch es donde los estudiantes practican; los archivos CSV de EO-1 permiten a un estudiante demostrar todos los resultados sin él.
- Los resultados siguen la práctica habitual de la ingeniería de sistemas, por ejemplo los procesos técnicos de ISO/IEC/IEEE 15288: definición de las necesidades y los requisitos de las partes interesadas, definición de los requisitos del sistema, definición de la arquitectura, verificación y validación. Haga la correspondencia con los criterios de acreditación de su programa según lo exija su centro.
A1 · Trazar una necesidad
Resultados: LO1 (principal), LO4, LO7 · Tamaño del grupo: individual · Ponderación sugerida: 8 %
Contexto
El cliente de EO-1, una empresa de analítica agrícola, expresó tres necesidades. N2 Twice-Weekly Revisit dice: «Farm customers need fresh imagery of their fields at least twice a week in the growing season.» Una necesidad solo se cumple cuando los requisitos que la formalizan están satisfechos por el diseño y verificados, y la propia necesidad está validada con el cliente.
Enunciado
- Siga N2 a través del modelo: los requisitos a los que se traza, sus hijos, las funciones y los componentes que satisfacen cada uno y los casos de prueba que los verifican, con el estado de cada prueba.
- Dibuje la cadena como una tabla o un pequeño diagrama: una fila o un recuadro por elemento, con su número, nombre, estado y la relación que lo conecta.
- Encuentre la actividad de validación de N2 y su estado.
- Responda: ¿Qué evidencia falta todavía para que N2 cuente como validada? Enumere cada elemento que falta, el elemento del modelo al que pertenece y lo que lo cerraría.
- Busque requisitos que respalden N2 pero no se tracen a ella. Nombre un candidato y argumente a favor o en contra de añadir la trazabilidad. No la añada al modelo.
En Holarch: abra N2 en la Vista del elemento y lea su sección Trazabilidad; después use Verificación → Matriz de trazabilidad, Verificación → RVTM y Verificación → Centro de pruebas. Sin Holarch: eo-1-v1.1-traceability.csv y eo-1-v1.1-rvtm.csv.
Entrega
Una nota de una a dos páginas (Word o PDF) con la cadena, las evidencias que faltan y su respuesta al paso 5. No cambie el modelo en esta tarea.
Rúbrica
| Criterio | 4 Ejemplar | 3 Competente | 2 En desarrollo | 1 Inicial |
|---|---|---|---|---|
| Cadena completa y correcta (40 %) | Cada elemento desde N2 hasta las pruebas, con las relaciones y los estados correctos, incluidos ambos hijos y la actividad de validación. | Falta un elemento o un estado, o es incorrecto. | La cadena se detiene en los requisitos o se salta un hijo. | Elementos enumerados sin relaciones. |
| Evidencias que faltan (35 %) | Nombra cada carencia (pruebas sin ejecutar, un padre sin verificación propia, requisitos todavía no aprobados, la validación sin ejecutar, el hijo sin función) y lo que cierra cada una. | La mayoría de los huecos, con lo que los cierra. | Enumera huecos sin decir qué los cierra. | Solo dice «faltan pruebas». |
| Verificación frente a validación (15 %) | Las mantiene separadas en todo momento: los requisitos se verifican, la necesidad se valida. | Un desliz. | Trata una prueba aprobada como validación de la necesidad. | Ninguna distinción. |
| Traza candidata (10 %) | Un requisito concreto con un argumento razonado en un sentido u otro. | Un candidato con un argumento débil. | Un candidato sin argumento. | Falta. |
A2 · Revisión y reelaboración de requisitos
Resultados: LO2 (principal), LO3, LO8 · Tamaño del grupo: grupo · Ponderación sugerida: 10 %
Contexto
Tres requisitos de EO-1 siguen siendo borradores y obtienen un 44 % en la comprobación de calidad de Holarch:
- 2.5 Safe Mode Recovery: "The spacecraft should recover from safe mode quickly and resume imaging as appropriate"
- 3.5 Battery Thermal Control: "The thermal design shall keep the battery warm enough (TBD)."
- 6.4 Operator Interface: "The operator interface shall be user friendly and/or easy to use."
3.5 también tiene una incidencia abierta, ISS-3 Battery heater set point not chosen, y un comentario de revisión del comité de revisión de diseño, RID-1 No cold-case analysis for the battery heater.
Enunciado
- Para cada uno de los tres, enumere lo que lo hace débil, palabra por palabra cuando importe.
- Reescriba cada uno en el proyecto del grupo: un «shall», una condición medible y un punto de partida o una condición explícitos cuando intervengan tiempos o rangos. Sustituya cada TBD por un valor y registre su justificación, o mantenga un TBR con un responsable y una fecha. Para 3.5, explique cómo responde su reescritura a ISS-3 y RID-1.
- Rellene Método de verificación, Nivel de verificación y Criterios de éxito para cada uno.
- Trace cada uno hasta su procedencia (una necesidad, un requisito padre o un origen) y hasta la función que lo satisface. Si no existe ninguna función, nombre la función que falta.
- Ponga cada uno en En revisión. Su instructor los revisa como Revisor. Responda a cada comentario en el modelo (cambie el requisito o responda con un motivo) y después resuelva el comentario.
- Guarde una línea base del documento EO-1 System Requirements Specification (SRS-001) con el nombre «A2 entregada» y expórtela a Word.
En Holarch: Necesidades y requisitos → Calidad, el inspector del requisito, Necesidades y requisitos → Aprobaciones y, en el documento, Versión ▾ → Guardar línea base… y Entregar ▾ → Especificación (Word).
Entrega
La exportación a Word, más una nota de media página sobre las debilidades que encontró en el paso 1. Se califica junto con el modelo tal como esté en la fecha de entrega.
Rúbrica
| Criterio | 4 Ejemplar | 3 Competente | 2 En desarrollo | 1 Inicial |
|---|---|---|---|---|
| Requisitos reescritos (40 %) | Los tres singulares, medibles y verificables; condiciones y puntos de partida explícitos; valores justificados. | Un requisito todavía tiene un término impreciso o le falta una condición. | Se añadieron valores, pero faltan condiciones o justificación. | La redacción cambió, pero sigue sin ser verificable. |
| Atributos de verificación (20 %) | El método, el nivel y los criterios de éxito se ajustan a cada requisito y podrían ejecutarse tal como están redactados. | Una discordancia, por ejemplo Test donde solo es posible Analysis. | Métodos definidos, criterios de éxito imprecisos. | Falta. |
| Trazabilidad (15 %) | Cada uno trazado hasta su fuente y su función satisfactoria, o nombrada la función que falta. | Falta una traza. | Solo fuentes. | Ninguna. |
| Ciclo de revisión (15 %) | Cada comentario de revisión respondido en el modelo y resuelto; los requisitos rechazados, rehechos y reenviados. | Queda un comentario abierto. | Comentarios respondidos sin cambios en el modelo. | Comentarios ignorados. |
| Análisis de debilidades (10 %) | Preciso: nombra cada término impreciso y por qué no se puede verificar. | General pero correcto. | Repite la puntuación de calidad. | Falta. |
A3 · Encontrar los huecos de cobertura
Resultados: LO4 (principal), LO1, LO2, LO7 · Tamaño del grupo: grupo · Ponderación sugerida: 10 %
Contexto
EO-1 está en su revisión crítica de diseño. El modelo es imperfecto a propósito: algunos requisitos no tienen ninguna función que los satisfaga, algunos no tienen prueba, algunas pruebas fallaron y una ecuación no está vinculada a nada.
Enunciado
Trabaje a partir del modelo tal como se distribuye en v1.1. Use una copia nueva si el proyecto de su grupo ha cambiado.
- Enumere todos los requisitos que no satisface ninguna función.
- Enumere todos los requisitos que no verifica ningún caso de prueba, y aquellos cuyas pruebas fallaron, con la incidencia abierta y cualquier desviación registrada respecto a ellos.
- Enumere los requisitos sin ningún componente que los satisfaga. Decida cuáles necesitan uno y cuáles se satisfacen correctamente a nivel de misión o de segmento.
- Encuentre los elementos del modelo a los que no se traza nada. Pista: mire las ecuaciones de potencia.
- Para cada carencia, decida: ¿le falta algo al modelo (una función, un componente, una prueba, un vínculo) o el requisito no es necesario o está mal redactado? Dé una frase de razonamiento por carencia.
- Cierre tres carencias a su elección en el proyecto del grupo, cada una como un cambio que pueda señalar en Control y revisiones → Actividad.
En Holarch: Verificación → Matriz de trazabilidad, Verificación → RVTM, Verificación → Comprobaciones del modelo y Riesgos, incidencias y decisiones → Incidencias y acciones. Sin Holarch: eo-1-v1.1-traceability.csv (su columna Coverage), eo-1-v1.1-rvtm.csv, eo-1-v1.1-issues-actions.csv y eo-1-v1.1-deviations-waivers.csv.
Entrega
Una tabla de huecos (hueco, elemento, decisión, razonamiento, cerrado sí o no) en Excel o Word, y una lista de los tres cambios que hizo.
Rúbrica
| Criterio | 4 Ejemplar | 3 Competente | 2 En desarrollo | 1 Inicial |
|---|---|---|---|---|
| Huecos encontrados (35 %) | Todas las carencias de funciones, pruebas, componentes y elementos huérfanos, incluidas las pruebas fallidas con sus incidencias y la desviación. | Se pasan por alto uno o dos huecos. | Solo se encuentran los borradores evidentes. | Menos de la mitad. |
| Decisiones (35 %) | Cada carencia recibe una decisión defendible; distingue el diseño que falta de los requisitos innecesarios o con un alcance incorrecto y de la satisfacción a nivel de misión. | La mayoría de las decisiones son sólidas. | Cada hueco se trata como «añadir un vínculo». | Ninguna decisión. |
| Cambios realizados (20 %) | Tres cambios que cierran realmente huecos, cada uno un paso limpio en el registro. | Dos cambios buenos. | Cambios que ocultan un hueco, como un vínculo añadido sin motivo. | Ninguna. |
| Presentación (10 %) | La tabla se puede ordenar y está completa. | Omisiones menores. | Difícil de seguir. | Falta. |
A4 · Ampliar la arquitectura
Resultados: LO5 (principal), LO4 · Tamaño del grupo: grupo · Ponderación sugerida: 12 %
Contexto
La arquitectura lógica de EO-1 (L0) solo abarca los segmentos de potencia y de tratamiento de datos: de L1 Power Generation a L6 Fault Management. Cada elemento lógico agrupa funciones (allocated to) y lo realiza una parte física (related to); por ejemplo, F3.1 Convert Sunlight to Power está asignada a L1, y 1.3.1 Solar Arrays realiza L1. La determinación y el control de actitud tienen las funciones F4.1 Estimate Attitude, F4.2 Compute Control Torques, F4.3 Drive Reaction Wheels y F4.4 Unload Wheel Momentum, y partes físicas bajo 1.2 ADCS, pero ninguna capa lógica.
Enunciado
- Añada elementos lógicos para la determinación y el control de actitud bajo L0. Cada elemento indica su propósito sin nombrar hardware.
- Asígneles F4.1 a F4.4 y relacione cada elemento lógico con las partes físicas bajo 1.2 ADCS que lo realizan, siguiendo el patrón de L1 a L6.
- Dibuje el diagrama de acción de F4 con los elementos que fluyen entre sus subfunciones, por ejemplo la estimación de actitud y las órdenes de par, si su proyecto de grupo aún no lo tiene.
- A partir de los flujos que cruzan los límites de los elementos, derive las interfaces. Compárelas con las interfaces existentes IF-06, IF-16, IF-17 e IF-18: ¿cuáles coinciden, cuáles faltan y cuáles transportan elementos que ninguna función usa?
- Compruebe que 2.1 a 2.4 están satisfechos cada uno por la función que hace el trabajo, e indique qué elemento lógico es entonces responsable de cada requisito.
En Holarch: Arquitectura → Assets, Comportamiento → Diagramas de Action (F4), la sección Trazabilidad del inspector para las asignaciones, Interfaces → Registro de interfaces y el preajuste Jerarquía de asignación del diagrama de jerarquía. Sin Holarch: eo-1-v1.1-allocation-chain.csv y eo-1-v1.1-icd.csv.
Entrega
Una breve descripción de la arquitectura (de dos a tres páginas, en Word o PDF): los elementos lógicos con sus propósitos, la tabla de asignación (función → elemento lógico → parte física), el diagrama de Action de F4 y la comparación de interfaces.
Rúbrica
| Criterio | 4 Ejemplar | 3 Competente | 2 En desarrollo | 1 Inicial |
|---|---|---|---|---|
| Elementos lógicos (25 %) | Independientes de la solución, cohesivos, cada uno con un propósito claro; sin nombres de hardware. | Un elemento nombra hardware o mezcla propósitos. | Los elementos copian las partes físicas. | Faltan o no están claros. |
| Asignación (30 %) | Cada subfunción asignada una vez al elemento correcto; elementos realizados por partes; coherente en el modelo. | Una asignación discutible. | Asignaciones solo a partes, saltándose la capa lógica. | Incompleta. |
| Flujos e interfaces (30 %) | Interfaces derivadas de los flujos que cruzan los límites; comparación precisa con IF-06, IF-16, IF-17 e IF-18, incluidas las carencias en ambos sentidos. | Comparación mayormente correcta. | Interfaces enumeradas, no derivadas. | Falta. |
| Responsabilidad de los requisitos (15 %) | Cada uno de 2.1 a 2.4 trazado a través de su función hasta un elemento lógico, con las incoherencias nombradas. | Falta uno. | Enumerados sin comprobar. | Falta. |
A5 · Trabajar el cambio
Resultados: LO6 (principal), LO7 · Tamaño del grupo: grupo · Ponderación sugerida: 10 %
Contexto
Tras la revisión de diseño, el requisito 3.1 Orbit Average Power pasó de 28 W a 30 W de potencia media orbital al final de la vida útil. El caso de prueba TC-06 Solar Array Power Test se aprobó con el valor anterior. Holarch marcó los vínculos de 3.1 para revisión.
Enunciado
- Enumere cada elemento al que llega el cambio: hacia delante a través de los vínculos desde 3.1, hacia atrás hasta aquello de lo que deriva 3.1, y los elementos que mencionan el valor anterior sin un vínculo a 3.1. Indique cómo encontró cada uno.
- Para cada elemento, escriba la pregunta que plantea el cambio, su hallazgo (con cifras cuando el modelo las tenga) y una decisión: ningún cambio (marcar el vínculo como revisado con un comentario), actualizar o elevar al comité de cambios.
- Decida qué hacer con TC-06: ¿una prueba aprobada con 28 W sigue demostrando 30 W? Muestre los cálculos a partir de las ecuaciones del modelo.
- Encuentre un elemento que el análisis basado en vínculos no detecta y explique por qué importa.
- Registre sus decisiones en el proyecto del grupo: un comentario en cada vínculo que marque como revisado, una solicitud de cambio para lo que debe decidir el comité, y una línea base antes y otra después.
En Holarch: Necesidades y requisitos → Vínculos por revisar, el análisis de impacto desde 3.1 (Abrir en ▾ → Spider y después Impacto), la sección Trazabilidad del inspector, las ecuaciones de potencia EQ-1.1 a EQ-1.4 y TPM-2 (Arquitectura → Presupuestos y TPM), Control y revisiones → Solicitudes de cambio y Control y revisiones → Líneas base y versiones. Sin Holarch: eo-1-v1.1-traceability.csv y eo-1-v1.1-change-impact-3.1.csv, el registro de impacto publicado; haga primero su propio análisis y después compare.
Entrega
Un registro de impacto (una tabla: elemento, cómo se llegó a él, pregunta, hallazgo, decisión, estado) y una recomendación de un párrafo al comité de cambios.
Rúbrica
| Criterio | 4 Ejemplar | 3 Competente | 2 En desarrollo | 1 Inicial |
|---|---|---|---|---|
| Alcance (30 %) | Encontrados los elementos hacia delante, hacia atrás y por búsqueda de texto, incluidos los que ningún vínculo alcanza. | Solo vínculos, todos ellos. | Algunos vínculos hacia delante. | Solo 3.1 y TC-06. |
| Hallazgos con cifras (30 %) | Usa los valores y las ecuaciones del modelo; el déficit de TC-06 se calcula y se explica. | Cifras mayormente correctas. | Solo cualitativo. | Conclusiones erróneas. |
| Decisiones (25 %) | Cada elemento tiene una decisión adecuada al hallazgo; vínculos marcados como revisados solo con un motivo; puntos del comité separados. | Una decisión débil. | Marca vínculos como revisados sin motivos. | Ninguna decisión. |
| Registro en el modelo (15 %) | Comentarios, solicitud de cambio y líneas base en su sitio y coherentes con el registro. | Falta uno. | Solo el documento. | Nada en el modelo. |
A6 · Plan de validación
Resultados: LO7 (principal), LO8, LO1 · Tamaño del grupo: grupo · Ponderación sugerida: 10 %
Contexto
La verificación pregunta si EO-1 se construyó correctamente frente a sus requisitos; la validación pregunta si es el sistema adecuado para los clientes agrícolas. El conjunto de validación de EO-1, TS-3 Mission Validation, contiene VAL-01 Customer Alert Pilot (para N1, no ejecutada), VAL-02 Growing Season Revisit Simulation (para N2, no ejecutada) y VAL-03 Agronomist Map Review (para N3, aprobada).
Empiece el plan en Necesidades y requisitos → Documentos → + Nuevo documento. En Plantilla, ponga Plantillas para en documento de plan de pruebas y elija la plantilla integrada Plan de verificación y validación con Incluir pautas de redacción, o la plantilla de la organización que su instructor haya publicado para esta tarea.
Enunciado
- 5.1 Operational Scenarios: escriba el escenario de VAL-01 en los términos del cliente: quién hace qué, qué día y con qué resultado. Nombre la necesidad que pone a prueba.
- 5.2 Usuarios y participantes: nombre a los usuarios representativos y lo que decide cada uno.
- 5.3 Validation Environment: describa el entorno, en qué se diferencia de las operaciones y qué significa esa diferencia para el resultado.
- Redacte los criterios de aceptación de VAL-01 de modo que un cliente pueda decir sí o no sin criterio de ingeniería, y regístrelos en el Resultado esperado del caso de prueba.
- 8 Estado de la verificación: lea la matriz en vivo. Elija la prueba fallida TC-04 Pointing Accuracy Test y explique qué significaría el resultado de VAL-01 si TC-04 sigue fallida en el momento del piloto.
- Exporte el plan a Word.
Opcional: bonificación de SysML v2 (LO9, hasta un 10 % adicional)
Cree un proyecto SysML v2 a partir de eo-1-v1.1-power-subsystem.sysml (Gestionar proyectos → Archivos de proyecto ▾ → Importar archivos SysML v2…). El archivo todavía tiene el requisito 3.1 en 28 W. Cambie la potencia media orbital requerida a 30 W, el cambio de A5, y lea lo que informa el editor. ¿Es un error de modelado o un hallazgo de diseño? Después cambie los valores de diseño, no el requisito, hasta que la línea de estado del editor diga Sin problemas, e indique si sus nuevos valores son físicamente creíbles. En media página, indique cuáles de sus afirmaciones comprobó la herramienta y cuáles solo conservó; la nota didáctica sobre SysML v2 que comparte su instructor enumera ambas.
Entrega
- La exportación a Word del plan.
- Para la bonificación de SysML v2: el archivo
.sysmly la media página.
Rúbrica
| Criterio | 4 Ejemplar | 3 Competente | 2 En desarrollo | 1 Inicial |
|---|---|---|---|---|
| Escenario en términos del cliente (30 %) | Concreto, del día a día, sin jerga de ingeniería; ejercita claramente N1. | Claro, con algo de jerga. | Un procedimiento de prueba, no un escenario. | Falta o es genérico. |
| Criterios de aceptación (25 %) | Observables, de sí o no, cuyo responsable es el cliente; ligados a «on the day of an overpass» de N1. | Mayormente observables. | Solo umbrales de ingeniería. | Imprecisos. |
| Participantes y entorno (20 %) | Usuarios representativos nombrados con sus decisiones; diferencias con las operaciones y su efecto indicados. | Falta uno. | Enumerado sin efecto. | Falta. |
| Razonamiento de V&V (15 %) | Explica por qué un piloto de validación puede tener éxito o fracasar con independencia de TC-04 y qué significa cada resultado. | Mayormente sólido. | Confunde verificación y validación. | Falta. |
| Entregable (10 %) | Exportación a Word limpia, con las pautas de la plantilla sustituidas por contenido. | Quedan textos de pautas. | Exportado en parte. | Falta. |
| Bonificación de SysML v2 (hasta +10 %) | Hallazgo explicado; Sin problemas, con valores creíbles; indicación precisa de lo que se comprobó y lo que se conservó. | Sin problemas; indicación genérica. | Se debilitó el requisito en lugar de cambiar el diseño, o quedan problemas. | Sin puntuación. |
Enseñar SysML v2 con Holarch: qué comprueba y qué solo conserva
Los proyectos SysML v2 de Holarch admiten un subconjunto de la especificación SysML v2 del OMG. El estado actual de cada área figura en la página de cobertura del lenguaje SysML v2 (holarch.app/sysml-v2-coverage/); consúltela antes de cada periodo lectivo. Cuando enseñe el lenguaje con Holarch, distinga tres tipos de afirmaciones, para que los estudiantes no aprendan una limitación de la herramienta como una regla del lenguaje, ni tomen una construcción que la herramienta conservó por una que comprobó:
- Comprobado: el editor analiza la construcción y la comprueba mientras se escribe, y las vistas y páginas la usan. Cuando la línea de estado del editor dice Sin problemas, estas comprobaciones se superaron.
- Conservado, no interpretado: se analiza y se conserva exactamente como está escrito, en el texto y en las exportaciones, pero sin darle ningún significado. Sin problemas no dice nada sobre si es correcto.
- Todavía no en Holarch: la construcción o la función no está disponible en Holarch. Sigue siendo SysML v2 válido.
Comprobado: se puede enseñar y evaluar con la herramienta
| Área | Lo que los estudiantes pueden confiar en que detecte el editor |
|---|---|
| Sintaxis | Caracteres, comentarios, cadenas, llaves, ;, nombres y tokens esperados. |
| Nombres e importaciones | Nombres sin resolver, ambiguos, duplicados y privados; importaciones de miembros, de espacios de nombres, recursivas y filtradas. |
| Definiciones, usos, especialización | part, attribute, port, action, state, requirement y los demás tipos y sus definiciones; tipado, subconjuntos, redefinición y conjugación; ciclos y el tipo de definición incorrecto. |
| Multiplicidades, valores y unidades | Límites válidos; cantidades con los tipos de magnitud de ISQ y unidades del SI y del sistema usual de EE. UU.; comprobaciones dimensionales: una potencia donde se espera una masa es un error. |
| Restricciones y cálculos | Tipos de los operandos, argumentos de cálculo, condiciones booleanas y evaluación: se notifican las restricciones, los requisitos y los objetivos que no se cumplen con los valores actuales. |
| Estructura | Extremos de conexión; sentidos de puertos, flujos y mensajes; interfaces y conectores de enlace. |
| Acciones y estados | Destinos de sucesión, nodos de control, los valores sobre los que itera un bucle for, transiciones iniciales, regiones paralelas, disparadores de transición y efectos do. |
| Requisitos y casos de uso | Destinos subject, actor, stakeholder, require y assume constraint, satisfy, verify y frame en los lugares correctos. |
| Asignación | allocate … to …, definiciones de asignación, dependencias. |
| Variabilidad | Una variación solo contiene variantes de su tipo, una elección es una variante de su punto, y los valores de la elección se evalúan. |
| Individuos, instantáneas y segmentos temporales | Cada uno tiene las características de la ocurrencia a la que pertenece; sus propios valores se leen primero. |
Parcialmente comprobado: enseñar indicando el límite
| Área | Comprobado o ejecutado | Límite que hay que explicar a los estudiantes |
|---|---|---|
| Acciones | El simulador ejecuta flujos de acciones, incluidas ejecuciones de Monte Carlo. | Las duraciones de los pasos, las probabilidades de las ramas y el número de iteraciones de los bucles son ajustes del simulador que se guardan en Holarch, no en el texto, de modo que una exportación .sysml no los incluye. |
| Estados | El simulador ejecuta máquinas de estados con estímulos y muestra los estados activos. | Lo mismo: los ajustes del simulador no forman parte del texto. |
| Casos de análisis y de verificación | Sujeto, objetivo, resultado de retorno; verify y un veredicto. | Un caso de análisis solo se evalúa cuando cada entrada tiene un valor; no hay solucionador. En una Vista paramétrica, Resolver encuentra una incógnita por restricción. Los análisis de estudios de alternativas de la biblioteca estándar no se evalúan. |
| Vistas | view, view def, expose, filtros, puntos de vista y las definiciones de vista estándar; las Vistas de secuencia dibujan fragmentos alt, opt, loop y par. | La disposición pertenece a Holarch, no al modelo. |
| Variabilidad | Las variaciones, variantes y configuraciones se comprueban y se evalúan. | Holarch todavía no busca ni enumera todas las combinaciones válidas. |
| Metadatos y palabras clave | @Name, #Name, metadata … about, palabras clave definidas por el usuario a partir de metadatos semánticos. | Los demás metadatos definidos por el usuario no tienen ningún significado más allá de sus valores; los metadatos escritos con about no añaden ningún tipo base. |
| Representaciones textuales | Los cuerpos rep … language en SysML y KerML se comprueban, y se evalúa el cuerpo de una restricción en SysML. | Los cuerpos en otros lenguajes, como Python, OCL o MATLAB, se conservan como texto y nunca se ejecutan. |
| Intercambio JSON de SysML v2 | Importación y exportación del formato de elementos de la Systems Modeling API, conservando los identificadores de elemento. | Los tipos de elemento que Holarch no interpreta se conservan tal como se importaron y se vuelven a escribir sin cambios; no tienen texto y no se pueden editar. |
Conservado, no interpretado: Sin problemas no demuestra nada aquí
- Cuerpos de representaciones textuales en lenguajes distintos de SysML y KerML.
- Los valores de los metadatos definidos por el usuario distintos de los metadatos semánticos.
- Texto
docy comentarios: nunca se comparan con el modelo. En el subsistema de potencia de EO-1, cambiar el requisito 3.1 a 30 W deja sudocdiciendo 28 W, sin que se notifique ningún problema. Un buen ejercicio. - Los tipos de elemento que Holarch no interpreta en un archivo SysML v2 JSON importado.
Lo inverso también importa: el estado de los requisitos, los resultados de verificación y las etiquetas son datos de Holarch. No están en el texto ni en una exportación .sysml.
Todavía no en Holarch
- Archivos
.kerml: no se importan, y los modelos escritos en KerML no se comprueban. KerML solo se lee para la biblioteca estándar. - Extensiones del lenguaje distintas de las palabras clave definidas por el usuario; la biblioteca estándar no se puede editar.
- Un solucionador para los casos de análisis y una búsqueda de combinaciones de variantes válidas en las páginas de Holarch.
- Confirmaciones de la Systems Modeling API en
main, etiquetas y fusiones: otras herramientas confirman en ramas de solicitudes de cambio, y un aprobador las aplica en Holarch.
Cómo usar esto en un curso
- Diga «la herramienta lo comprobó» solo para las áreas comprobadas. Por ejemplo, Sin problemas significa que las unidades son coherentes y que los requisitos se cumplen con los valores actuales. No significa que el texto
doccoincida con los valores ni que un cuerpo en Python sea correcto. - Evalúe las construcciones conservadas leyéndolas. Califíquelas por inspección, no por el número de problemas.
- El comportamiento se ejecuta en el simulador, tanto los flujos de acciones como las máquinas de estados. Las duraciones y probabilidades que usa el simulador son ajustes de Holarch: si los estudiantes solo entregan el archivo
.sysml, pídales también los ajustes. - Las reglas del lenguaje proceden de la especificación, no de ninguna herramienta. Cuando Holarch no haya implementado algo, diga «todavía no en Holarch», no «no está permitido».
- La bonificación de A6 se basa en esta nota: los estudiantes cambian 3.1 a 30 W en el subsistema de potencia de EO-1, ven que la comprobación de evaluación lo notifica, corrigen el diseño y anotan lo que se comprobó y lo que solo se conservó.
Descargas
El paquete es un único archivo zip. Lleva la versión en su nombre, de modo que un curso puede remitir exactamente a la copia que usó. Los archivos CSV y de proyecto de las tareas son las descargas del modelo de referencia EO-1 v1.1 en la página de EO-1.
| Archivo | Qué contiene |
|---|---|
| teaching-with-holarch-v1.0.zip | Todos los archivos siguientes en una carpeta. |
README.txt | El contenido, cómo usar el paquete, el aviso de licencia y el historial de cambios. |
LICENSE.txt | El aviso de licencia. |
learning-outcomes.md | Los resultados de aprendizaje del curso y su correspondencia con las tareas. |
assignments/A1-trace-a-need.md | A1 Trazar una necesidad. |
assignments/A2-requirements-rework.md | A2 Rehacer y revisar requisitos. |
assignments/A3-coverage-gaps.md | A3 Encontrar las carencias de cobertura. |
assignments/A4-extend-the-architecture.md | A4 Ampliar la arquitectura. |
assignments/A5-work-the-change.md | A5 Gestionar el cambio. |
assignments/A6-validation-plan.md | A6 Plan de validación. |
sysml-v2-teaching-boundaries.md | Enseñar SysML v2 con Holarch: qué comprueba y qué solo conserva. |
Las notas de solución no están en el zip; consulte Notas de solución.
Versiones
Esta es la versión 1.0 del paquete para instructores Enseñar con Holarch, escrita para el modelo de referencia EO-1 v1.1. Una versión nueva tiene nombres de archivo nuevos; las versiones anteriores siguen disponibles en sus direcciones.
- v1.0: primera publicación: los resultados de aprendizaje del curso y las tareas A1 a A6 con rúbricas, para el modelo de referencia EO-1 v1.1.
Cómo citarlo
Cite la versión que usó:
Holarch. Teaching with Holarch: instructor package, version 1.0. https://holarch.app/academic/instructor-package/. Licensed under CC BY 4.0.
Licencia
Los archivos del paquete para instructores se distribuyen bajo la licencia Creative Commons Atribución 4.0 Internacional (CC BY 4.0). Puede copiarlos, compartirlos y adaptarlos para cualquier fin, incluso comercial, si da el crédito adecuado, enlaza a la licencia e indica si ha hecho cambios. Crédito: «Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0». Cada descarga lleva este aviso.
El modelo de referencia EO-1 conserva su propia línea de crédito: «EO-1 Reference Model v1.1, Holarch, CC BY 4.0». Todos los nombres, personas y resultados de EO-1 son inventados.
La licencia cubre solo los archivos del paquete. Las notas de solución no forman parte del paquete, y el software Holarch no está cubierto por ella.