morethanadiagnosis-hub/openspec/specs/migration-wix.md

Migration: Wix → Community Hub

Status: approved Owners: Data, Content

Scope

• Inventory existing Wix content and data; define export, mapping, transform, validate, and import steps.

Data sources

• Pages, blog posts, media, members, products (if applicable), forms/submissions.

Mapping template

• Source → Target entity
• Field mapping with transforms
• Data class (Public/PII/PHI)
• Retention policy
• Notes

Process

1. Export: obtain Wix exports (CSV/JSON/API) and media dumps
2. Transform: normalize slugs, HTML → markdown where needed, sanitize
3. Validate: dry‑run import, link integrity checks, accessibility checks on content
4. Import: staged, idempotent jobs; audit logs
5. Verify: sampling and spot checks; stakeholder sign‑off

Rollback

• Keep original exports; implement reversible migrations; track IDs and redirects

Acceptance criteria

• Dry‑run import completes without critical errors; broken links < 1% and remediated.
• Redirects in place for migrated URLs; sitemap updated.
• Sampled content (N>=30 per type) matches expected formatting and accessibility criteria.