# edmozley/freeitsm architecture

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

- Interactive diagram: https://gitdiagram.com/edmozley/freeitsm
- Repository: https://github.com/edmozley/freeitsm

## Overview

FreeITSM is a self-hosted IT service-management platform: staff handle operational work while end users raise and follow requests through a self-service portal and other channels. A central workflow runs from incoming requests to ticket handling and automation; adjacent modules cover assets, knowledge, changes, problems and tasks. The README also documents forms, contracts, LMS, CMDB and integrations as major product areas. Edges reflect documented capabilities or visible source references; many module internals and their wiring were not sampled, so those relationships are omitted.

Main entry points: [`api/tickets`](https://github.com/edmozley/freeitsm/tree/main/api/tickets) (Ticket operations), [`includes/db.php`](https://github.com/edmozley/freeitsm/blob/main/includes/db.php) (MySQL data store), [`includes/messaging/ingest.php`](https://github.com/edmozley/freeitsm/blob/main/includes/messaging/ingest.php) (Channel ingestion), [`includes/functions.php`](https://github.com/edmozley/freeitsm/blob/main/includes/functions.php) (Shared runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_tickets_ui["Ticket workspace"]
  node_self_service["Self-service portal<br/>[index.php]"]
  node_watchtower["Watchtower<br/>[index.php]"]
end

subgraph group_service_ops["Service operations"]
  node_ticket_api["Ticket operations"]
  node_channel_ingest["Channel ingestion<br/>[ingest.php]"]
  node_notifications["Notifications<br/>[notifications.php]"]
  node_workflow["Workflow engine<br/>[engine.php]"]
end

subgraph group_platform["Shared platform"]
  node_database[("MySQL data store<br/>[db.php]")]
  node_shared_runtime["Shared runtime<br/>[functions.php]"]
  node_tenancy["Tenant context<br/>[tenancy.php]"]
end

subgraph group_business_modules["Business modules"]
  node_asset_management["Asset management"]
  node_knowledge["Knowledge base<br/>[index.php]"]
  node_change_management["Change management<br/>[index.php]"]
  node_problem_management["Problem management<br/>[index.php]"]
  node_tasks["Tasks<br/>[index.php]"]
  node_forms["Forms<br/>[index.php]"]
  node_contracts["Contracts<br/>[index.php]"]
  node_lms["Learning management"]
  node_cmdb["Configuration database"]
  node_integrations["External integrations<br/>[integrations.php]"]
end

node_staff(("Staff analyst"))
node_end_user(("End user"))

node_end_user -->|"submits requests"| node_self_service
node_self_service -->|"creates tickets"| node_ticket_api
node_staff -->|"handles tickets"| node_tickets_ui
node_tickets_ui -.->|"manages tickets"| node_ticket_api
node_channel_ingest -->|"stores ticket messages"| node_database
node_channel_ingest -->|"creates or updates tickets"| node_ticket_api
node_ticket_api -->|"dispatches events"| node_workflow
node_staff -->|"reviews attention"| node_watchtower
node_staff -->|"manages assets"| node_asset_management
node_staff -->|"uses knowledge"| node_knowledge
node_staff -->|"manages changes"| node_change_management
node_staff -->|"manages problems"| node_problem_management
node_staff -->|"manages work"| node_tasks
node_staff -->|"builds forms"| node_forms
node_staff -->|"manages contracts"| node_contracts
node_staff -->|"uses training"| node_lms
node_staff -->|"manages configuration"| node_cmdb
node_ticket_api -.->|"reads and writes"| node_database
node_shared_runtime -->|"connects to"| node_database
node_shared_runtime -->|"uses tenant context"| node_tenancy
node_workflow -->|"uses integrations"| node_integrations

click node_tickets_ui "https://github.com/edmozley/freeitsm/tree/main/tickets"
click node_self_service "https://github.com/edmozley/freeitsm/blob/main/self-service/index.php"
click node_watchtower "https://github.com/edmozley/freeitsm/blob/main/watchtower/index.php"
click node_ticket_api "https://github.com/edmozley/freeitsm/tree/main/api/tickets"
click node_channel_ingest "https://github.com/edmozley/freeitsm/blob/main/includes/messaging/ingest.php"
click node_notifications "https://github.com/edmozley/freeitsm/blob/main/includes/services/notifications.php"
click node_workflow "https://github.com/edmozley/freeitsm/blob/main/workflow/includes/engine.php"
click node_asset_management "https://github.com/edmozley/freeitsm/tree/main/asset-management"
click node_knowledge "https://github.com/edmozley/freeitsm/blob/main/knowledge/index.php"
click node_change_management "https://github.com/edmozley/freeitsm/blob/main/change-management/index.php"
click node_problem_management "https://github.com/edmozley/freeitsm/blob/main/problem-management/index.php"
click node_tasks "https://github.com/edmozley/freeitsm/blob/main/tasks/index.php"
click node_forms "https://github.com/edmozley/freeitsm/blob/main/forms/index.php"
click node_contracts "https://github.com/edmozley/freeitsm/blob/main/contracts/index.php"
click node_lms "https://github.com/edmozley/freeitsm/tree/main/api/lms"
click node_cmdb "https://github.com/edmozley/freeitsm/tree/main/api/cmdb"
click node_integrations "https://github.com/edmozley/freeitsm/blob/main/includes/integrations/integrations.php"
click node_database "https://github.com/edmozley/freeitsm/blob/main/includes/db.php"
click node_shared_runtime "https://github.com/edmozley/freeitsm/blob/main/includes/functions.php"
click node_tenancy "https://github.com/edmozley/freeitsm/blob/main/includes/tenancy.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_tickets_ui,node_self_service,node_watchtower,node_end_user toneBlue
class node_ticket_api,node_channel_ingest,node_notifications,node_workflow toneAmber
class node_database,node_shared_runtime,node_tenancy toneMint
class node_asset_management,node_knowledge,node_change_management,node_problem_management,node_tasks,node_forms,node_contracts,node_lms,node_cmdb,node_integrations toneRose
class node_staff toneIndigo
```

## Components

### User experience

- [Ticket workspace](https://github.com/edmozley/freeitsm/tree/main/tickets): `tickets`
- [Self-service portal](https://github.com/edmozley/freeitsm/blob/main/self-service/index.php): `self-service/index.php`
- [Watchtower](https://github.com/edmozley/freeitsm/blob/main/watchtower/index.php): `watchtower/index.php`

### Service operations

- [Ticket operations](https://github.com/edmozley/freeitsm/tree/main/api/tickets): `api/tickets`
- [Channel ingestion](https://github.com/edmozley/freeitsm/blob/main/includes/messaging/ingest.php): `includes/messaging/ingest.php`
- [Notifications](https://github.com/edmozley/freeitsm/blob/main/includes/services/notifications.php): `includes/services/notifications.php`
- [Workflow engine](https://github.com/edmozley/freeitsm/blob/main/workflow/includes/engine.php): `workflow/includes/engine.php`

### Shared platform

- [MySQL data store](https://github.com/edmozley/freeitsm/blob/main/includes/db.php): `includes/db.php`
- [Shared runtime](https://github.com/edmozley/freeitsm/blob/main/includes/functions.php): `includes/functions.php`
- [Tenant context](https://github.com/edmozley/freeitsm/blob/main/includes/tenancy.php): `includes/tenancy.php`

### Business modules

- [Asset management](https://github.com/edmozley/freeitsm/tree/main/asset-management): `asset-management`
- [Knowledge base](https://github.com/edmozley/freeitsm/blob/main/knowledge/index.php): `knowledge/index.php`
- [Change management](https://github.com/edmozley/freeitsm/blob/main/change-management/index.php): `change-management/index.php`
- [Problem management](https://github.com/edmozley/freeitsm/blob/main/problem-management/index.php): `problem-management/index.php`
- [Tasks](https://github.com/edmozley/freeitsm/blob/main/tasks/index.php): `tasks/index.php`
- [Forms](https://github.com/edmozley/freeitsm/blob/main/forms/index.php): `forms/index.php`
- [Contracts](https://github.com/edmozley/freeitsm/blob/main/contracts/index.php): `contracts/index.php`
- [Learning management](https://github.com/edmozley/freeitsm/tree/main/api/lms): `api/lms`
- [Configuration database](https://github.com/edmozley/freeitsm/tree/main/api/cmdb): `api/cmdb`
- [External integrations](https://github.com/edmozley/freeitsm/blob/main/includes/integrations/integrations.php): `includes/integrations/integrations.php`

### Other components

- **Staff analyst**
- **End user**

## Connections

- End user → Self-service portal: submits requests
- Self-service portal → Ticket operations: creates tickets
- Staff analyst → Ticket workspace: handles tickets
- Ticket workspace → Ticket operations: manages tickets
- Channel ingestion → MySQL data store: stores ticket messages (evidence: `includes/messaging/ingest.php`)
- Channel ingestion → Ticket operations: creates or updates tickets (evidence: `includes/messaging/ingest.php`)
- Ticket operations → Workflow engine: dispatches events (evidence: `workflow/includes/engine.php`)
- Staff analyst → Watchtower: reviews attention
- Staff analyst → Asset management: manages assets
- Staff analyst → Knowledge base: uses knowledge
- Staff analyst → Change management: manages changes
- Staff analyst → Problem management: manages problems
- Staff analyst → Tasks: manages work
- Staff analyst → Forms: builds forms
- Staff analyst → Contracts: manages contracts
- Staff analyst → Learning management: uses training
- Staff analyst → Configuration database: manages configuration
- Ticket operations → MySQL data store: reads and writes
- Shared runtime → MySQL data store: connects to (evidence: `includes/functions.php`)
- Shared runtime → Tenant context: uses tenant context (evidence: `includes/functions.php`)
- Workflow engine → External integrations: uses integrations (evidence: `workflow/includes/engine.php`)
