# aanddark/me-generator architecture

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

- Interactive diagram: https://gitdiagram.com/aanddark/me-generator
- Repository: https://github.com/aanddark/me-generator

## Overview

This is a browser-based geometry exercise generator: the app routes to a page, loads its UI, generates a shape problem, checks answers, and can draw shapes on a canvas. The sampled code shows task generation and calculation in detail, plus canvas drawing; component-to-service wiring for the web components was not sampled, so those links are omitted. The README is empty, and the graph reflects the available source index and excerpts.

Main entry points: [`src/core/usecase/TaskService.js`](https://github.com/aanddark/me-generator/blob/master/src/core/usecase/TaskService.js) (Task service), [`main.js`](https://github.com/aanddark/me-generator/blob/master/main.js) (App entry), [`src/core/ui/script/main.js`](https://github.com/aanddark/me-generator/blob/master/src/core/ui/script/main.js) (UI script entry), [`src/core/ui/widgets/webcomponents/app/main.js`](https://github.com/aanddark/me-generator/blob/master/src/core/ui/widgets/webcomponents/app/main.js) (Web component entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_entry["App entry<br/>[main.js]"]
  node_router["Router<br/>[router.js]"]
end

subgraph group_interface["User interface"]
  node_page["Main page template<br/>[main.template]"]
  node_ui_main["UI script entry<br/>[main.js]"]
  node_answer_renderer["Answer renderer"]
  node_canvas_renderer["Canvas renderer<br/>[renderCanvas.js]"]
  node_web_components["Web component entry<br/>[main.js]"]
  node_start_screen["Start screen"]
  node_answer_field["Answer field"]
  node_canvas_service["Canvas service<br/>[CanvasService.js]"]
end

subgraph group_tasks["Task generation"]
  node_task_service["Task service<br/>[TaskService.js]"]
  node_generator["Problem generator<br/>[generator.js]"]
  node_question_bank["Question bank<br/>[constanst.js]"]
  node_task["Task answer checking<br/>[Task.js]"]
end

subgraph group_geometry["Geometry domain"]
  node_shape_base["Shape base<br/>[shapeCuboid.js]"]
  node_square["Square<br/>[squre.js]"]
  node_rectangle["Rectangle<br/>[rectangle.js]"]
  node_rhombus["Rhombus<br/>[rhombus.js]"]
end

node_user(("User"))

node_user -.->|"opens app"| node_entry
node_entry -->|"creates"| node_router
node_entry -->|"loads template"| node_page
node_entry -->|"loads"| node_web_components
node_entry -->|"loads"| node_ui_main
node_ui_main -->|"imports"| node_answer_renderer
node_ui_main -->|"imports"| node_canvas_renderer
node_web_components -->|"imports"| node_start_screen
node_web_components -->|"imports"| node_answer_field
node_answer_renderer -->|"uses"| node_task_service
node_canvas_renderer -->|"uses"| node_canvas_service
node_task_service -->|"generates problem"| node_generator
node_generator -->|"reads questions"| node_question_bank
node_task_service -->|"creates task"| node_task
node_task_service -->|"creates shape"| node_square
node_task_service -->|"creates shape"| node_rectangle
node_task_service -->|"creates shape"| node_rhombus
node_square -->|"extends"| node_shape_base
node_rectangle -->|"extends"| node_shape_base
node_rhombus -->|"extends"| node_shape_base

click node_entry "https://github.com/aanddark/me-generator/blob/master/main.js"
click node_router "https://github.com/aanddark/me-generator/blob/master/utils/router.js"
click node_page "https://github.com/aanddark/me-generator/blob/master/src/pages/main.template"
click node_ui_main "https://github.com/aanddark/me-generator/blob/master/src/core/ui/script/main.js"
click node_answer_renderer "https://github.com/aanddark/me-generator/blob/master/src/core/ui/script/renderAnswerComponent.js"
click node_canvas_renderer "https://github.com/aanddark/me-generator/blob/master/src/core/ui/script/renderCanvas.js"
click node_web_components "https://github.com/aanddark/me-generator/blob/master/src/core/ui/widgets/webcomponents/app/main.js"
click node_start_screen "https://github.com/aanddark/me-generator/blob/master/src/core/ui/widgets/webcomponents/app/startScreenComponent.js"
click node_answer_field "https://github.com/aanddark/me-generator/blob/master/src/core/ui/widgets/webcomponents/app/answerFieldComponent.js"
click node_task_service "https://github.com/aanddark/me-generator/blob/master/src/core/usecase/TaskService.js"
click node_generator "https://github.com/aanddark/me-generator/blob/master/src/core/infrastructure/generator.js"
click node_question_bank "https://github.com/aanddark/me-generator/blob/master/src/core/infrastructure/constanst.js"
click node_task "https://github.com/aanddark/me-generator/blob/master/src/core/domain/Task.js"
click node_canvas_service "https://github.com/aanddark/me-generator/blob/master/src/core/usecase/CanvasService.js"
click node_shape_base "https://github.com/aanddark/me-generator/blob/master/src/core/domain/dto/shapeCuboid.js"
click node_square "https://github.com/aanddark/me-generator/blob/master/src/core/domain/squre.js"
click node_rectangle "https://github.com/aanddark/me-generator/blob/master/src/core/domain/rectangle.js"
click node_rhombus "https://github.com/aanddark/me-generator/blob/master/src/core/domain/rhombus.js"

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_entry,node_router,node_user toneBlue
class node_page,node_ui_main,node_answer_renderer,node_canvas_renderer,node_web_components,node_start_screen,node_answer_field,node_canvas_service toneAmber
class node_task_service,node_generator,node_question_bank,node_task toneMint
class node_shape_base,node_square,node_rectangle,node_rhombus toneRose
```

## Components

### App entry

- [App entry](https://github.com/aanddark/me-generator/blob/master/main.js): `main.js`
- [Router](https://github.com/aanddark/me-generator/blob/master/utils/router.js): `utils/router.js`

### User interface

- [Main page template](https://github.com/aanddark/me-generator/blob/master/src/pages/main.template): `src/pages/main.template`
- [UI script entry](https://github.com/aanddark/me-generator/blob/master/src/core/ui/script/main.js): `src/core/ui/script/main.js`
- [Answer renderer](https://github.com/aanddark/me-generator/blob/master/src/core/ui/script/renderAnswerComponent.js): `src/core/ui/script/renderAnswerComponent.js`
- [Canvas renderer](https://github.com/aanddark/me-generator/blob/master/src/core/ui/script/renderCanvas.js): `src/core/ui/script/renderCanvas.js`
- [Web component entry](https://github.com/aanddark/me-generator/blob/master/src/core/ui/widgets/webcomponents/app/main.js): `src/core/ui/widgets/webcomponents/app/main.js`
- [Start screen](https://github.com/aanddark/me-generator/blob/master/src/core/ui/widgets/webcomponents/app/startScreenComponent.js): `src/core/ui/widgets/webcomponents/app/startScreenComponent.js`
- [Answer field](https://github.com/aanddark/me-generator/blob/master/src/core/ui/widgets/webcomponents/app/answerFieldComponent.js): `src/core/ui/widgets/webcomponents/app/answerFieldComponent.js`
- [Canvas service](https://github.com/aanddark/me-generator/blob/master/src/core/usecase/CanvasService.js): `src/core/usecase/CanvasService.js`

### Task generation

- [Task service](https://github.com/aanddark/me-generator/blob/master/src/core/usecase/TaskService.js): `src/core/usecase/TaskService.js`
- [Problem generator](https://github.com/aanddark/me-generator/blob/master/src/core/infrastructure/generator.js): `src/core/infrastructure/generator.js`
- [Question bank](https://github.com/aanddark/me-generator/blob/master/src/core/infrastructure/constanst.js): `src/core/infrastructure/constanst.js`
- [Task answer checking](https://github.com/aanddark/me-generator/blob/master/src/core/domain/Task.js): `src/core/domain/Task.js`

### Geometry domain

- [Shape base](https://github.com/aanddark/me-generator/blob/master/src/core/domain/dto/shapeCuboid.js): `src/core/domain/dto/shapeCuboid.js`
- [Square](https://github.com/aanddark/me-generator/blob/master/src/core/domain/squre.js): `src/core/domain/squre.js`
- [Rectangle](https://github.com/aanddark/me-generator/blob/master/src/core/domain/rectangle.js): `src/core/domain/rectangle.js`
- [Rhombus](https://github.com/aanddark/me-generator/blob/master/src/core/domain/rhombus.js): `src/core/domain/rhombus.js`

### Other components

- **User**

## Connections

- User → App entry: opens app
- App entry → Router: creates (evidence: `main.js`)
- App entry → Main page template: loads template (evidence: `main.js`)
- App entry → Web component entry: loads (evidence: `main.js`)
- App entry → UI script entry: loads (evidence: `main.js`)
- UI script entry → Answer renderer: imports (evidence: `src/core/ui/script/main.js`)
- UI script entry → Canvas renderer: imports (evidence: `src/core/ui/script/main.js`)
- Web component entry → Start screen: imports (evidence: `src/core/ui/widgets/webcomponents/app/main.js`)
- Web component entry → Answer field: imports (evidence: `src/core/ui/widgets/webcomponents/app/main.js`)
- Answer renderer → Task service: uses (evidence: `src/core/ui/script/renderAnswerComponent.js`)
- Canvas renderer → Canvas service: uses (evidence: `src/core/ui/script/renderCanvas.js`)
- Task service → Problem generator: generates problem (evidence: `src/core/usecase/TaskService.js`)
- Problem generator → Question bank: reads questions (evidence: `src/core/infrastructure/generator.js`)
- Task service → Task answer checking: creates task (evidence: `src/core/usecase/TaskService.js`)
- Task service → Square: creates shape (evidence: `src/core/usecase/TaskService.js`)
- Task service → Rectangle: creates shape (evidence: `src/core/usecase/TaskService.js`)
- Task service → Rhombus: creates shape (evidence: `src/core/usecase/TaskService.js`)
- Square → Shape base: extends (evidence: `src/core/domain/squre.js`)
- Rectangle → Shape base: extends (evidence: `src/core/domain/rectangle.js`)
- Rhombus → Shape base: extends (evidence: `src/core/domain/rhombus.js`)
