ARCG-Remote-Station-Software/WORKING_CONTEXT.md

Working Context

Last updated: 2026-03-18

Purpose

• This repository contains the generic RMS software stack.
• It is intentionally independent from a specific station deployment.
• Station-specific configuration and infrastructure binding belongs in separate overlay/deploy repositories.

Scope

Included here:

• server/ backend API and orchestration
• public/ web UI
• plugins/ plugin catalog and capabilities
• test/ automated checks

Operational note:

• Local/ops utility scripts were moved to Remotestation-ARCG/tools/ (deploy overlay repository).

Not included here:

• production secrets
• station hostnames and private endpoints
• station-specific bandmaps/bandplans/deploy service wiring

Security Boundary (Public Repo)

• This repository is public.
• Never commit live configurations, production environment files, credentials, tokens, private hostnames, or any sensitive operational data.
• Keep all live/runtime secrets in deployment/runtime environment layers outside this repository.

Configuration Layers

Expected priority order:

1. RMS software defaults
2. Station overlay repository defaults
3. Runtime environment variables (highest priority)

Plugin Model

• Plugins declare capabilities and optional UI controls in manifest.json.
• Providers can be switched per capability at runtime.
• Auth methods are plugin-based (authMethod in manifest).

Deploy Contract

• Deploy repositories should fetch this repository as software source.
• Deploy repositories may overlay files for station-specific behavior.
• Deploy repositories must not patch in secrets; secrets come from env files on target systems.

Current Baseline

• Access token default/minimum baseline is 3 hours.
• OpenWebRX+ integrations remain plugin- and deploy-driven; station-specific profile/bandplan data stays outside this repo.

Recent Doc Update

• Added external-reference notes for AlfaSpid RAK/ROT1Prog manual:
  • docs/rotor-alfaspid-rak-rot1prog-manual-notes.md
• Linked the new notes page from README.md under RF/Hardware guides.
• Expanded docs/rotor-rot1prog-guide.md into a full end-to-end setup/calibration/runbook guide.