How r0073d-l053r/proxmate works
ProxMate is an invite-only, multi-tenant Proxmox cloud dashboard. Tenants redeem invites, authenticate, provision and manage isolated VMs or containers, then access them through browser consoles; admins configure the cluster and operate tenants, placement, backups, and monitoring. The graph follows the documented product capabilities and sampled route/service calls; several unsampled subsystems are represented only at their existing directory paths, so uncertain internal wiring is omitted.
Main entry points: (dashboard) Dashboard UI · admin.routes.ts Admin routes · proxmox.service.ts Proxmox adapter · auth.routes.ts Auth routes
Components 25
Tenant experience
- Dashboard UI
frontend/src/app/(dashboard) - Frontend API client
frontend/src/lib/api.ts
Identity and access
- Invites and quotas
backend/src/services/invite.service.ts - Auth routes
backend/src/routes/auth.routes.ts - Authentication
backend/src/services/auth.service.ts - MFA and SSO
backend/src/services - Access windows
backend/src/services/access.service.ts
Compute lifecycle
- VM routes
backend/src/routes/vm.routes.ts - VM lifecycle
backend/src/services/vm.service.ts - Templates and images
backend/src/services/template.service.ts - Placement scheduler
backend/src/services/scheduler.service.ts - Browser consoles
backend/src/routes/console.routes.ts - Browser IDE
backend/src/services/ide.service.ts - VM sharing
backend/src/services/vm-share.service.ts - MateStates backups
backend/src/services/matestate.service.ts
Cluster operations
- Proxmox adapter
backend/src/services/proxmox.service.ts - Cluster operations
backend/src/services/cluster-balancer.service.ts - Admin routes
backend/src/routes/admin.routes.ts - Monitoring and kiosk
backend/src/services/live-stats.service.ts - Audit trail
backend/src/services/audit.service.ts
Backend platform
- Express application
backend/src/app.ts - Application database
backend/src/lib/prisma.ts
Other components
- Tenant
- Proxmox cluster
- Mail service
Connections 32
- Tenant → Dashboard UI: uses
- Dashboard UI → Frontend API client: requests
- Frontend API client → Express application: calls API
- Express application → Auth routes: mounts routes
- Express application → VM routes: mounts routes
- Express application → Admin routes: mounts routes
- Auth routes → Authentication: creates sessions
- Auth routes → Invites and quotas: redeems invites
- Auth routes → MFA and SSO: checks factors
- Authentication → Access windows: checks expiry
- Authentication → Application database: reads/writes sessions
- Invites and quotas → Application database: stores quotas
- VM routes → VM lifecycle: manages guests
- VM routes → MateStates backups: creates backups
- VM routes → Audit trail: records actions
- Templates and images → VM lifecycle: deploys guests
- VM lifecycle → Placement scheduler: places guests
- VM lifecycle → Proxmox adapter: operates guests
- Placement scheduler → Proxmox adapter: queries capacity
- Proxmox adapter → Proxmox cluster: calls Proxmox API
- Dashboard UI → Browser consoles: opens console
- Browser consoles → Proxmox cluster: proxies console
- Dashboard UI → Browser IDE: opens IDE
- Browser IDE → Proxmox cluster: provisions IDE
- Dashboard UI → VM sharing: manages sharing
- Dashboard UI → Templates and images: selects templates
- Admin routes → Cluster operations: configures balancer
- Admin routes → Proxmox adapter: configures cluster
- Admin routes → Audit trail: records changes
- Admin routes → Monitoring and kiosk: views status
- MateStates backups → Proxmox adapter: backs up guests
- Access windows → Mail service: sends expiry notices