# legooh/devpool architecture

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

## Overview

GoTicket is a full-stack user-management application: a browser UI supports user CRUD, search, status changes and feedback, while an Express REST API validates requests, applies user rules and stores records in JSON. The graph preserves the main UI-to-API-to-storage workflow and the documented validation, password hashing, UUID, CORS and health-check capabilities. Source excerpts show the principal backend calls; README statements support documented features whose implementation was not sampled.

Main entry points: [`src/app.js`](https://github.com/legooh/devpool/blob/main/src/app.js) (Express app), [`src/services/userService.js`](https://github.com/legooh/devpool/blob/main/src/services/userService.js) (User service), [`public/app.js`](https://github.com/legooh/devpool/blob/main/public/app.js) (User dashboard), [`src/routes/userRoutes.js`](https://github.com/legooh/devpool/blob/main/src/routes/userRoutes.js) (User routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser interface"]
  node_ui["User dashboard<br/>[app.js]"]
end

subgraph group_api["REST API"]
  node_server["Server startup<br/>[server.js]"]
  node_config["Runtime config<br/>[config.js]"]
  node_app["Express app<br/>[app.js]"]
  node_routes["User routes<br/>[userRoutes.js]"]
  node_errors["Error handling<br/>[errorHandler.js]"]
end

subgraph group_domain["User domain"]
  node_service["User service<br/>[userService.js]"]
  node_validator["Payload validation<br/>[userValidator.js]"]
  node_apperror["Application errors<br/>[AppError.js]"]
end

subgraph group_persistence["Persistence"]
  node_repository["User repository"]
  node_json[("Users JSON file")]
end

node_user(("User"))
node_bcrypt["BCrypt library"]

node_user -->|"uses dashboard"| node_ui
node_ui -->|"calls users API"| node_routes
node_server -->|"loads settings"| node_config
node_server -->|"starts app"| node_app
node_app -->|"initializes"| node_repository
node_app -->|"mounts routes"| node_routes
node_app -->|"registers handlers"| node_errors
node_app -->|"serves static UI"| node_ui
node_routes -->|"dispatches requests"| node_service
node_service -->|"validates payload"| node_validator
node_service -->|"reads and writes"| node_repository
node_service -->|"hashes passwords"| node_bcrypt
node_repository -->|"reads and writes"| node_json
node_validator -->|"raises validation errors"| node_apperror
node_service -->|"raises domain errors"| node_apperror
node_errors -->|"formats errors"| node_apperror

click node_ui "https://github.com/legooh/devpool/blob/main/public/app.js"
click node_server "https://github.com/legooh/devpool/blob/main/src/server.js"
click node_config "https://github.com/legooh/devpool/blob/main/src/config.js"
click node_app "https://github.com/legooh/devpool/blob/main/src/app.js"
click node_routes "https://github.com/legooh/devpool/blob/main/src/routes/userRoutes.js"
click node_errors "https://github.com/legooh/devpool/blob/main/src/middleware/errorHandler.js"
click node_service "https://github.com/legooh/devpool/blob/main/src/services/userService.js"
click node_validator "https://github.com/legooh/devpool/blob/main/src/validators/userValidator.js"
click node_apperror "https://github.com/legooh/devpool/blob/main/src/errors/AppError.js"
click node_repository "https://github.com/legooh/devpool/blob/main/src/repositories/fileUserRepository.js"
click node_json "https://github.com/legooh/devpool/tree/main/data"

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_ui,node_user toneBlue
class node_server,node_config,node_app,node_routes,node_errors toneAmber
class node_service,node_validator,node_apperror toneMint
class node_repository,node_json toneRose
class node_bcrypt toneIndigo
```

## Components

### Browser interface

- [User dashboard](https://github.com/legooh/devpool/blob/main/public/app.js): `public/app.js`

### REST API

- [Server startup](https://github.com/legooh/devpool/blob/main/src/server.js): `src/server.js`
- [Runtime config](https://github.com/legooh/devpool/blob/main/src/config.js): `src/config.js`
- [Express app](https://github.com/legooh/devpool/blob/main/src/app.js): `src/app.js`
- [User routes](https://github.com/legooh/devpool/blob/main/src/routes/userRoutes.js): `src/routes/userRoutes.js`
- [Error handling](https://github.com/legooh/devpool/blob/main/src/middleware/errorHandler.js): `src/middleware/errorHandler.js`

### User domain

- [User service](https://github.com/legooh/devpool/blob/main/src/services/userService.js): `src/services/userService.js`
- [Payload validation](https://github.com/legooh/devpool/blob/main/src/validators/userValidator.js): `src/validators/userValidator.js`
- [Application errors](https://github.com/legooh/devpool/blob/main/src/errors/AppError.js): `src/errors/AppError.js`

### Persistence

- [User repository](https://github.com/legooh/devpool/blob/main/src/repositories/fileUserRepository.js): `src/repositories/fileUserRepository.js`
- [Users JSON file](https://github.com/legooh/devpool/tree/main/data): `data`

### Other components

- **User**
- **BCrypt library**

## Connections

- User → User dashboard: uses dashboard (evidence: `README.md`)
- User dashboard → User routes: calls users API (evidence: `public/app.js`)
- Server startup → Runtime config: loads settings (evidence: `src/server.js`)
- Server startup → Express app: starts app (evidence: `src/server.js`)
- Express app → User repository: initializes (evidence: `src/app.js`)
- Express app → User routes: mounts routes (evidence: `src/app.js`)
- Express app → Error handling: registers handlers (evidence: `src/app.js`)
- Express app → User dashboard: serves static UI (evidence: `src/app.js`)
- User routes → User service: dispatches requests (evidence: `src/routes/userRoutes.js`)
- User service → Payload validation: validates payload (evidence: `src/services/userService.js`)
- User service → User repository: reads and writes (evidence: `src/services/userService.js`)
- User service → BCrypt library: hashes passwords (evidence: `README.md`)
- User repository → Users JSON file: reads and writes (evidence: `README.md`)
- Payload validation → Application errors: raises validation errors (evidence: `src/validators/userValidator.js`)
- User service → Application errors: raises domain errors (evidence: `src/services/userService.js`)
- Error handling → Application errors: formats errors (evidence: `src/middleware/errorHandler.js`)
