# allen-john-y/ticketing architecture

> Architecture diagram of the GitHub repository allen-john-y/ticketing, 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/allen-john-y/ticketing
- Repository: https://github.com/allen-john-y/ticketing

## Overview

This is an internal service-management portal spanning incidents, service requests, HR onboarding/offboarding, knowledge, assets, licenses, and administrative configuration. Users sign in, search or navigate to a service, submit or manage records, and administrators configure workflows and resources. The React application routes to feature pages; those pages call a single Express backend, which also handles SharePoint uploads. The backend excerpt confirms incident and onboarding API behavior, but most server routes and several frontend pages were not sampled, so those connections are shown only where the excerpts support them.

Main entry points: [`frontend/src/App.js`](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/App.js) (Application routing), [`backend/server.js`](https://github.com/allen-john-y/ticketing/blob/main/backend/server.js) (Express API), [`frontend/src/SettingsPages/Settings.js`](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/Settings.js) (Settings hub), [`frontend/src/SettingsPages/AddRequest.js`](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/AddRequest.js) (Request configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Portal experience"]
  node_app["Application routing<br/>[App.js]"]
  node_search["Smart search<br/>[SmartSearch.js]"]
  node_home["Home dashboard<br/>[Home.js]"]
end

subgraph group_work["Service workflows"]
  node_incident_create["Create incident<br/>[CreateIncident.js]"]
  node_incident_list["Incident list<br/>[Incidents.js]"]
  node_incident_detail["Incident details<br/>[IncidentDetails.js]"]
  node_request_create["Create request<br/>[CreateRequest.js]"]
  node_request_list["Request list<br/>[Requests.js]"]
  node_request_detail["Request details<br/>[RequestDetails.js]"]
  node_hr_requests["HR requests<br/>[HrRequest.js]"]
  node_onboarding["Onboarding forms<br/>[OnboardingForm.js]"]
  node_onboarding_detail["Onboarding details"]
  node_offboarding["Offboarding forms<br/>[OffboardingForm.js]"]
  node_offboarding_detail["Offboarding details"]
  node_tickets["Ticket creation<br/>[CreateTicket.js]"]
  node_ticket_detail["Ticket details<br/>[TicketDetails.js]"]
end

subgraph group_resources["Resources and knowledge"]
  node_assets["Asset registry<br/>[AssetRegistry.js]"]
  node_licenses["License registry<br/>[LicenseRegistry.js]"]
  node_kb_list["Knowledge list<br/>[KBListView.js]"]
  node_kb_view["Knowledge article<br/>[KBView.js]"]
end

subgraph group_admin["Administration"]
  node_settings["Settings hub<br/>[Settings.js]"]
  node_request_config["Request configuration<br/>[AddRequest.js]"]
  node_field_config["Field configuration<br/>[AddField.js]"]
  node_category_forms["Category form helpers"]
  node_asset_config["Asset settings<br/>[AssetSettings.js]"]
  node_asset_create["Asset setup"]
  node_hr_config["HR request setup<br/>[CreateHrRequest.js]"]
  node_onboarding_config["Onboarding settings"]
  node_offboarding_config["Offboarding settings"]
  node_license_config["License mapping<br/>[LicenseMapping.js]"]
  node_department_config["Departments<br/>[Departments.js]"]
end

subgraph group_api["Backend services"]
  node_backend["Express API<br/>[server.js]"]
  node_sharepoint_upload["SharePoint upload"]
end

node_user(("Employee or admin"))

node_user -->|"uses"| node_app
node_app -->|"routes"| node_home
node_app -->|"renders"| node_search
node_app -->|"routes"| node_incident_list
node_app -->|"routes"| node_incident_create
node_app -->|"routes"| node_request_list
node_app -->|"routes"| node_request_create
node_app -->|"routes"| node_hr_requests
node_app -->|"routes"| node_onboarding
node_app -->|"routes"| node_offboarding
node_app -->|"routes"| node_ticket_detail
node_app -->|"routes"| node_settings
node_incident_detail -->|"calls API"| node_backend
node_backend -->|"calls upload"| node_sharepoint_upload
node_request_detail -->|"calls API"| node_backend
node_request_config -->|"manages services"| node_backend
node_hr_config -->|"manages HR types"| node_backend
node_onboarding_config -->|"saves settings"| node_backend
node_license_config -->|"saves mappings"| node_backend
node_assets -->|"reads and updates"| node_backend
node_field_config -->|"uses helpers"| node_category_forms
node_settings -->|"routes"| node_field_config
node_settings -->|"routes"| node_request_config
node_settings -->|"routes"| node_asset_config
node_settings -->|"routes"| node_license_config
node_settings -->|"routes"| node_department_config

click node_app "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/App.js"
click node_search "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SmartSearch.js"
click node_home "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/Home.js"
click node_incident_create "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/CreateIncident.js"
click node_incident_list "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/Incidents.js"
click node_incident_detail "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/IncidentDetails.js"
click node_request_create "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/CreateRequest.js"
click node_request_list "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/Requests.js"
click node_request_detail "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/RequestDetails.js"
click node_hr_requests "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/HrRequest.js"
click node_onboarding "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/OnboardingForm.js"
click node_onboarding_detail "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/OnboardingRequestDetails.js"
click node_offboarding "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/OffboardingForm.js"
click node_offboarding_detail "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/OffboardingRequestDetails.js"
click node_tickets "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/CreateTicket.js"
click node_ticket_detail "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/TicketDetails.js"
click node_assets "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/AssetRegistry.js"
click node_licenses "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/LicenseRegistry.js"
click node_kb_list "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/KBListView.js"
click node_kb_view "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/KBView.js"
click node_settings "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/Settings.js"
click node_request_config "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/AddRequest.js"
click node_field_config "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/AddField.js"
click node_category_forms "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/CategoryFormCombined.js"
click node_asset_config "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/AssetSettings.js"
click node_asset_create "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/CreateAssetRegistry.js"
click node_hr_config "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/CreateHrRequest.js"
click node_onboarding_config "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/OnboardingSettings.js"
click node_offboarding_config "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/OffboardingSettings.js"
click node_license_config "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/LicenseMapping.js"
click node_department_config "https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/Departments.js"
click node_backend "https://github.com/allen-john-y/ticketing/blob/main/backend/server.js"
click node_sharepoint_upload "https://github.com/allen-john-y/ticketing/blob/main/backend/utils/sharepointUpload.js"

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_search,node_home toneBlue
class node_incident_create,node_incident_list,node_incident_detail,node_request_create,node_request_list,node_request_detail,node_hr_requests,node_onboarding,node_onboarding_detail,node_offboarding,node_offboarding_detail,node_tickets,node_ticket_detail toneAmber
class node_assets,node_licenses,node_kb_list,node_kb_view toneMint
class node_settings,node_request_config,node_field_config,node_category_forms,node_asset_config,node_asset_create,node_hr_config,node_onboarding_config,node_offboarding_config,node_license_config,node_department_config toneRose
class node_backend,node_sharepoint_upload,node_user toneIndigo
```

## Components

### Portal experience

- [Application routing](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Smart search](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SmartSearch.js): `frontend/src/SmartSearch.js`
- [Home dashboard](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/Home.js): `frontend/src/Home.js`

### Service workflows

- [Create incident](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/CreateIncident.js): `frontend/src/CreateIncident.js`
- [Incident list](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/Incidents.js): `frontend/src/Incidents.js`
- [Incident details](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/IncidentDetails.js): `frontend/src/IncidentDetails.js`
- [Create request](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/CreateRequest.js): `frontend/src/CreateRequest.js`
- [Request list](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/Requests.js): `frontend/src/Requests.js`
- [Request details](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/RequestDetails.js): `frontend/src/RequestDetails.js`
- [HR requests](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/HrRequest.js): `frontend/src/HrRequest.js`
- [Onboarding forms](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/OnboardingForm.js): `frontend/src/OnboardingForm.js`
- [Onboarding details](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/OnboardingRequestDetails.js): `frontend/src/OnboardingRequestDetails.js`
- [Offboarding forms](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/OffboardingForm.js): `frontend/src/OffboardingForm.js`
- [Offboarding details](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/OffboardingRequestDetails.js): `frontend/src/OffboardingRequestDetails.js`
- [Ticket creation](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/CreateTicket.js): `frontend/src/CreateTicket.js`
- [Ticket details](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/TicketDetails.js): `frontend/src/TicketDetails.js`

### Resources and knowledge

- [Asset registry](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/AssetRegistry.js): `frontend/src/AssetRegistry.js`
- [License registry](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/LicenseRegistry.js): `frontend/src/LicenseRegistry.js`
- [Knowledge list](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/KBListView.js): `frontend/src/KBListView.js`
- [Knowledge article](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/KBView.js): `frontend/src/KBView.js`

### Administration

- [Settings hub](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/Settings.js): `frontend/src/SettingsPages/Settings.js`
- [Request configuration](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/AddRequest.js): `frontend/src/SettingsPages/AddRequest.js`
- [Field configuration](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/AddField.js): `frontend/src/SettingsPages/AddField.js`
- [Category form helpers](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/CategoryFormCombined.js): `frontend/src/SettingsPages/CategoryFormCombined.js`
- [Asset settings](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/AssetSettings.js): `frontend/src/SettingsPages/AssetSettings.js`
- [Asset setup](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/CreateAssetRegistry.js): `frontend/src/SettingsPages/CreateAssetRegistry.js`
- [HR request setup](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/CreateHrRequest.js): `frontend/src/SettingsPages/CreateHrRequest.js`
- [Onboarding settings](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/OnboardingSettings.js): `frontend/src/SettingsPages/OnboardingSettings.js`
- [Offboarding settings](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/OffboardingSettings.js): `frontend/src/SettingsPages/OffboardingSettings.js`
- [License mapping](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/LicenseMapping.js): `frontend/src/SettingsPages/LicenseMapping.js`
- [Departments](https://github.com/allen-john-y/ticketing/blob/main/frontend/src/SettingsPages/Departments.js): `frontend/src/SettingsPages/Departments.js`

### Backend services

- [Express API](https://github.com/allen-john-y/ticketing/blob/main/backend/server.js): `backend/server.js`
- [SharePoint upload](https://github.com/allen-john-y/ticketing/blob/main/backend/utils/sharepointUpload.js): `backend/utils/sharepointUpload.js`

### Other components

- **Employee or admin**

## Connections

- Employee or admin → Application routing: uses
- Application routing → Home dashboard: routes (evidence: `frontend/src/App.js`)
- Application routing → Smart search: renders (evidence: `frontend/src/App.js`)
- Application routing → Incident list: routes (evidence: `frontend/src/App.js`)
- Application routing → Create incident: routes (evidence: `frontend/src/App.js`)
- Application routing → Request list: routes (evidence: `frontend/src/App.js`)
- Application routing → Create request: routes (evidence: `frontend/src/App.js`)
- Application routing → HR requests: routes (evidence: `frontend/src/App.js`)
- Application routing → Onboarding forms: routes (evidence: `frontend/src/App.js`)
- Application routing → Offboarding forms: routes (evidence: `frontend/src/App.js`)
- Application routing → Ticket details: routes (evidence: `frontend/src/App.js`)
- Application routing → Settings hub: routes (evidence: `frontend/src/App.js`)
- Incident details → Express API: calls API (evidence: `frontend/src/IncidentDetails.js`)
- Express API → SharePoint upload: calls upload (evidence: `backend/server.js`)
- Request details → Express API: calls API (evidence: `frontend/src/RequestDetails.js`)
- Request configuration → Express API: manages services (evidence: `frontend/src/SettingsPages/AddRequest.js`)
- HR request setup → Express API: manages HR types (evidence: `frontend/src/SettingsPages/CreateHrRequest.js`)
- Onboarding settings → Express API: saves settings (evidence: `frontend/src/SettingsPages/OnboardingSettings.js`)
- License mapping → Express API: saves mappings (evidence: `frontend/src/SettingsPages/LicenseMapping.js`)
- Asset registry → Express API: reads and updates (evidence: `frontend/src/AssetRegistry.js`)
- Field configuration → Category form helpers: uses helpers (evidence: `frontend/src/SettingsPages/AddField.js`)
- Settings hub → Field configuration: routes (evidence: `frontend/src/SettingsPages/Settings.js`)
- Settings hub → Request configuration: routes (evidence: `frontend/src/SettingsPages/Settings.js`)
- Settings hub → Asset settings: routes (evidence: `frontend/src/SettingsPages/Settings.js`)
- Settings hub → License mapping: routes (evidence: `frontend/src/SettingsPages/Settings.js`)
- Settings hub → Departments: routes (evidence: `frontend/src/SettingsPages/Settings.js`)
