Home

GeneWeb Legacy Restoration — Project Wiki

Mission

Restore, secure, test, and deploy the legacy OCaml genealogy suite GeneWeb without altering its core behavior.

Deliverables

• Test policy and protocols (unit, functional, integration, performance)
• Security audit and vulnerability management
• Standards for documentation, conventions, and accessibility
• Deployment playbook (provisioning, hardening, keys/passwords, network)
• Deployment documentation (GDPR, delivery strategy, cross-department communication)

Notes

CI enforces quality gates plus unit and integration tests. Functional tests may be non‑blocking during development. Golden tests are optional and run on‑demand.

Migration approach

We will not modernize the UI initially. We stabilize GeneWeb (build, tests, security), then migrate small slices behind feature flags using a strangler pattern. Each slice ships with dual-run comparisons (OCaml vs Python), golden tests, performance checks, and a one-click rollback.

For demos

We publish release artifacts on tags (see 05-Deployment-Release-CD). Deployment to a server is a manual, approved step.

Start here: 05-Deployment-Quick-Deploy 2. 02-Product-OCaml-Overview 3. 02-Product-Runbook 4. 03-Quality-Test-Policy

Scope highlights

• Inputs: GEDCOM files, GeneWeb bases, configuration, templates/skins
• Outputs: HTML pages via gwd, exported GEDCOM, updated bases, logs
• Non-negotiables: preserve database semantics and rendering; any format/template change requires an ADR and updated goldens

Quick links

• 02-Product-Architecture
• 03-Quality-Test-Protocols
• 03-Quality-Security-Audit
• 05-Deployment-Security-Hardening
• 05-Deployment-Environments
• 06-Governance-ADR-Index