egg/DashBoard
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
Files
7cb0985b1228dcb69f33c865827658605a843cac
DashBoard/openspec/changes/archive/2026-02-12-full-modernization-architecture-blueprint/specs/frontend-platform-modernization-governance/spec.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

ADDED Requirements

Requirement: Frontend modernization scope SHALL be explicitly governed

The modernization program SHALL define an explicit in-scope and out-of-scope route matrix for each phase, and SHALL treat that matrix as a release-governed contract artifact.

Scenario: Scope matrix publication

  • WHEN a modernization phase is created
  • THEN the phase SHALL publish an explicit in-scope route list and out-of-scope route list
  • THEN the matrix SHALL include /admin/pages and /admin/performance in scope for this phase
  • THEN the matrix SHALL mark /tables, /excel-query, /query-tool, and /mid-section-defect as deferred routes for a follow-up phase

Scenario: Scope drift prevention

  • WHEN implementation tasks are derived from the phase specs
  • THEN tasks targeting routes outside the in-scope matrix SHALL be rejected for this phase

Requirement: Modernization phases SHALL define completion and deprecation milestones

Each modernization phase SHALL define measurable completion criteria and deprecation milestones for legacy-era patterns.

Scenario: Phase completion criteria

  • WHEN a phase reaches release review
  • THEN it SHALL provide objective completion criteria for route governance, style governance, and quality gates
  • THEN it SHALL identify any remaining deferred routes and their next-phase linkage

Scenario: Legacy deprecation milestones

  • WHEN legacy fallback or legacy style exceptions remain in phase scope
  • THEN the phase SHALL define a dated milestone or release gate to remove those exceptions