Holarch

Per i corsi

Guida per i docenti: tenere un corso con Holarch

Come configurare un corso in Holarch e svolgervi tre moduli pronti: requisiti e verifica, architettura funzionale e fisica, e basi di SysML v2. Ogni modulo elenca i capitoli di formazione che gli studenti guardano, i tutorial nell’app che completano e l’esercitazione EO-1 che consegnano. Segue un’opzione per un progetto di gruppo.

In questa pagina
  1. Prima di iniziare
  2. Checklist di configurazione del corso
  3. Usare Class Review
  4. Modulo 1: requisiti e verifica (2 settimane)
    1. Settimana 1: esigenze, requisiti e tracciamento
    2. Settimana 2: revisione, baseline e verifica
  5. Modulo 2: architettura funzionale e fisica (3 settimane)
    1. Settimana 1: funzioni e copertura
    2. Settimana 2: allocazione e interfacce
    3. Settimana 3: analisi e modifica
  6. Modulo 3: basi di SysML v2 (2 settimane)
    1. Settimana 1: struttura
    2. Settimana 2: requisiti e vincoli
  7. Opzione progetto di gruppo
  8. Schede di esercizi
  9. Ottenere aiuto

Prima di iniziare

Holarch è gratuito per studenti e docenti (vedere Per i corsi). Gli studenti imparano lo strumento da tre fonti, così il tempo in aula può essere dedicato al metodo:

  • Capitoli di formazione su /training/: brevi video, un compito ciascuno.
  • Tutorial nell’app: passaggi guidati su un piccolo modello di stazione meteorologica, con un pannello che controlla il lavoro. Gli studenti li avviano da Help → Tutorials nella barra laterale. I progetti dei tutorial non contano tra i progetti attivi di uno studente.
  • Schede di esercizi con soluzioni, una per percorso di formazione (elencate più avanti), per esercitarsi fuori dall’aula.

Il lavoro valutato usa l’EO-1 Open MBSE Reference Model, un CubeSat fittizio con lacune, test falliti e una modifica di requisito aperta inserite di proposito. La visita guidata Teaching with Holarch mostra il lato del docente in cinque minuti.

Checklist di configurazione del corso

Da fare una o due settimane prima della prima lezione. Il percorso di formazione 8, Teaching with Holarch, mostra ogni passo sullo schermo, non appena sarà pubblicato nella pagina della formazione.

  1. Creare l’organizzazione del corso. Account Settings → Organizations → Create Organization, con il nome del corso. Si diventa così org admin dell’organizzazione. (Percorso 8.1, Setting Up a Class Organization.)
  2. Richiedere lo stato di corso. In Impostazioni organizzazione, aprire l’organizzazione e, in Classe, fare clic su Request Class Status…. Inserire il corso, l’istituto e la fine del semestre, allegare il programma del corso (PDF o Word) e inviare. Holarch esamina la richiesta e risponde via e-mail. Lo stato di corso dà ai progetti dell’organizzazione 6 collaboratori per il progetto di un membro e 50 per i propri, 2.000 elementi ciascuno e la scheda Revisione della classe; inoltre i suoi progetti non contano tra i progetti attivi dei proprietari. Vedere Gestire un corso. (Percorso 8.2, Class Status and the Syllabus.)
  3. Aggiungere i membri. In Membri, inserire l’indirizzo e-mail di ogni studente, scegliere Membro e fare clic su Add Member. Un indirizzo senza account riceve un invito.
  4. Rendere org admin gli assistenti. Aggiungere ogni assistente con Amministratore org., così vede Class Review e può gestire l’elenco dei partecipanti. Amministrare un’organizzazione non dà accesso ai contenuti dei progetti: i progetti si aprono tramite la loro condivisione.
  5. Far creare a ogni gruppo il proprio progetto. Il capogruppo crea il modello EO-1 (Manage Projects → Project Files ▾ → New Demo Project → CubeSat (Guided systems engineering)), sceglie l’organizzazione del corso in Share → Organization, invita il gruppo come editor e il docente e gli assistenti come Revisore. I Reviewer non contano nel limite di collaboratori; possono leggere, esportare, commentare e approvare o respingere requisiti e revisioni di documenti, ma non modificare.
  6. Pubblicare i propri modelli. Se un’esercitazione parte da un documento, crearlo una volta da un modello predefinito, aggiungere le istruzioni nelle sue sezioni e salvarlo con Write ▾ → Templates ▸ Save as Template… nell’organizzazione, come predefinito per il suo tipo. Gli studenti lo trovano quindi preselezionato in + Nuovo documento. Vedere Salvare un documento come modello. (Percorso 8.3, Assignments from Templates.)
  7. Aggiungere le scadenze. Organization Settings → Class Review → + New Assignment, con un nome e data e ora di scadenza. In quel momento Holarch conserva una versione di ogni progetto di gruppo e i conteggi di ogni membro, così il lavoro successivo si può confrontare con la scadenza. Vedere Impostare la scadenza di un’esercitazione.
  8. Decidere sull’IA. L’IA segue l’impostazione dell’organizzazione del corso. Per un esame, deselezionare Allow AI in this organization's projects e lasciare selezionato Also turn off API and MCP access, così anche gli strumenti di IA collegati tramite MCP sono disattivati. Dopo, riselezionare la casella dell’IA e riattivare separatamente Accesso API. Vedere Disattivare l’IA per un’organizzazione. (Percorso 8.5, Turning AI Off for an Exam.)
  9. Chiedere agli studenti di conservare copie. Gli studenti possono esportare un progetto in qualsiasi momento. Chiedere un’esportazione prima di ogni scadenza.

Usare Class Review

Class Review è il luogo in cui si legge il lavoro dei gruppi a una scadenza. Si apre da Organization Settings → Class Review, oppure premendo ⌘K / Ctrl+K e scegliendo Revisione della classe.

  • Leggere il lavoro. In Progetti di gruppo, fare clic su un progetto per vederlo senza farne parte. I nomi degli elementi aprono un’anteprima con il testo e i commenti dell’elemento.
  • Confrontare con una scadenza. Scegliere l’esercitazione in Confronta con: i conteggi mostrano il valore alla scadenza, e il lavoro modificato o aggiunto dopo è contrassegnato come Changed after due date o Added after due date. Holarch segnala il lavoro in ritardo; non blocca un progetto alla scadenza.
  • Commentare e approvare nel progetto. Come Reviewer del progetto di gruppo, aggiungere commenti sugli elementi e usare Approva e Rifiuta… sui requisiti in revisione. (Percorso 8.4, Reviewing and Commenting on Student Work.)
  • Esportare per il registro dei voti. In Riepilogo della classe, Esporta (Excel) produce un foglio per il corso, uno per gruppo e uno per studente. Voti e rubriche restano nel proprio registro.

Valutare il modello e il ragionamento che vi si legge. I conteggi per membro e Activity sono evidenze per il raro caso in cui sia in discussione il contributo di un membro al lavoro di gruppo; non sono una misura della qualità né un motivo per sorvegliare ogni studente. (Percorso 8.6, Evidence for Grading: Class Review and Activity.)

Modulo 1: requisiti e verifica (2 settimane)

Gli studenti imparano a scrivere e revisionare requisiti, a tracciarli alle esigenze e a leggere la copertura di verifica.

Settimana 1: esigenze, requisiti e tracciamento

Settimana 2: revisione, baseline e verifica

Modulo 2: architettura funzionale e fisica (3 settimane)

Gli studenti scompongono le funzioni, costruiscono un livello logico tra funzioni e parti, derivano le interfacce e seguono una modifica attraverso l’architettura.

Settimana 1: funzioni e copertura

Settimana 2: allocazione e interfacce

Settimana 3: analisi e modifica

  • Da guardare: Simulation, Budgets and TPMs.
  • Tutorial: Simulate the Functional Flow e Baseline, Change, Impact.
  • Da consegnare: A4. Se il modulo ha spazio per una quarta settimana, aggiungere A5 Gestire la modifica: le equazioni di potenza e TPM-2 dei capitoli di questa settimana ne sono gli input.
  • Class Review: aggiungere una scadenza per esercitazione. Per A4, confrontare con la scadenza e aprire i nuovi elementi logici e le loro allocazioni nel progetto di ogni gruppo; la descrizione dell’architettura consegnata deve corrispondere a quanto contiene il modello.

Modulo 3: basi di SysML v2 (2 settimane)

Gli studenti scrivono un piccolo modello nella notazione testuale SysML v2, lo vedono come viste e imparano cosa dimostrano i controlli dello strumento. Ogni gruppo crea un progetto SysML v2 per il proprio lavoro; i tutorial SysML v2 costruiscono parti di un’auto ibrida.

Settimana 1: struttura

Settimana 2: requisiti e vincoli

Opzione progetto di gruppo

Per un progetto semestrale, ogni gruppo modella un sistema a sua scelta, non EO-1, dalle esigenze alla verifica. Le funzionalità per i corsi sostengono la struttura del corso:

  • Un progetto per gruppo nell’organizzazione del corso. Il capogruppo crea il progetto (vuoto, oppure dall’esempio di partenza per i corsi in Per i corsi), sceglie l’organizzazione del corso in Share → Organization, invita il gruppo come editor e il personale docente come Reviewer.
  • Milestone come scadenze. Aggiungere un’esercitazione in Class Review per milestone, per esempio concetto ed esigenze, revisione dei requisiti, architettura e piano di verifica. Ogni scadenza conserva una versione di ogni progetto di gruppo su cui basare la valutazione.
  • Un giro di revisione come Reviewer. Prima della milestone dei requisiti, i gruppi impostano i propri requisiti su In Review; il docente e gli assistenti commentano, approvano o respingono, e i gruppi rielaborano e ripresentano, come in A2. La revisione tra pari funziona allo stesso modo: aggiungere a un progetto i membri di un altro gruppo come Reviewer.
  • Una finestra d’esame senza IA. Disattivare l’IA per l’organizzazione, insieme all’accesso API e MCP, durante l’esame e riattivarla dopo (passo 8 della checklist).
  • Una baseline finale come consegna. Ogni gruppo salva una baseline del progetto in Control & Reviews → Baselines & Versions → + Save Baseline…, con il nome della consegna, ed esporta i propri deliverable (per esempio la specifica e il piano di verifica in Word). Valutare la baseline, non il progetto corrente.
  • Evidenze sul contributo solo quando servono. Valutare il gruppo sul modello e sul suo ragionamento. Aprire i contributi di un membro in Class Review solo se il suo contributo è in discussione.

Adattare le rubriche delle esercitazioni EO-1 a ogni milestone: valutano il giudizio (completezza della catena, qualità di ogni decisione, verifica rispetto a validazione) più che il numero di elementi.

Schede di esercizi

Ogni scheda contiene brevi esercizi pratici per un percorso di formazione, con le soluzioni, per gli studenti che vogliono esercitarsi più di quanto offrano le esercitazioni. Sono pubbliche, quindi non sono lavoro valutato.

Ottenere aiuto

Per la configurazione del corso, una domanda sullo stato di corso o le note con le soluzioni per A1–A6, contattateci con l’argomento Instructor. Le pagine Gestire un corso e Contributi dei Docs contengono i dettagli di ogni passo descritto sopra.

Pubblicato da Holarch