# Execution Plan — redesign-modern-timetravel
## Detailed Analysis Summary
### Transformation Scope (Brownfield Only)
- **Transformation Type**: Multi-component application change (frontend re-theme + new capability) with a cross-repo dependency (CMS/API).
- **Primary Changes**: Replace the red/purple dark theme with variant (B/E) × mode (light/dark); rebuild all landing sections to design B; build variant E (five eras) as a lazy-loaded alternative; generic packages block with filter and mobile swipe row; contact form with headless module.
- **Related Components**: this repo (`slp-software-frontend`); SlpModularCms (endpoint, `category` field, headless form package); consumer sites such as AndreaSlopFotografie (own `ContactForm` today).
### Change Impact Assessment
- **User-facing changes**: Yes — complete visual redesign, new variant switch, new form, new mobile packages UX.
- **Structural changes**: Yes — theme model, route/variant composition with lazy E bundle, new form module boundary.
- **Data model changes**: Yes — `PackageCardData.category`; new contact message entity (CMS side).
- **API changes**: Yes — new `POST /api/v1/contact-messages`; extended `GET /api/v1/offerings`.
- **NFR impact**: Yes — security (PII, spam, rate limiting), accessibility (WCAG AA, reduced motion), performance (code split, fonts).
### Component Relationships
```mermaid
graph TD
FE[slp-software-frontend - PRIMARY, major] --> API[SlpModularCms API - endpoint and category, major]
FE --> Mod[Headless form package - from SlpModularCms, major]
Mod --> API
Andrea[AndreaSlopFotografie and other sites - consumers, later] --> Mod
FE --> Nginx[nginx proxy and CSP - config only]
classDef primary fill:#63b3ed,stroke:#2b6cb0,color:#000;
classDef ext fill:#f6e05e,stroke:#c05621,color:#000;
classDef cfg fill:#9ae6b4,stroke:#2f855a,color:#000;
class FE primary;
class API,Mod,Andrea ext;
class Nginx cfg;
```
Text alternative: the frontend depends on the CMS API and on the headless form package that the CMS repo ships; other sites consume the same package; nginx and CSP need configuration changes.
| Component | Change type | Reason | Priority |
|---|---|---|---|
| slp-software-frontend | Major | redesign, theme model, form UI | Critical |
| SlpModularCms API | Major | contact endpoint, `category` | Critical (form), Important (category) |
| Headless form package (SlpModularCms) | Major | agreed reusable module | Critical (for form unit) |
| nginx / CSP | Configuration-only | API route, fonts | Important |
| Other sites (Andrea etc.) | Minor, later | adopt module | Optional (out of this feature) |
### Risk Assessment
- **Risk Level**: Medium-High (large visual scope, cross-repo contract, PII handling)
- **Rollback Complexity**: Easy for the frontend (branch/PR revert, hash-routed static bundle); Moderate for CMS endpoint (data stored)
- **Testing Complexity**: Complex (themes × variants × viewports, form states, cross-repo contract)
## Workflow Visualization
```mermaid
flowchart TD
Start(["User Request"])
subgraph INCEPTION["🔵 INCEPTION PHASE"]
WD["Workspace Detection
COMPLETED"]
RE["Reverse Engineering
COMPLETED"]
RA["Requirements Analysis
COMPLETED"]
US["User Stories
SKIP"]
WP["Workflow Planning
IN PROGRESS"]
AD["Application Design
EXECUTE"]
UG["Units Generation
EXECUTE"]
end
subgraph CONSTRUCTION["🟢 CONSTRUCTION PHASE (per unit U1..U5)"]
FD["Functional Design
EXECUTE U1 U3 U4"]
NFRA["NFR Requirements
EXECUTE U4 U5"]
NFRD["NFR Design
EXECUTE U4 U5"]
ID["Infrastructure Design
EXECUTE U4"]
CG["Code Generation
EXECUTE"]
BT["Build and Test
EXECUTE"]
end
OPS["Operations Phase
UNDECIDED - asked after Construction"]
Start --> WD --> RE --> RA
RA -.-> US
RA --> WP --> AD --> UG --> FD
FD --> NFRA --> NFRD --> ID --> CG
CG -.->|next unit| FD
CG --> BT
BT -.-> OPS
BT --> End(["Complete"])
style WD fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
style RE fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
style RA fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
style WP fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
style CG fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
style BT fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
style US fill:#BDBDBD,stroke:#424242,stroke-width:2px,stroke-dasharray: 5 5,color:#000
style AD fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
style UG fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
style FD fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
style NFRA fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
style NFRD fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
style ID fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
style OPS fill:#BDBDBD,stroke:#424242,stroke-width:2px,stroke-dasharray: 5 5,color:#000
style Start fill:#CE93D8,stroke:#6A1B9A,stroke-width:3px,color:#000
style End fill:#CE93D8,stroke:#6A1B9A,stroke-width:3px,color:#000
style INCEPTION fill:#BBDEFB,stroke:#1565C0,stroke-width:3px,color:#000
style CONSTRUCTION fill:#C8E6C9,stroke:#2E7D32,stroke-width:3px,color:#000
linkStyle default stroke:#333,stroke-width:2px
```
Text alternative: inception runs Application Design and Units Generation (User Stories skipped), then construction loops over five units with design stages only where useful; Operations is decided after construction.
## Phases to Execute
### 🔵 INCEPTION PHASE
- [x] Workspace Detection (COMPLETED)
- [x] Reverse Engineering (COMPLETED)
- [x] Requirements Analysis (COMPLETED)
- [x] User Stories (SKIP) — single visitor persona, requirements already detailed; can be added on request
- [~] Workflow Planning (IN PROGRESS)
- [ ] Application Design — EXECUTE
- **Rationale**: new components and boundaries: variant/mode theme model, lazy E bundle composition, packages block (grid/filter/swipe), headless form module and its API contract with the CMS. The **form contract** produced here is what the CMS session and other form sessions can start from.
- [ ] Units Generation — EXECUTE
- **Rationale**: multiple units with different risk and dependency (see below).
### 🟢 CONSTRUCTION PHASE
Units (proposed order, B first as requested):
- **U1 theme-foundation**: variant × mode model, tokens (B light/dark, E tokens placeholder), system preference, nav switch buttons (mode + icon-only variant button), removal of red/purple, fonts.
- **U2 b-modern-sections**: hero, Over (photo), Werkwijze, nav/footer, contact block frame, light/dark.
- **U3 packages-block**: generic grid, skeleton, filter chips (4+), swipe row on mobile, `category` field, B styling.
- **U4 contact-form**: headless form logic + validation + states, B styling, contract with CMS, spam fields, privacy line. **Coordination gate**: the user is notified before this unit's design/implementation starts (see below).
- **U5 e-timetravel**: lazy-loaded E with five eras, Win98 Werkwijze step cards, packages (2006 style) and form styling per era, light/dark, reduced-motion handling.
Stage decisions:
- [ ] Functional Design — EXECUTE for U1, U3, U4; SKIP for U2, U5 (design exists in the canvas)
- **Rationale**: U1 theme state rules, U3 filter/swipe behaviour, U4 form states/validation/contract are real logic; U2/U5 are visual ports of the canvas.
- [ ] NFR Requirements — EXECUTE for U4, U5; SKIP for U1-U3
- **Rationale**: U4 security/PII/rate-limit/spam; U5 performance (code split, effects) and accessibility with heavy effects. Other units covered by requirements.md NFR-1..8.
- [ ] NFR Design — EXECUTE for U4, U5 (follows NFR Requirements)
- [ ] Infrastructure Design — EXECUTE for U4 only (lightweight)
- **Rationale**: nginx route for the form endpoint, CSP/connect-src, env configuration; skipped for U1-U3 and U5 (no infra impact).
- [ ] Code Generation — EXECUTE (ALWAYS), per unit, with automatic per-unit build/test
- [ ] Build and Test — EXECUTE (ALWAYS)
### 🟡 OPERATIONS PHASE
- [ ] Deployment Setup, Monitoring Setup, Production Readiness Validation — UNDECIDED
- **Rationale**: Requirements Q15-C; asked again at Build and Test.
## Package Change Sequence / Module Update Strategy
- **Update Approach**: Hybrid — frontend units sequential; CMS work parallel to U1-U3 once the contract exists.
- **Critical Path**: Application Design (form contract) → CMS endpoint + headless package → U4 integration.
- **Coordination Points**: `POST /api/v1/contact-messages` contract; `category` on `GET /api/v1/offerings`; headless package API (hook/component slots); nginx route and CSP.
- **Testing Checkpoints**: per-unit tests; contract test (mock server) for U4; integrated check once the CMS endpoint exists.
- **Rollback**: frontend by PR revert; CMS endpoint behind the agreed contract version; mailto fallback while the endpoint is unavailable (feature flag).
## Coordination Plan
- **Form notice (user request)**: the user is told **before the form unit starts**, so they can attach the CMS session and the sessions of other sites that want a form. Because the headless module comes from the CMS repo, the recommended moment is the end of **Application Design** (contract ready, CMS can start in parallel with U1-U3).
- Candidate sessions to attach (from the session list, to be chosen by the user): `CMS & API`, `slpmodularcms-ec`, `slpmodularcms-f7`, `slpmodularcms-6b`, `AndreaSlopFotografie`, `slpsoftware-5d`.
## Estimated Timeline
- **Total Phases**: 2 active (Inception remaining 2 stages; Construction 5 units), Operations undecided
- **Estimated Duration**: several working sessions; U5 is the largest unit.
## Success Criteria
- **Primary Goal**: B live as default site with working light/dark and an icon button revealing E; contact form working end-to-end.
- **Key Deliverables**: variant/mode theme system, B sections, generic packages block with mobile swipe row, contact form + contract + CMS hand-off, E variant, tests.
- **Quality Gates**: `pnpm lint`, `tsc -b`, `vitest run` green; WCAG AA checks; security baseline rules compliant; reduced-motion verified; contract test passing.
- **Integration Testing**: frontend ↔ CMS endpoint once available.
- **Operational Readiness**: decided at Build and Test (Operations undecided).