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/deferred_route_handoff.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.6 KiB
Raw Blame History

Deferred Route Handoff (Phase 1 -> Follow-up)

Source Change

  • openspec/changes/full-modernization-architecture-blueprint/

Deferred Routes (Not in Phase 1 Blocking Scope)

  • /tables
  • /excel-query
  • /query-tool
  • /mid-section-defect

Follow-up Change

  • openspec/changes/deferred-route-modernization-follow-up/

Handoff Content

  1. Scope boundary contract:
  • Source: docs/migration/full-modernization-architecture-blueprint/route_scope_matrix.json
  1. Required acceptance model to carry forward:
  • Parity fixtures/checks:
    • docs/migration/full-modernization-architecture-blueprint/parity_golden_fixtures.json
    • docs/migration/full-modernization-architecture-blueprint/interaction_parity_checks.json
  • Manual acceptance + bug replay:
    • docs/migration/full-modernization-architecture-blueprint/page_content_manual_acceptance_checklist.md
    • docs/migration/full-modernization-architecture-blueprint/known_bug_baseline.json
    • docs/migration/full-modernization-architecture-blueprint/bug_revalidation_records.json
  1. Governance policy to carry forward:
  • docs/migration/full-modernization-architecture-blueprint/quality_gate_policy.json
  • docs/migration/full-modernization-architecture-blueprint/governance_milestones.md
  • docs/migration/full-modernization-architecture-blueprint/asset_readiness_manifest.json

Transfer Rule

  • Deferred routes remain excluded from phase-1 blocking criteria.
  • Follow-up change MUST promote these routes to in-scope and apply equivalent parity/manual-acceptance/bug-revalidation gates before legacy retirement.