# adilxali/script-craft architecture

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

- Interactive diagram: https://gitdiagram.com/adilxali/script-craft
- Repository: https://github.com/adilxali/script-craft

## Overview

The tree contains two products: ScriptCraft, an interactive JavaScript learning platform, and a pharmacy ERP backend. ScriptCraft’s visible workflow runs from lesson selection through an editor and isolated execution to practice feedback and tracked progress; authentication and dashboard capabilities are separate branches. The ERP evidence shows an API entry point and a substantial identity/tenant domain. The README is empty, and most ERP business modules are package stubs in the tree, so their behavior is not inferred here.

Main entry points: [`pages/learn/[module]/[lesson].vue`](https://github.com/adilxali/script-craft/blob/main/pages/learn/%5Bmodule%5D/%5Blesson%5D.vue) (Lesson View), [`pharmacy-erp/backend/app/main.py`](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/main.py) (ERP API), [`stores/progress.ts`](https://github.com/adilxali/script-craft/blob/main/stores/progress.ts) (Progress State), [`utils/worker-runner.ts`](https://github.com/adilxali/script-craft/blob/main/utils/worker-runner.ts) (Worker Runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["ScriptCraft Learning"]
  node_home["Learning Home<br/>[index.vue]"]
  node_lesson["Lesson View<br/>[&#91;lesson&#93;.vue]"]
  node_dashboard["Progress Dashboard<br/>[dashboard.vue]"]
  node_progress["Progress State<br/>[progress.ts]"]
  node_language["Language State<br/>[language.ts]"]
  node_quiz["Practice Quiz<br/>[PracticeQuiz.vue]"]
end

subgraph group_execution["Code Practice"]
  node_editor["Monaco Editor"]
  node_console["Console Panel<br/>[ConsolePanel.vue]"]
  node_test_runner["Test Runner"]
  node_worker["Worker Runner<br/>[worker-runner.ts]"]
end

subgraph group_web_auth["Web Authentication"]
  node_auth_store["Auth State<br/>[auth.ts]"]
  node_auth_api["Auth Endpoints<br/>[login.post.ts]"]
  node_auth_helper["Session Utility<br/>[auth.ts]"]
end

subgraph group_erp_core["ERP API Core"]
  node_erp_api["ERP API<br/>[main.py]"]
  node_tenant["Tenant Context<br/>[tenant_context.py]"]
  node_security["Token Security<br/>[security.py]"]
end

subgraph group_erp_identity["ERP Identity"]
  node_identity_api["Identity Routes<br/>[auth.py]"]
  node_identity_service["Identity Service"]
  node_user_repo["User Repository<br/>[user_repository.py]"]
  node_role_repo["Role Repository<br/>[role_repository.py]"]
  node_user_model["User Model<br/>[user.py]"]
  node_role_model["Role Model<br/>[role.py]"]
end

node_learner(("Learner"))
node_erp_user(("ERP Operator"))

node_learner -->|"opens"| node_home
node_learner -.->|"studies"| node_lesson
node_learner -->|"reviews progress"| node_dashboard
node_lesson -->|"renders"| node_editor
node_lesson -->|"renders"| node_console
node_lesson -->|"renders"| node_test_runner
node_editor -.->|"requests execution"| node_worker
node_console -->|"runs code"| node_worker
node_test_runner -->|"runs tests"| node_worker
node_lesson -->|"updates"| node_progress
node_quiz -->|"records completion"| node_progress
node_dashboard -->|"reads progress"| node_progress
node_lesson -->|"reads language"| node_language
node_learner -.->|"signs in"| node_auth_store
node_auth_store -->|"submits credentials"| node_auth_api
node_auth_api -.->|"uses sessions"| node_auth_helper
node_erp_user -.->|"calls API"| node_erp_api
node_erp_api -->|"decodes token"| node_security
node_erp_api -->|"sets tenant context"| node_tenant
node_erp_api -->|"mounts routes"| node_identity_api
node_identity_service -->|"uses repository"| node_user_repo
node_identity_service -->|"uses repository"| node_role_repo
node_user_repo -->|"queries"| node_user_model
node_role_repo -->|"queries"| node_role_model

click node_home "https://github.com/adilxali/script-craft/blob/main/pages/index.vue"
click node_lesson "https://github.com/adilxali/script-craft/blob/main/pages/learn/%5Bmodule%5D/%5Blesson%5D.vue"
click node_dashboard "https://github.com/adilxali/script-craft/blob/main/pages/dashboard.vue"
click node_progress "https://github.com/adilxali/script-craft/blob/main/stores/progress.ts"
click node_language "https://github.com/adilxali/script-craft/blob/main/stores/language.ts"
click node_quiz "https://github.com/adilxali/script-craft/blob/main/components/content/PracticeQuiz.vue"
click node_editor "https://github.com/adilxali/script-craft/blob/main/components/ide/MonacoEditor.client.vue"
click node_console "https://github.com/adilxali/script-craft/blob/main/components/ide/ConsolePanel.vue"
click node_test_runner "https://github.com/adilxali/script-craft/blob/main/components/ide/TestRunnerPanel.vue"
click node_worker "https://github.com/adilxali/script-craft/blob/main/utils/worker-runner.ts"
click node_auth_store "https://github.com/adilxali/script-craft/blob/main/stores/auth.ts"
click node_auth_api "https://github.com/adilxali/script-craft/blob/main/server/api/auth/login.post.ts"
click node_auth_helper "https://github.com/adilxali/script-craft/blob/main/server/utils/auth.ts"
click node_erp_api "https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/main.py"
click node_tenant "https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/core/tenant_context.py"
click node_security "https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/core/security.py"
click node_identity_api "https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/api/auth.py"
click node_identity_service "https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/services/identity_service.py"
click node_user_repo "https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/repositories/user_repository.py"
click node_role_repo "https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/repositories/role_repository.py"
click node_user_model "https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/models/user.py"
click node_role_model "https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/models/role.py"

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_home,node_lesson,node_dashboard,node_progress,node_language,node_quiz toneBlue
class node_editor,node_console,node_test_runner,node_worker toneAmber
class node_auth_store,node_auth_api,node_auth_helper toneMint
class node_erp_api,node_tenant,node_security toneRose
class node_identity_api,node_identity_service,node_user_repo,node_role_repo,node_user_model,node_role_model,node_learner,node_erp_user toneIndigo
```

## Components

### ScriptCraft Learning

- [Learning Home](https://github.com/adilxali/script-craft/blob/main/pages/index.vue): `pages/index.vue`
- [Lesson View](https://github.com/adilxali/script-craft/blob/main/pages/learn/%5Bmodule%5D/%5Blesson%5D.vue): `pages/learn/[module]/[lesson].vue`
- [Progress Dashboard](https://github.com/adilxali/script-craft/blob/main/pages/dashboard.vue): `pages/dashboard.vue`
- [Progress State](https://github.com/adilxali/script-craft/blob/main/stores/progress.ts): `stores/progress.ts`
- [Language State](https://github.com/adilxali/script-craft/blob/main/stores/language.ts): `stores/language.ts`
- [Practice Quiz](https://github.com/adilxali/script-craft/blob/main/components/content/PracticeQuiz.vue): `components/content/PracticeQuiz.vue`

### Code Practice

- [Monaco Editor](https://github.com/adilxali/script-craft/blob/main/components/ide/MonacoEditor.client.vue): `components/ide/MonacoEditor.client.vue`
- [Console Panel](https://github.com/adilxali/script-craft/blob/main/components/ide/ConsolePanel.vue): `components/ide/ConsolePanel.vue`
- [Test Runner](https://github.com/adilxali/script-craft/blob/main/components/ide/TestRunnerPanel.vue): `components/ide/TestRunnerPanel.vue`
- [Worker Runner](https://github.com/adilxali/script-craft/blob/main/utils/worker-runner.ts): `utils/worker-runner.ts`

### Web Authentication

- [Auth State](https://github.com/adilxali/script-craft/blob/main/stores/auth.ts): `stores/auth.ts`
- [Auth Endpoints](https://github.com/adilxali/script-craft/blob/main/server/api/auth/login.post.ts): `server/api/auth/login.post.ts`
- [Session Utility](https://github.com/adilxali/script-craft/blob/main/server/utils/auth.ts): `server/utils/auth.ts`

### ERP API Core

- [ERP API](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/main.py): `pharmacy-erp/backend/app/main.py`
- [Tenant Context](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/core/tenant_context.py): `pharmacy-erp/backend/app/core/tenant_context.py`
- [Token Security](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/core/security.py): `pharmacy-erp/backend/app/core/security.py`

### ERP Identity

- [Identity Routes](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/api/auth.py): `pharmacy-erp/backend/app/modules/identity/api/auth.py`
- [Identity Service](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/services/identity_service.py): `pharmacy-erp/backend/app/modules/identity/services/identity_service.py`
- [User Repository](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/repositories/user_repository.py): `pharmacy-erp/backend/app/modules/identity/repositories/user_repository.py`
- [Role Repository](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/repositories/role_repository.py): `pharmacy-erp/backend/app/modules/identity/repositories/role_repository.py`
- [User Model](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/models/user.py): `pharmacy-erp/backend/app/modules/identity/models/user.py`
- [Role Model](https://github.com/adilxali/script-craft/blob/main/pharmacy-erp/backend/app/modules/identity/models/role.py): `pharmacy-erp/backend/app/modules/identity/models/role.py`

### Other components

- **Learner**
- **ERP Operator**

## Connections

- Learner → Learning Home: opens (evidence: `pages/index.vue`)
- Learner → Lesson View: studies
- Learner → Progress Dashboard: reviews progress
- Lesson View → Monaco Editor: renders (evidence: `pages/learn/[module]/[lesson].vue`)
- Lesson View → Console Panel: renders (evidence: `pages/learn/[module]/[lesson].vue`)
- Lesson View → Test Runner: renders (evidence: `pages/learn/[module]/[lesson].vue`)
- Monaco Editor → Worker Runner: requests execution
- Console Panel → Worker Runner: runs code (evidence: `components/ide/ConsolePanel.vue`)
- Test Runner → Worker Runner: runs tests (evidence: `components/ide/TestRunnerPanel.vue`)
- Lesson View → Progress State: updates (evidence: `pages/learn/[module]/[lesson].vue`)
- Practice Quiz → Progress State: records completion (evidence: `components/content/PracticeQuiz.vue`)
- Progress Dashboard → Progress State: reads progress (evidence: `pages/dashboard.vue`)
- Lesson View → Language State: reads language (evidence: `pages/learn/[module]/[lesson].vue`)
- Learner → Auth State: signs in
- Auth State → Auth Endpoints: submits credentials (evidence: `stores/auth.ts`)
- Auth Endpoints → Session Utility: uses sessions
- ERP Operator → ERP API: calls API
- ERP API → Token Security: decodes token (evidence: `pharmacy-erp/backend/app/main.py`)
- ERP API → Tenant Context: sets tenant context (evidence: `pharmacy-erp/backend/app/main.py`)
- ERP API → Identity Routes: mounts routes (evidence: `pharmacy-erp/backend/app/main.py`)
- Identity Service → User Repository: uses repository (evidence: `pharmacy-erp/backend/app/modules/identity/services/identity_service.py`)
- Identity Service → Role Repository: uses repository (evidence: `pharmacy-erp/backend/app/modules/identity/services/identity_service.py`)
- User Repository → User Model: queries (evidence: `pharmacy-erp/backend/app/modules/identity/repositories/user_repository.py`)
- Role Repository → Role Model: queries (evidence: `pharmacy-erp/backend/app/modules/identity/repositories/role_repository.py`)
