# nelit2714/hosting-api architecture

> Architecture diagram of the GitHub repository nelit2714/hosting-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nelit2714/hosting-api
- Repository: https://github.com/nelit2714/hosting-api

## Overview

This is a reactive Spring API for provisioning and managing VPS instances, with user authentication, node enrollment, catalog and administration endpoints, and payment-backed purchases and renewals. The principal workflow is a client checkout through a payment gateway; fulfillment creates or renews a VPS, after which users manage its lifecycle through the VM API. Sampled code confirms VM-controller delegation, payment fulfillment calls, node enrollment-token storage, and webhook dispatch. Other major capabilities are represented from the file tree; their internal wiring is not asserted where source was not shown.

Main entry points: [`src/main/java/dev/nelit/api/services/impl/vm/VmServiceImpl.java`](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/vm/VmServiceImpl.java) (VM service), [`src/main/java/dev/nelit/api/services/payment/PaymentFulfillmentHandler.java`](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/payment/PaymentFulfillmentHandler.java) (Payment fulfillment), [`src/main/java/dev/nelit/api/controllers/NodeController.java`](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/NodeController.java) (Node API), [`src/main/java/dev/nelit/api/services/impl/CheckoutServiceImpl.java`](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/CheckoutServiceImpl.java) (Checkout orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_auth["Auth API"]
  node_authsvc["Authentication"]
  node_nodeapi["Node API"]
  node_nodesvc["Node management"]
  node_enrollment["Enrollment tokens"]
  node_redis[("Redis")]
end

subgraph group_catalog["Platform catalog"]
  node_admin["Administration"]
  node_catalogapi["Plans and images"]
  node_promo["Promotions"]
end

subgraph group_billing["Payments and orders"]
  node_checkout["Checkout API"]
  node_checkoutsvc["Checkout orchestration"]
  node_payments["Payment processing"]
  node_gateway["Payment gateways"]
  node_webhooks["Payment webhooks"]
  node_fulfillment["Payment fulfillment"]
  node_vpsorders["VPS orders"]
end

subgraph group_compute["VPS operations"]
  node_vms["VM service<br/>[VmServiceImpl.java]"]
  node_vmapi["VM API<br/>[VMController.java]"]
  node_vmgrpc["VM manager client"]
  node_entities[("Domain persistence<br/>[Vm.java]")]
end

node_client(("API client"))
node_gatewayactor(("Payment providers"))

node_client -.->|"authenticates"| node_auth
node_auth -.->|"delegates"| node_authsvc
node_client -->|"enrolls node"| node_nodeapi
node_nodeapi -->|"delegates"| node_nodesvc
node_nodeapi -->|"issues tokens"| node_enrollment
node_enrollment -->|"stores tokens"| node_redis
node_client -.->|"administers"| node_admin
node_client -.->|"selects plans"| node_catalogapi
node_client -.->|"checks out"| node_checkout
node_checkout -.->|"delegates"| node_checkoutsvc
node_checkoutsvc -.->|"creates payment"| node_payments
node_checkoutsvc -.->|"records order"| node_vpsorders
node_payments -.->|"dispatches"| node_gateway
node_gateway -.->|"requests payment"| node_gatewayactor
node_gatewayactor -.->|"sends event"| node_webhooks
node_webhooks -->|"dispatches"| node_fulfillment
node_fulfillment -->|"loads order"| node_vpsorders
node_fulfillment -->|"creates VM"| node_vms
node_client -->|"manages VPS"| node_vmapi
node_vmapi -->|"delegates"| node_vms
node_vms -.->|"controls VM"| node_vmgrpc
node_vms -.->|"persists state"| node_entities
node_fulfillment -->|"renews VM"| node_vms
node_client -.->|"uses promotion"| node_promo

click node_auth "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/AuthController.java"
click node_authsvc "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/AuthServiceImpl.java"
click node_nodeapi "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/NodeController.java"
click node_nodesvc "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/NodeServiceImpl.java"
click node_enrollment "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/EnrollmentTokenServiceImpl.java"
click node_admin "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/AdminController.java"
click node_catalogapi "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/PlanController.java"
click node_promo "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/promo/PromoCodeServiceImpl.java"
click node_checkout "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/CheckoutController.java"
click node_checkoutsvc "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/CheckoutServiceImpl.java"
click node_payments "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/payment/PaymentServiceImpl.java"
click node_gateway "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/payment/stripe/StripeCheckoutServiceImpl.java"
click node_webhooks "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/webhooks/StripeWebhookController.java"
click node_fulfillment "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/payment/PaymentFulfillmentHandler.java"
click node_vpsorders "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/payment/order/vps/VpsOrderServiceImpl.java"
click node_vms "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/vm/VmServiceImpl.java"
click node_vmapi "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/VMController.java"
click node_vmgrpc "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/grpc/VmLifecycleGrpcClient.java"
click node_entities "https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/domain/entity/vm/Vm.java"

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_auth,node_authsvc,node_nodeapi,node_nodesvc,node_enrollment,node_redis,node_client toneBlue
class node_admin,node_catalogapi,node_promo toneAmber
class node_checkout,node_checkoutsvc,node_payments,node_gateway,node_webhooks,node_fulfillment,node_vpsorders toneMint
class node_vms,node_vmapi,node_vmgrpc,node_entities toneRose
class node_gatewayactor toneIndigo
```

## Components

### API and identity

- [Auth API](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/AuthController.java): `src/main/java/dev/nelit/api/controllers/AuthController.java`
- [Authentication](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/AuthServiceImpl.java): `src/main/java/dev/nelit/api/services/impl/AuthServiceImpl.java`
- [Node API](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/NodeController.java): `src/main/java/dev/nelit/api/controllers/NodeController.java`
- [Node management](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/NodeServiceImpl.java): `src/main/java/dev/nelit/api/services/impl/NodeServiceImpl.java`
- [Enrollment tokens](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/EnrollmentTokenServiceImpl.java): `src/main/java/dev/nelit/api/services/impl/EnrollmentTokenServiceImpl.java`
- **Redis**

### Platform catalog

- [Administration](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/AdminController.java): `src/main/java/dev/nelit/api/controllers/AdminController.java`
- [Plans and images](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/PlanController.java): `src/main/java/dev/nelit/api/controllers/PlanController.java`
- [Promotions](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/promo/PromoCodeServiceImpl.java): `src/main/java/dev/nelit/api/services/impl/promo/PromoCodeServiceImpl.java`

### Payments and orders

- [Checkout API](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/CheckoutController.java): `src/main/java/dev/nelit/api/controllers/CheckoutController.java`
- [Checkout orchestration](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/CheckoutServiceImpl.java): `src/main/java/dev/nelit/api/services/impl/CheckoutServiceImpl.java`
- [Payment processing](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/payment/PaymentServiceImpl.java): `src/main/java/dev/nelit/api/services/impl/payment/PaymentServiceImpl.java`
- [Payment gateways](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/payment/stripe/StripeCheckoutServiceImpl.java): `src/main/java/dev/nelit/api/services/impl/payment/stripe/StripeCheckoutServiceImpl.java`
- [Payment webhooks](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/webhooks/StripeWebhookController.java): `src/main/java/dev/nelit/api/controllers/webhooks/StripeWebhookController.java`
- [Payment fulfillment](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/payment/PaymentFulfillmentHandler.java): `src/main/java/dev/nelit/api/services/payment/PaymentFulfillmentHandler.java`
- [VPS orders](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/payment/order/vps/VpsOrderServiceImpl.java): `src/main/java/dev/nelit/api/services/impl/payment/order/vps/VpsOrderServiceImpl.java`

### VPS operations

- [VM service](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/services/impl/vm/VmServiceImpl.java): `src/main/java/dev/nelit/api/services/impl/vm/VmServiceImpl.java`
- [VM API](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/controllers/VMController.java): `src/main/java/dev/nelit/api/controllers/VMController.java`
- [VM manager client](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/grpc/VmLifecycleGrpcClient.java): `src/main/java/dev/nelit/api/grpc/VmLifecycleGrpcClient.java`
- [Domain persistence](https://github.com/nelit2714/hosting-api/blob/master/src/main/java/dev/nelit/api/domain/entity/vm/Vm.java): `src/main/java/dev/nelit/api/domain/entity/vm/Vm.java`

### Other components

- **API client**
- **Payment providers**

## Connections

- API client → Auth API: authenticates
- Auth API → Authentication: delegates
- API client → Node API: enrolls node (evidence: `src/main/java/dev/nelit/api/controllers/NodeController.java`)
- Node API → Node management: delegates (evidence: `src/main/java/dev/nelit/api/controllers/NodeController.java`)
- Node API → Enrollment tokens: issues tokens (evidence: `src/main/java/dev/nelit/api/controllers/NodeController.java`)
- Enrollment tokens → Redis: stores tokens (evidence: `src/main/java/dev/nelit/api/services/impl/EnrollmentTokenServiceImpl.java`)
- API client → Administration: administers
- API client → Plans and images: selects plans
- API client → Checkout API: checks out
- Checkout API → Checkout orchestration: delegates
- Checkout orchestration → Payment processing: creates payment
- Checkout orchestration → VPS orders: records order
- Payment processing → Payment gateways: dispatches
- Payment gateways → Payment providers: requests payment
- Payment providers → Payment webhooks: sends event
- Payment webhooks → Payment fulfillment: dispatches (evidence: `src/main/java/dev/nelit/api/controllers/webhooks/StripeWebhookController.java`)
- Payment fulfillment → VPS orders: loads order
- Payment fulfillment → VM service: creates VM
- API client → VM API: manages VPS (evidence: `src/main/java/dev/nelit/api/controllers/VMController.java`)
- VM API → VM service: delegates (evidence: `src/main/java/dev/nelit/api/controllers/VMController.java`)
- VM service → VM manager client: controls VM
- VM service → Domain persistence: persists state
- Payment fulfillment → VM service: renews VM
- API client → Promotions: uses promotion
