Files
DashBoard/openspec/changes/archive/2026-02-08-residual-hardening-round4/tasks.md

1.4 KiB

1. Resource Cache Representation Normalization

  • 1.1 Refactor resource_cache derived index to use lightweight row-position references instead of full duplicated records payload.
  • 1.2 Keep get_all_resources / get_resources_by_filter API outputs backward compatible while sourcing data from normalized representation.
  • 1.3 Update cache telemetry fields to reflect normalized representation and verify amplification calculation remains interpretable.

2. Oracle Query Fragment Governance

  • 2.1 Extract shared Oracle SQL fragments/constants for resource/equipment cache loading into a common module.
  • 2.2 Replace duplicated SQL literals in resource_cache.py and realtime_equipment_cache.py with shared definitions.
  • 2.3 Add/adjust tests to lock expected query semantics and prevent drift.

3. Maintainability Hygiene

  • 3.1 Normalize type annotations in touched cache/service modules to one consistent style.
  • 3.2 Replace high-frequency magic numbers with named constants or env-driven config in touched modules.
  • 3.3 Confirm existing login/API rate-limit and bool parser utilities remain centralized without new duplication.

4. Verification and Documentation

  • 4.1 Run targeted backend tests for resource cache, equipment cache, health/admin, and route behavior.
  • 4.2 Update README.md and README.mdj with round-4 hardening notes.