# sandeshlim1992/studenthub architecture

> Architecture diagram of the GitHub repository sandeshlim1992/studenthub, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sandeshlim1992/studenthub
- Repository: https://github.com/sandeshlim1992/studenthub

## Overview

Student Hub is a customized Zammad helpdesk: students use a branded support portal while staff administer tickets and service configuration. The principal workflow is a customer submitting and following a support request, with Rails controllers handling ticket operations; the README documents a role-specific customer layout and ticket-list changes. Separate documented capabilities include a `/manage` administration area, AI tools, channels, knowledge base, reporting, and integrations. The tree confirms relevant backend and desktop entry paths, but omits most page implementations, so links to those areas are documented or left unverified rather than inferred from imports.

Main entry points: [`app/frontend/apps/desktop`](https://github.com/sandeshlim1992/studenthub/tree/develop/app/frontend/apps/desktop) (Manage UI), [`app/controllers/tickets_controller.rb`](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/tickets_controller.rb) (Ticket Submission), [`app/frontend/apps/desktop/components/Customer`](https://github.com/sandeshlim1992/studenthub/tree/develop/app/frontend/apps/desktop/components/Customer) (Customer Portal UI), [`app/controllers/ticket_articles_controller.rb`](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/ticket_articles_controller.rb) (Ticket Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Student Portal"]
  node_desktop["Desktop UI<br/>[AppDesktop.vue]"]
  node_customer_ui["Customer Portal UI"]
  node_ticket_create["Ticket Submission"]
end

subgraph group_tickets["Ticket Workflow"]
  node_ticket_api["Ticket Operations"]
  node_ticket_views["Ticket Views"]
  node_sla_preview["SLA Preview"]
end

subgraph group_admin["Administration"]
  node_manage_ui["Manage UI"]
  node_admin_config["Administration APIs"]
end

subgraph group_capabilities["Support Capabilities"]
  node_ai_tools["AI Tools"]
  node_channels["Communication Channels"]
  node_knowledge["Knowledge Base"]
  node_reports["Reports"]
  node_integrations["Integrations"]
end

subgraph group_platform["Application Platform"]
  node_graphql["GraphQL API"]
  node_query_handler["Query Handler<br/>[QueryHandler.ts]"]
  node_database[("PostgreSQL")]
end

node_student(("Student"))

node_student -->|"uses"| node_customer_ui
node_customer_ui -.->|"renders within"| node_desktop
node_student -.->|"submits request"| node_ticket_create
node_ticket_create -.->|"handles ticket actions"| node_ticket_api
node_student -.->|"views tickets"| node_ticket_views
node_ticket_create -.->|"requests SLA estimate"| node_sla_preview
node_manage_ui -->|"calls REST API"| node_admin_config
node_manage_ui -.->|"configures AI"| node_ai_tools
node_manage_ui -.->|"configures channels"| node_channels
node_manage_ui -.->|"manages articles"| node_knowledge
node_manage_ui -.->|"views reports"| node_reports
node_manage_ui -.->|"configures integrations"| node_integrations
node_query_handler -->|"queries"| node_graphql
node_ticket_api -.->|"reads and writes"| node_database

click node_desktop "https://github.com/sandeshlim1992/studenthub/blob/develop/app/frontend/apps/desktop/AppDesktop.vue"
click node_customer_ui "https://github.com/sandeshlim1992/studenthub/tree/develop/app/frontend/apps/desktop/components/Customer"
click node_ticket_create "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/tickets_controller.rb"
click node_ticket_api "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/ticket_articles_controller.rb"
click node_ticket_views "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/ticket_overviews_controller.rb"
click node_sla_preview "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/studenthub_sla_previews_controller.rb"
click node_manage_ui "https://github.com/sandeshlim1992/studenthub/tree/develop/app/frontend/apps/desktop"
click node_admin_config "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/settings_controller.rb"
click node_ai_tools "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/ai_assistance_controller.rb"
click node_channels "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/channels_email_controller.rb"
click node_knowledge "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/knowledge_base/search_controller.rb"
click node_reports "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/reports_controller.rb"
click node_integrations "https://github.com/sandeshlim1992/studenthub/tree/develop/app/controllers/integration"
click node_graphql "https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/graphql_controller.rb"
click node_query_handler "https://github.com/sandeshlim1992/studenthub/blob/develop/app/frontend/shared/server/apollo/handler/QueryHandler.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_desktop,node_customer_ui,node_ticket_create toneBlue
class node_ticket_api,node_ticket_views,node_sla_preview toneAmber
class node_manage_ui,node_admin_config toneMint
class node_ai_tools,node_channels,node_knowledge,node_reports,node_integrations toneRose
class node_graphql,node_query_handler,node_database,node_student toneIndigo
```

## Components

### Student Portal

- [Desktop UI](https://github.com/sandeshlim1992/studenthub/blob/develop/app/frontend/apps/desktop/AppDesktop.vue): `app/frontend/apps/desktop/AppDesktop.vue`
- [Customer Portal UI](https://github.com/sandeshlim1992/studenthub/tree/develop/app/frontend/apps/desktop/components/Customer): `app/frontend/apps/desktop/components/Customer`
- [Ticket Submission](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/tickets_controller.rb): `app/controllers/tickets_controller.rb`

### Ticket Workflow

- [Ticket Operations](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/ticket_articles_controller.rb): `app/controllers/ticket_articles_controller.rb`
- [Ticket Views](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/ticket_overviews_controller.rb): `app/controllers/ticket_overviews_controller.rb`
- [SLA Preview](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/studenthub_sla_previews_controller.rb): `app/controllers/studenthub_sla_previews_controller.rb`

### Administration

- [Manage UI](https://github.com/sandeshlim1992/studenthub/tree/develop/app/frontend/apps/desktop): `app/frontend/apps/desktop`
- [Administration APIs](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/settings_controller.rb): `app/controllers/settings_controller.rb`

### Support Capabilities

- [AI Tools](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/ai_assistance_controller.rb): `app/controllers/ai_assistance_controller.rb`
- [Communication Channels](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/channels_email_controller.rb): `app/controllers/channels_email_controller.rb`
- [Knowledge Base](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/knowledge_base/search_controller.rb): `app/controllers/knowledge_base/search_controller.rb`
- [Reports](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/reports_controller.rb): `app/controllers/reports_controller.rb`
- [Integrations](https://github.com/sandeshlim1992/studenthub/tree/develop/app/controllers/integration): `app/controllers/integration`

### Application Platform

- [GraphQL API](https://github.com/sandeshlim1992/studenthub/blob/develop/app/controllers/graphql_controller.rb): `app/controllers/graphql_controller.rb`
- [Query Handler](https://github.com/sandeshlim1992/studenthub/blob/develop/app/frontend/shared/server/apollo/handler/QueryHandler.ts): `app/frontend/shared/server/apollo/handler/QueryHandler.ts`
- **PostgreSQL**

### Other components

- **Student**

## Connections

- Student → Customer Portal UI: uses
- Customer Portal UI → Desktop UI: renders within
- Student → Ticket Submission: submits request
- Ticket Submission → Ticket Operations: handles ticket actions
- Student → Ticket Views: views tickets
- Ticket Submission → SLA Preview: requests SLA estimate
- Manage UI → Administration APIs: calls REST API
- Manage UI → AI Tools: configures AI
- Manage UI → Communication Channels: configures channels
- Manage UI → Knowledge Base: manages articles
- Manage UI → Reports: views reports
- Manage UI → Integrations: configures integrations
- Query Handler → GraphQL API: queries (evidence: `app/frontend/shared/server/apollo/handler/QueryHandler.ts`)
- Ticket Operations → PostgreSQL: reads and writes
