# melissaraujo00/sistema-ticket-crs architecture

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

- Interactive diagram: https://gitdiagram.com/melissaraujo00/sistema-ticket-crs
- Repository: https://github.com/melissaraujo00/sistema-ticket-crs

## Overview

This is a Laravel help-desk and ticket-management application with an Inertia/React interface. The central workflow is ticket creation and classification, assignment, technician diagnosis or escalation, and requester follow-up; tickets also retain status and action history. Separate capabilities include technician and administrative dashboards, organizational administration, knowledge/FAQ content, SLA configuration, and technical ratings. Edges reflect shown calls or explicit module references; some unsampled capabilities are represented by their existing directories without asserted runtime links.

Main entry points: [`app/Services/TecnicoService.php`](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Services/TecnicoService.php) (Technician workflows), [`app/Models/Ticket.php`](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Ticket.php) (Ticket record), [`app/Http/Controllers/Tickets/TicketController.php`](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/Tickets/TicketController.php) (Ticket actions), [`app/Models/HelpTopic.php`](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/HelpTopic.php) (Help topics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ticketing["Ticket lifecycle"]
  node_ticket_controller["Ticket actions"]
  node_ticket_ui["Ticket pages"]
  node_ticket_code["Ticket code action"]
  node_internal_note["Internal notes"]
  node_assignment["Assignment actions"]
  node_history[("Ticket history<br/>[TicketHistory.php]")]
end

subgraph group_service["Technician operations"]
  node_technician_controller["Technician API"]
  node_technician_service["Technician workflows<br/>[TecnicoService.php]"]
  node_solution[("Diagnosis and solutions<br/>[TicketSolution.php]")]
  node_attachment[("Attachments<br/>[Attachment.php]")]
  node_unresolved_notice["Unresolved notice"]
  node_technician_ui["Agent dashboard"]
end

subgraph group_admin["Admin and insights"]
  node_admin_dash["Admin dashboards"]
  node_dashboard_service["Dashboard metrics"]
  node_department_admin["Department administration"]
  node_department_service["Department service"]
  node_users[("User records<br/>[User.php]")]
  node_organization[("Organizational records<br/>[Department.php]")]
  node_ratings["Technical ratings"]
end

subgraph group_content["Knowledge and policy"]
  node_knowledge["Knowledge and FAQs"]
  node_help_topics[("Help topics<br/>[HelpTopic.php]")]
  node_sla[("SLA plans<br/>[SlaPlan.php]")]
  node_priority[("Priorities<br/>[Priority.php]")]
end

subgraph group_domain["Domain records"]
  node_ticket[("Ticket record<br/>[Ticket.php]")]
  node_status[("Ticket status<br/>[Status.php]")]
end

node_requester(("Requester"))
node_database[("MySQL database")]

node_requester -.->|"submits ticket"| node_ticket_controller
node_ticket_controller -->|"renders pages"| node_ticket_ui
node_ticket_controller -->|"creates and reads"| node_ticket
node_ticket_controller -->|"generates code"| node_ticket_code
node_ticket_controller -->|"adds note"| node_internal_note
node_ticket_controller -.->|"records actions"| node_history
node_assignment -->|"updates assignment"| node_ticket
node_assignment -.->|"records assignment"| node_history
node_technician_controller -->|"delegates requests"| node_technician_service
node_technician_service -->|"returns results"| node_technician_controller
node_technician_service -->|"queries and updates"| node_ticket
node_technician_service -->|"records diagnosis"| node_solution
node_technician_service -->|"reads attachments"| node_attachment
node_technician_service -->|"changes status"| node_status
node_technician_service -->|"reads history"| node_history
node_technician_service -->|"sends notice"| node_unresolved_notice
node_technician_service -->|"loads technician"| node_users
node_dashboard_service -->|"queries metrics"| node_ticket
node_dashboard_service -->|"uses user data"| node_users
node_dashboard_service -.->|"provides dashboard data"| node_admin_dash
node_department_admin -->|"manages departments"| node_organization
node_department_admin -->|"delegates operations"| node_department_service
node_ticket -->|"references requester"| node_users
node_ticket -->|"references topic"| node_help_topics
node_ticket -->|"references status"| node_status
node_ticket -->|"has history"| node_history
node_help_topics -->|"references plan"| node_sla
node_help_topics -->|"references priority"| node_priority
node_knowledge -.->|"manages topics"| node_help_topics
node_ticket -.->|"persists records"| node_database
node_organization -.->|"persists records"| node_database

click node_ticket_controller "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/Tickets/TicketController.php"
click node_ticket_ui "https://github.com/melissaraujo00/sistema-ticket-crs/tree/main/resources/js/pages/tickets"
click node_ticket_code "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Actions/GenerateTicketCodeAction.php"
click node_internal_note "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Actions/AddInternalNoteAction.php"
click node_assignment "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/Tickets/TicketAssignmentController.php"
click node_history "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/TicketHistory.php"
click node_ticket "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Ticket.php"
click node_status "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Status.php"
click node_technician_controller "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/TecnicoController.php"
click node_technician_service "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Services/TecnicoService.php"
click node_solution "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/TicketSolution.php"
click node_attachment "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Attachment.php"
click node_unresolved_notice "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Notifications/TicketUnresolvedNotification.php"
click node_technician_ui "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/resources/js/pages/dashboards/agent-dashboard.jsx"
click node_admin_dash "https://github.com/melissaraujo00/sistema-ticket-crs/tree/main/resources/js/pages/dashboards"
click node_dashboard_service "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Services/DashboardService.php"
click node_department_admin "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/DepartmentController.php"
click node_department_service "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Services/DepartmentService.php"
click node_users "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/User.php"
click node_organization "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Department.php"
click node_ratings "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/TechnicalRatingsController.php"
click node_knowledge "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/KnowledgeController.php"
click node_help_topics "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/HelpTopic.php"
click node_sla "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/SlaPlan.php"
click node_priority "https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Priority.php"

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_ticket_controller,node_ticket_ui,node_ticket_code,node_internal_note,node_assignment,node_history toneBlue
class node_technician_controller,node_technician_service,node_solution,node_attachment,node_unresolved_notice,node_technician_ui,node_database toneAmber
class node_admin_dash,node_dashboard_service,node_department_admin,node_department_service,node_users,node_organization,node_ratings,node_requester toneMint
class node_knowledge,node_help_topics,node_sla,node_priority toneRose
class node_ticket,node_status toneIndigo
```

## Components

### Ticket lifecycle

- [Ticket actions](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/Tickets/TicketController.php): `app/Http/Controllers/Tickets/TicketController.php`
- [Ticket pages](https://github.com/melissaraujo00/sistema-ticket-crs/tree/main/resources/js/pages/tickets): `resources/js/pages/tickets`
- [Ticket code action](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Actions/GenerateTicketCodeAction.php): `app/Actions/GenerateTicketCodeAction.php`
- [Internal notes](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Actions/AddInternalNoteAction.php): `app/Actions/AddInternalNoteAction.php`
- [Assignment actions](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/Tickets/TicketAssignmentController.php): `app/Http/Controllers/Tickets/TicketAssignmentController.php`
- [Ticket history](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/TicketHistory.php): `app/Models/TicketHistory.php`

### Technician operations

- [Technician API](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/TecnicoController.php): `app/Http/Controllers/TecnicoController.php`
- [Technician workflows](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Services/TecnicoService.php): `app/Services/TecnicoService.php`
- [Diagnosis and solutions](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/TicketSolution.php): `app/Models/TicketSolution.php`
- [Attachments](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Attachment.php): `app/Models/Attachment.php`
- [Unresolved notice](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Notifications/TicketUnresolvedNotification.php): `app/Notifications/TicketUnresolvedNotification.php`
- [Agent dashboard](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/resources/js/pages/dashboards/agent-dashboard.jsx): `resources/js/pages/dashboards/agent-dashboard.jsx`

### Admin and insights

- [Admin dashboards](https://github.com/melissaraujo00/sistema-ticket-crs/tree/main/resources/js/pages/dashboards): `resources/js/pages/dashboards`
- [Dashboard metrics](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Services/DashboardService.php): `app/Services/DashboardService.php`
- [Department administration](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/DepartmentController.php): `app/Http/Controllers/DepartmentController.php`
- [Department service](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Services/DepartmentService.php): `app/Services/DepartmentService.php`
- [User records](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/User.php): `app/Models/User.php`
- [Organizational records](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Department.php): `app/Models/Department.php`
- [Technical ratings](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/TechnicalRatingsController.php): `app/Http/Controllers/TechnicalRatingsController.php`

### Knowledge and policy

- [Knowledge and FAQs](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Http/Controllers/KnowledgeController.php): `app/Http/Controllers/KnowledgeController.php`
- [Help topics](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/HelpTopic.php): `app/Models/HelpTopic.php`
- [SLA plans](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/SlaPlan.php): `app/Models/SlaPlan.php`
- [Priorities](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Priority.php): `app/Models/Priority.php`

### Domain records

- [Ticket record](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Ticket.php): `app/Models/Ticket.php`
- [Ticket status](https://github.com/melissaraujo00/sistema-ticket-crs/blob/main/app/Models/Status.php): `app/Models/Status.php`

### Other components

- **Requester**
- **MySQL database**

## Connections

- Requester → Ticket actions: submits ticket
- Ticket actions → Ticket pages: renders pages (evidence: `app/Http/Controllers/Tickets/TicketController.php`)
- Ticket actions → Ticket record: creates and reads (evidence: `app/Http/Controllers/Tickets/TicketController.php`)
- Ticket actions → Ticket code action: generates code (evidence: `app/Http/Controllers/Tickets/TicketController.php`)
- Ticket actions → Internal notes: adds note (evidence: `app/Http/Controllers/Tickets/TicketController.php`)
- Ticket actions → Ticket history: records actions
- Assignment actions → Ticket record: updates assignment (evidence: `app/Http/Controllers/Tickets/TicketAssignmentController.php`)
- Assignment actions → Ticket history: records assignment (evidence: `app/Http/Controllers/Tickets/TicketAssignmentController.php`)
- Technician API → Technician workflows: delegates requests (evidence: `app/Http/Controllers/TecnicoController.php`)
- Technician workflows → Technician API: returns results (evidence: `app/Http/Controllers/TecnicoController.php`)
- Technician workflows → Ticket record: queries and updates (evidence: `app/Services/TecnicoService.php`)
- Technician workflows → Diagnosis and solutions: records diagnosis (evidence: `app/Services/TecnicoService.php`)
- Technician workflows → Attachments: reads attachments (evidence: `app/Services/TecnicoService.php`)
- Technician workflows → Ticket status: changes status (evidence: `app/Services/TecnicoService.php`)
- Technician workflows → Ticket history: reads history (evidence: `app/Services/TecnicoService.php`)
- Technician workflows → Unresolved notice: sends notice (evidence: `app/Services/TecnicoService.php`)
- Technician workflows → User records: loads technician (evidence: `app/Services/TecnicoService.php`)
- Dashboard metrics → Ticket record: queries metrics (evidence: `app/Services/DashboardService.php`)
- Dashboard metrics → User records: uses user data (evidence: `app/Services/DashboardService.php`)
- Dashboard metrics → Admin dashboards: provides dashboard data
- Department administration → Organizational records: manages departments (evidence: `app/Http/Controllers/DepartmentController.php`)
- Department administration → Department service: delegates operations (evidence: `app/Http/Controllers/DepartmentController.php`)
- Ticket record → User records: references requester (evidence: `app/Models/Ticket.php`)
- Ticket record → Help topics: references topic (evidence: `app/Models/Ticket.php`)
- Ticket record → Ticket status: references status (evidence: `app/Models/Ticket.php`)
- Ticket record → Ticket history: has history (evidence: `app/Models/Ticket.php`)
- Help topics → SLA plans: references plan (evidence: `app/Models/HelpTopic.php`)
- Help topics → Priorities: references priority (evidence: `app/Models/HelpTopic.php`)
- Knowledge and FAQs → Help topics: manages topics
- Ticket record → MySQL database: persists records
- Organizational records → MySQL database: persists records
