How putraa888263/nexdeploy works
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: bootstrap.ts Database bootstrap · auth.ts Session and authorization · deployment.ts Deployment orchestration · route.ts ZIP upload
Components 26
Panel
- Management UI
app/page.tsx
Identity and administration
- Session and authorization
app/api/_lib/auth.ts - Login and session routes
app/api/auth/login/route.ts - Initial administrator setup
app/api/setup/route.ts - User administration
app/api/users/route.ts - Panel settings
app/api/settings/route.ts - Activity feed
app/api/activity/route.ts
Project operations
- Project management
app/api/projects/route.ts - ZIP upload
app/api/projects/[id]/upload/route.ts - Environment settings
app/api/projects/[id]/environment/route.ts - Secret handling
app/api/_lib/environment.ts - Project resources
app/api/projects/[id]/resources/route.ts - Project status
app/api/projects/[id]/status/route.ts - Rollback
app/api/projects/[id]/rollback/route.ts - Backup management
app/api/projects/[id]/backups/route.ts - Backup restore
app/api/backups/[id]/restore/route.ts
Deployment runtime
- Nexa service API
app/api/nexa/v1/route.ts - Deployment orchestration
app/api/_lib/deployment.ts - Deployment logs and retry
app/api/deployments/[id]/logs/route.ts - Executor configuration
app/api/executor/route.ts - Deployment executor
executor/src/index.mjs - Archive validation
app/api/_lib/zip.ts
Persistence
- Database bootstrap
db/bootstrap.ts - Data schema
db/schema.ts - Project and deployment data
db/bootstrap.ts
Other components
- Panel user
Connections 38
- Panel user → Management UI: uses
README.md - Project management → Session and authorization: authorizes
app/api/projects/route.ts - Project management → Database bootstrap: reads and writes
app/api/projects/route.ts - ZIP upload → Session and authorization: authorizes
app/api/projects/[id]/upload/route.ts - ZIP upload → Archive validation: validates archive
app/api/projects/[id]/upload/route.ts - ZIP upload → Database bootstrap: stores metadata
app/api/projects/[id]/upload/route.ts - Environment settings → Session and authorization: authorizes
app/api/projects/[id]/environment/route.ts - Environment settings → Secret handling: encrypts values
app/api/projects/[id]/environment/route.ts - Environment settings → Database bootstrap: reads and writes
app/api/projects/[id]/environment/route.ts - Project resources → Session and authorization: authorizes
app/api/projects/[id]/resources/route.ts - Project resources → Database bootstrap: reads and writes
app/api/projects/[id]/resources/route.ts - Project status → Session and authorization: authorizes
app/api/projects/[id]/status/route.ts - Project status → Database bootstrap: reads and writes
app/api/projects/[id]/status/route.ts - Rollback → Session and authorization: authorizes
app/api/projects/[id]/rollback/route.ts - Rollback → Database bootstrap: reads and writes
app/api/projects/[id]/rollback/route.ts - Backup management → Session and authorization: authorizes
app/api/projects/[id]/backups/route.ts - Backup management → Database bootstrap: reads and writes
app/api/projects/[id]/backups/route.ts - Backup restore → Session and authorization: authorizes
app/api/backups/[id]/restore/route.ts - Backup restore → Database bootstrap: reads and writes
app/api/backups/[id]/restore/route.ts - Login and session routes → Session and authorization: calls
app/api/auth/login/route.ts - Initial administrator setup → Session and authorization: creates credentials
app/api/setup/route.ts - Initial administrator setup → Database bootstrap: initializes storage
app/api/setup/route.ts - User administration → Session and authorization: authorizes
app/api/users/route.ts - User administration → Database bootstrap: reads and writes
app/api/users/route.ts - Panel settings → Session and authorization: authorizes
app/api/settings/route.ts - Panel settings → Database bootstrap: reads and writes
app/api/settings/route.ts - Activity feed → Session and authorization: authorizes
app/api/activity/route.ts - Activity feed → Database bootstrap: queries activity
app/api/activity/route.ts - Nexa service API → Deployment orchestration: dispatches deployment
app/api/nexa/v1/route.ts - Nexa service API → Database bootstrap: reads and writes
app/api/nexa/v1/route.ts - Deployment logs and retry → Session and authorization: authorizes
app/api/deployments/[id]/logs/route.ts - Deployment logs and retry → Deployment orchestration: uses deployment data
app/api/deployments/[id]/logs/route.ts - Executor configuration → Session and authorization: authorizes
app/api/executor/route.ts - Executor configuration → Secret handling: decrypts token
app/api/executor/route.ts - Deployment orchestration → Secret handling: decrypts secrets
app/api/_lib/deployment.ts - Deployment orchestration → Deployment executor: dispatches jobs
app/api/_lib/deployment.ts - Deployment orchestration → Database bootstrap: records deployment
app/api/_lib/deployment.ts - Database bootstrap → Data schema: schema available