Struct ConfigEnv 

pub struct ConfigEnv {

    pub service_name: String,
    pub service_vers: String,
    pub pispas_host: String,
    pub remote_host: String,
    pub remote_port: u16,
    pub remote_ussl: bool,
    pub local_host: String,
    pub local_port: u16,
    pub local_ussl: bool,
    pub modules: Vec<String>,
    pub list_printers: Option<Vec<String>>,
    pub place_id: Option<i64>,
    pub objid: Option<i64>,
}

Runtime configuration loaded from the install’s .env file.

ConfigEnv is the single struct that every binary reads at startup. Fields are plain POD (strings, booleans, ports) so the type is trivially serializable to JSON for the Tauri configurator UI.

Lifecycle

1. The installer writes a default .env via init_env on first run.
2. Each binary calls ConfigEnv::load at startup, which reads the .env through dotenv::from_path and materialises the struct.
3. The configurator calls ConfigEnv::save after the user edits a field, then pushes an IPC restart message to pispas-modules.

Invariants

• local_ussl = true requires the embedded TLS cert and a client that connects via wss://local.unpispas.es:<local_port>. Binding to 127.0.0.1 is fine because DNS resolves local.unpispas.es there.
• modules is an ordered list used by pispas_modules::load_services to instantiate the services. Names not in the match arm are logged and ignored.

Extending

Adding a field requires touching four places — see CLAUDE.md § 5. Forgetting one of them silently resets the new field to its default every time the user saves from the configurator.

Fields

service_name: String

Stable identity of this install. Used as the Windows Service name and echoed back in every WebSocket message envelope.

service_vers: String

Build version tag, echoed in message envelopes for log correlation.

pispas_host: String

Backend REST API hostname (e.g. api.unpispas.es).

remote_host: String

Backend WebSocket hostname that pispas-modules keeps an outbound connection to (e.g. wss.unpispas.es).

remote_port: u16

Backend WebSocket port. Usually 443.

remote_ussl: bool

true → connect with wss://, false → ws://.

local_host: String

Bind address for the local WebSocket server. Almost always 127.0.0.1. See docs/CONFIGURATION.md before changing.

local_port: u16

Bind port for the local WebSocket server. Default 5005.

local_ussl: bool

true → accept TLS on the local socket (recommended for browser clients that require wss://). The listener is dual-mode and still accepts plain ws:// when this is on.

modules: Vec<String>

Ordered list of service modules to load at boot (base, print, paytef, …).

list_printers: Option<Vec<String>>

Cached printer list shown in the configurator UI. Refreshed by the service on demand.

place_id: Option<i64>

Place this TPV belongs to. None until the first authenticated client opens the local WS and sends a CHECK with place_id (first-write-wins). Once set, mismatching place_id on a future CHECK is rejected — the operator must explicitly reset identity from the configurator to re-pair the TPV to a different place.

objid: Option<i64>

Backend-assigned technical id (PK of the RASPPI table). None until the WSR CONNECT response delivers it. Used for routing (the WSR indexes by objid, not by service_name) and as the FQDN prefix of the per-TPV LE cert (<objid>.local.unpispas.es).

Implementations

impl ConfigEnv

pub fn load() -> Self

pub fn set_place_id(&mut self, new_place_id: i64) -> Result<(), String>

Set place_id and persist to .env. First-write-wins: returns Err if place_id is already set to a different value (the operator must explicitly reset identity to re-pair the TPV). Setting the same value is a no-op (idempotent).

pub fn set_objid(&mut self, new_objid: i64)

Set objid and persist. objid is assigned by the backend in the WSR CONNECT response. Once we have it, it should never change for the lifetime of the install — but we don’t enforce that here; the backend is the source of truth.

pub fn forget_identity(&mut self)

Drop the bootstrap fields and let the TPV re-pair from scratch. Triggered by the configurator UI when an operator wants to move the TPV to a different place. The backend should also be told to delete the old RASPPI row separately.

pub fn change_service_name(&mut self, new_name: &str)

pub fn change_service_vers(&mut self, new_vers: &str)

pub fn change_pispas_host(&mut self, new_host: &str)

pub fn change_remote_host(&mut self, new_host: &str)

pub fn change_remote_port(&mut self, new_port: u16)

pub fn change_remote_ussl(&mut self, ussl: bool)

pub fn change_local_host(&mut self, new_host: &str)

pub fn change_local_port(&mut self, new_port: u16)

pub fn change_local_ussl(&mut self, ussl: bool)

pub fn change_modules(&mut self, new_modules: Vec<String>)

pub fn save(&self)

Trait Implementations

impl Clone for ConfigEnv

fn clone(&self) -> ConfigEnv

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConfigEnv

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ConfigEnv

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ConfigEnv

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ConfigEnv

fn eq(&self, other: &ConfigEnv) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ConfigEnv

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ConfigEnv