Skip to content

Educator Use Cases

This diagram maps instructors and curriculum designers to the FCC subsystems they exercise when delivering courses, workshops, and assessments. Educators enter through docs/for-educators/ and rely on the CollaborationEngine for human-in-the-loop exercises, the ScoringEngine for graded deliverables, and the full persona and plugin catalogue to illustrate 11 extension points. The KnowledgeGraph and compliance audit pipeline appear in advanced modules where students explore governance trade-offs.

The diagram below traces the educator audience-to-subsystem mapping.

graph LR
    A((Educator))
    UC1[/"12-week curriculum"/]
    UC2[/"2-day workshop"/]
    UC3[/"Assessment strategies"/]
    UC4[/"Student workbook"/]
    UC5[/"Jupyter lecture companions"/]
    UC6[/"Grade with rubrics"/]
    S1[CollaborationEngine]
    S2[ScoringEngine]
    S3[PersonaSpec]
    S4[KnowledgeGraph]
    S5[CompliancePipeline]
    S6[Plugin system]
    A --> UC1
    A --> UC2
    A --> UC3
    A --> UC4
    A --> UC5
    A --> UC6
    UC1 --> S3
    UC1 --> S6
    UC2 --> S1
    UC2 --> S3
    UC3 --> S2
    UC4 --> S1
    UC4 --> S3
    UC5 --> S4
    UC5 --> S5
    UC6 --> S2

The 12-week curriculum is the spine: weeks one through four cover core modelling (personas, workflows, scenarios), weeks five through eight cover subsystems (events, observability, RAG, search), and weeks nine through twelve cover governance, compliance, and capstone deployment. The 2-day workshop is a compressed subset focused on hands-on labs.

Assessment Strategies and Grading Framework both wrap the ScoringEngine: rubrics grade deliverables against seven dimensions, and the engine produces signed rating reports instructors can attach to gradebooks. The Student Workbook and Jupyter companions give learners a scaffolded path through every subsystem.

Use-case detail

  • Use case 1 - 12-week curriculum: Instructor runs a full semester course covering all subsystems; docs/for-educators/curriculum-12-week.md.
  • Use case 2 - 2-day workshop: Instructor runs a compressed hands-on; CollaborationEngine drives pairs of learners; docs/for-educators/workshop-2-day.md.
  • Use case 3 - Assessment strategies: Instructor defines rubrics and grade bands; wraps ScoringEngine; docs/for-educators/assessment-strategies.md.
  • Use case 4 - Student workbook: Learners complete 12 weeks of structured exercises; docs/for-educators/student-workbook.md.
  • Use case 5 - Jupyter lecture companions: Students work through notebooks tied to each week; hits KnowledgeGraph and CompliancePipeline demos.
  • Use case 6 - Grade with rubrics: Instructor runs ScoringEngine against deliverables; docs/for-educators/grading-rubrics.md.

See also

  • Source: src/fcc/collaboration/engine.py, src/fcc/collaboration/scoring.py
  • Source: src/fcc/personas/models.py, src/fcc/knowledge/graph.py, src/fcc/compliance/pipeline.py
  • For audience tier: docs/for-educators/index.md