# chunglop0781/repository-mnha architecture

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

- Interactive diagram: https://gitdiagram.com/chunglop0781/repository-mnha
- Repository: https://github.com/chunglop0781/repository-mnha

## Overview

repository-mnha is a web workspace for running Emu8086 and C++, editing and previewing HTML, and storing documents. The main workflow is a user editing or selecting code, starting a run, and viewing its result and run history; code and results are stored in GitHub. Separate branches support HTML assets and remote previews, encrypted document storage, and connected data nodes for uploads. Source excerpts establish several service calls; other capability links below rely on README statements, so unsampled implementation details are not inferred.

Main entry points: [`controllers/code.controller.js`](https://github.com/chunglop0781/repository-mnha/blob/main/controllers/code.controller.js) (Code controller), [`controllers/html.controller.js`](https://github.com/chunglop0781/repository-mnha/blob/main/controllers/html.controller.js) (HTML controller), [`services/githubService.js`](https://github.com/chunglop0781/repository-mnha/blob/main/services/githubService.js) (GitHub storage), [`services/code/sessionManager.js`](https://github.com/chunglop0781/repository-mnha/blob/main/services/code/sessionManager.js) (Run sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_programming["Code workspace"]
  node_codeui["Code editor<br/>[codeEditor.js]"]
  node_codeapi["Code controller<br/>[code.controller.js]"]
  node_config["Language rules<br/>[codeConfig.js]"]
  node_sessions["Run sessions<br/>[sessionManager.js]"]
  node_emu["8086 emulator<br/>[machine.js]"]
  node_assembler["8086 assembler<br/>[assembler.js]"]
  node_cpp["C++ runner<br/>[cppRunner.js]"]
  node_remote["Remote source<br/>[remoteSource.js]"]
  node_code_store[("Code and history<br/>[codeStore.js]")]
end

subgraph group_webmedia["HTML and media"]
  node_htmlui["HTML editor<br/>[htmlEditor.js]"]
  node_htmlapi["HTML controller<br/>[html.controller.js]"]
  node_preview["Page preview<br/>[previewServer.js]"]
  node_media["Media uploads<br/>[mediaService.js]"]
  node_keys["Media key access<br/>[keyService.js]"]
end

subgraph group_documents["File archive"]
  node_fileui["File archive UI<br/>[fileStorage.js]"]
  node_fileapi["File controller"]
  node_filestore[("Encrypted file store<br/>[fileStore.js]")]
  node_wordapi["Word conversion<br/>[word.controller.js]"]
  node_wordstore[("Word storage<br/>[wordStore.js]")]
end

subgraph group_connections["Connected storage"]
  node_node["Data node<br/>[index.js]"]
  node_nodepick["Upload node selection<br/>[nodes.js]"]
  node_cloudflare["Cloudflare R2<br/>[cloudflare.js]"]
  node_github[("GitHub storage<br/>[githubService.js]")]
end

subgraph group_identity["Identity and sessions"]
  node_auth["Authentication<br/>[auth.controller.js]"]
  node_user_model[("User accounts<br/>[User.js]")]
end

node_user(("Workspace user"))
node_mongo[("MongoDB")]

node_user -->|"edits code"| node_codeui
node_codeui -->|"starts run"| node_codeapi
node_codeapi -->|"creates session"| node_sessions
node_sessions -->|"runs 8086"| node_emu
node_emu -->|"assembles"| node_assembler
node_sessions -->|"runs C++"| node_cpp
node_codeapi -->|"loads online code"| node_remote
node_codeapi -->|"saves results"| node_code_store
node_code_store -->|"stores code"| node_github
node_codeapi -->|"uses language rules"| node_config
node_user -->|"edits page"| node_htmlui
node_htmlui -->|"saves and previews"| node_htmlapi
node_htmlapi -->|"renders preview"| node_preview
node_htmlapi -->|"manages assets"| node_media
node_htmlapi -->|"requests file keys"| node_keys
node_media -->|"stores media"| node_cloudflare
node_user -->|"uploads documents"| node_fileui
node_fileui -->|"opens and uploads"| node_fileapi
node_fileapi -->|"stores encrypted parts"| node_filestore
node_filestore -->|"writes file parts"| node_github
node_fileapi -->|"selects upload node"| node_nodepick
node_nodepick -->|"routes upload"| node_node
node_node -->|"handles file parts"| node_filestore
node_user -->|"uses document tools"| node_wordapi
node_wordapi -->|"stores documents"| node_wordstore
node_wordstore -->|"persists files"| node_github
node_user -->|"signs in"| node_auth
node_auth -->|"checks account"| node_user_model
node_user_model -->|"shares user data"| node_mongo
node_github -.->|"returns stored data"| node_code_store

click node_codeui "https://github.com/chunglop0781/repository-mnha/blob/main/public/js/codeEditor.js"
click node_codeapi "https://github.com/chunglop0781/repository-mnha/blob/main/controllers/code.controller.js"
click node_config "https://github.com/chunglop0781/repository-mnha/blob/main/config/codeConfig.js"
click node_sessions "https://github.com/chunglop0781/repository-mnha/blob/main/services/code/sessionManager.js"
click node_emu "https://github.com/chunglop0781/repository-mnha/blob/main/services/emu8086/machine.js"
click node_assembler "https://github.com/chunglop0781/repository-mnha/blob/main/services/emu8086/assembler.js"
click node_cpp "https://github.com/chunglop0781/repository-mnha/blob/main/services/code/cppRunner.js"
click node_remote "https://github.com/chunglop0781/repository-mnha/blob/main/services/code/remoteSource.js"
click node_code_store "https://github.com/chunglop0781/repository-mnha/blob/main/services/code/codeStore.js"
click node_htmlui "https://github.com/chunglop0781/repository-mnha/blob/main/public/js/htmlEditor.js"
click node_htmlapi "https://github.com/chunglop0781/repository-mnha/blob/main/controllers/html.controller.js"
click node_preview "https://github.com/chunglop0781/repository-mnha/blob/main/services/code/previewServer.js"
click node_media "https://github.com/chunglop0781/repository-mnha/blob/main/services/code/mediaService.js"
click node_keys "https://github.com/chunglop0781/repository-mnha/blob/main/services/code/keyService.js"
click node_fileui "https://github.com/chunglop0781/repository-mnha/blob/main/public/js/fileStorage.js"
click node_fileapi "https://github.com/chunglop0781/repository-mnha/blob/main/controllers/files.controller.js"
click node_filestore "https://github.com/chunglop0781/repository-mnha/blob/main/services/code/fileStore.js"
click node_wordapi "https://github.com/chunglop0781/repository-mnha/blob/main/controllers/word.controller.js"
click node_wordstore "https://github.com/chunglop0781/repository-mnha/blob/main/services/word/wordStore.js"
click node_node "https://github.com/chunglop0781/repository-mnha/blob/main/connect/vercel/index.js"
click node_nodepick "https://github.com/chunglop0781/repository-mnha/blob/main/services/connect/nodes.js"
click node_cloudflare "https://github.com/chunglop0781/repository-mnha/blob/main/services/connect/cloudflare.js"
click node_github "https://github.com/chunglop0781/repository-mnha/blob/main/services/githubService.js"
click node_auth "https://github.com/chunglop0781/repository-mnha/blob/main/controllers/auth.controller.js"
click node_user_model "https://github.com/chunglop0781/repository-mnha/blob/main/models/User.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_codeui,node_codeapi,node_config,node_sessions,node_emu,node_assembler,node_cpp,node_remote,node_code_store,node_user toneBlue
class node_htmlui,node_htmlapi,node_preview,node_media,node_keys,node_mongo toneAmber
class node_fileui,node_fileapi,node_filestore,node_wordapi,node_wordstore toneMint
class node_node,node_nodepick,node_cloudflare,node_github toneRose
class node_auth,node_user_model toneIndigo
```

## Components

### Code workspace

- [Code editor](https://github.com/chunglop0781/repository-mnha/blob/main/public/js/codeEditor.js): `public/js/codeEditor.js`
- [Code controller](https://github.com/chunglop0781/repository-mnha/blob/main/controllers/code.controller.js): `controllers/code.controller.js`
- [Language rules](https://github.com/chunglop0781/repository-mnha/blob/main/config/codeConfig.js): `config/codeConfig.js`
- [Run sessions](https://github.com/chunglop0781/repository-mnha/blob/main/services/code/sessionManager.js): `services/code/sessionManager.js`
- [8086 emulator](https://github.com/chunglop0781/repository-mnha/blob/main/services/emu8086/machine.js): `services/emu8086/machine.js`
- [8086 assembler](https://github.com/chunglop0781/repository-mnha/blob/main/services/emu8086/assembler.js): `services/emu8086/assembler.js`
- [C++ runner](https://github.com/chunglop0781/repository-mnha/blob/main/services/code/cppRunner.js): `services/code/cppRunner.js`
- [Remote source](https://github.com/chunglop0781/repository-mnha/blob/main/services/code/remoteSource.js): `services/code/remoteSource.js`
- [Code and history](https://github.com/chunglop0781/repository-mnha/blob/main/services/code/codeStore.js): `services/code/codeStore.js`

### HTML and media

- [HTML editor](https://github.com/chunglop0781/repository-mnha/blob/main/public/js/htmlEditor.js): `public/js/htmlEditor.js`
- [HTML controller](https://github.com/chunglop0781/repository-mnha/blob/main/controllers/html.controller.js): `controllers/html.controller.js`
- [Page preview](https://github.com/chunglop0781/repository-mnha/blob/main/services/code/previewServer.js): `services/code/previewServer.js`
- [Media uploads](https://github.com/chunglop0781/repository-mnha/blob/main/services/code/mediaService.js): `services/code/mediaService.js`
- [Media key access](https://github.com/chunglop0781/repository-mnha/blob/main/services/code/keyService.js): `services/code/keyService.js`

### File archive

- [File archive UI](https://github.com/chunglop0781/repository-mnha/blob/main/public/js/fileStorage.js): `public/js/fileStorage.js`
- [File controller](https://github.com/chunglop0781/repository-mnha/blob/main/controllers/files.controller.js): `controllers/files.controller.js`
- [Encrypted file store](https://github.com/chunglop0781/repository-mnha/blob/main/services/code/fileStore.js): `services/code/fileStore.js`
- [Word conversion](https://github.com/chunglop0781/repository-mnha/blob/main/controllers/word.controller.js): `controllers/word.controller.js`
- [Word storage](https://github.com/chunglop0781/repository-mnha/blob/main/services/word/wordStore.js): `services/word/wordStore.js`

### Connected storage

- [Data node](https://github.com/chunglop0781/repository-mnha/blob/main/connect/vercel/index.js): `connect/vercel/index.js`
- [Upload node selection](https://github.com/chunglop0781/repository-mnha/blob/main/services/connect/nodes.js): `services/connect/nodes.js`
- [Cloudflare R2](https://github.com/chunglop0781/repository-mnha/blob/main/services/connect/cloudflare.js): `services/connect/cloudflare.js`
- [GitHub storage](https://github.com/chunglop0781/repository-mnha/blob/main/services/githubService.js): `services/githubService.js`

### Identity and sessions

- [Authentication](https://github.com/chunglop0781/repository-mnha/blob/main/controllers/auth.controller.js): `controllers/auth.controller.js`
- [User accounts](https://github.com/chunglop0781/repository-mnha/blob/main/models/User.js): `models/User.js`

### Other components

- **Workspace user**
- **MongoDB**

## Connections

- Workspace user → Code editor: edits code
- Code editor → Code controller: starts run (evidence: `controllers/code.controller.js`)
- Code controller → Run sessions: creates session (evidence: `services/code/sessionManager.js`)
- Run sessions → 8086 emulator: runs 8086 (evidence: `services/code/sessionManager.js`)
- 8086 emulator → 8086 assembler: assembles (evidence: `services/emu8086/machine.js`)
- Run sessions → C++ runner: runs C++ (evidence: `services/code/sessionManager.js`)
- Code controller → Remote source: loads online code (evidence: `controllers/code.controller.js`)
- Code controller → Code and history: saves results (evidence: `controllers/code.controller.js`)
- Code and history → GitHub storage: stores code (evidence: `services/code/codeStore.js`)
- Code controller → Language rules: uses language rules (evidence: `controllers/code.controller.js`)
- Workspace user → HTML editor: edits page
- HTML editor → HTML controller: saves and previews
- HTML controller → Page preview: renders preview (evidence: `controllers/html.controller.js`)
- HTML controller → Media uploads: manages assets (evidence: `controllers/html.controller.js`)
- HTML controller → Media key access: requests file keys (evidence: `controllers/html.controller.js`)
- Media uploads → Cloudflare R2: stores media (evidence: `services/code/mediaService.js`)
- Workspace user → File archive UI: uploads documents
- File archive UI → File controller: opens and uploads
- File controller → Encrypted file store: stores encrypted parts (evidence: `controllers/files.controller.js`)
- Encrypted file store → GitHub storage: writes file parts (evidence: `services/code/fileStore.js`)
- File controller → Upload node selection: selects upload node (evidence: `controllers/files.controller.js`)
- Upload node selection → Data node: routes upload
- Data node → Encrypted file store: handles file parts (evidence: `connect/vercel/index.js`)
- Workspace user → Word conversion: uses document tools
- Word conversion → Word storage: stores documents (evidence: `controllers/word.controller.js`)
- Word storage → GitHub storage: persists files
- Workspace user → Authentication: signs in
- Authentication → User accounts: checks account (evidence: `controllers/auth.controller.js`)
- User accounts → MongoDB: shares user data
- GitHub storage → Code and history: returns stored data (evidence: `services/code/codeStore.js`)
