1.4 KiB
1.4 KiB
1. Resource Cache Representation Normalization
- 1.1 Refactor
resource_cachederived index to use lightweight row-position references instead of full duplicated records payload. - 1.2 Keep
get_all_resources/get_resources_by_filterAPI 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.pyandrealtime_equipment_cache.pywith 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.mdandREADME.mdjwith round-4 hardening notes.