# piraidasan/tms-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/piraidasan/tms-frontend
- Repository: https://github.com/piraidasan/tms-frontend

## Overview

#### Purpose and runtime
TMS Frontend is an Angular 20 single-page administrative application for token/queue management. It supports dashboard monitoring, kiosk/token operations, location and workflow setup, users/roles/features, global configuration, and operational reports. It runs in the browser; Angular CLI provides local serving and production builds. Entry points are `src/main.ts`, `src/app/app.ts`, and `src/app/app.config.ts`.

#### Application shell and navigation
The root application composes global providers, styles, and route rendering. Route definitions determine public versus management screens, while the dashboard layout provides persistent navbar/sidebar chrome for authenticated areas.
- `src/app/app.routes.ts`
- `src/app/components/layout/dashboard-layout.component.ts`
- `src/app/components/sidebar/sidebar.component.ts`

#### Authentication and route boundary
Login and location-login pages establish the authenticated context. An auth guard protects restricted routes; `AuthService` owns auth-related client behavior, with environment auth configuration separating deployment settings.
- `src/app/pages/login/login.component.ts`
- `src/app/core/guards/auth.guard.ts`
- `src/app/core/services/auth.service.ts`
- `src/environments/auth-config.ts`

#### API access and service layer
Page components call domain-specific services, which centralize backend resource access. `HttpWrapperService`, API configuration, response interfaces, and `BaseCrudService` form the shared HTTP/error/CRUD boundary. The backend itself is external and not included in this repository.
- `src/app/core/services/http-wrapper.service.ts`
- `src/app/core/services/base-crud.service.ts`
- `src/app/core/services/api-config.service.ts`
- `src/app/services/token-transaction.service.ts`

#### Operational domains
Management functionality is organized by page/service pairs: location hierarchy and counters, workflow stages/service categories, customer/application settings, and user roles/features/accounts. Create/edit/list pages are separate routed feature screens over these domains.
- `src/app/pages/location-management/location-management.component.ts`
- `src/app/services/location-management/location.service.ts`
- `src/app/pages/workflow-management/workflow-management.component.ts`
- `src/app/services/workflow-management/stage.service.ts`
- `src/app/services/user-management/user.service.ts`

#### Kiosk, dashboard, and reporting flows
The kiosk and Enjaz token-management screens initiate or manage token transactions; dashboard data is loaded through its dedicated service. Report pages query historical, queue-list, and TAT report services and present operational analysis.
- `src/app/pages/kiosk/kiosk.component.ts`
- `src/app/pages/dashboard/dashboard.component.ts`
- `src/app/services/dashboard/dashboard.service.ts`
- `src/app/services/reports/tat-report.service.ts`

#### Client state and reusable interaction layer
State services retain selected location, feature/role data, master data, and tabs across routed views. A refresh bus coordinates invalidation/reload behavior. Shared UI components provide tables, forms, modal confirmation, notifications, date ranges, and icon rendering; pages should use these rather than duplicate interaction primitives.
- `src/app/services/state/location-state.service.ts`
- `src/app/services/state/master-data-store.service.ts`
- `src/app/core/services/refresh-bus.service.ts`
- `src/app/components/common/dynamic-table/dynamic-table.component.ts`
- `src/app/components/common/notification/toast-notification.component.ts`

#### Deployment assets and localization
Build/runtime configuration varies by environment (development, UAT, production). The frontend ships static kiosk/icon assets and translation catalogs, including Arabic, German, English, and Italian.
- `src/environments/environment.ts`
- `src/environments/environment.uat.ts`
- `src/environments/environment.prod.ts`
- `src/assets/i18n/en.json`
- `public/assets/kiosk`

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application Shell"]
  node_bootstrap(("Angular Bootstrap<br/>browser entry<br/>[main.ts]"))
  node_app["Root App &amp; Providers<br/>application shell<br/>[app.ts]"]
  node_app_config["App Configuration<br/>provider config<br/>[app.config.ts]"]
  node_routes["Route Definitions<br/>router<br/>[app.routes.ts]"]
  node_dashboard_layout["Dashboard Layout<br/>authenticated shell"]
  node_sidebar["Sidebar Navigation<br/>navigation component"]
end

subgraph group_access["Access Boundary"]
  node_login["Login Screens<br/>public pages<br/>[login.component.ts]"]
  node_auth_guard{{"Auth Guard<br/>route guard<br/>[auth.guard.ts]"}}
  node_auth_service["Auth Service<br/>auth client<br/>[auth.service.ts]"]
end

subgraph group_domains["Operational Domains"]
  node_management["Management Screens<br/>routed feature pages"]
  node_management_services["Management Services<br/>domain services"]
  node_operations["Kiosk &amp; Token Operations<br/>routed operational pages<br/>[kiosk.component.ts]"]
  node_dashboard_reports["Dashboard &amp; Reports<br/>analytics pages"]
end

subgraph group_platform["Shared Platform"]
  node_api_boundary["HTTP / CRUD Boundary<br/>API client layer"]
  node_state_ui["State, Refresh &amp; Shared UI<br/>client interaction layer"]
end

subgraph group_delivery["Deployment Assets"]
  node_environment["Environment &amp; Auth Config<br/>deployment configuration<br/>[environment.ts]"]
  node_localization_assets["Translations &amp; Kiosk Assets<br/>static assets<br/>[en.json]"]
end

node_backend[("External TMS Backend<br/>external API")]

node_bootstrap -->|"boots"| node_app
node_app -->|"uses providers"| node_app_config
node_app -->|"renders routes"| node_routes
node_routes -->|"public routes"| node_login
node_routes -->|"protects management"| node_auth_guard
node_auth_guard -->|"checks session"| node_auth_service
node_auth_service -.->|"reads auth settings"| node_environment
node_routes -->|"authenticated area"| node_dashboard_layout
node_dashboard_layout -->|"contains"| node_sidebar
node_dashboard_layout -->|"hosts"| node_management
node_dashboard_layout -->|"hosts"| node_operations
node_dashboard_layout -->|"hosts"| node_dashboard_reports
node_management -->|"calls"| node_management_services
node_operations -->|"token requests"| node_api_boundary
node_dashboard_reports -->|"loads analytics"| node_api_boundary
node_management_services -->|"uses"| node_api_boundary
node_api_boundary -->|"HTTP requests"| node_backend
node_management -->|"shares state and UI"| node_state_ui
node_operations -->|"uses shared UI"| node_state_ui
node_dashboard_reports -->|"uses refresh and UI"| node_state_ui
node_app_config -.->|"environment settings"| node_environment
node_app -.->|"ships localized assets"| node_localization_assets

click node_bootstrap "https://github.com/piraidasan/tms-frontend/blob/main/src/main.ts"
click node_app "https://github.com/piraidasan/tms-frontend/blob/main/src/app/app.ts"
click node_app_config "https://github.com/piraidasan/tms-frontend/blob/main/src/app/app.config.ts"
click node_routes "https://github.com/piraidasan/tms-frontend/blob/main/src/app/app.routes.ts"
click node_dashboard_layout "https://github.com/piraidasan/tms-frontend/blob/main/src/app/components/layout/dashboard-layout.component.ts"
click node_sidebar "https://github.com/piraidasan/tms-frontend/blob/main/src/app/components/sidebar/sidebar.component.ts"
click node_login "https://github.com/piraidasan/tms-frontend/blob/main/src/app/pages/login/login.component.ts"
click node_auth_guard "https://github.com/piraidasan/tms-frontend/blob/main/src/app/core/guards/auth.guard.ts"
click node_auth_service "https://github.com/piraidasan/tms-frontend/blob/main/src/app/core/services/auth.service.ts"
click node_management "https://github.com/piraidasan/tms-frontend/blob/main/src/app/pages/location-management/location-management.component.ts"
click node_management_services "https://github.com/piraidasan/tms-frontend/blob/main/src/app/services/location-management/location.service.ts"
click node_operations "https://github.com/piraidasan/tms-frontend/blob/main/src/app/pages/kiosk/kiosk.component.ts"
click node_dashboard_reports "https://github.com/piraidasan/tms-frontend/blob/main/src/app/pages/dashboard/dashboard.component.ts"
click node_api_boundary "https://github.com/piraidasan/tms-frontend/blob/main/src/app/core/services/http-wrapper.service.ts"
click node_state_ui "https://github.com/piraidasan/tms-frontend/blob/main/src/app/services/state/location-state.service.ts"
click node_environment "https://github.com/piraidasan/tms-frontend/blob/main/src/environments/environment.ts"
click node_localization_assets "https://github.com/piraidasan/tms-frontend/blob/main/src/assets/i18n/en.json"

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_bootstrap,node_app,node_app_config,node_routes,node_dashboard_layout,node_sidebar toneBlue
class node_login,node_auth_guard,node_auth_service toneAmber
class node_management,node_management_services,node_operations,node_dashboard_reports toneMint
class node_api_boundary,node_state_ui toneRose
class node_environment,node_localization_assets toneIndigo
class node_backend toneNeutral
```

## Components

### Application Shell

- [Angular Bootstrap](https://github.com/piraidasan/tms-frontend/blob/main/src/main.ts): browser entry · Starts the Angular single-page application. · `src/main.ts`
- [Root App & Providers](https://github.com/piraidasan/tms-frontend/blob/main/src/app/app.ts): application shell · `src/app/app.ts`
- [App Configuration](https://github.com/piraidasan/tms-frontend/blob/main/src/app/app.config.ts): provider config · `src/app/app.config.ts`
- [Route Definitions](https://github.com/piraidasan/tms-frontend/blob/main/src/app/app.routes.ts): router · Separates public and management routes. · `src/app/app.routes.ts`
- [Dashboard Layout](https://github.com/piraidasan/tms-frontend/blob/main/src/app/components/layout/dashboard-layout.component.ts): authenticated shell · Persistent navbar and sidebar chrome. · `src/app/components/layout/dashboard-layout.component.ts`
- [Sidebar Navigation](https://github.com/piraidasan/tms-frontend/blob/main/src/app/components/sidebar/sidebar.component.ts): navigation component · `src/app/components/sidebar/sidebar.component.ts`

### Access Boundary

- [Login Screens](https://github.com/piraidasan/tms-frontend/blob/main/src/app/pages/login/login.component.ts): public pages · Establish authenticated or location-login context. · `src/app/pages/login/login.component.ts`
- [Auth Guard](https://github.com/piraidasan/tms-frontend/blob/main/src/app/core/guards/auth.guard.ts): route guard · `src/app/core/guards/auth.guard.ts`
- [Auth Service](https://github.com/piraidasan/tms-frontend/blob/main/src/app/core/services/auth.service.ts): auth client · `src/app/core/services/auth.service.ts`

### Operational Domains

- [Management Screens](https://github.com/piraidasan/tms-frontend/blob/main/src/app/pages/location-management/location-management.component.ts): routed feature pages · Location, workflow, settings, users, roles, and features. · `src/app/pages/location-management/location-management.component.ts`
- [Management Services](https://github.com/piraidasan/tms-frontend/blob/main/src/app/services/location-management/location.service.ts): domain services · Location, stage, and user resource access. · `src/app/services/location-management/location.service.ts`
- [Kiosk & Token Operations](https://github.com/piraidasan/tms-frontend/blob/main/src/app/pages/kiosk/kiosk.component.ts): routed operational pages · Kiosk and Enjaz flows create or manage tokens. · `src/app/pages/kiosk/kiosk.component.ts`
- [Dashboard & Reports](https://github.com/piraidasan/tms-frontend/blob/main/src/app/pages/dashboard/dashboard.component.ts): analytics pages · Operational monitoring and historical queue/TAT analysis. · `src/app/pages/dashboard/dashboard.component.ts`

### Shared Platform

- [HTTP / CRUD Boundary](https://github.com/piraidasan/tms-frontend/blob/main/src/app/core/services/http-wrapper.service.ts): API client layer · Shared HTTP, API configuration, errors, and CRUD behavior. · `src/app/core/services/http-wrapper.service.ts`
- [State, Refresh & Shared UI](https://github.com/piraidasan/tms-frontend/blob/main/src/app/services/state/location-state.service.ts): client interaction layer · Cross-route state, reload coordination, tables, forms, and notifications. · `src/app/services/state/location-state.service.ts`

### Deployment Assets

- [Environment & Auth Config](https://github.com/piraidasan/tms-frontend/blob/main/src/environments/environment.ts): deployment configuration · Development, UAT, production, and auth settings. · `src/environments/environment.ts`
- [Translations & Kiosk Assets](https://github.com/piraidasan/tms-frontend/blob/main/src/assets/i18n/en.json): static assets · Localized catalogs and shipped kiosk/icon assets. · `src/assets/i18n/en.json`

### Other components

- **External TMS Backend**: external API · Backend resource API is outside this repository.

## Connections

- Angular Bootstrap → Root App & Providers: boots
- Root App & Providers → App Configuration: uses providers
- Root App & Providers → Route Definitions: renders routes
- Route Definitions → Login Screens: public routes
- Route Definitions → Auth Guard: protects management
- Auth Guard → Auth Service: checks session
- Auth Service → Environment & Auth Config: reads auth settings
- Route Definitions → Dashboard Layout: authenticated area
- Dashboard Layout → Sidebar Navigation: contains
- Dashboard Layout → Management Screens: hosts
- Dashboard Layout → Kiosk & Token Operations: hosts
- Dashboard Layout → Dashboard & Reports: hosts
- Management Screens → Management Services: calls
- Kiosk & Token Operations → HTTP / CRUD Boundary: token requests
- Dashboard & Reports → HTTP / CRUD Boundary: loads analytics
- Management Services → HTTP / CRUD Boundary: uses
- HTTP / CRUD Boundary → External TMS Backend: HTTP requests
- Management Screens → State, Refresh & Shared UI: shares state and UI
- Kiosk & Token Operations → State, Refresh & Shared UI: uses shared UI
- Dashboard & Reports → State, Refresh & Shared UI: uses refresh and UI
- App Configuration → Environment & Auth Config: environment settings
- Root App & Providers → Translations & Kiosk Assets: ships localized assets
