Operator guideENcurrenciesdetail

Currencies / Detail

Saved currency edit workspace for one currency, including icon upload, asset selection, and rate maintenance.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this page does

This detail page edits one saved currency record at /currencies/[currencyId].

What operators can change

  • Currency Name
  • Currency Symbol
  • Exchange Rate
  • MRKTG Ratio to EUR
  • Loyalty Point
  • Currency Type
  • Currency Icon

The saved Currency Code is shown but locked in read-only mode.

Important behavior

Currency Code cannot be changed here

The edit form keeps Currency Code disabled. Operators can review it, but not overwrite it from this screen.

Icon management is local until save

The page shows three related icon controls:

  • current icon preview
  • Upload icon
  • Select from Assets

Uploading or choosing an asset updates the local icon state immediately. The currency record is only updated after Save.

Upload accepts PNG and SVG only

The upload button rejects other file types. The FE also generates a currencyicons/<code>-<timestamp> asset key before calling the core upload endpoint.

Empty icon values are not sent on save

The FE only includes iconUrl in the update payload when the current local icon field is non-empty after trimming.

Calculation notes

Calculations

calculation

Read-only currency code

Saved currency code is reviewed here, not edited here.

Inputs
code
Transform
The detail form displays `Currency Code` as a disabled field and does not include code changes in the update flow.
calculation

Icon upload file gate

Unsupported icon file types are blocked before upload.

Inputs
icon
Transform
The FE accepts only `image/png` and `image/svg+xml` before calling the core upload hook.
calculation

Local icon staging

Previewing a new icon is not the same as persisting it.

Inputs
icon, asset_picker
Transform
Uploading a file or selecting an asset changes local `iconUrl` state and the preview immediately, but the currency record is updated only after `Save`.
calculation

Empty icon omission

Clearing icon state locally does not send an empty icon string automatically.

Inputs
icon
Transform
The FE includes `iconUrl` in the update payload only when the trimmed local value is non-empty.
Field dictionary

Fields

field

Currency Name

Display name for the saved currency.

Group
identity
Data Type
string
field

Currency Code

Stored code for the currency. It is displayed but disabled in edit mode.

Group
identity
Data Type
string
field

Currency Symbol

Symbol used when the currency is displayed elsewhere.

Group
identity
Data Type
string
field

Exchange Rate

Stored exchange-rate value for this currency.

Group
rates
Data Type
number
field

MRKTG Ratio to EUR

Marketing ratio value stored for this currency.

Group
rates
Data Type
number
field

Loyalty Point

Loyalty-point value stored for this currency.

Group
rates
Data Type
number
field

Currency Type

Editable FE type selection for the saved currency.

Group
classification
Data Type
enum
field

Currency Icon

Current icon value saved for the currency and updated through upload or asset selection.

Group
icon
Data Type
image
field

Current Icon Preview

Live preview of the currently selected icon state before save.

Group
icon
Data Type
image-preview
field

Select from Assets

Existing uploaded asset that can be assigned as the currency icon without uploading a new file.

Group
icon
Data Type
asset-reference
Operational notes

Notes

item

FE detail route, edit fields, upload flow, and asset-selection workflow are confirmed.

item

`UpdateCurrencyService` requires `currencyId`, validates the editable fields, and persists optional `iconUrl` only when the trimmed value is non-empty.

item

`get-currency-details` and `update-currency` both resolve through `AdminController` into dedicated currency services.

Related references

Related pages

pageCurrencies

Operator guide for currency inventory, create flow, and edit workspace.

pageCurrencies / Form

Create workspace for one currency record, including code-driven type suggestion and numeric rate inputs.

pageCurrencies / List

Currency inventory page for reviewing configured currencies and opening create or saved-record flows.

pageActivity Tag Rules / Detail

Rule inspection page with backend identity, conditions, timestamps, impact estimate, run action, delete action, and recent application history.

pageAffiliate Payment Settings / Detail

Saved affiliate payment-setting detail page for reviewing one configured record.

pageAffiliate Settings / Detail

Saved affiliate detail workspace for reviewing one affiliate and opening report actions.