# wallysoncr/helpteste architecture

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

- Interactive diagram: https://gitdiagram.com/wallysoncr/helpteste
- Repository: https://github.com/wallysoncr/helpteste

## Overview

HelpTicket is a web-based support-ticket system for requesters, agents, and administrators. Users sign in, create tickets, and follow their status, comments, and attachments; agents handle and update tickets, while administrators have reporting, user, and settings screens. The React app routes these workflows to a .NET API, whose ticket service coordinates ticket operations and persistence. Notifications, email, and a knowledge base are also represented. Some frontend screen-to-API details and unsampled implementations are not shown, so those links are omitted rather than inferred.

Main entry points: [`helpticket-main/frontend/src/App.jsx`](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/App.jsx) (Web routes), [`helpticket-main/backend/HelpTicket.Api/Data/AppDbContext.cs`](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Data/AppDbContext.cs) (Application database), [`helpticket-main/backend/HelpTicket.Api/Services/TicketService.cs`](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Services/TicketService.cs) (Ticket service), [`helpticket-main/backend/HelpTicket.Api/Services/EmailService.cs`](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Services/EmailService.cs) (Email service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Web routes<br/>[App.jsx]"]
  node_login["Login screen"]
  node_auth_context["Auth context<br/>[AuthContext.jsx]"]
  node_login_controller["Login controller"]
  node_auth_model["Auth model<br/>[AuthModel.js]"]
  node_ticket_screens["Ticket screens"]
  node_dashboard_screens["Dashboard screens"]
  node_admin_screens["Admin screens"]
  node_knowledge_screen["Knowledge base"]
end

subgraph group_identity["Identity"]
  node_auth_api["Authentication API<br/>[AuthController.cs]"]
  node_auth_service["Authentication service<br/>[AuthService.cs]"]
  node_user_repo["User repository"]
  node_user_admin_api["User management API"]
end

subgraph group_ticketing["Ticket operations"]
  node_api["HTTP API"]
  node_ticket_service["Ticket service<br/>[TicketService.cs]"]
  node_ticket_repo["Ticket repository"]
  node_category_repo["Category repository"]
end

subgraph group_support["Support features"]
  node_notification_api["Notifications API"]
  node_email_service["Email service<br/>[EmailService.cs]"]
end

subgraph group_persistence["Persistence"]
  node_database[("Application database<br/>[AppDbContext.cs]")]
end

node_user(("Requester / staff"))
node_email(("Email provider"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_ticket_screens
node_app -->|"routes to"| node_dashboard_screens
node_app -->|"routes to"| node_admin_screens
node_app -->|"routes to"| node_knowledge_screen
node_login_controller -->|"uses"| node_auth_model
node_auth_context -.->|"authenticates via"| node_user_repo
node_auth_context -.->|"uses recovery"| node_email_service
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"looks up users"| node_user_repo
node_auth_service -->|"sends recovery"| node_email_service
node_user_repo -->|"reads / writes"| node_database
node_user_admin_api -->|"manages users"| node_database
node_api -->|"delegates to"| node_ticket_service
node_ticket_service -->|"handles tickets"| node_ticket_repo
node_ticket_service -->|"looks up category"| node_category_repo
node_ticket_service -->|"sends updates"| node_email_service
node_ticket_repo -->|"reads / writes"| node_database
node_category_repo -.->|"reads categories"| node_database
node_notification_api -->|"reads notifications"| node_database
node_email_service -.->|"sends email"| node_email

click node_app "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/App.jsx"
click node_login "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/modules/auth/screens/HelpTicketLoginScreen.jsx"
click node_auth_context "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/context/AuthContext.jsx"
click node_login_controller "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/modules/auth/controllers/useLoginController.js"
click node_auth_model "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/modules/auth/models/AuthModel.js"
click node_ticket_screens "https://github.com/wallysoncr/helpteste/tree/main/helpticket-main/frontend/src/modules/tickets/screens"
click node_dashboard_screens "https://github.com/wallysoncr/helpteste/tree/main/helpticket-main/frontend/src/modules/dashboard/screens"
click node_admin_screens "https://github.com/wallysoncr/helpteste/tree/main/helpticket-main/frontend/src/modules/admin/screens"
click node_knowledge_screen "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/modules/knowledge/screens/KnowledgeBaseScreen.jsx"
click node_api "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Controllers/TicketsController.cs"
click node_auth_api "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Controllers/AuthController.cs"
click node_auth_service "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Services/AuthService.cs"
click node_user_repo "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Repositories/UsuarioRepository.cs"
click node_ticket_service "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Services/TicketService.cs"
click node_ticket_repo "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Repositories/TicketRepository.cs"
click node_category_repo "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Repositories/CategoriaRepository.cs"
click node_user_admin_api "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Controllers/UsuariosController.cs"
click node_notification_api "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Controllers/NotificacoesController.cs"
click node_email_service "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Services/EmailService.cs"
click node_database "https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Data/AppDbContext.cs"

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_app,node_login,node_auth_context,node_login_controller,node_auth_model,node_ticket_screens,node_dashboard_screens,node_admin_screens,node_knowledge_screen toneBlue
class node_auth_api,node_auth_service,node_user_repo,node_user_admin_api toneAmber
class node_api,node_ticket_service,node_ticket_repo,node_category_repo,node_user toneMint
class node_notification_api,node_email_service toneRose
class node_database,node_email toneIndigo
```

## Components

### Web application

- [Web routes](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/App.jsx): `helpticket-main/frontend/src/App.jsx`
- [Login screen](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/modules/auth/screens/HelpTicketLoginScreen.jsx): `helpticket-main/frontend/src/modules/auth/screens/HelpTicketLoginScreen.jsx`
- [Auth context](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/context/AuthContext.jsx): `helpticket-main/frontend/src/context/AuthContext.jsx`
- [Login controller](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/modules/auth/controllers/useLoginController.js): `helpticket-main/frontend/src/modules/auth/controllers/useLoginController.js`
- [Auth model](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/modules/auth/models/AuthModel.js): `helpticket-main/frontend/src/modules/auth/models/AuthModel.js`
- [Ticket screens](https://github.com/wallysoncr/helpteste/tree/main/helpticket-main/frontend/src/modules/tickets/screens): `helpticket-main/frontend/src/modules/tickets/screens`
- [Dashboard screens](https://github.com/wallysoncr/helpteste/tree/main/helpticket-main/frontend/src/modules/dashboard/screens): `helpticket-main/frontend/src/modules/dashboard/screens`
- [Admin screens](https://github.com/wallysoncr/helpteste/tree/main/helpticket-main/frontend/src/modules/admin/screens): `helpticket-main/frontend/src/modules/admin/screens`
- [Knowledge base](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/frontend/src/modules/knowledge/screens/KnowledgeBaseScreen.jsx): `helpticket-main/frontend/src/modules/knowledge/screens/KnowledgeBaseScreen.jsx`

### Identity

- [Authentication API](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Controllers/AuthController.cs): `helpticket-main/backend/HelpTicket.Api/Controllers/AuthController.cs`
- [Authentication service](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Services/AuthService.cs): `helpticket-main/backend/HelpTicket.Api/Services/AuthService.cs`
- [User repository](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Repositories/UsuarioRepository.cs): `helpticket-main/backend/HelpTicket.Api/Repositories/UsuarioRepository.cs`
- [User management API](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Controllers/UsuariosController.cs): `helpticket-main/backend/HelpTicket.Api/Controllers/UsuariosController.cs`

### Ticket operations

- [HTTP API](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Controllers/TicketsController.cs): `helpticket-main/backend/HelpTicket.Api/Controllers/TicketsController.cs`
- [Ticket service](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Services/TicketService.cs): `helpticket-main/backend/HelpTicket.Api/Services/TicketService.cs`
- [Ticket repository](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Repositories/TicketRepository.cs): `helpticket-main/backend/HelpTicket.Api/Repositories/TicketRepository.cs`
- [Category repository](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Repositories/CategoriaRepository.cs): `helpticket-main/backend/HelpTicket.Api/Repositories/CategoriaRepository.cs`

### Support features

- [Notifications API](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Controllers/NotificacoesController.cs): `helpticket-main/backend/HelpTicket.Api/Controllers/NotificacoesController.cs`
- [Email service](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Services/EmailService.cs): `helpticket-main/backend/HelpTicket.Api/Services/EmailService.cs`

### Persistence

- [Application database](https://github.com/wallysoncr/helpteste/blob/main/helpticket-main/backend/HelpTicket.Api/Data/AppDbContext.cs): `helpticket-main/backend/HelpTicket.Api/Data/AppDbContext.cs`

### Other components

- **Requester / staff**
- **Email provider**

## Connections

- Requester / staff → Web routes: uses
- Web routes → Login screen: routes to (evidence: `helpticket-main/frontend/src/App.jsx`)
- Web routes → Ticket screens: routes to (evidence: `helpticket-main/frontend/src/App.jsx`)
- Web routes → Dashboard screens: routes to (evidence: `helpticket-main/frontend/src/App.jsx`)
- Web routes → Admin screens: routes to (evidence: `helpticket-main/frontend/src/App.jsx`)
- Web routes → Knowledge base: routes to (evidence: `helpticket-main/frontend/src/App.jsx`)
- Login controller → Auth model: uses (evidence: `helpticket-main/frontend/src/modules/auth/controllers/useLoginController.js`)
- Auth context → User repository: authenticates via
- Auth context → Email service: uses recovery
- Authentication API → Authentication service: delegates to (evidence: `helpticket-main/backend/HelpTicket.Api/Controllers/AuthController.cs`)
- Authentication service → User repository: looks up users (evidence: `helpticket-main/backend/HelpTicket.Api/Services/AuthService.cs`)
- Authentication service → Email service: sends recovery (evidence: `helpticket-main/backend/HelpTicket.Api/Services/AuthService.cs`)
- User repository → Application database: reads / writes (evidence: `helpticket-main/backend/HelpTicket.Api/Repositories/UsuarioRepository.cs`)
- User management API → Application database: manages users (evidence: `helpticket-main/backend/HelpTicket.Api/Controllers/UsuariosController.cs`)
- HTTP API → Ticket service: delegates to (evidence: `helpticket-main/backend/HelpTicket.Api/Controllers/TicketsController.cs`)
- Ticket service → Ticket repository: handles tickets (evidence: `helpticket-main/backend/HelpTicket.Api/Services/TicketService.cs`)
- Ticket service → Category repository: looks up category (evidence: `helpticket-main/backend/HelpTicket.Api/Services/TicketService.cs`)
- Ticket service → Email service: sends updates (evidence: `helpticket-main/backend/HelpTicket.Api/Services/TicketService.cs`)
- Ticket repository → Application database: reads / writes (evidence: `helpticket-main/backend/HelpTicket.Api/Repositories/TicketRepository.cs`)
- Category repository → Application database: reads categories (evidence: `helpticket-main/backend/HelpTicket.Api/Repositories/CategoriaRepository.cs`)
- Notifications API → Application database: reads notifications (evidence: `helpticket-main/backend/HelpTicket.Api/Controllers/NotificacoesController.cs`)
- Email service → Email provider: sends email
