Repository navigation
Consumables Developer Guide
The internals of Assets → Consumables (5.8.0). Design and decisions: Consumables - design.
In one sentence: one service, ConsumablesService, is the only writer of eleven tables; stock is an append-only ledger with a running total kept in step inside the same locked transaction, and every other feature - tickets, Watchtower, the bell, Forms, stock takes - reads or writes through that service.
| File | What |
|---|---|
🟣 includes/services/consumables.php
|
ConsumablesService - items, types, the ledger (move(), reverse()), low stock (checkLow()), stock takes, the differences report, verify()
|
🟣 api/assets/consumables.php
|
GET list, item, meta, movements, people, counts, count, differences, verify; POST save_item, save_type, move, reverse, count_start, count_line, count_finish, count_cancel
|
🟣 asset-management/consumables/index.php + assets/js/consumables.js
|
The list, the item panel, the dialogs; ?item=, ?status=low, ?ticket=
|
🟣 asset-management/consumables/deliveries.php
|
Deliveries: the list, New (lines), one delivery with its Documents panel (inline script) |
🟣 asset-management/consumables/stocktake.php
|
Stock takes (inline script) |
🟣 asset-management/consumables/report.php
|
Differences, with an SVG chart drawn in the page - no library |
🎨 assets/css/consumables.css
|
All three pages; theme tokens only |
🟣 asset-management/settings/index.php, manifest.php
|
The Consumables tab; Cap::ASSETS_CONSUMABLES (the tab) and the actions entry for Cap::ASSETS_CONSUMABLES_ADJUST
|
🟣 includes/capabilities.php
|
The two caps |
🟣 includes/services/record_fields.php
|
A third entity, consumable, scoped by consumable_type_id
|
🟣 system/custom-fields/index.php, api/system/custom_fields.php
|
The Consumables tab, with a type per field |
🟣 assets/js/inbox.js, lang/*/tickets.php
|
Link to... → Consumables opens consumables/?ticket=N
|
🟣 includes/watchtower_queries.php, watchtower/index.php
|
Low stock on the Assets card |
🟣 includes/services/notifications.php, includes/entity_links.php
|
consumable.low_stock; entity consumable → asset-management/consumables/?item=N
|
🟣 forms/fill.php
|
Reads a Reorder hand-over from sessionStorage
|
🗄️ database/freeitsm.sql, includes/db_verify_schema.php, api/system/db_verify.php, includes/db_verify_indexes.php (generated), includes/db_verify_modules.php, includes/analyst_lifecycle.php
|
The tables, keys, module and lifecycle rows |
🧪 tests/consumables.php
|
37 checks on the ledger's rules |
| Table | Holds |
|---|---|
consumable_types |
Types; retired (is_active = 0), never deleted |
consumable_stores |
A store per company (tenant_id); location_id waits for stores per site |
consumable_items |
Items: company, type, name, part number, unit, supplier, unit_cost, notes |
consumable_stock |
UNIQUE (item_id, store_id): on_hand, min_level, reorder_point, low_notified_datetime
|
consumable_deliveries |
One order: store, company (tenant_id, for the documents' scope), supplier, order_ref (optional), invoice number and date, received_date, note |
consumable_movements |
The ledger - see below; a receipt (and its undo) carries delivery_id
|
consumable_counts, consumable_count_lines
|
Stock takes; per item expected, counted, difference, unit_cost, value_difference, movement_id
|
consumable_audit |
Field-by-field changes to items, types and stock takes |
consumable_fields, consumable_field_options, consumable_field_values
|
Custom fields (TypedFields) |
CREATE TABLE IF NOT EXISTS `consumable_movements` (
`id` INT NOT NULL AUTO_INCREMENT,
`item_id` INT NOT NULL,
`store_id` INT NOT NULL,
`kind` VARCHAR(12) NOT NULL, -- receive | issue | return | adjust | count | reverse
`quantity` INT NOT NULL, -- signed: + into the store, - out of it
`balance_after` INT NOT NULL,
`unit_cost` DECIMAL(12,2) NULL, -- valued at this, for ever
`ticket_id`, `recipient_user_id`, `supplier_id`, `invoice_ref`, `invoice_date`, `reason`,
`reverses_id` INT NULL, -- the movement this one undoes
`count_id` INT NULL, -- the stock take that posted it
`analyst_id` INT NULL,
`source` VARCHAR(20) NOT NULL DEFAULT 'app', -- app | ticket | api
`created_datetime` DATETIME NOT NULL, -- UTC
UNIQUE KEY `uq_consumable_movements_reverses` (`reverses_id`), -- undone once, never twice
...
);The ledger's foreign keys are RESTRICT: an item or a store with history is retired, never deleted - deleting would take the books with it.
TRAP: nothing updates or deletes a movement. Not the service, not the API, not a migration. A mistake is undone with reverse(), which writes the opposite quantity with reverses_id pointing back; the unique key makes a second undo impossible even under a race.
Every change of stock goes the same way:
$owns = !$conn->inTransaction();
if ($owns) $conn->beginTransaction();
$s = self::lockStock($conn, $itemId, $store); // INSERT IGNORE, then SELECT ... FOR UPDATE
$after = (int)$s['on_hand'] + $signed;
if ($after < 0) throw new ServiceError('conflict', 'not_enough', 'Only ' . (int)$s['on_hand'] . ' in stock.');
$mid = self::insertMovement($conn, $ctx, [... 'quantity' => $signed, 'balance_after' => $after, 'unit_cost' => $cost ...]);
$conn->prepare("UPDATE consumable_stock SET on_hand = ? ... WHERE id = ?")->execute([$after, $s['id']]);
if ($owns) $conn->commit();- Locked: two analysts issuing the last toner at once - the second waits, then sees 0 and is refused.
- Never below zero (Ed): the check is on the locked figure.
-
balance_afterlets anybody audit a single item's history line by line; the test checks it adds up. -
verify()returns every stock row whoseon_handdiffers fromSUM(quantity)of its ledger. It never fixes anything; it is for the API's?action=verify, the tests, and anybody wondering. -
Price: a receipt with a unit cost different from the item's updates the item's
unit_cost(recorded inconsumable_audit) - Ed: value at the latest receipt. Every movement stores the cost it was valued at.
Every receipt belongs to a delivery. move('receive', ...) without a delivery_id makes a one-line delivery inside its own transaction (newDelivery()); receiveDelivery() makes the delivery and calls move() per line with its delivery_id. The API's move action unsets delivery_id, so a browser cannot attach a receipt to somebody else's delivery - only receive_delivery creates that link.
public static function receiveDelivery(PDO $conn, ActorContext $ctx, array $in): array
// lines [{item_id, quantity, unit_cost}] - every line's item, company, quantity and price is
// checked BEFORE anything is written, so a bad line never leaves half a delivery booked in -
// even when the caller holds the transaction (the test does) and cannot roll back.- One company per delivery: every item must belong to the same company, whose store it goes into.
-
reverseDelivery()reverses every receipt on it not already reversed, with one reason, all or nothing; each undo keeps thedelivery_id, so a delivery's page shows both. -
saveDelivery()changes supplier, order number, invoice, dates and note, recording each change inconsumable_audit.delivery_id. -
Documents:
documentEntityRegistry()['consumable_delivery']-canchecks the delivery's company withanalystCanAccessTenant(),filterisactiveTenantFilter()onconsumable_deliveries.tenant_id,title_sqlfalls back to Delivery #N when there is no order number. The page callsrenderDocumentsPanel('consumable_delivery', $id); nothing else was needed.
-
ConsumablesService::ticketItems($ticketId)- the active items of the TICKET's company (not the analyst's active one) with on hand;?action=ticket_items. The right-click flyout#ctxConsumablesSubmenu(populateContextConsumablesSubmenu()ininbox.js) draws them and callsFreeitsmSelectSearch.filterList(sub, ..., {cap: 10, always: true})-alwaysis new: the search box whatever the length.select-search.jsis only loaded on multi-company pages, soensureSelectSearch()fetches it the first time the menu needs it. -
issueToTicket($ticketId, $itemId, $qty)-move('issue')against the ticket, totickets.user_id,source = 'ticket';POST action=issue_to_ticket. -
move()refuses an item from another company's stock than the ticket's (ticketTenant(), NULL = Default) - a ticket only ever takes from its own company's store, whichever door was used. -
forTicket($ticketId)-issued: the ticket's issue / return / reverse movements;requested: the items named by alookupanswer on theconsumablesource in a form submission for the ticket (form_submissions.ticket_id, orticket_forms.submission_id), each withissued_here.loadTicketConsumables()draws both in#stripConsumablePills; the ✕ on a used one callsreversewith a reason fromshowConfirm({textarea}). -
Forms:
FormsService::LOOKUP_SOURCES['consumable']-consumable_items, labelname, searchname+part_number,tenant_coltenant_id,whereis_active = 1,portal_safetrue (item names are what a customer asks for). The builder'sLOOKUP_SOURCESlist and the AI form generator's prompt name it too. A lookup answer is stored{"id", "label"}, so a request keeps saying what was asked for even if the item is renamed. - Asking never moves stock - deliberately no workflow or form action that issues: "issued" means a person handed it over.
| Action | Check |
|---|---|
| Read anything | requireModuleAccessJson('assets') |
| Items, receive, issue, return, undo those, counting a line | plus requireModuleWriteJson('assets') (read-only Assets cannot) |
| Types | plus requireCapabilityJson(Cap::ASSETS_CONSUMABLES)
|
| Adjust, undo an adjustment, finish a stock take |
Cap::ASSETS_CONSUMABLES_ADJUST - checked in the service (mayAdjust()), so it holds whatever calls it |
ASSETS_CONSUMABLES_ADJUST is declared in the manifest's actions with no restrict: an always-restricted everyday-work capability. Administrators hold it (is_admin holds every capability); anybody else needs a role with it - System → Roles shows it as Adjust consumable stock and finish stock takes, sensitive.
Company scope: items carry tenant_id; lists use activeTenantFilter(); one item is checked with analystCanAccessTenant(); a ticket with analystCanAccessTicket(); a person with analystCanAccessUser().
checkLow() runs after every movement and every save, and never stops the movement that caused it (it catches and logs):
- at or below
reorder_pointandlow_notified_datetime IS NULL→ notify everyone inconsumables_low_notify(a list of analyst ids, ticked in Settings), then set it; - above
reorder_point→ clear it, so the next dip tells again.
Watchtower's number is ConsumablesService::lowCount() - the same listItems(['status' => 'low']) the link opens, so the count and the list agree (the rule from Watchtower links).
inbox.js adds Consumables to Link to... (linkAddChoose('consumables')), opening asset-management/consumables/?ticket=N in a new tab. The page resolves the ticket on the server (analystCanAccessTicket(), its number, subject and requester tickets.user_id) and hands it to the script as CONSUMABLES.ticket; the rows get Issue, and the dialog sends ticket_id, the requester as recipient_user_id, and source: 'ticket'. ticketNote() writes a ticket_audit line (Consumable issued: "1 x USB mouse to Sam Taylor").
Settings stores consumables_reorder_form (a form id) and consumables_reorder_map (JSON {item, part_number, supplier, quantity, unit_cost, note} → form field ids), chosen from drop-downs - nothing typed. Reorder:
const target = Math.max(item.reorder_point || 0, item.min_level || 0, 1) * 2;
const suggest = Math.max(1, target - item.on_hand);
sessionStorage.setItem('freeitsm.formPrefill.' + formId, JSON.stringify(answers)); // {field id: value}
location.href = '../../forms/fill.php?id=' + formId;forms/fill.php (loadForm()) reads that key once, deletes it, and hands it to the existing applyDraftValues() - the function drafts already use. Same tab on purpose: sessionStorage does not follow a link opened with noopener.
-
startCount()- one open stock take per store. -
countLine()- expected is what the ledger says at that moment;difference = counted - expectedand its value are fixed then. Counting again replaces the line; both are inconsumable_audit. -
finishCount()- posts each non-zero difference as acountmovement. It posts the difference, not the counted figure, so stock issued between counting and finishing still comes out right. Clamped at zero (the movement's quantity is what actually changed; the reason keeps expected and counted). -
differences()- finished stock takes only; by month (built in UTC withDateTimeImmutable-strtotime()in the server's zone gave one month twice and lost another across summer time) and by item, losses and gains summed separately.
RecordFieldsService::ENTITIES['consumable'] with scope_col => 'consumable_type_id' (NULL = every type). fieldsFor($conn, 'consumable', $typeId) returns the shared fields plus that type's; saveItem() drops answers for fields the item's type does not have, and write() records each change in consumable_audit. The person entity's company scope works as before (scope_col => 'tenant_id'); tests/record-fields.php still passes.
FREEITSM_TEST_DATABASE=<throwaway db> php tests/consumables.php
57 checks, in a transaction that is always rolled back - including using one on a ticket (to its requester, listed as used, another company's item refused) and a form's lookup asking for one (listed, no stock moved, marked used once used), and deliveries: three lines booked in as one delivery with its order number and value, the order number from the item's side, all or nothing, a single Receive making its own delivery, the order number optional, a header change recorded, documents registered, the list finding a delivery by an item on it, and undoing a whole delivery once: fields per type and their history; receive, issue, the new price; too many refused; 0 and negatives refused; adjust needs the permission and a reason; undo once, an undo cannot be undone, the original never changes; the bell once per dip and again after recovering; one stock take at a time, expected/counted/difference/value, finishing posts the difference with stock issued in between, a stock take's posting cannot be undone, the report; on hand equals the ledger, verify() is clean, and balance_after adds up line by line.
FreeITSM — an open-source IT Service Management platform · github.com/edmozley/freeitsm · MIT licence
- Installation
- ⏰ Scheduled tasks (cron jobs)
-
Architecture
- ↳ 🧹 Root folder tidy (URL routing)
- ↳ 🔗 Database Integrity (FKs & constraints)
- ↳ 🛠️ Database Verification — Developer Guide
- ↳ 🧩 Service Layer (UI + API share code)
- ↳ 🪤 Code traps (the TRAP: comments)
- ↳ 📝 Commenting for the Engineering wiki
- ↳ 🛠️ Engineering wiki scanner - Developer Guide
- ↳ 📊 Service-Layer progress
- 🤝 Contributing (read before a pull request)
- 🧪 Developer tests
- 📄 PDF exports moved to PDFKit (#254)
- AI Providers
- Internationalisation (i18n)
- Timezones & Time Handling
- 📅 Date & Time Formats
- 💱 Currencies
- 🧭 The sidebar (optional module rail)
- 🧩 Preference templates
- 🔀 Display order (modules, Watchtower cards) — Developer Guide
- Theming & Dark Mode
- 🗂️ Recent — getting back to what you were doing
- ⌨️ Command palette (⌘K)
- 🔍 Searching inside tickets
- 📄 Attached documents
-
Mobile‑Friendly
- ↳ 🎫 Mobile: Tickets
- ↳ 💻 Mobile: Assets
- ↳ 📅 Mobile: Calendar
- ↳ 📚 Mobile: Knowledge
- ↳ 🚦 Mobile: Service Status
- ↳ 🗼 Mobile: Watchtower
- ↳ 🧩 Mobile: Problem Management
- ↳ 🔁 Mobile: Change Management
- ↳ 💿 Mobile: Software
- ↳ ✅ Mobile: Tasks
- ↳ 📝 Mobile: Forms
- ↳ 📄 Mobile: Contracts
- ↳ 📄 Mobile: Domains
- ↳ 📄 Mobile: People
- ↳ 🚀 Mobile: Projects
- ↳ 🗂️ Mobile: Files
- ↳ 🎓 Mobile: LMS
- ↳ 🗺️ Mobile: CMDB
- ↳ 🗺️ Mobile: Network Mapper
- ↳ 🧭 Mobile: Process Mapper
- ↳ ⚙️ Mobile: Workflow
- ↳ 🖥️ Mobile: System
- ↳ 📊 Mobile: Reporting
- ↳ 📖 Mobile: System Wiki
- ↳ 🙋 Mobile: Self-Service Portal
- ↳ 🧰 Mobile: Techniques & Tricks
-
Security
- Layer 1 — which modules you can enter
- ↳ 🧩 Module Access Control
- ↳ 🛠️ Module Access — Developer Guide
- ↳ 🔌 Switching modules off
- ↳ 🛠️ Module availability — Developer Guide
- ↳ 📐 Module availability — design (#217)
- Layer 2 — what you can administer
- ↳ 🎭 Roles & Permissions
- ↳ 🛠️ Roles — Developer Guide
- ↳ 🔤 Why capabilities are constants
- Layer 3 — the System module
- ↳ 🔑 Admin Access Control
- Hardening
- ↳ 📄 Security review response 2026-08
- ↳ 🛡️ Security hardening 2026-08
- ↳ 🛠️ Security hardening 2026-08 — Developer Guide
- ↳ 🛡️ Round three — plain English
- ↳ 🛠️ Round three — Developer Guide
- ↳ 🛡️ CSRF protection (S4) — Developer Guide
- Single Sign-On (SSO)
- 🗂️ LDAP & Active Directory
-
🟦 Microsoft Entra ID
- ↳ 📥 Importing people and groups
- ↳ 💻 Intune: assets to their primary user
- ↳ 🏢 Organisation chart
- ↳ 🛠️ Entra directory sync — Developer Guide
- ↳ 🛠️ Entra import - review (#235)
- ↳ 🛠️ Entra follow-ups - review (#237-#240)
- ↳ 🛠️ Intune primary user - review (#236)
- ↳ 🛠️ Intune after an Entra import - review (#334)
- ↳ 🛠️ Intune primary user history - review (#338)
- ↳ 🛠️ Intune asset types - review (#339)
- ↳ 🛠️ Intune scheduled syncs - review (#344)
- ↳ 🛠️ Microsoft 365 in Integrations - review (#352)
- ↳ 🛠️ Organisation chart - reviews (#242, #265)
- 📇 CardDAV contact sync
- Browser Extension
- API Reference
-
🔌 REST API — how it works
- ↳ 📜 Script library (PowerShell + Python)
- ↳ 📋 Proposal: custom fields, inventory import and change evidence (#194)
- ↳ 🛠️ Custom fields, evidence + inventory - review (#195-#197)
- ↳ 🛠️ Long forms in a task's Work view - review (#198)
- ↳ 🛠️ Empty Procedures fold - review (#247)
- ↳ 🎫 REST API: Tickets
- ↳ 💻 REST API: Assets
- ↳ 🔴 REST API: Problems
- ↳ 🟠 REST API: Changes
- ↳ 📚 REST API: Knowledge
- ↳ ✅ REST API: Tasks
- ↳ 🗄️ REST API: CMDB
- ↳ 📜 REST API: Contracts
- ↳ 🗓️ REST API: Calendar
- ↳ 💿 REST API: Software
- ↳ 🌐 REST API: Domains
- ↳ 🚦 REST API: Service Status
- ↳ ☀️ REST API: Morning Checks
- ↳ 📝 REST API: Forms
- ↳ ⚙️ REST API: Workflow
- ↳ 🏷️ REST API: Cost centres
- ↳ 🏢 REST API: Companies
- ↳ 📒 REST API: Chart of accounts
- ↳ 📁 REST API: Projects
- ↳ 🛡️ API threat protection
- ↳ 🧑💼 REST API: Analysts
- ↳ 🗺️ REST API: Network Mapper
- ↳ 🧭 Using the API docs page
- ↳ 📐 OpenAPI specification
- ↳ ✅ OpenAPI: kept correct
- ↳ 🛠️ Maintaining the catalogue
- Watchtower
-
Tickets
- ↳ Reply subject and replying to one message
- ↳ 🔄 Live updates
- ↳ 🛠️ Watching a ticket - Developer Guide (1 of 2)
- ↳ ✉️ Ticket address suggestions - Developer Guide
- ↳ 🛠️ CSAT delay and reminder - Developer Guide
- ↳ 🛠️ Ticket checklist step types - Developer Guide (1 of 2)
- ↳ 🛠️ Right-click Attach checklist - Developer Guide
- ↳ 🛠️ Checklists in the REST API - Developer Guide
- ↳ 🔗 A ticket's related block and attachments - Developer Guide
- ↳ 🛠️ Inbox.js map — Developer Guide
- ↳ 🛠️ Floating windows & the file viewer — Developer Guide
- ↳ 🛠️ Tickets settings — Developer Guide
- ↳ 📐 Simpler ticket and task forms - design (#218)
- ↳ 🗂️ The ticket workspace
- ↳ 📋 Forms on tickets
- ↳ 📊 The ticket table
- ↳ 📋 Rota copy and paste — Developer Deep Dive
- ↳ ✅ Checklists & SOPs
- ↳ ☑️ Mandatory fields
- ↳ 🧾 Custom ticket fields
- ↳ 🏷️ Ticket categories
- ↳ 🧾 A type for every new ticket
- ↳ 👥 Assigning tickets to a team, and escalation
- ↳ 🏢 One board across every company
- ↳ 🔎 Many companies: searchable lists (#358)
- ↳ 📊 Ticket dashboard — Developer Guide
- ↳ Mailbox Authentication
- ↳ 📤 Email send log
- ↳ ✉️ Emailed reports
- ↳ 📎 Attachment size limits and large emails
-
↳ Basic IMAP mailboxes
- ↳ 📐 Basic IMAP without the PHP extension (#257)
- ↳ 🛠️ Basic IMAP client — Developer Guide
- ↳ 🧪 Basic IMAP client — Testing and verifying
- ↳ 🛠️ Basic IMAP - Sent copy - Developer Guide (#270)
- ↳ 📤 PR #400 Sending through a relay without a login
- ↳ 🛠️ Verifying a mail folder — Developer Guide
- ↳ 🛠️ Mailbox providers — Developer Guide
- ↳ 🛠️ How Gmail mail collection works — Developer Guide
- ↳ Email rendering & images
- ↳ SLA Management
- ↳ WhatsApp channel
-
↳
✈️ Telegram channel - ↳ ⭐ CSAT company scope and filters — Developer Guide
- ↳ 👥 Microsoft Teams channel
- ↳ 🗨️ Mattermost channel
- ↳ 💬 Web chat channel
- ↳ 🟣 Slack channel
- ↳ 🔗 Linking tickets
- ↳ ⓘ Record previews
- ↳ 📝 Ticket notes: internal or shared
- ↳ 🗒️ Canned responses
- ↳ ✉️ Limiting replies to particular senders
- ↳ 📨 Telling the analyst a ticket is theirs
- ↳ ✍️ Email signatures
- ↳ 🌐 The public web address
- ↳ 🔢 Ticket numbering
- ↳ 🙋 Raising a ticket for someone else
- ↳ 🔀 Merging tickets
- ↳ 🔒 Confidential tickets
- ↳ 👥 Portal managers
- ↳ 👁 Who has seen a ticket
- ↳ 📜 Reading long tickets
- ↳ ✨ Reply Cleanup prompt and history
- ↳ ⑂ Splitting tickets
- ↳ ✅ Selecting several tickets
- ↳ 🗂️ The folder pane
- ↳ 🔽 Just my tickets, or no closed ones
- ↳ 🛠️ Snoozing tickets — Developer Guide
- ↳ 👥 Collision detection
- ↳ ⏱️ Time tracking
- ↳ 📄 Case reports - a ticket and its work as one PDF
- ↳ 📅 Scheduled work in your own calendar
- Problem Management
-
Tasks
- ↳ 🛠️ Task ID and hover card - review (#405)
- ↳ 🛠️ Task ID, Company column and hover card — Developer Guide
- ↳ 🛠️ Task board and subtasks — Developer Guide
- ↳ 🧑🤝🧑 People on a task ("Involved")
- ↳ 🔁 Repeating tasks
- ↳ 🏢 Moving a task between companies
- 🚀 Projects
-
Assets
- ↳ 🛠️ Asset list by type - review (#340)
- ↳ 🏢 Moving an asset between companies
- ↳ 📍 Shared asset locations
- ↳ 🧑💼 Assigning assets to analysts
- ↳ 📆 Warranty and lease alerts
- ↳ 📄 Leases
- ↳ 🔭 Saved table views
- ↳ 🖨️ Recording anything, and importing it
- ↳ 🧩 Asset type layouts
- ↳ 🕒 Inventory freshness
- ↳ 🔗 Linked configuration item
- ↳ 🔌 Connected assets
- ↳ 🔍 Asset review
- ↳ 📋 Missing information
- ↳ 📦 Consumables
- ↳ 🏷️ QR asset labels
- ↳ 📋 Who holds what, and handover documents
- ↳ 🖥️ The inventory agent (PowerShell)
- ↳ 🗄️ Proxmox VE servers
- ↳ ☁️ VMware Cloud Director servers
- ↳ 🪟 Hyper-V and Failover Clusters
- ↳ 🔗 Linking equipment to tickets
- ↳ ☑️ Follow-up tasks on a ticket
- Knowledge
- Change Management
- Calendar
- Morning Checks
- Reporting
- Software
-
Forms
- ↳ 🎨 The form designer — Developer Guide
- ↳ 📐 Layout & the grid — Developer Guide
- ↳ 🗂️ Collections — grouping submissions
- ↳ 📄 Submissions as PDFs
- ↳ ⚡ What happens next — a form's own actions
- ↳ 🛠️ Sections & conditional logic — Developer Guide
- ↳ 🛠️ Lookup fields — Developer Guide
- ↳ 🛡️ Catalogue request approvals
- People
- Starters & leavers
- Domains
- 🗂️ Files
- Contracts
- Service Status
- 🔔 Notifications
- 🚨 War Room
-
Self-Service Portal
- ↳ 🎨 Branding the portal
- ↳ 🙋 What people can do
- ↳ 📚 Help Centre
- ↳ 🚪 Landing page
- ↳ 🎨 Login screen designer
- ↳ 🛠️ Back to your page after sign-in - review (#407)
- ↳ 🛠️ Back to your page after sign-in — Developer Guide
- ↳ 🛒 Request catalogue
- ↳ 🔒 Portal privacy
- ↳ 👥 Portal managers
- ↳ 📇 Contact details
- ↳ 🛠️ Developer guide
- LMS
- Process Mapper
-
CMDB
- ↳ 🧱 Designing your CMDB
- ↳ 🛠️ CMDB — Developer Guide
- ↳ 🛠️ Impact analysis — Developer Guide
- ↳ 🛠️ Data quality — Developer Guide
- ↳ 🛠️ Record references — Developer Guide
- ↳ 🛠️ CMDB assistant - Developer Guide
- ↳ 🔗 Linked assets
- ↳ 📐 Linking an asset to its CI - design (#201)
- ↳ 📐 Discovery and redundancy-aware impact - design (#199)
- ↳ 🛠️ Relationship wording - review (#297)
- Network Mapper
-
Workflows
- ↳ 🔀 Branches: If / Otherwise and Choose by value
- ↳ 🛠️ Workflow engine — Developer Guide
- ↳ 🛠️ Workflows for tasks — Developer Guide
- ↳ 🛠️ Workflow notes on a ticket — Developer Guide
- ↳ 🛠️ Workflow category routing — Developer Guide
- ↳ 📐 Workflows in order, child tickets - design (#304)
- ↳ ⏰ Time-Based Triggers
- ↳ 🪝 Webhooks
- ↳ 💬 Webhook Message Formats
- ↳ 🔒 HTTPS Certificates & CA Bundles
- ↳ 🛠️ SSL Verification — the Global Setting
- ↳ 🐞 Workflow & Webhook Pitfalls
- Issue trackers (Jira, Azure DevOps)
- 📡 Zabbix (monitoring)
- 💬 Microsoft Teams alerts
- 📞 3CX (phone system)
-
System
- ↳ 🛠️ System cards by topic - review (#347)
- ↳ 🟦 Microsoft 365 (Entra ID and Intune)
- ↳ 🛠️ Preferences — Developer Guide
- ↳ 🗂️ Settings on one page
- ↳ 🧹 Maintenance
- ↳ 💾 Storage usage
- ↳ ✉️ Emailed reports
- ↳ 🔎 Finding people in the Analysts list
- ↳ 🚪 When an analyst leaves
- ↳ 🛠️ System → Branding — Developer Guide
- ↳ 🩺 Page health (D019) — Developer Guide
- ↳ ⭐ Feature Bingo
- ↳ 📍 Locations
- ↳ 🏷️ Cost centres
- ↳ 📒 Chart of accounts
- ↳ 📷 Photo Album
- ↳ Demo Data
- ↳ 🛠️ Demo Data — Developer Guide
-
Overview
- ↳ 📊 Progress tracker
- ↳ Concepts & vocabulary
- ↳ Email routing & mailboxes
- ↳ Settings: global vs per-company
- ↳ Users & self-service
- ↳ Staff cross-company access
- ↳ One company supporting another
- ↳ 🏢 One board across every company
- ↳ Worked examples
- ↳ Pitfalls & gotchas
- ↳ Scope: what it's for
- ↳ 🛠️ Developer Guide (make a module multi-company)
- ↳ 🗄️ Case study: CMDB (a linked graph)
- ↳ 🧪 Test harness (prove it's isolated)
- What this is
-
🐞 Bugs resolved
- ↳ 📖 #413 Reading pane too narrow on tablets
- ↳ 📱 #412 Sign-in card cramped on phones
- ↳ 🧭 #411 Header buttons out of reach
- ↳ 💱 #386 Project stuck in an old currency
- ↳ 🖥️ #393 Header ran off the screen
- ↳ 🖱️ #395 Ticket flyouts ran off the bottom
- ↳ 🔁 PR #401 Change editor used hardcoded priorities
- ↳ 📝 Knowledge drafts could not be published
- ↳ 🧩 #392 Project dialogs shared element ids
- ↳ 🖼️ #391 Knowledge images from your computer
- ↳ 🕗 #375 REST API wall-clock times
- ↳ 📅 #374 Calendar popup ran off the screen
- ↳ 🏢 #373 All companies: Changes, CMDB, Starters
- ↳ 🏢 #356 Assets People and All companies
- ↳ 🎓 #366 LMS demo data would not import
- ↳ 🔔 #362/#365 Team handover showed only a name
- ↳ 🔔 #365 The bell credited the wrong person
- ↳ 🗄️ #369 Inbox empty until Database Verification
- ↳ 🪆 #360 Links opened inside the ticket
- ↳ 🔗 #354 Workspace Links missed tasks
- ↳ 🔒 Task company checks in the API (5.5.0)
- ↳ 🔒 Asset holders through the API (5.4.0)
- ↳ 🔒 Files folder delete did not check inside (5.4.0)
- ↳ 🔒 The Intune tab did not check the company
- ↳ 📂 #332 Files viewer would not open
- ↳ 📎 #333 Note attachments downloaded
- ↳ 🪝 #326/#327 Form webhook Full record
- ↳ 📄 #325 Form PDF download failed
- ↳ 🔁 Small fixes in 5.1.0
- ↳ 🔁 CMDB relationships read backwards (5.1.0)
- ↳ 🔁 #301 CSAT delay was never applied
- ↳ 🔁 #281 Comments imported from Jira never arrived
- ↳ 🔁 #288 A change failed to open with Enforce approvals on
- ↳ 📚 Long non-Latin articles never got an embedding
- ↳ 🎫 #280 Email lookups scanned the whole table
- ↳ ✅ #266 Dragging a task told nobody
- ↳ 📚 #255 Article previews showed HTML codes
- ↳ 📚 #252 A link to a Knowledge article did not open
- ↳ 📄 #254 PDFs could not print Polish
- ↳ 📚 #250 Clicking a folder left the open article on screen
- ↳ 🎫 #260 The dashboard cog did nothing
- ↳ 🎫 #248 A department rule never matched on four routes
- ↳ 🔒 A directory account could be matched to someone else
- ↳ 🎫 #244 Reply went to the assigned analyst
- ↳ 🔒 Mailbox sign-in was not checked
- ↳ 🔒 Four weaknesses around signing in
- ↳ 🔒 A lookup answer could name any record
- ↳ 🎫 #227 A mailbox could not be deleted
- ↳ 🎫 #226 A picture on a note could not be closed
- ↳ 💻 #222 The Assets page never loaded in 4.3.0
- ↳ ⚙️ #214 A "contains" condition did not match capitals
- ↳ ⚙️ #216 A workflow email from a chosen mailbox always failed
- ↳ 🐳 The Docker image was missing PHP extensions
- ↳ 🌐 A failed DNS lookup read as a missing record
- ↳ 🔒 A link could change data
- ↳ 🔒 Access outlived its removal
- ↳ 🔒 Knowledge articles could run scripts
- ↳ 🔒 Knowledge writes ignored permissions
- ↳ 🔒 Company boundaries (Oct 2026)
- ↳ 🔒 Smaller gaps (Oct 2026)
- ↳ 🔒 Escaped text could leave its attribute
- ↳ 🔒 Task descriptions were not cleaned
- ↳ 🔒 Task documents ignored company scope
- ↳ 🔒 Repeating tasks ignored company scope
- ↳ 📬 #183 Mailbox checks overlapped
- ↳ 🌐 #188 Transfer lock shown off when unknown
- ↳ ✅ #184 Subtask names and Overdue
- ↳ 🧩 #186 Teams: the buttons did nothing
- ↳ 🔒 Text in a change could run script
- ↳ 🔒 AI settings changed without the AI permission
- ↳ 🚪 #178 Deleting an analyst failed
- ↳ 🎫 A team with no departments showed 0 tickets
- ↳ 🚀 Projects: adding a phase did nothing on Save
- ↳ 🔒 Leavers could still sign in
- ↳ 🖼️ Logo and courses broke on Apache with PHP-FPM
- ↳ 🔢 Chat tickets ignored your ticket numbering
- ↳ 📅 Dates shown as a dash, or in server time
- ↳ 🔒 Assets → Users showed people from other companies
- ↳ 🔒 Restricted analysts could read other modules' data
- ↳ 🖼️ Replies with a picture in the thread failed to send
- ↳ 📎 Reply attachments never reached the customer
- ↳ 🛠️ Outbound email attachments — Developer Guide
- ↳ 🔑 A global SSO provider was missing from the portal
- ↳ 🔀 Behind a proxy, the SSO redirect said http
- ↳ ✏️ The portal tagline moved when you saved it
- ↳ 🎨 The portal settings screen forgot what you saved
- ↳ 🛡️ The approvals inbox said "Error" and nothing else
- ↳ 📄 A table's answers were missing from the PDF
- ↳ ◉ A single-select column let you tick every option
- ↳ 📐 The portal ignored a form's field widths
- ↳ 📋 The tasks board stopped taking clicks
- ↳ 🗂️ #121 The index list is out of date after upgrading
- ↳ 📅 #133 The calendar subscription was empty
- ↳ 📋 #131 Tasks always reopened on the board
- ↳ 💥 #129 Every page returned HTTP 500 after upgrading
- ↳ 🐳 #127 A PHP warning above the System page
- ↳ 🕐 #126 Notes stamped with the server's clock
- ↳ 🌍 Storing every date in UTC
- ↳ 🚪 The portal was down for everyone signed in
- ↳ ⚙️ #120 Workflow notes could never be written
- ↳ ⚙️ #123 Three errors when running Database Verification
- ↳ 📝 #122 The description box was a stub in the corner
- ↳ 💣 Demo data deleted real accounts
- ↳ 🔐 #117 Sign-in redirected to the wrong address
- ↳ 🎨 #108 The priority dot was invisible
- ↳ ⏱️ #116 Time logged from the right-click menu
- ↳ 🔑 #114 API keys refused by our own guard
- ↳ 🗂️ #110 Assigning a task told nobody
- ↳ 🚪 #107 Signed out while still working
- ↳ 📎 #103 "Share with Requester" reached nobody
- ↳ 🔍 #102 Search found nothing for hyphens
- ↳ 🪟 #101 Source code editor opened behind
- ↳ ☑️ #88 Subtasks could not be ticked off
- ↳ 💻 #84 Asset deep link selected nothing
- ↳ 🎫 #79 A new ticket arrived with no status
- ↳ 📧 #79 A ticket from email did not say so
- ↳ 🔔 #78 Bell opened to nothing
- ↳ 📬 #77 Mail only collected from Inbox
- ↳ 🔐 #74 The default password could not be changed
- ↳ 🚦 #70 Renaming an impact level
- ↳ 📤 #67 App-only mailboxes could not send
- ↳ 📭 #45 Verify only ever worked for Microsoft
- ↳ 📭 #45 IMAP reported as not authenticated
- ↳ ✉️ An email template stopped escaping itself
- ↳ 🕐 The portal dashboard showed the wrong time
- ↳ 🔢 The folder said 99 and the list showed 96