Skip to content

v0.1.51

Latest

Choose a tag to compare

@github-actions github-actions released this 12 Nov 00:04
· 14 commits to main since this release

Breaking changes

  • Station security events need the new securityEvents:read permission. GET /v1/stations/:id/security-events now needs stations:read and securityEvents:read. Without securityEvents:read, GET /v1/stations/:id/security-logs returns the connection rows only (a source=security or severity filter answers an empty page), and the station OCPP message log (GET /v1/stations/:id/ocpp-logs: rows, queued commands, total and action list), the site live OCPP messages (GET /v1/sites/:id/ocpp-messages) and the AI assistant tools that read them leave out SecurityEventNotification messages and their replies. The CSMS hides the source and severity filters of the station log without it. Affected: viewers, custom roles and API keys that read station security events. The migration grants securityEvents:read once to the Operator and Admin roles; it is not a Viewer default. Action: add securityEvents:read to every custom role and API key that must keep seeing station security events. See Permissions.

Upgrade notes

  • New critical security events. TiltDetected, CableCutDetected and AttemptedReplayAttacks are now rated critical, and the OCPP 2.0.1 and 2.1 events that had no rating get the rating of their 1.6 counterpart or their class. While security auto-disable is on (security.autoDisableOnCritical, on by default), a station that reports one of them is disabled (OCPP ChangeAvailability Inoperative) until an operator enables it again. Review the setting before the upgrade if your stations report these events. See Security auto-disable.
  • Stored security events are re-rated. The v0.1.51 migration sets the severity of every stored security event from the current severity table. It changes no station status and runs no auto-disable.
  • Index migration outside a transaction. Migration 0489_release_0_1_51_indexes.sql builds the security_events and port_status_log receipt time indexes and the list sort indexes with CREATE INDEX CONCURRENTLY, outside a transaction. The build holds back no insert, but runs longer on large tables. On a Helm install with a large database, give helm upgrade a longer --timeout.
  • Google Maps controls use the system font. The CSMS and the portal now serve the Inter font from the app, and the strict CSP allows fonts and styles from the app origin only, so the Google Maps controls fall back to the system font.
  • Security Events dashboard card is hidden by default. Add it with Customize on the live dashboard. See Security Events.
  • Light and dark is now called Mode. The setting keeps the value each user and driver had stored, and the API field themePreference is unchanged.
  • New app settings for Helm and CDK. appSettings.system.distanceUnit, driverLanguage, updateCheckEnabled and portal.rfidSelfServiceEnabled (Helm) and the matching CDK appSettings keys are optional. Empty or absent keeps the value set in the dashboard.

Features

  • Themes. Every CSMS user and every driver picks a theme for their own account: Default, Soft (rounder corners, lighter borders, softer shadows) or High Contrast (plain black and white surfaces, strong borders, body text at the WCAG AAA level). Each theme comes in Light and Dark through the Mode setting. Theme and mode are saved on the account, so they follow the user to every browser and device. CSMS users set them on the Appearance tab of their profile or from the sidebar user menu, drivers under Personal Info in the portal and in the mobile app. See Themes, Appearance, Portal Personal Info and Mobile app Personal Info.
  • Driver defaults. New drivers created in the CSMS, through POST /v1/drivers or by portal or app registration take the company timezone, the new Driver Distance Unit (miles or km) and the new Driver Language from Settings > Company Info, unless the request sends its own. Portal registration keeps the language the visitor used, and the driver Details tab edits the timezone and distance unit. Requested by @MarcoSpittka in GitHub discussion 51. See Company Info and Timezone.
  • Driver RFID self-service switch. Settings > Integrations & Features > RFID Cards turns driver RFID card management on or off (on by default). Off, drivers see their RFID cards read-only in the portal and the mobile app, the API refuses driver card changes with 403 RFID_SELF_SERVICE_DISABLED, and operators manage the cards on the Tokens page. Requested by @Tobias9876 in GitHub discussion 55. See RFID Cards, Driver Self-Service and When the Operator Manages Your Cards.
  • Driver notification preferences per event and channel. Drivers choose per event and channel (email, SMS, push) which notices they get, in the portal and the mobile app, with an all on or all off switch per channel. Operators mark each driver event Optional or Mandatory per channel on the Driver Events tab. An event the operator turned off is never sent; a mandatory channel is sent whatever the driver chose. Existing preferences carry over and no event is mandatory by default. Requested by @Tobias9876 in GitHub discussion 56. See Driver Notification Preferences and Notification Preferences.
  • Security Events dashboard card. A donut of every severity and the stations sorted by worst severity, each linking to the station Security tab, with range, site and severity filters (GET /v1/dashboard/security-events). Available to users with securityEvents:read. Critical security events of the last hour are also exported to Grafana, with an alert. See Security Events.
  • Column sorting on every paged list. Click a column header in a CSMS list table to sort by it: once ascending, again descending, a third time back to the default order. The sort stays in the address, so Back, a reload and a shared link keep it. The list endpoints take optional sort and order (asc, desc) query parameters; an unknown key answers 400 VALIDATION_ERROR.
  • Simulator security events and High Temperature fault. The simulator Send Security Event dialog lists every OCPP security event of the station's version, grouped by severity, plus vendor tamper types, and the fault menu has High Temperature. See Security Event and Inject Fault.
  • 3D site layout. DC dispensers with two EVSEs stand on the line between two spots and serve both. Every EVSE has its number plate and its own status light. Idle cables hang on a J hook in natural bends. Every charger has a tap RFID reader, and each port of a wall box has its own. Wall boxes can have two ports. The camera comes as close as 1 m, zooms toward the pointer and eases in on a double-clicked charger, like a map app. See Layout.

Improvements

  • Settings System tab. A new System tab in Settings holds the settings of the CSMS installation itself, starting with the Update Check card. See System.
  • Readable names instead of internal ids. List tables no longer show internal id columns; the row opens the detail page, which keeps the copyable id under its title. The Stations list labels the OCPP id column Station ID. Links name their target: a session by its station and start time, a token by its RFID card value, a reservation by its number. The Audit Log list shows each entity's name, and an actor without a name shows its kind. See Audit Logs.
  • Session ID and reservation number columns. The Sessions lists show the session ID and the Reservations list the reservation number as a sortable first column (sort=sessionId, sort=reservationId). See Sessions and Reservations.
  • Tokens Label column. The Tokens list and the driver Tokens tab show each RFID card's label next to its value, on phones too. See Tokens.
  • Station Data Plan tab. The station page shows the station's data plan on its own tab. See Data Plan.
  • Brand Color. The company theme color in Settings > Company Info is now called Brand Color, so it is not confused with the account themes. The stored color is unchanged. See Company Info.
  • SIMs menu entry shows once a SIM exists. Add or import the first SIM from Settings > Integrations & Features > SIM Providers, or by entering an ICCID on a station. See SIMs.
  • One select, date picker and option switch everywhere. Every select field in the CSMS and the portal uses the same control, and every date field one date picker with month and year selects, keyboard navigation, Today and Clear. Every option switch in the portal (session chart, Reservations, Activity, station search networks, avatar editor, Popular Times day picker) is the same switch, with equal segments, arrow key selection and labels that stay whole on phones.
  • Sign-up only while registration is open. GET /v1/portal/features returns registrationEnabled. While registration is closed, the portal and the mobile app show no sign-up link and /register opens the login screen. Contributed by @MarcoSpittka in #60. See Registration.
  • The scanned connector after a QR scan. A QR code that names a connector opens the charging page with only that connector, preselected; Show All Connectors lists the others, in the portal and the mobile app. Contributed by @MarcoSpittka in #61. See Charging.

Fixes

  • Inter font bundled. The CSMS and the portal serve the Inter font from the app instead of Google Fonts, so no browser contacts Google to load it. Contributed by @MarcoSpittka in #57.
  • Update check from the server. The worker checks evtivity.com for a new stable release at most once a day and the dashboard reads the result from the API, so no browser contacts the website. The check can be turned off on the System tab. See Update check.
  • Support entry points follow the Support switch. While Support is turned off, the portal and the mobile app hide Report Issue and the Support Cases entry, and the support pages open the home page. Contributed by @MarcoSpittka in #62 (merged as #63). See Support Cases.
  • Default theme meets WCAG AA. The light mode status colors are deeper so they read as text, warning badges show near-white text on a darker amber, and in dark mode every status fill shows dark text.
  • Security review fixes. The critical security event count and the live security event notices reach only users who may see them. Security events and port status rows are pruned by their receipt time, not the station-reported time. Simulated security events and faults are checked and audited. Turning the RFID self-service switch off applies on every API process at once, and a generic settings delete of it is refused. Signing certificate failures are rated high, and the OCPP 1.6 edition 4 security events are listed. Audit Log names follow the viewer's sites, so a station, terminal or SIM moved to another site does not reveal its new label or OCPP id.
  • Dashboard and lists. Empty dashboard charts keep their full height, the Historical cards stay in their rows, a site-restricted operator's Live health row has no gaps and every stat row fills its width. The site Stations tab pages in a fixed order and fills its Vendor column (GET /v1/sites/:id/stations returns vendorId and vendorName). The matching stations preview of configuration templates and firmware campaigns shows each station's online status again. The firmware campaigns list is translated. See Dashboard, Sites and Firmware Updates.
  • Tab strips and quick commands. Roaming shows every tab that fits the page, tab strips are no longer capped at 80 percent of the page width, and station quick OCPP commands show only Close once the station's response arrived. See Roaming.
  • Portal feature switches. The portal reads its feature switches through one shared reader with one 60-second cache, so a switch the operator changes applies on every portal screen within a minute.
  • Dependency updates. The service images build on the current node:24-slim image (Dependabot #52), and the CI and release workflows use the current checkout, setup-node and artifact actions (Dependabot #58).

Mobile app

The driver app v0.1.51 ships with this release: themes and mode, driver notification preferences, read-only RFID cards while self-service is off, the sign-up link that follows the registration switch, the scanned connector after a QR scan, and support entry points that follow the Support switch.

Thanks

Thanks to @MarcoSpittka for #57, #60, #61 and #62 (merged as #63) and for discussion 51, and to @Tobias9876 for discussions 55 and 56.

Changelog

Commits since v0.1.50.

Features

  • sortable session and reservation number columns and a station data plan tab (3101be7)
  • (portal): show only the scanned connector after a QR scan (#61) (a25d0eb)
  • sort paged lists by column and show readable names instead of internal ids (e7cfa9b)
  • add account themes and modes, the sidebar theme menu, and one shared select and date picker (0f71e23)
  • (csms): add a Settings System tab and show the SIMs menu once a SIM exists (3c89ab6)
  • driver defaults, RFID self-service, notification preferences and security events access (0f091ba)

Bug Fixes

  • fill the dashboard rows and tab strips, share one portal option switch (f69e4fa)
  • (portal): hide support entry points while support is disabled (#62) (5791a6a)
  • (portal): offer sign-up only while registration is open (#60) (78301ac)
  • serve the Inter font from the app instead of Google Fonts (#57) (6a8be0b)

Tests

  • run the heavy 3D layout cable and reader checks one case per test (e7b7a17)
  • run the dual-port stall cable routes per connector kind and stall (1101cb7)

Build

  • bump the GitHub actions and the node 24-slim base image digest (b6a329d)

CI

  • keep the ocpi digests apart from the ocpi-simulator digests (1e98f1c)