epress node Architecture

epress node composes command entrypoints, a Fastify-based server, GraphQL and REST transport, and persistence models.

Request Lifecycle

Every request flows through a consistent pipeline from HTTP to response.

Request Path (Yellow)

Incoming requests are routed, authenticated, processed by business logic, and persisted via models.

Response Path (Blue)

Data flows back through serialization and response preparation before returning to the client.

Commands

Server Boot

GraphQL

REST Routes

Persistence Models

Client App

JWT and request context are attached in server preHandler hooks.
GraphQL routes are mounted under /api/graphql via GraphQL plugin prefix /api.
EWP endpoints are mounted under /ewp and perform their own installation and trust checks.
App operational endpoints are mounted under /api and support installation and node operation workflows.

Directory	Purpose
/commands	CLI entrypoints (start, migrate, sync)
/server	Fastify server, routes, GraphQL, models
/client	Next.js frontend application
/data	Runtime data (database, uploads, logs)
/test	Test files and fixtures