Align SCUM operations with reference tools

openspec/changes/align-scum-operations-with-reference-tools/proposal.md

@@ -0,0 +1,23 @@
+## Why
+
+The SCUM projection pipeline now reads real v57 facts, but the five SCUM pages still present those facts as disconnected tables. The established `scum_new_web` and `scum_robot` tools have useful operator workflows for player search, squad rosters, map overlays, and gifts. Their direct database, FTP, and SQL-transport design does not fit this platform.
+
+## What Changes
+
+- Turn SCUM users into a searchable, squad-filterable projection view with player details and typed-operation entry points.
+- Show each squad with its linked roster and flags rather than a disconnected aggregate table.
+- Render current player, vehicle, base, and flag points in a versioned plugin-declared coordinate frame with independent layers and a selected-marker inspector.
+- Separate game-observed completed timed-gift events from platform-owned gift definitions, revisions, and grants.
+- Move SCUM gift item catalogs and map geometry out of platform code into versioned SCUM plugin data packs.
+
+## Boundaries
+
+- Platform remains the durable owner of projections, gift definitions, revisions, and grants; the plugin owns version-specific SQL, item keys, and map geometry; Run only executes declared work.
+- Do not reintroduce FTP, direct platform/browser access to `SCUM.db`, arbitrary SQL, raw RCON, host paths, or a `run/` source tree.
+- Do not copy third-party map tiles into this repository. The map is an operator coordinate board until a plugin-declared asset reference is available.
+
+## Impact
+
+- `platform/`: separates observed timed-gift events from platform gift catalog data and resolves gift item definitions from the registered plugin.
+- `platform_web/`: adds projection-oriented user, squad, map, and gift views within the existing themed console.
+- `plugins/examples/scum-server-plugin/`: declares SCUM v57 gift items and map geometry as versioned data-pack assets.