# donathaniel/donathia architecture

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

## Overview

DoNathIA is an early-stage REST API for managing client credentials, with request authentication, audit tracking, and standardized responses. The shown workflow is an HTTP request entering the server, passing through app middleware and client routing, reaching a controller and service, and reading or writing MySQL. The README also describes local AI text services, but no AI implementation or routes appear in the supplied tree, so that capability is shown as documented but unverified. Relationships reflect the excerpts and README; unsampled code was not inspected.

Main entry points: [`src/app.js`](https://github.com/donathaniel/donathia/blob/main/src/app.js) (Express app), [`src/utils/responses.util.js`](https://github.com/donathaniel/donathia/blob/main/src/utils/responses.util.js) (Response helpers), [`src/config/database.js`](https://github.com/donathaniel/donathia/blob/main/src/config/database.js) (MySQL pool), [`src/controllers/clients.controller.js`](https://github.com/donathaniel/donathia/blob/main/src/controllers/clients.controller.js) (Client controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_server["HTTP server<br/>[server.js]"]
  node_app["Express app<br/>[app.js]"]
  node_admin["Admin-key check"]
  node_responses["Response helpers<br/>[responses.util.js]"]
end

subgraph group_clients["Client Management"]
  node_routes["Client routes<br/>[clients.routes.js]"]
  node_controller["Client controller"]
  node_service["Client service"]
end

subgraph group_audit["Persistence and Audit"]
  node_request_audit["Request audit middleware"]
  node_logger["HTTP logger<br/>[log.util.js]"]
  node_db_config["MySQL pool<br/>[database.js]"]
  node_mysql[("MySQL database")]
end

node_caller(("API caller"))
node_ai_services["Local AI services"]

node_caller -->|"sends request"| node_server
node_server -->|"starts"| node_app
node_app -->|"installs middleware"| node_request_audit
node_app -->|"guards clients"| node_admin
node_app -->|"mounts routes"| node_routes
node_app -->|"health response"| node_responses
node_routes -->|"dispatches"| node_controller
node_controller -->|"calls"| node_service
node_controller -->|"formats response"| node_responses
node_admin -->|"rejects access"| node_responses
node_request_audit -->|"records request"| node_db_config
node_request_audit -->|"logs request"| node_logger
node_responses -->|"updates audit"| node_db_config
node_responses -->|"logs response"| node_logger
node_service -->|"queries clients"| node_db_config
node_db_config -->|"connects"| node_mysql
node_app -.->|"documented capability"| node_ai_services

click node_server "https://github.com/donathaniel/donathia/blob/main/src/server.js"
click node_app "https://github.com/donathaniel/donathia/blob/main/src/app.js"
click node_admin "https://github.com/donathaniel/donathia/blob/main/src/middlewares/adminKey.middleware.js"
click node_request_audit "https://github.com/donathaniel/donathia/blob/main/src/middlewares/requests.middleware.js"
click node_routes "https://github.com/donathaniel/donathia/blob/main/src/routes/clients.routes.js"
click node_controller "https://github.com/donathaniel/donathia/blob/main/src/controllers/clients.controller.js"
click node_service "https://github.com/donathaniel/donathia/blob/main/src/services/clients.services.js"
click node_responses "https://github.com/donathaniel/donathia/blob/main/src/utils/responses.util.js"
click node_logger "https://github.com/donathaniel/donathia/blob/main/src/utils/log.util.js"
click node_db_config "https://github.com/donathaniel/donathia/blob/main/src/config/database.js"
click node_ai_services "https://github.com/donathaniel/donathia/tree/main/src/services"

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_app,node_admin,node_responses toneBlue
class node_routes,node_controller,node_service toneAmber
class node_request_audit,node_logger,node_db_config,node_mysql,node_caller toneMint
class node_ai_services toneTeal
```

## Components

### HTTP API

- [HTTP server](https://github.com/donathaniel/donathia/blob/main/src/server.js): `src/server.js`
- [Express app](https://github.com/donathaniel/donathia/blob/main/src/app.js): `src/app.js`
- [Admin-key check](https://github.com/donathaniel/donathia/blob/main/src/middlewares/adminKey.middleware.js): `src/middlewares/adminKey.middleware.js`
- [Response helpers](https://github.com/donathaniel/donathia/blob/main/src/utils/responses.util.js): `src/utils/responses.util.js`

### Client Management

- [Client routes](https://github.com/donathaniel/donathia/blob/main/src/routes/clients.routes.js): `src/routes/clients.routes.js`
- [Client controller](https://github.com/donathaniel/donathia/blob/main/src/controllers/clients.controller.js): `src/controllers/clients.controller.js`
- [Client service](https://github.com/donathaniel/donathia/blob/main/src/services/clients.services.js): `src/services/clients.services.js`

### Persistence and Audit

- [Request audit middleware](https://github.com/donathaniel/donathia/blob/main/src/middlewares/requests.middleware.js): `src/middlewares/requests.middleware.js`
- [HTTP logger](https://github.com/donathaniel/donathia/blob/main/src/utils/log.util.js): `src/utils/log.util.js`
- [MySQL pool](https://github.com/donathaniel/donathia/blob/main/src/config/database.js): `src/config/database.js`
- **MySQL database**

### Other components

- **API caller**
- [Local AI services](https://github.com/donathaniel/donathia/tree/main/src/services): `src/services`

## Connections

- API caller → HTTP server: sends request (evidence: `README.md`)
- HTTP server → Express app: starts (evidence: `src/server.js`)
- Express app → Request audit middleware: installs middleware (evidence: `src/app.js`)
- Express app → Admin-key check: guards clients (evidence: `src/app.js`)
- Express app → Client routes: mounts routes (evidence: `src/app.js`)
- Express app → Response helpers: health response (evidence: `src/app.js`)
- Client routes → Client controller: dispatches (evidence: `src/routes/clients.routes.js`)
- Client controller → Client service: calls (evidence: `src/controllers/clients.controller.js`)
- Client controller → Response helpers: formats response (evidence: `src/controllers/clients.controller.js`)
- Admin-key check → Response helpers: rejects access (evidence: `src/middlewares/adminKey.middleware.js`)
- Request audit middleware → MySQL pool: records request (evidence: `src/middlewares/requests.middleware.js`)
- Request audit middleware → HTTP logger: logs request (evidence: `src/middlewares/requests.middleware.js`)
- Response helpers → MySQL pool: updates audit (evidence: `src/utils/responses.util.js`)
- Response helpers → HTTP logger: logs response (evidence: `src/utils/responses.util.js`)
- Client service → MySQL pool: queries clients (evidence: `src/services/clients.services.js`)
- MySQL pool → MySQL database: connects (evidence: `src/config/database.js`)
- Express app → Local AI services: documented capability (evidence: `README.md`)
