# rgbittencourt/classatelier architecture

> Architecture diagram of the GitHub repository rgbittencourt/classatelier, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rgbittencourt/classatelier
- Repository: https://github.com/rgbittencourt/classatelier

## Overview

ClassAtelier is a browser-based interactive-lesson editor: authors open or import a `.aula.json` project, edit blocks and preview the lesson, then save or generate learner-facing outputs. Its broader workflow includes accessibility and content-review tools, slide-deck generation, and assembling lessons into courses for HTML, SCORM, or GitHub publication. The README documents these product branches; source excerpts confirm editor state, export preview, SCORM runtime, and slide rendering details. Many subsystem links are documented rather than visible in sampled call sites.

Main entry points: [`app.jsx`](https://github.com/rgbittencourt/classatelier/blob/main/app.jsx) (Lesson editor), [`slides-render.js`](https://github.com/rgbittencourt/classatelier/blob/main/slides-render.js) (Slide generation), [`export.jsx`](https://github.com/rgbittencourt/classatelier/blob/main/export.jsx) (Lesson export), [`devicepreview.jsx`](https://github.com/rgbittencourt/classatelier/blob/main/devicepreview.jsx) (Device preview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Lesson authoring"]
  node_editor["Lesson editor<br/>[app.jsx]"]
  node_blockkit["Lesson components<br/>[components.jsx]"]
  node_properties["Block properties<br/>[panel.jsx]"]
  node_preview["Device preview<br/>[devicepreview.jsx]"]
  node_import["Project import<br/>[importar.js]"]
  node_importui["Import interface<br/>[importar-ui.jsx]"]
end

subgraph group_review["Review tools"]
  node_a11y["Accessibility audit<br/>[a11y.jsx]"]
  node_spell["Spell checking<br/>[corretor.js]"]
  node_spellengine["Spell engine<br/>[corretor-motor.js]"]
  node_glossary["Glossary review<br/>[glossario.js]"]
end

subgraph group_outputs["Lesson outputs"]
  node_export["Lesson export<br/>[export.jsx]"]
  node_renderer["Lesson runtime<br/>[components.jsx]"]
  node_scorm["SCORM bridge<br/>[scorm.js]"]
  node_slides["Slide generation<br/>[slides-render.js]"]
  node_diagrams["Slide diagrams<br/>[slides-diagram.js]"]
  node_pptx["PowerPoint export<br/>[slides-pptx.js]"]
  node_print["Print view<br/>[print-view.jsx]"]
end

subgraph group_courses["Course publishing"]
  node_library[("Lesson library<br/>[app.jsx]")]
  node_course["Course assembly<br/>[export.jsx]"]
  node_github["GitHub publishing<br/>[export.jsx]"]
end

node_author(("Author"))
node_lms["LMS runtime"]
node_classauthor["ClassAuthor AI"]

node_author -->|"edits lessons"| node_editor
node_author -->|"opens project"| node_importui
node_importui -->|"imports project"| node_import
node_editor -->|"edits blocks"| node_blockkit
node_editor -->|"configures blocks"| node_properties
node_editor -->|"previews lesson"| node_preview
node_editor -->|"stores lessons"| node_library
node_author -->|"reviews accessibility"| node_a11y
node_editor -->|"checks spelling"| node_spell
node_spell -.->|"uses"| node_spellengine
node_author -->|"reviews links"| node_glossary
node_author -->|"exports lesson"| node_export
node_preview -->|"builds preview"| node_export
node_export -->|"embeds runtime"| node_renderer
node_renderer -.->|"reports progress"| node_scorm
node_scorm -->|"sends results"| node_lms
node_author -->|"generates deck"| node_slides
node_slides -->|"renders diagrams"| node_diagrams
node_slides -->|"exports deck"| node_pptx
node_author -->|"prints lesson"| node_print
node_author -->|"assembles course"| node_course
node_course -->|"publishes site"| node_github
node_github -->|"shares lesson links"| node_lms
node_slides -->|"requests slide content"| node_classauthor

click node_editor "https://github.com/rgbittencourt/classatelier/blob/main/app.jsx"
click node_blockkit "https://github.com/rgbittencourt/classatelier/blob/main/ui_kits/scorm_lesson/components.jsx"
click node_properties "https://github.com/rgbittencourt/classatelier/blob/main/panel.jsx"
click node_preview "https://github.com/rgbittencourt/classatelier/blob/main/devicepreview.jsx"
click node_import "https://github.com/rgbittencourt/classatelier/blob/main/importar.js"
click node_importui "https://github.com/rgbittencourt/classatelier/blob/main/importar-ui.jsx"
click node_a11y "https://github.com/rgbittencourt/classatelier/blob/main/a11y.jsx"
click node_spell "https://github.com/rgbittencourt/classatelier/blob/main/corretor.js"
click node_spellengine "https://github.com/rgbittencourt/classatelier/blob/main/corretor-motor.js"
click node_glossary "https://github.com/rgbittencourt/classatelier/blob/main/glossario.js"
click node_export "https://github.com/rgbittencourt/classatelier/blob/main/export.jsx"
click node_renderer "https://github.com/rgbittencourt/classatelier/blob/main/ui_kits/scorm_lesson/components.jsx"
click node_scorm "https://github.com/rgbittencourt/classatelier/blob/main/ui_kits/scorm_lesson/scorm.js"
click node_slides "https://github.com/rgbittencourt/classatelier/blob/main/slides-render.js"
click node_diagrams "https://github.com/rgbittencourt/classatelier/blob/main/slides-diagram.js"
click node_pptx "https://github.com/rgbittencourt/classatelier/blob/main/slides-pptx.js"
click node_print "https://github.com/rgbittencourt/classatelier/blob/main/print-view.jsx"
click node_library "https://github.com/rgbittencourt/classatelier/blob/main/app.jsx"
click node_course "https://github.com/rgbittencourt/classatelier/blob/main/export.jsx"
click node_github "https://github.com/rgbittencourt/classatelier/blob/main/export.jsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_editor,node_blockkit,node_properties,node_preview,node_import,node_importui toneBlue
class node_a11y,node_spell,node_spellengine,node_glossary toneAmber
class node_export,node_renderer,node_scorm,node_slides,node_diagrams,node_pptx,node_print toneMint
class node_library,node_course,node_github toneRose
class node_author,node_lms,node_classauthor toneIndigo
```

## Components

### Lesson authoring

- [Lesson editor](https://github.com/rgbittencourt/classatelier/blob/main/app.jsx): `app.jsx`
- [Lesson components](https://github.com/rgbittencourt/classatelier/blob/main/ui_kits/scorm_lesson/components.jsx): `ui_kits/scorm_lesson/components.jsx`
- [Block properties](https://github.com/rgbittencourt/classatelier/blob/main/panel.jsx): `panel.jsx`
- [Device preview](https://github.com/rgbittencourt/classatelier/blob/main/devicepreview.jsx): `devicepreview.jsx`
- [Project import](https://github.com/rgbittencourt/classatelier/blob/main/importar.js): `importar.js`
- [Import interface](https://github.com/rgbittencourt/classatelier/blob/main/importar-ui.jsx): `importar-ui.jsx`

### Review tools

- [Accessibility audit](https://github.com/rgbittencourt/classatelier/blob/main/a11y.jsx): `a11y.jsx`
- [Spell checking](https://github.com/rgbittencourt/classatelier/blob/main/corretor.js): `corretor.js`
- [Spell engine](https://github.com/rgbittencourt/classatelier/blob/main/corretor-motor.js): `corretor-motor.js`
- [Glossary review](https://github.com/rgbittencourt/classatelier/blob/main/glossario.js): `glossario.js`

### Lesson outputs

- [Lesson export](https://github.com/rgbittencourt/classatelier/blob/main/export.jsx): `export.jsx`
- [Lesson runtime](https://github.com/rgbittencourt/classatelier/blob/main/ui_kits/scorm_lesson/components.jsx): `ui_kits/scorm_lesson/components.jsx`
- [SCORM bridge](https://github.com/rgbittencourt/classatelier/blob/main/ui_kits/scorm_lesson/scorm.js): `ui_kits/scorm_lesson/scorm.js`
- [Slide generation](https://github.com/rgbittencourt/classatelier/blob/main/slides-render.js): `slides-render.js`
- [Slide diagrams](https://github.com/rgbittencourt/classatelier/blob/main/slides-diagram.js): `slides-diagram.js`
- [PowerPoint export](https://github.com/rgbittencourt/classatelier/blob/main/slides-pptx.js): `slides-pptx.js`
- [Print view](https://github.com/rgbittencourt/classatelier/blob/main/print-view.jsx): `print-view.jsx`

### Course publishing

- [Lesson library](https://github.com/rgbittencourt/classatelier/blob/main/app.jsx): `app.jsx`
- [Course assembly](https://github.com/rgbittencourt/classatelier/blob/main/export.jsx): `export.jsx`
- [GitHub publishing](https://github.com/rgbittencourt/classatelier/blob/main/export.jsx): `export.jsx`

### Other components

- **Author**
- **LMS runtime**
- **ClassAuthor AI**

## Connections

- Author → Lesson editor: edits lessons (evidence: `README.md`)
- Author → Import interface: opens project (evidence: `README.md`)
- Import interface → Project import: imports project (evidence: `README.md`)
- Lesson editor → Lesson components: edits blocks (evidence: `app.jsx`)
- Lesson editor → Block properties: configures blocks (evidence: `README.md`)
- Lesson editor → Device preview: previews lesson (evidence: `README.md`)
- Lesson editor → Lesson library: stores lessons (evidence: `README.md`)
- Author → Accessibility audit: reviews accessibility (evidence: `README.md`)
- Lesson editor → Spell checking: checks spelling (evidence: `app.jsx`)
- Spell checking → Spell engine: uses
- Author → Glossary review: reviews links
- Author → Lesson export: exports lesson (evidence: `README.md`)
- Device preview → Lesson export: builds preview (evidence: `devicepreview.jsx`)
- Lesson export → Lesson runtime: embeds runtime (evidence: `export.jsx`)
- Lesson runtime → SCORM bridge: reports progress
- SCORM bridge → LMS runtime: sends results (evidence: `ui_kits/scorm_lesson/scorm.js`)
- Author → Slide generation: generates deck (evidence: `README.md`)
- Slide generation → Slide diagrams: renders diagrams (evidence: `slides-render.js`)
- Slide generation → PowerPoint export: exports deck (evidence: `README.md`)
- Author → Print view: prints lesson (evidence: `README.md`)
- Author → Course assembly: assembles course (evidence: `README.md`)
- Course assembly → GitHub publishing: publishes site (evidence: `README.md`)
- GitHub publishing → LMS runtime: shares lesson links (evidence: `README.md`)
- Slide generation → ClassAuthor AI: requests slide content (evidence: `README.md`)
