# 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.