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
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.
- 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.)
- 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.)
- 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.
- 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.
- 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.
- 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.)
- 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.
- 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.)
- 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
- Da guardare: Writing Requirements and the Quality Check, Tracing Needs to Requirements, Open Items and Approvals. I nuovi utenti guardano prima The Holarch Workspace.
- Tutorial: Write Good Requirements e Trace Requirements.
- Da consegnare: A1 Tracciare un’esigenza (individuale, una nota scritta).
- Class Review: A1 non modifica nulla nel modello, quindi non serve una scadenza in Class Review. Aggiungere ora la scadenza di A2, così i gruppi vedono il termine.
Settimana 2: revisione, baseline e verifica
- Da guardare: Baselines and Links to Review, Verification and the Test Center, RVTM and VCRM.
- Tutorial: Verify the Requirements.
- Da consegnare: A2 Rielaborazione e revisione dei requisiti (gruppi). Pianificare il giro di revisione a metà settimana: i gruppi impostano i loro tre requisiti su In Review, il docente commenta e approva o respinge come Reviewer, e i gruppi rispondono prima della scadenza.
- Class Review: confrontare ogni progetto di gruppo con la scadenza di A2, leggere i tre requisiti, i loro commenti di revisione e la specifica in baseline. Seguito facoltativo: A3 Trovare le lacune di copertura come terza settimana o come compito a casa.
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
- Da guardare: Functions and the FFBD, Action Diagrams.
- Tutorial: Functional Analysis.
- Da consegnare: A3 Trovare le lacune di copertura (gruppi). Mostra agli studenti dove l’architettura è carente prima che la estendano.
Settimana 2: allocazione e interfacce
- Da guardare: Allocation, Interfaces.
- Tutorial: Physical Architecture and Allocation e Interfaces.
- Inizio: A4 Estendere l’architettura (gruppi, scadenza alla fine della settimana 3).
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
- Da guardare: Definitions and Attributes, Ports and Interfaces, Actions and Flows.
- Tutorial: Getting Started, Definitions and Attributes e Ports and Interfaces.
- In aula: esaminare i limiti didattici di SysML v2: cosa controlla l’Editor, cosa conserva senza interpretarlo e perché «non ancora in Holarch» non significa «non consentito».
Settimana 2: requisiti e vincoli
- Da guardare: Requirements, Verification and Traceability, Constraints and Calculations.
- Tutorial: Requirements e Constraints and Calculations.
- Da consegnare: A6 parte B da sola: il sottosistema di potenza di EO-1 in SysML v2, la modifica a 30 W, un progetto che la soddisfa e la mezza pagina su cosa è stato controllato e cosa solo conservato.
- Class Review: aggiungere la scadenza. Leggere insieme il file e la mezza pagina: il voto si basa sulla spiegazione, perché 0 diagnostiche da sole dimostrano solo ciò che i controlli coprono.
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.
- Primi passi
- Requisiti e verifica
- Comportamento e architettura
- Documenti e deliverable
- Fondamenti di SysML v2
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.