# putraa888263/nexdeploy architecture

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

- Interactive diagram: https://gitdiagram.com/putraa888263/nexdeploy
- Repository: https://github.com/putraa888263/nexdeploy

## Overview

NEXDEPLOY is a VPS project-deployment panel. The intended workflow is an administrator creates a project, uploads an archive, and dispatches deployment work to an executor; the panel also exposes environment, status, logs, rollback, backup, activity, user, and settings management. The README says several VPS integrations are not yet connected to production. Relationships below follow visible calls and indexed imports; unsampled route internals and UI-to-API wiring are not inferred.

Main entry points: [`db/bootstrap.ts`](https://github.com/putraa888263/nexdeploy/blob/main/db/bootstrap.ts) (Database bootstrap), [`app/api/_lib/auth.ts`](https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/auth.ts) (Session and authorization), [`app/api/_lib/deployment.ts`](https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/deployment.ts) (Deployment orchestration), [`app/api/projects/[id]/upload/route.ts`](https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/upload/route.ts) (ZIP upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_panel["Panel"]
  node_dashboard["Management UI<br/>[page.tsx]"]
end

subgraph group_identity["Identity and administration"]
  node_auth["Session and authorization<br/>[auth.ts]"]
  node_login_api["Login and session routes<br/>[route.ts]"]
  node_setup_api["Initial administrator setup<br/>[route.ts]"]
  node_users_api["User administration<br/>[route.ts]"]
  node_settings_api["Panel settings<br/>[route.ts]"]
  node_activity_api["Activity feed<br/>[route.ts]"]
end

subgraph group_projects["Project operations"]
  node_project_api["Project management<br/>[route.ts]"]
  node_upload_api["ZIP upload<br/>[route.ts]"]
  node_environment_api["Environment settings<br/>[route.ts]"]
  node_environment_lib["Secret handling<br/>[environment.ts]"]
  node_resources_api["Project resources<br/>[route.ts]"]
  node_status_api["Project status<br/>[route.ts]"]
  node_rollback_api["Rollback<br/>[route.ts]"]
  node_backup_api["Backup management<br/>[route.ts]"]
  node_restore_api["Backup restore<br/>[route.ts]"]
end

subgraph group_deployment["Deployment runtime"]
  node_nexa_api["Nexa service API<br/>[route.ts]"]
  node_deployment_lib["Deployment orchestration<br/>[deployment.ts]"]
  node_deployment_routes["Deployment logs and retry<br/>[route.ts]"]
  node_executor_api["Executor configuration<br/>[route.ts]"]
  node_executor["Deployment executor<br/>[index.mjs]"]
  node_zip_lib["Archive validation<br/>[zip.ts]"]
end

subgraph group_persistence["Persistence"]
  node_database_init["Database bootstrap<br/>[bootstrap.ts]"]
  node_schema[("Data schema<br/>[schema.ts]")]
  node_project_storage[("Project and deployment data<br/>[bootstrap.ts]")]
end

node_operator(("Panel user"))

node_operator -->|"uses"| node_dashboard
node_project_api -->|"authorizes"| node_auth
node_project_api -->|"reads and writes"| node_database_init
node_upload_api -->|"authorizes"| node_auth
node_upload_api -->|"validates archive"| node_zip_lib
node_upload_api -->|"stores metadata"| node_database_init
node_environment_api -->|"authorizes"| node_auth
node_environment_api -->|"encrypts values"| node_environment_lib
node_environment_api -->|"reads and writes"| node_database_init
node_resources_api -->|"authorizes"| node_auth
node_resources_api -->|"reads and writes"| node_database_init
node_status_api -->|"authorizes"| node_auth
node_status_api -->|"reads and writes"| node_database_init
node_rollback_api -->|"authorizes"| node_auth
node_rollback_api -->|"reads and writes"| node_database_init
node_backup_api -->|"authorizes"| node_auth
node_backup_api -->|"reads and writes"| node_database_init
node_restore_api -->|"authorizes"| node_auth
node_restore_api -->|"reads and writes"| node_database_init
node_login_api -->|"calls"| node_auth
node_setup_api -->|"creates credentials"| node_auth
node_setup_api -->|"initializes storage"| node_database_init
node_users_api -->|"authorizes"| node_auth
node_users_api -->|"reads and writes"| node_database_init
node_settings_api -->|"authorizes"| node_auth
node_settings_api -->|"reads and writes"| node_database_init
node_activity_api -->|"authorizes"| node_auth
node_activity_api -->|"queries activity"| node_database_init
node_nexa_api -->|"dispatches deployment"| node_deployment_lib
node_nexa_api -->|"reads and writes"| node_database_init
node_deployment_routes -->|"authorizes"| node_auth
node_deployment_routes -->|"uses deployment data"| node_deployment_lib
node_executor_api -->|"authorizes"| node_auth
node_executor_api -->|"decrypts token"| node_environment_lib
node_deployment_lib -->|"decrypts secrets"| node_environment_lib
node_deployment_lib -->|"dispatches jobs"| node_executor
node_deployment_lib -->|"records deployment"| node_database_init
node_database_init -.->|"schema available"| node_schema

click node_dashboard "https://github.com/putraa888263/nexdeploy/blob/main/app/page.tsx"
click node_project_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/route.ts"
click node_upload_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/upload/route.ts"
click node_environment_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/environment/route.ts"
click node_environment_lib "https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/environment.ts"
click node_resources_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/resources/route.ts"
click node_status_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/status/route.ts"
click node_rollback_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/rollback/route.ts"
click node_backup_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/backups/route.ts"
click node_restore_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/backups/%5Bid%5D/restore/route.ts"
click node_auth "https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/auth.ts"
click node_login_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/auth/login/route.ts"
click node_setup_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/setup/route.ts"
click node_users_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/users/route.ts"
click node_settings_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/settings/route.ts"
click node_activity_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/activity/route.ts"
click node_nexa_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/nexa/v1/route.ts"
click node_deployment_lib "https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/deployment.ts"
click node_deployment_routes "https://github.com/putraa888263/nexdeploy/blob/main/app/api/deployments/%5Bid%5D/logs/route.ts"
click node_executor_api "https://github.com/putraa888263/nexdeploy/blob/main/app/api/executor/route.ts"
click node_executor "https://github.com/putraa888263/nexdeploy/blob/main/executor/src/index.mjs"
click node_zip_lib "https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/zip.ts"
click node_database_init "https://github.com/putraa888263/nexdeploy/blob/main/db/bootstrap.ts"
click node_schema "https://github.com/putraa888263/nexdeploy/blob/main/db/schema.ts"
click node_project_storage "https://github.com/putraa888263/nexdeploy/blob/main/db/bootstrap.ts"

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_dashboard,node_operator toneBlue
class node_auth,node_login_api,node_setup_api,node_users_api,node_settings_api,node_activity_api toneAmber
class node_project_api,node_upload_api,node_environment_api,node_environment_lib,node_resources_api,node_status_api,node_rollback_api,node_backup_api,node_restore_api toneMint
class node_nexa_api,node_deployment_lib,node_deployment_routes,node_executor_api,node_executor,node_zip_lib toneRose
class node_database_init,node_schema,node_project_storage toneIndigo
```

## Components

### Panel

- [Management UI](https://github.com/putraa888263/nexdeploy/blob/main/app/page.tsx): `app/page.tsx`

### Identity and administration

- [Session and authorization](https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/auth.ts): `app/api/_lib/auth.ts`
- [Login and session routes](https://github.com/putraa888263/nexdeploy/blob/main/app/api/auth/login/route.ts): `app/api/auth/login/route.ts`
- [Initial administrator setup](https://github.com/putraa888263/nexdeploy/blob/main/app/api/setup/route.ts): `app/api/setup/route.ts`
- [User administration](https://github.com/putraa888263/nexdeploy/blob/main/app/api/users/route.ts): `app/api/users/route.ts`
- [Panel settings](https://github.com/putraa888263/nexdeploy/blob/main/app/api/settings/route.ts): `app/api/settings/route.ts`
- [Activity feed](https://github.com/putraa888263/nexdeploy/blob/main/app/api/activity/route.ts): `app/api/activity/route.ts`

### Project operations

- [Project management](https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/route.ts): `app/api/projects/route.ts`
- [ZIP upload](https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/upload/route.ts): `app/api/projects/[id]/upload/route.ts`
- [Environment settings](https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/environment/route.ts): `app/api/projects/[id]/environment/route.ts`
- [Secret handling](https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/environment.ts): `app/api/_lib/environment.ts`
- [Project resources](https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/resources/route.ts): `app/api/projects/[id]/resources/route.ts`
- [Project status](https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/status/route.ts): `app/api/projects/[id]/status/route.ts`
- [Rollback](https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/rollback/route.ts): `app/api/projects/[id]/rollback/route.ts`
- [Backup management](https://github.com/putraa888263/nexdeploy/blob/main/app/api/projects/%5Bid%5D/backups/route.ts): `app/api/projects/[id]/backups/route.ts`
- [Backup restore](https://github.com/putraa888263/nexdeploy/blob/main/app/api/backups/%5Bid%5D/restore/route.ts): `app/api/backups/[id]/restore/route.ts`

### Deployment runtime

- [Nexa service API](https://github.com/putraa888263/nexdeploy/blob/main/app/api/nexa/v1/route.ts): `app/api/nexa/v1/route.ts`
- [Deployment orchestration](https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/deployment.ts): `app/api/_lib/deployment.ts`
- [Deployment logs and retry](https://github.com/putraa888263/nexdeploy/blob/main/app/api/deployments/%5Bid%5D/logs/route.ts): `app/api/deployments/[id]/logs/route.ts`
- [Executor configuration](https://github.com/putraa888263/nexdeploy/blob/main/app/api/executor/route.ts): `app/api/executor/route.ts`
- [Deployment executor](https://github.com/putraa888263/nexdeploy/blob/main/executor/src/index.mjs): `executor/src/index.mjs`
- [Archive validation](https://github.com/putraa888263/nexdeploy/blob/main/app/api/_lib/zip.ts): `app/api/_lib/zip.ts`

### Persistence

- [Database bootstrap](https://github.com/putraa888263/nexdeploy/blob/main/db/bootstrap.ts): `db/bootstrap.ts`
- [Data schema](https://github.com/putraa888263/nexdeploy/blob/main/db/schema.ts): `db/schema.ts`
- [Project and deployment data](https://github.com/putraa888263/nexdeploy/blob/main/db/bootstrap.ts): `db/bootstrap.ts`

### Other components

- **Panel user**

## Connections

- Panel user → Management UI: uses (evidence: `README.md`)
- Project management → Session and authorization: authorizes (evidence: `app/api/projects/route.ts`)
- Project management → Database bootstrap: reads and writes (evidence: `app/api/projects/route.ts`)
- ZIP upload → Session and authorization: authorizes (evidence: `app/api/projects/[id]/upload/route.ts`)
- ZIP upload → Archive validation: validates archive (evidence: `app/api/projects/[id]/upload/route.ts`)
- ZIP upload → Database bootstrap: stores metadata (evidence: `app/api/projects/[id]/upload/route.ts`)
- Environment settings → Session and authorization: authorizes (evidence: `app/api/projects/[id]/environment/route.ts`)
- Environment settings → Secret handling: encrypts values (evidence: `app/api/projects/[id]/environment/route.ts`)
- Environment settings → Database bootstrap: reads and writes (evidence: `app/api/projects/[id]/environment/route.ts`)
- Project resources → Session and authorization: authorizes (evidence: `app/api/projects/[id]/resources/route.ts`)
- Project resources → Database bootstrap: reads and writes (evidence: `app/api/projects/[id]/resources/route.ts`)
- Project status → Session and authorization: authorizes (evidence: `app/api/projects/[id]/status/route.ts`)
- Project status → Database bootstrap: reads and writes (evidence: `app/api/projects/[id]/status/route.ts`)
- Rollback → Session and authorization: authorizes (evidence: `app/api/projects/[id]/rollback/route.ts`)
- Rollback → Database bootstrap: reads and writes (evidence: `app/api/projects/[id]/rollback/route.ts`)
- Backup management → Session and authorization: authorizes (evidence: `app/api/projects/[id]/backups/route.ts`)
- Backup management → Database bootstrap: reads and writes (evidence: `app/api/projects/[id]/backups/route.ts`)
- Backup restore → Session and authorization: authorizes (evidence: `app/api/backups/[id]/restore/route.ts`)
- Backup restore → Database bootstrap: reads and writes (evidence: `app/api/backups/[id]/restore/route.ts`)
- Login and session routes → Session and authorization: calls (evidence: `app/api/auth/login/route.ts`)
- Initial administrator setup → Session and authorization: creates credentials (evidence: `app/api/setup/route.ts`)
- Initial administrator setup → Database bootstrap: initializes storage (evidence: `app/api/setup/route.ts`)
- User administration → Session and authorization: authorizes (evidence: `app/api/users/route.ts`)
- User administration → Database bootstrap: reads and writes (evidence: `app/api/users/route.ts`)
- Panel settings → Session and authorization: authorizes (evidence: `app/api/settings/route.ts`)
- Panel settings → Database bootstrap: reads and writes (evidence: `app/api/settings/route.ts`)
- Activity feed → Session and authorization: authorizes (evidence: `app/api/activity/route.ts`)
- Activity feed → Database bootstrap: queries activity (evidence: `app/api/activity/route.ts`)
- Nexa service API → Deployment orchestration: dispatches deployment (evidence: `app/api/nexa/v1/route.ts`)
- Nexa service API → Database bootstrap: reads and writes (evidence: `app/api/nexa/v1/route.ts`)
- Deployment logs and retry → Session and authorization: authorizes (evidence: `app/api/deployments/[id]/logs/route.ts`)
- Deployment logs and retry → Deployment orchestration: uses deployment data (evidence: `app/api/deployments/[id]/logs/route.ts`)
- Executor configuration → Session and authorization: authorizes (evidence: `app/api/executor/route.ts`)
- Executor configuration → Secret handling: decrypts token (evidence: `app/api/executor/route.ts`)
- Deployment orchestration → Secret handling: decrypts secrets (evidence: `app/api/_lib/deployment.ts`)
- Deployment orchestration → Deployment executor: dispatches jobs (evidence: `app/api/_lib/deployment.ts`)
- Deployment orchestration → Database bootstrap: records deployment (evidence: `app/api/_lib/deployment.ts`)
- Database bootstrap → Data schema: schema available
