# michelbado/michels-tools architecture

> Architecture diagram of the GitHub repository michelbado/michels-tools, 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/michelbado/michels-tools
- Repository: https://github.com/michelbado/michels-tools

## Overview

Michel’s Tools is a browser-oriented web desktop served by one Go program. Visitors open the desktop, choose a tool, and get a result—usually computed locally in their browser; the README explicitly says PDFs and pasted text never leave the browser. The product spans network and connection troubleshooting, PDF and image processing, everyday engineering utilities, references, and games. The excerpts show the Go server serving embedded web files and registering server-side handlers. Many individual tools are documented but unsampled, so their internal calls and wiring are not inferred.

Main entry points: [`web/shell.js`](https://github.com/michelbado/michels-tools/blob/main/web/shell.js) (Web desktop), [`main.go`](https://github.com/michelbado/michels-tools/blob/main/main.go) (HTTP server), [`web/apps`](https://github.com/michelbado/michels-tools/tree/main/web/apps) (Browser games), [`web/apps/dhcpopt/app.js`](https://github.com/michelbado/michels-tools/blob/main/web/apps/dhcpopt/app.js) (DHCP options)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["Go server"]
  node_server["HTTP server<br/>[main.go]"]
  node_desktop["Web desktop<br/>[shell.js]"]
  node_desktopfiles["Desktop registry<br/>[desktopfiles.js]"]
  node_serverhandlers["Server handlers<br/>[desktop.go]"]
end

subgraph group_network["Network tools"]
  node_aggregation["IP aggregation<br/>[aggregate.go]"]
  node_networktools["Network tools"]
  node_dhcpui["DHCP options<br/>[app.js]"]
  node_dhcpcore["DHCP logic<br/>[dhcpopt.js]"]
  node_packetui["Packet decoder<br/>[app.js]"]
  node_packetcore["Packet parsing<br/>[pktdecode.js]"]
  node_connectiontools["Connection tools<br/>[app.js]"]
end

subgraph group_documents["Document and image tools"]
  node_pdfapps["PDF tools"]
  node_pdfcommon["PDF utilities<br/>[pdfcommon.js]"]
  node_imageapps["Image tools"]
end

subgraph group_utilities["Utilities and play"]
  node_engineering["Engineering tools"]
  node_references["Reference cards<br/>[refkit.js]"]
  node_games["Browser games"]
  node_gamekit["Game utilities<br/>[gamekit.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_desktop
node_server -->|"serves web files"| node_desktop
node_server -->|"registers handlers"| node_serverhandlers
node_desktop -->|"uses desktop registry"| node_desktopfiles
node_desktop -->|"offers tools"| node_networktools
node_desktop -->|"offers tools"| node_pdfapps
node_desktop -->|"offers tools"| node_imageapps
node_desktop -->|"offers tools"| node_engineering
node_desktop -->|"offers reference cards"| node_references
node_desktop -.->|"offers games"| node_games
node_dhcpui -.->|"uses"| node_dhcpcore
node_packetui -.->|"uses"| node_packetcore
node_visitor -->|"measures connection"| node_connectiontools
node_visitor -.->|"submits aggregation"| node_aggregation
node_games -.->|"uses game helpers"| node_gamekit

click node_server "https://github.com/michelbado/michels-tools/blob/main/main.go"
click node_desktop "https://github.com/michelbado/michels-tools/blob/main/web/shell.js"
click node_desktopfiles "https://github.com/michelbado/michels-tools/blob/main/web/desktopfiles.js"
click node_serverhandlers "https://github.com/michelbado/michels-tools/blob/main/desktop.go"
click node_aggregation "https://github.com/michelbado/michels-tools/blob/main/aggregate.go"
click node_networktools "https://github.com/michelbado/michels-tools/tree/main/web/apps"
click node_dhcpui "https://github.com/michelbado/michels-tools/blob/main/web/apps/dhcpopt/app.js"
click node_dhcpcore "https://github.com/michelbado/michels-tools/blob/main/web/lib/dhcpopt.js"
click node_packetui "https://github.com/michelbado/michels-tools/blob/main/web/apps/pktdecode/app.js"
click node_packetcore "https://github.com/michelbado/michels-tools/blob/main/web/lib/pktdecode.js"
click node_connectiontools "https://github.com/michelbado/michels-tools/blob/main/web/apps/netquality/app.js"
click node_pdfapps "https://github.com/michelbado/michels-tools/tree/main/web/apps"
click node_pdfcommon "https://github.com/michelbado/michels-tools/blob/main/web/lib/pdfcommon.js"
click node_imageapps "https://github.com/michelbado/michels-tools/tree/main/web/apps"
click node_engineering "https://github.com/michelbado/michels-tools/tree/main/web/apps"
click node_references "https://github.com/michelbado/michels-tools/blob/main/web/lib/refkit.js"
click node_games "https://github.com/michelbado/michels-tools/tree/main/web/apps"
click node_gamekit "https://github.com/michelbado/michels-tools/blob/main/web/lib/gamekit.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_server,node_desktop,node_desktopfiles,node_serverhandlers toneBlue
class node_aggregation,node_networktools,node_dhcpui,node_dhcpcore,node_packetui,node_packetcore,node_connectiontools toneAmber
class node_pdfapps,node_pdfcommon,node_imageapps toneMint
class node_engineering,node_references,node_games,node_gamekit toneRose
class node_visitor toneIndigo
```

## Components

### Go server

- [HTTP server](https://github.com/michelbado/michels-tools/blob/main/main.go): `main.go`
- [Web desktop](https://github.com/michelbado/michels-tools/blob/main/web/shell.js): `web/shell.js`
- [Desktop registry](https://github.com/michelbado/michels-tools/blob/main/web/desktopfiles.js): `web/desktopfiles.js`
- [Server handlers](https://github.com/michelbado/michels-tools/blob/main/desktop.go): `desktop.go`

### Network tools

- [IP aggregation](https://github.com/michelbado/michels-tools/blob/main/aggregate.go): `aggregate.go`
- [Network tools](https://github.com/michelbado/michels-tools/tree/main/web/apps): `web/apps`
- [DHCP options](https://github.com/michelbado/michels-tools/blob/main/web/apps/dhcpopt/app.js): `web/apps/dhcpopt/app.js`
- [DHCP logic](https://github.com/michelbado/michels-tools/blob/main/web/lib/dhcpopt.js): `web/lib/dhcpopt.js`
- [Packet decoder](https://github.com/michelbado/michels-tools/blob/main/web/apps/pktdecode/app.js): `web/apps/pktdecode/app.js`
- [Packet parsing](https://github.com/michelbado/michels-tools/blob/main/web/lib/pktdecode.js): `web/lib/pktdecode.js`
- [Connection tools](https://github.com/michelbado/michels-tools/blob/main/web/apps/netquality/app.js): `web/apps/netquality/app.js`

### Document and image tools

- [PDF tools](https://github.com/michelbado/michels-tools/tree/main/web/apps): `web/apps`
- [PDF utilities](https://github.com/michelbado/michels-tools/blob/main/web/lib/pdfcommon.js): `web/lib/pdfcommon.js`
- [Image tools](https://github.com/michelbado/michels-tools/tree/main/web/apps): `web/apps`

### Utilities and play

- [Engineering tools](https://github.com/michelbado/michels-tools/tree/main/web/apps): `web/apps`
- [Reference cards](https://github.com/michelbado/michels-tools/blob/main/web/lib/refkit.js): `web/lib/refkit.js`
- [Browser games](https://github.com/michelbado/michels-tools/tree/main/web/apps): `web/apps`
- [Game utilities](https://github.com/michelbado/michels-tools/blob/main/web/lib/gamekit.js): `web/lib/gamekit.js`

### Other components

- **Visitor**

## Connections

- Visitor → Web desktop: opens (evidence: `README.md`)
- HTTP server → Web desktop: serves web files (evidence: `main.go`)
- HTTP server → Server handlers: registers handlers (evidence: `main.go`)
- Web desktop → Desktop registry: uses desktop registry (evidence: `web/desktopfiles.js`)
- Web desktop → Network tools: offers tools (evidence: `README.md`)
- Web desktop → PDF tools: offers tools (evidence: `README.md`)
- Web desktop → Image tools: offers tools (evidence: `README.md`)
- Web desktop → Engineering tools: offers tools (evidence: `README.md`)
- Web desktop → Reference cards: offers reference cards (evidence: `README.md`)
- Web desktop → Browser games: offers games
- DHCP options → DHCP logic: uses
- Packet decoder → Packet parsing: uses
- Visitor → Connection tools: measures connection (evidence: `web/apps/netquality/app.js`)
- Visitor → IP aggregation: submits aggregation
- Browser games → Game utilities: uses game helpers
