egg/DashBoard
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
Files
5b358d71c1bd2344ec57c0c50c65c69cf42893de
DashBoard/docs/migration/full-modernization-architecture-blueprint/README.md
egg 7cb0985b12 feat(modernization): full architecture blueprint with hardening follow-up 
Implement phased modernization infrastructure for transitioning from
multi-page legacy routing to SPA portal-shell architecture, plus
post-delivery hardening fixes for policy loading, fallback consistency,
and governance drift detection.

Key changes:
- Add route contract enrichment with scope/visibility/compatibility policies
- Canonical 302 redirects from legacy direct-entry to /portal-shell/ routes
- Asset readiness enforcement and runtime fallback retirement for in-scope routes
- Shared feature-flag helpers (env > config > default) replacing duplicated _to_bool
- Defensive copy for lru_cached policy payloads preventing mutation corruption
- Unified retired-fallback response helper across app and blueprint routes
- Frontend/backend route-contract cross-validation in governance gates
- Shell CSS token fallback values for routes rendered outside shell scope
- Local-safe .env.example defaults with production recommendation comments
- Legacy contract fallback warning logging and single-hop redirect optimization

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 11:26:02 +08:00

1.4 KiB
Raw Blame History

Full Modernization Architecture Blueprint Artifacts

This directory stores execution artifacts for full-modernization-architecture-blueprint.

Core Governance

  • route_scope_matrix.json: frozen in-scope/deferred route contract matrix.
  • governance_milestones.md: completion and deprecation milestones.
  • exception_registry.json: approved temporary exceptions with owner and milestone.
  • Policy artifact runtime cache model:
    • src/mes_dashboard/core/modernization_policy.py caches route_scope_matrix.json and asset_readiness_manifest.json in-process with lru_cache.
    • Runtime behavior is restart-refresh by default: JSON edits take effect after worker restart.
    • Controlled refresh is available through clear_modernization_policy_cache() for tests or explicit maintenance hooks; no automatic file watcher/hot reload is active in production.

Content Modernization Safety

  • page_content_manual_acceptance_checklist.md: mandatory manual sign-off checklist.
  • known_bug_baseline.json: route-level known bug baseline and replay blocking policy.

Rollout Operations

  • rollout_runbook.md: phase steps and hold points.
  • rollback_controls.md: rollback and false-positive gate handling.
  • observability_checkpoints.md: route/gate/rollback observability contract.
  • deferred_route_handoff.md: explicit handoff package to deferred-route follow-up change.