How parsuka12/softwarehelpdesk works
Mesa de Ayuda is a web help desk for users and support staff. Users sign in, create and track priority/SLA-based tickets, while staff manage tickets, comments and assignments; the application also provides metrics, notifications, email intake and an on-demand Gemini assistant using team ticket history. The graph combines the documented capabilities with relationships visible in the supplied excerpts and source index. Several route/controller and scheduled-job implementations were not sampled, so those connections are omitted rather than inferred.
Main entry points: db.js PostgreSQL · ticket.controller.js Ticket operations · http.js API client · asistente.service.js Assistant context
Components 24
Web interface
- Vue application
frontend/src/App.vue - Sign-in state
frontend/src/stores/auth.js - API client
frontend/src/api/http.js - Ticket interface
frontend/src/components/TicketDetail.vue - Metrics view
frontend/src/views/DashboardView.vue - Interface state
frontend/src/stores/ui.js
API and access
- Express API
backend/src/app.js - Ticket routes
backend/src/routes/ticket.routes.js - Auth routes
backend/src/routes/auth.routes.js
Help desk workflows
- Ticket operations
backend/src/controllers/ticket.controller.js - Ticket queries
backend/src/services/ticket.service.js - Dashboard metrics
backend/src/controllers/dashboard.controller.js - User management
backend/src/controllers/user.controller.js - Email intake
backend/src/controllers/correo.controller.js - AI suggestions
backend/src/controllers/ia.controller.js
Supporting services
- Assistant context
backend/src/services/ai/asistente.service.js - Gemini client
backend/src/services/ai/gemini.service.js - Notifications
backend/src/services/notification.service.js - Mail delivery
backend/src/services/mail.service.js - SLA rules
backend/src/utils/sla.js
Runtime configuration
- PostgreSQL
backend/src/config/db.js
Other components
- Help desk user
- Google Gemini
- SMTP service
Connections 27
- Help desk user → Vue application: uses
README.md - Vue application → Sign-in state: uses
frontend/src/App.vue - Sign-in state → API client: calls
frontend/src/stores/auth.js - Ticket interface → API client: calls
frontend/src/components/TicketDetail.vue - Ticket interface → Interface state: updates
frontend/src/components/TicketDetail.vue - Metrics view → API client: calls
frontend/src/views/DashboardView.vue - Metrics view → Interface state: reads
frontend/src/views/DashboardView.vue - API client → Express API: sends requests
README.md - Express API → Ticket routes: mounts routes
backend/src/app.js - Ticket routes → Ticket operations: dispatches
backend/src/routes/ticket.routes.js - Auth routes → PostgreSQL: authenticates
backend/src/routes/auth.routes.js - Ticket operations → Ticket queries: calls
backend/src/controllers/ticket.controller.js - Ticket operations → PostgreSQL: reads and writes
backend/src/controllers/ticket.controller.js - Ticket queries → PostgreSQL: queries
backend/src/services/ticket.service.js - Ticket operations → SLA rules: calculates deadlines
backend/src/controllers/ticket.controller.js - Ticket operations → Notifications: notifies
backend/src/controllers/ticket.controller.js - Dashboard metrics → PostgreSQL: queries
backend/src/controllers/dashboard.controller.js - Dashboard metrics → SLA rules: uses
backend/src/controllers/dashboard.controller.js - User management → PostgreSQL: queries
backend/src/controllers/user.controller.js - Email intake → Ticket queries: uses
backend/src/controllers/correo.controller.js - Email intake → Mail delivery: sends mail
backend/src/controllers/correo.controller.js - AI suggestions → Assistant context: requests suggestions
backend/src/controllers/ia.controller.js - Assistant context → PostgreSQL: reads history
backend/src/services/ai/asistente.service.js - Assistant context → Gemini client: requests completion
backend/src/services/ai/asistente.service.js - Gemini client → Google Gemini: calls
- Notifications → Mail delivery: sends email
backend/src/services/notification.service.js - Mail delivery → SMTP service: delivers through