# kronnok/netmo architecture

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

## Overview

NetMO is a web system for managing notebook reservations, loans, inventory, and maintenance. Users interact through a static browser frontend and an HTTP API; the API authenticates accounts, applies domain operations, and persists data in PostgreSQL. Administrative workflows include registration review, loan and reservation management, ticket handling, and backup/restore; email supports registration and account recovery. The README documents the main capabilities, while sampled backend excerpts establish several service calls. Some frontend-to-endpoint and routing details are not shown, so those links are omitted or marked unverified.

Main entry points: [`backend/data/database.js`](https://github.com/kronnok/netmo/blob/main/backend/data/database.js) (Database access), [`backend/controllers/api-controller.js`](https://github.com/kronnok/netmo/blob/main/backend/controllers/api-controller.js) (API controller), [`backend/services/auth-service.js`](https://github.com/kronnok/netmo/blob/main/backend/services/auth-service.js) (Authentication), [`backend/services/registration-service.js`](https://github.com/kronnok/netmo/blob/main/backend/services/registration-service.js) (Registration review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interface"]
  node_frontend["Web frontend<br/>[app.js]"]
end

subgraph group_api["API and accounts"]
  node_server["HTTP server<br/>[server.js]"]
  node_routes["API routes<br/>[routes.js]"]
  node_controller["API controller<br/>[api-controller.js]"]
  node_auth["Authentication<br/>[auth-service.js]"]
  node_registration["Registration review"]
  node_password["Password recovery"]
  node_validation["Input validation<br/>[validation.js]"]
  node_sessions["Session tokens<br/>[session-token.js]"]
  node_rate["Attempt limiting"]
end

subgraph group_operations["Loan operations"]
  node_reservations["Reservations<br/>[api-service.js]"]
  node_loans["Loans and inventory<br/>[api-service.js]"]
  node_tickets["Maintenance tickets<br/>[api-service.js]"]
  node_administration["User administration<br/>[api-service.js]"]
  node_business_time["Business scheduling<br/>[business-time.js]"]
  node_backup["Backup and restore<br/>[backup-service.js]"]
end

subgraph group_platform["Persistence and integrations"]
  node_database_access["Database access<br/>[database.js]"]
  node_postgres[("PostgreSQL")]
  node_mail["Mail delivery<br/>[mail-service.js]"]
  node_mail_provider["Mail provider"]
end

node_user(("School user"))

node_user -->|"uses"| node_frontend
node_frontend -->|"calls API"| node_server
node_server -.->|"routes requests"| node_routes
node_server -.->|"dispatches"| node_controller
node_controller -->|"authenticates"| node_auth
node_controller -->|"registers accounts"| node_registration
node_controller -->|"handles recovery"| node_password
node_controller -->|"dispatches actions"| node_reservations
node_controller -->|"handles backups"| node_backup
node_auth -->|"queries"| node_database_access
node_auth -->|"verifies tokens"| node_sessions
node_auth -->|"limits attempts"| node_rate
node_auth -->|"validates email"| node_validation
node_registration -->|"stores requests"| node_database_access
node_registration -->|"validates fields"| node_validation
node_registration -->|"sends notices"| node_mail
node_registration -->|"limits requests"| node_rate
node_reservations -->|"queries"| node_database_access
node_reservations -->|"checks schedule"| node_business_time
node_loans -->|"queries"| node_database_access
node_tickets -->|"updates tickets"| node_database_access
node_administration -->|"manages accounts"| node_database_access
node_backup -->|"reads and restores"| node_database_access
node_database_access -->|"queries"| node_postgres
node_mail -->|"sends email"| node_mail_provider

click node_frontend "https://github.com/kronnok/netmo/blob/main/frontend/app.js"
click node_server "https://github.com/kronnok/netmo/blob/main/backend/server.js"
click node_routes "https://github.com/kronnok/netmo/blob/main/backend/routes.js"
click node_controller "https://github.com/kronnok/netmo/blob/main/backend/controllers/api-controller.js"
click node_auth "https://github.com/kronnok/netmo/blob/main/backend/services/auth-service.js"
click node_registration "https://github.com/kronnok/netmo/blob/main/backend/services/registration-service.js"
click node_password "https://github.com/kronnok/netmo/blob/main/backend/services/password-reset-service.js"
click node_validation "https://github.com/kronnok/netmo/blob/main/backend/services/validation.js"
click node_sessions "https://github.com/kronnok/netmo/blob/main/backend/services/session-token.js"
click node_rate "https://github.com/kronnok/netmo/blob/main/backend/services/login-rate-limiter.js"
click node_reservations "https://github.com/kronnok/netmo/blob/main/backend/services/api-service.js"
click node_loans "https://github.com/kronnok/netmo/blob/main/backend/services/api-service.js"
click node_tickets "https://github.com/kronnok/netmo/blob/main/backend/services/api-service.js"
click node_administration "https://github.com/kronnok/netmo/blob/main/backend/services/api-service.js"
click node_business_time "https://github.com/kronnok/netmo/blob/main/backend/services/business-time.js"
click node_backup "https://github.com/kronnok/netmo/blob/main/backend/services/backup-service.js"
click node_database_access "https://github.com/kronnok/netmo/blob/main/backend/data/database.js"
click node_mail "https://github.com/kronnok/netmo/blob/main/backend/services/mail-service.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_frontend,node_user toneBlue
class node_server,node_routes,node_controller,node_auth,node_registration,node_password,node_validation,node_sessions,node_rate toneAmber
class node_reservations,node_loans,node_tickets,node_administration,node_business_time,node_backup toneMint
class node_database_access,node_postgres,node_mail,node_mail_provider toneRose
```

## Components

### User interface

- [Web frontend](https://github.com/kronnok/netmo/blob/main/frontend/app.js): `frontend/app.js`

### API and accounts

- [HTTP server](https://github.com/kronnok/netmo/blob/main/backend/server.js): `backend/server.js`
- [API routes](https://github.com/kronnok/netmo/blob/main/backend/routes.js): `backend/routes.js`
- [API controller](https://github.com/kronnok/netmo/blob/main/backend/controllers/api-controller.js): `backend/controllers/api-controller.js`
- [Authentication](https://github.com/kronnok/netmo/blob/main/backend/services/auth-service.js): `backend/services/auth-service.js`
- [Registration review](https://github.com/kronnok/netmo/blob/main/backend/services/registration-service.js): `backend/services/registration-service.js`
- [Password recovery](https://github.com/kronnok/netmo/blob/main/backend/services/password-reset-service.js): `backend/services/password-reset-service.js`
- [Input validation](https://github.com/kronnok/netmo/blob/main/backend/services/validation.js): `backend/services/validation.js`
- [Session tokens](https://github.com/kronnok/netmo/blob/main/backend/services/session-token.js): `backend/services/session-token.js`
- [Attempt limiting](https://github.com/kronnok/netmo/blob/main/backend/services/login-rate-limiter.js): `backend/services/login-rate-limiter.js`

### Loan operations

- [Reservations](https://github.com/kronnok/netmo/blob/main/backend/services/api-service.js): `backend/services/api-service.js`
- [Loans and inventory](https://github.com/kronnok/netmo/blob/main/backend/services/api-service.js): `backend/services/api-service.js`
- [Maintenance tickets](https://github.com/kronnok/netmo/blob/main/backend/services/api-service.js): `backend/services/api-service.js`
- [User administration](https://github.com/kronnok/netmo/blob/main/backend/services/api-service.js): `backend/services/api-service.js`
- [Business scheduling](https://github.com/kronnok/netmo/blob/main/backend/services/business-time.js): `backend/services/business-time.js`
- [Backup and restore](https://github.com/kronnok/netmo/blob/main/backend/services/backup-service.js): `backend/services/backup-service.js`

### Persistence and integrations

- [Database access](https://github.com/kronnok/netmo/blob/main/backend/data/database.js): `backend/data/database.js`
- **PostgreSQL**
- [Mail delivery](https://github.com/kronnok/netmo/blob/main/backend/services/mail-service.js): `backend/services/mail-service.js`
- **Mail provider**

### Other components

- **School user**

## Connections

- School user → Web frontend: uses (evidence: `README.md`)
- Web frontend → HTTP server: calls API (evidence: `README.md`)
- HTTP server → API routes: routes requests (evidence: `backend/server.js`)
- HTTP server → API controller: dispatches (evidence: `backend/server.js`)
- API controller → Authentication: authenticates (evidence: `backend/controllers/api-controller.js`)
- API controller → Registration review: registers accounts (evidence: `backend/controllers/api-controller.js`)
- API controller → Password recovery: handles recovery (evidence: `backend/controllers/api-controller.js`)
- API controller → Reservations: dispatches actions (evidence: `backend/controllers/api-controller.js`)
- API controller → Backup and restore: handles backups (evidence: `backend/controllers/api-controller.js`)
- Authentication → Database access: queries (evidence: `backend/services/auth-service.js`)
- Authentication → Session tokens: verifies tokens (evidence: `backend/services/auth-service.js`)
- Authentication → Attempt limiting: limits attempts (evidence: `backend/services/auth-service.js`)
- Authentication → Input validation: validates email (evidence: `backend/services/auth-service.js`)
- Registration review → Database access: stores requests (evidence: `backend/services/registration-service.js`)
- Registration review → Input validation: validates fields (evidence: `backend/services/registration-service.js`)
- Registration review → Mail delivery: sends notices (evidence: `backend/services/registration-service.js`)
- Registration review → Attempt limiting: limits requests (evidence: `backend/services/registration-service.js`)
- Reservations → Database access: queries (evidence: `backend/services/api-service.js`)
- Reservations → Business scheduling: checks schedule (evidence: `backend/services/api-service.js`)
- Loans and inventory → Database access: queries (evidence: `backend/services/api-service.js`)
- Maintenance tickets → Database access: updates tickets (evidence: `backend/services/api-service.js`)
- User administration → Database access: manages accounts (evidence: `backend/services/api-service.js`)
- Backup and restore → Database access: reads and restores (evidence: `backend/services/backup-service.js`)
- Database access → PostgreSQL: queries (evidence: `backend/data/database.js`)
- Mail delivery → Mail provider: sends email (evidence: `backend/services/mail-service.js`)
