v9
UCS Operator - changelog
All notable changes to this project will be documented in this file.
[9.58.0] - 2026-11-18β
π Featuresβ
- (ui) Let DataTable render long lists a page at a time
- A blacklist can hold thousands of records, and rendering every row of such a list makes the admin page slow to open and to filter. DataTable gets an optional rowLimit: it sorts the whole data set as before, renders the first rowLimit rows, and offers "Show N more" with a "Showing x of y" line below the table. Select-all keeps covering the rows rendered.
Tables without rowLimit render every row, as before. This avoids adding @tanstack/react-virtual until a list needs to scroll through thousands of rows at once.
- (admin) Port blacklists
- Blacklists (lists of numbers that trunk incoming rules and outgoing filters check as a blacklist or a whitelist) move from the PHP admin to /admin/telephony/blacklists. The list page shows each list's group, record count and use, filters by name, group and use (including "empty whitelists", which hang up every call), and moves or deletes lists in bulk. A list's page holds its records: an inline box adds several caller numbers at once, each as its own record with the same called number, action and note; records are edited in a dialog, filtered by number, note and action, deleted in bulk, and rendered 200 at a time. "Used by" lists the trunk rules and filters checking the list, each as a blacklist or a whitelist.
The server stores a record as the Asterisk DB key
Deleting a list cascades its uses on trunk rules and filters without rebuilding the dial plan, so a whitelist use hangs up every call until the next rebuild; the delete confirms warn, and the issue is deferred server work Q. Usage and record counts come from structure.select and stay hidden for admins who are not superusers.
Design decisions (new design tokens, as for all admin work): warnings and the "same numbers" and "empty whitelist" chips use ds-warn-soft / ds-warn, the whitelist chip ds-tag-bg / ds-tag-fg; no new tokens, radii or font sizes.
- (admin) Port telephone services
- Telephone services (the menu items IP phones open from their services key) move from the PHP admin to /admin/telephony/phone-applications: a list with the URL, group and use, filters by name or URL, group and use, bulk change group and delete; an add page; and a detail page with the form and "Used by".
UCS assigns services only inside settings sets (settings.data JSON, applications[].application_id and url_append), with no foreign key. "Used by" parses that data and follows the sets to the groups and extensions taking them, linked to the number plan. A delete leaves the entries in the settings sets and provisioning skips them, which the delete confirmation says.
The PHP note listing UCS's built-in services moves into the form, each with "Use", and the form and the list say where phones load the URL from, the way provisioning builds it: as is for the phone's own service, from the UCS server over HTTP for a path, or from the server named in an address with //.
list returns the URL only when asked for columns, so the list passes
[null, columns]. edit takes partial data, so a bulk group change sends only
the id and the group.
Design decisions (new design tokens, as for all admin work): ds-muted for the address kind and help, the shared ghost button for "Use"; no new tokens.
- (admin) Port recording storages
- Recording storages move from the PHP admin to /admin/telephony/recording-storages: a list with path, type, format, retention ("30 days, then to Archive"), recording count and use, filtered by name or path, group and use, with bulk change group and delete; an add page; and a detail page with the form in sections and "Used by" (trunk incoming rules, outgoing filter patterns, settings sets, roles, and storages moving expired recordings here).
UCS finds each recording's file through its storage's current path pattern, so changing the path of a storage that holds recordings makes them unplayable and expiry later deletes their records as missing. Changing "keep" or the protection default rewrites the expiry and protection of every recording already in the storage. The form warns before saving either, previews today's directory, notes storages sharing the path, and flags a circle of "move expired to". A bulk group change sends only the id and group, so it rewrites no recording.
Deleting a storage deletes its recordings' records (CASCADE; files stay), leaves trunk rules, filter patterns, roles and other storages without it, and leaves settings sets pointing at it, which drops their recordings; storage #1 is UCS's fallback. The confirmations say all of this with counts, read with structure.select (hidden for admins who are not superusers). Empty speech-to-text limit and priority send UCS's defaults instead of PHP's 0, which is out of range for the priority. The server issues are deferred item R.
Design decisions (new design tokens, as for all admin work): ds-danger-soft / ds-danger for the path-change warning (data loss), ds-warn-soft / ds-warn for the retention and circle warnings, ds-muted for previews; no new tokens.
- (admin) Add a last-updated line for live admin pages
- Status pages refresh themselves by websocket events or polling, and an admin looking at them needs to know how fresh the data is and to be able to ask for it now. LastUpdated shows "Updated
It came out of the Status menu port, where every page had built the same control.
- (admin) Port the telephones status page
- Status βΊ Telephones moves from the PHP admin to /admin/status/phones: one row per extension or hot-desk line with its device, SIP username, outgoing filter and state (online, offline, not monitored, unknown, in a call, ringing), with the address and round-trip time when known. It filters by text, state, desk or web phones and device group (with subgroups), and a summary counts the lines online and offers the offline desk phones as a filter (an offline web phone is not a problem).
peer.change fires on every ring and answer, so it patches the matching row in the cache instead of refetching the whole list; address and round-trip changes send no event, so the page also polls every 15 s, and device, line and extension events refetch it. Devices link to their pages; for superusers the extension links to the number plan and the signed-in or web-phone user to the user page, read with structure.select (relations/phone-lines.ts).
A line without a SIP username on a device without a MAC is looked up under a name provisioning never uses, so it can never show a state; it shows as Unknown with the reason. status.phones checks no permission or group. Both are deferred item S.
- (admin) Port the registry status page
- Status βΊ Registry moves from the PHP admin to /admin/status/registry: one row per trunk registration (a number range has one per number) with trunk, user name, SIP proxy, state, last registration and refresh interval. States are Registered, Rejected, Authenticating and Not registered, the last three counted as failing; a trunk that is inactive, or registers with its own registrar, gets an explaining state instead of a blank (from config.trunks.list). It filters by text, state (with "Failing") and trunk, and the summary offers the failing ones as a filter.
UCS reads registration states from Asterisk only when it connects to the AMI and never subscribes to registry events, so the states date from the last UCS or Asterisk start. The page says so and counts the registrations due for renewal since then instead of claiming to be live; it still refetches on registry.change and trunk events and polls every 30 s. A registering trunk without a SIP proxy makes status.registrations fail as a whole (-1000); the page names that cause. These, a range without a dash and the missing permission check are deferred item S.
- (admin) Port the remote clients status page
- Status βΊ Remote clients moves from the PHP admin to /admin/status/clients: the applications and integrations signed in to UCS with a session of their own, and the XMPP clients (DCom), one row per connection with the user (linked to the user page), presence, connection kind, address, last activity and version. It filters by text, connection and presence, and says how many users and connections there are. The web operator and this admin sign in through uAuth and never appear; the page says so.
status.clients returns {sessions, xmpp}, not the keys its method help describes, with last_seen as float seconds. Nothing is emitted when a session expires or a client disconnects, so the list polls every 10 s; user.login and user.status refetch it and the presence names. PHP had no action and the server has none to drop another user's session, so there is none here. status.clients checks nothing beyond a signed-in user: anyone can list every client's address and version (deferred item S).
- (admin) Port the inbound queues status page
- Status βΊ Inbound queues moves from the PHP admin to /admin/status/queues: a list of queues with callers waiting and connected, the longest current wait, agents by status (warned when nobody is logged in), calls, abandoned share and service level, filtered by text, group (with subgroups) and "callers waiting" / "no agent logged in"; and a page per queue with its stat tiles, callers (state, wait and talk time ticking every second, agent) and member agents (status with AUX reason, paused in this queue, phone activity, calls, talk, ACW and AUX time), linked to the user pages.
One query reads status.queues and queues.agents together; queue.stats, agent.status and agent suspend/resume events refetch it, with a 10 s poll behind them. PHP had no actions on this page, so there are none; suspend, resume and resetting statistics exist on the server and are noted as a proposal.
Fixed while porting: soft-deleted queues, which status.queues returns after a server restart, are hidden; a caller's wait stops at the answer (the server keeps counting); an external number is no longer shown as a desk phone; an agent busy with a chat or e-mail is not counted as on a call. With no calls yet the shares show "β" instead of 0 %. status.queues checks no access, so any signed-in user sees every queue and its callers' numbers (deferred item S).
- (admin) Port the voicemail messages page
- Status βΊ Voicemail messages moves from the PHP admin to /admin/status/voicemail: messages newest first with received time, caller, mailbox (linked to its extension), folder and length, filtered by caller or mailbox, mailbox, folder and date range. A message plays in the browser (voicemail.download, base64), downloads as a file, or plays on the admin's own phone (voicemail.playback, the only playback PHP had). It is deleted one at a time or in bulk, with the progress dialog and a typed count from 20 up. voicemail.new refetches the list, with a 60 s poll for deletions made elsewhere.
The page loads the newest 1000 messages for the chosen mailbox and dates (PHP paged 20 at a time) and says when older ones are cut off.
Worked around: voicemail.messages applies only the end date when given both, so the start is filtered in the browser; rows carry another mailbox's name, so the mailbox comes from the voicemails enum; no mailbox gives {} instead of an empty list. A message's folder is never updated once it is heard, so there is a folder filter, not a new/heard one. Superusers see only Voicemail extensions' mailboxes, as in PHP, and the page says so. Deferred item S.
- (admin) Port the outgoing SMS status page
- Status βΊ Outgoing SMS moves from the PHP admin to /admin/status/sms: the SMS waiting for their gateway, in the order the server works through them (being sent first, then by next attempt), with recipient, queue, user, enqueued and next-attempt times and the last error; failed attempts are counted in red and a warning line appears when anything has failed. It filters by text, state ("failed at least once" included), queue and gateway.
PHP's "abort" is "Remove from queue", one at a time or in bulk. An SMS being sent cannot be removed: removing it would only lose its record while the gateway still sends it, so it gets no action and bulk skips it with a warning. sms.abort answers null when the SMS has already left the queue; the page reports that instead of a success. Nothing is emitted when an SMS is enqueued, retried or aborted, so the list polls every 10 s besides the sending/sent/error events.
The server retries 5 times 300 s apart and then drops the SMS without a record, which the page says. Queued SMS are stranded after a UCS restart and Gateway.cancel stops only the first SMS waiting at a gateway (deferred item S). The time formatting and the state chip live here and are reused by the FAX page.
- (admin) Port the outgoing FAX status page
- Status βΊ Outgoing FAX moves from the PHP admin to /admin/status/fax: the FAX jobs waiting to be sent, in the order the server works through them, with recipient, FAX extension (names from config.extensions.list), enqueued and next-attempt times and the last error, filtered by text, state and FAX machine, with a warning line when anything has failed. Retries follow the FAX_RETRY_* parameters, which the page names.
PHP's "abort" is "Remove from queue", one at a time or in bulk. fax.abort is superuser-only, writes "Aborted by user" to the FAX journal and mails the sender. A job being sent can still be removed, with a warning that the call is not hung up: removal is the only way out of a job stuck in "Sending", which is what a job marked sending at a restart becomes. fax.queued and fax.aborted refetch the list, with a 10 s poll for retries, which send no event.
The last error of a live job stays empty because the server writes the retry note only to the database, and fax.status's filter compares a variable with itself (deferred item S). Reuses the time formatting and state chip of the SMS page.
- (admin) Show INSOFT kiosks as their own kind on the telephones page
- Kiosks were counted as desk phones. INSOFT kiosk runs the same app as INSOFT uPhone, but on Tipro BeFree tabletop devices, so it is neither a plain desk phone nor a softphone. It becomes a third kind beside desk phones and softphones (web phone, uPhone): the kind filter offers it, and since a kiosk stands on a desk and is expected to be online, an offline kiosk line counts as a problem with its own "kiosk lines offline" summary button, next to the desk phone one.
Kinds come from the device type (1000 uPhone β softphone, 1001 kiosk β kiosk), read from config.devices.list because status.phones gives only the type name. FEATURE.md explains the three kinds.
- (supervisor) Add setting to hide agent state duration
- The Agent overview shows a timer next to each agent's name with the time spent in the current state. Some teams find it distracting or do not want agents to see how long colleagues have been in a state, so a new "Hide duration in agent state" setting removes it.
The flag is passed down as a prop along the same path as skipSuspended (SupervisorView -> AgentStats -> AgentStatsRows -> AgentStatsRow -> AgentButton). AgentButton gets an optional hideDuration prop defaulting to false, so its other user is unchanged.
-
(admin) Add a date range filter and a pager for report lists
- The report pages (call detail records, presence and login logs, statistics, the SMS and FAX journals, the audit log) all filter by a date range and most page on the server. These pieces keep that consistent before the pages are ported:
-
date-range.ts turns
from/todays, picked in the user's timezone, into the UTC instants the server's DateTime validator accepts, so a day covers the user's hours rather than the server's (PHP sent Prague wall-clock times). pageOffset maps a 1-basedpageURL filter to the offset. -
DateRangeFilter is the From/To pair of date inputs for a list toolbar.
-
ListPager shows "1β50 of N" with Previous/Next for methods that take limit and offset and return [rows, total].
foundations.md lists them with LastUpdated.
- (admin) Port the call detail records report
- Reports βΊ Call detail records moves from the PHP admin to /admin/reports/cdr: finished calls newest first with date, caller and called (users and extensions linked), path, duration, price, account code and recording, filtered by exact number, date range (today by default, as in PHP), group or extension, all in the address, paged on the server 50 at a time, with an Excel export of everything the filters match. The number plan's "Call records" links for groups and extensions now open it instead of PHP.
Recordings play inline and download. When the recording audit asks for a reason the page asks first (downloads up front, as PHP did; playback after the server says so), checks access with a two-byte status.recording call that also writes the audit entry, and then streams the audio from the api service's existing /recording route, which the operator already uses, so a long recording does not travel as base64 through one RPC call. Superusers may remove a recording when DELETE_RECORDINGS allows it, with a reason.
Worth knowing: status.cdr without a start silently means the last 31 days, so the page always sends one; a group includes its subgroups; the cdr table keeps no trunk, so calls cannot link to trunks; all Excel reports share one server lock. Deferred item T.
- (admin) Port the users presence report
- Reports βΊ Users presence moves from the PHP admin to /admin/reports/presence: how long each user spent in each presence state over a date range (today by default, as in PHP), with totals and per-user averages as tiles, filtered by name and group (with subgroups) in the address, an Excel export, and a history page per user (/admin/reports/presence/:userId) with each change, paged on the server.
Durations are filled in by the database when the next change arrives, so the newest change has none and the current state is never counted; the range selects changes by when they started without clipping them. When the LOG_PRESENCE parameter is off nothing is recorded, and superusers see a note saying so (config.parameters.get is superuser-only). The Excel export covers every user, whatever the filters. The summary helpers (dates, durations, user labels, export) live here and the agents logins report reuses them.
- (admin) Port the agents logins report
- Reports βΊ Agents logins moves from the PHP admin to /admin/reports/agent-logins: how long each agent spent logged in to queues by state (ready, ACW, AUX, offline) over a date range, with a "logged in" total, tiles with totals and averages, filters by name and group in the address, an Excel export (of the agents shown when filtered, otherwise of everyone the admin may see), and a history page per agent with each change, including call and phone events and waiting callers, paged on the server. It reuses the presence report's helpers.
On ekancl the summary failed: status.agents keeps four slots per agent and raises "list assignment index out of range" as soon as the range holds an older agent_logins row of a later state with a duration, and PHP fails the same way. When that happens and the admin is a superuser, the page sums states 0β3 itself through structure.select (relations/agent-logins.ts, with a guard that lets only UTC instants into the SQL) and says where the totals came from. Deferred item T.
- (admin) Port the agents statistics report
- Reports βΊ Agents statistics moves from the PHP admin to /admin/reports/agent-stats: each agent's queue work over a date range (answered, unanswered and transferred calls, talk, ready, ACW, AUX and break time), with total tiles, a legend that says what each figure means, filters by name and group in the address and an XLSX export; and a page per agent broken down by year, month, week, day, hour or statistics period, chosen in the address or by the length of the range. Unanswered, transferred and break time are new here; the server and the export had them, PHP's page did not.
status.agentsStats divides the ready, ACW, AUX and break sums by the agent's distinct queues over the whole group, so they come out too low when the agent's queues changed during the range; only the per-period breakdown and the export are exact. The page shows the server's figures as PHP did and says so above the legend (deferred item T). Figures are saved at the end of each statistics period, so the last minutes are missing, which the page says too. The period selection, labels, export button and legend live here and the queue statistics report reuses them.
- (admin) Port the inbound queue statistics report
- Reports βΊ Inbound queue statistics moves from the PHP admin to /admin/reports/queue-stats: each inbound queue's calls over a date range (answered, abandoned, overflowed), service level, answer rate, waiting and talk times, with total tiles, a legend, filters by name and group in the address and an XLSX export; and a page per queue broken down by period, with a link to its live status. Totals add up the counts and derive the rates from the sums (PHP's totals row was misaligned).
PHP and the export call the answer rate "AR (Abandoned Ratio)" although it is answered / (answered + abandoned after the threshold); the page names it "Answer rate" and the legend says so. Service level here is answered in time out of answered, unlike the live queue page, which also counts calls abandoned within the threshold; the legend explains the difference. Calls dropped because the queue was full count as abandoned; overflowed calls are in neither. An export of an empty range crashes the server, so the button waits for data. Deferred item T.
- (admin) Port the SMS messages journal
- Reports βΊ SMS messages moves from the PHP admin to /admin/reports/sms: SMS sent and received through the SMS queues, newest first, with direction, sender, recipient, the message text (PHP did not show it), queue, user and delivery report, filtered by exact number and queue and by date range (today by default, as in PHP), in the address and paged on the server. It refreshes on sms.sent, sms.received and sms.delivered and links to the Outgoing SMS queue, whose empty state now links here instead of to PHP.
Only SMS that a gateway actually sent are recorded; one that failed for good
leaves no trace (the queue page says so), so PHP's red "FAIL" only ever meant
"no delivery report", which is what the page shows. The number filter is an
exact match on the stored +
- (admin) Port the FAX journal
- Reports βΊ FAX journal moves from the PHP admin to /admin/reports/fax: FAX documents received and sent by the FAX machines, newest first, with machine (linked to its extension), direction, caller, called, pages and outcome (Transmitted or Failed, with the note), filtered by machine, direction (the server supports it, PHP did not offer it) and date range, in the address and paged on the server. A kept document downloads as a PDF under PHP's file name; superusers and admins with billing access may delete documents, one at a time or in bulk (rows without a document are skipped). It refreshes on fax.received and fax.aborted and links to the Outgoing FAX queue, whose empty state now links here instead of to PHP.
fax.journal checks for the PDF at a hard-coded path while download and delete use FAX_ROOT, so the document flag can be wrong; a deleted FAX machine's entries disappear (inner join); fax.remove sends no event; fax.journal checks no permission. Deferred item T.
- (admin) Port the audit log
- Reports βΊ Audit log moves from the PHP admin to /admin/reports/audit: who changed the configuration or looked at call details and recordings, newest first, with time, user (linked), group, action (section and operation with the raw code under it) and details, filtered by user, section, operation and date range (today by default) in the address, paged on the server and refreshed every minute on the first page (no event announces new entries). PHP could filter by none of these but the dates and user.
Details read the logged data: an update lists the changed fields as old β new, a creation or deletion the record's values, behind a disclosure past two fields; the record id and the reason of a recording access come first. UCS logs password hashes and trunk secrets as they are, so fields named like a password, secret, PIN or token show only that they changed (the server should mask them; deferred item T).
status.auditlog matches actions exactly from a list (an empty list returns nothing), so the section filter uses the page's own list of about 280 action codes; an action added to UCS later appears only while no section or operation is chosen. Reverting from the log is not built (a question for the team in the backlog).
- (admin) Add an editor for queue metadata fields
- E-mail, SMS and chat queues (and later task queues and teams) carry the same metadata struct: an ordered list of fields agents fill in, each with a key, a name and a type (text, number, checkbox, radio, select with options, or a button that opens a URL, an operator tab or a desktop application). The Messaging ports need one editor for it rather than three.
api/metadata-variables.ts parses what the server sends leniently (missing key, name or type), keeps the data of unknown types and sends it back unchanged, and checks a field before saving: key required and unique, name required, at least one complete option for radio and select, a URL or an application name for buttons. components/MetadataVariables lists the fields with add, edit, remove and reorder; MetadataVariableDialog and MetadataOptionsEditor edit one field and its options.
The button URL help names {ID}, {NOTE} and {key}: the operator still accepts the %ID% form PHP documented but converts it as deprecated (lib/expandTemplate). For an application button the field holds the name of an application set up in the Operator desktop app. foundations.md no longer says MetadataEditor (key/value pairs) is for queue metadata.
- (admin) Port the e-mail queues
- Messaging βΊ Email queues moves from the PHP admin to /admin/messaging/email-queues: a list with languages, agents, e-mail sources, a setup column (no agent, no source or no sender) and the e-mail count, filtered by name, status, group and setup in the address, with bulk change group, activate, deactivate and delete; an add page; and a queue page with a Settings tab (every PHP field in sections, languages with default reply templates, ordered senders, metadata fields) and an Agents tab that saves at once (several users added together, priority, most e-mails at once, language skills, reorder). "Used by" lists the e-mail sources delivering into the queue and the source filters copying or moving e-mails into it.
Deleting a queue cascades to its sources, every e-mail in it, statistics, memberships, senders and templates, while the server keeps the deleted sources (and agents the queue) in memory until a restart; the confirm names the sources and counts the e-mails. Queue edits reach agents only after a restart or when their membership is saved again, so a changed Active warns. An empty priority or "most e-mails at once" now takes the user's team default (PHP always sent 100 and 0); removing an agent sends their open e-mails back to the queue, which the dialogs say. Deferred item U.
- (admin) Port the e-mail sources
- Messaging βΊ Email sources moves from the PHP admin to /admin/messaging/email-sources: the mailboxes UCS fetches e-mail from, with server, queue (linked), group and filter count, filtered by status, queue, type and group; an add page; and a source page with every PHP field and a "Related" panel (the queue it delivers to, its filters, the other sources of that queue).
The UCS server does not fetch e-mail: each source is fetched by its own
ucs-email-fetcher@
- (admin) Port the e-mail senders
- Messaging βΊ Email senders moves from the PHP admin to /admin/messaging/email-senders: the SMTP accounts UCS sends e-mail through, with sender address, server, group and the queues using each, filtered by type, group and use; an add page; and a sender page with every PHP field, the queues sending through it in "Used by", and a new "Retry sending now" action (email.sender.flush), which wakes the sender and says how many e-mails were waiting. It reuses the e-mail sources' helpers for passwords, ports and names.
A queue sends through the sender whose address equals the e-mail's From, otherwise through its first sender; an empty port means 25 (465 for SSL/TLS); UCS signs in only with both username and password, and retries an unreachable server every 60 s without limit. The page says all of it. Deleting a sender stays in its queues' memory until a restart or queue save, and with an e-mail still waiting it can stop the e-mail module from loading after a restart; the confirm warns (deferred item U, with the other sender bugs found).
- (admin) Port the chat queues
- Messaging βΊ Chat queues moves from the PHP admin to /admin/messaging/chat-queues: queues for the web chat and Facebook messages, with their id, type, time limits, metadata fields, group, message count and use, filtered by type, status and group, with bulk actions; an add page; and a queue page with every PHP field, the metadata fields agents fill in, and "Used by" (chat notifiers watching the queue).
UCS stores Active, SLA and the agent timeout but never acts on them: chat.message accepts messages for an inactive queue, which the help text says. PHP also sent languages, default templates and senders, which are not in the struct and were dropped by the validator. config.chat.edit needs name and group even for a partial edit, so bulk edits send them. Deleting a queue deletes its chat messages, and chat notifiers keep its id and never fire again; the confirm shows both. Deferred item U.
- (admin) Port the SMS queues
- Messaging βΊ SMS queues moves from the PHP admin to /admin/messaging/sms-queues: queues with the gateways they send through and receive from, group and use (waiting SMS, notifiers), filtered by group, status and gateway; an add page; and a queue page with a Settings tab (every PHP field, metadata fields) and an "Outgoing gateways" tab that saves at once (add, edit, reorder; PHP's position field became up/down). The SMS queries and the part of a gateway the queue pages need live here; the gateway pages build on them.
A queue with two or more gateways uses them in turn, but the turn counter runs past the end of the list, so after each gateway has sent once every further SMS is refused until UCS restarts; removing a gateway can break a queue the same way, and removing the last one has no effect until restart. The gateways tab warns. UCS stores Active, SLA and timeout but never reads them; the form says so. editQueueGateway's duplicate check swaps gateway and queue. PHP's keys outside the struct were dropped by the server and are not sent. Deferred item U.
- (admin) Port the SMS gateways
- Messaging βΊ SMS gateways moves from the PHP admin to /admin/messaging/sms-gateways: the modems and services UCS sends and receives SMS through, with type, the queues sending through each and the queue it receives into, filtered by group, type, state and use, with bulk enable, disable and delete; an add page; and a gateway page with the settings of its type (credentials write-only), the incoming queue, the queues sending through it, and "Used by".
The group is chosen when the gateway is added and shown read-only after, as PHP did on purpose ("dont allow group change"): the server checks rights on the old group only. PHP never saved the MEX GATE sender (wrong input name); the port does. getGateway returns the O2 client private key in clear; the form keeps it write-only. A disabled gateway stays in its queues' rotation and the SMS handed to it wait until it is enabled; 2N VoiceBlue has no driver, so its SMS are recorded as sent but never leave; a running gateway keeps its incoming queue until a restart; a receiving gateway without a queue drops what it receives. The form and confirms say so (deferred item U). Lists read each gateway with get, because the list method takes no column argument.
- (admin) Port the message templates
- Messaging βΊ Message templates moves from the PHP admin to /admin/messaging/templates: the texts agents insert into e-mails, SMS and task notes, with where each can be used, type, variables, group and use, filtered by use, type and group; an add page; and a template page with every PHP field, the content in the operator's e-mail editor (Froala, no autosave; what Froala changes in the loaded HTML is not an edit), variables and attachments, which PHP left alone. "Used by" lists the e-mail queues using it as a reply template per language and the task queues using it for new task notes.
A new template is added first and its content written on its page, because pictures pasted into the editor upload as attachments of an existing template. The server takes empty content as "unchanged", so the form refuses to save it empty. Names are unique across groups; -6 lands on the name field. PHP's type had no default and an add without it failed; new templates start as inserted text. Deleting a template removes it from the queues using it, but e-mail and task queues keep its id in memory until saved again or UCS restarts, so new e-mails or task notes there can fail; the confirm warns (deferred item U).
The editor and the template checklist are the operator's components, reused unchanged; the attachment manager inside them reads the Redux store, so admin reaches the store indirectly here.
- (admin) Edit a message template as HTML in the code editor
- The template page only had the visual editor (Froala). The admin can now choose, above the content, between the visual editor and the HTML in Monaco (the bundled editor, loaded only when chosen); the choice is remembered in that browser, and the visual editor stays the default.
Both edit the same text, so switching keeps the changes. Froala rewrites the HTML it loads and reports that as a change, which the page ignores until the admin has used the editor; after the editor has been used, the rewrite that follows a switch from HTML counts as an edit, so the form stays unsaved instead of taking the rewritten text as the saved one. Pictures and attachments stay in the visual editor.
π Bug Fixesβ
- (admin) Count INSOFT uPhone as a softphone on the telephones page
- The telephones status page took only the operator's web phone (a PJSIP peer) for a softphone, so every closed INSOFT uPhone app counted as an offline desk phone: it was flagged in warning colours and raised "desk phone lines offline". uPhone is a softphone like the web phone, offline whenever its app is closed, so lines on devices of type 1000 now count as softphones. The kind filter offers desk phones and softphones (web phone, uPhone).
INSOFT kiosk (type 1001) stays a desk phone: it runs the same app, but on a Tipro BeFree tabletop device that stands on a desk and is expected to be online. FEATURE.md and the hidden semantics say so.
status.phones names the device type but not its id, so the ids come from config.devices.list, shared with the devices page's query.
- (admin) Keep the SLA of chat and SMS queues when saving untouched
- The chat and SMS queue forms showed the SLA and agent timeout rounded to two decimals of an hour or minute, so a 90 s SLA loaded as 0.03 h and was saved as 108 s without the field being touched; any value that is not a multiple of 36 s (or 0.6 s for minutes) changed on every save. They now use four decimals, as the e-mail queue form does, which round-trip to the same whole seconds.
- (admin) Start a report at the end date when only the end is set
- An empty "From" in the report filters means today, as in PHP. With only "To" set to an earlier day that gave an empty range (begin today, end in the past) and no hint why, in the call detail records, audit log, SMS and FAX journals, presence, agent logins and agent statistics. The default start is now never after the chosen end ("up to 1 November" starts that day), through one helper in date-range.ts that the pages' date inputs and the Excel exports use too.
- (admin) Ignore a non-numeric queue, machine or direction in a report URL
- The FAX journal and SMS journal turned
?fax=abc,?direction=xor?queue=abcinto NaN, which JSON sends as null, so the filter was silently dropped while the filter box still showed the garbage. A shared filterNumber reads a whole number or means "no filter", as the call detail records and audit log already did for their ids.
- The FAX journal and SMS journal turned
- (admin) Mask private keys in the audit log, not the pin switches
- The audit log hides values of fields named like a password, secret, pin or token, because UCS logs them as they are. Private and API keys (ssl_key and the like) were still shown, while always_pin and require_pin, which are plain on/off settings, were masked although their change is worth reading.
π Refactorβ
- (supervisor) Render agent overview columns with ternaries
- AgentStats and AgentStatsRow rendered every optional column as
cond && <X />, which the operator/jsx-ternary-not-and lint rule flags because a numeric condition would render a stray 0. Switch them tocond ? <X /> : null. No behaviour change.
- AgentStats and AgentStatsRow rendered every optional column as
- (supervisor) Name the memoized agent stats rows component
- oxlint's react/display-name flagged the anonymous arrow inside memo() in AgentStatsRows, which also shows up as Anonymous in React devtools. Set displayName so the component is identifiable.
- (admin) Share the stat tile, percentage and today helpers
- The report pages about to be ported show figures in the same tiles and percentages as the inbound queue status page, and default their date ranges to today. They would otherwise import them from the queue status section and the holidays model. StatTile and Percentage move to components/ and todayIso to date-range.ts, next to the other date filter helpers; the queue status and holiday pages import them from there. No behaviour changes.
- (admin) Move the row id helper out of the metadata editor component
- The admin API layer (metadata-variables.ts) imported newRowId from a React component file, which pulls component code into model and test imports and invites a circular import. It now lives in row-id.ts, and the editors, the template pages and the user metadata tab import it from there.
π Documentationβ
- (admin) Note the work planned after the rewrite
- The rewrite keeps the PHP admin's sections and pages, each doing at least what it did, with enhancements within the pages. Radical changes wait until it is done: moving the user-facing reports (call detail records, presence, agents logins and statistics, queue statistics, SMS messages, FAX journal) out of admin into the user part of the operator, keeping only the audit log in admin; removing or merging pages; and the UX refactoring from the backlog.
[9.57.0] - 2026-11-16β
π Featuresβ
- (chat) Replace docked chat boxes with a tabbed chat window (wip)
- The old colleague chat was a row of docked boxes backed by an Immutable Redux reducer, with a "Sessions" overflow list and a blinking title as the only signal for a new message. It had no room for group conversations, which issue 452 needs.
Replace it with ChatWindow: one window docked in the bottom-right corner,
one tab per conversation, up to three visible and the rest behind "+N".
Sessions and messages move from the chat reducer to TanStack Query
(chat-sessions-query, chat-messages-query) over the presence.* RPCs, so the
reducer, its actions and the whole components/Chat directory go away.
Group conversations the user already belongs to are listed and usable;
creating or managing them from Operator is not there yet.
A new message shows as a preview above the window instead of blinking. It
does not take focus and does not mark the conversation read. Conversations
can be muted per browser, and the new "Hold chat previews during calls"
setting collects previews into one summary when the call ends. It takes
the place of the "Automatically open last session" checkbox in the
settings form; the autoOpen value itself is still in the settings model.
The window is rendered only when "Show Chat" is on and is keyed by the user id so impersonation starts from a clean state.
Work in progress: pushed to share the state of the branch, not as a finished feature.
- (chat) Show colleagues as active or offline and group the chat window files
- Colleague status in the chat window mirrored the agent state (Ready, ACW, Not ready) with the colours configured in the UCS administration. Chat never asks for immediate attention, so a colleague's call-handling state says nothing about whether you can write to them. Presence is now just Active when the user is signed in to UCS and Offline otherwise, which also drops the dependency on the agents list and the agent colours. The "Online" msgid is gone from both catalogues because nothing uses it any more.
The ChatWindow directory had grown to almost fifty files in one level. Tests move to tests, as elsewhere in src, and the components that only make sense together move into list/, tabs/, conversation/ and peek/. The entry point, the state, the hooks and the pieces shared by several groups (CountBadge, PresenceDot, SessionMark) stay at the root, so the import from BottomMenu is unchanged. No behaviour changes with the move; the import blocks were re-sorted by oxfmt where paths changed.
HANDOFF.md carries the context of the session that started this work and is to be deleted before the branch is merged.
- (chat) Move the chat window onto the teamchat service with groups
- The window ran on the old presence.* chat calls, which only know integer sessions with an unread count. Groups could not be created or managed, there was no read position, and mutes and notification settings lived in the browser or in the application settings, so they did not follow the user to another computer or to the mobile app.
Switch to the teamchat.* RPCs and the teamchat.
On top of that come group conversations (create, rename, add people with a choice of how much history they see, remove as creator, leave), system notices for those events, @mentions that get through a mute, attachments uploaded over tus, editing within the server's edit window, and delivered and read receipts. Groups, mentions and attachments each appear only when the server reports the feature.
Mutes and the notification preferences (previews, sound, hold during calls, quiet while Offline) are now stored on the server and set from a gear in the chat window, so the messageNotification and holdPreviewsDuringCalls application settings are dropped and the window no longer persists mutes or the recent list in localStorage.
The Storybook theme toolbar now wraps ElementRoot so the dark palette actually applies, and the new ds tokens (attention, icon background, offline status, avatar pin colours) are added for both themes.
- (chat) Name who read a group message and follow the new teamchat events
- The teamchat server no longer publishes on a per-user teamchat.
topic. Events go out on the fixed topic teamchat and ucs-api delivers only the ones meant for the logged-in user, so the window now subscribes to teamchat and dispatches by payload.type as before.
- The teamchat server no longer publishes on a per-user teamchat.
Every member now sees the sender's client_msg_id, so a pending send is taken as confirmed only by a message we sent ourselves; a colleague's message carrying the same id no longer hides it. Our own messages sent from another window or the phone still arrive as ordinary new messages.
A message in the conversation that is open in the expanded window no longer pops a preview while the browser is unfocused: the preview would only cover the message it announces. The sound still plays, since with the browser in the background nothing else tells the agent it arrived, and the conversation stays unread until the browser is focused again.
In a group, hovering "Read by 2 of 3" (or "Delivered to ...") lists the people it counts, so the agent can see who is still behind. The receipt keeps the members it counted instead of only their number.
- (chat) Play MP4 and MOV attachments in the conversation
- A video sent in the chat was only a download link, so watching a short clip a colleague recorded meant saving it and opening it outside Operator. MP4 and MOV attachments now show as a video player in the message, loading only the metadata until played.
Browser support for MOV is uneven: Firefox does not play it, and the HEVC that iPhones record by default needs hardware decoding in Chrome and Edge. When the player reports an error the attachment falls back to the download link it was before, which also covers an MP4 the browser cannot decode. Other video types stay download links.
π Bug Fixesβ
- (chat) Upload and download attachments under /teamchat
- ucs-api serves the teamchat attachment endpoints at /teamchat/uploads and /teamchat/attachments/{id}, not under /api/v1.0, so uploads and downloads went to a path that does not exist. Point both at /teamchat and add it to the dev server proxy so they reach UCS during development too.
- (chat) Drop react-textarea-autosize and title the group name field
- master removed react-textarea-autosize in f345489e0, but the new chat
composer still imported it and only built because the package lingered in
node_modules; a clean install would break it. The composer now uses a plain
textarea that grows through native
field-sizing: content, capped at five lines by a max-height, as the other autosizing inputs already do. It stays a plain textarea rather than lib/ui's Textarea because the composer sets its own border, radius, padding and background, and cx does not merge classes.
- master removed react-textarea-autosize in f345489e0, but the new chat
composer still imported it and only built because the package lingered in
node_modules; a clean install would break it. The composer now uses a plain
textarea that grows through native
The new group form labelled its title field with the bare "Name" message, which Czech renders as "JmΓ©no", a person's name. It now carries a "title of a group" context, translated as "NΓ‘zev".
π Refactorβ
- (chat) Format chat window dates with luxon instead of moment
- The chat window was one of the remaining moment users while the rest of the app moves to luxon. Message times, day separators and the story fixtures now use luxon DateTime.
The server sends created as a string or a number. messageTime() reads the
SQL form (YYYY-MM-DD HH:mm:ss) first, falls back to ISO, and treats a number
as epoch milliseconds, which is what moment(created) did. Day labels map
moment's LT, dddd and LL onto TIME_SIMPLE, cccc and DATE_FULL, which give the
same output in Czech and English since luxon picks up the locale that
MomentI18nControl already sets.
-
(chat) Address the review of the chat window
- Follows the review of MR !760.
-
Search ignores diacritics, so "kristyna" finds KristΓ½na in the chat list, the group people search and @mentions. The chat has its own normalizeSearch in chat-list-model.ts: the admin one imports the admin navigation, and moving it to lib/ is a change of its own.
-
Presence is no longer a context helper. PresenceDot and the new PresenceLabel take a userId and select that one user's status, so a colleague logging in re-renders their dot instead of every component reading the chat context. Lists that sort by presence read the status map from the store.
-
Users come from the store's memoized selectUsersAsMap instead of a map ChatWindow built and passed through the context next to selectUsers, so there is one path to the user list.
-
useConversationSubline becomes
and branches on conversation.kind, so a direct conversation can no longer be described as a group. -
Errors are kept as the caught value and turned into text when they render (
), so a language switch also changes a shown error. The group forms run through useMutation instead of hand-rolled busy/error state. -
The composer takes onSend and onSaveEdit instead of one onSubmit that either fired and forgot or awaited. The edit is a useMutation in Conversation, next to its cache updates; starting or leaving an edit resets it, so a refused edit's reason does not linger.
-
Alt+C uses @tanstack/react-hotkeys, which matches by physical key (Option+C on a Mac) and rejects AltGr (Ctrl+Alt); it stays live in the message box except on a Mac, where Option+C types "Γ§".
-
ConversationTab gets onClose; ChatTabRow closes the tab and moves focus to the list tab through a ref instead of getElementById.
-
The chat reloads after a reconnect and after a sequence gap by listening to the connector, not by watching the websocket state flip in an effect, which misses a drop shorter than a render and counts the first connection as a reconnect. Connector gains add/ removeConnectListener, fired on open like the existing seq-fail listeners. A sequence gap used to reload only the Redux state, so the chat missed the lost event.
-
Text in JSX uses
, like the rest of src. Message ids are unchanged, so the catalogues need no update. -
The attachment test compares against attachmentUrl() instead of a raw query string, so it states "served inline" rather than how.
-
(chat) Inline the Alt+C shortcut into the chat window
- After the move to @tanstack/react-hotkeys, useChatShortcut was a single useHotkey call with one caller, so it is inlined into ChatWindow.
Its tests move into ChatWindow.test.tsx and drive the real window: Alt+C opens the chat list, also from the message box on Windows; AltGr+C (Ctrl+Alt) does nothing; on a Mac Option+C is left to a focused text field and opens the list anywhere else. Forcing ignoreInputs either way fails one of them, so the platform rule stays pinned.
π Documentationβ
- Add React component guidelines from the chat review
- The review of the chat window (MR !760) turned up the same handful of
patterns in many files: hooks that hand back formatters, translated text
kept in state,
{t...}children where the rest of src uses, hand-rolled busy/error state around RPC calls, children dispatching into their parent's state, focus by element id, wide contexts carrying fast-changing values, and re-implementations of what an installed library already does. Writing them down once keeps the next feature from repeating them.
- The review of the chat window (MR !760) turned up the same handful of
patterns in many files: hooks that hand back formatters, translated text
kept in state,
βοΈ Miscellaneous Tasksβ
- (chat) Add a busy group story with many people and messages
- The existing stories hold at most 28 messages and eight people, which is too little to see how the window behaves in a real contact-centre group: long scroll-back through many pages, day separators over weeks, a sender name on most rows, and a people list long enough to scroll.
Busy Group opens "Contact centre β all shifts", a group of the user and 47 colleagues with 600 messages over the last 25 days. The 40 extra colleagues are generated from Czech name lists and spread over the three user groups, a quarter of them offline.
The playground takes a crowd flag for this, so the fake backend now gets its sessions and users as arguments and the store gets the users and their statuses, instead of both reading the module constants. The other stories pass nothing and keep their data.
The fake backend answers listSessions and provisionChat the way UCS does, so the story cannot show the group's members either; that needs members in listSessions on the server first.
- Satisfy oxlint in the files this branch touches
- StoreConfig declared smsChat, crm, email and emailFilter as
Map<string, any>, but the type is intersected with ReturnType
, which already types those slices; typecheck output is identical without them. Drop the four entries and the TODO that described them.
- StoreConfig declared smsChat, crm, email and emailFilter as
Map<string, any>, but the type is intersected with ReturnType
PeekToast reset its leaving flag from an effect when a new preview arrived. Reset it during render on a new peek key instead, the pattern MessageList already uses, and give the timer callback a name so the rule sees that the state is set from a timer rather than from the effect.
The index key in linkify is correct, since the pieces of a split string are identified by their position, but its suppression used the plugin's old @eslint-react name and sat on the wrong line, so it did nothing. Name the rule react-x/no-array-index-key and put it on the key attribute.
- Remove HANDOFF