How mishazorin/vps-checker works
VPS Checker lets users register or log in, save servers, and inspect server health metrics; the frontend also supports linking Telegram. The backend separates authentication, user and server management, and metric collection, with SSH access to monitored machines and PostgreSQL-backed application data. Telegram bot setup and update handlers are present as a separate integration. Some Telegram and metrics wiring is inferred from source references rather than fully shown excerpts, so those relationships are marked unverified.
Main entry points: App.tsx Dashboard UI · telegram-bot.setup.ts Bot setup · servers.service.ts Server management · telegram.update.ts Bot handlers
Components 20
Web client
- Dashboard UI
frontend/frontFiles/src/App.tsx
Backend API
- Auth endpoints
backend/src/auth/auth.controller.ts - User endpoints
backend/src/users/users.controller.ts - Server endpoints
backend/src/servers/servers.controller.ts - Metric endpoints
backend/src/metrics/metrics.controller.ts - Telegram endpoints
backend/src/telegram/telegram.controller.ts - Application wiring
backend/src/app.module.ts
Application services
- Authentication
backend/src/auth/auth.service.ts - User management
backend/src/users/users.service.ts - Server management
backend/src/servers/servers.service.ts - Metric collection
backend/src/metrics/metrics.service.ts - User records
backend/src/users/entities/user.entity.ts - Server records
backend/src/servers/entities/server.entity.ts - Telegram settings
backend/src/telegram/telegram.service.ts
Storage and integrations
- PostgreSQL
- Monitored servers
- Bot setup
backend/src/telegram/telegram-bot.setup.ts - Bot handlers
backend/src/telegram/telegram.update.ts
Other components
- VPS operator
- Telegram
Connections 27
- VPS operator → Dashboard UI: uses
frontend/frontFiles/src/App.tsx - Dashboard UI → Auth endpoints: authenticates
frontend/frontFiles/src/App.tsx - Dashboard UI → Server endpoints: manages servers
frontend/frontFiles/src/App.tsx - Dashboard UI → Metric endpoints: requests metrics
frontend/frontFiles/src/App.tsx - Dashboard UI → User endpoints: requests link
frontend/frontFiles/src/App.tsx - Auth endpoints → Authentication: delegates to
backend/src/auth/auth.controller.ts - Authentication → User management: validates users
backend/src/auth/auth.service.ts - User endpoints → User management: delegates to
backend/src/users/users.controller.ts - Server endpoints → Server management: delegates to
backend/src/servers/servers.controller.ts - Metric endpoints → Metric collection: delegates to
backend/src/metrics/metrics.controller.ts - Server management → Server records: persists records
backend/src/servers/servers.service.ts - User management → User records: persists users
backend/src/users/users.service.ts - Server records → User records: belongs to
backend/src/servers/entities/server.entity.ts - Application wiring → PostgreSQL: configures
backend/src/app.module.ts - Server management → PostgreSQL: reads and writes
backend/src/servers/servers.service.ts - User management → PostgreSQL: reads and writes
backend/src/users/users.service.ts - Metric collection → Monitored servers: runs commands
backend/src/metrics/metrics.service.ts - Telegram endpoints → Telegram settings: delegates to
backend/src/telegram/telegram.controller.ts - Telegram settings → PostgreSQL: stores settings
- Telegram → Bot setup: sends updates
- Bot setup → Bot handlers: dispatches to
- Bot setup → Server management: uses
backend/src/telegram/telegram-bot.setup.ts - Bot setup → Metric collection: uses
backend/src/telegram/telegram-bot.setup.ts - Bot setup → Authentication: uses
backend/src/telegram/telegram-bot.setup.ts - Bot handlers → Server management: uses
backend/src/telegram/telegram.update.ts - Bot handlers → Metric collection: uses
backend/src/telegram/telegram.update.ts - Bot handlers → Authentication: uses
backend/src/telegram/telegram.update.ts