How arrizal2004/ccd works
Campus Cloud Dashboard lets students sign in, see only assigned lab VMs, and launch browser-based SSH/RDP sessions; administrators manage users, VM assignments and infrastructure. The graph also preserves VM provisioning and lifecycle, Open Web, helpdesk, group access, optional bastion SSH, and audit/monitoring capabilities documented by the README. Sampled source confirms several backend and frontend links; other capability links rely on README documentation, so unsampled implementation details are not inferred.
Main entry points: api.js Frontend API · App.jsx Dashboard Shell · database.py Application Database · auth.py JWT and Roles
Components 33
Dashboard UI
- Dashboard Shell
frontend/src/App.jsx - VM Dashboard
frontend/src/pages/ProxmoxPage.jsx - Admin Tools
frontend/src/components/AdminPanel.jsx - Group Management
frontend/src/components/GroupsPage.jsx - Helpdesk Tickets
frontend/src/components/TicketsPage.jsx - VM Requests
frontend/src/components/InfraRequestsPage.jsx - Open Web
frontend/src/pages/OpenWebPage.jsx - Frontend API
frontend/src/api.js
Identity and Access
- Accounts and Login
backend/routers/users.py - JWT and Roles
backend/auth.py - Group Access API
backend/routers/groups.py - Administration API
backend/routers/admin.py
VM Operations
- VM Management API
backend/routers/proxmox.py - VM Provisioning
backend/services/proxmox_provision.py - Proxmox Instances
backend/services/proxmox_instances.py - Proxmox API Client
backend/services/proxmox_client.py - VM Metrics Poller
backend/services/proxmox_iops_poller.py
Support and Remote Access
- Remote Connect API
backend/routers/guac.py - Guacamole Sync
backend/services/guac_sync.py - Open Web Proxy
backend/routers/openweb.py - Ticket Service
backend/routers/tickets.py - VM Request Service
backend/routers/infra_requests.py - SSH Credentials and Bastion
backend/routers/ssh_creds.py - SSH Operations
backend/services/ssh_client.py - SSH Key Access
backend/routers/ssh_keys.py
Application State
- Activity Audit
backend/services/audit.py - Application Database
backend/database.py - PostgreSQL
- Redis
Other components
- Student
- Administrator
- Apache Guacamole
- Proxmox VE
Connections 48
- Student → Dashboard Shell: uses
- Administrator → Dashboard Shell: uses
- Dashboard Shell → VM Dashboard: opens
frontend/src/App.jsx - Dashboard Shell → Admin Tools: opens
frontend/src/App.jsx - Dashboard Shell → Group Management: opens
frontend/src/App.jsx - Dashboard Shell → Helpdesk Tickets: opens
frontend/src/App.jsx - Dashboard Shell → VM Requests: opens
frontend/src/App.jsx - Dashboard Shell → Open Web: opens
frontend/src/App.jsx - VM Dashboard → Frontend API: requests
frontend/src/pages/ProxmoxPage.jsx - Admin Tools → Frontend API: requests
frontend/src/components/AdminPanel.jsx - Group Management → Frontend API: requests
frontend/src/components/GroupsPage.jsx - Helpdesk Tickets → Frontend API: requests
frontend/src/components/TicketsPage.jsx - VM Requests → Frontend API: requests
frontend/src/components/InfraRequestsPage.jsx - Open Web → Frontend API: requests
frontend/src/pages/OpenWebPage.jsx - Frontend API → Accounts and Login: calls REST API
- Frontend API → VM Management API: calls REST API
- Frontend API → Remote Connect API: calls REST API
- Frontend API → Ticket Service: calls REST API
- Frontend API → VM Request Service: calls REST API
- Frontend API → Open Web Proxy: calls REST API
- Accounts and Login → JWT and Roles: authenticates
backend/routers/users.py - JWT and Roles → Redis: checks revocation
backend/auth.py - Accounts and Login → Guacamole Sync: syncs accounts
backend/routers/users.py - Accounts and Login → Application Database: reads and writes
backend/routers/users.py - VM Management API → JWT and Roles: checks access
backend/routers/proxmox.py - VM Management API → Proxmox Instances: gets client
backend/routers/proxmox.py - VM Management API → Proxmox API Client: calls
backend/routers/proxmox.py - VM Management API → VM Provisioning: provisions VMs
backend/routers/proxmox.py - VM Management API → Application Database: updates VM records
backend/routers/proxmox.py - Proxmox Instances → Proxmox API Client: calls
backend/services/proxmox_instances.py - Proxmox API Client → Proxmox VE: sends API requests
- VM Metrics Poller → Application Database: records metrics
backend/services/proxmox_iops_poller.py - Remote Connect API → JWT and Roles: checks access
backend/routers/guac.py - Remote Connect API → Guacamole Sync: manages connections
- Remote Connect API → Application Database: reads credentials
backend/routers/guac.py - Guacamole Sync → Apache Guacamole: synchronizes accounts
backend/services/guac_sync.py - Remote Connect API → Apache Guacamole: creates remote sessions
- Open Web Proxy → Application Database: reads session data
- Open Web Proxy → Proxmox VE: proxies private app
- Ticket Service → JWT and Roles: checks access
backend/routers/tickets.py - Ticket Service → Application Database: reads and writes
backend/routers/tickets.py - Ticket Service → Activity Audit: records activity
backend/routers/tickets.py - VM Request Service → JWT and Roles: checks access
backend/routers/infra_requests.py - VM Request Service → Application Database: reads and writes
backend/routers/infra_requests.py - SSH Credentials and Bastion → JWT and Roles: checks access
backend/routers/ssh_creds.py - SSH Credentials and Bastion → Application Database: stores credentials
backend/routers/ssh_creds.py - SSH Credentials and Bastion → SSH Operations: tests SSH
backend/routers/ssh_creds.py - SSH Key Access → Application Database: stores keys
backend/routers/ssh_keys.py