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

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.